es-toolkit 1.17.0-dev.566 → 1.17.0-dev.567

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

@@ -4,6 +4,7 @@
  * @template T
  * @param {T[]} 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.
  *
  * @example
@@ -12,13 +13,14 @@
  * 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): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {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.
  *
  * @example
@@ -27,13 +29,14 @@ 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>): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {[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.
  *
  * @example
@@ -42,13 +45,14 @@ declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>): num
  * const result = findLastIndex(items, ['name', 'Alice']);
  * console.log(result); // 0
  */
-declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {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.
  *
  * @example
@@ -57,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): number;
+declare function findLastIndex<T>(arr: readonly T[], propertyToCheck: string, fromIndex?: number): number;
 
 export { findLastIndex };

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

@@ -4,6 +4,7 @@
  * @template T
  * @param {T[]} 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.
  *
  * @example
@@ -12,13 +13,14 @@
  * 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): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {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.
  *
  * @example
@@ -27,13 +29,14 @@ 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>): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {[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.
  *
  * @example
@@ -42,13 +45,14 @@ declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>): num
  * const result = findLastIndex(items, ['name', 'Alice']);
  * console.log(result); // 0
  */
-declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): number;
+declare function findLastIndex<T>(arr: readonly T[], 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 {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.
  *
  * @example
@@ -57,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): number;
+declare function findLastIndex<T>(arr: readonly T[], propertyToCheck: string, fromIndex?: number): number;
 
 export { findLastIndex };

package/dist/compat/array/findLastIndex.mjs

@@ -2,7 +2,14 @@ import { property } from '../object/property.mjs';
 import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
-function findLastIndex(source, doesMatch) {
+function findLastIndex(source, doesMatch, fromIndex = source.length - 1) {
+    if (fromIndex < 0) {
+        fromIndex = Math.max(source.length + fromIndex, 0);
+    }
+    else {
+        fromIndex = Math.min(fromIndex, source.length - 1);
+    }
+    source = source.slice(0, fromIndex + 1);
     switch (typeof doesMatch) {
         case 'function': {
             return source.findLastIndex(doesMatch);

package/dist/compat/index.js

@@ -397,7 +397,14 @@ function findIndex(source, doesMatch) {
     }
 }
 
-function findLastIndex(source, doesMatch) {
+function findLastIndex(source, doesMatch, fromIndex = source.length - 1) {
+    if (fromIndex < 0) {
+        fromIndex = Math.max(source.length + fromIndex, 0);
+    }
+    else {
+        fromIndex = Math.min(fromIndex, source.length - 1);
+    }
+    source = source.slice(0, fromIndex + 1);
     switch (typeof doesMatch) {
         case 'function': {
             return source.findLastIndex(doesMatch);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.17.0-dev.566+851755cd",
+  "version": "1.17.0-dev.567+5d4b59e8",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {