@compilr-dev/cli 0.5.0 → 0.5.1

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

@@ -1,17 +0,0 @@
-/**
- * Docs Overlay
- *
- * Document browser for project documents (PRD, architecture, design, notes).
- * Uses TabbedListOverlay for consistent list/tab/search behavior.
- *
- * Features:
- * - Tabbed filtering by document type
- * - Search with / toggle
- * - Paginated list
- * - Full-screen document viewing with markdown rendering
- * - Vim-style navigation in viewer (j/k, g/G, PgUp/PgDn)
- */
-export interface DocsOverlayResult {
-    viewed: boolean;
-}
-export declare function showDocsOverlay(): Promise<DocsOverlayResult>;

package/dist/ui/docs-overlay.js

@@ -1,303 +0,0 @@
-/**
- * Docs Overlay
- *
- * Document browser for project documents (PRD, architecture, design, notes).
- * Uses TabbedListOverlay for consistent list/tab/search behavior.
- *
- * Features:
- * - Tabbed filtering by document type
- * - Search with / toggle
- * - Paginated list
- * - Full-screen document viewing with markdown rendering
- * - Vim-style navigation in viewer (j/k, g/G, PgUp/PgDn)
- */
-import chalk from 'chalk';
-import { marked } from 'marked';
-import { markedTerminal } from 'marked-terminal';
-import * as terminal from './terminal.js';
-import { getCurrentTheme } from '../themes/index.js';
-import { TabbedListOverlay, BaseScreen, stay, popScreen, closeOverlay, isEscape, isCtrlC, isNavigateUp, isNavigateDown, isSpace, isClose, renderBorder, } from './base/index.js';
-import { documentRepository } from '../db/repositories/document-repository.js';
-import { getActiveProject } from '../tools/project-db.js';
-// =============================================================================
-// Constants
-// =============================================================================
-const PAGE_SIZE = 10;
-const DOC_TYPE_LABELS = {
-    'prd': 'PRD',
-    'architecture': 'ARCH',
-    'design': 'DESIGN',
-    'notes': 'NOTES',
-};
-const TABS = [
-    { id: 'all', label: 'All' },
-    { id: 'prd', label: 'PRD' },
-    { id: 'architecture', label: 'ARCH' },
-    { id: 'design', label: 'DESIGN' },
-    { id: 'notes', label: 'NOTES' },
-];
-// =============================================================================
-// Markdown Rendering
-// =============================================================================
-function getThemedMarkedOptions() {
-    const theme = getCurrentTheme();
-    const primaryColor = chalk.hex(theme.colors.primary);
-    const secondaryColor = chalk.hex(theme.colors.secondary || theme.colors.primary);
-    const mutedColor = chalk.hex(theme.colors.muted);
-    const borderColor = chalk.hex(theme.colors.border);
-    const fgColor = chalk.hex(theme.colors.foreground);
-    return {
-        showSectionPrefix: false,
-        reflowText: false,
-        width: Math.min(100, terminal.getTerminalWidth() - 4),
-        unescape: true,
-        tab: 2,
-        heading: primaryColor.bold,
-        firstHeading: primaryColor.bold,
-        strong: fgColor.bold,
-        em: fgColor.italic,
-        link: secondaryColor,
-        href: secondaryColor.underline,
-        blockquote: mutedColor.italic,
-        del: mutedColor.strikethrough,
-        hr: borderColor,
-        codespan: secondaryColor,
-        code: secondaryColor,
-        html: mutedColor,
-        table: fgColor,
-        listitem: fgColor,
-        paragraph: fgColor,
-        tableOptions: {
-            style: { head: ['bold'], border: [] },
-            chars: {
-                'top': '─', 'top-mid': '─', 'top-left': '─', 'top-right': '─',
-                'bottom': '─', 'bottom-mid': '─', 'bottom-left': '─', 'bottom-right': '─',
-                'left': ' ', 'left-mid': ' ', 'mid': '─', 'mid-mid': '─',
-                'right': ' ', 'right-mid': ' ', 'middle': ' ',
-            },
-        },
-    };
-}
-function preprocessMarkdown(content) {
-    const lines = content.split('\n');
-    return lines.map(line => /^(\s*)\* /.test(line) ? line.replace(/^(\s*)\* /, '$1- ') : line).join('\n');
-}
-function postProcessInlineFormatting(text) {
-    return text.replace(/\*\*([^*]+)\*\*/g, (_match, content) => chalk.bold(content));
-}
-function renderMarkdownSync(content) {
-    const preprocessed = preprocessMarkdown(content);
-    const options = getThemedMarkedOptions();
-    // eslint-disable-next-line @typescript-eslint/no-unsafe-argument, @typescript-eslint/no-explicit-any
-    marked.use(markedTerminal(options));
-    // Use synchronous parsing to avoid async rendering issues
-    const rendered = marked.parse(preprocessed, { async: false });
-    const postProcessed = postProcessInlineFormatting(rendered);
-    return postProcessed.split('\n');
-}
-/**
- * Full-screen document viewer with vim-style navigation.
- */
-class DocumentViewScreen extends BaseScreen {
-    document;
-    styles;
-    viewState;
-    constructor(document, styles) {
-        super();
-        this.document = document;
-        this.styles = styles;
-        // Load content synchronously in constructor so it's ready for first render
-        this.viewState = {
-            contentLines: renderMarkdownSync(document.content),
-            scrollOffset: 0,
-        };
-    }
-    /**
-     * Called when entering this screen.
-     * Clear screen for full-screen view.
-     */
-    onEnter() {
-        terminal.clearScreen();
-    }
-    render() {
-        const s = this.styles;
-        const cols = terminal.getTerminalWidth();
-        const rows = process.stdout.rows || 30;
-        const border = renderBorder(cols, s);
-        const lines = [];
-        // Header
-        const typeLabel = DOC_TYPE_LABELS[this.document.docType] || this.document.docType.toUpperCase();
-        lines.push(border);
-        lines.push(` ${s.primaryBold(typeLabel)}${s.muted(' │ ')}${chalk.bold(this.document.title)}`);
-        lines.push(border);
-        // Calculate content area
-        const headerLines = 3;
-        const footerLines = 3;
-        const contentHeight = rows - headerLines - footerLines;
-        // Get visible lines, accounting for wrapping
-        // We need to count physical lines (after wrapping) not logical lines
-        const totalLines = this.viewState.contentLines.length;
-        const visibleLines = [];
-        let physicalLinesUsed = 0;
-        for (let i = this.viewState.scrollOffset; i < totalLines && physicalLinesUsed < contentHeight; i++) {
-            const line = this.viewState.contentLines[i];
-            // Calculate how many physical lines this content line takes
-            // Strip ANSI codes for accurate width calculation
-            // eslint-disable-next-line no-control-regex
-            const visualLen = line.replace(/\x1b\[[0-9;]*m/g, '').length;
-            const linePhysicalHeight = Math.max(1, Math.ceil(visualLen / cols));
-            if (physicalLinesUsed + linePhysicalHeight <= contentHeight) {
-                visibleLines.push(line);
-                physicalLinesUsed += linePhysicalHeight;
-            }
-            else {
-                break; // No room for this line
-            }
-        }
-        // Content
-        for (const line of visibleLines) {
-            lines.push(line);
-        }
-        // Pad remaining physical space
-        for (let i = physicalLinesUsed; i < contentHeight; i++) {
-            lines.push('');
-        }
-        // Footer with position info
-        const canScrollUp = this.viewState.scrollOffset > 0;
-        const canScrollDown = this.viewState.scrollOffset + contentHeight < totalLines;
-        const arrows = (canScrollUp ? '▲' : ' ') + (canScrollDown ? '▼' : ' ');
-        const position = totalLines > 0
-            ? `Line ${String(this.viewState.scrollOffset + 1)}-${String(Math.min(this.viewState.scrollOffset + contentHeight, totalLines))} of ${String(totalLines)}`
-            : '';
-        const scrollPercent = totalLines > contentHeight
-            ? Math.round(((this.viewState.scrollOffset + contentHeight) / totalLines) * 100)
-            : 100;
-        lines.push(border);
-        lines.push(s.muted(` ${arrows} ${position} (${String(scrollPercent)}%)  ↑↓/jk Scroll · PgUp/PgDn Page · g/G Top/Bottom · q/Esc Back`));
-        lines.push(border);
-        return lines;
-    }
-    handleKey(data) {
-        const char = data.length === 1 && data[0] >= 0x20 && data[0] < 0x7f
-            ? String.fromCharCode(data[0])
-            : null;
-        const keyStr = data.toString();
-        const rows = process.stdout.rows || 30;
-        const contentHeight = rows - 6;
-        const totalLines = this.viewState.contentLines.length;
-        const maxScroll = Math.max(0, totalLines - contentHeight);
-        // Ctrl+C closes everything
-        if (isCtrlC(data)) {
-            return closeOverlay({ viewed: true });
-        }
-        // Escape or q - back to list
-        if (isEscape(data) || isClose(data)) {
-            return popScreen();
-        }
-        // Up / k
-        if (isNavigateUp(data)) {
-            if (this.viewState.scrollOffset > 0) {
-                this.viewState.scrollOffset--;
-                return stay();
-            }
-            return stay(false);
-        }
-        // Down / j
-        if (isNavigateDown(data)) {
-            if (this.viewState.scrollOffset < maxScroll) {
-                this.viewState.scrollOffset++;
-                return stay();
-            }
-            return stay(false);
-        }
-        // Page Up
-        if (keyStr === '\x1b[5~') {
-            this.viewState.scrollOffset = Math.max(0, this.viewState.scrollOffset - contentHeight);
-            return stay();
-        }
-        // Page Down / Space
-        if (keyStr === '\x1b[6~' || isSpace(data)) {
-            this.viewState.scrollOffset = Math.min(maxScroll, this.viewState.scrollOffset + contentHeight);
-            return stay();
-        }
-        // g = top
-        if (char === 'g') {
-            this.viewState.scrollOffset = 0;
-            return stay();
-        }
-        // G = bottom
-        if (char === 'G') {
-            this.viewState.scrollOffset = maxScroll;
-            return stay();
-        }
-        // Home
-        if (keyStr === '\x1b[H') {
-            this.viewState.scrollOffset = 0;
-            return stay();
-        }
-        // End
-        if (keyStr === '\x1b[F') {
-            this.viewState.scrollOffset = maxScroll;
-            return stay();
-        }
-        return stay(false);
-    }
-}
-// =============================================================================
-// Docs Overlay
-// =============================================================================
-class DocsOverlay extends TabbedListOverlay {
-    // Stored for potential future use (e.g., subtitle display)
-    _projectName;
-    constructor() {
-        const activeProject = getActiveProject();
-        const projectId = activeProject?.id ?? null;
-        const projectName = activeProject?.name ?? null;
-        // Load documents
-        const documents = projectId !== null
-            ? documentRepository.listByProject(projectId)
-            : [];
-        const config = {
-            title: 'Documents',
-            tabs: TABS,
-            items: documents,
-            pageSize: PAGE_SIZE,
-            filterByTab: (doc, tabId) => {
-                if (tabId === 'all')
-                    return true;
-                return doc.docType === tabId;
-            },
-            getSearchText: (doc) => `${doc.title} ${doc.docType}`,
-            renderItem: (doc, isSelected, styles) => {
-                const prefix = isSelected ? styles.primary('❯ ') : '  ';
-                const typeLabel = (DOC_TYPE_LABELS[doc.docType] || doc.docType).padEnd(8);
-                const title = doc.title.slice(0, 50);
-                if (isSelected) {
-                    return `${prefix}${styles.primaryBold(typeLabel)}  ${styles.primary(title)}`;
-                }
-                return `${prefix}${styles.muted(typeLabel)}  ${styles.secondary(title)}`;
-            },
-            showCount: true,
-            emptyMessage: projectId === null
-                ? 'No active project. Use /projects to select one.'
-                : 'No documents found. Use /design or /arch to create documents.',
-            noResultsMessage: 'No documents match the search.',
-        };
-        super(config);
-        this._projectName = projectName;
-    }
-    /**
-     * Override to add project name subtitle in header.
-     * For now, we work with the default rendering.
-     * The TabbedListOverlay handles everything else.
-     */
-    createDetailScreen(doc) {
-        return new DocumentViewScreen(doc, this.styles);
-    }
-}
-// =============================================================================
-// Export Function (Backward Compatible)
-// =============================================================================
-export async function showDocsOverlay() {
-    return new DocsOverlay().show();
-}

package/dist/ui/footer-v2.d.ts

@@ -1,222 +0,0 @@
-/**
- * Footer V2 - UI Orchestrator
- *
- * Single point of control for all terminal UI:
- * - Owns all rendering decisions (when to clear, when to render)
- * - Owns all UI state (agentRunning, todos, currentTool, etc.)
- * - Provides output methods that handle clear/render automatically
- * - REPL just emits events, doesn't manage rendering timing
- *
- * Key principles:
- * - NO scroll regions (preserves terminal scrollback)
- * - Deterministic render cycle
- * - All output goes through footer (no external console.log)
- */
-import { EventEmitter } from 'events';
-import type { TodoItem, AgentMode } from './types.js';
-export interface FooterV2Events {
-    submit: (input: string) => void;
-    command: (command: string, args: string) => void;
-    cancel: () => void;
-    escape: () => void;
-    interrupt: () => void;
-    modeChange: () => void;
-}
-export interface FooterV2Options {
-    prompt?: string;
-    initialMode?: AgentMode;
-}
-/**
- * Represents a semantic item that can be printed to the scrolling zone.
- * FooterV2 handles all formatting based on the item type.
- */
-export type PrintableItem = {
-    type: 'user-message';
-    text: string;
-} | {
-    type: 'agent-text';
-    text: string;
-    expression?: MascotExpression;
-} | {
-    type: 'tool-start';
-    name: string;
-    params: string;
-} | {
-    type: 'tool-result';
-    name: string;
-    params: string;
-    result: string;
-    success?: boolean;
-} | {
-    type: 'tool-error';
-    name: string;
-    params: string;
-    error: string;
-} | {
-    type: 'interrupted';
-    action?: string;
-    suggestion?: string;
-} | {
-    type: 'error';
-    message: string;
-} | {
-    type: 'success';
-    message: string;
-} | {
-    type: 'info';
-    message: string;
-} | {
-    type: 'warning';
-    message: string;
-} | {
-    type: 'raw';
-    text: string;
-} | {
-    type: 'raw-lines';
-    lines: string[];
-};
-/**
- * Inline mascot expressions for agent identity and state feedback.
- * Used to prefix agent messages and in spinner animations.
- */
-export declare const MASCOT: {
-    readonly neutral: "[•_•]";
-    readonly thinking: "[°_°]";
-    readonly searching: "[◐_◐]";
-    readonly success: "[^_^]";
-    readonly error: "[×_×]";
-    readonly confused: "[?_?]";
-    readonly working: "[•̀_•́]";
-    readonly crt: readonly ["[░░░]", "[▒░░]", "[░▒░]", "[░░▒]", "[░▒░]", "[▒░░]"];
-};
-export type MascotExpression = 'neutral' | 'thinking' | 'searching' | 'success' | 'error' | 'confused' | 'working';
-export declare class FooterV2 extends EventEmitter {
-    private promptPrefix;
-    private promptPrefixLen;
-    private lines;
-    private currentLine;
-    private cursorPos;
-    private mode;
-    private projectName;
-    private todos;
-    private spinnerText;
-    private spinnerFrame;
-    private agentRunning;
-    private queuedInputs;
-    private currentTool;
-    private readonly autocomplete;
-    private readonly fileAutocomplete;
-    private readonly history;
-    private historyIndex;
-    private savedInput;
-    private lastRenderHeight;
-    private cursorLineFromBottom;
-    private isRunning;
-    private isPaused;
-    private renderTimer;
-    private needsRender;
-    private lastEscapeTime;
-    private suggestion;
-    private readonly spinnerFrames;
-    private spinnerTimer;
-    constructor(options?: FooterV2Options);
-    /** Get the full input value (all lines joined with newlines) */
-    private getInputValue;
-    /** Get the current line content */
-    private getCurrentLineContent;
-    /** Clear input and reset to single empty line */
-    private clearInput;
-    start(): void;
-    stop(): void;
-    /**
-     * Print a semantic item to the scrolling zone.
-     * FooterV2 handles all formatting based on the item type.
-     */
-    print(item: PrintableItem): void;
-    /**
-     * Execute a callback that outputs to terminal.
-     * Handles clear → callback → render automatically.
-     * Use this for complex output that needs multiple console.log calls.
-     * @deprecated Prefer using print() with PrintableItem
-     */
-    output(callback: () => void): void;
-    setAgentRunning(running: boolean): void;
-    isAgentRunning(): boolean;
-    setTodos(todos: TodoItem[]): void;
-    getTodos(): TodoItem[];
-    setSpinnerText(text: string | null): void;
-    setCurrentTool(tool: string | null): void;
-    setMode(mode: AgentMode): void;
-    getMode(): AgentMode;
-    setProjectName(name: string | null): void;
-    getProjectName(): string | null;
-    /**
-     * Set ghost text suggestion (shown when input is empty)
-     */
-    setSuggestion(text: string | null): void;
-    getSuggestion(): string | null;
-    clearSuggestion(): void;
-    getQueuedInputs(): string[];
-    popQueuedInput(): string | null;
-    hasQueuedInput(): boolean;
-    clearQueue(): void;
-    /**
-     * Pause footer completely (for overlays)
-     */
-    pauseAnimation(): void;
-    /**
-     * Resume footer after pause
-     */
-    resumeAnimation(): void;
-    /**
-     * Restart input after command
-     */
-    restartInput(): void;
-    /**
-     * Refresh prompt with theme colors
-     */
-    refreshPrompt(): void;
-    /**
-     * @deprecated Use print() or output() instead
-     */
-    clearForOutput(): void;
-    /**
-     * @deprecated Use print() or output() instead
-     */
-    forceRender(): void;
-    private clear;
-    private render;
-    private buildSpinnerLine;
-    private buildTodoLine;
-    private buildModeLine;
-    private buildAutocompleteLines;
-    private buildFileAutocompleteLines;
-    private updateAutocomplete;
-    private acceptAutocomplete;
-    private closeAutocomplete;
-    private navigateAutocompleteUp;
-    private navigateAutocompleteDown;
-    private addToHistory;
-    private navigateHistoryUp;
-    private navigateHistoryDown;
-    private resetHistoryNavigation;
-    private startSpinnerAnimation;
-    private stopSpinnerAnimation;
-    private keyHandler;
-    private dataHandler;
-    private startKeyboardCapture;
-    private stopKeyboardCapture;
-    /**
-     * Handle word left (Option+Left) - move cursor to previous word boundary
-     */
-    private handleWordLeft;
-    /**
-     * Handle word right (Option+Right) - move cursor to next word boundary
-     */
-    private handleWordRight;
-    /**
-     * Handle Escape key - called from raw data handler for reliable detection
-     */
-    private handleEscape;
-    private handleKeypress;
-}