nhb-toolbox 1.8.4 → 1.9.6

package/dist/array/transform.d.ts

@@ -8,4 +8,11 @@ import type { OptionInput, OptionsConfig } from './types';
  * @returns An array of options, where each option has `value` and `label` fields as default or as specified by user in the config options.
  */
 export declare const createOptionsArray: <T extends OptionInput, K1 extends string = "value", K2 extends string = "label">(data: T[], config: OptionsConfig<T, K1, K2>) => { [P in K1 | K2]: string; }[];
+/**
+ * * Removes duplicate values from an array, supporting deep comparison for objects and arrays.
+ *
+ * @param array - The array from which duplicates need to be removed.
+ * @returns A new array with duplicates removed.
+ */
+export declare function removeDuplicatesFromArray<T>(array: T[]): T[];
 //# sourceMappingURL=transform.d.ts.map

package/dist/array/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/array/transform.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,WAAW,EACrB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAe5B,CAAC"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../src/array/transform.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,GAC9B,CAAC,SAAS,WAAW,EACrB,EAAE,SAAS,MAAM,YACjB,EAAE,SAAS,MAAM,kBAEX,CAAC,EAAE,UACD,aAAa,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,KAC9B,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,GAAE,EAe5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK5D"}

package/dist/array/transform.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOptionsArray = void 0;
+exports.removeDuplicatesFromArray = removeDuplicatesFromArray;
+const utils_1 = require("../utils");
 /**
  * * Converts an array of objects into a formatted array of options.
  *
@@ -22,3 +24,12 @@ const createOptionsArray = (data, config) => {
     }
 };
 exports.createOptionsArray = createOptionsArray;
+/**
+ * * Removes duplicate values from an array, supporting deep comparison for objects and arrays.
+ *
+ * @param array - The array from which duplicates need to be removed.
+ * @returns A new array with duplicates removed.
+ */
+function removeDuplicatesFromArray(array) {
+    return array.filter((item, index, self) => index === self.findIndex((el) => (0, utils_1.isDeepEqual)(el, item)));
+}

package/dist/colors/Color.d.ts

@@ -1,4 +1,4 @@
-import type { ColorType, Hex, HSL, RGB } from './types';
+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  3 static methods that can be used to check if a color is in `Hex`, `RGB` or `HSL` format.
@@ -17,11 +17,11 @@ import type { ColorType, Hex, HSL, RGB } from './types';
  * console.log(randomColor.hex, randomColor.rgb, randomColor.hsl);
  */
 export declare class Color {
-    hex: Hex;
-    rgb: RGB;
-    hsl: HSL;
+    hex: Hex6 | Hex8;
+    rgb: RGB | RGBA;
+    hsl: HSL | HSLA;
     /** - Iterates over the color representations (Hex, RGB, HSL). */
-    [Symbol.iterator](): Generator<`#${string}` | `rgb(${number}, ${number}, ${number})` | `hsl(${number}, ${number}%, ${number}%)`, void, unknown>;
+    [Symbol.iterator](): Generator<Hex6 | `rgb(${number}, ${number}, ${number})` | `hsl(${number}, ${number}%, ${number}%)` | Hex8 | `rgba(${number}, ${number}, ${number}, ${number})` | `hsla(${number}, ${number}%, ${number}%, ${number})`, void, unknown>;
     /**
      * * Creates a new Color instance, optionally converting an input color.
      *
@@ -29,21 +29,45 @@ export declare class Color {
      */
     constructor(toConvert?: ColorType);
     /**
-     * - Converts the given color to all other formats while preserving the original.
+     * * Applies or modifies the opacity of a color.
+     * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity
+     * - For alpha colors (Hex8/RGBA/HSLA): Updates the existing alpha channel
      *
-     * @private
-     * @param color - The color to convert.
-     * @returns An object containing Hex, RGB, and HSL representations.
+     * @param opacity - A number between 0-100 representing the opacity percentage
+     * @returns An object containing all color formats with the applied opacity
+     *
+     * @example
+     * const color = new Color("#ff0000");
+     * const alpha50 = color.applyOpacity(50); // 50% opacity
+     * console.log(alpha50.rgba); // rgba(255, 0, 0, 0.5)
+     *
+     * @example
+     * const alphaColor = new Color("#ff000080"); // Color with 50% opacity
+     * const alpha75 = alphaColor.applyOpacity(75); // Change to 75% opacity
+     * console.log(alpha75.hex8); // #ff0000bf
      */
-    private _convertColorToOthers;
+    applyOpacity(opacity: OpacityValue): SolidColors & AlphaColors;
+    /**
+     * Creates a new Color instance from a hex string
+     * @param hex The hex color string
+     */
+    static fromHex(hex: string): Color;
+    /**
+     * @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: ColorType): color is Hex6;
     /**
      * @static
-     * Checks if a color is in `Hex` format.
+     * Checks if a color is in `Hex8` format.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
+     * @returns Boolean: `true` if it's a `Hex8` color, `false` if not.
      */
-    static isHex(color: string): color is Hex;
+    static isHex8(color: ColorType): color is Hex8;
     /**
      * @static
      * Checks if a color is in `RGB` format.
@@ -51,7 +75,15 @@ export declare class Color {
      * @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 isRGB(color: ColorType): color is RGB;
+    /**
+     * @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: ColorType): color is RGBA;
     /**
      * @static
      * Checks if a color is in `HSL` format.
@@ -59,6 +91,22 @@ export declare class Color {
      * @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 isHSL(color: ColorType): color is HSL;
+    /**
+     * @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: ColorType): color is HSLA;
+    /**
+     * - 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.
+     */
+    private _convertColorToOthers;
 }
 //# sourceMappingURL=Color.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../../src/colors/Color.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAU,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAKhE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,KAAK;IACV,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IAEhB,iEAAiE;IAChE,CAAC,MAAM,CAAC,QAAQ,CAAC;IAMlB;;;;OAIG;gBACS,SAAS,CAAC,EAAE,SAAS;IAYjC;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;IAIhD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG;CAGhD"}
+{"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;;;;;;;;;;;;;;;;GAgBG;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;;;OAGG;WACW,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK;IAUzC;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,IAAI;IAIrD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,IAAI;IAIrD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,GAAG;IAInD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,IAAI;IAIrD;;;;;;OAMG;WACW,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,GAAG;IAInD;;;;;;OAMG;WACW,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,IAAI;IAMrD;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;CAuB7B"}

package/dist/colors/Color.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Color = void 0;
 const convert_1 = require("./convert");
+const helpers_1 = require("./helpers");
 const random_1 = require("./random");
 const hsl = (0, random_1.generateRandomHSLColor)();
 const hexRGB = (0, convert_1.convertColorCode)(hsl);
@@ -39,57 +40,105 @@ class Color {
      */
     constructor(toConvert) {
         if (toConvert) {
-            this.hex = this._convertColorToOthers(toConvert).hex;
-            this.rgb = this._convertColorToOthers(toConvert).rgb;
-            this.hsl = this._convertColorToOthers(toConvert).hsl;
+            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;
+            }
+            else {
+                // Handle solid colors (Hex, RGB, HSL)
+                this.hex = converted.hex;
+                this.rgb = converted.rgb;
+                this.hsl = converted.hsl;
+            }
         }
         else {
+            // Generate random color
             this.hex = hexRGB.hex;
             this.rgb = hexRGB.rgb;
             this.hsl = hsl;
         }
     }
     /**
-     * - Converts the given color to all other formats while preserving the original.
+     * * Applies or modifies the opacity of a color.
+     * - For solid colors (Hex6/RGB/HSL): Adds an alpha channel with the specified opacity
+     * - For alpha colors (Hex8/RGBA/HSLA): Updates the existing alpha channel
      *
-     * @private
-     * @param color - The color to convert.
-     * @returns An object containing Hex, RGB, and HSL representations.
+     * @param opacity - A number between 0-100 representing the opacity percentage
+     * @returns An object containing all color formats with the applied opacity
+     *
+     * @example
+     * const color = new Color("#ff0000");
+     * const alpha50 = color.applyOpacity(50); // 50% opacity
+     * console.log(alpha50.rgba); // rgba(255, 0, 0, 0.5)
+     *
+     * @example
+     * const alphaColor = new Color("#ff000080"); // Color with 50% opacity
+     * const alpha75 = alphaColor.applyOpacity(75); // Change to 75% opacity
+     * console.log(alpha75.hex8); // #ff0000bf
      */
-    _convertColorToOthers(color) {
-        if (Color.isHex(color)) {
+    applyOpacity(opacity) {
+        const validOpacity = Math.min(100, Math.max(0, opacity));
+        const alphaHex = (0, helpers_1._convertOpacityToHex)(opacity);
+        const alphaDecimal = validOpacity / 100;
+        if (Color.isHex8(this.hex)) {
+            const rgbaValues = (0, helpers_1._extractAlphaColorValues)(this.rgb);
+            const hslaValues = (0, helpers_1._extractAlphaColorValues)(this.hsl);
             return {
-                hex: color,
-                rgb: (0, convert_1.convertColorCode)(color).rgb,
-                hsl: (0, convert_1.convertColorCode)(color).hsl,
+                hex: this.hex.slice(0, 7),
+                hex8: `${this.hex.slice(0, 7)}${alphaHex}`,
+                rgb: `rgba(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]})`,
+                rgba: `rgba(${rgbaValues[0]}, ${rgbaValues[1]}, ${rgbaValues[2]}, ${alphaDecimal})`,
+                hsl: `hsla(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%)`,
+                hsla: `hsla(${hslaValues[0]}, ${hslaValues[1]}%, ${hslaValues[2]}%, ${alphaDecimal})`,
             };
         }
-        else if (Color.isRGB(color)) {
-            return {
-                hex: (0, convert_1.convertColorCode)(color).hex,
-                rgb: color,
-                hsl: (0, convert_1.convertColorCode)(color).hsl,
-            };
+        const rgbValues = (0, helpers_1._extractSolidColorValues)(this.rgb);
+        const hslValues = (0, helpers_1._extractSolidColorValues)(this.hsl);
+        return {
+            hex: this.hex,
+            hex8: `${this.hex}${alphaHex}`,
+            rgb: this.rgb,
+            rgba: `rgba(${rgbValues[0]}, ${rgbValues[1]}, ${rgbValues[2]}, ${alphaDecimal})`,
+            hsl: this.hsl,
+            hsla: `hsla(${hslValues[0]}, ${hslValues[1]}%, ${hslValues[2]}%, ${alphaDecimal})`,
+        };
+    }
+    /**
+     * Creates a new Color instance from a hex string
+     * @param hex The hex color string
+     */
+    static fromHex(hex) {
+        if (this.isHex6(hex)) {
+            return new Color(hex);
         }
-        else if (Color.isHSL(color)) {
-            return {
-                hex: (0, convert_1.convertColorCode)(color).hex,
-                rgb: (0, convert_1.convertColorCode)(color).rgb,
-                hsl: color,
-            };
+        if (this.isHex8(hex)) {
+            return new Color(hex);
         }
-        throw new Error(`Unrecognized Color Format: ${color}`);
+        throw new Error(`Unrecognized Hex Format: ${hex}`);
     }
     /**
      * @static
-     * Checks if a color is in `Hex` format.
+     * Checks if a color is in `Hex6` format.
      *
      * @param color Color to check.
-     * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
+     * @returns Boolean: `true` if it's a `Hex6` color, `false` if not.
      */
-    static isHex(color) {
+    static isHex6(color) {
         return /^#[0-9A-Fa-f]{6}$/.test(color);
     }
+    /**
+     * @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) {
+        return /^#[0-9A-Fa-f]{8}$/.test(color);
+    }
     /**
      * @static
      * Checks if a color is in `RGB` format.
@@ -100,6 +149,16 @@ class Color {
     static isRGB(color) {
         return /^rgb\(\d{1,3}, \d{1,3}, \d{1,3}\)$/.test(color);
     }
+    /**
+     * @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) {
+        return /^rgba\(\d{1,3}, \d{1,3}, \d{1,3}, (0|1|0?\.\d+)\)$/.test(color);
+    }
     /**
      * @static
      * Checks if a color is in `HSL` format.
@@ -110,5 +169,49 @@ class Color {
     static isHSL(color) {
         return /^hsl\(\d{1,3}, \d{1,3}%, \d{1,3}%\)$/.test(color);
     }
+    /**
+     * @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) {
+        return /^hsla\(\d{1,3}, \d{1,3}%, \d{1,3}%, (0|1|0?\.\d+)\)$/.test(color);
+    }
+    /**
+     * - 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.
+     */
+    _convertColorToOthers(color) {
+        if (Color.isHex6(color)) {
+            const { rgb, hsl } = (0, convert_1.convertColorCode)(color);
+            return { hex: color, rgb: rgb, hsl: hsl };
+        }
+        else if (Color.isRGB(color)) {
+            const { hex, hsl } = (0, convert_1.convertColorCode)(color);
+            return { hex: hex, rgb: color, hsl: hsl };
+        }
+        else if (Color.isHSL(color)) {
+            const { hex, rgb } = (0, convert_1.convertColorCode)(color);
+            return { hex: hex, rgb: rgb, hsl: color };
+        }
+        else if (Color.isHex8(color)) {
+            const { rgba, hsla } = (0, convert_1.convertColorCode)(color);
+            return { hex8: color, rgba: rgba, hsla: hsla };
+        }
+        else if (Color.isHSLA(color)) {
+            const { hex8, rgba } = (0, convert_1.convertColorCode)(color);
+            return { hex8: hex8, rgba: rgba, hsla: color };
+        }
+        else if (Color.isRGBA(color)) {
+            const { hex8, hsla } = (0, convert_1.convertColorCode)(color);
+            return { hex8: hex8, rgba: color, hsla: hsla };
+        }
+        throw new Error(`Unrecognized Color Format: ${color}`);
+    }
 }
 exports.Color = Color;

package/dist/colors/convert.d.ts

@@ -1,4 +1,4 @@
-import type { Hex, HSL, RGB } from './types';
+import type { Hex6, Hex8, HSL, HSLA, RGB, RGBA } from './types';
 /**
  * * Converts HSL to RGB color format.
  *
@@ -25,38 +25,84 @@ export declare const convertRgbToHsl: (r: number, g: number, b: number) => HSL;
  * @param l - The lightness component of the HSL color, as a percentage (0 to 100).
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-export declare const convertHslToHex: (h: number, s: number, l: number) => Hex;
+export declare const convertHslToHex: (h: number, s: number, l: number) => Hex6;
 /**
  * * Converts Hex to HSL color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in HSL format (e.g., `hsl(0, 100%, 50%)`).
  */
-export declare const convertHexToHsl: (hex: Hex | string) => HSL;
+export declare const convertHexToHsl: (hex: Hex6 | string) => HSL;
 /**
  * * Converts RGB to Hex color format.
  *
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
  * @param b - The blue component of the RGB color, in the range 0 to 255.
- * @param a - The alpha opacity of the RGB color, in the range 0 to 255.
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-export declare const convertRgbToHex: (r: number, g: number, b: number, a?: number) => Hex;
+export declare const convertRgbToHex: (r: number, g: number, b: number) => Hex6;
 /**
  * * Converts Hex to RGB color format.
  *
  * @param hex - A string representing the color in Hex format (e.g., `#FF0000`).
  * @returns A string representing the color in RGB format (e.g., `rgb(255, 0, 0)`).
  */
-export declare const convertHexToRgb: (hex: Hex | string) => RGB;
+export declare const convertHexToRgb: (hex: Hex6 | string) => RGB;
+/**
+ * * Converts RGB to RGBA format, adding alpha (opacity).
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+export declare const convertRgbToRgba: (r: number, g: number, b: number, a?: number) => RGBA;
+/**
+ * * Converts RGBA to Hex format, including alpha channel as part of Hex8.
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in Hex8 format (e.g., `#FF000080`).
+ */
+export declare const convertRgbaToHex8: (r: number, g: number, b: number, a?: number) => Hex8;
+/**
+ * * Converts HSLA to RGBA color format, including alpha channel.
+ *
+ * @param h - The hue component of the HSL color, in degrees (0 to 360).
+ * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
+ * @param l - The lightness component of the HSL color, as a percentage (0 to 100).
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+export declare const convertHslaToRgba: (h: number, s: number, l: number, a?: number) => RGBA;
+/**
+ * * Converts RGBA to HSLA color format, including alpha channel.
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in HSLA format (e.g., `hsla(0, 100%, 50%, 0.5)`).
+ */
+export declare const convertRgbaToHsla: (r: number, g: number, b: number, a?: number) => HSLA;
+/**
+ * * Converts Hex8 to RGBA color format, including alpha channel.
+ *
+ * @param hex8 - A string representing the color in Hex8 format (e.g., `#FF000080`).
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+export declare const convertHex8ToRgba: (hex8: Hex8) => RGBA;
 /**
  * * Converts a `Hex` color code to `RGB` and `HSL` formats.
  *
  * @param color The `Hex` color code (e.g., `#3c6945`).
  * @returns An object containing the `RGB` and `HSL` formats of the given `Hex` color.
  */
-export declare function convertColorCode(color: Hex): {
+export declare function convertColorCode(color: Hex6): {
     rgb: RGB;
     hsl: HSL;
 };
@@ -67,7 +113,7 @@ export declare function convertColorCode(color: Hex): {
  * @returns An object containing the `Hex` and `HSL` formats of the given `RGB` color.
  */
 export declare function convertColorCode(color: RGB): {
-    hex: Hex;
+    hex: Hex6;
     hsl: HSL;
 };
 /**
@@ -77,7 +123,37 @@ export declare function convertColorCode(color: RGB): {
  * @returns An object containing the `Hex` and `RGB` formats of the given `HSL` color.
  */
 export declare function convertColorCode(color: HSL): {
-    hex: Hex;
+    hex: Hex6;
     rgb: RGB;
 };
+/**
+ * * Converts a `Hex8` color code to `RGB` and `HSL` formats.
+ *
+ * @param color The `Hex8` color code (e.g., `#3c6945`).
+ * @returns An object containing the `RGB` and `HSL` formats of the given `Hex8` color.
+ */
+export declare function convertColorCode(color: Hex8): {
+    rgba: RGBA;
+    hsla: HSLA;
+};
+/**
+ * * Converts an `RGBA` color to `Hex8` and `HSLA` formats.
+ *
+ * @param color The `RGBA` color string (e.g., `rgb(60, 105, 69)`).
+ * @returns An object containing the `Hex8` and `HSLA` formats of the given `RGBA` color.
+ */
+export declare function convertColorCode(color: RGBA): {
+    hex8: Hex8;
+    hsla: HSLA;
+};
+/**
+ * * Converts an `HSLA` color to `Hex8` and `RGBA` formats.
+ *
+ * @param color The `HSLA` color string (e.g., `hsl(132, 27.27%, 32.35%)`).
+ * @returns An object containing the `Hex8` and `RGBA` formats of the given `HSLA` color.
+ */
+export declare function convertColorCode(color: HSLA): {
+    hex8: Hex8;
+    rgba: RGBA;
+};
 //# sourceMappingURL=convert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/colors/convert.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA8B,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAEzE;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAwBjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAkCjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAIjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,GAAG,GAAG,MAAM,KAAG,GAenD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,MACxB,MAAM,KACN,MAAM,KACN,MAAM,MACL,MAAM,KACR,GAcF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,GAAG,GAAG,MAAM,KAAG,GAgBnD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/colors/convert.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAGX,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EAEJ,GAAG,EACH,IAAI,EACJ,MAAM,SAAS,CAAC;AAEjB;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAwBjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,GAkCjE,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,IAIjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,IAAI,GAAG,MAAM,KAAG,GAepD,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,MAAO,MAAM,KAAK,MAAM,KAAK,MAAM,KAAG,IAOjE,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAS,IAAI,GAAG,MAAM,KAAG,GAgBpD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,MACzB,MAAM,KACN,MAAM,KACN,MAAM,MACN,MAAM,KACP,IAEF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,MAC1B,MAAM,KACN,MAAM,KACN,MAAM,MACN,MAAM,KACP,IAUF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,MAC1B,MAAM,KACN,MAAM,KACN,MAAM,MACN,MAAM,KACP,IAIF,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,MAC1B,MAAM,KACN,MAAM,KACN,MAAM,MACN,MAAM,KACP,IAIF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,SAAU,IAAI,KAAG,IAQ9C,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG;IAC9C,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG;IAC7C,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,GAAG,CAAC;CACT,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACX,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG;IAC9C,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,IAAI,CAAC;CACX,CAAC"}

package/dist/colors/convert.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
+exports.convertHex8ToRgba = exports.convertRgbaToHsla = exports.convertHslaToRgba = exports.convertRgbaToHex8 = exports.convertRgbToRgba = exports.convertHexToRgb = exports.convertRgbToHex = exports.convertHexToHsl = exports.convertHslToHex = exports.convertRgbToHsl = exports.convertHslToRgb = void 0;
 exports.convertColorCode = convertColorCode;
 const helpers_1 = require("./helpers");
 /**
@@ -111,20 +111,13 @@ exports.convertHexToHsl = convertHexToHsl;
  * @param r - The red component of the RGB color, in the range 0 to 255.
  * @param g - The green component of the RGB color, in the range 0 to 255.
  * @param b - The blue component of the RGB color, in the range 0 to 255.
- * @param a - The alpha opacity of the RGB color, in the range 0 to 255.
  * @returns A string representing the color in Hex format (e.g., `#FF0000`).
  */
-const convertRgbToHex = (r, g, b, a) => {
-    let hex = [r, g, b]
+const convertRgbToHex = (r, g, b) => {
+    const hex = [r, g, b]
         .map((v) => v.toString(16).padStart(2, '0'))
         .join('')
         .toUpperCase();
-    if (a !== undefined) {
-        const alphaHex = Math.round(a * 255)
-            .toString(16)
-            .padStart(2, '0');
-        hex += alphaHex;
-    }
     return `#${hex}`;
 };
 exports.convertRgbToHex = convertRgbToHex;
@@ -149,6 +142,84 @@ const convertHexToRgb = (hex) => {
     return `rgb(${r}, ${g}, ${b})`;
 };
 exports.convertHexToRgb = convertHexToRgb;
+/**
+ * * Converts RGB to RGBA format, adding alpha (opacity).
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+const convertRgbToRgba = (r, g, b, a = 1) => {
+    return `rgba(${r}, ${g}, ${b}, ${a})`;
+};
+exports.convertRgbToRgba = convertRgbToRgba;
+/**
+ * * Converts RGBA to Hex format, including alpha channel as part of Hex8.
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in Hex8 format (e.g., `#FF000080`).
+ */
+const convertRgbaToHex8 = (r, g, b, a = 1) => {
+    const alphaHex = Math.round(a * 255)
+        .toString(16)
+        .padStart(2, '0');
+    const hex = [r, g, b]
+        .map((v) => v.toString(16).padStart(2, '0'))
+        .join('')
+        .toUpperCase();
+    return `#${hex}${alphaHex}`;
+};
+exports.convertRgbaToHex8 = convertRgbaToHex8;
+/**
+ * * Converts HSLA to RGBA color format, including alpha channel.
+ *
+ * @param h - The hue component of the HSL color, in degrees (0 to 360).
+ * @param s - The saturation component of the HSL color, as a percentage (0 to 100).
+ * @param l - The lightness component of the HSL color, as a percentage (0 to 100).
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+const convertHslaToRgba = (h, s, l, a = 1) => {
+    const rgb = (0, exports.convertHslToRgb)(h, s, l);
+    const rgbNumbers = (0, helpers_1._extractSolidColorValues)(rgb);
+    return (0, exports.convertRgbToRgba)(rgbNumbers[0], rgbNumbers[1], rgbNumbers[2], a);
+};
+exports.convertHslaToRgba = convertHslaToRgba;
+/**
+ * * Converts RGBA to HSLA color format, including alpha channel.
+ *
+ * @param r - The red component of the RGB color, in the range 0 to 255.
+ * @param g - The green component of the RGB color, in the range 0 to 255.
+ * @param b - The blue component of the RGB color, in the range 0 to 255.
+ * @param a - The alpha (opacity) value, in the range 0 to 1.
+ * @returns A string representing the color in HSLA format (e.g., `hsla(0, 100%, 50%, 0.5)`).
+ */
+const convertRgbaToHsla = (r, g, b, a = 1) => {
+    const hsl = (0, exports.convertRgbToHsl)(r, g, b);
+    const hslNumbers = (0, helpers_1._extractSolidColorValues)(hsl);
+    return `hsla(${hslNumbers[0]}, ${hslNumbers[1]}%, ${hslNumbers[2]}%, ${a})`;
+};
+exports.convertRgbaToHsla = convertRgbaToHsla;
+/**
+ * * Converts Hex8 to RGBA color format, including alpha channel.
+ *
+ * @param hex8 - A string representing the color in Hex8 format (e.g., `#FF000080`).
+ * @returns A string representing the color in RGBA format (e.g., `rgba(255, 0, 0, 0.5)`).
+ */
+const convertHex8ToRgba = (hex8) => {
+    const hex = hex8.replace('#', '');
+    const r = parseInt(hex.slice(0, 2), 16);
+    const g = parseInt(hex.slice(2, 4), 16);
+    const b = parseInt(hex.slice(4, 6), 16);
+    const a = parseInt(hex.slice(6, 8), 16) / 255;
+    return `rgba(${r}, ${g}, ${b}, ${a})`;
+};
+exports.convertHex8ToRgba = convertHex8ToRgba;
 /**
  * * Converts a color from `Hex`, `RGB`, or `HSL` format to its equivalent representations.
  *
@@ -157,7 +228,7 @@ exports.convertHexToRgb = convertHexToRgb;
  * @throws If the color format is unrecognized throws `Error`.
  */
 function convertColorCode(color) {
-    if ((0, helpers_1._isHex)(color)) {
+    if ((0, helpers_1._isHex6)(color)) {
         return {
             rgb: (0, exports.convertHexToRgb)(color),
             hsl: (0, exports.convertHexToHsl)(color),
@@ -165,14 +236,36 @@ function convertColorCode(color) {
     }
     if ((0, helpers_1._isRGB)(color)) {
         return {
-            hex: (0, exports.convertRgbToHex)(...(0, helpers_1.extractNumbersFromColor)(color)),
-            hsl: (0, exports.convertRgbToHsl)(...(0, helpers_1.extractNumbersFromColor)(color)),
+            hex: (0, exports.convertRgbToHex)(...(0, helpers_1._extractSolidColorValues)(color)),
+            hsl: (0, exports.convertRgbToHsl)(...(0, helpers_1._extractSolidColorValues)(color)),
         };
     }
     if ((0, helpers_1._isHSL)(color)) {
         return {
-            hex: (0, exports.convertHslToHex)(...(0, helpers_1.extractNumbersFromColor)(color)),
-            rgb: (0, exports.convertHslToRgb)(...(0, helpers_1.extractNumbersFromColor)(color)),
+            hex: (0, exports.convertHslToHex)(...(0, helpers_1._extractSolidColorValues)(color)),
+            rgb: (0, exports.convertHslToRgb)(...(0, helpers_1._extractSolidColorValues)(color)),
+        };
+    }
+    if ((0, helpers_1._isHex8)(color)) {
+        const rgba = (0, exports.convertHex8ToRgba)(color);
+        return {
+            rgba: rgba,
+            hsla: (0, exports.convertRgbaToHsla)(...(0, helpers_1._extractAlphaColorValues)(rgba)),
+        };
+    }
+    if ((0, helpers_1._isRGBA)(color)) {
+        return {
+            hex8: (0, exports.convertRgbaToHex8)(...(0, helpers_1._extractAlphaColorValues)(color)),
+            hsla: (0, exports.convertRgbaToHsla)(...(0, helpers_1._extractAlphaColorValues)(color)),
+        };
+    }
+    if ((0, helpers_1._isHSLA)(color)) {
+        const hslaValues = (0, helpers_1._extractAlphaColorValues)(color);
+        const hex = (0, exports.convertHslToHex)(hslaValues[0], hslaValues[1], hslaValues[2]);
+        const alphaHex = (0, helpers_1._convertOpacityToHex)(Math.round(hslaValues[3] * 100));
+        return {
+            hex8: `#${hex}${alphaHex}`,
+            rgba: (0, exports.convertHslaToRgba)(...(0, helpers_1._extractAlphaColorValues)(color)),
         };
     }
     throw new Error(`Unrecognized Color Format: ${color}`);

package/dist/colors/helpers.d.ts

@@ -1,4 +1,4 @@
-import type { ColorNumbers, ColorType, Hex, HSL, OpacityValue, RGB } from './types';
+import type { ColorNumbers, ColorNumbersAlpha, Hex6, Hex8, HSL, HSLA, OpacityValue, RGB, RGBA } from './types';
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
@@ -35,26 +35,58 @@ export declare const _isSimilarToLast: (recentColors: string[], newColor: string
  * @param colorString The color string in RGB or HSL format.
  * @returns An array of extracted numbers.
  */
-export declare const extractNumbersFromColor: (colorString: HSL | RGB) => ColorNumbers;
+export declare const _extractSolidColorValues: (colorString: HSL | RGB) => ColorNumbers;
+/**
+ * * Extracts numbers from a color string like `rgba(66, 103, 69, 0.6)` or `hsla(120, 42.86%, 41.18%, 0.9)`.
+ * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
+ *
+ * @param colorString The color string in RGB or HSL format.
+ * @returns An array of extracted numbers.
+ */
+export declare const _extractAlphaColorValues: (colorString: HSLA | RGBA) => ColorNumbersAlpha;
 /**
  * * Checks if a color is in `Hex` format.
  *
  * @param color Color to check.
  * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
  */
-export declare function _isHex(color: ColorType): color is Hex;
+export declare function _isHex6(color: string): color is Hex6;
 /**
  * * 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.
  */
-export declare function _isRGB(color: ColorType): color is RGB;
+export declare function _isRGB(color: string): color is RGB;
 /**
  * * 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.
  */
-export declare function _isHSL(color: ColorType): color is HSL;
+export declare function _isHSL(color: string): color is HSL;
+/**
+ * @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.
+ */
+export declare function _isHex8(color: string): color is Hex8;
+/**
+ * @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.
+ */
+export declare function _isRGBA(color: string): color is RGBA;
+/**
+ * @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.
+ */
+export declare function _isHSLA(color: string): color is HSLA;
 //# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/colors/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,SAAS,EACT,GAAG,EACH,GAAG,EACH,YAAY,EACZ,GAAG,EACH,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,YAAY,KAAG,MAO5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAW,MAAM,WAAW,MAAM,KAAG,MAE9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,GAKrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,iBACd,MAAM,EAAE,YACZ,MAAM,KACd,OA2BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,gBACtB,GAAG,GAAG,GAAG,KACpB,YAIF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,GAAG,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,GAAG,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,IAAI,GAAG,CAErD"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/colors/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,YAAY,EACZ,iBAAiB,EACjB,IAAI,EACJ,IAAI,EACJ,GAAG,EACH,IAAI,EACJ,YAAY,EACZ,GAAG,EACH,IAAI,EACJ,MAAM,SAAS,CAAC;AAEjB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,YAAa,YAAY,KAAG,MAO5D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,UAAW,MAAM,WAAW,MAAM,KAAG,MAE9D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,GAKrC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,iBACd,MAAM,EAAE,YACZ,MAAM,KACd,OA2BF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,gBACvB,GAAG,GAAG,GAAG,KACpB,YAIF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,gBACvB,IAAI,GAAG,IAAI,KACtB,iBAIF,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,GAAG,CAElD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,IAAI,CAEpD"}

package/dist/colors/helpers.js

@@ -1,9 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.extractNumbersFromColor = exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._convertOpacityToHex = void 0;
-exports._isHex = _isHex;
+exports._extractAlphaColorValues = exports._extractSolidColorValues = exports._isSimilarToLast = exports._generateRandomHSL = exports._applyOpacity = exports._convertOpacityToHex = void 0;
+exports._isHex6 = _isHex6;
 exports._isRGB = _isRGB;
 exports._isHSL = _isHSL;
+exports._isHex8 = _isHex8;
+exports._isRGBA = _isRGBA;
+exports._isHSLA = _isHSLA;
 /**
  * * Converts opacity percentage (0-100) to a 2-digit hex string.
  *
@@ -77,17 +80,28 @@ exports._isSimilarToLast = _isSimilarToLast;
  * @param colorString The color string in RGB or HSL format.
  * @returns An array of extracted numbers.
  */
-const extractNumbersFromColor = (colorString) => {
+const _extractSolidColorValues = (colorString) => {
     return (colorString.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
 };
-exports.extractNumbersFromColor = extractNumbersFromColor;
+exports._extractSolidColorValues = _extractSolidColorValues;
+/**
+ * * Extracts numbers from a color string like `rgba(66, 103, 69, 0.6)` or `hsla(120, 42.86%, 41.18%, 0.9)`.
+ * * Converts percentage values to decimal (e.g., `42.86%` → `42.86`).
+ *
+ * @param colorString The color string in RGB or HSL format.
+ * @returns An array of extracted numbers.
+ */
+const _extractAlphaColorValues = (colorString) => {
+    return (colorString.match(/[\d.]+%?/g) || []).map((value) => parseFloat(value));
+};
+exports._extractAlphaColorValues = _extractAlphaColorValues;
 /**
  * * Checks if a color is in `Hex` format.
  *
  * @param color Color to check.
  * @returns Boolean: `true` if it's a `Hex` color, `false` if not.
  */
-function _isHex(color) {
+function _isHex6(color) {
     return /^#[0-9A-Fa-f]{6}$/.test(color);
 }
 /**
@@ -108,3 +122,33 @@ function _isRGB(color) {
 function _isHSL(color) {
     return /^hsl\(\d{1,3}, \d{1,3}%, \d{1,3}%\)$/.test(color);
 }
+/**
+ * @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.
+ */
+function _isHex8(color) {
+    return /^#[0-9A-Fa-f]{8}$/.test(color);
+}
+/**
+ * @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.
+ */
+function _isRGBA(color) {
+    return /^rgba\(\d{1,3}, \d{1,3}, \d{1,3}, (0|1|0?\.\d+)\)$/.test(color);
+}
+/**
+ * @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.
+ */
+function _isHSLA(color) {
+    return /^hsla\(\d{1,3}, \d{1,3}%, \d{1,3}%, (0|1|0?\.\d+)\)$/.test(color);
+}

package/dist/colors/random.d.ts

@@ -1,4 +1,4 @@
-import type { Hex, HSL, RGB } from './types';
+import type { Hex6, HSL, RGB } from './types';
 /**
  * * Utility to generate a unique random HSL color.
  *
@@ -13,7 +13,7 @@ export declare const generateRandomHSLColor: (maxColors?: number) => HSL;
  * @returns An object of generated unique random color in both `Hex` and `RGB` formats.
  */
 export declare const generateRandomColorInHexRGB: (maxColors?: number) => {
-    hex: Hex;
+    hex: Hex6;
     rgb: RGB;
 };
 //# sourceMappingURL=random.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/colors/random.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAQ7C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,eAAe,MAAM,KAAQ,GAqB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,eAC5B,MAAM,KACf;IACF,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CAGT,CAAC"}
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/colors/random.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAC;AAQ9C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,eAAe,MAAM,KAAQ,GAqB/D,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,eAC5B,MAAM,KACf;IACF,GAAG,EAAE,IAAI,CAAC;IACV,GAAG,EAAE,GAAG,CAAC;CAGT,CAAC"}

package/dist/colors/types.d.ts

@@ -5,12 +5,18 @@ export interface ColorInputArray extends Array<ColorInput | ColorInputArray> {
 }
 /** - Opacity options */
 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;
-export type ColorNumber = 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 | 101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 | 121 | 122 | 123 | 124 | 125 | 126 | 127 | 128 | 129 | 130 | 131 | 132 | 133 | 134 | 135 | 136 | 137 | 138 | 139 | 140 | 141 | 142 | 143 | 144 | 145 | 146 | 147 | 148 | 149 | 150 | 151 | 152 | 153 | 154 | 155 | 156 | 157 | 158 | 159 | 160 | 161 | 162 | 163 | 164 | 165 | 166 | 167 | 168 | 169 | 170 | 171 | 172 | 173 | 174 | 175 | 176 | 177 | 178 | 179 | 180 | 181 | 182 | 183 | 184 | 185 | 186 | 187 | 188 | 189 | 190 | 191 | 192 | 193 | 194 | 195 | 196 | 197 | 198 | 199 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 209 | 210 | 211 | 212 | 213 | 214 | 215 | 216 | 217 | 218 | 219 | 220 | 221 | 222 | 223 | 224 | 225 | 226 | 227 | 228 | 229 | 230 | 231 | 232 | 233 | 234 | 235 | 236 | 237 | 238 | 239 | 240 | 241 | 242 | 243 | 244 | 245 | 246 | 247 | 248 | 249 | 250 | 251 | 252 | 253 | 254 | 255;
 /**
  * * Represents a hexadecimal color code.
  * * Format: `#3C6945`
  */
 export type Hex = `#${string}`;
+/**
+ * * Represents a hexadecimal color code.
+ * * Format: `#3C6945`
+ */
+export type Hex6 = `#${string}` & {
+    __hex6Brand: never;
+};
 /**
  * * Represents an RGB color string.
  * * Format: `rgb(R, G, B)`
@@ -29,16 +35,44 @@ export type RGB = `rgb(${number}, ${number}, ${number})`;
  * - L (Lightness): 0-100%
  */
 export type HSL = `hsl(${number}, ${number}%, ${number}%)`;
-/** * Union type representing a color in Hex, RGB, or HSL format. */
-export type ColorType = Hex | RGB | HSL;
-/** - Colors Object that includes `Hex`, `RGB` and `HSL` formats of the same color. */
-export interface Colors {
-    hex: Hex;
+/**
+ * * Represents a hexadecimal color code with optional alpha channel.
+ * * Format: `#3C6945FF`
+ */
+export type Hex8 = `#${string}` & {
+    __hex8Brand: never;
+};
+/**
+ * * Represents an RGBA color string, now includes optional alpha (opacity).
+ * * Format: `rgba(R, G, B, A)`
+ */
+export type RGBA = `rgba(${number}, ${number}, ${number}, ${number})`;
+/**
+ * * Represents an HSLA color string with optional alpha channel.
+ * * Format: `hsla(H, S%, L%, A)`
+ */
+export type HSLA = `hsla(${number}, ${number}%, ${number}%, ${number})`;
+/** * Union type representing a color in Hex6, RGB, or HSL format. */
+export type ColorTypeSolid = Hex6 | RGB | HSL;
+/** * Union type representing a color in Hex8, RGBA, or HSLA format. */
+export type ColorTypeAlpha = Hex8 | RGBA | HSLA;
+/** - Colors Object that includes `Hex8`, `RGBA` and `HSLA` formats of the same color. */
+export interface SolidColors {
+    hex: Hex6;
     rgb: RGB;
     hsl: HSL;
 }
+/** - Colors Object that includes `Hex`, `RGB` and `HSL` formats of the same color. */
+export interface AlphaColors {
+    hex8: Hex8;
+    rgba: RGBA;
+    hsla: HSLA;
+}
+export type ColorType = ColorTypeSolid | ColorTypeAlpha | Hex;
+/** * Represents a tuple of three numerical values corresponding to RGB or HSL color components. */
+export type ColorNumbers = [number, number, number];
 /** * Represents a tuple of three numerical values corresponding to RGB or HSL color components. */
-export type ColorNumbers = [ColorNumber, ColorNumber, ColorNumber];
+export type ColorNumbersAlpha = [number, number, number, number];
 /**
  * * Represents the converted color formats for a given color type.
  *
@@ -48,12 +82,18 @@ export type ColorNumbers = [ColorNumber, ColorNumber, ColorNumber];
  *
  * @template T The input color type (`Hex`, `RGB`, or `HSL`).
  */
-export interface ConvertedColors<T extends ColorType> extends Record<string, Hex | RGB | HSL> {
+export interface ConvertedColors<T extends ColorType> extends Record<string, ColorType> {
     /** - The Hex representation (excluded if the input is already Hex). */
-    hex: T extends Hex ? never : Hex;
+    hex: T extends Hex6 | ColorTypeAlpha ? never : Hex6;
     /** - The RGB representation (excluded if the input is already RGB). */
-    rgb: T extends RGB ? never : RGB;
+    rgb: T extends RGB | ColorTypeAlpha ? never : RGB;
     /** - The HSL representation (excluded if the input is already HSL). */
-    hsl: T extends HSL ? never : HSL;
+    hsl: T extends HSL | ColorTypeAlpha ? never : HSL;
+    /** - The Hex8 representation with opacity (excluded if the input is already Hex8). */
+    hex8: T extends Hex8 | ColorTypeSolid ? never : Hex8;
+    /** - The RGBA representation (excluded if the input is already RGBA). */
+    rgba: T extends RGBA | ColorTypeSolid ? never : RGBA;
+    /** - The HSLA representation (excluded if the input is already HSLA). */
+    hsla: T extends HSLA | ColorTypeSolid ? never : HSLA;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"AAAA,+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,MAAM,MAAM,WAAW,GACpB,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,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,GACH,GAAG,CAAC;AAEP;;;GAGG;AACH,MAAM,MAAM,GAAG,GAAG,IAAI,MAAM,EAAE,CAAC;AAE/B;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,MAAM,GAAG,GAAG,OAAO,MAAM,KAAK,MAAM,MAAM,MAAM,IAAI,CAAC;AAM3D,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAExC,sFAAsF;AACtF,MAAM,WAAW,MAAM;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;CACT;AAED,mGAAmG;AACnG,MAAM,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,SAAS,CACnD,SAAQ,MAAM,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACvC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;IACjC,uEAAuE;IACvE,GAAG,EAAE,CAAC,SAAS,GAAG,GAAG,KAAK,GAAG,GAAG,CAAC;CACjC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/colors/types.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -7,12 +7,11 @@ export { findPrimeNumbers, isPrime } from './number/prime';
 export { getNumbersInRange } from './number/range';
 export { getColorForInitial } from './colors/initials';
 export { generateRandomColorInHexRGB, generateRandomHSLColor, } from './colors/random';
-export { convertColorCode, convertHexToHsl, convertHexToRgb, convertHslToHex, convertHslToRgb, convertRgbToHex, convertRgbToHsl, } from './colors/convert';
+export { convertColorCode, convertHex8ToRgba, convertHexToHsl, convertHexToRgb, convertHslaToRgba, convertHslToHex, convertHslToRgb, convertRgbaToHex8, convertRgbaToHsla, convertRgbToHex, convertRgbToHsl, convertRgbToRgba, } from './colors/convert';
 export { Color } from './colors/Color';
-export { extractNumbersFromColor } from './colors/helpers';
 export { filterArrayOfObjects, flattenArray, isValidButEmptyArray, shuffleArray, } from './array/basics';
 export { sortAnArray } from './array/sort';
-export { createOptionsArray } from './array/transform';
+export { createOptionsArray, removeDuplicatesFromArray, } from './array/transform';
 export { convertIntoFormData, isEmptyFormData } from './form/convert';
 export { createControlledFormData } from './form/transform';
 export { cloneObject, countObjectFields, generateQueryParams, isEmptyObject, isObject, } from './object/basics';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,EACf,eAAe,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,GACd,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,EACN,2BAA2B,EAC3B,sBAAsB,GACtB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,gBAAgB,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EACN,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,YAAY,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EACN,kBAAkB,EAClB,yBAAyB,GACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,QAAQ,GACR,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACN,gBAAgB,EAChB,0BAA0B,EAC1B,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,YAAY,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isDeepEqual = exports.convertArrayToString = exports.convertObjectValues = exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObject = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidButEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.extractNumbersFromColor = exports.Color = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.convertStringCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.sanitizeData = exports.mergeObjects = exports.mergeAndFlattenObjects = exports.flattenObject = exports.extractUpdatedFields = exports.extractUpdatedAndNewFields = exports.extractNewFields = exports.isObject = exports.isEmptyObject = exports.generateQueryParams = exports.countObjectFields = exports.cloneObject = exports.createControlledFormData = exports.isEmptyFormData = exports.convertIntoFormData = exports.removeDuplicatesFromArray = exports.createOptionsArray = exports.sortAnArray = exports.shuffleArray = exports.isValidButEmptyArray = exports.flattenArray = exports.filterArrayOfObjects = exports.Color = exports.convertRgbToRgba = exports.convertRgbToHsl = exports.convertRgbToHex = exports.convertRgbaToHsla = exports.convertRgbaToHex8 = exports.convertHslToRgb = exports.convertHslToHex = exports.convertHslaToRgba = exports.convertHexToRgb = exports.convertHexToHsl = exports.convertHex8ToRgba = exports.convertColorCode = exports.generateRandomHSLColor = exports.generateRandomColorInHexRGB = exports.getColorForInitial = exports.getNumbersInRange = exports.isPrime = exports.findPrimeNumbers = exports.numberToWords = exports.getRandomNumber = exports.convertToDecimal = exports.convertStringCase = exports.generateAnagrams = exports.truncateString = exports.trimString = exports.generateRandomID = exports.capitalizeString = void 0;
+exports.isDeepEqual = exports.convertArrayToString = exports.convertObjectValues = void 0;
 var basics_1 = require("./string/basics");
 Object.defineProperty(exports, "capitalizeString", { enumerable: true, get: function () { return basics_1.capitalizeString; } });
 Object.defineProperty(exports, "generateRandomID", { enumerable: true, get: function () { return basics_1.generateRandomID; } });
@@ -27,16 +28,19 @@ Object.defineProperty(exports, "generateRandomColorInHexRGB", { enumerable: true
 Object.defineProperty(exports, "generateRandomHSLColor", { enumerable: true, get: function () { return random_1.generateRandomHSLColor; } });
 var convert_3 = require("./colors/convert");
 Object.defineProperty(exports, "convertColorCode", { enumerable: true, get: function () { return convert_3.convertColorCode; } });
+Object.defineProperty(exports, "convertHex8ToRgba", { enumerable: true, get: function () { return convert_3.convertHex8ToRgba; } });
 Object.defineProperty(exports, "convertHexToHsl", { enumerable: true, get: function () { return convert_3.convertHexToHsl; } });
 Object.defineProperty(exports, "convertHexToRgb", { enumerable: true, get: function () { return convert_3.convertHexToRgb; } });
+Object.defineProperty(exports, "convertHslaToRgba", { enumerable: true, get: function () { return convert_3.convertHslaToRgba; } });
 Object.defineProperty(exports, "convertHslToHex", { enumerable: true, get: function () { return convert_3.convertHslToHex; } });
 Object.defineProperty(exports, "convertHslToRgb", { enumerable: true, get: function () { return convert_3.convertHslToRgb; } });
+Object.defineProperty(exports, "convertRgbaToHex8", { enumerable: true, get: function () { return convert_3.convertRgbaToHex8; } });
+Object.defineProperty(exports, "convertRgbaToHsla", { enumerable: true, get: function () { return convert_3.convertRgbaToHsla; } });
 Object.defineProperty(exports, "convertRgbToHex", { enumerable: true, get: function () { return convert_3.convertRgbToHex; } });
 Object.defineProperty(exports, "convertRgbToHsl", { enumerable: true, get: function () { return convert_3.convertRgbToHsl; } });
+Object.defineProperty(exports, "convertRgbToRgba", { enumerable: true, get: function () { return convert_3.convertRgbToRgba; } });
 var Color_1 = require("./colors/Color");
 Object.defineProperty(exports, "Color", { enumerable: true, get: function () { return Color_1.Color; } });
-var helpers_1 = require("./colors/helpers");
-Object.defineProperty(exports, "extractNumbersFromColor", { enumerable: true, get: function () { return helpers_1.extractNumbersFromColor; } });
 var basics_3 = require("./array/basics");
 Object.defineProperty(exports, "filterArrayOfObjects", { enumerable: true, get: function () { return basics_3.filterArrayOfObjects; } });
 Object.defineProperty(exports, "flattenArray", { enumerable: true, get: function () { return basics_3.flattenArray; } });
@@ -46,6 +50,7 @@ var sort_1 = require("./array/sort");
 Object.defineProperty(exports, "sortAnArray", { enumerable: true, get: function () { return sort_1.sortAnArray; } });
 var transform_1 = require("./array/transform");
 Object.defineProperty(exports, "createOptionsArray", { enumerable: true, get: function () { return transform_1.createOptionsArray; } });
+Object.defineProperty(exports, "removeDuplicatesFromArray", { enumerable: true, get: function () { return transform_1.removeDuplicatesFromArray; } });
 var convert_4 = require("./form/convert");
 Object.defineProperty(exports, "convertIntoFormData", { enumerable: true, get: function () { return convert_4.convertIntoFormData; } });
 Object.defineProperty(exports, "isEmptyFormData", { enumerable: true, get: function () { return convert_4.isEmptyFormData; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nhb-toolbox",
-  "version": "1.8.4",
+  "version": "1.9.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",