string-extn 1.0.12 → 1.1.0

package/README.md

@@ -18,6 +18,10 @@ 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)
 - [Examples](#examples)
 - [Testing](#testing)
 - [License](#license)
@@ -69,6 +73,23 @@ 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
+
 ---
 
 ## Installation
@@ -211,6 +232,35 @@ 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 |
+
 ---
 
 ## Examples
@@ -307,7 +357,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/index.d.ts

@@ -7,4 +7,8 @@ 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';
 //# 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"}

package/dist/index.js

@@ -7,4 +7,8 @@ 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';
 //# 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"}

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/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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "string-extn",
-  "version": "1.0.12",
+  "version": "1.1.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",