@fairyhunter13/opentui-core 0.1.91 → 0.1.94

package/renderer.d.ts

@@ -0,0 +1,388 @@
+import { Renderable, RootRenderable } from "./Renderable.js";
+import { DebugOverlayCorner, type CursorStyleOptions, type MousePointerStyle, type RenderContext, type ThemeMode, type WidthMethod } from "./types.js";
+import { RGBA, type ColorInput } from "./lib/RGBA.js";
+import type { Pointer } from "bun:ffi";
+import { OptimizedBuffer } from "./buffer.js";
+import { type RenderLib } from "./zig.js";
+import { TerminalConsole, type ConsoleOptions } from "./console.js";
+import { type MouseEventType, type RawMouseEvent, type ScrollInfo } from "./lib/parse.mouse.js";
+import { Selection } from "./lib/selection.js";
+import { type ClipboardTarget } from "./lib/clipboard.js";
+import { EventEmitter } from "events";
+import { KeyHandler, InternalKeyHandler } from "./lib/KeyHandler.js";
+import { type TerminalColors, type GetPaletteOptions } from "./lib/terminal-palette.js";
+import { type Clock } from "./lib/clock.js";
+export interface CliRendererConfig {
+    stdin?: NodeJS.ReadStream;
+    stdout?: NodeJS.WriteStream;
+    remote?: boolean;
+    testing?: boolean;
+    exitOnCtrlC?: boolean;
+    exitSignals?: NodeJS.Signals[];
+    forwardEnvKeys?: string[];
+    debounceDelay?: number;
+    targetFps?: number;
+    maxFps?: number;
+    memorySnapshotInterval?: number;
+    useThread?: boolean;
+    gatherStats?: boolean;
+    maxStatSamples?: number;
+    consoleOptions?: Omit<ConsoleOptions, "clock">;
+    postProcessFns?: ((buffer: OptimizedBuffer, deltaTime: number) => void)[];
+    enableMouseMovement?: boolean;
+    useMouse?: boolean;
+    autoFocus?: boolean;
+    useAlternateScreen?: boolean;
+    useConsole?: boolean;
+    experimental_splitHeight?: number;
+    useKittyKeyboard?: KittyKeyboardOptions | null;
+    backgroundColor?: ColorInput;
+    openConsoleOnError?: boolean;
+    prependInputHandlers?: ((sequence: string) => boolean)[];
+    stdinParserMaxBufferBytes?: number;
+    clock?: Clock;
+    onDestroy?: () => void;
+}
+export type PixelResolution = {
+    width: number;
+    height: number;
+};
+/**
+ * Kitty Keyboard Protocol configuration options
+ * See: https://sw.kovidgoyal.net/kitty/keyboard-protocol/#progressive-enhancement
+ */
+export interface KittyKeyboardOptions {
+    /** Disambiguate escape codes (fixes ESC timing, alt+key ambiguity, ctrl+c as event). Default: true */
+    disambiguate?: boolean;
+    /** Report alternate keys (numpad, shifted, base layout) for cross-keyboard shortcuts. Default: true */
+    alternateKeys?: boolean;
+    /** Report event types (press/repeat/release). Default: false */
+    events?: boolean;
+    /** Report all keys as escape codes. Default: false */
+    allKeysAsEscapes?: boolean;
+    /** Report text associated with key events. Default: false */
+    reportText?: boolean;
+}
+/**
+ * Build kitty keyboard protocol flags based on configuration
+ * @param config Kitty keyboard configuration object (null/undefined = disabled)
+ * @returns The combined flags value (0 = disabled, >0 = enabled)
+ * @internal Exported for testing
+ */
+export declare function buildKittyKeyboardFlags(config: KittyKeyboardOptions | null | undefined): number;
+export declare class MouseEvent {
+    readonly type: MouseEventType;
+    readonly button: number;
+    readonly x: number;
+    readonly y: number;
+    readonly source?: Renderable;
+    readonly modifiers: {
+        shift: boolean;
+        alt: boolean;
+        ctrl: boolean;
+    };
+    readonly scroll?: ScrollInfo;
+    readonly target: Renderable | null;
+    readonly isDragging?: boolean;
+    private _propagationStopped;
+    private _defaultPrevented;
+    get propagationStopped(): boolean;
+    get defaultPrevented(): boolean;
+    constructor(target: Renderable | null, attributes: RawMouseEvent & {
+        source?: Renderable;
+        isDragging?: boolean;
+    });
+    stopPropagation(): void;
+    preventDefault(): void;
+}
+export declare enum MouseButton {
+    LEFT = 0,
+    MIDDLE = 1,
+    RIGHT = 2,
+    WHEEL_UP = 4,
+    WHEEL_DOWN = 5
+}
+export declare function createCliRenderer(config?: CliRendererConfig): Promise<CliRenderer>;
+export declare enum CliRenderEvents {
+    DEBUG_OVERLAY_TOGGLE = "debugOverlay:toggle",
+    DESTROY = "destroy"
+}
+export declare enum RendererControlState {
+    IDLE = "idle",
+    AUTO_STARTED = "auto_started",
+    EXPLICIT_STARTED = "explicit_started",
+    EXPLICIT_PAUSED = "explicit_paused",
+    EXPLICIT_SUSPENDED = "explicit_suspended",
+    EXPLICIT_STOPPED = "explicit_stopped"
+}
+export declare class CliRenderer extends EventEmitter implements RenderContext {
+    private static animationFrameId;
+    private lib;
+    rendererPtr: Pointer;
+    stdin: NodeJS.ReadStream;
+    private stdout;
+    private exitOnCtrlC;
+    private exitSignals;
+    private _exitListenersAdded;
+    private _isDestroyed;
+    private _destroyPending;
+    private _destroyFinalized;
+    nextRenderBuffer: OptimizedBuffer;
+    currentRenderBuffer: OptimizedBuffer;
+    private _isRunning;
+    private targetFps;
+    private maxFps;
+    private automaticMemorySnapshot;
+    private memorySnapshotInterval;
+    private memorySnapshotTimer;
+    private lastMemorySnapshot;
+    readonly root: RootRenderable;
+    width: number;
+    height: number;
+    private _useThread;
+    private gatherStats;
+    private frameTimes;
+    private maxStatSamples;
+    private postProcessFns;
+    private backgroundColor;
+    private waitingForPixelResolution;
+    private readonly clock;
+    private rendering;
+    private renderingNative;
+    private renderTimeout;
+    private lastTime;
+    private frameCount;
+    private lastFpsTime;
+    private currentFps;
+    private targetFrameTime;
+    private minTargetFrameTime;
+    private immediateRerenderRequested;
+    private updateScheduled;
+    private liveRequestCounter;
+    private _controlState;
+    private frameCallbacks;
+    private renderStats;
+    debugOverlay: {
+        enabled: any;
+        corner: DebugOverlayCorner;
+    };
+    private _console;
+    private _resolution;
+    private _keyHandler;
+    private stdinParser;
+    private readonly oscSubscribers;
+    private hasLoggedStdinParserError;
+    private animationRequest;
+    private resizeTimeoutId;
+    private capabilityTimeoutId;
+    private resizeDebounceDelay;
+    private enableMouseMovement;
+    private _useMouse;
+    private autoFocus;
+    private _useAlternateScreen;
+    private _suspendedMouseEnabled;
+    private _previousControlState;
+    private capturedRenderable?;
+    private lastOverRenderableNum;
+    private lastOverRenderable?;
+    private currentSelection;
+    private selectionContainers;
+    private clipboard;
+    private _splitHeight;
+    private renderOffset;
+    private _terminalWidth;
+    private _terminalHeight;
+    private _terminalIsSetup;
+    private realStdoutWrite;
+    private captureCallback;
+    private _useConsole;
+    private sigwinchHandler;
+    private _capabilities;
+    private _latestPointer;
+    private _hasPointer;
+    private _lastPointerModifiers;
+    private _currentMousePointerStyle;
+    private _currentFocusedRenderable;
+    private lifecyclePasses;
+    private _openConsoleOnError;
+    private _paletteDetector;
+    private _cachedPalette;
+    private _paletteDetectionPromise;
+    private _onDestroy?;
+    private _themeMode;
+    private sequenceHandlers;
+    private prependedInputHandlers;
+    private shouldRestoreModesOnNextFocus;
+    private idleResolvers;
+    private _debugInputs;
+    private _debugModeEnabled;
+    private handleError;
+    private dumpOutputCache;
+    private exitHandler;
+    private warningHandler;
+    get controlState(): RendererControlState;
+    constructor(lib: RenderLib, rendererPtr: Pointer, stdin: NodeJS.ReadStream, stdout: NodeJS.WriteStream, width: number, height: number, config?: CliRendererConfig);
+    private addExitListeners;
+    private removeExitListeners;
+    get isDestroyed(): boolean;
+    registerLifecyclePass(renderable: Renderable): void;
+    unregisterLifecyclePass(renderable: Renderable): void;
+    getLifecyclePasses(): Set<Renderable>;
+    get currentFocusedRenderable(): Renderable | null;
+    focusRenderable(renderable: Renderable): void;
+    private setCapturedRenderable;
+    addToHitGrid(x: number, y: number, width: number, height: number, id: number): void;
+    pushHitGridScissorRect(x: number, y: number, width: number, height: number): void;
+    popHitGridScissorRect(): void;
+    clearHitGridScissorRects(): void;
+    get widthMethod(): WidthMethod;
+    private writeOut;
+    requestRender(): void;
+    private activateFrame;
+    get useConsole(): boolean;
+    set useConsole(value: boolean);
+    get isRunning(): boolean;
+    private isIdleNow;
+    private resolveIdleIfNeeded;
+    idle(): Promise<void>;
+    get resolution(): PixelResolution | null;
+    get console(): TerminalConsole;
+    get keyInput(): KeyHandler;
+    get _internalKeyInput(): InternalKeyHandler;
+    get terminalWidth(): number;
+    get terminalHeight(): number;
+    get useThread(): boolean;
+    get useMouse(): boolean;
+    set useMouse(useMouse: boolean);
+    get experimental_splitHeight(): number;
+    get liveRequestCount(): number;
+    get currentControlState(): string;
+    get capabilities(): any | null;
+    get themeMode(): ThemeMode | null;
+    getDebugInputs(): Array<{
+        timestamp: string;
+        sequence: string;
+    }>;
+    get useKittyKeyboard(): boolean;
+    set useKittyKeyboard(use: boolean);
+    set experimental_splitHeight(splitHeight: number);
+    private interceptStdoutWrite;
+    disableStdoutInterception(): void;
+    private flushStdoutCache;
+    private enableMouse;
+    private disableMouse;
+    enableKittyKeyboard(flags?: number): void;
+    disableKittyKeyboard(): void;
+    set useThread(useThread: boolean);
+    setupTerminal(): Promise<void>;
+    private stdinListener;
+    addInputHandler(handler: (sequence: string) => boolean): void;
+    prependInputHandler(handler: (sequence: string) => boolean): void;
+    removeInputHandler(handler: (sequence: string) => boolean): void;
+    subscribeOsc(handler: (sequence: string) => void): () => void;
+    private capabilityHandler;
+    private focusHandler;
+    private themeModeHandler;
+    private dispatchSequenceHandlers;
+    private drainStdinParser;
+    private handleStdinEvent;
+    private handleStdinParserFailure;
+    private setupInput;
+    private dispatchMouseEvent;
+    private processSingleMouseEvent;
+    /**
+     * Recheck hover state after hit grid changes.
+     * Called after render when native code detects the hit grid changed.
+     * Fires out/over events if the element under the cursor changed.
+     */
+    private recheckHoverState;
+    setMousePointer(style: MousePointerStyle): void;
+    hitTest(x: number, y: number): number;
+    private takeMemorySnapshot;
+    private startMemorySnapshotTimer;
+    private stopMemorySnapshotTimer;
+    setMemorySnapshotInterval(interval: number): void;
+    private handleResize;
+    private queryPixelResolution;
+    private processResize;
+    setBackgroundColor(color: ColorInput): void;
+    toggleDebugOverlay(): void;
+    configureDebugOverlay(options: {
+        enabled?: boolean;
+        corner?: DebugOverlayCorner;
+    }): void;
+    setTerminalTitle(title: string): void;
+    copyToClipboardOSC52(text: string, target?: ClipboardTarget): boolean;
+    clearClipboardOSC52(target?: ClipboardTarget): boolean;
+    isOsc52Supported(): boolean;
+    dumpHitGrid(): void;
+    dumpBuffers(timestamp?: number): void;
+    dumpStdoutBuffer(timestamp?: number): void;
+    static setCursorPosition(renderer: CliRenderer, x: number, y: number, visible?: boolean): void;
+    static setCursorStyle(renderer: CliRenderer, options: CursorStyleOptions): void;
+    static setCursorColor(renderer: CliRenderer, color: RGBA): void;
+    setCursorPosition(x: number, y: number, visible?: boolean): void;
+    setCursorStyle(options: CursorStyleOptions): void;
+    setCursorColor(color: RGBA): void;
+    getCursorState(): import("./zig.js").CursorState;
+    addPostProcessFn(processFn: (buffer: OptimizedBuffer, deltaTime: number) => void): void;
+    removePostProcessFn(processFn: (buffer: OptimizedBuffer, deltaTime: number) => void): void;
+    clearPostProcessFns(): void;
+    setFrameCallback(callback: (deltaTime: number) => Promise<void>): void;
+    removeFrameCallback(callback: (deltaTime: number) => Promise<void>): void;
+    clearFrameCallbacks(): void;
+    requestLive(): void;
+    dropLive(): void;
+    start(): void;
+    auto(): void;
+    private internalStart;
+    pause(): void;
+    suspend(): void;
+    resume(): void;
+    private internalPause;
+    stop(): void;
+    private internalStop;
+    destroy(): void;
+    private finalizeDestroy;
+    private startRenderLoop;
+    private loop;
+    intermediateRender(): void;
+    private renderNative;
+    private collectStatSample;
+    getStats(): {
+        fps: number;
+        frameCount: number;
+        frameTimes: number[];
+        averageFrameTime: number;
+        minFrameTime: number;
+        maxFrameTime: number;
+    };
+    resetStats(): void;
+    setGatherStats(enabled: boolean): void;
+    getSelection(): Selection | null;
+    get hasSelection(): boolean;
+    getSelectionContainer(): Renderable | null;
+    clearSelection(): void;
+    /**
+     * Start a new selection at the given coordinates.
+     * Used by both mouse and keyboard selection.
+     */
+    startSelection(renderable: Renderable, x: number, y: number): void;
+    updateSelection(currentRenderable: Renderable | undefined, x: number, y: number, options?: {
+        finishDragging?: boolean;
+    }): void;
+    requestSelectionUpdate(): void;
+    private isWithinContainer;
+    private finishSelection;
+    private notifySelectablesOfSelectionChange;
+    private walkSelectableRenderables;
+    get paletteDetectionStatus(): "idle" | "detecting" | "cached";
+    clearPaletteCache(): void;
+    /**
+     * Detects the terminal's color palette
+     *
+     * @returns Promise resolving to TerminalColors object containing palette and special colors
+     * @throws Error if renderer is suspended
+     */
+    getPalette(options?: GetPaletteOptions): Promise<TerminalColors>;
+}

package/runtime-plugin-support.d.ts

@@ -0,0 +1,3 @@
+import { createRuntimePlugin, runtimeModuleIdForSpecifier, type CreateRuntimePluginOptions, type RuntimeModuleEntry, type RuntimeModuleExports, type RuntimeModuleLoader } from "./runtime-plugin";
+export declare function ensureRuntimePluginSupport(options?: CreateRuntimePluginOptions): boolean;
+export { createRuntimePlugin, runtimeModuleIdForSpecifier, type CreateRuntimePluginOptions, type RuntimeModuleEntry, type RuntimeModuleExports, type RuntimeModuleLoader, };

package/runtime-plugin-support.js

@@ -0,0 +1,29 @@
+// @bun
+import {
+  createRuntimePlugin,
+  runtimeModuleIdForSpecifier
+} from "./index-ynzawt3n.js";
+import"./index-h066zmrb.js";
+import"./index-e6ec7apq.js";
+
+// src/runtime-plugin-support.ts
+var {plugin: registerBunPlugin } = globalThis.Bun;
+var runtimePluginSupportInstalledKey = "__opentuiCoreRuntimePluginSupportInstalled__";
+function ensureRuntimePluginSupport(options = {}) {
+  const state = globalThis;
+  if (state[runtimePluginSupportInstalledKey]) {
+    return false;
+  }
+  registerBunPlugin(createRuntimePlugin(options));
+  state[runtimePluginSupportInstalledKey] = true;
+  return true;
+}
+ensureRuntimePluginSupport();
+export {
+  runtimeModuleIdForSpecifier,
+  ensureRuntimePluginSupport,
+  createRuntimePlugin
+};
+
+//# debugId=7487C2BFD13C698664756E2164756E21
+//# sourceMappingURL=runtime-plugin-support.js.map

package/runtime-plugin-support.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/runtime-plugin-support.ts"],
+  "sourcesContent": [
+    "import { plugin as registerBunPlugin } from \"bun\"\nimport {\n  createRuntimePlugin,\n  runtimeModuleIdForSpecifier,\n  type CreateRuntimePluginOptions,\n  type RuntimeModuleEntry,\n  type RuntimeModuleExports,\n  type RuntimeModuleLoader,\n} from \"./runtime-plugin\"\n\nconst runtimePluginSupportInstalledKey = \"__opentuiCoreRuntimePluginSupportInstalled__\"\n\ntype RuntimePluginSupportState = typeof globalThis & {\n  [runtimePluginSupportInstalledKey]?: boolean\n}\n\nexport function ensureRuntimePluginSupport(options: CreateRuntimePluginOptions = {}): boolean {\n  const state = globalThis as RuntimePluginSupportState\n\n  if (state[runtimePluginSupportInstalledKey]) {\n    return false\n  }\n\n  registerBunPlugin(createRuntimePlugin(options))\n\n  state[runtimePluginSupportInstalledKey] = true\n  return true\n}\n\nensureRuntimePluginSupport()\n\nexport {\n  createRuntimePlugin,\n  runtimeModuleIdForSpecifier,\n  type CreateRuntimePluginOptions,\n  type RuntimeModuleEntry,\n  type RuntimeModuleExports,\n  type RuntimeModuleLoader,\n}\n"
+  ],
+  "mappings": ";;;;;;;;;AAAA;AAUA,IAAM,mCAAmC;AAMlC,SAAS,0BAA0B,CAAC,UAAsC,CAAC,GAAY;AAAA,EAC5F,MAAM,QAAQ;AAAA,EAEd,IAAI,MAAM,mCAAmC;AAAA,IAC3C,OAAO;AAAA,EACT;AAAA,EAEA,kBAAkB,oBAAoB,OAAO,CAAC;AAAA,EAE9C,MAAM,oCAAoC;AAAA,EAC1C,OAAO;AAAA;AAGT,2BAA2B;",
+  "debugId": "7487C2BFD13C698664756E2164756E21",
+  "names": []
+}

package/runtime-plugin.d.ts

@@ -0,0 +1,11 @@
+import { type BunPlugin } from "bun";
+export type RuntimeModuleExports = Record<string, unknown>;
+export type RuntimeModuleLoader = () => RuntimeModuleExports | Promise<RuntimeModuleExports>;
+export type RuntimeModuleEntry = RuntimeModuleExports | RuntimeModuleLoader;
+export interface CreateRuntimePluginOptions {
+    core?: RuntimeModuleEntry;
+    additional?: Record<string, RuntimeModuleEntry>;
+}
+export declare const isCoreRuntimeModuleSpecifier: (specifier: string) => boolean;
+export declare const runtimeModuleIdForSpecifier: (specifier: string) => string;
+export declare function createRuntimePlugin(input?: CreateRuntimePluginOptions): BunPlugin;

package/runtime-plugin.js

@@ -0,0 +1,16 @@
+// @bun
+import {
+  createRuntimePlugin,
+  isCoreRuntimeModuleSpecifier,
+  runtimeModuleIdForSpecifier
+} from "./index-ynzawt3n.js";
+import"./index-h066zmrb.js";
+import"./index-e6ec7apq.js";
+export {
+  runtimeModuleIdForSpecifier,
+  isCoreRuntimeModuleSpecifier,
+  createRuntimePlugin
+};
+
+//# debugId=54AC4E2ADFC3366A64756E2164756E21
+//# sourceMappingURL=runtime-plugin.js.map

package/runtime-plugin.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "54AC4E2ADFC3366A64756E2164756E21",
+  "names": []
+}

package/syntax-style.d.ts

@@ -0,0 +1,54 @@
+import { RGBA, type ColorInput } from "./lib/RGBA.js";
+import { type RenderLib } from "./zig.js";
+import { type Pointer } from "bun:ffi";
+export interface StyleDefinition {
+    fg?: RGBA;
+    bg?: RGBA;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    dim?: boolean;
+}
+export interface MergedStyle {
+    fg?: RGBA;
+    bg?: RGBA;
+    attributes: number;
+}
+export interface ThemeTokenStyle {
+    scope: string[];
+    style: {
+        foreground?: ColorInput;
+        background?: ColorInput;
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+        dim?: boolean;
+    };
+}
+export declare function convertThemeToStyles(theme: ThemeTokenStyle[]): Record<string, StyleDefinition>;
+export declare class SyntaxStyle {
+    private lib;
+    private stylePtr;
+    private _destroyed;
+    private nameCache;
+    private styleDefs;
+    private mergedCache;
+    constructor(lib: RenderLib, ptr: Pointer);
+    static create(): SyntaxStyle;
+    static fromTheme(theme: ThemeTokenStyle[]): SyntaxStyle;
+    static fromStyles(styles: Record<string, StyleDefinition>): SyntaxStyle;
+    private guard;
+    registerStyle(name: string, style: StyleDefinition): number;
+    resolveStyleId(name: string): number | null;
+    getStyleId(name: string): number | null;
+    get ptr(): Pointer;
+    getStyleCount(): number;
+    clearNameCache(): void;
+    getStyle(name: string): StyleDefinition | undefined;
+    mergeStyles(...styleNames: string[]): MergedStyle;
+    clearCache(): void;
+    getCacheSize(): number;
+    getAllStyles(): Map<string, StyleDefinition>;
+    getRegisteredNames(): string[];
+    destroy(): void;
+}

package/testing/manual-clock.d.ts

@@ -0,0 +1,16 @@
+import type { Clock, TimerHandle } from "../lib/clock";
+export declare class ManualClock implements Clock {
+    private time;
+    private nextId;
+    private nextOrder;
+    private readonly timers;
+    now(): number;
+    setTimeout(fn: () => void, delayMs: number): TimerHandle;
+    clearTimeout(handle: TimerHandle): void;
+    setInterval(fn: () => void, delayMs: number): TimerHandle;
+    clearInterval(handle: TimerHandle): void;
+    advance(delayMs: number): void;
+    runAll(): void;
+    private schedule;
+    private peekNextTimer;
+}

package/testing/mock-keys.d.ts

@@ -0,0 +1,81 @@
+import type { CliRenderer } from "../renderer.js";
+export declare function pasteBytes(text: string): Uint8Array;
+export declare const KeyCodes: {
+    readonly RETURN: "\r";
+    readonly LINEFEED: "\n";
+    readonly TAB: "\t";
+    readonly BACKSPACE: "\b";
+    readonly DELETE: "\u001B[3~";
+    readonly HOME: "\u001B[H";
+    readonly END: "\u001B[F";
+    readonly ESCAPE: "\u001B";
+    readonly ARROW_UP: "\u001B[A";
+    readonly ARROW_DOWN: "\u001B[B";
+    readonly ARROW_RIGHT: "\u001B[C";
+    readonly ARROW_LEFT: "\u001B[D";
+    readonly F1: "\u001BOP";
+    readonly F2: "\u001BOQ";
+    readonly F3: "\u001BOR";
+    readonly F4: "\u001BOS";
+    readonly F5: "\u001B[15~";
+    readonly F6: "\u001B[17~";
+    readonly F7: "\u001B[18~";
+    readonly F8: "\u001B[19~";
+    readonly F9: "\u001B[20~";
+    readonly F10: "\u001B[21~";
+    readonly F11: "\u001B[23~";
+    readonly F12: "\u001B[24~";
+};
+export type KeyInput = string | keyof typeof KeyCodes;
+export interface MockKeysOptions {
+    kittyKeyboard?: boolean;
+    otherModifiersMode?: boolean;
+}
+export declare function createMockKeys(renderer: CliRenderer, options?: MockKeysOptions): {
+    pressKeys: (keys: KeyInput[], delayMs?: number) => Promise<void>;
+    pressKey: (key: KeyInput, modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    typeText: (text: string, delayMs?: number) => Promise<void>;
+    pressEnter: (modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    pressEscape: (modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    pressTab: (modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    pressBackspace: (modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    pressArrow: (direction: "up" | "down" | "left" | "right", modifiers?: {
+        shift?: boolean;
+        ctrl?: boolean;
+        meta?: boolean;
+        super?: boolean;
+        hyper?: boolean;
+    }) => void;
+    pressCtrlC: () => void;
+    pasteBracketedText: (text: string) => Promise<void>;
+};

package/testing/mock-mouse.d.ts

@@ -0,0 +1,38 @@
+import type { CliRenderer } from "../renderer.js";
+export declare const MouseButtons: {
+    readonly LEFT: 0;
+    readonly MIDDLE: 1;
+    readonly RIGHT: 2;
+    readonly WHEEL_UP: 64;
+    readonly WHEEL_DOWN: 65;
+    readonly WHEEL_LEFT: 66;
+    readonly WHEEL_RIGHT: 67;
+};
+export type MouseButton = (typeof MouseButtons)[keyof typeof MouseButtons];
+export interface MousePosition {
+    x: number;
+    y: number;
+}
+export interface MouseModifiers {
+    shift?: boolean;
+    alt?: boolean;
+    ctrl?: boolean;
+}
+export type MouseEventType = "down" | "up" | "move" | "drag" | "scroll";
+export interface MouseEventOptions {
+    button?: MouseButton;
+    modifiers?: MouseModifiers;
+    delayMs?: number;
+}
+export declare function createMockMouse(renderer: CliRenderer): {
+    moveTo: (x: number, y: number, options?: MouseEventOptions) => Promise<void>;
+    click: (x: number, y: number, button?: MouseButton, options?: MouseEventOptions) => Promise<void>;
+    doubleClick: (x: number, y: number, button?: MouseButton, options?: MouseEventOptions) => Promise<void>;
+    pressDown: (x: number, y: number, button?: MouseButton, options?: MouseEventOptions) => Promise<void>;
+    release: (x: number, y: number, button?: MouseButton, options?: MouseEventOptions) => Promise<void>;
+    drag: (startX: number, startY: number, endX: number, endY: number, button?: MouseButton, options?: MouseEventOptions) => Promise<void>;
+    scroll: (x: number, y: number, direction: "up" | "down" | "left" | "right", options?: MouseEventOptions) => Promise<void>;
+    getCurrentPosition: () => MousePosition;
+    getPressedButtons: () => MouseButton[];
+    emitMouseEvent: (type: MouseEventType, x: number, y: number, button?: MouseButton, options?: Omit<MouseEventOptions, "button">) => Promise<void>;
+};

package/testing/mock-tree-sitter-client.d.ts

@@ -0,0 +1,23 @@
+import { TreeSitterClient } from "../lib/tree-sitter/index.js";
+import type { SimpleHighlight } from "../lib/tree-sitter/types.js";
+export declare class MockTreeSitterClient extends TreeSitterClient {
+    private _highlightPromises;
+    private _mockResult;
+    private _autoResolveTimeout?;
+    constructor(options?: {
+        autoResolveTimeout?: number;
+    });
+    highlightOnce(content: string, filetype: string): Promise<{
+        highlights?: SimpleHighlight[];
+        warning?: string;
+        error?: string;
+    }>;
+    setMockResult(result: {
+        highlights?: SimpleHighlight[];
+        warning?: string;
+        error?: string;
+    }): void;
+    resolveHighlightOnce(index?: number): void;
+    resolveAllHighlightOnce(): void;
+    isHighlighting(): boolean;
+}