es-toolkit 1.14.0 → 1.15.0-dev.416

package/dist/index.d.ts

@@ -81,6 +81,8 @@ export { flattenObject } from './object/flattenObject.js';
 export { mapKeys } from './object/mapKeys.js';
 export { mapValues } from './object/mapValues.js';
 export { cloneDeep } from './object/cloneDeep.js';
+export { merge } from './object/merge.js';
+export { mergeWith } from './object/mergeWith.js';
 export { isEqual } from './predicate/isEqual.js';
 export { isNil } from './predicate/isNil.js';
 export { isNotNil } from './predicate/isNotNil.js';
@@ -92,6 +94,7 @@ export { isFunction } from './predicate/isFunction.js';
 export { isTypedArray } from './predicate/isTypedArray.js';
 export { isPrimitive } from './predicate/isPrimitive.js';
 export { isBoolean } from './predicate/isBoolean.js';
+export { isSymbol } from './predicate/isSymbol.js';
 export { delay } from './promise/delay.js';
 export { withTimeout } from './promise/withTimeout.js';
 export { camelCase } from './string/camelCase.js';
@@ -100,3 +103,4 @@ export { kebabCase } from './string/kebabCase.js';
 export { lowerCase } from './string/lowerCase.js';
 export { startCase } from './string/startCase.js';
 export { capitalize } from './string/capitalize.js';
+export { pascalCase } from './string/pascalCase.js';

package/dist/index.js

@@ -2,14 +2,15 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const initial = require('./_chunk/initial-BTrQy1.js');
+const initial = require('./_chunk/initial-CBsbzo.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-CwRt_M.js');
 const function_index = require('./function/index.js');
 const math_index = require('./math/index.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
+const isObjectLike = require('./_chunk/isObjectLike-BeLCsr.js');
 const object_index = require('./object/index.js');
-const isFunction = require('./_chunk/isFunction-Cw_tLG.js');
+const isFunction = require('./_chunk/isFunction-D0hq6d.js');
 const isTypedArray = require('./_chunk/isTypedArray-BBEkFl.js');
 const predicate_index = require('./predicate/index.js');
 const string_index = require('./string/index.js');
@@ -41,7 +42,6 @@ exports.keyBy = initial.keyBy;
 exports.last = initial.last;
 exports.maxBy = initial.maxBy;
 exports.minBy = initial.minBy;
-exports.orderBy = initial.orderBy;
 exports.partition = initial.partition;
 exports.sample = initial.sample;
 exports.sampleSize = initial.sampleSize;
@@ -68,6 +68,7 @@ exports.zip = initial.zip;
 exports.zipObject = initial.zipObject;
 exports.zipWith = initial.zipWith;
 exports.flattenDeep = array_index.flattenDeep;
+exports.orderBy = array_index.orderBy;
 exports.AbortError = promise_index.AbortError;
 exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
@@ -91,16 +92,18 @@ exports.sum = math_index.sum;
 exports.sumBy = math_index.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
-exports.clone = object_index.clone;
-exports.cloneDeep = object_index.cloneDeep;
-exports.flattenObject = object_index.flattenObject;
-exports.invert = object_index.invert;
-exports.mapKeys = object_index.mapKeys;
-exports.mapValues = object_index.mapValues;
-exports.omit = object_index.omit;
-exports.omitBy = object_index.omitBy;
-exports.pick = object_index.pick;
-exports.pickBy = object_index.pickBy;
+exports.clone = isObjectLike.clone;
+exports.cloneDeep = isObjectLike.cloneDeep;
+exports.flattenObject = isObjectLike.flattenObject;
+exports.invert = isObjectLike.invert;
+exports.mapKeys = isObjectLike.mapKeys;
+exports.mapValues = isObjectLike.mapValues;
+exports.omit = isObjectLike.omit;
+exports.omitBy = isObjectLike.omitBy;
+exports.pick = isObjectLike.pick;
+exports.pickBy = isObjectLike.pickBy;
+exports.merge = object_index.merge;
+exports.mergeWith = object_index.mergeWith;
 exports.isEqual = isFunction.isEqual;
 exports.isFunction = isFunction.isFunction;
 exports.isLength = isFunction.isLength;
@@ -112,9 +115,11 @@ exports.isPlainObject = isTypedArray.isPlainObject;
 exports.isPrimitive = isTypedArray.isPrimitive;
 exports.isTypedArray = isTypedArray.isTypedArray;
 exports.isBoolean = predicate_index.isBoolean;
+exports.isSymbol = predicate_index.isSymbol;
 exports.camelCase = string_index.camelCase;
 exports.capitalize = string_index.capitalize;
 exports.kebabCase = string_index.kebabCase;
 exports.lowerCase = string_index.lowerCase;
+exports.pascalCase = string_index.pascalCase;
 exports.snakeCase = string_index.snakeCase;
 exports.startCase = string_index.startCase;

package/dist/index.mjs

@@ -81,6 +81,8 @@ export { flattenObject } from './object/flattenObject.mjs';
 export { mapKeys } from './object/mapKeys.mjs';
 export { mapValues } from './object/mapValues.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
+export { merge } from './object/merge.mjs';
+export { mergeWith } from './object/mergeWith.mjs';
 export { isEqual } from './predicate/isEqual.mjs';
 export { isNil } from './predicate/isNil.mjs';
 export { isNotNil } from './predicate/isNotNil.mjs';
@@ -92,6 +94,7 @@ export { isFunction } from './predicate/isFunction.mjs';
 export { isTypedArray } from './predicate/isTypedArray.mjs';
 export { isPrimitive } from './predicate/isPrimitive.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
+export { isSymbol } from './predicate/isSymbol.mjs';
 export { delay } from './promise/delay.mjs';
 export { withTimeout } from './promise/withTimeout.mjs';
 export { camelCase } from './string/camelCase.mjs';
@@ -100,3 +103,4 @@ export { kebabCase } from './string/kebabCase.mjs';
 export { lowerCase } from './string/lowerCase.mjs';
 export { startCase } from './string/startCase.mjs';
 export { capitalize } from './string/capitalize.mjs';
+export { pascalCase } from './string/pascalCase.mjs';

package/dist/object/index.d.mts

@@ -8,3 +8,5 @@ export { flattenObject } from './flattenObject.mjs';
 export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { merge } from './merge.mjs';
+export { mergeWith } from './mergeWith.mjs';

package/dist/object/index.d.ts

@@ -8,3 +8,5 @@ export { flattenObject } from './flattenObject.js';
 export { mapKeys } from './mapKeys.js';
 export { mapValues } from './mapValues.js';
 export { cloneDeep } from './cloneDeep.js';
+export { merge } from './merge.js';
+export { mergeWith } from './mergeWith.js';

package/dist/object/index.js

@@ -2,258 +2,59 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const isTypedArray = require('../_chunk/isTypedArray-BBEkFl.js');
+const isObjectLike = require('../_chunk/isObjectLike-BeLCsr.js');
 
-function omit(obj, keys) {
-    const result = { ...obj };
-    for (const key of keys) {
-        delete result[key];
-    }
-    return result;
-}
-
-function omitBy(obj, shouldOmit) {
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (shouldOmit(value, key)) {
-            continue;
-        }
-        result[key] = value;
-    }
-    return result;
-}
-
-function pick(obj, keys) {
-    const result = {};
-    for (const key of keys) {
-        result[key] = obj[key];
-    }
-    return result;
-}
-
-function pickBy(obj, shouldPick) {
-    const result = {};
-    for (const [key, value] of Object.entries(obj)) {
-        if (!shouldPick(value, key)) {
-            continue;
+function merge(target, source) {
+    const sourceKeys = Object.keys(source);
+    for (let i = 0; i < sourceKeys.length; i++) {
+        const key = sourceKeys[i];
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (Array.isArray(sourceValue)) {
+            target[key] = merge(targetValue ?? [], sourceValue);
         }
-        result[key] = value;
-    }
-    return result;
-}
-
-function invert(obj) {
-    const result = {};
-    const keys = Object.keys(obj);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const value = obj[key];
-        result[value] = key;
-    }
-    return result;
-}
-
-function clone(obj) {
-    if (isPrimitive(obj)) {
-        return obj;
-    }
-    if (Array.isArray(obj)) {
-        return obj.slice();
-    }
-    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 = new Map();
-        for (const [key, value] of obj) {
-            result.set(key, value);
+        else if (isObjectLike.isObjectLike(targetValue) && isObjectLike.isObjectLike(sourceValue)) {
+            target[key] = merge(targetValue ?? {}, sourceValue);
         }
-        return result;
-    }
-    if (obj instanceof Set) {
-        const result = new Set();
-        for (const value of obj) {
-            result.add(value);
+        else if (targetValue === undefined || sourceValue !== undefined) {
+            target[key] = sourceValue;
         }
-        return result;
     }
-    if (typeof obj === 'object') {
-        const prototype = Object.getPrototypeOf(obj);
-        const result = Object.create(prototype);
-        return Object.assign(result, obj);
-    }
-    return obj;
-}
-function isPrimitive(value) {
-    return value == null || (typeof value !== 'object' && typeof value !== 'function');
+    return target;
 }
 
-function flattenObject(object) {
-    return flattenObjectImpl(object);
-}
-function flattenObjectImpl(object, prefix = '') {
-    const result = {};
-    const keys = Object.keys(object);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const value = object[key];
-        const prefixedKey = prefix ? `${prefix}.${key}` : key;
-        if (isTypedArray.isPlainObject(value) && Object.keys(value).length > 0) {
-            Object.assign(result, flattenObjectImpl(value, prefixedKey));
-            continue;
+function mergeWith(target, source, merge) {
+    const sourceKeys = Object.keys(source);
+    for (let i = 0; i < sourceKeys.length; i++) {
+        const key = sourceKeys[i];
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        const merged = merge(targetValue, sourceValue, key, target, source);
+        if (merged != null) {
+            target[key] = merged;
         }
-        if (Array.isArray(value)) {
-            for (let index = 0; index < value.length; index++) {
-                result[`${prefixedKey}.${index}`] = value[index];
-            }
-            continue;
+        else if (Array.isArray(sourceValue)) {
+            target[key] = mergeWith(targetValue ?? [], sourceValue, merge);
         }
-        result[prefixedKey] = value;
-    }
-    return result;
-}
-
-function mapKeys(object, getNewKey) {
-    const result = {};
-    const keys = Object.keys(object);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const value = object[key];
-        result[getNewKey(value, key, object)] = value;
-    }
-    return result;
-}
-
-function mapValues(object, getNewValue) {
-    const result = {};
-    const keys = Object.keys(object);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const value = object[key];
-        result[key] = getNewValue(value, key, object);
-    }
-    return result;
-}
-
-function cloneDeep(obj) {
-    return cloneDeepImpl(obj);
-}
-function cloneDeepImpl(obj, stack = new Map()) {
-    if (isTypedArray.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.prototype.hasOwnProperty.call(obj, 'index')) {
-            result.index = obj.index;
-        }
-        if (Object.prototype.hasOwnProperty.call(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.entries()) {
-            result.set(key, cloneDeepImpl(value, stack));
+        else if (isObjectLike.isObjectLike(targetValue) && isObjectLike.isObjectLike(sourceValue)) {
+            target[key] = mergeWith(targetValue ?? {}, sourceValue, merge);
         }
-        return result;
-    }
-    if (obj instanceof Set) {
-        const result = new Set();
-        stack.set(obj, result);
-        for (const value of obj.values()) {
-            result.add(cloneDeepImpl(value, stack));
-        }
-        return result;
-    }
-    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(obj)) {
-        return obj.subarray();
-    }
-    if (isTypedArray.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));
-        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 = {};
-        stack.set(obj, result);
-        copyProperties(result, obj, stack);
-        return result;
-    }
-    return obj;
-}
-function copyProperties(target, source, stack) {
-    const keys = Object.keys(source);
-    for (let i = 0; i < keys.length; i++) {
-        const key = keys[i];
-        const descriptor = Object.getOwnPropertyDescriptor(source, key);
-        if (descriptor?.writable || descriptor?.set) {
-            target[key] = cloneDeepImpl(source[key], stack);
+        else if (targetValue === undefined || sourceValue !== undefined) {
+            target[key] = sourceValue;
         }
     }
+    return target;
 }
 
-exports.clone = clone;
-exports.cloneDeep = cloneDeep;
-exports.flattenObject = flattenObject;
-exports.invert = invert;
-exports.mapKeys = mapKeys;
-exports.mapValues = mapValues;
-exports.omit = omit;
-exports.omitBy = omitBy;
-exports.pick = pick;
-exports.pickBy = pickBy;
+exports.clone = isObjectLike.clone;
+exports.cloneDeep = isObjectLike.cloneDeep;
+exports.flattenObject = isObjectLike.flattenObject;
+exports.invert = isObjectLike.invert;
+exports.mapKeys = isObjectLike.mapKeys;
+exports.mapValues = isObjectLike.mapValues;
+exports.omit = isObjectLike.omit;
+exports.omitBy = isObjectLike.omitBy;
+exports.pick = isObjectLike.pick;
+exports.pickBy = isObjectLike.pickBy;
+exports.merge = merge;
+exports.mergeWith = mergeWith;

package/dist/object/index.mjs

@@ -8,3 +8,5 @@ export { flattenObject } from './flattenObject.mjs';
 export { mapKeys } from './mapKeys.mjs';
 export { mapValues } from './mapValues.mjs';
 export { cloneDeep } from './cloneDeep.mjs';
+export { merge } from './merge.mjs';
+export { mergeWith } from './mergeWith.mjs';

package/dist/object/merge.d.mts

@@ -0,0 +1,43 @@
+/**
+ * Merges the properties of the source object into the target object.
+ *
+ * This function performs a deep merge, meaning nested objects and arrays are merged recursively.
+ * If a property in the source object is an array or an object and the corresponding property in the target object is also an array or object, they will be merged.
+ * If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function mutates the target object.
+ *
+ * @param {T} target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param {S} source - The source object whose properties will be merged into the target object.
+ * @returns {T & S} The updated target object with properties from the source object merged in.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: { x: 1, y: 2 } };
+ * const source = { b: { y: 3, z: 4 }, c: 5 };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: 1, b: { x: 1, y: 3, z: 4 }, c: 5 }
+ *
+ * @example
+ * const target = { a: [1, 2], b: { x: 1 } };
+ * const source = { a: [3], b: { y: 2 } };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: [3, 2], b: { x: 1, y: 2 } }
+ *
+ * @example
+ * const target = { a: null };
+ * const source = { a: [1, 2, 3] };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: [1, 2, 3] }
+ */
+declare function merge<T, S>(target: T, source: S): T & S;
+
+export { merge };

package/dist/object/merge.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Merges the properties of the source object into the target object.
+ *
+ * This function performs a deep merge, meaning nested objects and arrays are merged recursively.
+ * If a property in the source object is an array or an object and the corresponding property in the target object is also an array or object, they will be merged.
+ * If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function mutates the target object.
+ *
+ * @param {T} target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param {S} source - The source object whose properties will be merged into the target object.
+ * @returns {T & S} The updated target object with properties from the source object merged in.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: { x: 1, y: 2 } };
+ * const source = { b: { y: 3, z: 4 }, c: 5 };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: 1, b: { x: 1, y: 3, z: 4 }, c: 5 }
+ *
+ * @example
+ * const target = { a: [1, 2], b: { x: 1 } };
+ * const source = { a: [3], b: { y: 2 } };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: [3, 2], b: { x: 1, y: 2 } }
+ *
+ * @example
+ * const target = { a: null };
+ * const source = { a: [1, 2, 3] };
+ *
+ * const result = merge(target, source);
+ * console.log(result);
+ * // Output: { a: [1, 2, 3] }
+ */
+declare function merge<T, S>(target: T, source: S): T & S;
+
+export { merge };

package/dist/object/merge.mjs

@@ -0,0 +1,22 @@
+import { isObjectLike } from '../compat/predicate/isObjectLike.mjs';
+
+function merge(target, source) {
+    const sourceKeys = Object.keys(source);
+    for (let i = 0; i < sourceKeys.length; i++) {
+        const key = sourceKeys[i];
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (Array.isArray(sourceValue)) {
+            target[key] = merge(targetValue ?? [], sourceValue);
+        }
+        else if (isObjectLike(targetValue) && isObjectLike(sourceValue)) {
+            target[key] = merge(targetValue ?? {}, sourceValue);
+        }
+        else if (targetValue === undefined || sourceValue !== undefined) {
+            target[key] = sourceValue;
+        }
+    }
+    return target;
+}
+
+export { merge };

package/dist/object/mergeWith.d.mts

@@ -0,0 +1,51 @@
+/**
+ * Merges the properties of the source object into the target object.
+ *
+ * You can provide a custom `merge` function to control how properties are merged. It should return the value to be set in the target object.
+ *
+ * If it returns `undefined`, a default deep merge will be applied for arrays and objects:
+ *
+ * - If a property in the source object is an array or an object and the corresponding property in the target object is also an array or object, they will be merged.
+ * - If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function mutates the target object.
+ *
+ * @param {T} target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param {S} source - The source object whose properties will be merged into the target object.
+ * @param {(targetValue: any, sourceValue: any, key: string, target: T, source: S) => any} merge - A custom merge function that defines how properties should be combined. It receives the following arguments:
+ *   - `targetValue`: The current value of the property in the target object.
+ *   - `sourceValue`: The value of the property in the source object.
+ *   - `key`: The key of the property being merged.
+ *   - `target`: The target object.
+ *   - `source`: The source object.
+ *
+ * @returns {T & S} The updated target object with properties from the source object merged in.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: 2 };
+ * const source = { b: 3, c: 4 };
+ *
+ * mergeWith(target, source, (targetValue, sourceValue) => {
+ *   if (typeof targetValue === 'number' && typeof sourceValue === 'number') {
+ *     return targetValue + sourceValue;
+ *   }
+ * });
+ * // Returns { a: 1, b: 5, c: 4 }
+ * @example
+ * const target = { a: [1], b: [2] };
+ * const source = { a: [3], b: [4] };
+ *
+ * const result = mergeWith(target, source, (objValue, srcValue) => {
+ *   if (Array.isArray(objValue)) {
+ *     return objValue.concat(srcValue);
+ *   }
+ * });
+ *
+ * expect(result).toEqual({ a: [1, 3], b: [2, 4] });
+ */
+declare function mergeWith<T, S>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
+
+export { mergeWith };

package/dist/object/mergeWith.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Merges the properties of the source object into the target object.
+ *
+ * You can provide a custom `merge` function to control how properties are merged. It should return the value to be set in the target object.
+ *
+ * If it returns `undefined`, a default deep merge will be applied for arrays and objects:
+ *
+ * - If a property in the source object is an array or an object and the corresponding property in the target object is also an array or object, they will be merged.
+ * - If a property in the source object is undefined, it will not overwrite a defined property in the target object.
+ *
+ * Note that this function mutates the target object.
+ *
+ * @param {T} target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param {S} source - The source object whose properties will be merged into the target object.
+ * @param {(targetValue: any, sourceValue: any, key: string, target: T, source: S) => any} merge - A custom merge function that defines how properties should be combined. It receives the following arguments:
+ *   - `targetValue`: The current value of the property in the target object.
+ *   - `sourceValue`: The value of the property in the source object.
+ *   - `key`: The key of the property being merged.
+ *   - `target`: The target object.
+ *   - `source`: The source object.
+ *
+ * @returns {T & S} The updated target object with properties from the source object merged in.
+ *
+ * @template T - Type of the target object.
+ * @template S - Type of the source object.
+ *
+ * @example
+ * const target = { a: 1, b: 2 };
+ * const source = { b: 3, c: 4 };
+ *
+ * mergeWith(target, source, (targetValue, sourceValue) => {
+ *   if (typeof targetValue === 'number' && typeof sourceValue === 'number') {
+ *     return targetValue + sourceValue;
+ *   }
+ * });
+ * // Returns { a: 1, b: 5, c: 4 }
+ * @example
+ * const target = { a: [1], b: [2] };
+ * const source = { a: [3], b: [4] };
+ *
+ * const result = mergeWith(target, source, (objValue, srcValue) => {
+ *   if (Array.isArray(objValue)) {
+ *     return objValue.concat(srcValue);
+ *   }
+ * });
+ *
+ * expect(result).toEqual({ a: [1, 3], b: [2, 4] });
+ */
+declare function mergeWith<T, S>(target: T, source: S, merge: (targetValue: any, sourceValue: any, key: string, target: T, source: S) => any): T & S;
+
+export { mergeWith };