nhb-toolbox 4.0.70 → 4.0.75

package/dist/cjs/number/Unit.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Unit = void 0;
+const constants_1 = require("./constants");
 /**
  * @class Represents a measurable unit and supports conversions between various types of units.
  *
@@ -37,11 +38,31 @@ class Unit {
         return `${this.#value} ${this.#unit ?? ''}`.trim();
     }
     /**
-     * @instance Converts the value using a static method name from the Unit class.
+     * @instance Converts using scientific prefixes (e.g., kB to MB, mg to g).
      *
-     * *Provides IntelliSense and type safety for method selection.*
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    convertByPrefix(fromPrefix, toPrefix) {
+        return Unit.convertByPrefix(this.#value, fromPrefix, toPrefix);
+    }
+    /**
+     * @instance Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    convertFromTo(from, to) {
+        return Unit.convertFromTo(this.#value, from, to);
+    }
+    /**
+     * @instance Converts the value using a static method name from the `Unit` class.
      *
-     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * - **N.B.** *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A static `Unit` method that accepts a number and returns a number.
      * @returns The converted numeric value.
      */
     convert(methodName) {
@@ -49,10 +70,44 @@ class Unit {
         if (typeof method !== 'function') {
             throw new Error(`Method ${methodName} is not a valid method!`);
         }
-        // @ts-expect-error -_-
         return method(this.#value);
     }
-    // ----- Static Conversion Methods -----
+    // ! ----- Static Conversion Methods ----- ! //
+    /**
+     * @static Converts a value using scientific prefixes (e.g., kB to MB, mg to g).
+     *
+     * @param value The value to convert.
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    static convertByPrefix(value, fromPrefix, toPrefix) {
+        const fromMultiplier = constants_1.PREFIX_MULTIPLIERS[fromPrefix];
+        const toMultiplier = constants_1.PREFIX_MULTIPLIERS[toPrefix];
+        return (value * fromMultiplier) / toMultiplier;
+    }
+    /**
+     * @static Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param value The numeric value.
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    static convertFromTo(value, from, to) {
+        const extractPrefix = (str) => {
+            const match = str.match(/^(da|[yzafpnμumcdhkMGTPEZY]?)(.+)$/);
+            if (!match)
+                throw new Error(`Invalid unit format: ${str}`);
+            return [match[1], match[2]];
+        };
+        const [fromPrefix, fromUnit] = extractPrefix(from);
+        const [toPrefix, toUnit] = extractPrefix(to);
+        if (fromUnit !== toUnit) {
+            throw new Error(`Mismatched units: ${fromUnit} vs ${toUnit}`);
+        }
+        return Unit.convertByPrefix(value, fromPrefix, toPrefix);
+    }
     /** Converts meters to feet. */
     static metersToFeet(m) {
         return m * 3.28084;
@@ -101,6 +156,30 @@ class Unit {
     static kelvinToCelsius(k) {
         return k - 273.15;
     }
+    /** Converts Fahrenheit to Kelvin. */
+    static fahrenheitToKelvin(f) {
+        return ((f - 32) * 5) / 9 + 273.15;
+    }
+    /** Converts Kelvin to Fahrenheit. */
+    static kelvinToFahrenheit(k) {
+        return ((k - 273.15) * 9) / 5 + 32;
+    }
+    /** Converts milliliters to liters. */
+    static mlToLiters(ml) {
+        return ml / 1000;
+    }
+    /** Converts liters to milliliters. */
+    static litersToMl(l) {
+        return l * 1000;
+    }
+    /** Converts gallons to milliliters. */
+    static gallonsToMl(gal) {
+        return gal * 3785.41;
+    }
+    /** Converts milliliters to gallons. */
+    static mlToGallons(ml) {
+        return ml / 3785.41;
+    }
     /** Converts liters to gallons. */
     static litersToGallons(l) {
         return l * 0.264172;
@@ -125,6 +204,18 @@ class Unit {
     static mphToKmph(mph) {
         return mph / 0.621371;
     }
+    /** Converts minutes to hours. */
+    static minutesToHours(min) {
+        return min / 60;
+    }
+    /** Converts seconds to minutes. */
+    static secondsToMinutes(sec) {
+        return sec / 60;
+    }
+    /** Converts hours to days. */
+    static hoursToDays(hr) {
+        return hr / 24;
+    }
     /** Converts hours to minutes. */
     static hoursToMinutes(h) {
         return h * 60;
@@ -149,6 +240,34 @@ class Unit {
     static kbToMb(kb) {
         return kb / 1024;
     }
+    /** Converts kilobytes to gigabytes. */
+    static kbToGb(kb) {
+        return kb / (1024 * 1024);
+    }
+    /** Converts gigabytes to kilobytes. */
+    static gbToKb(gb) {
+        return gb * 1024 * 1024;
+    }
+    /** Converts bytes to kilobytes. */
+    static bytesToKb(bytes) {
+        return bytes / 1024;
+    }
+    /** Converts kilobytes to bytes. */
+    static kbToBytes(kb) {
+        return kb * 1024;
+    }
+    /** Converts megabytes to kilobytes. */
+    static mbToKb(mb) {
+        return mb * 1024;
+    }
+    /** Converts gigabytes to terabytes. */
+    static gbToTb(gb) {
+        return gb / 1024;
+    }
+    /** Converts terabytes to gigabytes. */
+    static tbToGb(tb) {
+        return tb * 1024;
+    }
     /** Converts joules to calories. */
     static joulesToCalories(j) {
         return j * 0.239006;
@@ -157,6 +276,14 @@ class Unit {
     static caloriesToJoules(cal) {
         return cal / 0.239006;
     }
+    /** Converts calories to kilojoules. */
+    static caloriesToKJoules(cal) {
+        return cal / 0.239006 / 1000;
+    }
+    /** Converts kilojoules to calories. */
+    static kJoulesToCalories(kj) {
+        return kj * 1000 * 0.239006;
+    }
     /** Converts atmospheres to pascals. */
     static atmToPascal(atm) {
         return atm * 101325;
@@ -165,6 +292,14 @@ class Unit {
     static pascalToAtm(pa) {
         return pa / 101325;
     }
+    /** Converts bar to pascals. */
+    static barToPascal(bar) {
+        return bar * 100000;
+    }
+    /** Converts pascals to bar. */
+    static pascalToBar(pa) {
+        return pa / 100000;
+    }
     /** Converts hertz to kilohertz. */
     static hzToKHz(hz) {
         return hz / 1000;
@@ -173,5 +308,61 @@ class Unit {
     static kHzToHz(khz) {
         return khz * 1000;
     }
+    /** Converts hertz to megahertz. */
+    static hzToMHz(hz) {
+        return hz / 1_000_000;
+    }
+    /** Converts megahertz to hertz. */
+    static mHzToHz(mhz) {
+        return mhz * 1_000_000;
+    }
+    /** Converts kilohertz to megahertz. */
+    static kHzToMHz(khz) {
+        return khz / 1000;
+    }
+    /** Converts megahertz to kilohertz. */
+    static mHzToKHz(mhz) {
+        return mhz * 1000;
+    }
+    /** Converts centimeters to meters. */
+    static cmToMeters(cm) {
+        return cm / 100;
+    }
+    /** Converts meters to centimeters. */
+    static metersToCm(m) {
+        return m * 100;
+    }
+    /** Converts millimeters to meters. */
+    static mmToMeters(mm) {
+        return mm / 1000;
+    }
+    /** Converts meters to millimeters. */
+    static metersToMm(m) {
+        return m * 1000;
+    }
+    /** Converts square kilometers to square meters. */
+    static sqkmToSqm(sqkm) {
+        return sqkm * 1_000_000;
+    }
+    /** Converts square meters to square kilometers. */
+    static sqmToSqkm(sqm) {
+        return sqm / 1_000_000;
+    }
+    /** Converts square feet to square inches. */
+    static sqftToSqin(sqft) {
+        return sqft * 144;
+    }
+    /** Converts square inches to square feet. */
+    static sqinToSqft(sqin) {
+        return sqin / 144;
+    }
+    /** Converts watts to kilowatts. */
+    static wattsToKw(w) {
+        return w / 1000;
+    }
+    /** Converts kilowatts to watts. */
+    static kwToWatts(kw) {
+        return kw * 1000;
+    }
 }
 exports.Unit = Unit;

package/dist/cjs/number/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNIT_LABELS = exports.SUPPORTED_CURRENCIES = exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.thousands = exports.tens = exports.teens = exports.ones = void 0;
+exports.PREFIX_MULTIPLIERS = exports.UNITS = exports.SUPPORTED_CURRENCIES = exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.thousands = exports.tens = exports.teens = exports.ones = void 0;
 exports.ones = [
     '',
     'one',
@@ -539,10 +539,8 @@ exports.SUPPORTED_CURRENCIES = [
     'USD',
     'ZAR',
 ];
-/**
- * @constant Unit names and their full readable labels.
- */
-exports.UNIT_LABELS = {
+/** * @constant Unit names and their full readable labels. */
+exports.UNITS = {
     // Length
     m: 'Meter',
     km: 'Kilometer',
@@ -585,3 +583,28 @@ exports.UNIT_LABELS = {
     hz: 'Hertz',
     khz: 'Kilohertz',
 };
+/** * Scientific SI Unit prefix multipliers. */
+exports.PREFIX_MULTIPLIERS = {
+    y: 1e-24,
+    z: 1e-21,
+    a: 1e-18,
+    f: 1e-15,
+    p: 1e-12,
+    n: 1e-9,
+    μ: 1e-6,
+    u: 1e-6,
+    m: 1e-3,
+    c: 1e-2,
+    d: 1e-1,
+    da: 1e1,
+    h: 1e2,
+    k: 1e3,
+    M: 1e6,
+    G: 1e9,
+    T: 1e12,
+    P: 1e15,
+    E: 1e18,
+    Z: 1e21,
+    Y: 1e24,
+    '': 1, // base unit, like meter, gram, byte etc.
+};

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

@@ -1,4 +1,4 @@
-import type { UnitKey } from './types';
+import type { SIPrefix, UnitKey, UnitNumberMethods } from './types';
 /**
  * @class Represents a measurable unit and supports conversions between various types of units.
  *
@@ -29,14 +29,48 @@ export declare class Unit {
      */
     toString(): string;
     /**
-     * @instance Converts the value using a static method name from the Unit class.
+     * @instance Converts using scientific prefixes (e.g., kB to MB, mg to g).
      *
-     * *Provides IntelliSense and type safety for method selection.*
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    convertByPrefix(fromPrefix: SIPrefix, toPrefix: SIPrefix): number;
+    /**
+     * @instance Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    convertFromTo(from: string, to: string): number;
+    /**
+     * @instance Converts the value using a static method name from the `Unit` class.
+     *
+     * - **N.B.** *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A static `Unit` method that accepts a number and returns a number.
+     * @returns The converted numeric value.
+     */
+    convert(methodName: UnitNumberMethods): number;
+    /**
+     * @static Converts a value using scientific prefixes (e.g., kB to MB, mg to g).
+     *
+     * @param value The value to convert.
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    static convertByPrefix(value: number, fromPrefix: SIPrefix, toPrefix: SIPrefix): number;
+    /**
+     * @static Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
      *
-     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * @param value The numeric value.
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
      * @returns The converted numeric value.
      */
-    convert<T extends keyof typeof Unit>(methodName: T): (typeof Unit)[T] extends (value: number) => number ? number : never;
+    static convertFromTo(value: number, from: string, to: string): number;
     /** Converts meters to feet. */
     static metersToFeet(m: number): number;
     /** Converts feet to meters. */
@@ -61,6 +95,18 @@ export declare class Unit {
     static celsiusToKelvin(c: number): number;
     /** Converts Kelvin to Celsius. */
     static kelvinToCelsius(k: number): number;
+    /** Converts Fahrenheit to Kelvin. */
+    static fahrenheitToKelvin(f: number): number;
+    /** Converts Kelvin to Fahrenheit. */
+    static kelvinToFahrenheit(k: number): number;
+    /** Converts milliliters to liters. */
+    static mlToLiters(ml: number): number;
+    /** Converts liters to milliliters. */
+    static litersToMl(l: number): number;
+    /** Converts gallons to milliliters. */
+    static gallonsToMl(gal: number): number;
+    /** Converts milliliters to gallons. */
+    static mlToGallons(ml: number): number;
     /** Converts liters to gallons. */
     static litersToGallons(l: number): number;
     /** Converts gallons to liters. */
@@ -73,6 +119,12 @@ export declare class Unit {
     static kmphToMph(kmph: number): number;
     /** Converts miles per hour to kilometers per hour. */
     static mphToKmph(mph: number): number;
+    /** Converts minutes to hours. */
+    static minutesToHours(min: number): number;
+    /** Converts seconds to minutes. */
+    static secondsToMinutes(sec: number): number;
+    /** Converts hours to days. */
+    static hoursToDays(hr: number): number;
     /** Converts hours to minutes. */
     static hoursToMinutes(h: number): number;
     /** Converts minutes to seconds. */
@@ -85,17 +137,67 @@ export declare class Unit {
     static gbToMb(gb: number): number;
     /** Converts kilobytes to megabytes. */
     static kbToMb(kb: number): number;
+    /** Converts kilobytes to gigabytes. */
+    static kbToGb(kb: number): number;
+    /** Converts gigabytes to kilobytes. */
+    static gbToKb(gb: number): number;
+    /** Converts bytes to kilobytes. */
+    static bytesToKb(bytes: number): number;
+    /** Converts kilobytes to bytes. */
+    static kbToBytes(kb: number): number;
+    /** Converts megabytes to kilobytes. */
+    static mbToKb(mb: number): number;
+    /** Converts gigabytes to terabytes. */
+    static gbToTb(gb: number): number;
+    /** Converts terabytes to gigabytes. */
+    static tbToGb(tb: number): number;
     /** Converts joules to calories. */
     static joulesToCalories(j: number): number;
     /** Converts calories to joules. */
     static caloriesToJoules(cal: number): number;
+    /** Converts calories to kilojoules. */
+    static caloriesToKJoules(cal: number): number;
+    /** Converts kilojoules to calories. */
+    static kJoulesToCalories(kj: number): number;
     /** Converts atmospheres to pascals. */
     static atmToPascal(atm: number): number;
     /** Converts pascals to atmospheres. */
     static pascalToAtm(pa: number): number;
+    /** Converts bar to pascals. */
+    static barToPascal(bar: number): number;
+    /** Converts pascals to bar. */
+    static pascalToBar(pa: number): number;
     /** Converts hertz to kilohertz. */
     static hzToKHz(hz: number): number;
     /** Converts kilohertz to hertz. */
     static kHzToHz(khz: number): number;
+    /** Converts hertz to megahertz. */
+    static hzToMHz(hz: number): number;
+    /** Converts megahertz to hertz. */
+    static mHzToHz(mhz: number): number;
+    /** Converts kilohertz to megahertz. */
+    static kHzToMHz(khz: number): number;
+    /** Converts megahertz to kilohertz. */
+    static mHzToKHz(mhz: number): number;
+    /** Converts centimeters to meters. */
+    static cmToMeters(cm: number): number;
+    /** Converts meters to centimeters. */
+    static metersToCm(m: number): number;
+    /** Converts millimeters to meters. */
+    static mmToMeters(mm: number): number;
+    /** Converts meters to millimeters. */
+    static metersToMm(m: number): number;
+    /** Converts square kilometers to square meters. */
+    static sqkmToSqm(sqkm: number): number;
+    /** Converts square meters to square kilometers. */
+    static sqmToSqkm(sqm: number): number;
+    /** Converts square feet to square inches. */
+    static sqftToSqin(sqft: number): number;
+    /** Converts square inches to square feet. */
+    static sqinToSqft(sqin: number): number;
+    /** Converts watts to kilowatts. */
+    static wattsToKw(w: number): number;
+    /** Converts kilowatts to watts. */
+    static kwToWatts(kw: number): number;
 }
 //# sourceMappingURL=Unit.d.ts.map

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

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

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

@@ -171,10 +171,8 @@ export declare const CURRENCY_LOCALES: {
 };
 /** * Fiat currencies supported by Frankfurter API */
 export declare const SUPPORTED_CURRENCIES: readonly ["AUD", "BGN", "BRL", "CAD", "CHF", "CNY", "CZK", "DKK", "EUR", "GBP", "HKD", "HUF", "IDR", "ILS", "INR", "ISK", "JPY", "KRW", "MXN", "MYR", "NOK", "NZD", "PHP", "PLN", "RON", "SEK", "SGD", "THB", "TRY", "USD", "ZAR"];
-/**
- * @constant Unit names and their full readable labels.
- */
-export declare const UNIT_LABELS: {
+/** * @constant Unit names and their full readable labels. */
+export declare const UNITS: {
     readonly m: "Meter";
     readonly km: "Kilometer";
     readonly mi: "Mile";
@@ -206,4 +204,29 @@ export declare const UNIT_LABELS: {
     readonly hz: "Hertz";
     readonly khz: "Kilohertz";
 };
+/** * Scientific SI Unit prefix multipliers. */
+export declare const PREFIX_MULTIPLIERS: {
+    readonly y: 1e-24;
+    readonly z: 1e-21;
+    readonly a: 1e-18;
+    readonly f: 1e-15;
+    readonly p: 1e-12;
+    readonly n: 1e-9;
+    readonly μ: 0.000001;
+    readonly u: 0.000001;
+    readonly m: 0.001;
+    readonly c: 0.01;
+    readonly d: 0.1;
+    readonly da: 10;
+    readonly h: 100;
+    readonly k: 1000;
+    readonly M: 1000000;
+    readonly G: 1000000000;
+    readonly T: 1000000000000;
+    readonly P: 1000000000000000;
+    readonly E: 1000000000000000000;
+    readonly Z: 1e+21;
+    readonly Y: 1e+24;
+    readonly '': 1;
+};
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/number/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,uFAWP,CAAC;AAEX,eAAO,MAAM,KAAK,sHAWR,CAAC;AAEX,eAAO,MAAM,IAAI,oGAWP,CAAC;AAEX,eAAO,MAAM,SAAS,8JAaZ,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,cAAc,2mCAiKjB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,YAAY,mnCA8Hf,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiKnB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,oOAgCvB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDd,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/number/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,IAAI,uFAWP,CAAC;AAEX,eAAO,MAAM,KAAK,sHAWR,CAAC;AAEX,eAAO,MAAM,IAAI,oGAWP,CAAC;AAEX,eAAO,MAAM,SAAS,8JAaZ,CAAC;AAEX,sCAAsC;AACtC,eAAO,MAAM,cAAc,2mCAiKjB,CAAC;AAEX,2CAA2C;AAC3C,eAAO,MAAM,YAAY,mnCA8Hf,CAAC;AAEX,8CAA8C;AAC9C,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiKnB,CAAC;AAEX,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,oOAgCvB,CAAC;AAEX,6DAA6D;AAC7D,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDR,CAAC;AAEX,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;CAuBrB,CAAC"}

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

@@ -1,4 +1,5 @@
-import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, SUPPORTED_CURRENCIES, UNIT_LABELS } from './constants';
+import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, PREFIX_MULTIPLIERS, SUPPORTED_CURRENCIES, UNITS } from './constants';
+import type { Unit } from './Unit';
 /** - Options for random number generator */
 export interface RandomNumberOptions {
     /** Minimum number to start with. */
@@ -118,8 +119,14 @@ export interface InversePercentageOptions {
 }
 /** * Options for calculating percentages and related values. */
 export type PercentageOptions = GetPercentOptions | GetValueOptions | GetOriginalOptions | GetChangeOptions | ApplyChangeOptions | GetDifferenceOptions | InversePercentageOptions;
-/** * Short forms of units */
-export type UnitKey = keyof typeof UNIT_LABELS;
-/** Labels for the units */
-export type UnitLabel = (typeof UNIT_LABELS)[UnitKey];
+/** * 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;
+}[keyof typeof Unit];
+/** - Short forms of units */
+export type UnitKey = keyof typeof UNITS;
+/** - Labels for the units */
+export type UnitLabel = (typeof UNITS)[UnitKey];
+/** - Prefixes for SI units */
+export type SIPrefix = keyof typeof PREFIX_MULTIPLIERS;
 //# sourceMappingURL=types.d.ts.map

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":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,EACL,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,4CAA4C;AAC5C,MAAM,WAAW,mBAAmB;IACnC,oCAAoC;IACpC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,SAAS,GAAG,KAAK;IACpE,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,CAAC,CAAC;CACb;AAED,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;AAExE,oCAAoC;AACpC,MAAM,MAAM,UAAU,GACnB,KAAK,GACL,SAAS,GACT,KAAK,GACL,MAAM,GACN,OAAO,GACP,QAAQ,CAAC;AAEZ,gDAAgD;AAChD,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvC,kDAAkD;AAClD,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,KAAK,CAAE,SAAQ,mBAAmB;IACzE,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,KAAK,CAAC,EAAE,CAAC,CAAC;CACV;AAED,4DAA4D;AAC5D,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,KAAK,IACxC,CAAC,SAAS,OAAO,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;AAEvC,uCAAuC;AACvC,MAAM,MAAM,YAAY,GACrB,MAAM,OAAO,gBAAgB,GAC7B,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnC,6CAA6C;AAC7C,MAAM,MAAM,UAAU,GACnB,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,OAAO,gBAAgB,CAAC,GACxD,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjC,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC9B,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,YAAY,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IACjC,2DAA2D;IAC3D,IAAI,EAAE,aAAa,CAAC;IACpB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACd;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC/B,4DAA4D;IAC5D,IAAI,EAAE,WAAW,CAAC;IAClB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;CACd;AAED,uFAAuF;AACvF,MAAM,WAAW,kBAAkB;IAClC,qEAAqE;IACrE,IAAI,EAAE,cAAc,CAAC;IACrB,4CAA4C;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;CACd;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAChC,wEAAwE;IACxE,IAAI,EAAE,oBAAoB,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,oEAAoE;AACpE,MAAM,WAAW,kBAAkB;IAClC,qDAAqD;IACrD,IAAI,EAAE,sBAAsB,CAAC;IAC7B,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;CACnB;AAED,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACpC,4EAA4E;IAC5E,IAAI,EAAE,wBAAwB,CAAC;IAC/B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CACf;AAED,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACxC,mEAAmE;IACnE,IAAI,EAAE,iBAAiB,CAAC;IACxB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,KAAK,EAAE,MAAM,CAAC;CACd;AAED,gEAAgE;AAChE,MAAM,MAAM,iBAAiB,GAC1B,iBAAiB,GACjB,eAAe,GACf,kBAAkB,GAClB,gBAAgB,GAChB,kBAAkB,GAClB,oBAAoB,GACpB,wBAAwB,CAAC;AAE5B,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG;KAC9B,CAAC,IAAI,MAAM,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAClD,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CACzB,GACA,CAAC,GACA,KAAK;CACP,CAAC,MAAM,OAAO,IAAI,CAAC,CAAC;AAErB,6BAA6B;AAC7B,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,KAAK,CAAC;AAEzC,6BAA6B;AAC7B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;AAEhD,8BAA8B;AAC9B,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,kBAAkB,CAAC"}

package/dist/esm/number/Unit.js

@@ -1,3 +1,4 @@
+import { PREFIX_MULTIPLIERS } from './constants';
 /**
  * @class Represents a measurable unit and supports conversions between various types of units.
  *
@@ -34,11 +35,31 @@ export class Unit {
         return `${this.#value} ${this.#unit ?? ''}`.trim();
     }
     /**
-     * @instance Converts the value using a static method name from the Unit class.
+     * @instance Converts using scientific prefixes (e.g., kB to MB, mg to g).
      *
-     * *Provides IntelliSense and type safety for method selection.*
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    convertByPrefix(fromPrefix, toPrefix) {
+        return Unit.convertByPrefix(this.#value, fromPrefix, toPrefix);
+    }
+    /**
+     * @instance Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    convertFromTo(from, to) {
+        return Unit.convertFromTo(this.#value, from, to);
+    }
+    /**
+     * @instance Converts the value using a static method name from the `Unit` class.
      *
-     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * - **N.B.** *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A static `Unit` method that accepts a number and returns a number.
      * @returns The converted numeric value.
      */
     convert(methodName) {
@@ -46,10 +67,44 @@ export class Unit {
         if (typeof method !== 'function') {
             throw new Error(`Method ${methodName} is not a valid method!`);
         }
-        // @ts-expect-error -_-
         return method(this.#value);
     }
-    // ----- Static Conversion Methods -----
+    // ! ----- Static Conversion Methods ----- ! //
+    /**
+     * @static Converts a value using scientific prefixes (e.g., kB to MB, mg to g).
+     *
+     * @param value The value to convert.
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    static convertByPrefix(value, fromPrefix, toPrefix) {
+        const fromMultiplier = PREFIX_MULTIPLIERS[fromPrefix];
+        const toMultiplier = PREFIX_MULTIPLIERS[toPrefix];
+        return (value * fromMultiplier) / toMultiplier;
+    }
+    /**
+     * @static Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param value The numeric value.
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    static convertFromTo(value, from, to) {
+        const extractPrefix = (str) => {
+            const match = str.match(/^(da|[yzafpnμumcdhkMGTPEZY]?)(.+)$/);
+            if (!match)
+                throw new Error(`Invalid unit format: ${str}`);
+            return [match[1], match[2]];
+        };
+        const [fromPrefix, fromUnit] = extractPrefix(from);
+        const [toPrefix, toUnit] = extractPrefix(to);
+        if (fromUnit !== toUnit) {
+            throw new Error(`Mismatched units: ${fromUnit} vs ${toUnit}`);
+        }
+        return Unit.convertByPrefix(value, fromPrefix, toPrefix);
+    }
     /** Converts meters to feet. */
     static metersToFeet(m) {
         return m * 3.28084;
@@ -98,6 +153,30 @@ export class Unit {
     static kelvinToCelsius(k) {
         return k - 273.15;
     }
+    /** Converts Fahrenheit to Kelvin. */
+    static fahrenheitToKelvin(f) {
+        return ((f - 32) * 5) / 9 + 273.15;
+    }
+    /** Converts Kelvin to Fahrenheit. */
+    static kelvinToFahrenheit(k) {
+        return ((k - 273.15) * 9) / 5 + 32;
+    }
+    /** Converts milliliters to liters. */
+    static mlToLiters(ml) {
+        return ml / 1000;
+    }
+    /** Converts liters to milliliters. */
+    static litersToMl(l) {
+        return l * 1000;
+    }
+    /** Converts gallons to milliliters. */
+    static gallonsToMl(gal) {
+        return gal * 3785.41;
+    }
+    /** Converts milliliters to gallons. */
+    static mlToGallons(ml) {
+        return ml / 3785.41;
+    }
     /** Converts liters to gallons. */
     static litersToGallons(l) {
         return l * 0.264172;
@@ -122,6 +201,18 @@ export class Unit {
     static mphToKmph(mph) {
         return mph / 0.621371;
     }
+    /** Converts minutes to hours. */
+    static minutesToHours(min) {
+        return min / 60;
+    }
+    /** Converts seconds to minutes. */
+    static secondsToMinutes(sec) {
+        return sec / 60;
+    }
+    /** Converts hours to days. */
+    static hoursToDays(hr) {
+        return hr / 24;
+    }
     /** Converts hours to minutes. */
     static hoursToMinutes(h) {
         return h * 60;
@@ -146,6 +237,34 @@ export class Unit {
     static kbToMb(kb) {
         return kb / 1024;
     }
+    /** Converts kilobytes to gigabytes. */
+    static kbToGb(kb) {
+        return kb / (1024 * 1024);
+    }
+    /** Converts gigabytes to kilobytes. */
+    static gbToKb(gb) {
+        return gb * 1024 * 1024;
+    }
+    /** Converts bytes to kilobytes. */
+    static bytesToKb(bytes) {
+        return bytes / 1024;
+    }
+    /** Converts kilobytes to bytes. */
+    static kbToBytes(kb) {
+        return kb * 1024;
+    }
+    /** Converts megabytes to kilobytes. */
+    static mbToKb(mb) {
+        return mb * 1024;
+    }
+    /** Converts gigabytes to terabytes. */
+    static gbToTb(gb) {
+        return gb / 1024;
+    }
+    /** Converts terabytes to gigabytes. */
+    static tbToGb(tb) {
+        return tb * 1024;
+    }
     /** Converts joules to calories. */
     static joulesToCalories(j) {
         return j * 0.239006;
@@ -154,6 +273,14 @@ export class Unit {
     static caloriesToJoules(cal) {
         return cal / 0.239006;
     }
+    /** Converts calories to kilojoules. */
+    static caloriesToKJoules(cal) {
+        return cal / 0.239006 / 1000;
+    }
+    /** Converts kilojoules to calories. */
+    static kJoulesToCalories(kj) {
+        return kj * 1000 * 0.239006;
+    }
     /** Converts atmospheres to pascals. */
     static atmToPascal(atm) {
         return atm * 101325;
@@ -162,6 +289,14 @@ export class Unit {
     static pascalToAtm(pa) {
         return pa / 101325;
     }
+    /** Converts bar to pascals. */
+    static barToPascal(bar) {
+        return bar * 100000;
+    }
+    /** Converts pascals to bar. */
+    static pascalToBar(pa) {
+        return pa / 100000;
+    }
     /** Converts hertz to kilohertz. */
     static hzToKHz(hz) {
         return hz / 1000;
@@ -170,4 +305,60 @@ export class Unit {
     static kHzToHz(khz) {
         return khz * 1000;
     }
+    /** Converts hertz to megahertz. */
+    static hzToMHz(hz) {
+        return hz / 1_000_000;
+    }
+    /** Converts megahertz to hertz. */
+    static mHzToHz(mhz) {
+        return mhz * 1_000_000;
+    }
+    /** Converts kilohertz to megahertz. */
+    static kHzToMHz(khz) {
+        return khz / 1000;
+    }
+    /** Converts megahertz to kilohertz. */
+    static mHzToKHz(mhz) {
+        return mhz * 1000;
+    }
+    /** Converts centimeters to meters. */
+    static cmToMeters(cm) {
+        return cm / 100;
+    }
+    /** Converts meters to centimeters. */
+    static metersToCm(m) {
+        return m * 100;
+    }
+    /** Converts millimeters to meters. */
+    static mmToMeters(mm) {
+        return mm / 1000;
+    }
+    /** Converts meters to millimeters. */
+    static metersToMm(m) {
+        return m * 1000;
+    }
+    /** Converts square kilometers to square meters. */
+    static sqkmToSqm(sqkm) {
+        return sqkm * 1_000_000;
+    }
+    /** Converts square meters to square kilometers. */
+    static sqmToSqkm(sqm) {
+        return sqm / 1_000_000;
+    }
+    /** Converts square feet to square inches. */
+    static sqftToSqin(sqft) {
+        return sqft * 144;
+    }
+    /** Converts square inches to square feet. */
+    static sqinToSqft(sqin) {
+        return sqin / 144;
+    }
+    /** Converts watts to kilowatts. */
+    static wattsToKw(w) {
+        return w / 1000;
+    }
+    /** Converts kilowatts to watts. */
+    static kwToWatts(kw) {
+        return kw * 1000;
+    }
 }

package/dist/esm/number/constants.js

@@ -536,10 +536,8 @@ export const SUPPORTED_CURRENCIES = [
     'USD',
     'ZAR',
 ];
-/**
- * @constant Unit names and their full readable labels.
- */
-export const UNIT_LABELS = {
+/** * @constant Unit names and their full readable labels. */
+export const UNITS = {
     // Length
     m: 'Meter',
     km: 'Kilometer',
@@ -582,3 +580,28 @@ export const UNIT_LABELS = {
     hz: 'Hertz',
     khz: 'Kilohertz',
 };
+/** * Scientific SI Unit prefix multipliers. */
+export const PREFIX_MULTIPLIERS = {
+    y: 1e-24,
+    z: 1e-21,
+    a: 1e-18,
+    f: 1e-15,
+    p: 1e-12,
+    n: 1e-9,
+    μ: 1e-6,
+    u: 1e-6,
+    m: 1e-3,
+    c: 1e-2,
+    d: 1e-1,
+    da: 1e1,
+    h: 1e2,
+    k: 1e3,
+    M: 1e6,
+    G: 1e9,
+    T: 1e12,
+    P: 1e15,
+    E: 1e18,
+    Z: 1e21,
+    Y: 1e24,
+    '': 1, // base unit, like meter, gram, byte etc.
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.0.70",
+  "version": "4.0.75",
   "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",