nhb-toolbox 3.4.1 → 3.4.5

package/dist/colors/Color.d.ts

@@ -1,30 +1,40 @@
 import type { AlphaColors, ColorType, Hex6, Hex8, HSL, HSLA, OpacityValue, RGB, RGBA, SolidColors } from './types';
 /**
- * * Class representing a color and its conversions between Hex, RGB, and HSL formats.
- * * It has 1 instance method to apply opacity to `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` color.
+ * * 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.
  * * It has 6 static methods that can be used to check if a color is in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
  *
  * @property {Hex} hex - The color in `Hex` format.
+ * @property {Hex8} hex8 - The color in `Hex8` format.
  * @property {RGB} rgb - The color in `RGB` format.
+ * @property {RGBA} rgba - The color in `RGBA` format.
  * @property {HSL} hsl - The color in `HSL` format.
+ * @property {HSLA} hsla - The color in `HSLA` format.
  *
  * @example
- * const color = new Color("#ff5733"); // Accepts a color in `Hex`, `RGB` or `HSL` format.
+ * const color = new Color("#ff5733"); // Accepts a color in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
+ * console.log(color.hex); // Get Hex equivalent
+ * console.log(color.hex8); // Get Hex8 equivalent
  * console.log(color.rgb); // Get RGB equivalent
+ * console.log(color.rgba); // Get RGBA equivalent
  * console.log(color.hsl); // Get HSL equivalent
+ * console.log(color.hsla); // Get HSLA equivalent
  *
  * @example
  * const randomColor = new Color(); // Generate a random color
- * console.log(randomColor.hex, randomColor.rgb, randomColor.hsl);
+ * console.log(randomColor.hex, randomColor.rgb, randomColor.hsl, randomColor.hex8, randomColor.rgba, randomColor.hsla); // Get RGBA and HSLA equivalent
  */
 export declare class Color {
-    hex: Hex6 | Hex8;
-    rgb: RGB | RGBA;
-    hsl: HSL | HSLA;
+    hex: Hex6;
+    hex8: Hex8;
+    rgb: RGB;
+    rgba: RGBA;
+    hsl: HSL;
+    hsla: HSLA;
     /** - Iterates over the color representations (Hex, RGB, HSL). */
     [Symbol.iterator](): Generator<Hex6 | RGB | HSL | Hex8 | RGBA | HSLA, void, unknown>;
     /**
-     * * Creates a new Color instance, optionally converting an input color.
+     * * Creates a new `Color` instance, optionally converts an input color to other 5 different color formats.
      *
      * @param toConvert - The color to convert. If not provided, a random color is generated.
      */
@@ -49,57 +59,50 @@ export declare class Color {
      */
     applyOpacity(opacity: OpacityValue): SolidColors & AlphaColors;
     /**
-     * @static
-     * Checks if a color is in `Hex6` format.
+     * @static Checks if a color is in `Hex6` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's a `Hex6` color, `false` if not.
      */
     static isHex6(color: string): color is Hex6;
     /**
-     * @static
-     * Checks if a color is in `Hex8` format.
+     * @static Checks if a color is in `Hex8` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
      */
     static isHex8(color: string): color is Hex8;
     /**
-     * @static
-     * Checks if a color is in `RGB` format.
+     * @static Checks if a color is in `RGB` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `RGB` color, `false` if not.
      */
     static isRGB(color: string): color is RGB;
     /**
-     * @static
-     * Checks if a color is in `RGBA` format.
+     * @static Checks if a color is in `RGBA` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `RGBA` color, `false` if not.
      */
     static isRGBA(color: string): color is RGBA;
     /**
-     * @static
-     * Checks if a color is in `HSL` format.
+     * @static Checks if a color is in `HSL` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `HSL` color, `false` if not.
      */
     static isHSL(color: string): color is HSL;
     /**
-     * @static
-     * Checks if a color is in `HSLA` format.
+     * @static Checks if a color is in `HSLA` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `HSLA` color, `false` if not.
      */
     static isHSLA(color: string): color is HSLA;
     /**
-     * - Converts the given color to all other formats while preserving the original.
+     * @private Converts the given color to all other formats while preserving the original.
      *
-     * @private
      * @param color - The color to convert.
      * @returns An object containing Hex, RGB, and HSL representations.
      */

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;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,KAAK;IACV,GAAG,EAAE,IAAI,GAAG,IAAI,CAAC;IACjB,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAChB,GAAG,EAAE,GAAG,GAAG,IAAI,CAAC;IAEvB,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IAMlB;;;;OAIG;gBACS,SAAS,CAAC,EAAE,SAAS;IAuBjC;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,WAAW;IAgC9D;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAIlD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI;IAMlD;;;;;;OAMG;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;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"}

package/dist/colors/Color.js

@@ -4,59 +4,87 @@ import { generateRandomHSLColor } from './random';
 const hsl = generateRandomHSLColor();
 const hexRGB = convertColorCode(hsl);
 /**
- * * Class representing a color and its conversions between Hex, RGB, and HSL formats.
- * * It has 1 instance method to apply opacity to `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` color.
+ * * 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.
  * * It has 6 static methods that can be used to check if a color is in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
  *
  * @property {Hex} hex - The color in `Hex` format.
+ * @property {Hex8} hex8 - The color in `Hex8` format.
  * @property {RGB} rgb - The color in `RGB` format.
+ * @property {RGBA} rgba - The color in `RGBA` format.
  * @property {HSL} hsl - The color in `HSL` format.
+ * @property {HSLA} hsla - The color in `HSLA` format.
  *
  * @example
- * const color = new Color("#ff5733"); // Accepts a color in `Hex`, `RGB` or `HSL` format.
+ * const color = new Color("#ff5733"); // Accepts a color in `Hex`, `Hex8` `RGB`, `RGBA`, `HSL` or `HSLA` format.
+ * console.log(color.hex); // Get Hex equivalent
+ * console.log(color.hex8); // Get Hex8 equivalent
  * console.log(color.rgb); // Get RGB equivalent
+ * console.log(color.rgba); // Get RGBA equivalent
  * console.log(color.hsl); // Get HSL equivalent
+ * console.log(color.hsla); // Get HSLA equivalent
  *
  * @example
  * const randomColor = new Color(); // Generate a random color
- * console.log(randomColor.hex, randomColor.rgb, randomColor.hsl);
+ * console.log(randomColor.hex, randomColor.rgb, randomColor.hsl, randomColor.hex8, randomColor.rgba, randomColor.hsla); // Get RGBA and HSLA equivalent
  */
 export class Color {
     hex;
+    hex8;
     rgb;
+    rgba;
     hsl;
+    hsla;
     /** - Iterates over the color representations (Hex, RGB, HSL). */
     *[Symbol.iterator]() {
         yield this.hex;
+        yield this.hex8;
         yield this.rgb;
+        yield this.rgba;
         yield this.hsl;
+        yield this.hsla;
     }
     /**
-     * * Creates a new Color instance, optionally converting an input color.
+     * * Creates a new `Color` instance, optionally converts an input color to other 5 different color formats.
      *
      * @param toConvert - The color to convert. If not provided, a random color is generated.
      */
     constructor(toConvert) {
         if (toConvert) {
-            const converted = this._convertColorToOthers(toConvert);
-            if ('hex8' in converted) {
-                // Handle alpha colors (Hex8, RGBA, HSLA)
-                this.hex = converted.hex8;
-                this.rgb = converted.rgba;
-                this.hsl = converted.hsla;
+            const colors = this._convertColorToOthers(toConvert);
+            if ('hex8' in colors) {
+                // 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.rgb = `rgb(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`;
+                this.rgba = colors.rgba;
+                this.hsl = `hsl(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`;
+                this.hsla = colors.hsla;
             }
             else {
-                // Handle solid colors (Hex, RGB, HSL)
-                this.hex = converted.hex;
-                this.rgb = converted.rgb;
-                this.hsl = converted.hsl;
+                // 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.rgb = colors.rgb;
+                this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
+                this.hsl = colors.hsl;
+                this.hsla = `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, 1)`;
             }
         }
         else {
-            // Generate random color
+            const rgbValues = _extractSolidColorValues(hexRGB.rgb);
+            const hslValues = _extractSolidColorValues(hsl);
+            // Generate random colors
             this.hex = hexRGB.hex;
+            this.hex8 = `${hexRGB.hex}${_convertOpacityToHex(100)}`;
             this.rgb = hexRGB.rgb;
+            this.rgba = `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, 1)`;
             this.hsl = hsl;
+            this.hsla = `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, 1)`;
         }
     }
     /**
@@ -81,32 +109,31 @@ export class Color {
         const validOpacity = Math.min(100, Math.max(0, opacity));
         const alphaHex = _convertOpacityToHex(opacity);
         const alphaDecimal = validOpacity / 100;
-        if (Color.isHex8(this.hex)) {
-            const rgbaValues = _extractAlphaColorValues(this.rgb);
-            const hslaValues = _extractAlphaColorValues(this.hsl);
+        if (Color.isHex8(this.hex8)) {
+            const rgbaValues = _extractAlphaColorValues(this.rgba);
+            const hslaValues = _extractAlphaColorValues(this.hsla);
             return {
-                hex: this.hex.slice(0, 7),
-                hex8: `${this.hex.slice(0, 7)}${alphaHex}`,
-                rgb: `rgba(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`,
+                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: `hsla(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`,
+                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,
-            hex8: `${this.hex}${alphaHex}`,
-            rgb: this.rgb,
+            hex: this.hex.slice(0, 7),
+            hex8: `${this.hex.slice(0, 7)}${alphaHex}`,
+            rgb: `rgb(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]})`,
             rgba: `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, ${alphaDecimal})`,
-            hsl: this.hsl,
+            hsl: `hsl(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%)`,
             hsla: `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, ${alphaDecimal})`,
         };
     }
     /**
-     * @static
-     * Checks if a color is in `Hex6` format.
+     * @static Checks if a color is in `Hex6` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's a `Hex6` color, `false` if not.
@@ -115,8 +142,7 @@ export class Color {
         return /^#[0-9A-Fa-f]{6}$/.test(color);
     }
     /**
-     * @static
-     * Checks if a color is in `Hex8` format.
+     * @static Checks if a color is in `Hex8` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
@@ -125,8 +151,7 @@ export class Color {
         return /^#[0-9A-Fa-f]{8}$/.test(color);
     }
     /**
-     * @static
-     * Checks if a color is in `RGB` format.
+     * @static Checks if a color is in `RGB` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `RGB` color, `false` if not.
@@ -135,8 +160,7 @@ export class Color {
         return /^rgb\(\d{1,3},\s*\d{1,3},\s*\d{1,3}\)$/.test(color);
     }
     /**
-     * @static
-     * Checks if a color is in `RGBA` format.
+     * @static Checks if a color is in `RGBA` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `RGBA` color, `false` if not.
@@ -145,8 +169,7 @@ export class Color {
         return /^rgba\(\d{1,3},\s*\d{1,3},\s*\d{1,3},\s*(0|1|0?\.\d+)\)$/.test(color);
     }
     /**
-     * @static
-     * Checks if a color is in `HSL` format.
+     * @static Checks if a color is in `HSL` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `HSL` color, `false` if not.
@@ -155,8 +178,7 @@ export class Color {
         return /^hsl\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%\)$/.test(color);
     }
     /**
-     * @static
-     * Checks if a color is in `HSLA` format.
+     * @static Checks if a color is in `HSLA` format.
      *
      * @param color Color to check.
      * @returns Boolean: `true` if it's an `HSLA` color, `false` if not.
@@ -165,9 +187,8 @@ export class Color {
         return /^hsla\(\d{1,3},\s*\d{1,3}%,\s*\d{1,3}%,\s*(0|1|0?\.\d+)\)$/.test(color);
     }
     /**
-     * - Converts the given color to all other formats while preserving the original.
+     * @private Converts the given color to all other formats while preserving the original.
      *
-     * @private
      * @param color - The color to convert.
      * @returns An object containing Hex, RGB, and HSL representations.
      */

package/dist/colors/convert.js

@@ -166,7 +166,7 @@ export const convertRgbaToHex8 = (r, g, b, a = 1) => {
     }
     const hex = convertRgbToHex(r, g, b);
     const alphaHex = _convertOpacityToHex(Math.round(newAlpha * 100));
-    return `#${hex}${alphaHex}`;
+    return `${hex}${alphaHex}`;
 };
 /**
  * * Converts HSLA to RGBA color format, including alpha channel.
@@ -239,7 +239,7 @@ export const convertHslaToHex8 = (h, s, l, a = 1) => {
     }
     const hex = convertHslToHex(h, s, l);
     const alphaHex = _convertOpacityToHex(Math.round(newAlpha * 100));
-    return `#${hex}${alphaHex}`;
+    return `${hex}${alphaHex}`;
 };
 /**
  * * Converts Hex8 to HSLA color format.

package/dist/colors/types.d.ts

@@ -4,7 +4,7 @@ export type ColorInput = string | number;
 /** - An array of strings/numbers or nested arrays of strings/numbers for generating colors. */
 export interface ColorInputArray extends Array<ColorInput | ColorInputArray> {
 }
-/** - Opacity options */
+/** - Opacity value in percentage `(0% - 100%)` without `%` symbol. */
 export type OpacityValue = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 | 41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 | 61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 | 81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100;
 /**
  * * Represents a hexadecimal color code.
@@ -57,14 +57,20 @@ export type ColorTypeAlpha = Hex8 | RGBA | HSLA;
 export type ColorType = Hex | Hex6 | RGB | HSL | Hex8 | RGBA | HSLA;
 /** - Colors Object that includes `Hex8`, `RGBA` and `HSLA` formats of the same color. */
 export interface SolidColors {
+    /** Represents a normal Hex color */
     hex: Hex6;
+    /** Represents a normal RGB color */
     rgb: RGB;
+    /** Represents a normal HSL color */
     hsl: HSL;
 }
 /** - Colors Object that includes `Hex`, `RGB` and `HSL` formats of the same color. */
 export interface AlphaColors {
+    /** Represents a Hex color with alpha channel */
     hex8: Hex8;
+    /** Represents a RGBA color with alpha channel */
     rgba: RGBA;
+    /** Represents a HSLA color with alpha channel */
     hsla: HSLA;
 }
 /** * Represents a tuple of three numerical values corresponding to RGB or HSL color components. */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,+CAA+C;AAC/C,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,+FAA+F;AAC/F,MAAM,WAAW,eAAgB,SAAQ,KAAK,CAAC,UAAU,GAAG,eAAe,CAAC;CAAG;AAE/E,wBAAwB;AACxB,MAAM,MAAM,YAAY,GACrB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,EAAE,GACF,GAAG,CAAC;AAEP;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjD;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GACZ,OAAO,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,GACtC,OAAO,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GACZ,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,IAAI,GACxC,OAAO,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,CAAC;AAE1C;;;GAGG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAEjD;;;GAGG;AACH,MAAM,MAAM,IAAI,GACb,QAAQ,MAAM,KAAK,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,GAClD,QAAQ,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG,CAAC;AAEnD;;;GAGG;AACH,MAAM,MAAM,IAAI,GACb,QAAQ,MAAM,KAAK,MAAM,MAAM,MAAM,MAAM,MAAM,GAAG,GACpD,QAAQ,MAAM,IAAI,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC;AAErD,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;AAE9C,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD,sDAAsD;AACtD,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpE,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC3B,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT;AAED,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACX;AAED,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEpD,mGAAmG;AACnG,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS,CACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,IAAI,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;IACpD,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,cAAc,GAAG,KAAK,GAAG,GAAG,CAAC;IAClD,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,cAAc,GAAG,KAAK,GAAG,GAAG,CAAC;IAClD,sFAAsF;IACtF,IAAI,EAAE,CAAC,SAAS,IAAI,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;IACrD,yEAAyE;IACzE,IAAI,EAAE,CAAC,SAAS,IAAI,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;IACrD,yEAAyE;IACzE,IAAI,EAAE,CAAC,SAAS,IAAI,GAAG,cAAc,GAAG,KAAK,GAAG,IAAI,CAAC;CACrD;AAED,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"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"}

package/dist/date/Chronos.d.ts

@@ -1,10 +1,20 @@
 export declare class Chronos {
-    private readonly _date;
+    private readonly date;
     /**
      * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, or `Date`).
+     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
      */
     constructor(value?: number | string | Date | Chronos);
+    /** * Gets the native `Date` instance (read-only). */
+    toDate(): Date;
+    /** * Returns a string representation of a date. The format of the string depends on the locale. */
+    toString(): string;
+    /** * Returns a date as a string value in ISO format. */
+    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). */
+    static now(): number;
     /**
      * * Formats the date into a custom string format.
      * @param format - The desired format (Default format is `DD-MM-YYYY` = `30-06-1995`).
@@ -33,7 +43,12 @@ export declare class Chronos {
      *  - Other positive or negative numbers for other relative days (e.g., `-2` for two days ago, `2` for two days ahead).
      */
     getRelativeDay(): number;
-    /** * Gets the native `Date` instance (read-only). */
-    toDate(): Date;
+    /**
+     * * Checks if the year is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    isLeapYear(): boolean;
 }
 //# sourceMappingURL=Chronos.d.ts.map

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,KAAK,CAAO;IAE7B;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO;IAcpD;;;;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,qDAAqD;IACrD,MAAM,IAAI,IAAI;CAGd"}
+{"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"}

package/dist/date/Chronos.js

@@ -1,9 +1,9 @@
 import { DAYS, MONTHS, sortedFormats } from './constants';
 export class Chronos {
-    _date;
+    date;
     /**
      * * Creates a new immutable Chronos instance.
-     * @param value - A date value (`timestamp`, `string`, or `Date`).
+     * @param value - A date value (`timestamp`, `string`, `Date`, `Chronos`).
      */
     constructor(value) {
         const date = value instanceof Chronos ?
@@ -13,7 +13,27 @@ 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);
+    }
+    /** * Returns a string representation of a date. The format of the string depends on the locale. */
+    toString() {
+        return this.date.toString();
+    }
+    /** * Returns a date as a string value in ISO format. */
+    toISOString() {
+        return this.date.toISOString();
+    }
+    /** * Returns the time value in milliseconds since midnight, January 1, 1970 UTC. */
+    getTimeStamp() {
+        return this.date.getTime();
+    }
+    /** * Returns the number of milliseconds elapsed since midnight, January 1, 1970 Universal Coordinated Time (UTC). */
+    static now() {
+        return Date.now();
     }
     /**
      * * Formats the date into a custom string format.
@@ -21,14 +41,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),
@@ -91,7 +111,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);
     }
@@ -117,14 +137,20 @@ 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));
         return diffDays;
     }
-    /** * Gets the native `Date` instance (read-only). */
-    toDate() {
-        return new Date(this._date);
+    /**
+     * * Checks if the year is a leap year.
+     * - A year is a leap year if it is divisible by 4, but not divisible by 100, unless it is also divisible by 400.
+     * - For example, 2000 and 2400 are leap years, but 1900 and 2100 are not.
+     * @returns `true` if the year is a leap year, `false` otherwise.
+     */
+    isLeapYear() {
+        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.1",
+  "version": "3.4.5",
   "description": "A versatile collection of smart, efficient, and reusable utility functions for everyday development needs.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -57,7 +57,7 @@
     "build": "node scripts/build.mjs",
     "test": "jest --coverage --verbose",
     "format": "prettier --write .",
-    "lint": "node scripts/.mjs",
+    "lint": "node scripts/lint.mjs",
     "fix": "node scripts/fix.mjs",
     "commit": "node scripts/commit.mjs"
   }