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

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

@@ -0,0 +1,11 @@
+/**
+ * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+ *
+ * @template F The type of the function to spread arguments over.
+ * @param {F} func The function to spread arguments over.
+ * @param {number} startIndex The start position of the spread.
+ * @returns {(...args: any[]) => ReturnType<F>} A new function that invokes `func` with the spread arguments.
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, startIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

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

@@ -0,0 +1,11 @@
+/**
+ * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+ *
+ * @template F The type of the function to spread arguments over.
+ * @param {F} func The function to spread arguments over.
+ * @param {number} startIndex The start position of the spread.
+ * @returns {(...args: any[]) => ReturnType<F>} A new function that invokes `func` with the spread arguments.
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, startIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

package/dist/compat/function/spread.mjs

@@ -0,0 +1,11 @@
+import { spread as spread$1 } from '../../function/spread.mjs';
+
+function spread(func, startIndex = 0) {
+    startIndex = Number.parseInt(startIndex, 10);
+    if (Number.isNaN(startIndex) || startIndex < 0) {
+        startIndex = 0;
+    }
+    return spread$1(func, startIndex);
+}
+
+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

@@ -611,6 +611,14 @@ function rest(func, start = func.length - 1) {
     return function_index.rest(func, start);
 }
 
+function spread(func, startIndex = 0) {
+    startIndex = Number.parseInt(startIndex, 10);
+    if (Number.isNaN(startIndex) || startIndex < 0) {
+        startIndex = 0;
+    }
+    return function_index.spread(func, startIndex);
+}
+
 function identity(x) {
     return x;
 }
@@ -961,5 +969,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

@@ -169,6 +169,17 @@ function rest(func, startIndex = func.length - 1) {
     };
 }
 
+function spread(func, startIndex = 0) {
+    return function (...args) {
+        const array = args[startIndex];
+        const params = args.slice(0, startIndex);
+        if (array) {
+            params.push(...array);
+        }
+        return func.apply(this, params);
+    };
+}
+
 exports.after = after;
 exports.ary = ary;
 exports.before = before;
@@ -180,5 +191,6 @@ exports.once = once;
 exports.partial = partial;
 exports.partialRight = partialRight;
 exports.rest = rest;
+exports.spread = spread;
 exports.throttle = throttle;
 exports.unary = unary;

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,11 @@
+/**
+ * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+ *
+ * @template F The type of the function to spread arguments over.
+ * @param {F} func The function to spread arguments over.
+ * @param {number} startIndex The start position of the spread.
+ * @returns {(...args: any[]) => ReturnType<F>} A new function that invokes `func` with the spread arguments.
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, startIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

package/dist/function/spread.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+ *
+ * @template F The type of the function to spread arguments over.
+ * @param {F} func The function to spread arguments over.
+ * @param {number} startIndex The start position of the spread.
+ * @returns {(...args: any[]) => ReturnType<F>} A new function that invokes `func` with the spread arguments.
+ */
+declare function spread<F extends (...args: any[]) => any>(func: F, startIndex?: number): (...args: any[]) => ReturnType<F>;
+
+export { spread };

package/dist/function/spread.mjs

@@ -0,0 +1,12 @@
+function spread(func, startIndex = 0) {
+    return function (...args) {
+        const array = args[startIndex];
+        const params = args.slice(0, startIndex);
+        if (array) {
+            params.push(...array);
+        }
+        return func.apply(this, params);
+    };
+}
+
+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

@@ -88,6 +88,7 @@ exports.once = function_index.once;
 exports.partial = function_index.partial;
 exports.partialRight = function_index.partialRight;
 exports.rest = function_index.rest;
+exports.spread = function_index.spread;
 exports.throttle = function_index.throttle;
 exports.unary = function_index.unary;
 exports.clamp = math_index.clamp;

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.509+1c748480",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {