es-toolkit 1.25.2-dev.803 → 1.25.2-dev.805

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

@@ -57,7 +57,7 @@ declare function filter<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck
  * Filters items from a object and returns an array of elements that match the given predicate function.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch - The function invoked per iteration.
  * @returns {T[]} - Returns a new array of elements that satisfy the given predicate function.
  *

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

@@ -57,7 +57,7 @@ declare function filter<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck
  * Filters items from a object and returns an array of elements that match the given predicate function.
  *
  * @template T
- * @param {T} object - The object to iterate over.
+ * @param {T | null | undefined} object - The object to iterate over.
  * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch - The function invoked per iteration.
  * @returns {T[]} - Returns a new array of elements that satisfy the given predicate function.
  *

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

@@ -1,30 +1,33 @@
 /**
  * Checks if there is an element in an array that is truthy.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @returns {boolean} Returns `true` if any element is truthy, else `false`.
  *
  * @example
  * some([1, 2, 3, 4]);
  * // => true
  */
-declare function some<T>(arr: readonly T[]): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined): boolean;
 /**
  * Checks if there is an element in an array that matches the given predicate function.
  *
- * @param {T[]} arr The array to iterate over.
- * @param {(item: T, index: number, arr: any) => unknown} predicate The function invoked per iteration.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
+ * @param {(item: T, index: number, arr: readonly T[]) => unknown} predicate The function invoked per iteration.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example
  * some([1, 2, 3, 4], n => n % 2 === 0);
  * // => true
  */
-declare function some<T>(arr: readonly T[], predicate: (item: T, index: number, arr: any) => unknown): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, predicate: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
 /**
  * Checks if there is an element in an array that matches the given key-value pair.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {[keyof T, unknown]} predicate The key-value pair to match.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
@@ -32,11 +35,12 @@ declare function some<T>(arr: readonly T[], predicate: (item: T, index: number,
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
  * // => true
  */
-declare function some<T>(arr: readonly T[], predicate: [keyof T, unknown]): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, predicate: [keyof T, unknown]): boolean;
 /**
  * Checks if there is an element in an array that has a truthy value for the given property name.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {string} propertyToCheck The property name to check.
  * @returns {boolean} Returns `true` if any element has a truthy value for the property, else `false`.
  *
@@ -44,11 +48,12 @@ declare function some<T>(arr: readonly T[], predicate: [keyof T, unknown]): bool
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], 'a');
  * // => true
  */
-declare function some<T>(arr: readonly T[], propertyToCheck: string): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): boolean;
 /**
  * Checks if there is an element in an array that matches the given partial object.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {Partial<T>} doesMatch The partial object to match.
  * @returns {boolean} Returns `true` if any element matches the partial object, else `false`.
  *
@@ -56,30 +61,77 @@ declare function some<T>(arr: readonly T[], propertyToCheck: string): boolean;
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], { a: 2 });
  * // => true
  */
-declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): boolean;
 /**
- * Checks if there is an element in an array that matches the given predicate.
  *
- * Iteration is stopped once there is an element that matches `predicate`.
+ * Checks if there is an element in an object that matches the given predicate function.
  *
- * @param {T[]} arr The array to iterate over.
- * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string} [predicate=identity] The function invoked per iteration.
- * If a property name or an object is provided it will be used to create a predicate function.
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @returns {boolean} Returns `true` if any element is truthy, else `false`.
+ *
+ * @example
+ * some({ a: 1, b: 2, c: 3 });
+ * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined): boolean;
+/**
+ *
+ * Checks if there is an element in an object that matches the given predicate function.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch A function that takes an value, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example
- * some([1, 2, 3, 4], n => n % 2 === 0);
+ * some({ a: 1, b: 2, c: 3 }, n => n % 2 === 0);
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], { a: 2 });
+ * Checks if there is an element in an object that matches the given partial value.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {Partial<T[keyof T]>} doesMatch A partial value to match against the values of the object.
+ * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * some({ a: { id: 1, name: 'Alice' }, b: { id: 2, name: 'Bob' } }, { name: 'Bob' });
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
+ * Checks if there is an element in an object that matches a property with a specific value.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @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 {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * const obj = { alice: { id: 1, name: 'Alice' }, bob: { id: 2, name: 'Bob' } };
+ * const result = some(obj, ['name', 'Alice']);
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], 'a');
+ * Checks if there is an element in an object that has a specific property, where the property name is provided as a string.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {string} propertyToCheck The property name to check.
+ * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * const obj = { alice: { id: 1, name: 'Alice' }, bob: { id: 2, name: 'Bob' } };
+ * const result = some(obj, 'name');
  * // => true
  */
-declare function some<T>(arr: readonly T[] | null | undefined, predicate?: ((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string, guard?: unknown): boolean;
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): boolean;
 
 export { some };

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

@@ -1,30 +1,33 @@
 /**
  * Checks if there is an element in an array that is truthy.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @returns {boolean} Returns `true` if any element is truthy, else `false`.
  *
  * @example
  * some([1, 2, 3, 4]);
  * // => true
  */
-declare function some<T>(arr: readonly T[]): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined): boolean;
 /**
  * Checks if there is an element in an array that matches the given predicate function.
  *
- * @param {T[]} arr The array to iterate over.
- * @param {(item: T, index: number, arr: any) => unknown} predicate The function invoked per iteration.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
+ * @param {(item: T, index: number, arr: readonly T[]) => unknown} predicate The function invoked per iteration.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example
  * some([1, 2, 3, 4], n => n % 2 === 0);
  * // => true
  */
-declare function some<T>(arr: readonly T[], predicate: (item: T, index: number, arr: any) => unknown): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, predicate: (item: T, index: number, arr: readonly T[]) => unknown): boolean;
 /**
  * Checks if there is an element in an array that matches the given key-value pair.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {[keyof T, unknown]} predicate The key-value pair to match.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
@@ -32,11 +35,12 @@ declare function some<T>(arr: readonly T[], predicate: (item: T, index: number,
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
  * // => true
  */
-declare function some<T>(arr: readonly T[], predicate: [keyof T, unknown]): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, predicate: [keyof T, unknown]): boolean;
 /**
  * Checks if there is an element in an array that has a truthy value for the given property name.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {string} propertyToCheck The property name to check.
  * @returns {boolean} Returns `true` if any element has a truthy value for the property, else `false`.
  *
@@ -44,11 +48,12 @@ declare function some<T>(arr: readonly T[], predicate: [keyof T, unknown]): bool
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], 'a');
  * // => true
  */
-declare function some<T>(arr: readonly T[], propertyToCheck: string): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, propertyToCheck: string): boolean;
 /**
  * Checks if there is an element in an array that matches the given partial object.
  *
- * @param {T[]} arr The array to iterate over.
+ * @template T
+ * @param {ArrayLike<T> | null | undefined} arr The array to iterate over.
  * @param {Partial<T>} doesMatch The partial object to match.
  * @returns {boolean} Returns `true` if any element matches the partial object, else `false`.
  *
@@ -56,30 +61,77 @@ declare function some<T>(arr: readonly T[], propertyToCheck: string): boolean;
  * some([{ a: 1 }, { a: 2 }, { a: 3 }], { a: 2 });
  * // => true
  */
-declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
+declare function some<T>(arr: ArrayLike<T> | null | undefined, doesMatch: Partial<T>): boolean;
 /**
- * Checks if there is an element in an array that matches the given predicate.
  *
- * Iteration is stopped once there is an element that matches `predicate`.
+ * Checks if there is an element in an object that matches the given predicate function.
  *
- * @param {T[]} arr The array to iterate over.
- * @param {((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string} [predicate=identity] The function invoked per iteration.
- * If a property name or an object is provided it will be used to create a predicate function.
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @returns {boolean} Returns `true` if any element is truthy, else `false`.
+ *
+ * @example
+ * some({ a: 1, b: 2, c: 3 });
+ * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined): boolean;
+/**
+ *
+ * Checks if there is an element in an object that matches the given predicate function.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {(value: T[keyof T], key: keyof T, object: T) => unknown} doesMatch A function that takes an value, its key, and the object, and returns a truthy value if the item matches the criteria.
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example
- * some([1, 2, 3, 4], n => n % 2 === 0);
+ * some({ a: 1, b: 2, c: 3 }, n => n % 2 === 0);
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: (value: T[keyof T], key: keyof T, object: T) => unknown): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], { a: 2 });
+ * Checks if there is an element in an object that matches the given partial value.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {Partial<T[keyof T]>} doesMatch A partial value to match against the values of the object.
+ * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * some({ a: { id: 1, name: 'Alice' }, b: { id: 2, name: 'Bob' } }, { name: 'Bob' });
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatch: Partial<T[keyof T]>): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], ['a', 2]);
+ * Checks if there is an element in an object that matches a property with a specific value.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @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 {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * const obj = { alice: { id: 1, name: 'Alice' }, bob: { id: 2, name: 'Bob' } };
+ * const result = some(obj, ['name', 'Alice']);
  * // => true
+ */
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, doesMatchProperty: [keyof T[keyof T], unknown]): boolean;
+/**
  *
- * some([{ a: 1 }, { a: 2 }, { a: 3 }], 'a');
+ * Checks if there is an element in an object that has a specific property, where the property name is provided as a string.
+ *
+ * @template T
+ * @param {T | null | undefined} object The object to iterate over.
+ * @param {string} propertyToCheck The property name to check.
+ * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
+ *
+ * @example
+ * const obj = { alice: { id: 1, name: 'Alice' }, bob: { id: 2, name: 'Bob' } };
+ * const result = some(obj, 'name');
  * // => true
  */
-declare function some<T>(arr: readonly T[] | null | undefined, predicate?: ((item: T, index: number, arr: any) => unknown) | Partial<T> | [keyof T, unknown] | string, guard?: unknown): boolean;
+declare function some<T extends Record<string, unknown>>(object: T | null | undefined, propertyToCheck: string): boolean;
 
 export { some };

package/dist/compat/array/some.mjs

@@ -3,32 +3,44 @@ import { property } from '../object/property.mjs';
 import { matches } from '../predicate/matches.mjs';
 import { matchesProperty } from '../predicate/matchesProperty.mjs';
 
-function some(arr, predicate, guard) {
+function some(source, predicate, guard) {
+    if (!source) {
+        return false;
+    }
     if (guard != null) {
         predicate = undefined;
     }
     if (!predicate) {
         predicate = identity;
     }
-    if (!Array.isArray(arr)) {
-        return false;
-    }
+    const values = Array.isArray(source) ? source : Object.values(source);
     switch (typeof predicate) {
         case 'function': {
-            return arr.some(predicate);
+            if (!Array.isArray(source)) {
+                const keys = Object.keys(source);
+                for (let i = 0; i < keys.length; i++) {
+                    const key = keys[i];
+                    const value = source[key];
+                    if (predicate(value, key, source)) {
+                        return true;
+                    }
+                }
+                return false;
+            }
+            return values.some(predicate);
         }
         case 'object': {
             if (Array.isArray(predicate) && predicate.length === 2) {
                 const key = predicate[0];
                 const value = predicate[1];
-                return arr.some(matchesProperty(key, value));
+                return values.some(matchesProperty(key, value));
             }
             else {
-                return arr.some(matches(predicate));
+                return values.some(matches(predicate));
             }
         }
         case 'string': {
-            return arr.some(property(predicate));
+            return values.some(property(predicate));
         }
     }
 }

package/dist/compat/index.js

@@ -1009,32 +1009,44 @@ function slice(array, start, end) {
     return result;
 }
 
-function some(arr, predicate, guard) {
+function some(source, predicate, guard) {
+    if (!source) {
+        return false;
+    }
     if (guard != null) {
         predicate = undefined;
     }
     if (!predicate) {
         predicate = identity;
     }
-    if (!Array.isArray(arr)) {
-        return false;
-    }
+    const values = Array.isArray(source) ? source : Object.values(source);
     switch (typeof predicate) {
         case 'function': {
-            return arr.some(predicate);
+            if (!Array.isArray(source)) {
+                const keys = Object.keys(source);
+                for (let i = 0; i < keys.length; i++) {
+                    const key = keys[i];
+                    const value = source[key];
+                    if (predicate(value, key, source)) {
+                        return true;
+                    }
+                }
+                return false;
+            }
+            return values.some(predicate);
         }
         case 'object': {
             if (Array.isArray(predicate) && predicate.length === 2) {
                 const key = predicate[0];
                 const value = predicate[1];
-                return arr.some(matchesProperty(key, value));
+                return values.some(matchesProperty(key, value));
             }
             else {
-                return arr.some(matches(predicate));
+                return values.some(matches(predicate));
             }
         }
         case 'string': {
-            return arr.some(property(predicate));
+            return values.some(property(predicate));
         }
     }
 }

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.2-dev.803+aaf5dd1c",
+  "version": "1.25.2-dev.805+e4fd912b",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {