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

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

@@ -5,9 +5,9 @@ import { ListOfRecursiveArraysOrValues } from "../_internal/ListOfRecursiveArray
  * Recursively flattens array up to depth times.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} array - The array to flatten.
- * @param {number} [depth=1] - The maximum recursion depth.
- * @returns {T[]} Returns the new flattened array.
+ * @param array - The array to flatten.
+ * @param [depth=1] - The maximum recursion depth.
+ * @returns Returns the new flattened array.
  *
  * @example
  * const array = [1, [2, [3, [4]], 5]];

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

@@ -5,9 +5,9 @@ import { ListOfRecursiveArraysOrValues } from "../_internal/ListOfRecursiveArray
  * Recursively flattens array up to depth times.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} array - The array to flatten.
- * @param {number} [depth=1] - The maximum recursion depth.
- * @returns {T[]} Returns the new flattened array.
+ * @param array - The array to flatten.
+ * @param [depth=1] - The maximum recursion depth.
+ * @returns Returns the new flattened array.
  *
  * @example
  * const array = [1, [2, [3, [4]], 5]];

package/dist/compat/array/flattenDepth.js

@@ -4,9 +4,9 @@ const require_flatten = require("./flatten.js");
 * Recursively flattens array up to depth times.
 *
 * @template T
-* @param {ArrayLike<T> | null | undefined} array - The array to flatten.
-* @param {number} [depth=1] - The maximum recursion depth.
-* @returns {T[]} Returns the new flattened array.
+* @param array - The array to flatten.
+* @param [depth=1] - The maximum recursion depth.
+* @returns Returns the new flattened array.
 *
 * @example
 * const array = [1, [2, [3, [4]], 5]];

package/dist/compat/array/flattenDepth.mjs

@@ -4,9 +4,9 @@ import { flatten } from "./flatten.mjs";
 * Recursively flattens array up to depth times.
 *
 * @template T
-* @param {ArrayLike<T> | null | undefined} array - The array to flatten.
-* @param {number} [depth=1] - The maximum recursion depth.
-* @returns {T[]} Returns the new flattened array.
+* @param array - The array to flatten.
+* @param [depth=1] - The maximum recursion depth.
+* @returns Returns the new flattened array.
 *
 * @example
 * const array = [1, [2, [3, [4]], 5]];

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

@@ -8,9 +8,9 @@ import { StringIterator } from "../_internal/StringIterator.mjs";
  * Iterates over elements of array and invokes iteratee for each element.
  *
  * @template T
- * @param {T[]} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T[]} Returns array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns array.
  *
  * @example
  * forEach([1, 2], value => console.log(value));
@@ -20,9 +20,9 @@ declare function forEach<T>(collection: T[], iteratee?: ArrayIterator<T, any>):
 /**
  * Iterates over characters of string and invokes iteratee for each character.
  *
- * @param {string} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {string} Returns string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns string.
  *
  * @example
  * forEach('abc', char => console.log(char));
@@ -33,9 +33,9 @@ declare function forEach(collection: string, iteratee?: StringIterator<any>): st
  * Iterates over elements of collection and invokes iteratee for each element.
  *
  * @template T
- * @param {ArrayLike<T>} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {ArrayLike<T>} Returns collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns collection.
  *
  * @example
  * forEach({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -46,9 +46,9 @@ declare function forEach<T>(collection: ArrayLike<T>, iteratee?: ListIterator<T,
  * Iterates over own enumerable string keyed properties of an object and invokes iteratee for each property.
  *
  * @template T
- * @param {T} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns object.
  *
  * @example
  * forEach({ a: 1, b: 2 }, (value, key) => console.log(key));
@@ -59,9 +59,9 @@ declare function forEach<T extends object>(collection: T, iteratee?: ObjectItera
  * Iterates over elements of array and invokes iteratee for each element.
  *
  * @template T, U
- * @param {U & (T[] | null | undefined)} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {U} Returns the array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the array.
  *
  * @example
  * forEach([1, 2], value => console.log(value));
@@ -72,9 +72,9 @@ declare function forEach<T, U extends T[] | null | undefined>(collection: U & (T
  * Iterates over characters of string and invokes iteratee for each character.
  *
  * @template T
- * @param {T} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns the string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the string.
  *
  * @example
  * forEach('abc', char => console.log(char));
@@ -85,9 +85,9 @@ declare function forEach<T extends string | null | undefined>(collection: T, ite
  * Iterates over elements of collection and invokes iteratee for each element.
  *
  * @template T, L
- * @param {L & (ArrayLike<T> | null | undefined)} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {L} Returns the collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the collection.
  *
  * @example
  * forEach({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -98,9 +98,9 @@ declare function forEach<T, L extends ArrayLike<T> | null | undefined>(collectio
  * Iterates over own enumerable string keyed properties of an object and invokes iteratee for each property.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T | null | undefined} Returns the object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the object.
  *
  * @example
  * forEach({ a: 1, b: 2 }, (value, key) => console.log(key));

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

@@ -8,9 +8,9 @@ import { StringIterator } from "../_internal/StringIterator.js";
  * Iterates over elements of array and invokes iteratee for each element.
  *
  * @template T
- * @param {T[]} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T[]} Returns array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns array.
  *
  * @example
  * forEach([1, 2], value => console.log(value));
@@ -20,9 +20,9 @@ declare function forEach<T>(collection: T[], iteratee?: ArrayIterator<T, any>):
 /**
  * Iterates over characters of string and invokes iteratee for each character.
  *
- * @param {string} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {string} Returns string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns string.
  *
  * @example
  * forEach('abc', char => console.log(char));
@@ -33,9 +33,9 @@ declare function forEach(collection: string, iteratee?: StringIterator<any>): st
  * Iterates over elements of collection and invokes iteratee for each element.
  *
  * @template T
- * @param {ArrayLike<T>} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {ArrayLike<T>} Returns collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns collection.
  *
  * @example
  * forEach({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -46,9 +46,9 @@ declare function forEach<T>(collection: ArrayLike<T>, iteratee?: ListIterator<T,
  * Iterates over own enumerable string keyed properties of an object and invokes iteratee for each property.
  *
  * @template T
- * @param {T} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns object.
  *
  * @example
  * forEach({ a: 1, b: 2 }, (value, key) => console.log(key));
@@ -59,9 +59,9 @@ declare function forEach<T extends object>(collection: T, iteratee?: ObjectItera
  * Iterates over elements of array and invokes iteratee for each element.
  *
  * @template T, U
- * @param {U & (T[] | null | undefined)} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {U} Returns the array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the array.
  *
  * @example
  * forEach([1, 2], value => console.log(value));
@@ -72,9 +72,9 @@ declare function forEach<T, U extends T[] | null | undefined>(collection: U & (T
  * Iterates over characters of string and invokes iteratee for each character.
  *
  * @template T
- * @param {T} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns the string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the string.
  *
  * @example
  * forEach('abc', char => console.log(char));
@@ -85,9 +85,9 @@ declare function forEach<T extends string | null | undefined>(collection: T, ite
  * Iterates over elements of collection and invokes iteratee for each element.
  *
  * @template T, L
- * @param {L & (ArrayLike<T> | null | undefined)} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {L} Returns the collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the collection.
  *
  * @example
  * forEach({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -98,9 +98,9 @@ declare function forEach<T, L extends ArrayLike<T> | null | undefined>(collectio
  * Iterates over own enumerable string keyed properties of an object and invokes iteratee for each property.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T | null | undefined} Returns the object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the object.
  *
  * @example
  * forEach({ a: 1, b: 2 }, (value, key) => console.log(key));

package/dist/compat/array/forEach.js

@@ -6,13 +6,13 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 * Iterates over each element of the object invoking the provided callback function for each property.
 *
 * @template T - The type of object.
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => unknown} [callback] - The function invoked for each property.
+* @param object - The object to iterate over.
+* @param [callback] - The function invoked for each property.
 * The callback function receives three arguments:
 *  - 'value': The current property being processed in the object.
 *  - 'key': The key of the current property being processed in the object.
 *  - 'object': The object 'forEach' was called upon.
-* @returns {T} Returns the original object.
+* @returns Returns the original object.
 *
 * @example
 * forEach({'a': 1, 'b': 2 }, (value, key, object) => console.log(value, key));

package/dist/compat/array/forEach.mjs

@@ -6,13 +6,13 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 * Iterates over each element of the object invoking the provided callback function for each property.
 *
 * @template T - The type of object.
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => unknown} [callback] - The function invoked for each property.
+* @param object - The object to iterate over.
+* @param [callback] - The function invoked for each property.
 * The callback function receives three arguments:
 *  - 'value': The current property being processed in the object.
 *  - 'key': The key of the current property being processed in the object.
 *  - 'object': The object 'forEach' was called upon.
-* @returns {T} Returns the original object.
+* @returns Returns the original object.
 *
 * @example
 * forEach({'a': 1, 'b': 2 }, (value, key, object) => console.log(value, key));

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

@@ -8,9 +8,9 @@ import { StringIterator } from "../_internal/StringIterator.mjs";
  * Iterates over elements of array from right to left and invokes iteratee for each element.
  *
  * @template T
- * @param {T[]} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T[]} Returns array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns array.
  *
  * @example
  * forEachRight([1, 2], value => console.log(value));
@@ -20,9 +20,9 @@ declare function forEachRight<T>(collection: T[], iteratee?: ArrayIterator<T, an
 /**
  * Iterates over characters of string from right to left and invokes iteratee for each character.
  *
- * @param {string} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {string} Returns string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns string.
  *
  * @example
  * forEachRight('abc', char => console.log(char));
@@ -33,9 +33,9 @@ declare function forEachRight(collection: string, iteratee?: StringIterator<any>
  * Iterates over elements of collection from right to left and invokes iteratee for each element.
  *
  * @template T
- * @param {ArrayLike<T>} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {ArrayLike<T>} Returns collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns collection.
  *
  * @example
  * forEachRight({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -46,9 +46,9 @@ declare function forEachRight<T>(collection: ArrayLike<T>, iteratee?: ListIterat
  * Iterates over own enumerable string keyed properties of an object from right to left and invokes iteratee for each property.
  *
  * @template T
- * @param {T} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns object.
  *
  * @example
  * forEachRight({ a: 1, b: 2 }, (value, key) => console.log(key));
@@ -59,9 +59,9 @@ declare function forEachRight<T extends object>(collection: T, iteratee?: Object
  * Iterates over elements of array from right to left and invokes iteratee for each element.
  *
  * @template T, U
- * @param {U & (T[] | null | undefined)} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {U} Returns the array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the array.
  *
  * @example
  * forEachRight([1, 2], value => console.log(value));
@@ -72,9 +72,9 @@ declare function forEachRight<T, U extends T[] | null | undefined>(collection: U
  * Iterates over characters of string from right to left and invokes iteratee for each character.
  *
  * @template T
- * @param {T} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns the string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the string.
  *
  * @example
  * forEachRight('abc', char => console.log(char));
@@ -85,9 +85,9 @@ declare function forEachRight<T extends string | null | undefined>(collection: T
  * Iterates over elements of collection from right to left and invokes iteratee for each element.
  *
  * @template T, L
- * @param {L & (ArrayLike<T> | null | undefined)} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {L} Returns the collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the collection.
  *
  * @example
  * forEachRight({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -98,9 +98,9 @@ declare function forEachRight<T, L extends ArrayLike<T> | null | undefined>(coll
  * Iterates over own enumerable string keyed properties of an object from right to left and invokes iteratee for each property.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T | null | undefined} Returns the object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the object.
  *
  * @example
  * forEachRight({ a: 1, b: 2 }, (value, key) => console.log(key));

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

@@ -8,9 +8,9 @@ import { StringIterator } from "../_internal/StringIterator.js";
  * Iterates over elements of array from right to left and invokes iteratee for each element.
  *
  * @template T
- * @param {T[]} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T[]} Returns array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns array.
  *
  * @example
  * forEachRight([1, 2], value => console.log(value));
@@ -20,9 +20,9 @@ declare function forEachRight<T>(collection: T[], iteratee?: ArrayIterator<T, an
 /**
  * Iterates over characters of string from right to left and invokes iteratee for each character.
  *
- * @param {string} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {string} Returns string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns string.
  *
  * @example
  * forEachRight('abc', char => console.log(char));
@@ -33,9 +33,9 @@ declare function forEachRight(collection: string, iteratee?: StringIterator<any>
  * Iterates over elements of collection from right to left and invokes iteratee for each element.
  *
  * @template T
- * @param {ArrayLike<T>} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {ArrayLike<T>} Returns collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns collection.
  *
  * @example
  * forEachRight({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -46,9 +46,9 @@ declare function forEachRight<T>(collection: ArrayLike<T>, iteratee?: ListIterat
  * Iterates over own enumerable string keyed properties of an object from right to left and invokes iteratee for each property.
  *
  * @template T
- * @param {T} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns object.
  *
  * @example
  * forEachRight({ a: 1, b: 2 }, (value, key) => console.log(key));
@@ -59,9 +59,9 @@ declare function forEachRight<T extends object>(collection: T, iteratee?: Object
  * Iterates over elements of array from right to left and invokes iteratee for each element.
  *
  * @template T, U
- * @param {U & (T[] | null | undefined)} collection - The array to iterate over.
- * @param {ArrayIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {U} Returns the array.
+ * @param collection - The array to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the array.
  *
  * @example
  * forEachRight([1, 2], value => console.log(value));
@@ -72,9 +72,9 @@ declare function forEachRight<T, U extends T[] | null | undefined>(collection: U
  * Iterates over characters of string from right to left and invokes iteratee for each character.
  *
  * @template T
- * @param {T} collection - The string to iterate over.
- * @param {StringIterator<any>} [iteratee] - The function invoked per iteration.
- * @returns {T} Returns the string.
+ * @param collection - The string to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the string.
  *
  * @example
  * forEachRight('abc', char => console.log(char));
@@ -85,9 +85,9 @@ declare function forEachRight<T extends string | null | undefined>(collection: T
  * Iterates over elements of collection from right to left and invokes iteratee for each element.
  *
  * @template T, L
- * @param {L & (ArrayLike<T> | null | undefined)} collection - The collection to iterate over.
- * @param {ListIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {L} Returns the collection.
+ * @param collection - The collection to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the collection.
  *
  * @example
  * forEachRight({ 0: 'a', 1: 'b', length: 2 }, value => console.log(value));
@@ -98,9 +98,9 @@ declare function forEachRight<T, L extends ArrayLike<T> | null | undefined>(coll
  * Iterates over own enumerable string keyed properties of an object from right to left and invokes iteratee for each property.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {ObjectIterator<T, any>} [iteratee] - The function invoked per iteration.
- * @returns {T | null | undefined} Returns the object.
+ * @param collection - The object to iterate over.
+ * @param [iteratee] - The function invoked per iteration.
+ * @returns Returns the object.
  *
  * @example
  * forEachRight({ a: 1, b: 2 }, (value, key) => console.log(key));

package/dist/compat/array/forEachRight.js

@@ -6,13 +6,13 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 * Iterates over elements of 'array' from right to left and invokes 'callback' for each element.
 *
 * @template T - The type of object.
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => unknown} [callback] - The function invoked for each property.
+* @param object - The object to iterate over.
+* @param [callback] - The function invoked for each property.
 * The callback function receives three arguments:
 *  - 'value': The current property being processed in the object.
 *  - 'key': The key of the current property being processed in the object.
 *  - 'object': The object 'forEachRight' was called upon.
-* @returns {T} Returns the original object.
+* @returns Returns the original object.
 *
 * @example
 * forEachRight({'a': 1, 'b': 2 }, (value, key, object) => console.log(value, key));

package/dist/compat/array/forEachRight.mjs

@@ -6,13 +6,13 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 * Iterates over elements of 'array' from right to left and invokes 'callback' for each element.
 *
 * @template T - The type of object.
-* @param {T} object - The object to iterate over.
-* @param {(value: T[keyof T], key: keyof T, object: T) => unknown} [callback] - The function invoked for each property.
+* @param object - The object to iterate over.
+* @param [callback] - The function invoked for each property.
 * The callback function receives three arguments:
 *  - 'value': The current property being processed in the object.
 *  - 'key': The key of the current property being processed in the object.
 *  - 'object': The object 'forEachRight' was called upon.
-* @returns {T} Returns the original object.
+* @returns Returns the original object.
 *
 * @example
 * forEachRight({'a': 1, 'b': 2 }, (value, key, object) => console.log(value, key));

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

@@ -6,9 +6,9 @@ import { ValueIteratee } from "../_internal/ValueIteratee.mjs";
  * The order of grouped values is determined by the order they occur in collection.
  *
  * @template T - The type of elements in the array-like collection
- * @param {ArrayLike<T> | null | undefined} collection - The collection to iterate over
- * @param {ValueIteratee<T>} [iteratee=identity] - The iteratee to transform keys
- * @returns {Record<string, T[]>} Returns the composed aggregate object
+ * @param collection - The collection to iterate over
+ * @param [iteratee=identity] - The iteratee to transform keys
+ * @returns Returns the composed aggregate object
  *
  * @example
  * groupBy([6.1, 4.2, 6.3], Math.floor)
@@ -23,9 +23,9 @@ declare function groupBy<T>(collection: ArrayLike<T> | null | undefined, iterate
  * The order of grouped values is determined by the order they occur in collection.
  *
  * @template T - The type of the object
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {ValueIteratee<T[keyof T]>} [iteratee=identity] - The iteratee to transform keys
- * @returns {Record<string, Array<T[keyof T]>>} Returns the composed aggregate object
+ * @param collection - The object to iterate over
+ * @param [iteratee=identity] - The iteratee to transform keys
+ * @returns Returns the composed aggregate object
  *
  * @example
  * groupBy({ a: 6.1, b: 4.2, c: 6.3 }, Math.floor)

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

@@ -6,9 +6,9 @@ import { ValueIteratee } from "../_internal/ValueIteratee.js";
  * The order of grouped values is determined by the order they occur in collection.
  *
  * @template T - The type of elements in the array-like collection
- * @param {ArrayLike<T> | null | undefined} collection - The collection to iterate over
- * @param {ValueIteratee<T>} [iteratee=identity] - The iteratee to transform keys
- * @returns {Record<string, T[]>} Returns the composed aggregate object
+ * @param collection - The collection to iterate over
+ * @param [iteratee=identity] - The iteratee to transform keys
+ * @returns Returns the composed aggregate object
  *
  * @example
  * groupBy([6.1, 4.2, 6.3], Math.floor)
@@ -23,9 +23,9 @@ declare function groupBy<T>(collection: ArrayLike<T> | null | undefined, iterate
  * The order of grouped values is determined by the order they occur in collection.
  *
  * @template T - The type of the object
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {ValueIteratee<T[keyof T]>} [iteratee=identity] - The iteratee to transform keys
- * @returns {Record<string, Array<T[keyof T]>>} Returns the composed aggregate object
+ * @param collection - The object to iterate over
+ * @param [iteratee=identity] - The iteratee to transform keys
+ * @returns Returns the composed aggregate object
  *
  * @example
  * groupBy({ a: 6.1, b: 4.2, c: 6.3 }, Math.floor)

package/dist/compat/array/groupBy.js

@@ -12,13 +12,13 @@ const require_iteratee = require("../util/iteratee.js");
 *
 * @template T - The type of elements in the array or values in the object.
 * @template K - The type of keys.
-* @param {ArrayLike<T> | Record<any, T> | null | undefined} source - The collection to group.
-* @param {Function | PropertyKey | Array | Object} [_getKeyFromItem] - The iteratee to transform keys.
+* @param source - The collection to group.
+* @param [_getKeyFromItem] - The iteratee to transform keys.
 *   - If a function is provided, it's invoked for each element in the collection.
 *   - If a property name (string) is provided, that property of each element is used as the key.
 *   - If a property-value pair (array) is provided, elements with matching property values are used.
 *   - If a partial object is provided, elements with matching properties are used.
-* @returns {Record<K, T>} An object where each key is associated with an array of elements that
+* @returns An object where each key is associated with an array of elements that
 * share that key.
 *
 * @example

package/dist/compat/array/groupBy.mjs

@@ -12,13 +12,13 @@ import { iteratee } from "../util/iteratee.mjs";
 *
 * @template T - The type of elements in the array or values in the object.
 * @template K - The type of keys.
-* @param {ArrayLike<T> | Record<any, T> | null | undefined} source - The collection to group.
-* @param {Function | PropertyKey | Array | Object} [_getKeyFromItem] - The iteratee to transform keys.
+* @param source - The collection to group.
+* @param [_getKeyFromItem] - The iteratee to transform keys.
 *   - If a function is provided, it's invoked for each element in the collection.
 *   - If a property name (string) is provided, that property of each element is used as the key.
 *   - If a property-value pair (array) is provided, elements with matching property values are used.
 *   - If a partial object is provided, elements with matching properties are used.
-* @returns {Record<K, T>} An object where each key is associated with an array of elements that
+* @returns An object where each key is associated with an array of elements that
 * share that key.
 *
 * @example

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

@@ -3,8 +3,8 @@
  * Returns the first element of an array or `undefined` if the array is empty.
  *
  * @template T - The type of elements in the array.
- * @param {readonly [T, ...unknown[]]} array - A non-empty tuple with at least one element.
- * @returns {T} The first element of the array.
+ * @param array - A non-empty tuple with at least one element.
+ * @returns The first element of the array.
  *
  * @example
  * const arr = [1, 2, 3] as const;
@@ -16,8 +16,8 @@ declare function head<T>(array: readonly [T, ...unknown[]]): T;
  * Returns the first element of an array or `undefined` if the array is empty.
  *
  * @template T - The type of elements in the array.
- * @param {ArrayLike<T> | null | undefined} array - 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/null/undefined.
+ * @param array - The array from which to get the first element.
+ * @returns The first element of the array, or `undefined` if the array is empty/null/undefined.
  *
  * @example
  * const arr = [1, 2, 3];