zard-cli 1.0.0-beta.99 → 1.0.1

package/ui/runner.js

@@ -0,0 +1,135 @@
+/**
+ * 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 { createScreen, createTerminal, resolveTerminalStreams, } from './engine/index.js';
+import { beginCapture, endCapture } from './log-sink.js';
+import { flushRecords } from './output.js';
+import { zardTheme } from './theme.js';
+/** Signals that the command has to carry on without an interactive UI (CI, pipe, --yes). */
+export class NonInteractiveError extends Error {
+    constructor(message = 'This terminal is not interactive.') {
+        super(message);
+        this.name = 'NonInteractiveError';
+    }
+}
+/** The user abandoned the wizard (Ctrl+C, or a step that cancels the flow). */
+export class WizardCancelledError extends Error {
+    constructor(message = 'Operation cancelled.') {
+        super(message);
+        this.name = 'WizardCancelledError';
+    }
+}
+/**
+ * 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 function isInteractive(resolve = resolveTerminalStreams) {
+    const streams = resolve();
+    if (!streams)
+        return false;
+    streams.close();
+    return true;
+}
+export async function runWizard(options) {
+    const streams = (options.resolveStreams ?? resolveTerminalStreams)();
+    if (!streams)
+        throw new NonInteractiveError();
+    const screen = createScreen({
+        theme: zardTheme,
+        fps: options.fps ?? 30,
+        terminal: createTerminal({ stdin: streams.input, stdout: streams.output }),
+        // Teardown is ours: we intercept Ctrl+C to end the wizard with a message,
+        // instead of killing the process from inside the engine.
+        handleExitSignals: false,
+    });
+    let settled = false;
+    let teardownDone = false;
+    const teardown = () => {
+        if (teardownDone)
+            return;
+        teardownDone = true;
+        screen.unmount();
+        // After the unmount: that is what returns the terminal to its normal state,
+        // and closing the streams first would leave the alt-screen and raw mode on.
+        streams.close();
+        process.off('exit', teardown);
+        process.off('SIGINT', onSignal);
+        process.off('SIGTERM', onSignal);
+    };
+    // Safety net: if the process dies with the screen mounted, the terminal still
+    // returns to normal (cursor visible, no raw mode, out of the 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) {
+        // Last chance to show what was held: the screen is already down and whoever
+        // handles the error above will only see the exception's message.
+        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 @@
+/**
+ * Styling for line output — what the CLI writes outside the interactive screen.
+ *
+ * Replaces chalk using the engine's own ANSI vocabulary, which keeps a single
+ * source of truth for colour: the same theme tokens apply to the wizard in the
+ * alt-screen and to the text left behind in the terminal's history.
+ */
+/** Re-evaluates the colour capability — used in tests, when stdout is swapped. */
+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;
+    /** Highlights a file name, command or path inside a sentence. */
+    code: (text: string) => string;
+};
+/** True when the terminal accepts the UI's Unicode boxes and glyphs. */
+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,kFAAkF;AAClF,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,iEAAiE;iBACpD,MAAM;CACpB,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/ui/style.js

@@ -0,0 +1,44 @@
+/**
+ * Styling for line output — what the CLI writes outside the interactive screen.
+ *
+ * Replaces chalk using the engine's own ANSI vocabulary, which keeps a single
+ * source of truth for colour: the same theme tokens apply to the wizard in the
+ * alt-screen and to the text left behind in the terminal's history.
+ */
+import { Attr, createSgrBuilder, createTerminal } from './engine/index.js';
+import { zardTheme } from './theme.js';
+let cachedLevel = null;
+/** The current terminal's colour depth, resolved once per process. */
+function colorLevel() {
+    cachedLevel ??= createTerminal().caps.colors;
+    return cachedLevel;
+}
+/** Re-evaluates the colour capability — used in tests, when stdout is swapped. */
+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),
+    /** Highlights a file name, command or path inside a sentence. */
+    code: (text) => paint(text, 'primary', Attr.Bold),
+};
+/** True when the terminal accepts the UI's Unicode boxes and glyphs. */
+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,sEAAsE;AACtE,SAAS,UAAU;IACjB,WAAW,KAAK,cAAc,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC;IAC7C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,kFAAkF;AAClF,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,iEAAiE;IACjE,IAAI,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC;CAC1D,CAAC;AAEF,wEAAwE;AACxE,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 @@
+/**
+ * A simulated TTY, to exercise wizards without a real terminal.
+ *
+ * `runWizard` refuses to mount outside a TTY — that is what protects the user
+ * from a full-screen UI inside a pipe. To test the wizard itself, then, stdout
+ * becomes a buffer and stdin an emitter we inject keyboard bytes into.
+ */
+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 @@
+/**
+ * A simulated TTY, to exercise wizards without a real terminal.
+ *
+ * `runWizard` refuses to mount outside a TTY — that is what protects the user
+ * from a full-screen UI inside a pipe. To test the wizard itself, then, stdout
+ * becomes a buffer and stdin an emitter we inject keyboard bytes into.
+ */
+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,31 @@
+/**
+ * Editing a single line of text in a wizard field.
+ *
+ * The field accepted exactly two things — typing at the end and deleting
+ * backwards. Anyone who wanted to change the middle of an alias
+ * (`@/shared/components` to `@app/shared/components`) pressed the arrow keys,
+ * saw nothing happen, and was left with no option but to delete everything and
+ * retype it. Here the cursor is real: it moves, inserts in the middle, and
+ * deletes in both directions.
+ */
+import type { KeyEvent } from '../ui/engine/index.js';
+export interface TextInput {
+    readonly value: string;
+    /** Cursor position, in characters — never outside `[0, length]`. */
+    readonly caret: number;
+    /**
+     * True while the field still shows the suggestion and the user has not touched
+     * it: the first key typed replaces the whole suggestion instead of appending
+     * to it. Moving the cursor or deleting adopts the value and starts editing it.
+     */
+    readonly pristine: boolean;
+}
+export declare function startInput(value: string): TextInput;
+/**
+ * Applies one key to the field.
+ *
+ * Returns `null` when the key is not an editing key — `enter` and `escape`
+ * belong to the wizard's flow, and it decides what to do with them.
+ */
+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;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,oEAAoE;IACpE,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,CA2C7E"}

package/ui/text-input.js

@@ -0,0 +1,89 @@
+/**
+ * Editing a single line of text in a wizard field.
+ *
+ * The field accepted exactly two things — typing at the end and deleting
+ * backwards. Anyone who wanted to change the middle of an alias
+ * (`@/shared/components` to `@app/shared/components`) pressed the arrow keys,
+ * saw nothing happen, and was left with no option but to delete everything and
+ * retype it. Here the cursor is real: it moves, inserts in the middle, and
+ * deletes in both directions.
+ */
+export function startInput(value) {
+    return { value, caret: [...value].length, pristine: true };
+}
+/**
+ * Applies one key to the field.
+ *
+ * Returns `null` when the key is not an editing key — `enter` and `escape`
+ * belong to the wizard's flow, and it decides what to do with them.
+ */
+export function editInput(state, event) {
+    const chars = [...state.value];
+    const caret = clamp(state.caret, chars.length);
+    if (event.ctrl)
+        return editWithControl(state, chars, caret, event.key);
+    if (event.alt)
+        return null;
+    if (event.key.length === 1) {
+        // The whole suggestion goes on the first key: someone who already knows what
+        // they want types straight over it, rather than deleting the CLI's proposal
+        // one character at a time.
+        if (state.pristine)
+            return { value: event.key, caret: 1, pristine: false };
+        chars.splice(caret, 0, event.key);
+        return { value: chars.join(''), caret: caret + 1, pristine: false };
+    }
+    switch (event.key) {
+        case 'backspace':
+            if (caret === 0)
+                return { ...state, caret, pristine: false };
+            chars.splice(caret - 1, 1);
+            return { value: chars.join(''), caret: caret - 1, pristine: false };
+        case 'delete':
+            if (caret >= chars.length)
+                return { ...state, caret, pristine: false };
+            chars.splice(caret, 1);
+            return { value: chars.join(''), caret, pristine: false };
+        case 'left':
+            return { ...state, caret: Math.max(0, caret - 1), pristine: false };
+        case 'right':
+            return { ...state, caret: Math.min(chars.length, caret + 1), pristine: false };
+        case 'home':
+            return { ...state, caret: 0, pristine: false };
+        case 'end':
+            return { ...state, caret: chars.length, pristine: false };
+        default:
+            return null;
+    }
+}
+/** Os atalhos de linha que qualquer shell oferece. */
+function editWithControl(state, chars, caret, key) {
+    switch (key) {
+        case 'u': // clear to the start
+            return { value: chars.slice(caret).join(''), caret: 0, pristine: false };
+        case 'k': // clear to the end
+            return { value: chars.slice(0, caret).join(''), caret, pristine: false };
+        case 'w': {
+            // apaga a palavra anterior, incluindo os separadores que a antecedem
+            let start = caret;
+            while (start > 0 && isSeparator(chars[start - 1]))
+                start--;
+            while (start > 0 && !isSeparator(chars[start - 1]))
+                start--;
+            return { value: [...chars.slice(0, start), ...chars.slice(caret)].join(''), caret: start, pristine: false };
+        }
+        case 'a':
+            return { ...state, caret: 0, pristine: false };
+        case 'e':
+            return { ...state, caret: chars.length, pristine: false };
+        default:
+            return null;
+    }
+}
+function isSeparator(char) {
+    return char === ' ' || char === '/' || char === '\\' || char === '.' || char === '-';
+}
+function clamp(caret, length) {
+    return Math.max(0, Math.min(caret, length));
+}
+//# sourceMappingURL=text-input.js.map

package/ui/text-input.js.map

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

package/ui/theme.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The CLI's theme — semantic tokens consumed by the whole terminal UI.
+ *
+ * The palette follows ZardUI's neutral base (zinc) for text and borders, with
+ * the accents reserved for state: primary marks the active step and the cursor,
+ * while success/warning/danger communicate each step's outcome.
+ */
+import { type Theme } from './engine/index.js';
+export declare const zardTheme: Theme;
+//# sourceMappingURL=theme.d.ts.map

package/ui/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE5D,eAAO,MAAM,SAAS,EAAE,KAUtB,CAAC"}

package/ui/theme.js

@@ -0,0 +1,20 @@
+/**
+ * The CLI's theme — semantic tokens consumed by the whole terminal UI.
+ *
+ * The palette follows ZardUI's neutral base (zinc) for text and borders, with
+ * the accents reserved for state: primary marks the active step and the cursor,
+ * while success/warning/danger communicate each step's outcome.
+ */
+import { createTheme } from './engine/index.js';
+export const zardTheme = createTheme({
+    primary: '#7c93ff',
+    secondary: '#a78bfa',
+    success: '#4ade80',
+    warning: '#fbbf24',
+    danger: '#f87171',
+    muted: '#a1a1aa',
+    foreground: '#fafafa',
+    background: '#09090b',
+    border: '#27272a',
+});
+//# sourceMappingURL=theme.js.map

package/ui/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/ui/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAc,MAAM,mBAAmB,CAAC;AAE5D,MAAM,CAAC,MAAM,SAAS,GAAU,WAAW,CAAC;IAC1C,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,SAAS;IACpB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,SAAS;CAClB,CAAC,CAAC"}

package/utils/angular-compat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Pins the dependencies whose releases are tied to an Angular major.
+ *
+ * Zard supports Angular 19 and above, but several of the packages it installs
+ * ship one release per Angular major and peer on `>=` that major. Asking for
+ * them by name resolves to `latest`, which peers on an Angular newer than the
+ * project's: npm then fails the whole install with ERESOLVE, and the retry with
+ * `--legacy-peer-deps` "succeeds" while leaving a version that cannot compile.
+ */
+/** The major of an Angular version string, or null when it could not be read. */
+export declare function angularMajorOf(angularVersion: string | null | undefined): number | null;
+/**
+ * The install specifier for one package.
+ *
+ * Returns the name unchanged whenever nothing is known to constrain it — an
+ * unrecognized package, or an Angular major this package has no history for.
+ */
+export declare function pinForAngular(packageName: string, angularMajor: number | null): string;
+/** `pinForAngular` over a batch, keeping the order the caller passed. */
+export declare function pinAllForAngular(packageNames: Iterable<string>, angularVersion: string | null): string[];
+//# sourceMappingURL=angular-compat.d.ts.map

package/utils/angular-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-compat.d.ts","sourceRoot":"","sources":["../../src/utils/angular-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAoBH,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAKvF;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOtF;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,EAAE,CAGxG"}

package/utils/angular-compat.js

@@ -0,0 +1,52 @@
+/**
+ * Pins the dependencies whose releases are tied to an Angular major.
+ *
+ * Zard supports Angular 19 and above, but several of the packages it installs
+ * ship one release per Angular major and peer on `>=` that major. Asking for
+ * them by name resolves to `latest`, which peers on an Angular newer than the
+ * project's: npm then fails the whole install with ERESOLVE, and the retry with
+ * `--legacy-peer-deps` "succeeds" while leaving a version that cannot compile.
+ */
+/** Packages whose own major is the Angular major, so the pin is arithmetic. */
+const TRACKS_ANGULAR_MAJOR = new Set(['@angular/cdk', 'embla-carousel-angular', 'ngx-echarts']);
+/**
+ * The newest release of a package that still accepts a given Angular major, for
+ * the packages that version on their own schedule.
+ *
+ * Entries are only ever needed for a superseded Angular major, and those never
+ * go stale: once Angular N is behind us, the last release built for it is
+ * history. The current major is deliberately absent — it falls through
+ * unconstrained to `latest`, which is the release made for it. So when Angular
+ * N+1 ships, N gets its entry here.
+ */
+const LAST_COMPATIBLE = {
+    '@ng-icons/core': { 19: '^31', 20: '^32', 21: '^34' },
+    '@ng-icons/lucide': { 19: '^31', 20: '^32', 21: '^34' },
+};
+/** The major of an Angular version string, or null when it could not be read. */
+export function angularMajorOf(angularVersion) {
+    if (!angularVersion)
+        return null;
+    const major = Number.parseInt(angularVersion.split('.')[0], 10);
+    return Number.isNaN(major) ? null : major;
+}
+/**
+ * The install specifier for one package.
+ *
+ * Returns the name unchanged whenever nothing is known to constrain it — an
+ * unrecognized package, or an Angular major this package has no history for.
+ */
+export function pinForAngular(packageName, angularMajor) {
+    if (angularMajor === null)
+        return packageName;
+    if (TRACKS_ANGULAR_MAJOR.has(packageName))
+        return `${packageName}@^${angularMajor}`;
+    const range = LAST_COMPATIBLE[packageName]?.[angularMajor];
+    return range ? `${packageName}@${range}` : packageName;
+}
+/** `pinForAngular` over a batch, keeping the order the caller passed. */
+export function pinAllForAngular(packageNames, angularVersion) {
+    const major = angularMajorOf(angularVersion);
+    return Array.from(packageNames, name => pinForAngular(name, major));
+}
+//# sourceMappingURL=angular-compat.js.map

package/utils/angular-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"angular-compat.js","sourceRoot":"","sources":["../../src/utils/angular-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,cAAc,EAAE,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;AAEhG;;;;;;;;;GASG;AACH,MAAM,eAAe,GAA2C;IAC9D,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE;IACrD,kBAAkB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE;CACxD,CAAC;AAEF,iFAAiF;AACjF,MAAM,UAAU,cAAc,CAAC,cAAyC;IACtE,IAAI,CAAC,cAAc;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,YAA2B;IAC5E,IAAI,YAAY,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IAE9C,IAAI,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,OAAO,GAAG,WAAW,KAAK,YAAY,EAAE,CAAC;IAEpF,MAAM,KAAK,GAAG,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;AACzD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,gBAAgB,CAAC,YAA8B,EAAE,cAA6B;IAC5F,MAAM,KAAK,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;IAC7C,OAAO,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AACtE,CAAC"}

package/utils/config.d.ts

@@ -5,6 +5,15 @@ declare const configSchema: z.ZodObject<{
     style: z.ZodDefault<z.ZodEnum<{
         css: "css";
     }>>;
+    icons: z.ZodDefault<z.ZodString>;
+    rtl: z.ZodDefault<z.ZodBoolean>;
+    projectType: z.ZodDefault<z.ZodEnum<{
+        angular: "angular";
+        analog: "analog";
+        nx: "nx";
+        "angular-library": "angular-library";
+        "nx-library": "nx-library";
+    }>>;
     packageManager: z.ZodDefault<z.ZodEnum<{
         npm: "npm";
         yarn: "yarn";
@@ -22,11 +31,26 @@ declare const configSchema: z.ZodObject<{
         utils: z.ZodDefault<z.ZodString>;
         core: z.ZodDefault<z.ZodString>;
         services: z.ZodDefault<z.ZodString>;
+        blocks: z.ZodDefault<z.ZodString>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type Config = z.infer<typeof configSchema>;
 export declare const DEFAULT_CONFIG: Config;
 export declare function getConfig(cwd: string): Promise<Config | null>;
+/**
+ * Splits an alias prefix from the path that follows it.
+ *
+ * `@`, `@app`, `~` — the name does not matter: the prefix is a nickname for
+ * `baseUrl`, and the rest is the path inside the project. Handling only `@/`
+ * let an alias like `@app/components` escape the substitution and become a
+ * literal folder named `@app` at the root, outside anything the tsconfig maps.
+ */
+export declare function splitAlias(alias: string): {
+    prefix: string;
+    rest: string;
+};
+/** The alias prefix, with `/*` — the key the tsconfig has to map. */
+export declare function aliasPattern(alias: string): string;
 export declare function resolveAliasToPath(alias: string, baseUrl: string): string;
 export declare function resolveConfigPaths(cwd: string, config: Config): Promise<{
     resolvedPaths: {
@@ -36,9 +60,13 @@ export declare function resolveConfigPaths(cwd: string, config: Config): Promise
         utils: string;
         core: string;
         services: string;
+        blocks: string;
     };
     appConfigFile: string;
     style: "css";
+    icons: string;
+    rtl: boolean;
+    projectType: "angular" | "analog" | "nx" | "angular-library" | "nx-library";
     packageManager: "npm" | "yarn" | "pnpm" | "bun";
     tailwind: {
         css: string;
@@ -50,6 +78,7 @@ export declare function resolveConfigPaths(cwd: string, config: Config): Promise
         utils: string;
         core: string;
         services: string;
+        blocks: string;
     };
     $schema?: string;
     registryUrl?: string;