nhb-toolbox 4.0.57 → 4.0.70

package/dist/cjs/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getAverageOfNumbers = exports.getAverage = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateAverage = exports.wordCount = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
-exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.roundNumber = exports.numberToOrdinal = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.numberToWords = exports.convertToRomanNumerals = exports.convertNumberToWords = exports.isPerfectSquare = exports.isParOfFibonacciSeries = exports.isParOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isMultiple = exports.isInvalidNumbers = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = void 0;
-exports.getDuplicatesFromArray = exports.getDuplicates = exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getMinutesFromUTC = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.greet = exports.getGreeting = exports.generateGreeting = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = void 0;
-exports.getQueryParams = exports.generateQueryParams = exports.formatQueryParams = exports.createQueryParams = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedValues = exports.parseStringifiedPrimitives = exports.parseStringifiedObjectValues = exports.parsePrimitives = exports.parsePrimitiveData = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.getMissingElements = void 0;
-exports.isFunction = exports.isError = exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isBigInt = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.getQueryStringAsObject = exports.queryStringToObject = exports.parseQueryString = void 0;
-exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = void 0;
+exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = exports.Unit = exports.Currency = exports.sumOfNumbers = exports.sumNumbers = exports.sumDigits = exports.reverseNumber = exports.getSumOfNumbers = exports.getRandomNumber = exports.getAverageOfNumbers = exports.getAverage = exports.convertToDecimal = exports.calculateLCM = exports.calculateLCD = exports.calculateHCF = exports.calculateGCD = exports.calculateAverage = exports.wordCount = exports.levenshteinDistance = exports.getLevenshteinDistance = exports.extractNumbersFromString = exports.countWordsInString = exports.countWords = exports.slugifyString = exports.reverseString = exports.replaceAllInString = exports.normalizeString = exports.maskString = exports.formatWithPlural = exports.formatUnitWithPlural = exports.formatNumberWithPluralUnit = exports.extractURLs = exports.extractEmails = exports.convertStringCase = exports.isSnakeCase = exports.isPascalCase = exports.isPalindrome = exports.isKebabCase = exports.isEmojiOnly = exports.isCamelCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHslaToHex8 = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertHex8ToHsla = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.roundToNearestInterval = exports.roundToNearest = exports.roundNumberToNearestInterval = exports.roundNumber = exports.numberToOrdinal = exports.getRandomFloat = exports.getRandomDecimal = exports.getOrdinalNumber = exports.getOrdinal = exports.formatCurrency = exports.convertToOrdinal = exports.convertNumberToOrdinal = exports.convertNumberToCurrency = exports.clampNumber = exports.cardinalToOrdinal = exports.isPrimeNumber = exports.isPrime = exports.getPrimeNumbers = exports.findPrimeNumbers = exports.numberToWords = exports.convertToRomanNumerals = exports.convertNumberToWords = exports.isPerfectSquare = exports.isParOfFibonacciSeries = exports.isParOfFibonacci = exports.isOddNumber = exports.isOdd = exports.isMultiple = exports.isInvalidNumbers = exports.isFibonacci = exports.isEvenNumber = exports.isEven = exports.areInvalidNumbers = exports.getNthFibonacci = exports.getMemoizedFibonacciSeries = exports.getMemoizedFibonacci = exports.getFibonacciSeriesMemo = void 0;
+exports.findMissingElements = exports.extractMissingElements = exports.extractDuplicatesFromArray = exports.extractDuplicates = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidEmptyArray = exports.isInvalidOrEmptyArray = exports.getLastArrayElement = exports.flattenArray = exports.filterArrayOfObjects = exports.minutesToUTCOffset = exports.getTotalMinutesFromUTC = exports.getTotalMinutesFromTime = exports.getTotalMinutes = exports.getTimeStringFromUTC = exports.getMinutesFromUTC = exports.getCurrentTime = exports.getCurrentDateTime = exports.formatUTCOffset = exports.extractTotalMinutesFromTime = exports.extractTimeStringFromUTC = exports.extractTimeFromUTC = exports.extractMinutesFromUTC = exports.extractHourMinute = exports.convertMinutesToUTCOffset = exports.chronusts = exports.chronusjs = exports.chronus = exports.chronosts = exports.chronosjs = exports.chronos = exports.Chronus = exports.Chronos = exports.isValidUTCOffSet = exports.isValidUTC = exports.isValidTimeString = exports.isValidTime = exports.isLeapYear = exports.greet = exports.getGreeting = exports.generateGreeting = exports.Colour = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = void 0;
+exports.formatQueryParams = exports.createQueryParams = exports.remapObjectFields = exports.remapFields = exports.pickObjectFieldsByCondition = exports.pickObjectFields = exports.pickFieldsByCondition = exports.pickFields = exports.convertObjectValues = exports.sanitizeData = exports.parseStringifiedValues = exports.parseStringifiedPrimitives = exports.parseStringifiedObjectValues = exports.parsePrimitives = exports.parsePrimitiveData = exports.parseObjectValues = exports.parseJsonToObject = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObjectKeyValue = exports.flattenObjectDotNotation = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.countObjectFields = exports.cloneObject = exports.isValidFormData = exports.isOriginFileObj = exports.isFileUpload = exports.isFileList = exports.isFileArray = exports.isCustomFileArray = exports.isCustomFile = exports.serializeForm = exports.parseFormData = exports.createFormData = exports.createControlledFormData = exports.convertIntoFormData = exports.naturalSortForString = exports.naturalSort = exports.compareSorter = exports.compareNaturally = exports.splitArray = exports.rotateArray = exports.removeDuplicatesFromArray = exports.removeDuplicates = exports.moveArrayElement = exports.getMissingElements = exports.getDuplicatesFromArray = exports.getDuplicates = void 0;
+exports.isEmptyObjectGuard = exports.isEmptyObject = exports.isDate = exports.isBigInt = exports.isArrayWithLength = exports.isArrayOfType = exports.isArray = exports.doesReturnPromise = exports.isUndefined = exports.isTruthy = exports.isSymbol = exports.isString = exports.isPrimitive = exports.isPositiveInteger = exports.isNumber = exports.isNull = exports.isNonEmptyString = exports.isInteger = exports.isFalsy = exports.isBoolean = exports.throttleAction = exports.parsePrimitivesDeep = exports.parseJsonDeep = exports.parseJSON = exports.isDeepEqual = exports.getStaticMethodsCount = exports.getStaticMethodNames = exports.getInstanceMethodsCount = exports.getInstanceMethodNames = exports.getClassDetails = exports.deepParsePrimitives = exports.debounceAction = exports.countStaticMethods = exports.countInstanceMethods = exports.convertArrayToString = exports.saveToSessionStorage = exports.saveToLocalStorage = exports.removeFromSessionStorage = exports.removeFromLocalStorage = exports.getFromSessionStorage = exports.getFromLocalStorage = exports.toggleFullScreen = exports.smoothScrollTo = exports.copyToClipboard = exports.updateQueryParam = exports.getQueryStringAsObject = exports.queryStringToObject = exports.parseQueryString = exports.getQueryParams = exports.generateQueryParams = void 0;
+exports.isValidURL = exports.isValidEmail = exports.isUUID = exports.isURL = exports.isPhoneNumber = exports.isNumericString = exports.isNodeEnvironment = exports.isNodeENV = exports.isNode = exports.isIPAddress = exports.isExpectedNodeENV = exports.isEnvironment = exports.isEmailArray = exports.isEmail = exports.isDateString = exports.isBrowser = exports.isBase64 = exports.isValidSet = exports.isValidObject = exports.isValidMap = exports.isValidJSON = exports.isValidArray = exports.isSet = exports.isReturningPromise = exports.isRegularExpression = exports.isRegExp = exports.isPromise = exports.isObjectWithKeys = exports.isObjectEmpty = exports.isObject = exports.isNotEmptyObject = exports.isMethodDescriptor = exports.isMethod = exports.isMap = exports.isJSONObject = exports.isJSON = exports.isFunction = exports.isError = void 0;
 // ! String Utilities
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
@@ -56,6 +56,10 @@ Object.defineProperty(exports, "reverseNumber", { enumerable: true, get: functio
 Object.defineProperty(exports, "sumDigits", { enumerable: true, get: function () { return basics_2.sumDigits; } });
 Object.defineProperty(exports, "sumNumbers", { enumerable: true, get: function () { return basics_2.sumNumbers; } });
 Object.defineProperty(exports, "sumOfNumbers", { enumerable: true, get: function () { return basics_2.sumNumbers; } });
+var Currency_1 = require("./number/Currency");
+Object.defineProperty(exports, "Currency", { enumerable: true, get: function () { return Currency_1.Currency; } });
+var Unit_1 = require("./number/Unit");
+Object.defineProperty(exports, "Unit", { enumerable: true, get: function () { return Unit_1.Unit; } });
 var percent_1 = require("./number/percent");
 Object.defineProperty(exports, "calculatePercentage", { enumerable: true, get: function () { return percent_1.calculatePercentage; } });
 var fibonacci_1 = require("./number/fibonacci");

package/dist/cjs/number/Currency.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Currency = void 0;
+const utilities_1 = require("./utilities");
+const rateCache = new Map();
+/**
+ * * A utility class for handling currency operations like formatting and conversion.
+ *
+ * - Supports formatting based on locale.
+ * - Converts between **fiat currencies supported by `api.frankfurter.app`**.
+ * - Automatically caches conversion rates to reduce redundant API calls.
+ * - Intended for use with numeric inputs (number or numeric string).
+ */
+class Currency {
+    #amount;
+    #code;
+    /**
+     * * The formatted currency string (e.g., `$1,000.00`).
+     *
+     * - Generated using the `en-US` locale during construction.
+     * - This is a display-friendly version of the currency value.
+     * - For formatting with other locales, use the `format(locale)` method.
+     */
+    currency;
+    /**
+     * Creates an instance of the Currency class.
+     *
+     * @param amount - The numeric amount of currency (e.g., `100`, `'99.99'`).
+     * @param code - The ISO 4217 currency code representing the currency (e.g., `'USD'`, `'EUR'`).
+     */
+    constructor(amount, code) {
+        this.#amount = Number(amount);
+        this.#code = code;
+        this.currency = this.format('en-US');
+    }
+    /**
+     * @instance Formats the currency for a given locale.
+     * @param locale - The target locale (e.g., 'de-DE')
+     * @returns The formatted currency string
+     */
+    format(locale) {
+        return (0, utilities_1.formatCurrency)(this.#amount, this.#code, locale);
+    }
+    /**
+     * @instance Converts the current currency amount to a target currency using real-time exchange rates.
+     *
+     * - Uses `api.frankfurter.app` to fetch live exchange rates.
+     * - Supports **only the following fiat currencies**:
+     *   `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`.
+     * - Uses cached rates unless `forceRefresh` is set to `true`.
+     * - If API fails or currency not supported, falls back to `fallbackRate` if provided.
+     *
+     * @param to - The target currency code (must be one of the supported ones, e.g., `'EUR'`, `'USD'`).
+     * @param options - Optional settings:
+     *   - `fallbackRate`: A manual exchange rate to use if the API call fails or currency is not supported.
+     *   - `forceRefresh`: If true, ignores cached rates and fetches fresh data.
+     * @returns The converted amount as a number.
+     * @throws Will throw if the API call fails and no `fallbackRate` is provided.
+     */
+    async convert(to, options) {
+        const key = `${this.#code}->${to}`;
+        if (!options?.forceRefresh && rateCache.has(key)) {
+            const cachedRate = rateCache.get(key);
+            return this.#amount * cachedRate;
+        }
+        try {
+            const rate = await this.#fetchFromFrankfurter(to);
+            rateCache.set(key, rate);
+            return this.#amount * rate;
+        }
+        catch (error) {
+            if (options?.fallbackRate != null) {
+                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${JSON.stringify(error)}. Using fallback rate...`);
+                return this.#amount * options.fallbackRate;
+            }
+            throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${JSON.stringify(error)}`);
+        }
+    }
+    /**
+     * @private @instance Attempts to fetch rate from frankfurter.app
+     * @param to - Target currency code
+     * @returns Exchange rate (multiplier)
+     */
+    async #fetchFromFrankfurter(to) {
+        const url = `https://api.frankfurter.app/latest?amount=${this.#amount}&from=${this.#code}&to=${to}`;
+        const res = await fetch(url, { redirect: 'error' });
+        if (!res.ok)
+            throw new Error(`Frankfurter error: ${res.status}`);
+        const data = (await res.json());
+        if (!data.rates?.[to]) {
+            throw new Error(`Currency "${to}" not found in rates`);
+        }
+        return data.rates[to] / this.#amount;
+    }
+}
+exports.Currency = Currency;

package/dist/cjs/number/Unit.js

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Unit = void 0;
+/**
+ * @class Represents a measurable unit and supports conversions between various types of units.
+ *
+ * Includes static methods for:
+ * - Length: meters, feet, kilometers, miles
+ * - Mass: kilograms, pounds, grams, ounces
+ * - Temperature: Celsius, Fahrenheit, Kelvin
+ * - Volume: liters, gallons
+ * - Area: square meters, square feet
+ * - Speed: km/h, mph
+ * - Time: hours, minutes, seconds, days
+ * - Digital Storage: kilobytes, megabytes, gigabytes
+ * - Energy: joules, calories
+ * - Pressure: atm, pascals
+ * - Frequency: Hz, kHz
+ */
+class Unit {
+    #value;
+    #unit;
+    /**
+     * * Creates an instance of the Unit class.
+     * @param value The numeric value to work with.
+     * @param unit The unit type of the value (e.g., 'kg', 'm', 'kb').
+     */
+    constructor(value, unit) {
+        this.#value = value;
+        this.#unit = unit;
+    }
+    /**
+     * @instance Returns the original value with unit (if passed in the constructor).
+     * @returns A string in the format "value unit".
+     */
+    toString() {
+        return `${this.#value} ${this.#unit ?? ''}`.trim();
+    }
+    /**
+     * @instance Converts the value using a static method name from the Unit class.
+     *
+     * *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * @returns The converted numeric value.
+     */
+    convert(methodName) {
+        const method = Unit[methodName];
+        if (typeof method !== 'function') {
+            throw new Error(`Method ${methodName} is not a valid method!`);
+        }
+        // @ts-expect-error -_-
+        return method(this.#value);
+    }
+    // ----- Static Conversion Methods -----
+    /** Converts meters to feet. */
+    static metersToFeet(m) {
+        return m * 3.28084;
+    }
+    /** Converts feet to meters. */
+    static feetToMeters(ft) {
+        return ft / 3.28084;
+    }
+    /** Converts kilometers to miles. */
+    static kmToMiles(km) {
+        return km * 0.621371;
+    }
+    /** Converts miles to kilometers. */
+    static milesToKm(mi) {
+        return mi / 0.621371;
+    }
+    /** Converts kilograms to pounds. */
+    static kgToLbs(kg) {
+        return kg * 2.20462;
+    }
+    /** Converts pounds to kilograms. */
+    static lbsToKg(lbs) {
+        return lbs / 2.20462;
+    }
+    /** Converts grams to ounces. */
+    static gramsToOunces(g) {
+        return g * 0.035274;
+    }
+    /** Converts ounces to grams. */
+    static ouncesToGrams(oz) {
+        return oz / 0.035274;
+    }
+    /** Converts Celsius to Fahrenheit. */
+    static celsiusToFahrenheit(c) {
+        return (c * 9) / 5 + 32;
+    }
+    /** Converts Fahrenheit to Celsius. */
+    static fahrenheitToCelsius(f) {
+        return ((f - 32) * 5) / 9;
+    }
+    /** Converts Celsius to Kelvin. */
+    static celsiusToKelvin(c) {
+        return c + 273.15;
+    }
+    /** Converts Kelvin to Celsius. */
+    static kelvinToCelsius(k) {
+        return k - 273.15;
+    }
+    /** Converts liters to gallons. */
+    static litersToGallons(l) {
+        return l * 0.264172;
+    }
+    /** Converts gallons to liters. */
+    static gallonsToLiters(gal) {
+        return gal / 0.264172;
+    }
+    /** Converts square meters to square feet. */
+    static sqmToSqft(sqm) {
+        return sqm * 10.7639;
+    }
+    /** Converts square feet to square meters. */
+    static sqftToSqm(sqft) {
+        return sqft / 10.7639;
+    }
+    /** Converts kilometers per hour to miles per hour. */
+    static kmphToMph(kmph) {
+        return kmph * 0.621371;
+    }
+    /** Converts miles per hour to kilometers per hour. */
+    static mphToKmph(mph) {
+        return mph / 0.621371;
+    }
+    /** Converts hours to minutes. */
+    static hoursToMinutes(h) {
+        return h * 60;
+    }
+    /** Converts minutes to seconds. */
+    static minutesToSeconds(m) {
+        return m * 60;
+    }
+    /** Converts days to hours. */
+    static daysToHours(d) {
+        return d * 24;
+    }
+    /** Converts megabytes to gigabytes. */
+    static mbToGb(mb) {
+        return mb / 1024;
+    }
+    /** Converts gigabytes to megabytes. */
+    static gbToMb(gb) {
+        return gb * 1024;
+    }
+    /** Converts kilobytes to megabytes. */
+    static kbToMb(kb) {
+        return kb / 1024;
+    }
+    /** Converts joules to calories. */
+    static joulesToCalories(j) {
+        return j * 0.239006;
+    }
+    /** Converts calories to joules. */
+    static caloriesToJoules(cal) {
+        return cal / 0.239006;
+    }
+    /** Converts atmospheres to pascals. */
+    static atmToPascal(atm) {
+        return atm * 101325;
+    }
+    /** Converts pascals to atmospheres. */
+    static pascalToAtm(pa) {
+        return pa / 101325;
+    }
+    /** Converts hertz to kilohertz. */
+    static hzToKHz(hz) {
+        return hz / 1000;
+    }
+    /** Converts kilohertz to hertz. */
+    static kHzToHz(khz) {
+        return khz * 1000;
+    }
+}
+exports.Unit = Unit;

package/dist/cjs/number/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CURRENCY_LOCALES = exports.LOCALE_CODES = exports.CURRENCY_CODES = exports.thousands = exports.tens = exports.teens = exports.ones = void 0;
+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.ones = [
     '',
     'one',
@@ -505,3 +505,83 @@ exports.CURRENCY_LOCALES = {
     ZMW: 'en-ZM', // Zambian Kwacha
     ZWL: 'en-ZW', // Zimbabwean Dollar
 };
+/** * Fiat currencies supported by Frankfurter API */
+exports.SUPPORTED_CURRENCIES = [
+    '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.
+ */
+exports.UNIT_LABELS = {
+    // Length
+    m: 'Meter',
+    km: 'Kilometer',
+    mi: 'Mile',
+    ft: 'Foot',
+    // Mass / Weight
+    kg: 'Kilogram',
+    lbs: 'Pound',
+    g: 'Gram',
+    oz: 'Ounce',
+    // Temperature
+    C: 'Celsius',
+    F: 'Fahrenheit',
+    K: 'Kelvin',
+    // Volume
+    l: 'Liter',
+    gal: 'Gallon',
+    // Area
+    sqm: 'Square Meter',
+    sqft: 'Square Foot',
+    // Speed
+    kmph: 'Kilometer per Hour',
+    mph: 'Miles per Hour',
+    // Time
+    h: 'Hour',
+    min: 'Minute',
+    sec: 'Second',
+    d: 'Day',
+    // Digital Storage
+    kb: 'Kilobyte',
+    mb: 'Megabyte',
+    gb: 'Gigabyte',
+    // Energy
+    j: 'Joule',
+    cal: 'Calorie',
+    // Pressure
+    atm: 'Atmosphere',
+    pa: 'Pascal',
+    // Frequency
+    hz: 'Hertz',
+    khz: 'Kilohertz',
+};

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

@@ -11,7 +11,7 @@ export declare const MINUTE_FORMATS: readonly ["mm", "m"];
 export declare const SECOND_FORMATS: readonly ["ss", "s"];
 export declare const MILLISECOND_FORMATS: readonly ["ms", "mss"];
 export declare const TIME_FORMATS: readonly ["a", "A"];
-export declare const sortedFormats: ("a" | "M" | "D" | "h" | "s" | "A" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "mmm" | "mmmm" | "DD" | "Do" | "d" | "dd" | "ddd" | "H" | "HH" | "hh" | "mm" | "m" | "ss" | "ms" | "mss")[];
+export declare const sortedFormats: ("a" | "m" | "h" | "d" | "M" | "D" | "s" | "A" | "YYYY" | "YY" | "yyyy" | "yy" | "MM" | "mmm" | "mmmm" | "DD" | "Do" | "dd" | "ddd" | "H" | "HH" | "hh" | "mm" | "ss" | "ms" | "mss")[];
 export declare const TIME_ZONES: {
     /** International Date Line West (Baker Island, Howland Island) */
     readonly IDLW: number;

package/dist/dts/index.d.ts

@@ -4,6 +4,8 @@ export { isCamelCase, isEmojiOnly, isKebabCase, isPalindrome, isPascalCase, isSn
 export { convertStringCase, extractEmails, extractURLs, formatUnitWithPlural as formatNumberWithPluralUnit, formatUnitWithPlural, formatUnitWithPlural as formatWithPlural, maskString, normalizeString, replaceAllInString, reverseString, slugifyString, } from './string/convert';
 export { countWords, countWords as countWordsInString, extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, countWords as wordCount, } from './string/utilities';
 export { getAverage as calculateAverage, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getAverage, getAverage as getAverageOfNumbers, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics';
+export { Currency } from './number/Currency';
+export { Unit } from './number/Unit';
 export { calculatePercentage } from './number/percent';
 export { fibonacciGenerator, fibonacciGenerator as generateFibonacci, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getNthFibonacci, } from './number/fibonacci';
 export { areInvalidNumbers, isEven, isEven as isEvenNumber, isFibonacci, areInvalidNumbers as isInvalidNumbers, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';

package/dist/dts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EACN,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACX,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,IAAI,0BAA0B,EAClD,oBAAoB,EACpB,oBAAoB,IAAI,gBAAgB,EACxC,UAAU,EACV,eAAe,EACf,kBAAkB,EAClB,aAAa,EACb,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,UAAU,EACV,UAAU,IAAI,kBAAkB,EAChC,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,IAAI,mBAAmB,EAC7C,UAAU,IAAI,SAAS,GACvB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACN,UAAU,IAAI,gBAAgB,EAC9B,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,YAAY,IAAI,YAAY,EAC5B,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,UAAU,IAAI,mBAAmB,EACjC,eAAe,EACf,UAAU,IAAI,eAAe,EAC7B,aAAa,EACb,SAAS,EACT,UAAU,EACV,UAAU,IAAI,YAAY,GAC1B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAErC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EACN,kBAAkB,EAClB,kBAAkB,IAAI,iBAAiB,EACvC,kBAAkB,IAAI,YAAY,EAClC,kBAAkB,IAAI,mBAAmB,EACzC,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,IAAI,oBAAoB,EAC9C,sBAAsB,IAAI,0BAA0B,EACpD,eAAe,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,iBAAiB,EACjB,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,WAAW,EACX,iBAAiB,IAAI,gBAAgB,EACrC,UAAU,EACV,KAAK,EACL,KAAK,IAAI,WAAW,EACpB,WAAW,IAAI,gBAAgB,EAC/B,WAAW,IAAI,sBAAsB,EACrC,eAAe,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,aAAa,IAAI,oBAAoB,EACrC,sBAAsB,EACtB,aAAa,GACb,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACN,gBAAgB,EAChB,gBAAgB,IAAI,eAAe,EACnC,OAAO,EACP,OAAO,IAAI,aAAa,GACxB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACN,UAAU,IAAI,iBAAiB,EAC/B,WAAW,EACX,cAAc,IAAI,uBAAuB,EACzC,UAAU,IAAI,sBAAsB,EACpC,UAAU,IAAI,gBAAgB,EAC9B,cAAc,EACd,UAAU,EACV,UAAU,IAAI,gBAAgB,EAC9B,cAAc,IAAI,gBAAgB,EAClC,cAAc,EACd,UAAU,IAAI,eAAe,EAC7B,cAAc,IAAI,WAAW,EAC7B,cAAc,IAAI,4BAA4B,EAC9C,cAAc,EACd,cAAc,IAAI,sBAAsB,GACxC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAGxD,OAAO,EACN,WAAW,IAAI,gBAAgB,EAC/B,WAAW,EACX,WAAW,IAAI,KAAK,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACN,UAAU,EACV,WAAW,EACX,WAAW,IAAI,iBAAiB,EAChC,gBAAgB,IAAI,UAAU,EAC9B,gBAAgB,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EACN,OAAO,EACP,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,OAAO,EAClB,OAAO,IAAI,SAAS,EACpB,OAAO,IAAI,SAAS,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,eAAe,IAAI,yBAAyB,EAC5C,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,IAAI,wBAAwB,EAC9C,eAAe,IAAI,2BAA2B,EAC9C,eAAe,EACf,kBAAkB,EAClB,kBAAkB,IAAI,cAAc,EACpC,qBAAqB,IAAI,iBAAiB,EAC1C,kBAAkB,IAAI,oBAAoB,EAC1C,eAAe,EACf,eAAe,IAAI,uBAAuB,EAC1C,qBAAqB,IAAI,sBAAsB,EAC/C,eAAe,IAAI,kBAAkB,GACrC,MAAM,cAAc,CAAC;AAGtB,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,IAAI,iBAAiB,EAC1C,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,aAAa,IAAI,iBAAiB,EAClC,aAAa,IAAI,0BAA0B,EAC3C,mBAAmB,IAAI,sBAAsB,EAC7C,mBAAmB,EACnB,aAAa,EACb,aAAa,IAAI,sBAAsB,EACvC,mBAAmB,IAAI,kBAAkB,EACzC,gBAAgB,EAChB,yBAAyB,IAAI,gBAAgB,EAC7C,yBAAyB,EACzB,WAAW,EACX,UAAU,GACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,WAAW,IAAI,gBAAgB,EAC/B,WAAW,IAAI,aAAa,EAC5B,WAAW,EACX,WAAW,IAAI,oBAAoB,GACnC,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,wBAAwB,IAAI,mBAAmB,EAC/C,wBAAwB,EACxB,wBAAwB,IAAI,cAAc,GAC1C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EACN,YAAY,EACZ,iBAAiB,EACjB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEjE,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,GACjB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACN,iBAAiB,EACjB,iBAAiB,IAAI,kBAAkB,EACvC,iBAAiB,IAAI,eAAe,EACpC,iBAAiB,IAAI,4BAA4B,EACjD,iBAAiB,IAAI,0BAA0B,EAC/C,iBAAiB,IAAI,sBAAsB,EAC3C,YAAY,GACZ,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACN,mBAAmB,EACnB,UAAU,EACV,2BAA2B,IAAI,qBAAqB,EACpD,UAAU,IAAI,gBAAgB,EAC9B,2BAA2B,EAC3B,WAAW,EACX,WAAW,IAAI,iBAAiB,GAChC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACN,mBAAmB,IAAI,iBAAiB,EACxC,mBAAmB,IAAI,iBAAiB,EACxC,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,IAAI,mBAAmB,EACvC,gBAAgB,IAAI,sBAAsB,EAC1C,gBAAgB,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACN,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,oBAAoB,IAAI,uBAAuB,EAC/C,oBAAoB,EACpB,kBAAkB,IAAI,qBAAqB,EAC3C,WAAW,EACX,SAAS,EACT,SAAS,IAAI,aAAa,EAC1B,mBAAmB,IAAI,mBAAmB,EAC1C,cAAc,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,SAAS,EACT,OAAO,EACP,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,QAAQ,EACR,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,WAAW,GACX,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACN,kBAAkB,IAAI,iBAAiB,EACvC,OAAO,EACP,aAAa,EACb,YAAY,IAAI,iBAAiB,EACjC,QAAQ,EACR,MAAM,EACN,aAAa,EACb,aAAa,IAAI,kBAAkB,EACnC,OAAO,EACP,UAAU,EACV,MAAM,EACN,MAAM,IAAI,YAAY,EACtB,KAAK,EACL,kBAAkB,IAAI,QAAQ,EAC9B,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,aAAa,IAAI,aAAa,EAC9B,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,QAAQ,IAAI,mBAAmB,EAC/B,kBAAkB,EAClB,KAAK,EACL,YAAY,EACZ,MAAM,IAAI,WAAW,EACrB,KAAK,IAAI,UAAU,EACnB,gBAAgB,IAAI,aAAa,EACjC,KAAK,IAAI,UAAU,GACnB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACN,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,OAAO,EACP,YAAY,EACZ,aAAa,EACb,aAAa,IAAI,iBAAiB,EAClC,WAAW,EACX,MAAM,EACN,aAAa,IAAI,SAAS,EAC1B,aAAa,IAAI,iBAAiB,EAClC,eAAe,EACf,aAAa,EACb,KAAK,EACL,MAAM,EACN,OAAO,IAAI,YAAY,EACvB,KAAK,IAAI,UAAU,GACnB,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,53 @@
+import type { Numeric } from '../types';
+import type { ConvertOptions, CurrencyCode, LocaleCode, SupportedCurrency } from './types';
+/**
+ * * A utility class for handling currency operations like formatting and conversion.
+ *
+ * - Supports formatting based on locale.
+ * - Converts between **fiat currencies supported by `api.frankfurter.app`**.
+ * - Automatically caches conversion rates to reduce redundant API calls.
+ * - Intended for use with numeric inputs (number or numeric string).
+ */
+export declare class Currency {
+    #private;
+    /**
+     * * The formatted currency string (e.g., `$1,000.00`).
+     *
+     * - Generated using the `en-US` locale during construction.
+     * - This is a display-friendly version of the currency value.
+     * - For formatting with other locales, use the `format(locale)` method.
+     */
+    readonly currency: string;
+    /**
+     * Creates an instance of the Currency class.
+     *
+     * @param amount - The numeric amount of currency (e.g., `100`, `'99.99'`).
+     * @param code - The ISO 4217 currency code representing the currency (e.g., `'USD'`, `'EUR'`).
+     */
+    constructor(amount: Numeric, code: CurrencyCode);
+    /**
+     * @instance Formats the currency for a given locale.
+     * @param locale - The target locale (e.g., 'de-DE')
+     * @returns The formatted currency string
+     */
+    format(locale?: LocaleCode): string;
+    /**
+     * @instance Converts the current currency amount to a target currency using real-time exchange rates.
+     *
+     * - Uses `api.frankfurter.app` to fetch live exchange rates.
+     * - Supports **only the following fiat currencies**:
+     *   `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`.
+     * - Uses cached rates unless `forceRefresh` is set to `true`.
+     * - If API fails or currency not supported, falls back to `fallbackRate` if provided.
+     *
+     * @param to - The target currency code (must be one of the supported ones, e.g., `'EUR'`, `'USD'`).
+     * @param options - Optional settings:
+     *   - `fallbackRate`: A manual exchange rate to use if the API call fails or currency is not supported.
+     *   - `forceRefresh`: If true, ignores cached rates and fetches fresh data.
+     * @returns The converted amount as a number.
+     * @throws Will throw if the API call fails and no `fallbackRate` is provided.
+     */
+    convert(to: SupportedCurrency | CurrencyCode, options?: ConvertOptions): Promise<number>;
+}
+//# sourceMappingURL=Currency.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Currency.d.ts","sourceRoot":"","sources":["../../../src/number/Currency.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,KAAK,EACX,cAAc,EACd,YAAY,EAEZ,UAAU,EACV,iBAAiB,EACjB,MAAM,SAAS,CAAC;AAKjB;;;;;;;GAOG;AACH,qBAAa,QAAQ;;IAGpB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;;;;OAKG;gBACS,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY;IAM/C;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM;IAInC;;;;;;;;;;;;;;;;OAgBG;IACG,OAAO,CACZ,EAAE,EAAE,iBAAiB,GAAG,YAAY,EACpC,OAAO,CAAC,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC;CAiDlB"}

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

@@ -0,0 +1,101 @@
+import type { UnitKey } from './types';
+/**
+ * @class Represents a measurable unit and supports conversions between various types of units.
+ *
+ * Includes static methods for:
+ * - Length: meters, feet, kilometers, miles
+ * - Mass: kilograms, pounds, grams, ounces
+ * - Temperature: Celsius, Fahrenheit, Kelvin
+ * - Volume: liters, gallons
+ * - Area: square meters, square feet
+ * - Speed: km/h, mph
+ * - Time: hours, minutes, seconds, days
+ * - Digital Storage: kilobytes, megabytes, gigabytes
+ * - Energy: joules, calories
+ * - Pressure: atm, pascals
+ * - Frequency: Hz, kHz
+ */
+export declare class Unit {
+    #private;
+    /**
+     * * Creates an instance of the Unit class.
+     * @param value The numeric value to work with.
+     * @param unit The unit type of the value (e.g., 'kg', 'm', 'kb').
+     */
+    constructor(value: number, unit?: UnitKey);
+    /**
+     * @instance Returns the original value with unit (if passed in the constructor).
+     * @returns A string in the format "value unit".
+     */
+    toString(): string;
+    /**
+     * @instance Converts the value using a static method name from the Unit class.
+     *
+     * *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * @returns The converted numeric value.
+     */
+    convert<T extends keyof typeof Unit>(methodName: T): (typeof Unit)[T] extends (value: number) => number ? number : never;
+    /** Converts meters to feet. */
+    static metersToFeet(m: number): number;
+    /** Converts feet to meters. */
+    static feetToMeters(ft: number): number;
+    /** Converts kilometers to miles. */
+    static kmToMiles(km: number): number;
+    /** Converts miles to kilometers. */
+    static milesToKm(mi: number): number;
+    /** Converts kilograms to pounds. */
+    static kgToLbs(kg: number): number;
+    /** Converts pounds to kilograms. */
+    static lbsToKg(lbs: number): number;
+    /** Converts grams to ounces. */
+    static gramsToOunces(g: number): number;
+    /** Converts ounces to grams. */
+    static ouncesToGrams(oz: number): number;
+    /** Converts Celsius to Fahrenheit. */
+    static celsiusToFahrenheit(c: number): number;
+    /** Converts Fahrenheit to Celsius. */
+    static fahrenheitToCelsius(f: number): number;
+    /** Converts Celsius to Kelvin. */
+    static celsiusToKelvin(c: number): number;
+    /** Converts Kelvin to Celsius. */
+    static kelvinToCelsius(k: number): number;
+    /** Converts liters to gallons. */
+    static litersToGallons(l: number): number;
+    /** Converts gallons to liters. */
+    static gallonsToLiters(gal: number): number;
+    /** Converts square meters to square feet. */
+    static sqmToSqft(sqm: number): number;
+    /** Converts square feet to square meters. */
+    static sqftToSqm(sqft: number): number;
+    /** Converts kilometers per hour to miles per hour. */
+    static kmphToMph(kmph: number): number;
+    /** Converts miles per hour to kilometers per hour. */
+    static mphToKmph(mph: number): number;
+    /** Converts hours to minutes. */
+    static hoursToMinutes(h: number): number;
+    /** Converts minutes to seconds. */
+    static minutesToSeconds(m: number): number;
+    /** Converts days to hours. */
+    static daysToHours(d: number): number;
+    /** Converts megabytes to gigabytes. */
+    static mbToGb(mb: number): number;
+    /** Converts gigabytes to megabytes. */
+    static gbToMb(gb: number): number;
+    /** Converts kilobytes to megabytes. */
+    static kbToMb(kb: number): number;
+    /** Converts joules to calories. */
+    static joulesToCalories(j: number): number;
+    /** Converts calories to joules. */
+    static caloriesToJoules(cal: number): number;
+    /** Converts atmospheres to pascals. */
+    static atmToPascal(atm: number): number;
+    /** Converts pascals to atmospheres. */
+    static pascalToAtm(pa: number): number;
+    /** Converts hertz to kilohertz. */
+    static hzToKHz(hz: number): number;
+    /** Converts kilohertz to hertz. */
+    static kHzToHz(khz: number): number;
+}
+//# sourceMappingURL=Unit.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -169,4 +169,41 @@ export declare const CURRENCY_LOCALES: {
     readonly ZMW: "en-ZM";
     readonly ZWL: "en-ZW";
 };
+/** * 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: {
+    readonly m: "Meter";
+    readonly km: "Kilometer";
+    readonly mi: "Mile";
+    readonly ft: "Foot";
+    readonly kg: "Kilogram";
+    readonly lbs: "Pound";
+    readonly g: "Gram";
+    readonly oz: "Ounce";
+    readonly C: "Celsius";
+    readonly F: "Fahrenheit";
+    readonly K: "Kelvin";
+    readonly l: "Liter";
+    readonly gal: "Gallon";
+    readonly sqm: "Square Meter";
+    readonly sqft: "Square Foot";
+    readonly kmph: "Kilometer per Hour";
+    readonly mph: "Miles per Hour";
+    readonly h: "Hour";
+    readonly min: "Minute";
+    readonly sec: "Second";
+    readonly d: "Day";
+    readonly kb: "Kilobyte";
+    readonly mb: "Megabyte";
+    readonly gb: "Gigabyte";
+    readonly j: "Joule";
+    readonly cal: "Calorie";
+    readonly atm: "Atmosphere";
+    readonly pa: "Pascal";
+    readonly hz: "Hertz";
+    readonly khz: "Kilohertz";
+};
 //# 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"}
+{"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"}

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

@@ -1,4 +1,4 @@
-import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES } from './constants';
+import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, SUPPORTED_CURRENCIES, UNIT_LABELS } from './constants';
 /** - Options for random number generator */
 export interface RandomNumberOptions {
     /** Minimum number to start with. */
@@ -38,6 +38,21 @@ export type RangedNumbers<T extends GetAs> = T extends 'array' ? number[] : stri
 export type CurrencyCode = keyof typeof CURRENCY_LOCALES | (typeof CURRENCY_CODES)[number];
 /** - List of all supported BCP 47 locales */
 export type LocaleCode = (typeof CURRENCY_LOCALES)[keyof typeof CURRENCY_LOCALES] | (typeof LOCALE_CODES)[number];
+/** * Fiat currencies supported by Frankfurter API */
+export type SupportedCurrency = (typeof SUPPORTED_CURRENCIES)[number];
+/** - Options for `convert` method in `Currency` class */
+export interface ConvertOptions {
+    /** A manual exchange rate to use if the API call fails. */
+    fallbackRate?: number;
+    /**  If true, bypasses the cache and fetches fresh rate. */
+    forceRefresh?: boolean;
+}
+export interface FrankFurter {
+    amount: number;
+    base: CurrencyCode;
+    date: string;
+    rates: Record<CurrencyCode, number>;
+}
 /** * Options to calculate what percentage a `part` is of a `total`. */
 export interface GetPercentOptions {
     /** Mode to calculate percentage from `part` and `total` */
@@ -103,4 +118,8 @@ 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];
 //# 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,oBAAoB,EACpB,WAAW,EACX,MAAM,aAAa,CAAC;AAErB,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,6BAA6B;AAC7B,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,WAAW,CAAC;AAE/C,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC"}

package/dist/esm/index.js

@@ -6,6 +6,8 @@ export { convertStringCase, extractEmails, extractURLs, formatUnitWithPlural as
 export { countWords, countWords as countWordsInString, extractNumbersFromString, getLevenshteinDistance, getLevenshteinDistance as levenshteinDistance, countWords as wordCount, } from './string/utilities';
 // ! Number Utilities
 export { getAverage as calculateAverage, calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getAverage, getAverage as getAverageOfNumbers, getRandomNumber, sumNumbers as getSumOfNumbers, reverseNumber, sumDigits, sumNumbers, sumNumbers as sumOfNumbers, } from './number/basics';
+export { Currency } from './number/Currency';
+export { Unit } from './number/Unit';
 export { calculatePercentage } from './number/percent';
 export { fibonacciGenerator, fibonacciGenerator as generateFibonacci, getFibonacciSeries as getFibonacci, getFibonacciSeries as getFibonacciNumbers, getFibonacciSeries, getFibonacciSeriesMemo, getFibonacciSeriesMemo as getMemoizedFibonacci, getFibonacciSeriesMemo as getMemoizedFibonacciSeries, getNthFibonacci, } from './number/fibonacci';
 export { areInvalidNumbers, isEven, isEven as isEvenNumber, isFibonacci, areInvalidNumbers as isInvalidNumbers, isMultiple, isOdd, isOdd as isOddNumber, isFibonacci as isParOfFibonacci, isFibonacci as isParOfFibonacciSeries, isPerfectSquare, } from './number/guards';

package/dist/esm/number/Currency.js

@@ -0,0 +1,93 @@
+import { formatCurrency } from './utilities';
+const rateCache = new Map();
+/**
+ * * A utility class for handling currency operations like formatting and conversion.
+ *
+ * - Supports formatting based on locale.
+ * - Converts between **fiat currencies supported by `api.frankfurter.app`**.
+ * - Automatically caches conversion rates to reduce redundant API calls.
+ * - Intended for use with numeric inputs (number or numeric string).
+ */
+export class Currency {
+    #amount;
+    #code;
+    /**
+     * * The formatted currency string (e.g., `$1,000.00`).
+     *
+     * - Generated using the `en-US` locale during construction.
+     * - This is a display-friendly version of the currency value.
+     * - For formatting with other locales, use the `format(locale)` method.
+     */
+    currency;
+    /**
+     * Creates an instance of the Currency class.
+     *
+     * @param amount - The numeric amount of currency (e.g., `100`, `'99.99'`).
+     * @param code - The ISO 4217 currency code representing the currency (e.g., `'USD'`, `'EUR'`).
+     */
+    constructor(amount, code) {
+        this.#amount = Number(amount);
+        this.#code = code;
+        this.currency = this.format('en-US');
+    }
+    /**
+     * @instance Formats the currency for a given locale.
+     * @param locale - The target locale (e.g., 'de-DE')
+     * @returns The formatted currency string
+     */
+    format(locale) {
+        return formatCurrency(this.#amount, this.#code, locale);
+    }
+    /**
+     * @instance Converts the current currency amount to a target currency using real-time exchange rates.
+     *
+     * - Uses `api.frankfurter.app` to fetch live exchange rates.
+     * - Supports **only the following fiat currencies**:
+     *   `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`.
+     * - Uses cached rates unless `forceRefresh` is set to `true`.
+     * - If API fails or currency not supported, falls back to `fallbackRate` if provided.
+     *
+     * @param to - The target currency code (must be one of the supported ones, e.g., `'EUR'`, `'USD'`).
+     * @param options - Optional settings:
+     *   - `fallbackRate`: A manual exchange rate to use if the API call fails or currency is not supported.
+     *   - `forceRefresh`: If true, ignores cached rates and fetches fresh data.
+     * @returns The converted amount as a number.
+     * @throws Will throw if the API call fails and no `fallbackRate` is provided.
+     */
+    async convert(to, options) {
+        const key = `${this.#code}->${to}`;
+        if (!options?.forceRefresh && rateCache.has(key)) {
+            const cachedRate = rateCache.get(key);
+            return this.#amount * cachedRate;
+        }
+        try {
+            const rate = await this.#fetchFromFrankfurter(to);
+            rateCache.set(key, rate);
+            return this.#amount * rate;
+        }
+        catch (error) {
+            if (options?.fallbackRate != null) {
+                console.warn(`Currency conversion failed (${this.#code} → ${to}): ${JSON.stringify(error)}. Using fallback rate...`);
+                return this.#amount * options.fallbackRate;
+            }
+            throw new Error(`Currency conversion failed (${this.#code} → ${to}): ${JSON.stringify(error)}`);
+        }
+    }
+    /**
+     * @private @instance Attempts to fetch rate from frankfurter.app
+     * @param to - Target currency code
+     * @returns Exchange rate (multiplier)
+     */
+    async #fetchFromFrankfurter(to) {
+        const url = `https://api.frankfurter.app/latest?amount=${this.#amount}&from=${this.#code}&to=${to}`;
+        const res = await fetch(url, { redirect: 'error' });
+        if (!res.ok)
+            throw new Error(`Frankfurter error: ${res.status}`);
+        const data = (await res.json());
+        if (!data.rates?.[to]) {
+            throw new Error(`Currency "${to}" not found in rates`);
+        }
+        return data.rates[to] / this.#amount;
+    }
+}

package/dist/esm/number/Unit.js

@@ -0,0 +1,173 @@
+/**
+ * @class Represents a measurable unit and supports conversions between various types of units.
+ *
+ * Includes static methods for:
+ * - Length: meters, feet, kilometers, miles
+ * - Mass: kilograms, pounds, grams, ounces
+ * - Temperature: Celsius, Fahrenheit, Kelvin
+ * - Volume: liters, gallons
+ * - Area: square meters, square feet
+ * - Speed: km/h, mph
+ * - Time: hours, minutes, seconds, days
+ * - Digital Storage: kilobytes, megabytes, gigabytes
+ * - Energy: joules, calories
+ * - Pressure: atm, pascals
+ * - Frequency: Hz, kHz
+ */
+export class Unit {
+    #value;
+    #unit;
+    /**
+     * * Creates an instance of the Unit class.
+     * @param value The numeric value to work with.
+     * @param unit The unit type of the value (e.g., 'kg', 'm', 'kb').
+     */
+    constructor(value, unit) {
+        this.#value = value;
+        this.#unit = unit;
+    }
+    /**
+     * @instance Returns the original value with unit (if passed in the constructor).
+     * @returns A string in the format "value unit".
+     */
+    toString() {
+        return `${this.#value} ${this.#unit ?? ''}`.trim();
+    }
+    /**
+     * @instance Converts the value using a static method name from the Unit class.
+     *
+     * *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A key of Unit class static method accepting a number and returning a number.
+     * @returns The converted numeric value.
+     */
+    convert(methodName) {
+        const method = Unit[methodName];
+        if (typeof method !== 'function') {
+            throw new Error(`Method ${methodName} is not a valid method!`);
+        }
+        // @ts-expect-error -_-
+        return method(this.#value);
+    }
+    // ----- Static Conversion Methods -----
+    /** Converts meters to feet. */
+    static metersToFeet(m) {
+        return m * 3.28084;
+    }
+    /** Converts feet to meters. */
+    static feetToMeters(ft) {
+        return ft / 3.28084;
+    }
+    /** Converts kilometers to miles. */
+    static kmToMiles(km) {
+        return km * 0.621371;
+    }
+    /** Converts miles to kilometers. */
+    static milesToKm(mi) {
+        return mi / 0.621371;
+    }
+    /** Converts kilograms to pounds. */
+    static kgToLbs(kg) {
+        return kg * 2.20462;
+    }
+    /** Converts pounds to kilograms. */
+    static lbsToKg(lbs) {
+        return lbs / 2.20462;
+    }
+    /** Converts grams to ounces. */
+    static gramsToOunces(g) {
+        return g * 0.035274;
+    }
+    /** Converts ounces to grams. */
+    static ouncesToGrams(oz) {
+        return oz / 0.035274;
+    }
+    /** Converts Celsius to Fahrenheit. */
+    static celsiusToFahrenheit(c) {
+        return (c * 9) / 5 + 32;
+    }
+    /** Converts Fahrenheit to Celsius. */
+    static fahrenheitToCelsius(f) {
+        return ((f - 32) * 5) / 9;
+    }
+    /** Converts Celsius to Kelvin. */
+    static celsiusToKelvin(c) {
+        return c + 273.15;
+    }
+    /** Converts Kelvin to Celsius. */
+    static kelvinToCelsius(k) {
+        return k - 273.15;
+    }
+    /** Converts liters to gallons. */
+    static litersToGallons(l) {
+        return l * 0.264172;
+    }
+    /** Converts gallons to liters. */
+    static gallonsToLiters(gal) {
+        return gal / 0.264172;
+    }
+    /** Converts square meters to square feet. */
+    static sqmToSqft(sqm) {
+        return sqm * 10.7639;
+    }
+    /** Converts square feet to square meters. */
+    static sqftToSqm(sqft) {
+        return sqft / 10.7639;
+    }
+    /** Converts kilometers per hour to miles per hour. */
+    static kmphToMph(kmph) {
+        return kmph * 0.621371;
+    }
+    /** Converts miles per hour to kilometers per hour. */
+    static mphToKmph(mph) {
+        return mph / 0.621371;
+    }
+    /** Converts hours to minutes. */
+    static hoursToMinutes(h) {
+        return h * 60;
+    }
+    /** Converts minutes to seconds. */
+    static minutesToSeconds(m) {
+        return m * 60;
+    }
+    /** Converts days to hours. */
+    static daysToHours(d) {
+        return d * 24;
+    }
+    /** Converts megabytes to gigabytes. */
+    static mbToGb(mb) {
+        return mb / 1024;
+    }
+    /** Converts gigabytes to megabytes. */
+    static gbToMb(gb) {
+        return gb * 1024;
+    }
+    /** Converts kilobytes to megabytes. */
+    static kbToMb(kb) {
+        return kb / 1024;
+    }
+    /** Converts joules to calories. */
+    static joulesToCalories(j) {
+        return j * 0.239006;
+    }
+    /** Converts calories to joules. */
+    static caloriesToJoules(cal) {
+        return cal / 0.239006;
+    }
+    /** Converts atmospheres to pascals. */
+    static atmToPascal(atm) {
+        return atm * 101325;
+    }
+    /** Converts pascals to atmospheres. */
+    static pascalToAtm(pa) {
+        return pa / 101325;
+    }
+    /** Converts hertz to kilohertz. */
+    static hzToKHz(hz) {
+        return hz / 1000;
+    }
+    /** Converts kilohertz to hertz. */
+    static kHzToHz(khz) {
+        return khz * 1000;
+    }
+}

package/dist/esm/number/constants.js

@@ -502,3 +502,83 @@ export const CURRENCY_LOCALES = {
     ZMW: 'en-ZM', // Zambian Kwacha
     ZWL: 'en-ZW', // Zimbabwean Dollar
 };
+/** * Fiat currencies supported by Frankfurter API */
+export const SUPPORTED_CURRENCIES = [
+    '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 const UNIT_LABELS = {
+    // Length
+    m: 'Meter',
+    km: 'Kilometer',
+    mi: 'Mile',
+    ft: 'Foot',
+    // Mass / Weight
+    kg: 'Kilogram',
+    lbs: 'Pound',
+    g: 'Gram',
+    oz: 'Ounce',
+    // Temperature
+    C: 'Celsius',
+    F: 'Fahrenheit',
+    K: 'Kelvin',
+    // Volume
+    l: 'Liter',
+    gal: 'Gallon',
+    // Area
+    sqm: 'Square Meter',
+    sqft: 'Square Foot',
+    // Speed
+    kmph: 'Kilometer per Hour',
+    mph: 'Miles per Hour',
+    // Time
+    h: 'Hour',
+    min: 'Minute',
+    sec: 'Second',
+    d: 'Day',
+    // Digital Storage
+    kb: 'Kilobyte',
+    mb: 'Megabyte',
+    gb: 'Gigabyte',
+    // Energy
+    j: 'Joule',
+    cal: 'Calorie',
+    // Pressure
+    atm: 'Atmosphere',
+    pa: 'Pascal',
+    // Frequency
+    hz: 'Hertz',
+    khz: 'Kilohertz',
+};

package/package.json

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