string-extn 1.1.0 → 1.2.0

package/README.md

@@ -22,6 +22,10 @@ A lightweight, TypeScript-first library for **safe and functional string manipul
   - [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)
@@ -90,6 +94,22 @@ A lightweight, TypeScript-first library for **safe and functional string manipul
 - **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
@@ -145,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
@@ -261,6 +323,44 @@ reverseUnicode(emojiStr);         // "👍👍🏽"
 | `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

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

@@ -11,4 +11,7 @@ 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;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,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

@@ -11,4 +11,7 @@ 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;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,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/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/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/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.1.0",
+  "version": "1.2.0",
   "description": "Extended string utility functions for JavaScript and TypeScript.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -53,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"
   }
 }