zard-cli 1.0.0-beta.98 → 1.0.0

package/ui/blocks.js

@@ -0,0 +1,116 @@
+/**
+ * View blocks shared by the wizards.
+ *
+ * `init` and `add` are different flows, but the user should recognise the same
+ * CLI in both: the transcript of answers, the shortcut bar in the footer and the
+ * result panels live here so they cannot diverge.
+ */
+import { column, panel, progressBar, row, spinner, text } from './engine/index.js';
+/** The footer's shortcut bar: `↑/↓ navigate    enter confirm`. */
+export function controls(pairs) {
+    const segments = [];
+    pairs.forEach(([key, label], index) => {
+        segments.push(text(key, { color: 'foreground' }));
+        segments.push(text(` ${label}${index < pairs.length - 1 ? '    ' : ''}`, { color: 'muted' }));
+    });
+    return row({}, ...segments);
+}
+/** A transcript line: one question already answered. */
+export function answeredLine(label, value) {
+    return row({ gap: 0 }, text('✔  ', { color: 'success' }), text(label, { color: 'muted' }), text('  …  ', { color: 'muted', dim: true }), text(value, { color: 'foreground' }));
+}
+/** Enunciado do passo ativo. */
+export function question(prompt) {
+    return row({ gap: 0 }, text('◆  ', { color: 'primary' }), text(prompt, { color: 'foreground', bold: true, wrap: true }));
+}
+/** Text field with a block cursor. */
+/**
+ * Text field with the cursor where it actually is.
+ *
+ * Always drawing the cursor at the end hid the fact that it can move — and
+ * without seeing the position there is no editing the middle of a value with any
+ * confidence. The character under the cursor is inverted; at the end of the line
+ * that gives the same solid block as before.
+ */
+export function textField(value, caret = [...value].length) {
+    const chars = [...value];
+    const position = Math.max(0, Math.min(caret, chars.length));
+    return row({ gap: 0 }, text('   › ', { color: 'muted' }), text(chars.slice(0, position).join(''), { color: 'foreground' }), text(chars[position] ?? ' ', { color: 'foreground', inverse: true }), text(chars.slice(position + 1).join(''), { color: 'foreground' }));
+}
+/**
+ * Single-choice list, with the active item marked by `❯`.
+ *
+ * A coloured item keeps its colour whether active or not: the colour is what
+ * identifies it. State stays legible through the marker and the weight — bold on
+ * the active one, dimmed on the rest.
+ */
+export function choiceList(choices, activeIndex) {
+    return choices.map((choice, index) => {
+        const active = index === activeIndex;
+        return row({ gap: 0 }, text(active ? '   ❯  ' : '      ', { color: 'primary', bold: active }), text(choice.label, {
+            color: choice.color ?? (active ? 'foreground' : 'muted'),
+            bold: active,
+            dim: !active,
+        }), ...(choice.hint ? [text(`   ${choice.hint}`, { color: 'muted', dim: true })] : []));
+    });
+}
+/** Multiple-choice list, with a mark per item. */
+export function checkList(choices, activeIndex, selected) {
+    return choices.map((choice, index) => {
+        const active = index === activeIndex;
+        const checked = selected.has(index);
+        return row({ gap: 0 }, text(active ? '   ❯ ' : '     ', { color: 'primary', bold: active }), text(checked ? '◼ ' : '◻ ', { color: checked ? 'success' : 'muted', dim: !checked }), text(choice.label, { color: active ? 'foreground' : checked ? 'foreground' : 'muted', bold: active }), ...(choice.hint ? [text(`   ${choice.hint}`, { color: 'muted', dim: true })] : []));
+    });
+}
+/** Par Yes/No com o lado ativo destacado. */
+export function confirmField(value) {
+    return row({ gap: 4 }, text(`   ${value ? '❯  ' : '   '}Yes`, { color: value ? 'success' : 'muted', bold: value }), text(`${!value ? '❯  ' : '   '}No`, { color: !value ? 'danger' : 'muted', bold: !value }));
+}
+/** Explanation of the active step, in secondary text. */
+export function hint(content) {
+    return text(`   ${content}`, { color: 'muted', dim: true });
+}
+/** A highlighted warning — used when declining the step aborts the flow. */
+export function warning(content) {
+    return text(`   ⚠  ${content}`, { color: 'warning', bold: true });
+}
+/** Past this point the current step starts showing how long it has been running. */
+const SLOW_TASK_MS = 3000;
+/**
+ * The list of running tasks: done ones with ✔, the current one with a spinner and
+ * the pending ones dimmed — the same vocabulary as the transcript.
+ *
+ * `elapsedMs` is the current step's runtime: past a threshold, the counter shows
+ * next to it. Installing dependencies can take minutes, and without that signal a
+ * spinning spinner is indistinguishable from a hung process.
+ */
+export function taskList(tasks, doneCount, elapsedMs) {
+    const allDone = doneCount >= tasks.length;
+    return tasks.map((task, index) => {
+        const done = index < doneCount;
+        const current = index === doneCount && !allDone;
+        const mark = done
+            ? text('✔', { color: 'success' })
+            : current
+                ? spinner({ variant: 'dots', color: 'primary' })
+                : text('○', { color: 'muted', dim: true });
+        const showElapsed = current && elapsedMs !== undefined && elapsedMs >= SLOW_TASK_MS;
+        return row({ gap: 0 }, text('   '), mark, text(`  ${task.label}`, { color: done || current ? 'foreground' : 'muted' }), ...(task.note ? [text(`  —  ${task.note}`, { color: 'muted', dim: true })] : []), ...(showElapsed ? [text(`  ${Math.round(elapsedMs / 1000)}s`, { color: 'primary', dim: true })] : []));
+    });
+}
+/** Header for the execution phase, with a spinner while work is pending. */
+export function taskHeader(label, allDone) {
+    return row({ gap: 0 }, allDone ? text('✔', { color: 'success' }) : spinner({ variant: 'dots', color: 'primary' }), text(`  ${label}`, { color: 'foreground', bold: true }));
+}
+export function progress(done, total) {
+    return progressBar({ value: total ? done / total : 1, width: 44, color: 'success', showPercent: true });
+}
+/** Painel de desfecho — sucesso, cancelamento ou falha. */
+export function resultPanel(kind, message) {
+    return panel({ border: 'round', borderColor: kind, padding: { top: 0, right: 1, bottom: 0, left: 1 } }, row({ gap: 0 }, text(kind === 'success' ? '✔  ' : '✖  ', { color: kind, bold: true }), text(message, { color: 'foreground', bold: true })));
+}
+/** A screen's standard frame: breathing room at the sides, content in a column. */
+export function page(...children) {
+    return column({ flexGrow: 1, padding: { top: 1, right: 3, bottom: 1, left: 3 }, gap: 0 }, ...children);
+}
+//# sourceMappingURL=blocks.js.map

package/ui/blocks.js.map

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

package/ui/brand.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The CLI's visual identity — the banner and the command headers.
+ *
+ * The banner only appears when there is height to spare: in short terminals it
+ * gives way to the content, which is what the user needs to see to answer.
+ */
+import { type Node } from './engine/index.js';
+/** The brand name as it is written — the slash is part of it. */
+export declare const BRAND = "zard/ui";
+export declare const ZARDUI_BANNER: string[];
+export declare function brandBanner(rows: number): Node[];
+/** A command's compact header: `◇ zard/ui · initialize`. */
+export declare function commandHeader(command: string, description?: string): Node;
+//# sourceMappingURL=brand.d.ts.map

package/ui/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/ui/brand.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAA6B,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzE,iEAAiE;AACjE,eAAO,MAAM,KAAK,YAAY,CAAC;AAE/B,eAAO,MAAM,aAAa,UAOzB,CAAC;AAQF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAKhD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAUzE"}

package/ui/brand.js

@@ -0,0 +1,35 @@
+/**
+ * The CLI's visual identity — the banner and the command headers.
+ *
+ * The banner only appears when there is height to spare: in short terminals it
+ * gives way to the content, which is what the user needs to see to answer.
+ */
+import { banner, column, row, text } from './engine/index.js';
+/** The brand name as it is written — the slash is part of it. */
+export const BRAND = 'zard/ui';
+export const ZARDUI_BANNER = [
+    '███████╗ █████╗ ██████╗ ██████╗     ██╗██╗   ██╗██╗',
+    '╚══███╔╝██╔══██╗██╔══██╗██╔══██╗   ██╔╝██║   ██║██║',
+    '  ███╔╝ ███████║██████╔╝██║  ██║  ██╔╝ ██║   ██║██║',
+    ' ███╔╝  ██╔══██║██╔══██╗██║  ██║ ██╔╝  ██║   ██║██║',
+    '███████╗██║  ██║██║  ██║██████╔╝██╔╝   ╚██████╔╝██║',
+    '╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝╚═════╝ ╚═╝     ╚═════╝ ╚═╝',
+];
+const BANNER_COLOR = '#fafafa';
+const TAGLINE = 'The Angular component toolkit · beautiful components in seconds';
+/** Minimum height for the banner to fit without squeezing the questions. */
+const BANNER_MIN_ROWS = 24;
+export function brandBanner(rows) {
+    if (rows < BANNER_MIN_ROWS) {
+        return [row({ gap: 1 }, text('◇', { color: 'primary' }), text(BRAND, { color: 'foreground', bold: true }))];
+    }
+    return [banner({ lines: ZARDUI_BANNER, colors: [BANNER_COLOR] }), text(TAGLINE, { color: 'muted', dim: true })];
+}
+/** A command's compact header: `◇ zard/ui · initialize`. */
+export function commandHeader(command, description) {
+    const head = row({ gap: 1 }, text('◇', { color: 'success' }), text(BRAND, { color: 'foreground', bold: true }), text(`· ${command}`, { color: 'muted' }));
+    if (!description)
+        return head;
+    return column({}, head, text(description, { color: 'muted', dim: true }));
+}
+//# sourceMappingURL=brand.js.map

package/ui/brand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.js","sourceRoot":"","sources":["../../src/ui/brand.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAa,MAAM,mBAAmB,CAAC;AAEzE,iEAAiE;AACjE,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC;AAE/B,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,qDAAqD;IACrD,qDAAqD;IACrD,qDAAqD;IACrD,qDAAqD;IACrD,qDAAqD;IACrD,qDAAqD;CACtD,CAAC;AAEF,MAAM,YAAY,GAAG,SAAS,CAAC;AAC/B,MAAM,OAAO,GAAG,iEAAiE,CAAC;AAElF,4EAA4E;AAC5E,MAAM,eAAe,GAAG,EAAE,CAAC;AAE3B,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,IAAI,GAAG,eAAe,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC9G,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAClH,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,WAAoB;IACjE,MAAM,IAAI,GAAG,GAAG,CACd,EAAE,GAAG,EAAE,CAAC,EAAE,EACV,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAC/B,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAChD,IAAI,CAAC,KAAK,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CACzC,CAAC;IAEF,IAAI,CAAC,WAAW;QAAE,OAAO,IAAI,CAAC;IAC9B,OAAO,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5E,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * animation — FPS-independent tweens (they use real dt), easing, and a keyed
+ * clock that survives a re-render. The basis of spinner/progress/fade/typing/pulse.
+ */
+export type Easing = (t: number) => number;
+export declare const Easing: {
+    readonly linear: Easing;
+    readonly easeIn: Easing;
+    readonly easeOut: Easing;
+    readonly easeInOut: Easing;
+    readonly spring: Easing;
+};
+export interface TweenOptions {
+    readonly from: number;
+    readonly to: number;
+    readonly duration: number;
+    readonly easing?: Easing;
+    readonly loop?: boolean | 'pingpong';
+}
+export interface Tween {
+    readonly value: number;
+    readonly done: boolean;
+    update(dtMs: number): void;
+    reset(): void;
+}
+export declare function tween(options: TweenOptions): Tween;
+export interface AnimationClock {
+    register(key: string, tween: Tween): void;
+    has(key: string): boolean;
+    phase(key: string): number;
+    remove(key: string): void;
+    tick(dtMs: number): void;
+    readonly active: boolean;
+}
+export declare function createAnimationClock(): AnimationClock;
+/** Frames de spinner nomeados (dots, line, arc, bounce, pulse). */
+export declare const spinnerFrames: Readonly<Record<string, readonly string[]>>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/engine/animation/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;AAI3C,eAAO,MAAM,MAAM,EAAE;IACnB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CAmBzB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CACtC;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAyClD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAuBrD;AAED,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAMrE,CAAC"}

package/ui/engine/animation/index.js

@@ -0,0 +1,102 @@
+/**
+ * animation — FPS-independent tweens (they use real dt), easing, and a keyed
+ * clock that survives a re-render. The basis of spinner/progress/fade/typing/pulse.
+ */
+const clamp01 = (t) => (t < 0 ? 0 : t > 1 ? 1 : t);
+export const Easing = {
+    linear: t => clamp01(t),
+    easeIn: t => {
+        t = clamp01(t);
+        return t * t;
+    },
+    easeOut: t => {
+        t = clamp01(t);
+        return 1 - (1 - t) * (1 - t);
+    },
+    easeInOut: t => {
+        t = clamp01(t);
+        return t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2;
+    },
+    spring: t => {
+        t = clamp01(t);
+        return 1 - Math.cos(t * Math.PI * 1.5) * (1 - t);
+    },
+};
+export function tween(options) {
+    const easing = options.easing ?? Easing.linear;
+    const dur = Math.max(1, options.duration);
+    let elapsed = 0;
+    let dir = 1;
+    const compute = () => {
+        let t = elapsed / dur;
+        let done = false;
+        if (options.loop === 'pingpong') {
+            t = clamp01(t);
+        }
+        else if (options.loop) {
+            t = t % 1;
+        }
+        else if (t >= 1) {
+            t = 1;
+            done = true;
+        }
+        const eased = easing(t);
+        const value = options.from + (options.to - options.from) * (dir < 0 ? 1 - eased : eased);
+        return { value, done };
+    };
+    return {
+        get value() {
+            return compute().value;
+        },
+        get done() {
+            return compute().done;
+        },
+        update(dtMs) {
+            elapsed += dtMs;
+            if (options.loop === 'pingpong' && elapsed >= dur) {
+                elapsed = elapsed % dur;
+                dir *= -1;
+            }
+        },
+        reset() {
+            elapsed = 0;
+            dir = 1;
+        },
+    };
+}
+export function createAnimationClock() {
+    const tweens = new Map();
+    return {
+        register(key, t) {
+            tweens.set(key, t);
+        },
+        has(key) {
+            return tweens.has(key);
+        },
+        phase(key) {
+            return tweens.get(key)?.value ?? 0;
+        },
+        remove(key) {
+            tweens.delete(key);
+        },
+        tick(dtMs) {
+            for (const t of tweens.values())
+                t.update(dtMs);
+        },
+        get active() {
+            for (const t of tweens.values())
+                if (!t.done)
+                    return true;
+            return false;
+        },
+    };
+}
+/** Frames de spinner nomeados (dots, line, arc, bounce, pulse). */
+export const spinnerFrames = {
+    dots: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    line: ['-', '\\', '|', '/'],
+    arc: ['◜', '◠', '◝', '◞', '◡', '◟'],
+    bounce: ['⠁', '⠂', '⠄', '⠂'],
+    pulse: ['•', '●', '◉', '●'],
+};
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,51 @@
+/**
+ * ansi — generates escape sequences (CSI/SGR) and defines the colour vocabulary.
+ * The lowest level that "knows" the terminal protocol. No I/O.
+ */
+/** The colour depth the terminal supports (see TerminalCapabilities). */
+export type ColorLevel = 'truecolor' | 'ansi256' | 'ansi16' | 'none';
+/** A concrete colour already resolved for a depth — ready to become SGR bytes. */
+export type AnsiColor = {
+    readonly kind: 'rgb';
+    readonly r: number;
+    readonly g: number;
+    readonly b: number;
+} | {
+    readonly kind: 'ansi256';
+    readonly index: number;
+} | {
+    readonly kind: 'ansi16';
+    readonly index: number;
+} | {
+    readonly kind: 'default';
+};
+/**
+ * Text attributes as a bitmask (comparable by value, cheap to diff).
+ * A const object, not a `const enum`, to stay compatible with `isolatedModules`.
+ */
+export declare const Attr: {
+    readonly None: 0;
+    readonly Bold: number;
+    readonly Dim: number;
+    readonly Italic: number;
+    readonly Underline: number;
+    readonly Inverse: number;
+    readonly Strike: number;
+    readonly Blink: number;
+};
+/** An attribute bitmask value (combinable with bitwise OR). */
+export type Attr = number;
+export declare const ESC = "\u001B";
+/** Builds a CSI sequence (`ESC [ … `). e.g. csi("2J"), csi(`${y};${x}H`). */
+export declare function csi(body: string): string;
+/**
+ * Incremental SGR builder that emits ONLY the delta against the current state —
+ * the key to minimizing bytes in the encoder (ARCHITECTURE §17).
+ */
+export interface SgrBuilder {
+    transition(fg: AnsiColor, bg: AnsiColor, attrs: Attr): string;
+    reset(): string;
+    clear(): void;
+}
+export declare function createSgrBuilder(): SgrBuilder;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/engine/ansi/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,yEAAyE;AACzE,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE,kFAAkF;AAClF,MAAM,MAAM,SAAS,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC;AAEjC;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;CASP,CAAC;AACX,+DAA+D;AAC/D,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC;AAE1B,eAAO,MAAM,GAAG,WAAS,CAAC;AAE1B,6EAA6E;AAC7E,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExC;AAsCD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,GAAG,MAAM,CAAC;IAC9D,KAAK,IAAI,MAAM,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CA8C7C"}

package/ui/engine/ansi/index.js

@@ -0,0 +1,116 @@
+/**
+ * ansi — generates escape sequences (CSI/SGR) and defines the colour vocabulary.
+ * The lowest level that "knows" the terminal protocol. No I/O.
+ */
+/**
+ * Text attributes as a bitmask (comparable by value, cheap to diff).
+ * A const object, not a `const enum`, to stay compatible with `isolatedModules`.
+ */
+export const Attr = {
+    None: 0,
+    Bold: 1 << 0,
+    Dim: 1 << 1,
+    Italic: 1 << 2,
+    Underline: 1 << 3,
+    Inverse: 1 << 4,
+    Strike: 1 << 5,
+    Blink: 1 << 6,
+};
+export const ESC = '\x1b';
+/** Builds a CSI sequence (`ESC [ … `). e.g. csi("2J"), csi(`${y};${x}H`). */
+export function csi(body) {
+    return ESC + '[' + body;
+}
+const DEFAULT_COLOR = { kind: 'default' };
+function sameColor(a, b) {
+    if (a.kind !== b.kind)
+        return false;
+    if (a.kind === 'rgb' && b.kind === 'rgb')
+        return a.r === b.r && a.g === b.g && a.b === b.b;
+    if (a.kind === 'ansi256' && b.kind === 'ansi256')
+        return a.index === b.index;
+    if (a.kind === 'ansi16' && b.kind === 'ansi16')
+        return a.index === b.index;
+    return a.kind === b.kind; // default
+}
+function colorCodes(c, fg) {
+    const base = fg ? 38 : 48;
+    switch (c.kind) {
+        case 'rgb':
+            return [base, 2, c.r, c.g, c.b];
+        case 'ansi256':
+            return [base, 5, c.index];
+        case 'ansi16':
+            return c.index < 8 ? [(fg ? 30 : 40) + c.index] : [(fg ? 90 : 100) + (c.index - 8)];
+        case 'default':
+            return [fg ? 39 : 49];
+    }
+}
+function attrCodes(mask) {
+    const out = [];
+    if (mask & Attr.Bold)
+        out.push(1);
+    if (mask & Attr.Dim)
+        out.push(2);
+    if (mask & Attr.Italic)
+        out.push(3);
+    if (mask & Attr.Underline)
+        out.push(4);
+    if (mask & Attr.Blink)
+        out.push(5);
+    if (mask & Attr.Inverse)
+        out.push(7);
+    if (mask & Attr.Strike)
+        out.push(9);
+    return out;
+}
+export function createSgrBuilder() {
+    let curFg = DEFAULT_COLOR;
+    let curBg = DEFAULT_COLOR;
+    let curAttrs = 0;
+    return {
+        transition(fg, bg, attrs) {
+            const removingAttr = (curAttrs & ~attrs) !== 0;
+            const fgToDefault = fg.kind === 'default' && curFg.kind !== 'default';
+            const bgToDefault = bg.kind === 'default' && curBg.kind !== 'default';
+            if (removingAttr || fgToDefault || bgToDefault) {
+                // There is no cheap way to turn attributes off selectively → reset and rebuild.
+                const codes = [0, ...attrCodes(attrs)];
+                if (fg.kind !== 'default')
+                    codes.push(...colorCodes(fg, true));
+                if (bg.kind !== 'default')
+                    codes.push(...colorCodes(bg, false));
+                curFg = fg;
+                curBg = bg;
+                curAttrs = attrs;
+                return csi(codes.join(';') + 'm');
+            }
+            const codes = [];
+            const addedAttrs = attrs & ~curAttrs;
+            if (addedAttrs)
+                codes.push(...attrCodes(addedAttrs));
+            if (!sameColor(fg, curFg))
+                codes.push(...colorCodes(fg, true));
+            if (!sameColor(bg, curBg))
+                codes.push(...colorCodes(bg, false));
+            curFg = fg;
+            curBg = bg;
+            curAttrs = attrs;
+            if (codes.length === 0)
+                return '';
+            return csi(codes.join(';') + 'm');
+        },
+        reset() {
+            curFg = DEFAULT_COLOR;
+            curBg = DEFAULT_COLOR;
+            curAttrs = 0;
+            return csi('0m');
+        },
+        clear() {
+            curFg = DEFAULT_COLOR;
+            curBg = DEFAULT_COLOR;
+            curAttrs = 0;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

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