nhb-toolbox 4.0.21 → 4.0.30

package/dist/esm/number/convert.js

@@ -5,7 +5,8 @@ import { _convertLessThanThousand } from './helpers';
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */
-export function numberToWords(number) {
+export function numberToWords(num) {
+    let number = Number(num);
     const isNegative = number < 0;
     if (number === 0)
         return 'zero';
@@ -31,7 +32,8 @@ export function numberToWords(number) {
  * @example convertToRomanNumerals(29) → "XXIX"
  */
 export const convertToRomanNumerals = (num) => {
-    if (num <= 0 || num >= 4000)
+    let number = Number(num);
+    if (number <= 0 || number >= 4000)
         throw new RangeError('Number must be between 1 and 3999');
     const romanMap = [
         [1000, 'M'],
@@ -50,9 +52,9 @@ export const convertToRomanNumerals = (num) => {
     ];
     let result = '';
     for (const [value, numeral] of romanMap) {
-        while (num >= value) {
+        while (number >= value) {
             result += numeral;
-            num -= value;
+            number -= value;
         }
     }
     return result;

package/dist/esm/number/fibonacci.js

@@ -0,0 +1,83 @@
+/**
+ * * Generates the first `limit` Fibonacci numbers.
+ *
+ * @param limit The number of Fibonacci numbers to generate.
+ * @returns An array containing the first `limit` Fibonacci numbers.
+ */
+export function getFibonacciSeries(limit) {
+    const cLimit = Number(limit);
+    if (!Number.isFinite(cLimit) || cLimit <= 0) {
+        return [];
+    }
+    if (cLimit === 1)
+        return [0];
+    const series = [0, 1];
+    for (let i = 2; i < cLimit; i++) {
+        series.push(series[i - 1] + series[i - 2]);
+    }
+    return series;
+}
+/**
+ * * Generates the first `limit` Fibonacci numbers using recursion with memoization.
+ *
+ * @param limit - The number of Fibonacci numbers to generate.
+ * @returns An array containing the first `limit` Fibonacci numbers.
+ */
+export function getFibonacciSeriesMemo(limit) {
+    const cLimit = Number(limit);
+    if (!Number.isFinite(cLimit) || cLimit <= 0)
+        return [];
+    if (cLimit === 1)
+        return [0];
+    const memo = new Map([
+        [0, 0],
+        [1, 1],
+    ]);
+    const fib = (n) => {
+        if (memo.has(n))
+            return memo.get(n);
+        const val = fib(n - 1) + fib(n - 2);
+        memo.set(n, val);
+        return val;
+    };
+    return Array.from({ length: cLimit }, (_, i) => fib(i));
+}
+/**
+ * * Generator function for Fibonacci sequence up to a given limit.
+ *
+ * @param limit - Number of Fibonacci numbers to generate.
+ * @param onYield - Optional callback triggered on each yield with the current value and index.
+ * @returns A generator yielding Fibonacci numbers one by one.
+ */
+export function* fibonacciGenerator(limit, onYield) {
+    const cLimit = Number(limit);
+    if (!Number.isFinite(cLimit) || cLimit < 0)
+        return;
+    let a = 0;
+    let b = 1;
+    for (let i = 0; i < cLimit; i++) {
+        onYield?.(a, i);
+        yield a;
+        [a, b] = [b, a + b];
+    }
+}
+/**
+ * * Calculates the `n`-th Fibonacci number using optimized space.
+ *
+ * @param index - The index (0-based) of the Fibonacci number.
+ * @returns The index=`n`-th Fibonacci number.
+ */
+export function getNthFibonacci(index) {
+    const n = Number(index);
+    if (!Number.isFinite(n) || n < 0)
+        return NaN;
+    if (n === 0)
+        return 0;
+    if (n === 1)
+        return 1;
+    let a = 0, b = 1;
+    for (let i = 2; i <= n; i++) {
+        [a, b] = [b, a + b];
+    }
+    return b;
+}

package/dist/esm/number/utilities.js

@@ -6,7 +6,9 @@ import { CURRENCY_LOCALES } from './constants';
  * @returns The number rounded to the nearest interval.
  * @example roundToNearest(27, 5) → 25
  */
-export const roundToNearest = (value, interval = 5) => Math.round(value / interval) * interval;
+export const roundToNearest = (value, interval = 5) => {
+    return Math.round(Number(value) / interval) * interval;
+};
 /**
  * * Formats a number as a currency string.
  * @param value - The number to format.
@@ -34,7 +36,9 @@ export const formatCurrency = (value, currency = 'USD', locale) => {
  * @example clampNumber(5, 10, 20) → 10
  * @example clampNumber(25, 10, 20) → 20
  */
-export const clampNumber = (value, min, max) => Math.max(min, Math.min(value, max));
+export const clampNumber = (value, min, max) => {
+    return Math.max(min, Math.min(value, max));
+};
 /**
  * * Generates a random floating-point number within a range.
  * @param min - The minimum value.
@@ -43,7 +47,7 @@ export const clampNumber = (value, min, max) => Math.max(min, Math.min(value, ma
  * @example randomFloat(1.5, 3.5) → 2.84623
  */
 export const getRandomFloat = (min, max) => {
-    return Math.random() * (max - min) + min;
+    return Math.random() * (Number(max) - Number(min)) + Number(min);
 };
 /**
  * * Returns the ordinal suffix for a given number (e.g., 1 -> 'st', 2 -> 'nd', 3 -> 'rd', 4 -> 'th' etc.).
@@ -51,13 +55,13 @@ export const getRandomFloat = (min, max) => {
  * If the `withNumber` parameter is `true`, the function returns the number along with its ordinal suffix (e.g., "1st").
  * Otherwise, it returns only the ordinal suffix (e.g., "st").
  *
- * @param n - The number or number string to get the ordinal suffix for.
+ * @param num - The number or number string to get the ordinal suffix for.
  * @param withNumber - Whether to include the number along with its ordinal suffix (defaults to `true`).
  * @returns The appropriate ordinal suffix, optionally with the number (e.g., '1st' or 'st`, '2nd' or 'nd' and so on.).
  */
-export const getOrdinal = (n, withNumber = true) => {
-    const remainder10 = Number(n) % 10;
-    const remainder100 = Number(n) % 100;
+export const getOrdinal = (num, withNumber = true) => {
+    const remainder10 = Number(num) % 10;
+    const remainder100 = Number(num) % 100;
     let suffix;
     if (remainder10 === 1 && remainder100 !== 11) {
         suffix = 'st';
@@ -71,5 +75,5 @@ export const getOrdinal = (n, withNumber = true) => {
     else {
         suffix = 'th';
     }
-    return withNumber ? String(n).concat(suffix) : suffix;
+    return withNumber ? String(num).concat(suffix) : suffix;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.0.21",
+  "version": "4.0.30",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",