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

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

@@ -1,11 +1,47 @@
 /**
- * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+ * 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 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.
+ * @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, startIndex?: number): (...args: any[]) => ReturnType<F>;
+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

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

package/dist/compat/function/spread.mjs

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

@@ -13,6 +13,7 @@ export { groupBy } from '../array/groupBy.mjs';
 export { intersection } from '../array/intersection.mjs';
 export { intersectionBy } from '../array/intersectionBy.mjs';
 export { intersectionWith } from '../array/intersectionWith.mjs';
+export { join } from '../array/join.mjs';
 export { keyBy } from '../array/keyBy.mjs';
 export { maxBy } from '../array/maxBy.mjs';
 export { minBy } from '../array/minBy.mjs';

package/dist/compat/index.d.ts

@@ -13,6 +13,7 @@ export { groupBy } from '../array/groupBy.js';
 export { intersection } from '../array/intersection.js';
 export { intersectionBy } from '../array/intersectionBy.js';
 export { intersectionWith } from '../array/intersectionWith.js';
+export { join } from '../array/join.js';
 export { keyBy } from '../array/keyBy.js';
 export { maxBy } from '../array/maxBy.js';
 export { minBy } from '../array/minBy.js';

package/dist/compat/index.js

@@ -2,9 +2,9 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const initial = require('../_chunk/initial-Ci2bn_.js');
+const initial = require('../_chunk/initial-L_KfII.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,15 +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, startIndex = 0) {
-    startIndex = Number.parseInt(startIndex, 10);
-    if (Number.isNaN(startIndex) || startIndex < 0) {
-        startIndex = 0;
+function spread(func, argsIndex = 0) {
+    argsIndex = Number.parseInt(argsIndex, 10);
+    if (Number.isNaN(argsIndex) || argsIndex < 0) {
+        argsIndex = 0;
     }
-    return function_index.spread(func, startIndex);
+    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) {
@@ -750,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) {
@@ -844,6 +851,7 @@ exports.intersection = initial.intersection;
 exports.intersectionBy = initial.intersectionBy;
 exports.intersectionWith = initial.intersectionWith;
 exports.isSubset = initial.isSubset;
+exports.join = initial.join;
 exports.keyBy = initial.keyBy;
 exports.last = initial.last;
 exports.maxBy = initial.maxBy;
@@ -880,17 +888,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;

package/dist/compat/index.mjs

@@ -13,6 +13,7 @@ export { groupBy } from '../array/groupBy.mjs';
 export { intersection } from '../array/intersection.mjs';
 export { intersectionBy } from '../array/intersectionBy.mjs';
 export { intersectionWith } from '../array/intersectionWith.mjs';
+export { join } from '../array/join.mjs';
 export { keyBy } from '../array/keyBy.mjs';
 export { maxBy } from '../array/maxBy.mjs';
 export { minBy } from '../array/minBy.mjs';

package/dist/function/index.js

@@ -2,195 +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]);
-    };
-}
-
-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;
-exports.debounce = debounce;
-exports.memoize = memoize;
-exports.negate = negate;
-exports.noop = noop;
-exports.once = once;
-exports.partial = partial;
-exports.partialRight = partialRight;
-exports.rest = rest;
+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;
-exports.throttle = throttle;
-exports.unary = unary;

package/dist/function/spread.d.mts

@@ -1,11 +1,19 @@
 /**
- * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function.
  *
- * @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.
+ * @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, startIndex?: number): (...args: any[]) => ReturnType<F>;
+declare function spread<F extends (...args: any[]) => any>(func: F): (argsArr: Parameters<F>) => ReturnType<F>;
 
 export { spread };

package/dist/function/spread.d.ts

@@ -1,11 +1,19 @@
 /**
- * Creates a function that invokes `func` with the `this` binding of the create function and an array of arguments much like `Function#apply`.
+Creates a new function that spreads elements of an array argument into individual arguments
+ * for the original function.
  *
- * @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.
+ * @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, startIndex?: number): (...args: any[]) => ReturnType<F>;
+declare function spread<F extends (...args: any[]) => any>(func: F): (argsArr: Parameters<F>) => ReturnType<F>;
 
 export { spread };

package/dist/function/spread.mjs

@@ -1,11 +1,6 @@
-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);
+function spread(func) {
+    return function (argsArr) {
+        return func.apply(this, argsArr);
     };
 }
 

package/dist/index.d.mts

@@ -18,6 +18,7 @@ export { groupBy } from './array/groupBy.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { maxBy } from './array/maxBy.mjs';
 export { minBy } from './array/minBy.mjs';

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export { groupBy } from './array/groupBy.js';
 export { intersection } from './array/intersection.js';
 export { intersectionBy } from './array/intersectionBy.js';
 export { intersectionWith } from './array/intersectionWith.js';
+export { join } from './array/join.js';
 export { keyBy } from './array/keyBy.js';
 export { maxBy } from './array/maxBy.js';
 export { minBy } from './array/minBy.js';

package/dist/index.js

@@ -2,9 +2,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const initial = require('./_chunk/initial-Ci2bn_.js');
+const initial = require('./_chunk/initial-L_KfII.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');
@@ -39,6 +40,7 @@ exports.intersection = initial.intersection;
 exports.intersectionBy = initial.intersectionBy;
 exports.intersectionWith = initial.intersectionWith;
 exports.isSubset = initial.isSubset;
+exports.join = initial.join;
 exports.keyBy = initial.keyBy;
 exports.last = initial.last;
 exports.maxBy = initial.maxBy;
@@ -77,20 +79,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.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.throttle = function_index.throttle;
-exports.unary = function_index.unary;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;
 exports.mean = math_index.mean;

package/dist/index.mjs

@@ -18,6 +18,7 @@ export { groupBy } from './array/groupBy.mjs';
 export { intersection } from './array/intersection.mjs';
 export { intersectionBy } from './array/intersectionBy.mjs';
 export { intersectionWith } from './array/intersectionWith.mjs';
+export { join } from './array/join.mjs';
 export { keyBy } from './array/keyBy.mjs';
 export { maxBy } from './array/maxBy.mjs';
 export { minBy } from './array/minBy.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.509+1c748480",
+  "version": "1.17.0-dev.511+3a6cb365",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {