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

package/dist/array/chunk.mjs

@@ -1,7 +1,7 @@
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   chunk
 };

package/dist/array/compact.d.mts

@@ -3,7 +3,7 @@ type NotFalsey<T> = Exclude<T, false | null | 0 | '' | undefined>;
  * Removes falsey values (false, null, 0, '', undefined, NaN) from an array.
  *
  * @template T - The type of elements in the array.
- * @param {readonly T[]} arr - The input array to remove falsey values.
+ * @param {T[]} arr - The input array to remove falsey values.
  * @returns {Array<Exclude<T, false | null | 0 | '' | undefined>>} - A new array with all falsey values removed.
  *
  * @example

package/dist/array/compact.d.ts

@@ -3,7 +3,7 @@ type NotFalsey<T> = Exclude<T, false | null | 0 | '' | undefined>;
  * Removes falsey values (false, null, 0, '', undefined, NaN) from an array.
  *
  * @template T - The type of elements in the array.
- * @param {readonly T[]} arr - The input array to remove falsey values.
+ * @param {T[]} arr - The input array to remove falsey values.
  * @returns {Array<Exclude<T, false | null | 0 | '' | undefined>>} - A new array with all falsey values removed.
  *
  * @example

package/dist/array/compact.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/compact.ts"],"sourcesContent":["type NotFalsey<T> = Exclude<T, false | null | 0 | '' | undefined>;\n\n/**\n * Removes falsey values (false, null, 0, '', undefined, NaN) from an array.\n *\n * @template T - The type of elements in the array.\n * @param {readonly T[]} arr - The input array to remove falsey values.\n * @returns {Array<Exclude<T, false | null | 0 | '' | undefined>>} - A new array with all falsey values removed.\n *\n * @example\n * compact([0, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);\n * Returns: [1, 2, 3, 4, 5]\n */\nexport function compact<T>(arr: readonly T[]): Array<NotFalsey<T>> {\n  const result: Array<NotFalsey<T>> = [];\n\n  for (const item of arr) {\n    if (item) {\n      result.push(item as NotFalsey<T>);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,QAAW,KAAwC;AACjE,QAAM,SAA8B,CAAC;AAErC,aAAW,QAAQ,KAAK;AACtB,QAAI,MAAM;AACR,aAAO,KAAK,IAAoB;AAAA,IAClC;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/compact.ts"],"sourcesContent":["type NotFalsey<T> = Exclude<T, false | null | 0 | '' | undefined>;\n\n/**\n * Removes falsey values (false, null, 0, '', undefined, NaN) from an array.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} arr - The input array to remove falsey values.\n * @returns {Array<Exclude<T, false | null | 0 | '' | undefined>>} - A new array with all falsey values removed.\n *\n * @example\n * compact([0, 1, false, 2, '', 3, null, undefined, 4, NaN, 5]);\n * Returns: [1, 2, 3, 4, 5]\n */\nexport function compact<T>(arr: readonly T[]): Array<NotFalsey<T>> {\n  const result: Array<NotFalsey<T>> = [];\n\n  for (const item of arr) {\n    if (item) {\n      result.push(item as NotFalsey<T>);\n    }\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,QAAW,KAAwC;AACjE,QAAM,SAA8B,CAAC;AAErC,aAAW,QAAQ,KAAK;AACtB,QAAI,MAAM;AACR,aAAO,KAAK,IAAoB;AAAA,IAClC;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}

package/dist/array/compact.mjs

@@ -1,7 +1,7 @@
 import {
   compact
-} from "../chunk-DTJJIMKJ.mjs";
-import "../chunk-24FKGR6U.mjs";
+} from "../chunk-PJPGJ2O6.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   compact
 };

package/dist/array/countBy.js

@@ -24,11 +24,10 @@ __export(countBy_exports, {
 });
 module.exports = __toCommonJS(countBy_exports);
 function countBy(arr, mapper) {
-  var _a;
   const result = {};
   for (const item of arr) {
     const key = mapper(item);
-    result[key] = ((_a = result[key]) != null ? _a : 0) + 1;
+    result[key] = (result[key] ?? 0) + 1;
   }
   return result;
 }

package/dist/array/countBy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/countBy.ts"],"sourcesContent":["/**\n * Count the occurrences of each item in an array\n * based on a transformation function.\n *\n * This function takes an array and a transformation function\n * that converts each item in the array to a string. It then\n * counts the occurrences of each transformed item and returns\n * an object with the transformed items as keys and the counts\n * as values.\n *\n * @template T - The type of the items in the input array.\n *\n * @param {T[]} arr - The input array to count occurrences.\n * @param {(item: T) => string} mapper - The transformation function that maps each item to a string key.\n * @returns {Record<string, number>} An object containing the transformed items as keys and the\n * counts as values.\n */\nexport function countBy<T>(arr: T[], mapper: (item: T) => string): Record<string, number> {\n  const result: Record<string, number> = {};\n  \n  for (const item of arr) {\n    const key = mapper(item);\n    \n    result[key] = (result[key] ?? 0) + 1;\n  }\n  \n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBO,SAAS,QAAW,KAAU,QAAqD;AAjB1F;AAkBE,QAAM,SAAiC,CAAC;AAExC,aAAW,QAAQ,KAAK;AACtB,UAAM,MAAM,OAAO,IAAI;AAEvB,WAAO,GAAG,MAAK,YAAO,GAAG,MAAV,YAAe,KAAK;AAAA,EACrC;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/countBy.ts"],"sourcesContent":["/**\n * Count the occurrences of each item in an array\n * based on a transformation function.\n *\n * This function takes an array and a transformation function\n * that converts each item in the array to a string. It then\n * counts the occurrences of each transformed item and returns\n * an object with the transformed items as keys and the counts\n * as values.\n *\n * @template T - The type of the items in the input array.\n *\n * @param {T[]} arr - The input array to count occurrences.\n * @param {(item: T) => string} mapper - The transformation function that maps each item to a string key.\n * @returns {Record<string, number>} An object containing the transformed items as keys and the\n * counts as values.\n */\nexport function countBy<T>(arr: T[], mapper: (item: T) => string): Record<string, number> {\n  const result: Record<string, number> = {};\n  \n  for (const item of arr) {\n    const key = mapper(item);\n    \n    result[key] = (result[key] ?? 0) + 1;\n  }\n  \n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBO,SAAS,QAAW,KAAU,QAAqD;AACxF,QAAM,SAAiC,CAAC;AAExC,aAAW,QAAQ,KAAK;AACtB,UAAM,MAAM,OAAO,IAAI;AAEvB,WAAO,GAAG,KAAK,OAAO,GAAG,KAAK,KAAK;AAAA,EACrC;AAEA,SAAO;AACT;","names":[]}

package/dist/array/countBy.mjs

@@ -1,7 +1,7 @@
 import {
   countBy
-} from "../chunk-CRSKT4WW.mjs";
-import "../chunk-24FKGR6U.mjs";
+} from "../chunk-Z7HWEOQX.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   countBy
 };

package/dist/array/difference.mjs

@@ -1,7 +1,7 @@
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   difference
 };

package/dist/array/differenceBy.mjs

@@ -1,7 +1,7 @@
 import {
   differenceBy
 } from "../chunk-LVWX5B43.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   differenceBy
 };

package/dist/array/differenceWith.mjs

@@ -1,7 +1,7 @@
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   differenceWith
 };

package/dist/array/drop.mjs

@@ -1,7 +1,7 @@
 import {
   drop
 } from "../chunk-3EZAFZG3.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   drop
 };

package/dist/array/dropRight.mjs

@@ -1,7 +1,7 @@
 import {
   dropRight
 } from "../chunk-OXZCMC5I.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   dropRight
 };

package/dist/array/dropRightWhile.mjs

@@ -1,7 +1,7 @@
 import {
   dropRightWhile
 } from "../chunk-M7SBBYV2.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   dropRightWhile
 };

package/dist/array/dropWhile.mjs

@@ -1,7 +1,7 @@
 import {
   dropWhile
 } from "../chunk-LJ2C6MVP.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   dropWhile
 };

package/dist/array/fill.d.mts

@@ -5,6 +5,7 @@
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
+ * @template T, U
  * @param {Array<T | U>} array - The array to fill.
  * @param {U} value - The value to fill the array with.
  * @param {number} [start=0] - The start position. Defaults to 0.

package/dist/array/fill.d.ts

@@ -5,6 +5,7 @@
  * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the
  * entire array.
  *
+ * @template T, U
  * @param {Array<T | U>} array - The array to fill.
  * @param {U} value - The value to fill the array with.
  * @param {number} [start=0] - The start position. Defaults to 0.

package/dist/array/fill.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/array/fill.ts"],"sourcesContent":["/**\n * Fills elements of an array with a specified value from the start position up to, but not including, the end position.\n *\n * This function mutates the original array and replaces its elements with the provided value, starting from the specified\n * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the\n * entire array.\n *\n * @param {Array<T | U>} array - The array to fill.\n * @param {U} value - The value to fill the 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 array with the filled values.\n *\n * @example\n * const array = [1, 2, 3];\n * const result = fill(array, 'a');\n * // => ['a', 'a', 'a']\n *\n * const result = fill(Array(3), 2);\n * // => [2, 2, 2]\n *\n * const result = fill([4, 6, 8, 10], '*', 1, 3);\n * // => [4, '*', '*', 10]\n *\n * const result = fill(array, '*', -2, -1);\n * // => [1, '*', 3]\n */\nexport function fill<T>(array: unknown[], value: T): T[];\nexport function fill<T, U>(array: Array<T | U>, value: U, start: number): Array<T | U>;\nexport function fill<T, U>(array: Array<T | U>, value: U, start: number, end: number): Array<T | U>;\nexport function fill<T, U>(array: Array<T | U>, value: U, start = 0, end = array.length): Array<T | U> {\n  const length = array.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  for (let i = finalStart; i < finalEnd; i++) {\n    array[i] = value;\n  }\n\n  return array;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BO,SAAS,KAAW,OAAqB,OAAU,QAAQ,GAAG,MAAM,MAAM,QAAsB;AACrG,QAAM,SAAS,MAAM;AACrB,QAAM,aAAa,KAAK,IAAI,SAAS,IAAI,QAAQ,SAAS,OAAO,CAAC;AAClE,QAAM,WAAW,KAAK,IAAI,OAAO,IAAI,MAAM,SAAS,KAAK,MAAM;AAE/D,WAAS,IAAI,YAAY,IAAI,UAAU,KAAK;AAC1C,UAAM,CAAC,IAAI;AAAA,EACb;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/array/fill.ts"],"sourcesContent":["/**\n * Fills elements of an array with a specified value from the start position up to, but not including, the end position.\n *\n * This function mutates the original array and replaces its elements with the provided value, starting from the specified\n * start index up to the end index (non-inclusive). If the start or end indices are not provided, it defaults to filling the\n * entire array.\n *\n * @template T, U\n * @param {Array<T | U>} array - The array to fill.\n * @param {U} value - The value to fill the 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 array with the filled values.\n *\n * @example\n * const array = [1, 2, 3];\n * const result = fill(array, 'a');\n * // => ['a', 'a', 'a']\n *\n * const result = fill(Array(3), 2);\n * // => [2, 2, 2]\n *\n * const result = fill([4, 6, 8, 10], '*', 1, 3);\n * // => [4, '*', '*', 10]\n *\n * const result = fill(array, '*', -2, -1);\n * // => [1, '*', 3]\n */\nexport function fill<T>(array: unknown[], value: T): T[];\nexport function fill<T, U>(array: Array<T | U>, value: U, start: number): Array<T | U>;\nexport function fill<T, U>(array: Array<T | U>, value: U, start: number, end: number): Array<T | U>;\nexport function fill<T, U>(array: Array<T | U>, value: U, start = 0, end = array.length): Array<T | U> {\n  const length = array.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  for (let i = finalStart; i < finalEnd; i++) {\n    array[i] = value;\n  }\n\n  return array;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA+BO,SAAS,KAAW,OAAqB,OAAU,QAAQ,GAAG,MAAM,MAAM,QAAsB;AACrG,QAAM,SAAS,MAAM;AACrB,QAAM,aAAa,KAAK,IAAI,SAAS,IAAI,QAAQ,SAAS,OAAO,CAAC;AAClE,QAAM,WAAW,KAAK,IAAI,OAAO,IAAI,MAAM,SAAS,KAAK,MAAM;AAE/D,WAAS,IAAI,YAAY,IAAI,UAAU,KAAK;AAC1C,UAAM,CAAC,IAAI;AAAA,EACb;AAEA,SAAO;AACT;","names":[]}

package/dist/array/fill.mjs

@@ -1,7 +1,7 @@
 import {
   fill
-} from "../chunk-YFN6KOC4.mjs";
-import "../chunk-24FKGR6U.mjs";
+} from "../chunk-GTFDDKZ2.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   fill
 };

package/dist/array/flatMap.mjs

@@ -2,7 +2,7 @@ import {
   flatMap
 } from "../chunk-UY76KTPE.mjs";
 import "../chunk-33MSBDC6.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   flatMap
 };

package/dist/array/flatten.mjs

@@ -1,7 +1,7 @@
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   flatten
 };

package/dist/array/flattenDeep.mjs

@@ -2,7 +2,7 @@ import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
 import "../chunk-33MSBDC6.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   flattenDeep
 };

package/dist/array/forEachRight.mjs

@@ -1,7 +1,7 @@
 import {
   forEachRight
 } from "../chunk-IEA53J7P.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   forEachRight
 };

package/dist/array/groupBy.mjs

@@ -1,7 +1,7 @@
 import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
-import "../chunk-24FKGR6U.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   groupBy
 };

package/dist/array/head.d.mts

@@ -4,6 +4,7 @@
  * This function takes an array and returns the first element of the array.
  * If the array is empty, the function returns `undefined`.
  *
+ * @template T - The type of elements in the array.
  * @param {T[]} arr - The array from which to get the first element.
  * @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
  *

package/dist/array/head.d.ts

@@ -4,6 +4,7 @@
  * This function takes an array and returns the first element of the array.
  * If the array is empty, the function returns `undefined`.
  *
+ * @template T - The type of elements in the array.
  * @param {T[]} arr - The array from which to get the first element.
  * @returns {T | undefined} The first element of the array, or `undefined` if the array is empty.
  *

package/dist/array/head.js.map

@@ -1 +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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoBO,SAAS,KAAQ,KAAkC;AACxD,SAAO,IAAI,CAAC;AACd;","names":[]}
+{"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 * @template T - The type of elements in the array.\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":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAqBO,SAAS,KAAQ,KAAkC;AACxD,SAAO,IAAI,CAAC;AACd;","names":[]}

package/dist/array/head.mjs

@@ -1,7 +1,7 @@
 import {
   head
-} from "../chunk-HM2JT2RX.mjs";
-import "../chunk-24FKGR6U.mjs";
+} from "../chunk-FZZNWXDM.mjs";
+import "../chunk-J5LGTIGS.mjs";
 export {
   head
 };

package/dist/array/index.js

@@ -102,11 +102,10 @@ function compact(arr) {
 
 // src/array/countBy.ts
 function countBy(arr, mapper) {
-  var _a;
   const result = {};
   for (const item of arr) {
     const key = mapper(item);
-    result[key] = ((_a = result[key]) != null ? _a : 0) + 1;
+    result[key] = (result[key] ?? 0) + 1;
   }
   return result;
 }