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

package/build/api/top-langs.js

@@ -2,10 +2,10 @@ import * as z from 'zod/mini';
 import { TOP_LANG_LAYOUTS, TOP_LANG_STATS_FORMATS, renderTopLanguages, } from '../cards/top-languages.js';
 import { fetchTopLanguages } from '../fetchers/top-languages.js';
 import { errorResult } from './api-result.js';
-import { booleanParam, enumParam, listParam, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, safeParam, } from './params.js';
+import { booleanParam, enumParam, listParam, localeParam, looseIntParam, numberParam, parseColorParams, parseParams, rawParam, usernameParam, } from './params.js';
 /** What the top-languages endpoint accepts, on top of the shared color params. */
 const topLangsQuery = z.object({
-    username: safeParam,
+    username: usernameParam,
     hide: listParam,
     hide_title: booleanParam,
     hide_border: booleanParam,
@@ -27,26 +27,6 @@ const topLangsQuery = z.object({
 /**
  * Render the top languages card for a set of query params.
  *
- * @param query Raw query params, plus any of the shared color params.
- * @param query.username GitHub username.
- * @param query.hide Comma-separated languages to hide.
- * @param query.hide_title Whether to hide the card title.
- * @param query.hide_border Whether to hide the card border.
- * @param query.card_width Card width.
- * @param query.layout How the languages are laid out.
- * @param query.langs_count Number of languages to show.
- * @param query.exclude_repo Comma-separated repositories to exclude.
- * @param query.size_weight Weight given to a language's size.
- * @param query.count_weight Weight given to a language's repository count.
- * @param query.custom_title Card title.
- * @param query.locale Language the card is rendered in.
- * @param query.border_radius Card border radius.
- * @param query.role Comma-separated owner affiliations to include.
- * @param query.disable_animations Whether to disable the card animations.
- * @param query.hide_progress Whether to hide the progress bars.
- * @param query.hide_values Whether to hide the language values.
- * @param query.stats_format Whether values are shown as bytes or percentages.
- * @param config Deployment config supplying the PAT pool.
  * @returns The rendered card, or a rendered error.
  */
 const renderTopLangs = async (query, config) => {
@@ -54,9 +34,9 @@ const renderTopLangs = async (query, config) => {
     try {
         colors = parseColorParams(query);
     }
-    catch (err) {
+    catch (error) {
         // A rejected color cannot be used to draw its own error card.
-        return errorResult(err);
+        return errorResult(error);
     }
     try {
         const { username, hide, hide_title, hide_border, card_width, layout, langs_count, exclude_repo, size_weight, count_weight, custom_title, locale, border_radius, role, disable_animations, hide_progress, hide_values, stats_format, } = parseParams(topLangsQuery, query);
@@ -87,8 +67,8 @@ const renderTopLangs = async (query, config) => {
             }),
         };
     }
-    catch (err) {
-        return errorResult(err, colors);
+    catch (error) {
+        return errorResult(error, colors);
     }
 };
 /**

package/build/api/wakatime.d.ts

@@ -1,7 +1,7 @@
 import * as z from 'zod/mini';
-import type { CardConfig } from '../common/config.js';
-import type { ApiResult } from './api-result.js';
-import type { ApiQuery } from './params.js';
+import type { CardConfig } from '../common/config.ts';
+import type { ApiResult } from './api-result.ts';
+import type { ApiQuery } from './params.ts';
 /** What the wakatime endpoint accepts, on top of the shared color params. */
 declare const wakatimeQuery: z.ZodMiniObject<{
     username: z.ZodMiniType<string | undefined, string | undefined, z.core.$ZodTypeInternals<string | undefined, string | undefined>>;
@@ -17,16 +17,24 @@ declare const wakatimeQuery: z.ZodMiniObject<{
     hide: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<string[], string | undefined>>;
     api_domain: z.ZodMiniOptional<z.ZodMiniString<string>>;
     border_radius: z.ZodMiniType<number | undefined, string | undefined, z.core.$ZodTypeInternals<number | undefined, string | undefined>>;
-    display_format: z.ZodMiniType<"time" | "percent" | undefined, string | undefined, z.core.$ZodTypeInternals<"time" | "percent" | undefined, string | undefined>>;
+    display_format: z.ZodMiniType<"percent" | "time" | undefined, string | undefined, z.core.$ZodTypeInternals<"percent" | "time" | undefined, string | undefined>>;
     disable_animations: z.ZodMiniPipe<z.ZodMiniOptional<z.ZodMiniString<string>>, z.ZodMiniTransform<boolean | undefined, string | undefined>>;
 }, z.core.$strip>;
 /** The query this endpoint accepts, checked against the schema above. */
 type WakatimeApiQuery = ApiQuery<typeof wakatimeQuery>;
+/**
+ * Render the WakaTime card for a set of query params.
+ *
+ * WakaTime needs no GitHub token, so the config is read only for the transport it carries.
+ *
+ * @returns The rendered card, or a rendered error.
+ */
+declare const renderWakatime: (query: WakatimeApiQuery, config: CardConfig) => Promise<ApiResult>;
 /**
  * The card, with the values its enum params accept.
  * A UI reads them off the function it calls, e.g. `wakatime.LAYOUTS`.
  */
-export declare const wakatime: ((query: WakatimeApiQuery, config: CardConfig) => Promise<ApiResult>) & {
+export declare const wakatime: typeof renderWakatime & {
     LAYOUTS: readonly ["compact", "normal"];
     DISPLAY_FORMATS: readonly ["time", "percent"];
 };

package/build/api/wakatime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wakatime.d.ts","sourceRoot":"","sources":["../../src/api/wakatime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAc5C,6EAA6E;AAC7E,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;iBAgBjB,CAAC;AAEH,yEAAyE;AACzE,KAAK,gBAAgB,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAgFvD;;;GAGG;AACH,eAAO,MAAM,QAAQ,WA1DgB,gBAAgB,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CAAC;;;CA6D5F,CAAC"}
+{"version":3,"file":"wakatime.d.ts","sourceRoot":"","sources":["../../src/api/wakatime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAc5C,6EAA6E;AAC7E,QAAA,MAAM,aAAa;;;;;;;;;;;;;;;;iBAgBjB,CAAC;AAEH,yEAAyE;AACzE,KAAK,gBAAgB,GAAG,QAAQ,CAAC,OAAO,aAAa,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,QAAA,MAAM,cAAc,UAAiB,gBAAgB,UAAU,UAAU,KAAG,OAAO,CAAC,SAAS,CAoD5F,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;CAGnB,CAAC"}

package/build/api/wakatime.js

@@ -26,23 +26,6 @@ const wakatimeQuery = z.object({
  *
  * WakaTime needs no GitHub token, so the config is read only for the transport it carries.
  *
- * @param query Raw query params, plus any of the shared color params.
- * @param query.username WakaTime username.
- * @param query.hide_border Whether to hide the card border.
- * @param query.card_width Card width.
- * @param query.line_height Line height between the languages.
- * @param query.hide_title Whether to hide the card title.
- * @param query.hide_progress Whether to hide the progress bars.
- * @param query.custom_title Card title.
- * @param query.locale Language the card is rendered in.
- * @param query.layout How the languages are laid out.
- * @param query.langs_count Number of languages to show.
- * @param query.hide Comma-separated languages to hide.
- * @param query.api_domain WakaTime instance the stats are read from.
- * @param query.border_radius Card border radius.
- * @param query.display_format Whether values are shown as time or percentages.
- * @param query.disable_animations Whether to disable the card animations.
- * @param config Deployment config supplying the transport.
  * @returns The rendered card, or a rendered error.
  */
 const renderWakatime = async (query, config) => {
@@ -50,9 +33,9 @@ const renderWakatime = async (query, config) => {
     try {
         colors = parseColorParams(query);
     }
-    catch (err) {
+    catch (error) {
         // A rejected color cannot be used to draw its own error card.
-        return errorResult(err);
+        return errorResult(error);
     }
     try {
         const { username, hide_border, card_width, line_height, hide_title, hide_progress, custom_title, locale, layout, langs_count, hide, api_domain, border_radius, display_format, disable_animations, } = parseParams(wakatimeQuery, query);
@@ -77,8 +60,8 @@ const renderWakatime = async (query, config) => {
             }),
         };
     }
-    catch (err) {
-        return errorResult(err, colors);
+    catch (error) {
+        return errorResult(error, colors);
     }
 };
 /**

package/build/calculateRank.d.ts

@@ -1,15 +1,6 @@
 /**
  * Calculates the users rank.
  *
- * @param params Parameters on which the user's rank depends.
- * @param params.all_commits Whether `include_all_commits` was used.
- * @param params.commits Number of commits.
- * @param params.prs The number of pull requests.
- * @param params.issues The number of issues.
- * @param params.reviews The number of reviews.
- * @param params.repos Total number of repos (accepted for compatibility, unused in the calculation).
- * @param params.stars The number of stars.
- * @param params.followers The number of followers.
  * @returns The users rank.
  */
 declare function calculateRank({ all_commits, commits, prs, issues, reviews, stars, followers, }: {

package/build/calculateRank.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calculateRank.d.ts","sourceRoot":"","sources":["../src/calculateRank.ts"],"names":[],"mappings":"AAqBA;;;;;;;;;;;;;GAaG;AACH,iBAAS,aAAa,CAAC,EACrB,WAAW,EACX,OAAO,EACP,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,SAAS,GACV,EAAE;IACD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAoCxC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}
+{"version":3,"file":"calculateRank.d.ts","sourceRoot":"","sources":["../src/calculateRank.ts"],"names":[],"mappings":"AAmBA;;;;GAIG;AACH,iBAAS,aAAa,CAAC,EACrB,WAAW,EACX,OAAO,EACP,GAAG,EACH,MAAM,EACN,OAAO,EACP,KAAK,EACL,SAAS,GACV,EAAE;IACD,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAoCxC;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

package/build/calculateRank.js

@@ -1,7 +1,6 @@
 /**
  * Calculates the exponential cdf.
  *
- * @param x The value.
  * @returns The exponential cdf.
  */
 function exponential_cdf(x) {
@@ -10,7 +9,6 @@ function exponential_cdf(x) {
 /**
  * Calculates the log normal cdf.
  *
- * @param x The value.
  * @returns The log normal cdf.
  */
 function log_normal_cdf(x) {
@@ -20,24 +18,21 @@ function log_normal_cdf(x) {
 /**
  * Calculates the users rank.
  *
- * @param params Parameters on which the user's rank depends.
- * @param params.all_commits Whether `include_all_commits` was used.
- * @param params.commits Number of commits.
- * @param params.prs The number of pull requests.
- * @param params.issues The number of issues.
- * @param params.reviews The number of reviews.
- * @param params.repos Total number of repos (accepted for compatibility, unused in the calculation).
- * @param params.stars The number of stars.
- * @param params.followers The number of followers.
  * @returns The users rank.
  */
 function calculateRank({ all_commits, commits, prs, issues, reviews, stars, followers, }) {
-    const COMMITS_MEDIAN = all_commits ? 1000 : 250, COMMITS_WEIGHT = 2;
-    const PRS_MEDIAN = 50, PRS_WEIGHT = 3;
-    const ISSUES_MEDIAN = 25, ISSUES_WEIGHT = 1;
-    const REVIEWS_MEDIAN = 2, REVIEWS_WEIGHT = 1;
-    const STARS_MEDIAN = 50, STARS_WEIGHT = 4;
-    const FOLLOWERS_MEDIAN = 10, FOLLOWERS_WEIGHT = 1;
+    const COMMITS_MEDIAN = all_commits ? 1000 : 250;
+    const COMMITS_WEIGHT = 2;
+    const PRS_MEDIAN = 50;
+    const PRS_WEIGHT = 3;
+    const ISSUES_MEDIAN = 25;
+    const ISSUES_WEIGHT = 1;
+    const REVIEWS_MEDIAN = 2;
+    const REVIEWS_WEIGHT = 1;
+    const STARS_MEDIAN = 50;
+    const STARS_WEIGHT = 4;
+    const FOLLOWERS_MEDIAN = 10;
+    const FOLLOWERS_WEIGHT = 1;
     const TOTAL_WEIGHT = COMMITS_WEIGHT + PRS_WEIGHT + ISSUES_WEIGHT + REVIEWS_WEIGHT + STARS_WEIGHT + FOLLOWERS_WEIGHT;
     const THRESHOLDS = [1, 12.5, 25, 37.5, 50, 62.5, 75, 87.5, 100];
     const LEVELS = ['S', 'A+', 'A', 'A-', 'B+', 'B', 'B-', 'C+', 'C'];

package/build/cards/gist.d.ts

@@ -1,5 +1,5 @@
-import type { GistData } from '../fetchers/types.js';
-import type { CardOptions, CommonCardOptions } from './options.js';
+import type { GistData } from '../fetchers/types.ts';
+import type { CardOptions, CommonCardOptions } from './options.ts';
 interface GistCardOptions extends CommonCardOptions {
     show_owner: boolean;
     browser_rendering: boolean;
@@ -7,8 +7,6 @@ interface GistCardOptions extends CommonCardOptions {
 /**
  * Render gist card.
  *
- * @param gistData Gist data.
- * @param options Gist card options.
  * @returns Gist card.
  */
 declare const renderGistCard: (gistData: GistData, options?: CardOptions<GistCardOptions>) => string;

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;AAErD,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;;;;;;GAMG;AACH,QAAA,MAAM,cAAc,GAAI,UAAU,QAAQ,EAAE,UAAS,WAAW,CAAC,eAAe,CAAM,KAAG,MA6HxF,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC"}
+{"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"}

package/build/cards/gist.js

@@ -1,11 +1,11 @@
-import { default as Card } from '../common/Card.js';
+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 { kFormatter } from '../common/fmt.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';
+import { countWrappedLines, wrapTextMultiline, createLanguageNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
+import { el, rule } from '../markup/index.js';
 const ICON_SIZE = 16;
 const CARD_DEFAULT_WIDTH = 400;
 const X_OFFSET = 25;
@@ -17,8 +17,6 @@ const DESCRIPTION_MAX_LINES = 10;
 /**
  * Render gist card.
  *
- * @param gistData Gist data.
- * @param options Gist card options.
  * @returns Gist card.
  */
 const renderGistCard = (gistData, options = {}) => {
@@ -49,12 +47,7 @@ const renderGistCard = (gistData, options = {}) => {
         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>`;
+        descriptionSvg = el('text', { class: 'description', x: X_OFFSET, y: -5 }, multiLineDescription.map((line) => el('tspan', { dy: '1.2em', x: X_OFFSET }, line)));
     }
     const lineHeight = descriptionLines > 3 ? 12 : 10;
     const height = (descriptionLines > 1 ? 120 : 110) + descriptionLines * lineHeight;
@@ -73,7 +66,7 @@ const renderGistCard = (gistData, options = {}) => {
             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,
@@ -84,22 +77,23 @@ const renderGistCard = (gistData, options = {}) => {
         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} }
-    `,
+        light: ({ textColor, iconColor }) => [
+            rule('.description', {
+                font: `400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif`,
+                fill: textColor,
+                ...(browser_rendering ? wrappedTextStyles(textColor) : {}),
+            }),
+            rule('.gray', { font: "400 12px 'Segoe UI', Ubuntu, Sans-Serif", fill: textColor }),
+            rule('.icon', { fill: iconColor }),
+        ],
+        dark: ({ textColor, iconColor }) => [
+            rule('.description', {
+                fill: textColor,
+                ...(browser_rendering ? wrappedTextStyles(textColor) : {}),
+            }),
+            rule('.gray', { fill: textColor }),
+            rule('.icon', { fill: iconColor }),
+        ],
     });
     card.setHideBorder(hide_border);
     // `role="img"` hides the inner text from assistive tech, so everything the card
@@ -108,12 +102,9 @@ const renderGistCard = (gistData, options = {}) => {
         title: card.title,
         desc: `${desc}. Language: ${languageName}, Stars: ${totalStars}, Forks: ${totalForks}`,
     });
-    return card.render(`
-    ${descriptionSvg}
-
-    <g transform="translate(30, ${height - 75})">
-        ${starAndForkCount}
-    </g>
-  `);
+    return card.render([
+        descriptionSvg,
+        el('g', { transform: `translate(30, ${height - 75})` }, starAndForkCount),
+    ]);
 };
 export { renderGistCard };

package/build/cards/options.d.ts

@@ -1,4 +1,4 @@
-import type { ColorParams } from '../common/color.js';
+import type { ColorParams } from '../common/color.ts';
 /**
  * Options every card accepts.
  * Cards spread these into `getLightDarkColors`, hence {@link ColorParams}.

package/build/cards/repo.d.ts

@@ -1,5 +1,5 @@
-import type { RepositoryData } from '../fetchers/types.js';
-import type { CardOptions, CommonCardOptions } from './options.js';
+import type { RepositoryData } from '../fetchers/types.ts';
+import type { CardOptions, CommonCardOptions } from './options.ts';
 interface RepoCardOptions extends CommonCardOptions {
     locale: string;
     show_owner: boolean;
@@ -16,8 +16,6 @@ interface RepoCardOptions extends CommonCardOptions {
 /**
  * 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;

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;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"}
+{"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"}

package/build/cards/repo.js

@@ -1,11 +1,11 @@
 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 { 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, createLanguageNode, createTextNode, flexLayout, iconWithLabel, measureText, wrappedTextNode, wrappedTextStyles, } from '../common/render.js';
+import { 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;
@@ -16,39 +16,29 @@ 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}"`);
+        throw new TypeError(`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>
-  `;
+    return el('g', { 'data-testid': 'badge', class: 'badge', transform: `translate(${320 + xOffset}, -18)` }, el('rect', { 'stroke-width': 1, width: 70, height: 20, x: -12, y: -14, ry: 10, rx: 10 }), el('text', {
+        x: 23,
+        y: -5,
+        'alignment-baseline': 'central',
+        'dominant-baseline': 'central',
+        'text-anchor': 'middle',
+    }, label));
 };
 /**
  * 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)
+    const card_width = card_width_input && !Number.isNaN(card_width_input)
         ? card_width_input
         : show.length >= 2
             ? CARD_DEFAULT_WIDTH + 30
@@ -121,11 +111,11 @@ const renderRepoCard = (repo, options = {}) => {
         link: stat.link,
         labelXOffset: 23,
     }));
-    const extraLHeight = parseInt(String(line_height), 10);
+    const extraLHeight = Number.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 langName = primaryLanguage?.name || 'Unspecified';
+    const langColor = primaryLanguage?.color || '#333';
     const desc = parseEmojis(description || 'No description provided');
     const descriptionBoxWidth = card_width - 2 * X_OFFSET;
     let descriptionLinesCount;
@@ -157,19 +147,12 @@ const renderRepoCard = (repo, options = {}) => {
         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>`;
+        descriptionSvg = el('text', { class: 'description', x: X_OFFSET, y: -5 }, multiLineDescription.map((line) => el('tspan', { dy: '1.2em', x: X_OFFSET }, line)));
     }
-    const extraHeight = Object.keys(STATS).length
-        ? -7 + (Math.ceil(statItems.length / 2) + 1) * extraLHeight
-        : 0;
+    const extraHeight = Object.keys(STATS).length > 0 ? -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 svgLanguage = primaryLanguage ? createLanguageNode(langName, langColor) : undefined;
     const totalStars = kFormatter(stargazerCount);
     const totalForks = kFormatter(forkCount);
     const svgStars = iconWithLabel(icons.star, totalStars, 'stargazers', ICON_SIZE);
@@ -182,24 +165,16 @@ const renderRepoCard = (repo, options = {}) => {
             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 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,
@@ -212,39 +187,36 @@ const renderRepoCard = (repo, options = {}) => {
     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}; }
-    `,
+        light: ({ textColor, iconColor }) => [
+            rule('.description', {
+                font: `400 ${DESCRIPTION_FONT_SIZE}px 'Segoe UI', Ubuntu, Sans-Serif`,
+                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('.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('.stagger', {
+                opacity: 0,
+                animation: 'fadeInAnimation 0.3s ease-in-out forwards',
+            }),
+            rule('.not_bold', { 'font-weight': 400 }),
+            rule('.bold', { 'font-weight': 700 }),
+            rule('.icon', { fill: iconColor, display: 'block' }),
+        ],
+        dark: ({ textColor, iconColor }) => [
+            rule('.description', {
+                fill: textColor,
+                ...(browser_rendering ? wrappedTextStyles(textColor) : {}),
+            }),
+            rule('.gray', { fill: textColor }),
+            rule('.badge rect', { stroke: textColor }),
+            rule('.badge text', { fill: textColor }),
+            rule('.stat', { fill: textColor }),
+            rule('.icon', { fill: iconColor }),
+        ],
     });
     const extraStatLabels = Object.values(STATS)
         .map((stat) => `${stat.label}: ${stat.value ?? 0}`)
@@ -258,19 +230,15 @@ const renderRepoCard = (repo, options = {}) => {
         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}
-  `);
+    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)
+                : undefined,
+        descriptionSvg,
+        el('g', { transform: `translate(30, ${height - 75 - extraHeight})` }, starAndForkCount),
+        extraItems,
+    ]);
 };
 export { renderRepoCard };

package/build/cards/stats.d.ts

@@ -1,7 +1,7 @@
-import type { StatsData } from '../fetchers/types.js';
-import type { CardOptions, CommonCardOptions } from './options.js';
+import type { StatsData } from '../fetchers/types.ts';
+import type { CardOptions, CommonCardOptions } from './options.ts';
 /** Rank indicators the card can draw; the api validates `rank_icon` against this. */
-declare const RANK_ICONS: readonly ["default", "github", "percentile"];
+declare const RANK_ICONS: readonly ['default', 'github', 'percentile'];
 type RankIcon = (typeof RANK_ICONS)[number];
 interface StatCardOptions extends CommonCardOptions {
     locale: string;
@@ -25,11 +25,6 @@ interface StatCardOptions extends CommonCardOptions {
 /**
  * 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;