@dexto/tui 1.6.2

package/dist/hooks/useInputOrchestrator.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Unified Input Orchestrator
+ *
+ * Single point of keyboard input handling for the entire ink-cli.
+ * Routes keystrokes based on focus state to prevent conflicts.
+ *
+ * Focus Priority (highest to lowest):
+ * 1. Approval prompt (when visible)
+ * 2. Active overlay (selector/autocomplete)
+ * 3. Global shortcuts (Ctrl+C, Escape - handled specially)
+ * 4. Main text input (default)
+ *
+ * Mouse scroll events are handled separately by ScrollProvider.
+ */
+import type React from 'react';
+import type { UIState, InputState, SessionState, Message } from '../state/types.js';
+import type { ApprovalRequest } from '../components/ApprovalPrompt.js';
+import type { DextoAgent, QueuedMessage } from '@dexto/core';
+import type { TextBuffer } from '../components/shared/text-buffer.js';
+/**
+ * Ink-compatible Key interface
+ * Converted from our custom KeypressContext Key
+ */
+export interface Key {
+    upArrow: boolean;
+    downArrow: boolean;
+    leftArrow: boolean;
+    rightArrow: boolean;
+    pageUp: boolean;
+    pageDown: boolean;
+    return: boolean;
+    escape: boolean;
+    ctrl: boolean;
+    shift: boolean;
+    meta: boolean;
+    tab: boolean;
+    backspace: boolean;
+    delete: boolean;
+    /** True if this input came from a paste operation (bracketed paste) */
+    paste: boolean;
+}
+/**
+ * Input handler function signature
+ * Returns true if the input was consumed, false to continue to next handler
+ */
+export type InputHandler = (input: string, key: Key) => boolean | void;
+/**
+ * Handler configuration for the orchestrator
+ *
+ * Note: Main text input is NOT routed through the orchestrator.
+ * TextBufferInput handles its own input directly via useKeypress.
+ */
+export interface InputHandlers {
+    /** Handler for approval prompt (highest priority) */
+    approval?: InputHandler;
+    /** Handler for active overlay (selector/autocomplete) */
+    overlay?: InputHandler;
+}
+export interface UseInputOrchestratorProps {
+    ui: UIState;
+    approval: ApprovalRequest | null;
+    input: InputState;
+    session: SessionState;
+    /** Queued messages (for cancel handling) */
+    queuedMessages: QueuedMessage[];
+    /** Text buffer for clearing input on first Ctrl+C */
+    buffer: TextBuffer;
+    setUi: React.Dispatch<React.SetStateAction<UIState>>;
+    setInput: React.Dispatch<React.SetStateAction<InputState>>;
+    setMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+    setPendingMessages: React.Dispatch<React.SetStateAction<Message[]>>;
+    setQueuedMessages: React.Dispatch<React.SetStateAction<QueuedMessage[]>>;
+    agent: DextoAgent;
+    handlers: InputHandlers;
+}
+/**
+ * Unified input orchestrator hook
+ *
+ * This is the ONLY keyboard input hook in the entire ink-cli.
+ * All keyboard handling is routed through this single point.
+ * Mouse events are handled separately by MouseProvider/ScrollProvider.
+ */
+export declare function useInputOrchestrator({ ui, approval, input, session, queuedMessages, buffer, setUi, setInput, setMessages, setPendingMessages, setQueuedMessages, agent, handlers, }: UseInputOrchestratorProps): void;
+/**
+ * Create an input handler for the approval prompt
+ */
+export interface ApprovalHandlerProps {
+    onApprove: (rememberChoice: boolean) => void;
+    onDeny: () => void;
+    onCancel: () => void;
+    selectedOption: 'yes' | 'yes-session' | 'no';
+    setSelectedOption: (option: 'yes' | 'yes-session' | 'no') => void;
+    isCommandConfirmation: boolean;
+}
+export declare function createApprovalInputHandler({ onApprove, onDeny, onCancel, selectedOption, setSelectedOption, isCommandConfirmation, }: ApprovalHandlerProps): InputHandler;
+/**
+ * Create an input handler for selector components (BaseSelector pattern)
+ */
+export interface SelectorHandlerProps {
+    itemsLength: number;
+    selectedIndexRef: React.RefObject<number>;
+    onSelectIndex: (index: number) => void;
+    onSelect: () => void;
+    onClose: () => void;
+}
+export declare function createSelectorInputHandler({ itemsLength, selectedIndexRef, onSelectIndex, onSelect, onClose, }: SelectorHandlerProps): InputHandler;
+/**
+ * Create an input handler for autocomplete components
+ */
+export interface AutocompleteHandlerProps extends SelectorHandlerProps {
+    onTab?: () => void;
+}
+export declare function createAutocompleteInputHandler({ itemsLength, selectedIndexRef, onSelectIndex, onSelect, onClose, onTab, }: AutocompleteHandlerProps): InputHandler;
+/**
+ * Create an input handler for the main text input
+ */
+export interface MainInputHandlerProps {
+    value: string;
+    cursorPos: number;
+    onChange: (value: string) => void;
+    setCursorPos: (pos: number) => void;
+    onSubmit: (value: string) => void;
+    isDisabled: boolean;
+    history: string[];
+    historyIndex: number;
+    onHistoryNavigate?: (direction: 'up' | 'down') => void;
+    getLineInfo: (pos: number) => {
+        lines: string[];
+        lineIndex: number;
+        colIndex: number;
+        charCount: number;
+    };
+    getLineStart: (lineIndex: number) => number;
+}
+export declare function createMainInputHandler({ value, cursorPos, onChange, setCursorPos, onSubmit, isDisabled, history, historyIndex, onHistoryNavigate, getLineInfo, getLineStart, }: MainInputHandlerProps): InputHandler;
+//# sourceMappingURL=useInputOrchestrator.d.ts.map

package/dist/hooks/useInputOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInputOrchestrator.d.ts","sourceRoot":"","sources":["../../src/hooks/useInputOrchestrator.ts"],"names":[],"mappings":"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"}