es-toolkit 1.13.1 → 1.14.0-dev.399

package/dist/array/tail.d.ts

@@ -1,7 +1,8 @@
 /**
  * Returns an empty array when the input is a single-element array.
  *
- * @param {readonly [T]} arr - The single-element array to process.
+ * @template T - The type of the single element in the array.
+ * @param {[T]} arr - The single-element array to process.
  * @returns {[]} An empty array.
  *
  * @example
@@ -13,7 +14,8 @@ declare function tail<T>(arr: readonly [T]): [];
 /**
  * Returns an empty array when the input is an empty array.
  *
- * @param {readonly []} arr - The empty array to process.
+ * @template T - The type of elements in the array.
+ * @param {[]} arr - The empty array to process.
  * @returns {[]} An empty array.
  *
  * @example
@@ -25,7 +27,9 @@ declare function tail(arr: readonly []): [];
 /**
  * Returns a new array with all elements except for the first when the input is a tuple array.
  *
- * @param {readonly [T, ...U[]]} arr - The tuple array to process.
+ * @template T - The type of the first element in the tuple array.
+ * @template U - The type of the remaining elements in the tuple array.
+ * @param {[T, ...U[]]} arr - The tuple array to process.
  * @returns {U[]} A new array containing all elements of the input array except for the first one.
  *
  * @example
@@ -41,7 +45,8 @@ declare function tail<T, U>(arr: readonly [T, ...U[]]): U[];
  * except for the first one. If the input array is empty or has only one element,
  * an empty array is returned.
  *
- * @param {readonly T[]} arr - The array to get the tail of.
+ * @template T - The type of elements in the array.
+ * @param {T[]} arr - The array to get the tail of.
  * @returns {T[]} A new array containing all elements of the input array except for the first one.
  *
  * @example

package/dist/array/tail.mjs

@@ -1,8 +1,13 @@
-import {
-  tail
-} from "../chunk-TJ4Z5I7M.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  tail
-};
-//# sourceMappingURL=tail.mjs.map
+function tail(arr) {
+    const len = arr.length;
+    if (len <= 1) {
+        return [];
+    }
+    const result = new Array(len - 1);
+    for (let i = 1; i < len; i++) {
+        result[i - 1] = arr[i];
+    }
+    return result;
+}
+
+export { tail };

package/dist/array/take.mjs

@@ -1,8 +1,5 @@
-import {
-  take
-} from "../chunk-ME352XO7.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  take
-};
-//# sourceMappingURL=take.mjs.map
+function take(arr, count) {
+    return arr.slice(0, count);
+}
+
+export { take };

package/dist/array/takeRight.d.mts

@@ -4,7 +4,7 @@
  *
  * @template T - The type of elements in the array.
  * @param {T[]} arr - The array to take elements from.
- * @param {number} count - The number of elements to take.
+ * @param {number} [count=1] - The number of elements to take.
  * @returns {T[]} A new array containing the last `count` elements from `arr`.
  *
  * @example
@@ -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): T[];
 
 export { takeRight };

package/dist/array/takeRight.d.ts

@@ -4,7 +4,7 @@
  *
  * @template T - The type of elements in the array.
  * @param {T[]} arr - The array to take elements from.
- * @param {number} count - The number of elements to take.
+ * @param {number} [count=1] - The number of elements to take.
  * @returns {T[]} A new array containing the last `count` elements from `arr`.
  *
  * @example
@@ -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): T[];
 
 export { takeRight };

package/dist/array/takeRight.mjs

@@ -1,8 +1,8 @@
-import {
-  takeRight
-} from "../chunk-IQLKIDXF.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  takeRight
-};
-//# sourceMappingURL=takeRight.mjs.map
+function takeRight(arr, count = 1) {
+    if (count <= 0) {
+        return [];
+    }
+    return arr.slice(-count);
+}
+
+export { takeRight };

package/dist/array/takeRightWhile.mjs

@@ -1,8 +1,10 @@
-import {
-  takeRightWhile
-} from "../chunk-NTLX2MPV.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  takeRightWhile
-};
-//# sourceMappingURL=takeRightWhile.mjs.map
+function takeRightWhile(arr, shouldContinueTaking) {
+    for (let i = arr.length - 1; i >= 0; i--) {
+        if (!shouldContinueTaking(arr[i])) {
+            return arr.slice(i + 1);
+        }
+    }
+    return arr.slice();
+}
+
+export { takeRightWhile };

package/dist/array/takeWhile.mjs

@@ -1,8 +1,12 @@
-import {
-  takeWhile
-} from "../chunk-2IXFGSUA.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  takeWhile
-};
-//# sourceMappingURL=takeWhile.mjs.map
+function takeWhile(arr, shouldContinueTaking) {
+    const result = [];
+    for (const item of arr) {
+        if (!shouldContinueTaking(item)) {
+            break;
+        }
+        result.push(item);
+    }
+    return result;
+}
+
+export { takeWhile };

package/dist/array/toFilled.d.mts

@@ -2,6 +2,8 @@
  * Creates a new array filled with the specified value from the start position up to, but not including, the end position.
  * This function does not mutate the original array.
  *
+ * @template T - The type of elements in the original array.
+ * @template U - The type of the value to fill the new array with.
  * @param {Array<T>} arr - The array to base the new array on.
  * @param {U} value - The value to fill the new array with.
  * @param {number} [start=0] - The start position. Defaults to 0.
@@ -26,8 +28,8 @@
  * console.log(result); // [1, '*', '*', '*', 5]
  * console.log(array); // [1, 2, 3, 4, 5]
  */
-declare function toFilled<T, U>(arr: T[], value: U): Array<T | U>;
-declare function toFilled<T, U>(arr: T[], value: U, start: number): Array<T | U>;
-declare function toFilled<T, U>(arr: T[], value: U, start: number, end: number): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U, start: number): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U, start: number, end: number): Array<T | U>;
 
 export { toFilled };

package/dist/array/toFilled.d.ts

@@ -2,6 +2,8 @@
  * Creates a new array filled with the specified value from the start position up to, but not including, the end position.
  * This function does not mutate the original array.
  *
+ * @template T - The type of elements in the original array.
+ * @template U - The type of the value to fill the new array with.
  * @param {Array<T>} arr - The array to base the new array on.
  * @param {U} value - The value to fill the new array with.
  * @param {number} [start=0] - The start position. Defaults to 0.
@@ -26,8 +28,8 @@
  * console.log(result); // [1, '*', '*', '*', 5]
  * console.log(array); // [1, 2, 3, 4, 5]
  */
-declare function toFilled<T, U>(arr: T[], value: U): Array<T | U>;
-declare function toFilled<T, U>(arr: T[], value: U, start: number): Array<T | U>;
-declare function toFilled<T, U>(arr: T[], value: U, start: number, end: number): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U, start: number): Array<T | U>;
+declare function toFilled<T, U>(arr: readonly T[], value: U, start: number, end: number): Array<T | U>;
 
 export { toFilled };

package/dist/array/toFilled.mjs

@@ -1,8 +1,12 @@
-import {
-  toFilled
-} from "../chunk-OP4OAKQJ.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  toFilled
-};
-//# sourceMappingURL=toFilled.mjs.map
+function toFilled(arr, value, start = 0, end = arr.length) {
+    const length = arr.length;
+    const finalStart = Math.max(start >= 0 ? start : length + start, 0);
+    const finalEnd = Math.min(end >= 0 ? end : length + end, length);
+    const newArr = arr.slice();
+    for (let i = finalStart; i < finalEnd; i++) {
+        newArr[i] = value;
+    }
+    return newArr;
+}
+
+export { toFilled };

package/dist/array/union.mjs

@@ -1,9 +1,7 @@
-import {
-  union
-} from "../chunk-R6QA7PLZ.mjs";
-import "../chunk-DVK2N4KC.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  union
-};
-//# sourceMappingURL=union.mjs.map
+import { uniq } from './uniq.mjs';
+
+function union(arr1, arr2) {
+    return uniq(arr1.concat(arr2));
+}
+
+export { union };

package/dist/array/unionBy.mjs

@@ -1,8 +1,12 @@
-import {
-  unionBy
-} from "../chunk-NFS7RWWE.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  unionBy
-};
-//# sourceMappingURL=unionBy.mjs.map
+function unionBy(arr1, arr2, mapper) {
+    const map = new Map();
+    for (const item of [...arr1, ...arr2]) {
+        const key = mapper(item);
+        if (!map.has(key)) {
+            map.set(key, item);
+        }
+    }
+    return Array.from(map.values());
+}
+
+export { unionBy };

package/dist/array/unionWith.mjs

@@ -1,9 +1,7 @@
-import {
-  unionWith
-} from "../chunk-2ZCITDMK.mjs";
-import "../chunk-237HGSZS.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  unionWith
-};
-//# sourceMappingURL=unionWith.mjs.map
+import { uniqWith } from './uniqWith.mjs';
+
+function unionWith(arr1, arr2, areItemsEqual) {
+    return uniqWith(arr1.concat(arr2), areItemsEqual);
+}
+
+export { unionWith };

package/dist/array/uniq.mjs

@@ -1,8 +1,5 @@
-import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  uniq
-};
-//# sourceMappingURL=uniq.mjs.map
+function uniq(arr) {
+    return Array.from(new Set(arr));
+}
+
+export { uniq };

package/dist/array/uniqBy.mjs

@@ -1,8 +1,12 @@
-import {
-  uniqBy
-} from "../chunk-B4COTK4K.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  uniqBy
-};
-//# sourceMappingURL=uniqBy.mjs.map
+function uniqBy(arr, mapper) {
+    const map = new Map();
+    for (const item of arr) {
+        const key = mapper(item);
+        if (!map.has(key)) {
+            map.set(key, item);
+        }
+    }
+    return Array.from(map.values());
+}
+
+export { uniqBy };

package/dist/array/uniqWith.mjs

@@ -1,8 +1,12 @@
-import {
-  uniqWith
-} from "../chunk-237HGSZS.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  uniqWith
-};
-//# sourceMappingURL=uniqWith.mjs.map
+function uniqWith(arr, areItemsEqual) {
+    const result = [];
+    for (const item of arr) {
+        const isUniq = result.every(v => !areItemsEqual(v, item));
+        if (isUniq) {
+            result.push(item);
+        }
+    }
+    return result;
+}
+
+export { uniqWith };

package/dist/array/unzip.d.mts

@@ -2,8 +2,9 @@
  * Gathers elements in the same position in an internal array
  * from a grouped array of elements and returns them as a new array.
  *
- * @param zipped - The nested array to unzip.
- * @returns A new array of unzipped elements.
+ * @template T - The type of elements in the nested array.
+ * @param {Array<[...T]>} zipped - The nested array to unzip.
+ * @returns {Unzip<T>} A new array of unzipped elements.
  *
  * @example
  * const zipped = [['a', true, 1],['b', false, 2]];

package/dist/array/unzip.d.ts

@@ -2,8 +2,9 @@
  * Gathers elements in the same position in an internal array
  * from a grouped array of elements and returns them as a new array.
  *
- * @param zipped - The nested array to unzip.
- * @returns A new array of unzipped elements.
+ * @template T - The type of elements in the nested array.
+ * @param {Array<[...T]>} zipped - The nested array to unzip.
+ * @returns {Unzip<T>} A new array of unzipped elements.
  *
  * @example
  * const zipped = [['a', true, 1],['b', false, 2]];

package/dist/array/unzip.mjs

@@ -1,8 +1,18 @@
-import {
-  unzip
-} from "../chunk-UYZKMBDO.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  unzip
-};
-//# sourceMappingURL=unzip.mjs.map
+function unzip(zipped) {
+    let maxLen = 0;
+    for (let i = 0; i < zipped.length; i++) {
+        if (zipped[i].length > maxLen) {
+            maxLen = zipped[i].length;
+        }
+    }
+    const result = new Array(maxLen);
+    for (let i = 0; i < maxLen; i++) {
+        result[i] = new Array(zipped.length);
+        for (let j = 0; j < zipped.length; j++) {
+            result[i][j] = zipped[j][i];
+        }
+    }
+    return result;
+}
+
+export { unzip };

package/dist/array/unzipWith.mjs

@@ -1,8 +1,14 @@
-import {
-  unzipWith
-} from "../chunk-IFNXROZR.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  unzipWith
-};
-//# sourceMappingURL=unzipWith.mjs.map
+function unzipWith(target, iteratee) {
+    const maxLength = Math.max(...target.map(innerArray => innerArray.length));
+    const result = new Array(maxLength);
+    for (let i = 0; i < maxLength; i++) {
+        const group = new Array(target.length);
+        for (let j = 0; j < target.length; j++) {
+            group[j] = target[j][i];
+        }
+        result[i] = iteratee(...group);
+    }
+    return result;
+}
+
+export { unzipWith };

package/dist/array/without.mjs

@@ -1,8 +1,6 @@
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  without
-};
-//# sourceMappingURL=without.mjs.map
+function without(array, ...values) {
+    const valuesSet = new Set(values);
+    return array.filter(item => !valuesSet.has(item));
+}
+
+export { without };

package/dist/array/xor.mjs

@@ -1,12 +1,9 @@
-import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
-import "../chunk-R6QA7PLZ.mjs";
-import "../chunk-DVK2N4KC.mjs";
-import "../chunk-FVVSE2F2.mjs";
-import "../chunk-JPUKH67K.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  xor
-};
-//# sourceMappingURL=xor.mjs.map
+import { difference } from './difference.mjs';
+import { intersection } from './intersection.mjs';
+import { union } from './union.mjs';
+
+function xor(arr1, arr2) {
+    return difference(union(arr1, arr2), intersection(arr1, arr2));
+}
+
+export { xor };

package/dist/array/xorBy.mjs

@@ -1,11 +1,11 @@
-import {
-  xorBy
-} from "../chunk-Q47NGNXT.mjs";
-import "../chunk-NFS7RWWE.mjs";
-import "../chunk-O6UXZR3U.mjs";
-import "../chunk-LVWX5B43.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  xorBy
-};
-//# sourceMappingURL=xorBy.mjs.map
+import { differenceBy } from './differenceBy.mjs';
+import { intersectionBy } from './intersectionBy.mjs';
+import { unionBy } from './unionBy.mjs';
+
+function xorBy(arr1, arr2, mapper) {
+    const union = unionBy(arr1, arr2, mapper);
+    const intersection = intersectionBy(arr1, arr2, mapper);
+    return differenceBy(union, intersection, mapper);
+}
+
+export { xorBy };

package/dist/array/xorWith.mjs

@@ -1,12 +1,11 @@
-import {
-  xorWith
-} from "../chunk-QRSJBBFY.mjs";
-import "../chunk-2ZCITDMK.mjs";
-import "../chunk-237HGSZS.mjs";
-import "../chunk-XI7KRD2C.mjs";
-import "../chunk-6NVQAHXP.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  xorWith
-};
-//# sourceMappingURL=xorWith.mjs.map
+import { differenceWith } from './differenceWith.mjs';
+import { intersectionWith } from './intersectionWith.mjs';
+import { unionWith } from './unionWith.mjs';
+
+function xorWith(arr1, arr2, areElementsEqual) {
+    const union = unionWith(arr1, arr2, areElementsEqual);
+    const intersection = intersectionWith(arr1, arr2, areElementsEqual);
+    return differenceWith(union, intersection, areElementsEqual);
+}
+
+export { xorWith };

package/dist/array/zip.d.mts

@@ -7,6 +7,7 @@
  * with undefined values for missing elements.
  *
  * @param {...T[][]} arrs - The arrays to zip together.
+ * @param arr1
  * @returns {T[][]} A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example

package/dist/array/zip.d.ts

@@ -7,6 +7,7 @@
  * with undefined values for missing elements.
  *
  * @param {...T[][]} arrs - The arrays to zip together.
+ * @param arr1
  * @returns {T[][]} A new array of tuples containing the corresponding elements from the input arrays.
  *
  * @example

package/dist/array/zip.mjs

@@ -1,8 +1,14 @@
-import {
-  zip
-} from "../chunk-IDCUZVJL.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  zip
-};
-//# sourceMappingURL=zip.mjs.map
+function zip(...arrs) {
+    const result = [];
+    const maxIndex = Math.max(...arrs.map(x => x.length));
+    for (let i = 0; i < maxIndex; i++) {
+        const element = [];
+        for (const arr of arrs) {
+            element.push(arr[i]);
+        }
+        result.push(element);
+    }
+    return result;
+}
+
+export { zip };

package/dist/array/zipObject.d.mts

@@ -28,7 +28,7 @@
  * const result2 = zipObject(keys2, values2);
  * // result2 will be { a: 1, b: 2 }
  */
-declare function zipObject<P extends string | number | symbol, V>(keys: P[], values: V[]): {
+declare function zipObject<P extends PropertyKey, V>(keys: P[], values: V[]): {
     [K in P]: V;
 };
 

package/dist/array/zipObject.d.ts

@@ -28,7 +28,7 @@
  * const result2 = zipObject(keys2, values2);
  * // result2 will be { a: 1, b: 2 }
  */
-declare function zipObject<P extends string | number | symbol, V>(keys: P[], values: V[]): {
+declare function zipObject<P extends PropertyKey, V>(keys: P[], values: V[]): {
     [K in P]: V;
 };
 

package/dist/array/zipObject.mjs

@@ -1,8 +1,9 @@
-import {
-  zipObject
-} from "../chunk-6GWEY5EL.mjs";
-import "../chunk-24FKGR6U.mjs";
-export {
-  zipObject
-};
-//# sourceMappingURL=zipObject.mjs.map
+function zipObject(keys, values) {
+    const result = {};
+    for (let i = 0; i < keys.length; i++) {
+        result[keys[i]] = values[i];
+    }
+    return result;
+}
+
+export { zipObject };

package/dist/array/zipWith.d.mts

@@ -4,6 +4,11 @@
  * This function takes multiple arrays and a combiner function, and returns a new array where each element
  * is the result of applying the combiner function to the corresponding elements of the input arrays.
  *
+ * @template T - The type of elements in the first array.
+ * @template U - The type of elements in the second array (optional).
+ * @template V - The type of elements in the third array (optional).
+ * @template W - The type of elements in the fourth array (optional).
+ * @template R - The type of elements in the resulting array.
  * @param {T[]} arr1 - The first array to zip.
  * @param {U[]} [arr2] - The second array to zip (optional).
  * @param {V[]} [arr3] - The third array to zip (optional).

package/dist/array/zipWith.d.ts

@@ -4,6 +4,11 @@
  * This function takes multiple arrays and a combiner function, and returns a new array where each element
  * is the result of applying the combiner function to the corresponding elements of the input arrays.
  *
+ * @template T - The type of elements in the first array.
+ * @template U - The type of elements in the second array (optional).
+ * @template V - The type of elements in the third array (optional).
+ * @template W - The type of elements in the fourth array (optional).
+ * @template R - The type of elements in the resulting array.
  * @param {T[]} arr1 - The first array to zip.
  * @param {U[]} [arr2] - The second array to zip (optional).
  * @param {V[]} [arr3] - The third array to zip (optional).