es-toolkit 1.25.0-dev.791 → 1.25.0-dev.792

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

@@ -2,7 +2,7 @@
  * Filters items from a array and returns an array of elements.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - The function invoked per iteration.
  * @returns {T[]} - Returns a new array of elements that satisfy the given doesMatch function.
  *
@@ -10,12 +10,12 @@
  * filter([1, 2, 3], n => n % 2 === 0)
  * // => [2]
  */
-declare function filter<T>(arr: readonly T[], doesMatch?: (item: T, index: number, arr: readonly T[]) => unknown): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatch?: (item: T, index: number, arr: readonly T[]) => unknown): T[];
 /**
  * Filters elements in a arr that match the properties of the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {T[]} - Returns a new array of elements that match the given properties.
  *
@@ -24,12 +24,12 @@ declare function filter<T>(arr: readonly T[], doesMatch?: (item: T, index: numbe
  * filter(arr, { name: 'Bob' });
  * // => [{ id: 2, name: 'Bob' }]
  */
-declare function filter<T>(arr: readonly T[], doesMatch: Partial<T>): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): T[];
 /**
  * Filters elements in a arr that match the given key-value pair.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
@@ -38,12 +38,12 @@ declare function filter<T>(arr: readonly T[], doesMatch: Partial<T>): T[];
  * filter(arr, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
 /**
  * Filters the arr, returning elements that contain the given property name.
  *
  * @template T
- * @param {T[]} arr - The array to iterate over.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to iterate over.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T[]} - Returns a new array of elements that match the given property name.
  *
@@ -52,7 +52,7 @@ declare function filter<T>(arr: readonly T[], doesMatchProperty: [keyof T, unkno
  * filter(arr, 'name');
  * // => [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
  */
-declare function filter<T>(arr: readonly T[], propertyToCheck: string): T[];
+declare function filter<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): T[];
 /**
  * Filters items from a object and returns an array of elements that match the given predicate function.
  *
@@ -70,12 +70,12 @@ declare function filter<T>(arr: readonly T[], propertyToCheck: string): T[];
  * filter(obj, value => value > 2)
  * // => [3]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): T[];
 /**
  * Filters elements in a object that match the properties of the given partial object.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {Partial<T[keyof T]>} doesMatch - The partial object to match
  * @returns {T[]} - Returns a new array of elements that match the given properties.pair.
  *
@@ -84,12 +84,12 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatch:
  * filter(obj, { name: 'Bob' });
  * // => [{ id: 2, name: 'Bob' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): T[];
 /**
  * Filters elements in a arr that match the given key-value pair.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {[keyof T, unknown]} doesMatchProperty - The key-value pair to match.
  * @returns {T[]} - Returns a new array of elements that match the given key-value pair.
  *
@@ -98,12 +98,12 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatch:
  * filter(obj, ['name', 'Alice']);
  * // => [{ id: 1, name: 'Alice' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T[];
 /**
  * Filters the object, returning elements that contain the given property name.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T[]} - Returns a new array of elements that match the given property name.
  *
@@ -112,6 +112,6 @@ declare function filter<T extends Record<string, unknown>>(object: T, doesMatchP
  * filter(obj, 'name');
  * // => [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]
  */
-declare function filter<T extends Record<string, unknown>>(object: T, propertyToCheck: string): T[];
+declare function filter<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): T[];
 
 export { filter };

package/dist/compat/array/filter.mjs

@@ -5,6 +5,9 @@ import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
 function filter(source, predicate) {
+    if (!source) {
+        return [];
+    }
     if (!predicate) {
         predicate = identity;
     }

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

@@ -2,7 +2,7 @@
  * Finds the first item in an array that matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
  * @returns {T | undefined} - The first item that matches the predicate, or `undefined` if no match is found.
  *
@@ -12,12 +12,12 @@
  * const result = find(items, (item) => item > 3);
  * console.log(result); // 4
  */
-declare function find<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): T | undefined;
 /**
  * Finds the first item in an array that matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {T | undefined} - The first item that matches the partial object, or `undefined` if no match is found.
  *
@@ -27,12 +27,12 @@ declare function find<T>(arr: readonly T[], doesMatch: (item: T, index: number,
  * const result = find(items, { name: 'Bob' });
  * console.log(result); // { id: 2, name: 'Bob' }
  */
-declare function find<T>(arr: readonly T[], doesMatch: Partial<T>): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): T | undefined;
 /**
  * Finds the first item in an array that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
@@ -42,12 +42,12 @@ declare function find<T>(arr: readonly T[], doesMatch: Partial<T>): T | undefine
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
 /**
  * Finds the first item in an array that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T | undefined} - The first item that has the specified property, or `undefined` if no match is found.
  *
@@ -57,12 +57,12 @@ declare function find<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown
  * const result = find(items, 'name');
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T>(arr: readonly T[], propertyToCheck: string): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): T | undefined;
 /**
  * Finds the first item in an object that matches the given predicate function.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {(item: T[keyof T], index: number, arr: T) => unknown} doesMatch - A function that takes an item, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {T | undefined} - The first property value that matches the predicate, or `undefined` if no match is found.
  *
@@ -72,12 +72,12 @@ declare function find<T>(arr: readonly T[], propertyToCheck: string): T | undefi
  * const result = find(obj, (item) => item > 2);
  * console.log(result); // 3
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatch: (item: T[keyof T], index: keyof T, object: T) => unknown): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (item: T[keyof T], index: keyof T, object: T) => unknown): T | undefined;
 /**
  * Finds the first item in an object that matches the given partial value.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {Partial<T[keyof T]>} doesMatch - A partial value to match against the values of the object.
  * @returns {T | undefined} - The first property value that matches the partial value, or `undefined` if no match is found.
  *
@@ -87,12 +87,12 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatch: (
  * const result = find(obj, { name: 'Bob' });
  * console.log(result); // { id: 2, name: 'Bob' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): T | undefined;
 /**
  * Finds the first item in an object that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
@@ -102,12 +102,12 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatch: P
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
 /**
  * Finds the first item in an object that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T | undefined} - The first property value that has the specified property, or `undefined` if no match is found.
  *
@@ -117,6 +117,6 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatchPro
  * const result = find(obj, 'name');
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, propertyToCheck: string): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): T | undefined;
 
 export { find };

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

@@ -2,7 +2,7 @@
  * Finds the first item in an array that matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
  * @returns {T | undefined} - The first item that matches the predicate, or `undefined` if no match is found.
  *
@@ -12,12 +12,12 @@
  * const result = find(items, (item) => item > 3);
  * console.log(result); // 4
  */
-declare function find<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): T | undefined;
 /**
  * Finds the first item in an array that matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @returns {T | undefined} - The first item that matches the partial object, or `undefined` if no match is found.
  *
@@ -27,12 +27,12 @@ declare function find<T>(arr: readonly T[], doesMatch: (item: T, index: number,
  * const result = find(items, { name: 'Bob' });
  * console.log(result); // { id: 2, name: 'Bob' }
  */
-declare function find<T>(arr: readonly T[], doesMatch: Partial<T>): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): T | undefined;
 /**
  * Finds the first item in an array that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
@@ -42,12 +42,12 @@ declare function find<T>(arr: readonly T[], doesMatch: Partial<T>): T | undefine
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
 /**
  * Finds the first item in an array that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T | undefined} - The first item that has the specified property, or `undefined` if no match is found.
  *
@@ -57,12 +57,12 @@ declare function find<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown
  * const result = find(items, 'name');
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T>(arr: readonly T[], propertyToCheck: string): T | undefined;
+declare function find<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): T | undefined;
 /**
  * Finds the first item in an object that matches the given predicate function.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {(item: T[keyof T], index: number, arr: T) => unknown} doesMatch - A function that takes an item, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {T | undefined} - The first property value that matches the predicate, or `undefined` if no match is found.
  *
@@ -72,12 +72,12 @@ declare function find<T>(arr: readonly T[], propertyToCheck: string): T | undefi
  * const result = find(obj, (item) => item > 2);
  * console.log(result); // 3
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatch: (item: T[keyof T], index: keyof T, object: T) => unknown): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (item: T[keyof T], index: keyof T, object: T) => unknown): T | undefined;
 /**
  * Finds the first item in an object that matches the given partial value.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {Partial<T[keyof T]>} doesMatch - A partial value to match against the values of the object.
  * @returns {T | undefined} - The first property value that matches the partial value, or `undefined` if no match is found.
  *
@@ -87,12 +87,12 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatch: (
  * const result = find(obj, { name: 'Bob' });
  * console.log(result); // { id: 2, name: 'Bob' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatch: Partial<T[keyof T]>): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): T | undefined;
 /**
  * Finds the first item in an object that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @returns {T | undefined} - The first item that has the specified property value, or `undefined` if no match is found.
  *
@@ -102,12 +102,12 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatch: P
  * const result = find(items, ['name', 'Alice']);
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, doesMatchProperty: [keyof T, unknown]): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T, unknown]): T | undefined;
 /**
  * Finds the first item in an object that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {T extends Record<string, unknown> ? T : never} object - The object to search through.
+ * @param {T extends Record<string, unknown> ? T | null | undefined: never} object - The object to search through.
  * @param {string} propertyToCheck - The property name to check.
  * @returns {T | undefined} - The first property value that has the specified property, or `undefined` if no match is found.
  *
@@ -117,6 +117,6 @@ declare function find<T extends Record<string, unknown>>(object: T, doesMatchPro
  * const result = find(obj, 'name');
  * console.log(result); // { id: 1, name: 'Alice' }
  */
-declare function find<T extends Record<string, unknown>>(object: T, propertyToCheck: string): T | undefined;
+declare function find<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): T | undefined;
 
 export { find };

package/dist/compat/array/find.mjs

@@ -3,10 +3,10 @@ import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
 function find(source, doesMatch) {
-    let values = source;
-    if (!Array.isArray(source)) {
-        values = Object.values(source);
+    if (!source) {
+        return undefined;
     }
+    const values = Array.isArray(source) ? source : Object.values(source);
     switch (typeof doesMatch) {
         case 'function': {
             if (!Array.isArray(source)) {

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

@@ -2,8 +2,9 @@
  * Finds the index of the first item in an array that matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
+ * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
  * @returns {number} - The index of the first item that matches the predicate, or `undefined` if no match is found.
  *
  * @example
@@ -12,13 +13,14 @@
  * const result = find(items, (item) => item > 3);
  * console.log(result); // 4
  */
-declare function findIndex<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
+ * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
  * @returns {number} - The index of the first item that matches the partial object, or `undefined` if no match is found.
  *
  * @example
@@ -27,13 +29,14 @@ declare function findIndex<T>(arr: readonly T[], doesMatch: (item: T, index: num
  * const result = findIndex(items, { name: 'Bob' });
  * console.log(result); // 1
  */
-declare function findIndex<T>(arr: readonly T[], doesMatch: Partial<T>): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @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 value, or `undefined` if no match is found.
  *
  * @example
@@ -42,13 +45,14 @@ declare function findIndex<T>(arr: readonly T[], doesMatch: Partial<T>): number;
  * const result = findIndex(items, ['name', 'Alice']);
  * console.log(result); // 0
  */
-declare function findIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown], fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {string} propertyToCheck - The property name to check.
+ * @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 `undefined` if no match is found.
  *
  * @example
@@ -57,6 +61,6 @@ declare function findIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, un
  * const result = findIndex(items, 'name');
  * console.log(result); // 0
  */
-declare function findIndex<T>(arr: readonly T[], propertyToCheck: string): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string, fromIndex?: number): number;
 
 export { findIndex };

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

@@ -2,8 +2,9 @@
  * Finds the index of the first item in an array that matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
+ * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
  * @returns {number} - The index of the first item that matches the predicate, or `undefined` if no match is found.
  *
  * @example
@@ -12,13 +13,14 @@
  * const result = find(items, (item) => item > 3);
  * console.log(result); // 4
  */
-declare function findIndex<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches the given partial object.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
+ * @param {number} [fromIndex=0] - The index to start the search from, defaults to 0.
  * @returns {number} - The index of the first item that matches the partial object, or `undefined` if no match is found.
  *
  * @example
@@ -27,13 +29,14 @@ declare function findIndex<T>(arr: readonly T[], doesMatch: (item: T, index: num
  * const result = findIndex(items, { name: 'Bob' });
  * console.log(result); // 1
  */
-declare function findIndex<T>(arr: readonly T[], doesMatch: Partial<T>): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
+ * @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 value, or `undefined` if no match is found.
  *
  * @example
@@ -42,13 +45,14 @@ declare function findIndex<T>(arr: readonly T[], doesMatch: Partial<T>): number;
  * const result = findIndex(items, ['name', 'Alice']);
  * console.log(result); // 0
  */
-declare function findIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown], fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {string} propertyToCheck - The property name to check.
+ * @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 `undefined` if no match is found.
  *
  * @example
@@ -57,6 +61,6 @@ declare function findIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, un
  * const result = findIndex(items, 'name');
  * console.log(result); // 0
  */
-declare function findIndex<T>(arr: readonly T[], propertyToCheck: string): number;
+declare function findIndex<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string, fromIndex?: number): number;
 
 export { findIndex };

package/dist/compat/array/findIndex.mjs

@@ -2,25 +2,36 @@ import { property } from '../object/property.mjs';
 import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
-function findIndex(source, doesMatch) {
+function findIndex(arr, doesMatch, fromIndex = 0) {
+    if (!arr) {
+        return -1;
+    }
+    if (fromIndex < 0) {
+        fromIndex = Math.max(arr.length + fromIndex, 0);
+    }
+    const subArray = Array.from(arr).slice(fromIndex);
+    let index = -1;
     switch (typeof doesMatch) {
         case 'function': {
-            return source.findIndex(doesMatch);
+            index = subArray.findIndex(doesMatch);
+            break;
         }
         case 'object': {
             if (Array.isArray(doesMatch) && doesMatch.length === 2) {
                 const key = doesMatch[0];
                 const value = doesMatch[1];
-                return source.findIndex(matchesProperty(key, value));
+                index = subArray.findIndex(matchesProperty(key, value));
             }
             else {
-                return source.findIndex(matches(doesMatch));
+                index = subArray.findIndex(matches(doesMatch));
             }
+            break;
         }
         case 'string': {
-            return source.findIndex(property(doesMatch));
+            index = subArray.findIndex(property(doesMatch));
         }
     }
+    return index === -1 ? -1 : index + fromIndex;
 }
 
 export { findIndex };

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

@@ -2,7 +2,7 @@
  * Iterates through an array in reverse order and returns the index of the first item that matches the given predicate function.
  *
  * @template T
- * @param {T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {(item: T, index: number, arr: T[]) => unknown} doesMatch - A function that takes an item, its index, and the array, and returns a truthy value if the item matches the criteria.
  * @param {number} [fromIndex=arr.length - 1] - The index to start the search from, defaults to the last index of the array.
  * @returns {number} - The index of the first item that matches the predicate, or `undefined` if no match is found.
@@ -13,12 +13,12 @@
  * const result = findLastIndex(items, (item) => item > 3)
  * console.log(result); // 4
  */
-declare function findLastIndex<T>(arr: readonly T[], doesMatch: (item: T, index: number, arr: readonly T[]) => unknown, fromIndex?: number): number;
+declare function findLastIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: (item: T, index: number, arr: readonly T[]) => unknown, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches the given partial object.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {Partial<T>} doesMatch - A partial object that specifies the properties to match.
  * @param {number} [fromIndex=arr.length - 1] - The index to start the search from, defaults to the last index of the array.
  * @returns {number} - The index of the first item that matches the partial object, or `undefined` if no match is found.
@@ -29,12 +29,12 @@ declare function findLastIndex<T>(arr: readonly T[], doesMatch: (item: T, index:
  * const result = findLastIndex(items, { name: 'Bob' });
  * console.log(result); // 1
  */
-declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>, fromIndex?: number): number;
+declare function findLastIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>, fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that matches a property with a specific value.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {[keyof T, unknown]} doesMatchProperty - An array where the first element is the property key and the second element is the value to match.
  * @param {number} [fromIndex=arr.length - 1] - The index to start the search from, defaults to the last index of the array.
  * @returns {number} - The index of the first item that has the specified property value, or `undefined` if no match is found.
@@ -45,12 +45,12 @@ declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>, from
  * const result = findLastIndex(items, ['name', 'Alice']);
  * console.log(result); // 0
  */
-declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown], fromIndex?: number): number;
+declare function findLastIndex<T>(arr: ArrayLike<T> | null | undefined, doesMatchProperty: [keyof T, unknown], fromIndex?: number): number;
 /**
  * Finds the index of the first item in an array that has a specific property, where the property name is provided as a string.
  *
  * @template T
- * @param {readonly T[]} arr - The array to search through.
+ * @param {ArrayLike<T> | null | undefined} arr - The array to search through.
  * @param {string} propertyToCheck - The property name to check.
  * @param {number} [fromIndex=arr.length - 1] - The index to start the search from, defaults to the last index of the array.
  * @returns {number} - The index of the first item that has the specified property, or `undefined` if no match is found.
@@ -61,6 +61,6 @@ declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T
  * const result = findLastIndex(items, 'name');
  * console.log(result); // 1
  */
-declare function findLastIndex<T>(arr: readonly T[], propertyToCheck: string, fromIndex?: number): number;
+declare function findLastIndex<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string, fromIndex?: number): number;
 
 export { findLastIndex };