@compass-ai/nova 1.0.73 → 1.0.74

package/dist/ui/diff-renderer.js

@@ -0,0 +1,206 @@
+/**
+ * Diff-aware terminal renderer that intercepts Ink's stdout writes.
+ *
+ * Ink renders by erasing ALL dynamic lines and rewriting them every frame
+ * (via log-update). On terminals without double-buffering — especially
+ * Windows Terminal — the erase-rewrite cycle is visible as flicker.
+ *
+ * This module wraps `process.stdout.write` and detects Ink's
+ * `eraseLines(N) + content` pattern. Instead of erasing and rewriting,
+ * it diffs the new content against the previous frame line-by-line and
+ * only updates lines that actually changed. Unchanged lines are never
+ * touched, eliminating the visible erase flash.
+ *
+ * Non-Ink writes (Static output, CompassSpinner ANSI, cursor control)
+ * pass through unmodified.
+ */
+export function installDiffRenderer() {
+    const stream = process.stdout;
+    // Only install on TTY — cursor positioning requires a real terminal
+    if (!stream.isTTY) {
+        return () => { };
+    }
+    const originalWrite = stream.write;
+    // Previous frame state
+    let prevLines = [];
+    let prevLineCount = 0;
+    // Ink's ansiEscapes.eraseLines(N) for N>=1 produces:
+    //   \x1b[2K (\x1b[1A \x1b[2K){N-1} \x1b[G
+    // Detect this at the start of a write to identify log-update frames.
+    // eslint-disable-next-line no-control-regex
+    const ERASE_RE = /^(\x1b\[2K(?:\x1b\[1A\x1b\[2K)*\x1b\[G)/;
+    // Terminal-clear sequences (Ink uses these when output exceeds screen height)
+    // eslint-disable-next-line no-control-regex
+    const CLEAR_RE = /\x1bc|\x1b\[2J/;
+    // Reset state on terminal resize — the terminal may reflow lines,
+    // making our line-position tracking invalid. The next frame falls
+    // through to a full write which re-syncs state.
+    const handleResize = () => {
+        prevLines = [];
+        prevLineCount = 0;
+    };
+    stream.on('resize', handleResize);
+    // Stderr writes go to the same terminal and can shift the visible
+    // cursor position without going through our stdout interceptor.
+    // Monitor stderr for newline-containing writes and reset state so
+    // the next Ink frame does a safe full redraw.
+    const originalStderrWrite = process.stderr.write;
+    process.stderr.write = function (chunk, encodingOrCb, cb) {
+        if (prevLineCount > 0 && typeof chunk === 'string' && chunk.includes('\n')) {
+            prevLines = [];
+            prevLineCount = 0;
+        }
+        return originalStderrWrite.call(this, chunk, encodingOrCb, cb);
+    };
+    stream.write = function (chunk, encodingOrCb, cb) {
+        // Only intercept string writes
+        if (typeof chunk !== 'string') {
+            return originalWrite.call(this, chunk, encodingOrCb, cb);
+        }
+        // Reset state on full terminal clear
+        if (CLEAR_RE.test(chunk)) {
+            prevLines = [];
+            prevLineCount = 0;
+            return originalWrite.call(this, chunk, encodingOrCb, cb);
+        }
+        // Detect Ink's eraseLines + content pattern
+        const match = chunk.match(ERASE_RE);
+        if (!match) {
+            // Not a log-update frame — pass through unchanged.
+            // If this write contains newlines and we have active state, it means
+            // something wrote directly to stdout (e.g. console.log, debug diag)
+            // outside of Ink's render cycle. This shifts the cursor position and
+            // invalidates our line tracking. Reset state so the next Ink frame
+            // falls through to a safe full redraw instead of a broken diff.
+            // When prevLineCount is 0 we're already in "first frame" mode
+            // (e.g. after a clear()), so don't reset again.
+            if (prevLineCount > 0 && chunk.includes('\n')) {
+                prevLines = [];
+                prevLineCount = 0;
+            }
+            return originalWrite.call(this, chunk, encodingOrCb, cb);
+        }
+        const content = chunk.slice(match[0].length);
+        // Pure erase (no content) = log-update's clear() method.
+        // Pass through the erase and reset our state.
+        if (!content) {
+            prevLines = [];
+            prevLineCount = 0;
+            return originalWrite.call(this, chunk, encodingOrCb, cb);
+        }
+        const newLines = content.split('\n');
+        // No previous state to diff against — pass through and capture state.
+        // This happens on first frame or after a clear().
+        if (prevLineCount === 0) {
+            prevLines = newLines;
+            prevLineCount = newLines.length;
+            return originalWrite.call(this, chunk, encodingOrCb, cb);
+        }
+        // ── Diff against previous frame ──
+        const maxRows = Math.max(newLines.length, prevLines.length);
+        // Quick identity check
+        let changeCount = 0;
+        for (let i = 0; i < maxRows; i++) {
+            if (i >= newLines.length || i >= prevLines.length || newLines[i] !== prevLines[i]) {
+                changeCount++;
+            }
+        }
+        if (changeCount === 0) {
+            // Frames are identical — skip the write entirely
+            prevLines = newLines;
+            prevLineCount = newLines.length;
+            if (typeof encodingOrCb === 'function')
+                encodingOrCb();
+            else if (typeof cb === 'function')
+                cb();
+            return true;
+        }
+        // ── Build diff buffer ──
+        //
+        // Cursor starts at the end of the previous output (row prevLineCount-1).
+        // Navigate directly to each changed line — no detour through row 0.
+        // This minimizes cursor travel, which reduces visual artifacts on
+        // terminals that render intermediate cursor positions (Windows Terminal).
+        let buf = '';
+        // Start from where the cursor actually is: the last row of previous output.
+        let cursorRow = prevLineCount - 1;
+        for (let i = 0; i < maxRows; i++) {
+            const hasNew = i < newLines.length;
+            const hasPrev = i < prevLines.length;
+            // Skip unchanged lines — they stay on screen as-is
+            if (hasNew && hasPrev && newLines[i] === prevLines[i]) {
+                continue;
+            }
+            // Move cursor to row i from wherever it currently is
+            if (i < cursorRow) {
+                // Move UP to an earlier row
+                buf += `\x1b[${cursorRow - i}A\r`;
+                cursorRow = i;
+            }
+            else if (i > cursorRow) {
+                if (i < prevLineCount) {
+                    // Row already exists on screen — cursor down + column 0
+                    buf += `\x1b[${i - cursorRow}B\r`;
+                }
+                else {
+                    // Row is beyond previous frame — need \n to create new lines.
+                    // First reach the last existing row via cursor-down...
+                    if (cursorRow < prevLineCount - 1) {
+                        buf += `\x1b[${prevLineCount - 1 - cursorRow}B`;
+                        cursorRow = prevLineCount - 1;
+                    }
+                    // ...then \n for each truly new row
+                    const count = i - cursorRow;
+                    for (let j = 0; j < count; j++)
+                        buf += '\n';
+                    buf += '\r';
+                }
+                cursorRow = i;
+            }
+            else {
+                // Already on the right row, just ensure column 0
+                buf += '\r';
+            }
+            if (hasNew) {
+                // Write new content + clear remainder of old line
+                buf += newLines[i] + '\x1b[K';
+            }
+            else {
+                // Output shrank — erase this leftover line
+                buf += '\x1b[2K';
+            }
+        }
+        // Position cursor at the last row of new output (where log-update expects it)
+        const targetRow = newLines.length - 1;
+        if (cursorRow < targetRow) {
+            if (targetRow < prevLineCount) {
+                buf += `\x1b[${targetRow - cursorRow}B`;
+            }
+            else {
+                // Some target rows may be new
+                if (cursorRow < prevLineCount - 1) {
+                    buf += `\x1b[${prevLineCount - 1 - cursorRow}B`;
+                    cursorRow = prevLineCount - 1;
+                }
+                const count = targetRow - cursorRow;
+                for (let j = 0; j < count; j++)
+                    buf += '\n';
+            }
+        }
+        else if (cursorRow > targetRow) {
+            buf += `\x1b[${cursorRow - targetRow}A`;
+        }
+        // Update state
+        prevLines = newLines;
+        prevLineCount = newLines.length;
+        // Write the diff buffer as a single atomic write
+        return originalWrite.call(this, buf, encodingOrCb, cb);
+    };
+    // Return cleanup function
+    return () => {
+        stream.write = originalWrite;
+        process.stderr.write = originalStderrWrite;
+        stream.off('resize', handleResize);
+    };
+}
+//# sourceMappingURL=diff-renderer.js.map

package/dist/ui/diff-renderer.js.map

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

package/dist/ui/themes/markdown-theme.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Centralized markdown theme configuration for terminal rendering.
+ * Uses warm, readable colors that work well on both dark and light terminals.
+ *
+ * Color philosophy:
+ * - Avoid harsh light green and light yellow (low contrast, eye strain)
+ * - Use warm tones (purple, lavender) for code highlights
+ * - Mid blue tones for headers (professional, calm)
+ * - Magenta for interactive elements (links)
+ * - High contrast white/gray for body text
+ */
+import TerminalRenderer from 'marked-terminal';
+/**
+ * Warm color palette for markdown elements
+ */
+export declare const markdownColors: {
+    readonly firstHeading: import("chalk").ChalkInstance;
+    readonly heading: import("chalk").ChalkInstance;
+    readonly code: import("chalk").ChalkInstance;
+    readonly codespan: import("chalk").ChalkInstance;
+    readonly strong: import("chalk").ChalkInstance;
+    readonly em: import("chalk").ChalkInstance;
+    readonly del: import("chalk").ChalkInstance;
+    readonly blockquote: import("chalk").ChalkInstance;
+    readonly html: import("chalk").ChalkInstance;
+    readonly link: import("chalk").ChalkInstance;
+    readonly href: import("chalk").ChalkInstance;
+    readonly listitem: import("chalk").ChalkInstance;
+    readonly paragraph: import("chalk").ChalkInstance;
+    readonly hr: import("chalk").ChalkInstance;
+    readonly table: import("chalk").ChalkInstance;
+};
+/**
+ * Creates a configured TerminalRenderer with the warm color theme.
+ * Use this when setting up marked for markdown parsing.
+ *
+ * @example
+ * ```typescript
+ * import { marked } from 'marked';
+ * import { createMarkdownRenderer } from '../themes/markdown-theme';
+ *
+ * marked.setOptions({ renderer: createMarkdownRenderer() });
+ * const html = marked.parse(markdownContent);
+ * ```
+ */
+export declare function createMarkdownRenderer(): TerminalRenderer;
+export default createMarkdownRenderer;
+//# sourceMappingURL=markdown-theme.d.ts.map

package/dist/ui/themes/markdown-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-theme.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/markdown-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;CA2BjB,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAyBzD;AAED,eAAe,sBAAsB,CAAC"}

package/dist/ui/themes/markdown-theme.js

@@ -0,0 +1,79 @@
+/**
+ * Centralized markdown theme configuration for terminal rendering.
+ * Uses warm, readable colors that work well on both dark and light terminals.
+ *
+ * Color philosophy:
+ * - Avoid harsh light green and light yellow (low contrast, eye strain)
+ * - Use warm tones (purple, lavender) for code highlights
+ * - Mid blue tones for headers (professional, calm)
+ * - Magenta for interactive elements (links)
+ * - High contrast white/gray for body text
+ */
+import chalk from 'chalk';
+import TerminalRenderer from 'marked-terminal';
+/**
+ * Warm color palette for markdown elements
+ */
+export const markdownColors = {
+    // Headers - mid blue tones for professional look
+    firstHeading: chalk.hex('#7dd3fc').bold,
+    heading: chalk.hex('#60a5fa').bold,
+    // Code - light warm purple (easy on eyes, distinct from text)
+    code: chalk.hex('#c4b5fd'),
+    codespan: chalk.hex('#c4b5fd'),
+    // Text formatting
+    strong: chalk.hex('#a78bfa').bold,
+    em: chalk.italic,
+    del: chalk.dim.strikethrough,
+    // Quotes and secondary content
+    blockquote: chalk.dim.white.italic,
+    html: chalk.dim,
+    // Links - magenta for warmth and visibility
+    link: chalk.magenta,
+    href: chalk.magentaBright.underline,
+    // Lists and structure
+    listitem: chalk.reset,
+    paragraph: chalk.reset,
+    hr: chalk.dim,
+    table: chalk.reset,
+};
+/**
+ * Creates a configured TerminalRenderer with the warm color theme.
+ * Use this when setting up marked for markdown parsing.
+ *
+ * @example
+ * ```typescript
+ * import { marked } from 'marked';
+ * import { createMarkdownRenderer } from '../themes/markdown-theme';
+ *
+ * marked.setOptions({ renderer: createMarkdownRenderer() });
+ * const html = marked.parse(markdownContent);
+ * ```
+ */
+export function createMarkdownRenderer() {
+    return new TerminalRenderer({
+        // Colors
+        firstHeading: markdownColors.firstHeading,
+        heading: markdownColors.heading,
+        code: markdownColors.code,
+        codespan: markdownColors.codespan,
+        strong: markdownColors.strong,
+        em: markdownColors.em,
+        del: markdownColors.del,
+        blockquote: markdownColors.blockquote,
+        html: markdownColors.html,
+        link: markdownColors.link,
+        href: markdownColors.href,
+        listitem: markdownColors.listitem,
+        paragraph: markdownColors.paragraph,
+        hr: markdownColors.hr,
+        table: markdownColors.table,
+        // Formatting options
+        emoji: true,
+        unescape: true,
+        tab: 2,
+        showSectionPrefix: false, // Cleaner headings without # prefix
+    });
+}
+export default createMarkdownRenderer;
+//# sourceMappingURL=markdown-theme.js.map

package/dist/ui/themes/markdown-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-theme.js","sourceRoot":"","sources":["../../../src/ui/themes/markdown-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,gBAAgB,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,iDAAiD;IACjD,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI;IACvC,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI;IAElC,8DAA8D;IAC9D,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC;IAE9B,kBAAkB;IAClB,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI;IACjC,EAAE,EAAE,KAAK,CAAC,MAAM;IAChB,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,aAAa;IAE5B,+BAA+B;IAC/B,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM;IAClC,IAAI,EAAE,KAAK,CAAC,GAAG;IAEf,4CAA4C;IAC5C,IAAI,EAAE,KAAK,CAAC,OAAO;IACnB,IAAI,EAAE,KAAK,CAAC,aAAa,CAAC,SAAS;IAEnC,sBAAsB;IACtB,QAAQ,EAAE,KAAK,CAAC,KAAK;IACrB,SAAS,EAAE,KAAK,CAAC,KAAK;IACtB,EAAE,EAAE,KAAK,CAAC,GAAG;IACb,KAAK,EAAE,KAAK,CAAC,KAAK;CACV,CAAC;AAEX;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,gBAAgB,CAAC;QAC1B,SAAS;QACT,YAAY,EAAE,cAAc,CAAC,YAAY;QACzC,OAAO,EAAE,cAAc,CAAC,OAAO;QAC/B,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,MAAM,EAAE,cAAc,CAAC,MAAM;QAC7B,EAAE,EAAE,cAAc,CAAC,EAAE;QACrB,GAAG,EAAE,cAAc,CAAC,GAAG;QACvB,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,IAAI,EAAE,cAAc,CAAC,IAAI;QACzB,QAAQ,EAAE,cAAc,CAAC,QAAQ;QACjC,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,EAAE,EAAE,cAAc,CAAC,EAAE;QACrB,KAAK,EAAE,cAAc,CAAC,KAAK;QAE3B,qBAAqB;QACrB,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,CAAC;QACN,iBAAiB,EAAE,KAAK,EAAE,oCAAoC;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,eAAe,sBAAsB,CAAC"}

package/dist/ui/themes/ui-theme.d.ts

@@ -0,0 +1,301 @@
+/**
+ * Centralized UI theme configuration for the CLI.
+ * Provides consistent colors, borders, and visual elements across all components.
+ *
+ * Design philosophy:
+ * - Use rounded borders for a modern, polished look
+ * - Cohesive indigo/purple accent palette
+ * - Subtle, non-distracting dividers
+ * - High contrast for readability
+ */
+/**
+ * Primary color palette - indigo/purple tones for a modern look
+ */
+export declare const colors: {
+    readonly primary: "#6366f1";
+    readonly primaryBright: "#818cf8";
+    readonly primaryDim: "#4f46e5";
+    readonly secondary: "#8b5cf6";
+    readonly secondaryBright: "#a78bfa";
+    readonly success: "#22c55e";
+    readonly successBright: "#4ade80";
+    readonly warning: "#f59e0b";
+    readonly warningBright: "#fbbf24";
+    readonly error: "#ef4444";
+    readonly errorBright: "#f87171";
+    readonly info: "#06b6d4";
+    readonly infoBright: "#22d3ee";
+    readonly muted: "#6b7280";
+    readonly mutedDim: "#4b5563";
+    readonly border: "#374151";
+    readonly borderLight: "#4b5563";
+    readonly text: "#f9fafb";
+    readonly textDim: "#9ca3af";
+    readonly textMuted: "#6b7280";
+};
+/**
+ * Chalk-styled color functions for easy use in components
+ */
+export declare const styled: {
+    readonly primary: import("chalk").ChalkInstance;
+    readonly primaryBright: import("chalk").ChalkInstance;
+    readonly primaryBold: import("chalk").ChalkInstance;
+    readonly secondary: import("chalk").ChalkInstance;
+    readonly secondaryBright: import("chalk").ChalkInstance;
+    readonly success: import("chalk").ChalkInstance;
+    readonly successBright: import("chalk").ChalkInstance;
+    readonly warning: import("chalk").ChalkInstance;
+    readonly warningBright: import("chalk").ChalkInstance;
+    readonly error: import("chalk").ChalkInstance;
+    readonly errorBright: import("chalk").ChalkInstance;
+    readonly info: import("chalk").ChalkInstance;
+    readonly infoBright: import("chalk").ChalkInstance;
+    readonly muted: import("chalk").ChalkInstance;
+    readonly mutedDim: import("chalk").ChalkInstance;
+    readonly text: import("chalk").ChalkInstance;
+    readonly textDim: import("chalk").ChalkInstance;
+    readonly textMuted: import("chalk").ChalkInstance;
+};
+/**
+ * Border configuration
+ * Using 'round' style for modern, polished appearance
+ */
+export declare const borders: {
+    readonly style: "round";
+    readonly styles: {
+        readonly round: "round";
+        readonly single: "single";
+        readonly double: "double";
+        readonly bold: "bold";
+    };
+    readonly color: "gray";
+    readonly colorActive: "cyan";
+    readonly colorSuccess: "green";
+    readonly colorWarning: "yellow";
+    readonly colorError: "red";
+};
+/**
+ * Divider characters and styles
+ */
+export declare const dividers: {
+    readonly light: "─";
+    readonly heavy: "━";
+    readonly dotted: "·";
+    readonly double: "═";
+    readonly verticalLight: "│";
+    readonly verticalHeavy: "┃";
+    readonly roundedTopLeft: "╭";
+    readonly roundedTopRight: "╮";
+    readonly roundedBottomLeft: "╰";
+    readonly roundedBottomRight: "╯";
+    readonly squareTopLeft: "┌";
+    readonly squareTopRight: "┐";
+    readonly squareBottomLeft: "└";
+    readonly squareBottomRight: "┘";
+};
+/**
+ * Creates a horizontal divider line
+ * @param width - Width in characters
+ * @param style - Divider style ('light', 'heavy', 'dotted', 'double')
+ */
+export declare function createDivider(width: number, style?: 'light' | 'heavy' | 'dotted' | 'double'): string;
+/**
+ * Creates a subtle divider with faded edges
+ * @param width - Total width including faded edges
+ */
+export declare function createSoftDivider(width: number): string;
+/**
+ * Common UI symbols
+ */
+export declare const symbols: {
+    readonly check: "✓";
+    readonly cross: "✗";
+    readonly bullet: "•";
+    readonly circle: "○";
+    readonly circleFilled: "●";
+    readonly diamond: "◆";
+    readonly star: "★";
+    readonly starEmpty: "☆";
+    readonly arrowRight: "→";
+    readonly arrowLeft: "←";
+    readonly arrowUp: "↑";
+    readonly arrowDown: "↓";
+    readonly pointer: "❯";
+    readonly pointerSmall: "›";
+    readonly triangleRight: "▶";
+    readonly triangleDown: "▼";
+    readonly spinner: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    readonly progress: readonly ["░", "▒", "▓", "█"];
+    readonly dots: readonly ["⠁", "⠂", "⠄", "⡀", "⢀", "⠠", "⠐", "⠈"];
+    readonly info: "ℹ";
+    readonly warning: "⚠";
+    readonly error: "✖";
+    readonly question: "?";
+    readonly ellipsis: "…";
+    readonly middot: "·";
+    readonly pipe: "│";
+};
+/**
+ * Mode indicators with consistent styling
+ */
+export declare const modeIndicators: {
+    readonly auto: {
+        readonly symbol: "⚡";
+        readonly color: "yellow";
+    };
+    readonly manual: {
+        readonly symbol: "✋";
+        readonly color: "green";
+    };
+    readonly strict: {
+        readonly symbol: "🔒";
+        readonly color: "red";
+    };
+    readonly smart: {
+        readonly symbol: "🧠";
+        readonly color: "cyan";
+    };
+};
+/**
+ * Standard spacing values (in characters/lines)
+ */
+export declare const spacing: {
+    readonly none: 0;
+    readonly xs: 1;
+    readonly sm: 2;
+    readonly md: 3;
+    readonly lg: 4;
+    readonly xl: 6;
+};
+declare const _default: {
+    colors: {
+        readonly primary: "#6366f1";
+        readonly primaryBright: "#818cf8";
+        readonly primaryDim: "#4f46e5";
+        readonly secondary: "#8b5cf6";
+        readonly secondaryBright: "#a78bfa";
+        readonly success: "#22c55e";
+        readonly successBright: "#4ade80";
+        readonly warning: "#f59e0b";
+        readonly warningBright: "#fbbf24";
+        readonly error: "#ef4444";
+        readonly errorBright: "#f87171";
+        readonly info: "#06b6d4";
+        readonly infoBright: "#22d3ee";
+        readonly muted: "#6b7280";
+        readonly mutedDim: "#4b5563";
+        readonly border: "#374151";
+        readonly borderLight: "#4b5563";
+        readonly text: "#f9fafb";
+        readonly textDim: "#9ca3af";
+        readonly textMuted: "#6b7280";
+    };
+    styled: {
+        readonly primary: import("chalk").ChalkInstance;
+        readonly primaryBright: import("chalk").ChalkInstance;
+        readonly primaryBold: import("chalk").ChalkInstance;
+        readonly secondary: import("chalk").ChalkInstance;
+        readonly secondaryBright: import("chalk").ChalkInstance;
+        readonly success: import("chalk").ChalkInstance;
+        readonly successBright: import("chalk").ChalkInstance;
+        readonly warning: import("chalk").ChalkInstance;
+        readonly warningBright: import("chalk").ChalkInstance;
+        readonly error: import("chalk").ChalkInstance;
+        readonly errorBright: import("chalk").ChalkInstance;
+        readonly info: import("chalk").ChalkInstance;
+        readonly infoBright: import("chalk").ChalkInstance;
+        readonly muted: import("chalk").ChalkInstance;
+        readonly mutedDim: import("chalk").ChalkInstance;
+        readonly text: import("chalk").ChalkInstance;
+        readonly textDim: import("chalk").ChalkInstance;
+        readonly textMuted: import("chalk").ChalkInstance;
+    };
+    borders: {
+        readonly style: "round";
+        readonly styles: {
+            readonly round: "round";
+            readonly single: "single";
+            readonly double: "double";
+            readonly bold: "bold";
+        };
+        readonly color: "gray";
+        readonly colorActive: "cyan";
+        readonly colorSuccess: "green";
+        readonly colorWarning: "yellow";
+        readonly colorError: "red";
+    };
+    dividers: {
+        readonly light: "─";
+        readonly heavy: "━";
+        readonly dotted: "·";
+        readonly double: "═";
+        readonly verticalLight: "│";
+        readonly verticalHeavy: "┃";
+        readonly roundedTopLeft: "╭";
+        readonly roundedTopRight: "╮";
+        readonly roundedBottomLeft: "╰";
+        readonly roundedBottomRight: "╯";
+        readonly squareTopLeft: "┌";
+        readonly squareTopRight: "┐";
+        readonly squareBottomLeft: "└";
+        readonly squareBottomRight: "┘";
+    };
+    symbols: {
+        readonly check: "✓";
+        readonly cross: "✗";
+        readonly bullet: "•";
+        readonly circle: "○";
+        readonly circleFilled: "●";
+        readonly diamond: "◆";
+        readonly star: "★";
+        readonly starEmpty: "☆";
+        readonly arrowRight: "→";
+        readonly arrowLeft: "←";
+        readonly arrowUp: "↑";
+        readonly arrowDown: "↓";
+        readonly pointer: "❯";
+        readonly pointerSmall: "›";
+        readonly triangleRight: "▶";
+        readonly triangleDown: "▼";
+        readonly spinner: readonly ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+        readonly progress: readonly ["░", "▒", "▓", "█"];
+        readonly dots: readonly ["⠁", "⠂", "⠄", "⡀", "⢀", "⠠", "⠐", "⠈"];
+        readonly info: "ℹ";
+        readonly warning: "⚠";
+        readonly error: "✖";
+        readonly question: "?";
+        readonly ellipsis: "…";
+        readonly middot: "·";
+        readonly pipe: "│";
+    };
+    modeIndicators: {
+        readonly auto: {
+            readonly symbol: "⚡";
+            readonly color: "yellow";
+        };
+        readonly manual: {
+            readonly symbol: "✋";
+            readonly color: "green";
+        };
+        readonly strict: {
+            readonly symbol: "🔒";
+            readonly color: "red";
+        };
+        readonly smart: {
+            readonly symbol: "🧠";
+            readonly color: "cyan";
+        };
+    };
+    spacing: {
+        readonly none: 0;
+        readonly xs: 1;
+        readonly sm: 2;
+        readonly md: 3;
+        readonly lg: 4;
+        readonly xl: 6;
+    };
+    createDivider: typeof createDivider;
+    createSoftDivider: typeof createSoftDivider;
+};
+export default _default;
+//# sourceMappingURL=ui-theme.d.ts.map

package/dist/ui/themes/ui-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-theme.d.ts","sourceRoot":"","sources":["../../../src/ui/themes/ui-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;CA8BT,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;CA4BT,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;CAkBV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;CA4BX,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAkB,GACvD,MAAM,CAGR;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCV,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;CAKjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;CAOV,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEX,wBAUE"}