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

package/dist/compat/array/without.mjs

@@ -7,9 +7,9 @@ import { isArrayLikeObject } from "../predicate/isArrayLikeObject.mjs";
 * It correctly excludes `NaN`, as it compares values using [SameValueZero](https://tc39.es/ecma262/multipage/abstract-operations.html#sec-samevaluezero).
 *
 * @template T The type of elements in the array.
-* @param {ArrayLike<T> | null | undefined} array - The array to filter.
-* @param {...T[]} values - The values to exclude.
-* @returns {T[]} A new array without the specified values.
+* @param array - The array to filter.
+* @param values - The values to exclude.
+* @returns A new array without the specified values.
 *
 * @example
 * // Removes the specified values from the array

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

@@ -4,8 +4,8 @@
  * that exist in only one of the arrays.
  *
  * @template T - The type of elements in the arrays.
- * @param {...(ArrayLike<T> | null | undefined)} arrays - The arrays to compare.
- * @returns {T[]} An array containing the elements that are present in only one of the provided `arrays`.
+ * @param arrays - The arrays to compare.
+ * @returns An array containing the elements that are present in only one of the provided `arrays`.
  *
  * @example
  * // Returns [1, 2, 5, 6]

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

@@ -4,8 +4,8 @@
  * that exist in only one of the arrays.
  *
  * @template T - The type of elements in the arrays.
- * @param {...(ArrayLike<T> | null | undefined)} arrays - The arrays to compare.
- * @returns {T[]} An array containing the elements that are present in only one of the provided `arrays`.
+ * @param arrays - The arrays to compare.
+ * @returns An array containing the elements that are present in only one of the provided `arrays`.
  *
  * @example
  * // Returns [1, 2, 5, 6]

package/dist/compat/array/xor.js

@@ -6,8 +6,8 @@ const require_toArray = require("../util/toArray.js");
 * that exist in only one of the arrays.
 *
 * @template T - The type of elements in the arrays.
-* @param {...(ArrayLike<T> | null | undefined)} arrays - The arrays to compare.
-* @returns {T[]} An array containing the elements that are present in only one of the provided `arrays`.
+* @param arrays - The arrays to compare.
+* @returns An array containing the elements that are present in only one of the provided `arrays`.
 *
 * @example
 * // Returns [1, 2, 5, 6]

package/dist/compat/array/xor.mjs

@@ -6,8 +6,8 @@ import { toArray } from "../util/toArray.mjs";
 * that exist in only one of the arrays.
 *
 * @template T - The type of elements in the arrays.
-* @param {...(ArrayLike<T> | null | undefined)} arrays - The arrays to compare.
-* @returns {T[]} An array containing the elements that are present in only one of the provided `arrays`.
+* @param arrays - The arrays to compare.
+* @returns An array containing the elements that are present in only one of the provided `arrays`.
 *
 * @example
 * // Returns [1, 2, 5, 6]

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

@@ -7,9 +7,9 @@ import { ValueIteratee } from "../_internal/ValueIteratee.mjs";
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The arrays to inspect.
- * @param {ValueIteratee<T>} [iteratee] - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The arrays to inspect.
+ * @param [iteratee] - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([2.1, 1.2], [4.3, 2.4], Math.floor);
@@ -26,10 +26,10 @@ declare function xorBy<T>(arrays: ArrayLike<T> | null | undefined, iteratee?: Va
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ValueIteratee<T>} [iteratee] - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param [iteratee] - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([2.1, 1.2], [4.3, 2.4], Math.floor);
@@ -42,11 +42,11 @@ declare function xorBy<T>(arrays: ArrayLike<T> | null | undefined, arrays2: Arra
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays3 - The third array to inspect.
- * @param {...Array<ValueIteratee<T> | ArrayLike<T> | null | undefined>} iteratee - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param arrays3 - The third array to inspect.
+ * @param iteratee - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([1.2, 2.3], [3.4, 4.5], [5.6, 6.7], Math.floor);

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

@@ -7,9 +7,9 @@ import { ValueIteratee } from "../_internal/ValueIteratee.js";
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The arrays to inspect.
- * @param {ValueIteratee<T>} [iteratee] - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The arrays to inspect.
+ * @param [iteratee] - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([2.1, 1.2], [4.3, 2.4], Math.floor);
@@ -26,10 +26,10 @@ declare function xorBy<T>(arrays: ArrayLike<T> | null | undefined, iteratee?: Va
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ValueIteratee<T>} [iteratee] - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param [iteratee] - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([2.1, 1.2], [4.3, 2.4], Math.floor);
@@ -42,11 +42,11 @@ declare function xorBy<T>(arrays: ArrayLike<T> | null | undefined, arrays2: Arra
  * uniqueness is computed. The iteratee is invoked with one argument: (value).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays3 - The third array to inspect.
- * @param {...Array<ValueIteratee<T> | ArrayLike<T> | null | undefined>} iteratee - The iteratee invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param arrays3 - The third array to inspect.
+ * @param iteratee - The iteratee invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorBy([1.2, 2.3], [3.4, 4.5], [5.6, 6.7], Math.floor);

package/dist/compat/array/xorBy.js

@@ -15,8 +15,8 @@ const require_unionBy = require("./unionBy.js");
 * @template T - Type of elements in the input arrays.
 * @template U - Type of the values returned by the mapping function.
 *
-* @param {...(ArrayLike<T> | null | undefined | PropertyKey | Partial<T> | ((value: T) => unknown))} values - The arrays to inspect, or the function to map array elements to comparison values.
-* @returns {T[]} An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the values returned by the mapping function.
+* @param values - The arrays to inspect, or the function to map array elements to comparison values.
+* @returns An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the values returned by the mapping function.
 *
 * @example
 * // Custom mapping function for objects with an 'id' property

package/dist/compat/array/xorBy.mjs

@@ -15,8 +15,8 @@ import { unionBy } from "./unionBy.mjs";
 * @template T - Type of elements in the input arrays.
 * @template U - Type of the values returned by the mapping function.
 *
-* @param {...(ArrayLike<T> | null | undefined | PropertyKey | Partial<T> | ((value: T) => unknown))} values - The arrays to inspect, or the function to map array elements to comparison values.
-* @returns {T[]} An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the values returned by the mapping function.
+* @param values - The arrays to inspect, or the function to map array elements to comparison values.
+* @returns An array containing the elements that are present in either `arr1` or `arr2` but not in both, based on the values returned by the mapping function.
 *
 * @example
 * // Custom mapping function for objects with an 'id' property

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

@@ -5,9 +5,9 @@
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The arrays to inspect.
- * @param {(a: T, b: T) => boolean} [comparator] - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The arrays to inspect.
+ * @param [comparator] - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * const objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
@@ -22,10 +22,10 @@ declare function xorWith<T>(arrays: ArrayLike<T> | null | undefined, comparator?
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {(a: T, b: T) => boolean} [comparator] - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param [comparator] - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorWith([1, 2], [2, 3], (a, b) => a === b);
@@ -38,11 +38,11 @@ declare function xorWith<T>(arrays: ArrayLike<T> | null | undefined, arrays2: Ar
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays3 - The third array to inspect.
- * @param {...Array<(a: T, b: T) => boolean | ArrayLike<T> | null | undefined>} comparator - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param arrays3 - The third array to inspect.
+ * @param comparator - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorWith([1], [2], [3], (a, b) => a === b);

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

@@ -5,9 +5,9 @@
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The arrays to inspect.
- * @param {(a: T, b: T) => boolean} [comparator] - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The arrays to inspect.
+ * @param [comparator] - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * const objects = [{ 'x': 1, 'y': 2 }, { 'x': 2, 'y': 1 }];
@@ -22,10 +22,10 @@ declare function xorWith<T>(arrays: ArrayLike<T> | null | undefined, comparator?
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {(a: T, b: T) => boolean} [comparator] - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param [comparator] - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorWith([1, 2], [2, 3], (a, b) => a === b);
@@ -38,11 +38,11 @@ declare function xorWith<T>(arrays: ArrayLike<T> | null | undefined, arrays2: Ar
  * with two arguments: (arrVal, othVal).
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arrays - The first array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays2 - The second array to inspect.
- * @param {ArrayLike<T> | null | undefined} arrays3 - The third array to inspect.
- * @param {...Array<(a: T, b: T) => boolean | ArrayLike<T> | null | undefined>} comparator - The comparator invoked per element.
- * @returns {T[]} Returns the new array of values.
+ * @param arrays - The first array to inspect.
+ * @param arrays2 - The second array to inspect.
+ * @param arrays3 - The third array to inspect.
+ * @param comparator - The comparator invoked per element.
+ * @returns Returns the new array of values.
  *
  * @example
  * xorWith([1], [2], [3], (a, b) => a === b);

package/dist/compat/array/xorWith.js

@@ -13,8 +13,8 @@ const require_unionWith = require("./unionWith.js");
 *
 * @template T - Type of elements in the input arrays.
 *
-* @param {...(ArrayLike<T> | null | undefined | ((a: T, b: T) => boolean))} values - The arrays to inspect, or the comparator function.
-* @returns {T[]} An array containing the elements that are present in exactly one of the arrays
+* @param values - The arrays to inspect, or the comparator function.
+* @returns An array containing the elements that are present in exactly one of the arrays
 *  as determined by the comparator.
 *
 * @example

package/dist/compat/array/xorWith.mjs

@@ -13,8 +13,8 @@ import { unionWith } from "./unionWith.mjs";
 *
 * @template T - Type of elements in the input arrays.
 *
-* @param {...(ArrayLike<T> | null | undefined | ((a: T, b: T) => boolean))} values - The arrays to inspect, or the comparator function.
-* @returns {T[]} An array containing the elements that are present in exactly one of the arrays
+* @param values - The arrays to inspect, or the comparator function.
+* @returns An array containing the elements that are present in exactly one of the arrays
 *  as determined by the comparator.
 *
 * @example

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

@@ -8,9 +8,9 @@
  * with undefined values for missing elements.
  *
  * @template T, U
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @returns {Array<[T | undefined, U | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -23,9 +23,9 @@
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @returns {Array<[T | undefined, U | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b']);
@@ -41,10 +41,10 @@ declare function zip<T, U>(arr1: ArrayLike<T>, arr2: ArrayLike<U>): Array<[T | u
  * with undefined values for missing elements.
  *
  * @template T, U, V
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -58,10 +58,10 @@ declare function zip<T, U>(arr1: ArrayLike<T>, arr2: ArrayLike<U>): Array<[T | u
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b'], [true, false]);
@@ -77,11 +77,11 @@ declare function zip<T, U, V>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: Arra
  * with undefined values for missing elements.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -96,11 +96,11 @@ declare function zip<T, U, V>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: Arra
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1], ['a'], [true], [null]);
@@ -116,12 +116,12 @@ declare function zip<T, U, V, W>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: A
  * with undefined values for missing elements.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined, X | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -137,12 +137,12 @@ declare function zip<T, U, V, W>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: A
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V, W, X
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined, X | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1], ['a'], [true], [null], [undefined]);
@@ -158,8 +158,8 @@ declare function zip<T, U, V, W, X>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3
  * with undefined values for missing elements.
  *
  * @template T
- * @param {Array<ArrayLike<any> | null | undefined>} arrays - The arrays to zip.
- * @returns {Array<Array<T | undefined>>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arrays - The arrays to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -175,8 +175,8 @@ declare function zip<T, U, V, W, X>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T
- * @param {...Array<ArrayLike<T> | null | undefined>} arrays - The arrays to process.
- * @returns {Array<Array<T | undefined>>} Returns the new array of grouped elements.
+ * @param arrays - The arrays to process.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b'], [true, false]);

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

@@ -8,9 +8,9 @@
  * with undefined values for missing elements.
  *
  * @template T, U
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @returns {Array<[T | undefined, U | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -23,9 +23,9 @@
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @returns {Array<[T | undefined, U | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b']);
@@ -41,10 +41,10 @@ declare function zip<T, U>(arr1: ArrayLike<T>, arr2: ArrayLike<U>): Array<[T | u
  * with undefined values for missing elements.
  *
  * @template T, U, V
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -58,10 +58,10 @@ declare function zip<T, U>(arr1: ArrayLike<T>, arr2: ArrayLike<U>): Array<[T | u
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b'], [true, false]);
@@ -77,11 +77,11 @@ declare function zip<T, U, V>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: Arra
  * with undefined values for missing elements.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -96,11 +96,11 @@ declare function zip<T, U, V>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: Arra
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1], ['a'], [true], [null]);
@@ -116,12 +116,12 @@ declare function zip<T, U, V, W>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: A
  * with undefined values for missing elements.
  *
  * @template T, U, V, W
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined, X | undefined]>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -137,12 +137,12 @@ declare function zip<T, U, V, W>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3: A
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T, U, V, W, X
- * @param {ArrayLike<T>} arr1 - The first array to zip.
- * @param {ArrayLike<U>} arr2 - The second array to zip.
- * @param {ArrayLike<V>} arr3 - The third array to zip.
- * @param {ArrayLike<W>} arr4 - The fourth array to zip.
- * @param {ArrayLike<X>} arr5 - The fifth array to zip.
- * @returns {Array<[T | undefined, U | undefined, V | undefined, W | undefined, X | undefined]>} Returns the new array of grouped elements.
+ * @param arr1 - The first array to zip.
+ * @param arr2 - The second array to zip.
+ * @param arr3 - The third array to zip.
+ * @param arr4 - The fourth array to zip.
+ * @param arr5 - The fifth array to zip.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1], ['a'], [true], [null], [undefined]);
@@ -158,8 +158,8 @@ declare function zip<T, U, V, W, X>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3
  * with undefined values for missing elements.
  *
  * @template T
- * @param {Array<ArrayLike<any> | null | undefined>} arrays - The arrays to zip.
- * @returns {Array<Array<T | undefined>>} A new array of tuples containing the corresponding elements from the input arrays.
+ * @param arrays - The arrays to zip.
+ * @returns A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example
  * const arr1 = [1, 2, 3];
@@ -175,8 +175,8 @@ declare function zip<T, U, V, W, X>(arr1: ArrayLike<T>, arr2: ArrayLike<U>, arr3
  * the second of which contains the second elements of the given arrays, and so on.
  *
  * @template T
- * @param {...Array<ArrayLike<T> | null | undefined>} arrays - The arrays to process.
- * @returns {Array<Array<T | undefined>>} Returns the new array of grouped elements.
+ * @param arrays - The arrays to process.
+ * @returns Returns the new array of grouped elements.
  *
  * @example
  * zip([1, 2], ['a', 'b'], [true, false]);

package/dist/compat/array/zip.js

@@ -10,8 +10,8 @@ const require_isArrayLikeObject = require("../predicate/isArrayLikeObject.js");
 * with undefined values for missing elements.
 *
 * @template T
-* @param {Array<ArrayLike<any> | null | undefined>} arrays - The arrays to zip.
-* @returns {Array<Array<T | undefined>>} A new array of tuples containing the corresponding elements from the input arrays.
+* @param arrays - The arrays to zip.
+* @returns A new array of tuples containing the corresponding elements from the input arrays.
 *
 * @example
 * const arr1 = [1, 2, 3];

package/dist/compat/array/zip.mjs

@@ -10,8 +10,8 @@ import { isArrayLikeObject } from "../predicate/isArrayLikeObject.mjs";
 * with undefined values for missing elements.
 *
 * @template T
-* @param {Array<ArrayLike<any> | null | undefined>} arrays - The arrays to zip.
-* @returns {Array<Array<T | undefined>>} A new array of tuples containing the corresponding elements from the input arrays.
+* @param arrays - The arrays to zip.
+* @returns A new array of tuples containing the corresponding elements from the input arrays.
 *
 * @example
 * const arr1 = [1, 2, 3];

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

@@ -3,9 +3,9 @@
  * Combines two arrays, one of property names and one of corresponding values, into a single object.
  *
  * @template T - The type of values in the values array
- * @param {ArrayLike<PropertyKey>} props - An array of property names
- * @param {ArrayLike<T>} values - An array of values corresponding to the property names
- * @returns {Record<string, T>} A new object composed of the given property names and values
+ * @param props - An array of property names
+ * @param values - An array of values corresponding to the property names
+ * @returns A new object composed of the given property names and values
  *
  * @example
  * const props = ['a', 'b', 'c'];
@@ -17,8 +17,8 @@ declare function zipObject<T>(props: ArrayLike<PropertyKey>, values: ArrayLike<T
 /**
  * Creates an object from an array of property names, with undefined values.
  *
- * @param {ArrayLike<PropertyKey>} [props] - An array of property names
- * @returns {Record<string, undefined>} A new object with the given property names and undefined values
+ * @param [props] - An array of property names
+ * @returns A new object with the given property names and undefined values
  *
  * @example
  * const props = ['a', 'b', 'c'];