nhb-toolbox 2.8.5 → 2.8.6

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export { generateAnagrams } from './string/anagram';
 export { convertStringCase, maskString, replaceAllInString, reverseString, slugifyString, } from './string/convert';
 export { extractNumbersFromString, getLevenshteinDistance, isPalindrome, getLevenshteinDistance as levenshteinDistance, } from './string/utilities';
 export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getRandomNumber, isEven, isEven as isEvenNumber, isMultiple, isOdd, isOdd as isOddNumber, } from './number/basics';
-export { numberToWords } from './number/convert';
+export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
 export { findPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
+export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';

package/dist/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/index.js

@@ -5,8 +5,9 @@ export { convertStringCase, maskString, replaceAllInString, reverseString, slugi
 export { extractNumbersFromString, getLevenshteinDistance, isPalindrome, getLevenshteinDistance as levenshteinDistance, } from './string/utilities';
 // ! Number Utilities
 export { calculateHCF as calculateGCD, calculateHCF, calculateLCM as calculateLCD, calculateLCM, convertToDecimal, getRandomNumber, isEven, isEven as isEvenNumber, isMultiple, isOdd, isOdd as isOddNumber, } from './number/basics';
-export { numberToWords } from './number/convert';
+export { numberToWords as convertNumberToWords, convertToRomanNumerals, numberToWords, } from './number/convert';
 export { findPrimeNumbers, isPrime, isPrime as isPrimeNumber, } from './number/prime';
+export { clampNumber, formatCurrency as convertNumberToCurrency, formatCurrency, getRandomFloat as getRandomDecimal, getRandomFloat, roundToNearest as roundNumber, roundToNearest as roundNumberToNearestInterval, roundToNearest, roundToNearest as roundToNearestInterval, } from './number/utilities';
 export { getNumbersInRange } from './number/range';
 // ! Color Utilities
 export { getColorForInitial } from './colors/initials';

package/dist/number/constants.d.ts

@@ -2,4 +2,171 @@ export declare const ones: readonly ["", "one", "two", "three", "four", "five",
 export declare const teens: readonly ["", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen"];
 export declare const tens: readonly ["", "ten", "twenty", "thirty", "forty", "fifty", "sixty", "seventy", "eighty", "ninety"];
 export declare const thousands: readonly ["", "thousand", "million", "billion", "trillion", "quadrillion", "quintillion", "sextillion", "septillion", "octillion", "nonillion", "decillion"];
+/** List of ISO 4217 currency codes */
+export declare const CURRENCY_CODES: readonly ["AED", "AFN", "ALL", "AMD", "ANG", "AOA", "ARS", "AUD", "AWG", "AZN", "BAM", "BBD", "BDT", "BGN", "BHD", "BIF", "BMD", "BND", "BOB", "BRL", "BSD", "BTN", "BWP", "BYN", "BZD", "CAD", "CDF", "CHF", "CLP", "CNY", "COP", "CRC", "CUP", "CVE", "CZK", "DJF", "DKK", "DOP", "DZD", "EGP", "ERN", "ETB", "EUR", "FJD", "FKP", "FOK", "GBP", "GEL", "GGP", "GHS", "GIP", "GMD", "GNF", "GTQ", "GYD", "HKD", "HNL", "HRK", "HTG", "HUF", "IDR", "ILS", "IMP", "INR", "IQD", "IRR", "ISK", "JEP", "JMD", "JOD", "JPY", "KES", "KGS", "KHR", "KID", "KMF", "KRW", "KWD", "KYD", "KZT", "LAK", "LBP", "LKR", "LRD", "LSL", "LYD", "MAD", "MDL", "MGA", "MKD", "MMK", "MNT", "MOP", "MRU", "MUR", "MVR", "MWK", "MXN", "MYR", "MZN", "NAD", "NGN", "NIO", "NOK", "NPR", "NZD", "OMR", "PAB", "PEN", "PGK", "PHP", "PKR", "PLN", "PYG", "QAR", "RON", "RSD", "RUB", "RWF", "SAR", "SBD", "SCR", "SDG", "SEK", "SGD", "SHP", "SLE", "SOS", "SRD", "SSP", "STN", "SYP", "SZL", "THB", "TJS", "TMT", "TND", "TOP", "TRY", "TTD", "TVD", "TWD", "TZS", "UAH", "UGX", "USD", "UYU", "UZS", "VES", "VND", "VUV", "WST", "XAF", "XCD", "XOF", "XPF", "YER", "ZAR", "ZMW", "ZWL"];
+/** List of all supported BCP 47 locales */
+export declare const LOCALE_CODES: readonly ["af-ZA", "am-ET", "ar-AE", "ar-BH", "ar-DZ", "ar-EG", "ar-IQ", "ar-JO", "ar-KW", "ar-LB", "ar-LY", "ar-MA", "ar-OM", "ar-QA", "ar-SA", "ar-SD", "ar-SY", "ar-TN", "ar-YE", "az-AZ", "be-BY", "bg-BG", "bn-BD", "bn-IN", "bs-BA", "ca-ES", "cs-CZ", "cy-GB", "da-DK", "de-AT", "de-CH", "de-DE", "el-GR", "en-AU", "en-CA", "en-GB", "en-IE", "en-IN", "en-NZ", "en-PH", "en-SG", "en-US", "en-ZA", "es-AR", "es-BO", "es-CL", "es-CO", "es-CR", "es-DO", "es-EC", "es-ES", "es-GT", "es-HN", "es-MX", "es-NI", "es-PA", "es-PE", "es-PR", "es-PY", "es-SV", "es-US", "es-UY", "es-VE", "et-EE", "eu-ES", "fa-IR", "fi-FI", "fil-PH", "fr-BE", "fr-CA", "fr-CH", "fr-FR", "ga-IE", "gl-ES", "gu-IN", "he-IL", "hi-IN", "hr-HR", "hu-HU", "hy-AM", "id-ID", "is-IS", "it-CH", "it-IT", "ja-JP", "ka-GE", "kk-KZ", "km-KH", "kn-IN", "ko-KR", "ky-KG", "lt-LT", "lv-LV", "mk-MK", "ml-IN", "mn-MN", "mr-IN", "ms-MY", "mt-MT", "nb-NO", "ne-NP", "nl-BE", "nl-NL", "pl-PL", "pt-BR", "pt-PT", "ro-RO", "ru-RU", "sk-SK", "sl-SI", "sq-AL", "sr-Latn", "sv-SE", "sw-KE", "ta-IN", "te-IN", "th-TH", "tr-TR", "uk-UA", "ur-PK", "uz-UZ", "vi-VN", "zh-CN", "zh-HK", "zh-TW"];
+/** Mapping of CurrencyCodes to LocaleCodes */
+export declare const CURRENCY_LOCALES: {
+    readonly AED: "ar-AE";
+    readonly AFN: "fa-IR";
+    readonly ALL: "sq-AL";
+    readonly AMD: "hy-AM";
+    readonly ANG: "nl-NL";
+    readonly AOA: "pt-AO";
+    readonly ARS: "es-AR";
+    readonly AUD: "en-AU";
+    readonly AWG: "nl-AW";
+    readonly AZN: "az-AZ";
+    readonly BAM: "bs-BA";
+    readonly BBD: "en-BB";
+    readonly BDT: "bn-BD";
+    readonly BGN: "bg-BG";
+    readonly BHD: "ar-BH";
+    readonly BIF: "fr-BI";
+    readonly BMD: "en-BM";
+    readonly BND: "ms-BN";
+    readonly BOB: "es-BO";
+    readonly BRL: "pt-BR";
+    readonly BSD: "en-BS";
+    readonly BTN: "dz-BT";
+    readonly BWP: "en-BW";
+    readonly BYN: "be-BY";
+    readonly BZD: "es-BZ";
+    readonly CAD: "fr-CA";
+    readonly CDF: "fr-CD";
+    readonly CHF: "fr-CH";
+    readonly CLP: "es-CL";
+    readonly CNY: "zh-CN";
+    readonly COP: "es-CO";
+    readonly CRC: "es-CR";
+    readonly CUP: "es-CU";
+    readonly CVE: "pt-CV";
+    readonly CZK: "cs-CZ";
+    readonly DJF: "fr-DJ";
+    readonly DKK: "da-DK";
+    readonly DOP: "es-DO";
+    readonly DZD: "ar-DZ";
+    readonly EGP: "ar-EG";
+    readonly ERN: "ti-ER";
+    readonly ETB: "am-ET";
+    readonly EUR: "de-DE";
+    readonly FJD: "en-FJ";
+    readonly FKP: "en-FK";
+    readonly FOK: "fo-FO";
+    readonly GBP: "en-GB";
+    readonly GEL: "ka-GE";
+    readonly GGP: "en-GG";
+    readonly GHS: "ak-GH";
+    readonly GIP: "en-GI";
+    readonly GMD: "en-GM";
+    readonly GNF: "fr-GN";
+    readonly GTQ: "es-GT";
+    readonly GYD: "en-GY";
+    readonly HKD: "zh-HK";
+    readonly HNL: "es-HN";
+    readonly HRK: "hr-HR";
+    readonly HTG: "ht-HT";
+    readonly HUF: "hu-HU";
+    readonly IDR: "id-ID";
+    readonly ILS: "he-IL";
+    readonly IMP: "en-IM";
+    readonly INR: "hi-IN";
+    readonly IQD: "ar-IQ";
+    readonly IRR: "fa-IR";
+    readonly ISK: "is-IS";
+    readonly JEP: "en-JE";
+    readonly JMD: "en-JM";
+    readonly JOD: "ar-JO";
+    readonly JPY: "ja-JP";
+    readonly KES: "sw-KE";
+    readonly KGS: "ky-KG";
+    readonly KHR: "km-KH";
+    readonly KID: "en-KI";
+    readonly KMF: "fr-KM";
+    readonly KRW: "ko-KR";
+    readonly KWD: "ar-KW";
+    readonly KYD: "en-KY";
+    readonly KZT: "kk-KZ";
+    readonly LAK: "lo-LA";
+    readonly LBP: "ar-LB";
+    readonly LKR: "si-LK";
+    readonly LRD: "en-LR";
+    readonly LSL: "st-LS";
+    readonly LYD: "ar-LY";
+    readonly MAD: "ar-MA";
+    readonly MDL: "ro-RO";
+    readonly MGA: "mg-MG";
+    readonly MKD: "mk-MK";
+    readonly MMK: "my-MM";
+    readonly MNT: "mn-MN";
+    readonly MOP: "pt-MO";
+    readonly MRU: "ar-MA";
+    readonly MUR: "en-MU";
+    readonly MVR: "dv-MV";
+    readonly MWK: "ny-MW";
+    readonly MXN: "es-MX";
+    readonly MYR: "ms-MY";
+    readonly MZN: "pt-MZ";
+    readonly NAD: "en-NA";
+    readonly NGN: "en-NG";
+    readonly NIO: "es-NI";
+    readonly NOK: "no-NO";
+    readonly NPR: "ne-NP";
+    readonly NZD: "en-NZ";
+    readonly OMR: "ar-OM";
+    readonly PAB: "es-PA";
+    readonly PEN: "es-PE";
+    readonly PGK: "en-PG";
+    readonly PHP: "fil-PH";
+    readonly PKR: "ur-PK";
+    readonly PLN: "pl-PL";
+    readonly PYG: "es-PY";
+    readonly QAR: "ar-QA";
+    readonly RON: "ro-RO";
+    readonly RSD: "sr-RS";
+    readonly RUB: "ru-RU";
+    readonly RWF: "rw-RW";
+    readonly SAR: "ar-SA";
+    readonly SBD: "en-SB";
+    readonly SCR: "en-SC";
+    readonly SDG: "ar-SD";
+    readonly SEK: "sv-SE";
+    readonly SGD: "en-SG";
+    readonly SHP: "en-SH";
+    readonly SLE: "en-SL";
+    readonly SOS: "so-SO";
+    readonly SRD: "nl-SR";
+    readonly SSP: "en-SS";
+    readonly STN: "st-ST";
+    readonly SYP: "ar-SY";
+    readonly SZL: "en-SZ";
+    readonly THB: "th-TH";
+    readonly TJS: "tg-TJ";
+    readonly TMT: "tk-TM";
+    readonly TND: "ar-TN";
+    readonly TOP: "to-TO";
+    readonly TRY: "tr-TR";
+    readonly TTD: "en-TT";
+    readonly TVD: "en-TV";
+    readonly TWD: "zh-TW";
+    readonly TZS: "sw-TZ";
+    readonly UAH: "uk-UA";
+    readonly UGX: "sw-UG";
+    readonly USD: "en-US";
+    readonly UYU: "es-UY";
+    readonly UZS: "uz-UZ";
+    readonly VES: "ve-VE";
+    readonly VND: "vi-VN";
+    readonly VUV: "en-VU";
+    readonly WST: "en-WS";
+    readonly XAF: "fr-XAF";
+    readonly XCD: "en-XCD";
+    readonly XOF: "fr-XOF";
+    readonly XPF: "fr-XPF";
+    readonly YER: "ar-YE";
+    readonly ZAR: "en-ZA";
+    readonly ZMW: "en-ZM";
+    readonly ZWL: "en-ZW";
+};
 //# sourceMappingURL=constants.d.ts.map

package/dist/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"}
+{"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"}

package/dist/number/constants.js

@@ -48,3 +48,457 @@ export const thousands = [
     'nonillion',
     'decillion',
 ];
+/** List of ISO 4217 currency codes */
+export const CURRENCY_CODES = [
+    'AED',
+    'AFN',
+    'ALL',
+    'AMD',
+    'ANG',
+    'AOA',
+    'ARS',
+    'AUD',
+    'AWG',
+    'AZN',
+    'BAM',
+    'BBD',
+    'BDT',
+    'BGN',
+    'BHD',
+    'BIF',
+    'BMD',
+    'BND',
+    'BOB',
+    'BRL',
+    'BSD',
+    'BTN',
+    'BWP',
+    'BYN',
+    'BZD',
+    'CAD',
+    'CDF',
+    'CHF',
+    'CLP',
+    'CNY',
+    'COP',
+    'CRC',
+    'CUP',
+    'CVE',
+    'CZK',
+    'DJF',
+    'DKK',
+    'DOP',
+    'DZD',
+    'EGP',
+    'ERN',
+    'ETB',
+    'EUR',
+    'FJD',
+    'FKP',
+    'FOK',
+    'GBP',
+    'GEL',
+    'GGP',
+    'GHS',
+    'GIP',
+    'GMD',
+    'GNF',
+    'GTQ',
+    'GYD',
+    'HKD',
+    'HNL',
+    'HRK',
+    'HTG',
+    'HUF',
+    'IDR',
+    'ILS',
+    'IMP',
+    'INR',
+    'IQD',
+    'IRR',
+    'ISK',
+    'JEP',
+    'JMD',
+    'JOD',
+    'JPY',
+    'KES',
+    'KGS',
+    'KHR',
+    'KID',
+    'KMF',
+    'KRW',
+    'KWD',
+    'KYD',
+    'KZT',
+    'LAK',
+    'LBP',
+    'LKR',
+    'LRD',
+    'LSL',
+    'LYD',
+    'MAD',
+    'MDL',
+    'MGA',
+    'MKD',
+    'MMK',
+    'MNT',
+    'MOP',
+    'MRU',
+    'MUR',
+    'MVR',
+    'MWK',
+    'MXN',
+    'MYR',
+    'MZN',
+    'NAD',
+    'NGN',
+    'NIO',
+    'NOK',
+    'NPR',
+    'NZD',
+    'OMR',
+    'PAB',
+    'PEN',
+    'PGK',
+    'PHP',
+    'PKR',
+    'PLN',
+    'PYG',
+    'QAR',
+    'RON',
+    'RSD',
+    'RUB',
+    'RWF',
+    'SAR',
+    'SBD',
+    'SCR',
+    'SDG',
+    'SEK',
+    'SGD',
+    'SHP',
+    'SLE',
+    'SOS',
+    'SRD',
+    'SSP',
+    'STN',
+    'SYP',
+    'SZL',
+    'THB',
+    'TJS',
+    'TMT',
+    'TND',
+    'TOP',
+    'TRY',
+    'TTD',
+    'TVD',
+    'TWD',
+    'TZS',
+    'UAH',
+    'UGX',
+    'USD',
+    'UYU',
+    'UZS',
+    'VES',
+    'VND',
+    'VUV',
+    'WST',
+    'XAF',
+    'XCD',
+    'XOF',
+    'XPF',
+    'YER',
+    'ZAR',
+    'ZMW',
+    'ZWL',
+];
+/** List of all supported BCP 47 locales */
+export const LOCALE_CODES = [
+    'af-ZA',
+    'am-ET',
+    'ar-AE',
+    'ar-BH',
+    'ar-DZ',
+    'ar-EG',
+    'ar-IQ',
+    'ar-JO',
+    'ar-KW',
+    'ar-LB',
+    'ar-LY',
+    'ar-MA',
+    'ar-OM',
+    'ar-QA',
+    'ar-SA',
+    'ar-SD',
+    'ar-SY',
+    'ar-TN',
+    'ar-YE',
+    'az-AZ',
+    'be-BY',
+    'bg-BG',
+    'bn-BD',
+    'bn-IN',
+    'bs-BA',
+    'ca-ES',
+    'cs-CZ',
+    'cy-GB',
+    'da-DK',
+    'de-AT',
+    'de-CH',
+    'de-DE',
+    'el-GR',
+    'en-AU',
+    'en-CA',
+    'en-GB',
+    'en-IE',
+    'en-IN',
+    'en-NZ',
+    'en-PH',
+    'en-SG',
+    'en-US',
+    'en-ZA',
+    'es-AR',
+    'es-BO',
+    'es-CL',
+    'es-CO',
+    'es-CR',
+    'es-DO',
+    'es-EC',
+    'es-ES',
+    'es-GT',
+    'es-HN',
+    'es-MX',
+    'es-NI',
+    'es-PA',
+    'es-PE',
+    'es-PR',
+    'es-PY',
+    'es-SV',
+    'es-US',
+    'es-UY',
+    'es-VE',
+    'et-EE',
+    'eu-ES',
+    'fa-IR',
+    'fi-FI',
+    'fil-PH',
+    'fr-BE',
+    'fr-CA',
+    'fr-CH',
+    'fr-FR',
+    'ga-IE',
+    'gl-ES',
+    'gu-IN',
+    'he-IL',
+    'hi-IN',
+    'hr-HR',
+    'hu-HU',
+    'hy-AM',
+    'id-ID',
+    'is-IS',
+    'it-CH',
+    'it-IT',
+    'ja-JP',
+    'ka-GE',
+    'kk-KZ',
+    'km-KH',
+    'kn-IN',
+    'ko-KR',
+    'ky-KG',
+    'lt-LT',
+    'lv-LV',
+    'mk-MK',
+    'ml-IN',
+    'mn-MN',
+    'mr-IN',
+    'ms-MY',
+    'mt-MT',
+    'nb-NO',
+    'ne-NP',
+    'nl-BE',
+    'nl-NL',
+    'pl-PL',
+    'pt-BR',
+    'pt-PT',
+    'ro-RO',
+    'ru-RU',
+    'sk-SK',
+    'sl-SI',
+    'sq-AL',
+    'sr-Latn',
+    'sv-SE',
+    'sw-KE',
+    'ta-IN',
+    'te-IN',
+    'th-TH',
+    'tr-TR',
+    'uk-UA',
+    'ur-PK',
+    'uz-UZ',
+    'vi-VN',
+    'zh-CN',
+    'zh-HK',
+    'zh-TW',
+];
+/** Mapping of CurrencyCodes to LocaleCodes */
+export const CURRENCY_LOCALES = {
+    AED: 'ar-AE', // United Arab Emirates Dirham
+    AFN: 'fa-IR', // Afghan Afghani
+    ALL: 'sq-AL', // Albanian Lek
+    AMD: 'hy-AM', // Armenian Dram
+    ANG: 'nl-NL', // Netherlands Antillean Guilder
+    AOA: 'pt-AO', // Angolan Kwanza
+    ARS: 'es-AR', // Argentine Peso
+    AUD: 'en-AU', // Australian Dollar
+    AWG: 'nl-AW', // Aruban Florin
+    AZN: 'az-AZ', // Azerbaijani Manat
+    BAM: 'bs-BA', // Bosnia and Herzegovina Convertible Mark
+    BBD: 'en-BB', // Barbadian Dollar
+    BDT: 'bn-BD', // Bangladeshi Taka
+    BGN: 'bg-BG', // Bulgarian Lev
+    BHD: 'ar-BH', // Bahraini Dinar
+    BIF: 'fr-BI', // Burundian Franc
+    BMD: 'en-BM', // Bermudian Dollar
+    BND: 'ms-BN', // Brunei Dollar
+    BOB: 'es-BO', // Bolivian Boliviano
+    BRL: 'pt-BR', // Brazilian Real
+    BSD: 'en-BS', // Bahamian Dollar
+    BTN: 'dz-BT', // Bhutanese Ngultrum
+    BWP: 'en-BW', // Botswanan Pula
+    BYN: 'be-BY', // Belarusian Ruble
+    BZD: 'es-BZ', // Belize Dollar
+    CAD: 'fr-CA', // Canadian Dollar
+    CDF: 'fr-CD', // Congolese Franc
+    CHF: 'fr-CH', // Swiss Franc
+    CLP: 'es-CL', // Chilean Peso
+    CNY: 'zh-CN', // Chinese Yuan
+    COP: 'es-CO', // Colombian Peso
+    CRC: 'es-CR', // Costa Rican Colón
+    CUP: 'es-CU', // Cuban Peso
+    CVE: 'pt-CV', // Cape Verdean Escudo
+    CZK: 'cs-CZ', // Czech Koruna
+    DJF: 'fr-DJ', // Djiboutian Franc
+    DKK: 'da-DK', // Danish Krone
+    DOP: 'es-DO', // Dominican Peso
+    DZD: 'ar-DZ', // Algerian Dinar
+    EGP: 'ar-EG', // Egyptian Pound
+    ERN: 'ti-ER', // Eritrean Nakfa
+    ETB: 'am-ET', // Ethiopian Birr
+    EUR: 'de-DE', // Euro
+    FJD: 'en-FJ', // Fijian Dollar
+    FKP: 'en-FK', // Falkland Islands Pound
+    FOK: 'fo-FO', // Faroese Króna
+    GBP: 'en-GB', // British Pound Sterling
+    GEL: 'ka-GE', // Georgian Lari
+    GGP: 'en-GG', // Guernsey Pound
+    GHS: 'ak-GH', // Ghanaian Cedi
+    GIP: 'en-GI', // Gibraltar Pound
+    GMD: 'en-GM', // Gambian Dalasi
+    GNF: 'fr-GN', // Guinean Franc
+    GTQ: 'es-GT', // Guatemalan Quetzal
+    GYD: 'en-GY', // Guyanaese Dollar
+    HKD: 'zh-HK', // Hong Kong Dollar
+    HNL: 'es-HN', // Honduran Lempira
+    HRK: 'hr-HR', // Croatian Kuna
+    HTG: 'ht-HT', // Haitian Gourde
+    HUF: 'hu-HU', // Hungarian Forint
+    IDR: 'id-ID', // Indonesian Rupiah
+    ILS: 'he-IL', // Israeli New Shekel
+    IMP: 'en-IM', // Isle of Man Pound
+    INR: 'hi-IN', // Indian Rupee
+    IQD: 'ar-IQ', // Iraqi Dinar
+    IRR: 'fa-IR', // Iranian Rial
+    ISK: 'is-IS', // Icelandic Króna
+    JEP: 'en-JE', // Jersey Pound
+    JMD: 'en-JM', // Jamaican Dollar
+    JOD: 'ar-JO', // Jordanian Dinar
+    JPY: 'ja-JP', // Japanese Yen
+    KES: 'sw-KE', // Kenyan Shilling
+    KGS: 'ky-KG', // Kyrgyzstani Som
+    KHR: 'km-KH', // Cambodian Riel
+    KID: 'en-KI', // Kiribati Dollar
+    KMF: 'fr-KM', // Comorian Franc
+    KRW: 'ko-KR', // South Korean Won
+    KWD: 'ar-KW', // Kuwaiti Dinar
+    KYD: 'en-KY', // Cayman Islands Dollar
+    KZT: 'kk-KZ', // Kazakhstani Tenge
+    LAK: 'lo-LA', // Laotian Kip
+    LBP: 'ar-LB', // Lebanese Pound
+    LKR: 'si-LK', // Sri Lankan Rupee
+    LRD: 'en-LR', // Liberian Dollar
+    LSL: 'st-LS', // Lesotho Loti
+    LYD: 'ar-LY', // Libyan Dinar
+    MAD: 'ar-MA', // Moroccan Dirham
+    MDL: 'ro-RO', // Moldovan Leu
+    MGA: 'mg-MG', // Malagasy Ariary
+    MKD: 'mk-MK', // Macedonian Denar
+    MMK: 'my-MM', // Burmese Kyat
+    MNT: 'mn-MN', // Mongolian Tugrik
+    MOP: 'pt-MO', // Macanese Pataca
+    MRU: 'ar-MA', // Mauritanian Ouguiya
+    MUR: 'en-MU', // Mauritian Rupee
+    MVR: 'dv-MV', // Maldivian Rufiyaa
+    MWK: 'ny-MW', // Malawian Kwacha
+    MXN: 'es-MX', // Mexican Peso
+    MYR: 'ms-MY', // Malaysian Ringgit
+    MZN: 'pt-MZ', // Mozambican Metical
+    NAD: 'en-NA', // Namibian Dollar
+    NGN: 'en-NG', // Nigerian Naira
+    NIO: 'es-NI', // Nicaraguan Córdoba
+    NOK: 'no-NO', // Norwegian Krone
+    NPR: 'ne-NP', // Nepalese Rupee
+    NZD: 'en-NZ', // New Zealand Dollar
+    OMR: 'ar-OM', // Omani Rial
+    PAB: 'es-PA', // Panamanian Balboa
+    PEN: 'es-PE', // Peruvian Nuevo Sol
+    PGK: 'en-PG', // Papua New Guinean Kina
+    PHP: 'fil-PH', // Philippine Peso
+    PKR: 'ur-PK', // Pakistani Rupee
+    PLN: 'pl-PL', // Polish Zloty
+    PYG: 'es-PY', // Paraguayan Guarani
+    QAR: 'ar-QA', // Qatari Rial
+    RON: 'ro-RO', // Romanian Leu
+    RSD: 'sr-RS', // Serbian Dinar
+    RUB: 'ru-RU', // Russian Ruble
+    RWF: 'rw-RW', // Rwandan Franc
+    SAR: 'ar-SA', // Saudi Riyal
+    SBD: 'en-SB', // Solomon Islands Dollar
+    SCR: 'en-SC', // Seychellois Rupee
+    SDG: 'ar-SD', // Sudanese Pound
+    SEK: 'sv-SE', // Swedish Krona
+    SGD: 'en-SG', // Singapore Dollar
+    SHP: 'en-SH', // Saint Helena Pound
+    SLE: 'en-SL', // Sierra Leonean Leone
+    SOS: 'so-SO', // Somali Shilling
+    SRD: 'nl-SR', // Surinamese Dollar
+    SSP: 'en-SS', // South Sudanese Pound
+    STN: 'st-ST', // São Tomé and Príncipe Dobra
+    SYP: 'ar-SY', // Syrian Pound
+    SZL: 'en-SZ', // Swazi Lilangeni
+    THB: 'th-TH', // Thai Baht
+    TJS: 'tg-TJ', // Tajikistani Somoni
+    TMT: 'tk-TM', // Turkmenistan Manat
+    TND: 'ar-TN', // Tunisian Dinar
+    TOP: 'to-TO', // Tongan Paʻanga
+    TRY: 'tr-TR', // Turkish Lira
+    TTD: 'en-TT', // Trinidad and Tobago Dollar
+    TVD: 'en-TV', // Tuvaluan Dollar
+    TWD: 'zh-TW', // New Taiwan Dollar
+    TZS: 'sw-TZ', // Tanzanian Shilling
+    UAH: 'uk-UA', // Ukrainian Hryvnia
+    UGX: 'sw-UG', // Ugandan Shilling
+    USD: 'en-US', // United States Dollar
+    UYU: 'es-UY', // Uruguayan Peso
+    UZS: 'uz-UZ', // Uzbekistani Som
+    VES: 've-VE', // Venezuelan Bolívar
+    VND: 'vi-VN', // Vietnamese Dong
+    VUV: 'en-VU', // Vanuatu Vatu
+    WST: 'en-WS', // Samoan Tala
+    XAF: 'fr-XAF', // Central African CFA Franc
+    XCD: 'en-XCD', // East Caribbean Dollar
+    XOF: 'fr-XOF', // West African CFA Franc
+    XPF: 'fr-XPF', // CFP Franc
+    YER: 'ar-YE', // Yemeni Rial
+    ZAR: 'en-ZA', // South African Rand
+    ZMW: 'en-ZM', // Zambian Kwacha
+    ZWL: 'en-ZW', // Zimbabwean Dollar
+};

package/dist/number/convert.d.ts

@@ -4,4 +4,11 @@
  * @returns The number converted in words.
  */
 export declare function numberToWords(number: number): string;
+/**
+ * * Converts a number to a Roman numeral.
+ * @param num - The number to convert.
+ * @returns The Roman numeral representation.
+ * @example convertToRomanNumerals(29) → "XXIX"
+ */
+export declare const convertToRomanNumerals: (num: number) => string;
 //# sourceMappingURL=convert.d.ts.map

package/dist/number/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/number/convert.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BpD"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/number/convert.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA0BpD;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,MAAM,KAAG,MA4BpD,CAAC"}

package/dist/number/convert.js

@@ -24,3 +24,36 @@ export function numberToWords(number) {
     const finalResult = result.trim().replace(/\s+/g, ' ');
     return isNegative ? `minus ${finalResult}` : finalResult;
 }
+/**
+ * * Converts a number to a Roman numeral.
+ * @param num - The number to convert.
+ * @returns The Roman numeral representation.
+ * @example convertToRomanNumerals(29) → "XXIX"
+ */
+export const convertToRomanNumerals = (num) => {
+    if (num <= 0 || num >= 4000)
+        throw new RangeError('Number must be between 1 and 3999');
+    const romanMap = [
+        [1000, 'M'],
+        [900, 'CM'],
+        [500, 'D'],
+        [400, 'CD'],
+        [100, 'C'],
+        [90, 'XC'],
+        [50, 'L'],
+        [40, 'XL'],
+        [10, 'X'],
+        [9, 'IX'],
+        [5, 'V'],
+        [4, 'IV'],
+        [1, 'I'],
+    ];
+    let result = '';
+    for (const [value, numeral] of romanMap) {
+        while (num >= value) {
+            result += numeral;
+            num -= value;
+        }
+    }
+    return result;
+};

package/dist/number/range.js

@@ -12,7 +12,7 @@ import { isPrime } from './prime';
  * @returns Either a string or an array of numbers.
  */
 export function getNumbersInRange(type = 'any', options) {
-    const { getAs = 'array', min = 0, max = 100, includeMin = true, includeMax = true, separator = ',', multiples, } = options || {};
+    const { getAs = 'array', min = 0, max = 100, includeMin = true, includeMax = true, separator = ',', multiplesOf: multiples, } = options || {};
     let output = [];
     /**
      * Helper function to apply range and get array of numbers in that range.

package/dist/number/types.d.ts

@@ -1,3 +1,4 @@
+import type { CURRENCY_CODES, CURRENCY_LOCALES, LOCALE_CODES } from './constants';
 /** - Options for random number generator */
 export interface RandomNumberOptions {
     /** Minimum number to start with. */
@@ -27,10 +28,14 @@ export interface RangeOptions<T extends GetAs> extends RandomNumberOptions {
     /** Separator for the string format if `getAs` is `'string'`. Defaults to `,`. */
     separator?: string;
     /** The multiples of which number to consider in the result. */
-    multiples?: number;
+    multiplesOf?: number;
     /** The format for the result - either `'array'` or `'string'`. Default is `array` */
     getAs?: T;
 }
 /** - The return type of the `getNumbersInRange` function */
 export type RangedNumbers<T extends GetAs> = T extends 'array' ? number[] : string;
+/** List of ISO 4217 currency codes. */
+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];
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/number/types.ts"],"names":[],"mappings":"AAAA,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,MAAM,GAAG,MAAM,CAAC;AAEnE,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,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/number/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,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,MAAM,GAAG,MAAM,CAAC;AAEnE,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"}

package/dist/number/utilities.d.ts

@@ -0,0 +1,40 @@
+import type { CurrencyCode, LocaleCode } from './types';
+/**
+ * * Rounds a number to the nearest specified interval.
+ * @param value - The number to round.
+ * @param interval - The interval to round to. Defaults to `5`.
+ * @returns The number rounded to the nearest interval.
+ * @example roundToNearest(27, 5) → 25
+ */
+export declare const roundToNearest: (value: number, interval?: number) => number;
+/**
+ * * Formats a number as a currency string.
+ * @param value - The number to format.
+ * @param currency - The currency code (default: `USD`).
+ * @param locale - The locale for formatting (default: matching currency locale).
+ * @returns A formatted currency string.
+ * @example formatCurrency(1234.56) → "$1,234.56"
+ * @example formatCurrency(1234.56, "USD") → "$1,234.56"
+ * @example formatCurrency(1234.56, "USD", "en-US") → "$1,234.56"
+ */
+export declare const formatCurrency: (value: number, currency?: CurrencyCode, locale?: LocaleCode) => string;
+/**
+ * * Clamps a number within a specified range.
+ * @param value - The number to clamp.
+ * @param min - The minimum allowed value.
+ * @param max - The maximum allowed value.
+ * @returns The clamped number.
+ * @example clampNumber(15, 10, 20) → 15
+ * @example clampNumber(5, 10, 20) → 10
+ * @example clampNumber(25, 10, 20) → 20
+ */
+export declare const clampNumber: (value: number, min: number, max: number) => number;
+/**
+ * * Generates a random floating-point number within a range.
+ * @param min - The minimum value.
+ * @param max - The maximum value.
+ * @returns A random floating-point number between min and max.
+ * @example randomFloat(1.5, 3.5) → 2.84623
+ */
+export declare const getRandomFloat: (min: number, max: number) => number;
+//# sourceMappingURL=utilities.d.ts.map

package/dist/number/utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/number/utilities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,UAAW,MAAM,wBAAiB,MACrB,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,UACnB,MAAM,aACH,YAAY,WACb,UAAU,KACjB,MAQF,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,OAAO,MAAM,OAAO,MAAM,KAAG,MAClC,CAAC;AAErC;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,QAAS,MAAM,OAAO,MAAM,KAAG,MAEzD,CAAC"}

package/dist/number/utilities.js

@@ -0,0 +1,47 @@
+import { CURRENCY_LOCALES } from './constants';
+/**
+ * * Rounds a number to the nearest specified interval.
+ * @param value - The number to round.
+ * @param interval - The interval to round to. Defaults to `5`.
+ * @returns The number rounded to the nearest interval.
+ * @example roundToNearest(27, 5) → 25
+ */
+export const roundToNearest = (value, interval = 5) => Math.round(value / interval) * interval;
+/**
+ * * Formats a number as a currency string.
+ * @param value - The number to format.
+ * @param currency - The currency code (default: `USD`).
+ * @param locale - The locale for formatting (default: matching currency locale).
+ * @returns A formatted currency string.
+ * @example formatCurrency(1234.56) → "$1,234.56"
+ * @example formatCurrency(1234.56, "USD") → "$1,234.56"
+ * @example formatCurrency(1234.56, "USD", "en-US") → "$1,234.56"
+ */
+export const formatCurrency = (value, currency = 'USD', locale) => {
+    const selectedLocale = locale ? locale : CURRENCY_LOCALES[currency];
+    return new Intl.NumberFormat(selectedLocale, {
+        style: 'currency',
+        currency,
+    }).format(value);
+};
+/**
+ * * Clamps a number within a specified range.
+ * @param value - The number to clamp.
+ * @param min - The minimum allowed value.
+ * @param max - The maximum allowed value.
+ * @returns The clamped number.
+ * @example clampNumber(15, 10, 20) → 15
+ * @example clampNumber(5, 10, 20) → 10
+ * @example clampNumber(25, 10, 20) → 20
+ */
+export const clampNumber = (value, min, max) => Math.max(min, Math.min(value, max));
+/**
+ * * Generates a random floating-point number within a range.
+ * @param min - The minimum value.
+ * @param max - The maximum value.
+ * @returns A random floating-point number between min and max.
+ * @example randomFloat(1.5, 3.5) → 2.84623
+ */
+export const getRandomFloat = (min, max) => {
+    return Math.random() * (max - min) + min;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "2.8.5",
+  "version": "2.8.6",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",