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

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

@@ -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 };

package/dist/compat/array/findLastIndex.mjs

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

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

@@ -5,8 +5,7 @@
  * It uses strict equality (`===`) to compare elements.
  *
  * @template T - The type of elements in the array.
- * @template U - The type of the value to search for.
- * @param {T[] | null | undefined} array - The array to search.
+ * @param {ArrayLike<T> | null | undefined} array - The array to search.
  * @param {T} searchElement - The value to search for.
  * @param {number} [fromIndex] - The index to start the search at.
  * @returns {number} The index (zero-based) of the first occurrence of the value in the array, or `-1` if the value is not found.
@@ -16,6 +15,6 @@
  * indexOf(array, 3); // => 2
  * indexOf(array, NaN); // => 3
  */
-declare function indexOf<T>(array: readonly T[] | null | undefined, searchElement: T, fromIndex?: number): number;
+declare function indexOf<T>(array: ArrayLike<T> | null | undefined, searchElement: T, fromIndex?: number): number;
 
 export { indexOf };

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

@@ -5,8 +5,7 @@
  * It uses strict equality (`===`) to compare elements.
  *
  * @template T - The type of elements in the array.
- * @template U - The type of the value to search for.
- * @param {T[] | null | undefined} array - The array to search.
+ * @param {ArrayLike<T> | null | undefined} array - The array to search.
  * @param {T} searchElement - The value to search for.
  * @param {number} [fromIndex] - The index to start the search at.
  * @returns {number} The index (zero-based) of the first occurrence of the value in the array, or `-1` if the value is not found.
@@ -16,6 +15,6 @@
  * indexOf(array, 3); // => 2
  * indexOf(array, NaN); // => 3
  */
-declare function indexOf<T>(array: readonly T[] | null | undefined, searchElement: T, fromIndex?: number): number;
+declare function indexOf<T>(array: ArrayLike<T> | null | undefined, searchElement: T, fromIndex?: number): number;
 
 export { indexOf };

package/dist/compat/array/indexOf.mjs

@@ -1,5 +1,7 @@
+import { isArrayLike } from '../predicate/isArrayLike.mjs';
+
 function indexOf(array, searchElement, fromIndex) {
-    if (array == null) {
+    if (!isArrayLike(array)) {
         return -1;
     }
     if (Number.isNaN(searchElement)) {
@@ -14,7 +16,7 @@ function indexOf(array, searchElement, fromIndex) {
         }
         return -1;
     }
-    return array.indexOf(searchElement, fromIndex);
+    return Array.from(array).indexOf(searchElement, fromIndex);
 }
 
 export { indexOf };

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

@@ -2,7 +2,7 @@
  * Joins elements of an array into a string.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} array - The array to join.
+ * @param {ArrayLike<T> | null | undefined} array - The array to join.
  * @param {string} separator - The separator used to join the elements, default is common separator `,`.
  * @returns {string} - Returns a string containing all elements of the array joined by the specified separator.
  *
@@ -11,6 +11,6 @@
  * const result = join(arr, "~");
  * console.log(result); // Output: "a~b~c"
  */
-declare function join<T>(array: readonly T[], separator?: string): string;
+declare function join<T>(array: ArrayLike<T> | null | undefined, separator?: string): string;
 
 export { join };

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

@@ -2,7 +2,7 @@
  * Joins elements of an array into a string.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} array - The array to join.
+ * @param {ArrayLike<T> | null | undefined} array - The array to join.
  * @param {string} separator - The separator used to join the elements, default is common separator `,`.
  * @returns {string} - Returns a string containing all elements of the array joined by the specified separator.
  *
@@ -11,6 +11,6 @@
  * const result = join(arr, "~");
  * console.log(result); // Output: "a~b~c"
  */
-declare function join<T>(array: readonly T[], separator?: string): string;
+declare function join<T>(array: ArrayLike<T> | null | undefined, separator?: string): string;
 
 export { join };

package/dist/compat/array/join.mjs

@@ -1,5 +1,10 @@
+import { isArrayLike } from '../predicate/isArrayLike.mjs';
+
 function join(array, separator = ',') {
-    return array.join(separator);
+    if (!isArrayLike(array)) {
+        return '';
+    }
+    return Array.from(array).join(separator);
 }
 
 export { join };

package/dist/compat/index.js

@@ -8,7 +8,7 @@ const unary = require('../_chunk/unary-CMvKXy.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 const sumBy = require('../_chunk/sumBy-BkErWJ.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-B5ZVux.js');
+const toMerged = require('../_chunk/toMerged-BLnW4M.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
 const isWeakSet$1 = require('../_chunk/isWeakSet-BuFfzX.js');
 const upperFirst = require('../_chunk/upperFirst-BUECmK.js');
@@ -466,12 +466,9 @@ function identity(x) {
 
 function every(source, doesMatch) {
     if (!source) {
-        source = [];
-    }
-    let values = source;
-    if (!Array.isArray(source)) {
-        values = Object.values(source);
+        return true;
     }
+    const values = Array.isArray(source) ? source : Object.values(source);
     if (!doesMatch) {
         doesMatch = identity;
     }
@@ -506,7 +503,17 @@ function every(source, doesMatch) {
     }
 }
 
-function fill(array, value, start = 0, end = array.length) {
+function isString(value) {
+    return typeof value === 'string' || value instanceof String;
+}
+
+function fill(array, value, start = 0, end = array ? array.length : 0) {
+    if (!isArrayLike(array)) {
+        return [];
+    }
+    if (isString(array)) {
+        return array;
+    }
     start = Math.floor(start);
     end = Math.floor(end);
     if (!start) {
@@ -523,6 +530,9 @@ function isArray(value) {
 }
 
 function filter(source, predicate) {
+    if (!source) {
+        return [];
+    }
     if (!predicate) {
         predicate = identity;
     }
@@ -555,10 +565,10 @@ function filter(source, predicate) {
 }
 
 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)) {
@@ -590,51 +600,65 @@ function find(source, doesMatch) {
     }
 }
 
-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;
 }
 
-function findLastIndex(arr, doesMatch, fromIndex = arr.length - 1) {
+function findLastIndex(arr, doesMatch, fromIndex = arr ? arr.length - 1 : 0) {
+    if (!arr) {
+        return -1;
+    }
     if (fromIndex < 0) {
         fromIndex = Math.max(arr.length + fromIndex, 0);
     }
     else {
         fromIndex = Math.min(fromIndex, arr.length - 1);
     }
-    arr = arr.slice(0, fromIndex + 1);
+    const subArray = Array.from(arr).slice(0, fromIndex + 1);
     switch (typeof doesMatch) {
         case 'function': {
-            return arr.findLastIndex(doesMatch);
+            return subArray.findLastIndex(doesMatch);
         }
         case 'object': {
             if (Array.isArray(doesMatch) && doesMatch.length === 2) {
                 const key = doesMatch[0];
                 const value = doesMatch[1];
-                return arr.findLastIndex(matchesProperty(key, value));
+                return subArray.findLastIndex(matchesProperty(key, value));
             }
             else {
-                return arr.findLastIndex(matches(doesMatch));
+                return subArray.findLastIndex(matches(doesMatch));
             }
         }
         case 'string': {
-            return arr.findLastIndex(property(doesMatch));
+            return subArray.findLastIndex(property(doesMatch));
         }
     }
 }
@@ -683,10 +707,6 @@ function head(arr) {
     return zipWith.head(Array.from(arr));
 }
 
-function isString(value) {
-    return typeof value === 'string' || value instanceof String;
-}
-
 function isSymbol(value) {
     return typeof value === 'symbol' || value instanceof Symbol;
 }
@@ -752,7 +772,7 @@ function includes(source, target, fromIndex, guard) {
 }
 
 function indexOf(array, searchElement, fromIndex) {
-    if (array == null) {
+    if (!isArrayLike(array)) {
         return -1;
     }
     if (Number.isNaN(searchElement)) {
@@ -767,7 +787,7 @@ function indexOf(array, searchElement, fromIndex) {
         }
         return -1;
     }
-    return array.indexOf(searchElement, fromIndex);
+    return Array.from(array).indexOf(searchElement, fromIndex);
 }
 
 function intersection(...arrays) {
@@ -789,7 +809,10 @@ function intersection(...arrays) {
 }
 
 function join(array, separator = ',') {
-    return array.join(separator);
+    if (!isArrayLike(array)) {
+        return '';
+    }
+    return Array.from(array).join(separator);
 }
 
 function last(array) {

package/dist/index.js

@@ -11,7 +11,7 @@ const noop = require('./_chunk/noop-2IwLUk.js');
 const sumBy = require('./_chunk/sumBy-BkErWJ.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
-const toMerged = require('./_chunk/toMerged-B5ZVux.js');
+const toMerged = require('./_chunk/toMerged-BLnW4M.js');
 const object_index = require('./object/index.js');
 const isWeakSet = require('./_chunk/isWeakSet-BuFfzX.js');
 const predicate_index = require('./predicate/index.js');

package/dist/object/cloneDeep.mjs

@@ -104,7 +104,10 @@ function copyProperties(target, source, stack) {
     const keys = [...Object.keys(source), ...getSymbols(source)];
     for (let i = 0; i < keys.length; i++) {
         const key = keys[i];
-        target[key] = cloneDeepImpl(source[key], stack);
+        const descriptor = Object.getOwnPropertyDescriptor(target, key);
+        if (descriptor == null || descriptor.writable) {
+            target[key] = cloneDeepImpl(source[key], stack);
+        }
     }
 }
 

package/dist/object/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const toMerged = require('../_chunk/toMerged-B5ZVux.js');
+const toMerged = require('../_chunk/toMerged-BLnW4M.js');
 
 function mergeWith(target, source, merge) {
     const sourceKeys = Object.keys(source);

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.25.0-dev.791+3ed5a413",
+  "version": "1.25.0-dev.793+2f9740eb",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {