es-toolkit 1.47.0 → 1.47.1

package/dist/compat/array/pullAllWith.js

@@ -6,10 +6,10 @@ const require_copyArray = require("../_internal/copyArray.js");
 * Removes and returns elements from an array using a provided comparison function to determine which elements to remove.
 *
 * @template T
-* @param {T[] | ArrayLike<T>} array - The array to modify.
-* @param {T[] | ArrayLike<T>} values - The values to remove from the array.
-* @param {(a: T, b: T) => boolean} comparator - The function to compare elements of `array` with elements of `values`. Should return `true` if the two elements are considered equal.
-* @returns {T[] | ArrayLike<T>} - The array with specified values removed.
+* @param array - The array to modify.
+* @param values - The values to remove from the array.
+* @param comparator - The function to compare elements of `array` with elements of `values`. Should return `true` if the two elements are considered equal.
+* @returns The array with specified values removed.
 *
 * @example
 * import pullAllWith from './pullAllWith';

package/dist/compat/array/pullAllWith.mjs

@@ -6,10 +6,10 @@ import copyArray from "../_internal/copyArray.mjs";
 * Removes and returns elements from an array using a provided comparison function to determine which elements to remove.
 *
 * @template T
-* @param {T[] | ArrayLike<T>} array - The array to modify.
-* @param {T[] | ArrayLike<T>} values - The values to remove from the array.
-* @param {(a: T, b: T) => boolean} comparator - The function to compare elements of `array` with elements of `values`. Should return `true` if the two elements are considered equal.
-* @returns {T[] | ArrayLike<T>} - The array with specified values removed.
+* @param array - The array to modify.
+* @param values - The values to remove from the array.
+* @param comparator - The function to compare elements of `array` with elements of `values`. Should return `true` if the two elements are considered equal.
+* @returns The array with specified values removed.
 *
 * @example
 * import pullAllWith from './pullAllWith';

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

@@ -10,9 +10,9 @@ import { Many } from "../_internal/Many.mjs";
  * **Note:** Unlike `_.at`, this method mutates `array`.
  *
  * @template T
- * @param {T[]} array - The array to modify.
- * @param {...Array<number | number[]>} indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
- * @returns {T[]} Returns the new array of removed elements.
+ * @param array - The array to modify.
+ * @param indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
+ * @returns Returns the new array of removed elements.
  *
  * @example
  * var array = [5, 10, 15, 20];
@@ -32,9 +32,9 @@ declare function pullAt<T>(array: T[], ...indexes: Array<Many<number>>): T[];
  * **Note:** Unlike `_.at`, this method mutates `array`.
  *
  * @template L
- * @param {L} array - The array to modify.
- * @param {...Array<number | number[]>} indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
- * @returns {L} Returns the new array of removed elements.
+ * @param array - The array to modify.
+ * @param indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
+ * @returns Returns the new array of removed elements.
  *
  * @example
  * var array = [5, 10, 15, 20];

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

@@ -10,9 +10,9 @@ import { Many } from "../_internal/Many.js";
  * **Note:** Unlike `_.at`, this method mutates `array`.
  *
  * @template T
- * @param {T[]} array - The array to modify.
- * @param {...Array<number | number[]>} indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
- * @returns {T[]} Returns the new array of removed elements.
+ * @param array - The array to modify.
+ * @param indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
+ * @returns Returns the new array of removed elements.
  *
  * @example
  * var array = [5, 10, 15, 20];
@@ -32,9 +32,9 @@ declare function pullAt<T>(array: T[], ...indexes: Array<Many<number>>): T[];
  * **Note:** Unlike `_.at`, this method mutates `array`.
  *
  * @template L
- * @param {L} array - The array to modify.
- * @param {...Array<number | number[]>} indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
- * @returns {L} Returns the new array of removed elements.
+ * @param array - The array to modify.
+ * @param indexes - The indexes of elements to remove, specified as individual indexes or arrays of indexes.
+ * @returns Returns the new array of removed elements.
  *
  * @example
  * var array = [5, 10, 15, 20];

package/dist/compat/array/pullAt.js

@@ -11,9 +11,9 @@ const require_unset = require("../object/unset.js");
 * Removes elements from an array at specified indices and returns the removed elements.
 *
 * @template T
-* @param {ArrayLike<T>} array - The array from which elements will be removed.
-* @param {Array<number | readonly number[] | string | readonly string[]>} _indices - An array of indices specifying the positions of elements to remove.
-* @returns {ArrayLike<T>} An array containing the elements that were removed from the original array.
+* @param array - The array from which elements will be removed.
+* @param _indices - An array of indices specifying the positions of elements to remove.
+* @returns An array containing the elements that were removed from the original array.
 *
 * @example
 * const numbers = [10, 20, 30, 40, 50];

package/dist/compat/array/pullAt.mjs

@@ -11,9 +11,9 @@ import { unset } from "../object/unset.mjs";
 * Removes elements from an array at specified indices and returns the removed elements.
 *
 * @template T
-* @param {ArrayLike<T>} array - The array from which elements will be removed.
-* @param {Array<number | readonly number[] | string | readonly string[]>} _indices - An array of indices specifying the positions of elements to remove.
-* @returns {ArrayLike<T>} An array containing the elements that were removed from the original array.
+* @param array - The array from which elements will be removed.
+* @param _indices - An array of indices specifying the positions of elements to remove.
+* @returns An array containing the elements that were removed from the original array.
 *
 * @example
 * const numbers = [10, 20, 30, 40, 50];

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

@@ -5,10 +5,10 @@ import { MemoObjectIterator } from "../_internal/MemoObjectIterator.mjs";
 /**
  * Reduces an array to a single value using an iteratee function.
  *
- * @param {T[] | null | undefined} collection - The array to iterate over
- * @param {MemoListIterator<T, U, T[]>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The array to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const array = [1, 2, 3];
@@ -18,10 +18,10 @@ declare function reduce<T, U>(collection: T[] | null | undefined, callback: Memo
 /**
  * Reduces an array-like object to a single value using an iteratee function.
  *
- * @param {ArrayLike<T> | null | undefined} collection - The array-like object to iterate over
- * @param {MemoListIterator<T, U, ArrayLike<T>>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The array-like object to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const arrayLike = {0: 1, 1: 2, 2: 3, length: 3};
@@ -31,10 +31,10 @@ declare function reduce<T, U>(collection: ArrayLike<T> | null | undefined, callb
 /**
  * Reduces an object to a single value using an iteratee function.
  *
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {MemoObjectIterator<T[keyof T], U, T>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The object to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const obj = { a: 1, b: 2, c: 3 };
@@ -44,9 +44,9 @@ declare function reduce<T extends object, U>(collection: T | null | undefined, c
 /**
  * Reduces an array to a single value using an iteratee function.
  *
- * @param {T[] | null | undefined} collection - The array to iterate over
- * @param {MemoListIterator<T, T, T[]>} callback - The function invoked per iteration
- * @returns {T | undefined} Returns the accumulated value
+ * @param collection - The array to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const array = [1, 2, 3];
@@ -56,9 +56,9 @@ declare function reduce<T>(collection: T[] | null | undefined, callback: MemoLis
 /**
  * Reduces an array-like object to a single value using an iteratee function.
  *
- * @param {ArrayLike<T> | null | undefined} collection - The array-like object to iterate over
- * @param {MemoListIterator<T, T, ArrayLike<T>>} callback - The function invoked per iteration
- * @returns {T | undefined} Returns the accumulated value
+ * @param collection - The array-like object to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const arrayLike = {0: 1, 1: 2, 2: 3, length: 3};
@@ -68,9 +68,9 @@ declare function reduce<T>(collection: ArrayLike<T> | null | undefined, callback
 /**
  * Reduces an object to a single value using an iteratee function.
  *
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {MemoObjectIterator<T[keyof T], T[keyof T], T>} callback - The function invoked per iteration
- * @returns {T[keyof T] | undefined} Returns the accumulated value
+ * @param collection - The object to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const obj = { a: 1, b: 2, c: 3 };

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

@@ -5,10 +5,10 @@ import { MemoObjectIterator } from "../_internal/MemoObjectIterator.js";
 /**
  * Reduces an array to a single value using an iteratee function.
  *
- * @param {T[] | null | undefined} collection - The array to iterate over
- * @param {MemoListIterator<T, U, T[]>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The array to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const array = [1, 2, 3];
@@ -18,10 +18,10 @@ declare function reduce<T, U>(collection: T[] | null | undefined, callback: Memo
 /**
  * Reduces an array-like object to a single value using an iteratee function.
  *
- * @param {ArrayLike<T> | null | undefined} collection - The array-like object to iterate over
- * @param {MemoListIterator<T, U, ArrayLike<T>>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The array-like object to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const arrayLike = {0: 1, 1: 2, 2: 3, length: 3};
@@ -31,10 +31,10 @@ declare function reduce<T, U>(collection: ArrayLike<T> | null | undefined, callb
 /**
  * Reduces an object to a single value using an iteratee function.
  *
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {MemoObjectIterator<T[keyof T], U, T>} callback - The function invoked per iteration
- * @param {U} accumulator - The initial value
- * @returns {U} Returns the accumulated value
+ * @param collection - The object to iterate over
+ * @param callback - The function invoked per iteration
+ * @param accumulator - The initial value
+ * @returns Returns the accumulated value
  *
  * @example
  * const obj = { a: 1, b: 2, c: 3 };
@@ -44,9 +44,9 @@ declare function reduce<T extends object, U>(collection: T | null | undefined, c
 /**
  * Reduces an array to a single value using an iteratee function.
  *
- * @param {T[] | null | undefined} collection - The array to iterate over
- * @param {MemoListIterator<T, T, T[]>} callback - The function invoked per iteration
- * @returns {T | undefined} Returns the accumulated value
+ * @param collection - The array to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const array = [1, 2, 3];
@@ -56,9 +56,9 @@ declare function reduce<T>(collection: T[] | null | undefined, callback: MemoLis
 /**
  * Reduces an array-like object to a single value using an iteratee function.
  *
- * @param {ArrayLike<T> | null | undefined} collection - The array-like object to iterate over
- * @param {MemoListIterator<T, T, ArrayLike<T>>} callback - The function invoked per iteration
- * @returns {T | undefined} Returns the accumulated value
+ * @param collection - The array-like object to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const arrayLike = {0: 1, 1: 2, 2: 3, length: 3};
@@ -68,9 +68,9 @@ declare function reduce<T>(collection: ArrayLike<T> | null | undefined, callback
 /**
  * Reduces an object to a single value using an iteratee function.
  *
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {MemoObjectIterator<T[keyof T], T[keyof T], T>} callback - The function invoked per iteration
- * @returns {T[keyof T] | undefined} Returns the accumulated value
+ * @param collection - The object to iterate over
+ * @param callback - The function invoked per iteration
+ * @returns Returns the accumulated value
  *
  * @example
  * const obj = { a: 1, b: 2, c: 3 };

package/dist/compat/array/reduce.js

@@ -5,10 +5,10 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 /**
 * Reduces a collection to a single value using an iteratee function.
 *
-* @param {T[] | ArrayLike<T> | Record<string, T> | null | undefined} collection - The collection to iterate over.
-* @param {((accumulator: any, value: any, index: PropertyKey, collection: any) => any) | PropertyKey | object} iteratee - The function invoked per iteration or the key to reduce over.
-* @param {any} initialValue - The initial value.
-* @returns {any} - Returns the accumulated value.
+* @param collection - The collection to iterate over.
+* @param iteratee - The function invoked per iteration or the key to reduce over.
+* @param initialValue - The initial value.
+* @returns Returns the accumulated value.
 *
 * @example
 * // Using a reducer function
@@ -26,18 +26,19 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 * reduce(obj, (acc, value) => acc + value, 0); // => 6
 */
 function reduce(collection, iteratee = require_identity.identity, accumulator) {
+	const hasAccumulator = arguments.length >= 3;
 	if (!collection) return accumulator;
 	let keys;
 	let startIndex = 0;
 	if (require_isArrayLike.isArrayLike(collection)) {
 		keys = require_range.range(0, collection.length);
-		if (accumulator == null && collection.length > 0) {
+		if (!hasAccumulator && collection.length > 0) {
 			accumulator = collection[0];
 			startIndex += 1;
 		}
 	} else {
 		keys = Object.keys(collection);
-		if (accumulator == null) {
+		if (!hasAccumulator && keys.length > 0) {
 			accumulator = collection[keys[0]];
 			startIndex += 1;
 		}

package/dist/compat/array/reduce.mjs

@@ -5,10 +5,10 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 /**
 * Reduces a collection to a single value using an iteratee function.
 *
-* @param {T[] | ArrayLike<T> | Record<string, T> | null | undefined} collection - The collection to iterate over.
-* @param {((accumulator: any, value: any, index: PropertyKey, collection: any) => any) | PropertyKey | object} iteratee - The function invoked per iteration or the key to reduce over.
-* @param {any} initialValue - The initial value.
-* @returns {any} - Returns the accumulated value.
+* @param collection - The collection to iterate over.
+* @param iteratee - The function invoked per iteration or the key to reduce over.
+* @param initialValue - The initial value.
+* @returns Returns the accumulated value.
 *
 * @example
 * // Using a reducer function
@@ -26,18 +26,19 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 * reduce(obj, (acc, value) => acc + value, 0); // => 6
 */
 function reduce(collection, iteratee = identity, accumulator) {
+	const hasAccumulator = arguments.length >= 3;
 	if (!collection) return accumulator;
 	let keys;
 	let startIndex = 0;
 	if (isArrayLike(collection)) {
 		keys = range(0, collection.length);
-		if (accumulator == null && collection.length > 0) {
+		if (!hasAccumulator && collection.length > 0) {
 			accumulator = collection[0];
 			startIndex += 1;
 		}
 	} else {
 		keys = Object.keys(collection);
-		if (accumulator == null) {
+		if (!hasAccumulator && keys.length > 0) {
 			accumulator = collection[keys[0]];
 			startIndex += 1;
 		}

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

@@ -22,10 +22,10 @@ import { MemoObjectIterator } from "../_internal/MemoObjectIterator.mjs";
  * If not, it uses the last element of the array and begins with the second to last element for the calculation.
  *
  * @template T, U
- * @param {T[] | null | undefined} collection - The array to iterate over.
- * @param {MemoListIterator<T, U, T[]>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The array to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value, 0);
@@ -36,10 +36,10 @@ declare function reduceRight<T, U>(collection: T[] | null | undefined, callback:
  * Reduces an array-like collection to a single value using an iteratee function, starting from the right.
  *
  * @template T, U
- * @param {ArrayLike<T> | null | undefined} collection - The array-like collection to iterate over.
- * @param {MemoListIterator<T, U, ArrayLike<T>>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The array-like collection to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value, 0);
@@ -50,10 +50,10 @@ declare function reduceRight<T, U>(collection: ArrayLike<T> | null | undefined,
  * Reduces an object to a single value using an iteratee function, starting from the right.
  *
  * @template T, U
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {MemoObjectIterator<T[keyof T], U, T>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The object to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight({ a: 1, b: 2, c: 3 }, (acc, value) => acc + value, 0);
@@ -80,9 +80,9 @@ declare function reduceRight<T extends object, U>(collection: T | null | undefin
  * If not, it uses the last element of the array and begins with the second to last element for the calculation.
  *
  * @template T
- * @param {T[] | null | undefined} collection - The array to iterate over.
- * @param {MemoListIterator<T, T, T[]>} callback - The function invoked per iteration.
- * @returns {T | undefined} Returns the accumulated value.
+ * @param collection - The array to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value);
@@ -93,9 +93,9 @@ declare function reduceRight<T>(collection: T[] | null | undefined, callback: Me
  * Reduces an array-like collection to a single value using an iteratee function, starting from the right.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} collection - The array-like collection to iterate over.
- * @param {MemoListIterator<T, T, ArrayLike<T>>} callback - The function invoked per iteration.
- * @returns {T | undefined} Returns the accumulated value.
+ * @param collection - The array-like collection to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value);
@@ -106,9 +106,9 @@ declare function reduceRight<T>(collection: ArrayLike<T> | null | undefined, cal
  * Reduces an object to a single value using an iteratee function, starting from the right.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {MemoObjectIterator<T[keyof T], T[keyof T], T>} callback - The function invoked per iteration.
- * @returns {T[keyof T] | undefined} Returns the accumulated value.
+ * @param collection - The object to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight({ a: 1, b: 2, c: 3 }, (acc, value) => acc + value);

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

@@ -22,10 +22,10 @@ import { MemoObjectIterator } from "../_internal/MemoObjectIterator.js";
  * If not, it uses the last element of the array and begins with the second to last element for the calculation.
  *
  * @template T, U
- * @param {T[] | null | undefined} collection - The array to iterate over.
- * @param {MemoListIterator<T, U, T[]>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The array to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value, 0);
@@ -36,10 +36,10 @@ declare function reduceRight<T, U>(collection: T[] | null | undefined, callback:
  * Reduces an array-like collection to a single value using an iteratee function, starting from the right.
  *
  * @template T, U
- * @param {ArrayLike<T> | null | undefined} collection - The array-like collection to iterate over.
- * @param {MemoListIterator<T, U, ArrayLike<T>>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The array-like collection to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value, 0);
@@ -50,10 +50,10 @@ declare function reduceRight<T, U>(collection: ArrayLike<T> | null | undefined,
  * Reduces an object to a single value using an iteratee function, starting from the right.
  *
  * @template T, U
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {MemoObjectIterator<T[keyof T], U, T>} callback - The function invoked per iteration.
- * @param {U} accumulator - The initial value.
- * @returns {U} Returns the accumulated value.
+ * @param collection - The object to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @param accumulator - The initial value.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight({ a: 1, b: 2, c: 3 }, (acc, value) => acc + value, 0);
@@ -80,9 +80,9 @@ declare function reduceRight<T extends object, U>(collection: T | null | undefin
  * If not, it uses the last element of the array and begins with the second to last element for the calculation.
  *
  * @template T
- * @param {T[] | null | undefined} collection - The array to iterate over.
- * @param {MemoListIterator<T, T, T[]>} callback - The function invoked per iteration.
- * @returns {T | undefined} Returns the accumulated value.
+ * @param collection - The array to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value);
@@ -93,9 +93,9 @@ declare function reduceRight<T>(collection: T[] | null | undefined, callback: Me
  * Reduces an array-like collection to a single value using an iteratee function, starting from the right.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} collection - The array-like collection to iterate over.
- * @param {MemoListIterator<T, T, ArrayLike<T>>} callback - The function invoked per iteration.
- * @returns {T | undefined} Returns the accumulated value.
+ * @param collection - The array-like collection to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight([1, 2, 3], (acc, value) => acc + value);
@@ -106,9 +106,9 @@ declare function reduceRight<T>(collection: ArrayLike<T> | null | undefined, cal
  * Reduces an object to a single value using an iteratee function, starting from the right.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to iterate over.
- * @param {MemoObjectIterator<T[keyof T], T[keyof T], T>} callback - The function invoked per iteration.
- * @returns {T[keyof T] | undefined} Returns the accumulated value.
+ * @param collection - The object to iterate over.
+ * @param callback - The function invoked per iteration.
+ * @returns Returns the accumulated value.
  *
  * @example
  * reduceRight({ a: 1, b: 2, c: 3 }, (acc, value) => acc + value);

package/dist/compat/array/reduceRight.js

@@ -5,10 +5,10 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 /**
 * Reduces a collection to a single value using an iteratee function, starting from the right.
 *
-* @param {T[] | ArrayLike<T> | Record<string, T> | null | undefined} collection - The collection to iterate over.
-* @param {((accumulator: any, value: any, index: PropertyKey, collection: any) => any) | PropertyKey | object} iteratee - The function invoked per iteration or the key to reduce over.
-* @param {any} initialValue - The initial value.
-* @returns {any} - Returns the accumulated value.
+* @param collection - The collection to iterate over.
+* @param iteratee - The function invoked per iteration or the key to reduce over.
+* @param initialValue - The initial value.
+* @returns Returns the accumulated value.
 *
 * @example
 * // Using a reducer function
@@ -26,18 +26,19 @@ const require_isArrayLike = require("../predicate/isArrayLike.js");
 * reduceRight(obj, (acc, value) => acc + value, 0); // => 6
 */
 function reduceRight(collection, iteratee = require_identity.identity, accumulator) {
+	const hasAccumulator = arguments.length >= 3;
 	if (!collection) return accumulator;
 	let keys;
 	let startIndex;
 	if (require_isArrayLike.isArrayLike(collection)) {
 		keys = require_range.range(0, collection.length).reverse();
-		if (accumulator == null && collection.length > 0) {
+		if (!hasAccumulator && collection.length > 0) {
 			accumulator = collection[collection.length - 1];
 			startIndex = 1;
 		} else startIndex = 0;
 	} else {
 		keys = Object.keys(collection).reverse();
-		if (accumulator == null) {
+		if (!hasAccumulator && keys.length > 0) {
 			accumulator = collection[keys[0]];
 			startIndex = 1;
 		} else startIndex = 0;

package/dist/compat/array/reduceRight.mjs

@@ -5,10 +5,10 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 /**
 * Reduces a collection to a single value using an iteratee function, starting from the right.
 *
-* @param {T[] | ArrayLike<T> | Record<string, T> | null | undefined} collection - The collection to iterate over.
-* @param {((accumulator: any, value: any, index: PropertyKey, collection: any) => any) | PropertyKey | object} iteratee - The function invoked per iteration or the key to reduce over.
-* @param {any} initialValue - The initial value.
-* @returns {any} - Returns the accumulated value.
+* @param collection - The collection to iterate over.
+* @param iteratee - The function invoked per iteration or the key to reduce over.
+* @param initialValue - The initial value.
+* @returns Returns the accumulated value.
 *
 * @example
 * // Using a reducer function
@@ -26,18 +26,19 @@ import { isArrayLike } from "../predicate/isArrayLike.mjs";
 * reduceRight(obj, (acc, value) => acc + value, 0); // => 6
 */
 function reduceRight(collection, iteratee = identity, accumulator) {
+	const hasAccumulator = arguments.length >= 3;
 	if (!collection) return accumulator;
 	let keys;
 	let startIndex;
 	if (isArrayLike(collection)) {
 		keys = range(0, collection.length).reverse();
-		if (accumulator == null && collection.length > 0) {
+		if (!hasAccumulator && collection.length > 0) {
 			accumulator = collection[collection.length - 1];
 			startIndex = 1;
 		} else startIndex = 0;
 	} else {
 		keys = Object.keys(collection).reverse();
-		if (accumulator == null) {
+		if (!hasAccumulator && keys.length > 0) {
 			accumulator = collection[keys[0]];
 			startIndex = 1;
 		} else startIndex = 0;

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

@@ -7,9 +7,9 @@ import { ObjectIterateeCustom } from "../_internal/ObjectIteratee.mjs";
  * Iterates over the collection and rejects elements based on the given predicate.
  * If a function is provided, it is invoked for each element in the collection.
  *
- * @param {string | null | undefined} collection The string to iterate over
- * @param {StringIterator<boolean>} [predicate] The function invoked per iteration
- * @returns {string[]} Returns a new array of characters that do not satisfy the predicate
+ * @param collection The string to iterate over
+ * @param [predicate] The function invoked per iteration
+ * @returns Returns a new array of characters that do not satisfy the predicate
  * @example
  * reject('abc', char => char === 'b')
  * // => ['a', 'c']
@@ -20,9 +20,9 @@ declare function reject(collection: string | null | undefined, predicate?: Strin
  * If a function is provided, it is invoked for each element in the collection.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} collection The array-like to iterate over
- * @param {ListIterateeCustom<T, boolean>} [predicate] The function invoked per iteration
- * @returns {T[]} Returns a new array of elements that do not satisfy the predicate
+ * @param collection The array-like to iterate over
+ * @param [predicate] The function invoked per iteration
+ * @returns Returns a new array of elements that do not satisfy the predicate
  * @example
  * reject([1, 2, 3], num => num % 2 === 0)
  * // => [1, 3]
@@ -36,9 +36,9 @@ declare function reject<T>(collection: ArrayLike<T> | null | undefined, predicat
  * If a function is provided, it is invoked for each element in the collection.
  *
  * @template T
- * @param {T | null | undefined} collection The object to iterate over
- * @param {ObjectIterateeCustom<T, boolean>} [predicate] The function invoked per iteration
- * @returns {Array<T[keyof T]>} Returns a new array of elements that do not satisfy the predicate
+ * @param collection The object to iterate over
+ * @param [predicate] The function invoked per iteration
+ * @returns Returns a new array of elements that do not satisfy the predicate
  * @example
  * reject({ a: 1, b: 2, c: 3 }, value => value % 2 === 0)
  * // => [1, 3]