@stats-organization/github-readme-stats-core 2.1.3 → 2.1.5

package/build/common/Card.js

@@ -1,36 +1,44 @@
-// @ts-check
+import { isPrefixedHexColor, isValidGradient } from "./color.js";
 import { encodeHTML } from "./html.js";
 import { flexLayout } from "./render.js";
 class Card {
+    width;
+    height;
+    hideBorder;
+    hideTitle;
+    border_radius;
+    colors;
+    title;
+    css;
+    paddingX;
+    paddingY;
+    titlePrefixIcon;
+    animations;
+    a11yTitle;
+    a11yDesc;
     /**
      * Creates a new card instance.
      *
-     * @param {object} args Card arguments.
-     * @param {number=} args.width Card width.
-     * @param {number=} args.height Card height.
-     * @param {number=} args.border_radius Card border radius.
-     * @param {string=} args.customTitle Card custom title.
-     * @param {string=} args.defaultTitle Card default title.
-     * @param {string=} args.titlePrefixIcon Card title prefix icon.
-     * @param {object} [args.colors={}] Card colors arguments.
-     * @param {string=} args.colors.titleColor Card title color.
-     * @param {string=} args.colors.textColor Card text color.
-     * @param {string=} args.colors.iconColor Card icon color.
-     * @param {string|string[]=} args.colors.bgColor Card background color.
-     * @param {string=} args.colors.borderColor Card border color.
+     * The caller must ensure that the passed `titlePrefixIcon` is properly sanitized!
+     *
+     * @param props Card arguments.
+     * @param props.width Card width.
+     * @param props.height Card height.
+     * @param props.border_radius Card border radius.
+     * @param props.colors Card colors arguments.
+     * @param props.customTitle Card custom title.
+     * @param props.defaultTitle Card default title.
+     * @param props.titlePrefixIcon Sanitized card title prefix icon.
      */
     constructor({ width = 100, height = 100, border_radius = 4.5, colors = {}, customTitle, defaultTitle = "", titlePrefixIcon, }) {
         this.width = width;
         this.height = height;
         this.hideBorder = false;
         this.hideTitle = false;
-        this.border_radius = border_radius;
+        this.border_radius = parseFloat(String(border_radius));
         // returns theme based colors with proper overrides and defaults
         this.colors = colors;
-        this.title =
-            customTitle === undefined
-                ? encodeHTML(defaultTitle)
-                : encodeHTML(customTitle);
+        this.title = customTitle === undefined ? defaultTitle : customTitle;
         this.css = "";
         this.paddingX = 25;
         this.paddingY = 35;
@@ -39,55 +47,52 @@ class Card {
         this.a11yTitle = "";
         this.a11yDesc = "";
     }
-    /**
-     * @returns {void}
-     */
     disableAnimations() {
         this.animations = false;
     }
     /**
-     * @param {Object} props The props object.
-     * @param {string} props.title Accessibility title.
-     * @param {string} props.desc Accessibility description.
-     * @returns {void}
+     * @param props The props object.
+     * @param props.title Accessibility title.
+     * @param props.desc Accessibility description.
      */
-    setAccessibilityLabel({ title, desc }) {
+    setAccessibilityLabel({ title, desc, }) {
         this.a11yTitle = title;
         this.a11yDesc = desc;
     }
     /**
-     * @param {string} value The CSS to add to the card.
-     * @returns {void}
+     * The caller must ensure that the passed `css` string is properly sanitized!
+     *
+     * @param value The sanitized CSS to add to the card.
      */
     setCSS(value) {
         this.css = value;
     }
     /**
-     * @param {boolean} value Whether to hide the border or not.
-     * @returns {void}
+     * @param value Whether to hide the border or not.
      */
     setHideBorder(value) {
         this.hideBorder = value;
     }
     /**
-     * @param {boolean} value Whether to hide the title or not.
-     * @returns {void}
+     * @param value Whether to hide the title or not.
      */
     setHideTitle(value) {
-        this.hideTitle = value;
-        if (value) {
+        if (value && !this.hideTitle) {
             this.height -= 30;
         }
+        if (!value && this.hideTitle) {
+            this.height += 30;
+        }
+        this.hideTitle = value;
     }
     /**
-     * @param {string} text The title to set.
-     * @returns {void}
+     * @param text The title to set.
      */
     setTitle(text) {
         this.title = text;
     }
     /**
-     * @returns {string} The rendered card title.
+     * @returns The rendered card title.
      */
     renderTitle() {
         const titleText = `
@@ -96,7 +101,7 @@ class Card {
         y="0"
         class="header"
         data-testid="header"
-      >${this.title}</text>
+      >${encodeHTML(this.title)}</text>
     `;
         const prefixIcon = `
       <svg
@@ -108,7 +113,7 @@ class Card {
         width="16"
         height="16"
       >
-        ${this.titlePrefixIcon}
+        ${String(this.titlePrefixIcon)}
       </svg>
     `;
         return `
@@ -124,34 +129,37 @@ class Card {
     `;
     }
     /**
-     * @returns {string} The rendered card gradient.
+     * @returns The rendered card gradient.
      */
     renderGradient() {
         if (typeof this.colors.bgColor !== "object") {
             return "";
         }
+        if (!isValidGradient(this.colors.bgColor)) {
+            throw new Error(`Invalid gradient: ${this.colors.bgColor.join(",")}`);
+        }
         const gradients = this.colors.bgColor.slice(1);
-        return typeof this.colors.bgColor === "object"
-            ? `
+        return `
         <defs>
           <linearGradient
             id="gradient"
-            gradientTransform="rotate(${this.colors.bgColor[0]})"
+            gradientTransform="rotate(${String(this.colors.bgColor[0])})"
             gradientUnits="userSpaceOnUse"
           >
-            ${gradients.map((grad, index) => {
-                let offset = (index * 100) / (gradients.length - 1);
-                return `<stop offset="${offset}%" stop-color="#${grad}" />`;
-            })}
+            ${gradients
+            .map((grad, index) => {
+            const offset = (index * 100) / (gradients.length - 1);
+            return `<stop offset="${offset}%" stop-color="#${grad}" />`;
+        })
+            .join(",")}
           </linearGradient>
         </defs>
-        `
-            : "";
+        `;
     }
     /**
      * Retrieves css animations for a card.
      *
-     * @returns {string} Animation css.
+     * @returns Animation css.
      */
     getAnimations = () => {
         return `
@@ -175,10 +183,29 @@ class Card {
     `;
     };
     /**
-     * @param {string} body The inner body of the card.
-     * @returns {string} The rendered card.
+     * The caller must ensure that the passed `body` string is properly sanitized!
+     *
+     * @param body The sanitized inner body of the card.
+     * @returns The rendered card.
      */
     render(body) {
+        if (!Number.isFinite(this.border_radius)) {
+            throw new Error(`Invalid border radius: "${this.border_radius}"`);
+        }
+        if (this.colors.titleColor !== undefined &&
+            !isPrefixedHexColor(this.colors.titleColor)) {
+            throw new Error(`Invalid title color: "${this.colors.titleColor}"`);
+        }
+        if (this.colors.borderColor !== undefined &&
+            !isPrefixedHexColor(this.colors.borderColor)) {
+            throw new Error(`Invalid border color: "${this.colors.borderColor}"`);
+        }
+        if (this.colors.bgColor !== undefined &&
+            !(typeof this.colors.bgColor === "object"
+                ? isValidGradient(this.colors.bgColor)
+                : isPrefixedHexColor(this.colors.bgColor))) {
+            throw new Error(`Invalid background color: ${String(this.colors.bgColor)}`);
+        }
         return `
       <svg
         width="${this.width}"
@@ -189,12 +216,12 @@ class Card {
         role="img"
         aria-labelledby="descId"
       >
-        <title id="titleId">${this.a11yTitle}</title>
-        <desc id="descId">${this.a11yDesc}</desc>
+        <title id="titleId">${encodeHTML(this.a11yTitle)}</title>
+        <desc id="descId">${encodeHTML(this.a11yDesc)}</desc>
         <style>
           .header {
             font: 600 18px 'Segoe UI', Ubuntu, Sans-Serif;
-            fill: ${this.colors.titleColor};
+            fill: ${String(this.colors.titleColor)};
             animation: fadeInAnimation 0.8s ease-in-out forwards;
           }
           @supports(-moz-appearance: auto) {
@@ -204,9 +231,9 @@ class Card {
           ${this.css}
 
           ${this.getAnimations()}
-          ${this.animations === false
-            ? `* { animation-duration: 0s !important; animation-delay: 0s !important; }`
-            : ""}
+          ${this.animations
+            ? ""
+            : `* { animation-duration: 0s !important; animation-delay: 0s !important; }`}
         </style>
 
         ${this.renderGradient()}
@@ -217,11 +244,11 @@ class Card {
           y="0.5"
           rx="${this.border_radius}"
           height="99%"
-          stroke="${this.colors.borderColor}"
+          stroke="${String(this.colors.borderColor)}"
           width="${this.width - 1}"
           fill="${typeof this.colors.bgColor === "object"
             ? "url(#gradient)"
-            : this.colors.bgColor}"
+            : String(this.colors.bgColor)}"
           stroke-opacity="${this.hideBorder ? 0 : 1}"
         />
 

package/build/common/I18n.d.ts

@@ -1,26 +1,25 @@
 /**
  * I18n translation class.
  */
-export class I18n {
+declare class I18n<Translations extends Record<string, Record<string, string>>> {
+    locale: string;
+    translations: Translations;
     /**
-     * Constructor.
-     *
-     * @param {Object} options Options.
-     * @param {string=} options.locale Locale.
-     * @param {any} options.translations Translations.
+     * @param props Constructor arguments.
+     * @param props.locale Locale.
+     * @param props.translations Translations.
      */
-    constructor({ locale, translations }: {
-        locale?: string | undefined;
-        translations: any;
+    constructor({ locale, translations, }: {
+        locale?: string;
+        translations: Translations;
     });
-    locale: string;
-    translations: any;
     /**
      * Get translation.
      *
-     * @param {string} str String to translate.
-     * @returns {string} Translated string.
+     * @param str String to translate.
+     * @returns Translated string.
      */
-    t(str: string): string;
+    t(str: keyof Translations & string): string;
 }
+export { I18n };
 //# sourceMappingURL=I18n.d.ts.map

package/build/common/I18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"I18n.d.ts","sourceRoot":"","sources":["../../src/common/I18n.js"],"names":[],"mappings":"AAIA;;GAEG;AACH;IACE;;;;;;OAMG;IACH,sCAHG;QAAyB,MAAM,GAAvB,MAAM,YAAC;QACM,YAAY,EAAzB,GAAG;KACb,EAIA;IAFC,eAAuC;IACvC,kBAAgC;IAGlC;;;;;OAKG;IACH,OAHW,MAAM,GACJ,MAAM,CAclB;CACF"}
+{"version":3,"file":"I18n.d.ts","sourceRoot":"","sources":["../../src/common/I18n.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,cAAM,IAAI,CAAC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpE,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;OAIG;gBACS,EACV,MAAM,EACN,YAAY,GACb,EAAE;QACD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,YAAY,CAAC;KAC5B;IAKD;;;;;OAKG;IACH,CAAC,CAAC,GAAG,EAAE,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM;CAe5C;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/build/common/I18n.js

@@ -1,34 +1,35 @@
-// @ts-check
 const FALLBACK_LOCALE = "en";
 /**
  * I18n translation class.
  */
 class I18n {
+    locale;
+    translations;
     /**
-     * Constructor.
-     *
-     * @param {Object} options Options.
-     * @param {string=} options.locale Locale.
-     * @param {any} options.translations Translations.
+     * @param props Constructor arguments.
+     * @param props.locale Locale.
+     * @param props.translations Translations.
      */
-    constructor({ locale, translations }) {
+    constructor({ locale, translations, }) {
         this.locale = locale || FALLBACK_LOCALE;
         this.translations = translations;
     }
     /**
      * Get translation.
      *
-     * @param {string} str String to translate.
-     * @returns {string} Translated string.
+     * @param str String to translate.
+     * @returns Translated string.
      */
     t(str) {
-        if (!this.translations[str]) {
+        const translation = this.translations[str];
+        if (!translation) {
             throw new Error(`${str} Translation string not found`);
         }
-        if (!this.translations[str][this.locale]) {
+        const localized = translation[this.locale];
+        if (!localized) {
             throw new Error(`'${str}' translation not found for locale '${this.locale}'`);
         }
-        return this.translations[str][this.locale];
+        return localized;
     }
 }
 export { I18n };

package/build/common/color.d.ts

@@ -1,47 +1,70 @@
 /**
- * Object containing card colors.
+ * Checks if a value is a bare hex color, i.e. hex digits with no `#` prefix
+ * (`"f00"`, `"ffffff"`). This is the form user-supplied color params and
+ * gradient stops arrive in.
+ *
+ * @param value Value to check.
+ * @returns True if the value is a bare hex color.
  */
-export type CardColors = {
-    titleColor: string;
-    iconColor: string;
-    textColor: string;
-    bgColor: string | string[];
-    borderColor: string;
-    ringColor: string;
-};
+declare const isBareHexColor: (value: unknown) => boolean;
+/**
+ * Checks if a value is a `#`-prefixed hex color (`"#f00"`, `"#ffffff"`). This
+ * is the form colors take once resolved by {@link getCardColors}, i.e. right
+ * before they are written into the SVG.
+ *
+ * @param value Value to check.
+ * @returns True if the value is a `#`-prefixed hex color.
+ */
+declare const isPrefixedHexColor: (value: unknown) => boolean;
+/**
+ * Checks if the given parts form a valid gradient: a finite numeric angle
+ * followed by at least two bare-hex color stops, e.g. `["90", "f00", "0f0"]`.
+ * The angle is written into the SVG `gradientTransform="rotate(...)"`.
+ *
+ * @param parts Gradient parts: `[angle, ...stops]`.
+ * @returns True if the parts form a valid gradient.
+ */
+declare const isValidGradient: (parts: Array<string>) => boolean;
+/**
+ * Iterates over a collection of colors inputs and verifies that each is a valid color or gradient.
+ *
+ * @param colors Object whose values are checked as valid color inputs.
+ * @return The first key where the associated input value is not valid. null if all inputs are valid.
+ */
+declare const findInvalidColor: (colors: Record<string, string | null | undefined>) => string | null;
 /**
  * Retrieves a gradient if color has more than one valid hex codes else a single color.
  *
- * @param {string} color The color to parse.
- * @param {string | string[]} fallbackColor The fallback color.
- * @returns {string | string[]} The gradient or color.
+ * @param color The color to parse.
+ * @param fallbackColor The fallback color.
+ * @returns The gradient or color.
  */
-export function fallbackColor(color: string, fallbackColor: string | string[]): string | string[];
+declare const fallbackColor: (color: string | undefined, fallbackColor: string | Array<string>) => string | Array<string>;
 /**
  * Object containing card colors.
- * @typedef {{
- *  titleColor: string;
- *  iconColor: string;
- *  textColor: string;
- *  bgColor: string | string[];
- *  borderColor: string;
- *  ringColor: string;
- * }} CardColors
  */
+interface CardColors {
+    titleColor: string;
+    iconColor: string;
+    textColor: string;
+    bgColor: string | Array<string>;
+    borderColor: string;
+    ringColor: string;
+}
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
- * @param {Object} args Function arguments.
- * @param {string=} args.title_color Card title color.
- * @param {string=} args.text_color Card text color.
- * @param {string=} args.icon_color Card icon color.
- * @param {string=} args.bg_color Card background color.
- * @param {string=} args.border_color Card border color.
- * @param {string=} args.ring_color Card ring color.
- * @param {string=} args.theme Card theme.
- * @returns {CardColors} Card colors.
+ * @param props Function arguments.
+ * @param props.title_color Card title color.
+ * @param props.text_color Card text color.
+ * @param props.icon_color Card icon color.
+ * @param props.bg_color Card background color.
+ * @param props.border_color Card border color.
+ * @param props.ring_color Card ring color.
+ * @param props.theme Card theme.
+ * @returns Card colors.
  */
-export function getCardColors({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }: {
+declare const getCardColors: ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }: {
     title_color?: string | undefined;
     text_color?: string | undefined;
     icon_color?: string | undefined;
@@ -49,5 +72,6 @@ export function getCardColors({ title_color, text_color, icon_color, bg_color, b
     border_color?: string | undefined;
     ring_color?: string | undefined;
     theme?: string | undefined;
-}): CardColors;
+}) => CardColors;
+export { fallbackColor, getCardColors, findInvalidColor, isValidGradient, isBareHexColor, isPrefixedHexColor, };
 //# sourceMappingURL=color.d.ts.map

package/build/common/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/common/color.js"],"names":[],"mappings":";;;yBAoDa;IACT,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CAClB;AA9BJ;;;;;;GAMG;AACH,qCAJW,MAAM,iBACN,MAAM,GAAG,MAAM,EAAE,GACf,MAAM,GAAG,MAAM,EAAE,CAc7B;AAED;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;GAYG;AACH,mHATG;IAAsB,WAAW,GAAzB,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,QAAQ,GAAtB,MAAM,YAAC;IACO,YAAY,GAA1B,MAAM,YAAC;IACO,UAAU,GAAxB,MAAM,YAAC;IACO,KAAK,GAAnB,MAAM,YAAC;CACf,GAAU,UAAU,CAqEtB"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/common/color.ts"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,QAAA,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAExC,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,OAM5C,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,eAAe,GAAI,OAAO,KAAK,CAAC,MAAM,CAAC,KAAG,OAS/C,CAAC;AAeF;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,GACpB,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,KAChD,MAAM,GAAG,IAOX,CAAC;AAEF;;;;;;GAMG;AACH,QAAA,MAAM,aAAa,GACjB,OAAO,MAAM,GAAG,SAAS,EACzB,eAAe,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KACpC,MAAM,GAAG,KAAK,CAAC,MAAM,CAWvB,CAAC;AAEF;;GAEG;AACH,UAAU,UAAU;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,aAAa,GAAI,qFAQpB;IACD,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,KAAG,UAuDH,CAAC;AAEF,OAAO,EACL,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,kBAAkB,GACnB,CAAC"}

package/build/common/color.js

@@ -1,81 +1,118 @@
-// @ts-check
 import { themes } from "../themes/index.js";
+/** Matches a 3-, 4-, 6-, or 8-digit hex color with no leading `#`. */
+const HEX_COLOR = /^([A-Fa-f0-9]{8}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{4}|[A-Fa-f0-9]{3})$/;
 /**
- * Checks if a string is a valid hex color.
+ * Checks if a value is a bare hex color, i.e. hex digits with no `#` prefix
+ * (`"f00"`, `"ffffff"`). This is the form user-supplied color params and
+ * gradient stops arrive in.
  *
- * @param {string} hexColor String to check.
- * @returns {boolean} True if the given string is a valid hex color.
+ * @param value Value to check.
+ * @returns True if the value is a bare hex color.
  */
-const isValidHexColor = (hexColor) => {
-    return new RegExp(/^([A-Fa-f0-9]{8}|[A-Fa-f0-9]{6}|[A-Fa-f0-9]{3}|[A-Fa-f0-9]{4})$/).test(hexColor);
+const isBareHexColor = (value) => {
+    return typeof value === "string" && HEX_COLOR.test(value);
 };
 /**
- * Check if the given string is a valid gradient.
+ * Checks if a value is a `#`-prefixed hex color (`"#f00"`, `"#ffffff"`). This
+ * is the form colors take once resolved by {@link getCardColors}, i.e. right
+ * before they are written into the SVG.
  *
- * @param {string[]} colors Array of colors.
- * @returns {boolean} True if the given string is a valid gradient.
+ * @param value Value to check.
+ * @returns True if the value is a `#`-prefixed hex color.
  */
-const isValidGradient = (colors) => {
-    return (colors.length > 2 &&
-        colors.slice(1).every((color) => isValidHexColor(color)));
+const isPrefixedHexColor = (value) => {
+    return (typeof value === "string" &&
+        value.startsWith("#") &&
+        HEX_COLOR.test(value.slice(1)));
+};
+/**
+ * Checks if the given parts form a valid gradient: a finite numeric angle
+ * followed by at least two bare-hex color stops, e.g. `["90", "f00", "0f0"]`.
+ * The angle is written into the SVG `gradientTransform="rotate(...)"`.
+ *
+ * @param parts Gradient parts: `[angle, ...stops]`.
+ * @returns True if the parts form a valid gradient.
+ */
+const isValidGradient = (parts) => {
+    const [angle, ...stops] = parts;
+    return (stops.length >= 2 &&
+        angle !== undefined &&
+        angle.trim() !== "" &&
+        Number.isFinite(Number(angle)) &&
+        stops.every(isBareHexColor));
+};
+/**
+ * Checks if a string is a valid input for a color or gradient.
+ *
+ * @param color String to check, may be null or undefined.
+ * @returns True if the given string is a valid input.
+ */
+const isValidColorInput = (color) => {
+    if (color === null || color === undefined) {
+        return true;
+    }
+    return isValidGradient(color.split(",")) || isBareHexColor(color);
+};
+/**
+ * Iterates over a collection of colors inputs and verifies that each is a valid color or gradient.
+ *
+ * @param colors Object whose values are checked as valid color inputs.
+ * @return The first key where the associated input value is not valid. null if all inputs are valid.
+ */
+const findInvalidColor = (colors) => {
+    for (const [key, value] of Object.entries(colors)) {
+        if (!isValidColorInput(value)) {
+            return key;
+        }
+    }
+    return null;
 };
 /**
  * Retrieves a gradient if color has more than one valid hex codes else a single color.
  *
- * @param {string} color The color to parse.
- * @param {string | string[]} fallbackColor The fallback color.
- * @returns {string | string[]} The gradient or color.
+ * @param color The color to parse.
+ * @param fallbackColor The fallback color.
+ * @returns The gradient or color.
  */
 const fallbackColor = (color, fallbackColor) => {
-    let gradient = null;
-    let colors = color ? color.split(",") : [];
+    const colors = color ? color.split(",") : [];
     if (colors.length > 1 && isValidGradient(colors)) {
-        gradient = colors;
+        return colors;
+    }
+    if (color !== undefined && isBareHexColor(color)) {
+        return `#${color}`;
     }
-    return ((gradient ? gradient : isValidHexColor(color) && `#${color}`) ||
-        fallbackColor);
+    return fallbackColor;
 };
-/**
- * Object containing card colors.
- * @typedef {{
- *  titleColor: string;
- *  iconColor: string;
- *  textColor: string;
- *  bgColor: string | string[];
- *  borderColor: string;
- *  ringColor: string;
- * }} CardColors
- */
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
- * @param {Object} args Function arguments.
- * @param {string=} args.title_color Card title color.
- * @param {string=} args.text_color Card text color.
- * @param {string=} args.icon_color Card icon color.
- * @param {string=} args.bg_color Card background color.
- * @param {string=} args.border_color Card border color.
- * @param {string=} args.ring_color Card ring color.
- * @param {string=} args.theme Card theme.
- * @returns {CardColors} Card colors.
+ * @param props Function arguments.
+ * @param props.title_color Card title color.
+ * @param props.text_color Card text color.
+ * @param props.icon_color Card icon color.
+ * @param props.bg_color Card background color.
+ * @param props.border_color Card border color.
+ * @param props.ring_color Card ring color.
+ * @param props.theme Card theme.
+ * @returns Card colors.
  */
 const getCardColors = ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, theme, }) => {
-    const defaultTheme = themes["default"];
-    const isThemeProvided = theme !== null && theme !== undefined && theme in themes;
-    // @ts-ignore
-    const selectedTheme = isThemeProvided ? themes[theme] : defaultTheme;
+    const defaultTheme = themes.default;
+    const isThemeProvided = theme !== undefined && theme in themes;
+    const selectedTheme = isThemeProvided
+        ? themes[theme]
+        : defaultTheme;
     const defaultBorderColor = "border_color" in selectedTheme
         ? selectedTheme.border_color
-        : // @ts-ignore
-            defaultTheme.border_color;
+        : defaultTheme.border_color;
     // get the color provided by the user else the theme color
     // finally if both colors are invalid fallback to default theme
     const titleColor = fallbackColor(title_color || selectedTheme.title_color, "#" + defaultTheme.title_color);
     // get the color provided by the user else the theme color
     // finally if both colors are invalid we use the titleColor
-    const ringColor = fallbackColor(
-    // @ts-ignore
-    ring_color || selectedTheme.ring_color, titleColor);
+    // NOTE: no built-in theme defines `ring_color`, so it falls back to the title color.
+    const ringColor = fallbackColor(ring_color, titleColor);
     const iconColor = fallbackColor(icon_color || selectedTheme.icon_color, "#" + defaultTheme.icon_color);
     const textColor = fallbackColor(text_color || selectedTheme.text_color, "#" + defaultTheme.text_color);
     const bgColor = fallbackColor(bg_color || selectedTheme.bg_color, "#" + defaultTheme.bg_color);
@@ -89,4 +126,4 @@ const getCardColors = ({ title_color, text_color, icon_color, bg_color, border_c
     }
     return { titleColor, iconColor, textColor, bgColor, borderColor, ringColor };
 };
-export { fallbackColor, getCardColors };
+export { fallbackColor, getCardColors, findInvalidColor, isValidGradient, isBareHexColor, isPrefixedHexColor, };