es-toolkit 1.10.0-dev.205 → 1.10.0-dev.207

package/LICENSE

@@ -18,4 +18,10 @@ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+SOFTWARE.
+
+---
+
+Some of the test code in this software comes from the lodash library (https://github.com/lodash/lodash).
+
+The copyright for this imported test code from lodash is owned by the JS Foundation and other contributors <https://js.foundation/>.

package/dist/array/index.mjs

@@ -1,13 +1,4 @@
 import "../chunk-2MRZANXZ.mjs";
-import {
-  without
-} from "../chunk-PYEYV7BY.mjs";
-import {
-  xor
-} from "../chunk-L7FQX5MN.mjs";
-import {
-  xorBy
-} from "../chunk-Q47NGNXT.mjs";
 import {
   xorWith
 } from "../chunk-QRSJBBFY.mjs";
@@ -20,24 +11,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";
-import {
-  uniqWith
-} from "../chunk-237HGSZS.mjs";
 import {
   unzip
 } from "../chunk-UYZKMBDO.mjs";
@@ -45,16 +21,14 @@ import {
   unzipWith
 } from "../chunk-IFNXROZR.mjs";
 import {
-  sampleSize
-} from "../chunk-EHSKB6DF.mjs";
-import "../chunk-GIWAOOFY.mjs";
-import "../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";
+  xorBy
+} from "../chunk-Q47NGNXT.mjs";
 import {
   take
 } from "../chunk-ME352XO7.mjs";
@@ -71,14 +45,20 @@ 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 {
-  last
-} from "../chunk-KPBQ7OUY.mjs";
+  unionBy
+} from "../chunk-NFS7RWWE.mjs";
+import {
+  unionWith
+} from "../chunk-2ZCITDMK.mjs";
+import {
+  uniqWith
+} from "../chunk-237HGSZS.mjs";
 import {
   maxBy
 } from "../chunk-OOKNBU4V.mjs";
@@ -95,14 +75,16 @@ import {
   sample
 } from "../chunk-2KNLZB7V.mjs";
 import {
-  flattenDeep
-} from "../chunk-ML727RRJ.mjs";
+  sampleSize
+} from "../chunk-EHSKB6DF.mjs";
+import "../chunk-GIWAOOFY.mjs";
+import "../chunk-SYWMYQYJ.mjs";
 import {
-  forEachRight
-} from "../chunk-IEA53J7P.mjs";
+  shuffle
+} from "../chunk-G7UQ5PUR.mjs";
 import {
-  groupBy
-} from "../chunk-E6E4RZLN.mjs";
+  tail
+} from "../chunk-OF6NM4G7.mjs";
 import {
   head
 } from "../chunk-HM2JT2RX.mjs";
@@ -116,14 +98,14 @@ 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";
+  last
+} from "../chunk-KPBQ7OUY.mjs";
 import {
   dropRight
 } from "../chunk-JEKUA56R.mjs";
@@ -136,9 +118,18 @@ import {
 import {
   fill
 } from "../chunk-C4WE4GLC.mjs";
+import {
+  flattenDeep
+} from "../chunk-ML727RRJ.mjs";
 import {
   flatten
 } from "../chunk-33MSBDC6.mjs";
+import {
+  forEachRight
+} from "../chunk-IEA53J7P.mjs";
+import {
+  groupBy
+} from "../chunk-E6E4RZLN.mjs";
 import {
   chunk
 } from "../chunk-E6C5EZQA.mjs";
@@ -151,6 +142,15 @@ import {
 import {
   difference
 } from "../chunk-JPUKH67K.mjs";
+import {
+  differenceBy
+} from "../chunk-LVWX5B43.mjs";
+import {
+  differenceWith
+} from "../chunk-6NVQAHXP.mjs";
+import {
+  drop
+} from "../chunk-S3CORED5.mjs";
 import "../chunk-2HIMLZE3.mjs";
 export {
   chunk,

package/dist/chunk-5L4VWRFX.mjs

@@ -0,0 +1,14 @@
+import {
+  sum
+} from "./chunk-2SLTL4KL.mjs";
+
+// src/math/sumBy.ts
+function sumBy(items, getValue) {
+  const nums = items.map((x) => getValue(x));
+  return sum(nums);
+}
+
+export {
+  sumBy
+};
+//# sourceMappingURL=chunk-5L4VWRFX.mjs.map

package/dist/chunk-5L4VWRFX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/math/sumBy.ts"],"sourcesContent":["import { sum } from './sum.ts';\n\n/**\n * Calculates the sum of an array of numbers when applying\n * the `getValue` function to each element.\n *\n * If the array is empty, this function returns `0`.\n *\n * @template T - The type of elements in the array.\n * @param {T[]} items An array to calculate the average.\n * @param {(element: T) => number} getValue A function that selects a numeric value from each element.\n * @returns {number} The average of all the numbers as determined by the `getValue` function.\n *\n * @example\n * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: 6\n * sumBy([], x => x.a); // Returns: 0\n */\nexport function sumBy<T>(items: readonly T[], getValue: (element: T) => number): number {\n  const nums = items.map(x => getValue(x));\n\n  return sum(nums);\n}\n"],"mappings":";;;;;AAiBO,SAAS,MAAS,OAAqB,UAA0C;AACtF,QAAM,OAAO,MAAM,IAAI,OAAK,SAAS,CAAC,CAAC;AAEvC,SAAO,IAAI,IAAI;AACjB;","names":[]}

package/dist/chunk-FUS75PJ7.mjs

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

package/dist/compat/index.d.mts

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

@@ -61,6 +61,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/compat/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(compat_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) {
@@ -6540,6 +6547,7 @@ function chunk2(arr, size = 1) {
   shuffle,
   snakeCase,
   sum,
+  sumBy,
   tail,
   take,
   takeRight,