string-extn 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Balaji Katta Venkatarathnam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,367 @@
+# string-extn
+
+A lightweight, TypeScript-first library for **safe and functional string manipulation**. It provides **core string utilities, functional programming helpers, and Unicode-safe operations**, designed for **Node.js and browser environments**.
+
+---
+
+## Table of Contents
+
+- [Features](#features)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [API Reference](#api-reference)
+  - [Core Functions](#core-functions)
+  - [Functional Programming](#functional-programming)
+  - [Case Conversion](#case-conversion)
+  - [String Comparison & Similarity](#string-comparison--similarity)
+  - [String Masking & Redaction](#string-masking--redaction)
+  - [URL & Filename Safe Conversion](#url--filename-safe-conversion)
+  - [String Validation](#string-validation)
+  - [Unicode Operations](#unicode-operations)
+- [Examples](#examples)
+- [Testing](#testing)
+- [License](#license)
+
+---
+
+## Features
+
+### ✨ Core String Operations
+- **trim** - Remove leading/trailing whitespace
+- **pad** - Pad strings to a fixed length with custom characters
+- **slice** - Extract string substrings with flexible indexing
+- **repeat** - Repeat strings multiple times
+- **truncate** - Truncate strings with ellipsis
+- **reverse** - Reverse string character order
+
+### 🔧 Functional Programming Helpers
+- **map** - Transform each character with a function
+- **filter** - Keep only characters matching a predicate
+- **reduce** - Accumulate values by processing characters
+- **compose** - Chain multiple functions for complex transformations
+
+### 🔤 Case Conversion
+- **toCamelCase** - Convert to camelCase from kebab-case, snake_case, or spaces
+- **toKebabCase** - Convert to kebab-case from camelCase, snake_case, or spaces
+- **toSnakeCase** - Convert to snake_case from camelCase, kebab-case, or spaces
+- **toPascalCase** - Convert to PascalCase from any format
+
+### 🔍 String Comparison & Similarity
+- **diff** - Find character differences between two strings
+- **similarity** - Calculate similarity score (0-1) using Levenshtein distance
+
+### 🎭 String Masking & Redaction
+- **mask** - Mask sensitive information keeping only last N characters visible
+- **redact** - Redact portions matching regex patterns
+
+### 🌐 URL & Filename Safe Conversion
+- **slugify** - Convert to URL-friendly slug format
+- **filenameSafe** - Remove invalid filesystem characters
+
+### ✔️ String Validation (20 validators)
+- Email, UUID, Numeric, URL, Hex Color, Phone Number, Date
+- Strong Password, JSON, Base64, Alphabetic, Alphanumeric
+- Case validators, Whitespace, Palindrome, Hexadecimal, Roman Numeral
+- IPv4, IPv6 validation
+
+### 🌍 Unicode-Safe Operations
+- **lengthUnicode** - Count Unicode grapheme clusters (handles emoji with modifiers)
+- **unicodeSlice** - Slice strings while respecting grapheme boundaries
+- **reverseUnicode** - Reverse strings with proper emoji and combining mark support
+
+---
+
+## Installation
+
+```bash
+npm install string-extn
+```
+
+Or with Yarn:
+
+```bash
+yarn add string-extn
+```
+
+---
+
+## Quick Start
+
+### Core Functions
+
+```typescript
+import { trim, pad, slice, repeat, truncate, reverse } from 'string-extn';
+
+trim('  hello world  ');              // "hello world"
+pad('abc', 5, '-');                  // "abc--"
+slice('hello', 1, 4);                // "ell"
+repeat('ha', 3);                     // "hahaha"
+truncate('This is a long string', 10, '...'); // "This is a ..."
+reverse('hello');                    // "olleh"
+```
+
+### Functional Programming
+
+```typescript
+import { map, filter, reduce, compose } from 'string-extn';
+
+map('abc', c => c.toUpperCase());     // "ABC"
+filter('abcdef', c => 'aeiou'.includes(c)); // "ae"
+reduce('abc', (acc, c) => acc + c.charCodeAt(0), 0); // 294
+
+const shout = compose(s => s + '!', s => s.toUpperCase());
+shout('hello'); // "HELLO!"
+```
+
+### Unicode-Safe Operations
+
+```typescript
+import { lengthUnicode, unicodeSlice, reverseUnicode } from 'string-extn';
+
+const emojiStr = '👍🏽👍';
+lengthUnicode(emojiStr);          // 2 (counts emoji with skin tone as 1)
+unicodeSlice(emojiStr, 0, 1);     // "👍🏽"
+reverseUnicode(emojiStr);         // "👍👍🏽"
+```
+
+---
+
+## API Reference
+
+### Core Functions
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `trim` | `trim(str: string): string` | Removes leading/trailing whitespace |
+| `pad` | `pad(str: string, length: number, char?: string): string` | Pads string to fixed length |
+| `slice` | `slice(str: string, start: number, end?: number): string` | Returns substring |
+| `repeat` | `repeat(str: string, times: number): string` | Repeats string N times |
+| `truncate` | `truncate(str: string, max: number): string` | Truncates with ellipsis (...) |
+| `reverse` | `reverse(str: string): string` | Reverses string characters |
+
+### Functional Programming
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `map` | `map(str: string, fn: (c: string) => string): string` | Transforms each character |
+| `filter` | `filter(str: string, fn: (c: string) => boolean): string` | Filters characters by predicate |
+| `reduce` | `reduce<T>(str: string, fn: (acc: T, c: string) => T, initial: T): T` | Reduces string to accumulator value |
+| `compose` | `compose(...fns: Function[]): (value: any) => any` | Composes functions right-to-left |
+
+### Case Conversion
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `toCamelCase` | `toCamelCase(input: string): string` | Converts to camelCase |
+| `toKebabCase` | `toKebabCase(input: string): string` | Converts to kebab-case |
+| `toSnakeCase` | `toSnakeCase(input: string): string` | Converts to snake_case |
+| `toPascalCase` | `toPascalCase(input: string): string` | Converts to PascalCase |
+
+### String Comparison & Similarity
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `diff` | `diff(a: string, b: string): string[]` | Returns character differences between two strings |
+| `similarity` | `similarity(a: string, b: string): number` | Returns similarity score (0-1) using Levenshtein distance |
+
+### String Masking & Redaction
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `mask` | `mask(input: string, visible?: number, maskChar?: string): string` | Masks string keeping last N characters visible |
+| `redact` | `redact(input: string, patterns: RegExp[]): string` | Redacts portions matching regex patterns |
+
+### URL & Filename Safe Conversion
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `slugify` | `slugify(input: string): string` | Converts to URL-friendly slug format |
+| `filenameSafe` | `filenameSafe(input: string): string` | Removes invalid filesystem characters |
+
+### String Validation
+
+| Function | Input | Returns | Purpose |
+|----------|-------|---------|---------|
+| `isEmail` | string | boolean | Validates email address format |
+| `isUUID` | string | boolean | Validates UUID format (v1-v5) |
+| `isNumeric` | string | boolean | Validates numeric strings |
+| `isURL` | string | boolean | Validates URL format |
+| `isHexColor` | string | boolean | Validates hex color codes |
+| `isPhoneNumber` | string | boolean | Validates E.164 phone numbers |
+| `isDate` | string | boolean | Validates date strings |
+| `isStrongPassword` | string | boolean | Validates strong password criteria |
+| `isJSON` | string | boolean | Validates JSON format |
+| `isBase64` | string | boolean | Validates Base64 encoding |
+| `isAlphabetic` | string | boolean | Validates alphabetic strings only |
+| `isAlphanumeric` | string | boolean | Validates alphanumeric strings |
+| `isLowerCase` | string | boolean | Validates lowercase strings |
+| `isUpperCase` | string | boolean | Validates uppercase strings |
+| `isWhitespace` | string | boolean | Validates whitespace-only strings |
+| `isPalindrome` | string | boolean | Validates palindrome strings |
+| `isHexadecimal` | string | boolean | Validates hexadecimal format |
+| `isRomanNumeral` | string | boolean | Validates Roman numeral format |
+| `isIPv4` | string | boolean | Validates IPv4 addresses |
+| `isIPv6` | string | boolean | Validates IPv6 addresses |
+
+### Unicode Operations
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `lengthUnicode` | `lengthUnicode(str: string): number` | Counts Unicode grapheme clusters |
+| `unicodeSlice` | `unicodeSlice(str: string, start: number, end?: number): string` | Slices by grapheme boundaries |
+| `reverseUnicode` | `reverseUnicode(str: string): string` | Reverses with emoji/modifier support |
+
+---
+
+## Examples
+
+### Example 1: Text Processing Pipeline
+
+```typescript
+import { trim, map, filter } from 'string-extn';
+
+const input = '  HELLO WORLD  ';
+const result = trim(input)
+  .toLowerCase()
+  .split(' ')
+  .map(word => filter(word, c => 'aeiou'.includes(c)))
+  .join(',');
+
+console.log(result); // "e,o"
+```
+
+### Example 2: Case Conversion
+
+```typescript
+import { toCamelCase, toKebabCase, toSnakeCase, toPascalCase } from 'string-extn';
+
+const text = 'hello-world-example';
+
+console.log(toCamelCase(text));    // "helloWorldExample"
+console.log(toKebabCase('helloWorld')); // "hello-world"
+console.log(toSnakeCase('helloWorld')); // "hello_world"
+console.log(toPascalCase(text));   // "HelloWorldExample"
+```
+
+### Example 3: String Similarity & Diff
+
+```typescript
+import { similarity, diff } from 'string-extn';
+
+const str1 = 'hello';
+const str2 = 'hallo';
+
+console.log(similarity(str1, str2)); // 0.8 (80% similar - one character different)
+console.log(diff('abc', 'bcd'));    // ["-a", "+d"]
+```
+
+### Example 4: Masking Sensitive Data
+
+```typescript
+import { mask, redact } from 'string-extn';
+
+// Mask credit card
+const cardNumber = '4532111111111111';
+console.log(mask(cardNumber, 4)); // "············1111"
+
+// Redact email patterns
+const text = 'Contact john@example.com or jane@test.org';
+console.log(redact(text, [/@\w+\.\w+/g])); // "Contact [REDACTED] or [REDACTED]"
+```
+
+### Example 5: URL & Filename Safe Conversion
+
+```typescript
+import { slugify, filenameSafe } from 'string-extn';
+
+console.log(slugify('Hello World! Welcome'));    // "hello-world-welcome"
+console.log(slugify('Café au Lait'));            // "cafe-au-lait"
+console.log(filenameSafe('File<>Name?.txt'));    // "FileName.txt"
+```
+
+### Example 6: String Validation
+
+```typescript
+import { 
+  isEmail, isURL, isStrongPassword, isIPv4, 
+  isPalindrome, isJSON 
+} from 'string-extn';
+
+console.log(isEmail('user@example.com'));        // true
+console.log(isURL('https://example.com'));       // true
+console.log(isStrongPassword('MyPass@123'));     // true
+console.log(isIPv4('192.168.1.1'));             // true
+console.log(isPalindrome('A man a plan a canal Panama')); // true
+console.log(isJSON('{"key":"value"}'));         // true
+```
+
+### Example 7: Emoji Handling with Unicode
+
+```typescript
+import { lengthUnicode, unicodeSlice, reverseUnicode } from 'string-extn';
+
+const message = 'Hello 👨‍👩‍👧‍👦 World 🇺🇸';
+
+console.log(lengthUnicode(message));  // Correctly counts family emoji as 1
+console.log(unicodeSlice(message, 6, 8)); // "👨‍👩‍👧‍👦 "
+console.log(reverseUnicode(message)); // Preserves emoji integrity
+```
+
+### Example 3: Function Composition
+
+```typescript
+import { compose } from 'string-extn';
+
+const capitalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);
+const addPrefix = (s: string) => 'Hello, ' + s;
+const addExclamation = (s: string) => s + '!';
+
+const greet = compose(addExclamation, addPrefix, capitalize);
+console.log(greet('world')); // "Hello, World!"
+```
+
+---
+
+## Testing
+
+### Run the Test Suite
+
+```bash
+npm test
+```
+
+### Build the Library
+
+```bash
+npm run build
+```
+
+This generates compiled JavaScript in the `dist/` folder.
+
+### Link Locally for Testing
+
+```bash
+# In the string-extn folder
+npm link
+
+# In your test project folder
+npm link string-extn
+```
+
+---
+
+### Development Commands
+
+```bash
+npm install     # Install dependencies
+npm run build   # Build the library
+npm test        # Run tests
+npm link        # Link for local testing
+```
+
+---
+
+## License
+
+MIT © Balaji Katta Venkatarathnam
+

package/dist/case.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Converts a string to camelCase format.
+ *
+ * @param input - The input string to convert (can be kebab-case, snake_case, or space-separated)
+ * @returns The string converted to camelCase (first letter lowercase, subsequent words capitalized)
+ *
+ * @example
+ * toCamelCase("hello-world") // returns "helloWorld"
+ * toCamelCase("hello_world") // returns "helloWorld"
+ * toCamelCase("hello world") // returns "helloWorld"
+ */
+export declare function toCamelCase(input: string): string;
+/**
+ * Converts a string to kebab-case format.
+ *
+ * @param input - The input string to convert (can be camelCase, snake_case, or space-separated)
+ * @returns The string converted to kebab-case (lowercase with hyphens between words)
+ *
+ * @example
+ * toKebabCase("helloWorld") // returns "hello-world"
+ * toKebabCase("hello_world") // returns "hello-world"
+ * toKebabCase("hello world") // returns "hello-world"
+ */
+export declare function toKebabCase(input: string): string;
+/**
+ * Converts a string to snake_case format.
+ *
+ * @param input - The input string to convert (can be camelCase, kebab-case, or space-separated)
+ * @returns The string converted to snake_case (lowercase with underscores between words)
+ *
+ * @example
+ * toSnakeCase("helloWorld") // returns "hello_world"
+ * toSnakeCase("hello-world") // returns "hello_world"
+ * toSnakeCase("hello world") // returns "hello_world"
+ */
+export declare function toSnakeCase(input: string): string;
+/**
+ * Converts a string to Title Case format.
+ *
+ * @param input - The input string to convert
+ * @returns The string converted to Title Case (first letter of each word capitalized, rest lowercase)
+ *
+ * @example
+ * toTitleCase("hello world") // returns "Hello World"
+ * toTitleCase("helloWorld") // returns "HelloWorld"
+ * toTitleCase("hello-world") // returns "Hello-World"
+ */
+export declare function toTitleCase(input: string): string;
+//# sourceMappingURL=case.d.ts.map

package/dist/case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.d.ts","sourceRoot":"","sources":["../src/case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWjD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD"}

package/dist/case.js

@@ -0,0 +1,92 @@
+/**
+ * Converts a string to camelCase format.
+ *
+ * @param input - The input string to convert (can be kebab-case, snake_case, or space-separated)
+ * @returns The string converted to camelCase (first letter lowercase, subsequent words capitalized)
+ *
+ * @example
+ * toCamelCase("hello-world") // returns "helloWorld"
+ * toCamelCase("hello_world") // returns "helloWorld"
+ * toCamelCase("hello world") // returns "helloWorld"
+ */
+export function toCamelCase(input) {
+    return input
+        .toLowerCase()
+        .replace(/[-_\s]+(.)?/g, (_, c) => (c ? c.toUpperCase() : ""))
+        .replace(/^(.)/, (m) => m.toLowerCase());
+}
+/**
+ * Converts a string to kebab-case format.
+ *
+ * @param input - The input string to convert (can be camelCase, snake_case, or space-separated)
+ * @returns The string converted to kebab-case (lowercase with hyphens between words)
+ *
+ * @example
+ * toKebabCase("helloWorld") // returns "hello-world"
+ * toKebabCase("hello_world") // returns "hello-world"
+ * toKebabCase("hello world") // returns "hello-world"
+ */
+export function toKebabCase(input) {
+    // If the input is all uppercase (acronym style), just lowercase it
+    const compact = input.replace(/[_\s-]+/g, "");
+    if (compact && compact === compact.toUpperCase()) {
+        return input.replace(/[_\s]+/g, "-").toLowerCase();
+    }
+    // insert hyphen before every uppercase letter, treat underscores/spaces as separators
+    return input
+        .replace(/([A-Z])/g, "-$1")
+        .replace(/[_\s]+/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$|^-/g, "")
+        .toLowerCase();
+}
+/**
+ * Converts a string to snake_case format.
+ *
+ * @param input - The input string to convert (can be camelCase, kebab-case, or space-separated)
+ * @returns The string converted to snake_case (lowercase with underscores between words)
+ *
+ * @example
+ * toSnakeCase("helloWorld") // returns "hello_world"
+ * toSnakeCase("hello-world") // returns "hello_world"
+ * toSnakeCase("hello world") // returns "hello_world"
+ */
+export function toSnakeCase(input) {
+    const compact = input.replace(/[-\s_]+/g, "");
+    if (compact && compact === compact.toUpperCase()) {
+        return input.replace(/[-\s]+/g, "_").toLowerCase();
+    }
+    return input
+        .replace(/([A-Z])/g, "_$1")
+        .replace(/[-\s]+/g, "_")
+        .replace(/_+/g, "_")
+        .replace(/^_|_$/g, "")
+        .toLowerCase();
+}
+/**
+ * Converts a string to Title Case format.
+ *
+ * @param input - The input string to convert
+ * @returns The string converted to Title Case (first letter of each word capitalized, rest lowercase)
+ *
+ * @example
+ * toTitleCase("hello world") // returns "Hello World"
+ * toTitleCase("helloWorld") // returns "HelloWorld"
+ * toTitleCase("hello-world") // returns "Hello-World"
+ */
+export function toTitleCase(input) {
+    // Preserve separators and multiple spaces; capitalize first char of each word
+    const parts = input.split(/([^A-Za-z0-9]+)/);
+    return parts
+        .map((tok) => {
+        if (/^[A-Za-z0-9_]+$/.test(tok)) {
+            // if token is all uppercase, downcase then capitalize
+            if (tok === tok.toUpperCase())
+                tok = tok.toLowerCase();
+            return tok.charAt(0).toUpperCase() + tok.slice(1);
+        }
+        return tok;
+    })
+        .join("");
+}
+//# sourceMappingURL=case.js.map

package/dist/case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case.js","sourceRoot":"","sources":["../src/case.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;SAC7D,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,mEAAmE;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,OAAO,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,CAAC;IACD,sFAAsF;IACtF,OAAO,KAAK;SACT,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,IAAI,OAAO,KAAK,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;IACrD,CAAC;IACD,OAAO,KAAK;SACT,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC;SAC1B,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,8EAA8E;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7C,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAChC,sDAAsD;YACtD,IAAI,GAAG,KAAK,GAAG,CAAC,WAAW,EAAE;gBAAE,GAAG,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YACvD,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist/core.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Removes leading and trailing whitespace from a string.
+ *
+ * @param str - The string to trim.
+ * @returns A new string with whitespace removed from both ends.
+ *
+ * @example
+ * trim('  hello world  ') // => 'hello world'
+ */
+export declare function trim(str: string): string;
+/**
+ * Pads a string to a specified length by appending characters to the end.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length for the padded string.
+ * @param char - The character to pad with. Defaults to a space (' ').
+ * @returns A new string padded to the specified length, or the original string if already longer.
+ *
+ * @example
+ * pad('hello', 10, '-') // => 'hello-----'
+ * pad('hello', 8) // => 'hello   '
+ */
+export declare function pad(str: string, length: number, char?: string): string;
+/**
+ * Extracts a section of a string.
+ *
+ * @param str - The string to slice.
+ * @param start - The starting index (inclusive). Negative indices count from the end.
+ * @param end - The ending index (exclusive). Negative indices count from the end. Optional.
+ * @returns A new string containing the extracted section.
+ *
+ * @example
+ * slice('hello', 1, 4) // => 'ell'
+ * slice('hello', 2) // => 'llo'
+ * slice('hello', -3) // => 'llo'
+ */
+export declare function slice(str: string, start: number, end?: number): string;
+/**
+ * Repeats a string a specified number of times.
+ *
+ * @param str - The string to repeat.
+ * @param times - The number of times to repeat the string. Must be a non-negative integer.
+ * @returns A new string with the original string repeated.
+ *
+ * @example
+ * repeat('ab', 3) // => 'ababab'
+ * repeat('x', 5) // => 'xxxxx'
+ */
+export declare function repeat(str: string, times: number): string;
+/**
+ * Truncates a string to a maximum length and appends a suffix if truncated.
+ *
+ * @param input - The string to truncate.
+ * @param maxLength - The maximum length of the string (not including the suffix).
+ * @param suffix - The suffix to append if truncated. Defaults to '…'.
+ * @returns The original string if its length is <= maxLength, or the truncated string with suffix appended.
+ *
+ * @example
+ * truncate('hello world', 5) // => 'hello…'
+ * truncate('hi', 10) // => 'hi'
+ * truncate('hello world', 5, '...') // => 'he...'
+ */
+export declare function truncate(input: string, maxLength: number, suffix?: string): string;
+/**
+ * Reverses the order of characters in a string.
+ *
+ * @param str - The string to reverse.
+ * @returns A new string with characters in reverse order.
+ *
+ * @note This function splits the string into individual characters and reverses them.
+ * For Unicode-aware reversal that handles complex grapheme clusters (like emojis with modifiers),
+ * use {@link reverseUnicode} from the unicode module instead.
+ *
+ * @example
+ * reverse('hello') // => 'olleh'
+ * reverse('12345') // => '54321'
+ */
+export declare function reverse(str: string): string;
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,MAAM,CAEnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,SAAQ,GACb,MAAM,CAIR;AAGD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE3C"}