es-toolkit 1.10.1-dev.218 → 1.10.1-dev.220

package/dist/compat/index.mjs

@@ -1,5 +1,11 @@
 import "../chunk-NKLIE2OI.mjs";
 import "../chunk-QKYYOLJ6.mjs";
+import {
+  camelCase
+} from "../chunk-Y5V7UAZZ.mjs";
+import {
+  capitalize
+} from "../chunk-U56ZOM7L.mjs";
 import {
   kebabCase
 } from "../chunk-EYYZQFOP.mjs";
@@ -9,17 +15,27 @@ import {
 import {
   snakeCase
 } from "../chunk-F3WCQQET.mjs";
+import "../chunk-WVQ7YVRK.mjs";
+import "../chunk-ASJF5D6C.mjs";
+import {
+  isEqual
+} from "../chunk-JYSV56US.mjs";
+import {
+  isNil
+} from "../chunk-WMM7TZLG.mjs";
+import {
+  isNotNil
+} from "../chunk-BMRTZMRE.mjs";
+import {
+  isNull
+} from "../chunk-AIRSKN47.mjs";
+import {
+  isUndefined
+} from "../chunk-VH2PV426.mjs";
 import "../chunk-ARZ5BDR6.mjs";
 import {
   delay
 } from "../chunk-O64NE2P4.mjs";
-import {
-  camelCase
-} from "../chunk-Y5V7UAZZ.mjs";
-import {
-  capitalize
-} from "../chunk-U56ZOM7L.mjs";
-import "../chunk-WVQ7YVRK.mjs";
 import "../chunk-OSOLEQLZ.mjs";
 import {
   clone
@@ -39,36 +55,10 @@ import {
 import {
   pickBy
 } from "../chunk-6CLH5YZ2.mjs";
-import "../chunk-ASJF5D6C.mjs";
-import {
-  isEqual
-} from "../chunk-JYSV56US.mjs";
-import {
-  isNil
-} from "../chunk-WMM7TZLG.mjs";
-import {
-  isNotNil
-} from "../chunk-BMRTZMRE.mjs";
-import {
-  isNull
-} from "../chunk-AIRSKN47.mjs";
-import {
-  isUndefined
-} from "../chunk-VH2PV426.mjs";
-import "../chunk-236H5JZJ.mjs";
-import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
-import {
-  once
-} from "../chunk-CMBC4MXG.mjs";
-import {
-  throttle
-} from "../chunk-QOJGMVVR.mjs";
 import "../chunk-FUS75PJ7.mjs";
+import {
+  sumBy
+} from "../chunk-5L4VWRFX.mjs";
 import {
   meanBy
 } from "../chunk-IZAD2S7R.mjs";
@@ -81,9 +71,6 @@ import {
 import {
   round
 } from "../chunk-5PMKOZ2F.mjs";
-import {
-  sumBy
-} from "../chunk-5L4VWRFX.mjs";
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
@@ -93,14 +80,10 @@ import {
 import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
-import "../chunk-FZEZH22H.mjs";
+import "../chunk-DDH7K4QM.mjs";
 import {
-  AbortError
-} from "../chunk-DXB7EZUQ.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
-import "../chunk-2MRZANXZ.mjs";
+  xor
+} from "../chunk-L7FQX5MN.mjs";
 import {
   xorBy
 } from "../chunk-Q47NGNXT.mjs";
@@ -116,6 +99,9 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
+import {
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
@@ -135,8 +121,8 @@ import {
   without
 } from "../chunk-PYEYV7BY.mjs";
 import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
+  shuffle
+} from "../chunk-G7UQ5PUR.mjs";
 import {
   tail
 } from "../chunk-OF6NM4G7.mjs";
@@ -162,8 +148,8 @@ import {
   uniq
 } from "../chunk-DVK2N4KC.mjs";
 import {
-  unionBy
-} from "../chunk-NFS7RWWE.mjs";
+  keyBy
+} from "../chunk-AJKZMN2V.mjs";
 import {
   last
 } from "../chunk-KPBQ7OUY.mjs";
@@ -192,8 +178,8 @@ import {
   random
 } from "../chunk-SYWMYQYJ.mjs";
 import {
-  shuffle
-} from "../chunk-G7UQ5PUR.mjs";
+  forEachRight
+} from "../chunk-IEA53J7P.mjs";
 import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
@@ -212,9 +198,6 @@ import {
 import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
-import {
-  keyBy
-} from "../chunk-AJKZMN2V.mjs";
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
@@ -230,15 +213,15 @@ import {
 import {
   fill
 } from "../chunk-6KP7CLVJ.mjs";
+import {
+  flatMap
+} from "../chunk-KBXHURLW.mjs";
 import {
   flattenDeep
 } from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import {
-  forEachRight
-} from "../chunk-IEA53J7P.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -257,6 +240,26 @@ import {
 import {
   differenceWith
 } from "../chunk-6NVQAHXP.mjs";
+import "../chunk-FZEZH22H.mjs";
+import {
+  AbortError
+} from "../chunk-DXB7EZUQ.mjs";
+import "../chunk-236H5JZJ.mjs";
+import {
+  once
+} from "../chunk-CMBC4MXG.mjs";
+import {
+  throttle
+} from "../chunk-QOJGMVVR.mjs";
+import {
+  debounce
+} from "../chunk-3IP4JVLL.mjs";
+import {
+  negate
+} from "../chunk-BOOQBJN2.mjs";
+import {
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import "../chunk-2MM5EJJX.mjs";
 
 // src/compat/array/chunk.ts
@@ -286,6 +289,7 @@ export {
   dropRightWhile,
   dropWhile,
   fill,
+  flatMap,
   flatten,
   flattenDeep,
   forEachRight,

package/dist/compat/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/compat/array/chunk.ts"],"sourcesContent":["import { chunk as chunkToolkit } from '../../array/chunk.ts';\n\n/**\n * Splits an array into smaller arrays of a specified length.\n *\n * This function takes an input array and divides it into multiple smaller arrays,\n * each of a specified length. If the input array cannot be evenly divided,\n * the final sub-array will contain the remaining elements.\n *\n * @template T The type of elements in the array.\n * @param {T[]} arr - The array to be chunked into smaller arrays.\n * @param {number} size - The size of each smaller array. Must be a positive integer.\n * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.\n * @throws {Error} Throws an error if `size` is not a positive integer.\n *\n * @example\n * // Splits an array of numbers into sub-arrays of length 2\n * chunk([1, 2, 3, 4, 5], 2);\n * // Returns: [[1, 2], [3, 4], [5]]\n *\n * @example\n * // Splits an array of strings into sub-arrays of length 3\n * chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3);\n * // Returns: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]\n */\nexport function chunk<T>(arr: readonly T[], size: number = 1): T[][] {\n  size = Math.max(Math.floor(size), 0);\n\n  if (size === 0) {\n    return [];\n  }\n\n  return chunkToolkit(arr, size);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAASA,OAAS,KAAmB,OAAe,GAAU;AACnE,SAAO,KAAK,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC;AAEnC,MAAI,SAAS,GAAG;AACd,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,MAAa,KAAK,IAAI;AAC/B;","names":["chunk"]}
+{"version":3,"sources":["../../src/compat/array/chunk.ts"],"sourcesContent":["import { chunk as chunkToolkit } from '../../array/chunk.ts';\n\n/**\n * Splits an array into smaller arrays of a specified length.\n *\n * This function takes an input array and divides it into multiple smaller arrays,\n * each of a specified length. If the input array cannot be evenly divided,\n * the final sub-array will contain the remaining elements.\n *\n * @template T The type of elements in the array.\n * @param {T[]} arr - The array to be chunked into smaller arrays.\n * @param {number} size - The size of each smaller array. Must be a positive integer.\n * @returns {T[][]} A two-dimensional array where each sub-array has a maximum length of `size`.\n * @throws {Error} Throws an error if `size` is not a positive integer.\n *\n * @example\n * // Splits an array of numbers into sub-arrays of length 2\n * chunk([1, 2, 3, 4, 5], 2);\n * // Returns: [[1, 2], [3, 4], [5]]\n *\n * @example\n * // Splits an array of strings into sub-arrays of length 3\n * chunk(['a', 'b', 'c', 'd', 'e', 'f', 'g'], 3);\n * // Returns: [['a', 'b', 'c'], ['d', 'e', 'f'], ['g']]\n */\nexport function chunk<T>(arr: readonly T[], size: number = 1): T[][] {\n  size = Math.max(Math.floor(size), 0);\n\n  if (size === 0) {\n    return [];\n  }\n\n  return chunkToolkit(arr, size);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBO,SAASA,OAAS,KAAmB,OAAe,GAAU;AACnE,SAAO,KAAK,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC;AAEnC,MAAI,SAAS,GAAG;AACd,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,MAAa,KAAK,IAAI;AAC/B;","names":["chunk"]}

package/dist/function/index.mjs

@@ -1,10 +1,4 @@
 import "../chunk-236H5JZJ.mjs";
-import {
-  negate
-} from "../chunk-BOOQBJN2.mjs";
-import {
-  noop
-} from "../chunk-LKXCOLNY.mjs";
 import {
   once
 } from "../chunk-CMBC4MXG.mjs";
@@ -14,6 +8,12 @@ import {
 import {
   debounce
 } from "../chunk-3IP4JVLL.mjs";
+import {
+  negate
+} from "../chunk-BOOQBJN2.mjs";
+import {
+  noop
+} from "../chunk-LKXCOLNY.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   debounce,

package/dist/index.d.mts

@@ -9,6 +9,7 @@ export { dropRight } from './array/dropRight.mjs';
 export { dropRightWhile } from './array/dropRightWhile.mjs';
 export { dropWhile } from './array/dropWhile.mjs';
 export { fill } from './array/fill.mjs';
+export { flatMap } from './array/flatMap.mjs';
 export { flatten } from './array/flatten.mjs';
 export { flattenDeep } from './array/flattenDeep.mjs';
 export { forEachRight } from './array/forEachRight.mjs';

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export { dropRight } from './array/dropRight.js';
 export { dropRightWhile } from './array/dropRightWhile.js';
 export { dropWhile } from './array/dropWhile.js';
 export { fill } from './array/fill.js';
+export { flatMap } from './array/flatMap.js';
 export { flatten } from './array/flatten.js';
 export { flattenDeep } from './array/flattenDeep.js';
 export { forEachRight } from './array/forEachRight.js';

package/dist/index.js

@@ -52,6 +52,7 @@ __export(src_exports, {
   dropRightWhile: () => dropRightWhile,
   dropWhile: () => dropWhile,
   fill: () => fill,
+  flatMap: () => flatMap,
   flatten: () => flatten,
   flattenDeep: () => flattenDeep,
   forEachRight: () => forEachRight,
@@ -233,6 +234,11 @@ function flatten(arr, depth = 1) {
   return result;
 }
 
+// src/array/flatMap.ts
+function flatMap(arr, iteratee, depth = 1) {
+  return flatten(arr.map((item) => iteratee(item)), depth);
+}
+
 // src/array/flattenDeep.ts
 function flattenDeep(arr) {
   return flatten(arr, Infinity);
@@ -999,6 +1005,7 @@ var lowerCase = (str) => {
   dropRightWhile,
   dropWhile,
   fill,
+  flatMap,
   flatten,
   flattenDeep,
   forEachRight,