es-toolkit 1.35.0 → 1.36.0-dev.1215

package/dist/_chunk/{unary-BsNWRM.js → unary-EIEhcF.js}

@@ -134,6 +134,48 @@ function once(func) {
     };
 }
 
+function partial(func, ...partialArgs) {
+    return partialImpl(func, placeholderSymbol$1, ...partialArgs);
+}
+function partialImpl(func, placeholder, ...partialArgs) {
+    const partialed = function (...providedArgs) {
+        let providedArgsIndex = 0;
+        const substitutedArgs = partialArgs
+            .slice()
+            .map(arg => (arg === placeholder ? providedArgs[providedArgsIndex++] : arg));
+        const remainingArgs = providedArgs.slice(providedArgsIndex);
+        return func.apply(this, substitutedArgs.concat(remainingArgs));
+    };
+    if (func.prototype) {
+        partialed.prototype = Object.create(func.prototype);
+    }
+    return partialed;
+}
+const placeholderSymbol$1 = Symbol('partial.placeholder');
+partial.placeholder = placeholderSymbol$1;
+
+function partialRight(func, ...partialArgs) {
+    return partialRightImpl(func, placeholderSymbol, ...partialArgs);
+}
+function partialRightImpl(func, placeholder, ...partialArgs) {
+    const partialedRight = function (...providedArgs) {
+        const placeholderLength = partialArgs.filter(arg => arg === placeholder).length;
+        const rangeLength = Math.max(providedArgs.length - placeholderLength, 0);
+        const remainingArgs = providedArgs.slice(0, rangeLength);
+        let providedArgsIndex = rangeLength;
+        const substitutedArgs = partialArgs
+            .slice()
+            .map(arg => (arg === placeholder ? providedArgs[providedArgsIndex++] : arg));
+        return func.apply(this, remainingArgs.concat(substitutedArgs));
+    };
+    if (func.prototype) {
+        partialedRight.prototype = Object.create(func.prototype);
+    }
+    return partialedRight;
+}
+const placeholderSymbol = Symbol('partialRight.placeholder');
+partialRight.placeholder = placeholderSymbol;
+
 function rest(func, startIndex = func.length - 1) {
     return function (...args) {
         const rest = args.slice(startIndex);
@@ -192,6 +234,10 @@ exports.identity = identity;
 exports.memoize = memoize;
 exports.negate = negate;
 exports.once = once;
+exports.partial = partial;
+exports.partialImpl = partialImpl;
+exports.partialRight = partialRight;
+exports.partialRightImpl = partialRightImpl;
 exports.rest = rest;
 exports.retry = retry;
 exports.unary = unary;

package/dist/_chunk/{zip-_HttSl.js → zip-BJSrRi.js}

@@ -2,20 +2,6 @@
 
 const randomInt = require('./randomInt-CF7bZK.js');
 
-function at(arr, indices) {
-    const result = new Array(indices.length);
-    const length = arr.length;
-    for (let i = 0; i < indices.length; i++) {
-        let index = indices[i];
-        index = Number.isInteger(index) ? index : Math.trunc(index) || 0;
-        if (index < 0) {
-            index += length;
-        }
-        result[i] = arr[index];
-    }
-    return result;
-}
-
 function chunk(arr, size) {
     if (!Number.isInteger(size) || size <= 0) {
         throw new Error('Size must be an integer greater than zero.');
@@ -129,10 +115,6 @@ function flatten(arr, depth = 1) {
     return result;
 }
 
-function flatMap(arr, iteratee, depth = 1) {
-    return flatten(arr.map(item => iteratee(item)), depth);
-}
-
 function flattenDeep(arr) {
     return flatten(arr, Infinity);
 }
@@ -141,13 +123,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++) {
@@ -239,21 +214,6 @@ function minBy(items, getValue) {
     return minElement;
 }
 
-function partition(arr, isInTruthy) {
-    const truthy = [];
-    const falsy = [];
-    for (let i = 0; i < arr.length; i++) {
-        const item = arr[i];
-        if (isInTruthy(item)) {
-            truthy.push(item);
-        }
-        else {
-            falsy.push(item);
-        }
-    }
-    return [truthy, falsy];
-}
-
 function pull(arr, valuesToRemove) {
     const valuesSet = new Set(valuesToRemove);
     let resultIndex = 0;
@@ -271,15 +231,6 @@ function pull(arr, valuesToRemove) {
     return arr;
 }
 
-function pullAt(arr, indicesToRemove) {
-    const removed = at(arr, indicesToRemove);
-    const indices = new Set(indicesToRemove.slice().sort((x, y) => y - x));
-    for (const index of indices) {
-        arr.splice(index, 1);
-    }
-    return removed;
-}
-
 function remove(arr, shouldRemoveElement) {
     const originalArr = arr.slice();
     const removed = [];
@@ -334,12 +285,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);
@@ -480,7 +462,6 @@ function zip(...arrs) {
     return result;
 }
 
-exports.at = at;
 exports.chunk = chunk;
 exports.compact = compact;
 exports.countBy = countBy;
@@ -492,11 +473,9 @@ exports.dropRight = dropRight;
 exports.dropRightWhile = dropRightWhile;
 exports.dropWhile = dropWhile;
 exports.fill = fill;
-exports.flatMap = flatMap;
 exports.flatMapDeep = flatMapDeep;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
-exports.forEachRight = forEachRight;
 exports.groupBy = groupBy;
 exports.head = head;
 exports.initial = initial;
@@ -505,13 +484,12 @@ exports.intersectionBy = intersectionBy;
 exports.intersectionWith = intersectionWith;
 exports.isSubset = isSubset;
 exports.isSubsetWith = isSubsetWith;
+exports.isSymbol = isSymbol;
 exports.keyBy = keyBy;
 exports.last = last;
 exports.maxBy = maxBy;
 exports.minBy = minBy;
-exports.partition = partition;
 exports.pull = pull;
-exports.pullAt = pullAt;
 exports.remove = remove;
 exports.sample = sample;
 exports.sampleSize = sampleSize;
@@ -520,6 +498,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,32 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zip = require('../_chunk/zip-_HttSl.js');
+const zip = require('../_chunk/zip-BJSrRi.js');
+
+function at(arr, indices) {
+    const result = new Array(indices.length);
+    const length = arr.length;
+    for (let i = 0; i < indices.length; i++) {
+        let index = indices[i];
+        index = Number.isInteger(index) ? index : Math.trunc(index) || 0;
+        if (index < 0) {
+            index += length;
+        }
+        result[i] = arr[index];
+    }
+    return result;
+}
+
+function flatMap(arr, iteratee, depth = 1) {
+    return zip.flatten(arr.map(item => iteratee(item)), depth);
+}
+
+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) {
@@ -32,6 +57,30 @@ function orderBy(arr, criteria, orders) {
     });
 }
 
+function partition(arr, isInTruthy) {
+    const truthy = [];
+    const falsy = [];
+    for (let i = 0; i < arr.length; i++) {
+        const item = arr[i];
+        if (isInTruthy(item)) {
+            truthy.push(item);
+        }
+        else {
+            falsy.push(item);
+        }
+    }
+    return [truthy, falsy];
+}
+
+function pullAt(arr, indicesToRemove) {
+    const removed = at(arr, indicesToRemove);
+    const indices = new Set(indicesToRemove.slice().sort((x, y) => y - x));
+    for (const index of indices) {
+        arr.splice(index, 1);
+    }
+    return removed;
+}
+
 function sortBy(arr, criteria) {
     return orderBy(arr, criteria, ['asc']);
 }
@@ -77,7 +126,6 @@ function zipWith(arr1, ...rest) {
     return result;
 }
 
-exports.at = zip.at;
 exports.chunk = zip.chunk;
 exports.compact = zip.compact;
 exports.countBy = zip.countBy;
@@ -89,11 +137,9 @@ exports.dropRight = zip.dropRight;
 exports.dropRightWhile = zip.dropRightWhile;
 exports.dropWhile = zip.dropWhile;
 exports.fill = zip.fill;
-exports.flatMap = zip.flatMap;
 exports.flatMapDeep = zip.flatMapDeep;
 exports.flatten = zip.flatten;
 exports.flattenDeep = zip.flattenDeep;
-exports.forEachRight = zip.forEachRight;
 exports.groupBy = zip.groupBy;
 exports.head = zip.head;
 exports.initial = zip.initial;
@@ -106,9 +152,7 @@ exports.keyBy = zip.keyBy;
 exports.last = zip.last;
 exports.maxBy = zip.maxBy;
 exports.minBy = zip.minBy;
-exports.partition = zip.partition;
 exports.pull = zip.pull;
-exports.pullAt = zip.pullAt;
 exports.remove = zip.remove;
 exports.sample = zip.sample;
 exports.sampleSize = zip.sampleSize;
@@ -131,7 +175,12 @@ exports.xor = zip.xor;
 exports.xorBy = zip.xorBy;
 exports.xorWith = zip.xorWith;
 exports.zip = zip.zip;
+exports.at = at;
+exports.flatMap = flatMap;
+exports.forEachRight = forEachRight;
 exports.orderBy = orderBy;
+exports.partition = partition;
+exports.pullAt = pullAt;
 exports.sortBy = sortBy;
 exports.takeRightWhile = takeRightWhile;
 exports.takeWhile = takeWhile;

package/dist/array/pullAt.d.mts

@@ -9,8 +9,6 @@
  * @returns {Array<T | undefined>} An array containing the elements that were removed from the original array.
  *
  * @example
- * import { pullAt } from './pullAt';
- *
  * const numbers = [10, 20, 30, 40, 50];
  * const removed = pullAt(numbers, [1, 3, 4]);
  * console.log(removed); // [20, 40, 50]

package/dist/array/pullAt.d.ts

@@ -9,8 +9,6 @@
  * @returns {Array<T | undefined>} An array containing the elements that were removed from the original array.
  *
  * @example
- * import { pullAt } from './pullAt';
- *
  * const numbers = [10, 20, 30, 40, 50];
  * const removed = pullAt(numbers, [1, 3, 4]);
  * console.log(removed); // [20, 40, 50]

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);