@ebowwa/coder 0.7.63 → 0.7.65

package/dist/interfaces/ui/terminal/tui/tui-footer.js

@@ -0,0 +1,330 @@
+/**
+ * TUI Footer Component for Coder CLI
+ * Provides a persistent status bar at the bottom of the terminal
+ *
+ * Uses ANSI escape codes for cursor positioning:
+ * - ESC[s    Save cursor position
+ * - ESC[u    Restore cursor position
+ * - ESC[#;#H Move cursor to row, col
+ * - ESC[2K   Clear entire line
+ * - ESC[J    Clear from cursor to end of screen
+ */
+import chalk from "chalk";
+import { calculateContextInfo, formatPermissionMode, } from "../shared/status-line.js";
+import { spinnerFrames } from "./spinner.js";
+// ============================================
+// ANSI ESCAPE CODES
+// ============================================
+const ANSI = {
+    // Cursor
+    SAVE_CURSOR: "\x1b[s",
+    RESTORE_CURSOR: "\x1b[u",
+    MOVE_TO: (row, col) => `\x1b[${row};${col}H`,
+    MOVE_TO_BOTTOM: (offset = 0) => `\x1b[999;1H\x1b[${offset + 1}A`,
+    // Clear
+    CLEAR_LINE: "\x1b[2K",
+    CLEAR_TO_END: "\x1b[J",
+    CLEAR_SCREEN: "\x1b[2J",
+    // Scrolling
+    SCROLL_UP: (lines) => `\x1b[${lines}S`,
+    SCROLL_DOWN: (lines) => `\x1b[${lines}T`,
+    // Colors reset
+    RESET: "\x1b[0m",
+    // Alternate screen buffer
+    ENTER_ALT_SCREEN: "\x1b[?1049h",
+    EXIT_ALT_SCREEN: "\x1b[?1049l",
+    // Cursor visibility
+    HIDE_CURSOR: "\x1b[?25l",
+    SHOW_CURSOR: "\x1b[?25h",
+};
+// Export ANSI for external use
+export { ANSI };
+// ============================================
+// FOOTER RENDERER
+// ============================================
+/**
+ * Render footer content (without positioning)
+ */
+function renderFooterContent(options, spinnerFrame) {
+    const { permissionMode, tokensUsed, model, isLoading, verbose, showVersion } = options;
+    const contextInfo = calculateContextInfo(tokensUsed, model);
+    // Build status parts
+    const parts = [];
+    // 1. Loading spinner if active
+    if (isLoading && spinnerFrame) {
+        parts.push(chalk.cyan(spinnerFrame));
+    }
+    // 2. Context percentage with color
+    const contextValue = contextInfo.isCritical
+        ? chalk.red(`${contextInfo.percentRemaining.toFixed(0)}%`)
+        : contextInfo.isLow
+            ? chalk.yellow(`${contextInfo.percentRemaining.toFixed(0)}%`)
+            : chalk.dim(`${contextInfo.percentRemaining.toFixed(0)}%`);
+    parts.push(`Context: ${contextValue}`);
+    // 3. Permission mode
+    const permDisplay = formatPermissionMode(permissionMode);
+    parts.push(permDisplay);
+    // 4. Version (if verbose or showVersion)
+    if (verbose || showVersion) {
+        parts.push(chalk.dim(`v${getVersion()}`));
+    }
+    return parts.join(chalk.dim(" | "));
+}
+/**
+ * Get VERSION dynamically to avoid circular imports
+ */
+function getVersion() {
+    try {
+        // Dynamic import to avoid circular dependency
+        const statusLine = require("../shared/status-line.js");
+        return statusLine.VERSION || "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+// ============================================
+// TUI FOOTER CLASS
+// ============================================
+export class TUIFooter {
+    state;
+    static instance = null;
+    constructor() {
+        this.state = {
+            isEnabled: false,
+            lastRender: "",
+            lastOptions: null,
+            renderInterval: null,
+            spinnerFrame: 0,
+            terminalHeight: process.stdout.rows || 24,
+            terminalWidth: process.stdout.columns || 80,
+        };
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!TUIFooter.instance) {
+            TUIFooter.instance = new TUIFooter();
+        }
+        return TUIFooter.instance;
+    }
+    /**
+     * Reset singleton (for testing)
+     */
+    static reset() {
+        if (TUIFooter.instance) {
+            TUIFooter.instance.disable();
+            TUIFooter.instance = null;
+        }
+    }
+    /**
+     * Enable the footer (start tracking terminal size)
+     */
+    enable() {
+        if (this.state.isEnabled)
+            return;
+        this.state.isEnabled = true;
+        this.updateTerminalSize();
+        // Listen for terminal resize
+        process.stdout.on("resize", this.handleResize);
+    }
+    /**
+     * Disable the footer and clear it
+     */
+    disable() {
+        if (!this.state.isEnabled)
+            return;
+        this.stopSpinner();
+        this.clear();
+        process.stdout.off("resize", this.handleResize);
+        this.state.isEnabled = false;
+    }
+    /**
+     * Check if footer is enabled
+     */
+    isEnabled() {
+        return this.state.isEnabled;
+    }
+    /**
+     * Update terminal dimensions
+     */
+    updateTerminalSize() {
+        this.state.terminalHeight = process.stdout.rows || 24;
+        this.state.terminalWidth = process.stdout.columns || 80;
+    }
+    /**
+     * Handle terminal resize
+     */
+    handleResize = () => {
+        this.updateTerminalSize();
+        if (this.state.lastOptions) {
+            this.render(this.state.lastOptions);
+        }
+    };
+    /**
+     * Render the footer at the bottom of the screen
+     * Saves cursor position, moves to bottom, renders, restores cursor
+     */
+    render(options) {
+        if (!this.state.isEnabled)
+            return;
+        this.state.lastOptions = options;
+        // Build footer content
+        const content = renderFooterContent(options);
+        // Skip if content unchanged (optimization)
+        if (content === this.state.lastRender && !options.isLoading) {
+            return;
+        }
+        this.state.lastRender = content;
+        // Build ANSI sequence:
+        // 1. Save cursor position
+        // 2. Move to bottom of screen
+        // 3. Clear the line
+        // 4. Render footer content
+        // 5. Restore cursor position
+        const output = ANSI.SAVE_CURSOR +
+            ANSI.MOVE_TO_BOTTOM() +
+            ANSI.CLEAR_LINE +
+            "\r" + // Go to start of line
+            chalk.dim("┌") +
+            content +
+            ANSI.RESTORE_CURSOR;
+        process.stdout.write(output);
+    }
+    /**
+     * Render with loading spinner animation
+     */
+    renderLoading(options) {
+        const frame = spinnerFrames[this.state.spinnerFrame];
+        this.state.spinnerFrame = (this.state.spinnerFrame + 1) % spinnerFrames.length;
+        const content = renderFooterContent(options, frame);
+        this.state.lastRender = content;
+        if (!this.state.isEnabled)
+            return;
+        const output = ANSI.SAVE_CURSOR +
+            ANSI.MOVE_TO_BOTTOM() +
+            ANSI.CLEAR_LINE +
+            "\r" +
+            chalk.dim("┌") +
+            content +
+            ANSI.RESTORE_CURSOR;
+        process.stdout.write(output);
+    }
+    /**
+     * Start spinner animation for loading state
+     */
+    startSpinner(options, interval = 80) {
+        this.stopSpinner();
+        this.state.renderInterval = setInterval(() => {
+            this.renderLoading(options);
+        }, interval);
+    }
+    /**
+     * Stop spinner animation
+     */
+    stopSpinner() {
+        if (this.state.renderInterval) {
+            clearInterval(this.state.renderInterval);
+            this.state.renderInterval = null;
+        }
+    }
+    /**
+     * Clear the footer line
+     */
+    clear() {
+        if (!this.state.isEnabled)
+            return;
+        const output = ANSI.SAVE_CURSOR +
+            ANSI.MOVE_TO_BOTTOM() +
+            ANSI.CLEAR_LINE +
+            ANSI.RESTORE_CURSOR;
+        process.stdout.write(output);
+        this.state.lastRender = "";
+    }
+    /**
+     * Update just the token count (for incremental updates)
+     */
+    updateTokens(tokensUsed) {
+        if (this.state.lastOptions) {
+            this.render({
+                ...this.state.lastOptions,
+                tokensUsed,
+            });
+        }
+    }
+    /**
+     * Update loading state
+     */
+    setLoading(isLoading) {
+        if (this.state.lastOptions) {
+            const options = {
+                ...this.state.lastOptions,
+                isLoading,
+            };
+            if (isLoading) {
+                this.startSpinner(options);
+            }
+            else {
+                this.stopSpinner();
+                this.render(options);
+            }
+        }
+    }
+    /**
+     * Get terminal dimensions
+     */
+    getTerminalSize() {
+        return {
+            width: this.state.terminalWidth,
+            height: this.state.terminalHeight,
+        };
+    }
+}
+// ============================================
+// CONVENIENCE EXPORTS
+// ============================================
+/**
+ * Get the global TUI footer instance
+ */
+export function getTUIFooter() {
+    return TUIFooter.getInstance();
+}
+/**
+ * Enable TUI footer
+ */
+export function enableTUIFooter() {
+    const footer = TUIFooter.getInstance();
+    footer.enable();
+    return footer;
+}
+/**
+ * Disable TUI footer
+ */
+export function disableTUIFooter() {
+    TUIFooter.getInstance().disable();
+}
+/**
+ * Render footer status (convenience function)
+ */
+export function renderTUIFooter(options) {
+    TUIFooter.getInstance().render(options);
+}
+/**
+ * Clear the footer line
+ */
+export function clearTUIFooter() {
+    TUIFooter.getInstance().clear();
+}
+// ============================================
+// EXPORTS
+// ============================================
+export default {
+    TUIFooter,
+    getTUIFooter,
+    enableTUIFooter,
+    disableTUIFooter,
+    renderTUIFooter,
+    clearTUIFooter,
+    ANSI,
+};

package/dist/interfaces/ui/terminal/tui/types.d.ts

@@ -0,0 +1,165 @@
+/**
+ * TUI Types
+ * Type definitions for the interactive TUI components
+ */
+import type { PermissionMode, ClaudeModel, Message as ApiMessage, ToolDefinition } from "../../../../types/index.js";
+import type { HookManager } from "../../../../ecosystem/hooks/index.js";
+import type { LoadedSession, SessionSummary } from "../../../../core/sessions/types.js";
+/**
+ * Message sub-type for granular categorization
+ * - tool_call: Assistant is invoking a tool
+ * - tool_result: Tool execution result (success or error)
+ * - hook: Hook intercept/decision message
+ * - info: General system info (session start, commands, etc.)
+ * - error: Error messages
+ * - thinking: Extended thinking output
+ */
+export type MessageSubType = "tool_call" | "tool_result" | "hook" | "info" | "error" | "thinking";
+/**
+ * UI-specific message representation
+ */
+export interface UIMessage {
+    id: string;
+    /** Base role: user, assistant, or system */
+    role: "user" | "assistant" | "system";
+    /** Message content for display */
+    content: string;
+    /** Timestamp in milliseconds */
+    timestamp: number;
+    /** Optional sub-type for granular display labels */
+    subType?: MessageSubType;
+    /** For tool messages: the tool name */
+    toolName?: string;
+    /** For tool_result: whether it was an error */
+    isError?: boolean;
+}
+/**
+ * Props for the main InteractiveTUI component
+ */
+export interface InteractiveTUIProps {
+    apiKey: string;
+    model: ClaudeModel;
+    permissionMode: PermissionMode;
+    maxTokens: number;
+    systemPrompt: string;
+    tools: ToolDefinition[];
+    hookManager: HookManager;
+    sessionStore: SessionStore;
+    sessionId: string;
+    setSessionId: (id: string) => void;
+    initialMessages: ApiMessage[];
+    workingDirectory: string;
+    onExit: () => void;
+}
+/**
+ * Session store interface (subset used by TUI)
+ */
+export interface SessionStore {
+    saveMessage(message: ApiMessage): Promise<void>;
+    saveMetrics(metrics: unknown): Promise<void>;
+    exportSession(sessionId: string, format: "jsonl" | "json" | "markdown"): Promise<string>;
+    listSessions(limit?: number): Promise<SessionSummary[]>;
+    resumeSession(sessionId: string): Promise<LoadedSession | null>;
+    createSession(options: {
+        model: string;
+        workingDirectory: string;
+        agentName?: string;
+        agentColor?: string;
+        teamName?: string;
+    }): Promise<string>;
+}
+/**
+ * Session info for listing
+ */
+export interface SessionInfo {
+    id: string;
+    messageCount: number;
+    lastActivity?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Message area component props
+ */
+export interface MessageAreaProps {
+    messages: UIMessage[];
+    isLoading: boolean;
+    spinnerFrame: string;
+    height: number;
+    scrollOffset: number;
+    contextWarning: string | null;
+    streamingText?: string;
+}
+/**
+ * Status bar component props
+ */
+export interface StatusBarProps {
+    permissionMode: PermissionMode;
+    tokensUsed: number;
+    model: string;
+    isLoading: boolean;
+    spinnerFrame: string;
+}
+/**
+ * Input field component props
+ */
+export interface InputFieldProps {
+    value: string;
+    cursorPos: number;
+    placeholder: string;
+    isActive: boolean;
+}
+/**
+ * Terminal layout configuration
+ */
+export interface TerminalLayout {
+    terminalHeight: number;
+    inputHeight: number;
+    statusHeight: number;
+    messageHeight: number;
+}
+/**
+ * Command handler context
+ */
+export interface CommandContext {
+    sessionId: string;
+    setSessionId: (id: string) => void;
+    model: ClaudeModel;
+    setModel: (model: ClaudeModel) => void;
+    apiMessages: ApiMessage[];
+    setApiMessages: (messages: ApiMessage[]) => void;
+    setMessages: (messages: UIMessage[]) => void;
+    processedCountRef: React.MutableRefObject<number>;
+    totalCost: number;
+    setTotalCost: (cost: number) => void;
+    totalTokens: number;
+    setTotalTokens: (tokens: number) => void;
+    permissionMode: PermissionMode;
+    tools: ToolDefinition[];
+    workingDirectory: string;
+    sessionStore: SessionStore;
+    addSystemMessage: (content: string) => void;
+    messagesLength: number;
+    onExit: () => void;
+    exit: () => void;
+    sessionSelectMode: boolean;
+    setSessionSelectMode: (mode: boolean) => void;
+    setSelectableSessions: (sessions: SessionInfo[]) => void;
+    helpMode: boolean;
+    setHelpMode: (mode: boolean) => void;
+    helpSection: number;
+    setHelpSection: (section: number) => void;
+}
+/**
+ * Context info from status-line
+ */
+export interface ContextInfo {
+    percentRemaining: number;
+    isLow: boolean;
+    isCritical: boolean;
+}
+/**
+ * Re-export types from parent for convenience
+ */
+export type { PermissionMode, ClaudeModel, Message as ApiMessage, ToolDefinition } from "../../../../types/index.js";
+export type { HookManager } from "../../../../ecosystem/hooks/index.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/interfaces/ui/terminal/tui/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/src/interfaces/ui/terminal/tui/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,IAAI,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAExE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAExF;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX,aAAa,GACb,MAAM,GACN,MAAM,GACN,OAAO,GACP,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;IACtC,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,CAAC;IACnB,cAAc,EAAE,cAAc,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,eAAe,EAAE,UAAU,EAAE,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzF,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACxD,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAChE,aAAa,CAAC,OAAO,EAAE;QACrB,KAAK,EAAE,MAAM,CAAC;QACd,gBAAgB,EAAE,MAAM,CAAC;QACzB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACvC,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,cAAc,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;IACjD,WAAW,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC7C,iBAAiB,EAAE,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,cAAc,EAAE,cAAc,CAAC;IAC/B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9C,qBAAqB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAEzD,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,IAAI,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACrH,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/interfaces/ui/terminal/tui/types.js

@@ -0,0 +1,5 @@
+/**
+ * TUI Types
+ * Type definitions for the interactive TUI components
+ */
+export {};

package/dist/interfaces/ui/terminal/tui/useInputHandler.d.ts

@@ -0,0 +1,23 @@
+/**
+ * TUI Input Handler Hook
+ * Custom hook for handling keyboard input in TUI
+ */
+interface UseInputHandlerOptions {
+    isLoading: boolean;
+    inputValue: string;
+    cursorPos: number;
+    setInputValue: (value: string | ((prev: string) => string)) => void;
+    setCursorPos: (value: number | ((prev: number) => number)) => void;
+    onSubmit: (value: string) => void;
+    onCommand: (cmd: string) => void;
+}
+/**
+ * Hook for handling keyboard input in the TUI
+ */
+export declare function useInputHandler({ isLoading, inputValue, cursorPos, setInputValue, setCursorPos, onSubmit, onCommand, }: UseInputHandlerOptions): void;
+/**
+ * Hook for handling exit shortcuts (Ctrl+C)
+ */
+export declare function useExitHandler(onExit: () => void, exit: () => void): void;
+export {};
+//# sourceMappingURL=useInputHandler.d.ts.map

package/dist/interfaces/ui/terminal/tui/useInputHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputHandler.d.ts","sourceRoot":"","sources":["../../../../../packages/src/interfaces/ui/terminal/tui/useInputHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,UAAU,sBAAsB;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC;IACpE,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,KAAK,IAAI,CAAC;IACnE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EACT,UAAU,EACV,SAAS,EACT,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,SAAS,GACV,EAAE,sBAAsB,QA2DxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,MAAM,IAAI,QAUlE"}

package/dist/interfaces/ui/terminal/tui/useInputHandler.js

@@ -0,0 +1,72 @@
+/**
+ * TUI Input Handler Hook
+ * Custom hook for handling keyboard input in TUI
+ */
+import { useCallback } from "react";
+import { useInput } from "ink";
+/**
+ * Hook for handling keyboard input in the TUI
+ */
+export function useInputHandler({ isLoading, inputValue, cursorPos, setInputValue, setCursorPos, onSubmit, onCommand, }) {
+    // Main input handler
+    useInput((input, key) => {
+        if (isLoading)
+            return;
+        // Submit on Enter
+        if (key.return) {
+            if (inputValue.trim()) {
+                if (inputValue.startsWith("/")) {
+                    onCommand(inputValue);
+                }
+                else {
+                    onSubmit(inputValue);
+                }
+                setInputValue("");
+                setCursorPos(0);
+            }
+            return;
+        }
+        // Backspace
+        if (key.backspace || key.delete) {
+            if (cursorPos > 0) {
+                setInputValue((v) => v.slice(0, cursorPos - 1) + v.slice(cursorPos));
+                setCursorPos((p) => p - 1);
+            }
+            return;
+        }
+        // Arrow keys
+        if (key.leftArrow) {
+            setCursorPos((p) => Math.max(0, p - 1));
+            return;
+        }
+        if (key.rightArrow) {
+            setCursorPos((p) => Math.min(inputValue.length, p + 1));
+            return;
+        }
+        // Home/End keys (Ctrl+A / Ctrl+E)
+        if (key.ctrl && input === "a") {
+            setCursorPos(0);
+            return;
+        }
+        if (key.ctrl && input === "e") {
+            setCursorPos(inputValue.length);
+            return;
+        }
+        // Regular character
+        if (input && !key.ctrl && !key.meta) {
+            setInputValue((v) => v.slice(0, cursorPos) + input + v.slice(cursorPos));
+            setCursorPos((p) => p + input.length);
+        }
+    }, { isActive: !isLoading });
+}
+/**
+ * Hook for handling exit shortcuts (Ctrl+C)
+ */
+export function useExitHandler(onExit, exit) {
+    useInput((input, key) => {
+        if (key.ctrl && input === "c") {
+            onExit();
+            exit();
+        }
+    }, { isActive: true });
+}

package/dist/interfaces/ui/terminal/tui/useNativeInput.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Native terminal input hook
+ *
+ * Reads key events from stdin without managing raw mode.
+ * Ink handles raw mode - we just read the key events.
+ *
+ * IMPORTANT: This hook does NOT manage raw mode. Ink does that.
+ * We only read events from stdin via the native module.
+ */
+import { type NativeKeyEvent, type TerminalHandle } from "../../../../native/index.js";
+interface UseNativeInputOptions {
+    /** Whether the hook is active (default: true) */
+    isActive?: boolean;
+    /** Callback for key events */
+    onKey: (event: NativeKeyEvent) => void;
+}
+interface UseNativeInputResult {
+    /** Whether the terminal is ready for input */
+    isReady: boolean;
+    /** Whether there was an error initializing */
+    error: Error | null;
+}
+/**
+ * React hook for terminal keyboard input
+ *
+ * Uses native Rust TerminalHandle to read key events from stdin.
+ * Does NOT manage raw mode - let Ink handle that.
+ *
+ * @example
+ * ```tsx
+ * useNativeInput({
+ *   isActive: !isLoading,
+ *   onKey: (event) => {
+ *     if (KeyEvents.isEnter(event)) {
+ *       handleSubmit();
+ *     } else if (KeyEvents.isPrintable(event)) {
+ *       handleChar(event.code);
+ *     }
+ *   },
+ * });
+ * ```
+ */
+export declare function useNativeInput({ isActive, onKey, }: UseNativeInputOptions): UseNativeInputResult;
+/**
+ * Key event helper functions
+ */
+export declare const KeyEvents: {
+    /** Check if event is Enter key */
+    isEnter(event: NativeKeyEvent): boolean;
+    /** Check if event is Backspace key */
+    isBackspace(event: NativeKeyEvent): boolean;
+    /** Check if event is Delete key */
+    isDelete(event: NativeKeyEvent): boolean;
+    /** Check if event is Escape key */
+    isEscape(event: NativeKeyEvent): boolean;
+    /** Check if event is Tab key */
+    isTab(event: NativeKeyEvent): boolean;
+    /** Check if event is BackTab (Shift+Tab) key */
+    isBackTab(event: NativeKeyEvent): boolean;
+    /** Check if event is Arrow Up key */
+    isUp(event: NativeKeyEvent): boolean;
+    /** Check if event is Arrow Down key */
+    isDown(event: NativeKeyEvent): boolean;
+    /** Check if event is Arrow Left key */
+    isLeft(event: NativeKeyEvent): boolean;
+    /** Check if event is Arrow Right key */
+    isRight(event: NativeKeyEvent): boolean;
+    /** Check if event is Page Up key */
+    isPageUp(event: NativeKeyEvent): boolean;
+    /** Check if event is Page Down key */
+    isPageDown(event: NativeKeyEvent): boolean;
+    /** Check if event is Home key */
+    isHome(event: NativeKeyEvent): boolean;
+    /** Check if event is End key */
+    isEnd(event: NativeKeyEvent): boolean;
+    /** Check if event is Ctrl+C */
+    isCtrlC(event: NativeKeyEvent): boolean;
+    /** Check if event is Ctrl+A (beginning of line) */
+    isCtrlA(event: NativeKeyEvent): boolean;
+    /** Check if event is Ctrl+E (end of line) */
+    isCtrlE(event: NativeKeyEvent): boolean;
+    /** Check if event is a printable character */
+    isPrintable(event: NativeKeyEvent): boolean;
+    /** Check if event is Shift+Up */
+    isShiftUp(event: NativeKeyEvent): boolean;
+    /** Check if event is Shift+Down */
+    isShiftDown(event: NativeKeyEvent): boolean;
+};
+export type { NativeKeyEvent, TerminalHandle };
+//# sourceMappingURL=useNativeInput.d.ts.map