es-toolkit 1.26.1 → 1.27.0-dev.876

package/dist/compat/index.js

@@ -2,16 +2,16 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('../_chunk/zipWith-Dkv3D1.js');
+const zipWith = require('../_chunk/zipWith-Bb2eZI.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
 const unary = require('../_chunk/unary-CcTNuC.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const sumBy = require('../_chunk/sumBy-RVppiV.js');
+const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-wNz52b.js');
+const toMerged = require('../_chunk/toMerged-CPY8Ug.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
 const isWeakSet$1 = require('../_chunk/isWeakSet-D8h8bS.js');
-const upperFirst = require('../_chunk/upperFirst-BUECmK.js');
+const upperFirst = require('../_chunk/upperFirst-DK_rTF.js');
 const util_index = require('../util/index.js');
 
 function castArray(value) {
@@ -21,6 +21,10 @@ function castArray(value) {
     return Array.isArray(value) ? value : [value];
 }
 
+function toArray(value) {
+    return Array.isArray(value) ? value : Array.from(value);
+}
+
 function isArrayLike(value) {
     return value != null && typeof value !== 'function' && isWeakSet$1.isLength(value.length);
 }
@@ -30,7 +34,7 @@ function chunk(arr, size = 1) {
     if (size === 0 || !isArrayLike(arr)) {
         return [];
     }
-    return zipWith.chunk(Array.from(arr), size);
+    return zipWith.chunk(toArray(arr), size);
 }
 
 function compact(arr) {
@@ -52,7 +56,7 @@ function difference(arr, ...values) {
     if (!isArrayLikeObject(arr)) {
         return [];
     }
-    const arr1 = Array.from(arr);
+    const arr1 = toArray(arr);
     const arr2 = [];
     for (let i = 0; i < values.length; i++) {
         const value = values[i];
@@ -63,49 +67,25 @@ function difference(arr, ...values) {
     return zipWith.difference(arr1, arr2);
 }
 
-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 drop(collection, itemsCount = 1, guard) {
-    if (!isArrayLike(collection)) {
-        return [];
+function last(array) {
+    if (!isArrayLike(array)) {
+        return undefined;
     }
-    itemsCount = guard ? 1 : toInteger(itemsCount);
-    return zipWith.drop(Array.from(collection), itemsCount);
+    return zipWith.last(toArray(array));
 }
 
-function dropRight(collection, itemsCount = 1, guard) {
-    if (!isArrayLike(collection)) {
-        return [];
+function flattenArrayLike(values) {
+    const result = [];
+    for (let i = 0; i < values.length; i++) {
+        const arrayLike = values[i];
+        if (!isArrayLikeObject(arrayLike)) {
+            continue;
+        }
+        for (let j = 0; j < arrayLike.length; j++) {
+            result.push(arrayLike[j]);
+        }
     }
-    itemsCount = guard ? 1 : toInteger(itemsCount);
-    return zipWith.dropRight(Array.from(collection), itemsCount);
+    return result;
 }
 
 function isDeepKey(key) {
@@ -127,37 +107,68 @@ function toKey(value) {
     return value.toString();
 }
 
-const DOTS_KEY = /^[\w.]+$/g;
-const ESCAPE_REGEXP = /\\(\\)?/g;
-const PROPERTY_REGEXP = RegExp('[^.[\\]]+' +
-    '|' +
-    '\\[(?:' +
-    '([^"\'][^[]*)' +
-    '|' +
-    '(["\'])((?:(?!\\2)[^\\\\]|\\\\.)*?)\\2' +
-    ')\\]' +
-    '|' +
-    '(?=(?:\\.|\\[\\])(?:\\.|\\[\\]|$))', 'g');
 function toPath(deepKey) {
-    if (DOTS_KEY.test(deepKey)) {
-        return deepKey.split('.');
-    }
     const result = [];
-    if (deepKey[0] === '.') {
+    const length = deepKey.length;
+    if (length === 0) {
+        return result;
+    }
+    let index = 0;
+    let key = '';
+    let quoteChar = '';
+    let bracket = false;
+    if (deepKey.charCodeAt(0) === 46) {
         result.push('');
+        index++;
     }
-    const matches = deepKey.matchAll(PROPERTY_REGEXP);
-    for (const match of matches) {
-        let key = match[0];
-        const expr = match[1];
-        const quote = match[2];
-        const substr = match[3];
-        if (quote) {
-            key = substr.replace(ESCAPE_REGEXP, '$1');
+    while (index < length) {
+        const char = deepKey[index];
+        if (quoteChar) {
+            if (char === '\\' && index + 1 < length) {
+                index++;
+                key += deepKey[index];
+            }
+            else if (char === quoteChar) {
+                quoteChar = '';
+            }
+            else {
+                key += char;
+            }
         }
-        else if (expr) {
-            key = expr;
+        else if (bracket) {
+            if (char === '"' || char === "'") {
+                quoteChar = char;
+            }
+            else if (char === ']') {
+                bracket = false;
+                result.push(key);
+                key = '';
+            }
+            else {
+                key += char;
+            }
         }
+        else {
+            if (char === '[') {
+                bracket = true;
+                if (key) {
+                    result.push(key);
+                    key = '';
+                }
+            }
+            else if (char === '.') {
+                if (key) {
+                    result.push(key);
+                    key = '';
+                }
+            }
+            else {
+                key += char;
+            }
+        }
+        index++;
+    }
+    if (key) {
         result.push(key);
     }
     return result;
@@ -441,6 +452,85 @@ function matchesProperty(property, source) {
     };
 }
 
+function iteratee(value) {
+    if (value == null) {
+        return unary.identity;
+    }
+    switch (typeof value) {
+        case 'function': {
+            return value;
+        }
+        case 'object': {
+            if (Array.isArray(value) && value.length === 2) {
+                return matchesProperty(value[0], value[1]);
+            }
+            return matches(value);
+        }
+        case 'string':
+        case 'symbol':
+        case 'number': {
+            return property(value);
+        }
+    }
+}
+
+function differenceBy(arr, ..._values) {
+    if (!isArrayLikeObject(arr)) {
+        return [];
+    }
+    const iteratee$1 = last(_values);
+    const values = flattenArrayLike(_values);
+    if (isArrayLikeObject(iteratee$1)) {
+        return zipWith.difference(Array.from(arr), values);
+    }
+    return zipWith.differenceBy(Array.from(arr), values, iteratee(iteratee$1));
+}
+
+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 drop(collection, itemsCount = 1, guard) {
+    if (!isArrayLike(collection)) {
+        return [];
+    }
+    itemsCount = guard ? 1 : toInteger(itemsCount);
+    return zipWith.drop(toArray(collection), itemsCount);
+}
+
+function dropRight(collection, itemsCount = 1, guard) {
+    if (!isArrayLike(collection)) {
+        return [];
+    }
+    itemsCount = guard ? 1 : toInteger(itemsCount);
+    return zipWith.dropRight(toArray(collection), itemsCount);
+}
+
 function dropRightWhile(arr, predicate) {
     if (!isArrayLike(arr)) {
         return [];
@@ -472,7 +562,7 @@ function dropWhile(arr, predicate) {
     if (!isArrayLike(arr)) {
         return [];
     }
-    return dropWhileImpl(Array.from(arr), predicate);
+    return dropWhileImpl(toArray(arr), predicate);
 }
 function dropWhileImpl(arr, predicate) {
     switch (typeof predicate) {
@@ -687,7 +777,7 @@ function findLastIndex(arr, doesMatch, fromIndex = arr ? arr.length - 1 : 0) {
     else {
         fromIndex = Math.min(fromIndex, arr.length - 1);
     }
-    const subArray = Array.from(arr).slice(0, fromIndex + 1);
+    const subArray = toArray(arr).slice(0, fromIndex + 1);
     switch (typeof doesMatch) {
         case 'function': {
             return subArray.findLastIndex(doesMatch);
@@ -745,11 +835,27 @@ function flattenDepth(value, depth = 1) {
     return flatten(value, depth);
 }
 
+function forEach(collection, callback = unary.identity) {
+    if (!collection) {
+        return collection;
+    }
+    const keys = isArrayLike(collection) || Array.isArray(collection) ? rangeRight.range(0, collection.length) : Object.keys(collection);
+    for (let i = 0; i < keys.length; i++) {
+        const key = keys[i];
+        const value = collection[key];
+        const result = callback(value, key, collection);
+        if (result === false) {
+            break;
+        }
+    }
+    return collection;
+}
+
 function head(arr) {
     if (!isArrayLike(arr)) {
         return undefined;
     }
-    return zipWith.head(Array.from(arr));
+    return zipWith.head(toArray(arr));
 }
 
 function includes(source, target, fromIndex, guard) {
@@ -859,13 +965,6 @@ function join(array, separator = ',') {
     return Array.from(array).join(separator);
 }
 
-function last(array) {
-    if (!isArrayLike(array)) {
-        return undefined;
-    }
-    return zipWith.last(Array.from(array));
-}
-
 function getPriority(a) {
     if (typeof a === 'symbol') {
         return 1;
@@ -992,7 +1091,7 @@ function sample(collection) {
         return undefined;
     }
     if (isArrayLike(collection)) {
-        return zipWith.sample(Array.from(collection));
+        return zipWith.sample(toArray(collection));
     }
     return zipWith.sample(Object.values(collection));
 }
@@ -1098,7 +1197,7 @@ function tail(arr) {
     if (!isArrayLike(arr)) {
         return [];
     }
-    return zipWith.tail(Array.from(arr));
+    return zipWith.tail(toArray(arr));
 }
 
 function take(arr, count = 1, guard) {
@@ -1106,7 +1205,7 @@ function take(arr, count = 1, guard) {
     if (count < 1 || !isArrayLike(arr)) {
         return [];
     }
-    return zipWith.take(Array.from(arr), count);
+    return zipWith.take(toArray(arr), count);
 }
 
 function takeRight(arr, count = 1, guard) {
@@ -1114,7 +1213,13 @@ function takeRight(arr, count = 1, guard) {
     if (count <= 0 || !isArrayLike(arr)) {
         return [];
     }
-    return zipWith.takeRight(Array.from(arr), count);
+    return zipWith.takeRight(toArray(arr), count);
+}
+
+function union(...arrays) {
+    const validArrays = arrays.filter(isArrayLikeObject);
+    const flattened = flatten(validArrays, 1);
+    return zipWith.uniq(flattened);
 }
 
 function uniq(arr) {
@@ -1124,6 +1229,33 @@ function uniq(arr) {
     return zipWith.uniq(Array.from(arr));
 }
 
+function uniqBy(arr, ...values) {
+    if (!isArrayLikeObject(arr)) {
+        return [];
+    }
+    const iteratee$1 = last(values);
+    if (iteratee$1 === undefined) {
+        return Array.from(arr);
+    }
+    const validArrays = values.slice(0, -1).filter(isArrayLikeObject);
+    const flattenedArrays = flatten(validArrays);
+    const allValues = [...Array.from(arr), ...flattenedArrays];
+    if (isArrayLikeObject(iteratee$1)) {
+        return zipWith.uniq(allValues);
+    }
+    return zipWith.uniqBy(allValues, iteratee(iteratee$1));
+}
+
+function unzip(array) {
+    if (!isArrayLikeObject(array) || !array.length) {
+        return [];
+    }
+    if (Array.isArray(array)) {
+        return zipWith.unzip(array);
+    }
+    return zipWith.unzip(Array.from(array, value => Array.from(value)));
+}
+
 function without(array, ...values) {
     if (!isArrayLikeObject(array)) {
         return [];
@@ -1131,6 +1263,13 @@ function without(array, ...values) {
     return zipWith.without(Array.from(array), ...values);
 }
 
+function zip(...arrays) {
+    if (!arrays.length) {
+        return [];
+    }
+    return zipWith.zip(...arrays.filter(group => isArrayLikeObject(group)));
+}
+
 function set(obj, path, value) {
     const resolvedPath = Array.isArray(path) ? path : typeof path === 'string' ? toPath(path) : [path];
     let current = obj;
@@ -1517,7 +1656,7 @@ function clamp(value, bound1, bound2) {
     if (Number.isNaN(bound2)) {
         bound2 = 0;
     }
-    return sumBy.clamp(value, bound1, bound2);
+    return rangeRight.clamp(value, bound1, bound2);
 }
 
 function floor(number, precision = 0) {
@@ -1546,7 +1685,7 @@ function inRange(value, minimum, maximum) {
     if (minimum === maximum) {
         return false;
     }
-    return sumBy.inRange(value, minimum, maximum);
+    return rangeRight.inRange(value, minimum, maximum);
 }
 
 function max(items = []) {
@@ -1651,6 +1790,27 @@ function round(number, precision = 0) {
     return decimalAdjust('round', number, precision);
 }
 
+function sumBy(array, iteratee$1) {
+    if (!array || !array.length) {
+        return 0;
+    }
+    if (iteratee$1 != null) {
+        iteratee$1 = iteratee(iteratee$1);
+    }
+    let result = iteratee$1 ? iteratee$1(array[0]) : array[0];
+    for (let i = 1; i < array.length; i++) {
+        const current = iteratee$1 ? iteratee$1(array[i]) : array[i];
+        if (current !== undefined) {
+            result += current;
+        }
+    }
+    return result;
+}
+
+function sum(array) {
+    return sumBy(array);
+}
+
 function defaults(object, ...sources) {
     object = Object(object);
     const objectProto = Object.prototype;
@@ -2019,6 +2179,39 @@ function isDate(value) {
     return isWeakSet$1.isDate(value);
 }
 
+function isPrototype(value) {
+    const constructor = value.constructor;
+    const prototype = typeof constructor === 'function' ? constructor.prototype : Object.prototype;
+    return value === prototype;
+}
+
+function isEmpty(value) {
+    if (value == null) {
+        return true;
+    }
+    if (isArrayLike(value)) {
+        if (typeof value.splice !== 'function' &&
+            typeof value !== 'string' &&
+            (typeof Buffer === 'undefined' || !Buffer.isBuffer(value)) &&
+            !isTypedArray(value) &&
+            !isArguments(value)) {
+            return false;
+        }
+        return value.length === 0;
+    }
+    if (typeof value === 'object') {
+        if (value instanceof Map || value instanceof Set) {
+            return value.size === 0;
+        }
+        const keys = Object.keys(value);
+        if (isPrototype(value)) {
+            return keys.filter(x => x !== 'constructor').length === 0;
+        }
+        return keys.length === 0;
+    }
+    return true;
+}
+
 function isEqualWith(a, b, areValuesEqual = noop.noop) {
     if (typeof areValuesEqual !== 'function') {
         areValuesEqual = noop.noop;
@@ -2138,12 +2331,19 @@ function repeat(str, n) {
     return str.repeat(n);
 }
 
+function replace(target = '', pattern, replacement) {
+    if (arguments.length < 3) {
+        return toString(target);
+    }
+    return toString(target).replace(pattern, replacement);
+}
+
 function snakeCase(str) {
     return upperFirst.snakeCase(normalizeForCase(str));
 }
 
 function startCase(str) {
-    const words = upperFirst.getWords(normalizeForCase(str).trim());
+    const words = upperFirst.words(normalizeForCase(str).trim());
     let result = '';
     for (let i = 0; i < words.length; i++) {
         const word = words[i];
@@ -2164,10 +2364,6 @@ function startsWith(str, target, position = 0) {
     return str.startsWith(target, position);
 }
 
-function upperCase(str) {
-    return upperFirst.upperCase(normalizeForCase(str));
-}
-
 const esTemplateRegExp = /\$\{([^\\}]*(?:\\.[^\\}]*)*)\}/g;
 const unEscapedRegExp = /['\n\r\u2028\u2029\\]/g;
 const noMatchExp = /($^)/;
@@ -2314,6 +2510,10 @@ function trimStart(str, chars, guard) {
     }
 }
 
+function upperCase(str) {
+    return upperFirst.upperCase(normalizeForCase(str));
+}
+
 function constant(value) {
     return () => value;
 }
@@ -2364,7 +2564,6 @@ function uniqueId(prefix = '') {
 
 exports.at = zipWith.at;
 exports.countBy = zipWith.countBy;
-exports.differenceBy = zipWith.differenceBy;
 exports.differenceWith = zipWith.differenceWith;
 exports.flatMap = zipWith.flatMap;
 exports.flatMapDeep = zipWith.flatMapDeep;
@@ -2373,6 +2572,7 @@ exports.groupBy = zipWith.groupBy;
 exports.initial = zipWith.initial;
 exports.intersectionWith = zipWith.intersectionWith;
 exports.isSubset = zipWith.isSubset;
+exports.isSubsetWith = zipWith.isSubsetWith;
 exports.keyBy = zipWith.keyBy;
 exports.maxBy = zipWith.maxBy;
 exports.minBy = zipWith.minBy;
@@ -2383,17 +2583,13 @@ exports.shuffle = zipWith.shuffle;
 exports.takeRightWhile = zipWith.takeRightWhile;
 exports.takeWhile = zipWith.takeWhile;
 exports.toFilled = zipWith.toFilled;
-exports.union = zipWith.union;
 exports.unionBy = zipWith.unionBy;
 exports.unionWith = zipWith.unionWith;
-exports.uniqBy = zipWith.uniqBy;
 exports.uniqWith = zipWith.uniqWith;
-exports.unzip = zipWith.unzip;
 exports.unzipWith = zipWith.unzipWith;
 exports.xor = zipWith.xor;
 exports.xorBy = zipWith.xorBy;
 exports.xorWith = zipWith.xorWith;
-exports.zip = zipWith.zip;
 exports.zipObject = zipWith.zipObject;
 exports.zipWith = zipWith.zipWith;
 exports.AbortError = promise_index.AbortError;
@@ -2410,16 +2606,15 @@ exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
 exports.unary = unary.unary;
 exports.noop = noop.noop;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
 exports.randomInt = randomInt.randomInt;
 exports.clone = toMerged.clone;
+exports.findKey = toMerged.findKey;
 exports.flattenObject = toMerged.flattenObject;
 exports.invert = toMerged.invert;
 exports.isObjectLike = toMerged.isObjectLike;
@@ -2447,6 +2642,7 @@ exports.lowerFirst = upperFirst.lowerFirst;
 exports.pascalCase = upperFirst.pascalCase;
 exports.unescape = upperFirst.unescape;
 exports.upperFirst = upperFirst.upperFirst;
+exports.words = upperFirst.words;
 exports.invariant = util_index.invariant;
 exports.ary = ary;
 exports.attempt = attempt;
@@ -2471,10 +2667,12 @@ exports.defaultTo = defaultTo;
 exports.defaults = defaults;
 exports.defer = defer;
 exports.difference = difference;
+exports.differenceBy = differenceBy;
 exports.drop = drop;
 exports.dropRight = dropRight;
 exports.dropRightWhile = dropRightWhile;
 exports.dropWhile = dropWhile;
+exports.each = forEach;
 exports.endsWith = endsWith;
 exports.escape = escape;
 exports.every = every;
@@ -2491,6 +2689,7 @@ exports.flip = flip;
 exports.floor = floor;
 exports.flow = flow;
 exports.flowRight = flowRight;
+exports.forEach = forEach;
 exports.fromPairs = fromPairs;
 exports.get = get;
 exports.has = has;
@@ -2508,6 +2707,7 @@ exports.isArrayLike = isArrayLike;
 exports.isArrayLikeObject = isArrayLikeObject;
 exports.isBoolean = isBoolean;
 exports.isDate = isDate;
+exports.isEmpty = isEmpty;
 exports.isEqualWith = isEqualWith;
 exports.isError = isError;
 exports.isFinite = isFinite;
@@ -2527,6 +2727,7 @@ exports.isSymbol = isSymbol;
 exports.isTypedArray = isTypedArray;
 exports.isWeakMap = isWeakMap;
 exports.isWeakSet = isWeakSet;
+exports.iteratee = iteratee;
 exports.join = join;
 exports.kebabCase = kebabCase;
 exports.last = last;
@@ -2550,6 +2751,7 @@ exports.property = property;
 exports.random = random;
 exports.rearg = rearg;
 exports.repeat = repeat;
+exports.replace = replace;
 exports.rest = rest;
 exports.round = round;
 exports.sample = sample;
@@ -2562,6 +2764,8 @@ exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
+exports.sum = sum;
+exports.sumBy = sumBy;
 exports.tail = tail;
 exports.take = take;
 exports.takeRight = takeRight;
@@ -2580,9 +2784,13 @@ exports.toString = toString;
 exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;
+exports.union = union;
 exports.uniq = uniq;
+exports.uniqBy = uniqBy;
 exports.uniqueId = uniqueId;
 exports.unset = unset;
+exports.unzip = unzip;
 exports.upperCase = upperCase;
 exports.without = without;
+exports.zip = zip;
 exports.zipObjectDeep = zipObjectDeep;