gnosys 5.9.2 → 5.9.4

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

@@ -0,0 +1,60 @@
+/**
+ * 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 ──────╮` — must match the bottom border's total
+    // visible width of `innerW + 4` (corners + innerW+2 rule chars). The
+    // title segment `╭─ <title> ` already costs 4 + title chars, leaving
+    // `innerW - 1 - title` rule chars before the closing `╮` corner.
+    //
+    // v5.9.4 Bug 1 — pre-strip ANSI from the caller-supplied title so
+    // bolded / coloured titles still measure correctly; clamp `topPadLen`
+    // with `Math.max(1, ...)` so narrow widths never collapse the rule.
+    const titleStyled = color(c.textHi, title);
+    const titleBareLen = stripAnsi(title).length;
+    const topHead = `${color(border, `${glyph.boxTL}${glyph.boxH} `)}${titleStyled} `;
+    const topPadLen = Math.max(1, innerW - 1 - titleBareLen);
+    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":"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"}

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/table.d.ts

@@ -0,0 +1,37 @@
+export interface TableColumn<T> {
+    /** Header label (always rendered in `text-dim`). */
+    header: string;
+    /** Optional fixed column width; otherwise auto-fits to widest cell + header. */
+    width?: number;
+    /** Cell alignment within its column. Default `left`. */
+    align?: "left" | "right";
+    /** Cell value extractor. Returns the RAW string — color is applied below. */
+    render: (row: T) => string;
+    /** Optional ANSI token for this column's cell values. Defaults to `c.text`. */
+    color?: string;
+}
+export interface TableOptions<T> {
+    /** Include the header row + divider. Default true. */
+    showHeader?: boolean;
+    /** Draw the thin `─` rule under the header. Default true. */
+    dividerAfterHeader?: boolean;
+    /** Spaces before each line. Default 1 (col 2 baseline per design). */
+    indent?: number;
+    /** Spaces between columns. Default 2. */
+    gap?: number;
+    /**
+     * Optional row-level decorator. Receives the raw row and the fully built
+     * line; returns the final line. Lets callers prepend per-row markers
+     * (`▶ ` for changed rows, `✓ ` for completed) without bypassing the atom.
+     */
+    rowFormatter?: (row: T, line: string) => string;
+}
+/**
+ * Render a table. Returns one string per line (header + divider + rows),
+ * never trailing newline. Returns `[]` for an empty `rows` array unless
+ * `showHeader` is true (in which case header + divider are still emitted).
+ */
+export declare function renderTable<T>(rows: T[], columns: TableColumn<T>[], opts?: TableOptions<T>): string[];
+/** Convenience: render + print + trailing newline. */
+export declare function printTable<T>(rows: T[], columns: TableColumn<T>[], opts?: TableOptions<T>): void;
+//# sourceMappingURL=table.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../../../src/lib/setup/ui/table.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,sDAAsD;IACtD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,6DAA6D;IAC7D,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC3B,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EACzB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACzB,MAAM,EAAE,CAoDV;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,CAAC,EAC1B,IAAI,EAAE,CAAC,EAAE,EACT,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,EACzB,IAAI,GAAE,YAAY,CAAC,CAAC,CAAM,GACzB,IAAI,CAGN"}

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

@@ -0,0 +1,82 @@
+/**
+ * Table atom — generic tabular layout for the v5.9.4 CLI vocabulary.
+ *
+ * Per `arch-004`: every tabular CLI screen reaches for `Table` first instead
+ * of hand-rolling `padEnd` columns. Header row + thin divider + auto-fit
+ * or fixed-width columns + optional per-row marker formatter (e.g. `▶` for
+ * changed routing rows).
+ *
+ * The renderer measures printable width with ANSI stripped so coloured
+ * cell contents don't break alignment. Cell `render(row)` returns the
+ * RAW string; `color` is applied per-column for the cell value (header
+ * is always `text-dim` per design §4).
+ */
+import { c, color, glyph } from "./tokens.js";
+import { stripAnsi } from "./header.js";
+/**
+ * Render a table. Returns one string per line (header + divider + rows),
+ * never trailing newline. Returns `[]` for an empty `rows` array unless
+ * `showHeader` is true (in which case header + divider are still emitted).
+ */
+export function renderTable(rows, columns, opts = {}) {
+    if (columns.length === 0)
+        return [];
+    const showHeader = opts.showHeader !== false;
+    const drawDivider = opts.dividerAfterHeader !== false;
+    const indent = " ".repeat(opts.indent ?? 1);
+    const gap = " ".repeat(opts.gap ?? 2);
+    // Pre-compute raw cell values + per-column widths.
+    const rawCells = rows.map((row) => columns.map((col) => col.render(row)));
+    const widths = columns.map((col, idx) => {
+        if (typeof col.width === "number")
+            return col.width;
+        const headerLen = col.header.length;
+        const maxCell = rawCells.reduce((max, cells) => {
+            const len = stripAnsi(cells[idx] ?? "").length;
+            return len > max ? len : max;
+        }, 0);
+        return Math.max(headerLen, maxCell);
+    });
+    const lines = [];
+    if (showHeader) {
+        const headerCells = columns.map((col, idx) => color(c.textDim, padCell(col.header, widths[idx], col.align ?? "left")));
+        lines.push(`${indent}${headerCells.join(gap)}`);
+        if (drawDivider) {
+            const ruleWidth = widths.reduce((sum, w) => sum + w, 0) + gap.length * (columns.length - 1);
+            lines.push(`${indent}${color(c.textGhost, glyph.ruleLight.repeat(Math.max(1, ruleWidth)))}`);
+        }
+    }
+    rows.forEach((row, rowIdx) => {
+        const cells = columns.map((col, colIdx) => {
+            const raw = rawCells[rowIdx][colIdx];
+            // Last left-aligned column doesn't need trailing pad — saves a row of
+            // ghost whitespace per snapshot and matches the v5.9.3 hand-rolled output.
+            const isLastCol = colIdx === columns.length - 1;
+            const align = col.align ?? "left";
+            const padded = isLastCol && align === "left"
+                ? raw
+                : padCell(raw, widths[colIdx], align);
+            // Empty string opts out of column-level colouring — useful when the
+            // cell's `render()` already emits its own ANSI (e.g. cost tiers).
+            const cellColor = col.color === "" ? null : col.color ?? c.text;
+            return cellColor ? color(cellColor, padded) : padded;
+        });
+        const line = `${indent}${cells.join(gap)}`;
+        lines.push(opts.rowFormatter ? opts.rowFormatter(row, line) : line);
+    });
+    return lines;
+}
+/** Convenience: render + print + trailing newline. */
+export function printTable(rows, columns, opts = {}) {
+    const lines = renderTable(rows, columns, opts);
+    if (lines.length > 0)
+        process.stdout.write(`${lines.join("\n")}\n`);
+}
+/** Pad a cell value (which may contain ANSI) to a target printable width. */
+function padCell(value, width, align) {
+    const bareLen = stripAnsi(value).length;
+    const padLen = Math.max(0, width - bareLen);
+    const pad = " ".repeat(padLen);
+    return align === "right" ? `${pad}${value}` : `${value}${pad}`;
+}
+//# sourceMappingURL=table.js.map

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

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

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"}