es-toolkit 1.17.0-dev.508 → 1.17.0-dev.510

package/dist/compat/function/spread.d.mts

@@ -0,0 +1,47 @@
+/**
+ * Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function. The array argument is positioned based on the `argsIndex` parameter.
+ *
+ * @template F - A function type with any number of parameters and any return type.
+ * @param {F} func - The function to be transformed. It can be any function with any number of arguments.
+ * @param {number} [argsIndex=0] - The index where the array argument is positioned among the other arguments.
+ *   If `argsIndex` is negative or `NaN`, it defaults to `0`. If it's a fractional number, it is rounded to the nearest integer.
+ * @returns {(...args: any[]) => ReturnType<F>} - A new function that takes multiple arguments, including an array of arguments at the specified `argsIndex`,
+ *   and returns the result of calling the original function with those arguments.
+ *
+ * @example
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * const spreadAdd = spread(add);
+ * console.log(spreadAdd([1, 2])); // Output: 3
+ *
+ * @example
+ * // Example function to spread arguments over
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * // Create a new function that uses `spread` to combine arguments
+ * const spreadAdd = spread(add, 1);
+ *
+ * // Calling `spreadAdd` with an array as the second argument
+ * console.log(spreadAdd(1, [2])); // Output: 3
+ *
+ * @example
+ * // Function with default arguments
+ * function greet(name, greeting = 'Hello') {
+ *   return `${greeting}, ${name}!`;
+ * }
+ *
+ * // Create a new function that uses `spread` to position the argument array at index 0
+ * const spreadGreet = spread(greet, 0);
+ *
+ * // Calling `spreadGreet` with an array of arguments
+ * console.log(spreadGreet(['Alice'])); // Output: Hello, Alice!
+ * console.log(spreadGreet(['Bob', 'Hi'])); // Output: Hi, Bob!
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, argsIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

package/dist/compat/function/spread.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function. The array argument is positioned based on the `argsIndex` parameter.
+ *
+ * @template F - A function type with any number of parameters and any return type.
+ * @param {F} func - The function to be transformed. It can be any function with any number of arguments.
+ * @param {number} [argsIndex=0] - The index where the array argument is positioned among the other arguments.
+ *   If `argsIndex` is negative or `NaN`, it defaults to `0`. If it's a fractional number, it is rounded to the nearest integer.
+ * @returns {(...args: any[]) => ReturnType<F>} - A new function that takes multiple arguments, including an array of arguments at the specified `argsIndex`,
+ *   and returns the result of calling the original function with those arguments.
+ *
+ * @example
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * const spreadAdd = spread(add);
+ * console.log(spreadAdd([1, 2])); // Output: 3
+ *
+ * @example
+ * // Example function to spread arguments over
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * // Create a new function that uses `spread` to combine arguments
+ * const spreadAdd = spread(add, 1);
+ *
+ * // Calling `spreadAdd` with an array as the second argument
+ * console.log(spreadAdd(1, [2])); // Output: 3
+ *
+ * @example
+ * // Function with default arguments
+ * function greet(name, greeting = 'Hello') {
+ *   return `${greeting}, ${name}!`;
+ * }
+ *
+ * // Create a new function that uses `spread` to position the argument array at index 0
+ * const spreadGreet = spread(greet, 0);
+ *
+ * // Calling `spreadGreet` with an array of arguments
+ * console.log(spreadGreet(['Alice'])); // Output: Hello, Alice!
+ * console.log(spreadGreet(['Bob', 'Hi'])); // Output: Hi, Bob!
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, argsIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

package/dist/compat/function/spread.mjs

@@ -0,0 +1,16 @@
+function spread(func, argsIndex = 0) {
+    argsIndex = Number.parseInt(argsIndex, 10);
+    if (Number.isNaN(argsIndex) || argsIndex < 0) {
+        argsIndex = 0;
+    }
+    return function (...args) {
+        const array = args[argsIndex];
+        const params = args.slice(0, argsIndex);
+        if (array) {
+            params.push(...array);
+        }
+        return func.apply(this, params);
+    };
+}
+
+export { spread };

package/dist/compat/index.d.mts

@@ -116,6 +116,7 @@ export { indexOf } from './array/indexOf.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { rest } from './function/rest.mjs';
+export { spread } from './function/spread.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { has } from './object/has.mjs';

package/dist/compat/index.d.ts

@@ -116,6 +116,7 @@ export { indexOf } from './array/indexOf.js';
 export { ary } from './function/ary.js';
 export { bind } from './function/bind.js';
 export { rest } from './function/rest.js';
+export { spread } from './function/spread.js';
 export { get } from './object/get.js';
 export { set } from './object/set.js';
 export { has } from './object/has.js';

package/dist/compat/index.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const initial = require('../_chunk/initial-Ci2bn_.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const function_index = require('../function/index.js');
+const rest$1 = require('../_chunk/rest-Bzm2XK.js');
 const math_index = require('../math/index.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-BGwYW5.js');
@@ -574,7 +574,7 @@ function ary(func, n = func.length, guard) {
     if (Number.isNaN(n) || n < 0) {
         n = 0;
     }
-    return function_index.ary(func, n);
+    return rest$1.ary(func, n);
 }
 
 function bind(func, thisObj, ...partialArgs) {
@@ -608,7 +608,22 @@ function rest(func, start = func.length - 1) {
     if (Number.isNaN(start) || start < 0) {
         start = func.length - 1;
     }
-    return function_index.rest(func, start);
+    return rest$1.rest(func, start);
+}
+
+function spread(func, argsIndex = 0) {
+    argsIndex = Number.parseInt(argsIndex, 10);
+    if (Number.isNaN(argsIndex) || argsIndex < 0) {
+        argsIndex = 0;
+    }
+    return function (...args) {
+        const array = args[argsIndex];
+        const params = args.slice(0, argsIndex);
+        if (array) {
+            params.push(...array);
+        }
+        return func.apply(this, params);
+    };
 }
 
 function identity(x) {
@@ -742,7 +757,7 @@ function mergeWithDeep(target, source, merge, stack) {
 }
 
 function merge(object, ...sources) {
-    return mergeWith(object, ...sources, function_index.noop);
+    return mergeWith(object, ...sources, rest$1.noop);
 }
 
 function isArray(value) {
@@ -872,17 +887,17 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = function_index.after;
-exports.before = function_index.before;
-exports.debounce = function_index.debounce;
-exports.memoize = function_index.memoize;
-exports.negate = function_index.negate;
-exports.noop = function_index.noop;
-exports.once = function_index.once;
-exports.partial = function_index.partial;
-exports.partialRight = function_index.partialRight;
-exports.throttle = function_index.throttle;
-exports.unary = function_index.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;
@@ -961,5 +976,6 @@ exports.property = property;
 exports.rest = rest;
 exports.set = set;
 exports.size = size;
+exports.spread = spread;
 exports.startsWith = startsWith;
 exports.zipObjectDeep = zipObjectDeep;

package/dist/compat/index.mjs

@@ -117,6 +117,7 @@ export { indexOf } from './array/indexOf.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { rest } from './function/rest.mjs';
+export { spread } from './function/spread.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { has } from './object/has.mjs';

package/dist/function/index.d.mts

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

package/dist/function/index.d.ts

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

package/dist/function/index.js

@@ -2,183 +2,25 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const before = (n, func) => {
-    if (!Number.isInteger(n) || n < 0) {
-        throw new Error('n must be a non-negative integer.');
-    }
-    let counter = 0;
-    return ((...args) => {
-        if (++counter < n) {
-            return func(...args);
-        }
-        return undefined;
-    });
-};
-
-const after = (n, func) => {
-    if (!Number.isInteger(n) || n < 0) {
-        throw new Error(`n must be a non-negative integer.`);
-    }
-    let counter = 0;
-    return ((...args) => {
-        if (++counter >= n) {
-            return func(...args);
-        }
-        return undefined;
-    });
-};
-
-function debounce(func, debounceMs, { signal } = {}) {
-    let timeoutId = null;
-    const debounced = function (...args) {
-        if (timeoutId !== null) {
-            clearTimeout(timeoutId);
-        }
-        if (signal?.aborted) {
-            return;
-        }
-        timeoutId = setTimeout(() => {
-            func(...args);
-            timeoutId = null;
-        }, debounceMs);
-    };
-    const onAbort = function () {
-        debounced.cancel();
-    };
-    debounced.cancel = function () {
-        if (timeoutId !== null) {
-            clearTimeout(timeoutId);
-            timeoutId = null;
-        }
-    };
-    signal?.addEventListener('abort', onAbort, { once: true });
-    return debounced;
-}
-
-function noop() { }
-
-function once(func) {
-    let called = false;
-    let cache;
-    return function () {
-        if (called) {
-            return cache;
-        }
-        const result = func();
-        called = true;
-        cache = result;
-        return result;
-    };
-}
-
-function throttle(func, throttleMs) {
-    let lastCallTime;
-    const throttledFunction = function (...args) {
-        const now = Date.now();
-        if (lastCallTime == null || now - lastCallTime >= throttleMs) {
-            lastCallTime = now;
-            func(...args);
-        }
-    };
-    return throttledFunction;
-}
-
-function negate(func) {
-    return ((...args) => !func(...args));
-}
-
-function memoize(fn, options = {}) {
-    const { cache = new Map(), getCacheKey } = options;
-    const memoizedFn = function (arg) {
-        const key = getCacheKey ? getCacheKey(arg) : arg;
-        if (cache.has(key)) {
-            return cache.get(key);
-        }
-        const result = fn.call(this, arg);
-        cache.set(key, result);
-        return result;
-    };
-    memoizedFn.cache = cache;
-    return memoizedFn;
-}
-
-function ary(func, n) {
-    return function (...args) {
-        return func.apply(this, args.slice(0, n));
-    };
-}
-
-function unary(func) {
-    return ary(func, 1);
-}
-
-function partial(func, ...partialArgs) {
-    return function (...providedArgs) {
-        const args = [];
-        let startIndex = 0;
-        for (let i = 0; i < partialArgs.length; i++) {
-            const arg = partialArgs[i];
-            if (arg === partial.placeholder) {
-                args.push(providedArgs[startIndex++]);
-            }
-            else {
-                args.push(arg);
-            }
-        }
-        for (let i = startIndex; i < providedArgs.length; i++) {
-            args.push(providedArgs[i]);
-        }
-        return func.apply(this, args);
-    };
-}
-const partialPlaceholder = Symbol('partial.placeholder');
-partial.placeholder = partialPlaceholder;
-
-function partialRight(func, ...partialArgs) {
-    return function (...providedArgs) {
-        const placeholderLength = partialArgs.filter(arg => arg === partialRightPlaceholder).length;
-        const rangeLength = Math.max(providedArgs.length - placeholderLength, 0);
-        const args = [];
-        let providedIndex = 0;
-        for (let i = 0; i < rangeLength; i++) {
-            args.push(providedArgs[providedIndex++]);
-        }
-        for (let i = 0; i < partialArgs.length; i++) {
-            const arg = partialArgs[i];
-            if (arg === partialRight.placeholder) {
-                args.push(providedArgs[providedIndex++]);
-            }
-            else {
-                args.push(arg);
-            }
-        }
-        return func.apply(this, args);
-    };
-}
-const partialRightPlaceholder = Symbol('partialRight.placeholder');
-partialRight.placeholder = partialRightPlaceholder;
-
-function rest(func, startIndex = func.length - 1) {
-    return function (...args) {
-        const rest = args.slice(startIndex);
-        const params = args.slice(0, startIndex);
-        while (params.length < startIndex) {
-            params.push(undefined);
-        }
-        return func.apply(this, [...params, rest]);
-    };
-}
-
-exports.after = after;
-exports.ary = ary;
-exports.before = before;
-exports.debounce = debounce;
-exports.memoize = memoize;
-exports.negate = negate;
-exports.noop = noop;
-exports.once = once;
-exports.partial = partial;
-exports.partialRight = partialRight;
-exports.rest = rest;
-exports.throttle = throttle;
-exports.unary = unary;
+const rest = require('../_chunk/rest-Bzm2XK.js');
+
+function spread(func) {
+    return function (argsArr) {
+        return func.apply(this, argsArr);
+    };
+}
+
+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,3 +11,4 @@ export { unary } from './unary.mjs';
 export { partial } from './partial.mjs';
 export { partialRight } from './partialRight.mjs';
 export { rest } from './rest.mjs';
+export { spread } from './spread.mjs';

package/dist/function/spread.d.mts

@@ -0,0 +1,19 @@
+/**
+Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function.
+ *
+ * @template F - A function type with any number of parameters and any return type.
+ * @param {F} func - The function to be transformed. It can be any function with any number of arguments.
+ * @returns {(argsArr: Parameters<F>) => ReturnType<F>} - A new function that takes an array of arguments and returns the result of calling the original function with those arguments.
+ *
+ * @example
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * const spreadAdd = spread(add);
+ * console.log(spreadAdd([1, 2])); // Output: 3
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F): (argsArr: Parameters<F>) => ReturnType<F>;
+
+export { spread };

package/dist/function/spread.d.ts

@@ -0,0 +1,19 @@
+/**
+Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function.
+ *
+ * @template F - A function type with any number of parameters and any return type.
+ * @param {F} func - The function to be transformed. It can be any function with any number of arguments.
+ * @returns {(argsArr: Parameters<F>) => ReturnType<F>} - A new function that takes an array of arguments and returns the result of calling the original function with those arguments.
+ *
+ * @example
+ * function add(a, b) {
+ *   return a + b;
+ * }
+ *
+ * const spreadAdd = spread(add);
+ * console.log(spreadAdd([1, 2])); // Output: 3
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F): (argsArr: Parameters<F>) => ReturnType<F>;
+
+export { spread };

package/dist/function/spread.mjs

@@ -0,0 +1,7 @@
+function spread(func) {
+    return function (argsArr) {
+        return func.apply(this, argsArr);
+    };
+}
+
+export { spread };

package/dist/index.d.mts

@@ -68,6 +68,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 { spread } from './function/spread.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';
 export { mean } from './math/mean.mjs';

package/dist/index.d.ts

@@ -68,6 +68,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 { spread } from './function/spread.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';
 export { mean } from './math/mean.js';

package/dist/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const initial = require('./_chunk/initial-Ci2bn_.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
+const rest = require('./_chunk/rest-Bzm2XK.js');
 const function_index = require('./function/index.js');
 const math_index = require('./math/index.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
@@ -77,19 +78,20 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = function_index.after;
-exports.ary = function_index.ary;
-exports.before = function_index.before;
-exports.debounce = function_index.debounce;
-exports.memoize = function_index.memoize;
-exports.negate = function_index.negate;
-exports.noop = function_index.noop;
-exports.once = function_index.once;
-exports.partial = function_index.partial;
-exports.partialRight = function_index.partialRight;
-exports.rest = function_index.rest;
-exports.throttle = function_index.throttle;
-exports.unary = function_index.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;
 exports.mean = math_index.mean;

package/dist/index.mjs

@@ -68,6 +68,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 { spread } from './function/spread.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.17.0-dev.508+5bccc517",
+  "version": "1.17.0-dev.510+a84ffa9a",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {