es-toolkit 1.50.0-dev.1991 → 1.50.0-dev.1993

package/dist/bigint/rangeRight.d.ts

@@ -0,0 +1,43 @@
+//#region src/bigint/rangeRight.d.ts
+/**
+ * Returns an array of bigints from `0n` up to, but not including, `end`, in descending order.
+ *
+ * @param end - The exclusive end of the range.
+ * @returns An array of bigints.
+ *
+ * @example
+ * const result = rangeRight(4n);
+ * // result will be [3n, 2n, 1n, 0n]
+ */
+declare function rangeRight(end: bigint): bigint[];
+/**
+ * Returns an array of bigints from `start` up to, but not including, `end`, in descending order.
+ *
+ * @param start - The inclusive start of the range.
+ * @param end - The exclusive end of the range.
+ * @returns An array of bigints.
+ *
+ * @example
+ * const result = rangeRight(2n, 5n);
+ * // result will be [4n, 3n, 2n]
+ */
+declare function rangeRight(start: bigint, end: bigint): bigint[];
+/**
+ * Returns an array of bigints from `start` up to, but not including, `end`, incrementing by `step`,
+ * in descending order.
+ *
+ * A negative `step` counts down. If `step` points away from `end`, an empty array is returned.
+ *
+ * @param start - The inclusive start of the range.
+ * @param end - The exclusive end of the range.
+ * @param step - The amount to increment by. Must not be `0n`.
+ * @returns An array of bigints.
+ * @throws {Error} If `step` is `0n`.
+ *
+ * @example
+ * const result = rangeRight(0n, 10n, 2n);
+ * // result will be [8n, 6n, 4n, 2n, 0n]
+ */
+declare function rangeRight(start: bigint, end: bigint, step: bigint): bigint[];
+//#endregion
+export { rangeRight };

package/dist/bigint/rangeRight.js

@@ -0,0 +1,25 @@
+const require_bigIntRangeLength = require("../_internal/bigIntRangeLength.js");
+//#region src/bigint/rangeRight.ts
+/**
+* Returns an array of bigints from `start` up to, but not including, `end`, incrementing by `step`,
+* in descending order.
+*
+* @param start - The exclusive end of the range when called with one argument, otherwise the inclusive start.
+* @param end - The exclusive end of the range.
+* @param step - The amount to increment by. Must not be `0n`.
+* @returns An array of bigints.
+* @throws {Error} If `step` is `0n`.
+*/
+function rangeRight(start, end, step = 1n) {
+	if (end == null) {
+		end = start;
+		start = 0n;
+	}
+	if (step === 0n) throw new Error("The step value must be a non-zero bigint.");
+	const length = require_bigIntRangeLength.bigIntRangeLength(start, end, step);
+	const result = new Array(length);
+	for (let i = 0; i < length; i++) result[i] = start + BigInt(length - i - 1) * step;
+	return result;
+}
+//#endregion
+exports.rangeRight = rangeRight;

package/dist/bigint/rangeRight.mjs

@@ -0,0 +1,25 @@
+import { bigIntRangeLength } from "../_internal/bigIntRangeLength.mjs";
+//#region src/bigint/rangeRight.ts
+/**
+* Returns an array of bigints from `start` up to, but not including, `end`, incrementing by `step`,
+* in descending order.
+*
+* @param start - The exclusive end of the range when called with one argument, otherwise the inclusive start.
+* @param end - The exclusive end of the range.
+* @param step - The amount to increment by. Must not be `0n`.
+* @returns An array of bigints.
+* @throws {Error} If `step` is `0n`.
+*/
+function rangeRight(start, end, step = 1n) {
+	if (end == null) {
+		end = start;
+		start = 0n;
+	}
+	if (step === 0n) throw new Error("The step value must be a non-zero bigint.");
+	const length = bigIntRangeLength(start, end, step);
+	const result = new Array(length);
+	for (let i = 0; i < length; i++) result[i] = start + BigInt(length - i - 1) * step;
+	return result;
+}
+//#endregion
+export { rangeRight };

package/dist/bigint/sum.d.mts

@@ -0,0 +1,18 @@
+//#region src/bigint/sum.d.ts
+/**
+ * Calculates the sum of an array of bigints.
+ *
+ * This function takes an array of bigints and returns the sum of all the elements in the array.
+ * An empty array returns `0n`, so `sum(a) + sum(b)` always equals `sum([...a, ...b])`.
+ *
+ * @param nums - An array of bigints to be summed.
+ * @returns The sum of all the bigints in the array. Returns `0n` for an empty array.
+ *
+ * @example
+ * const numbers = [1n, 2n, 3n, 4n, 5n];
+ * const result = sum(numbers);
+ * // result will be 15n
+ */
+declare function sum(nums: readonly bigint[]): bigint;
+//#endregion
+export { sum };

package/dist/bigint/sum.d.ts

@@ -0,0 +1,18 @@
+//#region src/bigint/sum.d.ts
+/**
+ * Calculates the sum of an array of bigints.
+ *
+ * This function takes an array of bigints and returns the sum of all the elements in the array.
+ * An empty array returns `0n`, so `sum(a) + sum(b)` always equals `sum([...a, ...b])`.
+ *
+ * @param nums - An array of bigints to be summed.
+ * @returns The sum of all the bigints in the array. Returns `0n` for an empty array.
+ *
+ * @example
+ * const numbers = [1n, 2n, 3n, 4n, 5n];
+ * const result = sum(numbers);
+ * // result will be 15n
+ */
+declare function sum(nums: readonly bigint[]): bigint;
+//#endregion
+export { sum };

package/dist/bigint/sum.js

@@ -0,0 +1,22 @@
+//#region src/bigint/sum.ts
+/**
+* Calculates the sum of an array of bigints.
+*
+* This function takes an array of bigints and returns the sum of all the elements in the array.
+* An empty array returns `0n`, so `sum(a) + sum(b)` always equals `sum([...a, ...b])`.
+*
+* @param nums - An array of bigints to be summed.
+* @returns The sum of all the bigints in the array. Returns `0n` for an empty array.
+*
+* @example
+* const numbers = [1n, 2n, 3n, 4n, 5n];
+* const result = sum(numbers);
+* // result will be 15n
+*/
+function sum(nums) {
+	let result = 0n;
+	for (let i = 0; i < nums.length; i++) result += nums[i];
+	return result;
+}
+//#endregion
+exports.sum = sum;

package/dist/bigint/sum.mjs

@@ -0,0 +1,22 @@
+//#region src/bigint/sum.ts
+/**
+* Calculates the sum of an array of bigints.
+*
+* This function takes an array of bigints and returns the sum of all the elements in the array.
+* An empty array returns `0n`, so `sum(a) + sum(b)` always equals `sum([...a, ...b])`.
+*
+* @param nums - An array of bigints to be summed.
+* @returns The sum of all the bigints in the array. Returns `0n` for an empty array.
+*
+* @example
+* const numbers = [1n, 2n, 3n, 4n, 5n];
+* const result = sum(numbers);
+* // result will be 15n
+*/
+function sum(nums) {
+	let result = 0n;
+	for (let i = 0; i < nums.length; i++) result += nums[i];
+	return result;
+}
+//#endregion
+export { sum };

package/dist/bigint/sumBy.d.mts

@@ -0,0 +1,20 @@
+//#region src/bigint/sumBy.d.ts
+/**
+ * Calculates the sum of an array by mapping each element to a bigint.
+ *
+ * This function takes an array and a function that maps each element to a bigint,
+ * and returns the sum of the mapped values. An empty array returns `0n`.
+ *
+ * @template T - The type of elements in the array.
+ * @param items - An array of elements to be summed.
+ * @param getValue - A function that maps an element to the bigint to add.
+ * @returns The sum of the mapped bigints. Returns `0n` for an empty array.
+ *
+ * @example
+ * const items = [{ balance: 10n }, { balance: 20n }, { balance: 30n }];
+ * const result = sumBy(items, item => item.balance);
+ * // result will be 60n
+ */
+declare function sumBy<T>(items: readonly T[], getValue: (element: T, index: number) => bigint): bigint;
+//#endregion
+export { sumBy };

package/dist/bigint/sumBy.d.ts

@@ -0,0 +1,20 @@
+//#region src/bigint/sumBy.d.ts
+/**
+ * Calculates the sum of an array by mapping each element to a bigint.
+ *
+ * This function takes an array and a function that maps each element to a bigint,
+ * and returns the sum of the mapped values. An empty array returns `0n`.
+ *
+ * @template T - The type of elements in the array.
+ * @param items - An array of elements to be summed.
+ * @param getValue - A function that maps an element to the bigint to add.
+ * @returns The sum of the mapped bigints. Returns `0n` for an empty array.
+ *
+ * @example
+ * const items = [{ balance: 10n }, { balance: 20n }, { balance: 30n }];
+ * const result = sumBy(items, item => item.balance);
+ * // result will be 60n
+ */
+declare function sumBy<T>(items: readonly T[], getValue: (element: T, index: number) => bigint): bigint;
+//#endregion
+export { sumBy };

package/dist/bigint/sumBy.js

@@ -0,0 +1,24 @@
+//#region src/bigint/sumBy.ts
+/**
+* Calculates the sum of an array by mapping each element to a bigint.
+*
+* This function takes an array and a function that maps each element to a bigint,
+* and returns the sum of the mapped values. An empty array returns `0n`.
+*
+* @template T - The type of elements in the array.
+* @param items - An array of elements to be summed.
+* @param getValue - A function that maps an element to the bigint to add.
+* @returns The sum of the mapped bigints. Returns `0n` for an empty array.
+*
+* @example
+* const items = [{ balance: 10n }, { balance: 20n }, { balance: 30n }];
+* const result = sumBy(items, item => item.balance);
+* // result will be 60n
+*/
+function sumBy(items, getValue) {
+	let result = 0n;
+	for (let i = 0; i < items.length; i++) result += getValue(items[i], i);
+	return result;
+}
+//#endregion
+exports.sumBy = sumBy;

package/dist/bigint/sumBy.mjs

@@ -0,0 +1,24 @@
+//#region src/bigint/sumBy.ts
+/**
+* Calculates the sum of an array by mapping each element to a bigint.
+*
+* This function takes an array and a function that maps each element to a bigint,
+* and returns the sum of the mapped values. An empty array returns `0n`.
+*
+* @template T - The type of elements in the array.
+* @param items - An array of elements to be summed.
+* @param getValue - A function that maps an element to the bigint to add.
+* @returns The sum of the mapped bigints. Returns `0n` for an empty array.
+*
+* @example
+* const items = [{ balance: 10n }, { balance: 20n }, { balance: 30n }];
+* const result = sumBy(items, item => item.balance);
+* // result will be 60n
+*/
+function sumBy(items, getValue) {
+	let result = 0n;
+	for (let i = 0; i < items.length; i++) result += getValue(items[i], i);
+	return result;
+}
+//#endregion
+export { sumBy };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "es-toolkit",
-  "version": "1.50.0-dev.1991+20f809db",
+  "version": "1.50.0-dev.1993+54a5104a",
   "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",
@@ -34,6 +34,16 @@
         "default": "./dist/array/index.js"
       }
     },
+    "./bigint": {
+      "import": {
+        "types": "./dist/bigint/index.d.mts",
+        "default": "./dist/bigint/index.mjs"
+      },
+      "require": {
+        "types": "./dist/bigint/index.d.ts",
+        "default": "./dist/bigint/index.js"
+      }
+    },
     "./compat": {
       "import": {
         "types": "./dist/compat/index.d.mts",
@@ -189,6 +199,7 @@
     "compat",
     "*.d.ts",
     "array.js",
+    "bigint.js",
     "compat.js",
     "error.js",
     "fp.js",
@@ -283,6 +294,16 @@
           "default": "./dist/array/index.js"
         }
       },
+      "./bigint": {
+        "import": {
+          "types": "./dist/bigint/index.d.mts",
+          "default": "./dist/bigint/index.mjs"
+        },
+        "require": {
+          "types": "./dist/bigint/index.d.ts",
+          "default": "./dist/bigint/index.js"
+        }
+      },
       "./compat": {
         "import": {
           "types": "./dist/compat/index.d.mts",