maistro 1.0.390

package/dist/tui-test-harness.d.ts

@@ -0,0 +1,216 @@
+/**
+ * TUI Test Harness
+ *
+ * Provides utilities for testing terminal UI components by:
+ * 1. Capturing terminal output (stdout.write calls)
+ * 2. Simulating keyboard input (stdin events)
+ * 3. Parsing ANSI escape codes to understand rendered state
+ * 4. Computing a virtual terminal buffer to see what's "on screen"
+ */
+import { EventEmitter } from 'node:events';
+export interface TerminalCell {
+    char: string;
+}
+export interface CursorPosition {
+    row: number;
+    col: number;
+}
+/**
+ * Virtual terminal that tracks what would be displayed on screen
+ */
+export declare class VirtualTerminal {
+    private buffer;
+    private cursor;
+    private savedCursor;
+    private savedScrollOffset;
+    private scrollOffset;
+    private width;
+    private height;
+    private rawOutput;
+    constructor(width?: number, height?: number);
+    /**
+     * Clear the terminal buffer
+     */
+    clear(): void;
+    /**
+     * Process raw output (including ANSI codes)
+     */
+    write(data: string): void;
+    /**
+     * Find the end of an ANSI escape sequence
+     */
+    private findEscapeEnd;
+    /**
+     * Process an ANSI escape sequence
+     */
+    private processEscape;
+    private clearToEndOfScreen;
+    private clearToBeginningOfScreen;
+    private clearScreen;
+    private clearToEndOfLine;
+    private clearToBeginningOfLine;
+    private clearLine;
+    private scroll;
+    /**
+     * Get the content of a specific line (trimmed)
+     */
+    getLine(row: number): string;
+    /**
+     * Get all non-empty lines
+     */
+    getVisibleLines(): string[];
+    /**
+     * Get current cursor position
+     */
+    getCursor(): CursorPosition;
+    /**
+     * Get raw output for debugging
+     */
+    getRawOutput(): string[];
+    /**
+     * Count occurrences of a string in visible content
+     */
+    countOccurrences(needle: string): number;
+    /**
+     * Check if content contains a string
+     */
+    contains(needle: string): boolean;
+    /**
+     * Debug: print the terminal buffer
+     */
+    debug(): void;
+}
+/**
+ * Mock stdin for simulating keyboard input
+ * Extends EventEmitter to be compatible with TestableInput interface
+ */
+export declare class MockStdin extends EventEmitter {
+    private _isTTY;
+    private _rawMode;
+    get isTTY(): boolean;
+    set isTTY(value: boolean);
+    setRawMode(mode: boolean): this;
+    isRawMode(): boolean;
+    resume(): void;
+    pause(): void;
+    /**
+     * Simulate typing a string (each character sent separately)
+     */
+    type(text: string): void;
+    /**
+     * Send a single key or escape sequence
+     */
+    sendKey(key: string): void;
+    /**
+     * Send Enter key
+     */
+    sendEnter(): void;
+    /**
+     * Send Escape key
+     */
+    sendEscape(): void;
+    /**
+     * Send Backspace
+     */
+    sendBackspace(): void;
+    /**
+     * Send arrow keys
+     */
+    sendArrowUp(): void;
+    sendArrowDown(): void;
+    sendArrowRight(): void;
+    sendArrowLeft(): void;
+    /**
+     * Send Home key
+     */
+    sendHome(): void;
+    /**
+     * Send End key
+     */
+    sendEnd(): void;
+    /**
+     * Send Delete key
+     */
+    sendDelete(): void;
+    /**
+     * Send Ctrl+A (go to beginning)
+     */
+    sendCtrlA(): void;
+    /**
+     * Send Ctrl+E (go to end)
+     */
+    sendCtrlE(): void;
+    /**
+     * Send Ctrl+C (cancel)
+     */
+    sendCtrlC(): void;
+}
+/**
+ * Mock stdout that wraps VirtualTerminal
+ * Implements TestableStream interface from ui.ts
+ */
+export declare class MockStdout {
+    private terminal;
+    columns: number;
+    constructor(terminal: VirtualTerminal, width?: number);
+    write(data: string): boolean;
+    /**
+     * Get the underlying virtual terminal for assertions
+     */
+    getTerminal(): VirtualTerminal;
+}
+/**
+ * Test harness that combines virtual terminal and mock stdin
+ */
+export declare class TUITestHarness {
+    terminal: VirtualTerminal;
+    stdin: MockStdin;
+    stdout: MockStdout;
+    private originalStdin;
+    private originalStdoutWrite;
+    private originalColumns;
+    private width;
+    constructor(width?: number, height?: number);
+    /**
+     * Install the test harness (replace stdout.write to capture output)
+     * Note: stdin cannot be replaced in Node.js, use MockStdin directly for input simulation
+     */
+    install(): void;
+    /**
+     * Uninstall the test harness (restore original stdout)
+     */
+    uninstall(): void;
+    /**
+     * Reset the terminal buffer
+     */
+    reset(): void;
+    /**
+     * Run a test with the harness installed
+     */
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Get the mock streams for use with InteractiveUI constructor
+     * Usage: new InteractiveUI(harness.getStreams().stdin, harness.getStreams().stdout)
+     */
+    getStreams(): {
+        stdin: MockStdin;
+        stdout: MockStdout;
+    };
+}
+export declare const Keys: {
+    ENTER: string;
+    ESCAPE: string;
+    BACKSPACE: string;
+    DELETE: string;
+    TAB: string;
+    CTRL_C: string;
+    CTRL_A: string;
+    CTRL_E: string;
+    ARROW_UP: string;
+    ARROW_DOWN: string;
+    ARROW_RIGHT: string;
+    ARROW_LEFT: string;
+    HOME: string;
+    END: string;
+};
+//# sourceMappingURL=tui-test-harness.d.ts.map

package/dist/tui-test-harness.d.ts.map

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