Package Exports

text-dot-case
text-dot-case/dist.es2015/index.js
text-dot-case/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (text-dot-case) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Dot Case

Transform text into dot.case format where words are lowercase and separated by dots.

🚀 Features

Lightweight - Only ~450B minified + gzipped
Type-safe - Full TypeScript support with comprehensive type definitions
Zero dependencies - No external dependencies
Tree-shakeable - ES modules support
Universal - Works in browsers, Node.js, and serverless environments
Well-tested - Comprehensive test suite with edge cases
Customizable - Flexible options for advanced use cases

📦 Installation

# npm
npm install text-dot-case

# yarn
yarn add text-dot-case

# pnpm
pnpm add text-dot-case

# bun
bun add text-dot-case

🎯 Quick Start

import { dotCase } from "text-dot-case";

console.log(dotCase("hello world")); // "hello.world"
console.log(dotCase("userProfileData")); // "user.profile.data"
console.log(dotCase("backgroundColor")); // "background.color"

📖 Usage

ES Modules (Recommended)

import { dotCase } from "text-dot-case";

console.log(dotCase("Hello World")); // "hello.world"

CommonJS

const { dotCase } = require("text-dot-case");

console.log(dotCase("Hello World")); // "hello.world"

TypeScript

import { dotCase, Options } from "text-dot-case";

const result: string = dotCase("Hello World");
console.log(result); // "hello.world"

🔄 Transformation Examples

Basic Transformations

import { dotCase } from "text-dot-case";

// From different cases
dotCase("Hello World"); // "hello.world"
dotCase("helloWorld"); // "hello.world"
dotCase("HelloWorld"); // "hello.world"
dotCase("hello_world"); // "hello.world"
dotCase("hello-world"); // "hello.world"
dotCase("HELLO_WORLD"); // "hello.world"
dotCase("CONSTANT_CASE"); // "constant.case"

// Complex examples
dotCase("XMLParser"); // "xml.parser"
dotCase("iPhone6Plus"); // "i.phone6.plus"
dotCase("HTML5Canvas"); // "html5.canvas"
dotCase("getUserID"); // "get.user.id"

Advanced Options

import { dotCase } from "text-dot-case";

// Custom word splitting
dotCase("XMLHttpRequest", {
  splitRegexp: /([a-z])([A-Z])/g,
}); // "xml.http.request"

// Custom character stripping
dotCase("hello@world.com", {
  stripRegexp: /[@]/g,
}); // "hello.world.com"

// Custom transformation function
dotCase("API-v2-endpoint", {
  transform: (word, index) => {
    if (word === "API") return "api";
    if (word === "v2") return "v2";
    return word.toLowerCase();
  },
}); // "api.v2.endpoint"

🌍 Real-World Examples

Object Property Names

import { dotCase } from "text-dot-case";

// API response normalization
const apiResponse = {
  "First Name": "John",
  Last_Name: "Doe",
  emailAddress: "john@example.com",
  phoneNumber: "+1234567890",
};

const normalized = Object.keys(apiResponse).reduce((acc, key) => {
  acc[dotCase(key)] = apiResponse[key];
  return acc;
}, {});

console.log(normalized);
// {
//   "first.name": "John",
//   "last.name": "Doe",
//   "email.address": "john@example.com",
//   "phone.number": "+1234567890"
// }

Configuration Keys

import { dotCase } from "text-dot-case";

// Environment variables to config
dotCase("DATABASE_HOST"); // "database.host"
dotCase("apiSecretKey"); // "api.secret.key"
dotCase("maxRetryAttempts"); // "max.retry.attempts"
dotCase("REDIS_CONNECTION"); // "redis.connection"
dotCase("jwtTokenExpiry"); // "jwt.token.expiry"

File and Module Names

import { dotCase } from "text-dot-case";

// Component naming
dotCase("UserProfile"); // "user.profile"
dotCase("ShoppingCart"); // "shopping.cart"
dotCase("PaymentGateway"); // "payment.gateway"
dotCase("AuthMiddleware"); // "auth.middleware"
dotCase("EmailValidator"); // "email.validator"

Method and Function Names

import { dotCase } from "text-dot-case";

// Class methods to dot notation
dotCase("getUserById"); // "get.user.by.id"
dotCase("calculateTotalPrice"); // "calculate.total.price"
dotCase("validateEmailAddress"); // "validate.email.address"
dotCase("processPaymentData"); // "process.payment.data"
dotCase("generateAccessToken"); // "generate.access.token"

Database and Schema Mapping

import { dotCase } from "text-dot-case";

// Transform form data for nested objects
function normalizeFormData(formData) {
  const normalized = {};

  for (const [key, value] of Object.entries(formData)) {
    normalized[dotCase(key)] = value;
  }

  return normalized;
}

const form = {
  firstName: "John",
  lastName: "Doe",
  emailAddress: "john@example.com",
  billingAddress: "123 Main St",
  shippingAddress: "456 Oak Ave",
};

console.log(normalizeFormData(form));
// {
//   "first.name": "John",
//   "last.name": "Doe",
//   "email.address": "john@example.com",
//   "billing.address": "123 Main St",
//   "shipping.address": "456 Oak Ave"
// }

Constants and Enums

import { dotCase } from "text-dot-case";

// Transform constants
dotCase("MAX_FILE_SIZE"); // "max.file.size"
dotCase("DEFAULT_TIMEOUT"); // "default.timeout"
dotCase("ERROR_MESSAGES"); // "error.messages"
dotCase("HTTP_STATUS_CODES"); // "http.status.codes"
dotCase("VALIDATION_RULES"); // "validation.rules"

📖 API Reference

`dotCase(input, options?)`

Converts a string to dot.case.

Parameters

input (string): The string to convert
options (Options, optional): Configuration options

Returns

string: The dot.case formatted string

Options

interface Options {
  // Custom transform function for word processing
  transform?: (word: string, index: number, words: string[]) => string;

  // Regex to strip characters before processing
  stripRegexp?: RegExp;

  // Custom split function
  split?: (value: string) => string[];
}

🔧 Advanced Configuration

Custom Word Splitting

import { dotCase } from "text-dot-case";

// Split on specific patterns
dotCase("XMLHttpRequest", {
  splitRegexp: /([a-z])([A-Z])/g,
}); // "xml.http.request"

// Split on numbers
dotCase("user123data", {
  splitRegexp: /([a-zA-Z])(\d)/g,
}); // "user.123.data"

Custom Character Stripping

import { dotCase } from "text-dot-case";

// Strip specific characters
dotCase("hello@world.com", {
  stripRegexp: /[@]/g,
}); // "hello.world.com"

// Strip all non-alphanumeric except dots
dotCase("hello!@#world", {
  stripRegexp: /[^a-zA-Z0-9.]/g,
}); // "hello.world"

Custom Transform Functions

import { dotCase } from "text-dot-case";

// Preserve specific formatting
dotCase("XML-HTTP-Request", {
  transform: (word, index) => {
    const acronyms = ["xml", "http", "api", "url"];
    if (acronyms.includes(word.toLowerCase())) {
      return word.toLowerCase();
    }
    return word.toLowerCase();
  },
}); // "xml.http.request"

// Custom business logic
dotCase("UserV2API", {
  transform: (word, index) => {
    if (word === "V2") return "v2";
    if (word === "API") return "api";
    return word.toLowerCase();
  },
}); // "user.v2.api"

📊 Bundle Size

This package is optimized for minimal bundle size:

Minified: ~450B
Gzipped: ~250B
Tree-shakeable: Yes
Side effects: None

🌍 Browser Support

Modern browsers: ES2015+ (Chrome 51+, Firefox 54+, Safari 10+)
Node.js: 12+
TypeScript: 4.0+
Bundle formats: UMD, ESM, CommonJS

🧪 Testing

# Run tests
pnpm test

# Run tests in watch mode
pnpm test --watch

# Run tests with coverage
pnpm test --coverage

# Type checking
pnpm typecheck

# Linting
pnpm lint

text-camel-case - Convert to camelCase
text-capital-case - Convert to Capital Case
text-constant-case - Convert to CONSTANT_CASE
text-header-case - Convert to Header-Case
text-is-lower-case - Check if text is lower case
text-case - All case transformations in one package

📜 License

🤝 Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

🆘 Support

📧 Email: selikhov.dmitrey@gmail.com
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions
📖 Documentation: Full Documentation

Made with ❤️ by Dmitry Selikhov

text-dot-case