string-extn 1.0.12 → 1.2.0

package/README.md

@@ -18,6 +18,14 @@ A lightweight, TypeScript-first library for **safe and functional string manipul
   - [URL & Filename Safe Conversion](#url--filename-safe-conversion)
   - [String Validation](#string-validation)
   - [Unicode Operations](#unicode-operations)
+  - [Internationalization](#internationalization)
+  - [Security & Sanitization](#security--sanitization)
+  - [Performance Helpers](#performance-helpers)
+  - [Stream Utilities](#stream-utilities)
+  - [Chaining & Fluent API](#chaining--fluent-api)
+  - [Lazy Evaluation](#lazy-evaluation)
+  - [Template Interpolation](#template-interpolation)
+  - [Plugin System](#plugin-system)
 - [Examples](#examples)
 - [Testing](#testing)
 - [License](#license)
@@ -69,6 +77,39 @@ A lightweight, TypeScript-first library for **safe and functional string manipul
 - **unicodeSlice** - Slice strings while respecting grapheme boundaries
 - **reverseUnicode** - Reverse strings with proper emoji and combining mark support
 
+### 🌐 Internationalization
+- **localeCompare** - Locale-aware string comparison with configurable sensitivity
+- **normalizeUnicode** - Normalize strings to NFC/NFD/NFKC/NFKD
+
+### 🔐 Security & Sanitization
+- **escapeHTML** - Escape HTML-reserved characters
+- **escapeSQL** - Escape SQL-sensitive characters
+- **sanitizePath** - Remove traversal and dot segments from paths
+
+### ⚡ Performance Helpers
+- **fastRepeat** - Repeat strings using a fast doubling approach
+- **fastPadLeft** - Left-pad strings using fast repeat
+
+### 🌊 Stream Utilities
+- **chunkString** - Split strings into fixed-size chunks
+- **streamTransform** - Transform chunks and concatenate results
+
+### 🔗 Chaining & Fluent API
+- **chain** - Create chainable string transformations
+- **StringChain** - Fluent wrapper with trim, case, replace, and reverse
+
+### 💤 Lazy Evaluation
+- **lazy** - Build lazy transformation pipelines
+- **LazyString** - Deferred execution via `execute()`
+
+### 🧩 Template Interpolation
+- **template** - Replace {{key}} placeholders from a variable map
+
+### 🧩 Plugin System
+- **registerPlugin** - Register a named string plugin
+- **runPlugin** - Execute a registered plugin
+- **listPlugins** - List registered plugin names
+
 ---
 
 ## Installation
@@ -124,6 +165,48 @@ unicodeSlice(emojiStr, 0, 1);     // "👍🏽"
 reverseUnicode(emojiStr);         // "👍👍🏽"
 ```
 
+### Chaining & Lazy Evaluation
+
+```typescript
+import { chain, lazy } from 'string-extn';
+
+const chained = chain('  Hello  ')
+  .trim()
+  .toLower()
+  .replace('hello', 'hi')
+  .reverse()
+  .valueOf();
+// "ih"
+
+const pipeline = lazy('  Hello  ')
+  .trim()
+  .toUpper();
+
+pipeline.execute(); // "HELLO"
+```
+
+### Template Interpolation
+
+```typescript
+import { template } from 'string-extn';
+
+template('Hello {{name}}', { name: 'Ada' }); // "Hello Ada"
+```
+
+### Plugin System
+
+```typescript
+import { registerPlugin, runPlugin, listPlugins } from 'string-extn';
+
+registerPlugin({
+  name: 'wrap',
+  fn: (input, left: string, right: string) => `${left}${input}${right}`
+});
+
+runPlugin('wrap', 'core', '[', ']'); // "[core]"
+listPlugins(); // ["wrap"]
+```
+
 ---
 
 ## API Reference
@@ -211,6 +294,73 @@ reverseUnicode(emojiStr);         // "👍👍🏽"
 | `unicodeSlice` | `unicodeSlice(str: string, start: number, end?: number): string` | Slices by grapheme boundaries |
 | `reverseUnicode` | `reverseUnicode(str: string): string` | Reverses with emoji/modifier support |
 
+### Internationalization
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `localeCompare` | `localeCompare(a: string, b: string, locale?: string, sensitivity?: "base" | "accent" | "case" | "variant"): number` | Locale-aware string comparison |
+| `normalizeUnicode` | `normalizeUnicode(input: string, form?: "NFC" | "NFD" | "NFKC" | "NFKD"): string` | Unicode normalization |
+
+### Security & Sanitization
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `escapeHTML` | `escapeHTML(input: string): string` | Escapes HTML-reserved characters |
+| `escapeSQL` | `escapeSQL(input: string): string` | Escapes SQL-sensitive characters |
+| `sanitizePath` | `sanitizePath(input: string): string` | Removes traversal and dot segments |
+
+### Performance Helpers
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `fastRepeat` | `fastRepeat(input: string, count: number): string` | Fast string repetition |
+| `fastPadLeft` | `fastPadLeft(input: string, length: number, char?: string): string` | Fast left padding |
+
+### Stream Utilities
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `chunkString` | `chunkString(input: string, size: number): string[]` | Split string into chunks |
+| `streamTransform` | `streamTransform(chunks: string[], transformer: (chunk: string) => string): string` | Transform and concatenate |
+
+### Chaining & Fluent API
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `chain` | `chain(input: string): StringChain` | Create a chainable string wrapper |
+| `StringChain#trim` | `trim(): this` | Trim leading/trailing whitespace |
+| `StringChain#toUpper` | `toUpper(): this` | Uppercase with default locale rules |
+| `StringChain#toLower` | `toLower(): this` | Lowercase with default locale rules |
+| `StringChain#replace` | `replace(search: string | RegExp, replacement: string): this` | Replace with string or RegExp |
+| `StringChain#reverse` | `reverse(): this` | Reverse by Unicode code points |
+| `StringChain#valueOf` | `valueOf(): string` | Get the current value |
+| `StringChain#toString` | `toString(): string` | String coercion output |
+
+### Lazy Evaluation
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `lazy` | `lazy(input: string): LazyString` | Create a lazy string wrapper |
+| `LazyString#map` | `map(fn: (input: string) => string): this` | Register a deferred transform |
+| `LazyString#trim` | `trim(): this` | Register a trim operation |
+| `LazyString#toUpper` | `toUpper(): this` | Register uppercase conversion |
+| `LazyString#toLower` | `toLower(): this` | Register lowercase conversion |
+| `LazyString#execute` | `execute(): string` | Execute all operations in order |
+
+### Template Interpolation
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `template` | `template(input: string, variables: Record<string, any>): string` | Replace {{key}} placeholders |
+
+### Plugin System
+
+| Function | Signature | Description |
+|----------|-----------|-------------|
+| `registerPlugin` | `registerPlugin(plugin: StringExtnPlugin): void` | Register a named plugin |
+| `runPlugin` | `runPlugin(name: string, input: string, ...args: any[]): string` | Execute a plugin by name |
+| `listPlugins` | `listPlugins(): string[]` | List registered plugin names |
+
 ---
 
 ## Examples
@@ -307,7 +457,30 @@ console.log(unicodeSlice(message, 6, 8)); // "👨‍👩‍👧‍👦 "
 console.log(reverseUnicode(message)); // Preserves emoji integrity
 ```
 
-### Example 3: Function Composition
+### Example 8: Internationalization and Security
+
+```typescript
+import { localeCompare, normalizeUnicode, escapeHTML, sanitizePath } from 'string-extn';
+
+console.log(localeCompare('resume', 'résumé', 'en', 'accent')); // Non-zero
+console.log(normalizeUnicode('e\u0301', 'NFC')); // "\u00e9"
+console.log(escapeHTML('<script>alert(1)</script>')); // Escaped HTML entities
+console.log(sanitizePath('/var/../tmp')); // "/var/tmp"
+```
+
+### Example 9: Performance and Streams
+
+```typescript
+import { fastRepeat, fastPadLeft, chunkString, streamTransform } from 'string-extn';
+
+console.log(fastRepeat('ab', 4)); // "abababab"
+console.log(fastPadLeft('7', 3, '0')); // "007"
+
+const chunks = chunkString('abcdef', 2); // ["ab", "cd", "ef"]
+console.log(streamTransform(chunks, c => c.toUpperCase())); // "ABCDEF"
+```
+
+### Example 10: Function Composition
 
 ```typescript
 import { compose } from 'string-extn';

package/dist/chain.d.ts

@@ -0,0 +1,52 @@
+export declare class StringChain {
+    private value;
+    /**
+     * Create a new chain wrapper for the provided input.
+     * @param input The string to wrap for chained operations.
+     */
+    constructor(input: string);
+    /**
+     * Trim leading and trailing whitespace from the current value.
+     * @returns The same chain instance for further chaining.
+     */
+    trim(): this;
+    /**
+     * Convert the current value to uppercase using default locale rules.
+     * @returns The same chain instance for further chaining.
+     */
+    toUpper(): this;
+    /**
+     * Convert the current value to lowercase using default locale rules.
+     * @returns The same chain instance for further chaining.
+     */
+    toLower(): this;
+    /**
+     * Replace a match in the current value using a string or RegExp search.
+     * @param search The string or RegExp pattern to search for.
+     * @param replacement The replacement string (supports RegExp replacement tokens).
+     * @returns The same chain instance for further chaining.
+     */
+    replace(search: string | RegExp, replacement: string): this;
+    /**
+     * Reverse the current value by Unicode code points.
+     * @returns The same chain instance for further chaining.
+     */
+    reverse(): this;
+    /**
+     * Get the current value as a string.
+     * @returns The current chained value.
+     */
+    valueOf(): string;
+    /**
+     * Convert the chain to a string for coercion or display.
+     * @returns The current chained value.
+     */
+    toString(): string;
+}
+/**
+ * Create a new `StringChain` instance for the provided input.
+ * @param input The string to wrap for chained operations.
+ * @returns A new `StringChain` instance.
+ */
+export declare function chain(input: string): StringChain;
+//# sourceMappingURL=chain.d.ts.map

package/dist/chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.d.ts","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAS;IAEtB;;;OAGG;gBACS,KAAK,EAAE,MAAM;IAIzB;;;OAGG;IACH,IAAI,IAAI,IAAI;IAKZ;;;OAGG;IACH,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,OAAO,IAAI,IAAI;IAKf;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAK3D;;;OAGG;IACH,OAAO,IAAI,IAAI;IAKf;;;OAGG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAEhD"}

package/dist/chain.js

@@ -0,0 +1,74 @@
+export class StringChain {
+    /**
+     * Create a new chain wrapper for the provided input.
+     * @param input The string to wrap for chained operations.
+     */
+    constructor(input) {
+        this.value = input;
+    }
+    /**
+     * Trim leading and trailing whitespace from the current value.
+     * @returns The same chain instance for further chaining.
+     */
+    trim() {
+        this.value = this.value.trim();
+        return this;
+    }
+    /**
+     * Convert the current value to uppercase using default locale rules.
+     * @returns The same chain instance for further chaining.
+     */
+    toUpper() {
+        this.value = this.value.toUpperCase();
+        return this;
+    }
+    /**
+     * Convert the current value to lowercase using default locale rules.
+     * @returns The same chain instance for further chaining.
+     */
+    toLower() {
+        this.value = this.value.toLowerCase();
+        return this;
+    }
+    /**
+     * Replace a match in the current value using a string or RegExp search.
+     * @param search The string or RegExp pattern to search for.
+     * @param replacement The replacement string (supports RegExp replacement tokens).
+     * @returns The same chain instance for further chaining.
+     */
+    replace(search, replacement) {
+        this.value = this.value.replace(search, replacement);
+        return this;
+    }
+    /**
+     * Reverse the current value by Unicode code points.
+     * @returns The same chain instance for further chaining.
+     */
+    reverse() {
+        this.value = [...this.value].reverse().join("");
+        return this;
+    }
+    /**
+     * Get the current value as a string.
+     * @returns The current chained value.
+     */
+    valueOf() {
+        return this.value;
+    }
+    /**
+     * Convert the chain to a string for coercion or display.
+     * @returns The current chained value.
+     */
+    toString() {
+        return this.value;
+    }
+}
+/**
+ * Create a new `StringChain` instance for the provided input.
+ * @param input The string to wrap for chained operations.
+ * @returns A new `StringChain` instance.
+ */
+export function chain(input) {
+    return new StringChain(input);
+}
+//# sourceMappingURL=chain.js.map

package/dist/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../src/chain.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IAGtB;;;OAGG;IACH,YAAY,KAAa;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAAuB,EAAE,WAAmB;QAClD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa;IACjC,OAAO,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -7,4 +7,11 @@ export * from './mask.js';
 export * from './similarity.js';
 export * from './diff.js';
 export * from './validate.js';
+export * from './intl.js';
+export * from './perf.js';
+export * from './security.js';
+export * from './stream.js';
+export * from './chain.js';
+export * from './lazy.js';
+export * from './plugin.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -7,4 +7,11 @@ export * from './mask.js';
 export * from './similarity.js';
 export * from './diff.js';
 export * from './validate.js';
+export * from './intl.js';
+export * from './perf.js';
+export * from './security.js';
+export * from './stream.js';
+export * from './chain.js';
+export * from './lazy.js';
+export * from './plugin.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/intl.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Compares two strings using locale-aware collation rules.
+ *
+ * @param a - The first string to compare.
+ * @param b - The second string to compare.
+ * @param locale - BCP 47 locale tag used for collation (defaults to "en").
+ * @param sensitivity - Controls how differences in case/diacritics are handled.
+ * @returns A negative number if `a` sorts before `b`, positive if after, or 0 if equal.
+ *
+ * Special behavior: Uses `Intl.Collator`, which provides Unicode-aware comparison.
+ */
+export declare function localeCompare(a: string, b: string, locale?: string, sensitivity?: Intl.CollatorOptions["sensitivity"]): number;
+/**
+ * Normalizes a string to the specified Unicode normalization form.
+ *
+ * @param input - The string to normalize.
+ * @param form - The Unicode normalization form (NFC, NFD, NFKC, or NFKD).
+ * @returns The normalized string.
+ *
+ * Special behavior: Preserves Unicode text while normalizing code point sequences.
+ */
+export declare function normalizeUnicode(input: string, form?: "NFC" | "NFD" | "NFKC" | "NFKD"): string;
+//# sourceMappingURL=intl.d.ts.map

package/dist/intl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.d.ts","sourceRoot":"","sources":["../src/intl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,SAAO,EACb,WAAW,GAAE,IAAI,CAAC,eAAe,CAAC,aAAa,CAAU,GACxD,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAc,GAC5C,MAAM,CAER"}

package/dist/intl.js

@@ -0,0 +1,27 @@
+/**
+ * Compares two strings using locale-aware collation rules.
+ *
+ * @param a - The first string to compare.
+ * @param b - The second string to compare.
+ * @param locale - BCP 47 locale tag used for collation (defaults to "en").
+ * @param sensitivity - Controls how differences in case/diacritics are handled.
+ * @returns A negative number if `a` sorts before `b`, positive if after, or 0 if equal.
+ *
+ * Special behavior: Uses `Intl.Collator`, which provides Unicode-aware comparison.
+ */
+export function localeCompare(a, b, locale = "en", sensitivity = "base") {
+    return new Intl.Collator(locale, { sensitivity }).compare(a, b);
+}
+/**
+ * Normalizes a string to the specified Unicode normalization form.
+ *
+ * @param input - The string to normalize.
+ * @param form - The Unicode normalization form (NFC, NFD, NFKC, or NFKD).
+ * @returns The normalized string.
+ *
+ * Special behavior: Preserves Unicode text while normalizing code point sequences.
+ */
+export function normalizeUnicode(input, form = "NFC") {
+    return input.normalize(form);
+}
+//# sourceMappingURL=intl.js.map

package/dist/intl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intl.js","sourceRoot":"","sources":["../src/intl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,CAAS,EACT,CAAS,EACT,MAAM,GAAG,IAAI,EACb,cAAmD,MAAM;IAEzD,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,OAAwC,KAAK;IAE7C,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/lazy.d.ts

@@ -0,0 +1,42 @@
+export declare class LazyString {
+    private input;
+    private operations;
+    /**
+     * Create a new lazy wrapper for the provided input.
+     * @param input The string to wrap for lazy operations.
+     */
+    constructor(input: string);
+    /**
+     * Register a transformation to run later during execution.
+     * @param fn A function that receives the current value and returns the next value.
+     * @returns The same lazy instance for further chaining.
+     */
+    map(fn: (input: string) => string): this;
+    /**
+     * Register a trim operation that removes surrounding whitespace.
+     * @returns The same lazy instance for further chaining.
+     */
+    trim(): this;
+    /**
+     * Register an uppercase conversion using default locale rules.
+     * @returns The same lazy instance for further chaining.
+     */
+    toUpper(): this;
+    /**
+     * Register a lowercase conversion using default locale rules.
+     * @returns The same lazy instance for further chaining.
+     */
+    toLower(): this;
+    /**
+     * Execute all registered operations in order and return the result.
+     * @returns The final transformed string.
+     */
+    execute(): string;
+}
+/**
+ * Create a new `LazyString` instance for the provided input.
+ * @param input The string to wrap for lazy operations.
+ * @returns A new `LazyString` instance.
+ */
+export declare function lazy(input: string): LazyString;
+//# sourceMappingURL=lazy.d.ts.map

package/dist/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,UAAU,CAAiC;IAEnD;;;OAGG;gBACS,KAAK,EAAE,MAAM;IAIzB;;;;OAIG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI;IAKxC;;;OAGG;IACH,IAAI,IAAI,IAAI;IAIZ;;;OAGG;IACH,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,OAAO,IAAI,IAAI;IAIf;;;OAGG;IACH,OAAO,IAAI,MAAM;CAMlB;AAED;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAE9C"}

package/dist/lazy.js

@@ -0,0 +1,56 @@
+export class LazyString {
+    /**
+     * Create a new lazy wrapper for the provided input.
+     * @param input The string to wrap for lazy operations.
+     */
+    constructor(input) {
+        this.operations = [];
+        this.input = input;
+    }
+    /**
+     * Register a transformation to run later during execution.
+     * @param fn A function that receives the current value and returns the next value.
+     * @returns The same lazy instance for further chaining.
+     */
+    map(fn) {
+        this.operations.push(fn);
+        return this;
+    }
+    /**
+     * Register a trim operation that removes surrounding whitespace.
+     * @returns The same lazy instance for further chaining.
+     */
+    trim() {
+        return this.map(s => s.trim());
+    }
+    /**
+     * Register an uppercase conversion using default locale rules.
+     * @returns The same lazy instance for further chaining.
+     */
+    toUpper() {
+        return this.map(s => s.toUpperCase());
+    }
+    /**
+     * Register a lowercase conversion using default locale rules.
+     * @returns The same lazy instance for further chaining.
+     */
+    toLower() {
+        return this.map(s => s.toLowerCase());
+    }
+    /**
+     * Execute all registered operations in order and return the result.
+     * @returns The final transformed string.
+     */
+    execute() {
+        return this.operations.reduce((acc, fn) => fn(acc), this.input);
+    }
+}
+/**
+ * Create a new `LazyString` instance for the provided input.
+ * @param input The string to wrap for lazy operations.
+ * @returns A new `LazyString` instance.
+ */
+export function lazy(input) {
+    return new LazyString(input);
+}
+//# sourceMappingURL=lazy.js.map

package/dist/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../src/lazy.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAU;IAIrB;;;OAGG;IACH,YAAY,KAAa;QANjB,eAAU,GAA8B,EAAE,CAAC;QAOjD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,EAA6B;QAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAC3B,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,EACpB,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC"}

package/dist/perf.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Repeats a string using a fast doubling technique.
+ *
+ * @param input - The string to repeat.
+ * @param count - The number of times to repeat the string.
+ * @returns The repeated string, or an empty string when count is not positive or not finite.
+ *
+ * Special behavior: Non-integer counts are floored; non-finite or non-positive counts return "".
+ */
+export declare function fastRepeat(input: string, count: number): string;
+/**
+ * Pads the left side of a string to a target length using a fast repeat.
+ *
+ * @param input - The string to pad.
+ * @param length - The desired total length of the result.
+ * @param char - The padding character (defaults to a space).
+ * @returns The padded string, or the original string if already long enough.
+ *
+ * Special behavior: Uses code unit length and does not trim or normalize input.
+ */
+export declare function fastPadLeft(input: string, length: number, char?: string): string;
+//# sourceMappingURL=perf.d.ts.map

package/dist/perf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.d.ts","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAY/D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,SAAM,GACT,MAAM,CAGR"}

package/dist/perf.js

@@ -0,0 +1,39 @@
+/**
+ * Repeats a string using a fast doubling technique.
+ *
+ * @param input - The string to repeat.
+ * @param count - The number of times to repeat the string.
+ * @returns The repeated string, or an empty string when count is not positive or not finite.
+ *
+ * Special behavior: Non-integer counts are floored; non-finite or non-positive counts return "".
+ */
+export function fastRepeat(input, count) {
+    if (!Number.isFinite(count) || count <= 0)
+        return "";
+    let remaining = Math.floor(count);
+    let result = "";
+    let current = input;
+    while (remaining > 0) {
+        if (remaining & 1)
+            result += current;
+        current += current;
+        remaining >>= 1;
+    }
+    return result;
+}
+/**
+ * Pads the left side of a string to a target length using a fast repeat.
+ *
+ * @param input - The string to pad.
+ * @param length - The desired total length of the result.
+ * @param char - The padding character (defaults to a space).
+ * @returns The padded string, or the original string if already long enough.
+ *
+ * Special behavior: Uses code unit length and does not trim or normalize input.
+ */
+export function fastPadLeft(input, length, char = " ") {
+    if (input.length >= length)
+        return input;
+    return fastRepeat(char, length - input.length) + input;
+}
+//# sourceMappingURL=perf.js.map

package/dist/perf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf.js","sourceRoot":"","sources":["../src/perf.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,KAAa;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,SAAS,GAAG,CAAC,EAAE,CAAC;QACrB,IAAI,SAAS,GAAG,CAAC;YAAE,MAAM,IAAI,OAAO,CAAC;QACrC,OAAO,IAAI,OAAO,CAAC;QACnB,SAAS,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,MAAc,EACd,IAAI,GAAG,GAAG;IAEV,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;AACzD,CAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Plugin contract for extending string utilities.
+ */
+export type StringExtnPlugin = {
+    /** The unique plugin name used for registration and lookup. */
+    name: string;
+    /** The function invoked when the plugin runs. */
+    fn: (input: string, ...args: any[]) => string;
+};
+/**
+ * Register a plugin for later execution.
+ * @param plugin The plugin to register.
+ * @throws If a plugin with the same name is already registered.
+ */
+export declare function registerPlugin(plugin: StringExtnPlugin): void;
+/**
+ * Execute a registered plugin by name.
+ * @param name The plugin name to execute.
+ * @param input The input string passed to the plugin.
+ * @param args Additional arguments forwarded to the plugin function.
+ * @returns The plugin's result string.
+ * @throws If the plugin does not exist.
+ */
+export declare function runPlugin(name: string, input: string, ...args: any[]): string;
+/**
+ * List all registered plugin names in registration order.
+ * @returns An array of plugin names.
+ */
+export declare function listPlugins(): string[];
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC;CAC/C,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAM7D;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,IAAI,EAAE,GAAG,EAAE,GACb,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC"}

package/dist/plugin.js

@@ -0,0 +1,35 @@
+const plugins = new Map();
+/**
+ * Register a plugin for later execution.
+ * @param plugin The plugin to register.
+ * @throws If a plugin with the same name is already registered.
+ */
+export function registerPlugin(plugin) {
+    if (plugins.has(plugin.name)) {
+        throw new Error(`Plugin '${plugin.name}' already exists`);
+    }
+    plugins.set(plugin.name, plugin);
+}
+/**
+ * Execute a registered plugin by name.
+ * @param name The plugin name to execute.
+ * @param input The input string passed to the plugin.
+ * @param args Additional arguments forwarded to the plugin function.
+ * @returns The plugin's result string.
+ * @throws If the plugin does not exist.
+ */
+export function runPlugin(name, input, ...args) {
+    const plugin = plugins.get(name);
+    if (!plugin) {
+        throw new Error(`Plugin '${name}' not found`);
+    }
+    return plugin.fn(input, ...args);
+}
+/**
+ * List all registered plugin names in registration order.
+ * @returns An array of plugin names.
+ */
+export function listPlugins() {
+    return Array.from(plugins.keys());
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;AAEpD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAwB;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,WAAW,MAAM,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,KAAa,EACb,GAAG,IAAW;IAEd,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,aAAa,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC"}

package/dist/security.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Escapes HTML-reserved characters to their entity equivalents.
+ *
+ * @param input - The string to escape.
+ * @returns The escaped string with HTML-sensitive characters replaced.
+ *
+ * Special behavior: Escapes `&`, `<`, `>`, `"`, and `'` characters; does not decode entities.
+ */
+export declare function escapeHTML(input: string): string;
+/**
+ * Escapes SQL-sensitive characters by prefixing them with a backslash.
+ *
+ * @param input - The string to escape.
+ * @returns The escaped string with `'`, `"`, `;`, and `\` prefixed by `\`.
+ *
+ * Special behavior: Simple escaping helper; it does not validate SQL or prevent all injection cases.
+ */
+export declare function escapeSQL(input: string): string;
+/**
+ * Sanitizes a path-like string by removing traversal and dot segments.
+ *
+ * @param input - The path string to sanitize.
+ * @returns The sanitized path with `.` and `..` segments removed.
+ *
+ * Special behavior: Preserves a leading separator and normalizes repeated separators.
+ */
+export declare function sanitizePath(input: string): string;
+//# sourceMappingURL=security.d.ts.map

package/dist/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD"}

package/dist/security.js

@@ -0,0 +1,47 @@
+const ESCAPE_MAP = {
+    "&": "&",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#x27;"
+};
+/**
+ * Escapes HTML-reserved characters to their entity equivalents.
+ *
+ * @param input - The string to escape.
+ * @returns The escaped string with HTML-sensitive characters replaced.
+ *
+ * Special behavior: Escapes `&`, `<`, `>`, `"`, and `'` characters; does not decode entities.
+ */
+export function escapeHTML(input) {
+    return input.replace(/[&<>"']/g, char => ESCAPE_MAP[char] ?? char);
+}
+/**
+ * Escapes SQL-sensitive characters by prefixing them with a backslash.
+ *
+ * @param input - The string to escape.
+ * @returns The escaped string with `'`, `"`, `;`, and `\` prefixed by `\`.
+ *
+ * Special behavior: Simple escaping helper; it does not validate SQL or prevent all injection cases.
+ */
+export function escapeSQL(input) {
+    return input.replace(/['";\\]/g, "\\$&");
+}
+/**
+ * Sanitizes a path-like string by removing traversal and dot segments.
+ *
+ * @param input - The path string to sanitize.
+ * @returns The sanitized path with `.` and `..` segments removed.
+ *
+ * Special behavior: Preserves a leading separator and normalizes repeated separators.
+ */
+export function sanitizePath(input) {
+    const separator = input.includes("/") ? "/" : "\\";
+    const hasLeadingSeparator = input.startsWith("/") || input.startsWith("\\");
+    const parts = input
+        .split(/[\\/]+/)
+        .filter(part => part !== "" && part !== "." && part !== "..");
+    const sanitized = parts.join(separator);
+    return hasLeadingSeparator ? `${separator}${sanitized}` : sanitized;
+}
+//# sourceMappingURL=security.js.map

package/dist/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../src/security.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAA2B;IACzC,GAAG,EAAE,OAAO;IACZ,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;CACd,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACnD,MAAM,mBAAmB,GAAG,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,QAAQ,CAAC;SACf,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;IAEhE,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,mBAAmB,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACtE,CAAC"}

package/dist/stream.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Splits a string into an array of fixed-size chunks.
+ *
+ * @param input - The string to split.
+ * @param size - The chunk size in code units; must be a positive, finite number.
+ * @returns An array of chunk strings.
+ *
+ * Special behavior: Throws when size is non-positive or non-finite.
+ */
+export declare function chunkString(input: string, size: number): string[];
+/**
+ * Applies a transformer to each chunk and concatenates the results.
+ *
+ * @param chunks - The list of chunks to transform.
+ * @param transformer - The function applied to each chunk.
+ * @returns The concatenated transformed result.
+ *
+ * Special behavior: Preserves chunk order and performs a simple left-to-right join.
+ */
+export declare function streamTransform(chunks: string[], transformer: (chunk: string) => string): string;
+//# sourceMappingURL=stream.d.ts.map

package/dist/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CASjE;AAGD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC,MAAM,CAMR"}

package/dist/stream.js

@@ -0,0 +1,36 @@
+/**
+ * Splits a string into an array of fixed-size chunks.
+ *
+ * @param input - The string to split.
+ * @param size - The chunk size in code units; must be a positive, finite number.
+ * @returns An array of chunk strings.
+ *
+ * Special behavior: Throws when size is non-positive or non-finite.
+ */
+export function chunkString(input, size) {
+    if (!Number.isFinite(size) || size <= 0) {
+        throw new Error("Chunk size must be a positive number.");
+    }
+    const result = [];
+    for (let i = 0; i < input.length; i += size) {
+        result.push(input.slice(i, i + size));
+    }
+    return result;
+}
+/**
+ * Applies a transformer to each chunk and concatenates the results.
+ *
+ * @param chunks - The list of chunks to transform.
+ * @param transformer - The function applied to each chunk.
+ * @returns The concatenated transformed result.
+ *
+ * Special behavior: Preserves chunk order and performs a simple left-to-right join.
+ */
+export function streamTransform(chunks, transformer) {
+    let result = "";
+    for (const chunk of chunks) {
+        result += transformer(chunk);
+    }
+    return result;
+}
+//# sourceMappingURL=stream.js.map

package/dist/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.js","sourceRoot":"","sources":["../src/stream.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,IAAY;IACrD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAGD;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAgB,EAChB,WAAsC;IAEtC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/template.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Replace {{key}} placeholders in a template string with values from a map.
+ * @param input The template string containing {{key}} placeholders.
+ * @param variables A map of placeholder keys to values.
+ * @returns The rendered string with placeholders replaced.
+ * @remarks Keys are trimmed inside braces. Missing values (undefined) become an empty string.
+ */
+export declare function template(input: string, variables: Record<string, any>): string;
+//# sourceMappingURL=template.d.ts.map

package/dist/template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,MAAM,CAKR"}

package/dist/template.js

@@ -0,0 +1,14 @@
+/**
+ * Replace {{key}} placeholders in a template string with values from a map.
+ * @param input The template string containing {{key}} placeholders.
+ * @param variables A map of placeholder keys to values.
+ * @returns The rendered string with placeholders replaced.
+ * @remarks Keys are trimmed inside braces. Missing values (undefined) become an empty string.
+ */
+export function template(input, variables) {
+    return input.replace(/\{\{(.*?)\}\}/g, (_, key) => {
+        const value = variables[key.trim()];
+        return value !== undefined ? String(value) : "";
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../src/template.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAa,EACb,SAA8B;IAE9B,OAAO,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "string-extn",
-  "version": "1.0.12",
+  "version": "1.2.0",
   "description": "Extended string utility functions for JavaScript and TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -16,6 +16,17 @@
     "string",
     "utility",
     "functional",
+    "security",
+    "html-escape",
+    "sql-escape",
+    "path-sanitization",
+    "performance",
+    "fast-repeat",
+    "padding",
+    "stream",
+    "chunk",
+    "internationalization",
+    "i18n",
     "unicode",
     "typescript",
     "string-manipulation",
@@ -42,20 +53,18 @@
   },
   "homepage": "https://github.com/balaji-kv/string-extn#readme",
   "dependencies": {
+    "glob": "^13.0.6",
     "grapheme-splitter": "^1.0.4",
     "typescript": "^5.9.3"
   },
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.1.2",
-    "ts-node": "^10.9.2",
-    "glob": "^10.3.10"
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.2"
   },
   "overrides": {
-    "glob": "^10.3.10",
-    "inflight": {
-      "glob": "^10.3.10"
-    }
+    "minimatch": "^10.2.2",
+    "glob": "^13.0.6"
   }
 }