es-toolkit 1.8.0-dev.158 → 1.8.0-dev.160

package/dist/array/index.mjs

@@ -1,4 +1,16 @@
-import "../chunk-OC7ZNKWX.mjs";
+import "../chunk-467PWPPF.mjs";
+import {
+  without
+} from "../chunk-PYEYV7BY.mjs";
+import {
+  xor
+} from "../chunk-L7FQX5MN.mjs";
+import {
+  xorBy
+} from "../chunk-Q47NGNXT.mjs";
+import {
+  xorWith
+} from "../chunk-QRSJBBFY.mjs";
 import {
   zip
 } from "../chunk-IDCUZVJL.mjs";
@@ -8,24 +20,39 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
+import {
+  union
+} from "../chunk-R6QA7PLZ.mjs";
+import {
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
+import {
+  unionWith
+} from "../chunk-2ZCITDMK.mjs";
+import {
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
 import {
   uniqBy
 } from "../chunk-OXAZEEGP.mjs";
+import {
+  uniqWith
+} from "../chunk-237HGSZS.mjs";
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
 import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
 import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
-import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
+  partition
+} from "../chunk-DN3NOZ3H.mjs";
 import {
-  xorBy
-} from "../chunk-Q47NGNXT.mjs";
+  sample
+} from "../chunk-2KNLZB7V.mjs";
 import {
-  xorWith
-} from "../chunk-QRSJBBFY.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
 import {
   shuffle
 } from "../chunk-G7UQ5PUR.mjs";
@@ -42,20 +69,11 @@ import {
   takeWhile
 } from "../chunk-2IXFGSUA.mjs";
 import {
-  union
-} from "../chunk-R6QA7PLZ.mjs";
-import {
-  uniq
-} from "../chunk-DVK2N4KC.mjs";
-import {
-  unionBy
-} from "../chunk-NFS7RWWE.mjs";
-import {
-  unionWith
-} from "../chunk-2ZCITDMK.mjs";
+  intersection
+} from "../chunk-FVVSE2F2.mjs";
 import {
-  uniqWith
-} from "../chunk-237HGSZS.mjs";
+  intersectionBy
+} from "../chunk-O6UXZR3U.mjs";
 import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
@@ -72,16 +90,11 @@ import {
   orderBy
 } from "../chunk-7B7W36UP.mjs";
 import {
-  partition
-} from "../chunk-DN3NOZ3H.mjs";
-import {
-  sample
-} from "../chunk-2KNLZB7V.mjs";
+  drop
+} from "../chunk-S3CORED5.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import "../chunk-GIWAOOFY.mjs";
-import "../chunk-SYWMYQYJ.mjs";
+  dropRight
+} from "../chunk-JEKUA56R.mjs";
 import {
   dropRightWhile
 } from "../chunk-JE6JKZU3.mjs";
@@ -98,11 +111,8 @@ import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
 import {
-  intersection
-} from "../chunk-FVVSE2F2.mjs";
-import {
-  intersectionBy
-} from "../chunk-O6UXZR3U.mjs";
+  head
+} from "../chunk-HM2JT2RX.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -121,12 +131,8 @@ import {
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
-import {
-  drop
-} from "../chunk-S3CORED5.mjs";
-import {
-  dropRight
-} from "../chunk-JEKUA56R.mjs";
+import "../chunk-GIWAOOFY.mjs";
+import "../chunk-SYWMYQYJ.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   chunk,
@@ -142,6 +148,7 @@ export {
   fill,
   forEachRight,
   groupBy,
+  head,
   intersection,
   intersectionBy,
   intersectionWith,
@@ -163,6 +170,7 @@ export {
   uniq,
   uniqBy,
   uniqWith,
+  unzip,
   unzipWith,
   without,
   xor,

package/dist/array/unzip.d.mts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ *
+ * @example
+ * const zipped = [['a', true, 1],['b', false, 2]];
+ * const result = unzip(zipped);
+ * // result will be [['a', 'b'], [true, false], [1, 2]]
+ */
+declare function unzip<T extends unknown[]>(zipped: Array<[...T]>): Unzip<T>;
+type Unzip<K extends unknown[]> = {
+    [I in keyof K]: Array<K[I]>;
+};
+
+export { unzip };

package/dist/array/unzip.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ *
+ * @example
+ * const zipped = [['a', true, 1],['b', false, 2]];
+ * const result = unzip(zipped);
+ * // result will be [['a', 'b'], [true, false], [1, 2]]
+ */
+declare function unzip<T extends unknown[]>(zipped: Array<[...T]>): Unzip<T>;
+type Unzip<K extends unknown[]> = {
+    [I in keyof K]: Array<K[I]>;
+};
+
+export { unzip };

package/dist/array/unzip.js

@@ -0,0 +1,46 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/array/unzip.ts
+var unzip_exports = {};
+__export(unzip_exports, {
+  unzip: () => unzip
+});
+module.exports = __toCommonJS(unzip_exports);
+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;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  unzip
+});
+//# sourceMappingURL=unzip.js.map

package/dist/array/unzip.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/array/unzip.ts"],"sourcesContent":["/**\n * Gathers elements in the same position in an internal array \n * from a grouped array of elements and returns them as a new array.\n *\n * @param zipped - The nested array to unzip.\n * @returns A new array of unzipped elements.\n *\n * @example\n * const zipped = [['a', true, 1],['b', false, 2]];\n * const result = unzip(zipped);\n * // result will be [['a', 'b'], [true, false], [1, 2]]\n */\nexport function unzip<T extends unknown[]>(zipped: Array<[...T]>): Unzip<T> {\n  // For performance reasons, use this implementation instead of\n  // const maxLen = Math.max(...zipped.map(arr => arr.length));\n  let maxLen = 0;\n\n  for (let i = 0; i < zipped.length; i++) {\n    if (zipped[i].length > maxLen) {\n      maxLen = zipped[i].length;\n    }\n  }\n\n  const result = new Array(maxLen) as Unzip<T>;\n\n  for (let i = 0; i < maxLen; i++) {\n    result[i] = new Array(zipped.length);\n    for (let j = 0; j < zipped.length; j++) {\n      result[i][j] = zipped[j][i];\n    }\n  }\n\n  return result;\n}\n\ntype Unzip<K extends unknown[]> = { [I in keyof K]: Array<K[I]> };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAYO,SAAS,MAA2B,QAAiC;AAG1E,MAAI,SAAS;AAEb,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,QAAI,OAAO,CAAC,EAAE,SAAS,QAAQ;AAC7B,eAAS,OAAO,CAAC,EAAE;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,WAAO,CAAC,IAAI,IAAI,MAAM,OAAO,MAAM;AACnC,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,aAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/array/unzip.mjs

@@ -0,0 +1,8 @@
+import {
+  unzip
+} from "../chunk-UYZKMBDO.mjs";
+import "../chunk-2MM5EJJX.mjs";
+export {
+  unzip
+};
+//# sourceMappingURL=unzip.mjs.map

package/dist/array/unzip.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-467PWPPF.mjs

@@ -0,0 +1 @@
+//# sourceMappingURL=chunk-467PWPPF.mjs.map

package/dist/chunk-467PWPPF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-HM2JT2RX.mjs

@@ -0,0 +1,9 @@
+// src/array/head.ts
+function head(arr) {
+  return arr[0];
+}
+
+export {
+  head
+};
+//# sourceMappingURL=chunk-HM2JT2RX.mjs.map

package/dist/chunk-HM2JT2RX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/array/head.ts"],"sourcesContent":["/**\n * Returns the first element of an array.\n *\n * This function takes an array and returns the first element of the array.\n * If the array is empty, the function returns `undefined`.\n *\n * @param {T[]} arr - The array from which to get the first element.\n * @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.\n *\n * @example\n * const arr = [1, 2, 3];\n * const firstElement = head(arr);\n * // firstElement will be 1\n *\n * const emptyArr: number[] = [];\n * const noElement = head(emptyArr);\n * // noElement will be undefined\n */\nexport function head<T>(arr: readonly [T, ...T[]]): T;\nexport function head<T>(arr: readonly T[]): T | undefined;\nexport function head<T>(arr: readonly T[]): T | undefined {\n  return arr[0];\n}\n"],"mappings":";AAoBO,SAAS,KAAQ,KAAkC;AACxD,SAAO,IAAI,CAAC;AACd;","names":[]}

package/dist/chunk-UYZKMBDO.mjs

@@ -0,0 +1,22 @@
+// src/array/unzip.ts
+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
+};
+//# sourceMappingURL=chunk-UYZKMBDO.mjs.map

package/dist/chunk-UYZKMBDO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/array/unzip.ts"],"sourcesContent":["/**\n * Gathers elements in the same position in an internal array \n * from a grouped array of elements and returns them as a new array.\n *\n * @param zipped - The nested array to unzip.\n * @returns A new array of unzipped elements.\n *\n * @example\n * const zipped = [['a', true, 1],['b', false, 2]];\n * const result = unzip(zipped);\n * // result will be [['a', 'b'], [true, false], [1, 2]]\n */\nexport function unzip<T extends unknown[]>(zipped: Array<[...T]>): Unzip<T> {\n  // For performance reasons, use this implementation instead of\n  // const maxLen = Math.max(...zipped.map(arr => arr.length));\n  let maxLen = 0;\n\n  for (let i = 0; i < zipped.length; i++) {\n    if (zipped[i].length > maxLen) {\n      maxLen = zipped[i].length;\n    }\n  }\n\n  const result = new Array(maxLen) as Unzip<T>;\n\n  for (let i = 0; i < maxLen; i++) {\n    result[i] = new Array(zipped.length);\n    for (let j = 0; j < zipped.length; j++) {\n      result[i][j] = zipped[j][i];\n    }\n  }\n\n  return result;\n}\n\ntype Unzip<K extends unknown[]> = { [I in keyof K]: Array<K[I]> };\n"],"mappings":";AAYO,SAAS,MAA2B,QAAiC;AAG1E,MAAI,SAAS;AAEb,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,QAAI,OAAO,CAAC,EAAE,SAAS,QAAQ;AAC7B,eAAS,OAAO,CAAC,EAAE;AAAA,IACrB;AAAA,EACF;AAEA,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,WAAO,CAAC,IAAI,IAAI,MAAM,OAAO,MAAM;AACnC,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,aAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC;AAAA,IAC5B;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/index.d.mts

@@ -32,6 +32,7 @@ export { unionWith } from './array/unionWith.mjs';
 export { uniq } from './array/uniq.mjs';
 export { uniqBy } from './array/uniqBy.mjs';
 export { uniqWith } from './array/uniqWith.mjs';
+export { unzip } from './array/unzip.mjs';
 export { unzipWith } from './array/unzipWith.mjs';
 export { xor } from './array/xor.mjs';
 export { xorBy } from './array/xorBy.mjs';
@@ -40,6 +41,7 @@ export { zip } from './array/zip.mjs';
 export { zipObject } from './array/zipObject.mjs';
 export { zipWith } from './array/zipWith.mjs';
 export { without } from './array/without.mjs';
+export { head } from './array/head.mjs';
 export { AbortError } from './error/AbortError.mjs';
 export { debounce } from './function/debounce.mjs';
 export { noop } from './function/noop.mjs';

package/dist/index.d.ts

@@ -32,6 +32,7 @@ export { unionWith } from './array/unionWith.js';
 export { uniq } from './array/uniq.js';
 export { uniqBy } from './array/uniqBy.js';
 export { uniqWith } from './array/uniqWith.js';
+export { unzip } from './array/unzip.js';
 export { unzipWith } from './array/unzipWith.js';
 export { xor } from './array/xor.js';
 export { xorBy } from './array/xorBy.js';
@@ -40,6 +41,7 @@ export { zip } from './array/zip.js';
 export { zipObject } from './array/zipObject.js';
 export { zipWith } from './array/zipWith.js';
 export { without } from './array/without.js';
+export { head } from './array/head.js';
 export { AbortError } from './error/AbortError.js';
 export { debounce } from './function/debounce.js';
 export { noop } from './function/noop.js';

package/dist/index.js

@@ -51,6 +51,7 @@ __export(src_exports, {
   fill: () => fill,
   forEachRight: () => forEachRight,
   groupBy: () => groupBy,
+  head: () => head,
   inRange: () => inRange,
   intersection: () => intersection,
   intersectionBy: () => intersectionBy,
@@ -92,6 +93,7 @@ __export(src_exports, {
   uniq: () => uniq,
   uniqBy: () => uniqBy,
   uniqWith: () => uniqWith,
+  unzip: () => unzip,
   unzipWith: () => unzipWith,
   without: () => without,
   xor: () => xor,
@@ -457,6 +459,24 @@ function uniqBy(arr, mapper) {
   return Array.from(map.values());
 }
 
+// src/array/unzip.ts
+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;
+}
+
 // src/array/unzipWith.ts
 function unzipWith(target, iteratee) {
   const maxLength = Math.max(...target.map((innerArray) => innerArray.length));
@@ -532,6 +552,11 @@ function without(array, ...values) {
   return array.filter((item) => !valuesSet.has(item));
 }
 
+// src/array/head.ts
+function head(arr) {
+  return arr[0];
+}
+
 // src/error/AbortError.ts
 var AbortError = class extends Error {
   constructor(message = "The operation was aborted") {
@@ -777,6 +802,7 @@ function delay(ms, { signal } = {}) {
   fill,
   forEachRight,
   groupBy,
+  head,
   inRange,
   intersection,
   intersectionBy,
@@ -818,6 +844,7 @@ function delay(ms, { signal } = {}) {
   uniq,
   uniqBy,
   uniqWith,
+  unzip,
   unzipWith,
   without,
   xor,