@aitherium/shell-cli 1.1.0 → 1.11.1

package/dist/tui/screen.d.ts

@@ -0,0 +1,68 @@
+export interface PickerItem {
+    label: string;
+    value: string;
+    description?: string;
+    separator?: boolean;
+}
+export interface TuiSurface {
+    screen: any;
+    input: any;
+    /** Append raw streamed text (may contain partial lines / ANSI) to OUTPUT. */
+    appendOutput(text: string): void;
+    /** Append a finished line to OUTPUT (adds its own newline). */
+    outputLine(line: string): void;
+    /** Current OUTPUT length — a checkpoint for replaceOutputFrom (markdown render). */
+    markCheckpoint(): number;
+    /** Replace OUTPUT content from a checkpoint onward (used to swap streamed text for rendered markdown). */
+    replaceOutputFrom(offset: number, text: string): void;
+    /** Prepend text to the TOP of OUTPUT, keeping the viewport anchored (relay scrollback). */
+    prependOutput(text: string): void;
+    /** Append one line to the TRACE pane (into the current turn thread). */
+    traceLine(line: string): void;
+    /** Start a new collapsible trace thread for a user turn (collapses prior ones). */
+    startTraceTurn(label: string): void;
+    /** Mark the current trace thread done/error and stamp its duration in the header. */
+    finishTraceTurn(status: 'done' | 'error'): void;
+    /** Set the one-line STATUS strip. */
+    setStatus(text: string): void;
+    /** Relay mode: set the trace pane's label + raw content (the participant roster). */
+    setTracePanel(label: string, lines: string[]): void;
+    /** Set the output pane's label (e.g. the active relay channel). */
+    setOutputLabel(label: string): void;
+    /** Clear both content panes. */
+    clearPanes(): void;
+    /** Show/hide the TRACE pane (OUTPUT widens to fill). */
+    toggleTrace(): void;
+    /** Coalesced repaint. */
+    render(): void;
+    /** Focus the input box for typing. */
+    focusInput(): void;
+    /** Tear down the screen and restore the terminal. */
+    destroy(): void;
+    /** Whether the command picker overlay is open (suppresses chat input). */
+    pickerOpen(): boolean;
+    /** Show a filterable command picker; resolves with the chosen value or null. */
+    showPicker(title: string, items: PickerItem[], initialFilter?: string): Promise<string | null>;
+    /**
+     * Suspend the blessed screen, run `fn` on the REAL terminal (so command
+     * handlers' console.log / ora spinners / @inquirer prompts all work and don't
+     * corrupt the TUI), wait for a keypress, then restore the TUI. This is how
+     * `/commands` (including interactive ones like /login) run inside the TUI.
+     */
+    runDetached(label: string, fn: () => Promise<void> | void): Promise<void>;
+}
+export interface TuiScreenOpts {
+    title?: string;
+    onSubmit: (line: string) => void;
+    onInterrupt: () => void;
+    onHistory?: (dir: 'up' | 'down') => string | null;
+    /** Tab pressed: given the current input, return a replacement value or null. */
+    onTab?: (value: string) => string | null;
+    /** Slash pressed on an empty input line → open the command picker. */
+    onSlash?: () => void;
+    /** Fired on each printable keystroke (debounce + use for relay typing). */
+    onType?: () => void;
+    /** Fired when the OUTPUT pane is scrolled to the top (relay scrollback). */
+    onScrollTop?: () => void;
+}
+export declare function createTuiScreen(opts: TuiScreenOpts): TuiSurface;