es-toolkit 1.37.2-dev.1273 → 1.37.2-dev.1275

package/dist/index.d.mts

@@ -169,4 +169,5 @@ export { upperFirst } from './string/upperFirst.mjs';
 export { words } from './string/words.mjs';
 export { attempt } from './util/attempt.mjs';
 export { attemptAsync } from './util/attemptAsync.mjs';
+export { bindAll } from './util/bindAll.mjs';
 export { invariant } from './util/invariant.mjs';

package/dist/index.d.ts

@@ -169,4 +169,5 @@ export { upperFirst } from './string/upperFirst.js';
 export { words } from './string/words.js';
 export { attempt } from './util/attempt.js';
 export { attemptAsync } from './util/attemptAsync.js';
+export { bindAll } from './util/bindAll.js';
 export { invariant } from './util/invariant.js';

package/dist/index.js

@@ -199,4 +199,5 @@ exports.upperCase = upperFirst.upperCase;
 exports.upperFirst = upperFirst.upperFirst;
 exports.attempt = util_index.attempt;
 exports.attemptAsync = util_index.attemptAsync;
+exports.bindAll = util_index.bindAll;
 exports.invariant = util_index.invariant;

package/dist/index.mjs

@@ -169,4 +169,5 @@ export { upperFirst } from './string/upperFirst.mjs';
 export { words } from './string/words.mjs';
 export { attempt } from './util/attempt.mjs';
 export { attemptAsync } from './util/attemptAsync.mjs';
+export { bindAll } from './util/bindAll.mjs';
 export { invariant } from './util/invariant.mjs';

package/dist/util/bindAll.d.mts

@@ -0,0 +1,26 @@
+/**
+ * Binds methods of an object to the object itself, overwriting the existing method.
+ * Method names may be specified as individual arguments or as arrays of method names.
+ *
+ * @template T - Type of the object with methods to bind.
+ * @param {T} object - The object to bind methods to.
+ * @param {...(string|string[])} methodNames - The method names to bind, specified individually or in arrays.
+ * @returns {T} - Returns the object with bound methods.
+ *
+ * @example
+ * const view = {
+ *   'label': 'docs',
+ *   'click': function() {
+ *     console.log('clicked ' + this.label);
+ *   }
+ * };
+ *
+ * bindAll(view, ['click']);
+ * jQuery(element).on('click', view.click);
+ * // => Logs 'clicked docs' when clicked.
+ */
+declare function bindAll<T extends {
+    [key: string]: unknown;
+}>(object: T, ...methodNames: Array<string | string[] | number | IArguments>): T;
+
+export { bindAll };

package/dist/util/bindAll.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Binds methods of an object to the object itself, overwriting the existing method.
+ * Method names may be specified as individual arguments or as arrays of method names.
+ *
+ * @template T - Type of the object with methods to bind.
+ * @param {T} object - The object to bind methods to.
+ * @param {...(string|string[])} methodNames - The method names to bind, specified individually or in arrays.
+ * @returns {T} - Returns the object with bound methods.
+ *
+ * @example
+ * const view = {
+ *   'label': 'docs',
+ *   'click': function() {
+ *     console.log('clicked ' + this.label);
+ *   }
+ * };
+ *
+ * bindAll(view, ['click']);
+ * jQuery(element).on('click', view.click);
+ * // => Logs 'clicked docs' when clicked.
+ */
+declare function bindAll<T extends {
+    [key: string]: unknown;
+}>(object: T, ...methodNames: Array<string | string[] | number | IArguments>): T;
+
+export { bindAll };

package/dist/util/bindAll.mjs

@@ -0,0 +1,29 @@
+function bindAll(object, ...methodNames) {
+    if (Array.isArray(object) && methodNames.length === 0) {
+        return object;
+    }
+    const bindValue = (obj, key) => {
+        const value = obj[key];
+        if (typeof value === 'function') {
+            obj[key] = value.bind(obj);
+        }
+    };
+    methodNames.forEach(name => {
+        if (Array.isArray(name)) {
+            name.forEach(key => bindValue(object, String(key)));
+        }
+        else if (typeof name === 'number') {
+            const key = Object.is(name, -0) ? '-0' : String(name);
+            bindValue(object, key);
+        }
+        else if (name && typeof name === 'object' && 'length' in name) {
+            Array.from(name).forEach(key => bindValue(object, String(key)));
+        }
+        else if (name) {
+            bindValue(object, String(name));
+        }
+    });
+    return object;
+}
+
+export { bindAll };

package/dist/util/index.d.mts

@@ -1,3 +1,4 @@
 export { attempt } from './attempt.mjs';
 export { attemptAsync } from './attemptAsync.mjs';
+export { bindAll } from './bindAll.mjs';
 export { invariant } from './invariant.mjs';

package/dist/util/index.d.ts

@@ -1,3 +1,4 @@
 export { attempt } from './attempt.js';
 export { attemptAsync } from './attemptAsync.js';
+export { bindAll } from './bindAll.js';
 export { invariant } from './invariant.js';

package/dist/util/index.js

@@ -21,6 +21,34 @@ async function attemptAsync(func) {
     }
 }
 
+function bindAll(object, ...methodNames) {
+    if (Array.isArray(object) && methodNames.length === 0) {
+        return object;
+    }
+    const bindValue = (obj, key) => {
+        const value = obj[key];
+        if (typeof value === 'function') {
+            obj[key] = value.bind(obj);
+        }
+    };
+    methodNames.forEach(name => {
+        if (Array.isArray(name)) {
+            name.forEach(key => bindValue(object, String(key)));
+        }
+        else if (typeof name === 'number') {
+            const key = Object.is(name, -0) ? '-0' : String(name);
+            bindValue(object, key);
+        }
+        else if (name && typeof name === 'object' && 'length' in name) {
+            Array.from(name).forEach(key => bindValue(object, String(key)));
+        }
+        else if (name) {
+            bindValue(object, String(name));
+        }
+    });
+    return object;
+}
+
 function invariant(condition, message) {
     if (condition) {
         return;
@@ -30,4 +58,5 @@ function invariant(condition, message) {
 
 exports.attempt = attempt;
 exports.attemptAsync = attemptAsync;
+exports.bindAll = bindAll;
 exports.invariant = invariant;

package/dist/util/index.mjs

@@ -1,3 +1,4 @@
 export { attempt } from './attempt.mjs';
 export { attemptAsync } from './attemptAsync.mjs';
+export { bindAll } from './bindAll.mjs';
 export { invariant } from './invariant.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.37.2-dev.1273+cdc77fe5",
+  "version": "1.37.2-dev.1275+3de4a303",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {