es-toolkit 1.26.1-dev.850 → 1.26.1-dev.852

package/dist/compat/index.d.mts

@@ -47,8 +47,6 @@ export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { range } from '../math/range.mjs';
 export { rangeRight } from '../math/rangeRight.mjs';
-export { sum } from '../math/sum.mjs';
-export { sumBy } from '../math/sumBy.mjs';
 export { clone } from '../object/clone.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
 export { invert } from '../object/invert.mjs';
@@ -142,6 +140,8 @@ export { min } from './math/min.mjs';
 export { parseInt } from './math/parseInt.mjs';
 export { random } from './math/random.mjs';
 export { round } from './math/round.mjs';
+export { sum } from './math/sum.mjs';
+export { sumBy } from './math/sumBy.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
 export { defaults } from './object/defaults.mjs';
 export { fromPairs } from './object/fromPairs.mjs';

package/dist/compat/index.d.ts

@@ -47,8 +47,6 @@ export { medianBy } from '../math/medianBy.js';
 export { randomInt } from '../math/randomInt.js';
 export { range } from '../math/range.js';
 export { rangeRight } from '../math/rangeRight.js';
-export { sum } from '../math/sum.js';
-export { sumBy } from '../math/sumBy.js';
 export { clone } from '../object/clone.js';
 export { flattenObject } from '../object/flattenObject.js';
 export { invert } from '../object/invert.js';
@@ -142,6 +140,8 @@ export { min } from './math/min.js';
 export { parseInt } from './math/parseInt.js';
 export { random } from './math/random.js';
 export { round } from './math/round.js';
+export { sum } from './math/sum.js';
+export { sumBy } from './math/sumBy.js';
 export { cloneDeep } from './object/cloneDeep.js';
 export { defaults } from './object/defaults.js';
 export { fromPairs } from './object/fromPairs.js';

package/dist/compat/index.js

@@ -6,7 +6,7 @@ const zipWith = require('../_chunk/zipWith-Dx_q4f.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
 const unary = require('../_chunk/unary-CcTNuC.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const sumBy = require('../_chunk/sumBy-wtGD37.js');
+const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-wNz52b.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
@@ -1567,7 +1567,7 @@ function clamp(value, bound1, bound2) {
     if (Number.isNaN(bound2)) {
         bound2 = 0;
     }
-    return sumBy.clamp(value, bound1, bound2);
+    return rangeRight.clamp(value, bound1, bound2);
 }
 
 function floor(number, precision = 0) {
@@ -1596,7 +1596,7 @@ function inRange(value, minimum, maximum) {
     if (minimum === maximum) {
         return false;
     }
-    return sumBy.inRange(value, minimum, maximum);
+    return rangeRight.inRange(value, minimum, maximum);
 }
 
 function max(items = []) {
@@ -1701,6 +1701,27 @@ function round(number, precision = 0) {
     return decimalAdjust('round', number, precision);
 }
 
+function sumBy(array, iteratee$1) {
+    if (!array || !array.length) {
+        return 0;
+    }
+    if (iteratee$1 != null) {
+        iteratee$1 = iteratee(iteratee$1);
+    }
+    let result = iteratee$1 ? iteratee$1(array[0]) : array[0];
+    for (let i = 1; i < array.length; i++) {
+        const current = iteratee$1 ? iteratee$1(array[i]) : array[i];
+        if (current !== undefined) {
+            result += current;
+        }
+    }
+    return result;
+}
+
+function sum(array) {
+    return sumBy(array);
+}
+
 function defaults(object, ...sources) {
     object = Object(object);
     const objectProto = Object.prototype;
@@ -2498,14 +2519,12 @@ exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
 exports.unary = unary.unary;
 exports.noop = noop.noop;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
 exports.randomInt = randomInt.randomInt;
 exports.clone = toMerged.clone;
 exports.flattenObject = toMerged.flattenObject;
@@ -2654,6 +2673,8 @@ exports.sortBy = sortBy;
 exports.spread = spread;
 exports.startCase = startCase;
 exports.startsWith = startsWith;
+exports.sum = sum;
+exports.sumBy = sumBy;
 exports.tail = tail;
 exports.take = take;
 exports.takeRight = takeRight;

package/dist/compat/index.mjs

@@ -47,8 +47,6 @@ export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
 export { range } from '../math/range.mjs';
 export { rangeRight } from '../math/rangeRight.mjs';
-export { sum } from '../math/sum.mjs';
-export { sumBy } from '../math/sumBy.mjs';
 export { clone } from '../object/clone.mjs';
 export { isPrimitive } from '../predicate/isPrimitive.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
@@ -144,6 +142,8 @@ export { min } from './math/min.mjs';
 export { parseInt } from './math/parseInt.mjs';
 export { random } from './math/random.mjs';
 export { round } from './math/round.mjs';
+export { sum } from './math/sum.mjs';
+export { sumBy } from './math/sumBy.mjs';
 export { cloneDeep } from './object/cloneDeep.mjs';
 export { defaults } from './object/defaults.mjs';
 export { fromPairs } from './object/fromPairs.mjs';

package/dist/compat/math/sum.d.mts

@@ -0,0 +1,37 @@
+/**
+ * Computes the sum of the `number` values in `array`.
+ *
+ * @param {ArrayLike<number> | null | undefined} array - The array to iterate over.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sum([1, 2, 3]); // => 6
+ * sum(null); // => 0
+ * sum(undefined); // => 0
+ */
+declare function sum(array: ArrayLike<number> | null | undefined): number;
+/**
+ * Computes the sum of the `bigint` values in `array`.
+ *
+ * @param {ArrayLike<bigint>} array - The array to iterate over.
+ * @returns {bigint} Returns the sum.
+ *
+ * @example
+ * sum([1n, 2n, 3n]); // => 6n
+ */
+declare function sum(array: ArrayLike<bigint>): bigint;
+/**
+ * Computes the sum of the values in `array`.
+ *
+ * It does not coerce values to `number`.
+ *
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to iterate over.
+ * @returns {unknown} Returns the sum.
+ *
+ * @example
+ * sum(["1", "2"]); // => "12"
+ * sum([1, undefined, 2]); // => 3
+ */
+declare function sum(array: ArrayLike<unknown> | null | undefined): unknown;
+
+export { sum };

package/dist/compat/math/sum.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Computes the sum of the `number` values in `array`.
+ *
+ * @param {ArrayLike<number> | null | undefined} array - The array to iterate over.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sum([1, 2, 3]); // => 6
+ * sum(null); // => 0
+ * sum(undefined); // => 0
+ */
+declare function sum(array: ArrayLike<number> | null | undefined): number;
+/**
+ * Computes the sum of the `bigint` values in `array`.
+ *
+ * @param {ArrayLike<bigint>} array - The array to iterate over.
+ * @returns {bigint} Returns the sum.
+ *
+ * @example
+ * sum([1n, 2n, 3n]); // => 6n
+ */
+declare function sum(array: ArrayLike<bigint>): bigint;
+/**
+ * Computes the sum of the values in `array`.
+ *
+ * It does not coerce values to `number`.
+ *
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to iterate over.
+ * @returns {unknown} Returns the sum.
+ *
+ * @example
+ * sum(["1", "2"]); // => "12"
+ * sum([1, undefined, 2]); // => 3
+ */
+declare function sum(array: ArrayLike<unknown> | null | undefined): unknown;
+
+export { sum };

package/dist/compat/math/sum.mjs

@@ -0,0 +1,7 @@
+import { sumBy } from './sumBy.mjs';
+
+function sum(array) {
+    return sumBy(array);
+}
+
+export { sum };

package/dist/compat/math/sumBy.d.mts

@@ -0,0 +1,64 @@
+/**
+ * Computes the sum of the `number` values in `array`.
+ *
+ * @param {ArrayLike<number> | null | undefined} array - The array to iterate over.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sumBy([1, 2, 3]); // => 6
+ * sumBy(null); // => 0
+ * sumBy(undefined); // => 0
+ */
+declare function sumBy(array: ArrayLike<number> | null | undefined): number;
+/**
+ * Computes the sum of the `bigint` values in `array`.
+ *
+ * @param {ArrayLike<bigint>} array - The array to iterate over.
+ * @returns {bigint} Returns the sum.
+ *
+ * @example
+ * sumBy([1n, 2n, 3n]); // => 6n
+ */
+declare function sumBy(array: ArrayLike<bigint>): bigint;
+/**
+ * Computes the sum of the values in `array`.
+ *
+ * It does not coerce values to `number`.
+ *
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to iterate over.
+ * @returns {unknown} Returns the sum.
+ *
+ * @example
+ * sumBy(["1", "2"]); // => "12"
+ * sumBy([1, undefined, 2]); // => 3
+ */
+declare function sumBy(array: ArrayLike<unknown> | null | undefined): unknown;
+/**
+ * Compmutes the sum of the `number` values that are returned by the `iteratee` function.
+ *
+ * @template T - The type of the array elements.
+ * @param {ArrayLike<T>} array - The array to iterate over.
+ * @param {(value: T) => number} iteratee - The function invoked per iteration.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], object => object.a); // => 6
+ */
+declare function sumBy<T>(array: ArrayLike<T>, iteratee: (value: T) => number): number;
+/**
+ * Compmutes the sum of the `bigint` values that are returned by the `iteratee` function.
+ *
+ * NOTE: If the `array` is empty, the function returns `0`.
+ *
+ * @template T - The type of the array elements.
+ * @param {ArrayLike<T>} array - The array to iterate over.
+ * @param {(value: T) => bigint} iteratee - The function invoked per iteration.
+ * @returns {bigint | number} Returns the sum.
+ *
+ * @example
+ * sumBy([{ a: 1n }, { a: 2n }, { a: 3n }], object => object.a); // => 6n
+ * sumBy([], (item: { a: bigint }) => item.a); // => 0
+ */
+declare function sumBy<T>(array: ArrayLike<T>, iteratee: (value: T) => bigint): bigint | number;
+
+export { sumBy };

package/dist/compat/math/sumBy.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Computes the sum of the `number` values in `array`.
+ *
+ * @param {ArrayLike<number> | null | undefined} array - The array to iterate over.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sumBy([1, 2, 3]); // => 6
+ * sumBy(null); // => 0
+ * sumBy(undefined); // => 0
+ */
+declare function sumBy(array: ArrayLike<number> | null | undefined): number;
+/**
+ * Computes the sum of the `bigint` values in `array`.
+ *
+ * @param {ArrayLike<bigint>} array - The array to iterate over.
+ * @returns {bigint} Returns the sum.
+ *
+ * @example
+ * sumBy([1n, 2n, 3n]); // => 6n
+ */
+declare function sumBy(array: ArrayLike<bigint>): bigint;
+/**
+ * Computes the sum of the values in `array`.
+ *
+ * It does not coerce values to `number`.
+ *
+ * @param {ArrayLike<unknown> | null | undefined} array - The array to iterate over.
+ * @returns {unknown} Returns the sum.
+ *
+ * @example
+ * sumBy(["1", "2"]); // => "12"
+ * sumBy([1, undefined, 2]); // => 3
+ */
+declare function sumBy(array: ArrayLike<unknown> | null | undefined): unknown;
+/**
+ * Compmutes the sum of the `number` values that are returned by the `iteratee` function.
+ *
+ * @template T - The type of the array elements.
+ * @param {ArrayLike<T>} array - The array to iterate over.
+ * @param {(value: T) => number} iteratee - The function invoked per iteration.
+ * @returns {number} Returns the sum.
+ *
+ * @example
+ * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], object => object.a); // => 6
+ */
+declare function sumBy<T>(array: ArrayLike<T>, iteratee: (value: T) => number): number;
+/**
+ * Compmutes the sum of the `bigint` values that are returned by the `iteratee` function.
+ *
+ * NOTE: If the `array` is empty, the function returns `0`.
+ *
+ * @template T - The type of the array elements.
+ * @param {ArrayLike<T>} array - The array to iterate over.
+ * @param {(value: T) => bigint} iteratee - The function invoked per iteration.
+ * @returns {bigint | number} Returns the sum.
+ *
+ * @example
+ * sumBy([{ a: 1n }, { a: 2n }, { a: 3n }], object => object.a); // => 6n
+ * sumBy([], (item: { a: bigint }) => item.a); // => 0
+ */
+declare function sumBy<T>(array: ArrayLike<T>, iteratee: (value: T) => bigint): bigint | number;
+
+export { sumBy };

package/dist/compat/math/sumBy.mjs

@@ -0,0 +1,20 @@
+import { iteratee } from '../util/iteratee.mjs';
+
+function sumBy(array, iteratee$1) {
+    if (!array || !array.length) {
+        return 0;
+    }
+    if (iteratee$1 != null) {
+        iteratee$1 = iteratee(iteratee$1);
+    }
+    let result = iteratee$1 ? iteratee$1(array[0]) : array[0];
+    for (let i = 1; i < array.length; i++) {
+        const current = iteratee$1 ? iteratee$1(array[i]) : array[i];
+        if (current !== undefined) {
+            result += current;
+        }
+    }
+    return result;
+}
+
+export { sumBy };

package/dist/index.js

@@ -8,7 +8,7 @@ const promise_index = require('./_chunk/index-BGZDR9.js');
 const unary = require('./_chunk/unary-CcTNuC.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
-const sumBy = require('./_chunk/sumBy-wtGD37.js');
+const rangeRight = require('./_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
 const toMerged = require('./_chunk/toMerged-wNz52b.js');
@@ -102,19 +102,19 @@ exports.curryRight = function_index.curryRight;
 exports.spread = function_index.spread;
 exports.throttle = function_index.throttle;
 exports.noop = noop.noop;
-exports.clamp = sumBy.clamp;
-exports.inRange = sumBy.inRange;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = math_index.round;
+exports.sumBy = math_index.sumBy;
 exports.clone = toMerged.clone;
 exports.cloneDeep = toMerged.cloneDeep;
 exports.flattenObject = toMerged.flattenObject;

package/dist/math/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const sumBy = require('../_chunk/sumBy-wtGD37.js');
+const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
 function round(value, precision = 0) {
@@ -13,16 +13,24 @@ function round(value, precision = 0) {
     return Math.round(value * multiplier) / multiplier;
 }
 
-exports.clamp = sumBy.clamp;
-exports.inRange = sumBy.inRange;
-exports.mean = sumBy.mean;
-exports.meanBy = sumBy.meanBy;
-exports.median = sumBy.median;
-exports.medianBy = sumBy.medianBy;
-exports.range = sumBy.range;
-exports.rangeRight = sumBy.rangeRight;
-exports.sum = sumBy.sum;
-exports.sumBy = sumBy.sumBy;
+function sumBy(items, getValue) {
+    let result = 0;
+    for (let i = 0; i < items.length; i++) {
+        result += getValue(items[i]);
+    }
+    return result;
+}
+
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.median = rangeRight.median;
+exports.medianBy = rangeRight.medianBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = round;
+exports.sumBy = sumBy;

package/dist/math/rangeRight.mjs

@@ -1,11 +1,8 @@
-function rangeRight(start, end, step) {
+function rangeRight(start, end, step = 1) {
     if (end == null) {
         end = start;
         start = 0;
     }
-    if (step == null) {
-        step = 1;
-    }
     if (!Number.isInteger(step) || step === 0) {
         throw new Error(`The step value must be a non-zero integer.`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.26.1-dev.850+7dbf58a9",
+  "version": "1.26.1-dev.852+9d13669f",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {