@stats-forge/github-stats-forge-core 0.0.1

package/build/cards/gist.js

@@ -0,0 +1,119 @@
+import { default as Card } from '../common/Card.js';
+import { getLightDarkColors } from '../common/color.js';
+import { kFormatter, wrapTextMultiline } from '../common/fmt.js';
+import { encodeHTML } from '../common/html.js';
+import { icons } from '../common/icons.js';
+import { getLanguageColor } from '../common/languageColors.js';
+import { parseEmojis } from '../common/ops.js';
+import { countWrappedLines, createLanguageNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
+const ICON_SIZE = 16;
+const CARD_DEFAULT_WIDTH = 400;
+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_LINE_HEIGHT_PX = 16;
+const DESCRIPTION_MAX_LINES = 10;
+/**
+ * Render gist card.
+ *
+ * @param gistData Gist data.
+ * @param options Gist card options.
+ * @returns Gist card.
+ */
+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 { lightColors, darkColors } = getLightDarkColors({ ...options, theme });
+    const desc = parseEmojis(description || 'No description provided');
+    let descriptionLines;
+    let descriptionSvg;
+    if (browser_rendering) {
+        // The browser performs the actual text wrapping inside the foreignObject;
+        // we only estimate the line count server-side so the SVG can reserve enough
+        // height. The estimate uses measureText for font-aware widths instead of a
+        // fixed character count.
+        descriptionLines = countWrappedLines(desc, DESCRIPTION_FONT_SIZE, DESCRIPTION_BOX_WIDTH, DESCRIPTION_MAX_LINES);
+        descriptionSvg = wrappedTextNode({
+            text: desc,
+            x: X_OFFSET,
+            y: -3,
+            width: DESCRIPTION_BOX_WIDTH,
+            height: descriptionLines * DESCRIPTION_LINE_HEIGHT_PX + 10, // 10px extra for "descenders" like g, j, q, p, y
+            lineCount: descriptionLines,
+            className: 'description',
+            testId: 'description-text',
+        });
+    }
+    else {
+        const linesLimit = 10;
+        const multiLineDescription = wrapTextMultiline(desc, DESCRIPTION_BOX_WIDTH, DESCRIPTION_FONT_SIZE, linesLimit);
+        descriptionLines = multiLineDescription.length;
+        descriptionSvg = multiLineDescription
+            .map((line) => `<tspan dy="1.2em" x="${X_OFFSET}">${encodeHTML(line)}</tspan>`)
+            .join('');
+        descriptionSvg = `<text class="description" x="${X_OFFSET}" y="-5">
+        ${descriptionSvg}
+    </text>`;
+    }
+    const lineHeight = descriptionLines > 3 ? 12 : 10;
+    const height = (descriptionLines > 1 ? 120 : 110) + descriptionLines * lineHeight;
+    const totalStars = kFormatter(starsCount);
+    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 languageColor = getLanguageColor(languageName);
+    const svgLanguage = createLanguageNode(languageName, languageColor);
+    const starAndForkCount = flexLayout({
+        items: [svgLanguage, svgStars, svgForks],
+        sizes: [
+            measureText(languageName, 12),
+            ICON_SIZE + measureText(`${totalStars}`, 12),
+            ICON_SIZE + measureText(`${totalForks}`, 12),
+        ],
+        gap: 25,
+    }).join('');
+    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,
+        width: CARD_DEFAULT_WIDTH,
+        height,
+        border_radius,
+        colors: { light: lightColors, dark: darkColors },
+    });
+    card.setCSS({
+        light: ({ textColor, iconColor }) => `
+    .description {
+      font: 400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif;fill: ${textColor};
+      ${browser_rendering ? wrappedTextStyles(textColor) : ''}
+    }
+    .gray { font: 400 12px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${textColor} }
+    .icon { fill: ${iconColor} }
+  `,
+        dark: ({ textColor, iconColor }) => `
+      .description {
+        fill: ${textColor};
+        ${browser_rendering ? wrappedTextStyles(textColor) : ''}
+      }
+      .gray { fill: ${textColor} }
+      .icon { fill: ${iconColor} }
+    `,
+    });
+    card.setHideBorder(hide_border);
+    // `role="img"` hides the inner text from assistive tech, so everything the card
+    // shows has to be repeated here.
+    card.setAccessibilityLabel({
+        title: card.title,
+        desc: `${desc}. Language: ${languageName}, Stars: ${totalStars}, Forks: ${totalForks}`,
+    });
+    return card.render(`
+    ${descriptionSvg}
+
+    <g transform="translate(30, ${height - 75})">
+        ${starAndForkCount}
+    </g>
+  `);
+};
+export { renderGistCard };

package/build/cards/index.d.ts

@@ -0,0 +1,11 @@
+export { renderGistCard } from './gist.js';
+export { renderRepoCard } from './repo.js';
+export { RANK_ICONS, renderStatsCard } from './stats.js';
+export { TOP_LANG_LAYOUTS, TOP_LANG_STATS_FORMATS, renderTopLanguages } from './top-languages.js';
+export { DISPLAY_FORMATS, WAKATIME_LAYOUTS, renderWakatimeCard } from './wakatime.js';
+export type { CardOptions, CommonCardOptions } from './options.js';
+export type { GistData, Lang, RepositoryData, StatsData, TopLangData, WakaTimeData, } from '../fetchers/types.js';
+export { renderError } from '../common/render.js';
+export { themes } from '../themes/index.js';
+export type { ThemeName } from '../themes/index.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtF,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGnE,YAAY,EACV,QAAQ,EACR,IAAI,EACJ,cAAc,EACd,SAAS,EACT,WAAW,EACX,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/build/cards/index.js

@@ -0,0 +1,7 @@
+export { renderGistCard } from './gist.js';
+export { renderRepoCard } from './repo.js';
+export { RANK_ICONS, renderStatsCard } from './stats.js';
+export { TOP_LANG_LAYOUTS, TOP_LANG_STATS_FORMATS, renderTopLanguages } from './top-languages.js';
+export { DISPLAY_FORMATS, WAKATIME_LAYOUTS, renderWakatimeCard } from './wakatime.js';
+export { renderError } from '../common/render.js';
+export { themes } from '../themes/index.js';

package/build/cards/options.d.ts

@@ -0,0 +1,19 @@
+import type { ColorParams } from '../common/color.js';
+/**
+ * Options every card accepts.
+ * Cards spread these into `getLightDarkColors`, hence {@link ColorParams}.
+ */
+export interface CommonCardOptions extends ColorParams {
+    title_color: string;
+    icon_color: string;
+    text_color: string;
+    bg_color: string;
+    border_radius: number;
+    border_color: string;
+    hide_border: boolean;
+}
+/** `Partial<T>` that also accepts an explicit `undefined`, as api handlers forward. */
+export type CardOptions<T> = {
+    [K in keyof T]?: T[K] | undefined;
+};
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/cards/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,uFAAuF;AACvF,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;CAAE,CAAC"}

package/build/cards/options.js

@@ -0,0 +1 @@
+export {};

package/build/cards/repo.d.ts

@@ -0,0 +1,25 @@
+import type { RepositoryData } from '../fetchers/types.js';
+import type { CardOptions, CommonCardOptions } from './options.js';
+interface RepoCardOptions extends CommonCardOptions {
+    locale: string;
+    show_owner: boolean;
+    browser_rendering: boolean;
+    description_lines_count: number;
+    card_width_input: number;
+    show: Array<string>;
+    show_icons: boolean;
+    number_format: string;
+    text_bold: boolean;
+    line_height: number | string;
+    username: string;
+}
+/**
+ * Renders repository card details.
+ *
+ * @param repo Repository data.
+ * @param options Card options.
+ * @returns Repository card SVG object.
+ */
+declare const renderRepoCard: (repo: RepositoryData, options?: CardOptions<RepoCardOptions>) => string;
+export { renderRepoCard };
+//# sourceMappingURL=repo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repo.d.ts","sourceRoot":"","sources":["../../src/cards/repo.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,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;AAsCD;;;;;;GAMG;AACH,QAAA,MAAM,cAAc,GAClB,MAAM,cAAc,EACpB,UAAS,WAAW,CAAC,eAAe,CAAM,KACzC,MA4RF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/build/cards/repo.js

@@ -0,0 +1,276 @@
+import { Card } from '../common/Card.js';
+import { getLightDarkColors } from '../common/color.js';
+import { kFormatter, wrapTextMultiline } from '../common/fmt.js';
+import { encodeHTML } from '../common/html.js';
+import { I18n } from '../common/I18n.js';
+import { icons } from '../common/icons.js';
+import { buildSearchFilter, clampValue, parseEmojis } from '../common/ops.js';
+import { countWrappedLines, createLanguageNode, createTextNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
+import { repoCardLocales } from '../translations.js';
+const ICON_SIZE = 16;
+const CARD_DEFAULT_WIDTH = 400;
+const X_OFFSET = 25;
+const DESCRIPTION_FONT_SIZE = 13;
+const DESCRIPTION_LINE_HEIGHT_PX = 16;
+const DESCRIPTION_MAX_LINES = 3;
+/**
+ * Retrieves the repository description and wraps it to fit the card width.
+ *
+ * @param label The repository description.
+ * @param xOffset Horizontal offset of the badge.
+ * @returns Wrapped repo description SVG object.
+ */
+const getBadgeSVG = (label, xOffset = 0) => {
+    if (!Number.isFinite(xOffset)) {
+        throw new Error(`Invalid xOffset: "${xOffset}"`);
+    }
+    return `
+    <g data-testid="badge" class="badge" transform="translate(${320 + xOffset}, -18)">
+      <rect stroke-width="1" width="70" height="20" x="-12" y="-14" ry="10" rx="10"></rect>
+      <text
+        x="23" y="-5"
+        alignment-baseline="central"
+        dominant-baseline="central"
+        text-anchor="middle"
+      >
+        ${encodeHTML(label)}
+      </text>
+    </g>
+  `;
+};
+/**
+ * Renders repository card details.
+ *
+ * @param repo Repository data.
+ * @param options Card options.
+ * @returns Repository card SVG object.
+ */
+const renderRepoCard = (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 && !isNaN(card_width_input)
+        ? card_width_input
+        : show.length >= 2
+            ? CARD_DEFAULT_WIDTH + 30
+            : CARD_DEFAULT_WIDTH;
+    const i18n = new I18n({
+        locale,
+        translations: repoCardLocales,
+    });
+    const repoFilter = encodeURIComponent(buildSearchFilter([nameWithOwner], []));
+    const encodedUsername = encodeURIComponent(username ?? '');
+    const STATS = {};
+    if (show.includes('prs_authored')) {
+        STATS['prs_authored'] = {
+            icon: icons.prs,
+            label: i18n.t('repocard.prs-authored'),
+            value: totalPRsAuthored,
+            id: 'prs_authored',
+            link: `https://github.com/search?q=${repoFilter}author%3A${encodedUsername}&amp;type=pullrequests`,
+        };
+    }
+    if (show.includes('prs_commented')) {
+        STATS['prs_commented'] = {
+            icon: icons.comments,
+            label: i18n.t('repocard.prs-commented'),
+            value: totalPRsCommented,
+            id: 'prs_commented',
+            link: `https://github.com/search?q=${repoFilter}commenter%3A${encodedUsername}+-author%3A${encodedUsername}&amp;type=pullrequests`,
+        };
+    }
+    if (show.includes('prs_reviewed')) {
+        STATS['prs_reviewed'] = {
+            icon: icons.reviews,
+            label: i18n.t('repocard.prs-reviewed'),
+            value: totalPRsReviewed,
+            id: 'prs_reviewed',
+            link: `https://github.com/search?q=${repoFilter}reviewed-by%3A${encodedUsername}+-author%3A${encodedUsername}&amp;type=pullrequests`,
+        };
+    }
+    if (show.includes('issues_authored')) {
+        STATS['issues_authored'] = {
+            icon: icons.issues,
+            label: i18n.t('repocard.issues-authored'),
+            value: totalIssuesAuthored,
+            id: 'issues_authored',
+            link: `https://github.com/search?q=${repoFilter}author%3A${encodedUsername}&amp;type=issues`,
+        };
+    }
+    if (show.includes('issues_commented')) {
+        STATS['issues_commented'] = {
+            icon: icons.discussions_started,
+            label: i18n.t('repocard.issues-commented'),
+            value: totalIssuesCommented,
+            id: 'issues_commented',
+            link: `https://github.com/search?q=${repoFilter}commenter%3A${encodedUsername}+-author%3A${encodedUsername}&amp;type=issues`,
+        };
+    }
+    const statItems = Object.values(STATS).map((stat, index) => 
+    // create the text nodes, and pass index so that we can calculate the line spacing
+    createTextNode({
+        icon: stat.icon,
+        label: stat.label,
+        value: stat.value ?? 0,
+        id: stat.id,
+        unitSymbol: stat.unitSymbol,
+        index,
+        showIcons: show_icons,
+        shiftValuePos: 14.01,
+        bold: text_bold,
+        numberFormat: number_format,
+        link: stat.link,
+        labelXOffset: 23,
+    }));
+    const extraLHeight = parseInt(String(line_height), 10);
+    const lineHeight = 10;
+    const header = show_owner ? nameWithOwner : name;
+    const langName = (primaryLanguage && primaryLanguage.name) || 'Unspecified';
+    const langColor = (primaryLanguage && primaryLanguage.color) || '#333';
+    const desc = parseEmojis(description || 'No description provided');
+    const descriptionBoxWidth = card_width - 2 * X_OFFSET;
+    let descriptionLinesCount;
+    let descriptionSvg;
+    if (browser_rendering) {
+        // The browser performs the actual text wrapping inside the foreignObject;
+        // we only estimate the line count server-side so the SVG can reserve enough
+        // height. The estimate uses measureText for font-aware widths instead of a
+        // fixed character count.
+        descriptionLinesCount = description_lines_count
+            ? clampValue(description_lines_count, 1, DESCRIPTION_MAX_LINES)
+            : countWrappedLines(desc, DESCRIPTION_FONT_SIZE, descriptionBoxWidth, DESCRIPTION_MAX_LINES);
+        descriptionSvg = wrappedTextNode({
+            text: desc,
+            x: X_OFFSET,
+            y: -3,
+            width: descriptionBoxWidth,
+            height: descriptionLinesCount * DESCRIPTION_LINE_HEIGHT_PX + 10, // 10px extra for "descenders" like g, j, q, p, y
+            lineCount: descriptionLinesCount,
+            className: 'description',
+            testId: 'description-text',
+        });
+    }
+    else {
+        const descriptionMaxLines = description_lines_count
+            ? clampValue(description_lines_count, 1, DESCRIPTION_MAX_LINES)
+            : DESCRIPTION_MAX_LINES;
+        const multiLineDescription = wrapTextMultiline(desc, descriptionBoxWidth, DESCRIPTION_FONT_SIZE, descriptionMaxLines);
+        descriptionLinesCount = description_lines_count
+            ? clampValue(description_lines_count, 1, DESCRIPTION_MAX_LINES)
+            : multiLineDescription.length;
+        descriptionSvg = multiLineDescription
+            .map((line) => `<tspan dy="1.2em" x="${X_OFFSET}">${encodeHTML(line)}</tspan>`)
+            .join('');
+        descriptionSvg = `<text class="description" x="${X_OFFSET}" y="-5"> 
+      ${descriptionSvg}
+    </text>`;
+    }
+    const extraHeight = Object.keys(STATS).length
+        ? -7 + (Math.ceil(statItems.length / 2) + 1) * extraLHeight
+        : 0;
+    const height = (descriptionLinesCount > 1 ? 120 : 110) + descriptionLinesCount * lineHeight + extraHeight;
+    const { lightColors, darkColors } = getLightDarkColors({ ...options, theme });
+    const svgLanguage = primaryLanguage ? createLanguageNode(langName, langColor) : '';
+    const totalStars = kFormatter(stargazerCount);
+    const totalForks = kFormatter(forkCount);
+    const svgStars = iconWithLabel(icons.star, totalStars, 'stargazers', ICON_SIZE);
+    const svgForks = iconWithLabel(icons.fork, totalForks, 'forkcount', ICON_SIZE);
+    const starAndForkCount = flexLayout({
+        items: [svgLanguage, svgStars, svgForks],
+        sizes: [
+            measureText(langName, 12),
+            ICON_SIZE + measureText(`${totalStars}`, 12),
+            ICON_SIZE + measureText(`${totalForks}`, 12),
+        ],
+        gap: 25,
+    }).join('');
+    const extraRows = [];
+    for (let i = 0; i < statItems.length; i += 2) {
+        extraRows.push(flexLayout({
+            items: statItems.slice(i, i + 2),
+            gap: 210,
+            direction: 'row',
+        }).join(''));
+    }
+    const extraItems = `
+  <svg x="0" y="0"><g transform="translate(-3, ${height - 52 - extraHeight})">
+      ${flexLayout({
+        items: extraRows,
+        gap: extraLHeight,
+        direction: 'column',
+    }).join('')}
+    </g></svg>
+    `;
+    const card = new Card({
+        defaultTitle: header.length > 35 ? `${header.slice(0, 35)}...` : header,
+        titlePrefixIcon: icons.contribs,
+        width: card_width,
+        height,
+        border_radius,
+        colors: { light: lightColors, dark: darkColors },
+    });
+    card.disableAnimations();
+    card.setHideBorder(hide_border);
+    card.setHideTitle(false);
+    card.setCSS({
+        light: ({ textColor, iconColor }) => `
+    .description {
+      font: 400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif;fill: ${textColor};
+      ${browser_rendering ? wrappedTextStyles(textColor) : ''}
+    }
+    .gray { font: 400 12px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${textColor} }
+    .badge { font: 600 11px 'Segoe UI', Ubuntu, Sans-Serif; }
+    .badge rect { opacity: 0.2; stroke: ${textColor} }
+    .badge text { fill: ${textColor} }
+
+    .stat { font: 400 12px 'Segoe UI', Ubuntu, Sans-Serif; fill: ${textColor} }
+    .stagger {
+      opacity: 0;
+      animation: fadeInAnimation 0.3s ease-in-out forwards;
+    }
+    .not_bold { font-weight: 400 }
+    .bold { font-weight: 700 }
+    .icon {
+      fill: ${iconColor};
+      display: block;
+    }
+  `,
+        dark: ({ textColor, iconColor }) => `
+      .description {
+        fill: ${textColor};
+        ${browser_rendering ? wrappedTextStyles(textColor) : ''}
+      }
+      .gray { fill: ${textColor} }
+      .badge rect { stroke: ${textColor} }
+      .badge text { fill: ${textColor} }
+      .stat { fill: ${textColor} }
+      .icon { fill: ${iconColor}; }
+    `,
+    });
+    const extraStatLabels = Object.values(STATS)
+        .map((stat) => `${stat.label}: ${stat.value ?? 0}`)
+        .join(', ');
+    // `role="img"` hides the inner text from assistive tech, so everything the card
+    // shows has to be repeated here.
+    // Only translated or language-neutral text: the card honours `locale`, and there is no
+    // translated vocabulary for "stars" or "forks", so those counts stay out rather than
+    // announce themselves in English over a card rendered in another language.
+    card.setAccessibilityLabel({
+        title: card.title,
+        desc: [`${desc}.`, primaryLanguage ? langName : '', extraStatLabels].filter(Boolean).join(', '),
+    });
+    return card.render(`
+    ${isTemplate
+        ? getBadgeSVG(i18n.t('repocard.template'), card_width - CARD_DEFAULT_WIDTH)
+        : isArchived
+            ? getBadgeSVG(i18n.t('repocard.archived'), card_width - CARD_DEFAULT_WIDTH)
+            : ''}
+
+    ${descriptionSvg}
+
+    <g transform="translate(30, ${height - 75 - extraHeight})">
+      ${starAndForkCount}
+    </g>
+    ${extraItems}
+  `);
+};
+export { renderRepoCard };

package/build/cards/stats.d.ts

@@ -0,0 +1,37 @@
+import type { StatsData } from '../fetchers/types.js';
+import type { CardOptions, CommonCardOptions } from './options.js';
+/** Rank indicators the card can draw; the api validates `rank_icon` against this. */
+declare const RANK_ICONS: readonly ["default", "github", "percentile"];
+type RankIcon = (typeof RANK_ICONS)[number];
+interface StatCardOptions extends CommonCardOptions {
+    locale: string;
+    hide: Array<string>;
+    show_icons: boolean;
+    hide_title: boolean;
+    card_width: number;
+    hide_rank: boolean;
+    include_all_commits: boolean;
+    commits_year: number;
+    line_height: number | string;
+    custom_title: string;
+    disable_animations: boolean;
+    number_format: string;
+    number_precision: number;
+    ring_color: string;
+    text_bold: boolean;
+    rank_icon: RankIcon;
+    show: Array<string>;
+}
+/**
+ * Renders the stats card.
+ *
+ * @param stats The stats data.
+ * @param options The card options.
+ * @param username GitHub username, used to build stat search links.
+ * @param repo Repositories to scope the search links to.
+ * @param owner Owners to scope the search links to.
+ * @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 };
+//# sourceMappingURL=stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../src/cards/stats.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AASnE,qFAAqF;AACrF,QAAA,MAAM,UAAU,8CAA+C,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;AAiLD;;;;;;;;;GASG;AACH,QAAA,MAAM,eAAe,GACnB,OAAO,SAAS,EAChB,UAAS,WAAW,CAAC,eAAe,CAAM,EAC1C,WAAW,MAAM,EACjB,OAAM,KAAK,CAAC,MAAM,CAAM,EACxB,QAAO,KAAK,CAAC,MAAM,CAAM,KACxB,MAyXF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,CAAC"}