@stats-forge/github-stats-forge-cli 0.1.0 → 0.3.0

package/build/cards.d.ts

@@ -14,7 +14,7 @@ export interface CardOption {
     /** What the prompt asks. */
     label: string;
     kind: OptionKind;
-    /** The accepted values, for `choice`. */
+    /** The accepted values, for `choice` and for a `list` whose values are a closed set. */
     choices?: ReadonlyArray<string>;
     /** Shown under the prompt, for anything the label cannot say. */
     hint?: string;
@@ -32,6 +32,8 @@ export interface CardKind {
     /** @returns The rendered card, or the rendered error. */
     render: (query: Record<string, string>, config: CardConfig) => Promise<ApiResult>;
 }
+/** Colors and the theme, which every card accepts. */
+export declare const COMMON_OPTIONS: ReadonlyArray<CardOption>;
 /** Every card, with the options every card shares appended to its own. */
 export declare const cards: ReadonlyArray<CardKind>;
 /**

package/build/cards.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../src/cards.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAEtF;;;;;GAKG;AAEH,iFAAiF;AACjF,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpE,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,yCAAyC;IACzC,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,+CAA+C;IAC/C,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,yDAAyD;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACnF;AAkSD,0EAA0E;AAC1E,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAGvC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,QAAQ,GAAG,SAAiD,CAAC"}
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../src/cards.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAEtF;;;;;GAKG;AAEH,iFAAiF;AACjF,KAAK,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEpE,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,wFAAwF;IACxF,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gEAAgE;AAChE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACpC,+CAA+C;IAC/C,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACnC,yDAAyD;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CACnF;AAID,sDAAsD;AACtD,eAAO,MAAM,cAAc,EAAE,aAAa,CAAC,UAAU,CA8BpD,CAAC;AAkTF,0EAA0E;AAC1E,eAAO,MAAM,KAAK,EAAE,aAAa,CAAC,QAAQ,CAGvC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,QAAQ,GAAG,SAAiD,CAAC"}

package/build/cards.js

@@ -1,7 +1,7 @@
-import { gist, pin, stats, themes, topLangs, wakatime, } from '@stats-forge/github-stats-forge-core/api';
+import { contributedTo, gist, pin, stats, themes, topLangs, wakatime, } from '@stats-forge/github-stats-forge-core/api';
 const THEME_NAMES = Object.keys(themes);
 /** Colors and the theme, which every card accepts. */
-const COMMON_OPTIONS = [
+export const COMMON_OPTIONS = [
     {
         name: 'theme',
         label: 'Theme',
@@ -32,6 +32,18 @@ const COMMON_OPTIONS = [
     { name: 'border_radius', label: 'Border radius', kind: 'number' },
     { name: 'hide_border', label: 'Hide the border', kind: 'boolean' },
 ];
+/**
+ * The two ends of a card's date range.
+ *
+ * @returns The pair, naming what it counts.
+ */
+const rangeOptions = (counted) => {
+    const hint = 'A year, a month or a day: 2024, 2024-03, 2024-03-15';
+    return [
+        { name: 'from', label: `Count ${counted} from`, kind: 'text', hint },
+        { name: 'to', label: `Count ${counted} up to`, kind: 'text', hint },
+    ];
+};
 const LOCALE_OPTION = {
     name: 'locale',
     label: 'Locale',
@@ -49,13 +61,13 @@ const CARDS = [
                 name: 'show',
                 label: 'Extra stats to show',
                 kind: 'list',
-                hint: 'e.g. reviews,discussions_started,prs_merged,contributions',
+                choices: stats.OPTIONS.show,
             },
             {
                 name: 'hide',
                 label: 'Stats to hide',
                 kind: 'list',
-                hint: 'e.g. stars,commits,prs,issues,contribs',
+                choices: stats.OPTIONS.hide,
             },
             { name: 'show_icons', label: 'Show the stat icons', kind: 'boolean' },
             { name: 'hide_rank', label: 'Hide the rank circle', kind: 'boolean' },
@@ -63,19 +75,14 @@ const CARDS = [
                 name: 'rank_icon',
                 label: 'Rank indicator',
                 kind: 'choice',
-                choices: stats.RANK_ICONS,
+                choices: stats.OPTIONS.rank_icon,
             },
             {
                 name: 'include_all_commits',
                 label: 'Count commits of all time',
                 kind: 'boolean',
             },
-            {
-                name: 'commits_year',
-                label: 'Count commits for one year',
-                kind: 'number',
-                hint: 'Four digits, e.g. 2025',
-            },
+            ...rangeOptions('commits'),
             {
                 name: 'exclude_repo',
                 label: 'Repositories to exclude',
@@ -95,7 +102,7 @@ const CARDS = [
                 name: 'role',
                 label: 'Owner affiliations to include',
                 kind: 'list',
-                hint: 'OWNER, COLLABORATOR, ORGANIZATION_MEMBER',
+                choices: stats.OPTIONS.role,
             },
             {
                 name: 'contribs_include_own_repos',
@@ -111,7 +118,7 @@ const CARDS = [
                 name: 'number_format',
                 label: 'Number format',
                 kind: 'choice',
-                choices: ['short', 'long'],
+                choices: stats.OPTIONS.number_format,
             },
             {
                 name: 'number_precision',
@@ -126,7 +133,7 @@ const CARDS = [
             { name: 'ring_color', label: 'Rank ring color', kind: 'text' },
             LOCALE_OPTION,
         ],
-        render: (query, config) => stats(query, config),
+        render: stats,
     },
     {
         id: 'top-langs',
@@ -138,7 +145,7 @@ const CARDS = [
                 name: 'layout',
                 label: 'Layout',
                 kind: 'choice',
-                choices: topLangs.LAYOUTS,
+                choices: topLangs.OPTIONS.layout,
             },
             { name: 'langs_count', label: 'Languages to show', kind: 'number' },
             { name: 'hide', label: 'Languages to hide', kind: 'list' },
@@ -157,7 +164,7 @@ const CARDS = [
                 name: 'stats_format',
                 label: 'Show values as',
                 kind: 'choice',
-                choices: topLangs.STATS_FORMATS,
+                choices: topLangs.OPTIONS.stats_format,
             },
             {
                 name: 'hide_progress',
@@ -170,7 +177,12 @@ const CARDS = [
                 label: 'Progress bar background color',
                 kind: 'text',
             },
-            { name: 'role', label: 'Owner affiliations to include', kind: 'list' },
+            {
+                name: 'role',
+                label: 'Owner affiliations to include',
+                kind: 'list',
+                choices: topLangs.OPTIONS.role,
+            },
             { name: 'custom_title', label: 'Card title', kind: 'text' },
             { name: 'hide_title', label: 'Hide the title', kind: 'boolean' },
             { name: 'card_width', label: 'Card width', kind: 'number' },
@@ -181,7 +193,7 @@ const CARDS = [
             },
             LOCALE_OPTION,
         ],
-        render: (query, config) => topLangs(query, config),
+        render: topLangs,
     },
     {
         id: 'pin',
@@ -197,7 +209,7 @@ const CARDS = [
                 name: 'show',
                 label: 'Extra stats to show',
                 kind: 'list',
-                hint: 'e.g. prs_authored,issues_commented',
+                choices: pin.OPTIONS.show,
             },
             { name: 'show_icons', label: 'Show the stat icons', kind: 'boolean' },
             {
@@ -217,11 +229,48 @@ const CARDS = [
                 name: 'number_format',
                 label: 'Number format',
                 kind: 'choice',
-                choices: ['short', 'long'],
+                choices: pin.OPTIONS.number_format,
+            },
+            LOCALE_OPTION,
+        ],
+        render: pin,
+    },
+    {
+        id: 'contributed-to',
+        label: 'Contributed to — repositories you work on, ranked',
+        needsToken: true,
+        required: [{ name: 'username', label: 'GitHub username', kind: 'text' }],
+        options: [
+            { name: 'repos_count', label: 'Repositories to show', kind: 'number' },
+            {
+                name: 'include_own_repos',
+                label: 'Include your own repositories',
+                kind: 'boolean',
+            },
+            {
+                name: 'exclude_repo',
+                label: 'Repositories to exclude',
+                kind: 'list',
+                hint: 'Each one an owner/name, or just the name',
+            },
+            ...rangeOptions('contributions'),
+            {
+                name: 'hide_years',
+                label: 'Hide the year marks',
+                kind: 'boolean',
+                hint: 'One mark per contribution year, filled for the years that repo got one',
+            },
+            { name: 'custom_title', label: 'Card title', kind: 'text' },
+            { name: 'hide_title', label: 'Hide the title', kind: 'boolean' },
+            { name: 'card_width', label: 'Card width', kind: 'number' },
+            {
+                name: 'disable_animations',
+                label: 'Disable the animations',
+                kind: 'boolean',
             },
             LOCALE_OPTION,
         ],
-        render: (query, config) => pin(query, config),
+        render: contributedTo,
     },
     {
         id: 'gist',
@@ -235,8 +284,9 @@ const CARDS = [
                 label: 'Let the browser wrap the description',
                 kind: 'boolean',
             },
+            LOCALE_OPTION,
         ],
-        render: (query, config) => gist(query, config),
+        render: gist,
     },
     {
         id: 'wakatime',
@@ -248,13 +298,13 @@ const CARDS = [
                 name: 'layout',
                 label: 'Layout',
                 kind: 'choice',
-                choices: wakatime.LAYOUTS,
+                choices: wakatime.OPTIONS.layout,
             },
             {
                 name: 'display_format',
                 label: 'Show values as',
                 kind: 'choice',
-                choices: wakatime.DISPLAY_FORMATS,
+                choices: wakatime.OPTIONS.display_format,
             },
             { name: 'langs_count', label: 'Languages to show', kind: 'number' },
             { name: 'hide', label: 'Languages to hide', kind: 'list' },
@@ -280,7 +330,7 @@ const CARDS = [
             },
             LOCALE_OPTION,
         ],
-        render: (query, config) => wakatime(query, config),
+        render: wakatime,
     },
 ];
 /** Every card, with the options every card shares appended to its own. */

package/build/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;GAKG;AAEH,mCAAmC;AACnC,eAAO,MAAM,QAAQ,QAAO,OAAO,CAAC,QAAQ,CAIxC,CAAC;AA6BL,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,sDAAsD;AACtD,MAAM,WAAW,IAAI;IACnB,uCAAuC;IACvC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,SACpB,QAAQ,QACR,IAAI,WACD,MAAM,KACd,OAAO,CAAC,UAAU,CAmCpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAgB,QAAQ,KAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAY7E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,eAAsB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAMhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAa,OAAO,CAAC,MAAM,GAAG,SAAS,CAM3D,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAGzC;;;;;GAKG;AAEH,mCAAmC;AACnC,eAAO,MAAM,QAAQ,QAAO,OAAO,CAAC,QAAQ,CAIxC,CAAC;AAuCL,gDAAgD;AAChD,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,sDAAsD;AACtD,MAAM,WAAW,IAAI;IACnB,uCAAuC;IACvC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,MAAM,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe,SACpB,QAAQ,QACR,IAAI,WACD,MAAM,KACd,OAAO,CAAC,UAAU,CAmCpB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAgB,QAAQ,KAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAY7E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,eAAsB,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAMhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,QAAa,OAAO,CAAC,MAAM,GAAG,SAAS,CAM3D,CAAC"}

package/build/prompts.js

@@ -1,4 +1,4 @@
-import { confirm, input, password, select } from '@inquirer/prompts';
+import { checkbox, confirm, input, password, select } from '@inquirer/prompts';
 import { cards } from './cards.js';
 import { describeAnswer } from './query.js';
 /**
@@ -22,6 +22,15 @@ const askOption = async (option, current) => {
     if (option.kind === 'boolean') {
         return confirm({ message, default: current === true });
     }
+    if (option.kind === 'list' && option.choices) {
+        const chosen = new Set(Array.isArray(current) ? current : []);
+        const picked = await checkbox({
+            message,
+            pageSize: 15,
+            choices: option.choices.map((value) => ({ value, checked: chosen.has(value) })),
+        });
+        return picked.length > 0 ? picked : undefined;
+    }
     if (option.kind === 'choice') {
         const choices = [
             { name: '— leave unset —', value: undefined },

package/build/saved-card.d.ts

@@ -25,7 +25,8 @@ export declare const writeSavedCard: (path: string, card: CardKind, options: Rec
  * Turns saved options back into answers the menu can show and edit.
  *
  * Everything on a query string is a string;
- * a boolean option becomes one again so its prompt opens on the right answer.
+ * a boolean becomes one again, and a list splits back into its values,
+ * so each prompt opens on the answer it was saved with.
  *
  * @returns The answers, ready for the menu.
  */

package/build/saved-card.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"saved-card.d.ts","sourceRoot":"","sources":["../src/saved-card.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAiBzC;;GAEG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,OAAmD,CAAC;AAEnG;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,SAClB,MAAM,KACX,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAyB7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,SACnB,MAAM,QACN,QAAQ,WACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,OAAO,CAAC,MAAM,CAKhB,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,SAAU,QAAQ,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAW7F,CAAC"}
+{"version":3,"file":"saved-card.d.ts","sourceRoot":"","sources":["../src/saved-card.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAiBzC;;GAEG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,KAAG,OAAmD,CAAC;AAEnG;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,SAClB,MAAM,KACX,OAAO,CAAC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAyB7D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,SACnB,MAAM,QACN,QAAQ,WACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC9B,OAAO,CAAC,MAAM,CAKhB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,SAAU,QAAQ,WAAW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAuB7F,CAAC"}

package/build/saved-card.js

@@ -49,14 +49,28 @@ export const writeSavedCard = async (path, card, options) => {
  * Turns saved options back into answers the menu can show and edit.
  *
  * Everything on a query string is a string;
- * a boolean option becomes one again so its prompt opens on the right answer.
+ * a boolean becomes one again, and a list splits back into its values,
+ * so each prompt opens on the answer it was saved with.
  *
  * @returns The answers, ready for the menu.
  */
 export const toAnswers = (card, options) => {
     const kinds = new Map([...card.required, ...card.options].map((option) => [option.name, option.kind]));
-    return new Map(Object.entries(options).map(([name, value]) => [
-        name,
-        kinds.get(name) === 'boolean' ? value === 'true' : value,
-    ]));
+    const toAnswer = (name, value) => {
+        switch (kinds.get(name)) {
+            case 'boolean': {
+                return value === 'true';
+            }
+            case 'list': {
+                return value
+                    .split(',')
+                    .map((item) => item.trim())
+                    .filter(Boolean);
+            }
+            default: {
+                return value;
+            }
+        }
+    };
+    return new Map(Object.entries(options).map(([name, value]) => [name, toAnswer(name, value)]));
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stats-forge/github-stats-forge-cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Render a GitHub stats card to a local SVG file, one prompt at a time",
   "keywords": [
     "cli",
@@ -34,6 +34,10 @@
     ".": {
       "@stats/source": "./src/index.ts",
       "default": "./build/index.js"
+    },
+    "./cards": {
+      "@stats/source": "./src/cards.ts",
+      "default": "./build/cards.js"
     }
   },
   "publishConfig": {
@@ -41,7 +45,7 @@
   },
   "dependencies": {
     "@inquirer/prompts": "8.7.0",
-    "@stats-forge/github-stats-forge-core": "^0.1.0"
+    "@stats-forge/github-stats-forge-core": "^0.3.0"
   },
   "devDependencies": {
     "vitest": "4.1.11"

package/src/cards.ts

@@ -1,4 +1,5 @@
 import {
+  contributedTo,
   gist,
   pin,
   stats,
@@ -25,7 +26,7 @@ export interface CardOption {
   /** What the prompt asks. */
   label: string;
   kind: OptionKind;
-  /** The accepted values, for `choice`. */
+  /** The accepted values, for `choice` and for a `list` whose values are a closed set. */
   choices?: ReadonlyArray<string>;
   /** Shown under the prompt, for anything the label cannot say. */
   hint?: string;
@@ -48,7 +49,7 @@ export interface CardKind {
 const THEME_NAMES = Object.keys(themes);
 
 /** Colors and the theme, which every card accepts. */
-const COMMON_OPTIONS: ReadonlyArray<CardOption> = [
+export const COMMON_OPTIONS: ReadonlyArray<CardOption> = [
   {
     name: 'theme',
     label: 'Theme',
@@ -80,6 +81,19 @@ const COMMON_OPTIONS: ReadonlyArray<CardOption> = [
   { name: 'hide_border', label: 'Hide the border', kind: 'boolean' },
 ];
 
+/**
+ * The two ends of a card's date range.
+ *
+ * @returns The pair, naming what it counts.
+ */
+const rangeOptions = (counted: string): ReadonlyArray<CardOption> => {
+  const hint = 'A year, a month or a day: 2024, 2024-03, 2024-03-15';
+  return [
+    { name: 'from', label: `Count ${counted} from`, kind: 'text', hint },
+    { name: 'to', label: `Count ${counted} up to`, kind: 'text', hint },
+  ];
+};
+
 const LOCALE_OPTION: CardOption = {
   name: 'locale',
   label: 'Locale',
@@ -98,13 +112,13 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'show',
         label: 'Extra stats to show',
         kind: 'list',
-        hint: 'e.g. reviews,discussions_started,prs_merged,contributions',
+        choices: stats.OPTIONS.show,
       },
       {
         name: 'hide',
         label: 'Stats to hide',
         kind: 'list',
-        hint: 'e.g. stars,commits,prs,issues,contribs',
+        choices: stats.OPTIONS.hide,
       },
       { name: 'show_icons', label: 'Show the stat icons', kind: 'boolean' },
       { name: 'hide_rank', label: 'Hide the rank circle', kind: 'boolean' },
@@ -112,19 +126,14 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'rank_icon',
         label: 'Rank indicator',
         kind: 'choice',
-        choices: stats.RANK_ICONS,
+        choices: stats.OPTIONS.rank_icon,
       },
       {
         name: 'include_all_commits',
         label: 'Count commits of all time',
         kind: 'boolean',
       },
-      {
-        name: 'commits_year',
-        label: 'Count commits for one year',
-        kind: 'number',
-        hint: 'Four digits, e.g. 2025',
-      },
+      ...rangeOptions('commits'),
       {
         name: 'exclude_repo',
         label: 'Repositories to exclude',
@@ -144,7 +153,7 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'role',
         label: 'Owner affiliations to include',
         kind: 'list',
-        hint: 'OWNER, COLLABORATOR, ORGANIZATION_MEMBER',
+        choices: stats.OPTIONS.role,
       },
       {
         name: 'contribs_include_own_repos',
@@ -160,7 +169,7 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'number_format',
         label: 'Number format',
         kind: 'choice',
-        choices: ['short', 'long'],
+        choices: stats.OPTIONS.number_format,
       },
       {
         name: 'number_precision',
@@ -175,7 +184,7 @@ const CARDS: ReadonlyArray<CardKind> = [
       { name: 'ring_color', label: 'Rank ring color', kind: 'text' },
       LOCALE_OPTION,
     ],
-    render: (query, config) => stats(query, config),
+    render: stats,
   },
   {
     id: 'top-langs',
@@ -187,7 +196,7 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'layout',
         label: 'Layout',
         kind: 'choice',
-        choices: topLangs.LAYOUTS,
+        choices: topLangs.OPTIONS.layout,
       },
       { name: 'langs_count', label: 'Languages to show', kind: 'number' },
       { name: 'hide', label: 'Languages to hide', kind: 'list' },
@@ -206,7 +215,7 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'stats_format',
         label: 'Show values as',
         kind: 'choice',
-        choices: topLangs.STATS_FORMATS,
+        choices: topLangs.OPTIONS.stats_format,
       },
       {
         name: 'hide_progress',
@@ -219,7 +228,12 @@ const CARDS: ReadonlyArray<CardKind> = [
         label: 'Progress bar background color',
         kind: 'text',
       },
-      { name: 'role', label: 'Owner affiliations to include', kind: 'list' },
+      {
+        name: 'role',
+        label: 'Owner affiliations to include',
+        kind: 'list',
+        choices: topLangs.OPTIONS.role,
+      },
       { name: 'custom_title', label: 'Card title', kind: 'text' },
       { name: 'hide_title', label: 'Hide the title', kind: 'boolean' },
       { name: 'card_width', label: 'Card width', kind: 'number' },
@@ -230,7 +244,7 @@ const CARDS: ReadonlyArray<CardKind> = [
       },
       LOCALE_OPTION,
     ],
-    render: (query, config) => topLangs(query, config),
+    render: topLangs,
   },
   {
     id: 'pin',
@@ -246,7 +260,7 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'show',
         label: 'Extra stats to show',
         kind: 'list',
-        hint: 'e.g. prs_authored,issues_commented',
+        choices: pin.OPTIONS.show,
       },
       { name: 'show_icons', label: 'Show the stat icons', kind: 'boolean' },
       {
@@ -266,11 +280,48 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'number_format',
         label: 'Number format',
         kind: 'choice',
-        choices: ['short', 'long'],
+        choices: pin.OPTIONS.number_format,
+      },
+      LOCALE_OPTION,
+    ],
+    render: pin,
+  },
+  {
+    id: 'contributed-to',
+    label: 'Contributed to — repositories you work on, ranked',
+    needsToken: true,
+    required: [{ name: 'username', label: 'GitHub username', kind: 'text' }],
+    options: [
+      { name: 'repos_count', label: 'Repositories to show', kind: 'number' },
+      {
+        name: 'include_own_repos',
+        label: 'Include your own repositories',
+        kind: 'boolean',
+      },
+      {
+        name: 'exclude_repo',
+        label: 'Repositories to exclude',
+        kind: 'list',
+        hint: 'Each one an owner/name, or just the name',
+      },
+      ...rangeOptions('contributions'),
+      {
+        name: 'hide_years',
+        label: 'Hide the year marks',
+        kind: 'boolean',
+        hint: 'One mark per contribution year, filled for the years that repo got one',
+      },
+      { name: 'custom_title', label: 'Card title', kind: 'text' },
+      { name: 'hide_title', label: 'Hide the title', kind: 'boolean' },
+      { name: 'card_width', label: 'Card width', kind: 'number' },
+      {
+        name: 'disable_animations',
+        label: 'Disable the animations',
+        kind: 'boolean',
       },
       LOCALE_OPTION,
     ],
-    render: (query, config) => pin(query, config),
+    render: contributedTo,
   },
   {
     id: 'gist',
@@ -284,8 +335,9 @@ const CARDS: ReadonlyArray<CardKind> = [
         label: 'Let the browser wrap the description',
         kind: 'boolean',
       },
+      LOCALE_OPTION,
     ],
-    render: (query, config) => gist(query, config),
+    render: gist,
   },
   {
     id: 'wakatime',
@@ -297,13 +349,13 @@ const CARDS: ReadonlyArray<CardKind> = [
         name: 'layout',
         label: 'Layout',
         kind: 'choice',
-        choices: wakatime.LAYOUTS,
+        choices: wakatime.OPTIONS.layout,
       },
       {
         name: 'display_format',
         label: 'Show values as',
         kind: 'choice',
-        choices: wakatime.DISPLAY_FORMATS,
+        choices: wakatime.OPTIONS.display_format,
       },
       { name: 'langs_count', label: 'Languages to show', kind: 'number' },
       { name: 'hide', label: 'Languages to hide', kind: 'list' },
@@ -329,7 +381,7 @@ const CARDS: ReadonlyArray<CardKind> = [
       },
       LOCALE_OPTION,
     ],
-    render: (query, config) => wakatime(query, config),
+    render: wakatime,
   },
 ];
 

package/src/prompts.ts

@@ -1,4 +1,4 @@
-import { confirm, input, password, select } from '@inquirer/prompts';
+import { checkbox, confirm, input, password, select } from '@inquirer/prompts';
 
 import type { CardKind, CardOption } from './cards.ts';
 import { cards } from './cards.ts';
@@ -31,6 +31,16 @@ const askOption = async (option: CardOption, current: Answer): Promise<Answer> =
     return confirm({ message, default: current === true });
   }
 
+  if (option.kind === 'list' && option.choices) {
+    const chosen = new Set(Array.isArray(current) ? current : []);
+    const picked = await checkbox({
+      message,
+      pageSize: 15,
+      choices: option.choices.map((value) => ({ value, checked: chosen.has(value) })),
+    });
+    return picked.length > 0 ? picked : undefined;
+  }
+
   if (option.kind === 'choice') {
     const choices = [
       { name: '— leave unset —', value: undefined as Answer },

package/src/saved-card.ts

@@ -15,7 +15,7 @@ import type { Answer } from './query.ts';
 
 /** A card and the answers it was rendered from: the shape of the file. */
 interface SavedCard {
-  /** Which card: `stats`, `top-langs`, `pin`, `gist`, `wakatime`. */
+  /** Which card, by the id the catalog gives it. */
   card: string;
   /** The options, exactly as they reach the endpoint. */
   options: Record<string, string>;
@@ -82,7 +82,8 @@ export const writeSavedCard = async (
  * Turns saved options back into answers the menu can show and edit.
  *
  * Everything on a query string is a string;
- * a boolean option becomes one again so its prompt opens on the right answer.
+ * a boolean becomes one again, and a list splits back into its values,
+ * so each prompt opens on the answer it was saved with.
  *
  * @returns The answers, ready for the menu.
  */
@@ -91,10 +92,22 @@ export const toAnswers = (card: CardKind, options: Record<string, string>): Map<
     [...card.required, ...card.options].map((option) => [option.name, option.kind]),
   );
 
-  return new Map(
-    Object.entries(options).map(([name, value]) => [
-      name,
-      kinds.get(name) === 'boolean' ? value === 'true' : value,
-    ]),
-  );
+  const toAnswer = (name: string, value: string): Answer => {
+    switch (kinds.get(name)) {
+      case 'boolean': {
+        return value === 'true';
+      }
+      case 'list': {
+        return value
+          .split(',')
+          .map((item) => item.trim())
+          .filter(Boolean);
+      }
+      default: {
+        return value;
+      }
+    }
+  };
+
+  return new Map(Object.entries(options).map(([name, value]) => [name, toAnswer(name, value)]));
 };