es-toolkit 1.35.0-dev.1171 → 1.35.0-dev.1173

package/dist/compat/index.d.mts

@@ -284,6 +284,7 @@ export { method } from './util/method.mjs';
 export { methodOf } from './util/methodOf.mjs';
 export { now } from './util/now.mjs';
 export { over } from './util/over.mjs';
+export { overSome } from './util/overSome.mjs';
 export { stubArray } from './util/stubArray.mjs';
 export { stubFalse } from './util/stubFalse.mjs';
 export { stubObject } from './util/stubObject.mjs';

package/dist/compat/index.d.ts

@@ -284,6 +284,7 @@ export { method } from './util/method.js';
 export { methodOf } from './util/methodOf.js';
 export { now } from './util/now.js';
 export { over } from './util/over.js';
+export { overSome } from './util/overSome.js';
 export { stubArray } from './util/stubArray.js';
 export { stubFalse } from './util/stubFalse.js';
 export { stubObject } from './util/stubObject.js';

package/dist/compat/index.js

@@ -3498,6 +3498,26 @@ function over(...iteratees) {
     };
 }
 
+function overSome(...predicates) {
+    return function (...values) {
+        for (let i = 0; i < predicates.length; ++i) {
+            const predicate = predicates[i];
+            if (!Array.isArray(predicate)) {
+                if (iteratee(predicate).apply(this, values)) {
+                    return true;
+                }
+                continue;
+            }
+            for (let j = 0; j < predicate.length; ++j) {
+                if (iteratee(predicate[j]).apply(this, values)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    };
+}
+
 function stubArray() {
     return [];
 }
@@ -3788,6 +3808,7 @@ exports.nthArg = nthArg;
 exports.omit = omit;
 exports.orderBy = orderBy;
 exports.over = over;
+exports.overSome = overSome;
 exports.pad = pad;
 exports.padEnd = padEnd;
 exports.padStart = padStart;

package/dist/compat/index.mjs

@@ -284,6 +284,7 @@ export { method } from './util/method.mjs';
 export { methodOf } from './util/methodOf.mjs';
 export { now } from './util/now.mjs';
 export { over } from './util/over.mjs';
+export { overSome } from './util/overSome.mjs';
 export { stubArray } from './util/stubArray.mjs';
 export { stubFalse } from './util/stubFalse.mjs';
 export { stubObject } from './util/stubObject.mjs';

package/dist/compat/util/overSome.d.mts

@@ -0,0 +1,69 @@
+/**
+ * Creates a predicate function that checks if a value satisfies at least one of the given predicates.
+ *
+ * @template T - The type of the value to be checked.
+ * @template U - The first possible type that the value could match.
+ * @template V - The second possible type that the value could match.
+ *
+ * @param {(value: T) => value is U} predicate1 - A function that checks if the value matches type `U`.
+ * @param {(value: T) => value is V} predicate2 - A function that checks if the value matches type `V`.
+ *
+ * @returns {(value: T) => value is U | V} A function that takes a value and returns `true` if any predicates return truthy.
+ *
+ * @example
+ * const func = overSome(
+ *   (value) => typeof value === 'string',
+ *   (value) => typeof value === 'number'
+ * );
+ *
+ * func("hello"); // true
+ * func(42); // true
+ * func([]); // false
+ */
+declare function overSome<T, U extends T, V extends T>(predicate1: (value: T) => value is U, predicate2: (value: T) => value is V): (value: T) => value is U | V;
+/**
+ * Creates a function that checks if any of the given predicates return truthy for the provided values.
+ *
+ * @template T - The type of the values to be checked.
+ *
+ * @param {...Array<((...values: T[]) => boolean) | ReadonlyArray<(...values: T[]) => boolean>>} predicates -
+ *   A list of predicates or arrays of predicates. Each predicate is a function that takes one or more values of
+ *   type `T` and returns a boolean indicating whether the condition is satisfied for those values.
+ *
+ * @returns {(...values: T[]) => boolean} A function that takes a list of values and returns `true` if any of the
+ *   predicates return truthy for the provided values, and `false` otherwise.
+ *
+ * @example
+ * const func = overSome(
+ *   (value) => typeof value === 'string',
+ *   (value) => typeof value === 'number',
+ *   (value) => typeof value === 'symbol'
+ * );
+ *
+ * func("hello"); // true
+ * func(42); // true
+ * func(Symbol()); // true
+ * func([]); // false
+ *
+ * @example
+ * const func = overSome([
+ *   (value) => value.a > 0,
+ *   (value) => value.b > 0
+ * ]);
+ *
+ * func({ a: 0, b: 2 }); // true
+ * func({ a: 0, b: 0 }); // false
+ *
+ * @example
+ * const func = overSome(
+ *   (a, b) => typeof a === 'string' && typeof b === 'string',
+ *   (a, b) => a > 0 && b > 0
+ * );
+ *
+ * func("hello", "world"); // true
+ * func(1, 10); // true
+ * func(0, 2); // false
+ */
+declare function overSome<T>(...predicates: Array<((...values: T[]) => boolean) | ReadonlyArray<(...values: T[]) => boolean>>): (...values: T[]) => boolean;
+
+export { overSome };

package/dist/compat/util/overSome.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Creates a predicate function that checks if a value satisfies at least one of the given predicates.
+ *
+ * @template T - The type of the value to be checked.
+ * @template U - The first possible type that the value could match.
+ * @template V - The second possible type that the value could match.
+ *
+ * @param {(value: T) => value is U} predicate1 - A function that checks if the value matches type `U`.
+ * @param {(value: T) => value is V} predicate2 - A function that checks if the value matches type `V`.
+ *
+ * @returns {(value: T) => value is U | V} A function that takes a value and returns `true` if any predicates return truthy.
+ *
+ * @example
+ * const func = overSome(
+ *   (value) => typeof value === 'string',
+ *   (value) => typeof value === 'number'
+ * );
+ *
+ * func("hello"); // true
+ * func(42); // true
+ * func([]); // false
+ */
+declare function overSome<T, U extends T, V extends T>(predicate1: (value: T) => value is U, predicate2: (value: T) => value is V): (value: T) => value is U | V;
+/**
+ * Creates a function that checks if any of the given predicates return truthy for the provided values.
+ *
+ * @template T - The type of the values to be checked.
+ *
+ * @param {...Array<((...values: T[]) => boolean) | ReadonlyArray<(...values: T[]) => boolean>>} predicates -
+ *   A list of predicates or arrays of predicates. Each predicate is a function that takes one or more values of
+ *   type `T` and returns a boolean indicating whether the condition is satisfied for those values.
+ *
+ * @returns {(...values: T[]) => boolean} A function that takes a list of values and returns `true` if any of the
+ *   predicates return truthy for the provided values, and `false` otherwise.
+ *
+ * @example
+ * const func = overSome(
+ *   (value) => typeof value === 'string',
+ *   (value) => typeof value === 'number',
+ *   (value) => typeof value === 'symbol'
+ * );
+ *
+ * func("hello"); // true
+ * func(42); // true
+ * func(Symbol()); // true
+ * func([]); // false
+ *
+ * @example
+ * const func = overSome([
+ *   (value) => value.a > 0,
+ *   (value) => value.b > 0
+ * ]);
+ *
+ * func({ a: 0, b: 2 }); // true
+ * func({ a: 0, b: 0 }); // false
+ *
+ * @example
+ * const func = overSome(
+ *   (a, b) => typeof a === 'string' && typeof b === 'string',
+ *   (a, b) => a > 0 && b > 0
+ * );
+ *
+ * func("hello", "world"); // true
+ * func(1, 10); // true
+ * func(0, 2); // false
+ */
+declare function overSome<T>(...predicates: Array<((...values: T[]) => boolean) | ReadonlyArray<(...values: T[]) => boolean>>): (...values: T[]) => boolean;
+
+export { overSome };

package/dist/compat/util/overSome.mjs

@@ -0,0 +1,23 @@
+import { iteratee } from './iteratee.mjs';
+
+function overSome(...predicates) {
+    return function (...values) {
+        for (let i = 0; i < predicates.length; ++i) {
+            const predicate = predicates[i];
+            if (!Array.isArray(predicate)) {
+                if (iteratee(predicate).apply(this, values)) {
+                    return true;
+                }
+                continue;
+            }
+            for (let j = 0; j < predicate.length; ++j) {
+                if (iteratee(predicate[j]).apply(this, values)) {
+                    return true;
+                }
+            }
+        }
+        return false;
+    };
+}
+
+export { overSome };

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.35.0-dev.1171+b81ee6f1",
+  "version": "1.35.0-dev.1173+bdc56b74",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {