nhb-toolbox 4.23.10 → 4.23.11

package/dist/cjs/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.MONTHS = void 0;
+exports.STATUS_CODES = exports.HTTP_STATUS_CODES = exports.HTTP_STATUS = exports.HTTP_CODES = exports.COUNTRIES = exports.UNITS = exports.LOWERCASED_WORDS = exports.LOCALE_CODES = exports.FRANKFURTER_CURRENCIES = exports.CURRENCY_LOCALES = exports.CURRENCY_CODES = exports.CSS_COLORS = exports.NUMBER_COLOR_PALETTE = exports.ALPHABET_COLOR_PALETTE = exports.WESTERN_SEASONS = exports.US_ACADEMIC_SEASONS = exports.SEASON_PRESETS = exports.PHILIPPINES_SEASONS = exports.JAPAN_SEASONS = exports.INDIA_VEDIC_SEASONS = exports.INDIA_TAMIL_SEASONS = exports.INDIA_IMD_SEASONS = exports.ETHIOPIA_SEASONS = exports.BANGLADESH_SEASONS = exports.AUSTRALIA_SEASONS = exports.WESTERN_ZODIAC_SIGNS = exports.WEEK_DAYS = exports.VEDIC_ZODIAC_SIGNS = exports.TIME_ZONES = exports.TIME_ZONE_LABELS = exports.MONTHS = void 0;
 var constants_1 = require("./date/constants");
 Object.defineProperty(exports, "MONTHS", { enumerable: true, get: function () { return constants_1.MONTHS; } });
 Object.defineProperty(exports, "TIME_ZONE_LABELS", { enumerable: true, get: function () { return constants_1.TIME_ZONE_LABELS; } });
@@ -32,10 +32,12 @@ Object.defineProperty(exports, "FRANKFURTER_CURRENCIES", { enumerable: true, get
 Object.defineProperty(exports, "LOCALE_CODES", { enumerable: true, get: function () { return constants_3.LOCALE_CODES; } });
 var constants_4 = require("./string/constants");
 Object.defineProperty(exports, "LOWERCASED_WORDS", { enumerable: true, get: function () { return constants_4.LOWERCASE; } });
+var constants_5 = require("./converter/constants");
+Object.defineProperty(exports, "UNITS", { enumerable: true, get: function () { return constants_5.UNITS; } });
 var countries_1 = require("./object/countries");
 Object.defineProperty(exports, "COUNTRIES", { enumerable: true, get: function () { return countries_1.COUNTRIES; } });
-var constants_5 = require("./http-status/constants");
-Object.defineProperty(exports, "HTTP_CODES", { enumerable: true, get: function () { return constants_5.HTTP_STATUS_CODES; } });
-Object.defineProperty(exports, "HTTP_STATUS", { enumerable: true, get: function () { return constants_5.HTTP_STATUS_CODES; } });
-Object.defineProperty(exports, "HTTP_STATUS_CODES", { enumerable: true, get: function () { return constants_5.HTTP_STATUS_CODES; } });
-Object.defineProperty(exports, "STATUS_CODES", { enumerable: true, get: function () { return constants_5.HTTP_STATUS_CODES; } });
+var constants_6 = require("./http-status/constants");
+Object.defineProperty(exports, "HTTP_CODES", { enumerable: true, get: function () { return constants_6.HTTP_STATUS_CODES; } });
+Object.defineProperty(exports, "HTTP_STATUS", { enumerable: true, get: function () { return constants_6.HTTP_STATUS_CODES; } });
+Object.defineProperty(exports, "HTTP_STATUS_CODES", { enumerable: true, get: function () { return constants_6.HTTP_STATUS_CODES; } });
+Object.defineProperty(exports, "STATUS_CODES", { enumerable: true, get: function () { return constants_6.HTTP_STATUS_CODES; } });

package/dist/cjs/converter/area.js

@@ -15,11 +15,11 @@ class $Area extends base_1.$BaseConverter {
         'square-metre': 1,
         'square-kilometre': 1e6,
         'square-inch': 0.00064516,
-        'square-foot': 0.092903,
-        'square-yard': 0.836127,
-        'square-mile': 2.59e6,
+        'square-foot': 0.09290304,
+        'square-yard': 0.83612736,
+        'square-mile': 2_589_988.110336,
         hectare: 1e4,
-        acre: 4046.856,
+        acre: 4_046.8564224,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -41,33 +41,23 @@ class $Area extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    'square-millimeter': 'mm²',
-                    'square-centimeter': 'cm²',
-                    'square-meter': 'm²',
-                    'square-kilometer': 'km²',
-                    'square-millimetre': 'mm²',
-                    'square-centimetre': 'cm²',
-                    'square-metre': 'm²',
-                    'square-kilometre': 'km²',
-                    'square-inch': 'in²',
-                    'square-foot': 'ft²',
-                    'square-yard': 'yd²',
-                    'square-mile': 'mi²',
-                    hectare: 'ha',
-                    acre: 'ac',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            'square-millimeter': 'mm²',
+            'square-centimeter': 'cm²',
+            'square-meter': 'm²',
+            'square-kilometer': 'km²',
+            'square-millimetre': 'mm²',
+            'square-centimetre': 'cm²',
+            'square-metre': 'm²',
+            'square-kilometre': 'km²',
+            'square-inch': 'in²',
+            'square-foot': 'ft²',
+            'square-yard': 'yd²',
+            'square-mile': 'mi²',
+            hectare: 'ha',
+            acre: 'ac',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Area = $Area;

package/dist/cjs/converter/base.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.$BaseConverter = void 0;
+const constants_1 = require("./constants");
 class $BaseConverter {
     value;
     unit;
@@ -20,6 +21,18 @@ class $BaseConverter {
         const factor = 10 ** decimals;
         return Math.round(value * factor) / factor;
     }
+    $formatTo(value, target, shortLabels, options) {
+        const { style = 'plural', decimals = 2 } = options ?? {};
+        const rounded = this.$round(value, decimals);
+        switch (style) {
+            case 'compact':
+                return `${rounded}${shortLabels[target]}`;
+            case 'scientific':
+                return `${value.toExponential(decimals)} ${target}`;
+            default:
+                return this.$withPluralUnit(rounded, target);
+        }
+    }
     valueOf() {
         return this.value;
     }
@@ -67,7 +80,13 @@ class $BaseConverter {
         return this.value === Number(n);
     }
     format(decimals = 2) {
-        return `${this.$round(this.value, decimals)} ${this.unit}`;
+        return this.$withPluralUnit(this.$round(this.value, decimals));
+    }
+    supportedUnits(category) {
+        if (category && category in constants_1.UNITS) {
+            return [...constants_1.UNITS[category]];
+        }
+        return Object.values(constants_1.UNITS).flat();
     }
 }
 exports.$BaseConverter = $BaseConverter;

package/dist/cjs/converter/data.js

@@ -39,31 +39,21 @@ class $Data extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    bit: 'b',
-                    byte: 'B',
-                    kilobit: 'Kb',
-                    kilobyte: 'KB',
-                    megabit: 'Mb',
-                    megabyte: 'MB',
-                    gigabit: 'Gb',
-                    gigabyte: 'GB',
-                    terabit: 'Tb',
-                    terabyte: 'TB',
-                    petabit: 'Pb',
-                    petabyte: 'PB',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            bit: 'b',
+            byte: 'B',
+            kilobit: 'Kb',
+            kilobyte: 'KB',
+            megabit: 'Mb',
+            megabyte: 'MB',
+            gigabit: 'Gb',
+            gigabyte: 'GB',
+            terabit: 'Tb',
+            terabyte: 'TB',
+            petabit: 'Pb',
+            petabyte: 'PB',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Data = $Data;

package/dist/cjs/converter/length.js

@@ -19,7 +19,7 @@ class $Length extends base_1.$BaseConverter {
         yard: 0.9144,
         mile: 1609.344,
         'nautical-mile': 1852,
-        'light-year': 9.4607e15,
+        'light-year': 9.4607_3047_25808e15,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -41,33 +41,23 @@ class $Length extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    millimeter: 'mm',
-                    centimeter: 'cm',
-                    meter: 'm',
-                    kilometer: 'km',
-                    millimetre: 'mm',
-                    centimetre: 'cm',
-                    metre: 'm',
-                    kilometre: 'km',
-                    inch: 'in',
-                    foot: 'ft',
-                    yard: 'yd',
-                    mile: 'mi',
-                    'nautical-mile': 'nmi',
-                    'light-year': 'ly',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            millimeter: 'mm',
+            centimeter: 'cm',
+            meter: 'm',
+            kilometer: 'km',
+            millimetre: 'mm',
+            centimetre: 'cm',
+            metre: 'm',
+            kilometre: 'km',
+            inch: 'in',
+            foot: 'ft',
+            yard: 'yd',
+            mile: 'mi',
+            'nautical-mile': 'nmi',
+            'light-year': 'ly',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Length = $Length;

package/dist/cjs/converter/mass.js

@@ -11,11 +11,11 @@ class $Mass extends base_1.$BaseConverter {
         gram: 0.001,
         kilogram: 1,
         tonne: 1000,
-        ounce: 0.0283495,
-        pound: 0.453592,
-        stone: 6.35029,
-        'short-ton': 907.185,
-        'long-ton': 1016.05,
+        ounce: 0.028349523125,
+        pound: 0.45359237,
+        stone: 6.35029318,
+        'short-ton': 907.18474,
+        'long-ton': 1016.0469088,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -37,29 +37,19 @@ class $Mass extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    microgram: 'µg',
-                    milligram: 'mg',
-                    gram: 'g',
-                    kilogram: 'kg',
-                    tonne: 't',
-                    ounce: 'oz',
-                    pound: 'lb',
-                    stone: 'st',
-                    'short-ton': 't (US)',
-                    'long-ton': 't (UK)',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            microgram: 'µg',
+            milligram: 'mg',
+            gram: 'g',
+            kilogram: 'kg',
+            tonne: 't',
+            ounce: 'oz',
+            pound: 'lb',
+            stone: 'st',
+            'short-ton': 't (US)',
+            'long-ton': 't (UK)',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Mass = $Mass;

package/dist/cjs/converter/temp.js

@@ -40,22 +40,12 @@ class $Temperature extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    celsius: '°C',
-                    fahrenheit: '°F',
-                    kelvin: 'K',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            celsius: '°C',
+            fahrenheit: '°F',
+            kelvin: 'K',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Temperature = $Temperature;

package/dist/cjs/converter/time.js

@@ -40,32 +40,22 @@ class $Time extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    nanosecond: 'ns',
-                    microsecond: 'µs',
-                    millisecond: 'ms',
-                    second: 's',
-                    minute: 'min',
-                    hour: 'h',
-                    day: 'd',
-                    week: 'wk',
-                    month: 'mo',
-                    year: 'yr',
-                    decade: 'dec',
-                    century: 'cen',
-                    millennium: 'mil',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            nanosecond: 'ns',
+            microsecond: 'µs',
+            millisecond: 'ms',
+            second: 's',
+            minute: 'min',
+            hour: 'h',
+            day: 'd',
+            week: 'wk',
+            month: 'mo',
+            year: 'yr',
+            decade: 'dec',
+            century: 'cen',
+            millennium: 'mil',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Time = $Time;

package/dist/cjs/converter/volume.js

@@ -14,19 +14,19 @@ class $Volume extends base_1.$BaseConverter {
         'cubic-centimetre': 1e-6,
         'cubic-metre': 1,
         'cubic-kilometre': 1e9,
-        'cubic-inch': 1.6387e-5,
-        'cubic-foot': 0.0283168,
-        'cubic-yard': 0.764555,
+        'cubic-inch': 0.000016387064,
+        'cubic-foot': 0.028316846592,
+        'cubic-yard': 0.764554857984,
         liter: 0.001,
         litre: 0.001,
         milliliter: 1e-6,
         millilitre: 1e-6,
-        gallon: 0.00378541,
-        quart: 0.000946353,
-        pint: 0.000473176,
-        cup: 0.000236588,
-        tablespoon: 1.47868e-5,
-        teaspoon: 4.92892e-6,
+        gallon: 0.003785411784,
+        quart: 0.000946352946,
+        pint: 0.000473176473,
+        cup: 0.0002365882365,
+        tablespoon: 0.00001478676478125,
+        teaspoon: 0.00000492892159375,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -48,40 +48,30 @@ class $Volume extends base_1.$BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    'cubic-millimeter': 'mm³',
-                    'cubic-centimeter': 'cm³',
-                    'cubic-meter': 'm³',
-                    'cubic-kilometer': 'km³',
-                    'cubic-millimetre': 'mm³',
-                    'cubic-centimetre': 'cm³',
-                    'cubic-metre': 'm³',
-                    'cubic-kilometre': 'km³',
-                    'cubic-inch': 'in³',
-                    'cubic-foot': 'ft³',
-                    'cubic-yard': 'yd³',
-                    liter: 'L',
-                    litre: 'L',
-                    milliliter: 'mL',
-                    millilitre: 'mL',
-                    gallon: 'gal',
-                    quart: 'qt',
-                    pint: 'pt',
-                    cup: 'c',
-                    tablespoon: 'tbsp',
-                    teaspoon: 'tsp',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            'cubic-millimeter': 'mm³',
+            'cubic-centimeter': 'cm³',
+            'cubic-meter': 'm³',
+            'cubic-kilometer': 'km³',
+            'cubic-millimetre': 'mm³',
+            'cubic-centimetre': 'cm³',
+            'cubic-metre': 'm³',
+            'cubic-kilometre': 'km³',
+            'cubic-inch': 'in³',
+            'cubic-foot': 'ft³',
+            'cubic-yard': 'yd³',
+            liter: 'L',
+            litre: 'L',
+            milliliter: 'mL',
+            millilitre: 'mL',
+            gallon: 'gal',
+            quart: 'qt',
+            pint: 'pt',
+            cup: 'c',
+            tablespoon: 'tbsp',
+            teaspoon: 'tsp',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 exports.$Volume = $Volume;

package/dist/dts/constants.d.ts

@@ -4,5 +4,6 @@ export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants
 export { CSS_COLORS } from './colors/css-colors';
 export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, LOCALE_CODES, } from './number/constants';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants';
+export { UNITS } from './converter/constants';
 export { COUNTRIES } from './object/countries';
 export { HTTP_STATUS_CODES as HTTP_CODES, HTTP_STATUS_CODES as HTTP_STATUS, HTTP_STATUS_CODES, HTTP_STATUS_CODES as STATUS_CODES, } from './http-status/constants';

package/dist/dts/converter/base.d.ts

@@ -1,22 +1,32 @@
 import type { Numeric } from '../types/index';
-import type { $Unit } from './types';
+import type { Tuple } from '../utils/types';
+import type { $Unit, Category, CategoryUnits, ConverterFormatOptions } from './types';
 /**
  * @description Base class providing common mathematical and formatting utilities
  * for all unit converters (time, length, data, temperature, etc.).
  */
-export declare class $BaseConverter<U extends $Unit> {
+export declare class $BaseConverter<Unit extends $Unit> {
     protected readonly value: number;
-    protected readonly unit: U;
+    protected readonly unit: Unit;
     /**
      * Convert value to other units
      * @param value Number or numeric string value to convert.
      * @param unit Optional base unit for the provided value.
      */
-    constructor(value: Numeric, unit?: U);
-    /** * Returns a grammatically correct unit string, prefixed with the number value. */
+    constructor(value: Numeric, unit?: Unit);
+    /** @protected Returns a grammatically correct unit string, prefixed with the number value. */
     protected $withPluralUnit(value?: number, unit?: $Unit): string;
-    /** * Rounds a numeric value to given decimal places. */
+    /** @protected Rounds a numeric value to given decimal places. */
     protected $round(value: number, decimals?: number): number;
+    /**
+     * @protected Shared formatter for all converters.
+     * @param value Converted value (already computed via `.to(target)`).
+     * @param target Target unit name.
+     * @param shortLabels Record of compact unit labels.
+     * @param options Formatting options.
+     * @returns Formatted string according to style (compact, plural, scientific).
+     */
+    protected $formatTo(value: number, target: Unit, shortLabels: Record<Unit, string>, options: ConverterFormatOptions | undefined): string;
     /**
      * @instance Returns the numeric value.
      * @returns The raw numeric value without unit.
@@ -31,10 +41,15 @@ export declare class $BaseConverter<U extends $Unit> {
      * @instance Returns the unit name.
      * @returns The current unit.
      */
-    getUnit(): U;
+    getUnit(): Unit;
     /**
      * @instance Returns the original value with formatted pluralized unit.
-     * @returns A string like "3 hours" or "1 minute".
+     * @returns A string like `"3 hours"` or `"1 minute"` or `"3"` if no unit is provided.
+     *
+     * @remarks
+     * - This method is automatically called when the instance is used in a string context.
+     * - For complex and versatile pluralization, please refer to {@link https://toolbox.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
+
      */
     toString(): string;
     /**
@@ -43,7 +58,7 @@ export declare class $BaseConverter<U extends $Unit> {
      */
     toObject(): {
         value: number;
-        unit: U;
+        unit: Unit;
     };
     /**
      * @instance Converts to JSON representation.
@@ -87,9 +102,22 @@ export declare class $BaseConverter<U extends $Unit> {
     /** * @instance Returns whether this value equals another numeric value. */
     eq(n: Numeric): boolean;
     /**
-     * @instance Returns a human-friendly formatted string with fixed decimals.
-     * @param decimals Number of decimal places.
-     * @returns Formatted string.
+     * @instance Returns a human-friendly formatted string with fixed decimals (if the value is fraction).
+     * @param decimals Number of decimal places for fractional value.
+     * @returns Formatted string with proper unit pluralization.
+     *
+     * @remarks For complex and versatile pluralization, please refer to {@link https://toolbox.nazmul-nhb.dev/docs/utilities/string/pluralizer pluralizer} or {@link https://toolbox.nazmul-nhb.dev/docs/classes/Pluralizer Pluralizer Class} instead.
      */
     format(decimals?: number): string;
+    /**
+     * @instance Returns all supported units.
+     * @returns Array of supported unit strings.
+     */
+    supportedUnits(): Array<$Unit>;
+    /**
+     * @instance Returns all supported units for a specific category.
+     * @param category Category to filter units by.
+     * @returns Tuple of supported units for the specified category.
+     */
+    supportedUnits<Cat extends Category>(category: Cat): Tuple<CategoryUnits<Cat>>;
 }

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

@@ -1,4 +1,4 @@
-/** Record of Units */
+/** Record of Units (Categorized) */
 export declare const UNITS: Readonly<{
     readonly time: readonly ["nanosecond", "microsecond", "millisecond", "second", "minute", "hour", "day", "week", "month", "year", "decade", "century", "millennium"];
     readonly length: readonly ["millimeter", "centimeter", "meter", "kilometer", "millimetre", "centimetre", "metre", "kilometre", "inch", "foot", "yard", "mile", "nautical-mile", "light-year"];

package/dist/dts/converter/temp.d.ts

@@ -28,7 +28,7 @@ export declare class $Temperature extends $BaseConverter<$TempUnit> {
      * @instance Formats the converted value and unit.
      * @param target Target unit to format to.
      * @param options Formatting options.
-     * @returns Formatted string like "5°F", "5.25 kelvins", or "5e+3 celsius".
+     * @returns Formatted string like "95°F", "5.25 kelvins", or "5e+3 celsius".
      */
     formatTo(target: $TempUnit, options?: ConverterFormatOptions): string;
 }

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

@@ -22,6 +22,8 @@ export type $Unit = LooseLiteral<UnitMap[Category]>;
 export type InferCategory<U extends $Unit> = {
     [K in Category]: U extends UnitMap[K] ? K : never;
 }[Category];
+/** Infer Units belong to a specific Category */
+export type CategoryUnits<Cat extends Category> = UnitMap[Cat];
 /** * Type for the returned converter instance based on the provided unit `U`. */
 export type Converted<U extends $Unit> = InferCategory<U> extends never ? $BaseConverter<U> : InferCategory<U> extends 'area' ? $Area : InferCategory<U> extends 'time' ? $Time : InferCategory<U> extends 'length' ? $Length : InferCategory<U> extends 'mass' ? $Mass : InferCategory<U> extends 'data' ? $Data : InferCategory<U> extends 'temp' ? $Temperature : InferCategory<U> extends 'volume' ? $Volume : $BaseConverter<U>;
 /** * Options for formatting converted values. */

package/dist/dts/converter/volume.d.ts

@@ -28,7 +28,7 @@ export declare class $Volume extends $BaseConverter<$VolumeUnit> {
      * @instance Formats the converted value and unit.
      * @param target Target unit to format to.
      * @param options Formatting options.
-     * @returns Formatted string like "5hm³", "5.25 cubic-meters", or "5e+3 meter".
+     * @returns Formatted string like "5m³", "5.25 cubic-meters", or "5e+3 meter".
      */
     formatTo(target: $VolumeUnit, options?: ConverterFormatOptions): string;
 }

package/dist/esm/constants.js

@@ -4,5 +4,6 @@ export { ALPHABET_COLOR_PALETTE, NUMBER_COLOR_PALETTE } from './colors/constants
 export { CSS_COLORS } from './colors/css-colors.js';
 export { CURRENCY_CODES, CURRENCY_LOCALES, SUPPORTED_CURRENCIES as FRANKFURTER_CURRENCIES, LOCALE_CODES, } from './number/constants.js';
 export { LOWERCASE as LOWERCASED_WORDS } from './string/constants.js';
+export { UNITS } from './converter/constants.js';
 export { COUNTRIES } from './object/countries.js';
 export { HTTP_STATUS_CODES as HTTP_CODES, HTTP_STATUS_CODES as HTTP_STATUS, HTTP_STATUS_CODES, HTTP_STATUS_CODES as STATUS_CODES, } from './http-status/constants.js';

package/dist/esm/converter/area.js

@@ -12,11 +12,11 @@ export class $Area extends $BaseConverter {
         'square-metre': 1,
         'square-kilometre': 1e6,
         'square-inch': 0.00064516,
-        'square-foot': 0.092903,
-        'square-yard': 0.836127,
-        'square-mile': 2.59e6,
+        'square-foot': 0.09290304,
+        'square-yard': 0.83612736,
+        'square-mile': 2_589_988.110336,
         hectare: 1e4,
-        acre: 4046.856,
+        acre: 4_046.8564224,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -38,33 +38,23 @@ export class $Area extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    'square-millimeter': 'mm²',
-                    'square-centimeter': 'cm²',
-                    'square-meter': 'm²',
-                    'square-kilometer': 'km²',
-                    'square-millimetre': 'mm²',
-                    'square-centimetre': 'cm²',
-                    'square-metre': 'm²',
-                    'square-kilometre': 'km²',
-                    'square-inch': 'in²',
-                    'square-foot': 'ft²',
-                    'square-yard': 'yd²',
-                    'square-mile': 'mi²',
-                    hectare: 'ha',
-                    acre: 'ac',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            'square-millimeter': 'mm²',
+            'square-centimeter': 'cm²',
+            'square-meter': 'm²',
+            'square-kilometer': 'km²',
+            'square-millimetre': 'mm²',
+            'square-centimetre': 'cm²',
+            'square-metre': 'm²',
+            'square-kilometre': 'km²',
+            'square-inch': 'in²',
+            'square-foot': 'ft²',
+            'square-yard': 'yd²',
+            'square-mile': 'mi²',
+            hectare: 'ha',
+            acre: 'ac',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Area;

package/dist/esm/converter/base.js

@@ -1,3 +1,4 @@
+import { UNITS } from './constants.js';
 export class $BaseConverter {
     value;
     unit;
@@ -17,6 +18,18 @@ export class $BaseConverter {
         const factor = 10 ** decimals;
         return Math.round(value * factor) / factor;
     }
+    $formatTo(value, target, shortLabels, options) {
+        const { style = 'plural', decimals = 2 } = options ?? {};
+        const rounded = this.$round(value, decimals);
+        switch (style) {
+            case 'compact':
+                return `${rounded}${shortLabels[target]}`;
+            case 'scientific':
+                return `${value.toExponential(decimals)} ${target}`;
+            default:
+                return this.$withPluralUnit(rounded, target);
+        }
+    }
     valueOf() {
         return this.value;
     }
@@ -64,6 +77,12 @@ export class $BaseConverter {
         return this.value === Number(n);
     }
     format(decimals = 2) {
-        return `${this.$round(this.value, decimals)} ${this.unit}`;
+        return this.$withPluralUnit(this.$round(this.value, decimals));
+    }
+    supportedUnits(category) {
+        if (category && category in UNITS) {
+            return [...UNITS[category]];
+        }
+        return Object.values(UNITS).flat();
     }
 }

package/dist/esm/converter/data.js

@@ -36,31 +36,21 @@ export class $Data extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    bit: 'b',
-                    byte: 'B',
-                    kilobit: 'Kb',
-                    kilobyte: 'KB',
-                    megabit: 'Mb',
-                    megabyte: 'MB',
-                    gigabit: 'Gb',
-                    gigabyte: 'GB',
-                    terabit: 'Tb',
-                    terabyte: 'TB',
-                    petabit: 'Pb',
-                    petabyte: 'PB',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            bit: 'b',
+            byte: 'B',
+            kilobit: 'Kb',
+            kilobyte: 'KB',
+            megabit: 'Mb',
+            megabyte: 'MB',
+            gigabit: 'Gb',
+            gigabyte: 'GB',
+            terabit: 'Tb',
+            terabyte: 'TB',
+            petabit: 'Pb',
+            petabyte: 'PB',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Data;

package/dist/esm/converter/length.js

@@ -16,7 +16,7 @@ export class $Length extends $BaseConverter {
         yard: 0.9144,
         mile: 1609.344,
         'nautical-mile': 1852,
-        'light-year': 9.4607e15,
+        'light-year': 9.4607_3047_25808e15,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -38,33 +38,23 @@ export class $Length extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    millimeter: 'mm',
-                    centimeter: 'cm',
-                    meter: 'm',
-                    kilometer: 'km',
-                    millimetre: 'mm',
-                    centimetre: 'cm',
-                    metre: 'm',
-                    kilometre: 'km',
-                    inch: 'in',
-                    foot: 'ft',
-                    yard: 'yd',
-                    mile: 'mi',
-                    'nautical-mile': 'nmi',
-                    'light-year': 'ly',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            millimeter: 'mm',
+            centimeter: 'cm',
+            meter: 'm',
+            kilometer: 'km',
+            millimetre: 'mm',
+            centimetre: 'cm',
+            metre: 'm',
+            kilometre: 'km',
+            inch: 'in',
+            foot: 'ft',
+            yard: 'yd',
+            mile: 'mi',
+            'nautical-mile': 'nmi',
+            'light-year': 'ly',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Length;

package/dist/esm/converter/mass.js

@@ -8,11 +8,11 @@ export class $Mass extends $BaseConverter {
         gram: 0.001,
         kilogram: 1,
         tonne: 1000,
-        ounce: 0.0283495,
-        pound: 0.453592,
-        stone: 6.35029,
-        'short-ton': 907.185,
-        'long-ton': 1016.05,
+        ounce: 0.028349523125,
+        pound: 0.45359237,
+        stone: 6.35029318,
+        'short-ton': 907.18474,
+        'long-ton': 1016.0469088,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -34,29 +34,19 @@ export class $Mass extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    microgram: 'µg',
-                    milligram: 'mg',
-                    gram: 'g',
-                    kilogram: 'kg',
-                    tonne: 't',
-                    ounce: 'oz',
-                    pound: 'lb',
-                    stone: 'st',
-                    'short-ton': 't (US)',
-                    'long-ton': 't (UK)',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            microgram: 'µg',
+            milligram: 'mg',
+            gram: 'g',
+            kilogram: 'kg',
+            tonne: 't',
+            ounce: 'oz',
+            pound: 'lb',
+            stone: 'st',
+            'short-ton': 't (US)',
+            'long-ton': 't (UK)',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Mass;

package/dist/esm/converter/temp.js

@@ -37,21 +37,11 @@ export class $Temperature extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    celsius: '°C',
-                    fahrenheit: '°F',
-                    kelvin: 'K',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            celsius: '°C',
+            fahrenheit: '°F',
+            kelvin: 'K',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }

package/dist/esm/converter/time.js

@@ -37,32 +37,22 @@ export class $Time extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    nanosecond: 'ns',
-                    microsecond: 'µs',
-                    millisecond: 'ms',
-                    second: 's',
-                    minute: 'min',
-                    hour: 'h',
-                    day: 'd',
-                    week: 'wk',
-                    month: 'mo',
-                    year: 'yr',
-                    decade: 'dec',
-                    century: 'cen',
-                    millennium: 'mil',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            nanosecond: 'ns',
+            microsecond: 'µs',
+            millisecond: 'ms',
+            second: 's',
+            minute: 'min',
+            hour: 'h',
+            day: 'd',
+            week: 'wk',
+            month: 'mo',
+            year: 'yr',
+            decade: 'dec',
+            century: 'cen',
+            millennium: 'mil',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Time;

package/dist/esm/converter/volume.js

@@ -11,19 +11,19 @@ export class $Volume extends $BaseConverter {
         'cubic-centimetre': 1e-6,
         'cubic-metre': 1,
         'cubic-kilometre': 1e9,
-        'cubic-inch': 1.6387e-5,
-        'cubic-foot': 0.0283168,
-        'cubic-yard': 0.764555,
+        'cubic-inch': 0.000016387064,
+        'cubic-foot': 0.028316846592,
+        'cubic-yard': 0.764554857984,
         liter: 0.001,
         litre: 0.001,
         milliliter: 1e-6,
         millilitre: 1e-6,
-        gallon: 0.00378541,
-        quart: 0.000946353,
-        pint: 0.000473176,
-        cup: 0.000236588,
-        tablespoon: 1.47868e-5,
-        teaspoon: 4.92892e-6,
+        gallon: 0.003785411784,
+        quart: 0.000946352946,
+        pint: 0.000473176473,
+        cup: 0.0002365882365,
+        tablespoon: 0.00001478676478125,
+        teaspoon: 0.00000492892159375,
     };
     constructor(value, unit) {
         super(value, unit);
@@ -45,40 +45,30 @@ export class $Volume extends $BaseConverter {
     }
     formatTo(target, options) {
         const value = this.to(target);
-        const { style = 'plural', decimals = 2 } = options ?? {};
-        const rounded = this.$round(value, decimals);
-        switch (style) {
-            case 'compact': {
-                const shortLabels = {
-                    'cubic-millimeter': 'mm³',
-                    'cubic-centimeter': 'cm³',
-                    'cubic-meter': 'm³',
-                    'cubic-kilometer': 'km³',
-                    'cubic-millimetre': 'mm³',
-                    'cubic-centimetre': 'cm³',
-                    'cubic-metre': 'm³',
-                    'cubic-kilometre': 'km³',
-                    'cubic-inch': 'in³',
-                    'cubic-foot': 'ft³',
-                    'cubic-yard': 'yd³',
-                    liter: 'L',
-                    litre: 'L',
-                    milliliter: 'mL',
-                    millilitre: 'mL',
-                    gallon: 'gal',
-                    quart: 'qt',
-                    pint: 'pt',
-                    cup: 'c',
-                    tablespoon: 'tbsp',
-                    teaspoon: 'tsp',
-                };
-                return `${rounded}${shortLabels[target]}`;
-            }
-            case 'scientific':
-                return `${value.toExponential(decimals)} ${target}`;
-            default:
-                return this.$withPluralUnit(rounded, target);
-        }
+        const shortLabels = {
+            'cubic-millimeter': 'mm³',
+            'cubic-centimeter': 'cm³',
+            'cubic-meter': 'm³',
+            'cubic-kilometer': 'km³',
+            'cubic-millimetre': 'mm³',
+            'cubic-centimetre': 'cm³',
+            'cubic-metre': 'm³',
+            'cubic-kilometre': 'km³',
+            'cubic-inch': 'in³',
+            'cubic-foot': 'ft³',
+            'cubic-yard': 'yd³',
+            liter: 'L',
+            litre: 'L',
+            milliliter: 'mL',
+            millilitre: 'mL',
+            gallon: 'gal',
+            quart: 'qt',
+            pint: 'pt',
+            cup: 'c',
+            tablespoon: 'tbsp',
+            teaspoon: 'tsp',
+        };
+        return this.$formatTo(value, target, shortLabels, options);
     }
 }
 _a = $Volume;

package/package.json

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