es-toolkit 1.17.0-dev.540 → 1.17.0-dev.542

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

@@ -1,3 +1,14 @@
+/**
+ * Checks if there is an element in an array that is truthy.
+ *
+ * @param {T[]} 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;
 /**
  * Checks if there is an element in an array that matches the given predicate function.
  *

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

@@ -1,3 +1,14 @@
+/**
+ * Checks if there is an element in an array that is truthy.
+ *
+ * @param {T[]} 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;
 /**
  * Checks if there is an element in an array that matches the given predicate function.
  *

package/dist/compat/index.d.mts

@@ -61,6 +61,7 @@ export { MemoizeCache, memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { bindKey } from '../function/bindKey.mjs';
 export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';
 export { mean } from '../math/mean.mjs';

package/dist/compat/index.d.ts

@@ -61,6 +61,7 @@ export { MemoizeCache, memoize } from '../function/memoize.js';
 export { unary } from '../function/unary.js';
 export { partial } from '../function/partial.js';
 export { partialRight } from '../function/partialRight.js';
+export { bindKey } from '../function/bindKey.js';
 export { clamp } from '../math/clamp.js';
 export { inRange } from '../math/inRange.js';
 export { mean } from '../math/mean.js';

package/dist/compat/index.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const zipWith = require('../_chunk/zipWith-CaTQLt.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const rest$1 = require('../_chunk/rest-CXt9w3.js');
+const bindKey = require('../_chunk/bindKey-DwI1is.js');
 const math_index = require('../math/index.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-DN1PPP.js');
@@ -645,7 +645,7 @@ function ary(func, n = func.length, guard) {
     if (Number.isNaN(n) || n < 0) {
         n = 0;
     }
-    return rest$1.ary(func, n);
+    return bindKey.ary(func, n);
 }
 
 function bind(func, thisObj, ...partialArgs) {
@@ -679,7 +679,7 @@ function rest(func, start = func.length - 1) {
     if (Number.isNaN(start) || start < 0) {
         start = func.length - 1;
     }
-    return rest$1.rest(func, start);
+    return bindKey.rest(func, start);
 }
 
 function spread(func, argsIndex = 0) {
@@ -833,7 +833,7 @@ function mergeWithDeep(target, source, merge, stack) {
 }
 
 function merge(object, ...sources) {
-    return mergeWith(object, ...sources, rest$1.noop);
+    return mergeWith(object, ...sources, bindKey.noop);
 }
 
 function isArrayLike(value) {
@@ -987,17 +987,18 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = rest$1.after;
-exports.before = rest$1.before;
-exports.debounce = rest$1.debounce;
-exports.memoize = rest$1.memoize;
-exports.negate = rest$1.negate;
-exports.noop = rest$1.noop;
-exports.once = rest$1.once;
-exports.partial = rest$1.partial;
-exports.partialRight = rest$1.partialRight;
-exports.throttle = rest$1.throttle;
-exports.unary = rest$1.unary;
+exports.after = bindKey.after;
+exports.before = bindKey.before;
+exports.bindKey = bindKey.bindKey;
+exports.debounce = bindKey.debounce;
+exports.memoize = bindKey.memoize;
+exports.negate = bindKey.negate;
+exports.noop = bindKey.noop;
+exports.once = bindKey.once;
+exports.partial = bindKey.partial;
+exports.partialRight = bindKey.partialRight;
+exports.throttle = bindKey.throttle;
+exports.unary = bindKey.unary;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;
 exports.mean = math_index.mean;

package/dist/compat/index.mjs

@@ -61,6 +61,7 @@ export { memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { bindKey } from '../function/bindKey.mjs';
 export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';
 export { mean } from '../math/mean.mjs';

package/dist/function/bindKey.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Creates a function that invokes the method at `object[key]` with `partialArgs` prepended to the arguments it receives.
+ *
+ * This method differs from `bind` by allowing bound functions to reference methods that may be redefined or don't yet exist.
+ *
+ * The `bindKey.placeholder` value, which defaults to a `symbol`, may be used as a placeholder for partially applied arguments.
+ *
+ * @template T - The type of the object to bind.
+ * @template K - The type of the key to bind.
+ * @param {T} object - The object to invoke the method on.
+ * @param {K} key - The key of the method.
+ * @param {...any} partialArgs - The arguments to be partially applied.
+ * @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+ */
+declare function bindKey<T extends Record<PropertyKey, any>, K extends keyof T>(object: T, key: K, ...partialArgs: any[]): T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never;
+declare namespace bindKey {
+    var placeholder: typeof bindKeyPlaceholder;
+}
+declare const bindKeyPlaceholder: unique symbol;
+
+export { bindKey };

package/dist/function/bindKey.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Creates a function that invokes the method at `object[key]` with `partialArgs` prepended to the arguments it receives.
+ *
+ * This method differs from `bind` by allowing bound functions to reference methods that may be redefined or don't yet exist.
+ *
+ * The `bindKey.placeholder` value, which defaults to a `symbol`, may be used as a placeholder for partially applied arguments.
+ *
+ * @template T - The type of the object to bind.
+ * @template K - The type of the key to bind.
+ * @param {T} object - The object to invoke the method on.
+ * @param {K} key - The key of the method.
+ * @param {...any} partialArgs - The arguments to be partially applied.
+ * @returns {T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never} - Returns the new bound function.
+ */
+declare function bindKey<T extends Record<PropertyKey, any>, K extends keyof T>(object: T, key: K, ...partialArgs: any[]): T[K] extends (...args: any[]) => any ? (...args: any[]) => ReturnType<T[K]> : never;
+declare namespace bindKey {
+    var placeholder: typeof bindKeyPlaceholder;
+}
+declare const bindKeyPlaceholder: unique symbol;
+
+export { bindKey };

package/dist/function/bindKey.mjs

@@ -0,0 +1,27 @@
+function bindKey(object, key, ...partialArgs) {
+    const bound = function (...providedArgs) {
+        const args = [];
+        let startIndex = 0;
+        for (let i = 0; i < partialArgs.length; i++) {
+            const arg = partialArgs[i];
+            if (arg === bindKey.placeholder) {
+                args.push(providedArgs[startIndex++]);
+            }
+            else {
+                args.push(arg);
+            }
+        }
+        for (let i = startIndex; i < providedArgs.length; i++) {
+            args.push(providedArgs[i]);
+        }
+        if (this instanceof bound) {
+            return new object[key](...args);
+        }
+        return object[key].apply(object, args);
+    };
+    return bound;
+}
+const bindKeyPlaceholder = Symbol('bindKey.placeholder');
+bindKey.placeholder = bindKeyPlaceholder;
+
+export { bindKey };

package/dist/function/index.d.mts

@@ -11,4 +11,5 @@ export { unary } from './unary.mjs';
 export { partial } from './partial.mjs';
 export { partialRight } from './partialRight.mjs';
 export { rest } from './rest.mjs';
+export { bindKey } from './bindKey.mjs';
 export { spread } from './spread.mjs';

package/dist/function/index.d.ts

@@ -11,4 +11,5 @@ export { unary } from './unary.js';
 export { partial } from './partial.js';
 export { partialRight } from './partialRight.js';
 export { rest } from './rest.js';
+export { bindKey } from './bindKey.js';
 export { spread } from './spread.js';

package/dist/function/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const rest = require('../_chunk/rest-CXt9w3.js');
+const bindKey = require('../_chunk/bindKey-DwI1is.js');
 
 function spread(func) {
     return function (argsArr) {
@@ -10,17 +10,18 @@ function spread(func) {
     };
 }
 
-exports.after = rest.after;
-exports.ary = rest.ary;
-exports.before = rest.before;
-exports.debounce = rest.debounce;
-exports.memoize = rest.memoize;
-exports.negate = rest.negate;
-exports.noop = rest.noop;
-exports.once = rest.once;
-exports.partial = rest.partial;
-exports.partialRight = rest.partialRight;
-exports.rest = rest.rest;
-exports.throttle = rest.throttle;
-exports.unary = rest.unary;
+exports.after = bindKey.after;
+exports.ary = bindKey.ary;
+exports.before = bindKey.before;
+exports.bindKey = bindKey.bindKey;
+exports.debounce = bindKey.debounce;
+exports.memoize = bindKey.memoize;
+exports.negate = bindKey.negate;
+exports.noop = bindKey.noop;
+exports.once = bindKey.once;
+exports.partial = bindKey.partial;
+exports.partialRight = bindKey.partialRight;
+exports.rest = bindKey.rest;
+exports.throttle = bindKey.throttle;
+exports.unary = bindKey.unary;
 exports.spread = spread;

package/dist/function/index.mjs

@@ -11,4 +11,5 @@ export { unary } from './unary.mjs';
 export { partial } from './partial.mjs';
 export { partialRight } from './partialRight.mjs';
 export { rest } from './rest.mjs';
+export { bindKey } from './bindKey.mjs';
 export { spread } from './spread.mjs';

package/dist/index.d.mts

@@ -70,6 +70,7 @@ export { unary } from './function/unary.mjs';
 export { partial } from './function/partial.mjs';
 export { partialRight } from './function/partialRight.mjs';
 export { rest } from './function/rest.mjs';
+export { bindKey } from './function/bindKey.mjs';
 export { spread } from './function/spread.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';

package/dist/index.d.ts

@@ -70,6 +70,7 @@ export { unary } from './function/unary.js';
 export { partial } from './function/partial.js';
 export { partialRight } from './function/partialRight.js';
 export { rest } from './function/rest.js';
+export { bindKey } from './function/bindKey.js';
 export { spread } from './function/spread.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';

package/dist/index.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const zipWith = require('./_chunk/zipWith-CaTQLt.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
-const rest = require('./_chunk/rest-CXt9w3.js');
+const bindKey = require('./_chunk/bindKey-DwI1is.js');
 const function_index = require('./function/index.js');
 const math_index = require('./math/index.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
@@ -80,19 +80,20 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = rest.after;
-exports.ary = rest.ary;
-exports.before = rest.before;
-exports.debounce = rest.debounce;
-exports.memoize = rest.memoize;
-exports.negate = rest.negate;
-exports.noop = rest.noop;
-exports.once = rest.once;
-exports.partial = rest.partial;
-exports.partialRight = rest.partialRight;
-exports.rest = rest.rest;
-exports.throttle = rest.throttle;
-exports.unary = rest.unary;
+exports.after = bindKey.after;
+exports.ary = bindKey.ary;
+exports.before = bindKey.before;
+exports.bindKey = bindKey.bindKey;
+exports.debounce = bindKey.debounce;
+exports.memoize = bindKey.memoize;
+exports.negate = bindKey.negate;
+exports.noop = bindKey.noop;
+exports.once = bindKey.once;
+exports.partial = bindKey.partial;
+exports.partialRight = bindKey.partialRight;
+exports.rest = bindKey.rest;
+exports.throttle = bindKey.throttle;
+exports.unary = bindKey.unary;
 exports.spread = function_index.spread;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;

package/dist/index.mjs

@@ -70,6 +70,7 @@ export { unary } from './function/unary.mjs';
 export { partial } from './function/partial.mjs';
 export { partialRight } from './function/partialRight.mjs';
 export { rest } from './function/rest.mjs';
+export { bindKey } from './function/bindKey.mjs';
 export { spread } from './function/spread.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';

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.540+03005244",
+  "version": "1.17.0-dev.542+f1f55c8d",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {