es-toolkit 1.13.1-dev.321 → 1.13.1-dev.322

package/dist/array/index.mjs

@@ -1,13 +1,10 @@
 import "../chunk-DDH7K4QM.mjs";
-import {
-  zipObject
-} from "../chunk-6GWEY5EL.mjs";
 import {
   zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+} from "../chunk-MJ7LNBI6.mjs";
 import {
   unzip
-} from "../chunk-UYZKMBDO.mjs";
+} from "../chunk-JCRY7ZYS.mjs";
 import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
@@ -27,14 +24,14 @@ import {
   zip
 } from "../chunk-OLORW442.mjs";
 import {
-  takeRightWhile
-} from "../chunk-NTLX2MPV.mjs";
+  zipObject
+} from "../chunk-6GWEY5EL.mjs";
 import {
   takeWhile
 } from "../chunk-2IXFGSUA.mjs";
 import {
   toFilled
-} from "../chunk-OP4OAKQJ.mjs";
+} from "../chunk-XHSIT5DL.mjs";
 import {
   union
 } from "../chunk-R6QA7PLZ.mjs";
@@ -44,9 +41,6 @@ import {
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
-import {
-  uniqWith
-} from "../chunk-237HGSZS.mjs";
 import {
   uniq
 } from "../chunk-DVK2N4KC.mjs";
@@ -54,8 +48,8 @@ import {
   uniqBy
 } from "../chunk-B4COTK4K.mjs";
 import {
-  orderBy
-} from "../chunk-7B7W36UP.mjs";
+  uniqWith
+} from "../chunk-237HGSZS.mjs";
 import {
   partition
 } from "../chunk-DN3NOZ3H.mjs";
@@ -72,7 +66,7 @@ import {
 } from "../chunk-G7UQ5PUR.mjs";
 import {
   tail
-} from "../chunk-TJ4Z5I7M.mjs";
+} from "../chunk-DLS7UJKJ.mjs";
 import {
   take
 } from "../chunk-ME352XO7.mjs";
@@ -80,8 +74,8 @@ import {
   takeRight
 } from "../chunk-N3QYJX4T.mjs";
 import {
-  initial
-} from "../chunk-XPSOKBRZ.mjs";
+  takeRightWhile
+} from "../chunk-NTLX2MPV.mjs";
 import {
   intersection
 } from "../chunk-FVVSE2F2.mjs";
@@ -96,7 +90,7 @@ import {
 } from "../chunk-AJKZMN2V.mjs";
 import {
   last
-} from "../chunk-KPBQ7OUY.mjs";
+} from "../chunk-DTTKJ3VC.mjs";
 import {
   maxBy
 } from "../chunk-OOKNBU4V.mjs";
@@ -104,8 +98,8 @@ import {
   minBy
 } from "../chunk-IJD7FE2Z.mjs";
 import {
-  fill
-} from "../chunk-YFN6KOC4.mjs";
+  orderBy
+} from "../chunk-7B7W36UP.mjs";
 import {
   flatMap
 } from "../chunk-UY76KTPE.mjs";
@@ -123,10 +117,10 @@ import {
 } from "../chunk-E6E4RZLN.mjs";
 import {
   head
-} from "../chunk-HM2JT2RX.mjs";
+} from "../chunk-FZZNWXDM.mjs";
 import {
-  countBy
-} from "../chunk-Z7HWEOQX.mjs";
+  initial
+} from "../chunk-XPSOKBRZ.mjs";
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
@@ -148,12 +142,18 @@ import {
 import {
   dropWhile
 } from "../chunk-LJ2C6MVP.mjs";
+import {
+  fill
+} from "../chunk-GTFDDKZ2.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
 import {
   compact
-} from "../chunk-DTJJIMKJ.mjs";
+} from "../chunk-PJPGJ2O6.mjs";
+import {
+  countBy
+} from "../chunk-Z7HWEOQX.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   chunk,

package/dist/array/last.d.mts

@@ -7,6 +7,7 @@
  * Unlike some implementations, this function is optimized for performance
  * by directly accessing the last index of the array.
  *
+ * @template T - The type of elements in the array.
  * @param {T[]} arr - The array from which to get the last element.
  * @returns {T | undefined} The last element of the array, or `undefined` if the array is empty.
  *

package/dist/array/last.d.ts

@@ -7,6 +7,7 @@
  * Unlike some implementations, this function is optimized for performance
  * by directly accessing the last index of the array.
  *
+ * @template T - The type of elements in the array.
  * @param {T[]} arr - The array from which to get the last element.
  * @returns {T | undefined} The last element of the array, or `undefined` if the array is empty.
  *

package/dist/array/last.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/last.ts"],"sourcesContent":["/**\n * Returns the last element of an array.\n *\n * This function takes an array and returns the last element of the array.\n * If the array is empty, the function returns `undefined`.\n *\n * Unlike some implementations, this function is optimized for performance\n * by directly accessing the last index of the array.\n *\n * @param {T[]} arr - The array from which to get the last element.\n * @returns {T | undefined} The last element of the array, or `undefined` if the array is empty.\n *\n * @example\n * const arr = [1, 2, 3];\n * const lastElement = last(arr);\n * // lastElement will be 3\n *\n * const emptyArr: number[] = [];\n * const noElement = last(emptyArr);\n * // noElement will be undefined\n */\n\nexport function last<T>(arr: readonly [...T[], T]): T;\nexport function last<T>(arr: readonly T[]): T | undefined;\nexport function last<T>(arr: readonly T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAwBO,SAAS,KAAQ,KAAkC;AACxD,SAAO,IAAI,IAAI,SAAS,CAAC;AAC3B;","names":[]}
+{"version":3,"sources":["../../src/array/last.ts"],"sourcesContent":["/**\n * Returns the last element of an array.\n *\n * This function takes an array and returns the last element of the array.\n * If the array is empty, the function returns `undefined`.\n *\n * Unlike some implementations, this function is optimized for performance\n * by directly accessing the last index of the array.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} arr - The array from which to get the last element.\n * @returns {T | undefined} The last element of the array, or `undefined` if the array is empty.\n *\n * @example\n * const arr = [1, 2, 3];\n * const lastElement = last(arr);\n * // lastElement will be 3\n *\n * const emptyArr: number[] = [];\n * const noElement = last(emptyArr);\n * // noElement will be undefined\n */\n\nexport function last<T>(arr: readonly [...T[], T]): T;\nexport function last<T>(arr: readonly T[]): T | undefined;\nexport function last<T>(arr: readonly T[]): T | undefined {\n  return arr[arr.length - 1];\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAyBO,SAAS,KAAQ,KAAkC;AACxD,SAAO,IAAI,IAAI,SAAS,CAAC;AAC3B;","names":[]}

package/dist/array/last.mjs

@@ -1,6 +1,6 @@
 import {
   last
-} from "../chunk-KPBQ7OUY.mjs";
+} from "../chunk-DTTKJ3VC.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   last

package/dist/array/tail.d.mts

@@ -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.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.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/tail.ts"],"sourcesContent":["/**\n * Returns an empty array when the input is a single-element array.\n *\n * @param {readonly [T]} arr - The single-element array to process.\n * @returns {[]} An empty array.\n *\n * @example\n * const arr = [1];\n * const result = tail(arr);\n * // result will be []\n */\nexport function tail<T>(arr: readonly [T]): [];\n\n/**\n * Returns an empty array when the input is an empty array.\n *\n * @param {readonly []} arr - The empty array to process.\n * @returns {[]} An empty array.\n *\n * @example\n * const arr = [];\n * const result = tail(arr);\n * // result will be []\n */\nexport function tail(arr: readonly []): [];\n\n/**\n * Returns a new array with all elements except for the first when the input is a tuple array.\n *\n * @param {readonly [T, ...U[]]} arr - The tuple array to process.\n * @returns {U[]} A new array containing all elements of the input array except for the first one.\n *\n * @example\n * const arr = [1, 2, 3];\n * const result = tail(arr);\n * // result will be [2, 3]\n */\nexport function tail<T, U>(arr: readonly [T, ...U[]]): U[];\n\n/**\n * Returns a new array with all elements except for the first.\n *\n * This function takes an array and returns a new array containing all the elements\n * except for the first one. If the input array is empty or has only one element,\n * an empty array is returned.\n *\n * @param {readonly T[]} arr - The array to get the tail of.\n * @returns {T[]} A new array containing all elements of the input array except for the first one.\n *\n * @example\n * const arr1 = [1, 2, 3];\n * const result = tail(arr1);\n * // result will be [2, 3]\n *\n * const arr2 = [1];\n * const result2 = tail(arr2);\n * // result2 will be []\n *\n * const arr3 = [];\n * const result3 = tail(arr3);\n * // result3 will be []\n */\nexport function tail<T>(arr: readonly T[]): T[];\n\nexport function tail<T>(arr: readonly T[]): T[] {\n  const len = arr.length;\n  if (len <= 1) {\n    return [];\n  }\n  const result = new Array(len - 1);\n  for (let i = 1; i < len; i++) {\n    result[i - 1] = arr[i];\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgEO,SAAS,KAAQ,KAAwB;AAC9C,QAAM,MAAM,IAAI;AAChB,MAAI,OAAO,GAAG;AACZ,WAAO,CAAC;AAAA,EACV;AACA,QAAM,SAAS,IAAI,MAAM,MAAM,CAAC;AAChC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,WAAO,IAAI,CAAC,IAAI,IAAI,CAAC;AAAA,EACvB;AACA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/tail.ts"],"sourcesContent":["/**\n * Returns an empty array when the input is a single-element array.\n *\n * @template T - The type of the single element in the array.\n * @param {[T]} arr - The single-element array to process.\n * @returns {[]} An empty array.\n *\n * @example\n * const arr = [1];\n * const result = tail(arr);\n * // result will be []\n */\nexport function tail<T>(arr: readonly [T]): [];\n\n/**\n * Returns an empty array when the input is an empty array.\n *\n * @template T - The type of elements in the array.\n * @param {[]} arr - The empty array to process.\n * @returns {[]} An empty array.\n *\n * @example\n * const arr = [];\n * const result = tail(arr);\n * // result will be []\n */\nexport function tail(arr: readonly []): [];\n\n/**\n * Returns a new array with all elements except for the first when the input is a tuple array.\n *\n * @template T - The type of the first element in the tuple array.\n * @template U - The type of the remaining elements in the tuple array.\n * @param {[T, ...U[]]} arr - The tuple array to process.\n * @returns {U[]} A new array containing all elements of the input array except for the first one.\n *\n * @example\n * const arr = [1, 2, 3];\n * const result = tail(arr);\n * // result will be [2, 3]\n */\nexport function tail<T, U>(arr: readonly [T, ...U[]]): U[];\n\n/**\n * Returns a new array with all elements except for the first.\n *\n * This function takes an array and returns a new array containing all the elements\n * except for the first one. If the input array is empty or has only one element,\n * an empty array is returned.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} arr - The array to get the tail of.\n * @returns {T[]} A new array containing all elements of the input array except for the first one.\n *\n * @example\n * const arr1 = [1, 2, 3];\n * const result = tail(arr1);\n * // result will be [2, 3]\n *\n * const arr2 = [1];\n * const result2 = tail(arr2);\n * // result2 will be []\n *\n * const arr3 = [];\n * const result3 = tail(arr3);\n * // result3 will be []\n */\nexport function tail<T>(arr: readonly T[]): T[];\n\nexport function tail<T>(arr: readonly T[]): T[] {\n  const len = arr.length;\n  if (len <= 1) {\n    return [];\n  }\n  const result = new Array(len - 1);\n  for (let i = 1; i < len; i++) {\n    result[i - 1] = arr[i];\n  }\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqEO,SAAS,KAAQ,KAAwB;AAC9C,QAAM,MAAM,IAAI;AAChB,MAAI,OAAO,GAAG;AACZ,WAAO,CAAC;AAAA,EACV;AACA,QAAM,SAAS,IAAI,MAAM,MAAM,CAAC;AAChC,WAAS,IAAI,GAAG,IAAI,KAAK,KAAK;AAC5B,WAAO,IAAI,CAAC,IAAI,IAAI,CAAC;AAAA,EACvB;AACA,SAAO;AACT;","names":[]}

package/dist/array/tail.mjs

@@ -1,6 +1,6 @@
 import {
   tail
-} from "../chunk-TJ4Z5I7M.mjs";
+} from "../chunk-DLS7UJKJ.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   tail

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.

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.

package/dist/array/toFilled.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/toFilled.ts"],"sourcesContent":["/**\n * Creates a new array filled with the specified value from the start position up to, but not including, the end position.\n * This function does not mutate the original array.\n *\n * @param {Array<T>} arr - The array to base the new array on.\n * @param {U} value - The value to fill the new array with.\n * @param {number} [start=0] - The start position. Defaults to 0.\n * @param {number} [end=arr.length] - The end position. Defaults to the array's length.\n * @returns {Array<T | U>} The new array with the filled values.\n *\n * @example\n * const array = [1, 2, 3, 4, 5];\n * let result = toFilled(array, '*', 2);\n * console.log(result); // [1, 2, '*', '*', '*']\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*', 1, 4);\n * console.log(result); // [1, '*', '*', '*', 5]\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*');\n * console.log(result); // ['*', '*', '*', '*', '*']\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*', -4, -1);\n * console.log(result); // [1, '*', '*', '*', 5]\n * console.log(array); // [1, 2, 3, 4, 5]\n */\n\nexport function toFilled<T, U>(arr: T[], value: U): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start: number): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start: number, end: number): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start = 0, end = arr.length): Array<T | U> {\n  const length = arr.length;\n  const finalStart = Math.max(start >= 0 ? start : length + start, 0);\n  const finalEnd = Math.min(end >= 0 ? end : length + end, length);\n\n  const newArr: Array<T | U> = arr.slice();\n\n  for (let i = finalStart; i < finalEnd; i++) {\n    newArr[i] = value;\n  }\n\n  return newArr;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgCO,SAAS,SAAe,KAAU,OAAU,QAAQ,GAAG,MAAM,IAAI,QAAsB;AAC5F,QAAM,SAAS,IAAI;AACnB,QAAM,aAAa,KAAK,IAAI,SAAS,IAAI,QAAQ,SAAS,OAAO,CAAC;AAClE,QAAM,WAAW,KAAK,IAAI,OAAO,IAAI,MAAM,SAAS,KAAK,MAAM;AAE/D,QAAM,SAAuB,IAAI,MAAM;AAEvC,WAAS,IAAI,YAAY,IAAI,UAAU,KAAK;AAC1C,WAAO,CAAC,IAAI;AAAA,EACd;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/toFilled.ts"],"sourcesContent":["/**\n * Creates a new array filled with the specified value from the start position up to, but not including, the end position.\n * This function does not mutate the original array.\n *\n * @template T - The type of elements in the original array.\n * @template U - The type of the value to fill the new array with.\n * @param {Array<T>} arr - The array to base the new array on.\n * @param {U} value - The value to fill the new array with.\n * @param {number} [start=0] - The start position. Defaults to 0.\n * @param {number} [end=arr.length] - The end position. Defaults to the array's length.\n * @returns {Array<T | U>} The new array with the filled values.\n *\n * @example\n * const array = [1, 2, 3, 4, 5];\n * let result = toFilled(array, '*', 2);\n * console.log(result); // [1, 2, '*', '*', '*']\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*', 1, 4);\n * console.log(result); // [1, '*', '*', '*', 5]\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*');\n * console.log(result); // ['*', '*', '*', '*', '*']\n * console.log(array); // [1, 2, 3, 4, 5]\n *\n * result = toFilled(array, '*', -4, -1);\n * console.log(result); // [1, '*', '*', '*', 5]\n * console.log(array); // [1, 2, 3, 4, 5]\n */\n\nexport function toFilled<T, U>(arr: T[], value: U): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start: number): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start: number, end: number): Array<T | U>;\nexport function toFilled<T, U>(arr: T[], value: U, start = 0, end = arr.length): Array<T | U> {\n  const length = arr.length;\n  const finalStart = Math.max(start >= 0 ? start : length + start, 0);\n  const finalEnd = Math.min(end >= 0 ? end : length + end, length);\n\n  const newArr: Array<T | U> = arr.slice();\n\n  for (let i = finalStart; i < finalEnd; i++) {\n    newArr[i] = value;\n  }\n\n  return newArr;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkCO,SAAS,SAAe,KAAU,OAAU,QAAQ,GAAG,MAAM,IAAI,QAAsB;AAC5F,QAAM,SAAS,IAAI;AACnB,QAAM,aAAa,KAAK,IAAI,SAAS,IAAI,QAAQ,SAAS,OAAO,CAAC;AAClE,QAAM,WAAW,KAAK,IAAI,OAAO,IAAI,MAAM,SAAS,KAAK,MAAM;AAE/D,QAAM,SAAuB,IAAI,MAAM;AAEvC,WAAS,IAAI,YAAY,IAAI,UAAU,KAAK;AAC1C,WAAO,CAAC,IAAI;AAAA,EACd;AAEA,SAAO;AACT;","names":[]}

package/dist/array/toFilled.mjs

@@ -1,6 +1,6 @@
 import {
   toFilled
-} from "../chunk-OP4OAKQJ.mjs";
+} from "../chunk-XHSIT5DL.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   toFilled

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.js.map

@@ -1 +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":[]}
+{"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 * @template T - The type of elements in the nested array.\n * @param {Array<[...T]>} zipped - The nested array to unzip.\n * @returns {Unzip<T>} 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;AAaO,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

@@ -1,6 +1,6 @@
 import {
   unzip
-} from "../chunk-UYZKMBDO.mjs";
+} from "../chunk-JCRY7ZYS.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   unzip

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

package/dist/array/zipWith.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/zipWith.ts"],"sourcesContent":["/**\n * Combines multiple arrays into a single array using a custom combiner function.\n *\n * This function takes multiple arrays and a combiner function, and returns a new array where each element\n * is the result of applying the combiner function to the corresponding elements of the input arrays.\n *\n * @param {T[]} arr1 - The first array to zip.\n * @param {U[]} [arr2] - The second array to zip (optional).\n * @param {V[]} [arr3] - The third array to zip (optional).\n * @param {W[]} [arr4] - The fourth array to zip (optional).\n * @param {(...items: T[]) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.\n * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.\n *\n * @example\n * // Example usage with two arrays:\n * const arr1 = [1, 2, 3];\n * const arr2 = [4, 5, 6];\n * const result = zipWith(arr1, arr2, (a, b) => a + b);\n * // result will be [5, 7, 9]\n *\n * @example\n * // Example usage with three arrays:\n * const arr1 = [1, 2];\n * const arr2 = [3, 4];\n * const arr3 = [5, 6];\n * const result = zipWith(arr1, arr2, arr3, (a, b, c) => `${a}${b}${c}`);\n * // result will be [`135`, `246`]\n */\nexport function zipWith<T, R>(arr1: readonly T[], combine: (item: T) => R): R[];\nexport function zipWith<T, U, R>(arr1: readonly T[], arr2: readonly U[], combine: (item1: T, item2: U) => R): R[];\nexport function zipWith<T, U, V, R>(\n  arr1: readonly T[],\n  arr2: readonly U[],\n  arr3: readonly V[],\n  combine: (item1: T, item2: U, item3: V) => R\n): R[];\nexport function zipWith<T, U, V, W, R>(\n  arr1: readonly T[],\n  arr2: readonly U[],\n  arr3: readonly V[],\n  arr4: readonly W[],\n  combine: (item1: T, item2: U, item3: V, item4: W) => R\n): R[];\nexport function zipWith<T, R>(arr1: readonly T[], ...rest: any[]): R[] {\n  const arrs = [arr1, ...rest.slice(0, -1)];\n  const combine = rest[rest.length - 1] as (...items: T[]) => R;\n\n  const result: R[] = [];\n  const maxIndex = Math.max(...arrs.map(arr => arr.length));\n\n  for (let i = 0; i < maxIndex; i++) {\n    const elements: T[] = arrs.map(arr => arr[i]);\n    result.push(combine(...elements));\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA2CO,SAAS,QAAc,SAAuB,MAAkB;AACrE,QAAM,OAAO,CAAC,MAAM,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;AACxC,QAAM,UAAU,KAAK,KAAK,SAAS,CAAC;AAEpC,QAAM,SAAc,CAAC;AACrB,QAAM,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,SAAO,IAAI,MAAM,CAAC;AAExD,WAAS,IAAI,GAAG,IAAI,UAAU,KAAK;AACjC,UAAM,WAAgB,KAAK,IAAI,SAAO,IAAI,CAAC,CAAC;AAC5C,WAAO,KAAK,QAAQ,GAAG,QAAQ,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/zipWith.ts"],"sourcesContent":["/**\n * Combines multiple arrays into a single array using a custom combiner function.\n *\n * This function takes multiple arrays and a combiner function, and returns a new array where each element\n * is the result of applying the combiner function to the corresponding elements of the input arrays.\n *\n * @template T - The type of elements in the first array.\n * @template U - The type of elements in the second array (optional).\n * @template V - The type of elements in the third array (optional).\n * @template W - The type of elements in the fourth array (optional).\n * @template R - The type of elements in the resulting array.\n * @param {T[]} arr1 - The first array to zip.\n * @param {U[]} [arr2] - The second array to zip (optional).\n * @param {V[]} [arr3] - The third array to zip (optional).\n * @param {W[]} [arr4] - The fourth array to zip (optional).\n * @param {(...items: T[]) => R} combine - The combiner function that takes corresponding elements from each array and returns a single value.\n * @returns {R[]} A new array where each element is the result of applying the combiner function to the corresponding elements of the input arrays.\n *\n * @example\n * // Example usage with two arrays:\n * const arr1 = [1, 2, 3];\n * const arr2 = [4, 5, 6];\n * const result = zipWith(arr1, arr2, (a, b) => a + b);\n * // result will be [5, 7, 9]\n *\n * @example\n * // Example usage with three arrays:\n * const arr1 = [1, 2];\n * const arr2 = [3, 4];\n * const arr3 = [5, 6];\n * const result = zipWith(arr1, arr2, arr3, (a, b, c) => `${a}${b}${c}`);\n * // result will be [`135`, `246`]\n */\nexport function zipWith<T, R>(arr1: readonly T[], combine: (item: T) => R): R[];\nexport function zipWith<T, U, R>(arr1: readonly T[], arr2: readonly U[], combine: (item1: T, item2: U) => R): R[];\nexport function zipWith<T, U, V, R>(\n  arr1: readonly T[],\n  arr2: readonly U[],\n  arr3: readonly V[],\n  combine: (item1: T, item2: U, item3: V) => R\n): R[];\nexport function zipWith<T, U, V, W, R>(\n  arr1: readonly T[],\n  arr2: readonly U[],\n  arr3: readonly V[],\n  arr4: readonly W[],\n  combine: (item1: T, item2: U, item3: V, item4: W) => R\n): R[];\nexport function zipWith<T, R>(arr1: readonly T[], ...rest: any[]): R[] {\n  const arrs = [arr1, ...rest.slice(0, -1)];\n  const combine = rest[rest.length - 1] as (...items: T[]) => R;\n\n  const result: R[] = [];\n  const maxIndex = Math.max(...arrs.map(arr => arr.length));\n\n  for (let i = 0; i < maxIndex; i++) {\n    const elements: T[] = arrs.map(arr => arr[i]);\n    result.push(combine(...elements));\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAgDO,SAAS,QAAc,SAAuB,MAAkB;AACrE,QAAM,OAAO,CAAC,MAAM,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;AACxC,QAAM,UAAU,KAAK,KAAK,SAAS,CAAC;AAEpC,QAAM,SAAc,CAAC;AACrB,QAAM,WAAW,KAAK,IAAI,GAAG,KAAK,IAAI,SAAO,IAAI,MAAM,CAAC;AAExD,WAAS,IAAI,GAAG,IAAI,UAAU,KAAK;AACjC,UAAM,WAAgB,KAAK,IAAI,SAAO,IAAI,CAAC,CAAC;AAC5C,WAAO,KAAK,QAAQ,GAAG,QAAQ,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;","names":[]}

package/dist/array/zipWith.mjs

@@ -1,6 +1,6 @@
 import {
   zipWith
-} from "../chunk-4KYXHZ4R.mjs";
+} from "../chunk-MJ7LNBI6.mjs";
 import "../chunk-J5LGTIGS.mjs";
 export {
   zipWith