es-toolkit 1.28.0 → 1.29.0-dev.916

package/dist/compat/array/lastIndexOf.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Finds the index of the last occurrence of a value in an array.
+ *
+ * This method is similar to `Array.prototype.lastIndexOf`, but it also finds `NaN` values.
+ * It uses strict equality (`===`) to compare elements.
+ *
+ * @template T - The type of elements in the array.
+ * @param {ArrayLike<T> | null | undefined} array - The array to search.
+ * @param {T} searchElement - The value to search for.
+ * @param {number} [fromIndex] - The index to start the search at.
+ * @returns {number} The index (zero-based) of the last occurrence of the value in the array, or `-1` if the value is not found.
+ *
+ * @example
+ * const array = [1, 2, 3, NaN, 1];
+ * lastIndexOf(array, 3); // => 4
+ * lastIndexOf(array, NaN); // => 3
+ */
+declare function lastIndexOf<T>(array: ArrayLike<T> | null | undefined, searchElement: T, fromIndex?: number): number;
+
+export { lastIndexOf };

package/dist/compat/array/lastIndexOf.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Finds the index of the last occurrence of a value in an array.
+ *
+ * This method is similar to `Array.prototype.lastIndexOf`, but it also finds `NaN` values.
+ * It uses strict equality (`===`) to compare elements.
+ *
+ * @template T - The type of elements in the array.
+ * @param {ArrayLike<T> | null | undefined} array - The array to search.
+ * @param {T} searchElement - The value to search for.
+ * @param {number} [fromIndex] - The index to start the search at.
+ * @returns {number} The index (zero-based) of the last occurrence of the value in the array, or `-1` if the value is not found.
+ *
+ * @example
+ * const array = [1, 2, 3, NaN, 1];
+ * lastIndexOf(array, 3); // => 4
+ * lastIndexOf(array, NaN); // => 3
+ */
+declare function lastIndexOf<T>(array: ArrayLike<T> | null | undefined, searchElement: T, fromIndex?: number): number;
+
+export { lastIndexOf };

package/dist/compat/array/lastIndexOf.mjs

@@ -0,0 +1,22 @@
+import { isArrayLike } from '../predicate/isArrayLike.mjs';
+
+function lastIndexOf(array, searchElement, fromIndex) {
+    if (!isArrayLike(array) || array.length === 0) {
+        return -1;
+    }
+    const length = array.length;
+    let index = fromIndex ?? length - 1;
+    if (fromIndex != null) {
+        index = index < 0 ? Math.max(length + index, 0) : Math.min(index, length - 1);
+    }
+    if (Number.isNaN(searchElement)) {
+        for (let i = index; i >= 0; i--) {
+            if (Number.isNaN(array[i])) {
+                return i;
+            }
+        }
+    }
+    return Array.from(array).lastIndexOf(searchElement, index);
+}
+
+export { lastIndexOf };

package/dist/compat/index.d.mts

@@ -104,6 +104,7 @@ export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { join } from './array/join.mjs';
 export { last } from './array/last.mjs';
+export { lastIndexOf } from './array/lastIndexOf.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { sample } from './array/sample.mjs';
 export { size } from './array/size.mjs';
@@ -150,6 +151,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { assignIn, assignIn as extend } from './object/assignIn.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { defaults } from './object/defaults.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
 export { get } from './object/get.mjs';

package/dist/compat/index.d.ts

@@ -104,6 +104,7 @@ export { intersection } from './array/intersection.js';
 export { intersectionBy } from './array/intersectionBy.js';
 export { join } from './array/join.js';
 export { last } from './array/last.js';
+export { lastIndexOf } from './array/lastIndexOf.js';
 export { orderBy } from './array/orderBy.js';
 export { sample } from './array/sample.js';
 export { size } from './array/size.js';
@@ -150,6 +151,7 @@ export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';
 export { assignIn, assignIn as extend } from './object/assignIn.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { cloneDeepWith } from './object/cloneDeepWith.js';
 export { defaults } from './object/defaults.js';
 export { fromPairs } from './object/fromPairs.js';
 export { get } from './object/get.js';

package/dist/compat/index.js

@@ -8,7 +8,7 @@ const unary = require('../_chunk/unary-CcTNuC.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-CPY8Ug.js');
+const toMerged = require('../_chunk/toMerged-DGFrN7.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
 const isWeakSet$1 = require('../_chunk/isWeakSet-CvIdTA.js');
 const upperFirst = require('../_chunk/upperFirst-CorAVn.js');
@@ -354,29 +354,39 @@ function matches(source) {
     };
 }
 
-function cloneDeep(obj) {
-    if (typeof obj !== 'object') {
-        return toMerged.cloneDeep(obj);
-    }
-    switch (Object.prototype.toString.call(obj)) {
-        case isWeakSet$1.numberTag:
-        case isWeakSet$1.stringTag:
-        case isWeakSet$1.booleanTag: {
-            const result = new obj.constructor(obj?.valueOf());
-            toMerged.copyProperties(result, obj);
-            return result;
+function cloneDeepWith(obj, cloneValue) {
+    return toMerged.cloneDeepWith(obj, (value, key, object, stack) => {
+        const cloned = cloneValue?.(value, key, object, stack);
+        if (cloned != null) {
+            return cloned;
         }
-        case isWeakSet$1.argumentsTag: {
-            const result = {};
-            toMerged.copyProperties(result, obj);
-            result.length = obj.length;
-            result[Symbol.iterator] = obj[Symbol.iterator];
-            return result;
+        if (typeof obj !== 'object') {
+            return undefined;
         }
-        default: {
-            return toMerged.cloneDeep(obj);
+        switch (Object.prototype.toString.call(obj)) {
+            case isWeakSet$1.numberTag:
+            case isWeakSet$1.stringTag:
+            case isWeakSet$1.booleanTag: {
+                const result = new obj.constructor(obj?.valueOf());
+                toMerged.copyProperties(result, obj);
+                return result;
+            }
+            case isWeakSet$1.argumentsTag: {
+                const result = {};
+                toMerged.copyProperties(result, obj);
+                result.length = obj.length;
+                result[Symbol.iterator] = obj[Symbol.iterator];
+                return result;
+            }
+            default: {
+                return undefined;
+            }
         }
-    }
+    });
+}
+
+function cloneDeep(obj) {
+    return cloneDeepWith(obj);
 }
 
 const IS_UNSIGNED_INTEGER = /^(?:0|[1-9]\d*)$/;
@@ -979,6 +989,25 @@ function join(array, separator = ',') {
     return Array.from(array).join(separator);
 }
 
+function lastIndexOf(array, searchElement, fromIndex) {
+    if (!isArrayLike(array) || array.length === 0) {
+        return -1;
+    }
+    const length = array.length;
+    let index = fromIndex ?? length - 1;
+    if (fromIndex != null) {
+        index = index < 0 ? Math.max(length + index, 0) : Math.min(index, length - 1);
+    }
+    if (Number.isNaN(searchElement)) {
+        for (let i = index; i >= 0; i--) {
+            if (Number.isNaN(array[i])) {
+                return i;
+            }
+        }
+    }
+    return Array.from(array).lastIndexOf(searchElement, index);
+}
+
 function getPriority(a) {
     if (typeof a === 'symbol') {
         return 1;
@@ -2778,6 +2807,7 @@ exports.ceil = ceil;
 exports.chunk = chunk;
 exports.clamp = clamp;
 exports.cloneDeep = cloneDeep;
+exports.cloneDeepWith = cloneDeepWith;
 exports.compact = compact;
 exports.concat = concat;
 exports.conforms = conforms;
@@ -2859,6 +2889,7 @@ exports.join = join;
 exports.kebabCase = kebabCase;
 exports.keysIn = keysIn;
 exports.last = last;
+exports.lastIndexOf = lastIndexOf;
 exports.lowerCase = lowerCase;
 exports.mapKeys = mapKeys;
 exports.mapValues = mapValues;

package/dist/compat/index.mjs

@@ -105,6 +105,7 @@ export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { join } from './array/join.mjs';
 export { last } from './array/last.mjs';
+export { lastIndexOf } from './array/lastIndexOf.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { sample } from './array/sample.mjs';
 export { size } from './array/size.mjs';
@@ -151,6 +152,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { assignIn, assignIn as extend } from './object/assignIn.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { defaults } from './object/defaults.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
 export { get } from './object/get.mjs';

package/dist/compat/object/cloneDeep.mjs

@@ -1,29 +1,7 @@
-import { cloneDeep as cloneDeep$1, copyProperties } from '../../object/cloneDeep.mjs';
-import { argumentsTag, booleanTag, stringTag, numberTag } from '../_internal/tags.mjs';
+import { cloneDeepWith } from './cloneDeepWith.mjs';
 
 function cloneDeep(obj) {
-    if (typeof obj !== 'object') {
-        return cloneDeep$1(obj);
-    }
-    switch (Object.prototype.toString.call(obj)) {
-        case numberTag:
-        case stringTag:
-        case booleanTag: {
-            const result = new obj.constructor(obj?.valueOf());
-            copyProperties(result, obj);
-            return result;
-        }
-        case argumentsTag: {
-            const result = {};
-            copyProperties(result, obj);
-            result.length = obj.length;
-            result[Symbol.iterator] = obj[Symbol.iterator];
-            return result;
-        }
-        default: {
-            return cloneDeep$1(obj);
-        }
-    }
+    return cloneDeepWith(obj);
 }
 
 export { cloneDeep };

package/dist/compat/object/cloneDeepWith.d.mts

@@ -0,0 +1,38 @@
+/**
+ * Creates a deep clone of the given object using a customizer function.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue?: (value: any, key: PropertyKey | undefined, object: T | undefined, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };

package/dist/compat/object/cloneDeepWith.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Creates a deep clone of the given object using a customizer function.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue?: (value: any, key: PropertyKey | undefined, object: T | undefined, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };

package/dist/compat/object/cloneDeepWith.mjs

@@ -0,0 +1,35 @@
+import { cloneDeepWith as cloneDeepWith$1, copyProperties } from '../../object/cloneDeepWith.mjs';
+import { argumentsTag, booleanTag, stringTag, numberTag } from '../_internal/tags.mjs';
+
+function cloneDeepWith(obj, cloneValue) {
+    return cloneDeepWith$1(obj, (value, key, object, stack) => {
+        const cloned = cloneValue?.(value, key, object, stack);
+        if (cloned != null) {
+            return cloned;
+        }
+        if (typeof obj !== 'object') {
+            return undefined;
+        }
+        switch (Object.prototype.toString.call(obj)) {
+            case numberTag:
+            case stringTag:
+            case booleanTag: {
+                const result = new obj.constructor(obj?.valueOf());
+                copyProperties(result, obj);
+                return result;
+            }
+            case argumentsTag: {
+                const result = {};
+                copyProperties(result, obj);
+                result.length = obj.length;
+                result[Symbol.iterator] = obj[Symbol.iterator];
+                return result;
+            }
+            default: {
+                return undefined;
+            }
+        }
+    });
+}
+
+export { cloneDeepWith };

package/dist/index.d.mts

@@ -91,6 +91,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { clone } from './object/clone.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';

package/dist/index.d.ts

@@ -91,6 +91,7 @@ export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';
 export { clone } from './object/clone.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { cloneDeepWith } from './object/cloneDeepWith.js';
 export { findKey } from './object/findKey.js';
 export { flattenObject } from './object/flattenObject.js';
 export { invert } from './object/invert.js';

package/dist/index.js

@@ -11,7 +11,7 @@ const noop = require('./_chunk/noop-2IwLUk.js');
 const rangeRight = require('./_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
-const toMerged = require('./_chunk/toMerged-CPY8Ug.js');
+const toMerged = require('./_chunk/toMerged-DGFrN7.js');
 const object_index = require('./object/index.js');
 const isWeakSet = require('./_chunk/isWeakSet-CvIdTA.js');
 const predicate_index = require('./predicate/index.js');
@@ -118,6 +118,7 @@ exports.round = math_index.round;
 exports.sumBy = math_index.sumBy;
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
+exports.cloneDeepWith = toMerged.cloneDeepWith;
 exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;

package/dist/index.mjs

@@ -91,6 +91,7 @@ export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { clone } from './object/clone.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { cloneDeepWith } from './object/cloneDeepWith.mjs';
 export { findKey } from './object/findKey.mjs';
 export { flattenObject } from './object/flattenObject.mjs';
 export { invert } from './object/invert.mjs';

package/dist/object/cloneDeep.mjs

@@ -1,114 +1,7 @@
-import { getSymbols } from '../compat/_internal/getSymbols.mjs';
-import { isPrimitive } from '../predicate/isPrimitive.mjs';
-import { isTypedArray } from '../predicate/isTypedArray.mjs';
+import { cloneDeepWithImpl } from './cloneDeepWith.mjs';
 
 function cloneDeep(obj) {
-    return cloneDeepImpl(obj);
-}
-function cloneDeepImpl(obj, stack = new Map()) {
-    if (isPrimitive(obj)) {
-        return obj;
-    }
-    if (stack.has(obj)) {
-        return stack.get(obj);
-    }
-    if (Array.isArray(obj)) {
-        const result = new Array(obj.length);
-        stack.set(obj, result);
-        for (let i = 0; i < obj.length; i++) {
-            result[i] = cloneDeepImpl(obj[i], stack);
-        }
-        if (Object.hasOwn(obj, 'index')) {
-            result.index = obj.index;
-        }
-        if (Object.hasOwn(obj, 'input')) {
-            result.input = obj.input;
-        }
-        return result;
-    }
-    if (obj instanceof Date) {
-        return new Date(obj.getTime());
-    }
-    if (obj instanceof RegExp) {
-        const result = new RegExp(obj.source, obj.flags);
-        result.lastIndex = obj.lastIndex;
-        return result;
-    }
-    if (obj instanceof Map) {
-        const result = new Map();
-        stack.set(obj, result);
-        for (const [key, value] of obj) {
-            result.set(key, cloneDeepImpl(value, stack));
-        }
-        return result;
-    }
-    if (obj instanceof Set) {
-        const result = new Set();
-        stack.set(obj, result);
-        for (const value of obj) {
-            result.add(cloneDeepImpl(value, stack));
-        }
-        return result;
-    }
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(obj)) {
-        return obj.subarray();
-    }
-    if (isTypedArray(obj)) {
-        const result = new (Object.getPrototypeOf(obj).constructor)(obj.length);
-        stack.set(obj, result);
-        for (let i = 0; i < obj.length; i++) {
-            result[i] = cloneDeepImpl(obj[i], stack);
-        }
-        return result;
-    }
-    if (obj instanceof ArrayBuffer || (typeof SharedArrayBuffer !== 'undefined' && obj instanceof SharedArrayBuffer)) {
-        return obj.slice(0);
-    }
-    if (obj instanceof DataView) {
-        const result = new DataView(obj.buffer.slice(0), obj.byteOffset, obj.byteLength);
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (typeof File !== 'undefined' && obj instanceof File) {
-        const result = new File([obj], obj.name, { type: obj.type });
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (obj instanceof Blob) {
-        const result = new Blob([obj], { type: obj.type });
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (obj instanceof Error) {
-        const result = new obj.constructor();
-        stack.set(obj, result);
-        result.message = obj.message;
-        result.name = obj.name;
-        result.stack = obj.stack;
-        result.cause = obj.cause;
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    if (typeof obj === 'object' && obj !== null) {
-        const result = Object.create(Object.getPrototypeOf(obj));
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    return obj;
-}
-function copyProperties(target, source, stack) {
-    const keys = [...Object.keys(source), ...getSymbols(source)];
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const descriptor = Object.getOwnPropertyDescriptor(target, key);
-        if (descriptor == null || descriptor.writable) {
-            target[key] = cloneDeepImpl(source[key], stack);
-        }
-    }
+    return cloneDeepWithImpl(obj, undefined, obj, new Map(), undefined);
 }
 
-export { cloneDeep, copyProperties };
+export { cloneDeep };

package/dist/object/cloneDeepWith.d.mts

@@ -0,0 +1,43 @@
+/**
+ * Deeply clones the given object.
+ *
+ * You can customize the deep cloning process using the `cloneValue` function.
+ * The function takes the current value `value`, the property name `key`, and the entire object `obj` as arguments.
+ * If the function returns a value, that value is used;
+ * if it returns `undefined`, the default cloning method is used.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue: (value: any, key: PropertyKey | undefined, obj: T, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };

package/dist/object/cloneDeepWith.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Deeply clones the given object.
+ *
+ * You can customize the deep cloning process using the `cloneValue` function.
+ * The function takes the current value `value`, the property name `key`, and the entire object `obj` as arguments.
+ * If the function returns a value, that value is used;
+ * if it returns `undefined`, the default cloning method is used.
+ *
+ * @template T - The type of the object.
+ * @param {T} obj - The object to clone.
+ * @param {Function} [cloneValue] - A function to customize the cloning process.
+ * @returns {T} - A deep clone of the given object.
+ *
+ * @example
+ * // Clone a primitive value
+ * const num = 29;
+ * const clonedNum = cloneDeepWith(num);
+ * console.log(clonedNum); // 29
+ * console.log(clonedNum === num); // true
+ *
+ * @example
+ * // Clone an object with a customizer
+ * const obj = { a: 1, b: 2 };
+ * const clonedObj = cloneDeepWith(obj, (value) => {
+ *   if (typeof value === 'number') {
+ *     return value * 2; // Double the number
+ *   }
+ * });
+ * console.log(clonedObj); // { a: 2, b: 4 }
+ * console.log(clonedObj === obj); // false
+ *
+ * @example
+ * // Clone an array with a customizer
+ * const arr = [1, 2, 3];
+ * const clonedArr = cloneDeepWith(arr, (value) => {
+ *   return value + 1; // Increment each value
+ * });
+ * console.log(clonedArr); // [2, 3, 4]
+ * console.log(clonedArr === arr); // false
+ */
+declare function cloneDeepWith<T>(obj: T, cloneValue: (value: any, key: PropertyKey | undefined, obj: T, stack: Map<any, any>) => any): T;
+
+export { cloneDeepWith };