es-toolkit 1.4.0 → 1.5.0-dev.104

package/dist/index.mjs

@@ -1,11 +1,21 @@
 import "./chunk-ARZ5BDR6.mjs";
-import "./chunk-MAJSPFA6.mjs";
 import {
-  isNil
-} from "./chunk-OHQAR5AU.mjs";
+  delay
+} from "./chunk-AL3GJBEI.mjs";
+import "./chunk-T5JCRGXA.mjs";
 import {
-  isNotNil
-} from "./chunk-ZQNAZPSK.mjs";
+  omit
+} from "./chunk-PLTO44KM.mjs";
+import {
+  omitBy
+} from "./chunk-A67NF2C7.mjs";
+import {
+  pick
+} from "./chunk-OFWKFUFZ.mjs";
+import {
+  pickBy
+} from "./chunk-MQWVBKUT.mjs";
+import "./chunk-MAJSPFA6.mjs";
 import {
   isNull
 } from "./chunk-AIRSKN47.mjs";
@@ -13,73 +23,58 @@ import {
   isUndefined
 } from "./chunk-VH2PV426.mjs";
 import {
-  delay
-} from "./chunk-AL3GJBEI.mjs";
-import "./chunk-VAV4XHLO.mjs";
+  isNil
+} from "./chunk-OHQAR5AU.mjs";
+import {
+  isNotNil
+} from "./chunk-ZQNAZPSK.mjs";
+import "./chunk-7LAMAYGN.mjs";
+import {
+  clamp
+} from "./chunk-MLCL773E.mjs";
 import {
   randomInt
-} from "./chunk-QWJDITYJ.mjs";
+} from "./chunk-5UT77WON.mjs";
 import {
   random
-} from "./chunk-UGFVAAVO.mjs";
+} from "./chunk-LCP6FOCX.mjs";
+import {
+  range
+} from "./chunk-UNLX2F2Y.mjs";
 import {
   round
-} from "./chunk-V7E5DGZP.mjs";
+} from "./chunk-5PMKOZ2F.mjs";
 import {
   sum
 } from "./chunk-7OU22ENP.mjs";
-import "./chunk-T5JCRGXA.mjs";
-import {
-  pick
-} from "./chunk-OFWKFUFZ.mjs";
-import {
-  pickBy
-} from "./chunk-T2C2WVFL.mjs";
-import {
-  omit
-} from "./chunk-PLTO44KM.mjs";
-import {
-  omitBy
-} from "./chunk-SF3V7XXM.mjs";
-import "./chunk-N6EM6ETS.mjs";
-import {
-  debounce
-} from "./chunk-MKETZ2RP.mjs";
-import {
-  noop
-} from "./chunk-LKXCOLNY.mjs";
+import "./chunk-NP6PDX3E.mjs";
 import {
-  once
-} from "./chunk-UFAA5WKR.mjs";
-import {
-  throttle
-} from "./chunk-XLO3QZVY.mjs";
-import "./chunk-FZEZH22H.mjs";
-import {
-  AbortError
-} from "./chunk-VP2LXY75.mjs";
-import {
-  clamp
-} from "./chunk-MLCL773E.mjs";
-import "./chunk-EJGAXTF7.mjs";
+  zipWith
+} from "./chunk-4KYXHZ4R.mjs";
 import {
   uniqBy
 } from "./chunk-WPDDOUQT.mjs";
 import {
   xor
-} from "./chunk-WXIBCOES.mjs";
+} from "./chunk-G2TTBLLJ.mjs";
 import {
   xorBy
 } from "./chunk-AM2EGFCU.mjs";
 import {
   xorWith
-} from "./chunk-FCF2RHPW.mjs";
+} from "./chunk-UMDNWTJC.mjs";
+import {
+  unionWith
+} from "./chunk-642SWVKJ.mjs";
+import {
+  uniqWith
+} from "./chunk-2PFDLYQC.mjs";
 import {
   zip
-} from "./chunk-DD73BULA.mjs";
+} from "./chunk-IDCUZVJL.mjs";
 import {
-  zipWith
-} from "./chunk-T5FDOBCA.mjs";
+  sample
+} from "./chunk-DOOIIHT3.mjs";
 import {
   shuffle
 } from "./chunk-DPLJQQFX.mjs";
@@ -104,12 +99,6 @@ import {
 import {
   unionBy
 } from "./chunk-NRNKP6JF.mjs";
-import {
-  unionWith
-} from "./chunk-3KHI4I2X.mjs";
-import {
-  uniqWith
-} from "./chunk-2PFDLYQC.mjs";
 import {
   groupBy
 } from "./chunk-LWXZFXY5.mjs";
@@ -121,25 +110,28 @@ import {
 } from "./chunk-GNSJP2AB.mjs";
 import {
   intersectionWith
-} from "./chunk-KLJRZJOR.mjs";
+} from "./chunk-2EFS3VA3.mjs";
+import {
+  maxBy
+} from "./chunk-FXOABQRO.mjs";
+import {
+  minBy
+} from "./chunk-OIHARMNM.mjs";
 import {
   partition
 } from "./chunk-5L2V7WD3.mjs";
-import {
-  sample
-} from "./chunk-DOOIIHT3.mjs";
 import {
   chunk
 } from "./chunk-E6C5EZQA.mjs";
 import {
   difference
-} from "./chunk-M7UI5ETO.mjs";
+} from "./chunk-JPUKH67K.mjs";
 import {
   differenceBy
 } from "./chunk-LVWX5B43.mjs";
 import {
   differenceWith
-} from "./chunk-FQ4K36VD.mjs";
+} from "./chunk-6NVQAHXP.mjs";
 import {
   drop
 } from "./chunk-ACFP3XMB.mjs";
@@ -148,10 +140,27 @@ import {
 } from "./chunk-Q75KEFW5.mjs";
 import {
   dropRightWhile
-} from "./chunk-CIRFWC7Y.mjs";
+} from "./chunk-RNJM5BHX.mjs";
 import {
   dropWhile
-} from "./chunk-JFHM6EY2.mjs";
+} from "./chunk-K2BAFL2T.mjs";
+import "./chunk-FZEZH22H.mjs";
+import {
+  AbortError
+} from "./chunk-VP2LXY75.mjs";
+import "./chunk-N6EM6ETS.mjs";
+import {
+  debounce
+} from "./chunk-MKETZ2RP.mjs";
+import {
+  noop
+} from "./chunk-LKXCOLNY.mjs";
+import {
+  once
+} from "./chunk-UFAA5WKR.mjs";
+import {
+  throttle
+} from "./chunk-XLO3QZVY.mjs";
 import "./chunk-2MM5EJJX.mjs";
 export {
   AbortError,
@@ -174,6 +183,8 @@ export {
   isNotNil,
   isNull,
   isUndefined,
+  maxBy,
+  minBy,
   noop,
   omit,
   omitBy,
@@ -183,6 +194,7 @@ export {
   pickBy,
   random,
   randomInt,
+  range,
   round,
   sample,
   shuffle,

package/dist/math/index.d.mts

@@ -3,3 +3,4 @@ export { random } from './random.mjs';
 export { randomInt } from './randomInt.mjs';
 export { round } from './round.mjs';
 export { sum } from './sum.mjs';
+export { range } from './range.mjs';

package/dist/math/index.d.ts

@@ -3,3 +3,4 @@ export { random } from './random.js';
 export { randomInt } from './randomInt.js';
 export { round } from './round.js';
 export { sum } from './sum.js';
+export { range } from './range.js';

package/dist/math/index.js

@@ -23,6 +23,7 @@ __export(math_exports, {
   clamp: () => clamp,
   random: () => random,
   randomInt: () => randomInt,
+  range: () => range,
   round: () => round,
   sum: () => sum
 });
@@ -51,6 +52,9 @@ function randomInt(minimum, maximum) {
 
 // src/math/round.ts
 function round(value, precision = 0) {
+  if (!Number.isInteger(precision)) {
+    throw new Error("Precision must be an integer.");
+  }
   const multiplier = Math.pow(10, precision);
   return Math.round(value * multiplier) / multiplier;
 }
@@ -63,11 +67,32 @@ function sum(nums) {
   }
   return result;
 }
+
+// src/math/range.ts
+function range(start, end, step) {
+  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.`);
+  }
+  const length = Math.max(Math.ceil((end - start) / step), 0);
+  const result = new Array(length);
+  for (let i = 0; i < length; i++) {
+    result[i] = start + i * step;
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clamp,
   random,
   randomInt,
+  range,
   round,
   sum
 });

package/dist/math/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/math/index.ts","../../src/math/clamp.ts","../../src/math/random.ts","../../src/math/randomInt.ts","../../src/math/round.ts","../../src/math/sum.ts"],"sourcesContent":["export { clamp } from './clamp';\nexport { random } from './random';\nexport { randomInt } from './randomInt';\nexport { round } from './round';\nexport { sum } from './sum';\n","/**\n * Clamps a number within the inclusive lower and upper bounds.\n *\n * This function takes a number and two bounds, and returns the number clamped within the specified bounds.\n * If only one bound is provided, it returns the minimum of the value and the bound.\n *\n * @param {number} value - The number to clamp.\n * @param {number} minimum - The minimum bound to clamp the number.\n * @param {number} maximum - The maximum bound to clamp the number.\n * @returns {number} The clamped number within the specified bounds.\n *\n * @example\n * const result1 = clamp(10, 5); // result1 will be 5, as 10 is clamped to the bound 5\n * const result2 = clamp(10, 5, 15); // result2 will be 10, as it is within the bounds 5 and 15\n * const result3 = clamp(2, 5, 15); // result3 will be 5, as 2 is clamped to the lower bound 5\n * const result4 = clamp(20, 5, 15); // result4 will be 15, as 20 is clamped to the upper bound 15\n */\nexport function clamp(value: number, maximum: number): number;\nexport function clamp(value: number, minimum: number, maximum: number): number;\nexport function clamp(value: number, bound1: number, bound2?: number): number {\n  if (bound2 == null) {\n    return Math.min(value, bound1);\n  }\n\n  return Math.min(Math.max(value, bound1), bound2);\n}\n","/**\n * Generates a random floating-point number between minimum (inclusive) and maximum (exclusive).\n * If min is greater than maximum, the values are swapped.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = random(0, 5); // result will be a random floating-point number between 0 (inclusive) and 5 (exclusive)\n * const result2 = random(5, 0); // This will throw an error\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n","import { random } from './random';\n\n/**\n * Generates a random integer between minimum (inclusive) and maximum (exclusive).\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = randomInt(0, 5); // result will be a random integer between 0 (inclusive) and 5 (exclusive)\n * const result2 = randomInt(5, 0); // This will throw an error\n */\nexport function randomInt(minimum: number, maximum: number): number {\n  return Math.floor(random(minimum, maximum));\n}\n","/**\n * Rounds a number to a specified precision.\n *\n * This function takes a number and an optional precision value, and returns the number rounded\n * to the specified number of decimal places.\n *\n * @param {number} value - The number to round.\n * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.\n * @returns {number} The rounded number.\n *\n * @example\n * const result1 = round(1.2345); // result1 will be 1\n * const result2 = round(1.2345, 2); // result2 will be 1.23\n * const result3 = round(1.2345, 3); // result3 will be 1.235\n */\nexport function round(value: number, precision: number = 0): number {\n  const multiplier = Math.pow(10, precision);\n  return Math.round(value * multiplier) / multiplier;\n}\n","/**\n * Calculates the sum of an array of numbers.\n *\n * This function takes an array of numbers and returns the sum of all the elements in the array.\n *\n * @param {number[]} nums - An array of numbers to be summed.\n * @returns {number} The sum of all the numbers in the array.\n *\n * @example\n * const numbers = [1, 2, 3, 4, 5];\n * const result = sum(numbers);\n * // result will be 15\n */\nexport function sum(nums: number[]): number {\n  let result = 0;\n\n  for (const num of nums) {\n    result += num;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmBO,SAAS,MAAM,OAAe,QAAgB,QAAyB;AAC5E,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK,IAAI,OAAO,MAAM;AAAA,EAC/B;AAEA,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,MAAM,GAAG,MAAM;AACjD;;;ACZO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;;;ACLO,SAAS,UAAU,SAAiB,SAAyB;AAClE,SAAO,KAAK,MAAM,OAAO,SAAS,OAAO,CAAC;AAC5C;;;ACDO,SAAS,MAAM,OAAe,YAAoB,GAAW;AAClE,QAAM,aAAa,KAAK,IAAI,IAAI,SAAS;AACzC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;;;ACLO,SAAS,IAAI,MAAwB;AAC1C,MAAI,SAAS;AAEb,aAAW,OAAO,MAAM;AACtB,cAAU;AAAA,EACZ;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../src/math/index.ts","../../src/math/clamp.ts","../../src/math/random.ts","../../src/math/randomInt.ts","../../src/math/round.ts","../../src/math/sum.ts","../../src/math/range.ts"],"sourcesContent":["export { clamp } from './clamp';\nexport { random } from './random';\nexport { randomInt } from './randomInt';\nexport { round } from './round';\nexport { sum } from './sum';\nexport { range } from './range';\n","/**\n * Clamps a number within the inclusive lower and upper bounds.\n *\n * This function takes a number and two bounds, and returns the number clamped within the specified bounds.\n * If only one bound is provided, it returns the minimum of the value and the bound.\n *\n * @param {number} value - The number to clamp.\n * @param {number} minimum - The minimum bound to clamp the number.\n * @param {number} maximum - The maximum bound to clamp the number.\n * @returns {number} The clamped number within the specified bounds.\n *\n * @example\n * const result1 = clamp(10, 5); // result1 will be 5, as 10 is clamped to the bound 5\n * const result2 = clamp(10, 5, 15); // result2 will be 10, as it is within the bounds 5 and 15\n * const result3 = clamp(2, 5, 15); // result3 will be 5, as 2 is clamped to the lower bound 5\n * const result4 = clamp(20, 5, 15); // result4 will be 15, as 20 is clamped to the upper bound 15\n */\nexport function clamp(value: number, maximum: number): number;\nexport function clamp(value: number, minimum: number, maximum: number): number;\nexport function clamp(value: number, bound1: number, bound2?: number): number {\n  if (bound2 == null) {\n    return Math.min(value, bound1);\n  }\n\n  return Math.min(Math.max(value, bound1), bound2);\n}\n","/**\n * Generate a random number within the given range.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result1 = random(0, 5); // Returns a random number between 0 and 5.\n * const result2 = random(5, 0); // If the minimum is greater than the maximum, an error is thrown\n * const result3 = random(5, 5); // If the minimum is equal to the maximum, an error is thrown.\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n","import { random } from './random';\n\n/**\n * Generates a random integer between minimum (inclusive) and maximum (exclusive).\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = randomInt(0, 5); // result will be a random integer between 0 (inclusive) and 5 (exclusive)\n * const result2 = randomInt(5, 0); // This will throw an error\n */\nexport function randomInt(minimum: number, maximum: number): number {\n  return Math.floor(random(minimum, maximum));\n}\n","/**\n * Rounds a number to a specified precision.\n *\n * This function takes a number and an optional precision value, and returns the number rounded\n * to the specified number of decimal places.\n *\n * @param {number} value - The number to round.\n * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.\n * @returns {number} The rounded number.\n * @throws {Error} Throws an error if `Precision` is not integer.\n *\n * @example\n * const result1 = round(1.2345); // result1 will be 1\n * const result2 = round(1.2345, 2); // result2 will be 1.23\n * const result3 = round(1.2345, 3); // result3 will be 1.235\n * const result4 = round(1.2345, 3.1); // This will throw an error\n */\nexport function round(value: number, precision = 0): number {\n  if (!Number.isInteger(precision)) {\n    throw new Error('Precision must be an integer.');\n  }\n  const multiplier = Math.pow(10, precision);\n  return Math.round(value * multiplier) / multiplier;\n}\n","/**\n * Calculates the sum of an array of numbers.\n *\n * This function takes an array of numbers and returns the sum of all the elements in the array.\n *\n * @param {number[]} nums - An array of numbers to be summed.\n * @returns {number} The sum of all the numbers in the array.\n *\n * @example\n * const numbers = [1, 2, 3, 4, 5];\n * const result = sum(numbers);\n * // result will be 15\n */\nexport function sum(nums: number[]): number {\n  let result = 0;\n\n  for (const num of nums) {\n    result += num;\n  }\n\n  return result;\n}\n","/**\n * Returns an array of numbers from `start` to `end`, incrementing by `step`.\n *\n * If `step` is not provided, it defaults to `1` for an\n * ascending range and `-1` for a descending range.\n *\n * @param {number} start - The starting number of the range.\n * @param {number} [end] - The end number of the range.\n * @param {number} [step] - The step value for the range.\n * @returns {number[]} An array of numbers from `start` to `end` with the specified `step`.\n *\n * @example\n * // Returns [0, 1, 2, 3]\n * range(4);\n *\n * @example\n * // Returns [0, 5, 10, 15]\n * range(0, 20, 5);\n *\n * @example\n * // Returns []\n * range(0, -4, -1);\n *\n * @example\n * // Throws an error: The step value must be a non-zero integer.\n * range(1, 4, 0);\n */\nexport function range(end: number): number[];\nexport function range(start: number, end: number): number[];\nexport function range(start: number, end: number, step: number): number[];\nexport function range(start: number, end?: number, step?: number): number[] {\n  if (end == null) {\n    end = start;\n    start = 0;\n  }\n\n  if (step == null) {\n    step = 1;\n  }\n\n  if (!Number.isInteger(step) || step === 0) {\n    throw new Error(`The step value must be a non-zero integer.`);\n  }\n\n  const length = Math.max(Math.ceil((end - start) / step), 0);\n  const result = new Array(length);\n\n  for (let i = 0; i < length; i++) {\n    result[i] = start + i * step;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACmBO,SAAS,MAAM,OAAe,QAAgB,QAAyB;AAC5E,MAAI,UAAU,MAAM;AAClB,WAAO,KAAK,IAAI,OAAO,MAAM;AAAA,EAC/B;AAEA,SAAO,KAAK,IAAI,KAAK,IAAI,OAAO,MAAM,GAAG,MAAM;AACjD;;;ACZO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;;;ACLO,SAAS,UAAU,SAAiB,SAAyB;AAClE,SAAO,KAAK,MAAM,OAAO,SAAS,OAAO,CAAC;AAC5C;;;ACCO,SAAS,MAAM,OAAe,YAAY,GAAW;AAC1D,MAAI,CAAC,OAAO,UAAU,SAAS,GAAG;AAChC,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AACA,QAAM,aAAa,KAAK,IAAI,IAAI,SAAS;AACzC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;;;ACVO,SAAS,IAAI,MAAwB;AAC1C,MAAI,SAAS;AAEb,aAAW,OAAO,MAAM;AACtB,cAAU;AAAA,EACZ;AAEA,SAAO;AACT;;;ACSO,SAAS,MAAM,OAAe,KAAc,MAAyB;AAC1E,MAAI,OAAO,MAAM;AACf,UAAM;AACN,YAAQ;AAAA,EACV;AAEA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,SAAS,GAAG;AACzC,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,SAAS,KAAK,IAAI,KAAK,MAAM,MAAM,SAAS,IAAI,GAAG,CAAC;AAC1D,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,WAAO,CAAC,IAAI,QAAQ,IAAI;AAAA,EAC1B;AAEA,SAAO;AACT;","names":[]}

package/dist/math/index.mjs

@@ -1,24 +1,28 @@
-import "../chunk-VAV4XHLO.mjs";
+import "../chunk-7LAMAYGN.mjs";
+import {
+  clamp
+} from "../chunk-MLCL773E.mjs";
 import {
   randomInt
-} from "../chunk-QWJDITYJ.mjs";
+} from "../chunk-5UT77WON.mjs";
 import {
   random
-} from "../chunk-UGFVAAVO.mjs";
+} from "../chunk-LCP6FOCX.mjs";
+import {
+  range
+} from "../chunk-UNLX2F2Y.mjs";
 import {
   round
-} from "../chunk-V7E5DGZP.mjs";
+} from "../chunk-5PMKOZ2F.mjs";
 import {
   sum
 } from "../chunk-7OU22ENP.mjs";
-import {
-  clamp
-} from "../chunk-MLCL773E.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   clamp,
   random,
   randomInt,
+  range,
   round,
   sum
 };

package/dist/math/random.d.mts

@@ -1,15 +1,15 @@
 /**
- * Generates a random floating-point number between minimum (inclusive) and maximum (exclusive).
- * If min is greater than maximum, the values are swapped.
+ * Generate a random number within the given range.
  *
  * @param {number} minimum - The lower bound (inclusive).
  * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).
+ * @returns {number} A random number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
  * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
  *
  * @example
- * const result = random(0, 5); // result will be a random floating-point number between 0 (inclusive) and 5 (exclusive)
- * const result2 = random(5, 0); // This will throw an error
+ * const result1 = random(0, 5); // Returns a random number between 0 and 5.
+ * const result2 = random(5, 0); // If the minimum is greater than the maximum, an error is thrown
+ * const result3 = random(5, 5); // If the minimum is equal to the maximum, an error is thrown.
  */
 declare function random(minimum: number, maximum: number): number;
 

package/dist/math/random.d.ts

@@ -1,15 +1,15 @@
 /**
- * Generates a random floating-point number between minimum (inclusive) and maximum (exclusive).
- * If min is greater than maximum, the values are swapped.
+ * Generate a random number within the given range.
  *
  * @param {number} minimum - The lower bound (inclusive).
  * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).
+ * @returns {number} A random number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
  * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
  *
  * @example
- * const result = random(0, 5); // result will be a random floating-point number between 0 (inclusive) and 5 (exclusive)
- * const result2 = random(5, 0); // This will throw an error
+ * const result1 = random(0, 5); // Returns a random number between 0 and 5.
+ * const result2 = random(5, 0); // If the minimum is greater than the maximum, an error is thrown
+ * const result3 = random(5, 5); // If the minimum is equal to the maximum, an error is thrown.
  */
 declare function random(minimum: number, maximum: number): number;
 

package/dist/math/random.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/math/random.ts"],"sourcesContent":["/**\n * Generates a random floating-point number between minimum (inclusive) and maximum (exclusive).\n * If min is greater than maximum, the values are swapped.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = random(0, 5); // result will be a random floating-point number between 0 (inclusive) and 5 (exclusive)\n * const result2 = random(5, 0); // This will throw an error\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;","names":[]}
+{"version":3,"sources":["../../src/math/random.ts"],"sourcesContent":["/**\n * Generate a random number within the given range.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result1 = random(0, 5); // Returns a random number between 0 and 5.\n * const result2 = random(5, 0); // If the minimum is greater than the maximum, an error is thrown\n * const result3 = random(5, 5); // If the minimum is equal to the maximum, an error is thrown.\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;","names":[]}

package/dist/math/random.mjs

@@ -1,6 +1,6 @@
 import {
   random
-} from "../chunk-UGFVAAVO.mjs";
+} from "../chunk-LCP6FOCX.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   random

package/dist/math/randomInt.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/math/randomInt.ts","../../src/math/random.ts"],"sourcesContent":["import { random } from './random';\n\n/**\n * Generates a random integer between minimum (inclusive) and maximum (exclusive).\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = randomInt(0, 5); // result will be a random integer between 0 (inclusive) and 5 (exclusive)\n * const result2 = randomInt(5, 0); // This will throw an error\n */\nexport function randomInt(minimum: number, maximum: number): number {\n  return Math.floor(random(minimum, maximum));\n}\n","/**\n * Generates a random floating-point number between minimum (inclusive) and maximum (exclusive).\n * If min is greater than maximum, the values are swapped.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = random(0, 5); // result will be a random floating-point number between 0 (inclusive) and 5 (exclusive)\n * const result2 = random(5, 0); // This will throw an error\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;;;ADLO,SAAS,UAAU,SAAiB,SAAyB;AAClE,SAAO,KAAK,MAAM,OAAO,SAAS,OAAO,CAAC;AAC5C;","names":[]}
+{"version":3,"sources":["../../src/math/randomInt.ts","../../src/math/random.ts"],"sourcesContent":["import { random } from './random';\n\n/**\n * Generates a random integer between minimum (inclusive) and maximum (exclusive).\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random integer between minimum (inclusive) and maximum (exclusive).\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result = randomInt(0, 5); // result will be a random integer between 0 (inclusive) and 5 (exclusive)\n * const result2 = randomInt(5, 0); // This will throw an error\n */\nexport function randomInt(minimum: number, maximum: number): number {\n  return Math.floor(random(minimum, maximum));\n}\n","/**\n * Generate a random number within the given range.\n *\n * @param {number} minimum - The lower bound (inclusive).\n * @param {number} maximum - The upper bound (exclusive).\n * @returns {number} A random number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.\n * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.\n *\n * @example\n * const result1 = random(0, 5); // Returns a random number between 0 and 5.\n * const result2 = random(5, 0); // If the minimum is greater than the maximum, an error is thrown\n * const result3 = random(5, 5); // If the minimum is equal to the maximum, an error is thrown.\n */\nexport function random(minimum: number, maximum: number): number {\n  if (minimum >= maximum) {\n    throw new Error('Invalid input: The maximum value must be greater than the minimum value.');\n  }\n\n  return Math.random() * (maximum - minimum) + minimum;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACaO,SAAS,OAAO,SAAiB,SAAyB;AAC/D,MAAI,WAAW,SAAS;AACtB,UAAM,IAAI,MAAM,0EAA0E;AAAA,EAC5F;AAEA,SAAO,KAAK,OAAO,KAAK,UAAU,WAAW;AAC/C;;;ADLO,SAAS,UAAU,SAAiB,SAAyB;AAClE,SAAO,KAAK,MAAM,OAAO,SAAS,OAAO,CAAC;AAC5C;","names":[]}

package/dist/math/randomInt.mjs

@@ -1,7 +1,7 @@
 import {
   randomInt
-} from "../chunk-QWJDITYJ.mjs";
-import "../chunk-UGFVAAVO.mjs";
+} from "../chunk-5UT77WON.mjs";
+import "../chunk-LCP6FOCX.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   randomInt

package/dist/math/range.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Returns an array of numbers from `start` to `end`, incrementing by `step`.
+ *
+ * If `step` is not provided, it defaults to `1` for an
+ * ascending range and `-1` for a descending range.
+ *
+ * @param {number} start - The starting number of the range.
+ * @param {number} [end] - The end number of the range.
+ * @param {number} [step] - The step value for the range.
+ * @returns {number[]} An array of numbers from `start` to `end` with the specified `step`.
+ *
+ * @example
+ * // Returns [0, 1, 2, 3]
+ * range(4);
+ *
+ * @example
+ * // Returns [0, 5, 10, 15]
+ * range(0, 20, 5);
+ *
+ * @example
+ * // Returns []
+ * range(0, -4, -1);
+ *
+ * @example
+ * // Throws an error: The step value must be a non-zero integer.
+ * range(1, 4, 0);
+ */
+declare function range(end: number): number[];
+declare function range(start: number, end: number): number[];
+declare function range(start: number, end: number, step: number): number[];
+
+export { range };

package/dist/math/range.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Returns an array of numbers from `start` to `end`, incrementing by `step`.
+ *
+ * If `step` is not provided, it defaults to `1` for an
+ * ascending range and `-1` for a descending range.
+ *
+ * @param {number} start - The starting number of the range.
+ * @param {number} [end] - The end number of the range.
+ * @param {number} [step] - The step value for the range.
+ * @returns {number[]} An array of numbers from `start` to `end` with the specified `step`.
+ *
+ * @example
+ * // Returns [0, 1, 2, 3]
+ * range(4);
+ *
+ * @example
+ * // Returns [0, 5, 10, 15]
+ * range(0, 20, 5);
+ *
+ * @example
+ * // Returns []
+ * range(0, -4, -1);
+ *
+ * @example
+ * // Throws an error: The step value must be a non-zero integer.
+ * range(1, 4, 0);
+ */
+declare function range(end: number): number[];
+declare function range(start: number, end: number): number[];
+declare function range(start: number, end: number, step: number): number[];
+
+export { range };

package/dist/math/range.js

@@ -0,0 +1,48 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/math/range.ts
+var range_exports = {};
+__export(range_exports, {
+  range: () => range
+});
+module.exports = __toCommonJS(range_exports);
+function range(start, end, step) {
+  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.`);
+  }
+  const length = Math.max(Math.ceil((end - start) / step), 0);
+  const result = new Array(length);
+  for (let i = 0; i < length; i++) {
+    result[i] = start + i * step;
+  }
+  return result;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  range
+});
+//# sourceMappingURL=range.js.map

package/dist/math/range.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/math/range.ts"],"sourcesContent":["/**\n * Returns an array of numbers from `start` to `end`, incrementing by `step`.\n *\n * If `step` is not provided, it defaults to `1` for an\n * ascending range and `-1` for a descending range.\n *\n * @param {number} start - The starting number of the range.\n * @param {number} [end] - The end number of the range.\n * @param {number} [step] - The step value for the range.\n * @returns {number[]} An array of numbers from `start` to `end` with the specified `step`.\n *\n * @example\n * // Returns [0, 1, 2, 3]\n * range(4);\n *\n * @example\n * // Returns [0, 5, 10, 15]\n * range(0, 20, 5);\n *\n * @example\n * // Returns []\n * range(0, -4, -1);\n *\n * @example\n * // Throws an error: The step value must be a non-zero integer.\n * range(1, 4, 0);\n */\nexport function range(end: number): number[];\nexport function range(start: number, end: number): number[];\nexport function range(start: number, end: number, step: number): number[];\nexport function range(start: number, end?: number, step?: number): number[] {\n  if (end == null) {\n    end = start;\n    start = 0;\n  }\n\n  if (step == null) {\n    step = 1;\n  }\n\n  if (!Number.isInteger(step) || step === 0) {\n    throw new Error(`The step value must be a non-zero integer.`);\n  }\n\n  const length = Math.max(Math.ceil((end - start) / step), 0);\n  const result = new Array(length);\n\n  for (let i = 0; i < length; i++) {\n    result[i] = start + i * step;\n  }\n\n  return result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA8BO,SAAS,MAAM,OAAe,KAAc,MAAyB;AAC1E,MAAI,OAAO,MAAM;AACf,UAAM;AACN,YAAQ;AAAA,EACV;AAEA,MAAI,QAAQ,MAAM;AAChB,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,OAAO,UAAU,IAAI,KAAK,SAAS,GAAG;AACzC,UAAM,IAAI,MAAM,4CAA4C;AAAA,EAC9D;AAEA,QAAM,SAAS,KAAK,IAAI,KAAK,MAAM,MAAM,SAAS,IAAI,GAAG,CAAC;AAC1D,QAAM,SAAS,IAAI,MAAM,MAAM;AAE/B,WAAS,IAAI,GAAG,IAAI,QAAQ,KAAK;AAC/B,WAAO,CAAC,IAAI,QAAQ,IAAI;AAAA,EAC1B;AAEA,SAAO;AACT;","names":[]}

package/dist/math/range.mjs

@@ -0,0 +1,8 @@
+import {
+  range
+} from "../chunk-UNLX2F2Y.mjs";
+import "../chunk-2MM5EJJX.mjs";
+export {
+  range
+};
+//# sourceMappingURL=range.mjs.map

package/dist/math/range.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/math/round.d.mts

@@ -7,11 +7,13 @@
  * @param {number} value - The number to round.
  * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.
  * @returns {number} The rounded number.
+ * @throws {Error} Throws an error if `Precision` is not integer.
  *
  * @example
  * const result1 = round(1.2345); // result1 will be 1
  * const result2 = round(1.2345, 2); // result2 will be 1.23
  * const result3 = round(1.2345, 3); // result3 will be 1.235
+ * const result4 = round(1.2345, 3.1); // This will throw an error
  */
 declare function round(value: number, precision?: number): number;
 

package/dist/math/round.d.ts

@@ -7,11 +7,13 @@
  * @param {number} value - The number to round.
  * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.
  * @returns {number} The rounded number.
+ * @throws {Error} Throws an error if `Precision` is not integer.
  *
  * @example
  * const result1 = round(1.2345); // result1 will be 1
  * const result2 = round(1.2345, 2); // result2 will be 1.23
  * const result3 = round(1.2345, 3); // result3 will be 1.235
+ * const result4 = round(1.2345, 3.1); // This will throw an error
  */
 declare function round(value: number, precision?: number): number;
 

package/dist/math/round.js

@@ -24,6 +24,9 @@ __export(round_exports, {
 });
 module.exports = __toCommonJS(round_exports);
 function round(value, precision = 0) {
+  if (!Number.isInteger(precision)) {
+    throw new Error("Precision must be an integer.");
+  }
   const multiplier = Math.pow(10, precision);
   return Math.round(value * multiplier) / multiplier;
 }

package/dist/math/round.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/math/round.ts"],"sourcesContent":["/**\n * Rounds a number to a specified precision.\n *\n * This function takes a number and an optional precision value, and returns the number rounded\n * to the specified number of decimal places.\n *\n * @param {number} value - The number to round.\n * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.\n * @returns {number} The rounded number.\n *\n * @example\n * const result1 = round(1.2345); // result1 will be 1\n * const result2 = round(1.2345, 2); // result2 will be 1.23\n * const result3 = round(1.2345, 3); // result3 will be 1.235\n */\nexport function round(value: number, precision: number = 0): number {\n  const multiplier = Math.pow(10, precision);\n  return Math.round(value * multiplier) / multiplier;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAeO,SAAS,MAAM,OAAe,YAAoB,GAAW;AAClE,QAAM,aAAa,KAAK,IAAI,IAAI,SAAS;AACzC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;","names":[]}
+{"version":3,"sources":["../../src/math/round.ts"],"sourcesContent":["/**\n * Rounds a number to a specified precision.\n *\n * This function takes a number and an optional precision value, and returns the number rounded\n * to the specified number of decimal places.\n *\n * @param {number} value - The number to round.\n * @param {number} [precision=0] - The number of decimal places to round to. Defaults to 0.\n * @returns {number} The rounded number.\n * @throws {Error} Throws an error if `Precision` is not integer.\n *\n * @example\n * const result1 = round(1.2345); // result1 will be 1\n * const result2 = round(1.2345, 2); // result2 will be 1.23\n * const result3 = round(1.2345, 3); // result3 will be 1.235\n * const result4 = round(1.2345, 3.1); // This will throw an error\n */\nexport function round(value: number, precision = 0): number {\n  if (!Number.isInteger(precision)) {\n    throw new Error('Precision must be an integer.');\n  }\n  const multiplier = Math.pow(10, precision);\n  return Math.round(value * multiplier) / multiplier;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAiBO,SAAS,MAAM,OAAe,YAAY,GAAW;AAC1D,MAAI,CAAC,OAAO,UAAU,SAAS,GAAG;AAChC,UAAM,IAAI,MAAM,+BAA+B;AAAA,EACjD;AACA,QAAM,aAAa,KAAK,IAAI,IAAI,SAAS;AACzC,SAAO,KAAK,MAAM,QAAQ,UAAU,IAAI;AAC1C;","names":[]}

package/dist/math/round.mjs

@@ -1,6 +1,6 @@
 import {
   round
-} from "../chunk-V7E5DGZP.mjs";
+} from "../chunk-5PMKOZ2F.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   round