@pithos/core 2.0.0

package/dist/taphos/string/pad.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pads string on the left and right sides if it's shorter than length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length.
+ * @param chars - The string used as padding.
+ * @returns The padded string.
+ * @deprecated Use `padStart` and `padEnd` combination directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart | String.padStart() - MDN}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd | String.padEnd() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * pad('abc', 8);           // => '  abc   '
+ * pad('abc', 8, '_-');     // => '_-abc_-_'
+ * pad('abc', 3);           // => 'abc'
+ *
+ * // ✅ Recommended approach
+ * const str = 'abc';
+ * const length = 8;
+ * const padLength = Math.max(0, length - str.length);
+ * const leftPad = Math.floor(padLength / 2);
+ * const rightPad = padLength - leftPad;
+ * str.padStart(str.length + leftPad).padEnd(length);
+ * // => '  abc   '
+ * ```
+ */
+export declare function pad(str: string | null | undefined, length: number | null | undefined, chars?: string): string;
+//# sourceMappingURL=pad.d.ts.map

package/dist/taphos/string/pad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/pad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,GAAG,CACjB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAEjC,KAAK,SAAM,GACV,MAAM,CAoBR"}

package/dist/taphos/string/pad.js

@@ -0,0 +1,49 @@
+/**
+ * Pads string on the left and right sides if it's shorter than length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length.
+ * @param chars - The string used as padding.
+ * @returns The padded string.
+ * @deprecated Use `padStart` and `padEnd` combination directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart | String.padStart() - MDN}
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd | String.padEnd() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * pad('abc', 8);           // => '  abc   '
+ * pad('abc', 8, '_-');     // => '_-abc_-_'
+ * pad('abc', 3);           // => 'abc'
+ *
+ * // ✅ Recommended approach
+ * const str = 'abc';
+ * const length = 8;
+ * const padLength = Math.max(0, length - str.length);
+ * const leftPad = Math.floor(padLength / 2);
+ * const rightPad = padLength - leftPad;
+ * str.padStart(str.length + leftPad).padEnd(length);
+ * // => '  abc   '
+ * ```
+ */
+export function pad(str, length, 
+// Stryker disable next-line StringLiteral: Empty string default is handled by `chars || " "` below
+chars = " ") {
+    const s = str ?? "";
+    const len = length ?? 0;
+    // Stryker disable next-line EqualityOperator: When s.length === len, no padding needed, returning s is correct
+    if (s.length >= len) {
+        return s;
+    }
+    const padLength = len - s.length;
+    const leftPad = Math.floor(padLength / 2);
+    const rightPad = padLength - leftPad;
+    const padChar = chars || " ";
+    // Stryker disable next-line ArithmeticOperator,MethodExpression: Division vs multiplication doesn't matter because slice() trims to exact length
+    const leftStr = padChar.repeat(Math.ceil(leftPad / padChar.length)).slice(0, leftPad);
+    // Stryker disable next-line ArithmeticOperator,MethodExpression: Division vs multiplication doesn't matter because slice() trims to exact length
+    const rightStr = padChar.repeat(Math.ceil(rightPad / padChar.length)).slice(0, rightPad);
+    return leftStr + s + rightStr;
+}
+//# sourceMappingURL=pad.js.map

package/dist/taphos/string/pad.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pad.js","sourceRoot":"","sources":["../../../src/taphos/string/pad.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,GAAG,CACjB,GAA8B,EAC9B,MAAiC;AACjC,mGAAmG;AACnG,KAAK,GAAG,GAAG;IAEX,MAAM,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;IACpB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,CAAC;IAExB,+GAA+G;IAC/G,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IAErC,MAAM,OAAO,GAAG,KAAK,IAAI,GAAG,CAAC;IAC7B,iJAAiJ;IACjJ,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACtF,iJAAiJ;IACjJ,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEzF,OAAO,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC;AAChC,CAAC"}

package/dist/taphos/string/padEnd.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pads the end of a string with a given character until it reaches the specified length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param padString - The string to use for padding.
+ * @returns The padded string.
+ * @deprecated Use `string.padEnd()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd | String.padEnd() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_padend | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * padEnd('hello', 10);      // => 'hello     '
+ * padEnd('hello', 10, '0'); // => 'hello00000'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.padEnd(10);      // => 'hello     '
+ * 'hello'.padEnd(10, '0'); // => 'hello00000'
+ * ```
+ */
+export declare function padEnd(str: string | null | undefined, length: number | null | undefined, padString?: string): string;
+//# sourceMappingURL=padEnd.d.ts.map

package/dist/taphos/string/padEnd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padEnd.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/padEnd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,SAAS,SAAM,GACd,MAAM,CAER"}

package/dist/taphos/string/padEnd.js

@@ -0,0 +1,27 @@
+/**
+ * Pads the end of a string with a given character until it reaches the specified length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param padString - The string to use for padding.
+ * @returns The padded string.
+ * @deprecated Use `string.padEnd()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd | String.padEnd() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_padend | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * padEnd('hello', 10);      // => 'hello     '
+ * padEnd('hello', 10, '0'); // => 'hello00000'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.padEnd(10);      // => 'hello     '
+ * 'hello'.padEnd(10, '0'); // => 'hello00000'
+ * ```
+ */
+export function padEnd(str, length, padString = " ") {
+    return (str ?? "").padEnd(length ?? 0, padString);
+}
+//# sourceMappingURL=padEnd.js.map

package/dist/taphos/string/padEnd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"padEnd.js","sourceRoot":"","sources":["../../../src/taphos/string/padEnd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,MAAM,CACpB,GAA8B,EAC9B,MAAiC,EACjC,SAAS,GAAG,GAAG;IAEf,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}

package/dist/taphos/string/padStart.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pads the start of a string with a given character until it reaches the specified length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param padString - The string to use for padding.
+ * @returns The padded string.
+ * @deprecated Use `string.padStart()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart | String.padStart() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_padstart | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * padStart('hello', 10);      // => '     hello'
+ * padStart('42', 5, '0');     // => '00042'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.padStart(10);      // => '     hello'
+ * '42'.padStart(5, '0');     // => '00042'
+ * ```
+ */
+export declare function padStart(str: string | null | undefined, length: number | null | undefined, padString?: string): string;
+//# sourceMappingURL=padStart.d.ts.map

package/dist/taphos/string/padStart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"padStart.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/padStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,SAAS,SAAM,GACd,MAAM,CAER"}

package/dist/taphos/string/padStart.js

@@ -0,0 +1,27 @@
+/**
+ * Pads the start of a string with a given character until it reaches the specified length.
+ *
+ * @param str - The string to pad.
+ * @param length - The target length of the padded string.
+ * @param padString - The string to use for padding.
+ * @returns The padded string.
+ * @deprecated Use `string.padStart()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart | String.padStart() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_padstart | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * padStart('hello', 10);      // => '     hello'
+ * padStart('42', 5, '0');     // => '00042'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.padStart(10);      // => '     hello'
+ * '42'.padStart(5, '0');     // => '00042'
+ * ```
+ */
+export function padStart(str, length, padString = " ") {
+    return (str ?? "").padStart(length ?? 0, padString);
+}
+//# sourceMappingURL=padStart.js.map

package/dist/taphos/string/padStart.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"padStart.js","sourceRoot":"","sources":["../../../src/taphos/string/padStart.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,QAAQ,CACtB,GAA8B,EAC9B,MAAiC,EACjC,SAAS,GAAG,GAAG;IAEf,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC"}

package/dist/taphos/string/parseInteger.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Parses a string into an integer of the specified radix.
+ *
+ * @param str - The string to parse.
+ * @param radix - The radix (base) to use for parsing. Defaults to 10.
+ * @returns The parsed integer, or NaN if parsing fails.
+ * @deprecated Use `parseInt()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseInt | parseInt() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_parseint | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * parseInteger('42');       // => 42
+ * parseInteger('10', 2);    // => 2 (binary)
+ * parseInteger('ff', 16);   // => 255 (hex)
+ *
+ * // ✅ Recommended approach
+ * parseInt('42', 10);       // => 42
+ * parseInt('10', 2);        // => 2 (binary)
+ * parseInt('ff', 16);       // => 255 (hex)
+ * ```
+ */
+export declare function parseInteger(str: string | null | undefined, radix?: number): number;
+//# sourceMappingURL=parseInteger.d.ts.map

package/dist/taphos/string/parseInteger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInteger.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/parseInteger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,KAAK,SAAK,GACT,MAAM,CAGR"}

package/dist/taphos/string/parseInteger.js

@@ -0,0 +1,29 @@
+/**
+ * Parses a string into an integer of the specified radix.
+ *
+ * @param str - The string to parse.
+ * @param radix - The radix (base) to use for parsing. Defaults to 10.
+ * @returns The parsed integer, or NaN if parsing fails.
+ * @deprecated Use `parseInt()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/parseInt | parseInt() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_parseint | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * parseInteger('42');       // => 42
+ * parseInteger('10', 2);    // => 2 (binary)
+ * parseInteger('ff', 16);   // => 255 (hex)
+ *
+ * // ✅ Recommended approach
+ * parseInt('42', 10);       // => 42
+ * parseInt('10', 2);        // => 2 (binary)
+ * parseInt('ff', 16);       // => 255 (hex)
+ * ```
+ */
+export function parseInteger(str, radix = 10) {
+    // Stryker disable next-line StringLiteral: parseInt("", radix) and parseInt("any-string", radix) both return NaN for invalid input
+    return parseInt(str ?? "", radix);
+}
+//# sourceMappingURL=parseInteger.js.map

package/dist/taphos/string/parseInteger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseInteger.js","sourceRoot":"","sources":["../../../src/taphos/string/parseInteger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,YAAY,CAC1B,GAA8B,EAC9B,KAAK,GAAG,EAAE;IAEV,mIAAmI;IACnI,OAAO,QAAQ,CAAC,GAAG,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/taphos/string/repeat.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Repeats a string a specified number of times.
+ *
+ * @param str - The string to repeat.
+ * @param count - The number of times to repeat the string.
+ * @returns The repeated string.
+ * @deprecated Use `string.repeat()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/repeat | String.repeat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_repeat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * repeat('hello', 3); // => 'hellohellohello'
+ * repeat('-', 10);    // => '----------'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.repeat(3); // => 'hellohellohello'
+ * '-'.repeat(10);    // => '----------'
+ * ```
+ */
+export declare function repeat(str: string | null | undefined, count: number | null | undefined): string;
+//# sourceMappingURL=repeat.d.ts.map

package/dist/taphos/string/repeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/repeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CACpB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,MAAM,CAMR"}

package/dist/taphos/string/repeat.js

@@ -0,0 +1,30 @@
+/**
+ * Repeats a string a specified number of times.
+ *
+ * @param str - The string to repeat.
+ * @param count - The number of times to repeat the string.
+ * @returns The repeated string.
+ * @deprecated Use `string.repeat()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/repeat | String.repeat() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_repeat | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * repeat('hello', 3); // => 'hellohellohello'
+ * repeat('-', 10);    // => '----------'
+ *
+ * // ✅ Recommended approach
+ * 'hello'.repeat(3); // => 'hellohellohello'
+ * '-'.repeat(10);    // => '----------'
+ * ```
+ */
+export function repeat(str, count) {
+    // Stryker disable next-line ConditionalExpression,EqualityOperator: typeof check is defensive; count <= 0 vs count < 0 both return "" (repeat(0) === "")
+    if (!str || typeof count !== "number" || count < 0) {
+        return "";
+    }
+    return str.repeat(count);
+}
+//# sourceMappingURL=repeat.js.map

package/dist/taphos/string/repeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeat.js","sourceRoot":"","sources":["../../../src/taphos/string/repeat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,MAAM,CACpB,GAA8B,EAC9B,KAAgC;IAEhC,yJAAyJ;IACzJ,IAAI,CAAC,GAAG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACnD,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC"}

package/dist/taphos/string/replace.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Replaces matches for pattern in string with replacement.
+ *
+ * @param str - The string to modify.
+ * @param pattern - The pattern to replace.
+ * @param replacement - The replacement string.
+ * @returns The modified string.
+ * @deprecated Use `string.replace()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace | String.replace() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_replace | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * replace('hello world', 'world', 'there');  // => 'hello there'
+ * replace('foo bar foo', /foo/g, 'baz');     // => 'baz bar baz'
+ *
+ * // ✅ Recommended approach
+ * 'hello world'.replace('world', 'there');   // => 'hello there'
+ * 'foo bar foo'.replace(/foo/g, 'baz');      // => 'baz bar baz'
+ * ```
+ */
+export declare function replace(str: string | null | undefined, pattern: string | RegExp, replacement: string): string;
+//# sourceMappingURL=replace.d.ts.map

package/dist/taphos/string/replace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/replace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,EAAE,MAAM,GAClB,MAAM,CAER"}

package/dist/taphos/string/replace.js

@@ -0,0 +1,27 @@
+/**
+ * Replaces matches for pattern in string with replacement.
+ *
+ * @param str - The string to modify.
+ * @param pattern - The pattern to replace.
+ * @param replacement - The replacement string.
+ * @returns The modified string.
+ * @deprecated Use `string.replace()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/replace | String.replace() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_replace | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * replace('hello world', 'world', 'there');  // => 'hello there'
+ * replace('foo bar foo', /foo/g, 'baz');     // => 'baz bar baz'
+ *
+ * // ✅ Recommended approach
+ * 'hello world'.replace('world', 'there');   // => 'hello there'
+ * 'foo bar foo'.replace(/foo/g, 'baz');      // => 'baz bar baz'
+ * ```
+ */
+export function replace(str, pattern, replacement) {
+    return (str ?? "").replace(pattern, replacement);
+}
+//# sourceMappingURL=replace.js.map

package/dist/taphos/string/replace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replace.js","sourceRoot":"","sources":["../../../src/taphos/string/replace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CACrB,GAA8B,EAC9B,OAAwB,EACxB,WAAmB;IAEnB,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AACnD,CAAC"}

package/dist/taphos/string/split.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Splits a string by separator.
+ *
+ * @param str - The string to split.
+ * @param separator - The separator pattern.
+ * @param limit - The maximum number of splits.
+ * @returns An array of string segments.
+ * @deprecated Use `string.split()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/split | String.split() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_split | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * split('a-b-c', '-');      // => ['a', 'b', 'c']
+ * split('a-b-c', '-', 2);   // => ['a', 'b']
+ *
+ * // ✅ Recommended approach
+ * 'a-b-c'.split('-');       // => ['a', 'b', 'c']
+ * 'a-b-c'.split('-', 2);    // => ['a', 'b']
+ * ```
+ */
+export declare function split(str: string | null | undefined, separator: string | RegExp, limit?: number): string[];
+//# sourceMappingURL=split.d.ts.map

package/dist/taphos/string/split.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/split.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,EAAE,CAEV"}

package/dist/taphos/string/split.js

@@ -0,0 +1,27 @@
+/**
+ * Splits a string by separator.
+ *
+ * @param str - The string to split.
+ * @param separator - The separator pattern.
+ * @param limit - The maximum number of splits.
+ * @returns An array of string segments.
+ * @deprecated Use `string.split()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/split | String.split() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_split | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * split('a-b-c', '-');      // => ['a', 'b', 'c']
+ * split('a-b-c', '-', 2);   // => ['a', 'b']
+ *
+ * // ✅ Recommended approach
+ * 'a-b-c'.split('-');       // => ['a', 'b', 'c']
+ * 'a-b-c'.split('-', 2);    // => ['a', 'b']
+ * ```
+ */
+export function split(str, separator, limit) {
+    return (str ?? "").split(separator, limit);
+}
+//# sourceMappingURL=split.js.map

package/dist/taphos/string/split.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"split.js","sourceRoot":"","sources":["../../../src/taphos/string/split.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,KAAK,CACnB,GAA8B,EAC9B,SAA0B,EAC1B,KAAc;IAEd,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/taphos/string/startsWith.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Checks if a string starts with a given prefix.
+ *
+ * @param str - The string to check.
+ * @param prefix - The prefix to search for.
+ * @param position - The position to start searching from.
+ * @returns `true` if the string starts with the prefix, `false` otherwise.
+ * @deprecated Use `string.startsWith()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith | String.startsWith() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_startswith | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * startsWith('hello world', 'hello');    // => true
+ * startsWith('hello world', 'world', 6); // => true
+ *
+ * // ✅ Recommended approach
+ * 'hello world'.startsWith('hello');    // => true
+ * 'hello world'.startsWith('world', 6); // => true
+ * ```
+ */
+export declare function startsWith(str: string | null | undefined, prefix: string | null | undefined, position?: number): boolean;
+//# sourceMappingURL=startsWith.d.ts.map

package/dist/taphos/string/startsWith.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startsWith.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/startsWith.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjC,QAAQ,GAAE,MAAU,GACnB,OAAO,CAIT"}

package/dist/taphos/string/startsWith.js

@@ -0,0 +1,30 @@
+/**
+ * Checks if a string starts with a given prefix.
+ *
+ * @param str - The string to check.
+ * @param prefix - The prefix to search for.
+ * @param position - The position to start searching from.
+ * @returns `true` if the string starts with the prefix, `false` otherwise.
+ * @deprecated Use `string.startsWith()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/startsWith | String.startsWith() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_startswith | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * startsWith('hello world', 'hello');    // => true
+ * startsWith('hello world', 'world', 6); // => true
+ *
+ * // ✅ Recommended approach
+ * 'hello world'.startsWith('hello');    // => true
+ * 'hello world'.startsWith('world', 6); // => true
+ * ```
+ */
+export function startsWith(str, prefix, position = 0) {
+    // Stryker disable next-line ConditionalExpression: Native startsWith converts null to "null" string, so the null check is defensive but not strictly necessary
+    if (str == null || prefix == null)
+        return false;
+    return str.startsWith(prefix, position);
+}
+//# sourceMappingURL=startsWith.js.map

package/dist/taphos/string/startsWith.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startsWith.js","sourceRoot":"","sources":["../../../src/taphos/string/startsWith.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,UAAU,CACxB,GAA8B,EAC9B,MAAiC,EACjC,WAAmB,CAAC;IAEpB,+JAA+J;IAC/J,IAAI,GAAG,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

package/dist/taphos/string/toLower.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts a string to lowercase.
+ *
+ * @param str - The string to convert to lowercase.
+ * @returns The string converted to lowercase.
+ * @deprecated Use `string.toLowerCase()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase | String.toLowerCase() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_tolowercase | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * toLower('HELLO WORLD'); // => 'hello world'
+ *
+ * // ✅ Recommended approach
+ * 'HELLO WORLD'.toLowerCase(); // => 'hello world'
+ * ```
+ */
+export declare function toLower(str: string | null | undefined): string;
+//# sourceMappingURL=toLower.d.ts.map

package/dist/taphos/string/toLower.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toLower.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/toLower.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE9D"}

package/dist/taphos/string/toLower.js

@@ -0,0 +1,23 @@
+/**
+ * Converts a string to lowercase.
+ *
+ * @param str - The string to convert to lowercase.
+ * @returns The string converted to lowercase.
+ * @deprecated Use `string.toLowerCase()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toLowerCase | String.toLowerCase() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_tolowercase | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * toLower('HELLO WORLD'); // => 'hello world'
+ *
+ * // ✅ Recommended approach
+ * 'HELLO WORLD'.toLowerCase(); // => 'hello world'
+ * ```
+ */
+export function toLower(str) {
+    return str?.toLowerCase() ?? "";
+}
+//# sourceMappingURL=toLower.js.map

package/dist/taphos/string/toLower.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toLower.js","sourceRoot":"","sources":["../../../src/taphos/string/toLower.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,OAAO,CAAC,GAA8B;IACpD,OAAO,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/taphos/string/toUpper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Converts a string to uppercase.
+ *
+ * @param str - The string to convert to uppercase.
+ * @returns The string converted to uppercase.
+ * @deprecated Use `string.toUpperCase()` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase | String.toUpperCase() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_string_touppercase | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * toUpper('hello world'); // => 'HELLO WORLD'
+ *
+ * // ✅ Recommended approach
+ * 'hello world'.toUpperCase(); // => 'HELLO WORLD'
+ * ```
+ */
+export declare function toUpper(str: string | null | undefined): string;
+//# sourceMappingURL=toUpper.d.ts.map

package/dist/taphos/string/toUpper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toUpper.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/toUpper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAE9D"}