@compilr-dev/cli 0.4.0 → 0.5.1

package/dist/ui/autocomplete-controller.js

@@ -0,0 +1,384 @@
+/**
+ * Autocomplete controller for command, file, and agent autocomplete.
+ *
+ * Extracted from TerminalUI — owns all three autocomplete states and their
+ * management methods. Input state is passed in as parameters; accept() returns
+ * new input state instead of mutating directly.
+ */
+import { getStyles } from '../themes/index.js';
+import { getVisibleLength } from './line-utils.js';
+import { MAX_VISIBLE_COMMANDS, } from './terminal-types.js';
+import { filterCommands } from './terminal-autocomplete-utils.js';
+import { getFileMatches, extractAtMention, replaceAtMention, extractDollarMention, replaceDollarMention, } from './file-autocomplete.js';
+export class AutocompleteController {
+    command = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+    };
+    file = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+        partial: '',
+    };
+    agent = {
+        active: false,
+        matches: [],
+        selectedIndex: 0,
+        scrollOffset: 0,
+        partial: '',
+        startPos: 0,
+        lineIndex: 0,
+    };
+    getAgentSuggestions;
+    getCommands;
+    /** Whether any autocomplete is currently active. */
+    isActive() {
+        return this.command.active || this.file.active || this.agent.active;
+    }
+    // ===========================================================================
+    // Update (called when input changes)
+    // ===========================================================================
+    /**
+     * Detect and activate autocomplete based on current input state.
+     * Priority: @ file > $ agent > / command
+     */
+    update(lines, currentLine, cursorPos) {
+        const currentLineContent = lines[currentLine];
+        // Check for @ file path autocomplete first (works on any line)
+        const atMention = extractAtMention(currentLineContent, cursorPos);
+        if (atMention !== null) {
+            // File autocomplete mode - disable other autocompletes
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+            this.agent.active = false;
+            this.agent.matches = [];
+            // Enable file autocomplete
+            this.file.active = true;
+            this.file.partial = atMention;
+            this.file.matches = getFileMatches(atMention);
+            if (this.file.selectedIndex >= this.file.matches.length) {
+                this.file.selectedIndex = Math.max(0, this.file.matches.length - 1);
+                this.file.scrollOffset = 0;
+            }
+            return;
+        }
+        // Reset file autocomplete
+        this.file.active = false;
+        this.file.matches = [];
+        this.file.selectedIndex = 0;
+        this.file.scrollOffset = 0;
+        this.file.partial = '';
+        // Check for $ agent autocomplete (anywhere in the current line)
+        if (this.getAgentSuggestions) {
+            const dollarMention = extractDollarMention(currentLineContent, cursorPos);
+            if (dollarMention !== null) {
+                const partial = dollarMention.partial.toLowerCase();
+                const allAgents = this.getAgentSuggestions();
+                // Filter agents by partial match
+                const matches = allAgents.filter(a => a.id.toLowerCase().startsWith(partial) ||
+                    a.displayName.toLowerCase().includes(partial));
+                if (matches.length > 0) {
+                    this.agent.active = true;
+                    this.agent.partial = partial;
+                    this.agent.matches = matches;
+                    this.agent.startPos = dollarMention.startPos;
+                    this.agent.lineIndex = currentLine;
+                    if (this.agent.selectedIndex >= matches.length) {
+                        this.agent.selectedIndex = Math.max(0, matches.length - 1);
+                        this.agent.scrollOffset = 0;
+                    }
+                    // Reset command autocomplete
+                    this.command.active = false;
+                    this.command.matches = [];
+                    return;
+                }
+            }
+        }
+        // Reset agent autocomplete
+        this.agent.active = false;
+        this.agent.matches = [];
+        this.agent.selectedIndex = 0;
+        this.agent.scrollOffset = 0;
+        this.agent.partial = '';
+        this.agent.startPos = 0;
+        this.agent.lineIndex = 0;
+        // Activate command autocomplete when first line starts with /
+        const firstLine = lines[0];
+        if (currentLine === 0 && firstLine.startsWith('/')) {
+            this.command.active = true;
+            const freshCommands = this.getCommands?.() ?? [];
+            this.command.matches = filterCommands(firstLine, freshCommands);
+            // Reset selection if it's out of bounds
+            if (this.command.selectedIndex >= this.command.matches.length) {
+                this.command.selectedIndex = Math.max(0, this.command.matches.length - 1);
+                this.command.scrollOffset = 0;
+            }
+        }
+        else {
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+        }
+    }
+    // ===========================================================================
+    // Accept (apply selected autocomplete)
+    // ===========================================================================
+    /**
+     * Apply the selected autocomplete match.
+     * Returns new input state if something was accepted, null otherwise.
+     * Caller must also call update() after applying the result for file autocomplete
+     * (directory selection may trigger continued autocomplete).
+     */
+    accept(lines, currentLine, cursorPos) {
+        // Agent autocomplete takes highest priority
+        if (this.agent.active && this.agent.matches.length > 0) {
+            const selectedAgent = this.agent.matches[this.agent.selectedIndex];
+            const lineIdx = this.agent.lineIndex;
+            const line = lines[lineIdx];
+            const result = replaceDollarMention(line, cursorPos, selectedAgent.id);
+            const newLines = [...lines];
+            newLines[lineIdx] = result.input;
+            this.agent.active = false;
+            this.agent.matches = [];
+            this.agent.selectedIndex = 0;
+            this.agent.scrollOffset = 0;
+            this.agent.partial = '';
+            this.agent.startPos = 0;
+            this.agent.lineIndex = 0;
+            return { lines: newLines, currentLine: lineIdx, cursorPos: result.cursorPos };
+        }
+        // File autocomplete takes priority (works on current line)
+        if (this.file.active && this.file.matches.length > 0) {
+            const selectedFile = this.file.matches[this.file.selectedIndex];
+            const currentLineContent = lines[currentLine];
+            const result = replaceAtMention(currentLineContent, cursorPos, selectedFile.path);
+            const newLines = [...lines];
+            newLines[currentLine] = result.input;
+            this.file.active = false;
+            this.file.matches = [];
+            this.file.selectedIndex = 0;
+            this.file.scrollOffset = 0;
+            this.file.partial = '';
+            return { lines: newLines, currentLine, cursorPos: result.cursorPos };
+        }
+        // Command autocomplete (works on first line only)
+        if (this.command.active && this.command.matches.length > 0) {
+            const selected = this.command.matches[this.command.selectedIndex];
+            const newLines = [...lines];
+            newLines[0] = selected.command;
+            this.command.active = false;
+            this.command.matches = [];
+            this.command.selectedIndex = 0;
+            this.command.scrollOffset = 0;
+            return { lines: newLines, currentLine: 0, cursorPos: selected.command.length };
+        }
+        return null;
+    }
+    // ===========================================================================
+    // Close / Navigate
+    // ===========================================================================
+    close() {
+        this.agent.active = false;
+        this.agent.matches = [];
+        this.agent.selectedIndex = 0;
+        this.agent.scrollOffset = 0;
+        this.agent.partial = '';
+        this.agent.startPos = 0;
+        this.agent.lineIndex = 0;
+        this.file.active = false;
+        this.file.matches = [];
+        this.file.selectedIndex = 0;
+        this.file.scrollOffset = 0;
+        this.file.partial = '';
+        this.command.active = false;
+        this.command.matches = [];
+        this.command.selectedIndex = 0;
+        this.command.scrollOffset = 0;
+    }
+    navigateUp() {
+        if (this.agent.active && this.agent.matches.length > 0) {
+            if (this.agent.selectedIndex > 0) {
+                this.agent.selectedIndex--;
+                if (this.agent.selectedIndex < this.agent.scrollOffset) {
+                    this.agent.scrollOffset = this.agent.selectedIndex;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (this.file.active && this.file.matches.length > 0) {
+            if (this.file.selectedIndex > 0) {
+                this.file.selectedIndex--;
+                if (this.file.selectedIndex < this.file.scrollOffset) {
+                    this.file.scrollOffset = this.file.selectedIndex;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (!this.command.active || this.command.matches.length === 0) {
+            return false;
+        }
+        if (this.command.selectedIndex > 0) {
+            this.command.selectedIndex--;
+            if (this.command.selectedIndex < this.command.scrollOffset) {
+                this.command.scrollOffset = this.command.selectedIndex;
+            }
+            return true;
+        }
+        return false;
+    }
+    navigateDown() {
+        if (this.agent.active && this.agent.matches.length > 0) {
+            if (this.agent.selectedIndex < this.agent.matches.length - 1) {
+                this.agent.selectedIndex++;
+                const maxVisibleIndex = this.agent.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+                if (this.agent.selectedIndex > maxVisibleIndex) {
+                    this.agent.scrollOffset = this.agent.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (this.file.active && this.file.matches.length > 0) {
+            if (this.file.selectedIndex < this.file.matches.length - 1) {
+                this.file.selectedIndex++;
+                const maxVisibleIndex = this.file.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+                if (this.file.selectedIndex > maxVisibleIndex) {
+                    this.file.scrollOffset = this.file.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+                }
+                return true;
+            }
+            return false;
+        }
+        if (!this.command.active || this.command.matches.length === 0) {
+            return false;
+        }
+        if (this.command.selectedIndex < this.command.matches.length - 1) {
+            this.command.selectedIndex++;
+            const maxVisibleIndex = this.command.scrollOffset + MAX_VISIBLE_COMMANDS - 1;
+            if (this.command.selectedIndex > maxVisibleIndex) {
+                this.command.scrollOffset = this.command.selectedIndex - MAX_VISIBLE_COMMANDS + 1;
+            }
+            return true;
+        }
+        return false;
+    }
+    // ===========================================================================
+    // Build lines (for footer rendering)
+    // ===========================================================================
+    buildCommandLines(termWidth) {
+        if (!this.command.active || this.command.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.command;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const cmd = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const name = isSelected ? s.primaryBold(cmd.command) : cmd.command;
+            const baseLen = getVisibleLength(prefix) + getVisibleLength(name) + 3;
+            const maxDescLen = termWidth - baseLen - 2;
+            const truncatedDesc = cmd.description.length > maxDescLen
+                ? cmd.description.slice(0, maxDescLen - 1) + '…'
+                : cmd.description;
+            lines.push(`${prefix}${name} ${s.muted('- ' + truncatedDesc)}`);
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+    buildFileLines(termWidth) {
+        if (!this.file.active || this.file.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.file;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const file = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const icon = file.isDirectory ? '📁 ' : '📄 ';
+            const name = isSelected ? s.primaryBold(file.path) : file.path;
+            const baseLen = getVisibleLength(prefix) + 3 + getVisibleLength(file.path);
+            if (baseLen > termWidth - 2) {
+                const maxLen = termWidth - getVisibleLength(prefix) - 5;
+                const truncatedPath = file.path.length > maxLen
+                    ? '…' + file.path.slice(-(maxLen - 1))
+                    : file.path;
+                const truncatedName = isSelected ? s.primaryBold(truncatedPath) : truncatedPath;
+                lines.push(`${prefix}${icon}${truncatedName}`);
+            }
+            else {
+                lines.push(`${prefix}${icon}${name}`);
+            }
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+    buildAgentLines(termWidth) {
+        if (!this.agent.active || this.agent.matches.length === 0) {
+            return [];
+        }
+        const s = getStyles();
+        const lines = [];
+        const { matches, selectedIndex, scrollOffset } = this.agent;
+        const visible = matches.slice(scrollOffset, scrollOffset + MAX_VISIBLE_COMMANDS);
+        const total = matches.length;
+        if (scrollOffset > 0) {
+            lines.push(s.muted(`  ↑ ${String(scrollOffset)} more above`));
+        }
+        for (let i = 0; i < visible.length; i++) {
+            const agentItem = visible[i];
+            const actualIndex = scrollOffset + i;
+            const isSelected = actualIndex === selectedIndex;
+            const prefix = isSelected ? s.primary('❯ ') : '  ';
+            const mascot = agentItem.mascot + ' ';
+            const name = isSelected ? s.primaryBold('$' + agentItem.id) : '$' + agentItem.id;
+            const desc = s.muted(' - ' + agentItem.displayName);
+            const baseLen = getVisibleLength(prefix) + 6 + agentItem.id.length + 3 + agentItem.displayName.length;
+            if (baseLen > termWidth - 2) {
+                const maxDescLen = termWidth - getVisibleLength(prefix) - 6 - agentItem.id.length - 5;
+                const truncatedDesc = agentItem.displayName.length > maxDescLen
+                    ? s.muted(' - ' + agentItem.displayName.slice(0, maxDescLen - 1) + '…')
+                    : desc;
+                lines.push(`${prefix}${mascot}${name}${truncatedDesc}`);
+            }
+            else {
+                lines.push(`${prefix}${mascot}${name}${desc}`);
+            }
+        }
+        const belowCount = total - scrollOffset - visible.length;
+        if (belowCount > 0) {
+            lines.push(s.muted(`  ↓ ${String(belowCount)} more below`));
+        }
+        return lines;
+    }
+}

package/dist/ui/base/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Base UI Utilities
+ *
+ * Shared utilities for consistent overlay behavior.
+ *
+ * Components:
+ * - key-utils: Key detection functions
+ * - overlay-types: Core interfaces and types
+ * - overlay-lifecycle: Lifecycle management
+ * - overlay-base: BaseOverlay abstract class
+ * - screen-stack: Navigation stack for multi-screen overlays
+ */
+export * from './key-utils.js';
+export * from './overlay-types.js';
+export { OverlayLifecycle, setupOverlay } from './overlay-lifecycle.js';
+export type { KeyHandler } from './overlay-lifecycle.js';
+export { BaseOverlay } from './overlay-base.js';
+export { BaseScreen, ScreenStack, stay, pushScreen, popScreen, closeOverlay, } from './screen-stack.js';
+export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, renderProgressBar, formatTokens, } from './render-utils.js';
+export { TabbedListOverlay } from './tabbed-list-overlay.js';
+export type { TabbedListConfig, TabbedListState } from './tabbed-list-overlay.js';
+export { BaseOverlayV2 } from './overlay-base-v2.js';
+export { TabbedListOverlayV2 } from './tabbed-list-overlay-v2.js';
+export type { TabbedListConfigV2, TabbedListStateV2, } from './tabbed-list-overlay-v2.js';
+export { createInlineOverlayContext, inlineSetup, inlineCleanup, inlineCleanupWithSummary, inlineClearPrevious, inlinePadLines, inlineRenderLines, inlineRender, inlineUpdateContext, isEscapeKey, isCtrlCKey, isEnterKey, isBackspaceKey, isUpArrowKey, isDownArrowKey, isLeftArrowKey, isRightArrowKey, isTabKey, isSpaceKey, isPrintableChar, getPrintableChar, isNumberKey, getNumberKey, getNumberKeyIndex, } from './inline-overlay-utils.js';
+export type { InlineOverlayContext } from './inline-overlay-utils.js';

package/dist/ui/base/index.js

@@ -0,0 +1,33 @@
+/**
+ * Base UI Utilities
+ *
+ * Shared utilities for consistent overlay behavior.
+ *
+ * Components:
+ * - key-utils: Key detection functions
+ * - overlay-types: Core interfaces and types
+ * - overlay-lifecycle: Lifecycle management
+ * - overlay-base: BaseOverlay abstract class
+ * - screen-stack: Navigation stack for multi-screen overlays
+ */
+// Key detection utilities
+export * from './key-utils.js';
+// Core types and interfaces
+export * from './overlay-types.js';
+// Lifecycle management
+export { OverlayLifecycle, setupOverlay } from './overlay-lifecycle.js';
+// Base overlay class
+export { BaseOverlay } from './overlay-base.js';
+// Screen stack for multi-screen overlays
+export { BaseScreen, ScreenStack, stay, pushScreen, popScreen, closeOverlay, } from './screen-stack.js';
+// Render utilities
+export { renderBorder, wrapText, truncate, truncateAnsi, normalizeText, padToHeight, emptyLines, renderProgressBar, formatTokens, } from './render-utils.js';
+// Tabbed list overlay base
+export { TabbedListOverlay } from './tabbed-list-overlay.js';
+// V2 Overlay base classes (new Overlay interface)
+export { BaseOverlayV2 } from './overlay-base-v2.js';
+export { TabbedListOverlayV2 } from './tabbed-list-overlay-v2.js';
+// Inline overlay utilities (for in-conversation overlays)
+export { createInlineOverlayContext, inlineSetup, inlineCleanup, inlineCleanupWithSummary, inlineClearPrevious, inlinePadLines, inlineRenderLines, inlineRender, inlineUpdateContext, 
+// Key detection (also available from key-utils)
+isEscapeKey, isCtrlCKey, isEnterKey, isBackspaceKey, isUpArrowKey, isDownArrowKey, isLeftArrowKey, isRightArrowKey, isTabKey, isSpaceKey, isPrintableChar, getPrintableChar, isNumberKey, getNumberKey, getNumberKeyIndex, } from './inline-overlay-utils.js';

package/dist/ui/base/inline-overlay-utils.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Inline Overlay Utilities
+ *
+ * Shared utilities for "in-conversation" overlays that render above the footer.
+ * These overlays differ from full-screen overlays (BaseOverlay) in that they:
+ * - Render inline within the conversation
+ * - Use line-based clearing (clearLinesAbove) instead of full screen clear
+ * - Track line counts to prevent ghost lines and cursor drift
+ *
+ * CANONICAL PATTERN for inline overlays:
+ *
+ * ```typescript
+ * export async function showMyOverlay(options: Options): Promise<Result> {
+ *   const state = { ... };
+ *   const ctx = createInlineOverlayContext();
+ *
+ *   // Setup
+ *   // NOTE: Footer should be paused by CALLER (index.ts), not here
+ *   // This prevents double-pause issues with agent tool overlays
+ *   inlineSetup(ctx);
+ *
+ *   // Initial render
+ *   ctx.lineCount = renderMyOverlay(options, state, ctx);
+ *   ctx.maxLineCount = Math.max(ctx.maxLineCount, ctx.lineCount);
+ *
+ *   return new Promise((resolve) => {
+ *     const cleanup = (result: Result) => {
+ *       inlineCleanup(ctx);
+ *       process.stdin.removeListener('data', handleData);
+ *       resolve(result);
+ *     };
+ *
+ *     const handleData = (data: Buffer) => {
+ *       // Handle keys, update state
+ *       // ...
+ *
+ *       // Re-render (always use maxLineCount for both clearing and target)
+ *       ctx.lineCount = renderMyOverlay(options, state, ctx);
+ *       ctx.maxLineCount = Math.max(ctx.maxLineCount, ctx.lineCount);
+ *     };
+ *
+ *     process.stdin.on('data', handleData);
+ *   });
+ * }
+ * ```
+ *
+ * RENDER FUNCTION pattern:
+ *
+ * ```typescript
+ * function renderMyOverlay(
+ *   options: Options,
+ *   state: State,
+ *   ctx: InlineOverlayContext
+ * ): number {
+ *   const lines: string[] = [];
+ *
+ *   // Clear previous render
+ *   if (ctx.maxLineCount > 0) {
+ *     terminal.clearLinesAbove(ctx.maxLineCount);
+ *   }
+ *
+ *   // Build lines array
+ *   lines.push(...);
+ *
+ *   // Pad to consistent height (prevents cursor drift)
+ *   while (lines.length < ctx.maxLineCount) {
+ *     lines.push('');
+ *   }
+ *
+ *   // Render
+ *   terminal.write(lines.join('\n'));
+ *
+ *   return lines.length;
+ * }
+ * ```
+ */
+/**
+ * Context for tracking inline overlay render state.
+ * This prevents ghost lines and cursor drift.
+ */
+export interface InlineOverlayContext {
+    /** Current number of lines rendered */
+    lineCount: number;
+    /** Maximum lines ever rendered (used for clearing) */
+    maxLineCount: number;
+    /** Whether raw mode was enabled before overlay */
+    wasRawMode: boolean;
+}
+/**
+ * Create a new inline overlay context.
+ * Call this at the start of showXxxOverlay().
+ */
+export declare function createInlineOverlayContext(): InlineOverlayContext;
+/**
+ * Standard setup for inline overlays.
+ * Call this after creating the context.
+ *
+ * NOTE: Footer pause should be handled by the CALLER (index.ts),
+ * not by the overlay itself. This prevents double-pause issues
+ * when overlays are triggered by agent tools.
+ */
+export declare function inlineSetup(ctx: InlineOverlayContext): void;
+/**
+ * Standard cleanup for inline overlays.
+ * Call this before resolving the promise.
+ *
+ * NOTE: Footer resume should be handled by the CALLER (index.ts),
+ * not by the overlay itself.
+ */
+export declare function inlineCleanup(ctx: InlineOverlayContext): void;
+/**
+ * Cleanup with a result summary line.
+ * Some overlays show a brief result after closing.
+ */
+export declare function inlineCleanupWithSummary(ctx: InlineOverlayContext, summaryLine: string): void;
+/**
+ * Clear previous render and prepare for new render.
+ * Call this at the start of your render function.
+ *
+ * @param ctx - The overlay context
+ */
+export declare function inlineClearPrevious(ctx: InlineOverlayContext): void;
+/**
+ * Pad lines array to target height (prevents cursor drift).
+ * Call this before rendering.
+ *
+ * @param lines - Array of lines to pad
+ * @param targetLineCount - Target number of lines (usually ctx.maxLineCount)
+ */
+export declare function inlinePadLines(lines: string[], targetLineCount: number): void;
+/**
+ * Render lines and return the line count.
+ * Call this at the end of your render function.
+ *
+ * @param lines - Array of lines to render
+ * @returns Number of lines rendered
+ */
+export declare function inlineRenderLines(lines: string[]): number;
+/**
+ * Complete render helper that clears, pads, and renders.
+ * Use this for simpler overlays.
+ *
+ * @param lines - Array of lines to render
+ * @param ctx - The overlay context
+ * @returns Number of lines rendered
+ */
+export declare function inlineRender(lines: string[], ctx: InlineOverlayContext): number;
+/**
+ * Update context after render.
+ * Call this after your render function returns.
+ *
+ * @param ctx - The overlay context
+ * @param newLineCount - Number of lines just rendered
+ */
+export declare function inlineUpdateContext(ctx: InlineOverlayContext, newLineCount: number): void;
+/**
+ * Check if buffer is Escape key
+ */
+export declare function isEscapeKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Ctrl+C
+ */
+export declare function isCtrlCKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Enter key
+ */
+export declare function isEnterKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Backspace key
+ */
+export declare function isBackspaceKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Up arrow
+ */
+export declare function isUpArrowKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Down arrow
+ */
+export declare function isDownArrowKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Left arrow
+ */
+export declare function isLeftArrowKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Right arrow
+ */
+export declare function isRightArrowKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Tab key
+ */
+export declare function isTabKey(data: Buffer): boolean;
+/**
+ * Check if buffer is Space key
+ */
+export declare function isSpaceKey(data: Buffer): boolean;
+/**
+ * Check if buffer is a printable ASCII character
+ */
+export declare function isPrintableChar(data: Buffer): boolean;
+/**
+ * Get printable character from buffer, or null if not printable
+ */
+export declare function getPrintableChar(data: Buffer): string | null;
+/**
+ * Check if buffer is a number key (1-9)
+ */
+export declare function isNumberKey(data: Buffer): boolean;
+/**
+ * Get number from number key (1-9), or null if not a number key
+ * Returns 1-9 (not 0-8)
+ */
+export declare function getNumberKey(data: Buffer): number | null;
+/**
+ * Get 0-indexed number from number key, or null if not a number key
+ * Returns 0-8 (for use as array index)
+ */
+export declare function getNumberKeyIndex(data: Buffer): number | null;