nhb-toolbox 4.2.0 → 4.3.2

package/dist/cjs/date/Chronos.js

@@ -276,6 +276,10 @@ class Chronos {
     get timestamp() {
         return this.#date.getTime();
     }
+    /** * Gets the last date (number) of the current month `(28, 29, 30 or 31)`. */
+    get lastDateOfMonth() {
+        return this.lastDayOfMonth().#date.getDate();
+    }
     /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect() {
         return `[Chronos ${this.toLocalISOString()}]`;
@@ -694,6 +698,14 @@ class Chronos {
         const jul = new Date(year, 6, 1).getTimezoneOffset();
         return this.#date.getTimezoneOffset() < Math.max(jan, jul);
     }
+    /** @instance Checks if current day is the first day of the current month. */
+    isFirstDayOfMonth() {
+        return this.isSame(this.firstDayOfMonth(), 'day');
+    }
+    /** @instance Checks if current day is the last day of the current month. */
+    isLastDayOfMonth() {
+        return this.isSame(this.lastDayOfMonth(), 'day');
+    }
     /**
      * @instance Returns full time difference from now (or a specified time) down to a given level.
      *
@@ -938,6 +950,20 @@ class Chronos {
     getRelativeMilliSecond(time) {
         return this.#date.getTime() - this.#toNewDate(time).getTime();
     }
+    /** @instance Returns a new Chronos instance set to the first day of the current month. */
+    firstDayOfMonth() {
+        const year = this.#date.getFullYear();
+        const month = this.#date.getMonth();
+        const lastDate = new Date(year, month, 1);
+        return new Chronos(lastDate).#withOrigin('firstDayOfMonth');
+    }
+    /** @instance Returns a new Chronos instance set to the last day of the current month. */
+    lastDayOfMonth() {
+        const year = this.#date.getFullYear();
+        const month = this.#date.getMonth() + 1;
+        const lastDate = new Date(year, month, 0);
+        return new Chronos(lastDate).#withOrigin('lastDayOfMonth');
+    }
     /**
      * @instance Compares the stored date with now, returning the difference in the specified unit.
      *
@@ -1479,7 +1505,7 @@ class Chronos {
                 const daysOffset = (roundedWeek - 1) * 7;
                 startOfYear.setDate(startOfYear.getDate() + daysOffset);
                 startOfYear.setHours(0, 0, 0, 0);
-                return new Chronos(startOfYear);
+                return new Chronos(startOfYear).#withOrigin('round');
             }
             case 'month': {
                 const currentMonth = date.getMonth();

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/date/Chronos.d.ts

@@ -126,6 +126,8 @@ export declare class Chronos {
     get unix(): number;
     /** Gets the time value in milliseconds since midnight, January 1, 1970 UTC. */
     get timestamp(): number;
+    /** * Gets the last date (number) of the current month `(28, 29, 30 or 31)`. */
+    get lastDateOfMonth(): 28 | 29 | 30 | 31;
     /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect(): string;
     /** @instance Clones and returns a new Chronos instance with the same date. */
@@ -357,6 +359,10 @@ export declare class Chronos {
      * @returns Whether the date is in DST.
      */
     isDST(): boolean;
+    /** @instance Checks if current day is the first day of the current month. */
+    isFirstDayOfMonth(): boolean;
+    /** @instance Checks if current day is the last day of the current month. */
+    isLastDayOfMonth(): boolean;
     /**
      * @instance Returns full time difference from now (or a specified time) down to a given level.
      *
@@ -453,6 +459,10 @@ export declare class Chronos {
      * @returns The difference in number, negative is `Chronos` time is a past time else positive.
      */
     getRelativeMilliSecond(time?: ChronosInput): number;
+    /** @instance Returns a new Chronos instance set to the first day of the current month. */
+    firstDayOfMonth(): Chronos;
+    /** @instance Returns a new Chronos instance set to the last day of the current month. */
+    lastDayOfMonth(): Chronos;
     /**
      * @instance Compares the stored date with now, returning the difference in the specified unit.
      *

package/dist/dts/date/Chronos.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../../src/date/Chronos.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../../src/date/Chronos.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAIlD,OAAO,EAIN,MAAM,EAKN,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAEX,YAAY,EACZ,cAAc,EACd,aAAa,EACb,OAAO,EACP,aAAa,EACb,aAAa,EACb,OAAO,EACP,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,UAAU,EACV,MAAM,SAAS,CAAC;AAGjB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,OAAO;;IAGnB,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC;IAEnC;;;;;;OAMG;;IAGH;;;;;;OAMG;gBACS,KAAK,EAAE,MAAM;IAEzB;;;;;;OAMG;gBACS,KAAK,EAAE,MAAM;IAEzB;;;;;;OAMG;gBACS,KAAK,EAAE,IAAI;IAEvB;;;;;;OAMG;gBACS,KAAK,EAAE,OAAO;IAE1B;;;;;;;;;;;;OAYG;gBAEF,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,EAAE,CAAC,EAAE,MAAM;IAGZ;;;;;;;;;;OAUG;gBACS,KAAK,CAAC,EAAE,YAAY;IA0C/B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAexD;;;;OAIG;IACH,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM;IAKnD,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAuB7D,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAqBvC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAqBxC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAajC;IAgID,sCAAsC;IACtC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yCAAyC;IACzC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,yDAAyD;IACzD,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0CAA0C;IAC1C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,0CAA0C;IAC1C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,gDAAgD;IAChD,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,+CAA+C;IAC/C,IAAI,UAAU,IAAI,MAAM,CAIvB;IAED,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,0EAA0E;IAC1E,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,+EAA+E;IAC/E,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,+EAA+E;IAC/E,IAAI,eAAe,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAEvC;IAED,qFAAqF;IACrF,OAAO,IAAI,MAAM;IAIjB,8EAA8E;IAC9E,KAAK,IAAI,OAAO;IAMhB,oFAAoF;IACpF,MAAM,IAAI,MAAM;IAIhB,qFAAqF;IACrF,OAAO,IAAI,MAAM;IAIjB,6DAA6D;IAC7D,MAAM,IAAI,IAAI;IAiBd,2GAA2G;IAC3G,QAAQ,IAAI,MAAM;IAyBlB,+DAA+D;IAC/D,gBAAgB,IAAI,MAAM;IAkB1B,gEAAgE;IAChE,WAAW,IAAI,MAAM;IAkBrB;;;;;;OAMG;IACH,cAAc,CACb,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,EAChE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAClC,MAAM;IAIT,4FAA4F;IAC5F,YAAY,IAAI,MAAM;IAItB;;;;;;OAMG;IACH,MAAM,CACL,MAAM,GAAE,MAAwC,EAChD,MAAM,UAAQ,GACZ,MAAM;IAIT;;;;;;;OAOG;IACH,YAAY,CACX,MAAM,GAAE,YAA0C,EAClD,MAAM,UAAQ,GACZ,MAAM;IAIT;;;;;OAKG;IACH,SAAS,CAAC,MAAM,GAAE,MAAwC,GAAG,MAAM;IAUnE;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAMpC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAMlC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMhC;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO;IAoB7C;;;;;OAKG;IACH,UAAU,IAAI,OAAO;IAMrB,qDAAqD;IACrD,OAAO,IAAI,OAAO;IAIlB,wDAAwD;IACxD,UAAU,IAAI,OAAO;IAIrB,yDAAyD;IACzD,WAAW,IAAI,OAAO;IAItB;;;;;OAKG;IACH,MAAM,CACL,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,QAAQ,EACd,YAAY,GAAE,MAAU,GACtB,OAAO;IASV;;;;;OAKG;IACH,QAAQ,CACP,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,QAAQ,EACd,YAAY,GAAE,MAAU,GACtB,OAAO;IASV;;;;;OAKG;IACH,OAAO,CACN,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,QAAQ,EACd,YAAY,GAAE,MAAU,GACtB,OAAO;IASV;;;;;;;;;;;;OAYG;IACH,SAAS,CACR,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,YAAY,EACjB,SAAS,GAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAW,GACzC,OAAO;IAiBV;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,YAAY,GAAE,MAAU,EAAE,aAAa,GAAE,CAAC,GAAG,CAAK,GAAG,OAAO;IAYtE;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,YAAY,GAAE,MAAU,EAAE,aAAa,GAAE,CAAC,GAAG,CAAK,GAAG,OAAO;IAItE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CACb,iBAAiB,GAAE,MAAU,EAC7B,eAAe,GAAE,MAAW,EAC5B,YAAY,GAAE,MAAU,EACxB,aAAa,GAAE,CAAC,GAAG,CAAK,GACtB,OAAO;IAoBV;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,CAAC,SAAS,UAAQ,GAAG,OAAO;IAM5C;;;OAGG;IACH,KAAK,IAAI,OAAO;IAUhB,6EAA6E;IAC7E,iBAAiB,IAAI,OAAO;IAI5B,4EAA4E;IAC5E,gBAAgB,IAAI,OAAO;IAI3B;;;;;;;OAOG;IACH,OAAO,CACN,KAAK,GAAE,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAY,EAClD,gBAAgB,GAAE,OAAc,EAChC,IAAI,CAAC,EAAE,YAAY,GACjB,MAAM;IAwGT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,YAAY,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO;IA2BtD;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAiB5C;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAgB7C;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAe3C;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAK5C;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAK5C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAK9C;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAK9C;;;;OAIG;IACH,sBAAsB,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAInD,0FAA0F;IAC1F,eAAe,IAAI,OAAO;IAO1B,yFAAyF;IACzF,cAAc,IAAI,OAAO;IAOzB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,GAAE,QAAmB,EAAE,IAAI,CAAC,EAAE,YAAY,GAAG,MAAM;IAuB/D;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAE,MAAU,GAAG,OAAO;IAsC1D;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,YAAY,GAAE,MAAU,GAAG,OAAO;IAOxD;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO;IAiC5C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIjD;;;OAGG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM;IAqB3B;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAgC3C;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM;IA4BjD;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,GAAG,MAAM;IA0BzC,6EAA6E;IAC7E,YAAY,IAAI,MAAM;IAwBtB;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAiB9B;;;;;;OAMG;IACH,OAAO,IAAI,MAAM;IAUjB;;;;OAIG;IACH,aAAa,CAAC,YAAY,GAAE,MAAU,GAAG,MAAM;IAY/C;;;;;;;;;OASG;IACH,WAAW,CAAC,YAAY,GAAE,MAAU,GAAG,MAAM;IAK7C,8CAA8C;IAC9C,YAAY,IAAI,MAAM;IAMtB;;;OAGG;IACH,aAAa,IAAI,UAAU;IAa3B,wDAAwD;IACxD,WAAW,IAAI,MAAM;IAIrB,4DAA4D;IAC5D,QAAQ,IAAI,aAAa;IAIzB,2DAA2D;IAC3D,OAAO;IAIP;;;OAGG;IACH,cAAc,IAAI,GAAG,MAAM,IAAI,MAAM,EAAE;IASvC;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,IAAI,OAAO;IAKpB;;;;OAIG;IACH,eAAe,CAAC,UAAU,GAAE,MAAU,GAAG,OAAO;IAMhD,2CAA2C;IAC3C,YAAY,IAAI,MAAM;IAUtB,oDAAoD;IACpD,KAAK,IAAI,OAAO;IAMhB,2DAA2D;IAC3D,OAAO,IAAI,OAAO;IAMlB;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAiFtD;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,SAAI,GAAG,OAAO;IA6D3C;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,MAAM;IAO7C;;;;OAIG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAQ3B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,IAAI,OAAO;IAQ1B;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO;IAM3C;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO;IAM7C;;;OAGG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,OAAO;IAM7C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAgB9C;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,IAAI;IAIjD;;;;;;OAMG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM;IAIpD;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO;CAGvD"}

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/date/Chronos.js

@@ -273,6 +273,10 @@ export class Chronos {
     get timestamp() {
         return this.#date.getTime();
     }
+    /** * Gets the last date (number) of the current month `(28, 29, 30 or 31)`. */
+    get lastDateOfMonth() {
+        return this.lastDayOfMonth().#date.getDate();
+    }
     /** @instance Returns a debug-friendly string for `console.log` or `util.inspect`. */
     inspect() {
         return `[Chronos ${this.toLocalISOString()}]`;
@@ -691,6 +695,14 @@ export class Chronos {
         const jul = new Date(year, 6, 1).getTimezoneOffset();
         return this.#date.getTimezoneOffset() < Math.max(jan, jul);
     }
+    /** @instance Checks if current day is the first day of the current month. */
+    isFirstDayOfMonth() {
+        return this.isSame(this.firstDayOfMonth(), 'day');
+    }
+    /** @instance Checks if current day is the last day of the current month. */
+    isLastDayOfMonth() {
+        return this.isSame(this.lastDayOfMonth(), 'day');
+    }
     /**
      * @instance Returns full time difference from now (or a specified time) down to a given level.
      *
@@ -935,6 +947,20 @@ export class Chronos {
     getRelativeMilliSecond(time) {
         return this.#date.getTime() - this.#toNewDate(time).getTime();
     }
+    /** @instance Returns a new Chronos instance set to the first day of the current month. */
+    firstDayOfMonth() {
+        const year = this.#date.getFullYear();
+        const month = this.#date.getMonth();
+        const lastDate = new Date(year, month, 1);
+        return new Chronos(lastDate).#withOrigin('firstDayOfMonth');
+    }
+    /** @instance Returns a new Chronos instance set to the last day of the current month. */
+    lastDayOfMonth() {
+        const year = this.#date.getFullYear();
+        const month = this.#date.getMonth() + 1;
+        const lastDate = new Date(year, month, 0);
+        return new Chronos(lastDate).#withOrigin('lastDayOfMonth');
+    }
     /**
      * @instance Compares the stored date with now, returning the difference in the specified unit.
      *
@@ -1476,7 +1502,7 @@ export class Chronos {
                 const daysOffset = (roundedWeek - 1) * 7;
                 startOfYear.setDate(startOfYear.getDate() + daysOffset);
                 startOfYear.setHours(0, 0, 0, 0);
-                return new Chronos(startOfYear);
+                return new Chronos(startOfYear).#withOrigin('round');
             }
             case 'month': {
                 const currentMonth = date.getMonth();

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.3.2",
   "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",