@underactive/pi-topping 0.6.1 → 0.6.3

package/README.md

@@ -6,7 +6,7 @@ We garnish our pies. It seemed rude not to extend Pi the same courtesy. This is
 
 ![Example of pi-topping's decorated user prompt](https://raw.githubusercontent.com/underactive/pi-topping/main/media/demo_user_prompt.png)
 
-**“Working” Loader** — animated spinner (with color choice), randomized activity word, optional word packs, shimmer (with direction, speed, and invert option), token activity monitor (with color, direction, and dim toggle), elapsed timer, output token display, and live output-token rate (with color choice and dim toggle) — all arrangeable left to right.
+**“Working” Loader** — animated spinner (with color choice), randomized activity word, optional word packs, shimmer (with direction, speed, and invert option), token activity monitor (with color, direction, and dim toggle), elapsed timer, output token display, and live output-token rate (with color choice and dim toggle) — all arrangeable left to right. During a blocking extension prompt, the loader switches to a stable dim waiting line with a pulsing indicator, then resumes afterward.
 
 ![Demo of pi-topping's shimmering activity word, scrolling activity meter, elapsed timer, token count, and token rate](https://raw.githubusercontent.com/underactive/pi-topping/main/media/demo.gif)
 
@@ -71,6 +71,12 @@ Run `/topping-settings` (TUI only) to customize your toppings. Settings persist
 ║    [■] Mid-turn inputs                                ON   ║
 ║                                                            ║
 ╟─ Word Packs ───────────────────────────────────────────────╢
+║    [ ] Doctor Who                                    OFF   ║
+║    [ ] Firefly                                       OFF   ║
+║    [ ] Hitchhiker's Guide                            OFF   ║
+║    [ ] The Lord of the Rings                         OFF   ║
+║    [ ] The Matrix                                    OFF   ║
+║    [ ] Portal                                        OFF   ║
 ║    [ ] SimCity                                       OFF   ║
 ║    [ ] Star Trek                                     OFF   ║
 ║    [ ] Star Wars                                     OFF   ║
@@ -78,15 +84,16 @@ Run `/topping-settings` (TUI only) to customize your toppings. Settings persist
 ╟─ Options ──────────────────────────────────────────────────╢
 ║    [■] Use NerdFont icons                             ON   ║
 ╟────────────────────────────────────────────────────────────╢
-║  ↑↓ move  ←→ select  ␣ toggle  ⏎ apply  esc cancel         ║
-╚════════════════════════════════════════════════════[ 9/41 ]╝
+║  ↑↓ move  PgUp/PgDn page  ←→ select                       ║
+║  ␣ toggle  ⏎ apply  esc cancel                            ║
+╚════════════════════════════════════════════════════[ 9/47 ]╝
 ```
 
 ### Word packs
 
-Base activity words are always available. All word packs, including the shipped **SimCity**, **Star Trek**, and **Star Wars** packs and custom packs, are disabled by default. Enable packs in `/topping-settings` to add their entries to the same uniformly selected pool. When Randomize “Worked” text is on, the completion marker uses the selected entry’s matching past tense; otherwise it uses `Worked`.
+Base activity words are always available. All word packs, including the shipped **Doctor Who**, **Firefly**, **Hitchhiker's Guide**, **The Lord of the Rings**, **The Matrix**, **Portal**, **SimCity**, **Star Trek**, and **Star Wars** packs and custom packs, are disabled by default. Enable packs in `/topping-settings` to add their entries to the same uniformly selected pool. When Randomize “Worked” text is on, the completion marker uses the selected entry’s matching past tense; otherwise it uses `Worked`.
 
-Bundled packs live in [`wordpacks/`](wordpacks/). Copy `wordpacks/simcity.json`, `wordpacks/star-trek.json`, or `wordpacks/star-wars.json` to `~/.pi/agent/pi-topping/word-packs.json`, then change the pack `id` (the bundled `simcity`, `star-trek`, and `star-wars` IDs are reserved), name, and words:
+Bundled packs live in [`wordpacks/`](wordpacks/). Copy `wordpacks/doctor-who.json`, `wordpacks/firefly.json`, `wordpacks/hitchhikers-guide.json`, `wordpacks/lord-of-the-rings.json`, `wordpacks/matrix.json`, `wordpacks/portal.json`, `wordpacks/simcity.json`, `wordpacks/star-trek.json`, or `wordpacks/star-wars.json` to `~/.pi/agent/pi-topping/word-packs.json`, then change the pack `id` (the bundled `doctor-who`, `firefly`, `hitchhikers-guide`, `lord-of-the-rings`, `matrix`, `portal`, `simcity`, `star-trek`, and `star-wars` IDs are reserved), name, and words:
 
 ```json
 {
@@ -122,7 +129,7 @@ Restart Pi (or run `/reload`) to pick it up.
 
 ## Requirements
 
-- [Pi](https://github.com/earendil-works/pi-coding-agent)
+- [Pi](https://github.com/earendil-works/pi-coding-agent). Pi ≥0.84.4 is required for the waiting-for-input loader state; older Pi versions keep the animated loader.
 - Node.js ≥22.19.0
 
 ## Development

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@underactive/pi-topping",
-  "version": "0.6.1",
+  "version": "0.6.3",
   "description": "A Pi extension that adds quality of life improvements to Pi's UX: a high-vis user prompt, a shimmering working loader with token activity meter and elapsed timer, and an end-of-turn completion marker",
   "keywords": ["pi-package", "pi-extension"],
   "license": "MIT",
@@ -30,8 +30,8 @@
     "@earendil-works/pi-tui": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-coding-agent": "0.82.1",
-    "@earendil-works/pi-tui": "0.82.1",
+    "@earendil-works/pi-coding-agent": "0.84.4",
+    "@earendil-works/pi-tui": "0.84.4",
     "@types/node": "^24.0.0",
     "typescript": "^5.9.3"
   },

package/src/menu.ts

@@ -5,27 +5,14 @@
  *
  * Renders a titled box containing one or more sections of boolean toggle,
  * multi-value cycle, or drag-to-reorder items, plus an optional live-updating
- * preview section driven by a caller-supplied render callback, e.g.:
- *
- *   ╔═[ Pi Topping: Settings ]════════════════════════╗
- *   ╟─ Preview ────────────────────────────────────╢
- *   ║                                                  ║
- *   ║ ⠋ Cerebrating… ⣤⣤⣤⣤  28 tok/s · 3s · ↓ 84 tokens ║
- *   ║                                                  ║
- *   ╟─ Decorations ───────────────────────────────────╢
- *   ║  ❯ [■] Animated spinner                    ON   ║
- *   ║    [ ] "Working..." text shimmer           OFF   ║
- *   ║                                                  ║
- *   ╟──────────────────────────────────────────────────╢
- *   ║  ↑↓ move  ␣ toggle  ⏎ apply  esc cancel          ║
- *   ╚══════════════════════════════════════════[ 1/2 ]═╝
+ * preview section driven by a caller-supplied render callback.
  *
  * Intended to be reused by any extension that needs a simple modal toggle
  * menu; it has no dependency on this extension's own settings shape.
  */
 
 import type { ExtensionCommandContext, Theme } from "@earendil-works/pi-coding-agent";
-import { type Component, Key, matchesKey, truncateToWidth, type TUI, visibleWidth } from "@earendil-works/pi-tui";
+import { type Component, Key, matchesKey, truncateToWidth, type SizeValue, type TUI, visibleWidth } from "@earendil-works/pi-tui";
 
 export type MenuValue = boolean | string;
 
@@ -79,6 +66,8 @@ export interface MenuConfig {
 	preview?: (values: Record<string, MenuValue>, elapsedMs: number, activeItemId: string | undefined, width: number) => string[] | PreviewResult;
 	/** Optional heading for the preview block. Defaults to `Preview`. */
 	previewTitle?: string;
+	/** Maximum overlay height in rows or as a percentage of the terminal height. */
+	maxHeight?: SizeValue;
 }
 
 export interface MenuResult<T> {
@@ -86,7 +75,7 @@ export interface MenuResult<T> {
 	values: T;
 }
 
-const DEFAULT_HINTS = ["\u2191\u2193 move", "\u2423 toggle", "\u23ce apply", "esc cancel"];
+const DEFAULT_HINTS = ["\u2191\u2193 move", "PgUp/PgDn page", "\u2423 toggle", "\u23ce apply", "esc cancel"];
 const OVERLAY_WIDTH = "86%";
 export const DEFAULT_PREVIEW_WIDTH = 76;
 const ROW_PREFIX_WIDTH = 8; // "  " + marker + " " + "[" + box + "]" + " "
@@ -141,6 +130,7 @@ export class MenuComponent implements Component {
 	private readonly previewFn: MenuConfig["preview"];
 	private readonly previewOrigin: number | undefined;
 	private readonly tui: TUI | undefined;
+	private readonly maxHeight: SizeValue | undefined;
 	private previewTimer: ReturnType<typeof setTimeout> | undefined;
 	private previewNextRefreshMs: number | undefined;
 	private disposed = false;
@@ -149,6 +139,7 @@ export class MenuComponent implements Component {
 	private cachedWidth: number | undefined;
 	private cachedRows: number | undefined;
 	private cachedLines: string[] | undefined;
+	private pageItemCount: number | undefined;
 
 	constructor(
 		config: MenuConfig,
@@ -163,6 +154,7 @@ export class MenuComponent implements Component {
 		this.hints = config.hints ?? DEFAULT_HINTS;
 		this.previewTitle = config.previewTitle ?? "Preview";
 		this.tui = tui;
+		this.maxHeight = config.maxHeight;
 		this.values = buildInitialValues(config);
 		this.flat = [];
 		for (const [sectionIndex, section] of config.sections.entries()) {
@@ -203,7 +195,7 @@ export class MenuComponent implements Component {
 
 		// Map input to a normalized key name.
 		let mappedKey: string | undefined;
-		for (const k of [Key.up, Key.down, Key.left, Key.right, Key.space, Key.enter, Key.escape]) {
+		for (const k of [Key.up, Key.down, Key.pageUp, Key.pageDown, Key.left, Key.right, Key.space, Key.enter, Key.escape]) {
 			if (matchesKey(data, k)) {
 				mappedKey = k;
 				break;
@@ -214,14 +206,16 @@ export class MenuComponent implements Component {
 		const keyActions: Record<string, () => void> = {
 			[Key.up]: () => {
 				if (this.moveGrabbedItem(-1)) return;
-				this.cursor = (this.cursor - 1 + this.flat.length) % this.flat.length;
+				this.cursor = Math.max(0, this.cursor - 1);
 				this.invalidate();
 			},
 			[Key.down]: () => {
 				if (this.moveGrabbedItem(1)) return;
-				this.cursor = (this.cursor + 1) % this.flat.length;
+				this.cursor = Math.min(this.flat.length - 1, this.cursor + 1);
 				this.invalidate();
 			},
+			[Key.pageUp]: () => this.moveByPage(-1),
+			[Key.pageDown]: () => this.moveByPage(1),
 			[Key.left]: () => this.cycleCurrentValue(-1),
 			[Key.right]: () => this.cycleCurrentValue(1),
 			[Key.space]: () => {
@@ -258,9 +252,9 @@ export class MenuComponent implements Component {
 	}
 
 	/**
-	 * Move the grabbed reorder row one slot within its group, clamped at the group
-	 * edges. Returns true when the key belongs to the mover and must not also move
-	 * the cursor — which is what keeps a grab from escaping its group.
+	 * Move the grabbed reorder row within its group, clamped at the group edges.
+	 * Returns true when the key belongs to the mover and must not also move the
+	 * cursor — which is what keeps a grab from escaping its group.
 	 */
 	private moveGrabbedItem(delta: number): boolean {
 		const grabbed = this.flat[this.cursor]!;
@@ -272,10 +266,10 @@ export class MenuComponent implements Component {
 		let end = this.cursor;
 		while (end < this.flat.length - 1 && this.flat[end + 1]!.reorderGroup === group) end++;
 
-		const target = this.cursor + delta;
-		if (target >= start && target <= end) {
-			this.flat[this.cursor] = this.flat[target]!;
-			this.flat[target] = grabbed;
+		const target = Math.max(start, Math.min(end, this.cursor + delta));
+		if (target !== this.cursor) {
+			this.flat.splice(this.cursor, 1);
+			this.flat.splice(target, 0, grabbed);
 			this.cursor = target;
 			this.values[group] = this.flat.slice(start, end + 1).map(flat => flat.id).join(",");
 			this.invalidate();
@@ -283,6 +277,20 @@ export class MenuComponent implements Component {
 		return true;
 	}
 
+	private moveByPage(direction: -1 | 1): void {
+		const pageItemCount = this.getPageItemCount();
+		if (this.moveGrabbedItem(direction * pageItemCount)) return;
+		this.cursor = Math.max(0, Math.min(this.flat.length - 1, this.cursor + direction * pageItemCount));
+		this.invalidate();
+	}
+
+	private getPageItemCount(): number {
+		if (this.pageItemCount !== undefined) return this.pageItemCount;
+		const rows = this.availableRows();
+		if (rows === undefined) return Math.max(1, Math.min(this.flat.length, 10));
+		return Math.max(1, rows - 6);
+	}
+
 	private cycleCurrentValue(delta: number): void {
 		const item = this.flat[this.cursor]!;
 		if (!item.cycleValues?.length || (item.cycleEnabledBy && !this.values[item.cycleEnabledBy])) return;
@@ -377,10 +385,17 @@ export class MenuComponent implements Component {
 	private buildResponsiveToggleSections(innerWidth: number, maxRows: number, allLines: string[]): string[] {
 		if (allLines.length <= maxRows) {
 			this.scrollStart = 0;
+			this.pageItemCount = Math.max(1, this.flat.length);
 			return allLines;
 		}
-		if (maxRows <= 0) return [];
-		if (maxRows === 1) return this.buildToggleWindow(innerWidth, this.cursor, 1).lines;
+		if (maxRows <= 0) {
+			this.pageItemCount = 1;
+			return [];
+		}
+		if (maxRows === 1) {
+			this.pageItemCount = 1;
+			return this.buildToggleWindow(innerWidth, this.cursor, 1).lines;
+		}
 
 		const contentRows = maxRows - 1; // Reserve one fixed row for scroll status.
 		if (this.cursor < this.scrollStart) this.scrollStart = this.cursor;
@@ -405,6 +420,7 @@ export class MenuComponent implements Component {
 			}
 		}
 		const window = this.buildToggleWindow(innerWidth, this.scrollStart, contentRows);
+		this.pageItemCount = Math.max(1, window.end - this.scrollStart + 1);
 
 		const rows = [...window.lines];
 		while (rows.length < contentRows) rows.push(this.renderBlankRow(innerWidth));
@@ -417,8 +433,16 @@ export class MenuComponent implements Component {
 	}
 
 	private availableRows(): number | undefined {
-		const rows = (this.tui as (TUI & { terminal?: { rows?: number } }) | undefined)?.terminal?.rows;
-		return typeof rows === "number" && Number.isFinite(rows) && rows > 0 ? Math.floor(rows) : undefined;
+		const rows = this.tui?.terminal?.rows;
+		if (typeof rows !== "number" || !Number.isFinite(rows) || rows <= 0) return undefined;
+
+		const terminalRows = Math.floor(rows);
+		if (this.maxHeight === undefined) return terminalRows;
+		const requestedRows = typeof this.maxHeight === "number"
+			? this.maxHeight
+			: (Number.parseFloat(this.maxHeight) / 100) * terminalRows;
+		if (!Number.isFinite(requestedRows)) return terminalRows;
+		return Math.max(1, Math.min(terminalRows, Math.floor(requestedRows)));
 	}
 
 	private buildLines(maxWidth: number, maxRows?: number): string[] {
@@ -431,6 +455,7 @@ export class MenuComponent implements Component {
 		const naturalBody = this.buildToggleSections(innerWidth);
 		const naturalHeight = header.length + naturalBody.length + footer.length;
 		if (maxRows === undefined || naturalHeight <= maxRows) {
+			this.pageItemCount = Math.max(1, this.flat.length);
 			return [...header, ...naturalBody, ...footer].map(line => truncateToWidth(line, boxWidth, ""));
 		}
 
@@ -571,9 +596,10 @@ export async function showMenu<T extends Record<string, MenuValue>>(
 		return { applied: false, values: initialValues };
 	}
 
+	const maxHeight = config.maxHeight ?? "100%";
 	return ctx.ui.custom<MenuResult<T>>(
 		(tui, theme, _keybindings, done) =>
 			new MenuComponent(config, theme, done as (result: MenuResult<Record<string, MenuValue>>) => void, tui),
-		{ overlay: true, overlayOptions: { width: OVERLAY_WIDTH, maxHeight: "100%" } },
+		{ overlay: true, overlayOptions: { width: OVERLAY_WIDTH, maxHeight } },
 	);
 }

package/src/session.ts

@@ -47,8 +47,20 @@ type MessageStartEvent = Extract<ExtensionEvent, { type: "message_start" }>;
 type MessageUpdateEvent = Extract<ExtensionEvent, { type: "message_update" }>;
 type MessageEndEvent = Extract<ExtensionEvent, { type: "message_end" }>;
 type ToolExecutionStartEvent = Extract<ExtensionEvent, { type: "tool_execution_start" }>;
+type UIPromptStartEvent = Extract<ExtensionEvent, { type: "ui_prompt_start" }>;
+type UIPromptEndEvent = Extract<ExtensionEvent, { type: "ui_prompt_end" }>;
+type UIPromptKind = UIPromptStartEvent["kind"];
 
 const DONE_ENTRY_TYPE = "pi-topping-done";
+const WAITING_LABELS: Record<UIPromptKind, string> = {
+	select: "Waiting for selection",
+	confirm: "Waiting for confirmation",
+	input: "Waiting for input",
+	editor: "Waiting in editor",
+	custom: "Waiting for input",
+};
+const WAITING_PULSE_FRAMES = ["·", "•", "●", "•"];
+const WAITING_PULSE_INTERVAL_MS = 120;
 // Reconciliation resets the EMA at message boundaries, so retain and then fade the last rate to avoid flicker.
 const TOKEN_RATE_HOLD_MS = 1_500;
 const TOKEN_RATE_FADE_MS = 250;
@@ -74,6 +86,7 @@ interface SessionState {
 	tokenRateFadeStartsAt: number;
 	timer: ReturnType<typeof setInterval> | null;
 	busy: boolean;
+	waiting: { kind: UIPromptKind; title?: string } | null;
 	midTurnInputs: number;
 	/** Last string passed to setWorkingMessage(), or the NOT_SENT sentinel before the first call. */
 	lastMessage: string | undefined | typeof NOT_SENT;
@@ -106,11 +119,17 @@ function makeFreshState(): SessionState {
 		tokenRateFadeStartsAt: 0,
 		timer: null,
 		busy: false,
+		waiting: null,
 		midTurnInputs: 0,
 		lastMessage: NOT_SENT,
 	};
 }
 
+function waitingLabel(waiting: NonNullable<SessionState["waiting"]>): string {
+	const title = waiting.title ? stripControlChars(waiting.title).trim() : "";
+	return title ? `Waiting: ${title}` : WAITING_LABELS[waiting.kind];
+}
+
 /** Owns mutable extension state and Pi lifecycle registrations. */
 export class SessionManager {
 	#counter = new StreamingWordCounter();
@@ -225,6 +244,23 @@ export class SessionManager {
 		}
 	};
 
+	#onUIPromptStart = (event: UIPromptStartEvent, ctx: ExtensionContext): void => {
+		this.#currentCtx = ctx;
+		if (!this.usable(ctx) || !this.#state.busy) return;
+		this.#state.waiting = { kind: event.kind, title: event.title };
+		this.applyWaitingIndicator(ctx);
+		this.tick();
+	};
+
+	#onUIPromptEnd = (_event: UIPromptEndEvent, ctx: ExtensionContext): void => {
+		this.#currentCtx = ctx;
+		if (!this.usable(ctx) || !this.#state.waiting) return;
+		this.#state.waiting = null;
+		if (!this.#state.busy) return;
+		this.applyIndicator(ctx);
+		this.tick();
+	};
+
 	#onAgentSettled = async (_e: AgentSettledEvent, ctx: ExtensionContext): Promise<void> => {
 		this.#currentCtx = ctx;
 		if (!this.usable(ctx)) return;
@@ -232,6 +268,7 @@ export class SessionManager {
 		const hadPrompt = !!this.#state.startTime;
 		const elapsedMs = hadPrompt ? Date.now() - this.#state.startTime : 0;
 		this.#state.busy = false;
+		this.#state.waiting = null;
 		this.#state.startTime = 0;
 		this.#counter.reset();
 		this.stopTimer();
@@ -252,6 +289,7 @@ export class SessionManager {
 	};
 
 	#onSessionShutdown = async (_e: SessionShutdownEvent, _ctx: ExtensionContext): Promise<void> => {
+		this.#state.waiting = null;
 		this.stopTimer();
 	};
 
@@ -298,6 +336,8 @@ export class SessionManager {
 		this.#pi.on("message_end", this.#onMessageEnd);
 		this.#pi.on("tool_execution_start", this.#onToolExecutionStart);
 		this.#pi.on("agent_settled", this.#onAgentSettled);
+		this.#pi.on("ui_prompt_start", this.#onUIPromptStart);
+		this.#pi.on("ui_prompt_end", this.#onUIPromptEnd);
 		this.#pi.on("session_shutdown", this.#onSessionShutdown);
 		this.#pi.registerEntryRenderer<DoneEntryData>(DONE_ENTRY_TYPE, (entry, _o, theme) => this.#renderDoneEntry(entry, theme));
 		this.#pi.registerMessageRenderer<PromptBoxDetails>(PROMPT_BOX_TYPE, promptBoxRenderer);
@@ -345,6 +385,13 @@ export class SessionManager {
 		return `${decorations.animatedSpinner}:${decorations.spinnerColor}:${decorations.spinnerColorEnabled}:${this.#settings.loaderOrder[0]}`;
 	}
 
+	private applyWaitingIndicator(ctx: ExtensionContext): void {
+		ctx.ui.setWorkingIndicator({
+			frames: WAITING_PULSE_FRAMES.map((frame) => ctx.ui.theme.fg("dim", frame)),
+			intervalMs: WAITING_PULSE_INTERVAL_MS,
+		});
+	}
+
 	private applyIndicator(ctx: ExtensionContext): void {
 		if (!this.#settings.decorations.animatedSpinner || this.spinnerInMessage()) {
 			ctx.ui.setWorkingIndicator({ frames: [] });
@@ -401,6 +448,14 @@ export class SessionManager {
 		const ctx = this.#currentCtx;
 		const state = this.#state;
 		if (!state.busy || !ctx) return;
+		if (state.waiting) {
+			const msg = ctx.ui.theme.fg("dim", waitingLabel(state.waiting));
+			if (msg !== state.lastMessage) {
+				state.lastMessage = msg;
+				ctx.ui.setWorkingMessage(msg);
+			}
+			return;
+		}
 
 		const now = Date.now();
 		const total = state.confirmTokens + state.liveTokens;
@@ -497,8 +552,9 @@ export class SessionManager {
 		const preview = new PreviewRenderer(ctx, [...this.#bundledPacks, ...this.#userPacks]);
 		const result = await showMenu<Record<string, boolean | string>>(ctx, {
 			title: "Pi Topping: Settings",
+			maxHeight: "75%",
 			sections: buildMenuSections(this.#settings, this.#bundledPacks, this.#userPacks),
-			hints: ["↑↓ move", "←→ select", "␣ toggle", "⏎ apply", "esc cancel"],
+			hints: ["↑↓ move", "PgUp/PgDn page", "←→ select", "␣ toggle", "⏎ apply", "esc cancel"],
 			preview: preview.render.bind(preview),
 		});
 		if (!result.applied) return;
@@ -512,7 +568,10 @@ export class SessionManager {
 		}
 
 		this.#settings = updatedSettings;
-		if (before !== this.indicatorFingerprint()) this.applyIndicator(ctx);
+		if (before !== this.indicatorFingerprint()) {
+			if (this.#state.waiting) this.applyWaitingIndicator(ctx);
+			else this.applyIndicator(ctx);
+		}
 		this.#state.activityMeter.setDirection(this.#settings.decorations.meterDirection);
 		if (this.#state.busy) {
 			this.stopTimer();

package/src/setup-command.ts

@@ -114,7 +114,7 @@ export function registerSetupCommand(pi: ExtensionAPI, install: ToppingInstaller
 						})),
 					},
 				],
-				hints: ["↑↓ move", "␣ toggle", "⏎ install", "esc cancel"],
+				hints: ["↑↓ move", "PgUp/PgDn page", "␣ toggle", "⏎ install", "esc cancel"],
 				previewTitle: "Description",
 				preview: (_values, _elapsedMs, activeItemId) => ({ lines: renderDescription(missing, activeItemId) }),
 			});

package/src/word-packs.ts

@@ -6,7 +6,7 @@ import { isPlainObject, stripControlChars } from "./util.ts";
 import { WORDS, type WordEntry } from "./words.ts";
 
 const PACK_ID_PATTERN = /^[a-z][a-z0-9-]{0,63}$/;
-const RESERVED_BUNDLED_PACK_IDS = new Set(["simcity", "star-trek", "star-wars"]);
+const RESERVED_BUNDLED_PACK_IDS = new Set(["doctor-who", "firefly", "hitchhikers-guide", "lord-of-the-rings", "matrix", "portal", "simcity", "star-trek", "star-wars"]);
 
 export function isWordPackId(value: string): boolean { return PACK_ID_PATTERN.test(value); }
 const BUNDLED_PACK_DIRECTORY = fileURLToPath(new URL("../wordpacks/", import.meta.url));