nhb-toolbox 4.0.60 → 4.0.75

package/dist/cjs/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFibonacciSeriesMemo = exports.getFibonacciSeries = exports.getFibonacciNumbers = exports.getFibonacci = exports.generateFibonacci = exports.fibonacciGenerator = exports.calculatePercentage = 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.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 = exports.getMemoizedFibonacci = void 0;
-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 = exports.convertRgbaToHsla = void 0;
-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 = exports.getDuplicatesFromArray = void 0;
-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 = exports.getQueryParams = 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 = 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; } });
@@ -58,6 +58,8 @@ Object.defineProperty(exports, "sumNumbers", { enumerable: true, get: function (
 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/Unit.js

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

package/dist/cjs/number/constants.js

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

package/dist/dts/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

@@ -5,6 +5,7 @@ export { convertStringCase, extractEmails, extractURLs, formatUnitWithPlural as
 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":"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"}

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

@@ -0,0 +1,203 @@
+import type { SIPrefix, UnitKey, UnitNumberMethods } 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 using scientific prefixes (e.g., kB to MB, mg to g).
+     *
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    convertByPrefix(fromPrefix: SIPrefix, toPrefix: SIPrefix): number;
+    /**
+     * @instance Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    convertFromTo(from: string, to: string): number;
+    /**
+     * @instance Converts the value using a static method name from the `Unit` class.
+     *
+     * - **N.B.** *Provides IntelliSense and type safety for method selection.*
+     *
+     * @param methodName - A static `Unit` method that accepts a number and returns a number.
+     * @returns The converted numeric value.
+     */
+    convert(methodName: UnitNumberMethods): number;
+    /**
+     * @static Converts a value using scientific prefixes (e.g., kB to MB, mg to g).
+     *
+     * @param value The value to convert.
+     * @param fromPrefix The SI prefix of the source unit.
+     * @param toPrefix The SI prefix of the target unit.
+     * @returns The converted numeric value.
+     */
+    static convertByPrefix(value: number, fromPrefix: SIPrefix, toPrefix: SIPrefix): number;
+    /**
+     * @static Converts from prefixed unit string to another (e.g., kB to MB, mg to g).
+     *
+     * @param value The numeric value.
+     * @param from Prefixed unit string (e.g., 'kB', 'mg').
+     * @param to Target prefixed unit string (e.g., 'MB', 'g').
+     * @returns The converted numeric value.
+     */
+    static convertFromTo(value: number, from: string, to: string): number;
+    /** 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 Fahrenheit to Kelvin. */
+    static fahrenheitToKelvin(f: number): number;
+    /** Converts Kelvin to Fahrenheit. */
+    static kelvinToFahrenheit(k: number): number;
+    /** Converts milliliters to liters. */
+    static mlToLiters(ml: number): number;
+    /** Converts liters to milliliters. */
+    static litersToMl(l: number): number;
+    /** Converts gallons to milliliters. */
+    static gallonsToMl(gal: number): number;
+    /** Converts milliliters to gallons. */
+    static mlToGallons(ml: number): number;
+    /** Converts liters to gallons. */
+    static litersToGallons(l: number): number;
+    /** Converts gallons to liters. */
+    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 minutes to hours. */
+    static minutesToHours(min: number): number;
+    /** Converts seconds to minutes. */
+    static secondsToMinutes(sec: number): number;
+    /** Converts hours to days. */
+    static hoursToDays(hr: number): number;
+    /** Converts hours to minutes. */
+    static hoursToMinutes(h: number): number;
+    /** Converts minutes to seconds. */
+    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 kilobytes to gigabytes. */
+    static kbToGb(kb: number): number;
+    /** Converts gigabytes to kilobytes. */
+    static gbToKb(gb: number): number;
+    /** Converts bytes to kilobytes. */
+    static bytesToKb(bytes: number): number;
+    /** Converts kilobytes to bytes. */
+    static kbToBytes(kb: number): number;
+    /** Converts megabytes to kilobytes. */
+    static mbToKb(mb: number): number;
+    /** Converts gigabytes to terabytes. */
+    static gbToTb(gb: number): number;
+    /** Converts terabytes to gigabytes. */
+    static tbToGb(tb: number): number;
+    /** Converts joules to calories. */
+    static joulesToCalories(j: number): number;
+    /** Converts calories to joules. */
+    static caloriesToJoules(cal: number): number;
+    /** Converts calories to kilojoules. */
+    static caloriesToKJoules(cal: number): number;
+    /** Converts kilojoules to calories. */
+    static kJoulesToCalories(kj: number): number;
+    /** Converts atmospheres to pascals. */
+    static atmToPascal(atm: number): number;
+    /** Converts pascals to atmospheres. */
+    static pascalToAtm(pa: number): number;
+    /** Converts bar to pascals. */
+    static barToPascal(bar: number): number;
+    /** Converts pascals to bar. */
+    static pascalToBar(pa: number): number;
+    /** Converts hertz to kilohertz. */
+    static hzToKHz(hz: number): number;
+    /** Converts kilohertz to hertz. */
+    static kHzToHz(khz: number): number;
+    /** Converts hertz to megahertz. */
+    static hzToMHz(hz: number): number;
+    /** Converts megahertz to hertz. */
+    static mHzToHz(mhz: number): number;
+    /** Converts kilohertz to megahertz. */
+    static kHzToMHz(khz: number): number;
+    /** Converts megahertz to kilohertz. */
+    static mHzToKHz(mhz: number): number;
+    /** Converts centimeters to meters. */
+    static cmToMeters(cm: number): number;
+    /** Converts meters to centimeters. */
+    static metersToCm(m: number): number;
+    /** Converts millimeters to meters. */
+    static mmToMeters(mm: number): number;
+    /** Converts meters to millimeters. */
+    static metersToMm(m: number): number;
+    /** Converts square kilometers to square meters. */
+    static sqkmToSqm(sqkm: number): number;
+    /** Converts square meters to square kilometers. */
+    static sqmToSqkm(sqm: number): number;
+    /** Converts square feet to square inches. */
+    static sqftToSqin(sqft: number): number;
+    /** Converts square inches to square feet. */
+    static sqinToSqft(sqin: number): number;
+    /** Converts watts to kilowatts. */
+    static wattsToKw(w: number): number;
+    /** Converts kilowatts to watts. */
+    static kwToWatts(kw: number): number;
+}
+//# sourceMappingURL=Unit.d.ts.map

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

@@ -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

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

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

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

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

@@ -1,4 +1,5 @@
-import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, SUPPORTED_CURRENCIES } from './constants';
+import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES, PREFIX_MULTIPLIERS, SUPPORTED_CURRENCIES, UNITS } from './constants';
+import type { Unit } from './Unit';
 /** - Options for random number generator */
 export interface RandomNumberOptions {
     /** Minimum number to start with. */
@@ -118,4 +119,14 @@ export interface InversePercentageOptions {
 }
 /** * Options for calculating percentages and related values. */
 export type PercentageOptions = GetPercentOptions | GetValueOptions | GetOriginalOptions | GetChangeOptions | ApplyChangeOptions | GetDifferenceOptions | InversePercentageOptions;
+/** * Static methods from `Unit` class that accept a single number argument and return a number. */
+export type UnitNumberMethods = {
+    [K in keyof typeof Unit]: (typeof Unit)[K] extends ((value: number) => number) ? K : never;
+}[keyof typeof Unit];
+/** - Short forms of units */
+export type UnitKey = keyof typeof UNITS;
+/** - Labels for the units */
+export type UnitLabel = (typeof UNITS)[UnitKey];
+/** - Prefixes for SI units */
+export type SIPrefix = keyof typeof PREFIX_MULTIPLIERS;
 //# sourceMappingURL=types.d.ts.map

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

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

package/dist/esm/index.js

@@ -7,6 +7,7 @@ export { countWords, countWords as countWordsInString, extractNumbersFromString,
 // ! 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/Unit.js

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

package/dist/esm/number/constants.js

@@ -536,3 +536,72 @@ export const SUPPORTED_CURRENCIES = [
     'USD',
     'ZAR',
 ];
+/** * @constant Unit names and their full readable labels. */
+export const UNITS = {
+    // 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',
+};
+/** * Scientific SI Unit prefix multipliers. */
+export const PREFIX_MULTIPLIERS = {
+    y: 1e-24,
+    z: 1e-21,
+    a: 1e-18,
+    f: 1e-15,
+    p: 1e-12,
+    n: 1e-9,
+    μ: 1e-6,
+    u: 1e-6,
+    m: 1e-3,
+    c: 1e-2,
+    d: 1e-1,
+    da: 1e1,
+    h: 1e2,
+    k: 1e3,
+    M: 1e6,
+    G: 1e9,
+    T: 1e12,
+    P: 1e15,
+    E: 1e18,
+    Z: 1e21,
+    Y: 1e24,
+    '': 1, // base unit, like meter, gram, byte etc.
+};

package/package.json

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