es-toolkit 1.10.1-dev.219 → 1.10.1-dev.221

package/dist/array/index.mjs

@@ -1,4 +1,7 @@
-import "../chunk-2MRZANXZ.mjs";
+import "../chunk-DDH7K4QM.mjs";
+import {
+  xor
+} from "../chunk-L7FQX5MN.mjs";
 import {
   xorBy
 } from "../chunk-Q47NGNXT.mjs";
@@ -14,6 +17,9 @@ import {
 import {
   zipWith
 } from "../chunk-4KYXHZ4R.mjs";
+import {
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
 import {
   unionWith
 } from "../chunk-2ZCITDMK.mjs";
@@ -33,8 +39,8 @@ import {
   without
 } from "../chunk-PYEYV7BY.mjs";
 import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
+  shuffle
+} from "../chunk-G7UQ5PUR.mjs";
 import {
   tail
 } from "../chunk-OF6NM4G7.mjs";
@@ -60,8 +66,8 @@ import {
   uniq
 } from "../chunk-DVK2N4KC.mjs";
 import {
-  unionBy
-} from "../chunk-NFS7RWWE.mjs";
+  keyBy
+} from "../chunk-AJKZMN2V.mjs";
 import {
   last
 } from "../chunk-KPBQ7OUY.mjs";
@@ -86,8 +92,8 @@ import {
 import "../chunk-GIWAOOFY.mjs";
 import "../chunk-SYWMYQYJ.mjs";
 import {
-  shuffle
-} from "../chunk-G7UQ5PUR.mjs";
+  forEachRight
+} from "../chunk-IEA53J7P.mjs";
 import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
@@ -106,9 +112,6 @@ import {
 import {
   intersectionWith
 } from "../chunk-XI7KRD2C.mjs";
-import {
-  keyBy
-} from "../chunk-AJKZMN2V.mjs";
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
@@ -124,15 +127,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";
@@ -164,6 +167,7 @@ export {
   dropRightWhile,
   dropWhile,
   fill,
+  flatMap,
   flatten,
   flattenDeep,
   forEachRight,

package/dist/chunk-DDH7K4QM.mjs

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

package/dist/chunk-DDH7K4QM.mjs.map

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

package/dist/chunk-KBXHURLW.mjs

@@ -0,0 +1,13 @@
+import {
+  flatten
+} from "./chunk-33MSBDC6.mjs";
+
+// src/array/flatMap.ts
+function flatMap(arr, iteratee, depth = 1) {
+  return flatten(arr.map((item) => iteratee(item)), depth);
+}
+
+export {
+  flatMap
+};
+//# sourceMappingURL=chunk-KBXHURLW.mjs.map

package/dist/chunk-KBXHURLW.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/array/flatMap.ts"],"sourcesContent":["import { flatten } from './flatten';\n\n/**\n * Maps each element in the array using the iteratee function and flattens the result up to the specified depth.\n *\n * @template T - The type of elements within the array.\n * @template U - The type of elements within the returned array from the iteratee function.\n * @template D - The depth to which the array should be flattened.\n * @param {T[]} arr - The array to flatten.\n * @param {(item: T) => U} iteratee - The function that produces the new array elements.\n * @param {D} depth - The depth level specifying how deep a nested array structure should be flattened. Defaults to 1.\n * @returns {Array<FlatArray<U[], D>>} The new array with the mapped and flattened elements.\n *\n * @example\n * const arr = [1, 2, 3];\n *\n * flatMap(arr, (item: number) => [item, item]);\n * // [1, 1, 2, 2, 3, 3]\n *\n * flatMap(arr, (item: number) => [[item, item]], 2);\n * // [1, 1, 2, 2, 3, 3]\n */\nexport function flatMap<T, U, D extends number>(\n  arr: readonly T[],\n  iteratee: (item: T) => U,\n  depth = 1 as D\n): Array<FlatArray<U[], D>> {\n  return flatten(arr.map(item => iteratee(item)), depth);\n}\n"],"mappings":";;;;;AAsBO,SAAS,QACd,KACA,UACA,QAAQ,GACkB;AAC1B,SAAO,QAAQ,IAAI,IAAI,UAAQ,SAAS,IAAI,CAAC,GAAG,KAAK;AACvD;","names":[]}

package/dist/compat/index.d.mts

@@ -8,6 +8,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/compat/index.d.ts

@@ -8,6 +8,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/compat/index.js

@@ -52,6 +52,7 @@ __export(compat_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);
@@ -1008,6 +1014,7 @@ function chunk2(arr, size = 1) {
   dropRightWhile,
   dropWhile,
   fill,
+  flatMap,
   flatten,
   flattenDeep,
   forEachRight,