nhb-toolbox 3.4.5 → 3.4.7

package/dist/colors/Color.d.ts

@@ -55,7 +55,7 @@ export declare class Color {
      * @example
      * const alphaColor = new Color("#ff000080"); // Color with 50% opacity
      * const alpha75 = alphaColor.applyOpacity(75); // Change to 75% opacity
-     * console.log(alpha75.hex8); // #ff0000bf
+     * console.log(alpha75.hex8); // #FF0000BF
      */
     applyOpacity(opacity: OpacityValue): SolidColors & AlphaColors;
     /**

package/dist/colors/Color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../src/colors/Color.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,YAAY,EACZ,GAAG,EACH,IAAI,EACJ,WAAW,EACX,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,KAAK;IACV,GAAG,EAAE,IAAI,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IAElB,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IASlB;;;;OAIG;gBACS,SAAS,CAAC,EAAE,SAAS;IAyCjC;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW;IAgC9D;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;OAKG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;OAKG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAuB7B"}
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../src/colors/Color.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,WAAW,EACX,SAAS,EACT,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,YAAY,EACZ,GAAG,EACH,IAAI,EACJ,WAAW,EACX,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,KAAK;IACV,GAAG,EAAE,IAAI,CAAC;IACV,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IACX,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,IAAI,CAAC;IAElB,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IASlB;;;;OAIG;gBACS,SAAS,CAAC,EAAE,SAAS;IA2CjC;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW;IAkB9D;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;OAKG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;OAKG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;OAKG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;CAuB7B"}

package/dist/colors/Color.js

@@ -2,7 +2,7 @@ import { convertColorCode } from './convert';
 import { _convertOpacityToHex, _extractAlphaColorValues, _extractSolidColorValues, } from './helpers';
 import { generateRandomHSLColor } from './random';
 const hsl = generateRandomHSLColor();
-const hexRGB = convertColorCode(hsl);
+const { hex, rgb } = convertColorCode(hsl);
 /**
  * * Class representing a color and its conversions among `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` and `HSLA` formats.
  * * It has 1 instance method `applyOpacity()` to apply opacity to `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` color.
@@ -56,8 +56,8 @@ export class Color {
                 // Extract alpha color values (Hex8, RGBA, HSLA)
                 const rgbaValues = _extractAlphaColorValues(colors.rgba);
                 const hslaValues = _extractAlphaColorValues(colors.hsla);
-                this.hex = colors.hex8.slice(0, 7);
-                this.hex8 = colors.hex8;
+                this.hex = colors.hex8.toUpperCase().slice(0, 7);
+                this.hex8 = colors.hex8.toUpperCase();
                 this.rgb = `rgb(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`;
                 this.rgba = colors.rgba;
                 this.hsl = `hsl(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`;
@@ -67,8 +67,9 @@ export class Color {
                 // Extract solid color values (Hex, RGB, HSL)
                 const rgbValues = _extractSolidColorValues(colors.rgb);
                 const hslValues = _extractSolidColorValues(colors.hsl);
-                this.hex = colors.hex;
-                this.hex8 = `${colors.hex}${_convertOpacityToHex(100)}`;
+                this.hex = colors.hex.toUpperCase();
+                this.hex8 =
+                    `${colors.hex.toUpperCase()}${_convertOpacityToHex(100)}`;
                 this.rgb = colors.rgb;
                 this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
                 this.hsl = colors.hsl;
@@ -76,12 +77,13 @@ export class Color {
             }
         }
         else {
-            const rgbValues = _extractSolidColorValues(hexRGB.rgb);
+            const rgbValues = _extractSolidColorValues(rgb);
             const hslValues = _extractSolidColorValues(hsl);
             // Generate random colors
-            this.hex = hexRGB.hex;
-            this.hex8 = `${hexRGB.hex}${_convertOpacityToHex(100)}`;
-            this.rgb = hexRGB.rgb;
+            this.hex = hex.toUpperCase();
+            this.hex8 =
+                `${hex.toUpperCase()}${_convertOpacityToHex(100)}`;
+            this.rgb = rgb;
             this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
             this.hsl = hsl;
             this.hsla = `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, 1)`;
@@ -103,29 +105,17 @@ export class Color {
      * @example
      * const alphaColor = new Color("#ff000080"); // Color with 50% opacity
      * const alpha75 = alphaColor.applyOpacity(75); // Change to 75% opacity
-     * console.log(alpha75.hex8); // #ff0000bf
+     * console.log(alpha75.hex8); // #FF0000BF
      */
     applyOpacity(opacity) {
         const validOpacity = Math.min(100, Math.max(0, opacity));
         const alphaHex = _convertOpacityToHex(opacity);
         const alphaDecimal = validOpacity / 100;
-        if (Color.isHex8(this.hex8)) {
-            const rgbaValues = _extractAlphaColorValues(this.rgba);
-            const hslaValues = _extractAlphaColorValues(this.hsla);
-            return {
-                hex: this.hex8.slice(0, 7),
-                hex8: `${this.hex8.slice(0, 7)}${alphaHex}`,
-                rgb: `rgb(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`,
-                rgba: `rgba(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]}, ${alphaDecimal})`,
-                hsl: `hsl(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`,
-                hsla: `hsla(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%, ${alphaDecimal})`,
-            };
-        }
         const rgbValues = _extractSolidColorValues(this.rgb);
         const hslValues = _extractSolidColorValues(this.hsl);
         return {
-            hex: this.hex.slice(0, 7),
-            hex8: `${this.hex.slice(0, 7)}${alphaHex}`,
+            hex: this.hex.slice(0, 7).toUpperCase(),
+            hex8: `${this.hex.slice(0, 7)}${alphaHex}`.toUpperCase(),
             rgb: `rgb(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]})`,
             rgba: `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, ${alphaDecimal})`,
             hsl: `hsl(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%)`,

package/dist/date/Chronos.d.ts

@@ -1,5 +1,5 @@
 export declare class Chronos {
-    private readonly date;
+    #private;
     /**
      * * Creates a new immutable Chronos instance.
      * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
@@ -13,7 +13,29 @@ export declare class Chronos {
     toISOString(): string;
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     getTimeStamp(): number;
-    /** * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC). */
+    /** * Returns the date value as a `Date` object. */
+    get date(): Date;
+    /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    get unix(): number;
+    /**
+     * @instance Returns the current date and time in a specified format.
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY HH:mm:ss:mss` = `30-06-1995 15:55:58:775`).
+     * @returns Formatted date string in desired format.
+     */
+    today(format?: string): string;
+    /**
+     * @static Returns the current date and time in a specified format.
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY HH:mm:ss:mss` = `30-06-1995 15:55:58:775`).
+     * @returns Formatted date string in desired format.
+     */
+    static today(format?: string): string;
+    /**
+     * * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC).
+     * * It basically calls `Date.now()`.
+     * @returns The number of milliseconds elapsed since the Unix epoch.
+     */
     static now(): number;
     /**
      * * Formats the date into a custom string format.

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

@@ -1 +1 @@
-{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAGA,qBAAa,OAAO;IACnB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAO;IAE5B;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB,wDAAwD;IACxD,WAAW,IAAI,MAAM;IAIrB,oFAAoF;IACpF,YAAY,IAAI,MAAM;IAItB,qHAAqH;IACrH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IA2E7C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB;;;;;OAKG;IACH,UAAU,IAAI,OAAO;CAKrB"}
+{"version":3,"file":"Chronos.d.ts","sourceRoot":"","sources":["../../src/date/Chronos.ts"],"names":[],"mappings":"AAGA,qBAAa,OAAO;;IAGnB;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD,qDAAqD;IACrD,MAAM,IAAI,IAAI;IAId,mGAAmG;IACnG,QAAQ,IAAI,MAAM;IAIlB,wDAAwD;IACxD,WAAW,IAAI,MAAM;IAIrB,oFAAoF;IACpF,YAAY,IAAI,MAAM;IAItB,mDAAmD;IACnD,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,oFAAoF;IACpF,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,SAA4B,GAAG,MAAM;IAKjD;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,SAA4B,GAAG,MAAM;IAKxD;;;;OAIG;IACH,MAAM,CAAC,GAAG,IAAI,MAAM;IAIpB;;;;OAIG;IACH,MAAM,CAAC,MAAM,GAAE,MAAqB,GAAG,MAAM;IA2E7C;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM9B;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;;;;OAQG;IACH,cAAc,IAAI,MAAM;IAexB;;;;;OAKG;IACH,UAAU,IAAI,OAAO;CAKrB"}

package/dist/date/Chronos.js

@@ -1,6 +1,6 @@
 import { DAYS, MONTHS, sortedFormats } from './constants';
 export class Chronos {
-    date;
+    #date;
     /**
      * * Creates a new immutable Chronos instance.
      * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
@@ -13,25 +13,57 @@ export class Chronos {
         if (isNaN(date.getTime())) {
             throw new Error('Invalid date provided!');
         }
-        this.date = date;
+        this.#date = date;
     }
     /** * Gets the native `Date` instance (read-only). */
     toDate() {
-        return new Date(this.date);
+        return new Date(this.#date);
     }
     /** * Returns a string representation of a date. The format of the string depends on the locale. */
     toString() {
-        return this.date.toString();
+        return this.#date.toString();
     }
     /** * Returns a date as a string value in ISO format. */
     toISOString() {
-        return this.date.toISOString();
+        return this.#date.toISOString();
     }
     /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
     getTimeStamp() {
-        return this.date.getTime();
+        return this.#date.getTime();
     }
-    /** * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC). */
+    /** * Returns the date value as a `Date` object. */
+    get date() {
+        return this.#date;
+    }
+    /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    get unix() {
+        return this.#date.getTime();
+    }
+    /**
+     * @instance Returns the current date and time in a specified format.
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY HH:mm:ss:mss` = `30-06-1995 15:55:58:775`).
+     * @returns Formatted date string in desired format.
+     */
+    today(format = 'DD-MM-YYYY HH:mm:ss:mss') {
+        const today = new Date();
+        return new Chronos(today).format(format);
+    }
+    /**
+     * @static Returns the current date and time in a specified format.
+     *
+     * @param format - The desired format (Default format is `DD-MM-YYYY HH:mm:ss:mss` = `30-06-1995 15:55:58:775`).
+     * @returns Formatted date string in desired format.
+     */
+    static today(format = 'DD-MM-YYYY HH:mm:ss:mss') {
+        const today = new Date();
+        return new Chronos(today).format(format);
+    }
+    /**
+     * * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC).
+     * * It basically calls `Date.now()`.
+     * @returns The number of milliseconds elapsed since the Unix epoch.
+     */
     static now() {
         return Date.now();
     }
@@ -41,14 +73,14 @@ export class Chronos {
      * @returns Formatted date string in desired format.
      */
     format(format = 'DD-MM-YYYY') {
-        const year = this.date.getFullYear();
-        const month = this.date.getMonth();
-        const day = this.date.getDay();
-        const date = this.date.getDate();
-        const hours = this.date.getHours();
-        const minutes = this.date.getMinutes();
-        const seconds = this.date.getSeconds();
-        const milliseconds = this.date.getMilliseconds();
+        const year = this.#date.getFullYear();
+        const month = this.#date.getMonth();
+        const day = this.#date.getDay();
+        const date = this.#date.getDate();
+        const hours = this.#date.getHours();
+        const minutes = this.#date.getMinutes();
+        const seconds = this.#date.getSeconds();
+        const milliseconds = this.#date.getMilliseconds();
         const dateComponents = {
             YYYY: String(year),
             YY: String(year).slice(-2),
@@ -111,7 +143,7 @@ export class Chronos {
      * @returns A new `Chronos` instance with the updated date.
      */
     addDays(days) {
-        const newDate = new Date(this.date);
+        const newDate = new Date(this.#date);
         newDate.setDate(newDate.getDate() + days);
         return new Chronos(newDate);
     }
@@ -137,7 +169,7 @@ export class Chronos {
         // Set the time of today to 00:00:00 for comparison purposes
         today.setHours(0, 0, 0, 0);
         // Normalize the input date to 00:00:00
-        const inputDate = new Date(this.date);
+        const inputDate = new Date(this.#date);
         inputDate.setHours(0, 0, 0, 0);
         const diffTime = inputDate.getTime() - today.getTime();
         const diffDays = Math.floor(diffTime / (1000 * 60 * 60 * 24));
@@ -150,7 +182,7 @@ export class Chronos {
      * @returns `true` if the year is a leap year, `false` otherwise.
      */
     isLeapYear() {
-        const year = this.date.getFullYear();
+        const year = this.#date.getFullYear();
         return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
     }
 }

package/package.json

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