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

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

@@ -10,6 +10,8 @@
  * from which elements will be compared and filtered.
  * @param {T[]} secondArr - The array containing elements to be excluded from the first array.
  * Each element in this array will be checked against the first array, and if a match is found,
+ * @param arr
+ * @param {...any} values
  * that element will be excluded from the result.
  * @returns {T[]} A new array containing the elements that are present in the first array but not
  * in the second array.

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

@@ -10,6 +10,8 @@
  * from which elements will be compared and filtered.
  * @param {T[]} secondArr - The array containing elements to be excluded from the first array.
  * Each element in this array will be checked against the first array, and if a match is found,
+ * @param arr
+ * @param {...any} values
  * that element will be excluded from the result.
  * @returns {T[]} A new array containing the elements that are present in the first array but not
  * in the second array.

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

@@ -65,6 +65,7 @@ declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * @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.
+ * @param guard
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example

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

@@ -65,6 +65,7 @@ declare function some<T>(arr: readonly T[], doesMatch: Partial<T>): boolean;
  * @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.
+ * @param guard
  * @returns {boolean} Returns `true` if any element passes the predicate check, else `false`.
  *
  * @example

package/dist/{function → compat/function}/bindKey.d.mts

@@ -11,6 +11,30 @@
  * @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.
+ *
+ * @example
+ * const object = {
+ *   user: 'fred',
+ *   greet: function (greeting, punctuation) {
+ *     return greeting + ' ' + this.user + punctuation;
+ *   },
+ * };
+ *
+ * let bound = bindKey(object, 'greet', 'hi');
+ * bound('!');
+ * // => 'hi fred!'
+ *
+ * object.greet = function (greeting, punctuation) {
+ *   return greeting + 'ya ' + this.user + punctuation;
+ * };
+ *
+ * bound('!');
+ * // => 'hiya fred!'
+ *
+ * // Bound with placeholders.
+ * bound = bindKey(object, 'greet', bindKey.placeholder, '!');
+ * bound('hi');
+ * // => 'hiya fred!'
  */
 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 {

package/dist/{function → compat/function}/bindKey.d.ts

@@ -11,6 +11,30 @@
  * @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.
+ *
+ * @example
+ * const object = {
+ *   user: 'fred',
+ *   greet: function (greeting, punctuation) {
+ *     return greeting + ' ' + this.user + punctuation;
+ *   },
+ * };
+ *
+ * let bound = bindKey(object, 'greet', 'hi');
+ * bound('!');
+ * // => 'hi fred!'
+ *
+ * object.greet = function (greeting, punctuation) {
+ *   return greeting + 'ya ' + this.user + punctuation;
+ * };
+ *
+ * bound('!');
+ * // => 'hiya fred!'
+ *
+ * // Bound with placeholders.
+ * bound = bindKey(object, 'greet', bindKey.placeholder, '!');
+ * bound('hi');
+ * // => 'hiya fred!'
  */
 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 {

package/dist/compat/index.d.mts

@@ -61,7 +61,6 @@ 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';
@@ -123,6 +122,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { indexOf } from './array/indexOf.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
+export { bindKey } from './function/bindKey.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';

package/dist/compat/index.d.ts

@@ -61,7 +61,6 @@ 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';
@@ -123,6 +122,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { indexOf } from './array/indexOf.js';
 export { ary } from './function/ary.js';
 export { bind } from './function/bind.js';
+export { bindKey } from './function/bindKey.js';
 export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';
 export { attempt } from './function/attempt.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 bindKey = require('../_chunk/bindKey-DwI1is.js');
+const rest$1 = require('../_chunk/rest-CXt9w3.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 bindKey.ary(func, n);
+    return rest$1.ary(func, n);
 }
 
 function bind(func, thisObj, ...partialArgs) {
@@ -674,12 +674,38 @@ function bind(func, thisObj, ...partialArgs) {
 const bindPlaceholder = Symbol('bind.placeholder');
 bind.placeholder = bindPlaceholder;
 
+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;
+
 function rest(func, start = func.length - 1) {
     start = Number.parseInt(start, 10);
     if (Number.isNaN(start) || start < 0) {
         start = func.length - 1;
     }
-    return bindKey.rest(func, start);
+    return rest$1.rest(func, start);
 }
 
 function spread(func, argsIndex = 0) {
@@ -833,7 +859,7 @@ function mergeWithDeep(target, source, merge, stack) {
 }
 
 function merge(object, ...sources) {
-    return mergeWith(object, ...sources, bindKey.noop);
+    return mergeWith(object, ...sources, rest$1.noop);
 }
 
 function isArrayLike(value) {
@@ -987,18 +1013,17 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-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.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.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;
 exports.mean = math_index.mean;
@@ -1044,6 +1069,7 @@ exports.upperFirst = string_index.upperFirst;
 exports.ary = ary;
 exports.attempt = attempt;
 exports.bind = bind;
+exports.bindKey = bindKey;
 exports.chunk = chunk;
 exports.concat = concat;
 exports.difference = difference;

package/dist/compat/index.mjs

@@ -61,7 +61,6 @@ 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';
@@ -124,6 +123,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { indexOf } from './array/indexOf.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
+export { bindKey } from './function/bindKey.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';

package/dist/function/index.d.mts

@@ -11,5 +11,4 @@ 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,5 +11,4 @@ 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 bindKey = require('../_chunk/bindKey-DwI1is.js');
+const rest = require('../_chunk/rest-CXt9w3.js');
 
 function spread(func) {
     return function (argsArr) {
@@ -10,18 +10,17 @@ function spread(func) {
     };
 }
 
-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.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.spread = spread;

package/dist/function/index.mjs

@@ -11,5 +11,4 @@ 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,7 +70,6 @@ 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,7 +70,6 @@ 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 bindKey = require('./_chunk/bindKey-DwI1is.js');
+const rest = require('./_chunk/rest-CXt9w3.js');
 const function_index = require('./function/index.js');
 const math_index = require('./math/index.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
@@ -80,20 +80,19 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-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.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.spread = function_index.spread;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;

package/dist/index.mjs

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