es-toolkit 1.47.0 → 1.47.1

package/dist/array/forEachAsync.d.mts

@@ -9,11 +9,11 @@ interface ForEachAsyncOptions {
  * when all async operations complete. It supports optional concurrency limiting.
  *
  * @template T - The type of elements in the array.
- * @param {readonly T[]} array The array to iterate over.
- * @param {(item: T, index: number, array: readonly T[]) => Promise<void>} callback An async function to execute for each element.
- * @param {ForEachAsyncOptions} [options] Optional configuration object.
- * @param {number} [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
- * @returns {Promise<void>} A promise that resolves when all operations complete.
+ * @param array The array to iterate over.
+ * @param callback An async function to execute for each element.
+ * @param [options] Optional configuration object.
+ * @param [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
+ * @returns A promise that resolves when all operations complete.
  * @example
  * const users = [{ id: 1 }, { id: 2 }, { id: 3 }];
  * await forEachAsync(users, async (user) => {

package/dist/array/forEachAsync.d.ts

@@ -9,11 +9,11 @@ interface ForEachAsyncOptions {
  * when all async operations complete. It supports optional concurrency limiting.
  *
  * @template T - The type of elements in the array.
- * @param {readonly T[]} array The array to iterate over.
- * @param {(item: T, index: number, array: readonly T[]) => Promise<void>} callback An async function to execute for each element.
- * @param {ForEachAsyncOptions} [options] Optional configuration object.
- * @param {number} [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
- * @returns {Promise<void>} A promise that resolves when all operations complete.
+ * @param array The array to iterate over.
+ * @param callback An async function to execute for each element.
+ * @param [options] Optional configuration object.
+ * @param [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
+ * @returns A promise that resolves when all operations complete.
  * @example
  * const users = [{ id: 1 }, { id: 2 }, { id: 3 }];
  * await forEachAsync(users, async (user) => {

package/dist/array/forEachAsync.js

@@ -7,11 +7,11 @@ const require_limitAsync = require("./limitAsync.js");
 * when all async operations complete. It supports optional concurrency limiting.
 *
 * @template T - The type of elements in the array.
-* @param {readonly T[]} array The array to iterate over.
-* @param {(item: T, index: number, array: readonly T[]) => Promise<void>} callback An async function to execute for each element.
-* @param {ForEachAsyncOptions} [options] Optional configuration object.
-* @param {number} [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
-* @returns {Promise<void>} A promise that resolves when all operations complete.
+* @param array The array to iterate over.
+* @param callback An async function to execute for each element.
+* @param [options] Optional configuration object.
+* @param [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
+* @returns A promise that resolves when all operations complete.
 * @example
 * const users = [{ id: 1 }, { id: 2 }, { id: 3 }];
 * await forEachAsync(users, async (user) => {

package/dist/array/forEachAsync.mjs

@@ -7,11 +7,11 @@ import { limitAsync } from "./limitAsync.mjs";
 * when all async operations complete. It supports optional concurrency limiting.
 *
 * @template T - The type of elements in the array.
-* @param {readonly T[]} array The array to iterate over.
-* @param {(item: T, index: number, array: readonly T[]) => Promise<void>} callback An async function to execute for each element.
-* @param {ForEachAsyncOptions} [options] Optional configuration object.
-* @param {number} [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
-* @returns {Promise<void>} A promise that resolves when all operations complete.
+* @param array The array to iterate over.
+* @param callback An async function to execute for each element.
+* @param [options] Optional configuration object.
+* @param [options.concurrency] Maximum number of concurrent async operations. If not specified, all operations run concurrently.
+* @returns A promise that resolves when all operations complete.
 * @example
 * const users = [{ id: 1 }, { id: 2 }, { id: 3 }];
 * await forEachAsync(users, async (user) => {

package/dist/array/forEachRight.d.mts

@@ -3,8 +3,8 @@
  * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array to iterate over.
- * @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+ * @param arr - The array to iterate over.
+ * @param callback - The function invoked per iteration.
  * The callback function receives three arguments:
  *  - 'value': The current element being processed in the array.
  *  - 'index': The index of the current element being processed in the array.
@@ -26,8 +26,8 @@ declare function forEachRight<T>(arr: T[], callback: (value: T, index: number, a
  * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array to iterate over.
- * @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+ * @param arr - The array to iterate over.
+ * @param callback - The function invoked per iteration.
  * The callback function receives three arguments:
  *  - 'value': The current element being processed in the array.
  *  - 'index': The index of the current element being processed in the array.

package/dist/array/forEachRight.d.ts

@@ -3,8 +3,8 @@
  * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array to iterate over.
- * @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+ * @param arr - The array to iterate over.
+ * @param callback - The function invoked per iteration.
  * The callback function receives three arguments:
  *  - 'value': The current element being processed in the array.
  *  - 'index': The index of the current element being processed in the array.
@@ -26,8 +26,8 @@ declare function forEachRight<T>(arr: T[], callback: (value: T, index: number, a
  * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array to iterate over.
- * @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+ * @param arr - The array to iterate over.
+ * @param callback - The function invoked per iteration.
  * The callback function receives three arguments:
  *  - 'value': The current element being processed in the array.
  *  - 'index': The index of the current element being processed in the array.

package/dist/array/forEachRight.js

@@ -3,8 +3,8 @@
 * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The array to iterate over.
-* @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+* @param arr - The array to iterate over.
+* @param callback - The function invoked per iteration.
 * The callback function receives three arguments:
 *  - 'value': The current element being processed in the array.
 *  - 'index': The index of the current element being processed in the array.

package/dist/array/forEachRight.mjs

@@ -3,8 +3,8 @@
 * Iterates over elements of 'arr' from right to left and invokes 'callback' for each element.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The array to iterate over.
-* @param {(value: T, index: number, arr: T[]) => void} callback - The function invoked per iteration.
+* @param arr - The array to iterate over.
+* @param callback - The function invoked per iteration.
 * The callback function receives three arguments:
 *  - 'value': The current element being processed in the array.
 *  - 'index': The index of the current element being processed in the array.

package/dist/array/groupBy.d.mts

@@ -8,9 +8,9 @@
  *
  * @template T - The type of elements in the array.
  * @template K - The type of keys.
- * @param {T[]} arr - The array to group.
- * @param {(item: T, index: number, array: readonly T[]) => K} getKeyFromItem - A function that generates a key from an element, its index, and the array.
- * @returns {Record<K, T[]>} An object where each key is associated with an array of elements that
+ * @param arr - The array to group.
+ * @param getKeyFromItem - A function that generates a key from an element, its index, and the array.
+ * @returns An object where each key is associated with an array of elements that
  * share that key.
  *
  * @example

package/dist/array/groupBy.d.ts

@@ -8,9 +8,9 @@
  *
  * @template T - The type of elements in the array.
  * @template K - The type of keys.
- * @param {T[]} arr - The array to group.
- * @param {(item: T, index: number, array: readonly T[]) => K} getKeyFromItem - A function that generates a key from an element, its index, and the array.
- * @returns {Record<K, T[]>} An object where each key is associated with an array of elements that
+ * @param arr - The array to group.
+ * @param getKeyFromItem - A function that generates a key from an element, its index, and the array.
+ * @returns An object where each key is associated with an array of elements that
  * share that key.
  *
  * @example

package/dist/array/groupBy.js

@@ -8,9 +8,9 @@
 *
 * @template T - The type of elements in the array.
 * @template K - The type of keys.
-* @param {T[]} arr - The array to group.
-* @param {(item: T, index: number, array: readonly T[]) => K} getKeyFromItem - A function that generates a key from an element, its index, and the array.
-* @returns {Record<K, T[]>} An object where each key is associated with an array of elements that
+* @param arr - The array to group.
+* @param getKeyFromItem - A function that generates a key from an element, its index, and the array.
+* @returns An object where each key is associated with an array of elements that
 * share that key.
 *
 * @example

package/dist/array/groupBy.mjs

@@ -8,9 +8,9 @@
 *
 * @template T - The type of elements in the array.
 * @template K - The type of keys.
-* @param {T[]} arr - The array to group.
-* @param {(item: T, index: number, array: readonly T[]) => K} getKeyFromItem - A function that generates a key from an element, its index, and the array.
-* @returns {Record<K, T[]>} An object where each key is associated with an array of elements that
+* @param arr - The array to group.
+* @param getKeyFromItem - A function that generates a key from an element, its index, and the array.
+* @returns An object where each key is associated with an array of elements that
 * share that key.
 *
 * @example

package/dist/array/head.d.mts

@@ -6,8 +6,8 @@
  * If the array is empty, the function returns `undefined`.
  *
  * @template T - The type of elements in the array.
- * @param {[T, ...T[]]} arr - A non-empty array from which to get the first element.
- * @returns {T} The first element of the array.
+ * @param arr - A non-empty array from which to get the first element.
+ * @returns The first element of the array.
  *
  * @example
  * const arr = [1, 2, 3];
@@ -22,8 +22,8 @@ declare function head<T>(arr: readonly [T, ...T[]]): T;
  * If the array is empty, the function returns `undefined`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array from which to get the first element.
- * @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
+ * @param arr - The array from which to get the first element.
+ * @returns The first element of the array, or `undefined` if the array is empty.
  *
  * @example
  * const emptyArr: number[] = [];

package/dist/array/head.d.ts

@@ -6,8 +6,8 @@
  * If the array is empty, the function returns `undefined`.
  *
  * @template T - The type of elements in the array.
- * @param {[T, ...T[]]} arr - A non-empty array from which to get the first element.
- * @returns {T} The first element of the array.
+ * @param arr - A non-empty array from which to get the first element.
+ * @returns The first element of the array.
  *
  * @example
  * const arr = [1, 2, 3];
@@ -22,8 +22,8 @@ declare function head<T>(arr: readonly [T, ...T[]]): T;
  * If the array is empty, the function returns `undefined`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} arr - The array from which to get the first element.
- * @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
+ * @param arr - The array from which to get the first element.
+ * @returns The first element of the array, or `undefined` if the array is empty.
  *
  * @example
  * const emptyArr: number[] = [];

package/dist/array/head.js

@@ -6,8 +6,8 @@
 * If the array is empty, the function returns `undefined`.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The array from which to get the first element.
-* @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
+* @param arr - The array from which to get the first element.
+* @returns The first element of the array, or `undefined` if the array is empty.
 *
 * @example
 * const emptyArr: number[] = [];

package/dist/array/head.mjs

@@ -6,8 +6,8 @@
 * If the array is empty, the function returns `undefined`.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} arr - The array from which to get the first element.
-* @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
+* @param arr - The array from which to get the first element.
+* @returns The first element of the array, or `undefined` if the array is empty.
 *
 * @example
 * const emptyArr: number[] = [];

package/dist/array/initial.d.mts

@@ -3,8 +3,8 @@
  * Returns an empty array when the input is a tuple containing exactly one element.
  *
  * @template T The type of the single element.
- * @param {[T]} arr - A tuple containing exactly one element.
- * @returns {[]} An empty array since there is only one element.
+ * @param arr - A tuple containing exactly one element.
+ * @returns An empty array since there is only one element.
  *
  * @example
  * const array = [100] as const;
@@ -15,7 +15,7 @@ declare function initial<T>(arr: readonly [T]): [];
 /**
  * Returns an empty array when the input array is empty.
  *
- * @returns {[]} Always returns an empty array for an empty input.
+ * @returns Always returns an empty array for an empty input.
  *
  * @example
  * const array = [] as const;
@@ -28,8 +28,8 @@ declare function initial(arr: readonly []): [];
  *
  * @template T The types of the initial elements.
  * @template U The type of the last element in the tuple.
- * @param {[...T[], U]} arr - A tuple with one or more elements.
- * @returns {T[]} A new array containing all but the last element of the tuple.
+ * @param arr - A tuple with one or more elements.
+ * @returns A new array containing all but the last element of the tuple.
  *
  * @example
  * const array = ['apple', 'banana', 'cherry'] as const;
@@ -42,8 +42,8 @@ declare function initial<T, U>(arr: readonly [...T[], U]): T[];
  * If the input array is empty or has only one element, the function returns an empty array.
  *
  * @template T The type of elements in the array.
- * @param {T[]} arr - The input array.
- * @returns {T[]} A new array containing all but the last element of the input array.
+ * @param arr - The input array.
+ * @returns A new array containing all but the last element of the input array.
  *
  * @example
  * const arr = [1, 2, 3, 4];

package/dist/array/initial.d.ts

@@ -3,8 +3,8 @@
  * Returns an empty array when the input is a tuple containing exactly one element.
  *
  * @template T The type of the single element.
- * @param {[T]} arr - A tuple containing exactly one element.
- * @returns {[]} An empty array since there is only one element.
+ * @param arr - A tuple containing exactly one element.
+ * @returns An empty array since there is only one element.
  *
  * @example
  * const array = [100] as const;
@@ -15,7 +15,7 @@ declare function initial<T>(arr: readonly [T]): [];
 /**
  * Returns an empty array when the input array is empty.
  *
- * @returns {[]} Always returns an empty array for an empty input.
+ * @returns Always returns an empty array for an empty input.
  *
  * @example
  * const array = [] as const;
@@ -28,8 +28,8 @@ declare function initial(arr: readonly []): [];
  *
  * @template T The types of the initial elements.
  * @template U The type of the last element in the tuple.
- * @param {[...T[], U]} arr - A tuple with one or more elements.
- * @returns {T[]} A new array containing all but the last element of the tuple.
+ * @param arr - A tuple with one or more elements.
+ * @returns A new array containing all but the last element of the tuple.
  *
  * @example
  * const array = ['apple', 'banana', 'cherry'] as const;
@@ -42,8 +42,8 @@ declare function initial<T, U>(arr: readonly [...T[], U]): T[];
  * If the input array is empty or has only one element, the function returns an empty array.
  *
  * @template T The type of elements in the array.
- * @param {T[]} arr - The input array.
- * @returns {T[]} A new array containing all but the last element of the input array.
+ * @param arr - The input array.
+ * @returns A new array containing all but the last element of the input array.
  *
  * @example
  * const arr = [1, 2, 3, 4];

package/dist/array/initial.js

@@ -4,8 +4,8 @@
 * If the input array is empty or has only one element, the function returns an empty array.
 *
 * @template T The type of elements in the array.
-* @param {T[]} arr - The input array.
-* @returns {T[]} A new array containing all but the last element of the input array.
+* @param arr - The input array.
+* @returns A new array containing all but the last element of the input array.
 *
 * @example
 * const arr = [1, 2, 3, 4];

package/dist/array/initial.mjs

@@ -4,8 +4,8 @@
 * If the input array is empty or has only one element, the function returns an empty array.
 *
 * @template T The type of elements in the array.
-* @param {T[]} arr - The input array.
-* @returns {T[]} A new array containing all but the last element of the input array.
+* @param arr - The input array.
+* @returns A new array containing all but the last element of the input array.
 *
 * @example
 * const arr = [1, 2, 3, 4];

package/dist/array/intersection.d.mts

@@ -7,9 +7,9 @@
  * are not found in the second array.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {T[]} secondArr - The second array to compare.
- * @returns {T[]} A new array containing the elements that are present in both arrays.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @returns A new array containing the elements that are present in both arrays.
  *
  * @example
  * const array1 = [1, 2, 3, 4, 5];

package/dist/array/intersection.d.ts

@@ -7,9 +7,9 @@
  * are not found in the second array.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {T[]} secondArr - The second array to compare.
- * @returns {T[]} A new array containing the elements that are present in both arrays.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @returns A new array containing the elements that are present in both arrays.
  *
  * @example
  * const array1 = [1, 2, 3, 4, 5];

package/dist/array/intersection.js

@@ -7,9 +7,9 @@
 * are not found in the second array.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {T[]} secondArr - The second array to compare.
-* @returns {T[]} A new array containing the elements that are present in both arrays.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @returns A new array containing the elements that are present in both arrays.
 *
 * @example
 * const array1 = [1, 2, 3, 4, 5];

package/dist/array/intersection.mjs

@@ -7,9 +7,9 @@
 * are not found in the second array.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {T[]} secondArr - The second array to compare.
-* @returns {T[]} A new array containing the elements that are present in both arrays.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @returns A new array containing the elements that are present in both arrays.
 *
 * @example
 * const array1 = [1, 2, 3, 4, 5];

package/dist/array/intersectionBy.d.mts

@@ -9,10 +9,10 @@
  *
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {U[]} secondArr - The second array to compare.
- * @param {(item: T | U) => unknown} mapper - A function to map the elements of both arrays for comparison.
- * @returns {T[]} A new array containing the elements from the first array that have corresponding mapped values in the second array.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @param mapper - A function to map the elements of both arrays for comparison.
+ * @returns A new array containing the elements from the first array that have corresponding mapped values in the second array.
  *
  * @example
  * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionBy.d.ts

@@ -9,10 +9,10 @@
  *
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {U[]} secondArr - The second array to compare.
- * @param {(item: T | U) => unknown} mapper - A function to map the elements of both arrays for comparison.
- * @returns {T[]} A new array containing the elements from the first array that have corresponding mapped values in the second array.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @param mapper - A function to map the elements of both arrays for comparison.
+ * @returns A new array containing the elements from the first array that have corresponding mapped values in the second array.
  *
  * @example
  * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionBy.js

@@ -9,10 +9,10 @@
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {U[]} secondArr - The second array to compare.
-* @param {(item: T | U) => unknown} mapper - A function to map the elements of both arrays for comparison.
-* @returns {T[]} A new array containing the elements from the first array that have corresponding mapped values in the second array.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @param mapper - A function to map the elements of both arrays for comparison.
+* @returns A new array containing the elements from the first array that have corresponding mapped values in the second array.
 *
 * @example
 * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionBy.mjs

@@ -9,10 +9,10 @@
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {U[]} secondArr - The second array to compare.
-* @param {(item: T | U) => unknown} mapper - A function to map the elements of both arrays for comparison.
-* @returns {T[]} A new array containing the elements from the first array that have corresponding mapped values in the second array.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @param mapper - A function to map the elements of both arrays for comparison.
+* @returns A new array containing the elements from the first array that have corresponding mapped values in the second array.
 *
 * @example
 * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionWith.d.mts

@@ -9,11 +9,11 @@
  *
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {U[]} secondArr - The second array to compare.
- * @param {(x: T, y: U) => boolean} areItemsEqual - A custom function to determine if two elements are equal.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @param areItemsEqual - A custom function to determine if two elements are equal.
  * This function takes two arguments, one from each array, and returns `true` if the elements are considered equal, and `false` otherwise.
- * @returns {T[]} A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
+ * @returns A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
  *
  * @example
  * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionWith.d.ts

@@ -9,11 +9,11 @@
  *
  * @template T - The type of elements in the first array.
  * @template U - The type of elements in the second array.
- * @param {T[]} firstArr - The first array to compare.
- * @param {U[]} secondArr - The second array to compare.
- * @param {(x: T, y: U) => boolean} areItemsEqual - A custom function to determine if two elements are equal.
+ * @param firstArr - The first array to compare.
+ * @param secondArr - The second array to compare.
+ * @param areItemsEqual - A custom function to determine if two elements are equal.
  * This function takes two arguments, one from each array, and returns `true` if the elements are considered equal, and `false` otherwise.
- * @returns {T[]} A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
+ * @returns A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
  *
  * @example
  * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionWith.js

@@ -9,11 +9,11 @@
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {U[]} secondArr - The second array to compare.
-* @param {(x: T, y: U) => boolean} areItemsEqual - A custom function to determine if two elements are equal.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @param areItemsEqual - A custom function to determine if two elements are equal.
 * This function takes two arguments, one from each array, and returns `true` if the elements are considered equal, and `false` otherwise.
-* @returns {T[]} A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
+* @returns A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
 *
 * @example
 * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/intersectionWith.mjs

@@ -9,11 +9,11 @@
 *
 * @template T - The type of elements in the first array.
 * @template U - The type of elements in the second array.
-* @param {T[]} firstArr - The first array to compare.
-* @param {U[]} secondArr - The second array to compare.
-* @param {(x: T, y: U) => boolean} areItemsEqual - A custom function to determine if two elements are equal.
+* @param firstArr - The first array to compare.
+* @param secondArr - The second array to compare.
+* @param areItemsEqual - A custom function to determine if two elements are equal.
 * This function takes two arguments, one from each array, and returns `true` if the elements are considered equal, and `false` otherwise.
-* @returns {T[]} A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
+* @returns A new array containing the elements from the first array that have corresponding matches in the second array according to the custom equality function.
 *
 * @example
 * const array1 = [{ id: 1 }, { id: 2 }, { id: 3 }];

package/dist/array/isSubset.d.mts

@@ -4,9 +4,9 @@
  *
  *
  * @template T - The type of elements contained in the arrays.
- * @param {T[]} superset - The array that may contain all elements of the subset.
- * @param {T[]} subset - The array to check against the superset.
- * @returns {boolean} - Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
+ * @param superset - The array that may contain all elements of the subset.
+ * @param subset - The array to check against the superset.
+ * @returns Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
  *
  * @example
  * ```typescript

package/dist/array/isSubset.d.ts

@@ -4,9 +4,9 @@
  *
  *
  * @template T - The type of elements contained in the arrays.
- * @param {T[]} superset - The array that may contain all elements of the subset.
- * @param {T[]} subset - The array to check against the superset.
- * @returns {boolean} - Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
+ * @param superset - The array that may contain all elements of the subset.
+ * @param subset - The array to check against the superset.
+ * @returns Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
  *
  * @example
  * ```typescript

package/dist/array/isSubset.js

@@ -5,9 +5,9 @@ const require_difference = require("./difference.js");
 *
 *
 * @template T - The type of elements contained in the arrays.
-* @param {T[]} superset - The array that may contain all elements of the subset.
-* @param {T[]} subset - The array to check against the superset.
-* @returns {boolean} - Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
+* @param superset - The array that may contain all elements of the subset.
+* @param subset - The array to check against the superset.
+* @returns Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
 *
 * @example
 * ```typescript

package/dist/array/isSubset.mjs

@@ -5,9 +5,9 @@ import { difference } from "./difference.mjs";
 *
 *
 * @template T - The type of elements contained in the arrays.
-* @param {T[]} superset - The array that may contain all elements of the subset.
-* @param {T[]} subset - The array to check against the superset.
-* @returns {boolean} - Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
+* @param superset - The array that may contain all elements of the subset.
+* @param subset - The array to check against the superset.
+* @returns Returns `true` if all elements of the `subset` are present in the `superset`, otherwise returns `false`.
 *
 * @example
 * ```typescript