maistro 1.0.390

package/dist/inputBox.d.ts

@@ -0,0 +1,228 @@
+import { type PastedImageResult } from './imageManager.js';
+export type { PastedImageResult };
+/**
+ * Get the display width of a string (accounts for wide characters like CJK, emoji).
+ * Returns the number of terminal columns the string occupies.
+ */
+export declare function getDisplayWidth(str: string): number;
+/**
+ * Get the character index that corresponds to a given display column.
+ * Returns the index of the character at or before the column.
+ */
+export declare function charIndexAtDisplayColumn(str: string, column: number): number;
+/**
+ * Reusable InputBox component with consistent rendering and behavior.
+ *
+ * Features:
+ * - Full-screen redraw approach (reliable across all terminals)
+ * - Consistent structure: top border, input line(s), bottom border, hint (outside)
+ * - Multi-line input support via Ctrl+J (\x0a), Shift+Enter (in supported terminals),
+ *   or pasting multi-line text. Note: Most terminals (iTerm2, Terminal.app) send the
+ *   same sequence for Shift+Enter as Enter, so Ctrl+J is the reliable method.
+ * - Escape-to-clear with confirmation (press twice within 1 second)
+ * - Cursor movement (arrows, Home/End)
+ * - Backspace/Delete support
+ * - Image paste detection (base64, data URLs, iTerm2 sequences)
+ */
+export interface InputBoxOptions {
+    /** Placeholder text shown when input is empty */
+    placeholder?: string;
+    /** Hint text shown below the input box (right-aligned) */
+    hint?: string;
+    /** Initial input value */
+    initialValue?: string;
+    /** Callback to clear screen and redraw content above input bar (REQUIRED for reliable rendering) */
+    onRedraw: (inputLines?: number) => void;
+    /** Callback when Enter is pressed (receives trimmed input) */
+    onSubmit?: (value: string) => void;
+    /** Callback when Escape cancels (only when input is empty or after double-escape) */
+    onCancel?: () => void;
+    /** Callback on each input change */
+    onChange?: (value: string) => void;
+    /** Custom key handler for additional keys (return true if handled) */
+    onKey?: (key: string, inputBox: InputBox) => boolean;
+    /**
+     * Callback when image data is pasted (base64, data URL, or iTerm2 escape sequence).
+     * Return true to prevent the data from being inserted as text.
+     * The callback receives the raw pasted data and detection result.
+     */
+    onImagePaste?: (data: string, detection: PastedImageResult) => boolean | Promise<boolean>;
+    /**
+     * Callback when CTRL+V is pressed to check system clipboard for images.
+     * This is called synchronously with the key press and should return a Promise.
+     * Return true if an image was found and handled, false to allow normal paste behavior.
+     */
+    onClipboardPaste?: () => Promise<boolean>;
+    /** Stream to write to (default: process.stdout) */
+    stdout?: NodeJS.WriteStream;
+    /** Stream to read from (default: process.stdin) */
+    stdin?: NodeJS.ReadStream;
+    /**
+     * Input mode: 'multi-line' (default) allows newlines, 'single-line' disables them.
+     */
+    mode?: 'single-line' | 'multi-line';
+    /**
+     * History array for navigation. When provided, enables history browsing.
+     * Most recent entries should be at the end of the array.
+     */
+    history?: string[];
+    /**
+     * Callback when history navigation is triggered (Shift+Up/Down or Up/Down at boundaries).
+     * Return the new value to set, or null to do nothing.
+     * @param direction - 'up' for previous history, 'down' for next history
+     * @param currentValue - The current input value (to save before navigating)
+     * @param historyIndex - Current history index (-1 means not in history)
+     */
+    onHistoryNavigate?: (direction: 'up' | 'down', currentValue: string, historyIndex: number) => string | null;
+    /**
+     * Callback when Up/Down is pressed at the first/last line of input.
+     * Used for task navigation in execution mode.
+     * Return true if handled (prevents default cursor movement).
+     */
+    onBoundaryNavigation?: (direction: 'up' | 'down') => boolean;
+    /**
+     * Whether to use Shift+Arrow for history navigation.
+     * If false (default), history is triggered by Up/Down when at input boundaries.
+     * If true, Shift+Up/Down always navigates history regardless of cursor position.
+     */
+    shiftArrowHistory?: boolean;
+    /**
+     * Custom footer rendering callback. When provided, this is called instead of
+     * the default hint rendering. Useful for adding extra content (like image lists)
+     * alongside the hint.
+     * @param escPendingClear - Whether escape-to-clear confirmation is pending
+     * @param termWidth - Current terminal width
+     */
+    customFooter?: (escPendingClear: boolean, termWidth: number) => void;
+    /**
+     * Callback to conditionally hide the input box visually.
+     * When this returns true, render() skips drawing borders and input line,
+     * but the InputBox still processes key events.
+     * Useful for menus where input should only appear for certain selections.
+     */
+    hideWhen?: () => boolean;
+}
+export declare class InputBox {
+    private inputBuffer;
+    private cursorIndex;
+    private isFirstRender;
+    private escPendingClear;
+    private escTimeout;
+    private escapeBuffer;
+    private escapeTimeout;
+    private resolved;
+    private options;
+    private stdout;
+    private stdin;
+    private dataHandler;
+    private rawModeWasEnabled;
+    private preferredVisualCol;
+    private historyIndex;
+    private savedInput;
+    private lastRenderedLineCount;
+    constructor(options: InputBoxOptions);
+    /** Get current input value */
+    getValue(): string;
+    /** Set input value programmatically */
+    setValue(value: string): void;
+    /** Clear input */
+    clear(): void;
+    /** Update history array */
+    setHistory(history: string[]): void;
+    /** Mark as first render (call after external screen redraw) */
+    markFirstRender(): void;
+    /** Get current history index (-1 means not browsing history) */
+    getHistoryIndex(): number;
+    /** Reset history navigation state (call when user modifies input) */
+    resetHistoryState(): void;
+    /**
+     * Navigate history in the given direction.
+     * @returns true if navigation occurred, false if at boundary
+     */
+    navigateHistory(direction: 'up' | 'down'): boolean;
+    /**
+     * Check if cursor is at the first visual line of input
+     */
+    isAtFirstLine(): boolean;
+    /**
+     * Check if cursor is at the last visual line of input
+     */
+    isAtLastLine(): boolean;
+    private safeWrite;
+    private getTermWidth;
+    private getTermHeight;
+    /**
+     * Get cursor position info within multi-line input.
+     * Returns the logical line number and column within that line.
+     */
+    private getLineInfo;
+    /**
+     * Get the content width available for text (terminal width minus prefix).
+     * Prefix is "> " for first line and "  " for continuation lines = 2 chars.
+     */
+    private getContentWidth;
+    /**
+     * Get visual line info for navigation.
+     * Visual lines are what you see on screen after wrapping.
+     * Returns info about which visual row the cursor is on within the current logical line.
+     * Uses display width to account for wide characters (CJK, emoji, etc.).
+     */
+    private getVisualLineInfo;
+    /**
+     * Calculate cursor index from logical line number and column.
+     */
+    private cursorIndexFromLineCol;
+    /**
+     * Render the input box.
+     * Uses full-screen redraw approach for reliability.
+     * Supports multi-line input with proper cursor positioning.
+     *
+     * Self-clears previous output to prevent duplication when onRedraw is empty.
+     */
+    render(): void;
+    /**
+     * Handle a key press
+     */
+    handleKey(key: string): void;
+    /**
+     * Insert text at current cursor position
+     */
+    private insertText;
+    /**
+     * Handle bare escape key (no sequence following)
+     */
+    private handleBareEscape;
+    /**
+     * Clean up and stop listening
+     */
+    cleanup(): void;
+    /**
+     * Start listening for input
+     */
+    start(): void;
+    /**
+     * Run as a promise (convenience method)
+     */
+    prompt(): Promise<string | null>;
+}
+/**
+ * Create and run an InputBox as a promise
+ */
+export declare function inputBox(options: InputBoxOptions): Promise<string | null>;
+/**
+ * Create a single-line InputBox (no multi-line support)
+ */
+export declare function singleLineInput(options: Omit<InputBoxOptions, 'mode'>): InputBox;
+/**
+ * Create an InputBox with history navigation support
+ */
+export declare function inputWithHistory(options: Omit<InputBoxOptions, 'mode'> & {
+    history: string[];
+}): InputBox;
+/**
+ * Create a single-line InputBox with history navigation
+ */
+export declare function singleLineWithHistory(options: Omit<InputBoxOptions, 'mode' | 'shiftArrowHistory'> & {
+    history: string[];
+}): InputBox;
+//# sourceMappingURL=inputBox.d.ts.map

package/dist/inputBox.d.ts.map

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