zard-cli 1.0.0-beta.9 → 1.1.0-alpha.0

package/ui/index.js

@@ -0,0 +1,18 @@
+/**
+ * Superfície pública da UI da CLI.
+ *
+ * Os comandos importam daqui — nunca de `./engine` diretamente — para que a
+ * troca ou atualização da engine fique contida nesta camada.
+ */
+export * from './engine/index.js';
+export * from './blocks.js';
+export * from './brand.js';
+export * from './gate.js';
+export * from './log-sink.js';
+export * from './output.js';
+export * from './report.js';
+export * from './runner.js';
+export * from './style.js';
+export * from './text-input.js';
+export * from './theme.js';
+//# sourceMappingURL=index.js.map

package/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,YAAY,CAAC"}

package/ui/log-sink.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Sink de mensagens — desvia a saída do logger enquanto a tela interativa está
+ * montada.
+ *
+ * Em alt-screen, qualquer `console.log` disparado por um módulo interno
+ * (tsconfig-updater, theme-loader, package manager…) rasgaria o frame que a
+ * engine acabou de pintar. Durante a captura as mensagens ficam retidas aqui e
+ * são reemitidas no histórico do terminal depois do unmount, junto do resumo.
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'success' | 'debug';
+export interface LogRecord {
+    readonly level: LogLevel;
+    readonly message: string;
+}
+/** Passa a reter as mensagens do logger em vez de escrevê-las no terminal. */
+export declare function beginCapture(): void;
+/** Encerra a captura e devolve o que foi retido, na ordem em que chegou. */
+export declare function endCapture(): LogRecord[];
+export declare function isCapturing(): boolean;
+/** Retém uma mensagem. Devolve false quando não há captura ativa. */
+export declare function capture(level: LogLevel, message: string): boolean;
+/** Mensagens retidas até agora, sem encerrar a captura (para exibir na UI). */
+export declare function captured(): readonly LogRecord[];
+//# sourceMappingURL=log-sink.d.ts.map

package/ui/log-sink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-sink.d.ts","sourceRoot":"","sources":["../../src/ui/log-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAID,8EAA8E;AAC9E,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAIxC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,qEAAqE;AACrE,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,IAAI,SAAS,SAAS,EAAE,CAE/C"}

package/ui/log-sink.js

@@ -0,0 +1,35 @@
+/**
+ * Sink de mensagens — desvia a saída do logger enquanto a tela interativa está
+ * montada.
+ *
+ * Em alt-screen, qualquer `console.log` disparado por um módulo interno
+ * (tsconfig-updater, theme-loader, package manager…) rasgaria o frame que a
+ * engine acabou de pintar. Durante a captura as mensagens ficam retidas aqui e
+ * são reemitidas no histórico do terminal depois do unmount, junto do resumo.
+ */
+let buffer = null;
+/** Passa a reter as mensagens do logger em vez de escrevê-las no terminal. */
+export function beginCapture() {
+    buffer = [];
+}
+/** Encerra a captura e devolve o que foi retido, na ordem em que chegou. */
+export function endCapture() {
+    const captured = buffer ?? [];
+    buffer = null;
+    return captured;
+}
+export function isCapturing() {
+    return buffer !== null;
+}
+/** Retém uma mensagem. Devolve false quando não há captura ativa. */
+export function capture(level, message) {
+    if (buffer === null)
+        return false;
+    buffer.push({ level, message });
+    return true;
+}
+/** Mensagens retidas até agora, sem encerrar a captura (para exibir na UI). */
+export function captured() {
+    return buffer ?? [];
+}
+//# sourceMappingURL=log-sink.js.map

package/ui/log-sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-sink.js","sourceRoot":"","sources":["../../src/ui/log-sink.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,8EAA8E;AAC9E,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,EAAE,CAAC;AACd,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,UAAU;IACxB,MAAM,QAAQ,GAAG,MAAM,IAAI,EAAE,CAAC;IAC9B,MAAM,GAAG,IAAI,CAAC;IACd,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,WAAW;IACzB,OAAO,MAAM,KAAK,IAAI,CAAC;AACzB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,OAAO,CAAC,KAAe,EAAE,OAAe;IACtD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAChC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/ui/output.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Saída em linha — a única porta por onde a CLI escreve texto solto no
+ * terminal, fora da tela interativa.
+ *
+ * Concentrar a escrita aqui garante que o logger, o resumo final e as
+ * mensagens reemitidas do sink usem exatamente a mesma marcação de nível e a
+ * mesma paleta.
+ */
+import { type LogRecord } from './log-sink.js';
+export declare function writeLine(text?: string): void;
+export declare function formatRecord(record: LogRecord): string;
+/** Reemite no histórico do terminal as mensagens retidas durante a tela. */
+export declare function flushRecords(records: readonly LogRecord[]): void;
+//# sourceMappingURL=output.d.ts.map

package/ui/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/ui/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,eAAe,CAAC;AAW9D,wBAAgB,SAAS,CAAC,IAAI,SAAK,GAAG,IAAI,CAEzC;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAEtD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAEhE"}

package/ui/output.js

@@ -0,0 +1,28 @@
+/**
+ * Saída em linha — a única porta por onde a CLI escreve texto solto no
+ * terminal, fora da tela interativa.
+ *
+ * Concentrar a escrita aqui garante que o logger, o resumo final e as
+ * mensagens reemitidas do sink usem exatamente a mesma marcação de nível e a
+ * mesma paleta.
+ */
+import { style } from './style.js';
+const MARKS = {
+    info: text => `${style.primary('›')} ${text}`,
+    success: text => `${style.success('✔')} ${text}`,
+    warn: text => `${style.warning('⚠')} ${text}`,
+    error: text => `${style.danger('✖')} ${text}`,
+    debug: text => style.dim(`[debug] ${text}`),
+};
+export function writeLine(text = '') {
+    process.stdout.write(`${text}\n`);
+}
+export function formatRecord(record) {
+    return MARKS[record.level](record.message);
+}
+/** Reemite no histórico do terminal as mensagens retidas durante a tela. */
+export function flushRecords(records) {
+    for (const record of records)
+        writeLine(formatRecord(record));
+}
+//# sourceMappingURL=output.js.map

package/ui/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/ui/output.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,KAAK,GAA+C;IACxD,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAC7C,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAChD,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAC7C,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE;IAC7C,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;CAC5C,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,IAAI,GAAG,EAAE;IACjC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAiB;IAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,OAA6B;IACxD,KAAK,MAAM,MAAM,IAAI,OAAO;QAAE,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/ui/report.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Resumo pós-execução — o que permanece no histórico depois do alt-screen.
+ *
+ * Ao sair da tela cheia, tudo que o wizard desenhou desaparece. O que o usuário
+ * precisa reter (o que foi escrito, o que rodar em seguida, o que deu errado)
+ * é reimpresso aqui, no fluxo normal do terminal, onde continua rolável e
+ * copiável depois que o comando termina.
+ */
+import { type LogRecord } from './log-sink.js';
+export type ReportStatus = 'success' | 'cancelled' | 'error';
+export interface ReportCommand {
+    readonly command: string;
+    /** Trecho final destacado, como o `[component]` de `zard-cli add`. */
+    readonly argument?: string;
+}
+export interface Report {
+    readonly status: ReportStatus;
+    /** Uma frase: o desfecho do comando. */
+    readonly headline: string;
+    /** Itens do que foi efetivamente feito. */
+    readonly items?: readonly string[];
+    /** Texto de apoio, exibido em tom secundário. */
+    readonly notes?: readonly string[];
+    /** Próximos passos sugeridos. */
+    readonly commands?: readonly ReportCommand[];
+    /** Mensagens retidas enquanto a tela estava montada. */
+    readonly logs?: readonly LogRecord[];
+}
+export declare function printReport(report: Report): void;
+//# sourceMappingURL=report.d.ts.map

package/ui/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/ui/report.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAI/C,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;CACtC;AAQD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA+BhD"}

package/ui/report.js

@@ -0,0 +1,45 @@
+/**
+ * Resumo pós-execução — o que permanece no histórico depois do alt-screen.
+ *
+ * Ao sair da tela cheia, tudo que o wizard desenhou desaparece. O que o usuário
+ * precisa reter (o que foi escrito, o que rodar em seguida, o que deu errado)
+ * é reimpresso aqui, no fluxo normal do terminal, onde continua rolável e
+ * copiável depois que o comando termina.
+ */
+import { flushRecords, writeLine } from './output.js';
+import { style } from './style.js';
+const HEADLINE = {
+    success: text => `${style.success('✔')} ${style.bold(text)}`,
+    cancelled: text => `${style.warning('■')} ${style.bold(text)}`,
+    error: text => `${style.danger('✖')} ${style.bold(text)}`,
+};
+export function printReport(report) {
+    writeLine();
+    writeLine(HEADLINE[report.status](report.headline));
+    if (report.logs?.length) {
+        writeLine();
+        flushRecords(report.logs);
+    }
+    if (report.items?.length) {
+        writeLine();
+        for (const item of report.items)
+            writeLine(`  ${style.success('✔')} ${item}`);
+    }
+    if (report.notes?.length) {
+        writeLine();
+        for (const note of report.notes)
+            writeLine(`  ${style.muted(note)}`);
+    }
+    if (report.commands?.length) {
+        writeLine();
+        for (const { command, argument } of report.commands) {
+            const suffix = argument ? ` ${style.primary(argument)}` : '';
+            writeLine(`  ${style.foreground(command)}${suffix}`);
+        }
+    }
+    // Duas linhas, não uma: o prompt do shell volta logo abaixo e, colado, o
+    // último comando sugerido parece parte dele.
+    writeLine();
+    writeLine();
+}
+//# sourceMappingURL=report.js.map

package/ui/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/ui/report.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAwBnC,MAAM,QAAQ,GAAmD;IAC/D,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IAC5D,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;IAC9D,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;CAC1D,CAAC;AAEF,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,SAAS,EAAE,CAAC;IACZ,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,CAAC;QACZ,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACzB,SAAS,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,SAAS,CAAC,KAAK,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QACzB,SAAS,EAAE,CAAC;QACZ,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK;YAAE,SAAS,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvE,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC5B,SAAS,EAAE,CAAC;QACZ,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpD,MAAM,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,SAAS,CAAC,KAAK,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,yEAAyE;IACzE,6CAA6C;IAC7C,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;AACd,CAAC"}

package/ui/runner.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Runner — a ponte entre o loop de frames da engine e o fluxo async da CLI.
+ *
+ * Os comandos são sequenciais (`const config = await promptForConfig(...)`),
+ * enquanto a engine é um laço de render dirigido por eventos. O runner concilia
+ * os dois: monta a tela, entrega o controle ao `onKey`/`run` e resolve uma
+ * Promise quando o fluxo chama `done()`.
+ *
+ * Três invariantes valem para qualquer wizard:
+ *   1. o terminal é restaurado em todos os caminhos de saída — inclusive erro,
+ *      SIGINT e crash do processo;
+ *   2. sem TTY a tela nunca é montada: quem chamou recebe NonInteractiveError e
+ *      segue pelo caminho headless;
+ *   3. o que o logger escreveria durante a montagem fica retido no sink e é
+ *      reemitido depois, para não rasgar o frame.
+ */
+import { type KeyEvent, type Node, type Screen } from './engine/index.js';
+import { type LogRecord } from './log-sink.js';
+/** Sinaliza que o comando precisa seguir sem UI interativa (CI, pipe, --yes). */
+export declare class NonInteractiveError extends Error {
+    constructor(message?: string);
+}
+/** O usuário abandonou o wizard (Ctrl+C ou um passo que cancela o fluxo). */
+export declare class WizardCancelledError extends Error {
+    constructor(message?: string);
+}
+export interface WizardContext<T> {
+    /** Encerra a tela e resolve o wizard com este valor. */
+    done(value: T): void;
+    /** Encerra a tela e rejeita com WizardCancelledError. */
+    cancel(message?: string): void;
+    /** Agenda um novo frame depois de alterar o estado. */
+    refresh(): void;
+    /** Acesso à tela para casos que precisam do scheduler ou das capacidades. */
+    readonly screen: Screen;
+}
+export interface WizardOptions<T> {
+    /** View pura reconstruída a cada frame. */
+    view: () => Node;
+    /** Teclas que a view trata por conta própria. */
+    onKey?: (event: KeyEvent, ctx: WizardContext<T>) => void;
+    /**
+     * Trabalho assíncrono executado com a tela viva — instalar pacotes, escrever
+     * arquivos. A UI continua animando enquanto a promise não resolve.
+     */
+    run?: (ctx: WizardContext<T>) => Promise<void> | void;
+    fps?: number;
+}
+export interface WizardResult<T> {
+    readonly value: T;
+    /** Mensagens que o logger reteve enquanto a tela estava montada. */
+    readonly logs: readonly LogRecord[];
+}
+/** true quando dá para montar a tela interativa (entrada e saída são um TTY). */
+export declare function isInteractive(): boolean;
+export declare function runWizard<T>(options: WizardOptions<T>): Promise<WizardResult<T>>;
+//# sourceMappingURL=runner.d.ts.map

package/ui/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/ui/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAIzE,iFAAiF;AACjF,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,SAAsC;CAI1D;AAED,6EAA6E;AAC7E,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,SAAyB;CAI7C;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,wDAAwD;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACrB,yDAAyD;IACzD,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uDAAuD;IACvD,OAAO,IAAI,IAAI,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,iDAAiD;IACjD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD;;;OAGG;IACH,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;CACrC;AAED,iFAAiF;AACjF,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAmFtF"}

package/ui/runner.js

@@ -0,0 +1,119 @@
+/**
+ * Runner — a ponte entre o loop de frames da engine e o fluxo async da CLI.
+ *
+ * Os comandos são sequenciais (`const config = await promptForConfig(...)`),
+ * enquanto a engine é um laço de render dirigido por eventos. O runner concilia
+ * os dois: monta a tela, entrega o controle ao `onKey`/`run` e resolve uma
+ * Promise quando o fluxo chama `done()`.
+ *
+ * Três invariantes valem para qualquer wizard:
+ *   1. o terminal é restaurado em todos os caminhos de saída — inclusive erro,
+ *      SIGINT e crash do processo;
+ *   2. sem TTY a tela nunca é montada: quem chamou recebe NonInteractiveError e
+ *      segue pelo caminho headless;
+ *   3. o que o logger escreveria durante a montagem fica retido no sink e é
+ *      reemitido depois, para não rasgar o frame.
+ */
+import { createScreen } from './engine/index.js';
+import { beginCapture, endCapture } from './log-sink.js';
+import { flushRecords } from './output.js';
+import { zardTheme } from './theme.js';
+/** Sinaliza que o comando precisa seguir sem UI interativa (CI, pipe, --yes). */
+export class NonInteractiveError extends Error {
+    constructor(message = 'This terminal is not interactive.') {
+        super(message);
+        this.name = 'NonInteractiveError';
+    }
+}
+/** O usuário abandonou o wizard (Ctrl+C ou um passo que cancela o fluxo). */
+export class WizardCancelledError extends Error {
+    constructor(message = 'Operation cancelled.') {
+        super(message);
+        this.name = 'WizardCancelledError';
+    }
+}
+/** true quando dá para montar a tela interativa (entrada e saída são um TTY). */
+export function isInteractive() {
+    return Boolean(process.stdout.isTTY && process.stdin.isTTY);
+}
+export async function runWizard(options) {
+    if (!isInteractive())
+        throw new NonInteractiveError();
+    const screen = createScreen({
+        theme: zardTheme,
+        fps: options.fps ?? 30,
+        // O teardown é nosso: interceptamos Ctrl+C para encerrar o wizard com uma
+        // mensagem, em vez de matar o processo direto de dentro da engine.
+        handleExitSignals: false,
+    });
+    let settled = false;
+    let teardownDone = false;
+    const teardown = () => {
+        if (teardownDone)
+            return;
+        teardownDone = true;
+        screen.unmount();
+        process.off('exit', teardown);
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+    };
+    // Rede de segurança: se o processo morrer com a tela montada, o terminal
+    // ainda volta ao normal (cursor visível, sem raw mode, fora do alt-screen).
+    function onSignal() {
+        teardown();
+        process.exit(130);
+    }
+    process.on('exit', teardown);
+    process.on('SIGINT', onSignal);
+    process.on('SIGTERM', onSignal);
+    beginCapture();
+    try {
+        const value = await new Promise((resolve, reject) => {
+            const settle = (fn) => {
+                if (settled)
+                    return;
+                settled = true;
+                teardown();
+                fn();
+            };
+            const ctx = {
+                done: v => settle(() => resolve(v)),
+                cancel: message => settle(() => reject(new WizardCancelledError(message))),
+                refresh: () => screen.scheduler.requestRender(),
+                screen,
+            };
+            screen.setView(options.view);
+            screen.onKey(event => {
+                if (settled)
+                    return;
+                if (event.ctrl && (event.key === 'c' || event.key === 'd')) {
+                    ctx.cancel();
+                    return;
+                }
+                options.onKey?.(event, ctx);
+            });
+            screen.mount();
+            if (options.run) {
+                void (async () => {
+                    try {
+                        await options.run?.(ctx);
+                    }
+                    catch (error) {
+                        settle(() => reject(error));
+                    }
+                })();
+            }
+        });
+        return { value, logs: endCapture() };
+    }
+    catch (error) {
+        // Última chance de mostrar o que foi retido: a tela já caiu e quem trata o
+        // erro acima só verá a mensagem da exceção.
+        flushRecords(endCapture());
+        throw error;
+    }
+    finally {
+        teardown();
+    }
+}
+//# sourceMappingURL=runner.js.map

package/ui/runner.js.map

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

package/ui/style.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Estilo para saída em linha — o que a CLI escreve fora da tela interativa.
+ *
+ * Substitui o chalk usando o vocabulário ANSI da própria engine, o que mantém
+ * uma única fonte de verdade de cor: os mesmos tokens do tema valem para o
+ * wizard em alt-screen e para o texto que sobra no histórico do terminal.
+ */
+/** Reavalia a capacidade de cor — usado em teste, quando o stdout é trocado. */
+export declare function resetColorLevel(): void;
+export declare const style: {
+    primary: (text: string) => string;
+    success: (text: string) => string;
+    warning: (text: string) => string;
+    danger: (text: string) => string;
+    muted: (text: string) => string;
+    foreground: (text: string) => string;
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    /** Destaque de nome de arquivo, comando ou caminho dentro de uma frase. */
+    code: (text: string) => string;
+};
+/** true quando o terminal aceita as caixas e glifos Unicode da UI. */
+export declare function supportsUnicode(): boolean;
+//# sourceMappingURL=style.d.ts.map

package/ui/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,gFAAgF;AAChF,wBAAgB,eAAe,IAAI,IAAI,CAEtC;AAWD,eAAO,MAAM,KAAK;oBACA,MAAM;oBACN,MAAM;oBACN,MAAM;mBACP,MAAM;kBACP,MAAM;uBACD,MAAM;iBACZ,MAAM;gBACP,MAAM;IAClB,2EAA2E;iBAC9D,MAAM;CACpB,CAAC;AAEF,sEAAsE;AACtE,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/ui/style.js

@@ -0,0 +1,44 @@
+/**
+ * Estilo para saída em linha — o que a CLI escreve fora da tela interativa.
+ *
+ * Substitui o chalk usando o vocabulário ANSI da própria engine, o que mantém
+ * uma única fonte de verdade de cor: os mesmos tokens do tema valem para o
+ * wizard em alt-screen e para o texto que sobra no histórico do terminal.
+ */
+import { Attr, createSgrBuilder, createTerminal } from './engine/index.js';
+import { zardTheme } from './theme.js';
+let cachedLevel = null;
+/** Nível de cor do terminal atual, resolvido uma única vez por processo. */
+function colorLevel() {
+    cachedLevel ??= createTerminal().caps.colors;
+    return cachedLevel;
+}
+/** Reavalia a capacidade de cor — usado em teste, quando o stdout é trocado. */
+export function resetColorLevel() {
+    cachedLevel = null;
+}
+function paint(text, token, attrs = Attr.None) {
+    const level = colorLevel();
+    if (level === 'none' || (token === undefined && attrs === Attr.None))
+        return text;
+    const sgr = createSgrBuilder();
+    const fg = zardTheme.resolve(token, level);
+    return sgr.transition(fg, { kind: 'default' }, attrs) + text + sgr.reset();
+}
+export const style = {
+    primary: (text) => paint(text, 'primary'),
+    success: (text) => paint(text, 'success'),
+    warning: (text) => paint(text, 'warning'),
+    danger: (text) => paint(text, 'danger'),
+    muted: (text) => paint(text, 'muted'),
+    foreground: (text) => paint(text, 'foreground'),
+    bold: (text) => paint(text, undefined, Attr.Bold),
+    dim: (text) => paint(text, undefined, Attr.Dim),
+    /** Destaque de nome de arquivo, comando ou caminho dentro de uma frase. */
+    code: (text) => paint(text, 'primary', Attr.Bold),
+};
+/** true quando o terminal aceita as caixas e glifos Unicode da UI. */
+export function supportsUnicode() {
+    return createTerminal().caps.unicode;
+}
+//# sourceMappingURL=style.js.map

package/ui/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/ui/style.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAmB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,IAAI,WAAW,GAAsB,IAAI,CAAC;AAE1C,4EAA4E;AAC5E,SAAS,UAAU;IACjB,WAAW,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,eAAe;IAC7B,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED,SAAS,KAAK,CAAC,IAAY,EAAE,KAAyB,EAAE,QAAc,IAAI,CAAC,IAAI;IAC7E,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,KAAK,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAElF,MAAM,GAAG,GAAG,gBAAgB,EAAE,CAAC;IAC/B,MAAM,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3C,OAAO,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC;IACjD,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;IAC/C,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;IAC7C,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,CAAC;IACvD,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;IACzD,GAAG,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC;IACvD,2EAA2E;IAC3E,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1D,CAAC;AAEF,sEAAsE;AACtE,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;AACvC,CAAC"}

package/ui/testing/fake-tty.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Um TTY simulado para exercitar wizards sem um terminal real.
+ *
+ * `runWizard` se recusa a montar fora de um TTY — é o que protege o usuário de
+ * uma UI de tela cheia num pipe. Para testar o wizard em si, então, stdout vira
+ * um buffer e stdin um emissor onde injetamos bytes de teclado.
+ */
+export interface FakeTty {
+    /** Tudo o que foi escrito, concatenado. */
+    output(): string;
+    isRawMode(): boolean;
+    /** Injeta bytes de teclado — `\r` para enter, `\x1b[B` para seta abaixo. */
+    press(bytes: string): void;
+    restore(): void;
+}
+export declare const KEY: {
+    readonly enter: "\r";
+    readonly up: "\u001B[A";
+    readonly down: "\u001B[B";
+    readonly left: "\u001B[D";
+    readonly right: "\u001B[C";
+    readonly backspace: "";
+    readonly escape: "\u001B";
+};
+export declare function fakeTty(): FakeTty;
+//# sourceMappingURL=fake-tty.d.ts.map

package/ui/testing/fake-tty.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fake-tty.d.ts","sourceRoot":"","sources":["../../../src/ui/testing/fake-tty.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,WAAW,OAAO;IACtB,2CAA2C;IAC3C,MAAM,IAAI,MAAM,CAAC;IACjB,SAAS,IAAI,OAAO,CAAC;IACrB,4EAA4E;IAC5E,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,GAAG;;;;;;;;CAQN,CAAC;AAEX,wBAAgB,OAAO,IAAI,OAAO,CAiDjC"}

package/ui/testing/fake-tty.js

@@ -0,0 +1,61 @@
+/**
+ * Um TTY simulado para exercitar wizards sem um terminal real.
+ *
+ * `runWizard` se recusa a montar fora de um TTY — é o que protege o usuário de
+ * uma UI de tela cheia num pipe. Para testar o wizard em si, então, stdout vira
+ * um buffer e stdin um emissor onde injetamos bytes de teclado.
+ */
+import { EventEmitter } from 'node:events';
+export const KEY = {
+    enter: '\r',
+    up: '\x1b[A',
+    down: '\x1b[B',
+    left: '\x1b[D',
+    right: '\x1b[C',
+    backspace: '\x7f',
+    escape: '\x1b',
+};
+export function fakeTty() {
+    const written = [];
+    const originalWrite = process.stdout.write.bind(process.stdout);
+    const originalStdin = process.stdin;
+    const descriptors = {
+        isTTY: Object.getOwnPropertyDescriptor(process.stdout, 'isTTY'),
+        columns: Object.getOwnPropertyDescriptor(process.stdout, 'columns'),
+        rows: Object.getOwnPropertyDescriptor(process.stdout, 'rows'),
+    };
+    process.stdout.write = ((chunk) => {
+        written.push(String(chunk));
+        return true;
+    });
+    Object.defineProperty(process.stdout, 'isTTY', { value: true, configurable: true });
+    Object.defineProperty(process.stdout, 'columns', { value: 80, configurable: true });
+    Object.defineProperty(process.stdout, 'rows', { value: 24, configurable: true });
+    const stdin = new EventEmitter();
+    let rawMode = false;
+    stdin.isTTY = true;
+    stdin.setRawMode = value => {
+        rawMode = value;
+    };
+    stdin.resume = () => undefined;
+    stdin.pause = () => undefined;
+    Object.defineProperty(process, 'stdin', { value: stdin, configurable: true });
+    return {
+        output: () => written.join(''),
+        isRawMode: () => rawMode,
+        press: bytes => {
+            stdin.emit('data', Buffer.from(bytes, 'utf8'));
+        },
+        restore: () => {
+            process.stdout.write = originalWrite;
+            Object.defineProperty(process, 'stdin', { value: originalStdin, configurable: true });
+            for (const [key, descriptor] of Object.entries(descriptors)) {
+                if (descriptor)
+                    Object.defineProperty(process.stdout, key, descriptor);
+                else
+                    delete process.stdout[key];
+            }
+        },
+    };
+}
+//# sourceMappingURL=fake-tty.js.map

package/ui/testing/fake-tty.js.map

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

package/ui/text-input.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Edição de uma linha de texto num campo do wizard.
+ *
+ * O campo aceitava só duas coisas — digitar no fim e apagar de trás para a
+ * frente. Quem quisesse trocar o meio de um alias (`@/shared/components` para
+ * `@app/shared/components`) apertava as setas, não via nada acontecer e ficava
+ * sem saída a não ser apagar tudo e redigitar. Aqui o cursor é de verdade:
+ * anda, insere no meio, apaga para os dois lados.
+ */
+import type { KeyEvent } from '../ui/engine/index.js';
+export interface TextInput {
+    readonly value: string;
+    /** Posição do cursor, em caracteres — nunca fora de `[0, comprimento]`. */
+    readonly caret: number;
+    /**
+     * true enquanto o campo ainda mostra a sugestão e o usuário não tocou nela:
+     * a primeira tecla digitada substitui a sugestão inteira, em vez de emendar
+     * nela. Mover o cursor ou apagar assume o valor e passa a editá-lo.
+     */
+    readonly pristine: boolean;
+}
+export declare function startInput(value: string): TextInput;
+/**
+ * Aplica uma tecla ao campo.
+ *
+ * Devolve `null` quando a tecla não é de edição — `enter` e `escape` pertencem
+ * ao fluxo do wizard, e é ele quem decide o que fazer com elas.
+ */
+export declare function editInput(state: TextInput, event: KeyEvent): TextInput | null;
+//# sourceMappingURL=text-input.d.ts.map

package/ui/text-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-input.d.ts","sourceRoot":"","sources":["../../src/ui/text-input.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CA0C7E"}