es-toolkit 1.35.0-dev.1206 → 1.35.0-dev.1211

package/dist/_chunk/{toSnakeCaseKeys-DCXJ3Q.js → toSnakeCaseKeys-nofgoP.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-const zipWith = require('./zipWith-ChDTPy.js');
+const zipWith = require('./zipWith-Bt0YQl.js');
 const AbortError = require('./AbortError-Cg4ZQ1.js');
 const error_index = require('../error/index.js');
 const unary = require('./unary-EIEhcF.js');
@@ -805,40 +805,11 @@ function differenceWith(array, ...values) {
     return zipWith.difference(Array.from(array), flattenedValues);
 }
 
-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);
+    itemsCount = guard ? 1 : zipWith.toInteger(itemsCount);
     return zipWith.drop(toArray$1(collection), itemsCount);
 }
 
@@ -846,7 +817,7 @@ function dropRight(collection, itemsCount = 1, guard) {
     if (!isArrayLike(collection)) {
         return [];
     }
-    itemsCount = guard ? 1 : toInteger(itemsCount);
+    itemsCount = guard ? 1 : zipWith.toInteger(itemsCount);
     return zipWith.dropRight(toArray$1(collection), itemsCount);
 }
 
@@ -1073,7 +1044,7 @@ function findLast(source, _doesMatch, fromIndex) {
         return undefined;
     }
     const length = Array.isArray(source) ? source.length : Object.keys(source).length;
-    fromIndex = toInteger(fromIndex ?? length - 1);
+    fromIndex = zipWith.toInteger(fromIndex ?? length - 1);
     if (fromIndex < 0) {
         fromIndex = Math.max(length + fromIndex, 0);
     }
@@ -1182,6 +1153,31 @@ function forEach(collection, callback = unary.identity) {
     return collection;
 }
 
+function forEachRight(collection, callback = unary.identity) {
+    if (!collection) {
+        return collection;
+    }
+    const keys = isArrayLike(collection) ? range$1.range(0, collection.length) : Object.keys(collection);
+    for (let i = keys.length - 1; i >= 0; i--) {
+        const key = keys[i];
+        const value = collection[key];
+        const result = callback(value, key, collection);
+        if (result === false) {
+            break;
+        }
+    }
+    return collection;
+}
+
+function groupBy(source, _getKeyFromItem) {
+    if (source == null) {
+        return {};
+    }
+    const items = isArrayLike(source) ? Array.from(source) : Object.values(source);
+    const getKeyFromItem = iteratee(_getKeyFromItem ?? unary.identity);
+    return zipWith.groupBy(items, getKeyFromItem);
+}
+
 function head(arr) {
     if (!isArrayLike(arr)) {
         return undefined;
@@ -1197,7 +1193,7 @@ function includes(source, target, fromIndex, guard) {
         fromIndex = 0;
     }
     else {
-        fromIndex = toInteger(fromIndex);
+        fromIndex = zipWith.toInteger(fromIndex);
     }
     if (isString(source)) {
         if (fromIndex > source.length || target instanceof RegExp) {
@@ -1377,7 +1373,7 @@ function nth(array, n = 0) {
     if (!isArrayLikeObject(array) || array.length === 0) {
         return undefined;
     }
-    n = toInteger(n);
+    n = zipWith.toInteger(n);
     if (n < 0) {
         n += array.length;
     }
@@ -1425,7 +1421,7 @@ function isKey(value, object) {
     if (Array.isArray(value)) {
         return false;
     }
-    if (typeof value === 'number' || typeof value === 'boolean' || value == null || isSymbol(value)) {
+    if (typeof value === 'number' || typeof value === 'boolean' || value == null || zipWith.isSymbol(value)) {
         return true;
     }
     return ((typeof value === 'string' && (regexIsPlainProp.test(value) || !regexIsDeepProp.test(value))) ||
@@ -1650,8 +1646,8 @@ function slice(array, start, end) {
         start = 0;
         end = length;
     }
-    start = toInteger(start);
-    end = toInteger(end);
+    start = zipWith.toInteger(start);
+    end = zipWith.toInteger(end);
     if (start < 0) {
         start = Math.max(length + start, 0);
     }
@@ -1747,7 +1743,7 @@ function sortedIndexBy(array, value, iteratee$1, retHighest) {
     const transformedValue = iterateeFunction(value);
     const valIsNaN = isNaN(transformedValue);
     const valIsNull = isPromise.isNull(transformedValue);
-    const valIsSymbol = isSymbol(transformedValue);
+    const valIsSymbol = zipWith.isSymbol(transformedValue);
     const valIsUndefined = isPromise.isUndefined(transformedValue);
     while (low < high) {
         let setLow;
@@ -1756,7 +1752,7 @@ function sortedIndexBy(array, value, iteratee$1, retHighest) {
         const othIsDefined = !isPromise.isUndefined(computed);
         const othIsNull = isPromise.isNull(computed);
         const othIsReflexive = !isNaN(computed);
-        const othIsSymbol = isSymbol(computed);
+        const othIsSymbol = zipWith.isSymbol(computed);
         if (valIsNaN) {
             setLow = retHighest || othIsReflexive;
         }
@@ -1859,7 +1855,7 @@ function tail(arr) {
 }
 
 function take(arr, count = 1, guard) {
-    count = guard ? 1 : toInteger(count);
+    count = guard ? 1 : zipWith.toInteger(count);
     if (count < 1 || !isArrayLike(arr)) {
         return [];
     }
@@ -1867,7 +1863,7 @@ function take(arr, count = 1, guard) {
 }
 
 function takeRight(arr, count = 1, guard) {
-    count = guard ? 1 : toInteger(count);
+    count = guard ? 1 : zipWith.toInteger(count);
     if (count <= 0 || !isArrayLike(arr)) {
         return [];
     }
@@ -2022,7 +2018,7 @@ function after(n, func) {
     if (typeof func !== 'function') {
         throw new TypeError('Expected a function');
     }
-    n = toInteger(n);
+    n = zipWith.toInteger(n);
     return function (...args) {
         if (--n < 1) {
             return func.apply(this, args);
@@ -2054,7 +2050,7 @@ function before(n, func) {
         throw new TypeError('Expected a function');
     }
     let result;
-    n = toInteger(n);
+    n = zipWith.toInteger(n);
     return function (...args) {
         if (--n > 0) {
             result = func.apply(this, args);
@@ -2293,7 +2289,7 @@ function delay(func, wait, ...args) {
     if (typeof func !== 'function') {
         throw new TypeError('Expected a function');
     }
-    return setTimeout(func, toNumber(wait) || 0, ...args);
+    return setTimeout(func, zipWith.toNumber(wait) || 0, ...args);
 }
 
 function flip(func) {
@@ -2320,7 +2316,7 @@ function flowRight(...funcs) {
 
 function nthArg(n = 0) {
     return function (...args) {
-        return args.at(toInteger(n));
+        return args.at(zipWith.toInteger(n));
     };
 }
 
@@ -2407,8 +2403,8 @@ function add(value, other) {
         other = toString(other);
     }
     else {
-        value = toNumber(value);
-        other = toNumber(other);
+        value = zipWith.toNumber(value);
+        other = zipWith.toNumber(other);
     }
     return value + other;
 }
@@ -2457,8 +2453,8 @@ function divide(value, other) {
         other = toString(other);
     }
     else {
-        value = toNumber(value);
-        other = toNumber(other);
+        value = zipWith.toNumber(value);
+        other = zipWith.toNumber(other);
     }
     return value / other;
 }
@@ -2582,8 +2578,8 @@ function multiply(value, other) {
         other = toString(other);
     }
     else {
-        value = toNumber(value);
-        other = toNumber(other);
+        value = zipWith.toNumber(value);
+        other = zipWith.toNumber(other);
     }
     return value * other;
 }
@@ -2664,15 +2660,15 @@ function range(start, end, step) {
     if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
         end = step = undefined;
     }
-    start = toFinite(start);
+    start = zipWith.toFinite(start);
     if (end === undefined) {
         end = start;
         start = 0;
     }
     else {
-        end = toFinite(end);
+        end = zipWith.toFinite(end);
     }
-    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    step = step === undefined ? (start < end ? 1 : -1) : zipWith.toFinite(step);
     const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
     const result = new Array(length);
     for (let index = 0; index < length; index++) {
@@ -2686,15 +2682,15 @@ function rangeRight(start, end, step) {
     if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
         end = step = undefined;
     }
-    start = toFinite(start);
+    start = zipWith.toFinite(start);
     if (end === undefined) {
         end = start;
         start = 0;
     }
     else {
-        end = toFinite(end);
+        end = zipWith.toFinite(end);
     }
-    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    step = step === undefined ? (start < end ? 1 : -1) : zipWith.toFinite(step);
     const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
     const result = new Array(length);
     for (let index = length - 1; index >= 0; index--) {
@@ -2720,8 +2716,8 @@ function subtract(value, other) {
         other = toString(other);
     }
     else {
-        value = toNumber(value);
-        other = toNumber(other);
+        value = zipWith.toNumber(value);
+        other = zipWith.toNumber(other);
     }
     return value - other;
 }
@@ -2737,7 +2733,7 @@ function isTypedArray(x) {
 }
 
 function times(n, getValue) {
-    n = toInteger(n);
+    n = zipWith.toInteger(n);
     if (n < 1 || !Number.isSafeInteger(n)) {
         return [];
     }
@@ -2919,7 +2915,12 @@ function create(prototype, properties) {
 function defaults(object, ...sources) {
     object = Object(object);
     const objectProto = Object.prototype;
-    for (let i = 0; i < sources.length; i++) {
+    let length = sources.length;
+    const guard = length > 2 ? sources[2] : undefined;
+    if (guard && isIterateeCall(sources[0], sources[1], guard)) {
+        length = 1;
+    }
+    for (let i = 0; i < length; i++) {
         const source = sources[i];
         const keys = Object.keys(source);
         for (let j = 0; j < keys.length; j++) {
@@ -3303,7 +3304,7 @@ function pickBy(obj, shouldPick) {
     }
     const keys = isArrayLike(obj) ? range$1.range(0, obj.length) : [...keysIn(obj), ...getSymbolsIn(obj)];
     for (let i = 0; i < keys.length; i++) {
-        const key = (isSymbol(keys[i]) ? keys[i] : keys[i].toString());
+        const key = (zipWith.isSymbol(keys[i]) ? keys[i] : keys[i].toString());
         const value = obj[key];
         if (shouldPick(value, key, obj)) {
             result[key] = value;
@@ -3573,8 +3574,14 @@ function padStart(str, length = 0, chars = ' ') {
     return toString(str).padStart(length, chars);
 }
 
-function repeat(str, n) {
-    return str.repeat(n);
+function repeat(str, n, guard) {
+    if (guard ? isIterateeCall(str, n, guard) : n === undefined) {
+        n = 1;
+    }
+    else {
+        n = zipWith.toInteger(n);
+    }
+    return toString(str).repeat(n);
 }
 
 function replace(target = '', pattern, replacement) {
@@ -3776,8 +3783,9 @@ function upperFirst(str) {
     return reverseString.upperFirst(toString(str));
 }
 
-function words(str, pattern = reverseString.CASE_SPLIT_PATTERN) {
+function words(str, pattern = reverseString.CASE_SPLIT_PATTERN, guard) {
     const input = toString(str);
+    pattern = guard ? reverseString.CASE_SPLIT_PATTERN : pattern;
     const words = Array.from(input.match(pattern) ?? []);
     return words.filter(x => x !== '');
 }
@@ -3819,14 +3827,14 @@ function gt(value, other) {
     if (typeof value === 'string' && typeof other === 'string') {
         return value > other;
     }
-    return toNumber(value) > toNumber(other);
+    return zipWith.toNumber(value) > zipWith.toNumber(other);
 }
 
 function gte(value, other) {
     if (typeof value === 'string' && typeof other === 'string') {
         return value >= other;
     }
-    return toNumber(value) >= toNumber(other);
+    return zipWith.toNumber(value) >= zipWith.toNumber(other);
 }
 
 function invoke(object, path, args = []) {
@@ -3875,14 +3883,14 @@ function lt(value, other) {
     if (typeof value === 'string' && typeof other === 'string') {
         return value < other;
     }
-    return toNumber(value) < toNumber(other);
+    return zipWith.toNumber(value) < zipWith.toNumber(other);
 }
 
 function lte(value, other) {
     if (typeof value === 'string' && typeof other === 'string') {
         return value <= other;
     }
-    return toNumber(value) <= toNumber(other);
+    return zipWith.toNumber(value) <= zipWith.toNumber(other);
 }
 
 function method(path, ...args) {
@@ -3981,7 +3989,7 @@ function toSafeInteger(value) {
     if (value == null) {
         return 0;
     }
-    return clamp(toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER);
+    return clamp(zipWith.toInteger(value), -MAX_SAFE_INTEGER, MAX_SAFE_INTEGER);
 }
 
 let idCounter = 0;
@@ -4071,12 +4079,12 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     flow,
     flowRight,
     forEach,
-    forEachRight: zipWith.forEachRight,
+    forEachRight,
     fromPairs,
     functions,
     functionsIn,
     get,
-    groupBy: zipWith.groupBy,
+    groupBy,
     gt,
     gte,
     has,
@@ -4136,7 +4144,7 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     isString,
     isSubset: zipWith.isSubset,
     isSubsetWith: zipWith.isSubsetWith,
-    isSymbol,
+    isSymbol: zipWith.isSymbol,
     isTypedArray,
     isUndefined: isPromise.isUndefined,
     isWeakMap,
@@ -4253,12 +4261,12 @@ const compat = /*#__PURE__*/Object.freeze(/*#__PURE__*/Object.defineProperty({
     toCamelCaseKeys,
     toDefaulted,
     toFilled: zipWith.toFilled,
-    toFinite,
-    toInteger,
+    toFinite: zipWith.toFinite,
+    toInteger: zipWith.toInteger,
     toLength,
     toLower,
     toMerged,
-    toNumber,
+    toNumber: zipWith.toNumber,
     toPairs,
     toPairsIn,
     toPath,
@@ -4413,10 +4421,12 @@ exports.floor = floor;
 exports.flow = flow;
 exports.flowRight = flowRight;
 exports.forEach = forEach;
+exports.forEachRight = forEachRight;
 exports.fromPairs = fromPairs;
 exports.functions = functions;
 exports.functionsIn = functionsIn;
 exports.get = get;
+exports.groupBy = groupBy;
 exports.gt = gt;
 exports.gte = gte;
 exports.has = has;
@@ -4456,7 +4466,6 @@ exports.isRegExp = isRegExp;
 exports.isSafeInteger = isSafeInteger;
 exports.isSet = isSet;
 exports.isString = isString;
-exports.isSymbol = isSymbol;
 exports.isTypedArray = isTypedArray;
 exports.isWeakMap = isWeakMap;
 exports.isWeakSet = isWeakSet;
@@ -4559,12 +4568,9 @@ exports.times = times;
 exports.toArray = toArray;
 exports.toCamelCaseKeys = toCamelCaseKeys;
 exports.toDefaulted = toDefaulted;
-exports.toFinite = toFinite;
-exports.toInteger = toInteger;
 exports.toLength = toLength;
 exports.toLower = toLower;
 exports.toMerged = toMerged;
-exports.toNumber = toNumber;
 exports.toPairs = toPairs;
 exports.toPairsIn = toPairsIn;
 exports.toPath = toPath;

package/dist/_chunk/{zipWith-ChDTPy.js → zipWith-Bt0YQl.js}

@@ -141,13 +141,6 @@ function flatMapDeep(arr, iteratee) {
     return flattenDeep(arr.map((item) => iteratee(item)));
 }
 
-function forEachRight(arr, callback) {
-    for (let i = arr.length - 1; i >= 0; i--) {
-        const element = arr[i];
-        callback(element, i, arr);
-    }
-}
-
 function groupBy(arr, getKeyFromItem) {
     const result = {};
     for (let i = 0; i < arr.length; i++) {
@@ -334,12 +327,43 @@ function tail(arr) {
     return arr.slice(1);
 }
 
-function take(arr, count) {
+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 take(arr, count, guard) {
+    count = guard || count === undefined ? 1 : toInteger(count);
     return arr.slice(0, count);
 }
 
-function takeRight(arr, count = 1) {
-    if (count <= 0) {
+function takeRight(arr, count = 1, guard) {
+    count = guard || count === undefined ? 1 : toInteger(count);
+    if (count <= 0 || arr == null || arr.length === 0) {
         return [];
     }
     return arr.slice(-count);
@@ -516,7 +540,6 @@ exports.flatMap = flatMap;
 exports.flatMapDeep = flatMapDeep;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
-exports.forEachRight = forEachRight;
 exports.groupBy = groupBy;
 exports.head = head;
 exports.initial = initial;
@@ -525,6 +548,7 @@ exports.intersectionBy = intersectionBy;
 exports.intersectionWith = intersectionWith;
 exports.isSubset = isSubset;
 exports.isSubsetWith = isSubsetWith;
+exports.isSymbol = isSymbol;
 exports.keyBy = keyBy;
 exports.last = last;
 exports.maxBy = maxBy;
@@ -540,6 +564,9 @@ exports.tail = tail;
 exports.take = take;
 exports.takeRight = takeRight;
 exports.toFilled = toFilled;
+exports.toFinite = toFinite;
+exports.toInteger = toInteger;
+exports.toNumber = toNumber;
 exports.union = union;
 exports.unionBy = unionBy;
 exports.unionWith = unionWith;

package/dist/array/index.js

@@ -2,7 +2,14 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('../_chunk/zipWith-ChDTPy.js');
+const zipWith = require('../_chunk/zipWith-Bt0YQl.js');
+
+function forEachRight(arr, callback) {
+    for (let i = arr.length - 1; i >= 0; i--) {
+        const element = arr[i];
+        callback(element, i, arr);
+    }
+}
 
 function compareValues(a, b, order) {
     if (a < b) {
@@ -73,7 +80,6 @@ exports.flatMap = zipWith.flatMap;
 exports.flatMapDeep = zipWith.flatMapDeep;
 exports.flatten = zipWith.flatten;
 exports.flattenDeep = zipWith.flattenDeep;
-exports.forEachRight = zipWith.forEachRight;
 exports.groupBy = zipWith.groupBy;
 exports.head = zipWith.head;
 exports.initial = zipWith.initial;
@@ -113,6 +119,7 @@ exports.xorWith = zipWith.xorWith;
 exports.zip = zipWith.zip;
 exports.zipObject = zipWith.zipObject;
 exports.zipWith = zipWith.zipWith;
+exports.forEachRight = forEachRight;
 exports.orderBy = orderBy;
 exports.sortBy = sortBy;
 exports.takeRightWhile = takeRightWhile;

package/dist/array/take.d.mts

@@ -20,6 +20,6 @@
  * // Returns [1, 2, 3]
  * take([1, 2, 3], 5);
  */
-declare function take<T>(arr: readonly T[], count: number): T[];
+declare function take<T>(arr: readonly T[], count?: number, guard?: unknown): T[];
 
 export { take };

package/dist/array/take.d.ts

@@ -20,6 +20,6 @@
  * // Returns [1, 2, 3]
  * take([1, 2, 3], 5);
  */
-declare function take<T>(arr: readonly T[], count: number): T[];
+declare function take<T>(arr: readonly T[], count?: number, guard?: unknown): T[];
 
 export { take };

package/dist/array/take.mjs

@@ -1,4 +1,7 @@
-function take(arr, count) {
+import { toInteger } from '../compat/util/toInteger.mjs';
+
+function take(arr, count, guard) {
+    count = guard || count === undefined ? 1 : toInteger(count);
     return arr.slice(0, count);
 }
 

package/dist/array/takeRight.d.mts

@@ -19,6 +19,6 @@
  * // Returns [1, 2, 3]
  * takeRight([1, 2, 3], 5);
  */
-declare function takeRight<T>(arr: readonly T[], count?: number): T[];
+declare function takeRight<T>(arr: readonly T[], count?: number, guard?: unknown): T[];
 
 export { takeRight };

package/dist/array/takeRight.d.ts

@@ -19,6 +19,6 @@
  * // Returns [1, 2, 3]
  * takeRight([1, 2, 3], 5);
  */
-declare function takeRight<T>(arr: readonly T[], count?: number): T[];
+declare function takeRight<T>(arr: readonly T[], count?: number, guard?: unknown): T[];
 
 export { takeRight };

package/dist/array/takeRight.mjs

@@ -1,5 +1,8 @@
-function takeRight(arr, count = 1) {
-    if (count <= 0) {
+import { toInteger } from '../compat/util/toInteger.mjs';
+
+function takeRight(arr, count = 1, guard) {
+    count = guard || count === undefined ? 1 : toInteger(count);
+    if (count <= 0 || arr == null || arr.length === 0) {
         return [];
     }
     return arr.slice(-count);