nhb-toolbox 4.2.0 → 4.2.1

package/dist/cjs/number/constants.js

@@ -14,7 +14,7 @@ exports.ones = [
     'nine',
 ];
 exports.teens = [
-    '',
+    'ten',
     'eleven',
     'twelve',
     'thirteen',
@@ -45,11 +45,8 @@ exports.thousands = [
     'trillion',
     'quadrillion',
     'quintillion',
-    'sextillion',
-    'septillion',
-    'octillion',
-    'nonillion',
-    'decillion',
+    // ! Needs to modify later, below supports up to 10 sextillion! It's a bug!
+    // 'sextillion',
 ];
 /** List of ISO 4217 currency codes */
 exports.CURRENCY_CODES = [

package/dist/cjs/number/convert.js

@@ -5,7 +5,8 @@ exports.numberToWords = numberToWords;
 const constants_1 = require("./constants");
 const helpers_1 = require("./helpers");
 /**
- * * Converts a number to words
+ * * Converts a number to words.
+ * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */
@@ -18,6 +19,9 @@ function numberToWords(num) {
     let i = 0;
     let result = '';
     while (number > 0) {
+        if (i >= constants_1.thousands.length) {
+            return `Number exceeds supported range (max is 10e${constants_1.thousands.length * 3 - 2})`;
+        }
         if (number % 1000 !== 0) {
             const isLastGroup = i === 0 && number % 100 < 100;
             const prefix = (0, helpers_1._convertLessThanThousand)(number % 1000, isLastGroup);

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

@@ -1,7 +1,7 @@
 export declare const ones: readonly ["", "one", "two", "three", "four", "five", "six", "seven", "eight", "nine"];
-export declare const teens: readonly ["", "eleven", "twelve", "thirteen", "fourteen", "fifteen", "sixteen", "seventeen", "eighteen", "nineteen"];
+export declare const teens: readonly ["ten", "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"];
+export declare const thousands: readonly ["", "thousand", "million", "billion", "trillion", "quadrillion", "quintillion"];
 /** 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 */

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

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

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

@@ -1,6 +1,7 @@
 import type { Numeric } from '../types';
 /**
- * * Converts a number to words
+ * * Converts a number to words.
+ * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/number/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CA4BlD;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,OAAO,KAAG,MA8BrD,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/number/convert.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAIxC;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAgClD;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,QAAS,OAAO,KAAG,MA8BrD,CAAC"}

package/dist/esm/number/constants.js

@@ -11,7 +11,7 @@ export const ones = [
     'nine',
 ];
 export const teens = [
-    '',
+    'ten',
     'eleven',
     'twelve',
     'thirteen',
@@ -42,11 +42,8 @@ export const thousands = [
     'trillion',
     'quadrillion',
     'quintillion',
-    'sextillion',
-    'septillion',
-    'octillion',
-    'nonillion',
-    'decillion',
+    // ! Needs to modify later, below supports up to 10 sextillion! It's a bug!
+    // 'sextillion',
 ];
 /** List of ISO 4217 currency codes */
 export const CURRENCY_CODES = [

package/dist/esm/number/convert.js

@@ -1,7 +1,8 @@
 import { thousands } from './constants';
 import { _convertLessThanThousand } from './helpers';
 /**
- * * Converts a number to words
+ * * Converts a number to words.
+ * @Warning ***Supports numeric values up to `10e19` or `10^20` (one hundred quintillion).***
  * @param number - The number to convert into words.
  * @returns The number converted in words.
  */
@@ -14,6 +15,9 @@ export function numberToWords(num) {
     let i = 0;
     let result = '';
     while (number > 0) {
+        if (i >= thousands.length) {
+            return `Number exceeds supported range (max is 10e${thousands.length * 3 - 2})`;
+        }
         if (number % 1000 !== 0) {
             const isLastGroup = i === 0 && number % 100 < 100;
             const prefix = _convertLessThanThousand(number % 1000, isLastGroup);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "4.2.0",
+  "version": "4.2.1",
   "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",
@@ -52,7 +52,7 @@
     "name": "Nazmul Hassan",
     "email": "nazmulnhb@gmail.com"
   },
-  "license": "ISC",
+  "license": "Apache-2.0",
   "devDependencies": {
     "@eslint/js": "^9.18.0",
     "@types/jest": "^29.5.14",