@stryke/helpers 0.9.35 → 0.9.36

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 # Changelog for Stryke - Helpers
 
+## [0.9.35](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.35) (01/16/2026)
+
+### Updated Dependencies
+
+- Updated **type-checks** to **v0.5.18**
+- Updated **convert** to **v0.6.33**
+- Updated **types** to **v0.10.32**
+
 ## [0.9.34](https://github.com/storm-software/stryke/releases/tag/helpers%400.9.34) (01/15/2026)
 
 ### Updated Dependencies

package/dist/arg-identity.cjs

@@ -1 +1,17 @@
-function e(e){return e}exports.argIdentity=e;
+
+//#region src/arg-identity.ts
+/**
+* This method returns the first argument provided to it.
+*
+* @remarks
+* For more info, please see {@link https://lodash.com/docs/4.17.15#identity | the original Lodash documentation}.
+*
+* @param value - The value to return.
+* @returns The value provided.
+*/
+function argIdentity(value) {
+	return value;
+}
+
+//#endregion
+exports.argIdentity = argIdentity;

package/dist/arg-identity.mjs

@@ -1,2 +1,17 @@
-function e(e){return e}export{e as argIdentity};
+//#region src/arg-identity.ts
+/**
+* This method returns the first argument provided to it.
+*
+* @remarks
+* For more info, please see {@link https://lodash.com/docs/4.17.15#identity | the original Lodash documentation}.
+*
+* @param value - The value to return.
+* @returns The value provided.
+*/
+function argIdentity(value) {
+	return value;
+}
+
+//#endregion
+export { argIdentity };
 //# sourceMappingURL=arg-identity.mjs.map

package/dist/arg-identity.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"arg-identity.mjs","names":[],"sources":["../src/arg-identity.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\n/**\n * This method returns the first argument provided to it.\n *\n * @remarks\n * For more info, please see {@link https://lodash.com/docs/4.17.15#identity | the original Lodash documentation}.\n *\n * @param value - The value to return.\n * @returns The value provided.\n */\nexport function argIdentity(value: any) {\n  return value;\n}\n"],"mappings":"AA0BA,SAAgB,EAAY,EAAY,CACtC,OAAO"}
+{"version":3,"file":"arg-identity.mjs","names":[],"sources":["../src/arg-identity.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\n/**\n * This method returns the first argument provided to it.\n *\n * @remarks\n * For more info, please see {@link https://lodash.com/docs/4.17.15#identity | the original Lodash documentation}.\n *\n * @param value - The value to return.\n * @returns The value provided.\n */\nexport function argIdentity(value: any) {\n  return value;\n}\n"],"mappings":";;;;;;;;;;AA0BA,SAAgB,YAAY,OAAY;AACtC,QAAO"}

package/dist/convert/src/to-string-key.cjs

@@ -1 +1,15 @@
-function e(e){return Object.is(e,-0)?`-0`:e.toString()}exports.toStringKey=e;
+
+//#region ../convert/src/to-string-key.ts
+/**
+* Converts `value` to a string key if it's not a string or symbol.
+*
+* @param value - The value to inspect.
+* @returns Returns the key.
+*/
+function toStringKey(value) {
+	if (Object.is(value, -0)) return "-0";
+	return value.toString();
+}
+
+//#endregion
+exports.toStringKey = toStringKey;

package/dist/convert/src/to-string-key.mjs

@@ -1,2 +1,15 @@
-function e(e){return Object.is(e,-0)?`-0`:e.toString()}export{e as toStringKey};
+//#region ../convert/src/to-string-key.ts
+/**
+* Converts `value` to a string key if it's not a string or symbol.
+*
+* @param value - The value to inspect.
+* @returns Returns the key.
+*/
+function toStringKey(value) {
+	if (Object.is(value, -0)) return "-0";
+	return value.toString();
+}
+
+//#endregion
+export { toStringKey };
 //# sourceMappingURL=to-string-key.mjs.map

package/dist/convert/src/to-string-key.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"to-string-key.mjs","names":[],"sources":["../../../../convert/src/to-string-key.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Converts `value` to a string key if it's not a string or symbol.\n *\n * @param value - The value to inspect.\n * @returns Returns the key.\n */\nexport function toStringKey(value: number): string | symbol {\n  if (Object.is(value, -0)) {\n    return \"-0\";\n  }\n\n  return value.toString();\n}\n"],"mappings":"AAwBA,SAAgB,EAAY,EAAgC,CAK1D,OAJI,OAAO,GAAG,EAAO,GAAG,CACf,KAGF,EAAM,UAAU"}
+{"version":3,"file":"to-string-key.mjs","names":[],"sources":["../../../../convert/src/to-string-key.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\n/**\n * Converts `value` to a string key if it's not a string or symbol.\n *\n * @param value - The value to inspect.\n * @returns Returns the key.\n */\nexport function toStringKey(value: number): string | symbol {\n  if (Object.is(value, -0)) {\n    return \"-0\";\n  }\n\n  return value.toString();\n}\n"],"mappings":";;;;;;;AAwBA,SAAgB,YAAY,OAAgC;AAC1D,KAAI,OAAO,GAAG,OAAO,GAAG,CACtB,QAAO;AAGT,QAAO,MAAM,UAAU"}

package/dist/debounce.cjs

@@ -1 +1,62 @@
-function e(e,t,{signal:n}={}){let r=null,i=((...i)=>{r!==null&&clearTimeout(r),!n?.aborted&&(r=setTimeout(()=>{e(...i),r=null},t))});return i.cancel=()=>{r!==null&&(clearTimeout(r),r=null)},n?.addEventListener(`abort`,()=>{i.cancel()},{once:!0}),i}exports.debounce=e;
+
+//#region src/debounce.ts
+/**
+* Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
+* have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
+* method to cancel any pending execution.
+*
+* @example
+* ```typescript
+* const debouncedFunction = debounce(() => {
+*   console.log('Function executed');
+* }, 1000);
+*
+* // Will log 'Function executed' after 1 second if not called again in that time
+* debouncedFunction();
+*
+* // Will not log anything as the previous call is canceled
+* debouncedFunction.cancel();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const signal = controller.signal;
+* const debouncedWithSignal = debounce(() => {
+*  console.log('Function executed');
+* }, 1000, { signal });
+*
+* debouncedWithSignal();
+*
+* // Will cancel the debounced function call
+* controller.abort();
+* ```
+*
+* @param func - The function to debounce.
+* @param debounceMs - The number of milliseconds to delay.
+* @param options - The options object.
+* @returns A new debounced function with a `cancel` method.
+*/
+function debounce(func, debounceMs, { signal } = {}) {
+	let timeoutId = null;
+	const debounced = ((...args) => {
+		if (timeoutId !== null) clearTimeout(timeoutId);
+		if (signal?.aborted) return;
+		timeoutId = setTimeout(() => {
+			func(...args);
+			timeoutId = null;
+		}, debounceMs);
+	});
+	const onAbort = () => {
+		debounced.cancel();
+	};
+	debounced.cancel = () => {
+		if (timeoutId !== null) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+	};
+	signal?.addEventListener("abort", onAbort, { once: true });
+	return debounced;
+}
+
+//#endregion
+exports.debounce = debounce;

package/dist/debounce.mjs

@@ -1,2 +1,62 @@
-function e(e,t,{signal:n}={}){let r=null,i=((...i)=>{r!==null&&clearTimeout(r),!n?.aborted&&(r=setTimeout(()=>{e(...i),r=null},t))});return i.cancel=()=>{r!==null&&(clearTimeout(r),r=null)},n?.addEventListener(`abort`,()=>{i.cancel()},{once:!0}),i}export{e as debounce};
+//#region src/debounce.ts
+/**
+* Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds
+* have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`
+* method to cancel any pending execution.
+*
+* @example
+* ```typescript
+* const debouncedFunction = debounce(() => {
+*   console.log('Function executed');
+* }, 1000);
+*
+* // Will log 'Function executed' after 1 second if not called again in that time
+* debouncedFunction();
+*
+* // Will not log anything as the previous call is canceled
+* debouncedFunction.cancel();
+*
+* // With AbortSignal
+* const controller = new AbortController();
+* const signal = controller.signal;
+* const debouncedWithSignal = debounce(() => {
+*  console.log('Function executed');
+* }, 1000, { signal });
+*
+* debouncedWithSignal();
+*
+* // Will cancel the debounced function call
+* controller.abort();
+* ```
+*
+* @param func - The function to debounce.
+* @param debounceMs - The number of milliseconds to delay.
+* @param options - The options object.
+* @returns A new debounced function with a `cancel` method.
+*/
+function debounce(func, debounceMs, { signal } = {}) {
+	let timeoutId = null;
+	const debounced = ((...args) => {
+		if (timeoutId !== null) clearTimeout(timeoutId);
+		if (signal?.aborted) return;
+		timeoutId = setTimeout(() => {
+			func(...args);
+			timeoutId = null;
+		}, debounceMs);
+	});
+	const onAbort = () => {
+		debounced.cancel();
+	};
+	debounced.cancel = () => {
+		if (timeoutId !== null) {
+			clearTimeout(timeoutId);
+			timeoutId = null;
+		}
+	};
+	signal?.addEventListener("abort", onAbort, { once: true });
+	return debounced;
+}
+
+//#endregion
+export { debounce };
 //# sourceMappingURL=debounce.mjs.map

package/dist/debounce.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"debounce.mjs","names":["timeoutId: ReturnType<typeof setTimeout> | null"],"sources":["../src/debounce.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nexport interface DebounceOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds\n * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`\n * method to cancel any pending execution.\n *\n * @example\n * ```typescript\n * const debouncedFunction = debounce(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' after 1 second if not called again in that time\n * debouncedFunction();\n *\n * // Will not log anything as the previous call is canceled\n * debouncedFunction.cancel();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const signal = controller.signal;\n * const debouncedWithSignal = debounce(() => {\n *  console.log('Function executed');\n * }, 1000, { signal });\n *\n * debouncedWithSignal();\n *\n * // Will cancel the debounced function call\n * controller.abort();\n * ```\n *\n * @param func - The function to debounce.\n * @param debounceMs - The number of milliseconds to delay.\n * @param options - The options object.\n * @returns A new debounced function with a `cancel` method.\n */\nexport function debounce<F extends (...args: any[]) => void>(\n  func: F,\n  debounceMs: number,\n  { signal }: DebounceOptions = {}\n): F & { cancel: () => void } {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  const debounced = ((...args: Parameters<F>) => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (signal?.aborted) {\n      return;\n    }\n\n    timeoutId = setTimeout(() => {\n      func(...args);\n      timeoutId = null;\n    }, debounceMs);\n  }) as F & { cancel: () => void };\n\n  const onAbort = () => {\n    debounced.cancel();\n  };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n  return debounced;\n}\n"],"mappings":"AAwDA,SAAgB,EACd,EACA,EACA,CAAE,UAA4B,EAAE,CACJ,CAC5B,IAAIA,EAAkD,KAEhD,IAAc,GAAG,IAAwB,CACzC,IAAc,MAChB,aAAa,EAAU,CAGrB,IAAQ,UAIZ,EAAY,eAAiB,CAC3B,EAAK,GAAG,EAAK,CACb,EAAY,MACX,EAAW,IAgBhB,MATA,GAAU,WAAe,CACnB,IAAc,OAChB,aAAa,EAAU,CACvB,EAAY,OAIhB,GAAQ,iBAAiB,YAXH,CACpB,EAAU,QAAQ,EAUuB,CAAE,KAAM,GAAM,CAAC,CAEnD"}
+{"version":3,"file":"debounce.mjs","names":["timeoutId: ReturnType<typeof setTimeout> | null"],"sources":["../src/debounce.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 License, and is\n free for commercial and private use. For more information, please visit\n our licensing page.\n\n Website:         https://stormsoftware.com\n Repository:      https://github.com/storm-software/stryke\n Documentation:   https://stormsoftware.com/projects/stryke/docs\n Contact:         https://stormsoftware.com/contact\n License:         https://stormsoftware.com/projects/stryke/license\n\n ------------------------------------------------------------------- */\n\nexport interface DebounceOptions {\n  signal?: AbortSignal;\n}\n\n/**\n * Creates a debounced function that delays invoking the provided function until after `debounceMs` milliseconds\n * have elapsed since the last time the debounced function was invoked. The debounced function also has a `cancel`\n * method to cancel any pending execution.\n *\n * @example\n * ```typescript\n * const debouncedFunction = debounce(() => {\n *   console.log('Function executed');\n * }, 1000);\n *\n * // Will log 'Function executed' after 1 second if not called again in that time\n * debouncedFunction();\n *\n * // Will not log anything as the previous call is canceled\n * debouncedFunction.cancel();\n *\n * // With AbortSignal\n * const controller = new AbortController();\n * const signal = controller.signal;\n * const debouncedWithSignal = debounce(() => {\n *  console.log('Function executed');\n * }, 1000, { signal });\n *\n * debouncedWithSignal();\n *\n * // Will cancel the debounced function call\n * controller.abort();\n * ```\n *\n * @param func - The function to debounce.\n * @param debounceMs - The number of milliseconds to delay.\n * @param options - The options object.\n * @returns A new debounced function with a `cancel` method.\n */\nexport function debounce<F extends (...args: any[]) => void>(\n  func: F,\n  debounceMs: number,\n  { signal }: DebounceOptions = {}\n): F & { cancel: () => void } {\n  let timeoutId: ReturnType<typeof setTimeout> | null = null;\n\n  const debounced = ((...args: Parameters<F>) => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n    }\n\n    if (signal?.aborted) {\n      return;\n    }\n\n    timeoutId = setTimeout(() => {\n      func(...args);\n      timeoutId = null;\n    }, debounceMs);\n  }) as F & { cancel: () => void };\n\n  const onAbort = () => {\n    debounced.cancel();\n  };\n\n  debounced.cancel = () => {\n    if (timeoutId !== null) {\n      clearTimeout(timeoutId);\n      timeoutId = null;\n    }\n  };\n\n  signal?.addEventListener(\"abort\", onAbort, { once: true });\n\n  return debounced;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwDA,SAAgB,SACd,MACA,YACA,EAAE,WAA4B,EAAE,EACJ;CAC5B,IAAIA,YAAkD;CAEtD,MAAM,cAAc,GAAG,SAAwB;AAC7C,MAAI,cAAc,KAChB,cAAa,UAAU;AAGzB,MAAI,QAAQ,QACV;AAGF,cAAY,iBAAiB;AAC3B,QAAK,GAAG,KAAK;AACb,eAAY;KACX,WAAW;;CAGhB,MAAM,gBAAgB;AACpB,YAAU,QAAQ;;AAGpB,WAAU,eAAe;AACvB,MAAI,cAAc,MAAM;AACtB,gBAAa,UAAU;AACvB,eAAY;;;AAIhB,SAAQ,iBAAiB,SAAS,SAAS,EAAE,MAAM,MAAM,CAAC;AAE1D,QAAO"}

package/dist/deep-clone.cjs

@@ -1 +1,113 @@
-const e=require(`./type-checks/src/is-primitive.cjs`),t=require(`./type-checks/src/is-typed-array.cjs`);function n(i){if(e.isPrimitive(i))return i;if(Array.isArray(i))return i.map(e=>n(e));if(i instanceof Date)return new Date(i.getTime());if(i instanceof RegExp)return new RegExp(i.source,i.flags);if(i instanceof Map){let e=new Map;for(let[t,r]of i.entries())e.set(t,n(r));return e}if(i instanceof Set){let e=new Set;for(let t of i.values())e.add(n(t));return e}if(t.isTypedArray(i)){let e=new(Object.getPrototypeOf(i)).constructor(i.length);for(let[t,r]of i.entries())e[t]=n(r);return e}if(i instanceof ArrayBuffer||typeof SharedArrayBuffer<`u`&&i instanceof SharedArrayBuffer)return[...i];if(i instanceof DataView){let e=new DataView([...i.buffer]);return r(i,e),e}if(typeof File<`u`&&i instanceof File){let e=new File([i],i.name,{type:i.type});return r(i,e),e}if(i instanceof Blob){let e=new Blob([i],{type:i.type});return r(i,e),e}if(i instanceof Error){let e=new i.constructor;return e.message=i.message,e.name=i.name,e.stack=i.stack,e.cause=i.cause,r(i,e),e}if(typeof i==`object`&&i){let e={};return r(i,e),e}return i}function r(e,t){let r=Object.keys(e);for(let i of r){let r=Object.getOwnPropertyDescriptor(e,i);(r?.writable||r?.set)&&(t[i]=n(e[i]))}}exports.deepClone=n;
+const require_is_primitive = require('./type-checks/src/is-primitive.cjs');
+const require_is_typed_array = require('./type-checks/src/is-typed-array.cjs');
+
+//#region src/deep-clone.ts
+/**
+* Creates a deep clone of the given object.
+*
+* @remarks
+* This function creates a deep clone of the given object, including nested objects and arrays. The resulting output will be of type `Resolved<T>`, which is a type that resolves to the most specific type possible for the given input type `T`. **If you are just looking for a way to copy an object deeply, use {@link deepCopy} instead.**
+*
+* @example
+* ```typescript
+* // Clone a primitive values
+* const num = 29;
+* const clonedNum = clone(num);
+* console.log(clonedNum); // 29
+* console.log(clonedNum === num) ; // true
+*
+* // Clone an array
+* const arr = [1, 2, 3];
+* const clonedArr = clone(arr);
+* console.log(clonedArr); // [1, 2, 3]
+* console.log(clonedArr === arr); // false
+*
+* // Clone an array with nested objects
+* const arr = [1, { a: 1 }, [1, 2, 3]];
+* const clonedArr = clone(arr);
+* arr[1].a = 2;
+* console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+* console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
+* console.log(clonedArr === arr); // false
+*
+* // Clone an object
+* const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
+* const clonedObj = clone(obj);
+* console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
+* console.log(clonedObj === obj); // false
+*
+*
+* // Clone an object with nested objects
+* const obj = { a: 1, b: { c: 1 } };
+* const clonedObj = clone(obj);
+* obj.b.c = 2;
+* console.log(obj); // { a: 1, b: { c: 2 } }
+* console.log(clonedObj); // { a: 1, b: { c: 1 } }
+* console.log(clonedObj === obj); // false
+* ```
+*
+* @param obj - The object to clone.
+* @returns A deep clone of the given object.
+*/
+function deepClone(obj) {
+	if (require_is_primitive.isPrimitive(obj)) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => deepClone(item));
+	if (obj instanceof Date) return new Date(obj.getTime());
+	if (obj instanceof RegExp) return new RegExp(obj.source, obj.flags);
+	if (obj instanceof Map) {
+		const result = /* @__PURE__ */ new Map();
+		for (const [key, value] of obj.entries()) result.set(key, deepClone(value));
+		return result;
+	}
+	if (obj instanceof Set) {
+		const result = /* @__PURE__ */ new Set();
+		for (const value of obj.values()) result.add(deepClone(value));
+		return result;
+	}
+	if (require_is_typed_array.isTypedArray(obj)) {
+		const result = new (Object.getPrototypeOf(obj)).constructor(obj.length);
+		for (const [i, element_] of obj.entries()) result[i] = deepClone(element_);
+		return result;
+	}
+	if (obj instanceof ArrayBuffer || typeof SharedArrayBuffer !== "undefined" && obj instanceof SharedArrayBuffer) return [...obj];
+	if (obj instanceof DataView) {
+		const result = new DataView([...obj.buffer]);
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (typeof File !== "undefined" && obj instanceof File) {
+		const result = new File([obj], obj.name, { type: obj.type });
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (obj instanceof Blob) {
+		const result = new Blob([obj], { type: obj.type });
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (obj instanceof Error) {
+		const result = new obj.constructor();
+		result.message = obj.message;
+		result.name = obj.name;
+		result.stack = obj.stack;
+		result.cause = obj.cause;
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (typeof obj === "object" && obj !== null) {
+		const result = {};
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	return obj;
+}
+function cloneDeepHelper(obj, clonedObj) {
+	const keys = Object.keys(obj);
+	for (const key of keys) {
+		const descriptor = Object.getOwnPropertyDescriptor(obj, key);
+		if (descriptor?.writable || descriptor?.set) clonedObj[key] = deepClone(obj[key]);
+	}
+}
+
+//#endregion
+exports.deepClone = deepClone;

package/dist/deep-clone.mjs

@@ -1,2 +1,114 @@
-import{isPrimitive as e}from"./type-checks/src/is-primitive.mjs";import{isTypedArray as t}from"./type-checks/src/is-typed-array.mjs";function n(i){if(e(i))return i;if(Array.isArray(i))return i.map(e=>n(e));if(i instanceof Date)return new Date(i.getTime());if(i instanceof RegExp)return new RegExp(i.source,i.flags);if(i instanceof Map){let e=new Map;for(let[t,r]of i.entries())e.set(t,n(r));return e}if(i instanceof Set){let e=new Set;for(let t of i.values())e.add(n(t));return e}if(t(i)){let e=new(Object.getPrototypeOf(i)).constructor(i.length);for(let[t,r]of i.entries())e[t]=n(r);return e}if(i instanceof ArrayBuffer||typeof SharedArrayBuffer<`u`&&i instanceof SharedArrayBuffer)return[...i];if(i instanceof DataView){let e=new DataView([...i.buffer]);return r(i,e),e}if(typeof File<`u`&&i instanceof File){let e=new File([i],i.name,{type:i.type});return r(i,e),e}if(i instanceof Blob){let e=new Blob([i],{type:i.type});return r(i,e),e}if(i instanceof Error){let e=new i.constructor;return e.message=i.message,e.name=i.name,e.stack=i.stack,e.cause=i.cause,r(i,e),e}if(typeof i==`object`&&i){let e={};return r(i,e),e}return i}function r(e,t){let r=Object.keys(e);for(let i of r){let r=Object.getOwnPropertyDescriptor(e,i);(r?.writable||r?.set)&&(t[i]=n(e[i]))}}export{n as deepClone};
+import { isPrimitive } from "./type-checks/src/is-primitive.mjs";
+import { isTypedArray } from "./type-checks/src/is-typed-array.mjs";
+
+//#region src/deep-clone.ts
+/**
+* Creates a deep clone of the given object.
+*
+* @remarks
+* This function creates a deep clone of the given object, including nested objects and arrays. The resulting output will be of type `Resolved<T>`, which is a type that resolves to the most specific type possible for the given input type `T`. **If you are just looking for a way to copy an object deeply, use {@link deepCopy} instead.**
+*
+* @example
+* ```typescript
+* // Clone a primitive values
+* const num = 29;
+* const clonedNum = clone(num);
+* console.log(clonedNum); // 29
+* console.log(clonedNum === num) ; // true
+*
+* // Clone an array
+* const arr = [1, 2, 3];
+* const clonedArr = clone(arr);
+* console.log(clonedArr); // [1, 2, 3]
+* console.log(clonedArr === arr); // false
+*
+* // Clone an array with nested objects
+* const arr = [1, { a: 1 }, [1, 2, 3]];
+* const clonedArr = clone(arr);
+* arr[1].a = 2;
+* console.log(arr); // [2, { a: 2 }, [1, 2, 3]]
+* console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]
+* console.log(clonedArr === arr); // false
+*
+* // Clone an object
+* const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };
+* const clonedObj = clone(obj);
+* console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }
+* console.log(clonedObj === obj); // false
+*
+*
+* // Clone an object with nested objects
+* const obj = { a: 1, b: { c: 1 } };
+* const clonedObj = clone(obj);
+* obj.b.c = 2;
+* console.log(obj); // { a: 1, b: { c: 2 } }
+* console.log(clonedObj); // { a: 1, b: { c: 1 } }
+* console.log(clonedObj === obj); // false
+* ```
+*
+* @param obj - The object to clone.
+* @returns A deep clone of the given object.
+*/
+function deepClone(obj) {
+	if (isPrimitive(obj)) return obj;
+	if (Array.isArray(obj)) return obj.map((item) => deepClone(item));
+	if (obj instanceof Date) return new Date(obj.getTime());
+	if (obj instanceof RegExp) return new RegExp(obj.source, obj.flags);
+	if (obj instanceof Map) {
+		const result = /* @__PURE__ */ new Map();
+		for (const [key, value] of obj.entries()) result.set(key, deepClone(value));
+		return result;
+	}
+	if (obj instanceof Set) {
+		const result = /* @__PURE__ */ new Set();
+		for (const value of obj.values()) result.add(deepClone(value));
+		return result;
+	}
+	if (isTypedArray(obj)) {
+		const result = new (Object.getPrototypeOf(obj)).constructor(obj.length);
+		for (const [i, element_] of obj.entries()) result[i] = deepClone(element_);
+		return result;
+	}
+	if (obj instanceof ArrayBuffer || typeof SharedArrayBuffer !== "undefined" && obj instanceof SharedArrayBuffer) return [...obj];
+	if (obj instanceof DataView) {
+		const result = new DataView([...obj.buffer]);
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (typeof File !== "undefined" && obj instanceof File) {
+		const result = new File([obj], obj.name, { type: obj.type });
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (obj instanceof Blob) {
+		const result = new Blob([obj], { type: obj.type });
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (obj instanceof Error) {
+		const result = new obj.constructor();
+		result.message = obj.message;
+		result.name = obj.name;
+		result.stack = obj.stack;
+		result.cause = obj.cause;
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	if (typeof obj === "object" && obj !== null) {
+		const result = {};
+		cloneDeepHelper(obj, result);
+		return result;
+	}
+	return obj;
+}
+function cloneDeepHelper(obj, clonedObj) {
+	const keys = Object.keys(obj);
+	for (const key of keys) {
+		const descriptor = Object.getOwnPropertyDescriptor(obj, key);
+		if (descriptor?.writable || descriptor?.set) clonedObj[key] = deepClone(obj[key]);
+	}
+}
+
+//#endregion
+export { deepClone };
 //# sourceMappingURL=deep-clone.mjs.map

package/dist/deep-clone.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"deep-clone.mjs","names":[],"sources":["../src/deep-clone.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isPrimitive } from \"@stryke/type-checks/is-primitive\";\nimport { isTypedArray } from \"@stryke/type-checks/is-typed-array\";\n\nexport type Resolved<T> =\n  Equal<T, ResolvedMain<T>> extends true ? T : ResolvedMain<T>;\n\ntype Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;\n\ntype ResolvedMain<T> = T extends [never]\n  ? never // (special trick for jsonable | null) type\n  : ValueOf<T> extends boolean | number | bigint | string\n    ? ValueOf<T>\n    : T extends (...args: any[]) => any\n      ? never\n      : T extends object\n        ? ResolvedObject<T>\n        : ValueOf<T>;\n\ntype ResolvedObject<T extends object> = T extends (infer U)[]\n  ? IsTuple<T> extends true\n    ? ResolvedTuple<T>\n    : ResolvedMain<U>[]\n  : T extends Set<infer U>\n    ? Set<ResolvedMain<U>>\n    : T extends Map<infer K, infer V>\n      ? Map<ResolvedMain<K>, ResolvedMain<V>>\n      : T extends WeakSet<any> | WeakMap<any, any>\n        ? never\n        : T extends\n              | Date\n              | Uint8Array\n              | Uint8ClampedArray\n              | Uint16Array\n              | Uint32Array\n              | BigUint64Array\n              | Int8Array\n              | Int16Array\n              | Int32Array\n              | BigInt64Array\n              | Float32Array\n              | Float64Array\n              | ArrayBuffer\n              | SharedArrayBuffer\n              | DataView\n              | Blob\n              | File\n          ? T\n          : {\n              [P in keyof T]: ResolvedMain<T[P]>;\n            };\n\ntype ResolvedTuple<T extends readonly any[]> = T extends []\n  ? []\n  : T extends [infer F]\n    ? [ResolvedMain<F>]\n    : T extends [infer F, ...infer Rest extends readonly any[]]\n      ? [ResolvedMain<F>, ...ResolvedTuple<Rest>]\n      : T extends [(infer F)?]\n        ? [ResolvedMain<F>?]\n        : T extends [(infer F)?, ...infer Rest extends readonly any[]]\n          ? [ResolvedMain<F>?, ...ResolvedTuple<Rest>]\n          : [];\n\ntype IsTuple<T extends readonly any[] | { length: number }> = [T] extends [\n  never\n]\n  ? false\n  : T extends readonly any[]\n    ? number extends T[\"length\"]\n      ? false\n      : true\n    : false;\n\ntype ValueOf<Instance> =\n  IsValueOf<Instance, boolean> extends true\n    ? boolean\n    : IsValueOf<Instance, number> extends true\n      ? number\n      : IsValueOf<Instance, string> extends true\n        ? string\n        : Instance;\n\ntype IsValueOf<Instance, O extends ValueOfInterface<any>> = Instance extends O\n  ? O extends ValueOfInterface<infer Primitive>\n    ? Instance extends Primitive\n      ? false\n      : true // not Primitive, but Object\n    : false // cannot be\n  : false;\n\ninterface ValueOfInterface<T> {\n  valueOf: () => T;\n}\n\n/**\n * Creates a deep clone of the given object.\n *\n * @remarks\n * This function creates a deep clone of the given object, including nested objects and arrays. The resulting output will be of type `Resolved<T>`, which is a type that resolves to the most specific type possible for the given input type `T`. **If you are just looking for a way to copy an object deeply, use {@link deepCopy} instead.**\n *\n * @example\n * ```typescript\n * // Clone a primitive values\n * const num = 29;\n * const clonedNum = clone(num);\n * console.log(clonedNum); // 29\n * console.log(clonedNum === num) ; // true\n *\n * // Clone an array\n * const arr = [1, 2, 3];\n * const clonedArr = clone(arr);\n * console.log(clonedArr); // [1, 2, 3]\n * console.log(clonedArr === arr); // false\n *\n * // Clone an array with nested objects\n * const arr = [1, { a: 1 }, [1, 2, 3]];\n * const clonedArr = clone(arr);\n * arr[1].a = 2;\n * console.log(arr); // [2, { a: 2 }, [1, 2, 3]]\n * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]\n * console.log(clonedArr === arr); // false\n *\n * // Clone an object\n * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };\n * const clonedObj = clone(obj);\n * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }\n * console.log(clonedObj === obj); // false\n *\n *\n * // Clone an object with nested objects\n * const obj = { a: 1, b: { c: 1 } };\n * const clonedObj = clone(obj);\n * obj.b.c = 2;\n * console.log(obj); // { a: 1, b: { c: 2 } }\n * console.log(clonedObj); // { a: 1, b: { c: 1 } }\n * console.log(clonedObj === obj); // false\n * ```\n *\n * @param obj - The object to clone.\n * @returns A deep clone of the given object.\n */\nexport function deepClone<T>(obj: T): Resolved<T> {\n  if (isPrimitive(obj)) {\n    return obj as Resolved<T>;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(item => deepClone(item)) as Resolved<T>;\n  }\n\n  if (obj instanceof Date) {\n    return new Date(obj.getTime()) as Resolved<T>;\n  }\n\n  if (obj instanceof RegExp) {\n    return new RegExp(obj.source, obj.flags) as Resolved<T>;\n  }\n\n  if (obj instanceof Map) {\n    const result = new Map();\n    for (const [key, value] of obj.entries()) {\n      result.set(key, deepClone(value));\n    }\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Set) {\n    const result = new Set();\n    for (const value of obj.values()) {\n      result.add(deepClone(value));\n    }\n    return result as Resolved<T>;\n  }\n\n  if (isTypedArray(obj)) {\n    // eslint-disable-next-line ts/no-unsafe-call\n    const result = new (Object.getPrototypeOf(obj).constructor)(obj.length);\n    // eslint-disable-next-line ts/naming-convention\n    for (const [i, element_] of obj.entries()) {\n      result[i] = deepClone(element_);\n    }\n    return result as Resolved<T>;\n  }\n\n  if (\n    obj instanceof ArrayBuffer ||\n    (typeof SharedArrayBuffer !== \"undefined\" &&\n      obj instanceof SharedArrayBuffer)\n  ) {\n    return [...(obj as any)] as Resolved<T>;\n  }\n\n  if (obj instanceof DataView) {\n    const result = new DataView([...(obj.buffer as any)] as any);\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  // For legacy NodeJS support\n  if (typeof File !== \"undefined\" && obj instanceof File) {\n    const result = new File([obj], obj.name, { type: obj.type });\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Blob) {\n    const result = new Blob([obj], { type: obj.type });\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Error) {\n    const result = new (obj.constructor as new () => Error)();\n    result.message = obj.message;\n    result.name = obj.name;\n    result.stack = obj.stack;\n    result.cause = obj.cause;\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (typeof obj === \"object\" && obj !== null) {\n    const result = {};\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  return obj as Resolved<T>;\n}\n\nfunction cloneDeepHelper(obj: any, clonedObj: any): void {\n  const keys = Object.keys(obj);\n\n  for (const key of keys) {\n    const descriptor = Object.getOwnPropertyDescriptor(obj, key);\n\n    if (descriptor?.writable || descriptor?.set) {\n      clonedObj[key] = deepClone(obj[key]);\n    }\n  }\n}\n"],"mappings":"qIA+JA,SAAgB,EAAa,EAAqB,CAChD,GAAI,EAAY,EAAI,CAClB,OAAO,EAGT,GAAI,MAAM,QAAQ,EAAI,CACpB,OAAO,EAAI,IAAI,GAAQ,EAAU,EAAK,CAAC,CAGzC,GAAI,aAAe,KACjB,OAAO,IAAI,KAAK,EAAI,SAAS,CAAC,CAGhC,GAAI,aAAe,OACjB,OAAO,IAAI,OAAO,EAAI,OAAQ,EAAI,MAAM,CAG1C,GAAI,aAAe,IAAK,CACtB,IAAM,EAAS,IAAI,IACnB,IAAK,GAAM,CAAC,EAAK,KAAU,EAAI,SAAS,CACtC,EAAO,IAAI,EAAK,EAAU,EAAM,CAAC,CAEnC,OAAO,EAGT,GAAI,aAAe,IAAK,CACtB,IAAM,EAAS,IAAI,IACnB,IAAK,IAAM,KAAS,EAAI,QAAQ,CAC9B,EAAO,IAAI,EAAU,EAAM,CAAC,CAE9B,OAAO,EAGT,GAAI,EAAa,EAAI,CAAE,CAErB,IAAM,EAAS,IAAK,OAAO,eAAe,EAAI,EAAC,YAAa,EAAI,OAAO,CAEvE,IAAK,GAAM,CAAC,EAAG,KAAa,EAAI,SAAS,CACvC,EAAO,GAAK,EAAU,EAAS,CAEjC,OAAO,EAGT,GACE,aAAe,aACd,OAAO,kBAAsB,KAC5B,aAAe,kBAEjB,MAAO,CAAC,GAAI,EAAY,CAG1B,GAAI,aAAe,SAAU,CAC3B,IAAM,EAAS,IAAI,SAAS,CAAC,GAAI,EAAI,OAAe,CAAQ,CAE5D,OADA,EAAgB,EAAK,EAAO,CACrB,EAIT,GAAI,OAAO,KAAS,KAAe,aAAe,KAAM,CACtD,IAAM,EAAS,IAAI,KAAK,CAAC,EAAI,CAAE,EAAI,KAAM,CAAE,KAAM,EAAI,KAAM,CAAC,CAE5D,OADA,EAAgB,EAAK,EAAO,CACrB,EAGT,GAAI,aAAe,KAAM,CACvB,IAAM,EAAS,IAAI,KAAK,CAAC,EAAI,CAAE,CAAE,KAAM,EAAI,KAAM,CAAC,CAElD,OADA,EAAgB,EAAK,EAAO,CACrB,EAGT,GAAI,aAAe,MAAO,CACxB,IAAM,EAAS,IAAK,EAAI,YAMxB,MALA,GAAO,QAAU,EAAI,QACrB,EAAO,KAAO,EAAI,KAClB,EAAO,MAAQ,EAAI,MACnB,EAAO,MAAQ,EAAI,MACnB,EAAgB,EAAK,EAAO,CACrB,EAGT,GAAI,OAAO,GAAQ,UAAY,EAAc,CAC3C,IAAM,EAAS,EAAE,CAEjB,OADA,EAAgB,EAAK,EAAO,CACrB,EAGT,OAAO,EAGT,SAAS,EAAgB,EAAU,EAAsB,CACvD,IAAM,EAAO,OAAO,KAAK,EAAI,CAE7B,IAAK,IAAM,KAAO,EAAM,CACtB,IAAM,EAAa,OAAO,yBAAyB,EAAK,EAAI,EAExD,GAAY,UAAY,GAAY,OACtC,EAAU,GAAO,EAAU,EAAI,GAAK"}
+{"version":3,"file":"deep-clone.mjs","names":[],"sources":["../src/deep-clone.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                       ⚡ Storm Software - Stryke\n\n This code was released as part of the Stryke project. Stryke\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/stryke.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/stryke\n Documentation:            https://docs.stormsoftware.com/projects/stryke\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { isPrimitive } from \"@stryke/type-checks/is-primitive\";\nimport { isTypedArray } from \"@stryke/type-checks/is-typed-array\";\n\nexport type Resolved<T> =\n  Equal<T, ResolvedMain<T>> extends true ? T : ResolvedMain<T>;\n\ntype Equal<X, Y> = X extends Y ? (Y extends X ? true : false) : false;\n\ntype ResolvedMain<T> = T extends [never]\n  ? never // (special trick for jsonable | null) type\n  : ValueOf<T> extends boolean | number | bigint | string\n    ? ValueOf<T>\n    : T extends (...args: any[]) => any\n      ? never\n      : T extends object\n        ? ResolvedObject<T>\n        : ValueOf<T>;\n\ntype ResolvedObject<T extends object> = T extends (infer U)[]\n  ? IsTuple<T> extends true\n    ? ResolvedTuple<T>\n    : ResolvedMain<U>[]\n  : T extends Set<infer U>\n    ? Set<ResolvedMain<U>>\n    : T extends Map<infer K, infer V>\n      ? Map<ResolvedMain<K>, ResolvedMain<V>>\n      : T extends WeakSet<any> | WeakMap<any, any>\n        ? never\n        : T extends\n              | Date\n              | Uint8Array\n              | Uint8ClampedArray\n              | Uint16Array\n              | Uint32Array\n              | BigUint64Array\n              | Int8Array\n              | Int16Array\n              | Int32Array\n              | BigInt64Array\n              | Float32Array\n              | Float64Array\n              | ArrayBuffer\n              | SharedArrayBuffer\n              | DataView\n              | Blob\n              | File\n          ? T\n          : {\n              [P in keyof T]: ResolvedMain<T[P]>;\n            };\n\ntype ResolvedTuple<T extends readonly any[]> = T extends []\n  ? []\n  : T extends [infer F]\n    ? [ResolvedMain<F>]\n    : T extends [infer F, ...infer Rest extends readonly any[]]\n      ? [ResolvedMain<F>, ...ResolvedTuple<Rest>]\n      : T extends [(infer F)?]\n        ? [ResolvedMain<F>?]\n        : T extends [(infer F)?, ...infer Rest extends readonly any[]]\n          ? [ResolvedMain<F>?, ...ResolvedTuple<Rest>]\n          : [];\n\ntype IsTuple<T extends readonly any[] | { length: number }> = [T] extends [\n  never\n]\n  ? false\n  : T extends readonly any[]\n    ? number extends T[\"length\"]\n      ? false\n      : true\n    : false;\n\ntype ValueOf<Instance> =\n  IsValueOf<Instance, boolean> extends true\n    ? boolean\n    : IsValueOf<Instance, number> extends true\n      ? number\n      : IsValueOf<Instance, string> extends true\n        ? string\n        : Instance;\n\ntype IsValueOf<Instance, O extends ValueOfInterface<any>> = Instance extends O\n  ? O extends ValueOfInterface<infer Primitive>\n    ? Instance extends Primitive\n      ? false\n      : true // not Primitive, but Object\n    : false // cannot be\n  : false;\n\ninterface ValueOfInterface<T> {\n  valueOf: () => T;\n}\n\n/**\n * Creates a deep clone of the given object.\n *\n * @remarks\n * This function creates a deep clone of the given object, including nested objects and arrays. The resulting output will be of type `Resolved<T>`, which is a type that resolves to the most specific type possible for the given input type `T`. **If you are just looking for a way to copy an object deeply, use {@link deepCopy} instead.**\n *\n * @example\n * ```typescript\n * // Clone a primitive values\n * const num = 29;\n * const clonedNum = clone(num);\n * console.log(clonedNum); // 29\n * console.log(clonedNum === num) ; // true\n *\n * // Clone an array\n * const arr = [1, 2, 3];\n * const clonedArr = clone(arr);\n * console.log(clonedArr); // [1, 2, 3]\n * console.log(clonedArr === arr); // false\n *\n * // Clone an array with nested objects\n * const arr = [1, { a: 1 }, [1, 2, 3]];\n * const clonedArr = clone(arr);\n * arr[1].a = 2;\n * console.log(arr); // [2, { a: 2 }, [1, 2, 3]]\n * console.log(clonedArr); // [1, { a: 1 }, [1, 2, 3]]\n * console.log(clonedArr === arr); // false\n *\n * // Clone an object\n * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };\n * const clonedObj = clone(obj);\n * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }\n * console.log(clonedObj === obj); // false\n *\n *\n * // Clone an object with nested objects\n * const obj = { a: 1, b: { c: 1 } };\n * const clonedObj = clone(obj);\n * obj.b.c = 2;\n * console.log(obj); // { a: 1, b: { c: 2 } }\n * console.log(clonedObj); // { a: 1, b: { c: 1 } }\n * console.log(clonedObj === obj); // false\n * ```\n *\n * @param obj - The object to clone.\n * @returns A deep clone of the given object.\n */\nexport function deepClone<T>(obj: T): Resolved<T> {\n  if (isPrimitive(obj)) {\n    return obj as Resolved<T>;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.map(item => deepClone(item)) as Resolved<T>;\n  }\n\n  if (obj instanceof Date) {\n    return new Date(obj.getTime()) as Resolved<T>;\n  }\n\n  if (obj instanceof RegExp) {\n    return new RegExp(obj.source, obj.flags) as Resolved<T>;\n  }\n\n  if (obj instanceof Map) {\n    const result = new Map();\n    for (const [key, value] of obj.entries()) {\n      result.set(key, deepClone(value));\n    }\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Set) {\n    const result = new Set();\n    for (const value of obj.values()) {\n      result.add(deepClone(value));\n    }\n    return result as Resolved<T>;\n  }\n\n  if (isTypedArray(obj)) {\n    // eslint-disable-next-line ts/no-unsafe-call\n    const result = new (Object.getPrototypeOf(obj).constructor)(obj.length);\n    // eslint-disable-next-line ts/naming-convention\n    for (const [i, element_] of obj.entries()) {\n      result[i] = deepClone(element_);\n    }\n    return result as Resolved<T>;\n  }\n\n  if (\n    obj instanceof ArrayBuffer ||\n    (typeof SharedArrayBuffer !== \"undefined\" &&\n      obj instanceof SharedArrayBuffer)\n  ) {\n    return [...(obj as any)] as Resolved<T>;\n  }\n\n  if (obj instanceof DataView) {\n    const result = new DataView([...(obj.buffer as any)] as any);\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  // For legacy NodeJS support\n  if (typeof File !== \"undefined\" && obj instanceof File) {\n    const result = new File([obj], obj.name, { type: obj.type });\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Blob) {\n    const result = new Blob([obj], { type: obj.type });\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (obj instanceof Error) {\n    const result = new (obj.constructor as new () => Error)();\n    result.message = obj.message;\n    result.name = obj.name;\n    result.stack = obj.stack;\n    result.cause = obj.cause;\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  if (typeof obj === \"object\" && obj !== null) {\n    const result = {};\n    cloneDeepHelper(obj, result);\n    return result as Resolved<T>;\n  }\n\n  return obj as Resolved<T>;\n}\n\nfunction cloneDeepHelper(obj: any, clonedObj: any): void {\n  const keys = Object.keys(obj);\n\n  for (const key of keys) {\n    const descriptor = Object.getOwnPropertyDescriptor(obj, key);\n\n    if (descriptor?.writable || descriptor?.set) {\n      clonedObj[key] = deepClone(obj[key]);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+JA,SAAgB,UAAa,KAAqB;AAChD,KAAI,YAAY,IAAI,CAClB,QAAO;AAGT,KAAI,MAAM,QAAQ,IAAI,CACpB,QAAO,IAAI,KAAI,SAAQ,UAAU,KAAK,CAAC;AAGzC,KAAI,eAAe,KACjB,QAAO,IAAI,KAAK,IAAI,SAAS,CAAC;AAGhC,KAAI,eAAe,OACjB,QAAO,IAAI,OAAO,IAAI,QAAQ,IAAI,MAAM;AAG1C,KAAI,eAAe,KAAK;EACtB,MAAM,yBAAS,IAAI,KAAK;AACxB,OAAK,MAAM,CAAC,KAAK,UAAU,IAAI,SAAS,CACtC,QAAO,IAAI,KAAK,UAAU,MAAM,CAAC;AAEnC,SAAO;;AAGT,KAAI,eAAe,KAAK;EACtB,MAAM,yBAAS,IAAI,KAAK;AACxB,OAAK,MAAM,SAAS,IAAI,QAAQ,CAC9B,QAAO,IAAI,UAAU,MAAM,CAAC;AAE9B,SAAO;;AAGT,KAAI,aAAa,IAAI,EAAE;EAErB,MAAM,SAAS,KAAK,OAAO,eAAe,IAAI,EAAC,YAAa,IAAI,OAAO;AAEvE,OAAK,MAAM,CAAC,GAAG,aAAa,IAAI,SAAS,CACvC,QAAO,KAAK,UAAU,SAAS;AAEjC,SAAO;;AAGT,KACE,eAAe,eACd,OAAO,sBAAsB,eAC5B,eAAe,kBAEjB,QAAO,CAAC,GAAI,IAAY;AAG1B,KAAI,eAAe,UAAU;EAC3B,MAAM,SAAS,IAAI,SAAS,CAAC,GAAI,IAAI,OAAe,CAAQ;AAC5D,kBAAgB,KAAK,OAAO;AAC5B,SAAO;;AAIT,KAAI,OAAO,SAAS,eAAe,eAAe,MAAM;EACtD,MAAM,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC;AAC5D,kBAAgB,KAAK,OAAO;AAC5B,SAAO;;AAGT,KAAI,eAAe,MAAM;EACvB,MAAM,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,MAAM,IAAI,MAAM,CAAC;AAClD,kBAAgB,KAAK,OAAO;AAC5B,SAAO;;AAGT,KAAI,eAAe,OAAO;EACxB,MAAM,SAAS,IAAK,IAAI,aAAiC;AACzD,SAAO,UAAU,IAAI;AACrB,SAAO,OAAO,IAAI;AAClB,SAAO,QAAQ,IAAI;AACnB,SAAO,QAAQ,IAAI;AACnB,kBAAgB,KAAK,OAAO;AAC5B,SAAO;;AAGT,KAAI,OAAO,QAAQ,YAAY,QAAQ,MAAM;EAC3C,MAAM,SAAS,EAAE;AACjB,kBAAgB,KAAK,OAAO;AAC5B,SAAO;;AAGT,QAAO;;AAGT,SAAS,gBAAgB,KAAU,WAAsB;CACvD,MAAM,OAAO,OAAO,KAAK,IAAI;AAE7B,MAAK,MAAM,OAAO,MAAM;EACtB,MAAM,aAAa,OAAO,yBAAyB,KAAK,IAAI;AAE5D,MAAI,YAAY,YAAY,YAAY,IACtC,WAAU,OAAO,UAAU,IAAI,KAAK"}

package/dist/deep-merge.cjs

@@ -1 +1,60 @@
-const e=require(`./type-checks/src/is-function.cjs`),t=require(`./type-checks/src/is-mergeable-object.cjs`),n=require(`./type-checks/src/property-exists.cjs`),r=e=>Array.isArray(e)?[]:{},i=(e,t)=>t.clone!==!1&&t.isMergeableObject(e)?l(r(e),e,t):e,a=(e,t,n)=>[...e,...t].map(e=>i(e,n)),o=(t,n)=>{if(!n.customMerge)return l;let r=n.customMerge(t);return e.isFunction(r)?r:l},s=e=>[...Object.keys(e),...Object.getOwnPropertySymbols?Object.getOwnPropertySymbols(e).filter(t=>Object.propertyIsEnumerable.call(e,t)):[]],c=(e,t,r)=>{let a={};if(r.isMergeableObject(e))for(let t of s(e))a[t]=i(e[t],r);for(let c of s(t))a[c]=n.propertyUnsafe(e,c)&&r.isMergeableObject(t[c])?o(c,r)(e[c],t[c],r):i(t[c],r);return a};function l(e,n,r){if(!e||!n)return e||n;let o=r??{};o.arrayMerge??=a,o.isMergeableObject??=t.isMergeableObject,o.cloneUnlessOtherwiseSpecified??=i;let s=Array.isArray(n);return s===Array.isArray(e)?s?o.arrayMerge(e,n,o):c(e,n,o):i(n,o)}l.all=function(e,t){if(!Array.isArray(e))throw TypeError(`first argument should be an array`);return e.reduce((e,n)=>l(e,n,t),{})},exports.deepMerge=l;
+const require_is_function = require('./type-checks/src/is-function.cjs');
+const require_is_mergeable_object = require('./type-checks/src/is-mergeable-object.cjs');
+const require_property_exists = require('./type-checks/src/property-exists.cjs');
+
+//#region src/deep-merge.ts
+const emptyTarget = (val) => {
+	return Array.isArray(val) ? [] : {};
+};
+const cloneUnlessOtherwiseSpecified = (value, options) => {
+	return options.clone !== false && options.isMergeableObject(value) ? deepMerge(emptyTarget(value), value, options) : value;
+};
+const defaultArrayMerge = (target, source, options) => {
+	return [...target, ...source].map((element) => {
+		return cloneUnlessOtherwiseSpecified(element, options);
+	});
+};
+const getMergeFunction = (key, options) => {
+	if (!options.customMerge) return deepMerge;
+	const customMerge = options.customMerge(key);
+	return require_is_function.isFunction(customMerge) ? customMerge : deepMerge;
+};
+const getKeys = (target) => {
+	return [...Object.keys(target), ...Object.getOwnPropertySymbols ? Object.getOwnPropertySymbols(target).filter((symbol) => {
+		return Object.propertyIsEnumerable.call(target, symbol);
+	}) : []];
+};
+const mergeObject = (target, source, options) => {
+	const destination = {};
+	if (options.isMergeableObject(target)) for (const key of getKeys(target)) destination[key] = cloneUnlessOtherwiseSpecified(target[key], options);
+	for (const key of getKeys(source)) destination[key] = require_property_exists.propertyUnsafe(target, key) && options.isMergeableObject(source[key]) ? getMergeFunction(key, options)(target[key], source[key], options) : cloneUnlessOtherwiseSpecified(source[key], options);
+	return destination;
+};
+/**
+* Deep merge two objects
+*
+* @param target - The target object
+* @param source - The source object
+* @param options - The options object
+* @returns The merged object
+*/
+function deepMerge(target, source, options) {
+	if (!target || !source) return target || source;
+	const opts = options ?? {};
+	opts.arrayMerge ??= defaultArrayMerge;
+	opts.isMergeableObject ??= require_is_mergeable_object.isMergeableObject;
+	opts.cloneUnlessOtherwiseSpecified ??= cloneUnlessOtherwiseSpecified;
+	const sourceIsArray = Array.isArray(source);
+	if (!(sourceIsArray === Array.isArray(target))) return cloneUnlessOtherwiseSpecified(source, opts);
+	if (sourceIsArray) return opts.arrayMerge(target, source, opts);
+	return mergeObject(target, source, opts);
+}
+deepMerge.all = function deepMergeAll(array, options) {
+	if (!Array.isArray(array)) throw new TypeError("first argument should be an array");
+	return array.reduce((prev, next) => {
+		return deepMerge(prev, next, options);
+	}, {});
+};
+
+//#endregion
+exports.deepMerge = deepMerge;