es-toolkit 1.47.0-dev.1841 → 1.47.0-dev.1842

package/dist/math/median.mjs

@@ -8,8 +8,8 @@
 *
 * If the array is empty, this function returns `NaN`.
 *
-* @param {number[]} nums - An array of numbers to calculate the median.
-* @returns {number} The median of all the numbers in the array.
+* @param nums - An array of numbers to calculate the median.
+* @returns The median of all the numbers in the array.
 *
 * @example
 * const arrayWithOddNumberOfElements = [1, 2, 3, 4, 5];

package/dist/math/medianBy.d.mts

@@ -10,9 +10,9 @@
  * If the array is empty, this function returns `NaN`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} items An array to calculate the median.
- * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {number} The median of all the numbers as determined by the `getValue` function.
+ * @param items An array to calculate the median.
+ * @param getValue A function that selects a numeric value from each element.
+ * @returns The median of all the numbers as determined by the `getValue` function.
  *
  * @example
  * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3

package/dist/math/medianBy.d.ts

@@ -10,9 +10,9 @@
  * If the array is empty, this function returns `NaN`.
  *
  * @template T - The type of elements in the array.
- * @param {T[]} items An array to calculate the median.
- * @param {(element: T) => number} getValue A function that selects a numeric value from each element.
- * @returns {number} The median of all the numbers as determined by the `getValue` function.
+ * @param items An array to calculate the median.
+ * @param getValue A function that selects a numeric value from each element.
+ * @returns The median of all the numbers as determined by the `getValue` function.
  *
  * @example
  * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3

package/dist/math/medianBy.js

@@ -11,9 +11,9 @@ const require_median = require("./median.js");
 * If the array is empty, this function returns `NaN`.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} items An array to calculate the median.
-* @param {(element: T) => number} getValue A function that selects a numeric value from each element.
-* @returns {number} The median of all the numbers as determined by the `getValue` function.
+* @param items An array to calculate the median.
+* @param getValue A function that selects a numeric value from each element.
+* @returns The median of all the numbers as determined by the `getValue` function.
 *
 * @example
 * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3

package/dist/math/medianBy.mjs

@@ -11,9 +11,9 @@ import { median } from "./median.mjs";
 * If the array is empty, this function returns `NaN`.
 *
 * @template T - The type of elements in the array.
-* @param {T[]} items An array to calculate the median.
-* @param {(element: T) => number} getValue A function that selects a numeric value from each element.
-* @returns {number} The median of all the numbers as determined by the `getValue` function.
+* @param items An array to calculate the median.
+* @param getValue A function that selects a numeric value from each element.
+* @returns The median of all the numbers as determined by the `getValue` function.
 *
 * @example
 * medianBy([{ a: 1 }, { a: 2 }, { a: 3 }, { a: 4 }, { a: 5 }], x => x.a); // Returns: 3

package/dist/math/percentile.d.mts

@@ -7,9 +7,9 @@
  *
  * `NaN` values are sorted as the smallest values. Returns `NaN` if the array is empty.
  *
- * @param {readonly number[]} arr - An array of numbers to calculate the percentile.
- * @param {number} percentile - The percentile to compute, in the range `[0, 100]`.
- * @returns {number} The value at the given percentile.
+ * @param arr - An array of numbers to calculate the percentile.
+ * @param percentile - The percentile to compute, in the range `[0, 100]`.
+ * @returns The value at the given percentile.
  * @throws {Error} Throws an error if `percentile` is not a number, less than `0`, or greater than `100`.
  *
  * @example

package/dist/math/percentile.d.ts

@@ -7,9 +7,9 @@
  *
  * `NaN` values are sorted as the smallest values. Returns `NaN` if the array is empty.
  *
- * @param {readonly number[]} arr - An array of numbers to calculate the percentile.
- * @param {number} percentile - The percentile to compute, in the range `[0, 100]`.
- * @returns {number} The value at the given percentile.
+ * @param arr - An array of numbers to calculate the percentile.
+ * @param percentile - The percentile to compute, in the range `[0, 100]`.
+ * @returns The value at the given percentile.
  * @throws {Error} Throws an error if `percentile` is not a number, less than `0`, or greater than `100`.
  *
  * @example

package/dist/math/percentile.js

@@ -7,9 +7,9 @@
 *
 * `NaN` values are sorted as the smallest values. Returns `NaN` if the array is empty.
 *
-* @param {readonly number[]} arr - An array of numbers to calculate the percentile.
-* @param {number} percentile - The percentile to compute, in the range `[0, 100]`.
-* @returns {number} The value at the given percentile.
+* @param arr - An array of numbers to calculate the percentile.
+* @param percentile - The percentile to compute, in the range `[0, 100]`.
+* @returns The value at the given percentile.
 * @throws {Error} Throws an error if `percentile` is not a number, less than `0`, or greater than `100`.
 *
 * @example

package/dist/math/percentile.mjs

@@ -7,9 +7,9 @@
 *
 * `NaN` values are sorted as the smallest values. Returns `NaN` if the array is empty.
 *
-* @param {readonly number[]} arr - An array of numbers to calculate the percentile.
-* @param {number} percentile - The percentile to compute, in the range `[0, 100]`.
-* @returns {number} The value at the given percentile.
+* @param arr - An array of numbers to calculate the percentile.
+* @param percentile - The percentile to compute, in the range `[0, 100]`.
+* @returns The value at the given percentile.
 * @throws {Error} Throws an error if `percentile` is not a number, less than `0`, or greater than `100`.
 *
 * @example

package/dist/math/random.d.mts

@@ -4,8 +4,8 @@
  *
  * If only one argument is provided, a number between `0` and the given number is returned.
  *
- * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random number between 0 (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random number between 0 (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
  * @throws {Error} Throws an error if `maximum` is not greater than `0`.
  *
  * @example
@@ -16,9 +16,9 @@ declare function random(maximum: number): number;
 /**
  * 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 number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+ * @param minimum - The lower bound (inclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns 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

package/dist/math/random.d.ts

@@ -4,8 +4,8 @@
  *
  * If only one argument is provided, a number between `0` and the given number is returned.
  *
- * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random number between 0 (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random number between 0 (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
  * @throws {Error} Throws an error if `maximum` is not greater than `0`.
  *
  * @example
@@ -16,9 +16,9 @@ declare function random(maximum: number): number;
 /**
  * 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 number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+ * @param minimum - The lower bound (inclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns 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

package/dist/math/random.js

@@ -2,9 +2,9 @@
 /**
 * 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 number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+* @param minimum - The lower bound (inclusive).
+* @param maximum - The upper bound (exclusive).
+* @returns 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

package/dist/math/random.mjs

@@ -2,9 +2,9 @@
 /**
 * 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 number between minimum (inclusive) and maximum (exclusive). The number can be an integer or a decimal.
+* @param minimum - The lower bound (inclusive).
+* @param maximum - The upper bound (exclusive).
+* @returns 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

package/dist/math/randomInt.d.mts

@@ -2,8 +2,8 @@
 /**
  * Generates a random integer between 0 (inclusive) and the given maximum (exclusive).
  *
- * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random integer between 0 (inclusive) and maximum (exclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random integer between 0 (inclusive) and maximum (exclusive).
  * @throws {Error} Throws an error if `maximum` is not greater than `0`.
  *
  * @example
@@ -13,9 +13,9 @@ declare function randomInt(maximum: number): number;
 /**
  * Generates a random integer between minimum (inclusive) and maximum (exclusive).
  *
- * @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).
+ * @param minimum - The lower bound (inclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random integer between minimum (inclusive) and maximum (exclusive).
  * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
  *
  * @example

package/dist/math/randomInt.d.ts

@@ -2,8 +2,8 @@
 /**
  * Generates a random integer between 0 (inclusive) and the given maximum (exclusive).
  *
- * @param {number} maximum - The upper bound (exclusive).
- * @returns {number} A random integer between 0 (inclusive) and maximum (exclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random integer between 0 (inclusive) and maximum (exclusive).
  * @throws {Error} Throws an error if `maximum` is not greater than `0`.
  *
  * @example
@@ -13,9 +13,9 @@ declare function randomInt(maximum: number): number;
 /**
  * Generates a random integer between minimum (inclusive) and maximum (exclusive).
  *
- * @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).
+ * @param minimum - The lower bound (inclusive).
+ * @param maximum - The upper bound (exclusive).
+ * @returns A random integer between minimum (inclusive) and maximum (exclusive).
  * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
  *
  * @example

package/dist/math/randomInt.js

@@ -5,9 +5,9 @@ const require_random = require("./random.js");
 *
 * If only one argument is provided, a number between `0` and the given number is returned.
 *
-* @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).
+* @param minimum - The lower bound (inclusive).
+* @param maximum - The upper bound (exclusive).
+* @returns A random integer between minimum (inclusive) and maximum (exclusive).
 * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
 *
 * @example

package/dist/math/randomInt.mjs

@@ -5,9 +5,9 @@ import { random } from "./random.mjs";
 *
 * If only one argument is provided, a number between `0` and the given number is returned.
 *
-* @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).
+* @param minimum - The lower bound (inclusive).
+* @param maximum - The upper bound (exclusive).
+* @returns A random integer between minimum (inclusive) and maximum (exclusive).
 * @throws {Error} Throws an error if `maximum` is not greater than `minimum`.
 *
 * @example

package/dist/math/range.d.mts

@@ -2,8 +2,8 @@
 /**
  * Returns an array of numbers from `0` (inclusive) to `end` (exclusive), incrementing by `1`.
  *
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
  *
  * @example
  * // Returns [0, 1, 2, 3]
@@ -13,9 +13,9 @@ declare function range(end: number): number[];
 /**
  * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `1`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
  *
  * @example
  * // Returns [1, 2, 3]
@@ -25,10 +25,10 @@ declare function range(start: number, end: number): number[];
 /**
  * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @param {number} step - The step value for the range.
- * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @param step - The step value for the range.
+ * @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
  *
  * @example
  * // Returns [0, 5, 10, 15]

package/dist/math/range.d.ts

@@ -2,8 +2,8 @@
 /**
  * Returns an array of numbers from `0` (inclusive) to `end` (exclusive), incrementing by `1`.
  *
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
  *
  * @example
  * // Returns [0, 1, 2, 3]
@@ -13,9 +13,9 @@ declare function range(end: number): number[];
 /**
  * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `1`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
  *
  * @example
  * // Returns [1, 2, 3]
@@ -25,10 +25,10 @@ declare function range(start: number, end: number): number[];
 /**
  * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @param {number} step - The step value for the range.
- * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @param step - The step value for the range.
+ * @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
  *
  * @example
  * // Returns [0, 5, 10, 15]

package/dist/math/range.js

@@ -2,10 +2,10 @@
 /**
 * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
 *
-* @param {number} start - The starting number of the range (inclusive).
-* @param {number} end - The end number of the range (exclusive).
-* @param {number} step - The step value for the range.
-* @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+* @param start - The starting number of the range (inclusive).
+* @param end - The end number of the range (exclusive).
+* @param step - The step value for the range.
+* @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
 * @throws {Error} Throws an error if the step value is not a non-zero integer.
 *
 * @example

package/dist/math/range.mjs

@@ -2,10 +2,10 @@
 /**
 * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
 *
-* @param {number} start - The starting number of the range (inclusive).
-* @param {number} end - The end number of the range (exclusive).
-* @param {number} step - The step value for the range.
-* @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+* @param start - The starting number of the range (inclusive).
+* @param end - The end number of the range (exclusive).
+* @param step - The step value for the range.
+* @returns An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
 * @throws {Error} Throws an error if the step value is not a non-zero integer.
 *
 * @example

package/dist/math/rangeRight.d.mts

@@ -2,8 +2,8 @@
 /**
  * Returns an array of numbers from `end` (exclusive) to `0` (inclusive), decrementing by `1`.
  *
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
  *
  * @example
  * // Returns [3, 2, 1, 0]
@@ -13,9 +13,9 @@ declare function rangeRight(end: number): number[];
 /**
  * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `1`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
  *
  * @example
  * // Returns [3, 2, 1]
@@ -25,10 +25,10 @@ declare function rangeRight(start: number, end: number): number[];
 /**
  * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @param {number} step - The step value for the range.
- * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @param step - The step value for the range.
+ * @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
  *
  * @example
  * // Returns [15, 10, 5, 0]

package/dist/math/rangeRight.d.ts

@@ -2,8 +2,8 @@
 /**
  * Returns an array of numbers from `end` (exclusive) to `0` (inclusive), decrementing by `1`.
  *
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
  *
  * @example
  * // Returns [3, 2, 1, 0]
@@ -13,9 +13,9 @@ declare function rangeRight(end: number): number[];
 /**
  * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `1`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
  *
  * @example
  * // Returns [3, 2, 1]
@@ -25,10 +25,10 @@ declare function rangeRight(start: number, end: number): number[];
 /**
  * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
  *
- * @param {number} start - The starting number of the range (inclusive).
- * @param {number} end - The end number of the range (exclusive).
- * @param {number} step - The step value for the range.
- * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+ * @param start - The starting number of the range (inclusive).
+ * @param end - The end number of the range (exclusive).
+ * @param step - The step value for the range.
+ * @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
  *
  * @example
  * // Returns [15, 10, 5, 0]

package/dist/math/rangeRight.js

@@ -2,10 +2,10 @@
 /**
 * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
 *
-* @param {number} start - The starting number of the range (inclusive).
-* @param {number} end - The end number of the range (exclusive).
-* @param {number} step - The step value for the range.
-* @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+* @param start - The starting number of the range (inclusive).
+* @param end - The end number of the range (exclusive).
+* @param step - The step value for the range.
+* @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
 * @throws {Error} Throws an error if the step value is not a non-zero integer.
 *
 * @example

package/dist/math/rangeRight.mjs

@@ -2,10 +2,10 @@
 /**
 * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
 *
-* @param {number} start - The starting number of the range (inclusive).
-* @param {number} end - The end number of the range (exclusive).
-* @param {number} step - The step value for the range.
-* @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+* @param start - The starting number of the range (inclusive).
+* @param end - The end number of the range (exclusive).
+* @param step - The step value for the range.
+* @returns An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
 * @throws {Error} Throws an error if the step value is not a non-zero integer.
 *
 * @example

package/dist/math/round.d.mts

@@ -5,9 +5,9 @@
  * This function takes a number and an optional precision value, and returns the number rounded
  * to the specified number of decimal places.
  *
- * @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.
+ * @param value - The number to round.
+ * @param [precision=0] - The number of decimal places to round to. Defaults to 0.
+ * @returns The rounded number.
  * @throws {Error} Throws an error if `Precision` is not integer.
  *
  * @example

package/dist/math/round.d.ts

@@ -5,9 +5,9 @@
  * This function takes a number and an optional precision value, and returns the number rounded
  * to the specified number of decimal places.
  *
- * @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.
+ * @param value - The number to round.
+ * @param [precision=0] - The number of decimal places to round to. Defaults to 0.
+ * @returns The rounded number.
  * @throws {Error} Throws an error if `Precision` is not integer.
  *
  * @example

package/dist/math/round.js

@@ -5,9 +5,9 @@
 * This function takes a number and an optional precision value, and returns the number rounded
 * to the specified number of decimal places.
 *
-* @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.
+* @param value - The number to round.
+* @param [precision=0] - The number of decimal places to round to. Defaults to 0.
+* @returns The rounded number.
 * @throws {Error} Throws an error if `Precision` is not integer.
 *
 * @example

package/dist/math/round.mjs

@@ -5,9 +5,9 @@
 * This function takes a number and an optional precision value, and returns the number rounded
 * to the specified number of decimal places.
 *
-* @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.
+* @param value - The number to round.
+* @param [precision=0] - The number of decimal places to round to. Defaults to 0.
+* @returns The rounded number.
 * @throws {Error} Throws an error if `Precision` is not integer.
 *
 * @example

package/dist/math/sum.d.mts

@@ -4,8 +4,8 @@
  *
  * This function takes an array of numbers and returns the sum of all the elements in the array.
  *
- * @param {number[]} nums - An array of numbers to be summed.
- * @returns {number} The sum of all the numbers in the array.
+ * @param nums - An array of numbers to be summed.
+ * @returns The sum of all the numbers in the array.
  *
  * @example
  * const numbers = [1, 2, 3, 4, 5];

package/dist/math/sum.d.ts

@@ -4,8 +4,8 @@
  *
  * This function takes an array of numbers and returns the sum of all the elements in the array.
  *
- * @param {number[]} nums - An array of numbers to be summed.
- * @returns {number} The sum of all the numbers in the array.
+ * @param nums - An array of numbers to be summed.
+ * @returns The sum of all the numbers in the array.
  *
  * @example
  * const numbers = [1, 2, 3, 4, 5];

package/dist/math/sum.js

@@ -4,8 +4,8 @@
 *
 * This function takes an array of numbers and returns the sum of all the elements in the array.
 *
-* @param {number[]} nums - An array of numbers to be summed.
-* @returns {number} The sum of all the numbers in the array.
+* @param nums - An array of numbers to be summed.
+* @returns The sum of all the numbers in the array.
 *
 * @example
 * const numbers = [1, 2, 3, 4, 5];

package/dist/math/sum.mjs

@@ -4,8 +4,8 @@
 *
 * This function takes an array of numbers and returns the sum of all the elements in the array.
 *
-* @param {number[]} nums - An array of numbers to be summed.
-* @returns {number} The sum of all the numbers in the array.
+* @param nums - An array of numbers to be summed.
+* @returns The sum of all the numbers in the array.
 *
 * @example
 * const numbers = [1, 2, 3, 4, 5];

package/dist/math/sumBy.d.mts

@@ -6,10 +6,10 @@
  * If the array is empty, this function returns `0`.
  *
  * @template T - The type of elements in the array.
- * @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.
+ * @param items - An array to calculate the sum.
+ * @param 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.
+ * @returns The sum of all the numbers as determined by the `getValue` function.
  *
  * @example
  * sumBy([{ a: 1 }, { a: 2 }, { a: 3 }], (x, i) => x.a * i); // Returns: 8