@compilr-dev/cli 0.4.0 → 0.5.0

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

@@ -0,0 +1,222 @@
+/**
+ * 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;
+}