zard-cli 1.0.0-beta.98 → 1.0.0

package/ui/engine/terminal/index.js

@@ -0,0 +1,235 @@
+/**
+ * terminal — the ONE low-level I/O boundary (ADR-0007). Nothing else touches
+ * process.stdout/stdin. Detects capabilities and handles raw mode and the
+ * alternate screen.
+ */
+import { closeSync, openSync } from 'node:fs';
+import { ReadStream, WriteStream } from 'node:tty';
+import { csi } from '../ansi/index.js';
+/**
+ * Opens the process's controlling terminal, ignoring the inherited fds.
+ *
+ * `/dev/tty` is the terminal the process is attached to, whatever the caller did
+ * with stdin and stdout. It is the mechanism `fzf`, `less` and `git rebase -i`
+ * use to stay interactive inside a pipe; on Windows, `CONIN$`/`CONOUT$` are the
+ * equivalent.
+ *
+ * Returns null when there is no terminal at all — real CI, a cron job, a
+ * container with no tty — and that is what keeps the headless path working
+ * where it should.
+ */
+export function openControllingTerminal() {
+    const [inPath, outPath] = process.platform === 'win32' ? ['CONIN$', 'CONOUT$'] : ['/dev/tty', '/dev/tty'];
+    let inFd;
+    let outFd;
+    try {
+        inFd = openSync(inPath, 'r');
+        outFd = openSync(outPath, 'w');
+        const input = new ReadStream(inFd);
+        const output = new WriteStream(outFd);
+        if (!input.isTTY || !output.isTTY)
+            throw new Error('not a terminal');
+        // Without this the screen does not reflow when the window is resized: Node
+        // only wires SIGWINCH to the `process.stdout` it creates itself.
+        // `_refreshSize` is internal, so the optional chaining is deliberate — if it
+        // disappears, reflow is lost, not the interface.
+        const onResize = () => output._refreshSize?.();
+        process.on('SIGWINCH', onResize);
+        return {
+            input,
+            output,
+            fromControllingTerminal: true,
+            close() {
+                process.off('SIGWINCH', onResize);
+                for (const stream of [input, output]) {
+                    try {
+                        stream.destroy();
+                    }
+                    catch {
+                        /* already closed */
+                    }
+                }
+            },
+        };
+    }
+    catch {
+        for (const fd of [inFd, outFd]) {
+            if (fd === undefined)
+                continue;
+            try {
+                closeSync(fd);
+            }
+            catch {
+                /* nunca chegou a abrir */
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Where the UI should be drawn.
+ *
+ * The inherited fds come first: when both are already a terminal, there is
+ * nothing to resolve. The rest exists because of `npx` — on POSIX it runs the
+ * binary through a shell and the process's stdin arrives as a pipe, which made
+ * the CLI conclude nobody could answer and fall back to text mode. The terminal
+ * was there the whole time; it was the route to it that had gone missing.
+ */
+export function resolveTerminalStreams(stdin = process.stdin, stdout = process.stdout, openTerminal = openControllingTerminal) {
+    if (stdin.isTTY && stdout.isTTY) {
+        return { input: stdin, output: stdout, fromControllingTerminal: false, close: () => undefined };
+    }
+    return openTerminal();
+}
+/** Emuladores que fazem 24 bits sem anunciar nada em COLORTERM. */
+const TRUECOLOR_PROGRAMS = new Set([
+    'vscode',
+    'iterm.app',
+    'hyper',
+    'wezterm',
+    'ghostty',
+    'tabby',
+    'rio',
+    'warpterminal',
+]);
+const TRUECOLOR_TERMS = ['kitty', 'alacritty', 'wezterm', 'contour', 'foot', 'ghostty', 'direct'];
+const FORCE_LEVELS = {
+    '0': 'none',
+    '1': 'ansi16',
+    '2': 'ansi256',
+    '3': 'truecolor',
+};
+/**
+ * How many colours this terminal accepts.
+ *
+ * This decides whether the banner's gradient comes out in the theme's exact
+ * tones or quantized — and the answer has to be the same on all three platforms,
+ * or the same CLI has three appearances. `COLORTERM` alone does not give that:
+ * Windows Terminal, VS Code and iTerm all do 24-bit and none of them set it, so
+ * falling through to the `ansi16` at the end would treat them as 1990 terminals.
+ *
+ * The order runs from the most explicit to the most assumed: what the user asked
+ * for (NO_COLOR/FORCE_COLOR), what the terminal declares, who it says it is, and
+ * only then a guess from the platform.
+ */
+export function detectColorLevel(env, isTTY, force, platform = process.platform) {
+    if (force)
+        return force;
+    if (env['NO_COLOR'] !== undefined)
+        return 'none';
+    const forced = FORCE_LEVELS[(env['FORCE_COLOR'] ?? '').trim()];
+    if (forced)
+        return forced;
+    if (!isTTY)
+        return 'none';
+    const term = (env['TERM'] ?? '').toLowerCase();
+    if (term === 'dumb')
+        return 'none';
+    const colorterm = (env['COLORTERM'] ?? '').toLowerCase();
+    if (colorterm.includes('truecolor') || colorterm.includes('24bit'))
+        return 'truecolor';
+    // Windows Terminal and the Windows 10+ console both do 24-bit; neither sets
+    // COLORTERM or TERM, so without this line the CLI would look poorer exactly
+    // where it was developed.
+    if (env['WT_SESSION'] !== undefined || env['ConEmuANSI'] === 'ON')
+        return 'truecolor';
+    const program = (env['TERM_PROGRAM'] ?? '').toLowerCase();
+    if (TRUECOLOR_PROGRAMS.has(program))
+        return 'truecolor';
+    if (TRUECOLOR_TERMS.some(known => term.includes(known)))
+        return 'truecolor';
+    // macOS Terminal.app announces xterm-256color and means it: 256 colours, no
+    // 24-bit. The generic branch below would give the same answer, but saying it
+    // here stops a future TERM rule from promoting it by mistake.
+    if (program === 'apple_terminal')
+        return 'ansi256';
+    if (term.includes('256'))
+        return 'ansi256';
+    // Windows with none of the hints above is still Windows 10 or newer: Node 20,
+    // which the CLI requires, runs on nothing older.
+    if (platform === 'win32')
+        return 'truecolor';
+    return 'ansi16';
+}
+export function createTerminal(options = {}) {
+    const out = options.stdout ?? process.stdout;
+    const inp = options.stdin ?? process.stdin;
+    const caps = {
+        colors: detectColorLevel(process.env, Boolean(out.isTTY), options.forceColor),
+        unicode: (process.env['TERM'] ?? '') !== 'dumb',
+        mouse: Boolean(out.isTTY),
+        synchronizedOutput: Boolean(out.isTTY),
+        isTTY: Boolean(out.isTTY),
+    };
+    let rawOn = false;
+    let altOn = false;
+    return {
+        caps,
+        size() {
+            return { cols: out.columns ?? 80, rows: out.rows ?? 24 };
+        },
+        write(bytes) {
+            out.write(bytes);
+        },
+        writeError(bytes) {
+            process.stderr.write(bytes);
+        },
+        enterRawMode() {
+            if (inp.isTTY && !rawOn) {
+                inp.setRawMode(true);
+                inp.resume();
+                rawOn = true;
+            }
+        },
+        exitRawMode() {
+            if (inp.isTTY && rawOn) {
+                inp.setRawMode(false);
+                // enterRawMode's `resume()` holds a live reference in the event loop.
+                // Without putting stdin back to paused, the process keeps running after
+                // the wizard ends: the screen drops, the summary appears and the shell
+                // never comes back — it looks as if the final enter did nothing.
+                inp.pause();
+                rawOn = false;
+            }
+        },
+        enterAltScreen() {
+            if (!altOn) {
+                out.write(csi('?1049h'));
+                altOn = true;
+            }
+        },
+        exitAltScreen() {
+            if (altOn) {
+                out.write(csi('?1049l'));
+                altOn = false;
+            }
+        },
+        showCursor(visible) {
+            out.write(csi(visible ? '?25h' : '?25l'));
+        },
+        enableMouse(enabled) {
+            out.write(csi(enabled ? '?1000;1006h' : '?1000;1006l'));
+        },
+        onResize(cb) {
+            const handler = () => cb({ cols: out.columns ?? 80, rows: out.rows ?? 24 });
+            out.on('resize', handler);
+            return { dispose: () => out.off('resize', handler) };
+        },
+        onData(cb) {
+            inp.on('data', cb);
+            return { dispose: () => inp.off('data', cb) };
+        },
+        restore() {
+            // The attribute reset comes first, and before leaving the alt-screen: the
+            // last frame almost always ends mid-colour, and without clearing SGR that
+            // attribute still applies in the main buffer — the user's shell keeps
+            // writing in colour after the CLI has exited.
+            out.write('\x1b[0m');
+            this.showCursor(true);
+            this.enableMouse(false);
+            this.exitAltScreen();
+            this.exitRawMode();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/ui/engine/terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ui/engine/terminal/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAgBvC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB;IACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IAE1G,IAAI,IAAwB,CAAC;IAC7B,IAAI,KAAyB,CAAC;IAE9B,IAAI,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,MAAgB,EAAE,GAAG,CAAC,CAAC;QACvC,KAAK,GAAG,QAAQ,CAAC,OAAiB,EAAE,GAAG,CAAC,CAAC;QAEzC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;QAEtC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QAErE,2EAA2E;QAC3E,iEAAiE;QACjE,6EAA6E;QAC7E,iDAAiD;QACjD,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAE,MAAmD,CAAC,YAAY,EAAE,EAAE,CAAC;QACnG,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAEjC,OAAO;YACL,KAAK;YACL,MAAM;YACN,uBAAuB,EAAE,IAAI;YAC7B,KAAK;gBACH,OAAO,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAClC,KAAK,MAAM,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;oBACrC,IAAI,CAAC;wBACH,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,CAAC;oBAAC,MAAM,CAAC;wBACP,oBAAoB;oBACtB,CAAC;gBACH,CAAC;YACH,CAAC;SACF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,EAAE,KAAK,SAAS;gBAAE,SAAS;YAC/B,IAAI,CAAC;gBACH,SAAS,CAAC,EAAE,CAAC,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACP,0BAA0B;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAA2B,OAAO,CAAC,KAAK,EACxC,SAA6B,OAAO,CAAC,MAAM,EAC3C,eAA6C,uBAAuB;IAEpE,IAAI,KAAK,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC;IAClG,CAAC;IAED,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC;AA8BD,mEAAmE;AACnE,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,QAAQ;IACR,WAAW;IACX,OAAO;IACP,SAAS;IACT,SAAS;IACT,OAAO;IACP,KAAK;IACL,cAAc;CACf,CAAC,CAAC;AACH,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;AAElG,MAAM,YAAY,GAA+B;IAC/C,GAAG,EAAE,MAAM;IACX,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,SAAS;IACd,GAAG,EAAE,WAAW;CACjB,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAsB,EACtB,KAAc,EACd,KAAkB,EAClB,WAA4B,OAAO,CAAC,QAAQ;IAE5C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IACxB,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAEjD,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,IAAI,CAAC,KAAK;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IAEnC,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,WAAW,CAAC;IAEvF,4EAA4E;IAC5E,4EAA4E;IAC5E,0BAA0B;IAC1B,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,SAAS,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAEtF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,WAAW,CAAC;IACxD,IAAI,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC;IAE5E,4EAA4E;IAC5E,6EAA6E;IAC7E,8DAA8D;IAC9D,IAAI,OAAO,KAAK,gBAAgB;QAAE,OAAO,SAAS,CAAC;IAEnD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE3C,8EAA8E;IAC9E,iDAAiD;IACjD,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC;IAE7C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAA2B,EAAE;IAC1D,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAE3C,MAAM,IAAI,GAAyB;QACjC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;QAC7E,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM;QAC/C,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACzB,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;QACtC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC;KAC1B,CAAC;IAEF,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,KAAK,GAAG,KAAK,CAAC;IAElB,OAAO;QACL,IAAI;QACJ,IAAI;YACF,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,KAAK;YACT,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,UAAU,CAAC,KAAK;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,YAAY;YACV,IAAI,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC;gBACxB,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;gBACrB,GAAG,CAAC,MAAM,EAAE,CAAC;gBACb,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;QACD,WAAW;YACT,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC;gBACvB,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBACtB,sEAAsE;gBACtE,wEAAwE;gBACxE,uEAAuE;gBACvE,iEAAiE;gBACjE,GAAG,CAAC,KAAK,EAAE,CAAC;gBACZ,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;QACH,CAAC;QACD,cAAc;YACZ,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzB,KAAK,GAAG,IAAI,CAAC;YACf,CAAC;QACH,CAAC;QACD,aAAa;YACX,IAAI,KAAK,EAAE,CAAC;gBACV,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACzB,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;QACH,CAAC;QACD,UAAU,CAAC,OAAO;YAChB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5C,CAAC;QACD,WAAW,CAAC,OAAO;YACjB,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAC1D,CAAC;QACD,QAAQ,CAAC,EAAE;YACT,MAAM,OAAO,GAAG,GAAS,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;YAClF,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,CAAC;QACvD,CAAC;QACD,MAAM,CAAC,EAAE;YACP,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAChD,CAAC;QACD,OAAO;YACL,0EAA0E;YAC1E,0EAA0E;YAC1E,sEAAsE;YACtE,8CAA8C;YAC9C,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACrB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YACxB,IAAI,CAAC,aAAa,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,EAAE,CAAC;QACrB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/ui/engine/testing/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * testing — test utilities. An in-memory Terminal that captures writes
+ * deterministically (no TTY) for snapshots and byte assertions.
+ */
+import type { ColorLevel } from '../ansi/index.js';
+import type { Size } from '../frame/index.js';
+import type { Terminal } from '../terminal/index.js';
+export interface MockTerminal extends Terminal {
+    /** Todos os chunks escritos, na ordem. */
+    readonly writes: readonly string[];
+    /** The last chunk written (the frame's patch). */
+    readonly lastWrite: string;
+    /** Everything written so far, concatenated. */
+    output(): string;
+    reset(): void;
+    /** Injeta bytes no stdin simulado (dispara onData). */
+    feed(bytes: string | Buffer): void;
+    /** Simula um SIGWINCH com novo tamanho. */
+    emitResize(size: Size): void;
+}
+export interface MockTerminalOptions {
+    readonly size?: Size;
+    readonly colors?: ColorLevel;
+    readonly synchronizedOutput?: boolean;
+}
+export declare function createMockTerminal(options?: MockTerminalOptions): MockTerminal;
+//# sourceMappingURL=index.d.ts.map

package/ui/engine/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/engine/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAwB,MAAM,sBAAsB,CAAC;AAE3E,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,IAAI,MAAM,CAAC;IACjB,KAAK,IAAI,IAAI,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACnC,2CAA2C;IAC3C,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAwDlF"}

package/ui/engine/testing/index.js

@@ -0,0 +1,63 @@
+/**
+ * testing — test utilities. An in-memory Terminal that captures writes
+ * deterministically (no TTY) for snapshots and byte assertions.
+ */
+export function createMockTerminal(options = {}) {
+    let size = options.size ?? { cols: 80, rows: 24 };
+    const writes = [];
+    const dataCbs = new Set();
+    const resizeCbs = new Set();
+    const caps = {
+        colors: options.colors ?? 'truecolor',
+        unicode: true,
+        mouse: true,
+        synchronizedOutput: options.synchronizedOutput ?? true,
+        isTTY: true,
+    };
+    return {
+        caps,
+        writes,
+        get lastWrite() {
+            return writes[writes.length - 1] ?? '';
+        },
+        output() {
+            return writes.join('');
+        },
+        reset() {
+            writes.length = 0;
+        },
+        feed(bytes) {
+            const buf = typeof bytes === 'string' ? Buffer.from(bytes, 'utf8') : bytes;
+            for (const cb of [...dataCbs])
+                cb(buf);
+        },
+        emitResize(next) {
+            size = next;
+            for (const cb of [...resizeCbs])
+                cb(next);
+        },
+        size() {
+            return size;
+        },
+        write(bytes) {
+            writes.push(bytes);
+        },
+        writeError() { },
+        enterRawMode() { },
+        exitRawMode() { },
+        enterAltScreen() { },
+        exitAltScreen() { },
+        showCursor() { },
+        enableMouse() { },
+        onResize(cb) {
+            resizeCbs.add(cb);
+            return { dispose: () => resizeCbs.delete(cb) };
+        },
+        onData(cb) {
+            dataCbs.add(cb);
+            return { dispose: () => dataCbs.delete(cb) };
+        },
+        restore() { },
+    };
+}
+//# sourceMappingURL=index.js.map

package/ui/engine/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/ui/engine/testing/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAClD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC/C,MAAM,IAAI,GAAyB;QACjC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,WAAW;QACrC,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,IAAI;QACX,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,KAAK,EAAE,IAAI;KACZ,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,MAAM;QACN,IAAI,SAAS;YACX,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,MAAM;YACJ,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzB,CAAC;QACD,KAAK;YACH,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,CAAC,KAAK;YACR,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC3E,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC;gBAAE,EAAE,CAAC,GAAG,CAAC,CAAC;QACzC,CAAC;QACD,UAAU,CAAC,IAAI;YACb,IAAI,GAAG,IAAI,CAAC;YACZ,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,SAAS,CAAC;gBAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;QACD,UAAU,KAAI,CAAC;QACf,YAAY,KAAI,CAAC;QACjB,WAAW,KAAI,CAAC;QAChB,cAAc,KAAI,CAAC;QACnB,aAAa,KAAI,CAAC;QAClB,UAAU,KAAI,CAAC;QACf,WAAW,KAAI,CAAC;QAChB,QAAQ,CAAC,EAAE;YACT,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,CAAC,EAAE;YACP,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,KAAI,CAAC;KACb,CAAC;AACJ,CAAC"}

package/ui/engine/theme/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * theme — semantic colour tokens, resolved and downsampled to the terminal's
+ * capability. Themes are immutable; `extend` creates derived ones.
+ */
+import type { AnsiColor, ColorLevel } from '../ansi/index.js';
+import type { ColorRef } from '../frame/index.js';
+export type Color = string;
+export interface ThemeTokens {
+    primary: Color;
+    secondary: Color;
+    success: Color;
+    warning: Color;
+    danger: Color;
+    muted: Color;
+    foreground: Color;
+    background: Color;
+    border: Color;
+}
+export interface Theme {
+    readonly tokens: ThemeTokens;
+    resolve(ref: ColorRef | undefined, level: ColorLevel): AnsiColor;
+    extend(partial: Partial<ThemeTokens>): Theme;
+}
+export declare function createTheme(tokens?: Partial<ThemeTokens>): Theme;
+export declare const defaultTheme: Theme;
+//# sourceMappingURL=index.d.ts.map

package/ui/engine/theme/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/engine/theme/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,KAAK,CAAC;IACf,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,KAAK,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,EAAE,KAAK,CAAC;IAClB,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,SAAS,EAAE,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;IACjE,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,KAAK,CAAC;CAC9C;AA0HD,wBAAgB,WAAW,CAAC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,KAAK,CAEpE;AAED,eAAO,MAAM,YAAY,EAAE,KAAiC,CAAC"}

package/ui/engine/theme/index.js

@@ -0,0 +1,128 @@
+/**
+ * theme — semantic colour tokens, resolved and downsampled to the terminal's
+ * capability. Themes are immutable; `extend` creates derived ones.
+ */
+const DEFAULT_TOKENS = {
+    primary: '#7c93ff',
+    secondary: '#a78bfa',
+    success: '#4ade80',
+    warning: '#fbbf24',
+    danger: '#f87171',
+    muted: '#8b93a7',
+    foreground: '#e6e9f0',
+    background: '#0b0d12',
+    border: '#2b3040',
+};
+const NAMED = {
+    black: [0, 0, 0],
+    red: [205, 49, 49],
+    green: [13, 188, 121],
+    yellow: [229, 229, 16],
+    blue: [36, 114, 200],
+    magenta: [188, 63, 188],
+    cyan: [17, 168, 205],
+    white: [229, 229, 229],
+};
+function parseColor(c) {
+    const s = c.trim().toLowerCase();
+    const named = NAMED[s];
+    if (named)
+        return named;
+    const hex = s.startsWith('#') ? s.slice(1) : null;
+    if (hex && (hex.length === 3 || hex.length === 6)) {
+        const full = hex.length === 3
+            ? hex
+                .split('')
+                .map(ch => ch + ch)
+                .join('')
+            : hex;
+        const r = parseInt(full.slice(0, 2), 16);
+        const g = parseInt(full.slice(2, 4), 16);
+        const b = parseInt(full.slice(4, 6), 16);
+        if ([r, g, b].every(n => !Number.isNaN(n)))
+            return [r, g, b];
+    }
+    const m = s.match(/rgb\(\s*(\d+)[ ,]+(\d+)[ ,]+(\d+)\s*\)/);
+    if (m)
+        return [Number(m[1]), Number(m[2]), Number(m[3])];
+    return null;
+}
+// RGB → index in the 6x6x6 cube plus the ANSI-256 grayscale ramp.
+function toAnsi256(r, g, b) {
+    if (r === g && g === b) {
+        if (r < 8)
+            return 16;
+        if (r > 248)
+            return 231;
+        return Math.round(((r - 8) / 247) * 24) + 232;
+    }
+    const q = (v) => (v < 48 ? 0 : v < 115 ? 1 : Math.round((v - 35) / 40));
+    return 16 + 36 * q(r) + 6 * q(g) + q(b);
+}
+const ANSI16 = [
+    [0, 0, 0],
+    [205, 49, 49],
+    [13, 188, 121],
+    [229, 229, 16],
+    [36, 114, 200],
+    [188, 63, 188],
+    [17, 168, 205],
+    [229, 229, 229],
+    [102, 102, 102],
+    [241, 76, 76],
+    [35, 209, 139],
+    [245, 245, 67],
+    [59, 142, 234],
+    [214, 112, 214],
+    [41, 184, 219],
+    [255, 255, 255],
+];
+function toAnsi16(r, g, b) {
+    let best = 0;
+    let bestD = Infinity;
+    for (let i = 0; i < ANSI16.length; i++) {
+        const c = ANSI16[i];
+        const d = (r - c[0]) ** 2 + (g - c[1]) ** 2 + (b - c[2]) ** 2;
+        if (d < bestD) {
+            bestD = d;
+            best = i;
+        }
+    }
+    return best;
+}
+function makeTheme(tokens) {
+    const cache = new Map();
+    const resolve = (ref, level) => {
+        if (ref === undefined || level === 'none')
+            return { kind: 'default' };
+        const key = ref + '@' + level;
+        const hit = cache.get(key);
+        if (hit)
+            return hit;
+        const raw = tokens[ref] ?? ref;
+        const rgb = parseColor(raw);
+        let out;
+        if (!rgb)
+            out = { kind: 'default' };
+        else if (level === 'truecolor')
+            out = { kind: 'rgb', r: rgb[0], g: rgb[1], b: rgb[2] };
+        else if (level === 'ansi256')
+            out = { kind: 'ansi256', index: toAnsi256(rgb[0], rgb[1], rgb[2]) };
+        else
+            out = { kind: 'ansi16', index: toAnsi16(rgb[0], rgb[1], rgb[2]) };
+        cache.set(key, out);
+        return out;
+    };
+    return {
+        tokens,
+        resolve,
+        extend(partial) {
+            return makeTheme({ ...tokens, ...partial });
+        },
+    };
+}
+export function createTheme(tokens = {}) {
+    return makeTheme({ ...DEFAULT_TOKENS, ...tokens });
+}
+export const defaultTheme = makeTheme(DEFAULT_TOKENS);
+//# sourceMappingURL=index.js.map

package/ui/engine/theme/index.js.map

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

package/ui/engine/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * utils — pure string/Unicode helpers. No I/O, no dependencies.
+ * Enough for ASCII, wide characters and emoji.
+ */
+export declare function graphemes(text: string): string[];
+export declare function charWidth(grapheme: string): 0 | 1 | 2;
+export declare function stringWidth(text: string): number;
+export declare function wrapText(text: string, width: number): string[];
+export declare function truncate(text: string, width: number, ellipsis?: string): string;
+export declare function sliceByWidth(text: string, start: number, end: number): string;
+export declare function stripAnsi(text: string): string;
+//# sourceMappingURL=index.d.ts.map

package/ui/engine/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/engine/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOhD;AAqCD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAOrD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAsC9D;AAOD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,MAAM,CAa5E;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAU7E;AAGD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C"}