@stats-forge/github-stats-forge-core 0.1.0 → 0.2.0

package/build/cards/contributed-to.js

@@ -0,0 +1,242 @@
+import { CARD_ICON, CARD_WIDTH, FONT_SIZE, firefoxFontSize, font } from '../common/brand.js';
+import { Card } from '../common/Card.js';
+import { getLightDarkColors } from '../common/color.js';
+import { formatYears } from '../common/date.js';
+import { kFormatter } from '../common/fmt.js';
+import { I18n } from '../common/I18n.js';
+import { clampValue } from '../common/ops.js';
+import { createProgressNode, measureText } from '../common/render.js';
+import { atRule, el, rule } from '../markup/index.js';
+import { contributedToCardLocales } from '../translations.js';
+const CARD_DEFAULT_WIDTH = CARD_WIDTH.wide;
+const MIN_CARD_WIDTH = 340;
+/** Padding the card keeps at its edges; matches `Card`'s own `paddingX`. */
+const CARD_PADDING = 25;
+const TITLE_FONT_SIZE = FONT_SIZE.title;
+/** What `Card`'s title layout reserves for the prefix icon, so the title text starts past it. */
+const TITLE_ICON_COLUMN = 25;
+const NAME_FONT_SIZE = FONT_SIZE.meta;
+/** Room kept at the right edge for the contribution count. */
+const COUNT_WIDTH = 46;
+const BAR_WIDTH = 130;
+const COLUMN_GAP = 12;
+/** Baseline of the first row, measured from the top of the card body. */
+const FIRST_ROW_Y = 10;
+const ROW_HEIGHT = 38;
+/** A row with no year marks under it needs only its own line. */
+const ROW_HEIGHT_NO_YEARS = 24;
+/** How far the year marks sit below their row's baseline. */
+const YEAR_STRIP_Y = 8;
+const YEAR_MARK_SIZE = 7;
+const YEAR_MARK_GAP = 3;
+/** Gap between the last row and the footer's own baseline. */
+const FOOTER_GAP = 12;
+/** Where `Card` puts the body while the title is shown; `setHideTitle` adjusts the height by the same 30. */
+const BODY_OFFSET_Y = 55;
+const BOTTOM_PADDING = 18;
+/**
+ * The title, naming the account unless that makes it too wide for the card.
+ *
+ * A login is up to 39 characters, which at the title's size overruns the default width
+ * by half again — so the plain wording is the fallback rather than a truncated login.
+ *
+ * @returns The default title, which `custom_title` still overrides.
+ */
+const defaultTitleFor = (i18n, contentWidth) => {
+    const named = i18n.t('contributedtocard.title');
+    return measureText(named, TITLE_FONT_SIZE) <= contentWidth
+        ? named
+        : i18n.t('contributedtocard.title-unnamed');
+};
+/**
+ * Shortens a name to fit its column, ending it with an ellipsis when it does not.
+ *
+ * @returns The name as it is drawn.
+ */
+const truncateName = (name, maxWidth) => {
+    if (measureText(name, NAME_FONT_SIZE) <= maxWidth) {
+        return name;
+    }
+    let trimmed = name;
+    while (trimmed.length > 1 && measureText(`${trimmed}…`, NAME_FONT_SIZE) > maxWidth) {
+        trimmed = trimmed.slice(0, -1);
+    }
+    return `${trimmed}…`;
+};
+/**
+ * The marks under a repository's name, one per contribution year of the account,
+ * filled for the years that repository got a contribution.
+ *
+ * The step shrinks to fit, so a long-lived account keeps the strip inside its column
+ * rather than running it under the bar.
+ *
+ * @returns The strip, positioned relative to its row's baseline.
+ */
+const createYearStrip = (repoYears, years, columnWidth) => {
+    const contributed = new Set(repoYears);
+    const step = Math.min(YEAR_MARK_SIZE + YEAR_MARK_GAP, Math.floor(columnWidth / years.length));
+    const size = Math.max(step - YEAR_MARK_GAP, 3);
+    return el('g', { 'data-testid': 'year-strip', transform: `translate(0, ${YEAR_STRIP_Y})` }, years.map((year, index) => el('rect', {
+        'data-testid': contributed.has(year) ? 'year-on' : 'year-off',
+        class: contributed.has(year) ? 'year-on' : 'year-off',
+        x: index * step,
+        y: 0,
+        width: size,
+        height: size,
+        rx: 1,
+        ry: 1,
+    })));
+};
+/**
+ * One repository: its name, a bar for its share of the top repository's contributions,
+ * and the count itself.
+ *
+ * @returns The row, positioned by its own transform.
+ */
+const createRepoRow = ({ repo, index, maxContributions, years, nameWidth, contentWidth, rowHeight, }) => el('g', {
+    class: 'stagger',
+    style: `animation-delay: ${450 + index * 150}ms`,
+    transform: `translate(0, ${FIRST_ROW_Y + index * rowHeight})`,
+}, el('text', { class: 'repo-name', 'data-testid': 'repo-name', x: 0, y: 0 }, truncateName(repo.nameWithOwner, nameWidth)), createProgressNode({
+    x: nameWidth + COLUMN_GAP,
+    y: -9,
+    width: BAR_WIDTH,
+    progress: (repo.contributions / maxContributions) * 100,
+    delay: 450 + index * 150,
+}), el('text', {
+    class: 'count',
+    'data-testid': 'repo-contributions',
+    x: contentWidth,
+    y: 0,
+    'text-anchor': 'end',
+}, kFormatter(repo.contributions)), years.length > 0 && createYearStrip(repo.years, years, nameWidth));
+/**
+ * The line under the rows: how much of the walk the card is showing, and over what years.
+ *
+ * Never dropped, because the card shows a slice of the repositories
+ * and a rank means nothing without the total it was taken from.
+ *
+ * @returns The footer text.
+ */
+const footerText = ({ i18n, shown, totalRepos, years, }) => {
+    const parts = [
+        i18n.t(shown < totalRepos ? 'contributedtocard.footer-top' : 'contributedtocard.footer-all'),
+    ];
+    const [firstYear] = years;
+    const lastYear = years.at(-1);
+    if (firstYear !== undefined && lastYear !== undefined) {
+        parts.push(formatYears(firstYear, lastYear));
+    }
+    return parts.join(' · ');
+};
+/**
+ * Renders the repositories a user contributed to, ranked by contributions.
+ *
+ * @returns Contributed-to card SVG string.
+ */
+const renderContributedToCard = (data, options = {}) => {
+    const { locale, hide_title = false, hide_border = false, card_width, custom_title, disable_animations = false, hide_years = false, border_radius, theme = 'default', } = options;
+    const { login, repos, totalRepos } = data;
+    const years = hide_years ? [] : data.years;
+    const width = card_width && !Number.isNaN(card_width)
+        ? clampValue(card_width, MIN_CARD_WIDTH, Number.MAX_SAFE_INTEGER)
+        : CARD_DEFAULT_WIDTH;
+    const contentWidth = width - 2 * CARD_PADDING;
+    const nameWidth = contentWidth - COUNT_WIDTH - BAR_WIDTH - 2 * COLUMN_GAP;
+    const rowHeight = years.length > 0 ? ROW_HEIGHT : ROW_HEIGHT_NO_YEARS;
+    // the count is a share of the busiest repository, so the first bar is always full
+    const maxContributions = Math.max(...repos.map((repo) => repo.contributions), 1);
+    const rows = repos.map((repo, index) => createRepoRow({
+        repo,
+        index,
+        maxContributions,
+        years,
+        nameWidth,
+        contentWidth,
+        rowHeight,
+    }));
+    const i18n = new I18n({
+        locale,
+        translations: contributedToCardLocales({ login, shown: repos.length, totalRepos }),
+    });
+    const footer = footerText({ i18n, shown: repos.length, totalRepos, years });
+    const footerY = FIRST_ROW_Y + Math.max(repos.length, 1) * rowHeight + FOOTER_GAP;
+    const height = BODY_OFFSET_Y + footerY + BOTTOM_PADDING;
+    const { lightColors, darkColors } = getLightDarkColors({ ...options, theme });
+    const card = new Card({
+        customTitle: custom_title,
+        defaultTitle: defaultTitleFor(i18n, contentWidth - TITLE_ICON_COLUMN),
+        titlePrefixIcon: CARD_ICON.contributedTo,
+        width,
+        height,
+        border_radius,
+        colors: { light: lightColors, dark: darkColors },
+    });
+    if (disable_animations) {
+        card.disableAnimations();
+    }
+    card.setHideBorder(hide_border);
+    card.setHideTitle(hide_title);
+    card.setCSS({
+        light: ({ textColor, titleColor, iconColor, progBarBgColor }) => [
+            atRule('@keyframes growWidthAnimation', rule('from', { width: 0 }), rule('to', { width: '100%' })),
+            rule('.repo-name', {
+                font: font('regular', 'meta'),
+                fill: textColor,
+            }),
+            rule('.count', {
+                font: font('semibold', 'meta'),
+                fill: textColor,
+                'font-variant-numeric': 'tabular-nums',
+            }),
+            rule('.footer', {
+                font: font('regular', 'micro'),
+                fill: textColor,
+                opacity: 0.7,
+            }),
+            firefoxFontSize(['.repo-name', '.count'], 'small'),
+            rule('.year-on', { fill: titleColor }),
+            // a year with no contribution reads off the text color, not `progBarBgColor`:
+            // on a dark theme that color is a light grey, and the empty marks came out looking filled
+            rule('.year-off', { fill: textColor, opacity: 0.25 }),
+            rule('.progress-background', { fill: progBarBgColor }),
+            rule('.lang-progress', {
+                fill: titleColor,
+                animation: 'growWidthAnimation 0.6s ease-in-out forwards',
+            }),
+            rule('.stagger', { opacity: 0, animation: 'fadeInAnimation 0.3s ease-in-out forwards' }),
+            rule('.icon', { fill: iconColor, display: 'block' }),
+        ],
+        dark: ({ textColor, titleColor, iconColor, progBarBgColor }) => [
+            rule('.repo-name', { fill: textColor }),
+            rule('.count', { fill: textColor }),
+            rule('.footer', { fill: textColor }),
+            rule('.year-on', { fill: titleColor }),
+            // a year with no contribution reads off the text color, not `progBarBgColor`:
+            // on a dark theme that color is a light grey, and the empty marks came out looking filled
+            rule('.year-off', { fill: textColor, opacity: 0.25 }),
+            rule('.progress-background', { fill: progBarBgColor }),
+            rule('.lang-progress', { fill: titleColor }),
+            rule('.icon', { fill: iconColor }),
+        ],
+    });
+    // `role="img"` hides the inner text from assistive tech, so everything the card
+    // shows has to be repeated here — the year marks included, since they carry
+    // information no other element on the card does.
+    card.setAccessibilityLabel({
+        title: card.title,
+        desc: [
+            ...repos.map((repo) => {
+                const inYears = hide_years
+                    ? ''
+                    : `, ${i18n.t('contributedtocard.years')}: ${repo.years.join(', ')}`;
+                return `${repo.nameWithOwner}: ${repo.contributions} ${i18n.t('contributedtocard.contributions')}${inYears}`;
+            }),
+            footer,
+        ].join('; '),
+    });
+    return card.render(el('g', { 'data-testid': 'contributed-to-body', transform: `translate(${CARD_PADDING}, 0)` }, repos.length === 0
+        ? el('text', { class: 'repo-name', 'data-testid': 'no-repos', x: 0, y: FIRST_ROW_Y }, i18n.t('contributedtocard.no-contributions'))
+        : rows, el('text', { class: 'footer', 'data-testid': 'footer', x: 0, y: footerY }, footer)));
+};
+export { renderContributedToCard, MIN_CARD_WIDTH };

package/build/cards/gist.d.ts

@@ -1,6 +1,7 @@
 import type { GistData } from '../fetchers/types.ts';
 import type { CardOptions, CommonCardOptions } from './options.ts';
 interface GistCardOptions extends CommonCardOptions {
+    locale: string;
     show_owner: boolean;
     browser_rendering: boolean;
 }

package/build/cards/gist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/cards/gist.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWnE,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,QAAA,MAAM,cAAc,aAAc,QAAQ,YAAW,WAAW,CAAC,eAAe,CAAC,KAAQ,MA0HxF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"gist.d.ts","sourceRoot":"","sources":["../../src/cards/gist.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKrD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAWnE,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;;;GAIG;AACH,QAAA,MAAM,cAAc,aAAc,QAAQ,YAAW,WAAW,CAAC,eAAe,CAAC,KAAQ,MA+HxF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/build/cards/gist.js

@@ -1,17 +1,20 @@
+import { CARD_ICON, CARD_WIDTH, FONT_SIZE, font } from '../common/brand.js';
 import { Card } from '../common/Card.js';
 import { getLightDarkColors } from '../common/color.js';
 import { kFormatter } from '../common/fmt.js';
+import { I18n } from '../common/I18n.js';
 import { icons } from '../common/icons.js';
 import { getLanguageColor } from '../common/languageColors.js';
 import { parseEmojis } from '../common/ops.js';
 import { countWrappedLines, wrapTextMultiline, createLanguageNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
 import { el, rule } from '../markup/index.js';
+import { gistCardLocales } from '../translations.js';
 const ICON_SIZE = 16;
-const CARD_DEFAULT_WIDTH = 400;
+const CARD_DEFAULT_WIDTH = CARD_WIDTH.standard;
 const X_OFFSET = 25;
 const HEADER_MAX_LENGTH = 35;
 const DESCRIPTION_BOX_WIDTH = CARD_DEFAULT_WIDTH - 2 * X_OFFSET;
-const DESCRIPTION_FONT_SIZE = 13;
+const DESCRIPTION_FONT_SIZE = FONT_SIZE.meta;
 const DESCRIPTION_LINE_HEIGHT_PX = 16;
 const DESCRIPTION_MAX_LINES = 10;
 /**
@@ -21,9 +24,10 @@ const DESCRIPTION_MAX_LINES = 10;
  */
 const renderGistCard = (gistData, options = {}) => {
     const { name, nameWithOwner, description, language, starsCount, forksCount } = gistData;
-    const { theme = 'default_repocard', border_radius, show_owner = false, browser_rendering = false, hide_border = false, } = options;
+    const { locale, theme = 'default_repocard', border_radius, show_owner = false, browser_rendering = false, hide_border = false, } = options;
     const { lightColors, darkColors } = getLightDarkColors({ ...options, theme });
-    const desc = parseEmojis(description || 'No description provided');
+    const i18n = new I18n({ locale, translations: gistCardLocales });
+    const desc = parseEmojis(description || i18n.t('gistcard.no-description'));
     let descriptionLines;
     let descriptionSvg;
     if (browser_rendering) {
@@ -55,7 +59,7 @@ const renderGistCard = (gistData, options = {}) => {
     const totalForks = kFormatter(forksCount);
     const svgStars = iconWithLabel(icons.star, totalStars, 'starsCount', ICON_SIZE);
     const svgForks = iconWithLabel(icons.fork, totalForks, 'forksCount', ICON_SIZE);
-    const languageName = language || 'Unspecified';
+    const languageName = language || i18n.t('gistcard.unspecified-language');
     const languageColor = getLanguageColor(languageName);
     const svgLanguage = createLanguageNode(languageName, languageColor);
     const starAndForkCount = flexLayout({
@@ -70,7 +74,7 @@ const renderGistCard = (gistData, options = {}) => {
     const header = show_owner ? nameWithOwner : name;
     const card = new Card({
         defaultTitle: header.length > HEADER_MAX_LENGTH ? `${header.slice(0, HEADER_MAX_LENGTH)}...` : header,
-        titlePrefixIcon: icons.gist,
+        titlePrefixIcon: CARD_ICON.gist,
         width: CARD_DEFAULT_WIDTH,
         height,
         border_radius,
@@ -79,11 +83,11 @@ const renderGistCard = (gistData, options = {}) => {
     card.setCSS({
         light: ({ textColor, iconColor }) => [
             rule('.description', {
-                font: `400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif`,
+                font: font('regular', 'meta'),
                 fill: textColor,
                 ...(browser_rendering ? wrappedTextStyles(textColor) : {}),
             }),
-            rule('.gray', { font: "400 12px 'Segoe UI', Ubuntu, Sans-Serif", fill: textColor }),
+            rule('.gray', { font: font('regular', 'small'), fill: textColor }),
             rule('.icon', { fill: iconColor }),
         ],
         dark: ({ textColor, iconColor }) => [
@@ -100,7 +104,7 @@ const renderGistCard = (gistData, options = {}) => {
     // shows has to be repeated here.
     card.setAccessibilityLabel({
         title: card.title,
-        desc: `${desc}. Language: ${languageName}, Stars: ${totalStars}, Forks: ${totalForks}`,
+        desc: `${desc}. ${i18n.t('gistcard.language')}: ${languageName}, ${i18n.t('gistcard.stars')}: ${totalStars}, ${i18n.t('gistcard.forks')}: ${totalForks}`,
     });
     return card.render([
         descriptionSvg,

package/build/cards/repo.d.ts

@@ -18,6 +18,17 @@ interface RepoCardOptions extends CommonCardOptions {
  *
  * @returns Repository card SVG object.
  */
-declare const renderRepoCard: (repo: RepositoryData, options?: CardOptions<RepoCardOptions>) => string;
+declare const renderCard: (repo: RepositoryData, options?: CardOptions<RepoCardOptions>) => string;
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * They ride on the renderer so a list cannot be found without what draws it;
+ * the api handler forwards them onto its own export, which is what a UI reads.
+ */
+declare const renderRepoCard: typeof renderCard & {
+    OPTIONS: {
+        show: readonly ["prs_authored", "prs_commented", "prs_reviewed", "issues_authored", "issues_commented"];
+        number_format: readonly ["short", "long"];
+    };
+};
 export { renderRepoCard };
 //# sourceMappingURL=repo.d.ts.map

package/build/cards/repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/cards/repo.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASnE,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuCD;;;;GAIG;AACH,QAAA,MAAM,cAAc,SACZ,cAAc,YACX,WAAW,CAAC,eAAe,CAAC,KACpC,MAiRF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/cards/repo.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAmBnE,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;IACpB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAuCD;;;;GAIG;AACH,QAAA,MAAM,UAAU,SAAU,cAAc,YAAW,WAAW,CAAC,eAAe,CAAC,KAAQ,MAoRtF,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,cAAc;;QAEhB,IAAI;QACJ,aAAa;;CAEf,CAAC;AAEH,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/build/cards/repo.js

@@ -1,18 +1,27 @@
+import { CARD_ICON, CARD_WIDTH, FONT_SIZE, FONT_WEIGHT, font } from '../common/brand.js';
 import { Card } from '../common/Card.js';
 import { getLightDarkColors } from '../common/color.js';
 import { kFormatter } from '../common/fmt.js';
 import { I18n } from '../common/I18n.js';
 import { icons } from '../common/icons.js';
 import { buildSearchFilter, clampValue, parseEmojis } from '../common/ops.js';
-import { countWrappedLines, wrapTextMultiline, createLanguageNode, createTextNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
+import { NUMBER_FORMATS, countWrappedLines, wrapTextMultiline, createLanguageNode, createTextNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
 import { el, rule } from '../markup/index.js';
 import { repoCardLocales } from '../translations.js';
 const ICON_SIZE = 16;
-const CARD_DEFAULT_WIDTH = 400;
+const CARD_DEFAULT_WIDTH = CARD_WIDTH.standard;
 const X_OFFSET = 25;
-const DESCRIPTION_FONT_SIZE = 13;
+const DESCRIPTION_FONT_SIZE = FONT_SIZE.meta;
 const DESCRIPTION_LINE_HEIGHT_PX = 16;
 const DESCRIPTION_MAX_LINES = 3;
+/** Stats the card draws only when `show` names them. */
+const REPO_SHOW_STATS = [
+    'prs_authored',
+    'prs_commented',
+    'prs_reviewed',
+    'issues_authored',
+    'issues_commented',
+];
 /**
  * Retrieves the repository description and wraps it to fit the card width.
  *
@@ -35,7 +44,7 @@ const getBadgeSVG = (label, xOffset = 0) => {
  *
  * @returns Repository card SVG object.
  */
-const renderRepoCard = (repo, options = {}) => {
+const renderCard = (repo, options = {}) => {
     const { name, nameWithOwner, description, primaryLanguage, isArchived, isTemplate, stargazerCount, forkCount, totalPRsAuthored, totalPRsCommented, totalPRsReviewed, totalIssuesAuthored, totalIssuesCommented, } = repo;
     const { hide_border = false, card_width_input, show_owner = false, browser_rendering = false, show = [], show_icons = true, number_format = 'short', text_bold = false, line_height = 22, username, theme = 'default_repocard', border_radius, locale, description_lines_count, } = options;
     const card_width = card_width_input && !Number.isNaN(card_width_input)
@@ -47,10 +56,12 @@ const renderRepoCard = (repo, options = {}) => {
         locale,
         translations: repoCardLocales,
     });
+    // Typed against the exported list, so a stat drawn here cannot be missing from it.
+    const shows = (stat) => show.includes(stat);
     const repoFilter = encodeURIComponent(buildSearchFilter([nameWithOwner], []));
     const encodedUsername = encodeURIComponent(username ?? '');
     const STATS = {};
-    if (show.includes('prs_authored')) {
+    if (shows('prs_authored')) {
         STATS['prs_authored'] = {
             icon: icons.prs,
             label: i18n.t('repocard.prs-authored'),
@@ -59,7 +70,7 @@ const renderRepoCard = (repo, options = {}) => {
             link: `https://github.com/search?q=${repoFilter}author%3A${encodedUsername}&type=pullrequests`,
         };
     }
-    if (show.includes('prs_commented')) {
+    if (shows('prs_commented')) {
         STATS['prs_commented'] = {
             icon: icons.comments,
             label: i18n.t('repocard.prs-commented'),
@@ -68,7 +79,7 @@ const renderRepoCard = (repo, options = {}) => {
             link: `https://github.com/search?q=${repoFilter}commenter%3A${encodedUsername}+-author%3A${encodedUsername}&type=pullrequests`,
         };
     }
-    if (show.includes('prs_reviewed')) {
+    if (shows('prs_reviewed')) {
         STATS['prs_reviewed'] = {
             icon: icons.reviews,
             label: i18n.t('repocard.prs-reviewed'),
@@ -77,7 +88,7 @@ const renderRepoCard = (repo, options = {}) => {
             link: `https://github.com/search?q=${repoFilter}reviewed-by%3A${encodedUsername}+-author%3A${encodedUsername}&type=pullrequests`,
         };
     }
-    if (show.includes('issues_authored')) {
+    if (shows('issues_authored')) {
         STATS['issues_authored'] = {
             icon: icons.issues,
             label: i18n.t('repocard.issues-authored'),
@@ -86,7 +97,7 @@ const renderRepoCard = (repo, options = {}) => {
             link: `https://github.com/search?q=${repoFilter}author%3A${encodedUsername}&type=issues`,
         };
     }
-    if (show.includes('issues_commented')) {
+    if (shows('issues_commented')) {
         STATS['issues_commented'] = {
             icon: icons.discussions_started,
             label: i18n.t('repocard.issues-commented'),
@@ -114,9 +125,9 @@ const renderRepoCard = (repo, options = {}) => {
     const extraLHeight = Number.parseInt(String(line_height), 10);
     const lineHeight = 10;
     const header = show_owner ? nameWithOwner : name;
-    const langName = primaryLanguage?.name || 'Unspecified';
+    const langName = primaryLanguage?.name || i18n.t('repocard.unspecified-language');
     const langColor = primaryLanguage?.color || '#333';
-    const desc = parseEmojis(description || 'No description provided');
+    const desc = parseEmojis(description || i18n.t('repocard.no-description'));
     const descriptionBoxWidth = card_width - 2 * X_OFFSET;
     let descriptionLinesCount;
     let descriptionSvg;
@@ -177,7 +188,7 @@ const renderRepoCard = (repo, options = {}) => {
     const extraItems = el('svg', { x: 0, y: 0 }, el('g', { transform: `translate(-3, ${height - 52 - extraHeight})` }, flexLayout({ items: extraRows, gap: extraLHeight, direction: 'column' })));
     const card = new Card({
         defaultTitle: header.length > 35 ? `${header.slice(0, 35)}...` : header,
-        titlePrefixIcon: icons.contribs,
+        titlePrefixIcon: CARD_ICON.repo,
         width: card_width,
         height,
         border_radius,
@@ -189,21 +200,21 @@ const renderRepoCard = (repo, options = {}) => {
     card.setCSS({
         light: ({ textColor, iconColor }) => [
             rule('.description', {
-                font: `400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif`,
+                font: font('regular', 'meta'),
                 fill: textColor,
                 ...(browser_rendering ? wrappedTextStyles(textColor) : {}),
             }),
-            rule('.gray', { font: "400 12px 'Segoe UI', Ubuntu, Sans-Serif", fill: textColor }),
-            rule('.badge', { font: "600 11px 'Segoe UI', Ubuntu, Sans-Serif" }),
+            rule('.gray', { font: font('regular', 'small'), fill: textColor }),
+            rule('.badge', { font: font('semibold', 'micro') }),
             rule('.badge rect', { opacity: 0.2, stroke: textColor }),
             rule('.badge text', { fill: textColor }),
-            rule('.stat', { font: "400 12px 'Segoe UI', Ubuntu, Sans-Serif", fill: textColor }),
+            rule('.stat', { font: font('regular', 'small'), fill: textColor }),
             rule('.stagger', {
                 opacity: 0,
                 animation: 'fadeInAnimation 0.3s ease-in-out forwards',
             }),
-            rule('.not_bold', { 'font-weight': 400 }),
-            rule('.bold', { 'font-weight': 700 }),
+            rule('.not_bold', { 'font-weight': FONT_WEIGHT.regular }),
+            rule('.bold', { 'font-weight': FONT_WEIGHT.semibold }),
             rule('.icon', { fill: iconColor, display: 'block' }),
         ],
         dark: ({ textColor, iconColor }) => [
@@ -241,4 +252,15 @@ const renderRepoCard = (repo, options = {}) => {
         extraItems,
     ]);
 };
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * They ride on the renderer so a list cannot be found without what draws it;
+ * the api handler forwards them onto its own export, which is what a UI reads.
+ */
+const renderRepoCard = Object.assign(renderCard, {
+    OPTIONS: {
+        show: REPO_SHOW_STATS,
+        number_format: NUMBER_FORMATS,
+    },
+});
 export { renderRepoCard };

package/build/cards/stats.d.ts

@@ -11,7 +11,6 @@ interface StatCardOptions extends CommonCardOptions {
     card_width: number;
     hide_rank: boolean;
     include_all_commits: boolean;
-    commits_year: number;
     line_height: number | string;
     custom_title: string;
     disable_animations: boolean;
@@ -27,6 +26,19 @@ interface StatCardOptions extends CommonCardOptions {
  *
  * @returns The stats card SVG object.
  */
-declare const renderStatsCard: (stats: StatsData, options?: CardOptions<StatCardOptions>, username?: string, repo?: Array<string>, owner?: Array<string>) => string;
-export { RANK_ICONS, renderStatsCard };
+declare const renderCard: (stats: StatsData, options?: CardOptions<StatCardOptions>, username?: string, repo?: Array<string>, owner?: Array<string>) => string;
+/**
+ * The card, and the values each of its options accepts, keyed by the option's own name.
+ * They ride on the renderer so a list cannot be found without what draws it;
+ * the api handler forwards them onto its own export, which is what a UI reads.
+ */
+declare const renderStatsCard: typeof renderCard & {
+    OPTIONS: {
+        rank_icon: readonly ["default", "github", "percentile"];
+        show: readonly ["contributions", "prs_merged", "prs_merged_percentage", "reviews", "discussions_started", "discussions_answered", "prs_authored", "prs_commented", "prs_reviewed", "issues_authored", "issues_commented", "all_time_contribs"];
+        hide: readonly ["stars", "commits", "prs", "issues", "contribs"];
+        number_format: readonly ["short", "long"];
+    };
+};
+export { renderStatsCard };
 //# sourceMappingURL=stats.d.ts.map

package/build/cards/stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cards/stats.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAqBnE,qFAAqF;AACrF,QAAA,MAAM,UAAU,YAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAChE,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5C,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AAoJD;;;;GAIG;AACH,QAAA,MAAM,eAAe,UACZ,SAAS,YACP,WAAW,CAAC,eAAe,CAAC,aAC1B,MAAM,SACX,KAAK,CAAC,MAAM,CAAC,UACZ,KAAK,CAAC,MAAM,CAAC,KACnB,MA0XF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cards/stats.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAKtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAqBnE,qFAAqF;AACrF,QAAA,MAAM,UAAU,YAAI,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAU,CAAC;AAChE,KAAK,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AA0B5C,UAAU,eAAgB,SAAQ,iBAAiB;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,QAAQ,CAAC;IACpB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACrB;AA8ID;;;;GAIG;AACH,QAAA,MAAM,UAAU,UACP,SAAS,YACP,WAAW,CAAC,eAAe,CAAC,aAC1B,MAAM,SACX,KAAK,CAAC,MAAM,CAAC,UACZ,KAAK,CAAC,MAAM,CAAC,KACnB,MA8WF,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,eAAe;;QAEjB,SAAS;QACT,IAAI;QACJ,IAAI;QACJ,aAAa;;CAEf,CAAC;AAEH,OAAO,EAAE,eAAe,EAAE,CAAC"}