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

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.d.mts

@@ -142,6 +142,7 @@ export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';
 export { isArrayLike } from './predicate/isArrayLike.mjs';
 export { isSymbol } from './predicate/isSymbol.mjs';
+export { isObject } from './predicate/isObject.mjs';
 export { isObjectLike } from './predicate/isObjectLike.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
 export { isTypedArray } from './predicate/isTypedArray.mjs';

package/dist/compat/index.d.ts

@@ -142,6 +142,7 @@ export { isArray } from './predicate/isArray.js';
 export { isArguments } from './predicate/isArguments.js';
 export { isArrayLike } from './predicate/isArrayLike.js';
 export { isSymbol } from './predicate/isSymbol.js';
+export { isObject } from './predicate/isObject.js';
 export { isObjectLike } from './predicate/isObjectLike.js';
 export { isBoolean } from './predicate/isBoolean.js';
 export { isTypedArray } from './predicate/isTypedArray.js';

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);
@@ -920,6 +927,11 @@ function isArray(value) {
     return Array.isArray(value);
 }
 
+function isObject(value) {
+    const type = typeof value;
+    return value !== null && (type === 'object' || type === 'function');
+}
+
 function isBoolean(x) {
     if (x === true || x === false) {
         return true;
@@ -1175,6 +1187,7 @@ exports.isArray = isArray;
 exports.isArrayLike = isArrayLike;
 exports.isBoolean = isBoolean;
 exports.isMatch = isMatch;
+exports.isObject = isObject;
 exports.isPlainObject = isPlainObject;
 exports.isRegExp = isRegExp;
 exports.isString = isString;

package/dist/compat/index.mjs

@@ -143,6 +143,7 @@ export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';
 export { isArrayLike } from './predicate/isArrayLike.mjs';
 export { isSymbol } from './predicate/isSymbol.mjs';
+export { isObject } from './predicate/isObject.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
 export { isTypedArray } from './predicate/isTypedArray.mjs';
 export { isMatch } from './predicate/isMatch.mjs';

package/dist/compat/predicate/isObject.d.mts

@@ -0,0 +1,26 @@
+/**
+ * Checks if the given value is the language type of Object.
+ * https://262.ecma-international.org/7.0/#sec-ecmascript-language-types
+ *
+ * This function tests whether the provided value is an object or not.
+ * It returns `true` if the value is an object, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to an object value.
+ *
+ * @param {unknown} value - The value to check if it is an object.
+ * @returns {value is object} `true` if the value is the language type of Object, `false` otherwise.
+ *
+ * @example
+ * const value1 = {};
+ * const value2 = [1, 2, 3];
+ * const value3 = () => {};
+ * const value4 = null;
+ *
+ * console.log(isArray(value1)); // true
+ * console.log(isArray(value2)); // true
+ * console.log(isArray(value3)); // true
+ * console.log(isArray(value4)); // false
+ */
+declare function isObject(value: unknown): value is object;
+
+export { isObject };

package/dist/compat/predicate/isObject.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Checks if the given value is the language type of Object.
+ * https://262.ecma-international.org/7.0/#sec-ecmascript-language-types
+ *
+ * This function tests whether the provided value is an object or not.
+ * It returns `true` if the value is an object, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to an object value.
+ *
+ * @param {unknown} value - The value to check if it is an object.
+ * @returns {value is object} `true` if the value is the language type of Object, `false` otherwise.
+ *
+ * @example
+ * const value1 = {};
+ * const value2 = [1, 2, 3];
+ * const value3 = () => {};
+ * const value4 = null;
+ *
+ * console.log(isArray(value1)); // true
+ * console.log(isArray(value2)); // true
+ * console.log(isArray(value3)); // true
+ * console.log(isArray(value4)); // false
+ */
+declare function isObject(value: unknown): value is object;
+
+export { isObject };

package/dist/compat/predicate/isObject.mjs

@@ -0,0 +1,6 @@
+function isObject(value) {
+    const type = typeof value;
+    return value !== null && (type === 'object' || type === 'function');
+}
+
+export { isObject };

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.568+40c9ab92",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {