es-toolkit 1.21.0 → 1.22.0-dev.688

package/dist/compat/index.js

@@ -2,15 +2,15 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('../_chunk/zipWith-DEcUS4.js');
+const zipWith = require('../_chunk/zipWith-EOU_KZ.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const rest$1 = require('../_chunk/rest-pUyjvl.js');
+const flowRight = require('../_chunk/flowRight-BzdOZX.js');
 const range = require('../_chunk/range-BXlMmn.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-D-sLFv.js');
+const toMerged = require('../_chunk/toMerged-2WPeoI.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-BIekvL.js');
-const isWeakSet$1 = require('../_chunk/isWeakSet-1xFSnK.js');
-const string_index = require('../string/index.js');
+const isWeakSet$1 = require('../_chunk/isWeakSet-clQklw.js');
+const pad$1 = require('../_chunk/pad-Cw2pvt.js');
 
 function castArray(value) {
     if (arguments.length === 0) {
@@ -45,18 +45,6 @@ function drop(collection, itemsCount) {
     return collection.slice(itemsCount);
 }
 
-function fill(array, value, start = 0, end = array.length) {
-    start = Math.floor(start);
-    end = Math.floor(end);
-    if (!start) {
-        start = 0;
-    }
-    if (!end) {
-        end = 0;
-    }
-    return zipWith.fill(array, value, start, end);
-}
-
 function isDeepKey(key) {
     switch (typeof key) {
         case 'number':
@@ -380,6 +368,86 @@ function matchesProperty(property, source) {
     };
 }
 
+function dropWhile(arr, predicate) {
+    switch (typeof predicate) {
+        case 'function': {
+            return zipWith.dropWhile(arr, (item, index, arr) => Boolean(predicate(item, index, arr)));
+        }
+        case 'object': {
+            if (Array.isArray(predicate) && predicate.length === 2) {
+                const key = predicate[0];
+                const value = predicate[1];
+                return zipWith.dropWhile(arr, matchesProperty(key, value));
+            }
+            else {
+                return zipWith.dropWhile(arr, matches(predicate));
+            }
+        }
+        case 'string': {
+            return zipWith.dropWhile(arr, property(predicate));
+        }
+    }
+}
+
+function identity(x) {
+    return x;
+}
+
+function every(source, doesMatch) {
+    if (!source) {
+        source = [];
+    }
+    let values = source;
+    if (!Array.isArray(source)) {
+        values = Object.values(source);
+    }
+    if (!doesMatch) {
+        doesMatch = identity;
+    }
+    switch (typeof doesMatch) {
+        case 'function': {
+            if (!Array.isArray(source)) {
+                const entries = Object.entries(source);
+                for (let i = 0; i < entries.length; i++) {
+                    const entry = entries[i];
+                    const key = entry[0];
+                    const value = entry[1];
+                    if (!doesMatch(value, key, source)) {
+                        return false;
+                    }
+                }
+                return true;
+            }
+            return values.every(doesMatch);
+        }
+        case 'object': {
+            if (Array.isArray(doesMatch) && doesMatch.length === 2) {
+                const key = doesMatch[0];
+                const value = doesMatch[1];
+                return values.every(matchesProperty(key, value));
+            }
+            else {
+                return values.every(matches(doesMatch));
+            }
+        }
+        case 'string': {
+            return values.every(property(doesMatch));
+        }
+    }
+}
+
+function fill(array, value, start = 0, end = array.length) {
+    start = Math.floor(start);
+    end = Math.floor(end);
+    if (!start) {
+        start = 0;
+    }
+    if (!end) {
+        end = 0;
+    }
+    return zipWith.fill(array, value, start, end);
+}
+
 function find(source, doesMatch) {
     let values = source;
     if (!Array.isArray(source)) {
@@ -503,6 +571,77 @@ function flattenDepth(value, depth = 1) {
     return flatten(value, depth);
 }
 
+function isString(value) {
+    return typeof value === 'string' || value instanceof String;
+}
+
+function isSymbol(value) {
+    return typeof value === 'symbol' || value instanceof Symbol;
+}
+
+function toNumber(value) {
+    if (isSymbol(value)) {
+        return NaN;
+    }
+    return Number(value);
+}
+
+function toFinite(value) {
+    if (!value) {
+        return value === 0 ? value : 0;
+    }
+    value = toNumber(value);
+    if (value === Infinity || value === -Infinity) {
+        const sign = value < 0 ? -1 : 1;
+        return sign * Number.MAX_VALUE;
+    }
+    return value === value ? value : 0;
+}
+
+function toInteger(value) {
+    const finite = toFinite(value);
+    const remainder = finite % 1;
+    return remainder ? finite - remainder : finite;
+}
+
+function includes(source, target, fromIndex, guard) {
+    if (source == null) {
+        return false;
+    }
+    if (guard || !fromIndex) {
+        fromIndex = 0;
+    }
+    else {
+        fromIndex = toInteger(fromIndex);
+    }
+    if (isString(source)) {
+        if (fromIndex > source.length || target instanceof RegExp) {
+            return false;
+        }
+        if (fromIndex < 0) {
+            fromIndex = Math.max(0, source.length + fromIndex);
+        }
+        return source.includes(target, fromIndex);
+    }
+    if (Array.isArray(source)) {
+        return source.includes(target, fromIndex);
+    }
+    const keys = [];
+    for (const key in source) {
+        keys.push(key);
+    }
+    if (fromIndex < 0) {
+        fromIndex = Math.max(0, keys.length + fromIndex);
+    }
+    for (let i = fromIndex; i < keys.length; i++) {
+        const value = Reflect.get(source, keys[i]);
+        if (value === target || (Number.isNaN(value) && Number.isNaN(target))) {
+            return true;
+        }
+    }
+    return false;
+}
+
 function indexOf(array, searchElement, fromIndex) {
     if (array == null) {
         return -1;
@@ -561,10 +700,6 @@ const compareValues = (a, b, order) => {
     return 0;
 };
 
-function isSymbol(value) {
-    return typeof value === 'symbol' || value instanceof Symbol;
-}
-
 const regexIsDeepProp = /\.|\[(?:[^[\]]*|(["'])(?:(?!\1)[^\\]|\\.)*?\1)\]/;
 const regexIsPlainProp = /^\w*$/;
 function isKey(value, object) {
@@ -661,10 +796,6 @@ function size(target) {
     return Object.keys(target).length;
 }
 
-function identity(x) {
-    return x;
-}
-
 function some(arr, predicate, guard) {
     if (guard != null) {
         predicate = undefined;
@@ -723,6 +854,30 @@ function zipObjectDeep(keys, values) {
     return result;
 }
 
+function isArray(value) {
+    return Array.isArray(value);
+}
+
+function filter(source, predicate) {
+    if (!predicate) {
+        predicate = identity;
+    }
+    const collection = isArray(source) ? source : Object.values(source);
+    switch (typeof predicate) {
+        case 'function': {
+            return collection.filter(predicate);
+        }
+        case 'object': {
+            return isArray(predicate)
+                ? collection.filter(matchesProperty(predicate[0], predicate[1]))
+                : collection.filter(matches(predicate));
+        }
+        case 'string': {
+            return collection.filter(property(predicate));
+        }
+    }
+}
+
 function ary(func, n = func.length, guard) {
     if (guard) {
         n = func.length;
@@ -730,7 +885,7 @@ function ary(func, n = func.length, guard) {
     if (Number.isNaN(n) || n < 0) {
         n = 0;
     }
-    return rest$1.ary(func, n);
+    return flowRight.ary(func, n);
 }
 
 function bind(func, thisObj, ...partialArgs) {
@@ -797,7 +952,7 @@ function rest(func, start = func.length - 1) {
     if (Number.isNaN(start) || start < 0) {
         start = func.length - 1;
     }
-    return rest$1.rest(func, start);
+    return flowRight.rest(func, start);
 }
 
 function spread(func, argsIndex = 0) {
@@ -905,7 +1060,7 @@ function debounce(func, debounceMs = 0, options = {}) {
     }
     let result = undefined;
     let pendingAt = null;
-    const _debounced = rest$1.debounce(function (...args) {
+    const _debounced = flowRight.debounce(function (...args) {
         result = func.apply(this, args);
         pendingAt = null;
     }, debounceMs, { signal, edges });
@@ -944,6 +1099,12 @@ function throttle(func, throttleMs = 0, options = {}) {
     return debounce(func, throttleMs, { leading, trailing, signal, maxWait: throttleMs });
 }
 
+function flip(func) {
+    return function (...args) {
+        return func.apply(this, args.reverse());
+    };
+}
+
 function isNil(x) {
     return x == null;
 }
@@ -1211,7 +1372,7 @@ function mergeWithDeep(target, source, merge, stack) {
 }
 
 function merge(object, ...sources) {
-    return mergeWith(object, ...sources, rest$1.noop);
+    return mergeWith(object, ...sources, flowRight.noop);
 }
 
 function isArrayLike(value) {
@@ -1229,10 +1390,6 @@ function fromPairs(pairs) {
     return result;
 }
 
-function isArray(value) {
-    return Array.isArray(value);
-}
-
 function isObject(value) {
     return value !== null && (typeof value === 'object' || typeof value === 'function');
 }
@@ -1253,10 +1410,6 @@ function isRegExp(value) {
     return isWeakSet$1.isRegExp(value);
 }
 
-function isString(value) {
-    return typeof value === 'string' || value instanceof String;
-}
-
 function isWeakMap(value) {
     return isWeakSet$1.isWeakMap(value);
 }
@@ -1333,27 +1486,41 @@ function normalizeForCase(str) {
 }
 
 function camelCase(str) {
-    return string_index.camelCase(normalizeForCase(str));
+    return pad$1.camelCase(normalizeForCase(str));
 }
 
 function kebabCase(str) {
-    return string_index.kebabCase(normalizeForCase(str));
+    return pad$1.kebabCase(normalizeForCase(str));
 }
 
 function snakeCase(str) {
-    return string_index.snakeCase(normalizeForCase(str));
+    return pad$1.snakeCase(normalizeForCase(str));
 }
 
 function startCase(str) {
-    return string_index.startCase(normalizeForCase(str));
+    const words = pad$1.getWords(normalizeForCase(str).trim());
+    let result = '';
+    for (let i = 0; i < words.length; i++) {
+        const word = words[i];
+        if (result) {
+            result += ' ';
+        }
+        if (word === word.toUpperCase()) {
+            result += word;
+        }
+        else {
+            result += word[0].toUpperCase() + word.slice(1).toLowerCase();
+        }
+    }
+    return result;
 }
 
 function lowerCase(str) {
-    return string_index.lowerCase(normalizeForCase(str));
+    return pad$1.lowerCase(normalizeForCase(str));
 }
 
 function upperCase(str) {
-    return string_index.upperCase(normalizeForCase(str));
+    return pad$1.upperCase(normalizeForCase(str));
 }
 
 function startsWith(str, target, position = 0) {
@@ -1365,7 +1532,7 @@ function endsWith(str, target, position = str.length) {
 }
 
 function pad(str, length, chars = ' ') {
-    return string_index.pad(toString(str), length, chars);
+    return pad$1.pad(toString(str), length, chars);
 }
 
 function padStart(str, length = 0, chars = ' ') {
@@ -1389,14 +1556,14 @@ function trim(str, chars, guard) {
     }
     switch (typeof chars) {
         case 'string': {
-            return string_index.trim(str, chars.toString().split(''));
+            return pad$1.trim(str, chars.toString().split(''));
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return string_index.trim(str, chars.map(x => x.toString()));
+                return pad$1.trim(str, chars.map(x => x.toString()));
             }
             else {
-                return string_index.trim(str, chars.toString().split(''));
+                return pad$1.trim(str, chars.toString().split(''));
             }
         }
     }
@@ -1411,14 +1578,14 @@ function trimStart(str, chars, guard) {
     }
     switch (typeof chars) {
         case 'string': {
-            return string_index.trimStart(str, chars.toString().split(''));
+            return pad$1.trimStart(str, chars.toString().split(''));
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return string_index.trimStart(str, chars.map(x => x.toString()));
+                return pad$1.trimStart(str, chars.map(x => x.toString()));
             }
             else {
-                return string_index.trimStart(str, chars.toString().split(''));
+                return pad$1.trimStart(str, chars.toString().split(''));
             }
         }
     }
@@ -1433,14 +1600,14 @@ function trimEnd(str, chars, guard) {
     }
     switch (typeof chars) {
         case 'string': {
-            return string_index.trimEnd(str, chars.toString().split(''));
+            return pad$1.trimEnd(str, chars.toString().split(''));
         }
         case 'object': {
             if (Array.isArray(chars)) {
-                return string_index.trimEnd(str, chars.map(x => x.toString()));
+                return pad$1.trimEnd(str, chars.map(x => x.toString()));
             }
             else {
-                return string_index.trimEnd(str, chars.toString().split(''));
+                return pad$1.trimEnd(str, chars.toString().split(''));
             }
         }
     }
@@ -1609,31 +1776,6 @@ function random(...args) {
     }
 }
 
-function toNumber(value) {
-    if (isSymbol(value)) {
-        return NaN;
-    }
-    return Number(value);
-}
-
-function toFinite(value) {
-    if (!value) {
-        return value === 0 ? value : 0;
-    }
-    value = toNumber(value);
-    if (value === Infinity || value === -Infinity) {
-        const sign = value < 0 ? -1 : 1;
-        return sign * Number.MAX_VALUE;
-    }
-    return value === value ? value : 0;
-}
-
-function toInteger(value) {
-    const finite = toFinite(value);
-    const remainder = finite % 1;
-    return remainder ? finite - remainder : finite;
-}
-
 exports.at = zipWith.at;
 exports.compact = zipWith.compact;
 exports.countBy = zipWith.countBy;
@@ -1641,7 +1783,6 @@ exports.differenceBy = zipWith.differenceBy;
 exports.differenceWith = zipWith.differenceWith;
 exports.dropRight = zipWith.dropRight;
 exports.dropRightWhile = zipWith.dropRightWhile;
-exports.dropWhile = zipWith.dropWhile;
 exports.first = zipWith.head;
 exports.flatMap = zipWith.flatMap;
 exports.flatMapDeep = zipWith.flatMapDeep;
@@ -1688,15 +1829,17 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
-exports.after = rest$1.after;
-exports.before = rest$1.before;
-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.unary = rest$1.unary;
+exports.after = flowRight.after;
+exports.before = flowRight.before;
+exports.flow = flowRight.flow;
+exports.flowRight = flowRight.flowRight;
+exports.memoize = flowRight.memoize;
+exports.negate = flowRight.negate;
+exports.noop = flowRight.noop;
+exports.once = flowRight.once;
+exports.partial = flowRight.partial;
+exports.partialRight = flowRight.partialRight;
+exports.unary = flowRight.unary;
 exports.mean = range.mean;
 exports.meanBy = range.meanBy;
 exports.range = range.range;
@@ -1715,18 +1858,20 @@ exports.isDate = isWeakSet$1.isDate;
 exports.isEqual = isWeakSet$1.isEqual;
 exports.isFunction = isWeakSet$1.isFunction;
 exports.isLength = isWeakSet$1.isLength;
+exports.isMap = isWeakSet$1.isMap;
 exports.isNotNil = isWeakSet$1.isNotNil;
 exports.isNull = isWeakSet$1.isNull;
+exports.isSet = isWeakSet$1.isSet;
 exports.isUndefined = isWeakSet$1.isUndefined;
-exports.capitalize = string_index.capitalize;
-exports.constantCase = string_index.constantCase;
-exports.deburr = string_index.deburr;
-exports.escape = string_index.escape;
-exports.escapeRegExp = string_index.escapeRegExp;
-exports.lowerFirst = string_index.lowerFirst;
-exports.pascalCase = string_index.pascalCase;
-exports.unescape = string_index.unescape;
-exports.upperFirst = string_index.upperFirst;
+exports.capitalize = pad$1.capitalize;
+exports.constantCase = pad$1.constantCase;
+exports.deburr = pad$1.deburr;
+exports.escape = pad$1.escape;
+exports.escapeRegExp = pad$1.escapeRegExp;
+exports.lowerFirst = pad$1.lowerFirst;
+exports.pascalCase = pad$1.pascalCase;
+exports.unescape = pad$1.unescape;
+exports.upperFirst = pad$1.upperFirst;
 exports.ary = ary;
 exports.attempt = attempt;
 exports.bind = bind;
@@ -1745,19 +1890,24 @@ exports.debounce = debounce;
 exports.defer = defer;
 exports.difference = difference;
 exports.drop = drop;
+exports.dropWhile = dropWhile;
 exports.endsWith = endsWith;
+exports.every = every;
 exports.fill = fill;
+exports.filter = filter;
 exports.find = find;
 exports.findIndex = findIndex;
 exports.findLastIndex = findLastIndex;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
 exports.flattenDepth = flattenDepth;
+exports.flip = flip;
 exports.floor = floor;
 exports.fromPairs = fromPairs;
 exports.get = get;
 exports.has = has;
 exports.inRange = inRange;
+exports.includes = includes;
 exports.indexOf = indexOf;
 exports.isArguments = isArguments;
 exports.isArray = isArray;

package/dist/compat/index.mjs

@@ -5,7 +5,6 @@ export { differenceBy } from '../array/differenceBy.mjs';
 export { differenceWith } from '../array/differenceWith.mjs';
 export { dropRight } from '../array/dropRight.mjs';
 export { dropRightWhile } from '../array/dropRightWhile.mjs';
-export { dropWhile } from '../array/dropWhile.mjs';
 export { flatMap } from '../array/flatMap.mjs';
 export { flatMapDeep } from '../array/flatMapDeep.mjs';
 export { forEachRight } from '../array/forEachRight.mjs';
@@ -57,6 +56,8 @@ export { memoize } from '../function/memoize.mjs';
 export { unary } from '../function/unary.mjs';
 export { partial } from '../function/partial.mjs';
 export { partialRight } from '../function/partialRight.mjs';
+export { flow } from '../function/flow.mjs';
+export { flowRight } from '../function/flowRight.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
@@ -73,11 +74,13 @@ export { isObjectLike } from './predicate/isObjectLike.mjs';
 export { toMerged } from '../object/toMerged.mjs';
 export { isDate } from '../predicate/isDate.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
+export { isMap } from '../predicate/isMap.mjs';
 export { isNotNil } from '../predicate/isNotNil.mjs';
 export { isNull } from '../predicate/isNull.mjs';
 export { isUndefined } from '../predicate/isUndefined.mjs';
 export { isLength } from '../predicate/isLength.mjs';
 export { isFunction } from '../predicate/isFunction.mjs';
+export { isSet } from '../predicate/isSet.mjs';
 export { delay } from '../promise/delay.mjs';
 export { withTimeout } from '../promise/withTimeout.mjs';
 export { timeout } from '../promise/timeout.mjs';
@@ -95,6 +98,8 @@ export { chunk } from './array/chunk.mjs';
 export { concat } from './array/concat.mjs';
 export { difference } from './array/difference.mjs';
 export { drop } from './array/drop.mjs';
+export { dropWhile } from './array/dropWhile.mjs';
+export { every } from './array/every.mjs';
 export { fill } from './array/fill.mjs';
 export { find } from './array/find.mjs';
 export { findIndex } from './array/findIndex.mjs';
@@ -102,6 +107,7 @@ export { findLastIndex } from './array/findLastIndex.mjs';
 export { flatten } from './array/flatten.mjs';
 export { flattenDeep } from './array/flattenDeep.mjs';
 export { flattenDepth } from './array/flattenDepth.mjs';
+export { includes } from './array/includes.mjs';
 export { indexOf } from './array/indexOf.mjs';
 export { join } from './array/join.mjs';
 export { orderBy } from './array/orderBy.mjs';
@@ -109,6 +115,7 @@ export { sortBy } from './array/sortBy.mjs';
 export { size } from './array/size.mjs';
 export { some } from './array/some.mjs';
 export { zipObjectDeep } from './array/zipObjectDeep.mjs';
+export { filter } from './array/filter.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
 export { bindKey } from './function/bindKey.mjs';
@@ -120,6 +127,7 @@ export { rearg } from './function/rearg.mjs';
 export { curry } from './function/curry.mjs';
 export { debounce } from './function/debounce.mjs';
 export { throttle } from './function/throttle.mjs';
+export { flip } from './function/flip.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { pick } from './object/pick.mjs';

package/dist/compat/string/startCase.mjs

@@ -1,8 +1,22 @@
-import { startCase as startCase$1 } from '../../string/startCase.mjs';
+import { getWords } from '../../string/_internal/getWords.mjs';
 import { normalizeForCase } from '../_internal/normalizeForCase.mjs';
 
 function startCase(str) {
-    return startCase$1(normalizeForCase(str));
+    const words = getWords(normalizeForCase(str).trim());
+    let result = '';
+    for (let i = 0; i < words.length; i++) {
+        const word = words[i];
+        if (result) {
+            result += ' ';
+        }
+        if (word === word.toUpperCase()) {
+            result += word;
+        }
+        else {
+            result += word[0].toUpperCase() + word.slice(1).toLowerCase();
+        }
+    }
+    return result;
 }
 
 export { startCase };

package/dist/compat/util/toInteger.d.mts

@@ -1,6 +1,9 @@
 /**
  * Converts `value` to an integer.
  *
+ * This function first converts `value` to a finite number. If the result has any decimal places,
+ * they are removed by rounding down to the nearest whole number.
+ *
  * @param {unknown} value - The value to convert.
  * @returns {number} Returns the number.
  *

package/dist/compat/util/toInteger.d.ts

@@ -1,6 +1,9 @@
 /**
  * Converts `value` to an integer.
  *
+ * This function first converts `value` to a finite number. If the result has any decimal places,
+ * they are removed by rounding down to the nearest whole number.
+ *
  * @param {unknown} value - The value to convert.
  * @returns {number} Returns the number.
  *