@compilr-dev/cli 0.4.0 → 0.5.0

package/dist/ui/footer.d.ts

@@ -30,12 +30,16 @@ export interface FooterOptions {
 export declare class Footer extends EventEmitter {
     private readonly todoZone;
     private readonly inputPrompt;
+    private readonly subagentRenderer;
     private agentRunning;
     private mode;
     private lastRenderHeight;
     private isRunning;
     private isPaused;
+    private isRendering;
     private cursorLineFromBottom;
+    private projectName;
+    private externalRendererEnabled;
     private readonly renderInterval;
     private renderTimer;
     private needsRender;
@@ -65,6 +69,14 @@ export declare class Footer extends EventEmitter {
      * Get the current mode
      */
     getMode(): AgentMode;
+    /**
+     * Set the current project name (displayed in footer)
+     */
+    setProjectName(name: string | null): void;
+    /**
+     * Get the current project name
+     */
+    getProjectName(): string | null;
     /**
      * Update the todo list
      */
@@ -86,6 +98,49 @@ export declare class Footer extends EventEmitter {
      * Add tokens to the spinner counter
      */
     addTokens(count: number): void;
+    /**
+     * Called when a subagent starts
+     */
+    onSubagentStart(agentId: string, agentType: string, description: string): void;
+    /**
+     * Called when a subagent uses a tool
+     */
+    onSubagentToolUse(agentId: string, toolName: string, summary?: string): void;
+    /**
+     * Called when a subagent completes
+     *
+     * CRITICAL (legacy mode only): We must pause rendering immediately to prevent a race condition.
+     * The render loop could fire between onSubagentEnd and clearForOutput, which would:
+     * 1. See the subagent as 'done'
+     * 2. Render with 0 subagent lines
+     * 3. Update lastRenderHeight to a smaller value
+     * 4. Then clearForOutput would not clear enough lines → ghost lines!
+     *
+     * In external renderer mode: No pause needed since the internal render loop is disabled.
+     */
+    onSubagentEnd(agentId: string, success: boolean, tokenCount: number, error?: string): void;
+    /**
+     * Toggle expanded view for subagents (Ctrl+O)
+     */
+    toggleSubagentExpand(): void;
+    /**
+     * Check if there are active subagents
+     */
+    hasActiveSubagents(): boolean;
+    /**
+     * Clear subagent tracking (after completion displayed)
+     */
+    clearSubagents(): void;
+    /**
+     * Get the last subagent's stats before clearing
+     */
+    getLastSubagentStats(): {
+        type: string;
+        description: string;
+        toolCount: number;
+        tokenCount: number;
+        durationMs: number;
+    } | null;
     /**
      * Get queued inputs
      */
@@ -105,12 +160,26 @@ export declare class Footer extends EventEmitter {
     /**
      * Clear footer before scrolling output
      * Call this before writing to the scrolling zone
+     * Pauses interval rendering to prevent ghost lines during output
+     *
+     * When external renderer is enabled (scroll region mode):
+     * - Footer doesn't need clearing (it's in a separate scroll region)
+     * - Just mark that we need a re-render
      */
     clearForOutput(): void;
     /**
      * Force an immediate render
+     * Resumes interval rendering after clearForOutput()
+     *
+     * When external renderer is enabled (scroll region mode):
+     * - Just mark that we need a re-render (TerminalRenderer's loop will pick it up)
      */
     forceRender(): void;
+    /**
+     * Restart input prompt after a command completes
+     * Use this for non-overlay commands where finishInput() stopped the prompt
+     */
+    restartInput(): void;
     /**
      * Pause footer completely (for overlays)
      * Stops render loop, input capture, and animation
@@ -125,6 +194,37 @@ export declare class Footer extends EventEmitter {
      * Get the height of last render
      */
     getLastRenderHeight(): number;
+    /**
+     * Get all footer lines for rendering (for TerminalRenderer integration)
+     * Returns the lines WITHOUT writing to terminal
+     */
+    getFooterLines(): string[];
+    /**
+     * Get cursor position within footer content (for TerminalRenderer)
+     * Returns { row, col } where row is 0-indexed from start of footer lines
+     */
+    getFooterCursorPosition(): {
+        row: number;
+        col: number;
+    };
+    /**
+     * Enable external renderer mode (TerminalRenderer manages rendering)
+     * When enabled:
+     * - Footer's internal render loop is disabled
+     * - Input capture remains active
+     * - Event forwarding remains active
+     * - TerminalRenderer calls getFooterLines() and renders
+     */
+    setExternalRenderer(enabled: boolean): void;
+    /**
+     * Check if external renderer is enabled
+     */
+    isExternalRendererEnabled(): boolean;
+    /**
+     * Request a render from external renderer
+     * Call this to notify TerminalRenderer that footer needs re-rendering
+     */
+    requestExternalRender(): void;
     /**
      * Refresh the prompt with current theme colors
      * Call after theme changes to apply new colors immediately
@@ -132,6 +232,12 @@ export declare class Footer extends EventEmitter {
     refreshPrompt(): void;
     /**
      * Clear the footer area
+     *
+     * Strategy: Simply move to the top of the CURRENT footer and clear to end.
+     * - When footer SHRINKS: clearToEndOfScreen handles the extra lines
+     * - When footer GROWS: terminal scrolls naturally when we write more lines
+     *
+     * We NEVER move up into the scrolling zone - that would eat content!
      */
     private clear;
     /**
@@ -144,6 +250,7 @@ export declare class Footer extends EventEmitter {
     private renderModeIndicator;
     /**
      * Calculate how many terminal rows a line takes (accounting for wrapping)
+     * Uses unified line-utils for consistent calculation across all components.
      */
     private getTerminalRowsForLine;
     /**