tuiuiu.js 0.1.1

package/dist/dev-tools/testing.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Testing Utilities - Tools for testing tuiuiu applications
+ *
+ * Provides:
+ * - Terminal Simulator: Mock terminal for testing
+ * - Snapshot Testing: Compare rendered output
+ * - Event Simulation: Simulate user input
+ * - Accessibility Checker: Validate a11y requirements
+ * - Test Harness: Complete testing environment
+ */
+import type { VNode } from '../utils/types.js';
+export interface TerminalSize {
+    columns: number;
+    rows: number;
+}
+export interface CursorPosition {
+    x: number;
+    y: number;
+}
+export interface TerminalCell {
+    char: string;
+    fg?: string;
+    bg?: string;
+    bold?: boolean;
+    dim?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    inverse?: boolean;
+    strikethrough?: boolean;
+}
+export interface TerminalState {
+    cells: TerminalCell[][];
+    cursor: CursorPosition;
+    cursorVisible: boolean;
+    title: string;
+    alternateScreen: boolean;
+    mouseEnabled: boolean;
+    bracketedPaste: boolean;
+}
+export interface KeyEvent {
+    key: string;
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+    meta?: boolean;
+}
+export interface MouseEvent {
+    x: number;
+    y: number;
+    button: 'left' | 'right' | 'middle' | 'none';
+    action: 'press' | 'release' | 'move' | 'scroll';
+    scrollDirection?: 'up' | 'down';
+    ctrl?: boolean;
+    alt?: boolean;
+    shift?: boolean;
+}
+export interface SnapshotOptions {
+    includeStyles?: boolean;
+    includePositions?: boolean;
+    normalize?: boolean;
+}
+export interface SnapshotDiff {
+    matches: boolean;
+    differences: Array<{
+        line: number;
+        expected: string;
+        actual: string;
+    }>;
+}
+export interface AccessibilityIssue {
+    type: 'error' | 'warning' | 'info';
+    code: string;
+    message: string;
+    node?: VNode;
+    path?: string;
+}
+export interface AccessibilityReport {
+    valid: boolean;
+    issues: AccessibilityIssue[];
+    summary: {
+        errors: number;
+        warnings: number;
+        info: number;
+    };
+}
+/**
+ * Simulated terminal for testing
+ */
+export declare class TerminalSimulator {
+    private state;
+    private size;
+    private output;
+    private inputQueue;
+    private eventHandlers;
+    constructor(columns?: number, rows?: number);
+    private createInitialState;
+    /**
+     * Get terminal size
+     */
+    getSize(): TerminalSize;
+    /**
+     * Resize terminal
+     */
+    resize(columns: number, rows: number): void;
+    /**
+     * Write to terminal (process ANSI sequences)
+     */
+    write(data: string): void;
+    /**
+     * Get raw output
+     */
+    getOutput(): string[];
+    /**
+     * Get combined output
+     */
+    getOutputString(): string;
+    /**
+     * Clear output buffer
+     */
+    clearOutput(): void;
+    /**
+     * Get current terminal state
+     */
+    getState(): TerminalState;
+    /**
+     * Get cell at position
+     */
+    getCell(x: number, y: number): TerminalCell | null;
+    /**
+     * Get row as string
+     */
+    getRow(y: number): string;
+    /**
+     * Get screen as string array
+     */
+    getScreen(): string[];
+    /**
+     * Get screen as single string
+     */
+    getScreenString(): string;
+    /**
+     * Simulate key press
+     */
+    sendKey(event: KeyEvent): void;
+    /**
+     * Simulate text input
+     */
+    sendText(text: string): void;
+    /**
+     * Simulate mouse event
+     */
+    sendMouse(event: MouseEvent): void;
+    /**
+     * Simulate paste
+     */
+    sendPaste(text: string): void;
+    /**
+     * Get cursor position
+     */
+    getCursor(): CursorPosition;
+    /**
+     * Check if cursor is visible
+     */
+    isCursorVisible(): boolean;
+    /**
+     * Get window title
+     */
+    getTitle(): string;
+    /**
+     * Register event handler
+     */
+    on(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Remove event handler
+     */
+    off(event: string, handler: (...args: unknown[]) => void): void;
+    /**
+     * Emit event
+     */
+    private emit;
+    /**
+     * Reset terminal
+     */
+    reset(): void;
+    /**
+     * Process ANSI output
+     */
+    private processOutput;
+    private writeChar;
+    private parseEscapeSequence;
+    private parseCSI;
+    private parseOSC;
+    private eraseDisplay;
+    private eraseLine;
+    private setMode;
+    private keyToSequence;
+    private mouseToSequence;
+}
+/**
+ * Create a snapshot of rendered output
+ */
+export declare function createSnapshot(output: string, options?: SnapshotOptions): string;
+/**
+ * Compare snapshots
+ */
+export declare function compareSnapshots(expected: string, actual: string): SnapshotDiff;
+/**
+ * Format snapshot diff for display
+ */
+export declare function formatSnapshotDiff(diff: SnapshotDiff): string;
+/**
+ * Strip ANSI codes from string
+ */
+export declare function stripAnsi(str: string): string;
+export interface EventSimulator {
+    keyPress(key: string, modifiers?: Partial<KeyEvent>): void;
+    keyDown(key: string, modifiers?: Partial<KeyEvent>): void;
+    keyUp(key: string, modifiers?: Partial<KeyEvent>): void;
+    type(text: string, delay?: number): Promise<void>;
+    click(x: number, y: number, button?: MouseEvent['button']): void;
+    doubleClick(x: number, y: number): void;
+    rightClick(x: number, y: number): void;
+    drag(fromX: number, fromY: number, toX: number, toY: number): void;
+    scroll(x: number, y: number, direction: 'up' | 'down', amount?: number): void;
+    paste(text: string): void;
+    resize(columns: number, rows: number): void;
+}
+/**
+ * Create event simulator for terminal
+ */
+export declare function createEventSimulator(terminal: TerminalSimulator): EventSimulator;
+/**
+ * Check accessibility of VNode tree
+ */
+export declare function checkAccessibility(node: VNode): AccessibilityReport;
+/**
+ * Format accessibility report
+ */
+export declare function formatAccessibilityReport(report: AccessibilityReport): string;
+export interface TestHarnessOptions {
+    columns?: number;
+    rows?: number;
+    enableMouse?: boolean;
+    enableBracketedPaste?: boolean;
+}
+export interface TestHarness {
+    terminal: TerminalSimulator;
+    events: EventSimulator;
+    render(node: VNode): string;
+    getScreen(): string[];
+    getScreenString(): string;
+    checkA11y(node: VNode): AccessibilityReport;
+    snapshot(output: string, options?: SnapshotOptions): string;
+    compareSnapshot(expected: string, actual: string): SnapshotDiff;
+    reset(): void;
+    cleanup(): void;
+}
+/**
+ * Create a complete test harness
+ */
+export declare function createTestHarness(options?: TestHarnessOptions): TestHarness;
+//# sourceMappingURL=testing.d.ts.map

package/dist/dev-tools/testing.d.ts.map

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