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

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

@@ -7,9 +7,9 @@ import { ListIteratee } from "../_internal/ListIteratee.mjs";
  * The predicate is invoked with three arguments: (value, index, array).
  *
  * @template T - The type of elements in the array
- * @param {ArrayLike<T> | null | undefined} arr - The array to query
- * @param {ListIteratee<T>} [predicate=identity] - The function invoked per iteration
- * @returns {T[]} Returns the slice of array
+ * @param arr - The array to query
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns the slice of array
  *
  * @example
  * dropWhile([1, 2, 3], n => n < 3)

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

@@ -7,9 +7,9 @@ import { ListIteratee } from "../_internal/ListIteratee.js";
  * The predicate is invoked with three arguments: (value, index, array).
  *
  * @template T - The type of elements in the array
- * @param {ArrayLike<T> | null | undefined} arr - The array to query
- * @param {ListIteratee<T>} [predicate=identity] - The function invoked per iteration
- * @returns {T[]} Returns the slice of array
+ * @param arr - The array to query
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns the slice of array
  *
  * @example
  * dropWhile([1, 2, 3], n => n < 3)

package/dist/compat/array/dropWhile.js

@@ -12,9 +12,9 @@ const require_matchesProperty = require("../predicate/matchesProperty.js");
 * The predicate is invoked with three arguments: (value, index, array).
 *
 * @template T - The type of elements in the array
-* @param {ArrayLike<T> | null | undefined} arr - The array to query
-* @param {ListIteratee<T>} [predicate=identity] - The function invoked per iteration
-* @returns {T[]} Returns the slice of array
+* @param arr - The array to query
+* @param [predicate=identity] - The function invoked per iteration
+* @returns Returns the slice of array
 *
 * @example
 * dropWhile([1, 2, 3], n => n < 3)

package/dist/compat/array/dropWhile.mjs

@@ -12,9 +12,9 @@ import { matchesProperty } from "../predicate/matchesProperty.mjs";
 * The predicate is invoked with three arguments: (value, index, array).
 *
 * @template T - The type of elements in the array
-* @param {ArrayLike<T> | null | undefined} arr - The array to query
-* @param {ListIteratee<T>} [predicate=identity] - The function invoked per iteration
-* @returns {T[]} Returns the slice of array
+* @param arr - The array to query
+* @param [predicate=identity] - The function invoked per iteration
+* @returns Returns the slice of array
 *
 * @example
 * dropWhile([1, 2, 3], n => n < 3)

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

@@ -7,9 +7,9 @@ import { ObjectIterateeCustom } from "../_internal/ObjectIteratee.mjs";
  * The predicate is invoked with three arguments: (value, index|key, collection).
  *
  * @template T - The type of elements in the collection
- * @param {ArrayLike<T> | null | undefined} collection - The collection to iterate over
- * @param {ListIterateeCustom<T, boolean>} [predicate=identity] - The function invoked per iteration
- * @returns {boolean} Returns true if all elements pass the predicate check, else false
+ * @param collection - The collection to iterate over
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns true if all elements pass the predicate check, else false
  *
  * @example
  * // Using a function predicate
@@ -35,9 +35,9 @@ declare function every<T>(collection: ArrayLike<T> | null | undefined, predicate
  * The predicate is invoked with three arguments: (value, key, object).
  *
  * @template T - The type of the object
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {ObjectIterateeCustom<T, boolean>} [predicate=identity] - The function invoked per iteration
- * @returns {boolean} Returns true if all elements pass the predicate check, else false
+ * @param collection - The object to iterate over
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns true if all elements pass the predicate check, else false
  *
  * @example
  * // Using a function predicate

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

@@ -7,9 +7,9 @@ import { ObjectIterateeCustom } from "../_internal/ObjectIteratee.js";
  * The predicate is invoked with three arguments: (value, index|key, collection).
  *
  * @template T - The type of elements in the collection
- * @param {ArrayLike<T> | null | undefined} collection - The collection to iterate over
- * @param {ListIterateeCustom<T, boolean>} [predicate=identity] - The function invoked per iteration
- * @returns {boolean} Returns true if all elements pass the predicate check, else false
+ * @param collection - The collection to iterate over
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns true if all elements pass the predicate check, else false
  *
  * @example
  * // Using a function predicate
@@ -35,9 +35,9 @@ declare function every<T>(collection: ArrayLike<T> | null | undefined, predicate
  * The predicate is invoked with three arguments: (value, key, object).
  *
  * @template T - The type of the object
- * @param {T | null | undefined} collection - The object to iterate over
- * @param {ObjectIterateeCustom<T, boolean>} [predicate=identity] - The function invoked per iteration
- * @returns {boolean} Returns true if all elements pass the predicate check, else false
+ * @param collection - The object to iterate over
+ * @param [predicate=identity] - The function invoked per iteration
+ * @returns Returns true if all elements pass the predicate check, else false
  *
  * @example
  * // Using a function predicate

package/dist/compat/array/every.js

@@ -9,12 +9,12 @@ const require_isIterateeCall = require("../_internal/isIterateeCall.js");
 * Checks if every item in an object has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {T extends Record<string, unknown> ? T : never} object - The object to check through.
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to check through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {PropertyKey} propertyToCheck - The property name to check.
-* @param {unknown} guard - Enables use as an iteratee for methods like `_.map`.
-* @returns {boolean} - `true` if every property value has the specified property, or `false` if at least one does not match.
+* @param object - The object to check through.
+* @param source - The source array or object to check through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param propertyToCheck - The property name to check.
+* @param guard - Enables use as an iteratee for methods like `_.map`.
+* @returns `true` if every property value has the specified property, or `false` if at least one does not match.
 *
 * @example
 * // Using a property name

package/dist/compat/array/every.mjs

@@ -9,12 +9,12 @@ import { isIterateeCall } from "../_internal/isIterateeCall.mjs";
 * Checks if every item in an object has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {T extends Record<string, unknown> ? T : never} object - The object to check through.
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to check through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {PropertyKey} propertyToCheck - The property name to check.
-* @param {unknown} guard - Enables use as an iteratee for methods like `_.map`.
-* @returns {boolean} - `true` if every property value has the specified property, or `false` if at least one does not match.
+* @param object - The object to check through.
+* @param source - The source array or object to check through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param propertyToCheck - The property name to check.
+* @param guard - Enables use as an iteratee for methods like `_.map`.
+* @returns `true` if every property value has the specified property, or `false` if at least one does not match.
 *
 * @example
 * // Using a property name

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

@@ -5,9 +5,9 @@ import { RejectReadonly } from "../_internal/RejectReadonly.mjs";
 /**
  * Fills an array with a value.
  * @template T
- * @param {any[] | null | undefined} array - The array to fill
- * @param {T} value - The value to fill array with
- * @returns {T[]} Returns the filled array
+ * @param array - The array to fill
+ * @param value - The value to fill array with
+ * @returns Returns the filled array
  * @example
  * fill([1, 2, 3], 'a')
  * // => ['a', 'a', 'a']
@@ -16,9 +16,9 @@ declare function fill<T>(array: any[] | null | undefined, value: T): T[];
 /**
  * Fills an array-like object with a value.
  * @template T, AL
- * @param {RejectReadonly<AL> | null | undefined} array - The array-like object to fill
- * @param {T} value - The value to fill array with
- * @returns {ArrayLike<T>} Returns the filled array-like object
+ * @param array - The array-like object to fill
+ * @param value - The value to fill array with
+ * @returns Returns the filled array-like object
  * @example
  * fill({ length: 3 }, 2)
  * // => { 0: 2, 1: 2, 2: 2, length: 3 }
@@ -27,11 +27,11 @@ declare function fill<T, AL extends MutableList<any>>(array: RejectReadonly<AL>
 /**
  * Fills an array with a value from start up to end.
  * @template T, U
- * @param {U[] | null | undefined} array - The array to fill
- * @param {T} value - The value to fill array with
- * @param {number} [start=0] - The start position
- * @param {number} [end=array.length] - The end position
- * @returns {Array<T | U>} Returns the filled array
+ * @param array - The array to fill
+ * @param value - The value to fill array with
+ * @param [start=0] - The start position
+ * @param [end=array.length] - The end position
+ * @returns Returns the filled array
  * @example
  * fill([1, 2, 3], 'a', 1, 2)
  * // => [1, 'a', 3]
@@ -40,11 +40,11 @@ declare function fill<T, U>(array: U[] | null | undefined, value: T, start?: num
 /**
  * Fills an array-like object with a value from start up to end.
  * @template T, U
- * @param {U extends readonly any[] ? never : U | null | undefined} array - The array-like object to fill
- * @param {T} value - The value to fill array with
- * @param {number} [start=0] - The start position
- * @param {number} [end=array.length] - The end position
- * @returns {ArrayLike<T | U[0]>} Returns the filled array-like object
+ * @param array - The array-like object to fill
+ * @param value - The value to fill array with
+ * @param [start=0] - The start position
+ * @param [end=array.length] - The end position
+ * @returns Returns the filled array-like object
  * @example
  * fill({ 0: 1, 1: 2, 2: 3, length: 3 }, 'a', 1, 2)
  * // => { 0: 1, 1: 'a', 2: 3, length: 3 }

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

@@ -5,9 +5,9 @@ import { RejectReadonly } from "../_internal/RejectReadonly.js";
 /**
  * Fills an array with a value.
  * @template T
- * @param {any[] | null | undefined} array - The array to fill
- * @param {T} value - The value to fill array with
- * @returns {T[]} Returns the filled array
+ * @param array - The array to fill
+ * @param value - The value to fill array with
+ * @returns Returns the filled array
  * @example
  * fill([1, 2, 3], 'a')
  * // => ['a', 'a', 'a']
@@ -16,9 +16,9 @@ declare function fill<T>(array: any[] | null | undefined, value: T): T[];
 /**
  * Fills an array-like object with a value.
  * @template T, AL
- * @param {RejectReadonly<AL> | null | undefined} array - The array-like object to fill
- * @param {T} value - The value to fill array with
- * @returns {ArrayLike<T>} Returns the filled array-like object
+ * @param array - The array-like object to fill
+ * @param value - The value to fill array with
+ * @returns Returns the filled array-like object
  * @example
  * fill({ length: 3 }, 2)
  * // => { 0: 2, 1: 2, 2: 2, length: 3 }
@@ -27,11 +27,11 @@ declare function fill<T, AL extends MutableList<any>>(array: RejectReadonly<AL>
 /**
  * Fills an array with a value from start up to end.
  * @template T, U
- * @param {U[] | null | undefined} array - The array to fill
- * @param {T} value - The value to fill array with
- * @param {number} [start=0] - The start position
- * @param {number} [end=array.length] - The end position
- * @returns {Array<T | U>} Returns the filled array
+ * @param array - The array to fill
+ * @param value - The value to fill array with
+ * @param [start=0] - The start position
+ * @param [end=array.length] - The end position
+ * @returns Returns the filled array
  * @example
  * fill([1, 2, 3], 'a', 1, 2)
  * // => [1, 'a', 3]
@@ -40,11 +40,11 @@ declare function fill<T, U>(array: U[] | null | undefined, value: T, start?: num
 /**
  * Fills an array-like object with a value from start up to end.
  * @template T, U
- * @param {U extends readonly any[] ? never : U | null | undefined} array - The array-like object to fill
- * @param {T} value - The value to fill array with
- * @param {number} [start=0] - The start position
- * @param {number} [end=array.length] - The end position
- * @returns {ArrayLike<T | U[0]>} Returns the filled array-like object
+ * @param array - The array-like object to fill
+ * @param value - The value to fill array with
+ * @param [start=0] - The start position
+ * @param [end=array.length] - The end position
+ * @returns Returns the filled array-like object
  * @example
  * fill({ 0: 1, 1: 2, 2: 3, length: 3 }, 'a', 1, 2)
  * // => { 0: 1, 1: 'a', 2: 3, length: 3 }

package/dist/compat/array/fill.js

@@ -10,11 +10,11 @@ const require_isString = require("../predicate/isString.js");
 * entire array.
 *
 * @template T, U
-* @param {ArrayLike<T | U> | null | undefined} array - The array to fill.
-* @param {U} value - The value to fill the array with.
-* @param {number} [start=0] - The start position. Defaults to 0.
-* @param {number} [end=arr.length] - The end position. Defaults to the array's length.
-* @returns {ArrayLike<T | U>} The array with the filled values.
+* @param array - The array to fill.
+* @param value - The value to fill the array with.
+* @param [start=0] - The start position. Defaults to 0.
+* @param [end=arr.length] - The end position. Defaults to the array's length.
+* @returns The array with the filled values.
 *
 * @example
 * fill([1, 2, 3], 'a');

package/dist/compat/array/fill.mjs

@@ -10,11 +10,11 @@ import { isString } from "../predicate/isString.mjs";
 * entire array.
 *
 * @template T, U
-* @param {ArrayLike<T | U> | null | undefined} array - The array to fill.
-* @param {U} value - The value to fill the array with.
-* @param {number} [start=0] - The start position. Defaults to 0.
-* @param {number} [end=arr.length] - The end position. Defaults to the array's length.
-* @returns {ArrayLike<T | U>} The array with the filled values.
+* @param array - The array to fill.
+* @param value - The value to fill the array with.
+* @param [start=0] - The start position. Defaults to 0.
+* @param [end=arr.length] - The end position. Defaults to the array's length.
+* @returns The array with the filled values.
 *
 * @example
 * fill([1, 2, 3], 'a');

package/dist/compat/array/filter.js

@@ -7,9 +7,9 @@ const require_iteratee = require("../util/iteratee.js");
 * If a function is provided, it is invoked for each element in the collection.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The array or object to iterate over.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} [predicate=identity] - The function invoked per iteration.
-* @returns {T[]} - Returns a new array of filtered elements that satisfy the predicate.
+* @param source - The array or object to iterate over.
+* @param [predicate=identity] - The function invoked per iteration.
+* @returns Returns a new array of filtered elements that satisfy the predicate.
 *
 * @example
 * filter([{ a: 1 }, { a: 2 }, { b: 1 }], 'a');

package/dist/compat/array/filter.mjs

@@ -7,9 +7,9 @@ import { iteratee } from "../util/iteratee.mjs";
 * If a function is provided, it is invoked for each element in the collection.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The array or object to iterate over.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} [predicate=identity] - The function invoked per iteration.
-* @returns {T[]} - Returns a new array of filtered elements that satisfy the predicate.
+* @param source - The array or object to iterate over.
+* @param [predicate=identity] - The function invoked per iteration.
+* @returns Returns a new array of filtered elements that satisfy the predicate.
 *
 * @example
 * filter([{ a: 1 }, { a: 2 }, { b: 1 }], 'a');

package/dist/compat/array/find.js

@@ -5,10 +5,10 @@ const require_iteratee = require("../util/iteratee.js");
 * Finds the first item in an object that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
-* @returns {T | undefined} - The first property value that has the specified property, or `undefined` if no match is found.
+* @param source - The source array or object to search through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [fromIndex=0] - The index to start the search from, defaults to 0.
+* @returns The first property value that has the specified property, or `undefined` if no match is found.
 *
 * @example
 * // Using a property name

package/dist/compat/array/find.mjs

@@ -5,10 +5,10 @@ import { iteratee } from "../util/iteratee.mjs";
 * Finds the first item in an object that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
-* @returns {T | undefined} - The first property value that has the specified property, or `undefined` if no match is found.
+* @param source - The source array or object to search through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [fromIndex=0] - The index to start the search from, defaults to 0.
+* @returns The first property value that has the specified property, or `undefined` if no match is found.
 *
 * @example
 * // Using a property name

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

@@ -5,11 +5,11 @@ import { ListIterateeCustom } from "../_internal/ListIterateeCustom.mjs";
  * Finds the index of the first item in an array that has a specific property, where the property name is provided as a PropertyKey.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
- * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
- * @param {PropertyKey} propertyToCheck - The property name to check for in the items of the array.
- * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
- * @returns {number} - The index of the first item that has the specified property, or `-1` if no match is found.
+ * @param arr - The array to search through.
+ * @param doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
+ * @param propertyToCheck - The property name to check for in the items of the array.
+ * @param [fromIndex=0] - The index to start the search from, defaults to 0.
+ * @returns The index of the first item that has the specified property, or `-1` if no match is found.
  *
  * @example
  * // Using a property name

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

@@ -5,11 +5,11 @@ import { ListIterateeCustom } from "../_internal/ListIterateeCustom.js";
  * Finds the index of the first item in an array that has a specific property, where the property name is provided as a PropertyKey.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
- * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
- * @param {PropertyKey} propertyToCheck - The property name to check for in the items of the array.
- * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
- * @returns {number} - The index of the first item that has the specified property, or `-1` if no match is found.
+ * @param arr - The array to search through.
+ * @param doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
+ * @param propertyToCheck - The property name to check for in the items of the array.
+ * @param [fromIndex=0] - The index to start the search from, defaults to 0.
+ * @returns The index of the first item that has the specified property, or `-1` if no match is found.
  *
  * @example
  * // Using a property name

package/dist/compat/array/findIndex.js

@@ -7,11 +7,11 @@ const require_identity = require("../function/identity.js");
 * Finds the index of the first item in an array that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | null | undefined} arr - The array to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
-* @param {PropertyKey} propertyToCheck - The property name to check for in the items of the array.
-* @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
-* @returns {number} - The index of the first item that has the specified property, or `-1` if no match is found.
+* @param arr - The array to search through.
+* @param doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
+* @param propertyToCheck - The property name to check for in the items of the array.
+* @param [fromIndex=0] - The index to start the search from, defaults to 0.
+* @returns The index of the first item that has the specified property, or `-1` if no match is found.
 *
 * @example
 * // Using a property name

package/dist/compat/array/findIndex.mjs

@@ -7,11 +7,11 @@ import { identity } from "../function/identity.mjs";
 * Finds the index of the first item in an array that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | null | undefined} arr - The array to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
-* @param {PropertyKey} propertyToCheck - The property name to check for in the items of the array.
-* @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
-* @returns {number} - The index of the first item that has the specified property, or `-1` if no match is found.
+* @param arr - The array to search through.
+* @param doesMatch - The criteria to match against the items in the array. This can be a function, a partial object, a key-value pair, or a property name.
+* @param propertyToCheck - The property name to check for in the items of the array.
+* @param [fromIndex=0] - The index to start the search from, defaults to 0.
+* @returns The index of the first item that has the specified property, or `-1` if no match is found.
 *
 * @example
 * // Using a property name

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

@@ -8,10 +8,10 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.mjs";
  * Finds the last element in a collection that satisfies the predicate.
  *
  * @template T, S
- * @param {ArrayLike<T> | null | undefined} collection - The collection to search.
- * @param {ListIteratorTypeGuard<T, S>} predicate - The predicate function with type guard.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {S | undefined} The last element that satisfies the predicate.
+ * @param collection - The collection to search.
+ * @param predicate - The predicate function with type guard.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const users = [{ user: 'barney', age: 36 }, { user: 'fred', age: 40 }, { user: 'pebbles', age: 18 }];
@@ -23,10 +23,10 @@ declare function findLast<T, S extends T>(collection: ArrayLike<T> | null | unde
  * Finds the last element in a collection that satisfies the predicate.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} collection - The collection to search.
- * @param {ListIterateeCustom<T, boolean>} [predicate] - The predicate function, partial object, property-value pair, or property name.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {T | undefined} The last element that satisfies the predicate.
+ * @param collection - The collection to search.
+ * @param [predicate] - The predicate function, partial object, property-value pair, or property name.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const users = [{ user: 'barney', age: 36 }, { user: 'fred', age: 40 }, { user: 'pebbles', age: 18 }];
@@ -47,10 +47,10 @@ declare function findLast<T>(collection: ArrayLike<T> | null | undefined, predic
  * Finds the last element in an object that satisfies the predicate with type guard.
  *
  * @template T, S
- * @param {T | null | undefined} collection - The object to search.
- * @param {ObjectIteratorTypeGuard<T, S>} predicate - The predicate function with type guard.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {S | undefined} The last element that satisfies the predicate.
+ * @param collection - The object to search.
+ * @param predicate - The predicate function with type guard.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const obj = { a: 1, b: 'hello', c: 3 };
@@ -62,10 +62,10 @@ declare function findLast<T extends object, S extends T[keyof T]>(collection: T
  * Finds the last element in an object that satisfies the predicate.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to search.
- * @param {ObjectIterateeCustom<T, boolean>} [predicate] - The predicate function, partial object, property-value pair, or property name.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {T[keyof T] | undefined} The last element that satisfies the predicate.
+ * @param collection - The object to search.
+ * @param [predicate] - The predicate function, partial object, property-value pair, or property name.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const obj = { a: { id: 1, name: 'Alice' }, b: { id: 2 }, c: { id: 3, name: 'Bob' } };

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

@@ -8,10 +8,10 @@ import { ListIteratorTypeGuard } from "../_internal/ListIteratorTypeGuard.js";
  * Finds the last element in a collection that satisfies the predicate.
  *
  * @template T, S
- * @param {ArrayLike<T> | null | undefined} collection - The collection to search.
- * @param {ListIteratorTypeGuard<T, S>} predicate - The predicate function with type guard.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {S | undefined} The last element that satisfies the predicate.
+ * @param collection - The collection to search.
+ * @param predicate - The predicate function with type guard.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const users = [{ user: 'barney', age: 36 }, { user: 'fred', age: 40 }, { user: 'pebbles', age: 18 }];
@@ -23,10 +23,10 @@ declare function findLast<T, S extends T>(collection: ArrayLike<T> | null | unde
  * Finds the last element in a collection that satisfies the predicate.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} collection - The collection to search.
- * @param {ListIterateeCustom<T, boolean>} [predicate] - The predicate function, partial object, property-value pair, or property name.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {T | undefined} The last element that satisfies the predicate.
+ * @param collection - The collection to search.
+ * @param [predicate] - The predicate function, partial object, property-value pair, or property name.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const users = [{ user: 'barney', age: 36 }, { user: 'fred', age: 40 }, { user: 'pebbles', age: 18 }];
@@ -47,10 +47,10 @@ declare function findLast<T>(collection: ArrayLike<T> | null | undefined, predic
  * Finds the last element in an object that satisfies the predicate with type guard.
  *
  * @template T, S
- * @param {T | null | undefined} collection - The object to search.
- * @param {ObjectIteratorTypeGuard<T, S>} predicate - The predicate function with type guard.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {S | undefined} The last element that satisfies the predicate.
+ * @param collection - The object to search.
+ * @param predicate - The predicate function with type guard.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const obj = { a: 1, b: 'hello', c: 3 };
@@ -62,10 +62,10 @@ declare function findLast<T extends object, S extends T[keyof T]>(collection: T
  * Finds the last element in an object that satisfies the predicate.
  *
  * @template T
- * @param {T | null | undefined} collection - The object to search.
- * @param {ObjectIterateeCustom<T, boolean>} [predicate] - The predicate function, partial object, property-value pair, or property name.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {T[keyof T] | undefined} The last element that satisfies the predicate.
+ * @param collection - The object to search.
+ * @param [predicate] - The predicate function, partial object, property-value pair, or property name.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The last element that satisfies the predicate.
  *
  * @example
  * const obj = { a: { id: 1, name: 'Alice' }, b: { id: 2 }, c: { id: 3, name: 'Bob' } };

package/dist/compat/array/findLast.js

@@ -6,10 +6,10 @@ const require_iteratee = require("../util/iteratee.js");
 * Finds the last item in an object that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {number} [fromIndex] - The index to start the search from, defaults to source.length-1 for arrays or Object.keys(source).length-1 for objects.
-* @returns {T | undefined} - The last property value that has the specified property, or `undefined` if no match is found.
+* @param source - The source array or object to search through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [fromIndex] - The index to start the search from, defaults to source.length-1 for arrays or Object.keys(source).length-1 for objects.
+* @returns The last property value that has the specified property, or `undefined` if no match is found.
 *
 * @example
 * // Using a property name

package/dist/compat/array/findLast.mjs

@@ -6,10 +6,10 @@ import { iteratee } from "../util/iteratee.mjs";
 * Finds the last item in an object that has a specific property, where the property name is provided as a PropertyKey.
 *
 * @template T
-* @param {ArrayLike<T> | Record<any, any> | null | undefined} source - The source array or object to search through.
-* @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | PropertyKey} doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
-* @param {number} [fromIndex] - The index to start the search from, defaults to source.length-1 for arrays or Object.keys(source).length-1 for objects.
-* @returns {T | undefined} - The last property value that has the specified property, or `undefined` if no match is found.
+* @param source - The source array or object to search through.
+* @param doesMatch - The criteria to match. It can be a function, a partial object, a key-value pair, or a property name.
+* @param [fromIndex] - The index to start the search from, defaults to source.length-1 for arrays or Object.keys(source).length-1 for objects.
+* @returns The last property value that has the specified property, or `undefined` if no match is found.
 *
 * @example
 * // Using a property name

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

@@ -5,10 +5,10 @@ import { ListIterateeCustom } from "../_internal/ListIterateeCustom.mjs";
  * Finds the index of the last element in the array that satisfies the predicate.
  *
  * @template T
- * @param {ArrayLike<T> | null | undefined} array - The array to search through.
- * @param {ListIterateeCustom<T, boolean>} [predicate] - The predicate function, partial object, property-value pair, or property name.
- * @param {number} [fromIndex] - The index to start searching from.
- * @returns {number} The index of the last matching element, or -1 if not found.
+ * @param array - The array to search through.
+ * @param [predicate] - The predicate function, partial object, property-value pair, or property name.
+ * @param [fromIndex] - The index to start searching from.
+ * @returns The index of the last matching element, or -1 if not found.
  *
  * @example
  * const users = [