es-toolkit 1.13.1-dev.368 → 1.13.1-dev.371

package/dist/compat/index.d.mts

@@ -55,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

@@ -55,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

@@ -462,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

@@ -55,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

@@ -60,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

@@ -60,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

@@ -76,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

@@ -60,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.368+b0011fa0",
+  "version": "1.13.1-dev.371+86fe776f",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {