gnosys 5.9.1 → 5.9.3

package/dist/lib/setup/ui/menu.js

@@ -0,0 +1,75 @@
+/**
+ * Menu atom — the single numbered-menu format the redesign uses.
+ *
+ * 3-col number gutter, lowercase labels by convention, right-aligned
+ * meta column, optional `◂ tag` (recommended | current | detected) to
+ * the right of meta.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a numbered menu as a single string (no trailing newline).
+ * Caller follows with one blank line then a Prompt/Footer.
+ */
+export function Menu(items) {
+    const W = width();
+    // Column layout:
+    //   col 1: " " indent (content lives at col 2 per the spec)
+    //   col 2-4: 3-char gutter for number, right-aligned
+    //   col 5: " "
+    //   col 6+: label
+    //   meta is right-aligned within W-2
+    //   tag (◂ ...) follows meta, right-aligned at the very right
+    const indent = "    "; // menu items at col 4 — 4-space indent (1 base + 3)
+    const lines = [];
+    for (const it of items) {
+        // Numbers are always text-dim per design §3 (numbered-menu spec).
+        const labelColor = it.dim ? c.textDim : c.text;
+        const metaColor = it.dim ? c.textDim : c.textMid;
+        const tagColor = c.accentHi;
+        const num = color(c.textDim, it.n.padStart(2, " "));
+        const label = color(labelColor, it.label);
+        const meta = it.meta ? color(metaColor, it.meta) : "";
+        const tag = it.tag ? color(tagColor, `${glyph.tag} ${it.tag}`) : "";
+        // Build the inner content then right-pad meta + tag.
+        const leftSide = `${indent}${num}  ${label}`;
+        const leftBare = stripAnsi(leftSide);
+        // Reserve room: leftBare | gap | meta | gap | tag, ending at col W-1.
+        const tagBare = it.tag ? `${glyph.tag} ${it.tag}` : "";
+        const metaBare = it.meta ?? "";
+        const tagWidth = tagBare.length;
+        const metaWidth = metaBare.length;
+        // tag occupies the rightmost slot if present; meta column ends before
+        // the tag with a one-space gap. If no tag, meta ends at col W-1.
+        const rightEnd = W - 1;
+        let line;
+        if (it.tag && it.meta) {
+            const tagStart = rightEnd - tagWidth;
+            const metaEnd = tagStart - 1; // one space between meta and tag
+            const metaStart = metaEnd - metaWidth;
+            const gap1 = " ".repeat(Math.max(1, metaStart - leftBare.length));
+            const gap2 = " ";
+            line = `${leftSide}${gap1}${meta}${gap2}${tag}`;
+        }
+        else if (it.tag) {
+            const tagStart = rightEnd - tagWidth;
+            const gap = " ".repeat(Math.max(1, tagStart - leftBare.length));
+            line = `${leftSide}${gap}${tag}`;
+        }
+        else if (it.meta) {
+            const metaStart = rightEnd - metaWidth;
+            const gap = " ".repeat(Math.max(1, metaStart - leftBare.length));
+            line = `${leftSide}${gap}${meta}`;
+        }
+        else {
+            line = leftSide;
+        }
+        lines.push(line);
+    }
+    return lines.join("\n");
+}
+/** Convenience: print menu + trailing blank line. */
+export function printMenu(items) {
+    process.stdout.write(`${Menu(items)}\n\n`);
+}
+//# sourceMappingURL=menu.js.map

package/dist/lib/setup/ui/menu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/menu.ts"],"names":[],"mappings":"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"}

package/dist/lib/setup/ui/panel.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Panel atom — rounded `╭─╮ │ ╰─╯` box in `accent-dim`.
+ *
+ * Used ONLY for summary views (settings overview, completion screen).
+ * Flow screens use Header + Title + content + Prompt — no box. The
+ * design handoff is strict about this.
+ */
+export interface PanelOptions {
+    /** Right-side glyph on a row (e.g. `✓` to mark "edited this session"). */
+    trailing?: Record<number, string>;
+}
+/**
+ * Render a panel. Each row is a string (already formatted/colored). The
+ * panel wraps each row in `│ … │` with `accent-dim` border. The title
+ * sits in the top border: `╭─ title ────╮`.
+ *
+ * Width is fixed to the lesser of W or 68 cols of inner content (matches
+ * the spec mockup) so summary panels never spill on wider terminals.
+ */
+export declare function Panel(title: string, rows: string[], opts?: PanelOptions): string;
+/** Convenience: print panel + trailing blank line. */
+export declare function printPanel(title: string, rows: string[], opts?: PanelOptions): void;
+//# sourceMappingURL=panel.d.ts.map

package/dist/lib/setup/ui/panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/panel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,MAAM,CAkCpF;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,YAAiB,GAAG,IAAI,CAEvF"}

package/dist/lib/setup/ui/panel.js

@@ -0,0 +1,53 @@
+/**
+ * Panel atom — rounded `╭─╮ │ ╰─╯` box in `accent-dim`.
+ *
+ * Used ONLY for summary views (settings overview, completion screen).
+ * Flow screens use Header + Title + content + Prompt — no box. The
+ * design handoff is strict about this.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a panel. Each row is a string (already formatted/colored). The
+ * panel wraps each row in `│ … │` with `accent-dim` border. The title
+ * sits in the top border: `╭─ title ────╮`.
+ *
+ * Width is fixed to the lesser of W or 68 cols of inner content (matches
+ * the spec mockup) so summary panels never spill on wider terminals.
+ */
+export function Panel(title, rows, opts = {}) {
+    const W = width();
+    const indent = " ";
+    // Inner content width: target 66 chars inner (between `│  ` and `  │`),
+    // clamp by terminal width.
+    const innerW = Math.min(66, Math.max(40, W - 4));
+    const border = c.accentDim;
+    // Top border: `╭─ title ──────╮`
+    const titleStyled = color(c.textHi, title);
+    const topHead = `${color(border, `${glyph.boxTL}${glyph.boxH} `)}${titleStyled} `;
+    const topHeadBare = stripAnsi(topHead);
+    const topPadLen = Math.max(1, innerW + 2 - topHeadBare.length);
+    const top = `${indent}${topHead}${color(border, `${glyph.boxH.repeat(topPadLen)}${glyph.boxTR}`)}`;
+    // Each row: `│  <content>  │` — pad content to innerW.
+    const left = color(border, `${glyph.boxV} `);
+    const right = color(border, ` ${glyph.boxV}`);
+    const middle = [];
+    rows.forEach((rowStyled, idx) => {
+        const bare = stripAnsi(rowStyled);
+        const trail = opts.trailing?.[idx] ?? "";
+        const trailBare = stripAnsi(trail);
+        // Reserve room for the optional trailing glyph (e.g. ✓), right-aligned.
+        const usable = innerW - bare.length - (trailBare ? trailBare.length + 1 : 0);
+        const padContent = " ".repeat(Math.max(0, usable));
+        const trailingPart = trail ? ` ${trail}` : "";
+        middle.push(`${indent}${left}${rowStyled}${padContent}${trailingPart}${right}`);
+    });
+    // Bottom border: `╰──────────────╯`
+    const bottom = `${indent}${color(border, `${glyph.boxBL}${glyph.boxH.repeat(innerW + 2)}${glyph.boxBR}`)}`;
+    return [top, ...middle, bottom].join("\n");
+}
+/** Convenience: print panel + trailing blank line. */
+export function printPanel(title, rows, opts = {}) {
+    process.stdout.write(`${Panel(title, rows, opts)}\n\n`);
+}
+//# sourceMappingURL=panel.js.map

package/dist/lib/setup/ui/panel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/panel.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAOxC;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,IAAc,EAAE,OAAqB,EAAE;IAC1E,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,GAAG,CAAC;IACnB,wEAAwE;IACxE,2BAA2B;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,CAAC,CAAC,SAAS,CAAC;IAE3B,iCAAiC;IACjC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,WAAW,GAAG,CAAC;IAClF,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/D,MAAM,GAAG,GAAG,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IAEnG,uDAAuD;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE;QAC9B,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QACnC,wEAAwE;QACxE,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,KAAK,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,MAAM,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;IAE3G,OAAO,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,IAAc,EAAE,OAAqB,EAAE;IAC/E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/lib/setup/ui/prompt.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Prompt atom — single helper that wraps every readline question call.
+ *
+ * Catches `AbortError` from readline's signal/SIGINT path, prints a clean
+ * cancellation message in `text-dim`, closes the readline, and exits with
+ * code 130 (standard SIGINT exit). This is the *only* place SIGINT cleanup
+ * should live — every other site routes through here.
+ */
+import type { Interface as ReadlineInterface } from "readline/promises";
+export interface PromptOptions {
+    /** Right-aligned dim hint (`1–8 · pick    q · quit`). */
+    hint?: string;
+    /** Lead-in text shown after the prompt glyph (`press enter to begin`). */
+    lead?: string;
+    /** What to print on cancel. Default: `cancelled · no changes written`. */
+    cancelMessage?: string;
+    /** Skip the actual `process.exit(130)`. Used by some integration tests. */
+    skipExitOnCancel?: boolean;
+}
+/**
+ * Render the prompt line and await user input. On `AbortError`, prints the
+ * cancellation message and exits 130 (unless `skipExitOnCancel`).
+ *
+ * @returns The user's input, trimmed. Returns the empty string on Enter.
+ */
+export declare function Prompt(rl: ReadlineInterface, opts?: PromptOptions): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/lib/setup/ui/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAKxE,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,wBAAsB,MAAM,CAC1B,EAAE,EAAE,iBAAiB,EACrB,IAAI,GAAE,aAAkB,GACvB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/lib/setup/ui/prompt.js

@@ -0,0 +1,38 @@
+/**
+ * Prompt atom — single helper that wraps every readline question call.
+ *
+ * Catches `AbortError` from readline's signal/SIGINT path, prints a clean
+ * cancellation message in `text-dim`, closes the readline, and exits with
+ * code 130 (standard SIGINT exit). This is the *only* place SIGINT cleanup
+ * should live — every other site routes through here.
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+import { safeQuestion } from "./safePrompt.js";
+/**
+ * Render the prompt line and await user input. On `AbortError`, prints the
+ * cancellation message and exits 130 (unless `skipExitOnCancel`).
+ *
+ * @returns The user's input, trimmed. Returns the empty string on Enter.
+ */
+export async function Prompt(rl, opts = {}) {
+    const W = width();
+    const indent = " ";
+    const glyphPart = color(c.accent, glyph.prompt);
+    const lead = opts.lead ? ` ${color(c.text, opts.lead)}` : "";
+    const head = `${indent}${glyphPart}${lead} `;
+    // If a hint is present, print it right-aligned ABOVE the prompt line.
+    // This matches the design's "hint on the line above the cursor".
+    if (opts.hint) {
+        const hint = color(c.textDim, opts.hint);
+        const hintBare = stripAnsi(hint);
+        const pad = " ".repeat(Math.max(1, W - 1 - hintBare.length));
+        process.stdout.write(`${pad}${hint}\n`);
+    }
+    const raw = await safeQuestion(rl, head, {
+        cancelMessage: opts.cancelMessage,
+        skipExitOnCancel: opts.skipExitOnCancel,
+    });
+    return raw.trim();
+}
+//# sourceMappingURL=prompt.js.map

package/dist/lib/setup/ui/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAa/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,EAAqB,EACrB,OAAsB,EAAE;IAExB,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,GAAG,CAAC;IACnB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,CAAC;IAE7C,sEAAsE;IACtE,iEAAiE;IACjE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE;QACvC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/dist/lib/setup/ui/safePrompt.d.ts

@@ -0,0 +1,24 @@
+/**
+ * safeQuestion — a thin migration shim that gives every existing
+ * `rl.question(...)` call site clean Ctrl+C handling without forcing
+ * a rewrite to the full Prompt() atom.
+ *
+ * Behavior:
+ *   - On normal input, returns the raw string (caller decides about trim).
+ *   - On SIGINT (Ctrl+C), prints `cancelled · no changes written` in
+ *     `text-dim`, closes the readline, exits 130.
+ *
+ * The SIGINT handler is installed lazily on the first call and remembered
+ * via a module-level flag so the same readline can be questioned many
+ * times without leaking listeners.
+ *
+ * v5.9.3 Phase B uses this everywhere the old helpers wrap `rl.question`.
+ * New screens compose Prompt() from `index.js` instead.
+ */
+import type { Interface as ReadlineInterface } from "readline/promises";
+export interface SafeQuestionOptions {
+    cancelMessage?: string;
+    skipExitOnCancel?: boolean;
+}
+export declare function safeQuestion(rl: ReadlineInterface, prompt: string, opts?: SafeQuestionOptions): Promise<string>;
+//# sourceMappingURL=safePrompt.d.ts.map

package/dist/lib/setup/ui/safePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safePrompt.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/safePrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGxE,MAAM,WAAW,mBAAmB;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAkCD,wBAAsB,YAAY,CAChC,EAAE,EAAE,iBAAiB,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/lib/setup/ui/safePrompt.js

@@ -0,0 +1,71 @@
+/**
+ * safeQuestion — a thin migration shim that gives every existing
+ * `rl.question(...)` call site clean Ctrl+C handling without forcing
+ * a rewrite to the full Prompt() atom.
+ *
+ * Behavior:
+ *   - On normal input, returns the raw string (caller decides about trim).
+ *   - On SIGINT (Ctrl+C), prints `cancelled · no changes written` in
+ *     `text-dim`, closes the readline, exits 130.
+ *
+ * The SIGINT handler is installed lazily on the first call and remembered
+ * via a module-level flag so the same readline can be questioned many
+ * times without leaking listeners.
+ *
+ * v5.9.3 Phase B uses this everywhere the old helpers wrap `rl.question`.
+ * New screens compose Prompt() from `index.js` instead.
+ */
+import { c, color } from "./tokens.js";
+/**
+ * Track which readline interfaces we've already wired SIGINT cleanup
+ * to. We use a WeakSet so a closed/GC'd interface drops out automatically.
+ */
+const sigintWired = new WeakSet();
+function wireSigint(rl, cancelMessage, skipExit) {
+    if (sigintWired.has(rl))
+        return;
+    sigintWired.add(rl);
+    const handler = () => {
+        process.stdout.write(`\n ${color(c.textDim, cancelMessage)}\n`);
+        try {
+            rl.close();
+        }
+        catch {
+            // already closed — fine
+        }
+        if (!skipExit) {
+            process.exit(130);
+        }
+    };
+    // `rl.on('SIGINT', …)` fires when the user hits Ctrl+C with readline
+    // listening — Node's readline already emits SIGINT before bubbling to
+    // process. This is the load-bearing wire.
+    rl.on("SIGINT", handler);
+}
+export async function safeQuestion(rl, prompt, opts = {}) {
+    const message = opts.cancelMessage ?? "cancelled · no changes written";
+    wireSigint(rl, message, opts.skipExitOnCancel ?? false);
+    try {
+        return await rl.question(prompt);
+    }
+    catch (err) {
+        // Defensive: still catch AbortError for callers that pass their own
+        // AbortSignal through (e.g. test harness).
+        const isAbort = err instanceof Error &&
+            (err.name === "AbortError" || /aborted|signal/i.test(err.message ?? ""));
+        if (!isAbort)
+            throw err;
+        process.stdout.write(`\n ${color(c.textDim, message)}\n`);
+        try {
+            rl.close();
+        }
+        catch {
+            // Already closed — fine.
+        }
+        if (!opts.skipExitOnCancel) {
+            process.exit(130);
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=safePrompt.js.map

package/dist/lib/setup/ui/safePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safePrompt.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/safePrompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAOvC;;;GAGG;AACH,MAAM,WAAW,GAAG,IAAI,OAAO,EAAqB,CAAC;AAErD,SAAS,UAAU,CACjB,EAAqB,EACrB,aAAqB,EACrB,QAAiB;IAEjB,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO;IAChC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,CAAC;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,qEAAqE;IACrE,sEAAsE;IACtE,0CAA0C;IAC1C,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,EAAqB,EACrB,MAAc,EACd,OAA4B,EAAE;IAE9B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,IAAI,gCAAgC,CAAC;IACvE,UAAU,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,gBAAgB,IAAI,KAAK,CAAC,CAAC;IAExD,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,oEAAoE;QACpE,2CAA2C;QAC3C,MAAM,OAAO,GACX,GAAG,YAAY,KAAK;YACpB,CAAC,GAAG,CAAC,IAAI,KAAK,YAAY,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,OAAO;YAAE,MAAM,GAAG,CAAC;QAExB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/setup/ui/spinner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Spinner atom — animated `◌ ◐ ◑ ◒ ◓` for any operation > 200 ms.
+ *
+ * Same line is rewritten in place via `\r` (carriage return). On `ok` /
+ * `fail` / `update`, the spinner stops cleanly and replaces the line with
+ * a final Status-style line. No newlines are emitted until resolution.
+ */
+export interface SpinnerHandle {
+    /** Replace the spinner with a `✓ text · meta` line and stop. */
+    ok(text: string, meta?: string): void;
+    /** Replace the spinner with a `✗ text · meta` line and stop. */
+    fail(text: string, meta?: string): void;
+    /** Update the in-progress label (spinner keeps animating). */
+    update(label: string): void;
+    /** Stop without printing a final line (for callers that handle output). */
+    stop(): void;
+}
+/**
+ * Start an animated spinner. Returns a handle. The spinner immediately
+ * writes its first frame. Caller MUST eventually call one of `ok`/`fail`/
+ * `stop` to release the line.
+ *
+ * When stdout isn't a TTY (CI, test capture), the spinner falls back to a
+ * single static `◌ label` line and the `ok/fail` calls print final lines
+ * directly — no `\r` redraw.
+ */
+export declare function Spinner(label: string): SpinnerHandle;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/lib/setup/ui/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/spinner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,gEAAgE;IAChE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,8DAA8D;IAC9D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2EAA2E;IAC3E,IAAI,IAAI,IAAI,CAAC;CACd;AAKD;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAgEpD"}

package/dist/lib/setup/ui/spinner.js

@@ -0,0 +1,87 @@
+/**
+ * Spinner atom — animated `◌ ◐ ◑ ◒ ◓` for any operation > 200 ms.
+ *
+ * Same line is rewritten in place via `\r` (carriage return). On `ok` /
+ * `fail` / `update`, the spinner stops cleanly and replaces the line with
+ * a final Status-style line. No newlines are emitted until resolution.
+ */
+import { c, color, glyph } from "./tokens.js";
+import { Status } from "./status.js";
+const FRAMES = [glyph.spin0, glyph.spin1, glyph.spin2, glyph.spin3, glyph.spin4];
+const FRAME_MS = 125; // ~8 fps
+/**
+ * Start an animated spinner. Returns a handle. The spinner immediately
+ * writes its first frame. Caller MUST eventually call one of `ok`/`fail`/
+ * `stop` to release the line.
+ *
+ * When stdout isn't a TTY (CI, test capture), the spinner falls back to a
+ * single static `◌ label` line and the `ok/fail` calls print final lines
+ * directly — no `\r` redraw.
+ */
+export function Spinner(label) {
+    let currentLabel = label;
+    const isTTY = process.stdout.isTTY;
+    let frame = 0;
+    let timer = null;
+    let stopped = false;
+    function draw() {
+        if (stopped)
+            return;
+        if (!isTTY) {
+            // Non-TTY: print one static line only, do NOT animate.
+            return;
+        }
+        const g = color(c.accent, FRAMES[frame % FRAMES.length]);
+        const txt = color(c.text, currentLabel);
+        process.stdout.write(`\r ${g} ${txt}`);
+    }
+    function clearLine() {
+        if (isTTY) {
+            // Move to start of line, clear to end.
+            process.stdout.write("\r\x1b[2K");
+        }
+    }
+    function final(kind, text, meta) {
+        if (stopped)
+            return;
+        stopped = true;
+        if (timer)
+            clearInterval(timer);
+        clearLine();
+        process.stdout.write(`${Status(kind, text, meta)}\n`);
+    }
+    // First frame (or static line for non-TTY).
+    if (isTTY) {
+        draw();
+        timer = setInterval(() => {
+            frame = (frame + 1) % FRAMES.length;
+            draw();
+        }, FRAME_MS);
+        // Unref so the timer never blocks process exit on its own.
+        timer.unref?.();
+    }
+    else {
+        process.stdout.write(`${Status("progress", currentLabel)}\n`);
+    }
+    return {
+        ok(text, meta) {
+            final("ok", text, meta);
+        },
+        fail(text, meta) {
+            final("fail", text, meta);
+        },
+        update(nextLabel) {
+            currentLabel = nextLabel;
+            draw();
+        },
+        stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            if (timer)
+                clearInterval(timer);
+            clearLine();
+        },
+    };
+}
+//# sourceMappingURL=spinner.js.map

package/dist/lib/setup/ui/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/spinner.ts"],"names":[],"mappings":"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"}

package/dist/lib/setup/ui/status.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Status atom — one-liner with leading glyph + optional right-aligned meta.
+ *
+ * Kinds:
+ *   ok       ✓ in ok color
+ *   warn     ⚠ in warn color
+ *   fail     ✗ in fail color
+ *   progress ◌ in accent color (use Spinner for animated variants)
+ */
+export type StatusKind = "ok" | "warn" | "fail" | "progress";
+/**
+ * Render a status line. Returns the formatted string (no trailing newline).
+ *
+ * @param kind  ok | warn | fail | progress
+ * @param text  Body, in `text`.
+ * @param meta  Optional right-aligned, in `text-dim`.
+ */
+export declare function Status(kind: StatusKind, text: string, meta?: string): string;
+/** Convenience: print a single status line. */
+export declare function printStatus(kind: StatusKind, text: string, meta?: string): void;
+//# sourceMappingURL=status.d.ts.map

package/dist/lib/setup/ui/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;AAgB7D;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAED,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/E"}

package/dist/lib/setup/ui/status.js

@@ -0,0 +1,49 @@
+/**
+ * Status atom — one-liner with leading glyph + optional right-aligned meta.
+ *
+ * Kinds:
+ *   ok       ✓ in ok color
+ *   warn     ⚠ in warn color
+ *   fail     ✗ in fail color
+ *   progress ◌ in accent color (use Spinner for animated variants)
+ */
+import { c, color, glyph, width } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+const KIND_TO_GLYPH = {
+    ok: glyph.ok,
+    warn: glyph.warn,
+    fail: glyph.fail,
+    progress: glyph.spin0,
+};
+const KIND_TO_COLOR = {
+    ok: c.ok,
+    warn: c.warn,
+    fail: c.fail,
+    progress: c.accent,
+};
+/**
+ * Render a status line. Returns the formatted string (no trailing newline).
+ *
+ * @param kind  ok | warn | fail | progress
+ * @param text  Body, in `text`.
+ * @param meta  Optional right-aligned, in `text-dim`.
+ */
+export function Status(kind, text, meta) {
+    const W = width();
+    const indent = " ";
+    const g = color(KIND_TO_COLOR[kind], KIND_TO_GLYPH[kind]);
+    const body = color(c.text, text);
+    const left = `${indent}${g} ${body}`;
+    if (!meta)
+        return left;
+    const metaTxt = color(c.textDim, meta);
+    const leftBare = stripAnsi(left);
+    const metaBare = stripAnsi(metaTxt);
+    const pad = " ".repeat(Math.max(1, W - 1 - leftBare.length - metaBare.length));
+    return `${left}${pad}${metaTxt}`;
+}
+/** Convenience: print a single status line. */
+export function printStatus(kind, text, meta) {
+    process.stdout.write(`${Status(kind, text, meta)}\n`);
+}
+//# sourceMappingURL=status.js.map

package/dist/lib/setup/ui/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/status.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,MAAM,aAAa,GAA+B;IAChD,EAAE,EAAE,KAAK,CAAC,EAAE;IACZ,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,IAAI,EAAE,KAAK,CAAC,IAAI;IAChB,QAAQ,EAAE,KAAK,CAAC,KAAK;CACtB,CAAC;AAEF,MAAM,aAAa,GAA+B;IAChD,EAAE,EAAE,CAAC,CAAC,EAAE;IACR,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,IAAI,EAAE,CAAC,CAAC,IAAI;IACZ,QAAQ,EAAE,CAAC,CAAC,MAAM;CACnB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,IAAgB,EAAE,IAAY,EAAE,IAAa;IAClE,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,GAAG,CAAC;IACnB,MAAM,CAAC,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/E,OAAO,GAAG,IAAI,GAAG,GAAG,GAAG,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,IAAgB,EAAE,IAAY,EAAE,IAAa;IACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/lib/setup/ui/title.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Title atom — screen-level heading + optional subtitle.
+ */
+/**
+ * Render a title + optional subtitle. Caller follows with the standard
+ * blank line via normal flow.
+ *
+ * @param title  Bold, `text-hi`.
+ * @param sub    Optional, `text-mid`, rendered on the next line.
+ */
+export declare function Title(title: string, sub?: string): string;
+/** Convenience: print title + trailing blank line to stdout. */
+export declare function printTitle(title: string, sub?: string): void;
+//# sourceMappingURL=title.d.ts.map

package/dist/lib/setup/ui/title.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/title.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,gEAAgE;AAChE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAE5D"}

package/dist/lib/setup/ui/title.js

@@ -0,0 +1,24 @@
+/**
+ * Title atom — screen-level heading + optional subtitle.
+ */
+import { c, color } from "./tokens.js";
+/**
+ * Render a title + optional subtitle. Caller follows with the standard
+ * blank line via normal flow.
+ *
+ * @param title  Bold, `text-hi`.
+ * @param sub    Optional, `text-mid`, rendered on the next line.
+ */
+export function Title(title, sub) {
+    const indent = " ";
+    const line1 = `${indent}${color(c.textHi, title)}`;
+    if (!sub)
+        return line1;
+    const line2 = `${indent}${color(c.textMid, sub)}`;
+    return `${line1}\n${line2}`;
+}
+/** Convenience: print title + trailing blank line to stdout. */
+export function printTitle(title, sub) {
+    process.stdout.write(`${Title(title, sub)}\n\n`);
+}
+//# sourceMappingURL=title.js.map

package/dist/lib/setup/ui/title.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"title.js","sourceRoot":"","sources":["../../../../src/lib/setup/ui/title.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAY;IAC/C,MAAM,MAAM,GAAG,GAAG,CAAC;IACnB,MAAM,KAAK,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;IACnD,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,KAAK,GAAG,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;IAClD,OAAO,GAAG,KAAK,KAAK,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,GAAY;IACpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;AACnD,CAAC"}