@qrvey/utils 1.12.0 → 1.13.0-1

package/dist/cjs/themes/constants/COLOR_TYPE.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.COLOR_TYPE = void 0;
+/**
+ * The color luminosity type
+ */
 var COLOR_TYPE;
 (function (COLOR_TYPE) {
     COLOR_TYPE["DARK"] = "DARK";

package/dist/cjs/themes/constants/CSS_VARIABLE_DESTINATION.d.ts

@@ -1,3 +1,6 @@
+/**
+ * The Destination places to inject the css variables
+ */
 export declare enum CSS_VARIABLE_DESTINATION {
     CANVAS = "CANVAS",
     GLOBAL = "GLOBAL"

package/dist/cjs/themes/constants/CSS_VARIABLE_DESTINATION.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CSS_VARIABLE_DESTINATION = void 0;
+/**
+ * The Destination places to inject the css variables
+ */
 var CSS_VARIABLE_DESTINATION;
 (function (CSS_VARIABLE_DESTINATION) {
     CSS_VARIABLE_DESTINATION["CANVAS"] = "CANVAS";

package/dist/cjs/themes/constants/HEXADECIMAL_REGULAR_EXPRESSION.d.ts

@@ -1 +1,4 @@
+/**
+ * Hexadecimal Regular Expression
+ */
 export declare const HEXADECIMAL_REGULAR_EXPRESSION: RegExp;

package/dist/cjs/themes/constants/HEXADECIMAL_REGULAR_EXPRESSION.js

@@ -1,4 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HEXADECIMAL_REGULAR_EXPRESSION = void 0;
+/**
+ * Hexadecimal Regular Expression
+ */
 exports.HEXADECIMAL_REGULAR_EXPRESSION = /^#([0-9A-Fa-f]{6}|[0-9A-Fa-f]{8})$/;

package/dist/cjs/themes/constants/RGBA_REGULAR_EXPRESION.d.ts

@@ -1 +1,4 @@
+/**
+ * RGBA Regular Expression
+ */
 export declare const RGBA_REGULAR_EXPRESSION: RegExp;

package/dist/cjs/themes/constants/RGBA_REGULAR_EXPRESION.js

@@ -1,4 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RGBA_REGULAR_EXPRESSION = void 0;
+/**
+ * RGBA Regular Expression
+ */
 exports.RGBA_REGULAR_EXPRESSION = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$/;

package/dist/cjs/themes/constants/index.d.ts

@@ -3,6 +3,10 @@ export * from "./AUTOMATIC_CANVAS_CSS_VARIABLES_FOR_LIGHT";
 export * from "./AUTOMATIC_CSS_VARIABLES";
 export * from "./AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_DARK";
 export * from "./AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_LIGHT";
+export * from "./CANVAS_CSS_VARIABLES";
+export * from "./CHANNEL_BLACK_COLOR";
+export * from "./CHANNEL_WHITE_COLOR";
+export * from "./COLOR_NAME";
 export * from "./COLOR_TYPE";
 export * from "./CSS_VARIABLE_DESTINATION";
 export * from "./GLOBAL_CSS_VARIABLES";

package/dist/cjs/themes/constants/index.js

@@ -19,6 +19,10 @@ __exportStar(require("./AUTOMATIC_CANVAS_CSS_VARIABLES_FOR_LIGHT"), exports);
 __exportStar(require("./AUTOMATIC_CSS_VARIABLES"), exports);
 __exportStar(require("./AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_DARK"), exports);
 __exportStar(require("./AUTOMATIC_GLOBAL_CSS_VARIABLES_FOR_LIGHT"), exports);
+__exportStar(require("./CANVAS_CSS_VARIABLES"), exports);
+__exportStar(require("./CHANNEL_BLACK_COLOR"), exports);
+__exportStar(require("./CHANNEL_WHITE_COLOR"), exports);
+__exportStar(require("./COLOR_NAME"), exports);
 __exportStar(require("./COLOR_TYPE"), exports);
 __exportStar(require("./CSS_VARIABLE_DESTINATION"), exports);
 __exportStar(require("./GLOBAL_CSS_VARIABLES"), exports);

package/dist/cjs/themes/helpers/calculateHSP.d.ts

@@ -0,0 +1,8 @@
+import { IColorChannel } from "../interfaces/IColorChannel";
+/**
+ * Calculates the HSP Color Mode from the RGBA channels
+ * - If the calculation are wrong or the given parameter is undefined, the function will return a default for light colors
+ * @param rgbaChannel the rgba channel object
+ * @returns a HSP color number
+ */
+export declare function calculateHSP(rgbaChannel: IColorChannel): number;

package/dist/cjs/themes/helpers/calculateHSP.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateHSP = void 0;
+const general_1 = require("../../general");
+const isEmpty_1 = require("../../general/mix/isEmpty");
+/**
+ * Calculates the HSP Color Mode from the RGBA channels
+ * - If the calculation are wrong or the given parameter is undefined, the function will return a default for light colors
+ * @param rgbaChannel the rgba channel object
+ * @returns a HSP color number
+ */
+function calculateHSP(rgbaChannel) {
+    if ((0, isEmpty_1.isEmpty)(rgbaChannel))
+        return 255;
+    const { r, g, b } = rgbaChannel;
+    // HSP equation from http://alienryderflex.com/hsp.html
+    const hsp = Math.sqrt(0.299 * (r * r) + 0.587 * (g * g) + 0.114 * (b * b));
+    return (0, general_1.isNaNV2)(hsp) ? 255 : hsp;
+}
+exports.calculateHSP = calculateHSP;

package/dist/cjs/themes/helpers/getCSSVariablesByDestination.d.ts

@@ -7,12 +7,7 @@ import { IColorCSSVariableDestination } from "../interfaces/IColorCSSVariableDes
  */
 export declare function getCSSVariablesByDestination(destination?: IColorCSSVariableDestination): {
     DARK: {
-        "--qv-global-header-background-color": string; /**
-         * Gets CSS variables depending on the destination of them.
-         * - Destination is the place where the CSS variables are going to be applied. With this, the right CSS variables are searched and set.
-         * @param destination the string of the destination.
-         * @returns the CSS variables and their values.
-         */
+        "--qv-global-header-background-color": string;
         "--qv-global-opacity-black-color": string;
         "--qv-global-border-color": string;
         "--qv-global-divider-color": string;

package/dist/cjs/themes/helpers/getCSSVariablesByDestination.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCSSVariablesByDestination = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
 const AUTOMATIC_CSS_VARIABLES_1 = require("../constants/AUTOMATIC_CSS_VARIABLES");
 const CSS_VARIABLE_DESTINATION_1 = require("../constants/CSS_VARIABLE_DESTINATION");
 /**
@@ -10,6 +11,8 @@ const CSS_VARIABLE_DESTINATION_1 = require("../constants/CSS_VARIABLE_DESTINATIO
  * @returns the CSS variables and their values.
  */
 function getCSSVariablesByDestination(destination = CSS_VARIABLE_DESTINATION_1.CSS_VARIABLE_DESTINATION.GLOBAL) {
+    if ((0, isEmpty_1.isEmpty)(destination))
+        return AUTOMATIC_CSS_VARIABLES_1.AUTOMATIC_CANVAS_CSS_VARIABLES[CSS_VARIABLE_DESTINATION_1.CSS_VARIABLE_DESTINATION.GLOBAL];
     return AUTOMATIC_CSS_VARIABLES_1.AUTOMATIC_CANVAS_CSS_VARIABLES[destination];
 }
 exports.getCSSVariablesByDestination = getCSSVariablesByDestination;

package/dist/cjs/themes/helpers/getChannelsByHexadecimalColor.d.ts

@@ -0,0 +1,8 @@
+import { IColorChannel } from "../interfaces/IColorChannel";
+/**
+ * Gets the RGBA channels based on the given string Hexadecimal color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the Hexadecimal color
+ * @returns the RGBA channels
+ */
+export declare function getChannelsByHexadecimalColor(hexadecimal?: string): IColorChannel;

package/dist/cjs/themes/helpers/getChannelsByHexadecimalColor.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannelsByHexadecimalColor = void 0;
+const CHANNEL_WHITE_COLOR_1 = require("../constants/CHANNEL_WHITE_COLOR");
+const getHexadecimalOpacity_1 = require("./getHexadecimalOpacity");
+const isHexadecimalColor_1 = require("./isHexadecimalColor");
+/**
+ * Gets the RGBA channels based on the given string Hexadecimal color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the Hexadecimal color
+ * @returns the RGBA channels
+ */
+function getChannelsByHexadecimalColor(hexadecimal = "") {
+    if (!(0, isHexadecimalColor_1.isHexadecimalColor)(hexadecimal))
+        return CHANNEL_WHITE_COLOR_1.CHANNEL_WHITE_COLOR;
+    const colorCode = +`0x${hexadecimal
+        .slice(1)
+        .replace(hexadecimal.length < 5 && /./g, "$&$&")}`;
+    return {
+        r: colorCode >> 16,
+        g: (colorCode >> 8) & 255,
+        b: colorCode & 255,
+        a: (0, getHexadecimalOpacity_1.getHexadecimalOpacity)(hexadecimal),
+    };
+}
+exports.getChannelsByHexadecimalColor = getChannelsByHexadecimalColor;

package/dist/cjs/themes/helpers/getChannelsByNameColor.d.ts

@@ -0,0 +1,8 @@
+import { IColorChannel } from "../interfaces/IColorChannel";
+/**
+ * Gets the RGBA channels based on the given string name color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the name color
+ * @returns the RGBA channels
+ */
+export declare function getChannelsByNameColor(name?: string): IColorChannel;

package/dist/cjs/themes/helpers/getChannelsByNameColor.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannelsByNameColor = void 0;
+const isEmpty_1 = require("../../general/mix/isEmpty");
+const CHANNEL_WHITE_COLOR_1 = require("../constants/CHANNEL_WHITE_COLOR");
+const COLOR_NAME_1 = require("../constants/COLOR_NAME");
+/**
+ * Gets the RGBA channels based on the given string name color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the name color
+ * @returns the RGBA channels
+ */
+function getChannelsByNameColor(name = "") {
+    const nameColorChannel = COLOR_NAME_1.COLOR_NAME[String(name).toLowerCase()];
+    if ((0, isEmpty_1.isEmpty)(nameColorChannel) ||
+        !Array.isArray(nameColorChannel) ||
+        nameColorChannel.length !== 3)
+        return CHANNEL_WHITE_COLOR_1.CHANNEL_WHITE_COLOR;
+    return {
+        r: nameColorChannel[0],
+        g: nameColorChannel[1],
+        b: nameColorChannel[2],
+        a: 1,
+    };
+}
+exports.getChannelsByNameColor = getChannelsByNameColor;

package/dist/cjs/themes/helpers/getChannelsByRgbaColor.d.ts

@@ -0,0 +1,8 @@
+import { IColorChannel } from "../interfaces/IColorChannel";
+/**
+ * Gets the RGBA channels based on the given string RGBA color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the RGBA color
+ * @returns the RGBA channels
+ */
+export declare function getChannelsByRgbaColor(rgba?: string): IColorChannel;

package/dist/cjs/themes/helpers/getChannelsByRgbaColor.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChannelsByRgbaColor = void 0;
+const CHANNEL_WHITE_COLOR_1 = require("../constants/CHANNEL_WHITE_COLOR");
+const RGBA_REGULAR_EXPRESION_1 = require("../constants/RGBA_REGULAR_EXPRESION");
+const getRgbaOpacity_1 = require("./getRgbaOpacity");
+const isRGBAColor_1 = require("./isRGBAColor");
+/**
+ * Gets the RGBA channels based on the given string RGBA color
+ * - If the given argument is undefined or invalid, the function will return a channel related to white color
+ * @param color the RGBA color
+ * @returns the RGBA channels
+ */
+function getChannelsByRgbaColor(rgba = "") {
+    if (!(0, isRGBAColor_1.isRGBAColor)(rgba))
+        return CHANNEL_WHITE_COLOR_1.CHANNEL_WHITE_COLOR;
+    const colors = rgba.toLowerCase().match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION);
+    return {
+        r: Number(colors[1]),
+        g: Number(colors[2]),
+        b: Number(colors[3]),
+        a: (0, getRgbaOpacity_1.getRgbaOpacity)(rgba),
+    };
+}
+exports.getChannelsByRgbaColor = getChannelsByRgbaColor;

package/dist/cjs/themes/helpers/getHexadecimalOpacity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gets the Alpha channel (opacity) base on the hexadecimal color
+ * - If the alpha channel is not set into the given parameter or the calculation is NaN, the function will return 1
+ * @param hexadecimal hexadecimal color
+ * @returns the Alpha channel (opacity)
+ */
+export declare function getHexadecimalOpacity(hexadecimal?: string): number;

package/dist/cjs/themes/helpers/getHexadecimalOpacity.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getHexadecimalOpacity = void 0;
+const isNaNV2_1 = require("../../general/mix/isNaNV2");
+const isHexadecimalColor_1 = require("./isHexadecimalColor");
+/**
+ * Gets the Alpha channel (opacity) base on the hexadecimal color
+ * - If the alpha channel is not set into the given parameter or the calculation is NaN, the function will return 1
+ * @param hexadecimal hexadecimal color
+ * @returns the Alpha channel (opacity)
+ */
+function getHexadecimalOpacity(hexadecimal = "") {
+    if (!(0, isHexadecimalColor_1.isHexadecimalColor)(hexadecimal))
+        return 1;
+    const opacityHexa = hexadecimal.slice(7) || "FF";
+    const opacity = parseInt(opacityHexa, 16) / 255;
+    return (0, isNaNV2_1.isNaNV2)(opacity) ? 1 : opacity;
+}
+exports.getHexadecimalOpacity = getHexadecimalOpacity;

package/dist/cjs/themes/helpers/getRgbaOpacity.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Gets the Alpha channel (opacity) base on the RGBA color
+ * * - If the alpha channel is not set into the given parameter or the calculation is NaN, the function will return 1
+ * @param hexadecimal RGBA color
+ * @returns the Alpha channel (opacity)
+ */
+export declare function getRgbaOpacity(rgba?: string): number;

package/dist/cjs/themes/helpers/getRgbaOpacity.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRgbaOpacity = void 0;
+const isNaNV2_1 = require("../../general/mix/isNaNV2");
+const RGBA_REGULAR_EXPRESION_1 = require("../constants/RGBA_REGULAR_EXPRESION");
+const isRGBAColor_1 = require("./isRGBAColor");
+/**
+ * Gets the Alpha channel (opacity) base on the RGBA color
+ * * - If the alpha channel is not set into the given parameter or the calculation is NaN, the function will return 1
+ * @param hexadecimal RGBA color
+ * @returns the Alpha channel (opacity)
+ */
+function getRgbaOpacity(rgba = "") {
+    var _a;
+    if (!(0, isRGBAColor_1.isRGBAColor)(rgba))
+        return 1;
+    const colors = rgba.toLowerCase().match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION);
+    const opacity = (_a = Number(colors[4])) !== null && _a !== void 0 ? _a : 1;
+    return (0, isNaNV2_1.isNaNV2)(opacity) ? 1 : opacity;
+}
+exports.getRgbaOpacity = getRgbaOpacity;

package/dist/cjs/themes/helpers/index.d.ts

@@ -1,5 +1,10 @@
+export * from "./calculateHSP";
+export * from "./getChannelsByHexadecimalColor";
+export * from "./getChannelsByNameColor";
+export * from "./getChannelsByRgbaColor";
 export * from "./getCSSVariablesByDestination";
-export * from "./lightOrDark";
+export * from "./getHexadecimalOpacity";
+export * from "./getRgbaOpacity";
 export * from "./isDarkColor";
 export * from "./isHexadecimalColor";
 export * from "./isRGBAColor";

package/dist/cjs/themes/helpers/index.js

@@ -14,8 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./calculateHSP"), exports);
+__exportStar(require("./getChannelsByHexadecimalColor"), exports);
+__exportStar(require("./getChannelsByNameColor"), exports);
+__exportStar(require("./getChannelsByRgbaColor"), exports);
 __exportStar(require("./getCSSVariablesByDestination"), exports);
-__exportStar(require("./lightOrDark"), exports);
+__exportStar(require("./getHexadecimalOpacity"), exports);
+__exportStar(require("./getRgbaOpacity"), exports);
 __exportStar(require("./isDarkColor"), exports);
 __exportStar(require("./isHexadecimalColor"), exports);
 __exportStar(require("./isRGBAColor"), exports);

package/dist/cjs/themes/helpers/isHexadecimalColor.js

@@ -9,6 +9,7 @@ const HEXADECIMAL_REGULAR_EXPRESSION_1 = require("../constants/HEXADECIMAL_REGUL
  * @returns true: the color is an hexadecimal type
  */
 function isHexadecimalColor(color = "") {
-    return !(0, isEmpty_1.isEmpty)(color === null || color === void 0 ? void 0 : color.match(HEXADECIMAL_REGULAR_EXPRESSION_1.HEXADECIMAL_REGULAR_EXPRESSION));
+    return (typeof color === "string" &&
+        !(0, isEmpty_1.isEmpty)(color.match(HEXADECIMAL_REGULAR_EXPRESSION_1.HEXADECIMAL_REGULAR_EXPRESSION)));
 }
 exports.isHexadecimalColor = isHexadecimalColor;

package/dist/cjs/themes/helpers/isRGBAColor.js

@@ -9,6 +9,7 @@ const RGBA_REGULAR_EXPRESION_1 = require("../constants/RGBA_REGULAR_EXPRESION");
  * @returns true: the color is an RGBA type
  */
 function isRGBAColor(color = "") {
-    return !(0, isEmpty_1.isEmpty)(color === null || color === void 0 ? void 0 : color.match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION));
+    return (typeof color === "string" &&
+        !(0, isEmpty_1.isEmpty)(color.toLowerCase().match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION)));
 }
 exports.isRGBAColor = isRGBAColor;

package/dist/cjs/themes/helpers/lightOrDark.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.lightOrDark = void 0;
 const isEmpty_1 = require("../../general/mix/isEmpty");
 const COLOR_TYPE_1 = require("../constants/COLOR_TYPE");
-const RGBA_REGULAR_EXPRESION_1 = require("../constants/RGBA_REGULAR_EXPRESION");
+const calculateHSP_1 = require("./calculateHSP");
+const getChannelsByHexadecimalColor_1 = require("./getChannelsByHexadecimalColor");
+const getChannelsByNameColor_1 = require("./getChannelsByNameColor");
+const getChannelsByRgbaColor_1 = require("./getChannelsByRgbaColor");
 const isHexadecimalColor_1 = require("./isHexadecimalColor");
 const isRGBAColor_1 = require("./isRGBAColor");
 /**
@@ -14,43 +17,24 @@ const isRGBAColor_1 = require("./isRGBAColor");
  * @returns the color type (Dark or Light)
  */
 function lightOrDark(color, brightnessThreshold = 127.5, opacityThreshold = 0.5) {
-    if ((0, isEmpty_1.isEmpty)(color))
+    if ((0, isEmpty_1.isEmpty)(color) || typeof color !== "string")
         return COLOR_TYPE_1.COLOR_TYPE.LIGHT;
+    let rgbaChannel = { r: 0, g: 0, b: 0, a: 1 };
     const rgbaColor = (0, isRGBAColor_1.isRGBAColor)(color);
     const hexadecimalColor = (0, isHexadecimalColor_1.isHexadecimalColor)(color);
-    if (!rgbaColor && !hexadecimalColor)
-        return;
-    let r, g, b, a;
     if (rgbaColor) {
-        const colors = color.match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION);
-        r = Number(colors[1]);
-        g = Number(colors[2]);
-        b = Number(colors[3]);
-        a = rgbaOpacity(color);
+        rgbaChannel = (0, getChannelsByRgbaColor_1.getChannelsByRgbaColor)(color);
     }
-    if (hexadecimalColor) {
-        const colorCode = +`0x${color
-            .slice(1)
-            .replace(color.length < 5 && /./g, "$&$&")}`;
-        r = colorCode >> 16;
-        g = (colorCode >> 8) & 255;
-        b = colorCode & 255;
-        a = hexadecimalOpacity(color);
+    else if (hexadecimalColor) {
+        rgbaChannel = (0, getChannelsByHexadecimalColor_1.getChannelsByHexadecimalColor)(color);
     }
-    // HSP equation from http://alienryderflex.com/hsp.html
-    const hsp = Math.sqrt(0.299 * (r * r) + 0.587 * (g * g) + 0.114 * (b * b));
-    if (hsp > brightnessThreshold || a < opacityThreshold) {
+    else {
+        rgbaChannel = (0, getChannelsByNameColor_1.getChannelsByNameColor)(color);
+    }
+    const hsp = (0, calculateHSP_1.calculateHSP)(rgbaChannel);
+    if (hsp > brightnessThreshold || rgbaChannel.a < opacityThreshold) {
         return COLOR_TYPE_1.COLOR_TYPE.LIGHT;
     }
     return COLOR_TYPE_1.COLOR_TYPE.DARK;
 }
 exports.lightOrDark = lightOrDark;
-function hexadecimalOpacity(hexadecimal) {
-    const opacityHexa = hexadecimal.slice(7) || "FF";
-    return parseInt(opacityHexa, 16) / 255;
-}
-function rgbaOpacity(rgba) {
-    var _a;
-    const colors = rgba.match(RGBA_REGULAR_EXPRESION_1.RGBA_REGULAR_EXPRESSION);
-    return (_a = Number(colors[4])) !== null && _a !== void 0 ? _a : 1;
-}

package/dist/cjs/themes/helpers/setAutomaticCSSVariablesForDark.js

@@ -11,7 +11,7 @@ const getCSSVariablesByDestination_1 = require("./getCSSVariablesByDestination")
  * @param wrapperTags the html elements to set the CSS variables
  */
 function setAutomaticCSSVariablesForDark(colorType, wrapperTags, destination = CSS_VARIABLE_DESTINATION_1.CSS_VARIABLE_DESTINATION.GLOBAL) {
-    if ((0, isEmpty_1.isEmpty)(colorType) || (0, isEmpty_1.isEmpty)(wrapperTags))
+    if ((0, isEmpty_1.isEmpty)(colorType) || !Array.isArray(wrapperTags))
         return;
     const cssVariables = (0, getCSSVariablesByDestination_1.getCSSVariablesByDestination)(destination);
     const cssVariablesKeys = Object.keys(cssVariables[colorType] || {});

package/dist/cjs/themes/interfaces/IColorCSSVariableDestination.d.ts

@@ -1,2 +1,5 @@
 import { CSS_VARIABLE_DESTINATION } from "../constants/CSS_VARIABLE_DESTINATION";
+/**
+ * CSS Variable Destination types
+ */
 export type IColorCSSVariableDestination = CSS_VARIABLE_DESTINATION;

package/dist/cjs/themes/interfaces/IColorChannel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Structure for the RGBA Color channels
+ */
+export interface IColorChannel {
+    a?: number;
+    b: number;
+    g: number;
+    r: number;
+}

package/dist/cjs/themes/interfaces/IColorChannel.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/themes/interfaces/IColorType.d.ts

@@ -1,2 +1,5 @@
 import { COLOR_TYPE } from "../constants/COLOR_TYPE";
+/**
+ * Color types
+ */
 export type IColorType = COLOR_TYPE;

package/dist/cjs/themes/interfaces/index.d.ts

@@ -1,2 +1,3 @@
+export * from "./IColorChannel";
 export * from "./IColorCSSVariableDestination";
 export * from "./IColorType";

package/dist/cjs/themes/interfaces/index.js

@@ -14,5 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./IColorChannel"), exports);
 __exportStar(require("./IColorCSSVariableDestination"), exports);
 __exportStar(require("./IColorType"), exports);

package/dist/dates/adapters/dateToMonthYear.js

@@ -1,4 +1,5 @@
 import { DATE_YEAR_MONTHS } from "../constants/DATE_YEAR_MONTHS";
+import { INTL_YEAR_FORMAT } from "../constants/INTL_DATE_FORMATS";
 import { getDateByTimezone } from "../helpers/getDateByTimezone";
 import { getDefaultDateSettings } from "../helpers/getDefaultDateSettings";
 import { isValidDateObject } from "../helpers/isValidDateObject";
@@ -17,5 +18,6 @@ export function dateToMonthYear(date, settings) {
     const dt = new Date(timezonedDate.valueOf());
     if (!isValidDateObject(dt))
         return date;
-    return `${DATE_YEAR_MONTHS[dt.getMonth()]} ${dt.getFullYear()}`;
+    const year = INTL_YEAR_FORMAT.format(dt.getFullYear());
+    return `${DATE_YEAR_MONTHS[dt.getMonth()]} ${year}`;
 }

package/dist/dates/constants/INTL_DATE_FORMATS.d.ts

@@ -0,0 +1 @@
+export declare const INTL_YEAR_FORMAT: Intl.NumberFormat;

package/dist/dates/constants/INTL_DATE_FORMATS.js

@@ -0,0 +1,5 @@
+export const INTL_YEAR_FORMAT = new Intl.NumberFormat(undefined, {
+    useGrouping: false,
+    minimumIntegerDigits: 4,
+    maximumSignificantDigits: 4,
+});

package/dist/dates/constants/index.d.ts

@@ -42,3 +42,4 @@ export * from "./ISO_8601_REGEX";
 export * from "./TIME_GROUPING_PROPERTY_INFO_LIST";
 export * from "./TIME_GROUPING_PROPERTY_INFO";
 export * from "./TIME_GROUPING_PROPERTY_LABEL";
+export * from "./INTL_DATE_FORMATS";

package/dist/dates/constants/index.js

@@ -42,3 +42,4 @@ export * from "./ISO_8601_REGEX";
 export * from "./TIME_GROUPING_PROPERTY_INFO_LIST";
 export * from "./TIME_GROUPING_PROPERTY_INFO";
 export * from "./TIME_GROUPING_PROPERTY_LABEL";
+export * from "./INTL_DATE_FORMATS";

package/dist/dates/relative/RelativeStatementAdapter.d.ts

@@ -1,7 +1,7 @@
 import { AbsoluteStatement } from "./interfaces/AbsoluteStatement";
 import { RelativeInput } from "./interfaces/RelativeInput";
 import { RelativeToAbsoluteStruct } from "./interfaces/RelativeToAbsoluteStruct";
-export default class RelativeStatementAdapter {
+export declare class RelativeStatementAdapter {
     statement: RelativeInput;
     now: Date;
     constructor(statement: RelativeInput, now?: Date);

package/dist/dates/relative/RelativeStatementAdapter.js

@@ -6,7 +6,7 @@ import { getStatementCase } from "./helpers/getStatementCase";
 import { DATE_GROUPING_PROPERTY } from "../constants/DATE_GROUPING_PROPERTY";
 import { parseDate } from "./helpers/parseDate";
 import { DATETIME_FORMAT } from "./constants/DATE_FORMATS";
-export default class RelativeStatementAdapter {
+export class RelativeStatementAdapter {
     constructor(statement, now = new Date()) {
         this.statement =
             typeof statement === "string" ? statement : formatStatement(statement);

package/dist/dates/relative/relative.d.ts

@@ -14,9 +14,8 @@ import { RelativeStatement } from "./interfaces/RelativeStatement";
  *
  * Output:
  * { gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
- *
- * @param {RelativeStatement[]|string[]} statements - Raw statements/values
- * @param {Date} clock - Clock/time reference for relative date resolution
- * @returns {AbsoluteRange[]|string[]}
+ * @param statements - Raw statements/values
+ * @param clock - Clock/time reference for relative date resolution
+ * @returns
  */
 export declare function resolveRelative(statements: RelativeStatement[], clock?: Date): (string | import("./interfaces").AbsoluteStatement)[];

package/dist/dates/relative/relative.js

@@ -1,4 +1,4 @@
-import RelativeStatementAdapter from "./RelativeStatementAdapter";
+import { RelativeStatementAdapter } from "./RelativeStatementAdapter";
 /**
  * Resolve a list of relative statements according to operator
  * @example
@@ -14,10 +14,9 @@ import RelativeStatementAdapter from "./RelativeStatementAdapter";
  *
  * Output:
  * { gte: "03/06/2021 00:00:00", lte: "03/05/2022 23:59:59" }
- *
- * @param {RelativeStatement[]|string[]} statements - Raw statements/values
- * @param {Date} clock - Clock/time reference for relative date resolution
- * @returns {AbsoluteRange[]|string[]}
+ * @param statements - Raw statements/values
+ * @param clock - Clock/time reference for relative date resolution
+ * @returns
  */
 export function resolveRelative(statements, clock = new Date()) {
     return statements.map((s) => new RelativeStatementAdapter(s, clock).value());

package/dist/filters/constants/common/FILTER_SCOPE.d.ts

@@ -1,10 +1,10 @@
 export declare enum FILTER_SCOPE {
-    ADMIN = "ADMIN",
-    DATA = "DATA",
-    GLOBAL = "GLOBAL",
-    PAGE = "PAGE",
-    TAB = "TAB",
-    DEFAULT = "DEFAULT",
-    CHART = "CHART",
+    ADMIN = "ADMIN",// Admin filters (TBD)
+    DATA = "DATA",// User Management Filters a.k.a. Super Filters
+    GLOBAL = "GLOBAL",// Analyze Filters | Filters for all pages on PB/EU
+    PAGE = "PAGE",// PB/EU Filters for a single page
+    TAB = "TAB",// PB/EU Filters for a single tab
+    DEFAULT = "DEFAULT",// Filters created on Chart Builder
+    CHART = "CHART",// PB/EU Filters for panels inside a page/tab
     ACTION = "ACTION"
 }

package/dist/filters/services/Filters.api.js

@@ -7,8 +7,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import UChartPaginationApi from "./UChartPaginationApi";
-import UChartApi from "./UChartApi";
+import { UChartPaginationApi } from "./UChartPaginationApi";
+import { UChartApi } from "./UChartApi";
 import { isRangeValidator } from "../helpers/common/isRangeValidator";
 import { getFiltersByVisibility } from "../helpers/common/getFiltersByVisibility";
 import { excludeFiltersByAggregateColumn } from "../helpers/common/excludeFiltersByAggregateColumn";

package/dist/filters/services/UChartApi.d.ts

@@ -3,7 +3,7 @@ import { IFilterConfig } from "../interfaces/common/IFilterConfig";
 import { IFUFlattenedFilter } from "../interfaces/ui/IFUFlattenedFilter";
 import { IFBLogic } from "../interfaces/backend/IFBLogic";
 import { IFUChartSettings } from "../interfaces/ui/IFUChartSettings";
-export default class UChartApi {
+export declare class UChartApi {
     /**
      * Gets a promise with a resulting data
      * @param config the config