es-toolkit 1.13.1-dev.367 → 1.13.1-dev.369

package/dist/compat/index.d.mts

@@ -40,6 +40,7 @@ export { zipObject } from '../array/zipObject.mjs';
 export { zipWith } from '../array/zipWith.mjs';
 export { without } from '../array/without.mjs';
 export { head as first, head } from '../array/head.mjs';
+export { isSubset } from '../array/isSubset.mjs';
 export { tail } from '../array/tail.mjs';
 export { toFilled } from '../array/toFilled.mjs';
 export { last } from '../array/last.mjs';
@@ -54,6 +55,7 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { throttle } from '../function/throttle.mjs';
 export { negate } from '../function/negate.mjs';
+export { bind } from '../function/bind.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

@@ -40,6 +40,7 @@ export { zipObject } from '../array/zipObject.js';
 export { zipWith } from '../array/zipWith.js';
 export { without } from '../array/without.js';
 export { head as first, head } from '../array/head.js';
+export { isSubset } from '../array/isSubset.js';
 export { tail } from '../array/tail.js';
 export { toFilled } from '../array/toFilled.js';
 export { last } from '../array/last.js';
@@ -54,6 +55,7 @@ export { noop } from '../function/noop.js';
 export { once } from '../function/once.js';
 export { throttle } from '../function/throttle.js';
 export { negate } from '../function/negate.js';
+export { bind } from '../function/bind.js';
 export { clamp } from '../math/clamp.js';
 export { inRange } from '../math/inRange.js';
 export { mean } from '../math/mean.js';

package/dist/compat/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const size = require('../_chunk/size-CJyNw8.js');
+const size = require('../_chunk/size-DmGMC-.js');
 const isNil = require('../_chunk/isNil-IuJ4cv.js');
 const promise_index = require('../_chunk/index-CwRt_M.js');
 const function_index = require('../function/index.js');
@@ -423,6 +423,7 @@ exports.initial = size.initial;
 exports.intersection = size.intersection;
 exports.intersectionBy = size.intersectionBy;
 exports.intersectionWith = size.intersectionWith;
+exports.isSubset = size.isSubset;
 exports.keyBy = size.keyBy;
 exports.last = size.last;
 exports.maxBy = size.maxBy;
@@ -461,6 +462,7 @@ exports.delay = promise_index.delay;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = function_index.after;
 exports.before = function_index.before;
+exports.bind = function_index.bind;
 exports.debounce = function_index.debounce;
 exports.negate = function_index.negate;
 exports.noop = function_index.noop;

package/dist/compat/index.mjs

@@ -40,6 +40,7 @@ export { zipObject } from '../array/zipObject.mjs';
 export { zipWith } from '../array/zipWith.mjs';
 export { without } from '../array/without.mjs';
 export { head as first, head } from '../array/head.mjs';
+export { isSubset } from '../array/isSubset.mjs';
 export { tail } from '../array/tail.mjs';
 export { toFilled } from '../array/toFilled.mjs';
 export { last } from '../array/last.mjs';
@@ -54,6 +55,7 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { throttle } from '../function/throttle.mjs';
 export { negate } from '../function/negate.mjs';
+export { bind } from '../function/bind.mjs';
 export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';
 export { mean } from '../math/mean.mjs';

package/dist/function/bind.d.mts

@@ -0,0 +1,32 @@
+/**
+ *
+ * Creates a function that invokes `func` with the `this` binding of `thisArg` and `partials` prepended to the arguments it receives.
+ *
+ * The `bind.placeholder` value, which defaults to a `symbol`, may be used as a placeholder for partially applied arguments.
+ *
+ * **Note:** Unlike native `Function#bind`, this method doesn't set the `length` property of bound functions.
+ *
+ * @param {(...args: any[]) => any} func  The function to bind.
+ * @param {any} thisArg  The `this` binding of `func`.
+ * @param {any[]} partials  The arguments to be partially applied.
+ * @returns {(...args: any[]) => any} Returns the new bound function.
+ *
+ * @example
+ * function greet(greeting, punctuation) {
+ *   return greeting + ' ' + this.user + punctuation;
+ * }
+ * const object = { user: 'fred' };
+ * let bound = bind(greet, object, 'hi');
+ * bound('!');
+ * // => 'hi fred!'
+ *
+ * bound = bind(greet, object, bind.placeholder, '!');
+ * bound('hi');
+ * // => 'hi fred!'
+ */
+declare function bind(func: (...args: any[]) => any, thisArg?: any, ...partials: any[]): (...args: any[]) => any;
+declare namespace bind {
+    var placeholder: symbol;
+}
+
+export { bind };

package/dist/function/bind.d.ts

@@ -0,0 +1,32 @@
+/**
+ *
+ * Creates a function that invokes `func` with the `this` binding of `thisArg` and `partials` prepended to the arguments it receives.
+ *
+ * The `bind.placeholder` value, which defaults to a `symbol`, may be used as a placeholder for partially applied arguments.
+ *
+ * **Note:** Unlike native `Function#bind`, this method doesn't set the `length` property of bound functions.
+ *
+ * @param {(...args: any[]) => any} func  The function to bind.
+ * @param {any} thisArg  The `this` binding of `func`.
+ * @param {any[]} partials  The arguments to be partially applied.
+ * @returns {(...args: any[]) => any} Returns the new bound function.
+ *
+ * @example
+ * function greet(greeting, punctuation) {
+ *   return greeting + ' ' + this.user + punctuation;
+ * }
+ * const object = { user: 'fred' };
+ * let bound = bind(greet, object, 'hi');
+ * bound('!');
+ * // => 'hi fred!'
+ *
+ * bound = bind(greet, object, bind.placeholder, '!');
+ * bound('hi');
+ * // => 'hi fred!'
+ */
+declare function bind(func: (...args: any[]) => any, thisArg?: any, ...partials: any[]): (...args: any[]) => any;
+declare namespace bind {
+    var placeholder: symbol;
+}
+
+export { bind };

package/dist/function/bind.mjs

@@ -0,0 +1,22 @@
+function bind(func, thisArg, ...partials) {
+    const wrapper = function (...args) {
+        let index = 0;
+        const result = partials.map(bindArg => {
+            if (bindArg === bind.placeholder) {
+                return args[index++];
+            }
+            return bindArg;
+        });
+        for (let i = index; i < args.length; i++) {
+            result.push(args[i]);
+        }
+        if (this instanceof wrapper) {
+            return new func(...result);
+        }
+        return func.apply(thisArg, result);
+    };
+    return wrapper;
+}
+bind.placeholder = Symbol('bind.placeholder');
+
+export { bind };

package/dist/function/index.d.mts

@@ -5,3 +5,4 @@ export { noop } from './noop.mjs';
 export { once } from './once.mjs';
 export { throttle } from './throttle.mjs';
 export { negate } from './negate.mjs';
+export { bind } from './bind.mjs';

package/dist/function/index.d.ts

@@ -5,3 +5,4 @@ export { noop } from './noop.js';
 export { once } from './once.js';
 export { throttle } from './throttle.js';
 export { negate } from './negate.js';
+export { bind } from './bind.js';

package/dist/function/index.js

@@ -87,8 +87,30 @@ function negate(func) {
     return ((...args) => !func(...args));
 }
 
+function bind(func, thisArg, ...partials) {
+    const wrapper = function (...args) {
+        let index = 0;
+        const result = partials.map(bindArg => {
+            if (bindArg === bind.placeholder) {
+                return args[index++];
+            }
+            return bindArg;
+        });
+        for (let i = index; i < args.length; i++) {
+            result.push(args[i]);
+        }
+        if (this instanceof wrapper) {
+            return new func(...result);
+        }
+        return func.apply(thisArg, result);
+    };
+    return wrapper;
+}
+bind.placeholder = Symbol('bind.placeholder');
+
 exports.after = after;
 exports.before = before;
+exports.bind = bind;
 exports.debounce = debounce;
 exports.negate = negate;
 exports.noop = noop;

package/dist/function/index.mjs

@@ -5,3 +5,4 @@ export { noop } from './noop.mjs';
 export { once } from './once.mjs';
 export { throttle } from './throttle.mjs';
 export { negate } from './negate.mjs';
+export { bind } from './bind.mjs';

package/dist/index.d.mts

@@ -45,6 +45,7 @@ export { zipObject } from './array/zipObject.mjs';
 export { zipWith } from './array/zipWith.mjs';
 export { without } from './array/without.mjs';
 export { head } from './array/head.mjs';
+export { isSubset } from './array/isSubset.mjs';
 export { tail } from './array/tail.mjs';
 export { toFilled } from './array/toFilled.mjs';
 export { last } from './array/last.mjs';
@@ -59,6 +60,7 @@ export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { bind } from './function/bind.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';

package/dist/index.d.ts

@@ -45,6 +45,7 @@ export { zipObject } from './array/zipObject.js';
 export { zipWith } from './array/zipWith.js';
 export { without } from './array/without.js';
 export { head } from './array/head.js';
+export { isSubset } from './array/isSubset.js';
 export { tail } from './array/tail.js';
 export { toFilled } from './array/toFilled.js';
 export { last } from './array/last.js';
@@ -59,6 +60,7 @@ export { noop } from './function/noop.js';
 export { once } from './function/once.js';
 export { throttle } from './function/throttle.js';
 export { negate } from './function/negate.js';
+export { bind } from './function/bind.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';
 export { mean } from './math/mean.js';

package/dist/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const size = require('./_chunk/size-CJyNw8.js');
+const size = require('./_chunk/size-DmGMC-.js');
 const array_index = require('./array/index.js');
 const isNil = require('./_chunk/isNil-IuJ4cv.js');
 const promise_index = require('./_chunk/index-CwRt_M.js');
@@ -36,6 +36,7 @@ exports.initial = size.initial;
 exports.intersection = size.intersection;
 exports.intersectionBy = size.intersectionBy;
 exports.intersectionWith = size.intersectionWith;
+exports.isSubset = size.isSubset;
 exports.keyBy = size.keyBy;
 exports.last = size.last;
 exports.maxBy = size.maxBy;
@@ -75,6 +76,7 @@ exports.delay = promise_index.delay;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = function_index.after;
 exports.before = function_index.before;
+exports.bind = function_index.bind;
 exports.debounce = function_index.debounce;
 exports.negate = function_index.negate;
 exports.noop = function_index.noop;

package/dist/index.mjs

@@ -45,6 +45,7 @@ export { zipObject } from './array/zipObject.mjs';
 export { zipWith } from './array/zipWith.mjs';
 export { without } from './array/without.mjs';
 export { head } from './array/head.mjs';
+export { isSubset } from './array/isSubset.mjs';
 export { tail } from './array/tail.mjs';
 export { toFilled } from './array/toFilled.mjs';
 export { last } from './array/last.mjs';
@@ -59,6 +60,7 @@ export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { bind } from './function/bind.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.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.13.1-dev.367+a4b77c01",
+  "version": "1.13.1-dev.369+f198dfd9",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {