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

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

@@ -0,0 +1,62 @@
+/**
+ * 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 {(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 {number} - The index of the first item that matches the predicate, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a predicate function
+ * const items = [1, 2, 3, 4, 5];
+ * 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;
+/**
+ * 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.
+ * @returns {number} - The index of the first item that matches the partial object, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a partial object
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, { name: 'Bob' });
+ * console.log(result); // 1
+ */
+declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>): 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.
+ * @returns {number} - The index of the first item that has the specified property value, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a property-value pair
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, ['name', 'Alice']);
+ * console.log(result); // 0
+ */
+declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): 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.
+ * @returns {number} - The index of the first item that has the specified property, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a property name
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, 'name');
+ * console.log(result); // 1
+ */
+declare function findLastIndex<T>(arr: readonly T[], propertyToCheck: string): number;
+
+export { findLastIndex };

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

@@ -0,0 +1,62 @@
+/**
+ * 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 {(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 {number} - The index of the first item that matches the predicate, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a predicate function
+ * const items = [1, 2, 3, 4, 5];
+ * 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;
+/**
+ * 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.
+ * @returns {number} - The index of the first item that matches the partial object, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a partial object
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, { name: 'Bob' });
+ * console.log(result); // 1
+ */
+declare function findLastIndex<T>(arr: readonly T[], doesMatch: Partial<T>): 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.
+ * @returns {number} - The index of the first item that has the specified property value, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a property-value pair
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, ['name', 'Alice']);
+ * console.log(result); // 0
+ */
+declare function findLastIndex<T>(arr: readonly T[], doesMatchProperty: [keyof T, unknown]): 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.
+ * @returns {number} - The index of the first item that has the specified property, or `undefined` if no match is found.
+ *
+ * @example
+ * // Using a property name
+ * const items = [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
+ * const result = findLastIndex(items, 'name');
+ * console.log(result); // 1
+ */
+declare function findLastIndex<T>(arr: readonly T[], propertyToCheck: string): number;
+
+export { findLastIndex };

package/dist/compat/array/findLastIndex.mjs

@@ -0,0 +1,26 @@
+import { property } from '../object/property.mjs';
+import { matches } from '../predicate/matches.mjs';
+import { matchesProperty } from '../predicate/matchesProperty.mjs';
+
+function findLastIndex(source, doesMatch) {
+    switch (typeof doesMatch) {
+        case 'function': {
+            return source.findLastIndex(doesMatch);
+        }
+        case 'object': {
+            if (Array.isArray(doesMatch) && doesMatch.length === 2) {
+                const key = doesMatch[0];
+                const value = doesMatch[1];
+                return source.findLastIndex(matchesProperty(key, value));
+            }
+            else {
+                return source.findLastIndex(matches(doesMatch));
+            }
+        }
+        case 'string': {
+            return source.findLastIndex(property(doesMatch));
+        }
+    }
+}
+
+export { findLastIndex };

package/dist/compat/index.d.mts

@@ -111,6 +111,7 @@ export { difference } from './array/difference.mjs';
 export { fill } from './array/fill.mjs';
 export { find } from './array/find.mjs';
 export { findIndex } from './array/findIndex.mjs';
+export { findLastIndex } from './array/findLastIndex.mjs';
 export { flatten } from './array/flatten.mjs';
 export { flattenDeep } from './array/flattenDeep.mjs';
 export { flattenDepth } from './array/flattenDepth.mjs';

package/dist/compat/index.d.ts

@@ -111,6 +111,7 @@ export { difference } from './array/difference.js';
 export { fill } from './array/fill.js';
 export { find } from './array/find.js';
 export { findIndex } from './array/findIndex.js';
+export { findLastIndex } from './array/findLastIndex.js';
 export { flatten } from './array/flatten.js';
 export { flattenDeep } from './array/flattenDeep.js';
 export { flattenDepth } from './array/flattenDepth.js';

package/dist/compat/index.js

@@ -397,6 +397,27 @@ function findIndex(source, doesMatch) {
     }
 }
 
+function findLastIndex(source, doesMatch) {
+    switch (typeof doesMatch) {
+        case 'function': {
+            return source.findLastIndex(doesMatch);
+        }
+        case 'object': {
+            if (Array.isArray(doesMatch) && doesMatch.length === 2) {
+                const key = doesMatch[0];
+                const value = doesMatch[1];
+                return source.findLastIndex(matchesProperty(key, value));
+            }
+            else {
+                return source.findLastIndex(matches(doesMatch));
+            }
+        }
+        case 'string': {
+            return source.findLastIndex(property(doesMatch));
+        }
+    }
+}
+
 function flatten(value, depth = 1) {
     const result = [];
     const flooredDepth = Math.floor(depth);
@@ -1141,6 +1162,7 @@ exports.endsWith = endsWith;
 exports.fill = fill;
 exports.find = find;
 exports.findIndex = findIndex;
+exports.findLastIndex = findLastIndex;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
 exports.flattenDepth = flattenDepth;

package/dist/compat/index.mjs

@@ -112,6 +112,7 @@ export { difference } from './array/difference.mjs';
 export { fill } from './array/fill.mjs';
 export { find } from './array/find.mjs';
 export { findIndex } from './array/findIndex.mjs';
+export { findLastIndex } from './array/findLastIndex.mjs';
 export { flatten } from './array/flatten.mjs';
 export { flattenDeep } from './array/flattenDeep.mjs';
 export { flattenDepth } from './array/flattenDepth.mjs';

package/dist/string/deburr.mjs

@@ -1,4 +1,4 @@
-const deburrMap = {
+const deburrMap = new Map(Object.entries({
     Æ: 'Ae',
     Ð: 'D',
     Ø: 'O',
@@ -28,18 +28,18 @@ const deburrMap = {
     Ŧ: 'T',
     ŧ: 't',
     ſ: 's',
-};
+}));
 function deburr(str) {
     str = str.normalize('NFD');
-    const result = [];
+    let result = '';
     for (let i = 0; i < str.length; i++) {
         const char = str[i];
         if ((char >= '\u0300' && char <= '\u036f') || (char >= '\ufe20' && char <= '\ufe23')) {
             continue;
         }
-        result.push(deburrMap[char] ?? char);
+        result += deburrMap.get(char) ?? char;
     }
-    return result.join('');
+    return result;
 }
 
 export { deburr };

package/dist/string/index.js

@@ -65,7 +65,7 @@ function lowerFirst(str) {
     return str.substring(0, 1).toLowerCase() + str.substring(1);
 }
 
-const deburrMap = {
+const deburrMap = new Map(Object.entries({
     Æ: 'Ae',
     Ð: 'D',
     Ø: 'O',
@@ -95,18 +95,18 @@ const deburrMap = {
     Ŧ: 'T',
     ŧ: 't',
     ſ: 's',
-};
+}));
 function deburr(str) {
     str = str.normalize('NFD');
-    const result = [];
+    let result = '';
     for (let i = 0; i < str.length; i++) {
         const char = str[i];
         if ((char >= '\u0300' && char <= '\u036f') || (char >= '\ufe20' && char <= '\ufe23')) {
             continue;
         }
-        result.push(deburrMap[char] ?? char);
+        result += deburrMap.get(char) ?? char;
     }
-    return result.join('');
+    return result;
 }
 
 const htmlEscapes = {

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.564+e264ed6c",
+  "version": "1.17.0-dev.566+851755cd",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {