es-toolkit 1.39.10-dev.1599 → 1.39.10-dev.1600

package/dist/math/sumBy.d.mts

@@ -5,14 +5,15 @@
  * If the array is empty, this function returns `0`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} items An array to calculate the sum.
- * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
+ * @param {readonly T[]} items - An array to calculate the sum.
+ * @param {(element: T, index: number) => number} getValue - A function that selects a numeric value from each element.
+ *   It receives the element and its zero‑based index in the array.
  * @returns {number} The sum of all the numbers as determined by the `getValue` function.
  *
  * @example
- * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: 6
- * sumBy([], x => x.a); // Returns: 0
+ * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8
+ * sumBy([], () => 1); // Returns: 0
  */
-declare function sumBy<T>(items: readonly T[], getValue: (element: T) => number): number;
+declare function sumBy<T>(items: readonly T[], getValue: (element: T, index: number) => number): number;
 
 export { sumBy };

package/dist/math/sumBy.d.ts

@@ -5,14 +5,15 @@
  * If the array is empty, this function returns `0`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} items An array to calculate the sum.
- * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
+ * @param {readonly T[]} items - An array to calculate the sum.
+ * @param {(element: T, index: number) => number} getValue - A function that selects a numeric value from each element.
+ *   It receives the element and its zero‑based index in the array.
  * @returns {number} The sum of all the numbers as determined by the `getValue` function.
  *
  * @example
- * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], x => x.a); // Returns: 6
- * sumBy([], x => x.a); // Returns: 0
+ * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8
+ * sumBy([], () => 1); // Returns: 0
  */
-declare function sumBy<T>(items: readonly T[], getValue: (element: T) => number): number;
+declare function sumBy<T>(items: readonly T[], getValue: (element: T, index: number) => number): number;
 
 export { sumBy };

package/dist/math/sumBy.js

@@ -5,7 +5,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 function sumBy(items, getValue) {
     let result = 0;
     for (let i = 0; i < items.length; i++) {
-        result += getValue(items[i]);
+        result += getValue(items[i], i);
     }
     return result;
 }

package/dist/math/sumBy.mjs

@@ -1,7 +1,7 @@
 function sumBy(items, getValue) {
     let result = 0;
     for (let i = 0; i < items.length; i++) {
-        result += getValue(items[i]);
+        result += getValue(items[i], i);
     }
     return result;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.39.10-dev.1599+6525f2a3",
+  "version": "1.39.10-dev.1600+579af7b1",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
   "homepage": "https://es-toolkit.dev",
   "bugs": "https://github.com/toss/es-toolkit/issues",