es-toolkit 1.20.0 → 1.21.0-dev.662

package/dist/compat/array/castArray.d.mts

@@ -2,7 +2,7 @@
  * Casts value as an array if it's not one.
  *
  * @template T The type of elements in the array.
- * @param {T | readonly T[]} value The value to be cast to an array.
+ * @param {T | T[]} value The value to be cast to an array.
  * @returns {T[]} An array containing the input value if it wasn't an array, or the original array if it was.
  *
  * @example
@@ -15,7 +15,7 @@
  * const arr3 = castArray({'a': 1});
  * // Returns: [{'a': 1}]
  *
- * const arr4 =  castArray(null);
+ * const arr4 = castArray(null);
  * // Returns: [null]
  *
  * const arr5 = castArray(undefined);

package/dist/compat/array/castArray.d.ts

@@ -2,7 +2,7 @@
  * Casts value as an array if it's not one.
  *
  * @template T The type of elements in the array.
- * @param {T | readonly T[]} value The value to be cast to an array.
+ * @param {T | T[]} value The value to be cast to an array.
  * @returns {T[]} An array containing the input value if it wasn't an array, or the original array if it was.
  *
  * @example
@@ -15,7 +15,7 @@
  * const arr3 = castArray({'a': 1});
  * // Returns: [{'a': 1}]
  *
- * const arr4 =  castArray(null);
+ * const arr4 = castArray(null);
  * // Returns: [null]
  *
  * const arr5 = castArray(undefined);

package/dist/compat/array/flatten.mjs

@@ -5,7 +5,8 @@ function flatten(value, depth = 1) {
         return result;
     }
     const recursive = (arr, currentDepth) => {
-        for (const item of arr) {
+        for (let i = 0; i < arr.length; i++) {
+            const item = arr[i];
             if (currentDepth < flooredDepth &&
                 (Array.isArray(item) ||
                     Boolean(item?.[Symbol.isConcatSpreadable]) ||

package/dist/compat/function/curry.mjs

@@ -4,60 +4,52 @@ function curry(func, arity = func.length, guard) {
     if (Number.isNaN(arity) || arity < 1) {
         arity = 0;
     }
-    const wrapper = function (...partials) {
-        const holders = replaceHolders(partials);
-        const length = partials.length - holders.length;
+    const wrapper = function (...partialArgs) {
+        const holders = partialArgs.filter(item => item === curry.placeholder);
+        const length = partialArgs.length - holders.length;
         if (length < arity) {
-            return makeCurry(func, holders, arity - length, partials);
+            return makeCurry(func, arity - length, partialArgs);
         }
         if (this instanceof wrapper) {
-            return new func(...partials);
+            return new func(...partialArgs);
         }
-        return func.apply(this, partials);
+        return func.apply(this, partialArgs);
     };
     wrapper.placeholder = curryPlaceholder;
     return wrapper;
 }
-function makeCurry(func, holders, arity, partials) {
-    function wrapper(...args) {
-        const holdersCount = args.filter(item => item === curry.placeholder).length;
-        const length = args.length - holdersCount;
-        args = composeArgs(args, partials, holders);
+function makeCurry(func, arity, partialArgs) {
+    function wrapper(...providedArgs) {
+        const holders = providedArgs.filter(item => item === curry.placeholder);
+        const length = providedArgs.length - holders.length;
+        providedArgs = composeArgs(providedArgs, partialArgs);
         if (length < arity) {
-            const newHolders = replaceHolders(args);
-            return makeCurry(func, newHolders, arity - length, args);
+            return makeCurry(func, arity - length, providedArgs);
         }
         if (this instanceof wrapper) {
-            return new func(...args);
+            return new func(...providedArgs);
         }
-        return func.apply(this, args);
+        return func.apply(this, providedArgs);
     }
     wrapper.placeholder = curryPlaceholder;
     return wrapper;
 }
-function replaceHolders(args) {
-    const result = [];
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === curry.placeholder) {
-            result.push(i);
+function composeArgs(providedArgs, partialArgs) {
+    const args = [];
+    let startIndex = 0;
+    for (let i = 0; i < partialArgs.length; i++) {
+        const arg = partialArgs[i];
+        if (arg === curry.placeholder && startIndex < providedArgs.length) {
+            args.push(providedArgs[startIndex++]);
         }
-    }
-    return result;
-}
-function composeArgs(args, partials, holders) {
-    const result = [...partials];
-    const argsLength = args.length;
-    const holdersLength = holders.length;
-    let argsIndex = -1, leftIndex = partials.length, rangeLength = Math.max(argsLength - holdersLength, 0);
-    while (++argsIndex < holdersLength) {
-        if (argsIndex < argsLength) {
-            result[holders[argsIndex]] = args[argsIndex];
+        else {
+            args.push(arg);
         }
     }
-    while (rangeLength--) {
-        result[leftIndex++] = args[argsIndex++];
+    for (let i = startIndex; i < providedArgs.length; i++) {
+        args.push(providedArgs[i]);
     }
-    return result;
+    return args;
 }
 const curryPlaceholder = Symbol('curry.placeholder');
 curry.placeholder = curryPlaceholder;

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

@@ -0,0 +1,16 @@
+/**
+ * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
+ *
+ * @param {F} func The function to defer.
+ * @param {Parameters<F>} args The arguments to invoke `func` with.
+ * @returns {number} Returns the timer id.
+ *
+ * @example
+ * defer((text) => {
+ *   console.log(text);
+ * }, 'deferred');
+ * // => Logs 'deferred' after the current call stack has cleared.
+ */
+declare function defer<F extends (...args: any[]) => any>(func: F, ...args: Parameters<F>): number;
+
+export { defer };

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

@@ -0,0 +1,16 @@
+/**
+ * Defers invoking the `func` until the current call stack has cleared. Any additional arguments are provided to func when it's invoked.
+ *
+ * @param {F} func The function to defer.
+ * @param {Parameters<F>} args The arguments to invoke `func` with.
+ * @returns {number} Returns the timer id.
+ *
+ * @example
+ * defer((text) => {
+ *   console.log(text);
+ * }, 'deferred');
+ * // => Logs 'deferred' after the current call stack has cleared.
+ */
+declare function defer<F extends (...args: any[]) => any>(func: F, ...args: Parameters<F>): number;
+
+export { defer };

package/dist/compat/function/defer.mjs

@@ -0,0 +1,8 @@
+function defer(func, ...args) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    return setTimeout(func, 1, ...args);
+}
+
+export { defer };

package/dist/compat/index.d.mts

@@ -57,10 +57,8 @@ export { MemoizeCache, memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
-export { inRange } from '../math/inRange.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
-export { random } from '../math/random.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
@@ -70,11 +68,9 @@ export { pickBy } from '../object/pickBy.mjs';
 export { invert } from '../object/invert.mjs';
 export { clone } from '../object/clone.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
-export { cloneDeep } from '../object/cloneDeep.mjs';
 export { toMerged } from '../object/toMerged.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
-export { isNil } from '../predicate/isNil.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
 export { isUndefined } from '../predicate/isUndefined.mjs';
@@ -86,13 +82,13 @@ export { withTimeout } from '../promise/withTimeout.mjs';
 export { timeout } from '../promise/timeout.mjs';
 export { capitalize } from '../string/capitalize.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
+export { constantCase } from '../string/constantCase.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
 export { lowerFirst } from '../string/lowerFirst.mjs';
 export { deburr } from '../string/deburr.mjs';
 export { escape } from '../string/escape.mjs';
 export { escapeRegExp } from '../string/escapeRegExp.mjs';
 export { unescape } from '../string/unescape.mjs';
-export { pad } from '../string/pad.mjs';
 export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
@@ -115,6 +111,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { bindKey } from './function/bindKey.mjs';
+export { defer } from './function/defer.mjs';
 export { rest } from './function/rest.mjs';
 export { spread } from './function/spread.mjs';
 export { attempt } from './function/attempt.mjs';
@@ -134,6 +131,7 @@ export { merge } from './object/merge.mjs';
 export { mergeWith } from './object/mergeWith.mjs';
 export { fromPairs } from './object/fromPairs.mjs';
 export { unset } from './object/unset.mjs';
+export { cloneDeep } from './object/cloneDeep.mjs';
 export { isPlainObject } from './predicate/isPlainObject.mjs';
 export { isArray } from './predicate/isArray.mjs';
 export { isArguments } from './predicate/isArguments.mjs';
@@ -142,6 +140,8 @@ export { isSymbol } from './predicate/isSymbol.mjs';
 export { isObject } from './predicate/isObject.mjs';
 export { isObjectLike } from './predicate/isObjectLike.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
+export { isError } from './predicate/isError.mjs';
+export { isFinite } from './predicate/isFinite.mjs';
 export { isTypedArray } from './predicate/isTypedArray.mjs';
 export { isMatch } from './predicate/isMatch.mjs';
 export { isRegExp } from './predicate/isRegExp.mjs';
@@ -156,6 +156,8 @@ export { isInteger } from './predicate/isInteger.mjs';
 export { isSafeInteger } from './predicate/isSafeInteger.mjs';
 export { isNumber } from './predicate/isNumber.mjs';
 export { isNaN } from './predicate/isNaN.mjs';
+export { isArrayLikeObject } from './predicate/isArrayLikeObject.mjs';
+export { isNil } from './predicate/isNil.mjs';
 export { camelCase } from './string/camelCase.mjs';
 export { kebabCase } from './string/kebabCase.mjs';
 export { snakeCase } from './string/snakeCase.mjs';
@@ -164,6 +166,7 @@ export { lowerCase } from './string/lowerCase.mjs';
 export { upperCase } from './string/upperCase.mjs';
 export { startsWith } from './string/startsWith.mjs';
 export { endsWith } from './string/endsWith.mjs';
+export { pad } from './string/pad.mjs';
 export { padStart } from './string/padStart.mjs';
 export { padEnd } from './string/padEnd.mjs';
 export { repeat } from './string/repeat.mjs';
@@ -177,5 +180,10 @@ export { ceil } from './math/ceil.mjs';
 export { floor } from './math/floor.mjs';
 export { round } from './math/round.mjs';
 export { parseInt } from './math/parseInt.mjs';
+export { inRange } from './math/inRange.mjs';
+export { random } from './math/random.mjs';
 export { toPath } from './util/toPath.mjs';
 export { toString } from './util/toString.mjs';
+export { toNumber } from './util/toNumber.mjs';
+export { toInteger } from './util/toInteger.mjs';
+export { toFinite } from './util/toFinite.mjs';

package/dist/compat/index.d.ts

@@ -57,10 +57,8 @@ export { MemoizeCache, memoize } from '../function/memoize.js';
 export { unary } from '../function/unary.js';
 export { partial } from '../function/partial.js';
 export { partialRight } from '../function/partialRight.js';
-export { inRange } from '../math/inRange.js';
 export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
-export { random } from '../math/random.js';
 export { randomInt } from '../math/randomInt.js';
 export { sum } from '../math/sum.js';
 export { sumBy } from '../math/sumBy.js';
@@ -70,11 +68,9 @@ export { pickBy } from '../object/pickBy.js';
 export { invert } from '../object/invert.js';
 export { clone } from '../object/clone.js';
 export { flattenObject } from '../object/flattenObject.js';
-export { cloneDeep } from '../object/cloneDeep.js';
 export { toMerged } from '../object/toMerged.js';
 export { isDate } from '../predicate/isDate.js';
 export { isEqual } from '../predicate/isEqual.js';
-export { isNil } from '../predicate/isNil.js';
 export { isNotNil } from '../predicate/isNotNil.js';
 export { isNull } from '../predicate/isNull.js';
 export { isUndefined } from '../predicate/isUndefined.js';
@@ -86,13 +82,13 @@ export { withTimeout } from '../promise/withTimeout.js';
 export { timeout } from '../promise/timeout.js';
 export { capitalize } from '../string/capitalize.js';
 export { pascalCase } from '../string/pascalCase.js';
+export { constantCase } from '../string/constantCase.js';
 export { upperFirst } from '../string/upperFirst.js';
 export { lowerFirst } from '../string/lowerFirst.js';
 export { deburr } from '../string/deburr.js';
 export { escape } from '../string/escape.js';
 export { escapeRegExp } from '../string/escapeRegExp.js';
 export { unescape } from '../string/unescape.js';
-export { pad } from '../string/pad.js';
 export { castArray } from './array/castArray.js';
 export { chunk } from './array/chunk.js';
 export { concat } from './array/concat.js';
@@ -115,6 +111,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { ary } from './function/ary.js';
 export { bind } from './function/bind.js';
 export { bindKey } from './function/bindKey.js';
+export { defer } from './function/defer.js';
 export { rest } from './function/rest.js';
 export { spread } from './function/spread.js';
 export { attempt } from './function/attempt.js';
@@ -134,6 +131,7 @@ export { merge } from './object/merge.js';
 export { mergeWith } from './object/mergeWith.js';
 export { fromPairs } from './object/fromPairs.js';
 export { unset } from './object/unset.js';
+export { cloneDeep } from './object/cloneDeep.js';
 export { isPlainObject } from './predicate/isPlainObject.js';
 export { isArray } from './predicate/isArray.js';
 export { isArguments } from './predicate/isArguments.js';
@@ -142,6 +140,8 @@ export { isSymbol } from './predicate/isSymbol.js';
 export { isObject } from './predicate/isObject.js';
 export { isObjectLike } from './predicate/isObjectLike.js';
 export { isBoolean } from './predicate/isBoolean.js';
+export { isError } from './predicate/isError.js';
+export { isFinite } from './predicate/isFinite.js';
 export { isTypedArray } from './predicate/isTypedArray.js';
 export { isMatch } from './predicate/isMatch.js';
 export { isRegExp } from './predicate/isRegExp.js';
@@ -156,6 +156,8 @@ export { isInteger } from './predicate/isInteger.js';
 export { isSafeInteger } from './predicate/isSafeInteger.js';
 export { isNumber } from './predicate/isNumber.js';
 export { isNaN } from './predicate/isNaN.js';
+export { isArrayLikeObject } from './predicate/isArrayLikeObject.js';
+export { isNil } from './predicate/isNil.js';
 export { camelCase } from './string/camelCase.js';
 export { kebabCase } from './string/kebabCase.js';
 export { snakeCase } from './string/snakeCase.js';
@@ -164,6 +166,7 @@ export { lowerCase } from './string/lowerCase.js';
 export { upperCase } from './string/upperCase.js';
 export { startsWith } from './string/startsWith.js';
 export { endsWith } from './string/endsWith.js';
+export { pad } from './string/pad.js';
 export { padStart } from './string/padStart.js';
 export { padEnd } from './string/padEnd.js';
 export { repeat } from './string/repeat.js';
@@ -177,5 +180,10 @@ export { ceil } from './math/ceil.js';
 export { floor } from './math/floor.js';
 export { round } from './math/round.js';
 export { parseInt } from './math/parseInt.js';
+export { inRange } from './math/inRange.js';
+export { random } from './math/random.js';
 export { toPath } from './util/toPath.js';
 export { toString } from './util/toString.js';
+export { toNumber } from './util/toNumber.js';
+export { toInteger } from './util/toInteger.js';
+export { toFinite } from './util/toFinite.js';