zard-cli 1.0.0-beta.98 → 1.0.0

package/ui/engine/utils/index.js

@@ -0,0 +1,143 @@
+/**
+ * utils — pure string/Unicode helpers. No I/O, no dependencies.
+ * Enough for ASCII, wide characters and emoji.
+ */
+const SEG = typeof Intl.Segmenter === 'function'
+    ? new Intl.Segmenter('en', { granularity: 'grapheme' })
+    : null;
+export function graphemes(text) {
+    if (SEG) {
+        const out = [];
+        for (const s of SEG.segment(text))
+            out.push(s.segment);
+        return out;
+    }
+    return Array.from(text);
+}
+/** true se o code point ocupa 2 colunas (East Asian Wide/Fullwidth, emoji). */
+function isWide(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        cp === 0x2329 ||
+        cp === 0x232a ||
+        (cp >= 0x2e80 && cp <= 0x303e) || // CJK radicals, Kangxi
+        (cp >= 0x3041 && cp <= 0x33ff) || // Hiragana … CJK symbols
+        (cp >= 0x3400 && cp <= 0x4dbf) || // CJK Ext A
+        (cp >= 0x4e00 && cp <= 0x9fff) || // CJK Unified
+        (cp >= 0xa000 && cp <= 0xa4cf) || // Yi
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul Syllables
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK Compat
+        (cp >= 0xfe10 && cp <= 0xfe19) ||
+        (cp >= 0xfe30 && cp <= 0xfe6f) ||
+        (cp >= 0xff00 && cp <= 0xff60) || // Fullwidth forms
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1faff) || // emoji & symbols
+        (cp >= 0x20000 && cp <= 0x3fffd) // CJK Ext B+
+    );
+}
+/** true se combinante / largura zero. */
+function isZeroWidth(cp) {
+    return ((cp >= 0x0300 && cp <= 0x036f) ||
+        (cp >= 0x1ab0 && cp <= 0x1aff) ||
+        (cp >= 0x1dc0 && cp <= 0x1dff) ||
+        (cp >= 0x200b && cp <= 0x200f) ||
+        (cp >= 0x20d0 && cp <= 0x20ff) ||
+        (cp >= 0xfe20 && cp <= 0xfe2f) ||
+        cp === 0xfeff);
+}
+export function charWidth(grapheme) {
+    const cp = grapheme.codePointAt(0);
+    if (cp === undefined)
+        return 0;
+    if (cp < 0x20 || (cp >= 0x7f && cp <= 0x9f))
+        return 0; // controle
+    if (isZeroWidth(cp))
+        return 0;
+    if (isWide(cp))
+        return 2;
+    return 1;
+}
+export function stringWidth(text) {
+    let w = 0;
+    for (const g of graphemes(stripAnsi(text)))
+        w += charWidth(g);
+    return w;
+}
+export function wrapText(text, width) {
+    if (width <= 0)
+        return [text];
+    const out = [];
+    for (const rawLine of text.split('\n')) {
+        let line = '';
+        let lineW = 0;
+        for (const word of splitWords(rawLine)) {
+            const ww = stringWidth(word);
+            if (lineW + ww > width && lineW > 0) {
+                out.push(line);
+                line = '';
+                lineW = 0;
+            }
+            if (ww > width) {
+                // palavra maior que a largura: quebra dura por grapheme
+                if (line) {
+                    out.push(line);
+                    line = '';
+                    lineW = 0;
+                }
+                for (const g of graphemes(word)) {
+                    const gw = charWidth(g);
+                    if (lineW + gw > width) {
+                        out.push(line);
+                        line = '';
+                        lineW = 0;
+                    }
+                    line += g;
+                    lineW += gw;
+                }
+            }
+            else {
+                line += word;
+                lineW += ww;
+            }
+        }
+        out.push(line);
+    }
+    return out.length ? out : [''];
+}
+function splitWords(line) {
+    // keeps spaces attached to the following word so simple indents survive
+    return line.length ? (line.match(/\s*\S+\s*|\s+/g) ?? [line]) : [''];
+}
+export function truncate(text, width, ellipsis = '…') {
+    if (stringWidth(text) <= width)
+        return text;
+    const ew = stringWidth(ellipsis);
+    const budget = Math.max(0, width - ew);
+    let out = '';
+    let w = 0;
+    for (const g of graphemes(text)) {
+        const gw = charWidth(g);
+        if (w + gw > budget)
+            break;
+        out += g;
+        w += gw;
+    }
+    return out + ellipsis;
+}
+export function sliceByWidth(text, start, end) {
+    let out = '';
+    let col = 0;
+    for (const g of graphemes(text)) {
+        const gw = charWidth(g);
+        if (col >= start && col + gw <= end)
+            out += g;
+        col += gw;
+        if (col >= end)
+            break;
+    }
+    return out;
+}
+const ANSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
+export function stripAnsi(text) {
+    return text.replace(ANSI_RE, '');
+}
+//# sourceMappingURL=index.js.map

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

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

package/ui/gate.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Gate — lets an async flow wait for an answer from the keyboard.
+ *
+ * Linear wizards (choose → resolve → confirm → install) read far better written
+ * as one async function than as a state machine inside `onKey`. The gate is the
+ * missing piece: the flow awaits `wait()`, and the key handler calls `settle()`
+ * when the user decides.
+ */
+export interface Gate<T> {
+    wait(): Promise<T>;
+    /** Delivers the answer. Later calls are ignored. */
+    settle(value: T): void;
+    /** Interrompe quem espera, propagando o erro. */
+    fail(error: unknown): void;
+    /** True while somebody is waiting for an answer. */
+    readonly pending: boolean;
+}
+export declare function createGate<T>(): Gate<T>;
+//# sourceMappingURL=gate.d.ts.map

package/ui/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/ui/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACnB,oDAAoD;IACpD,MAAM,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACvB,iDAAiD;IACjD,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,wBAAgB,UAAU,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CA2BvC"}

package/ui/gate.js

@@ -0,0 +1,36 @@
+/**
+ * Gate — lets an async flow wait for an answer from the keyboard.
+ *
+ * Linear wizards (choose → resolve → confirm → install) read far better written
+ * as one async function than as a state machine inside `onKey`. The gate is the
+ * missing piece: the flow awaits `wait()`, and the key handler calls `settle()`
+ * when the user decides.
+ */
+export function createGate() {
+    let resolveFn = null;
+    let rejectFn = null;
+    return {
+        wait() {
+            return new Promise((resolve, reject) => {
+                resolveFn = resolve;
+                rejectFn = reject;
+            });
+        },
+        settle(value) {
+            const resolve = resolveFn;
+            resolveFn = null;
+            rejectFn = null;
+            resolve?.(value);
+        },
+        fail(error) {
+            const reject = rejectFn;
+            resolveFn = null;
+            rejectFn = null;
+            reject?.(error);
+        },
+        get pending() {
+            return resolveFn !== null;
+        },
+    };
+}
+//# sourceMappingURL=gate.js.map

package/ui/gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.js","sourceRoot":"","sources":["../../src/ui/gate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,UAAU,UAAU;IACxB,IAAI,SAAS,GAAgC,IAAI,CAAC;IAClD,IAAI,QAAQ,GAAsC,IAAI,CAAC;IAEvD,OAAO;QACL,IAAI;YACF,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACxC,SAAS,GAAG,OAAO,CAAC;gBACpB,QAAQ,GAAG,MAAM,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,KAAK;YACV,MAAM,OAAO,GAAG,SAAS,CAAC;YAC1B,SAAS,GAAG,IAAI,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,KAAK;YACR,MAAM,MAAM,GAAG,QAAQ,CAAC;YACxB,SAAS,GAAG,IAAI,CAAC;YACjB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,OAAO;YACT,OAAO,SAAS,KAAK,IAAI,CAAC;QAC5B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/ui/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The public surface of the CLI's UI.
+ *
+ * Commands import from here — never from `./engine` directly — so that replacing
+ * or upgrading the engine stays contained in this layer.
+ */
+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.d.ts.map

package/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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/index.js

@@ -0,0 +1,18 @@
+/**
+ * The public surface of the CLI's UI.
+ *
+ * Commands import from here — never from `./engine` directly — so that replacing
+ * or upgrading the engine stays contained in this layer.
+ */
+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 @@
+/**
+ * Message sink — diverts the logger's output while the interactive screen is
+ * mounted.
+ *
+ * In the alt-screen, any `console.log` fired by an internal module
+ * (tsconfig-updater, theme-loader, package manager…) would tear the frame the
+ * engine just painted. While capturing, messages are held here and re-emitted
+ * into the terminal's history after unmount, alongside the summary.
+ */
+export type LogLevel = 'info' | 'warn' | 'error' | 'success' | 'debug';
+export interface LogRecord {
+    readonly level: LogLevel;
+    readonly message: string;
+}
+/** Starts holding the logger's messages instead of writing them to the 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;
+/** Holds one message. Returns false when no capture is active. */
+export declare function capture(level: LogLevel, message: string): boolean;
+/** The messages held so far, without ending the capture (for display in the 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,oFAAoF;AACpF,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,IAAI,SAAS,EAAE,CAIxC;AAED,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,kEAAkE;AAClE,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAIjE;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,IAAI,SAAS,SAAS,EAAE,CAE/C"}

package/ui/log-sink.js

@@ -0,0 +1,35 @@
+/**
+ * Message sink — diverts the logger's output while the interactive screen is
+ * mounted.
+ *
+ * In the alt-screen, any `console.log` fired by an internal module
+ * (tsconfig-updater, theme-loader, package manager…) would tear the frame the
+ * engine just painted. While capturing, messages are held here and re-emitted
+ * into the terminal's history after unmount, alongside the summary.
+ */
+let buffer = null;
+/** Starts holding the logger's messages instead of writing them to the 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;
+}
+/** Holds one message. Returns false when no capture is active. */
+export function capture(level, message) {
+    if (buffer === null)
+        return false;
+    buffer.push({ level, message });
+    return true;
+}
+/** The messages held so far, without ending the capture (for display in the 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,oFAAoF;AACpF,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,kEAAkE;AAClE,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,oFAAoF;AACpF,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/ui/output.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Line output — the only door through which the CLI writes loose text to the
+ * terminal, outside the interactive screen.
+ *
+ * Concentrating writes here guarantees the logger, the final summary and the
+ * messages re-emitted from the sink all use exactly the same level markers and
+ * the same palette.
+ */
+import { type LogRecord } from './log-sink.js';
+export declare function writeLine(text?: string): void;
+export declare function formatRecord(record: LogRecord): string;
+/** Re-emits into the terminal's history the messages held while the screen was up. */
+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,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,GAAG,IAAI,CAEhE"}

package/ui/output.js

@@ -0,0 +1,28 @@
+/**
+ * Line output — the only door through which the CLI writes loose text to the
+ * terminal, outside the interactive screen.
+ *
+ * Concentrating writes here guarantees the logger, the final summary and the
+ * messages re-emitted from the sink all use exactly the same level markers and
+ * the same palette.
+ */
+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);
+}
+/** Re-emits into the terminal's history the messages held while the screen was up. */
+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,sFAAsF;AACtF,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 @@
+/**
+ * The post-run summary — what stays in the history after the alt-screen.
+ *
+ * On leaving the full screen, everything the wizard drew disappears. What the
+ * user needs to keep (what was written, what to run next, what went wrong) is
+ * reprinted here, in the terminal's normal flow, where it stays scrollable and
+ * copyable after the command ends.
+ */
+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;
+    /** What was actually done. */
+    readonly items?: readonly string[];
+    /** Supporting text, shown in a secondary tone. */
+    readonly notes?: readonly string[];
+    /** Suggested next steps. */
+    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,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,kDAAkD;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,4BAA4B;IAC5B,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 @@
+/**
+ * The post-run summary — what stays in the history after the alt-screen.
+ *
+ * On leaving the full screen, everything the wizard drew disappears. What the
+ * user needs to keep (what was written, what to run next, what went wrong) is
+ * reprinted here, in the terminal's normal flow, where it stays scrollable and
+ * copyable after the command ends.
+ */
+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}`);
+        }
+    }
+    // Two lines, not one: the shell prompt comes back right below and, pressed up
+    // against it, the last suggested command looks like part of it.
+    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,8EAA8E;IAC9E,gEAAgE;IAChE,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,CAAC;AACd,CAAC"}

package/ui/runner.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Runner — the bridge between the engine's frame loop and the CLI's async flow.
+ *
+ * Commands are sequential (`const config = await promptForConfig(...)`), while
+ * the engine is an event-driven render loop. The runner reconciles the two: it
+ * mounts the screen, hands control to `onKey`/`run`, and resolves a Promise when
+ * the flow calls `done()`.
+ *
+ * Three invariants hold for every wizard:
+ *   1. the terminal is restored on every exit path — errors, SIGINT and a
+ *      process crash included;
+ *   2. with no TTY the screen is never mounted: the caller gets a
+ *      NonInteractiveError and follows the headless path;
+ *   3. whatever the logger would write during the mount is held in the sink and
+ *      re-emitted afterwards, so the frame is not torn.
+ */
+import { type KeyEvent, type Node, type Screen, type TerminalStreams } from './engine/index.js';
+import { type LogRecord } from './log-sink.js';
+/** Signals that the command has to carry on without an interactive UI (CI, pipe, --yes). */
+export declare class NonInteractiveError extends Error {
+    constructor(message?: string);
+}
+/** The user abandoned the wizard (Ctrl+C, or a step that cancels the flow). */
+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;
+    /** Access to the screen, for cases that need the scheduler or the capabilities. */
+    readonly screen: Screen;
+}
+export interface WizardOptions<T> {
+    /** Pure view, rebuilt every frame. */
+    view: () => Node;
+    /** Keys the view handles on its own. */
+    onKey?: (event: KeyEvent, ctx: WizardContext<T>) => void;
+    /**
+     * Async work run with the screen alive — installing packages, writing files.
+     * The UI keeps animating until the promise resolves.
+     */
+    run?: (ctx: WizardContext<T>) => Promise<void> | void;
+    fps?: number;
+    /** How to find the terminal. Injectable for tests; the default resolves it itself. */
+    resolveStreams?: () => TerminalStreams | null;
+}
+export interface WizardResult<T> {
+    readonly value: T;
+    /** Mensagens que o logger reteve enquanto a tela estava montada. */
+    readonly logs: readonly LogRecord[];
+}
+/**
+ * True when there is a terminal to mount the screen on.
+ *
+ * Looking at `process.stdout.isTTY && process.stdin.isTTY` is not enough: that
+ * is what made `npx zard-cli init` fall back to text mode on macOS and Linux,
+ * where npm runs the binary through a shell and hands over stdin as a pipe. The
+ * controlling terminal is still reachable, and it is what decides.
+ */
+export declare function isInteractive(resolve?: () => TerminalStreams | null): 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,EAIL,KAAK,QAAQ,EACb,KAAK,IAAI,EACT,KAAK,MAAM,EACX,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA4B,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAIzE,4FAA4F;AAC5F,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,SAAsC;CAI1D;AAED,+EAA+E;AAC/E,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,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,sCAAsC;IACtC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,wCAAwC;IACxC,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;IACb,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,CAAC;CAC/C;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;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAM,eAAe,GAAG,IAA6B,GAAG,OAAO,CAMrG;AAED,wBAAsB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAwFtF"}