es-toolkit 1.25.2 → 1.26.0-dev.826

package/dist/compat/index.d.ts

@@ -7,7 +7,6 @@ export { flatMapDeep } from '../array/flatMapDeep.js';
 export { forEachRight } from '../array/forEachRight.js';
 export { groupBy } from '../array/groupBy.js';
 export { initial } from '../array/initial.js';
-export { intersectionBy } from '../array/intersectionBy.js';
 export { intersectionWith } from '../array/intersectionWith.js';
 export { isSubset } from '../array/isSubset.js';
 export { keyBy } from '../array/keyBy.js';
@@ -36,6 +35,7 @@ export { zipWith } from '../array/zipWith.js';
 export { AbortError } from '../error/AbortError.js';
 export { TimeoutError } from '../error/TimeoutError.js';
 export { after } from '../function/after.js';
+export { identity } from '../function/identity.js';
 export { MemoizeCache, memoize } from '../function/memoize.js';
 export { negate } from '../function/negate.js';
 export { noop } from '../function/noop.js';
@@ -45,6 +45,8 @@ export { partialRight } from '../function/partialRight.js';
 export { unary } from '../function/unary.js';
 export { mean } from '../math/mean.js';
 export { meanBy } from '../math/meanBy.js';
+export { median } from '../math/median.js';
+export { medianBy } from '../math/medianBy.js';
 export { randomInt } from '../math/randomInt.js';
 export { range } from '../math/range.js';
 export { rangeRight } from '../math/rangeRight.js';
@@ -77,6 +79,7 @@ export { lowerFirst } from '../string/lowerFirst.js';
 export { pascalCase } from '../string/pascalCase.js';
 export { unescape } from '../string/unescape.js';
 export { upperFirst } from '../string/upperFirst.js';
+export { invariant } from '../util/invariant.js';
 export { castArray } from './array/castArray.js';
 export { chunk } from './array/chunk.js';
 export { compact } from './array/compact.js';
@@ -99,6 +102,7 @@ export { head as first, head } from './array/head.js';
 export { includes } from './array/includes.js';
 export { indexOf } from './array/indexOf.js';
 export { intersection } from './array/intersection.js';
+export { intersectionBy } from './array/intersectionBy.js';
 export { join } from './array/join.js';
 export { last } from './array/last.js';
 export { orderBy } from './array/orderBy.js';
@@ -198,6 +202,7 @@ export { snakeCase } from './string/snakeCase.js';
 export { startCase } from './string/startCase.js';
 export { startsWith } from './string/startsWith.js';
 export { upperCase } from './string/upperCase.js';
+export { template, templateSettings } from './string/template.js';
 export { trim } from './string/trim.js';
 export { trimEnd } from './string/trimEnd.js';
 export { trimStart } from './string/trimStart.js';
@@ -212,3 +217,4 @@ export { toNumber } from './util/toNumber.js';
 export { toPath } from './util/toPath.js';
 export { toSafeInteger } from './util/toSafeInteger.js';
 export { toString } from './util/toString.js';
+export { uniqueId } from './util/uniqueId.js';

package/dist/compat/index.js

@@ -4,14 +4,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const zipWith = require('../_chunk/zipWith-Dkv3D1.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const unary = require('../_chunk/unary-CMvKXy.js');
+const unary = require('../_chunk/unary-CcTNuC.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const sumBy = require('../_chunk/sumBy-BkErWJ.js');
+const sumBy = require('../_chunk/sumBy-RVppiV.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
-const toMerged = require('../_chunk/toMerged-BLnW4M.js');
+const toMerged = require('../_chunk/toMerged-wNz52b.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 util_index = require('../util/index.js');
 
 function castArray(value) {
     if (arguments.length === 0) {
@@ -62,17 +63,48 @@ function difference(arr, ...values) {
     return zipWith.difference(arr1, arr2);
 }
 
-function drop(collection, itemsCount) {
+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(Array.from(collection), itemsCount);
 }
 
-function dropRight(collection, itemsCount) {
+function dropRight(collection, itemsCount = 1, guard) {
     if (!isArrayLike(collection)) {
         return [];
     }
+    itemsCount = guard ? 1 : toInteger(itemsCount);
     return zipWith.dropRight(Array.from(collection), itemsCount);
 }
 
@@ -460,17 +492,27 @@ function dropWhileImpl(arr, predicate) {
     }
 }
 
-function identity(x) {
-    return x;
+function isIterateeCall(value, index, object) {
+    if (!isObject(object)) {
+        return false;
+    }
+    if ((typeof index === 'number' && isArrayLike(object) && isIndex(index) && index < object.length) ||
+        (typeof index === 'string' && index in object)) {
+        return isWeakSet$1.eq(object[index], value);
+    }
+    return false;
 }
 
-function every(source, doesMatch) {
+function every(source, doesMatch, guard) {
     if (!source) {
         return true;
     }
     const values = Array.isArray(source) ? source : Object.values(source);
+    if (guard && isIterateeCall(source, doesMatch, guard)) {
+        doesMatch = undefined;
+    }
     if (!doesMatch) {
-        doesMatch = identity;
+        doesMatch = unary.identity;
     }
     switch (typeof doesMatch) {
         case 'function': {
@@ -534,7 +576,7 @@ function filter(source, predicate) {
         return [];
     }
     if (!predicate) {
-        predicate = identity;
+        predicate = unary.identity;
     }
     const collection = isArray(source) ? source : Object.values(source);
     switch (typeof predicate) {
@@ -707,35 +749,6 @@ function head(arr) {
     return zipWith.head(Array.from(arr));
 }
 
-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;
@@ -808,6 +821,34 @@ function intersection(...arrays) {
     return result;
 }
 
+function intersectionBy(array, ...values) {
+    if (!isArrayLikeObject(array)) {
+        return [];
+    }
+    const lastValue = zipWith.last(values);
+    if (lastValue === undefined) {
+        return Array.from(array);
+    }
+    let result = zipWith.uniq(Array.from(array));
+    const count = isArrayLikeObject(lastValue) ? values.length : values.length - 1;
+    for (let i = 0; i < count; ++i) {
+        const value = values[i];
+        if (!isArrayLikeObject(value)) {
+            return [];
+        }
+        if (isArrayLikeObject(lastValue)) {
+            result = zipWith.intersectionBy(result, Array.from(value), unary.identity);
+        }
+        else if (typeof lastValue === 'function') {
+            result = zipWith.intersectionBy(result, Array.from(value), value => lastValue(value));
+        }
+        else if (typeof lastValue === 'string') {
+            result = zipWith.intersectionBy(result, Array.from(value), property(lastValue));
+        }
+    }
+    return result;
+}
+
 function join(array, separator = ',') {
     if (!isArrayLike(array)) {
         return '';
@@ -870,16 +911,20 @@ function isKey(value, object) {
         (object != null));
 }
 
-function orderBy(collection, criteria, orders) {
-    if (collection == null || typeof collection === 'number') {
+function orderBy(collection, criteria, orders, guard) {
+    if (collection == null) {
         return [];
     }
-    if (typeof collection === 'object' && !Array.isArray(collection)) {
+    orders = guard ? undefined : orders;
+    if (!Array.isArray(collection)) {
         collection = Object.values(collection);
     }
     if (!Array.isArray(criteria)) {
         criteria = criteria == null ? [null] : [criteria];
     }
+    if (criteria.length === 0) {
+        criteria = [null];
+    }
     if (!Array.isArray(orders)) {
         orders = orders == null ? [] : [orders];
     }
@@ -959,17 +1004,6 @@ function size(target) {
     return Object.keys(target).length;
 }
 
-function isIterateeCall(value, index, object) {
-    if (!isObject(object)) {
-        return false;
-    }
-    if ((typeof index === 'number' && isArrayLike(object) && isIndex(index) && index < object.length) ||
-        (typeof index === 'string' && index in object)) {
-        return isWeakSet$1.eq(object[index], value);
-    }
-    return false;
-}
-
 function slice(array, start, end) {
     if (!isArrayLike(array)) {
         return [];
@@ -1004,38 +1038,57 @@ function slice(array, start, end) {
     return result;
 }
 
-function some(arr, predicate, guard) {
+function some(source, predicate, guard) {
+    if (!source) {
+        return false;
+    }
     if (guard != null) {
         predicate = undefined;
     }
     if (!predicate) {
-        predicate = identity;
-    }
-    if (!Array.isArray(arr)) {
-        return false;
+        predicate = unary.identity;
     }
+    const values = Array.isArray(source) ? source : Object.values(source);
     switch (typeof predicate) {
         case 'function': {
-            return arr.some(predicate);
+            if (!Array.isArray(source)) {
+                const keys = Object.keys(source);
+                for (let i = 0; i < keys.length; i++) {
+                    const key = keys[i];
+                    const value = source[key];
+                    if (predicate(value, key, source)) {
+                        return true;
+                    }
+                }
+                return false;
+            }
+            return values.some(predicate);
         }
         case 'object': {
             if (Array.isArray(predicate) && predicate.length === 2) {
                 const key = predicate[0];
                 const value = predicate[1];
-                return arr.some(matchesProperty(key, value));
+                return values.some(matchesProperty(key, value));
             }
             else {
-                return arr.some(matches(predicate));
+                return values.some(matches(predicate));
             }
         }
         case 'string': {
-            return arr.some(property(predicate));
+            return values.some(property(predicate));
         }
     }
 }
 
-function sortBy(collection, criteria) {
-    return orderBy(collection, criteria, ['asc']);
+function sortBy(collection, ...criteria) {
+    const length = criteria.length;
+    if (length > 1 && isIterateeCall(collection, criteria[0], criteria[1])) {
+        criteria = [];
+    }
+    else if (length > 2 && isIterateeCall(criteria[0], criteria[1], criteria[2])) {
+        criteria = [criteria[0]];
+    }
+    return orderBy(collection, zipWith.flatten(criteria), ['asc']);
 }
 
 function tail(arr) {
@@ -1045,14 +1098,16 @@ function tail(arr) {
     return zipWith.tail(Array.from(arr));
 }
 
-function take(arr, count = 1) {
+function take(arr, count = 1, guard) {
+    count = guard ? 1 : toInteger(count);
     if (count < 1 || !isArrayLike(arr)) {
         return [];
     }
     return zipWith.take(Array.from(arr), count);
 }
 
-function takeRight(arr, count = 1) {
+function takeRight(arr, count = 1, guard) {
+    count = guard ? 1 : toInteger(count);
     if (count <= 0 || !isArrayLike(arr)) {
         return [];
     }
@@ -1628,7 +1683,7 @@ function invertBy(object, iteratee) {
         return result;
     }
     if (iteratee == null) {
-        iteratee = identity;
+        iteratee = unary.identity;
     }
     const keys = Object.keys(object);
     for (let i = 0; i < keys.length; i++) {
@@ -1646,7 +1701,7 @@ function invertBy(object, iteratee) {
 }
 
 function mapKeys(object, getNewKey) {
-    getNewKey = getNewKey ?? identity;
+    getNewKey = getNewKey ?? unary.identity;
     switch (typeof getNewKey) {
         case 'string':
         case 'symbol':
@@ -1661,7 +1716,7 @@ function mapKeys(object, getNewKey) {
 }
 
 function mapValues(object, getNewValue) {
-    getNewValue = getNewValue ?? identity;
+    getNewValue = getNewValue ?? unary.identity;
     switch (typeof getNewValue) {
         case 'string':
         case 'symbol':
@@ -2110,6 +2165,86 @@ function upperCase(str) {
     return upperFirst.upperCase(normalizeForCase(str));
 }
 
+const esTemplateRegExp = /\$\{([^\\}]*(?:\\.[^\\}]*)*)\}/g;
+const unEscapedRegExp = /['\n\r\u2028\u2029\\]/g;
+const noMatchExp = /($^)/;
+const escapeMap = new Map([
+    ['\\', '\\'],
+    ["'", "'"],
+    ['\n', 'n'],
+    ['\r', 'r'],
+    ['\u2028', 'u2028'],
+    ['\u2029', 'u2029'],
+]);
+function escapeString(match) {
+    return `\\${escapeMap.get(match)}`;
+}
+const templateSettings = {
+    escape: /<%-([\s\S]+?)%>/g,
+    evaluate: /<%([\s\S]+?)%>/g,
+    interpolate: /<%=([\s\S]+?)%>/g,
+    variable: '',
+    imports: {
+        _: {
+            escape,
+            template,
+        },
+    },
+};
+function template(string, options, guard) {
+    string = toString(string);
+    if (guard) {
+        options = templateSettings;
+    }
+    options = defaults({ ...options }, templateSettings);
+    const delimitersRegExp = new RegExp([
+        options.escape?.source ?? noMatchExp.source,
+        options.interpolate?.source ?? noMatchExp.source,
+        options.interpolate ? esTemplateRegExp.source : noMatchExp.source,
+        options.evaluate?.source ?? noMatchExp.source,
+        '$',
+    ].join('|'), 'g');
+    let lastIndex = 0;
+    let isEvaluated = false;
+    let source = `__p += ''`;
+    for (const match of string.matchAll(delimitersRegExp)) {
+        const [fullMatch, escapeValue, interpolateValue, esTemplateValue, evaluateValue] = match;
+        const { index } = match;
+        source += ` + '${string.slice(lastIndex, index).replace(unEscapedRegExp, escapeString)}'`;
+        if (escapeValue) {
+            source += ` + _.escape(${escapeValue})`;
+        }
+        if (interpolateValue) {
+            source += ` + ((${interpolateValue}) == null ? '' : ${interpolateValue})`;
+        }
+        else if (esTemplateValue) {
+            source += ` + ((${esTemplateValue}) == null ? '' : ${esTemplateValue})`;
+        }
+        if (evaluateValue) {
+            source += `;\n${evaluateValue};\n __p += ''`;
+            isEvaluated = true;
+        }
+        lastIndex = index + fullMatch.length;
+    }
+    const imports = defaults({ ...options.imports }, templateSettings.imports);
+    const importsKeys = Object.keys(imports);
+    const importValues = Object.values(imports);
+    const sourceURL = `//# sourceURL=${options.sourceURL ? String(options.sourceURL).replace(/[\r\n]/g, ' ') : `es-toolkit.templateSource[${Date.now()}]`}\n`;
+    const compiledFunction = `function(${options.variable || 'obj'}) {
+    let __p = '';
+    ${options.variable ? '' : 'if (obj == null) { obj = {}; }'}
+    ${isEvaluated ? `function print() { __p += Array.prototype.join.call(arguments, ''); }` : ''}
+    ${options.variable ? source : `with(obj) {\n${source}\n}`}
+    return __p;
+  }`;
+    const result = attempt(() => new Function(...importsKeys, `${sourceURL}return ${compiledFunction}`)(...importValues));
+    result.source = compiledFunction;
+    if (result instanceof Error) {
+        throw result;
+    }
+    return result;
+}
+
 function trim(str, chars, guard) {
     if (str == null) {
         return '';
@@ -2218,6 +2353,12 @@ function toSafeInteger(value) {
     return clamp(toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER);
 }
 
+let idCounter = 0;
+function uniqueId(prefix = '') {
+    const id = ++idCounter;
+    return `${prefix}${id}`;
+}
+
 exports.at = zipWith.at;
 exports.countBy = zipWith.countBy;
 exports.differenceBy = zipWith.differenceBy;
@@ -2227,7 +2368,6 @@ exports.flatMapDeep = zipWith.flatMapDeep;
 exports.forEachRight = zipWith.forEachRight;
 exports.groupBy = zipWith.groupBy;
 exports.initial = zipWith.initial;
-exports.intersectionBy = zipWith.intersectionBy;
 exports.intersectionWith = zipWith.intersectionWith;
 exports.isSubset = zipWith.isSubset;
 exports.keyBy = zipWith.keyBy;
@@ -2259,6 +2399,7 @@ exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = unary.after;
+exports.identity = unary.identity;
 exports.memoize = unary.memoize;
 exports.negate = unary.negate;
 exports.once = unary.once;
@@ -2268,6 +2409,8 @@ 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;
@@ -2301,6 +2444,7 @@ exports.lowerFirst = upperFirst.lowerFirst;
 exports.pascalCase = upperFirst.pascalCase;
 exports.unescape = upperFirst.unescape;
 exports.upperFirst = upperFirst.upperFirst;
+exports.invariant = util_index.invariant;
 exports.ary = ary;
 exports.attempt = attempt;
 exports.before = before;
@@ -2352,6 +2496,7 @@ exports.inRange = inRange;
 exports.includes = includes;
 exports.indexOf = indexOf;
 exports.intersection = intersection;
+exports.intersectionBy = intersectionBy;
 exports.invertBy = invertBy;
 exports.isArguments = isArguments;
 exports.isArray = isArray;
@@ -2417,6 +2562,8 @@ exports.startsWith = startsWith;
 exports.tail = tail;
 exports.take = take;
 exports.takeRight = takeRight;
+exports.template = template;
+exports.templateSettings = templateSettings;
 exports.throttle = throttle;
 exports.times = times;
 exports.toDefaulted = toDefaulted;
@@ -2431,6 +2578,7 @@ exports.trim = trim;
 exports.trimEnd = trimEnd;
 exports.trimStart = trimStart;
 exports.uniq = uniq;
+exports.uniqueId = uniqueId;
 exports.unset = unset;
 exports.upperCase = upperCase;
 exports.without = without;

package/dist/compat/index.mjs

@@ -7,7 +7,6 @@ export { flatMapDeep } from '../array/flatMapDeep.mjs';
 export { forEachRight } from '../array/forEachRight.mjs';
 export { groupBy } from '../array/groupBy.mjs';
 export { initial } from '../array/initial.mjs';
-export { intersectionBy } from '../array/intersectionBy.mjs';
 export { intersectionWith } from '../array/intersectionWith.mjs';
 export { isSubset } from '../array/isSubset.mjs';
 export { keyBy } from '../array/keyBy.mjs';
@@ -36,6 +35,7 @@ export { zipWith } from '../array/zipWith.mjs';
 export { AbortError } from '../error/AbortError.mjs';
 export { TimeoutError } from '../error/TimeoutError.mjs';
 export { after } from '../function/after.mjs';
+export { identity } from '../function/identity.mjs';
 export { memoize } from '../function/memoize.mjs';
 export { negate } from '../function/negate.mjs';
 export { noop } from '../function/noop.mjs';
@@ -45,6 +45,8 @@ export { partialRight } from '../function/partialRight.mjs';
 export { unary } from '../function/unary.mjs';
 export { mean } from '../math/mean.mjs';
 export { meanBy } from '../math/meanBy.mjs';
+export { median } from '../math/median.mjs';
+export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { range } from '../math/range.mjs';
 export { rangeRight } from '../math/rangeRight.mjs';
@@ -79,6 +81,7 @@ export { lowerFirst } from '../string/lowerFirst.mjs';
 export { pascalCase } from '../string/pascalCase.mjs';
 export { unescape } from '../string/unescape.mjs';
 export { upperFirst } from '../string/upperFirst.mjs';
+export { invariant } from '../util/invariant.mjs';
 export { castArray } from './array/castArray.mjs';
 export { chunk } from './array/chunk.mjs';
 export { compact } from './array/compact.mjs';
@@ -101,6 +104,7 @@ export { head as first, head } from './array/head.mjs';
 export { includes } from './array/includes.mjs';
 export { indexOf } from './array/indexOf.mjs';
 export { intersection } from './array/intersection.mjs';
+export { intersectionBy } from './array/intersectionBy.mjs';
 export { join } from './array/join.mjs';
 export { last } from './array/last.mjs';
 export { orderBy } from './array/orderBy.mjs';
@@ -199,6 +203,7 @@ export { snakeCase } from './string/snakeCase.mjs';
 export { startCase } from './string/startCase.mjs';
 export { startsWith } from './string/startsWith.mjs';
 export { upperCase } from './string/upperCase.mjs';
+export { template, templateSettings } from './string/template.mjs';
 export { trim } from './string/trim.mjs';
 export { trimEnd } from './string/trimEnd.mjs';
 export { trimStart } from './string/trimStart.mjs';
@@ -212,3 +217,4 @@ export { toNumber } from './util/toNumber.mjs';
 export { toPath } from './util/toPath.mjs';
 export { toSafeInteger } from './util/toSafeInteger.mjs';
 export { toString } from './util/toString.mjs';
+export { uniqueId } from './util/uniqueId.mjs';

package/dist/compat/object/invertBy.mjs

@@ -1,5 +1,5 @@
+import { identity } from '../../function/identity.mjs';
 import { isNil } from '../../predicate/isNil.mjs';
-import { identity } from '../_internal/identity.mjs';
 
 function invertBy(object, iteratee) {
     const result = {};

package/dist/compat/object/mapKeys.mjs

@@ -1,6 +1,6 @@
 import { property } from './property.mjs';
+import { identity } from '../../function/identity.mjs';
 import { mapKeys as mapKeys$1 } from '../../object/mapKeys.mjs';
-import { identity } from '../_internal/identity.mjs';
 
 function mapKeys(object, getNewKey) {
     getNewKey = getNewKey ?? identity;

package/dist/compat/object/mapValues.mjs

@@ -1,6 +1,6 @@
 import { property } from './property.mjs';
+import { identity } from '../../function/identity.mjs';
 import { mapValues as mapValues$1 } from '../../object/mapValues.mjs';
-import { identity } from '../_internal/identity.mjs';
 
 function mapValues(object, getNewValue) {
     getNewValue = getNewValue ?? identity;