@pithos/core 2.0.0

package/dist/taphos/string/toUpper.js

@@ -0,0 +1,23 @@
+/**
+ * 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 function toUpper(str) {
+    return str?.toUpperCase() ?? "";
+}
+//# sourceMappingURL=toUpper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toUpper.js","sourceRoot":"","sources":["../../../src/taphos/string/toUpper.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/trim.d.ts

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

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

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

package/dist/taphos/string/trim.js

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

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

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

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

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

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

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

package/dist/taphos/string/trimEnd.js

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

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

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

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

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

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

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

package/dist/taphos/string/trimStart.js

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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Converts the first character of a string to uppercase and the rest to lowercase.
+ *
+ * @param str - The string to convert.
+ * @returns The string with its first character converted to uppercase and the rest lowercased.
+ * @deprecated Use `capitalize` from Arkhe directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase | String.toUpperCase() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * upperFirst('hello'); // => 'Hello'
+ * upperFirst('HELLO'); // => 'Hello'
+ *
+ * // ✅ Recommended approach
+ * import { capitalize } from 'pithos/arkhe/string/capitalize';
+ * capitalize('hello'); // => 'Hello'
+ * ```
+ */
+export declare function upperFirst(str: string): string;
+//# sourceMappingURL=upperFirst.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upperFirst.d.ts","sourceRoot":"","sources":["../../../src/taphos/string/upperFirst.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C"}

package/dist/taphos/string/upperFirst.js

@@ -0,0 +1,27 @@
+/**
+ * Converts the first character of a string to uppercase and the rest to lowercase.
+ *
+ * @param str - The string to convert.
+ * @returns The string with its first character converted to uppercase and the rest lowercased.
+ * @deprecated Use `capitalize` from Arkhe directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/toUpperCase | String.toUpperCase() - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * upperFirst('hello'); // => 'Hello'
+ * upperFirst('HELLO'); // => 'Hello'
+ *
+ * // ✅ Recommended approach
+ * import { capitalize } from 'pithos/arkhe/string/capitalize';
+ * capitalize('hello'); // => 'Hello'
+ * ```
+ */
+export function upperFirst(str) {
+    // Stryker disable next-line ConditionalExpression: Fast-path optimization - charAt(0) and slice(1) on empty string produce identical "" result
+    if (str.length === 0)
+        return str;
+    return str.charAt(0).toUpperCase() + str.slice(1).toLowerCase();
+}
+//# sourceMappingURL=upperFirst.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upperFirst.js","sourceRoot":"","sources":["../../../src/taphos/string/upperFirst.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW;IAClC,+IAA+I;IAC/I,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACjC,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AACpE,CAAC"}

package/dist/taphos/util/attempt.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Attempts to invoke func, returning either the result or the caught error.
+ *
+ * @template T - The return type of the function.
+ * @param func - The function to attempt.
+ * @param args - The arguments to invoke the function with.
+ * @returns The result of the function or the caught error.
+ * @deprecated Use try/catch directly or Zygos Result pattern instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch | try...catch - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const result = attempt(JSON.parse, '{"a":1}');
+ * if (result instanceof Error) {
+ *   console.error('Parse failed:', result);
+ * } else {
+ *   console.log('Parsed:', result);
+ * }
+ *
+ * // ✅ Recommended approach (try/catch)
+ * try {
+ *   const result = JSON.parse('{"a":1}');
+ *   console.log('Parsed:', result);
+ * } catch (error) {
+ *   console.error('Parse failed:', error);
+ * }
+ *
+ * // ✅ Recommended approach (Zygos Result)
+ * import { tryCatch } from '@pithos/zygos';
+ *
+ * const result = tryCatch(() => JSON.parse('{"a":1}'));
+ * if (result.isOk()) {
+ *   console.log('Parsed:', result.value);
+ * } else {
+ *   console.error('Parse failed:', result.error);
+ * }
+ * ```
+ */
+export declare function attempt<T>(func: (...args: unknown[]) => T, ...args: unknown[]): T | Error;
+//# sourceMappingURL=attempt.d.ts.map

package/dist/taphos/util/attempt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.d.ts","sourceRoot":"","sources":["../../../src/taphos/util/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACvB,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAC/B,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,CAAC,GAAG,KAAK,CAMX"}

package/dist/taphos/util/attempt.js

@@ -0,0 +1,49 @@
+/**
+ * Attempts to invoke func, returning either the result or the caught error.
+ *
+ * @template T - The return type of the function.
+ * @param func - The function to attempt.
+ * @param args - The arguments to invoke the function with.
+ * @returns The result of the function or the caught error.
+ * @deprecated Use try/catch directly or Zygos Result pattern instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch | try...catch - MDN}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const result = attempt(JSON.parse, '{"a":1}');
+ * if (result instanceof Error) {
+ *   console.error('Parse failed:', result);
+ * } else {
+ *   console.log('Parsed:', result);
+ * }
+ *
+ * // ✅ Recommended approach (try/catch)
+ * try {
+ *   const result = JSON.parse('{"a":1}');
+ *   console.log('Parsed:', result);
+ * } catch (error) {
+ *   console.error('Parse failed:', error);
+ * }
+ *
+ * // ✅ Recommended approach (Zygos Result)
+ * import { tryCatch } from '@pithos/zygos';
+ *
+ * const result = tryCatch(() => JSON.parse('{"a":1}'));
+ * if (result.isOk()) {
+ *   console.log('Parsed:', result.value);
+ * } else {
+ *   console.error('Parse failed:', result.error);
+ * }
+ * ```
+ */
+export function attempt(func, ...args) {
+    try {
+        return func(...args);
+    }
+    catch (error) {
+        return error instanceof Error ? error : new Error(String(error));
+    }
+}
+//# sourceMappingURL=attempt.js.map

package/dist/taphos/util/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../../src/taphos/util/attempt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,OAAO,CACrB,IAA+B,EAC/B,GAAG,IAAe;IAElB,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}

package/dist/taphos/util/castArray.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Casts value as an array if it's not one.
+ *
+ * @template T - The type of elements.
+ * @param value - The value to inspect.
+ * @returns The cast array.
+ * @deprecated Use `Array.isArray(value) ? value : [value]` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray | Array.isArray() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_isarray | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * castArray(1);        // => [1]
+ * castArray([1, 2, 3]); // => [1, 2, 3]
+ *
+ * // ✅ Recommended approach
+ * Array.isArray(1) ? 1 : [1];           // => [1]
+ * Array.isArray([1, 2, 3]) ? [1, 2, 3] : [[1, 2, 3]]; // => [1, 2, 3]
+ * ```
+ */
+export declare function castArray<T>(value: T | T[]): T[];
+//# sourceMappingURL=castArray.d.ts.map

package/dist/taphos/util/castArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"castArray.d.ts","sourceRoot":"","sources":["../../../src/taphos/util/castArray.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAEhD"}

package/dist/taphos/util/castArray.js

@@ -0,0 +1,26 @@
+/**
+ * Casts value as an array if it's not one.
+ *
+ * @template T - The type of elements.
+ * @param value - The value to inspect.
+ * @returns The cast array.
+ * @deprecated Use `Array.isArray(value) ? value : [value]` directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/isArray | Array.isArray() - MDN}
+ * @see {@link https://caniuse.com/mdn-javascript_builtins_array_isarray | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * castArray(1);        // => [1]
+ * castArray([1, 2, 3]); // => [1, 2, 3]
+ *
+ * // ✅ Recommended approach
+ * Array.isArray(1) ? 1 : [1];           // => [1]
+ * Array.isArray([1, 2, 3]) ? [1, 2, 3] : [[1, 2, 3]]; // => [1, 2, 3]
+ * ```
+ */
+export function castArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+//# sourceMappingURL=castArray.js.map

package/dist/taphos/util/castArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"castArray.js","sourceRoot":"","sources":["../../../src/taphos/util/castArray.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,SAAS,CAAI,KAAc;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC"}

package/dist/taphos/util/cloneDeep.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Creates a deep clone of a value using the native structuredClone API.
+ *
+ * @template T - The type of the value to clone.
+ * @param value - The value to clone deeply.
+ * @returns A deep clone of the input value.
+ * @deprecated Use the native `structuredClone()` function directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone | structuredClone() - MDN}
+ * @see {@link https://caniuse.com/mdn-api_structuredclone | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const original = { a: 1, b: { c: 2 } };
+ *
+ * // ❌ Deprecated approach
+ * const cloned = cloneDeep(original);
+ * cloned.b.c = 3;
+ * console.log(original.b.c); // 2 (unchanged)
+ *
+ * // ✅ Recommended approach
+ * const clonedNative = structuredClone(original);
+ * clonedNative.b.c = 3;
+ * console.log(original.b.c); // 2 (unchanged)
+ * ```
+ */
+export declare function cloneDeep<T>(value: T): T;
+//# sourceMappingURL=cloneDeep.d.ts.map

package/dist/taphos/util/cloneDeep.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneDeep.d.ts","sourceRoot":"","sources":["../../../src/taphos/util/cloneDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAExC"}

package/dist/taphos/util/cloneDeep.js

@@ -0,0 +1,30 @@
+/**
+ * Creates a deep clone of a value using the native structuredClone API.
+ *
+ * @template T - The type of the value to clone.
+ * @param value - The value to clone deeply.
+ * @returns A deep clone of the input value.
+ * @deprecated Use the native `structuredClone()` function directly instead.
+ * @see {@link https://developer.mozilla.org/en-US/docs/Web/API/Window/structuredClone | structuredClone() - MDN}
+ * @see {@link https://caniuse.com/mdn-api_structuredclone | Browser support - Can I Use}
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * const original = { a: 1, b: { c: 2 } };
+ *
+ * // ❌ Deprecated approach
+ * const cloned = cloneDeep(original);
+ * cloned.b.c = 3;
+ * console.log(original.b.c); // 2 (unchanged)
+ *
+ * // ✅ Recommended approach
+ * const clonedNative = structuredClone(original);
+ * clonedNative.b.c = 3;
+ * console.log(original.b.c); // 2 (unchanged)
+ * ```
+ */
+export function cloneDeep(value) {
+    return structuredClone(value);
+}
+//# sourceMappingURL=cloneDeep.js.map

package/dist/taphos/util/cloneDeep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloneDeep.js","sourceRoot":"","sources":["../../../src/taphos/util/cloneDeep.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,SAAS,CAAI,KAAQ;IACjC,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/taphos/util/constant.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Creates a function that returns value.
+ *
+ * @template T - The type of the value.
+ * @param value - The value to return.
+ * @returns A function that returns the value.
+ * @deprecated Use an inline arrow function `() => value` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const getDefault = constant({ user: 'guest' });
+ * getDefault();  // => { user: 'guest' }
+ *
+ * // ✅ Recommended approach
+ * const getDefault = () => ({ user: 'guest' });
+ * getDefault();  // => { user: 'guest' }
+ * ```
+ */
+export declare function constant<T>(value: T): () => T;
+//# sourceMappingURL=constant.d.ts.map

package/dist/taphos/util/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../src/taphos/util/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,CAE7C"}

package/dist/taphos/util/constant.js

@@ -0,0 +1,24 @@
+/**
+ * Creates a function that returns value.
+ *
+ * @template T - The type of the value.
+ * @param value - The value to return.
+ * @returns A function that returns the value.
+ * @deprecated Use an inline arrow function `() => value` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const getDefault = constant({ user: 'guest' });
+ * getDefault();  // => { user: 'guest' }
+ *
+ * // ✅ Recommended approach
+ * const getDefault = () => ({ user: 'guest' });
+ * getDefault();  // => { user: 'guest' }
+ * ```
+ */
+export function constant(value) {
+    return () => value;
+}
+//# sourceMappingURL=constant.js.map

package/dist/taphos/util/constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.js","sourceRoot":"","sources":["../../../src/taphos/util/constant.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAQ;IAClC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC;AACrB,CAAC"}

package/dist/taphos/util/identity.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Returns the first argument it receives.
+ *
+ * @template T - The type of the value.
+ * @param value - Any value.
+ * @returns The value.
+ * @deprecated Use an inline arrow function `(x) => x` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * [1, 2, 3].filter(identity);
+ *
+ * // ✅ Recommended approach
+ * [1, 2, 3].filter(x => x);
+ * // Or simply
+ * [1, 2, 3].filter(Boolean);
+ * ```
+ */
+export declare function identity<T>(value: T): T;
+//# sourceMappingURL=identity.d.ts.map

package/dist/taphos/util/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/taphos/util/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEvC"}

package/dist/taphos/util/identity.js

@@ -0,0 +1,24 @@
+/**
+ * Returns the first argument it receives.
+ *
+ * @template T - The type of the value.
+ * @param value - Any value.
+ * @returns The value.
+ * @deprecated Use an inline arrow function `(x) => x` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * [1, 2, 3].filter(identity);
+ *
+ * // ✅ Recommended approach
+ * [1, 2, 3].filter(x => x);
+ * // Or simply
+ * [1, 2, 3].filter(Boolean);
+ * ```
+ */
+export function identity(value) {
+    return value;
+}
+//# sourceMappingURL=identity.js.map

package/dist/taphos/util/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/taphos/util/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAQ;IAClC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/taphos/util/nthArg.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Creates a function that gets the argument at index n.
+ *
+ * @param n - The index of the argument to return.
+ * @returns A function that returns the nth argument.
+ * @deprecated Use an inline arrow function `(...args) => args[n]` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const getSecond = nthArg(1);
+ * getSecond('a', 'b', 'c');  // => 'b'
+ *
+ * // ✅ Recommended approach
+ * const getSecond = (...args: string[]) => args[1];
+ * getSecond('a', 'b', 'c');  // => 'b'
+ * ```
+ */
+export declare function nthArg(n: number): (...args: unknown[]) => unknown;
+//# sourceMappingURL=nthArg.d.ts.map

package/dist/taphos/util/nthArg.d.ts.map

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

package/dist/taphos/util/nthArg.js

@@ -0,0 +1,26 @@
+/**
+ * Creates a function that gets the argument at index n.
+ *
+ * @param n - The index of the argument to return.
+ * @returns A function that returns the nth argument.
+ * @deprecated Use an inline arrow function `(...args) => args[n]` instead.
+ * @since 2.0.0
+ *
+ * @example
+ * ```typescript
+ * // ❌ Deprecated approach
+ * const getSecond = nthArg(1);
+ * getSecond('a', 'b', 'c');  // => 'b'
+ *
+ * // ✅ Recommended approach
+ * const getSecond = (...args: string[]) => args[1];
+ * getSecond('a', 'b', 'c');  // => 'b'
+ * ```
+ */
+export function nthArg(n) {
+    return (...args) => {
+        const index = n < 0 ? args.length + n : n;
+        return args[index];
+    };
+}
+//# sourceMappingURL=nthArg.js.map

package/dist/taphos/util/nthArg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nthArg.js","sourceRoot":"","sources":["../../../src/taphos/util/nthArg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,OAAO,CAAC,GAAG,IAAe,EAAE,EAAE;QAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}