@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/terminal.d.ts

@@ -65,6 +65,17 @@ export declare function clearLinesAbove(count: number): void;
  * Clear entire screen
  */
 export declare function clearScreen(): void;
+/**
+ * Enter alternate screen buffer.
+ * Content shown here doesn't go to main scrollback.
+ * Used for modal UIs like menus, editors.
+ */
+export declare function enterAlternateScreen(): void;
+/**
+ * Leave alternate screen buffer.
+ * Returns to main screen (previous content restored).
+ */
+export declare function leaveAlternateScreen(): void;
 /**
  * Calculate how many physical (visual) lines a string occupies
  * given terminal width and starting column.
@@ -94,6 +105,15 @@ export declare function calculateCursorPosition(text: string, cursorPos: number,
  * @returns String of repeated characters
  */
 export declare function horizontalLine(char?: string): string;
+/**
+ * Calculate total physical lines for an array of strings (joined with newlines).
+ * Each array entry is a logical line; this returns total physical lines.
+ *
+ * @param lines - Array of lines (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Total physical line count
+ */
+export declare function totalPhysicalLines(lines: string[], termWidth: number): number;
 /**
  * Enable raw mode for stdin
  * In raw mode, input is available character by character

package/dist/ui/terminal.js

@@ -120,6 +120,26 @@ export function clearLinesAbove(count) {
 export function clearScreen() {
     process.stdout.write('\x1b[2J\x1b[H');
 }
+/**
+ * Enter alternate screen buffer.
+ * Content shown here doesn't go to main scrollback.
+ * Used for modal UIs like menus, editors.
+ */
+export function enterAlternateScreen() {
+    // Enter alternate screen and disable mouse tracking
+    // \x1b[?1049h - alternate screen
+    // \x1b[?1000l - disable mouse click tracking
+    // \x1b[?1002l - disable mouse drag tracking
+    // \x1b[?1003l - disable all mouse tracking
+    process.stdout.write('\x1b[?1049h\x1b[?1000l\x1b[?1002l\x1b[?1003l');
+}
+/**
+ * Leave alternate screen buffer.
+ * Returns to main screen (previous content restored).
+ */
+export function leaveAlternateScreen() {
+    process.stdout.write('\x1b[?1049l');
+}
 // =============================================================================
 // Line Calculations
 // =============================================================================
@@ -193,6 +213,58 @@ export function horizontalLine(char = '─') {
     return char.repeat(getTerminalWidth());
 }
 // =============================================================================
+// ANSI-Aware Utilities (internal)
+// =============================================================================
+/**
+ * Strip ANSI escape codes from a string.
+ * Used to calculate visual width of styled text.
+ * (Not exported to avoid conflicts with other modules)
+ */
+function stripAnsiCodes(str) {
+    // eslint-disable-next-line no-control-regex
+    return str.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Get the visual width of a string (excluding ANSI escape codes).
+ */
+function visualWidth(str) {
+    return stripAnsiCodes(str).length;
+}
+/**
+ * Calculate the number of physical terminal lines a string occupies.
+ * Accounts for ANSI escape codes (which don't take visual width) and line wrapping.
+ *
+ * @param text - Text to measure (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Number of physical lines
+ */
+function physicalLineCount(text, termWidth) {
+    if (text.length === 0)
+        return 1; // Empty line still takes 1 line
+    const visLen = visualWidth(text);
+    if (visLen === 0)
+        return 1;
+    // Number of lines = ceil(visLen / termWidth)
+    return Math.ceil(visLen / termWidth);
+}
+/**
+ * Calculate total physical lines for an array of strings (joined with newlines).
+ * Each array entry is a logical line; this returns total physical lines.
+ *
+ * @param lines - Array of lines (may contain ANSI escape codes)
+ * @param termWidth - Terminal width in columns
+ * @returns Total physical line count
+ */
+export function totalPhysicalLines(lines, termWidth) {
+    if (lines.length === 0)
+        return 0;
+    let total = 0;
+    for (const line of lines) {
+        total += physicalLineCount(line, termWidth);
+    }
+    return total;
+}
+// =============================================================================
 // Raw Mode
 // =============================================================================
 /**

package/dist/ui/theme-overlay-v2.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Theme Overlay V2
+ *
+ * Theme selection overlay using TabbedListOverlayV2 for the new Overlay interface.
+ * Works with TerminalUI's overlay management.
+ *
+ * Features:
+ * - Tabs: Curated (top picks), All, Dark, Light
+ * - Search mode with / toggle
+ * - Live preview with syntax highlighting
+ * - Persists selection to settings
+ */
+import { TabbedListOverlayV2 } from './base/index.js';
+import type { KeyEvent, OverlayAction } from './overlay/index.js';
+import { type Theme } from '../themes/index.js';
+export interface ThemeOverlayOptions {
+    /** Current theme ID (for highlighting current selection) */
+    currentThemeId?: string;
+}
+export interface ThemeOverlayResult {
+    /** Selected theme ID (if changed) */
+    themeChanged?: string;
+    /** Selected theme name */
+    themeName?: string;
+}
+/**
+ * Theme overlay using the new Overlay interface.
+ * Displays available themes in a searchable, tabbed list with preview.
+ */
+export declare class ThemeOverlayV2 extends TabbedListOverlayV2<Theme, ThemeOverlayResult> {
+    readonly type: "inline";
+    readonly id = "theme-overlay-v2";
+    private readonly currentThemeId;
+    private readonly curatedIds;
+    constructor(options?: ThemeOverlayOptions);
+    handleKey(key: KeyEvent): OverlayAction<ThemeOverlayResult>;
+    private selectTheme;
+    /**
+     * Optional summary shown after overlay closes.
+     */
+    getCloseSummary(result: ThemeOverlayResult): string | null;
+}

package/dist/ui/theme-overlay-v2.js

@@ -0,0 +1,135 @@
+/**
+ * Theme Overlay V2
+ *
+ * Theme selection overlay using TabbedListOverlayV2 for the new Overlay interface.
+ * Works with TerminalUI's overlay management.
+ *
+ * Features:
+ * - Tabs: Curated (top picks), All, Dark, Light
+ * - Search mode with / toggle
+ * - Live preview with syntax highlighting
+ * - Persists selection to settings
+ */
+import chalk from 'chalk';
+import { TabbedListOverlayV2, } from './base/index.js';
+import { getCuratedThemes, getCurrentTheme, setCurrentTheme, getAllThemes, getThemeCount, clearStyleCache, } from '../themes/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PAGE_SIZE = 10;
+const TABS = [
+    { id: 'curated', label: 'Curated' },
+    { id: 'all', label: 'All' },
+    { id: 'dark', label: 'Dark' },
+    { id: 'light', label: 'Light' },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function renderPreview(theme, styles) {
+    const lines = [];
+    const colors = theme.colors;
+    lines.push(styles.muted('  Preview:'));
+    // Use chalk for hex colors in preview
+    const primary = chalk.hex(colors.primary);
+    const secondary = chalk.hex(colors.secondary || colors.primary);
+    const muted = chalk.hex(colors.muted);
+    const fg = chalk.hex(colors.foreground);
+    lines.push('  ' + primary.bold('function') + ' ' + secondary('greet') + fg('() {'));
+    lines.push('    ' + muted('// Say hello'));
+    lines.push('    ' + fg('console.') + secondary('log') + fg('("Hello, ') + primary('World') + fg('!");'));
+    lines.push('  ' + fg('}'));
+    return lines;
+}
+// =============================================================================
+// Theme Overlay V2 Class
+// =============================================================================
+/**
+ * Theme overlay using the new Overlay interface.
+ * Displays available themes in a searchable, tabbed list with preview.
+ */
+export class ThemeOverlayV2 extends TabbedListOverlayV2 {
+    type = 'inline';
+    id = 'theme-overlay-v2';
+    currentThemeId;
+    curatedIds;
+    constructor(options = {}) {
+        const currentTheme = getCurrentTheme();
+        const currentThemeId = options.currentThemeId ?? currentTheme.id;
+        const curatedThemes = getCuratedThemes();
+        const curatedIds = new Set(curatedThemes.map(t => t.id));
+        const allThemes = getAllThemes();
+        const counts = getThemeCount();
+        super({
+            title: `Select Theme (${String(counts.total)})`,
+            tabs: TABS,
+            items: allThemes,
+            pageSize: PAGE_SIZE,
+            showCount: false, // We show count in title
+            filterByTab: (theme, tabId) => {
+                switch (tabId) {
+                    case 'curated':
+                        return curatedIds.has(theme.id);
+                    case 'dark':
+                        return theme.type === 'dark';
+                    case 'light':
+                        return theme.type === 'light';
+                    default:
+                        return true; // 'all'
+                }
+            },
+            getSearchText: (theme) => {
+                return `${theme.name} ${theme.id}`;
+            },
+            renderItem: (theme, isSelected, styles) => {
+                const isCurrent = theme.id === currentThemeId;
+                const prefix = isSelected ? styles.primary('> ') : '  ';
+                const icon = theme.type === 'dark' ? 'D' : 'L';
+                const checkmark = isCurrent ? styles.success(' *') : '';
+                // Pad the plain name first, then apply styling (ANSI codes break padEnd)
+                const paddedName = theme.name.padEnd(33);
+                const label = isSelected ? styles.primary(paddedName) : paddedName;
+                return `  ${prefix}${label}${icon}${checkmark}`;
+            },
+            renderSelectedPreview: (theme, styles) => {
+                return renderPreview(theme, styles);
+            },
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Select · Esc Exit search';
+                }
+                return 'Tab Filter · ↑↓/jk · ←→/hl Pages · / Search · Enter Select · q/Esc Close';
+            },
+            emptyMessage: 'No themes available.',
+            noResultsMessage: 'No themes match the search.',
+        });
+        this.currentThemeId = currentThemeId;
+        this.curatedIds = curatedIds;
+    }
+    handleKey(key) {
+        // Handle Enter/Space to select theme
+        if ((key.name === 'return' || key.name === 'space') && this.state.filteredItems.length > 0) {
+            const theme = this.state.filteredItems[this.state.selectedIndex];
+            return this.selectTheme(theme);
+        }
+        // Let parent handle other keys
+        return super.handleKey(key);
+    }
+    selectTheme(theme) {
+        setCurrentTheme(theme.id);
+        clearStyleCache();
+        return this.close({
+            themeChanged: theme.id,
+            themeName: theme.name,
+        });
+    }
+    /**
+     * Optional summary shown after overlay closes.
+     */
+    getCloseSummary(result) {
+        if (result.themeName) {
+            return `Theme changed to: ${result.themeName}`;
+        }
+        return null;
+    }
+}

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

@@ -0,0 +1,24 @@
+/**
+ * Theme Overlay
+ *
+ * Standalone theme selection overlay using TabbedListOverlay.
+ * Accessible via /theme command or from Config overlay.
+ *
+ * Features:
+ * - Tabs: Curated (top picks), All, Dark, Light
+ * - Search mode with / toggle
+ * - Live preview with syntax highlighting
+ * - Quick select with number keys (1-9,0) in Curated tab
+ * - Persists selection to settings
+ */
+export interface ThemeOverlayOptions {
+    /** Current theme ID (for highlighting current selection) */
+    currentThemeId?: string;
+}
+export interface ThemeOverlayResult {
+    /** Selected theme ID (if changed) */
+    themeChanged?: string;
+    /** Selected theme name */
+    themeName?: string;
+}
+export declare function showThemeOverlay(options?: ThemeOverlayOptions): Promise<ThemeOverlayResult>;

package/dist/ui/theme-overlay.js

@@ -0,0 +1,127 @@
+/**
+ * Theme Overlay
+ *
+ * Standalone theme selection overlay using TabbedListOverlay.
+ * Accessible via /theme command or from Config overlay.
+ *
+ * Features:
+ * - Tabs: Curated (top picks), All, Dark, Light
+ * - Search mode with / toggle
+ * - Live preview with syntax highlighting
+ * - Quick select with number keys (1-9,0) in Curated tab
+ * - Persists selection to settings
+ */
+import chalk from 'chalk';
+import { TabbedListOverlay, isEnter, isSpace, } from './base/index.js';
+import { getCuratedThemes, getCurrentTheme, setCurrentTheme, getAllThemes, getThemeCount, clearStyleCache, } from '../themes/index.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const PAGE_SIZE = 10;
+const TABS = [
+    { id: 'curated', label: 'Curated' },
+    { id: 'all', label: 'All' },
+    { id: 'dark', label: 'Dark' },
+    { id: 'light', label: 'Light' },
+];
+// =============================================================================
+// Helper Functions
+// =============================================================================
+function renderPreview(theme, styles) {
+    const lines = [];
+    const colors = theme.colors;
+    lines.push(styles.muted('  Preview:'));
+    // Use chalk for hex colors in preview
+    const primary = chalk.hex(colors.primary);
+    const secondary = chalk.hex(colors.secondary || colors.primary);
+    const muted = chalk.hex(colors.muted);
+    const fg = chalk.hex(colors.foreground);
+    lines.push('  ' + primary.bold('function') + ' ' + secondary('greet') + fg('() {'));
+    lines.push('    ' + muted('// Say hello'));
+    lines.push('    ' + fg('console.') + secondary('log') + fg('("Hello, ') + primary('World') + fg('!");'));
+    lines.push('  ' + fg('}'));
+    return lines;
+}
+// =============================================================================
+// Theme Overlay Class
+// =============================================================================
+class ThemeOverlay extends TabbedListOverlay {
+    currentThemeId;
+    curatedIds;
+    constructor(options = {}) {
+        const currentTheme = getCurrentTheme();
+        const currentThemeId = options.currentThemeId ?? currentTheme.id;
+        const curatedThemes = getCuratedThemes();
+        const curatedIds = new Set(curatedThemes.map(t => t.id));
+        const allThemes = getAllThemes();
+        const counts = getThemeCount();
+        const config = {
+            title: `Select Theme (${String(counts.total)})`,
+            tabs: TABS,
+            items: allThemes,
+            pageSize: PAGE_SIZE,
+            showCount: false, // We show count in title
+            filterByTab: (theme, tabId) => {
+                switch (tabId) {
+                    case 'curated':
+                        return curatedIds.has(theme.id);
+                    case 'dark':
+                        return theme.type === 'dark';
+                    case 'light':
+                        return theme.type === 'light';
+                    default:
+                        return true; // 'all'
+                }
+            },
+            getSearchText: (theme) => {
+                return `${theme.name} ${theme.id}`;
+            },
+            renderItem: (theme, isSelected, styles) => {
+                const isCurrent = theme.id === currentThemeId;
+                const prefix = isSelected ? styles.primary('❯ ') : '  ';
+                const icon = theme.type === 'dark' ? '🌙' : '☀️';
+                const checkmark = isCurrent ? styles.success(' ✓') : '';
+                const label = isSelected ? styles.primary(theme.name) : theme.name;
+                return `  ${prefix}${label.padEnd(33)}${icon}${checkmark}`;
+            },
+            renderSelectedPreview: (theme, styles) => {
+                return renderPreview(theme, styles);
+            },
+            footerHints: (searchMode) => {
+                if (searchMode) {
+                    return 'Type to filter · ↑↓/jk Navigate · Enter Select · Esc Exit search';
+                }
+                return 'Tab Filter · ↑↓/jk · ←→/hl Pages · / Search · Enter Select · q/Esc Close';
+            },
+            emptyMessage: 'No themes available.',
+            noResultsMessage: 'No themes match the search.',
+        };
+        super(config);
+        this.currentThemeId = currentThemeId;
+        this.curatedIds = curatedIds;
+    }
+    handleKey(data) {
+        // Handle Enter/Space to select theme
+        if ((isEnter(data) || isSpace(data)) && this.state.filteredItems.length > 0) {
+            const theme = this.state.filteredItems[this.state.selectedIndex];
+            this.selectTheme(theme);
+            return;
+        }
+        // Let parent handle other keys (including number keys for tab switching)
+        super.handleKey(data);
+    }
+    selectTheme(theme) {
+        setCurrentTheme(theme.id);
+        clearStyleCache();
+        this.close({
+            themeChanged: theme.id,
+            themeName: theme.name,
+        });
+    }
+}
+// =============================================================================
+// Export Function
+// =============================================================================
+export async function showThemeOverlay(options = {}) {
+    return new ThemeOverlay(options).show();
+}

package/dist/ui/todo-zone.js

@@ -13,32 +13,60 @@ import { getStyles } from '../themes/index.js';
 // =============================================================================
 // Thinking Words (for random selection when no active todo)
 // =============================================================================
+// Retro-computing themed thinking words (C64, Amiga, Spectrum era vibes)
 const THINKING_WORDS = [
-    'Thinking',
-    'Pondering',
-    'Contemplating',
-    'Ruminating',
-    'Cogitating',
-    'Deliberating',
-    'Musing',
-    'Reflecting',
-    'Considering',
-    'Analyzing',
-    'Processing',
-    'Computing',
-    'Synthesizing',
-    'Extrapolating',
-    'Hypothesizing',
-    'Discombobulating',
-    'Nebulizing',
-    'Percolating',
-    'Marinating',
-    'Simmering',
-    'Brewing',
-    'Fermenting',
-    'Distilling',
-    'Crystallizing',
-    'Transmuting',
+    // Tape/Cassette Era
+    'Rewinding tape',
+    'Loading from cassette',
+    'Seeking track',
+    'Press PLAY on tape',
+    'Fast forwarding',
+    // Floppy/Disk Era
+    'Spinning diskette',
+    'Aligning heads',
+    'Seeking sector',
+    'Ejecting floppy',
+    'Formatting track',
+    'Reading FAT',
+    // CRT/Old Hardware
+    'Degaussing CRT',
+    'Warming tubes',
+    'Adjusting V-HOLD',
+    'Tuning phosphors',
+    'Calibrating beam',
+    'Syncing scanlines',
+    // Memory/System
+    'Paging memory',
+    'Swapping buffers',
+    'Defragmenting',
+    'Poking registers',
+    'Peeking bytes',
+    'Flushing cache',
+    'Allocating heap',
+    // Modem/BBS Era
+    'Dialing BBS',
+    'Waiting for carrier',
+    'Handshaking modem',
+    'Negotiating baud',
+    'Detecting ring',
+    // Terminal/Shell
+    'Parsing commands',
+    'Piping output',
+    'Forking process',
+    'Grepping logs',
+    'Spawning shell',
+    'Sourcing profile',
+    // Classic References
+    'SYS 64738',
+    'LOAD "*",8,1',
+    'Guru meditating',
+    'POKE 53280,0',
+    'RUN/STOP',
+    'Inserting cartridge',
+    // Printer/Peripherals
+    'Feeding paper',
+    'Advancing ribbon',
+    'Parking heads',
 ];
 // =============================================================================
 // Formatting Helpers

package/dist/ui/tool-formatters.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tool Result Formatters
+ *
+ * Extracts content, summary, and success from tool results.
+ * Each tool type has its own formatter to produce human-readable output.
+ */
+export interface FormattedResult {
+    content: string;
+    summary: string;
+    success: boolean;
+}
+/**
+ * Format tool result for display.
+ * Handles the agent's structured result format.
+ */
+export declare function formatToolResult(toolName: string, result: unknown): FormattedResult;