zard-cli 1.0.0-beta.102 → 1.0.0-beta.104

package/ui/engine/terminal/index.js

@@ -0,0 +1,235 @@
+/**
+ * terminal — ÚNICA fronteira de I/O de baixo nível (ADR-0007). Ninguém mais
+ * toca process.stdout/stdin. Detecta capacidades e faz raw mode/alt-screen.
+ * (Fatia vertical / PoC: implementação real mínima.)
+ */
+import { closeSync, openSync } from 'node:fs';
+import { ReadStream, WriteStream } from 'node:tty';
+import { csi } from '../ansi/index.js';
+/**
+ * Abre o terminal de controle do processo, ignorando os fds herdados.
+ *
+ * `/dev/tty` é o terminal ao qual o processo está ligado, independentemente do
+ * que quem o invocou tenha feito com stdin e stdout. É o mecanismo que `fzf`,
+ * `less` e o `git rebase -i` usam para continuar interativos dentro de um pipe;
+ * no Windows, `CONIN$`/`CONOUT$` são o equivalente.
+ *
+ * Devolve null quando não há terminal nenhum — CI de verdade, um cron, um
+ * contêiner sem tty —, e é isso que mantém o caminho headless funcionando onde
+ * ele deve funcionar.
+ */
+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');
+        // Sem isto a tela não reflui ao redimensionar a janela: o Node só liga o
+        // SIGWINCH ao `process.stdout` que ele mesmo cria. `_refreshSize` é interno,
+        // então o encadeamento opcional é proposital — sumindo, perde-se o reflow,
+        // não a 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 {
+                        /* já fechado */
+                    }
+                }
+            },
+        };
+    }
+    catch {
+        for (const fd of [inFd, outFd]) {
+            if (fd === undefined)
+                continue;
+            try {
+                closeSync(fd);
+            }
+            catch {
+                /* nunca chegou a abrir */
+            }
+        }
+        return null;
+    }
+}
+/**
+ * Onde a UI deve ser desenhada.
+ *
+ * Os fds herdados vêm primeiro: quando os dois já são um terminal, não há o que
+ * resolver. O resto existe por causa do `npx` — em POSIX ele executa o binário
+ * através de um shell e o stdin do processo chega como pipe, o que fazia a CLI
+ * concluir que ninguém podia responder e cair no modo texto. O terminal estava
+ * lá o tempo todo; era o caminho até ele que tinha sumido.
+ */
+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',
+};
+/**
+ * Quantas cores este terminal aceita.
+ *
+ * Isto é o que decide se o gradiente do banner sai nos tons exatos do tema ou
+ * quantizado — e a resposta precisa ser a mesma nas três plataformas, senão a
+ * mesma CLI tem três aparências. `COLORTERM` sozinho não dá isso: o Windows
+ * Terminal, o VS Code e o iTerm fazem 24 bits e não o definem, então cair no
+ * `ansi16` do fim da função os trataria como terminais de 1990.
+ *
+ * A ordem é do mais explícito para o mais suposto: o que o usuário pediu
+ * (NO_COLOR/FORCE_COLOR), o que o terminal declara, quem ele diz ser, e só
+ * então o palpite pela plataforma.
+ */
+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';
+    // O Windows Terminal e o console do Windows 10+ fazem 24 bits; nenhum dos
+    // dois define COLORTERM ou TERM, então sem esta linha a CLI ficaria mais
+    // pobre justamente onde ela foi desenvolvida.
+    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';
+    // O Terminal.app do macOS anuncia xterm-256color e é honesto: 256 cores, sem
+    // 24 bits. Cair no ramo genérico abaixo já daria isso, mas dizê-lo aqui
+    // impede que uma regra futura sobre TERM o promova por engano.
+    if (program === 'apple_terminal')
+        return 'ansi256';
+    if (term.includes('256'))
+        return 'ansi256';
+    // Windows sem nenhuma das pistas acima ainda é Windows 10 ou mais novo: o
+    // Node 20, que a CLI exige, não roda em nada anterior.
+    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);
+                // O `resume()` de enterRawMode segura uma referência viva no event
+                // loop. Sem devolver o stdin ao estado pausado, o processo continua
+                // rodando depois que o wizard termina: a tela cai, o resumo aparece e
+                // o shell nunca volta — parece que o enter final não fez nada.
+                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() {
+            // O reset de atributos vem primeiro, e antes de sair do alt-screen: o
+            // último frame quase sempre termina no meio de uma cor, e sem zerar o SGR
+            // esse atributo continua valendo no buffer principal — o shell do usuário
+            // fica escrevendo colorido depois que a CLI já saiu.
+            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":"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"}

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

@@ -0,0 +1,27 @@
+/**
+ * testing — utilitários para teste/PoC. Um Terminal em memória que captura
+ * writes de forma determinística (sem TTY) para snapshots e asserções de bytes.
+ */
+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[];
+    /** Último chunk escrito (o patch do frame). */
+    readonly lastWrite: string;
+    /** Concatenação de tudo. */
+    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,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,4BAA4B;IAC5B,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 — utilitários para teste/PoC. Um Terminal em memória que captura
+ * writes de forma determinística (sem TTY) para snapshots e asserções de bytes.
+ */
+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,27 @@
+/**
+ * theme — tokens semânticos de cor e resolução/downsampling para a
+ * capacidade do terminal. Temas são imutáveis; `extend` cria derivados.
+ * (Fatia vertical / PoC: implementação real.)
+ */
+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;;;;GAIG;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,129 @@
+/**
+ * theme — tokens semânticos de cor e resolução/downsampling para a
+ * capacidade do terminal. Temas são imutáveis; `extend` cria derivados.
+ * (Fatia vertical / PoC: implementação real.)
+ */
+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 → índice do cubo 6x6x6 + rampa de cinza do ANSI-256.
+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 — helpers puros de string/Unicode. Sem I/O, sem dependências.
+ * (Fatia vertical / PoC: implementação real, suficiente para ASCII + wide + 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"}