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

package/dist/array/at.d.mts

@@ -5,9 +5,9 @@
  * This function supports negative indices, which count from the end of the array.
  *
  * @template T
- * @param {readonly T[]} arr - The array to retrieve elements from.
- * @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
- * @returns {T[]} A new array containing the elements at the specified indices.
+ * @param arr - The array to retrieve elements from.
+ * @param indices - An array of indices specifying the positions of elements to retrieve.
+ * @returns A new array containing the elements at the specified indices.
  *
  * @example
  * const numbers = [10, 20, 30, 40, 50];

package/dist/array/at.d.ts

@@ -5,9 +5,9 @@
  * This function supports negative indices, which count from the end of the array.
  *
  * @template T
- * @param {readonly T[]} arr - The array to retrieve elements from.
- * @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
- * @returns {T[]} A new array containing the elements at the specified indices.
+ * @param arr - The array to retrieve elements from.
+ * @param indices - An array of indices specifying the positions of elements to retrieve.
+ * @returns A new array containing the elements at the specified indices.
  *
  * @example
  * const numbers = [10, 20, 30, 40, 50];

package/dist/array/at.js

@@ -5,9 +5,9 @@
 * This function supports negative indices, which count from the end of the array.
 *
 * @template T
-* @param {readonly T[]} arr - The array to retrieve elements from.
-* @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
-* @returns {T[]} A new array containing the elements at the specified indices.
+* @param arr - The array to retrieve elements from.
+* @param indices - An array of indices specifying the positions of elements to retrieve.
+* @returns A new array containing the elements at the specified indices.
 *
 * @example
 * const numbers = [10, 20, 30, 40, 50];

package/dist/array/at.mjs

@@ -5,9 +5,9 @@
 * This function supports negative indices, which count from the end of the array.
 *
 * @template T
-* @param {readonly T[]} arr - The array to retrieve elements from.
-* @param {number[]} indices - An array of indices specifying the positions of elements to retrieve.
-* @returns {T[]} A new array containing the elements at the specified indices.
+* @param arr - The array to retrieve elements from.
+* @param indices - An array of indices specifying the positions of elements to retrieve.
+* @returns A new array containing the elements at the specified indices.
 *
 * @example
 * const numbers = [10, 20, 30, 40, 50];

package/dist/array/cartesianProduct.d.mts

@@ -3,17 +3,17 @@
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T
- * @param {readonly T[]} arr1 - The array to take the product of.
- * @returns {Array<[T]>} An array of single-element tuples.
+ * @param arr1 - The array to take the product of.
+ * @returns An array of single-element tuples.
  */
 declare function cartesianProduct<T>(arr1: readonly T[]): Array<[T]>;
 /**
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @returns {Array<[T, U]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  *
  * @example
  * cartesianProduct([1, 2], ['a', 'b']);
@@ -24,21 +24,21 @@ declare function cartesianProduct<T, U>(arr1: readonly T[], arr2: readonly U[]):
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U, V
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @param {readonly V[]} arr3 - The third array to take the product of.
- * @returns {Array<[T, U, V]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @param arr3 - The third array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  */
 declare function cartesianProduct<T, U, V>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[]): Array<[T, U, V]>;
 /**
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U, V, W
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @param {readonly V[]} arr3 - The third array to take the product of.
- * @param {readonly W[]} arr4 - The fourth array to take the product of.
- * @returns {Array<[T, U, V, W]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @param arr3 - The third array to take the product of.
+ * @param arr4 - The fourth array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  */
 declare function cartesianProduct<T, U, V, W>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): Array<[T, U, V, W]>;
 /**
@@ -51,8 +51,8 @@ declare function cartesianProduct<T, U, V, W>(arr1: readonly T[], arr2: readonly
  * If any input array is empty, the result is `[]`.
  *
  * @template T
- * @param {Array<readonly T[]>} arrs - The arrays to take the product of.
- * @returns {T[][]} An array of tuples representing the Cartesian product.
+ * @param arrs - The arrays to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  *
  * @example
  * cartesianProduct([1, 2], ['a', 'b']);

package/dist/array/cartesianProduct.d.ts

@@ -3,17 +3,17 @@
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T
- * @param {readonly T[]} arr1 - The array to take the product of.
- * @returns {Array<[T]>} An array of single-element tuples.
+ * @param arr1 - The array to take the product of.
+ * @returns An array of single-element tuples.
  */
 declare function cartesianProduct<T>(arr1: readonly T[]): Array<[T]>;
 /**
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @returns {Array<[T, U]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  *
  * @example
  * cartesianProduct([1, 2], ['a', 'b']);
@@ -24,21 +24,21 @@ declare function cartesianProduct<T, U>(arr1: readonly T[], arr2: readonly U[]):
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U, V
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @param {readonly V[]} arr3 - The third array to take the product of.
- * @returns {Array<[T, U, V]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @param arr3 - The third array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  */
 declare function cartesianProduct<T, U, V>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[]): Array<[T, U, V]>;
 /**
  * Computes the [Cartesian product](https://en.wikipedia.org/wiki/Cartesian_product) of the input arrays.
  *
  * @template T, U, V, W
- * @param {readonly T[]} arr1 - The first array to take the product of.
- * @param {readonly U[]} arr2 - The second array to take the product of.
- * @param {readonly V[]} arr3 - The third array to take the product of.
- * @param {readonly W[]} arr4 - The fourth array to take the product of.
- * @returns {Array<[T, U, V, W]>} An array of tuples representing the Cartesian product.
+ * @param arr1 - The first array to take the product of.
+ * @param arr2 - The second array to take the product of.
+ * @param arr3 - The third array to take the product of.
+ * @param arr4 - The fourth array to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  */
 declare function cartesianProduct<T, U, V, W>(arr1: readonly T[], arr2: readonly U[], arr3: readonly V[], arr4: readonly W[]): Array<[T, U, V, W]>;
 /**
@@ -51,8 +51,8 @@ declare function cartesianProduct<T, U, V, W>(arr1: readonly T[], arr2: readonly
  * If any input array is empty, the result is `[]`.
  *
  * @template T
- * @param {Array<readonly T[]>} arrs - The arrays to take the product of.
- * @returns {T[][]} An array of tuples representing the Cartesian product.
+ * @param arrs - The arrays to take the product of.
+ * @returns An array of tuples representing the Cartesian product.
  *
  * @example
  * cartesianProduct([1, 2], ['a', 'b']);

package/dist/array/chunk.d.mts

@@ -7,9 +7,9 @@
  * the final sub-array will contain the remaining elements.
  *
  * @template T The type of elements in the array.
- * @param {T[]} arr - The array to be chunked into smaller arrays.
- * @param {number} size - The size of each smaller array. Must be a positive integer.
- * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.
+ * @param arr - The array to be chunked into smaller arrays.
+ * @param size - The size of each smaller array. Must be a positive integer.
+ * @returns A two-dimensional array where each sub-array has a maximum length of `size`.
  * @throws {Error} Throws an error if `size` is not a positive integer.
  *
  * @example

package/dist/array/chunk.d.ts

@@ -7,9 +7,9 @@
  * the final sub-array will contain the remaining elements.
  *
  * @template T The type of elements in the array.
- * @param {T[]} arr - The array to be chunked into smaller arrays.
- * @param {number} size - The size of each smaller array. Must be a positive integer.
- * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.
+ * @param arr - The array to be chunked into smaller arrays.
+ * @param size - The size of each smaller array. Must be a positive integer.
+ * @returns A two-dimensional array where each sub-array has a maximum length of `size`.
  * @throws {Error} Throws an error if `size` is not a positive integer.
  *
  * @example

package/dist/array/chunk.js

@@ -7,9 +7,9 @@
 * the final sub-array will contain the remaining elements.
 *
 * @template T The type of elements in the array.
-* @param {T[]} arr - The array to be chunked into smaller arrays.
-* @param {number} size - The size of each smaller array. Must be a positive integer.
-* @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.
+* @param arr - The array to be chunked into smaller arrays.
+* @param size - The size of each smaller array. Must be a positive integer.
+* @returns A two-dimensional array where each sub-array has a maximum length of `size`.
 * @throws {Error} Throws an error if `size` is not a positive integer.
 *
 * @example

package/dist/array/chunk.mjs

@@ -7,9 +7,9 @@
 * the final sub-array will contain the remaining elements.
 *
 * @template T The type of elements in the array.
-* @param {T[]} arr - The array to be chunked into smaller arrays.
-* @param {number} size - The size of each smaller array. Must be a positive integer.
-* @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.
+* @param arr - The array to be chunked into smaller arrays.
+* @param size - The size of each smaller array. Must be a positive integer.
+* @returns A two-dimensional array where each sub-array has a maximum length of `size`.
 * @throws {Error} Throws an error if `size` is not a positive integer.
 *
 * @example

package/dist/array/combinations.d.mts

@@ -9,9 +9,9 @@
  * The number of combinations is `n! / r! / (n - r)!` when `0 <= r <= n`, and zero when `r > n`.
  *
  * @template T
- * @param {readonly T[]} arr - The input array.
- * @param {number} r - The length of each combination. Must be a non-negative integer.
- * @returns {T[][]} An array of `r`-length combinations.
+ * @param arr - The input array.
+ * @param r - The length of each combination. Must be a non-negative integer.
+ * @returns An array of `r`-length combinations.
  * @throws {Error} If `r` is not a non-negative integer.
  *
  * @example

package/dist/array/combinations.d.ts

@@ -9,9 +9,9 @@
  * The number of combinations is `n! / r! / (n - r)!` when `0 <= r <= n`, and zero when `r > n`.
  *
  * @template T
- * @param {readonly T[]} arr - The input array.
- * @param {number} r - The length of each combination. Must be a non-negative integer.
- * @returns {T[][]} An array of `r`-length combinations.
+ * @param arr - The input array.
+ * @param r - The length of each combination. Must be a non-negative integer.
+ * @returns An array of `r`-length combinations.
  * @throws {Error} If `r` is not a non-negative integer.
  *
  * @example

package/dist/array/combinations.js

@@ -9,9 +9,9 @@
 * The number of combinations is `n! / r! / (n - r)!` when `0 <= r <= n`, and zero when `r > n`.
 *
 * @template T
-* @param {readonly T[]} arr - The input array.
-* @param {number} r - The length of each combination. Must be a non-negative integer.
-* @returns {T[][]} An array of `r`-length combinations.
+* @param arr - The input array.
+* @param r - The length of each combination. Must be a non-negative integer.
+* @returns An array of `r`-length combinations.
 * @throws {Error} If `r` is not a non-negative integer.
 *
 * @example

package/dist/array/combinations.mjs

@@ -9,9 +9,9 @@
 * The number of combinations is `n! / r! / (n - r)!` when `0 <= r <= n`, and zero when `r > n`.
 *
 * @template T
-* @param {readonly T[]} arr - The input array.
-* @param {number} r - The length of each combination. Must be a non-negative integer.
-* @returns {T[][]} An array of `r`-length combinations.
+* @param arr - The input array.
+* @param r - The length of each combination. Must be a non-negative integer.
+* @returns An array of `r`-length combinations.
 * @throws {Error} If `r` is not a non-negative integer.
 *
 * @example

package/dist/array/compact.d.mts

@@ -4,8 +4,8 @@ type NotFalsey<T> = Exclude<T, false | null | 0 | 0n | '' | undefined>;
  * Removes falsey values (false, null, 0, -0, 0n, '', undefined, NaN) from an array.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The input array to remove falsey values.
- * @returns {Array<Exclude<T, false | null | 0 | 0n | '' | undefined>>} - A new array with all falsey values removed.
+ * @param arr - The input array to remove falsey values.
+ * @returns A new array with all falsey values removed.
  *
  * @example
  * compact([0, -0, 0n, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);

package/dist/array/compact.d.ts

@@ -4,8 +4,8 @@ type NotFalsey<T> = Exclude<T, false | null | 0 | 0n | '' | undefined>;
  * Removes falsey values (false, null, 0, -0, 0n, '', undefined, NaN) from an array.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The input array to remove falsey values.
- * @returns {Array<Exclude<T, false | null | 0 | 0n | '' | undefined>>} - A new array with all falsey values removed.
+ * @param arr - The input array to remove falsey values.
+ * @returns A new array with all falsey values removed.
  *
  * @example
  * compact([0, -0, 0n, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);

package/dist/array/compact.js

@@ -3,8 +3,8 @@
 * Removes falsey values (false, null, 0, -0, 0n, '', undefined, NaN) from an array.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The input array to remove falsey values.
-* @returns {Array<Exclude<T, false | null | 0 | 0n | '' | undefined>>} - A new array with all falsey values removed.
+* @param arr - The input array to remove falsey values.
+* @returns A new array with all falsey values removed.
 *
 * @example
 * compact([0, -0, 0n, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);

package/dist/array/compact.mjs

@@ -3,8 +3,8 @@
 * Removes falsey values (false, null, 0, -0, 0n, '', undefined, NaN) from an array.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The input array to remove falsey values.
-* @returns {Array<Exclude<T, false | null | 0 | 0n | '' | undefined>>} - A new array with all falsey values removed.
+* @param arr - The input array to remove falsey values.
+* @returns A new array with all falsey values removed.
 *
 * @example
 * compact([0, -0, 0n, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);

package/dist/array/countBy.d.mts

@@ -11,9 +11,9 @@
  *
  * @template T - The type of the items in the input array.
  * @template K - The type of keys.
- * @param {T[]} arr - The input array to count occurrences.
- * @param {(item: T, index: number, array: readonly T[]) => K} mapper - The transformation function that maps each item, its index, and the array to a key.
- * @returns {Record<K, number>} An object containing the transformed items as keys and the
+ * @param arr - The input array to count occurrences.
+ * @param mapper - The transformation function that maps each item, its index, and the array to a key.
+ * @returns An object containing the transformed items as keys and the
  * counts as values.
  *
  * @example

package/dist/array/countBy.d.ts

@@ -11,9 +11,9 @@
  *
  * @template T - The type of the items in the input array.
  * @template K - The type of keys.
- * @param {T[]} arr - The input array to count occurrences.
- * @param {(item: T, index: number, array: readonly T[]) => K} mapper - The transformation function that maps each item, its index, and the array to a key.
- * @returns {Record<K, number>} An object containing the transformed items as keys and the
+ * @param arr - The input array to count occurrences.
+ * @param mapper - The transformation function that maps each item, its index, and the array to a key.
+ * @returns An object containing the transformed items as keys and the
  * counts as values.
  *
  * @example

package/dist/array/countBy.js

@@ -11,9 +11,9 @@
 *
 * @template T - The type of the items in the input array.
 * @template K - The type of keys.
-* @param {T[]} arr - The input array to count occurrences.
-* @param {(item: T, index: number, array: readonly T[]) => K} mapper - The transformation function that maps each item, its index, and the array to a key.
-* @returns {Record<K, number>} An object containing the transformed items as keys and the
+* @param arr - The input array to count occurrences.
+* @param mapper - The transformation function that maps each item, its index, and the array to a key.
+* @returns An object containing the transformed items as keys and the
 * counts as values.
 *
 * @example

package/dist/array/countBy.mjs

@@ -11,9 +11,9 @@
 *
 * @template T - The type of the items in the input array.
 * @template K - The type of keys.
-* @param {T[]} arr - The input array to count occurrences.
-* @param {(item: T, index: number, array: readonly T[]) => K} mapper - The transformation function that maps each item, its index, and the array to a key.
-* @returns {Record<K, number>} An object containing the transformed items as keys and the
+* @param arr - The input array to count occurrences.
+* @param mapper - The transformation function that maps each item, its index, and the array to a key.
+* @returns An object containing the transformed items as keys and the
 * counts as values.
 *
 * @example

package/dist/array/difference.d.mts

@@ -7,12 +7,12 @@
  * filters out any elements from the first array that also appear in the second array.
  *
  * @template T
- * @param {T[]} firstArr - The array from which to derive the difference. This is the primary array
+ * @param firstArr - The array from which to derive the difference. This is the primary array
  * from which elements will be compared and filtered.
- * @param {T[]} secondArr - The array containing elements to be excluded from the first array.
+ * @param secondArr - The array containing elements to be excluded from the first array.
  * Each element in this array will be checked against the first array, and if a match is found,
  * that element will be excluded from the result.
- * @returns {T[]} A new array containing the elements that are present in the first array but not
+ * @returns A new array containing the elements that are present in the first array but not
  * in the second array.
  *
  * @example

package/dist/array/difference.d.ts

@@ -7,12 +7,12 @@
  * filters out any elements from the first array that also appear in the second array.
  *
  * @template T
- * @param {T[]} firstArr - The array from which to derive the difference. This is the primary array
+ * @param firstArr - The array from which to derive the difference. This is the primary array
  * from which elements will be compared and filtered.
- * @param {T[]} secondArr - The array containing elements to be excluded from the first array.
+ * @param secondArr - The array containing elements to be excluded from the first array.
  * Each element in this array will be checked against the first array, and if a match is found,
  * that element will be excluded from the result.
- * @returns {T[]} A new array containing the elements that are present in the first array but not
+ * @returns A new array containing the elements that are present in the first array but not
  * in the second array.
  *
  * @example

package/dist/array/difference.js

@@ -7,12 +7,12 @@
 * filters out any elements from the first array that also appear in the second array.
 *
 * @template T
-* @param {T[]} firstArr - The array from which to derive the difference. This is the primary array
+* @param firstArr - The array from which to derive the difference. This is the primary array
 * from which elements will be compared and filtered.
-* @param {T[]} secondArr - The array containing elements to be excluded from the first array.
+* @param secondArr - The array containing elements to be excluded from the first array.
 * Each element in this array will be checked against the first array, and if a match is found,
 * that element will be excluded from the result.
-* @returns {T[]} A new array containing the elements that are present in the first array but not
+* @returns A new array containing the elements that are present in the first array but not
 * in the second array.
 *
 * @example

package/dist/array/difference.mjs

@@ -7,12 +7,12 @@
 * filters out any elements from the first array that also appear in the second array.
 *
 * @template T
-* @param {T[]} firstArr - The array from which to derive the difference. This is the primary array
+* @param firstArr - The array from which to derive the difference. This is the primary array
 * from which elements will be compared and filtered.
-* @param {T[]} secondArr - The array containing elements to be excluded from the first array.
+* @param secondArr - The array containing elements to be excluded from the first array.
 * Each element in this array will be checked against the first array, and if a match is found,
 * that element will be excluded from the result.
-* @returns {T[]} A new array containing the elements that are present in the first array but not
+* @returns A new array containing the elements that are present in the first array but not
 * in the second array.
 *
 * @example

package/dist/array/differenceBy.d.mts

@@ -10,11 +10,11 @@
  * mapped, match an element in the mapped version of the second array.
  *
  * @template T, U
- * @param {T[]} firstArr - The primary array from which to derive the difference.
- * @param {U[]} secondArr - The array containing elements to be excluded from the first array.
- * @param {(value: T | U) => unknown} mapper - The function to map the elements of both arrays. This function
+ * @param firstArr - The primary array from which to derive the difference.
+ * @param secondArr - The array containing elements to be excluded from the first array.
+ * @param mapper - The function to map the elements of both arrays. This function
  * is applied to each element in both arrays, and the comparison is made based on the mapped values.
- * @returns {T[]} A new array containing the elements from the first array that do not have a corresponding
+ * @returns A new array containing the elements from the first array that do not have a corresponding
  * mapped identity in the second array.
  *
  * @example

package/dist/array/differenceBy.d.ts

@@ -10,11 +10,11 @@
  * mapped, match an element in the mapped version of the second array.
  *
  * @template T, U
- * @param {T[]} firstArr - The primary array from which to derive the difference.
- * @param {U[]} secondArr - The array containing elements to be excluded from the first array.
- * @param {(value: T | U) => unknown} mapper - The function to map the elements of both arrays. This function
+ * @param firstArr - The primary array from which to derive the difference.
+ * @param secondArr - The array containing elements to be excluded from the first array.
+ * @param mapper - The function to map the elements of both arrays. This function
  * is applied to each element in both arrays, and the comparison is made based on the mapped values.
- * @returns {T[]} A new array containing the elements from the first array that do not have a corresponding
+ * @returns A new array containing the elements from the first array that do not have a corresponding
  * mapped identity in the second array.
  *
  * @example

package/dist/array/differenceBy.js

@@ -10,11 +10,11 @@
 * mapped, match an element in the mapped version of the second array.
 *
 * @template T, U
-* @param {T[]} firstArr - The primary array from which to derive the difference.
-* @param {U[]} secondArr - The array containing elements to be excluded from the first array.
-* @param {(value: T | U) => unknown} mapper - The function to map the elements of both arrays. This function
+* @param firstArr - The primary array from which to derive the difference.
+* @param secondArr - The array containing elements to be excluded from the first array.
+* @param mapper - The function to map the elements of both arrays. This function
 * is applied to each element in both arrays, and the comparison is made based on the mapped values.
-* @returns {T[]} A new array containing the elements from the first array that do not have a corresponding
+* @returns A new array containing the elements from the first array that do not have a corresponding
 * mapped identity in the second array.
 *
 * @example

package/dist/array/differenceBy.mjs

@@ -10,11 +10,11 @@
 * mapped, match an element in the mapped version of the second array.
 *
 * @template T, U
-* @param {T[]} firstArr - The primary array from which to derive the difference.
-* @param {U[]} secondArr - The array containing elements to be excluded from the first array.
-* @param {(value: T | U) => unknown} mapper - The function to map the elements of both arrays. This function
+* @param firstArr - The primary array from which to derive the difference.
+* @param secondArr - The array containing elements to be excluded from the first array.
+* @param mapper - The function to map the elements of both arrays. This function
 * is applied to each element in both arrays, and the comparison is made based on the mapped values.
-* @returns {T[]} A new array containing the elements from the first array that do not have a corresponding
+* @returns A new array containing the elements from the first array that do not have a corresponding
 * mapped identity in the second array.
 *
 * @example

package/dist/array/differenceWith.d.mts

@@ -7,10 +7,10 @@
  * if elements are equal is made using the provided custom function.
  *
  * @template T, U
- * @param {T[]} firstArr - The array from which to get the difference.
- * @param {U[]} secondArr - The array containing elements to exclude from the first array.
- * @param {(x: T, y: U) => boolean} areItemsEqual - A function to determine if two items are equal.
- * @returns {T[]} A new array containing the elements from the first array that do not match any elements in the second array
+ * @param firstArr - The array from which to get the difference.
+ * @param secondArr - The array containing elements to exclude from the first array.
+ * @param areItemsEqual - A function to determine if two items are equal.
+ * @returns A new array containing the elements from the first array that do not match any elements in the second array
  * according to the custom equality function.
  *
  * @example

package/dist/array/differenceWith.d.ts

@@ -7,10 +7,10 @@
  * if elements are equal is made using the provided custom function.
  *
  * @template T, U
- * @param {T[]} firstArr - The array from which to get the difference.
- * @param {U[]} secondArr - The array containing elements to exclude from the first array.
- * @param {(x: T, y: U) => boolean} areItemsEqual - A function to determine if two items are equal.
- * @returns {T[]} A new array containing the elements from the first array that do not match any elements in the second array
+ * @param firstArr - The array from which to get the difference.
+ * @param secondArr - The array containing elements to exclude from the first array.
+ * @param areItemsEqual - A function to determine if two items are equal.
+ * @returns A new array containing the elements from the first array that do not match any elements in the second array
  * according to the custom equality function.
  *
  * @example

package/dist/array/differenceWith.js

@@ -7,10 +7,10 @@
 * if elements are equal is made using the provided custom function.
 *
 * @template T, U
-* @param {T[]} firstArr - The array from which to get the difference.
-* @param {U[]} secondArr - The array containing elements to exclude from the first array.
-* @param {(x: T, y: U) => boolean} areItemsEqual - A function to determine if two items are equal.
-* @returns {T[]} A new array containing the elements from the first array that do not match any elements in the second array
+* @param firstArr - The array from which to get the difference.
+* @param secondArr - The array containing elements to exclude from the first array.
+* @param areItemsEqual - A function to determine if two items are equal.
+* @returns A new array containing the elements from the first array that do not match any elements in the second array
 * according to the custom equality function.
 *
 * @example

package/dist/array/differenceWith.mjs

@@ -7,10 +7,10 @@
 * if elements are equal is made using the provided custom function.
 *
 * @template T, U
-* @param {T[]} firstArr - The array from which to get the difference.
-* @param {U[]} secondArr - The array containing elements to exclude from the first array.
-* @param {(x: T, y: U) => boolean} areItemsEqual - A function to determine if two items are equal.
-* @returns {T[]} A new array containing the elements from the first array that do not match any elements in the second array
+* @param firstArr - The array from which to get the difference.
+* @param secondArr - The array containing elements to exclude from the first array.
+* @param areItemsEqual - A function to determine if two items are equal.
+* @returns A new array containing the elements from the first array that do not match any elements in the second array
 * according to the custom equality function.
 *
 * @example

package/dist/array/drop.d.mts

@@ -6,9 +6,9 @@
  * of elements removed from the start.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array from which to drop elements.
- * @param {number} itemsCount - The number of elements to drop from the beginning of the array.
- * @returns {T[]} A new array with the specified number of elements removed from the start.
+ * @param arr - The array from which to drop elements.
+ * @param itemsCount - The number of elements to drop from the beginning of the array.
+ * @returns A new array with the specified number of elements removed from the start.
  *
  * @example
  * const array = [1, 2, 3, 4, 5];