es-toolkit 1.10.0-dev.204 → 1.10.0-dev.206

package/dist/compat/index.mjs

@@ -1,5 +1,8 @@
 import "../chunk-NKLIE2OI.mjs";
 import "../chunk-QKYYOLJ6.mjs";
+import {
+  capitalize
+} from "../chunk-U56ZOM7L.mjs";
 import {
   kebabCase
 } from "../chunk-EYYZQFOP.mjs";
@@ -17,10 +20,10 @@ import {
   camelCase
 } from "../chunk-XGCYC4YA.mjs";
 import "../chunk-WVQ7YVRK.mjs";
-import {
-  capitalize
-} from "../chunk-U56ZOM7L.mjs";
 import "../chunk-OSOLEQLZ.mjs";
+import {
+  clone
+} from "../chunk-U4JGKZ56.mjs";
 import {
   invert
 } from "../chunk-74WWMNZS.mjs";
@@ -37,6 +40,9 @@ import {
   pickBy
 } from "../chunk-6CLH5YZ2.mjs";
 import "../chunk-ASJF5D6C.mjs";
+import {
+  isEqual
+} from "../chunk-JYSV56US.mjs";
 import {
   isNil
 } from "../chunk-WMM7TZLG.mjs";
@@ -49,26 +55,7 @@ import {
 import {
   isUndefined
 } from "../chunk-VH2PV426.mjs";
-import {
-  isEqual
-} from "../chunk-JYSV56US.mjs";
-import {
-  clone
-} from "../chunk-U4JGKZ56.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-TLVQSNOE.mjs";
+import "../chunk-FUS75PJ7.mjs";
 import {
   meanBy
 } from "../chunk-IZAD2S7R.mjs";
@@ -81,6 +68,9 @@ import {
 import {
   round
 } from "../chunk-5PMKOZ2F.mjs";
+import {
+  sumBy
+} from "../chunk-5L4VWRFX.mjs";
 import {
   sum
 } from "../chunk-2SLTL4KL.mjs";
@@ -90,16 +80,7 @@ import {
 import {
   inRange
 } from "../chunk-BH6HLGBA.mjs";
-import {
-  debounce
-} from "../chunk-3IP4JVLL.mjs";
 import "../chunk-2MRZANXZ.mjs";
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
-import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
 import {
   xorBy
 } from "../chunk-Q47NGNXT.mjs";
@@ -115,18 +96,9 @@ 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";
@@ -140,17 +112,11 @@ import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import {
-  randomInt
-} from "../chunk-GIWAOOFY.mjs";
-import {
-  random
-} from "../chunk-SYWMYQYJ.mjs";
+  without
+} from "../chunk-PYEYV7BY.mjs";
 import {
-  shuffle
-} from "../chunk-G7UQ5PUR.mjs";
+  xor
+} from "../chunk-L7FQX5MN.mjs";
 import {
   tail
 } from "../chunk-OF6NM4G7.mjs";
@@ -170,11 +136,14 @@ import {
   toFilled
 } from "../chunk-OP4OAKQJ.mjs";
 import {
-  intersectionWith
-} from "../chunk-XI7KRD2C.mjs";
+  union
+} from "../chunk-R6QA7PLZ.mjs";
 import {
-  keyBy
-} from "../chunk-AJKZMN2V.mjs";
+  uniq
+} from "../chunk-DVK2N4KC.mjs";
+import {
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
 import {
   last
 } from "../chunk-KPBQ7OUY.mjs";
@@ -194,11 +163,17 @@ import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
 import {
-  forEachRight
-} from "../chunk-IEA53J7P.mjs";
+  randomInt
+} from "../chunk-GIWAOOFY.mjs";
+import {
+  random
+} from "../chunk-SYWMYQYJ.mjs";
+import {
+  shuffle
+} from "../chunk-G7UQ5PUR.mjs";
 import {
   groupBy
 } from "../chunk-E6E4RZLN.mjs";
@@ -215,11 +190,11 @@ import {
   intersectionBy
 } from "../chunk-O6UXZR3U.mjs";
 import {
-  differenceBy
-} from "../chunk-LVWX5B43.mjs";
+  intersectionWith
+} from "../chunk-XI7KRD2C.mjs";
 import {
-  differenceWith
-} from "../chunk-6NVQAHXP.mjs";
+  keyBy
+} from "../chunk-AJKZMN2V.mjs";
 import {
   drop
 } from "../chunk-S3CORED5.mjs";
@@ -235,13 +210,15 @@ import {
 import {
   fill
 } from "../chunk-C4WE4GLC.mjs";
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
-import "../chunk-FZEZH22H.mjs";
 import {
-  AbortError
-} from "../chunk-DXB7EZUQ.mjs";
+  forEachRight
+} from "../chunk-IEA53J7P.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -254,6 +231,32 @@ import {
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
+import {
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
+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-2HIMLZE3.mjs";
 
 // src/compat/array/chunk.ts
@@ -325,6 +328,7 @@ export {
   shuffle,
   snakeCase,
   sum,
+  sumBy,
   tail,
   take,
   takeRight,

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-2HIMLZE3.mjs";
 export {
   debounce,

package/dist/index.d.mts

@@ -62,6 +62,7 @@ export { random } from './math/random.mjs';
 export { randomInt } from './math/randomInt.mjs';
 export { round } from './math/round.mjs';
 export { sum } from './math/sum.mjs';
+export { sumBy } from './math/sumBy.mjs';
 export { range } from './math/range.mjs';
 export { omit } from './object/omit.mjs';
 export { omitBy } from './object/omitBy.mjs';

package/dist/index.d.ts

@@ -62,6 +62,7 @@ export { random } from './math/random.js';
 export { randomInt } from './math/randomInt.js';
 export { round } from './math/round.js';
 export { sum } from './math/sum.js';
+export { sumBy } from './math/sumBy.js';
 export { range } from './math/range.js';
 export { omit } from './object/omit.js';
 export { omitBy } from './object/omitBy.js';

package/dist/index.js

@@ -5031,7 +5031,7 @@ var require_lodash = __commonJS({
         function sum2(array) {
           return array && array.length ? baseSum(array, identity) : 0;
         }
-        function sumBy(array, iteratee2) {
+        function sumBy2(array, iteratee2) {
           return array && array.length ? baseSum(array, getIteratee(iteratee2, 2)) : 0;
         }
         lodash.after = after;
@@ -5318,7 +5318,7 @@ var require_lodash = __commonJS({
         lodash.startsWith = startsWith;
         lodash.subtract = subtract;
         lodash.sum = sum2;
-        lodash.sumBy = sumBy;
+        lodash.sumBy = sumBy2;
         lodash.template = template;
         lodash.times = times;
         lodash.toFinite = toFinite;
@@ -5588,6 +5588,7 @@ __export(src_exports, {
   shuffle: () => shuffle,
   snakeCase: () => snakeCase,
   sum: () => sum,
+  sumBy: () => sumBy,
   tail: () => tail,
   take: () => take,
   takeRight: () => takeRight,
@@ -6247,6 +6248,12 @@ function round(value, precision = 0) {
   return Math.round(value * multiplier) / multiplier;
 }
 
+// src/math/sumBy.ts
+function sumBy(items, getValue) {
+  const nums = items.map((x) => getValue(x));
+  return sum(nums);
+}
+
 // src/math/range.ts
 function range(start, end, step) {
   if (end == null) {
@@ -6531,6 +6538,7 @@ var capitalize2 = (str) => {
   shuffle,
   snakeCase,
   sum,
+  sumBy,
   tail,
   take,
   takeRight,