nhb-toolbox 4.10.54 → 4.10.56

package/dist/cjs/number/percent.js

@@ -18,27 +18,38 @@ const guards_1 = require("./guards");
  * @returns The calculated number rounded to three decimal places, or `NaN` if input is invalid.
  */
 function calculatePercentage(options) {
+    const { roundTo = 3 } = options;
+    /**
+     * - Rounds a number to the specified number of decimal places.
+     *
+     * @param num - The number to round.
+     * @returns The rounded number.
+     */
+    const _roundNumber = (num) => {
+        const factor = Math.pow(10, roundTo);
+        return Math.round(num * factor) / factor;
+    };
     switch (options?.mode) {
         case 'get-percent': {
             const { part, total } = options;
             if ((0, guards_1.areInvalidNumbers)(part, total) || total === 0) {
                 return NaN;
             }
-            return Math.round((part / total) * 100 * 1000) / 1000;
+            return _roundNumber((part / total) * 100);
         }
         case 'get-value': {
             const { percentage, total } = options;
             if ((0, guards_1.areInvalidNumbers)(percentage, total) || total === 0) {
                 return NaN;
             }
-            return Math.round((percentage / 100) * total * 1000) / 1000;
+            return _roundNumber((percentage / 100) * total);
         }
         case 'get-original': {
             const { percentage, value } = options;
             if ((0, guards_1.areInvalidNumbers)(percentage, value) || percentage === 0) {
                 return NaN;
             }
-            return Math.round((value / percentage) * 100 * 1000) / 1000;
+            return _roundNumber((value / percentage) * 100);
         }
         case 'get-change-percent': {
             const { oldValue, newValue } = options;
@@ -46,7 +57,7 @@ function calculatePercentage(options) {
                 return NaN;
             }
             const change = ((newValue - oldValue) / oldValue) * 100;
-            return Math.round(change * 1000) / 1000;
+            return _roundNumber(change);
         }
         case 'apply-percent-change': {
             const { baseValue, percentage } = options;
@@ -54,7 +65,7 @@ function calculatePercentage(options) {
                 return NaN;
             }
             const value = baseValue * (1 + percentage / 100);
-            return Math.round(value * 1000) / 1000;
+            return _roundNumber(value);
         }
         case 'get-percent-difference': {
             const { value1, value2 } = options;
@@ -66,14 +77,14 @@ function calculatePercentage(options) {
                 return NaN;
             }
             const diff = (Math.abs(value1 - value2) / avg) * 100;
-            return Math.round(diff * 1000) / 1000;
+            return _roundNumber(diff);
         }
         case 'inverse-percent': {
             const { part, total } = options;
             if ((0, guards_1.areInvalidNumbers)(part, total) || part === 0) {
                 return NaN;
             }
-            return Math.round((total / part) * 100 * 1000) / 1000;
+            return _roundNumber((total / part) * 100);
         }
         default:
             return NaN;

package/dist/cjs/number/range.js

@@ -16,7 +16,7 @@ const prime_1 = require("./prime");
  * @returns Either a string or an array of numbers.
  */
 function getNumbersInRange(type = 'any', options) {
-    const { getAs = 'array', min = 0, max = 100, includeMin = true, includeMax = true, separator = ',', multiplesOf: multiples, } = options || {};
+    const { getAsString = false, min = 0, max = 100, includeMin = true, includeMax = true, separator = ', ', multiplesOf, } = options || {};
     let output = [];
     /**
      * Helper function to apply range and get array of numbers in that range.
@@ -42,8 +42,8 @@ function getNumbersInRange(type = 'any', options) {
         }
         return numbers;
     };
-    if (type === 'prime' && multiples !== undefined) {
-        console.warn('Warning: The "multiples" option is ignored when the type is "prime"!');
+    if (type === 'prime' && multiplesOf !== undefined) {
+        console.warn('Warning: The "multiplesOf" option is ignored when the type is "prime"!');
     }
     switch (type) {
         case 'random':
@@ -71,9 +71,9 @@ function getNumbersInRange(type = 'any', options) {
             break;
     }
     if (type !== 'prime') {
-        output = (0, helpers_1._applyMultiples)(output, multiples);
+        output = (0, helpers_1._applyMultiples)(output, multiplesOf);
     }
-    return getAs === 'string' ?
+    return getAsString ?
         (0, utils_1.convertArrayToString)(output, separator)
         : output;
 }

package/dist/dts/number/percent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"percent.d.ts","sourceRoot":"","sources":["../../../src/number/percent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAuFtE"}
+{"version":3,"file":"percent.d.ts","sourceRoot":"","sources":["../../../src/number/percent.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAqGtE"}

package/dist/dts/number/range.d.ts

@@ -1,4 +1,4 @@
-import type { GetAs, NumberType, RangedNumbers, RangeOptions } from './types';
+import type { NumberType, RangedNumbers, RangeOptions } from './types';
 /**
  * * Function to get numbers within a range based on the provided `NumberType` and options.
  * * Returns either a string or an array of numbers based on the `getAs` property in options.
@@ -7,5 +7,5 @@ import type { GetAs, NumberType, RangedNumbers, RangeOptions } from './types';
  * @param options - Options to configure number generation, including range and formatting.
  * @returns Either a string or an array of numbers.
  */
-export declare function getNumbersInRange<T extends GetAs>(type?: NumberType, options?: RangeOptions<T>): RangedNumbers<T>;
+export declare function getNumbersInRange<T extends boolean = false>(type?: NumberType, options?: RangeOptions<T>): RangedNumbers<T>;
 //# sourceMappingURL=range.d.ts.map

package/dist/dts/number/range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/number/range.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9E;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,KAAK,EAChD,IAAI,GAAE,UAAkB,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,CAAC,CAAC,CA2FlB"}
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/number/range.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,OAAO,GAAG,KAAK,EAC1D,IAAI,GAAE,UAAkB,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,aAAa,CAAC,CAAC,CAAC,CA2FlB"}

package/dist/dts/number/types.d.ts

@@ -22,19 +22,17 @@ export interface DecimalOptions<T extends boolean | undefined = false> {
 export type ConvertedDecimal<T> = T extends true ? `${number}` : number;
 /** - Type of numbers to generate */
 export type NumberType = 'any' | 'natural' | 'odd' | 'even' | 'prime' | 'random';
-/** - Output format for the generated numbers */
-export type GetAs = 'array' | 'string';
 /** - Options for generating numbers in a range */
-export interface RangeOptions<T extends GetAs> extends RandomNumberOptions {
-    /** Separator for the string format if `getAs` is `'string'`. Defaults to `,`. */
-    separator?: string;
+export interface RangeOptions<T extends boolean = false> extends RandomNumberOptions {
+    /** Separator for the string format if `getAsString` is `'true'`. Defaults to `, `. */
+    separator?: T extends true ? string : never;
     /** The multiples of which number to consider in the result. */
     multiplesOf?: number;
-    /** The format for the result - either `'array'` or `'string'`. Default is `array` */
-    getAs?: T;
+    /** The format for the result - `{ getAsString: true }` returns strings with custom separator and `false` returns array of numbers. Default is `false`. */
+    getAsString?: T;
 }
 /** - The return type of the `getNumbersInRange` function */
-export type RangedNumbers<T extends GetAs> = T extends 'array' ? number[] : string;
+export type RangedNumbers<T extends boolean = false> = T extends true ? string : number[];
 /** List of ISO 4217 currency codes. */
 export type CurrencyCode = keyof typeof CURRENCY_LOCALES | (typeof CURRENCY_CODES)[number];
 /** - List of all supported BCP 47 locales */
@@ -118,7 +116,10 @@ export interface InversePercentageOptions {
     total: number;
 }
 /** * Options for calculating percentages and related values. */
-export type PercentageOptions = GetPercentOptions | GetValueOptions | GetOriginalOptions | GetChangeOptions | ApplyChangeOptions | GetDifferenceOptions | InversePercentageOptions;
+export type PercentageOptions = (GetPercentOptions | GetValueOptions | GetOriginalOptions | GetChangeOptions | ApplyChangeOptions | GetDifferenceOptions | InversePercentageOptions) & {
+    /** The number of decimal places to round the result to. */
+    roundTo?: number;
+};
 /** * Static methods from `Unit` class that accept a single number argument and return a number. */
 export type UnitNumberMethods = {
     [K in keyof typeof Unit]: (typeof Unit)[K] extends ((value: number) => number) ? K : never;

package/dist/dts/number/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/number/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/number/types.ts"],"names":[],"mappings":"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"}

package/dist/esm/number/percent.js

@@ -15,27 +15,38 @@ import { areInvalidNumbers } from './guards';
  * @returns The calculated number rounded to three decimal places, or `NaN` if input is invalid.
  */
 export function calculatePercentage(options) {
+    const { roundTo = 3 } = options;
+    /**
+     * - Rounds a number to the specified number of decimal places.
+     *
+     * @param num - The number to round.
+     * @returns The rounded number.
+     */
+    const _roundNumber = (num) => {
+        const factor = Math.pow(10, roundTo);
+        return Math.round(num * factor) / factor;
+    };
     switch (options?.mode) {
         case 'get-percent': {
             const { part, total } = options;
             if (areInvalidNumbers(part, total) || total === 0) {
                 return NaN;
             }
-            return Math.round((part / total) * 100 * 1000) / 1000;
+            return _roundNumber((part / total) * 100);
         }
         case 'get-value': {
             const { percentage, total } = options;
             if (areInvalidNumbers(percentage, total) || total === 0) {
                 return NaN;
             }
-            return Math.round((percentage / 100) * total * 1000) / 1000;
+            return _roundNumber((percentage / 100) * total);
         }
         case 'get-original': {
             const { percentage, value } = options;
             if (areInvalidNumbers(percentage, value) || percentage === 0) {
                 return NaN;
             }
-            return Math.round((value / percentage) * 100 * 1000) / 1000;
+            return _roundNumber((value / percentage) * 100);
         }
         case 'get-change-percent': {
             const { oldValue, newValue } = options;
@@ -43,7 +54,7 @@ export function calculatePercentage(options) {
                 return NaN;
             }
             const change = ((newValue - oldValue) / oldValue) * 100;
-            return Math.round(change * 1000) / 1000;
+            return _roundNumber(change);
         }
         case 'apply-percent-change': {
             const { baseValue, percentage } = options;
@@ -51,7 +62,7 @@ export function calculatePercentage(options) {
                 return NaN;
             }
             const value = baseValue * (1 + percentage / 100);
-            return Math.round(value * 1000) / 1000;
+            return _roundNumber(value);
         }
         case 'get-percent-difference': {
             const { value1, value2 } = options;
@@ -63,14 +74,14 @@ export function calculatePercentage(options) {
                 return NaN;
             }
             const diff = (Math.abs(value1 - value2) / avg) * 100;
-            return Math.round(diff * 1000) / 1000;
+            return _roundNumber(diff);
         }
         case 'inverse-percent': {
             const { part, total } = options;
             if (areInvalidNumbers(part, total) || part === 0) {
                 return NaN;
             }
-            return Math.round((total / part) * 100 * 1000) / 1000;
+            return _roundNumber((total / part) * 100);
         }
         default:
             return NaN;

package/dist/esm/number/range.js

@@ -13,7 +13,7 @@ import { isPrime } from './prime';
  * @returns Either a string or an array of numbers.
  */
 export function getNumbersInRange(type = 'any', options) {
-    const { getAs = 'array', min = 0, max = 100, includeMin = true, includeMax = true, separator = ',', multiplesOf: multiples, } = options || {};
+    const { getAsString = false, min = 0, max = 100, includeMin = true, includeMax = true, separator = ', ', multiplesOf, } = options || {};
     let output = [];
     /**
      * Helper function to apply range and get array of numbers in that range.
@@ -39,8 +39,8 @@ export function getNumbersInRange(type = 'any', options) {
         }
         return numbers;
     };
-    if (type === 'prime' && multiples !== undefined) {
-        console.warn('Warning: The "multiples" option is ignored when the type is "prime"!');
+    if (type === 'prime' && multiplesOf !== undefined) {
+        console.warn('Warning: The "multiplesOf" option is ignored when the type is "prime"!');
     }
     switch (type) {
         case 'random':
@@ -68,9 +68,9 @@ export function getNumbersInRange(type = 'any', options) {
             break;
     }
     if (type !== 'prime') {
-        output = _applyMultiples(output, multiples);
+        output = _applyMultiples(output, multiplesOf);
     }
-    return getAs === 'string' ?
+    return getAsString ?
         convertArrayToString(output, separator)
         : output;
 }

package/package.json

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