es-toolkit 1.47.0-dev.1840 → 1.47.0-dev.1842

package/dist/math/sumBy.d.ts

@@ -6,10 +6,10 @@
  * If the array is empty, this function returns `0`.
  *
  * @template T - The type of elements in the array.
- * @param {readonly T[]} items - An array to calculate the sum.
- * @param {(element: T, index: number) => number} getValue - A function that selects a numeric value from each element.
+ * @param items - An array to calculate the sum.
+ * @param getValue - A function that selects a numeric value from each element.
  *   It receives the element and its zero‑based index in the array.
- * @returns {number} The sum of all the numbers as determined by the `getValue` function.
+ * @returns The sum of all the numbers as determined by the `getValue` function.
  *
  * @example
  * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8

package/dist/math/sumBy.js

@@ -6,10 +6,10 @@
 * If the array is empty, this function returns `0`.
 *
 * @template T - The type of elements in the array.
-* @param {readonly T[]} items - An array to calculate the sum.
-* @param {(element: T, index: number) => number} getValue - A function that selects a numeric value from each element.
+* @param items - An array to calculate the sum.
+* @param getValue - A function that selects a numeric value from each element.
 *   It receives the element and its zero‑based index in the array.
-* @returns {number} The sum of all the numbers as determined by the `getValue` function.
+* @returns The sum of all the numbers as determined by the `getValue` function.
 *
 * @example
 * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8

package/dist/math/sumBy.mjs

@@ -6,10 +6,10 @@
 * If the array is empty, this function returns `0`.
 *
 * @template T - The type of elements in the array.
-* @param {readonly T[]} items - An array to calculate the sum.
-* @param {(element: T, index: number) => number} getValue - A function that selects a numeric value from each element.
+* @param items - An array to calculate the sum.
+* @param getValue - A function that selects a numeric value from each element.
 *   It receives the element and its zero‑based index in the array.
-* @returns {number} The sum of all the numbers as determined by the `getValue` function.
+* @returns The sum of all the numbers as determined by the `getValue` function.
 *
 * @example
 * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8

package/dist/object/clone.d.mts

@@ -3,8 +3,8 @@
  * Creates a shallow clone of the given object.
  *
  * @template T - The type of the object.
- * @param {T} obj - The object to clone.
- * @returns {T} - A shallow clone of the given object.
+ * @param obj - The object to clone.
+ * @returns A shallow clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/clone.d.ts

@@ -3,8 +3,8 @@
  * Creates a shallow clone of the given object.
  *
  * @template T - The type of the object.
- * @param {T} obj - The object to clone.
- * @returns {T} - A shallow clone of the given object.
+ * @param obj - The object to clone.
+ * @returns A shallow clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/clone.js

@@ -5,8 +5,8 @@ const require_isTypedArray = require("../predicate/isTypedArray.js");
 * Creates a shallow clone of the given object.
 *
 * @template T - The type of the object.
-* @param {T} obj - The object to clone.
-* @returns {T} - A shallow clone of the given object.
+* @param obj - The object to clone.
+* @returns A shallow clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/clone.mjs

@@ -5,8 +5,8 @@ import { isTypedArray } from "../predicate/isTypedArray.mjs";
 * Creates a shallow clone of the given object.
 *
 * @template T - The type of the object.
-* @param {T} obj - The object to clone.
-* @returns {T} - A shallow clone of the given object.
+* @param obj - The object to clone.
+* @returns A shallow clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/cloneDeep.d.mts

@@ -3,8 +3,8 @@
  * Creates a deep clone of the given object.
  *
  * @template T - The type of the object.
- * @param {T} obj - The object to clone.
- * @returns {T} - A deep clone of the given object.
+ * @param obj - The object to clone.
+ * @returns A deep clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/cloneDeep.d.ts

@@ -3,8 +3,8 @@
  * Creates a deep clone of the given object.
  *
  * @template T - The type of the object.
- * @param {T} obj - The object to clone.
- * @returns {T} - A deep clone of the given object.
+ * @param obj - The object to clone.
+ * @returns A deep clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/cloneDeep.js

@@ -4,8 +4,8 @@ const require_cloneDeepWith = require("./cloneDeepWith.js");
 * Creates a deep clone of the given object.
 *
 * @template T - The type of the object.
-* @param {T} obj - The object to clone.
-* @returns {T} - A deep clone of the given object.
+* @param obj - The object to clone.
+* @returns A deep clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/cloneDeep.mjs

@@ -4,8 +4,8 @@ import { cloneDeepWithImpl } from "./cloneDeepWith.mjs";
 * Creates a deep clone of the given object.
 *
 * @template T - The type of the object.
-* @param {T} obj - The object to clone.
-* @returns {T} - A deep clone of the given object.
+* @param obj - The object to clone.
+* @returns A deep clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/cloneDeepWith.d.mts

@@ -8,9 +8,9 @@
  * 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.
+ * @param obj - The object to clone.
+ * @param [cloneValue] - A function to customize the cloning process.
+ * @returns A deep clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/cloneDeepWith.d.ts

@@ -8,9 +8,9 @@
  * 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.
+ * @param obj - The object to clone.
+ * @param [cloneValue] - A function to customize the cloning process.
+ * @returns A deep clone of the given object.
  *
  * @example
  * // Clone a primitive value

package/dist/object/cloneDeepWith.js

@@ -14,9 +14,9 @@ const require_isBuffer = require("../predicate/isBuffer.js");
 * 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.
+* @param obj - The object to clone.
+* @param [cloneValue] - A function to customize the cloning process.
+* @returns A deep clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/cloneDeepWith.mjs

@@ -14,9 +14,9 @@ import { isBuffer } from "../predicate/isBuffer.mjs";
 * 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.
+* @param obj - The object to clone.
+* @param [cloneValue] - A function to customize the cloning process.
+* @returns A deep clone of the given object.
 *
 * @example
 * // Clone a primitive value

package/dist/object/findKey.d.mts

@@ -2,12 +2,12 @@
 /**
  * Finds the key of the first element in the object that satisfies the provided testing function.
  *
- * @param {T} obj - The object to search.
- * @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+ * @param obj - The object to search.
+ * @param predicate - The function to execute on each value in the object. It takes three arguments:
  *   - value: The current value being processed in the object.
  *   - key: The key of the current value being processed in the object.
  *   - obj: The object that findKey was called upon.
- * @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+ * @returns The key of the first element in the object that passes the test, or undefined if no element passes.
  *
  * @example
  * const users = {

package/dist/object/findKey.d.ts

@@ -2,12 +2,12 @@
 /**
  * Finds the key of the first element in the object that satisfies the provided testing function.
  *
- * @param {T} obj - The object to search.
- * @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+ * @param obj - The object to search.
+ * @param predicate - The function to execute on each value in the object. It takes three arguments:
  *   - value: The current value being processed in the object.
  *   - key: The key of the current value being processed in the object.
  *   - obj: The object that findKey was called upon.
- * @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+ * @returns The key of the first element in the object that passes the test, or undefined if no element passes.
  *
  * @example
  * const users = {

package/dist/object/findKey.js

@@ -2,12 +2,12 @@
 /**
 * Finds the key of the first element in the object that satisfies the provided testing function.
 *
-* @param {T} obj - The object to search.
-* @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+* @param obj - The object to search.
+* @param predicate - The function to execute on each value in the object. It takes three arguments:
 *   - value: The current value being processed in the object.
 *   - key: The key of the current value being processed in the object.
 *   - obj: The object that findKey was called upon.
-* @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+* @returns The key of the first element in the object that passes the test, or undefined if no element passes.
 *
 * @example
 * const users = {

package/dist/object/findKey.mjs

@@ -2,12 +2,12 @@
 /**
 * Finds the key of the first element in the object that satisfies the provided testing function.
 *
-* @param {T} obj - The object to search.
-* @param {(value: T[keyof T], key: keyof T, obj: T) => boolean} predicate - The function to execute on each value in the object. It takes three arguments:
+* @param obj - The object to search.
+* @param predicate - The function to execute on each value in the object. It takes three arguments:
 *   - value: The current value being processed in the object.
 *   - key: The key of the current value being processed in the object.
 *   - obj: The object that findKey was called upon.
-* @returns {keyof T | undefined} The key of the first element in the object that passes the test, or undefined if no element passes.
+* @returns The key of the first element in the object that passes the test, or undefined if no element passes.
 *
 * @example
 * const users = {

package/dist/object/flattenObject.d.mts

@@ -9,9 +9,9 @@ interface FlattenObjectOptions {
 /**
  * Flattens a nested object into a single level object with delimiter-separated keys.
  *
- * @param {object} object - The object to flatten.
- * @param {string} [options.delimiter='.'] - The delimiter to use between nested keys.
- * @returns {Record<string, any>} - The flattened object.
+ * @param object - The object to flatten.
+ * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+ * @returns The flattened object.
  *
  * @example
  * const nestedObject = {

package/dist/object/flattenObject.d.ts

@@ -9,9 +9,9 @@ interface FlattenObjectOptions {
 /**
  * Flattens a nested object into a single level object with delimiter-separated keys.
  *
- * @param {object} object - The object to flatten.
- * @param {string} [options.delimiter='.'] - The delimiter to use between nested keys.
- * @returns {Record<string, any>} - The flattened object.
+ * @param object - The object to flatten.
+ * @param [options.delimiter='.'] - The delimiter to use between nested keys.
+ * @returns The flattened object.
  *
  * @example
  * const nestedObject = {

package/dist/object/flattenObject.js

@@ -3,9 +3,9 @@ const require_isPlainObject = require("../predicate/isPlainObject.js");
 /**
 * Flattens a nested object into a single level object with delimiter-separated keys.
 *
-* @param {object} object - The object to flatten.
-* @param {string} [options.delimiter='.'] - The delimiter to use between nested keys.
-* @returns {Record<string, any>} - The flattened object.
+* @param object - The object to flatten.
+* @param [options.delimiter='.'] - The delimiter to use between nested keys.
+* @returns The flattened object.
 *
 * @example
 * const nestedObject = {

package/dist/object/flattenObject.mjs

@@ -3,9 +3,9 @@ import { isPlainObject } from "../predicate/isPlainObject.mjs";
 /**
 * Flattens a nested object into a single level object with delimiter-separated keys.
 *
-* @param {object} object - The object to flatten.
-* @param {string} [options.delimiter='.'] - The delimiter to use between nested keys.
-* @returns {Record<string, any>} - The flattened object.
+* @param object - The object to flatten.
+* @param [options.delimiter='.'] - The delimiter to use between nested keys.
+* @returns The flattened object.
 *
 * @example
 * const nestedObject = {

package/dist/object/invert.d.mts

@@ -8,8 +8,8 @@
  *
  * @template K - Type of the keys in the input object (string, number, symbol)
  * @template V - Type of the values in the input object (string, number, symbol)
- * @param {Record<K, V>} obj - The input object whose keys and values are to be inverted
- * @returns {Record<V, K>} - A new object with keys and values inverted
+ * @param obj - The input object whose keys and values are to be inverted
+ * @returns A new object with keys and values inverted
  *
  * @example
  * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }

package/dist/object/invert.d.ts

@@ -8,8 +8,8 @@
  *
  * @template K - Type of the keys in the input object (string, number, symbol)
  * @template V - Type of the values in the input object (string, number, symbol)
- * @param {Record<K, V>} obj - The input object whose keys and values are to be inverted
- * @returns {Record<V, K>} - A new object with keys and values inverted
+ * @param obj - The input object whose keys and values are to be inverted
+ * @returns A new object with keys and values inverted
  *
  * @example
  * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }

package/dist/object/invert.js

@@ -8,8 +8,8 @@
 *
 * @template K - Type of the keys in the input object (string, number, symbol)
 * @template V - Type of the values in the input object (string, number, symbol)
-* @param {Record<K, V>} obj - The input object whose keys and values are to be inverted
-* @returns {Record<V, K>} - A new object with keys and values inverted
+* @param obj - The input object whose keys and values are to be inverted
+* @returns A new object with keys and values inverted
 *
 * @example
 * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }

package/dist/object/invert.mjs

@@ -8,8 +8,8 @@
 *
 * @template K - Type of the keys in the input object (string, number, symbol)
 * @template V - Type of the values in the input object (string, number, symbol)
-* @param {Record<K, V>} obj - The input object whose keys and values are to be inverted
-* @returns {Record<V, K>} - A new object with keys and values inverted
+* @param obj - The input object whose keys and values are to be inverted
+* @returns A new object with keys and values inverted
 *
 * @example
 * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }

package/dist/object/mapKeys.d.mts

@@ -6,9 +6,9 @@
  * @template T - The type of the object.
  * @template K - The type of the new keys generated by the iteratee function.
  *
- * @param {T} object - The object to iterate over.
- * @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
- * @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
+ * @param object - The object to iterate over.
+ * @param getNewKey - The function invoked per own enumerable property.
+ * @returns Returns the new mapped object.
  *
  * @example
  * // Example usage:

package/dist/object/mapKeys.d.ts

@@ -6,9 +6,9 @@
  * @template T - The type of the object.
  * @template K - The type of the new keys generated by the iteratee function.
  *
- * @param {T} object - The object to iterate over.
- * @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
- * @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
+ * @param object - The object to iterate over.
+ * @param getNewKey - The function invoked per own enumerable property.
+ * @returns Returns the new mapped object.
  *
  * @example
  * // Example usage:

package/dist/object/mapKeys.js

@@ -6,9 +6,9 @@
 * @template T - The type of the object.
 * @template K - The type of the new keys generated by the iteratee function.
 *
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
-* @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
+* @param object - The object to iterate over.
+* @param getNewKey - The function invoked per own enumerable property.
+* @returns Returns the new mapped object.
 *
 * @example
 * // Example usage:

package/dist/object/mapKeys.mjs

@@ -6,9 +6,9 @@
 * @template T - The type of the object.
 * @template K - The type of the new keys generated by the iteratee function.
 *
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => K} getNewKey - The function invoked per own enumerable property.
-* @returns {Record<K, T[keyof T]>} - Returns the new mapped object.
+* @param object - The object to iterate over.
+* @param getNewKey - The function invoked per own enumerable property.
+* @returns Returns the new mapped object.
 *
 * @example
 * // Example usage:

package/dist/object/mapValues.d.mts

@@ -7,9 +7,9 @@
  * @template K - The type of the keys in the object.
  * @template V - The type of the new values generated by the iteratee function.
  *
- * @param {T} object - The object to iterate over.
- * @param {(value: T[K], key: K, object: T) => V} getNewValue - The function invoked per own enumerable property.
- * @returns {Record<K, V>} - Returns the new mapped object.
+ * @param object - The object to iterate over.
+ * @param getNewValue - The function invoked per own enumerable property.
+ * @returns Returns the new mapped object.
  *
  * @example
  * // Example usage:

package/dist/object/mapValues.d.ts

@@ -7,9 +7,9 @@
  * @template K - The type of the keys in the object.
  * @template V - The type of the new values generated by the iteratee function.
  *
- * @param {T} object - The object to iterate over.
- * @param {(value: T[K], key: K, object: T) => V} getNewValue - The function invoked per own enumerable property.
- * @returns {Record<K, V>} - Returns the new mapped object.
+ * @param object - The object to iterate over.
+ * @param getNewValue - The function invoked per own enumerable property.
+ * @returns Returns the new mapped object.
  *
  * @example
  * // Example usage:

package/dist/object/mapValues.js

@@ -7,9 +7,9 @@
 * @template K - The type of the keys in the object.
 * @template V - The type of the new values generated by the iteratee function.
 *
-* @param {T} object - The object to iterate over.
-* @param {(value: T[K], key: K, object: T) => V} getNewValue - The function invoked per own enumerable property.
-* @returns {Record<K, V>} - Returns the new mapped object.
+* @param object - The object to iterate over.
+* @param getNewValue - The function invoked per own enumerable property.
+* @returns Returns the new mapped object.
 *
 * @example
 * // Example usage:

package/dist/object/mapValues.mjs

@@ -7,9 +7,9 @@
 * @template K - The type of the keys in the object.
 * @template V - The type of the new values generated by the iteratee function.
 *
-* @param {T} object - The object to iterate over.
-* @param {(value: T[K], key: K, object: T) => V} getNewValue - The function invoked per own enumerable property.
-* @returns {Record<K, V>} - Returns the new mapped object.
+* @param object - The object to iterate over.
+* @param getNewValue - The function invoked per own enumerable property.
+* @returns Returns the new mapped object.
 *
 * @example
 * // Example usage:

package/dist/object/merge.d.mts

@@ -8,9 +8,9 @@
  *
  * 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.
+ * @param target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param source - The source object whose properties will be merged into the target object.
+ * @returns 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.

package/dist/object/merge.d.ts

@@ -8,9 +8,9 @@
  *
  * 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.
+ * @param target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param source - The source object whose properties will be merged into the target object.
+ * @returns 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.

package/dist/object/merge.js

@@ -10,9 +10,9 @@ const require_isUnsafeProperty = require("../_internal/isUnsafeProperty.js");
 *
 * 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.
+* @param target - The target object into which the source object properties will be merged. This object is modified in place.
+* @param source - The source object whose properties will be merged into the target object.
+* @returns 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.

package/dist/object/merge.mjs

@@ -10,9 +10,9 @@ import { isUnsafeProperty } from "../_internal/isUnsafeProperty.mjs";
 *
 * 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.
+* @param target - The target object into which the source object properties will be merged. This object is modified in place.
+* @param source - The source object whose properties will be merged into the target object.
+* @returns 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.

package/dist/object/mergeWith.d.mts

@@ -11,16 +11,16 @@
  *
  * 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:
+ * @param target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param source - The source object whose properties will be merged into the target object.
+ * @param 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.
+ * @returns 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.

package/dist/object/mergeWith.d.ts

@@ -11,16 +11,16 @@
  *
  * 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:
+ * @param target - The target object into which the source object properties will be merged. This object is modified in place.
+ * @param source - The source object whose properties will be merged into the target object.
+ * @param 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.
+ * @returns 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.

package/dist/object/mergeWith.js

@@ -13,16 +13,16 @@ const require_isUnsafeProperty = require("../_internal/isUnsafeProperty.js");
 *
 * 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:
+* @param target - The target object into which the source object properties will be merged. This object is modified in place.
+* @param source - The source object whose properties will be merged into the target object.
+* @param 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.
+* @returns 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.