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

package/build/common/Card.js

@@ -1,4 +1,4 @@
-import { isPrefixedHexColor, isValidGradient } from "./color.js";
+import { getCardColors, isPrefixedHexColor, isValidGradient } from "./color.js";
 import { encodeHTML } from "./html.js";
 import { flexLayout } from "./render.js";
 class Card {
@@ -10,6 +10,7 @@ class Card {
     colors;
     title;
     css;
+    darkCss;
     paddingX;
     paddingY;
     titlePrefixIcon;
@@ -25,21 +26,23 @@ class Card {
      * @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.colors Card colors for light and dark mode.
+     * @param props.colors.light Card colors for light mode.
+     * @param props.colors.dark Card colors for dark mode, or `null` when no dark-mode override is needed.
      * @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, }) {
+    constructor({ width = 100, height = 100, border_radius = 4.5, colors = { light: getCardColors({}), dark: null }, customTitle, defaultTitle = "", titlePrefixIcon, }) {
         this.width = width;
         this.height = height;
         this.hideBorder = false;
         this.hideTitle = false;
         this.border_radius = parseFloat(String(border_radius));
-        // returns theme based colors with proper overrides and defaults
         this.colors = colors;
         this.title = customTitle === undefined ? defaultTitle : customTitle;
         this.css = "";
+        this.darkCss = "";
         this.paddingX = 25;
         this.paddingY = 35;
         this.titlePrefixIcon = titlePrefixIcon;
@@ -60,12 +63,17 @@ class Card {
         this.a11yDesc = desc;
     }
     /**
-     * The caller must ensure that the passed `css` string is properly sanitized!
+     * Sets the card CSS for light and dark mode.
      *
-     * @param value The sanitized CSS to add to the card.
+     * The caller must ensure that the passed CSS strings are properly sanitized!
+     *
+     * @param props The props object.
+     * @param props.light CSS applied unconditionally (light/default mode).
+     * @param props.dark CSS placed inside a `@media (prefers-color-scheme: dark)` block. Pass `null` when not needed.
      */
-    setCSS(value) {
-        this.css = value;
+    setCSS({ light, dark }) {
+        this.css = light;
+        this.darkCss = dark ?? "";
     }
     /**
      * @param value Whether to hide the border or not.
@@ -132,27 +140,35 @@ class Card {
      * @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 `
-        <defs>
+        const buildGradientDef = (id, bgColor) => {
+            const gradients = bgColor.slice(1);
+            return `
           <linearGradient
-            id="gradient"
-            gradientTransform="rotate(${String(this.colors.bgColor[0])})"
+            id="${id}"
+            gradientTransform="rotate(${String(bgColor[0])})"
             gradientUnits="userSpaceOnUse"
           >
             ${gradients
-            .map((grad, index) => {
-            const offset = (index * 100) / (gradients.length - 1);
-            return `<stop offset="${offset}%" stop-color="#${grad}" />`;
-        })
-            .join(",")}
-          </linearGradient>
+                .map((grad, index) => {
+                const offset = (index * 100) / (gradients.length - 1);
+                return `<stop offset="${offset}%" stop-color="#${grad}" />`;
+            })
+                .join(",")}
+          </linearGradient>`;
+        };
+        if (typeof this.colors.light.bgColor === "object" &&
+            !isValidGradient(this.colors.light.bgColor)) {
+            throw new Error(`Invalid gradient: ${this.colors.light.bgColor.join(",")}`);
+        }
+        if (this.colors.dark &&
+            typeof this.colors.dark.bgColor === "object" &&
+            !isValidGradient(this.colors.dark.bgColor)) {
+            throw new Error(`Invalid dark gradient: ${this.colors.dark.bgColor.join(",")}`);
+        }
+        return `
+        <defs>
+          ${typeof this.colors.light.bgColor === "object" ? buildGradientDef("gradient", this.colors.light.bgColor) : ""}
+          ${this.colors.dark && typeof this.colors.dark.bgColor === "object" ? buildGradientDef("gradient-dark", this.colors.dark.bgColor) : ""}
         </defs>
         `;
     }
@@ -182,6 +198,24 @@ class Card {
       }
     `;
     };
+    /**
+     * Builds the @media (prefers-color-scheme: dark) CSS block for the card.
+     * Returns an empty string when no dark colors are set.
+     */
+    renderDarkMediaBlock() {
+        if (!this.colors.dark) {
+            return "";
+        }
+        const bgFill = typeof this.colors.dark.bgColor === "object"
+            ? "url(#gradient-dark)"
+            : this.colors.dark.bgColor;
+        return `
+          @media (prefers-color-scheme: dark) {
+            .header { fill: ${this.colors.dark.titleColor}; }
+            .card-bg { fill: ${bgFill}; stroke: ${this.colors.dark.borderColor}; }
+            ${this.darkCss}
+          }`;
+    }
     /**
      * The caller must ensure that the passed `body` string is properly sanitized!
      *
@@ -192,19 +226,16 @@ class Card {
         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 (!isPrefixedHexColor(this.colors.light.titleColor)) {
+            throw new Error(`Invalid title color: "${this.colors.light.titleColor}"`);
         }
-        if (this.colors.borderColor !== undefined &&
-            !isPrefixedHexColor(this.colors.borderColor)) {
-            throw new Error(`Invalid border color: "${this.colors.borderColor}"`);
+        if (!isPrefixedHexColor(this.colors.light.borderColor)) {
+            throw new Error(`Invalid border color: "${this.colors.light.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)}`);
+        if (!(typeof this.colors.light.bgColor === "object"
+            ? isValidGradient(this.colors.light.bgColor)
+            : isPrefixedHexColor(this.colors.light.bgColor))) {
+            throw new Error(`Invalid background color: ${String(this.colors.light.bgColor)}`);
         }
         return `
       <svg
@@ -221,7 +252,7 @@ class Card {
         <style>
           .header {
             font: 600 18px 'Segoe UI', Ubuntu, Sans-Serif;
-            fill: ${String(this.colors.titleColor)};
+            fill: ${this.colors.light.titleColor};
             animation: fadeInAnimation 0.8s ease-in-out forwards;
           }
           @supports(-moz-appearance: auto) {
@@ -229,6 +260,7 @@ class Card {
             .header { font-size: 15.5px; }
           }
           ${this.css}
+          ${this.renderDarkMediaBlock()}
 
           ${this.getAnimations()}
           ${this.animations
@@ -240,15 +272,16 @@ class Card {
 
         <rect
           data-testid="card-bg"
+          class="card-bg"
           x="0.5"
           y="0.5"
           rx="${this.border_radius}"
           height="99%"
-          stroke="${String(this.colors.borderColor)}"
+          stroke="${this.colors.light.borderColor}"
           width="${this.width - 1}"
-          fill="${typeof this.colors.bgColor === "object"
+          fill="${typeof this.colors.light.bgColor === "object"
             ? "url(#gradient)"
-            : String(this.colors.bgColor)}"
+            : this.colors.light.bgColor}"
           stroke-opacity="${this.hideBorder ? 0 : 1}"
         />
 

package/build/common/I18n.d.ts

@@ -1,7 +1,9 @@
+/** A map of translation keys to per-locale strings. */
+type TranslationsMap = Record<string, Record<string, string>>;
 /**
  * I18n translation class.
  */
-declare class I18n<Translations extends Record<string, Record<string, string>>> {
+declare class I18n<Translations extends TranslationsMap = TranslationsMap> {
     locale: string;
     translations: Translations;
     /**
@@ -10,7 +12,7 @@ declare class I18n<Translations extends Record<string, Record<string, string>>>
      * @param props.translations Translations.
      */
     constructor({ locale, translations, }: {
-        locale?: string;
+        locale?: string | undefined;
         translations: Translations;
     });
     /**

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"I18n.d.ts","sourceRoot":"","sources":["../../src/common/I18n.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE9D;;GAEG;AACH,cAAM,IAAI,CAAC,YAAY,SAAS,eAAe,GAAG,eAAe;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;IAE3B;;;;OAIG;gBACS,EACV,MAAM,EACN,YAAY,GACb,EAAE;QAED,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC5B,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/color.d.ts

@@ -32,14 +32,6 @@ declare const isValidGradient: (parts: Array<string>) => boolean;
  * @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 color The color to parse.
- * @param fallbackColor The fallback color.
- * @returns The gradient or color.
- */
-declare const fallbackColor: (color: string | undefined, fallbackColor: string | Array<string>) => string | Array<string>;
 /**
  * Object containing card colors.
  */
@@ -50,7 +42,24 @@ interface CardColors {
     bgColor: string | Array<string>;
     borderColor: string;
     ringColor: string;
+    progBarBgColor: string;
 }
+/**
+ * Every color param a card accepts, before any `_light` / `_dark` suffix.
+ *
+ * Single source of truth: the param types and {@link COLOR_PARAM_KEYS} are all
+ * derived from this, so adding a param here is enough.
+ */
+declare const BASE_COLOR_KEYS: readonly ["title_color", "icon_color", "text_color", "bg_color", "border_color", "ring_color", "prog_bar_bg_color", "theme"];
+declare const THEME_VARIANTS: readonly ["light", "dark"];
+type BaseColorKey = (typeof BASE_COLOR_KEYS)[number];
+type ThemeVariant = (typeof THEME_VARIANTS)[number];
+/**
+ * Object with all input color params. Not every field is consumed by every card
+ * (e.g. `prog_bar_bg_color` is only used by the top-languages card's `normal`
+ * layout).
+ */
+type ColorInput = Partial<Record<BaseColorKey, string | undefined>>;
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
@@ -61,17 +70,50 @@ interface CardColors {
  * @param props.bg_color Card background color.
  * @param props.border_color Card border color.
  * @param props.ring_color Card ring color.
+ * @param props.prog_bar_bg_color Progress bar background color.
  * @param props.theme Card theme.
  * @returns Card colors.
  */
-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;
-    bg_color?: string | undefined;
-    border_color?: string | undefined;
-    ring_color?: string | undefined;
-    theme?: string | undefined;
-}) => CardColors;
-export { fallbackColor, getCardColors, findInvalidColor, isValidGradient, isBareHexColor, isPrefixedHexColor, };
+declare const getCardColors: ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, prog_bar_bg_color, theme, }: ColorInput) => CardColors;
+type LightDarkColorParams = Partial<Record<`${BaseColorKey}_${ThemeVariant}`, string | undefined>>;
+/**
+ * Returns resolved colors for both light and dark mode given all input params.
+ *
+ * Each mode resolves independently, then runs the normal `getCardColors` precedence
+ * (explicit color -> theme color -> default theme):
+ *   light: `theme_light ?? theme`, with `*_light` params overriding general ones
+ *   dark:  `theme_dark  ?? theme`, with `*_dark`  params overriding general ones
+ *
+ * Anything a mode does not override falls back to the general params,
+ * so a partial override such as `bg_color_dark` alone keeps every other color from the base theme.
+ *
+ * When no `_light` / `_dark` param is provided at all, `darkColors` is `null` and the caller emits no dark-mode block.
+ *
+ * @param params Raw query params, containing both general and `_light`/`_dark` suffixed colors and themes.
+ * @returns `{ lightColors, darkColors }`, resolved colors for both light and dark mode
+ */
+declare const getLightDarkColors: (params: ColorInput & LightDarkColorParams) => {
+    lightColors: CardColors;
+    darkColors: CardColors | null;
+};
+type ColorParams = ColorInput & LightDarkColorParams;
+declare const COLOR_PARAM_KEYS: ReadonlyArray<keyof ColorParams>;
+/**
+ * Picks all color-related parameters from a query object.
+ *
+ * @param query Raw query parameters.
+ * @returns All color-related parameters.
+ */
+declare const pickColorParams: (query: Record<string, string | undefined>) => ColorParams;
+/**
+ * Finds the first color param holding an invalid color.
+ *
+ * Theme params are skipped: they name a theme, and an unknown name falls back
+ * to the default rather than being an error.
+ *
+ * @param params Color params, as returned by {@link pickColorParams}.
+ * @returns The first invalid param name, or null if all are valid.
+ */
+declare const findInvalidColorParam: (params: ColorParams) => string | null;
+export { getCardColors, getLightDarkColors, findInvalidColor, findInvalidColorParam, pickColorParams, isValidGradient, isBareHexColor, isPrefixedHexColor, BASE_COLOR_KEYS, THEME_VARIANTS, COLOR_PARAM_KEYS, };
 //# 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.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"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/common/color.ts"],"names":[],"mappings":"AAOA;;;;;;;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;AAyBF;;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;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,QAAA,MAAM,eAAe,8HASX,CAAC;AAEX,QAAA,MAAM,cAAc,4BAA6B,CAAC;AAElD,KAAK,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,KAAK,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpD;;;;GAIG;AACH,KAAK,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,aAAa,GAAI,wGASpB,UAAU,KAAG,UAkEf,CAAC;AAEF,KAAK,oBAAoB,GAAG,OAAO,CACjC,MAAM,CAAC,GAAG,YAAY,IAAI,YAAY,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,CAC9D,CAAC;AAkBF;;;;;;;;;;;;;;;GAeG;AACH,QAAA,MAAM,kBAAkB,GACtB,QAAQ,UAAU,GAAG,oBAAoB,KACxC;IAAE,WAAW,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAA;CAmB1D,CAAC;AAEF,KAAK,WAAW,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAErD,QAAA,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,WAAW,CAKtD,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,eAAe,GACnB,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,KACxC,WAGA,CAAC;AAQJ;;;;;;;;GAQG;AACH,QAAA,MAAM,qBAAqB,GAAI,QAAQ,WAAW,KAAG,MAAM,GAAG,IAO3D,CAAC;AAEJ,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,EAIlB,eAAe,EACf,cAAc,EACd,gBAAgB,GACjB,CAAC"}

package/build/common/color.js

@@ -84,6 +84,23 @@ const fallbackColor = (color, fallbackColor) => {
     }
     return fallbackColor;
 };
+/**
+ * Every color param a card accepts, before any `_light` / `_dark` suffix.
+ *
+ * Single source of truth: the param types and {@link COLOR_PARAM_KEYS} are all
+ * derived from this, so adding a param here is enough.
+ */
+const BASE_COLOR_KEYS = [
+    "title_color",
+    "icon_color",
+    "text_color",
+    "bg_color",
+    "border_color",
+    "ring_color",
+    "prog_bar_bg_color",
+    "theme",
+];
+const THEME_VARIANTS = ["light", "dark"];
 /**
  * Returns theme based colors with proper overrides and defaults.
  *
@@ -94,10 +111,11 @@ const fallbackColor = (color, fallbackColor) => {
  * @param props.bg_color Card background color.
  * @param props.border_color Card border color.
  * @param props.ring_color Card ring color.
+ * @param props.prog_bar_bg_color Progress bar background 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 getCardColors = ({ title_color, text_color, icon_color, bg_color, border_color, ring_color, prog_bar_bg_color, theme, }) => {
     const defaultTheme = themes.default;
     const isThemeProvided = theme !== undefined && theme in themes;
     const selectedTheme = isThemeProvided
@@ -111,19 +129,98 @@ const getCardColors = ({ title_color, text_color, icon_color, bg_color, border_c
     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
-    // 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);
     const borderColor = fallbackColor(border_color || defaultBorderColor, "#" + defaultBorderColor);
+    // No theme defines `ring_color`, so it falls back to the title color.
+    const ringColor = fallbackColor(ring_color, titleColor);
+    // No theme defines `prog_bar_bg_color`, so it falls back to "#ddd".
+    const progBarBgColor = fallbackColor(prog_bar_bg_color, "#ddd");
     if (typeof titleColor !== "string" ||
         typeof textColor !== "string" ||
         typeof ringColor !== "string" ||
+        typeof progBarBgColor !== "string" ||
         typeof iconColor !== "string" ||
         typeof borderColor !== "string") {
         throw new Error("Unexpected behavior, all colors except background should be string.");
     }
-    return { titleColor, iconColor, textColor, bgColor, borderColor, ringColor };
+    return {
+        titleColor,
+        iconColor,
+        textColor,
+        bgColor,
+        borderColor,
+        ringColor,
+        progBarBgColor,
+    };
 };
-export { fallbackColor, getCardColors, findInvalidColor, isValidGradient, isBareHexColor, isPrefixedHexColor, };
+/**
+ * Returns the light- or dark-mode-specific color params, given a set of
+ * raw query params. Also removes the "_light" or "_dark" suffixes.
+ *
+ * @param params Raw query params with optional `_light` / `_dark` suffixes.
+ * @param suffix `"_light"` or `"_dark"`.
+ * @returns ColorInput with the suffix stripped, ready for `getCardColors`.
+ */
+const extractLightDarkColors = (params, suffix) => Object.fromEntries(BASE_COLOR_KEYS.map((key) => [key, params[`${key}${suffix}`]]));
+/**
+ * Returns resolved colors for both light and dark mode given all input params.
+ *
+ * Each mode resolves independently, then runs the normal `getCardColors` precedence
+ * (explicit color -> theme color -> default theme):
+ *   light: `theme_light ?? theme`, with `*_light` params overriding general ones
+ *   dark:  `theme_dark  ?? theme`, with `*_dark`  params overriding general ones
+ *
+ * Anything a mode does not override falls back to the general params,
+ * so a partial override such as `bg_color_dark` alone keeps every other color from the base theme.
+ *
+ * When no `_light` / `_dark` param is provided at all, `darkColors` is `null` and the caller emits no dark-mode block.
+ *
+ * @param params Raw query params, containing both general and `_light`/`_dark` suffixed colors and themes.
+ * @returns `{ lightColors, darkColors }`, resolved colors for both light and dark mode
+ */
+const getLightDarkColors = (params) => {
+    const lightOverrides = extractLightDarkColors(params, "_light");
+    const darkOverrides = extractLightDarkColors(params, "_dark");
+    const hasModeOverrides = Object.values(lightOverrides).some((v) => v !== undefined) ||
+        Object.values(darkOverrides).some((v) => v !== undefined);
+    if (!hasModeOverrides) {
+        return { lightColors: getCardColors(params), darkColors: null };
+    }
+    const defined = (obj) => Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+    return {
+        lightColors: getCardColors({ ...params, ...defined(lightOverrides) }),
+        darkColors: getCardColors({ ...params, ...defined(darkOverrides) }),
+    };
+};
+const COLOR_PARAM_KEYS = [
+    ...BASE_COLOR_KEYS,
+    ...THEME_VARIANTS.flatMap((variant) => BASE_COLOR_KEYS.map((key) => `${key}_${variant}`)),
+];
+/**
+ * Picks all color-related parameters from a query object.
+ *
+ * @param query Raw query parameters.
+ * @returns All color-related parameters.
+ */
+const pickColorParams = (query) => Object.fromEntries(COLOR_PARAM_KEYS.filter((k) => k in query).map((k) => [k, query[k]]));
+/** Params naming a theme rather than holding a color value. */
+const THEME_PARAM_KEYS = [
+    "theme",
+    ...THEME_VARIANTS.map((variant) => `theme_${variant}`),
+];
+/**
+ * Finds the first color param holding an invalid color.
+ *
+ * Theme params are skipped: they name a theme, and an unknown name falls back
+ * to the default rather than being an error.
+ *
+ * @param params Color params, as returned by {@link pickColorParams}.
+ * @returns The first invalid param name, or null if all are valid.
+ */
+const findInvalidColorParam = (params) => findInvalidColor(Object.fromEntries(Object.entries(params).filter(([key]) => !THEME_PARAM_KEYS.includes(key))));
+export { getCardColors, getLightDarkColors, findInvalidColor, findInvalidColorParam, pickColorParams, isValidGradient, isBareHexColor, isPrefixedHexColor, 
+// Not re-exported from the package index: internal,
+// exposed so tests can pin the accepted param list.
+BASE_COLOR_KEYS, THEME_VARIANTS, COLOR_PARAM_KEYS, };

package/build/common/config.d.ts

@@ -7,7 +7,8 @@ interface Config {
     whitelist: Array<string> | undefined;
     gistWhitelist: Array<string> | undefined;
     excludeRepositories: Array<string>;
-    fetchMultiPageStars: string | undefined;
+    /** Max pages of starred repos to fetch; `Infinity` means every page, `1` only the first. */
+    fetchMultiPageStars: number;
     pats: Array<PersonalAccessToken>;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,MAAM;IACd,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACrC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAkDD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAK,GAAqB,KAAG,IAY9D,CAAC;AAIF,eAAO,MAAM,SAAS,QAAO,MAAuB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/common/config.ts"],"names":[],"mappings":"AAAA,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAE9C,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,MAAM;IACd,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACrC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACzC,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnC,4FAA4F;IAC5F,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,KAAK,CAAC,mBAAmB,CAAC,CAAC;CAClC;AA4CD;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,MAAK,GAAqB,KAAG,IAU9D,CAAC;AAIF,eAAO,MAAM,SAAS,QAAO,MAAuB,CAAC"}

package/build/common/config.js

@@ -2,11 +2,17 @@
  * @param value Comma-separated string.
  * @returns Parsed string values.
  */
-const parseCsv = (value) => {
-    if (!value) {
-        return undefined;
+const parseCsv = (value) => value ? value.split(",") : undefined;
+/**
+ * @param value Raw `FETCH_MULTI_PAGE_STARS` value.
+ * @returns Page limit: `"true"` means every page, a positive number caps the pages, anything else means one.
+ */
+const parseFetchMultiPageStars = (value) => {
+    if (value === "true") {
+        return Infinity;
     }
-    return value.split(",");
+    const limit = Number(value);
+    return limit > 0 ? limit : 1;
 };
 /**
  * @param env Environment variables to inspect.
@@ -27,34 +33,18 @@ const getDefaultEnv = () => {
     const processEnv = globalThis.process?.env;
     return processEnv ?? {};
 };
-/**
- * @param config (Partial) config values to normalize.
- * @returns Normalized config object with defaults applied.
- */
-const normalizeConfig = (config = {}) => {
-    return {
-        whitelist: config.whitelist,
-        gistWhitelist: config.gistWhitelist,
-        excludeRepositories: config.excludeRepositories ?? [],
-        fetchMultiPageStars: config.fetchMultiPageStars,
-        pats: config.pats ?? [],
-    };
-};
 let currentConfig;
 /**
  * @param env Environment variables used to build the runtime config.
  */
 export const loadConfigFromEnv = (env = getDefaultEnv()) => {
-    const whitelist = parseCsv(env["WHITELIST"]);
-    const gistWhitelist = parseCsv(env["GIST_WHITELIST"]);
-    const excludeRepositories = parseCsv(env["EXCLUDE_REPO"]) ?? [];
-    currentConfig = normalizeConfig({
-        whitelist,
-        gistWhitelist,
-        excludeRepositories,
-        fetchMultiPageStars: env["FETCH_MULTI_PAGE_STARS"],
+    currentConfig = {
+        whitelist: parseCsv(env["WHITELIST"]),
+        gistWhitelist: parseCsv(env["GIST_WHITELIST"]),
+        excludeRepositories: parseCsv(env["EXCLUDE_REPO"]) ?? [],
+        fetchMultiPageStars: parseFetchMultiPageStars(env["FETCH_MULTI_PAGE_STARS"]),
         pats: parsePATsFromEnv(env),
-    });
+    };
 };
 loadConfigFromEnv();
 export const getConfig = () => currentConfig;

package/build/common/constants.d.ts

@@ -1,6 +1,7 @@
+import type { RepositoryAffiliation } from "../graphql/generated/common.js";
 /**
  * Valid owner affiliations for GitHub API queries.
  */
-declare const OWNER_AFFILIATIONS: Array<string>;
+declare const OWNER_AFFILIATIONS: Array<RepositoryAffiliation>;
 export { OWNER_AFFILIATIONS };
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAIrC,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/common/constants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAE5E;;GAEG;AACH,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC,qBAAqB,CAIpD,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/build/common/date.d.ts

@@ -0,0 +1,37 @@
+/** A span between two dates, as GitHub's range arguments take it. */
+interface GitHubDateRange {
+    /** Start of the range, inclusive. */
+    from: Date;
+    /** End of the range, inclusive. */
+    to: Date;
+}
+/**
+ * Format a date as a GitHub `DateTime` scalar.
+ * Seconds precision, no milliseconds.
+ *
+ * @param date Date to format.
+ * @returns e.g. `2024-01-01T00:00:00Z`.
+ */
+declare const toGitHubDateTime: (date: Date) => string;
+/**
+ * The full UTC span of a calendar year, both ends inclusive.
+ *
+ * The end matters to callers that would otherwise leave a range open:
+ * GitHub's `contributionsCollection` defaults `to` to one year after `from`,
+ * which pulls the next 1st of January into the year.
+ *
+ * @param year Four-digit year.
+ * @returns The range covering it.
+ */
+declare const getGitHubYearRange: (year: number) => GitHubDateRange;
+/**
+ * Get diff in minutes between two dates.
+ *
+ * @param d1 First date.
+ * @param d2 Second date.
+ * @returns Number of minutes between the two dates.
+ */
+declare const dateDiff: (d1: Date, d2: Date) => number;
+export { dateDiff, getGitHubYearRange, toGitHubDateTime };
+export type { GitHubDateRange };
+//# sourceMappingURL=date.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../../src/common/date.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,UAAU,eAAe;IACvB,qCAAqC;IACrC,IAAI,EAAE,IAAI,CAAC;IACX,mCAAmC;IACnC,EAAE,EAAE,IAAI,CAAC;CACV;AAED;;;;;;GAMG;AACH,QAAA,MAAM,gBAAgB,GAAI,MAAM,IAAI,KAAG,MACA,CAAC;AAExC;;;;;;;;;GASG;AACH,QAAA,MAAM,kBAAkB,GAAI,MAAM,MAAM,KAAG,eAGzC,CAAC;AAEH;;;;;;GAMG;AACH,QAAA,MAAM,QAAQ,GAAI,IAAI,IAAI,EAAE,IAAI,IAAI,KAAG,MACkB,CAAC;AAE1D,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/build/common/date.js

@@ -0,0 +1,31 @@
+/**
+ * Format a date as a GitHub `DateTime` scalar.
+ * Seconds precision, no milliseconds.
+ *
+ * @param date Date to format.
+ * @returns e.g. `2024-01-01T00:00:00Z`.
+ */
+const toGitHubDateTime = (date) => `${date.toISOString().slice(0, 19)}Z`;
+/**
+ * The full UTC span of a calendar year, both ends inclusive.
+ *
+ * The end matters to callers that would otherwise leave a range open:
+ * GitHub's `contributionsCollection` defaults `to` to one year after `from`,
+ * which pulls the next 1st of January into the year.
+ *
+ * @param year Four-digit year.
+ * @returns The range covering it.
+ */
+const getGitHubYearRange = (year) => ({
+    from: new Date(Date.UTC(year, 0, 1)),
+    to: new Date(Date.UTC(year, 11, 31, 23, 59, 59)),
+});
+/**
+ * Get diff in minutes between two dates.
+ *
+ * @param d1 First date.
+ * @param d2 Second date.
+ * @returns Number of minutes between the two dates.
+ */
+const dateDiff = (d1, d2) => Math.round((d1.getTime() - d2.getTime()) / (1000 * 60));
+export { dateDiff, getGitHubYearRange, toGitHubDateTime };