@flyingrobots/bijou-tui 7.1.0 → 8.0.0-rc.1

package/dist/driver-script.js

@@ -0,0 +1,71 @@
+import { resolveClock, } from '@flyingrobots/bijou';
+import { installBCSSResolver } from './css/install.js';
+import { createEventBus } from './eventbus.js';
+import { isResizeMsg } from './types.js';
+import { createDriverRuntimeState, dispatchScriptStep, initialSize, isStopped, normalizeFrame, } from './driver-runtime.js';
+/**
+ * Run a TEA application against a deterministic scripted input sequence.
+ *
+ * @param app - Application to drive.
+ * @param steps - Ordered interactions to feed into the application.
+ * @param options - Optional callbacks and runtime configuration.
+ * @returns The final model, rendered frames, and elapsed time.
+ */
+export async function runScript(app, steps, options) {
+    const clock = resolveClock(options?.ctx);
+    const start = clock.now();
+    const frames = [];
+    const bus = createEventBus({ clock });
+    const state = createDriverRuntimeState();
+    let currentSize = initialSize(options?.ctx);
+    if (options?.ctx != null) {
+        installBCSSResolver(options.ctx, options.css);
+    }
+    const [initialModel, initialCommands] = app.init();
+    let model = initialModel;
+    if (options?.pulseFps !== false) {
+        bus.startPulse(options?.pulseFps ?? options?.ctx?.runtime.refreshRate ?? 60);
+    }
+    bus.onQuit(() => {
+        state.running = false;
+    });
+    bus.on((msg) => {
+        if (!state.running)
+            return;
+        const [nextModel, commands] = app.update(msg, model);
+        model = nextModel;
+        if (isResizeMsg(msg)) {
+            currentSize = {
+                width: Math.max(0, msg.columns),
+                height: Math.max(0, msg.rows),
+            };
+        }
+        const frame = normalizeFrame(app, model, currentSize);
+        frames.push(frame);
+        options?.onFrame?.(frame, frames.length - 1);
+        for (const command of commands)
+            bus.runCmd(command);
+    });
+    try {
+        const initialFrame = normalizeFrame(app, model, currentSize);
+        frames.push(initialFrame);
+        options?.onFrame?.(initialFrame, 0);
+        for (const command of initialCommands)
+            bus.runCmd(command);
+        await bus.drain();
+        for (const step of steps) {
+            if (isStopped(state))
+                break;
+            if (!await dispatchScriptStep(bus, clock, state, step))
+                break;
+            await bus.drain();
+        }
+        await bus.drain();
+        return { model, frames, elapsed: clock.now() - start };
+    }
+    finally {
+        bus.stopPulse();
+        bus.dispose();
+    }
+}
+//# sourceMappingURL=driver-script.js.map

package/dist/driver-script.js.map

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

package/dist/driver.d.ts

@@ -1,196 +1,6 @@
-/**
- * Scripted driver for TEA applications.
- *
- * Feeds a sequence of key events into an app and captures all rendered
- * frames. Useful for automated demos, integration tests, and CI.
- *
- * ```ts
- * const result = await runScript(counterApp, [
- *   { key: 'up' },
- *   { key: 'up' },
- *   { key: 'down' },
- *   { key: 'q' },
- * ]);
- * console.log(result.model);   // final model state
- * console.log(result.frames);  // all rendered frames
- * ```
- */
-import type { App, RunOptions, MouseMsg } from './types.js';
-import { type BusMsg } from './eventbus.js';
-import { type Surface } from '@flyingrobots/bijou';
-/** A single step in a scripted interaction sequence. */
-export type ScriptStep<M = never> = {
-    /** Key to send (raw terminal key string, e.g., 'a', '\x1b[A', '\x03'). */
-    key: string;
-    /** Milliseconds to wait before sending this step. Default: 0. */
-    delay?: number;
-} | {
-    /** Resize event to emit. */
-    resize: {
-        columns: number;
-        rows: number;
-    };
-    /** Milliseconds to wait before sending this step. Default: 0. */
-    delay?: number;
-} | {
-    /** Pulse event to emit. */
-    pulse: {
-        dt: number;
-    };
-    /** Milliseconds to wait before sending this step. Default: 0. */
-    delay?: number;
-} | {
-    /** Mouse event to emit. */
-    mouse: MouseMsg;
-    /** Milliseconds to wait before sending this step. Default: 0. */
-    delay?: number;
-} | {
-    /** Custom message to emit directly onto the bus. */
-    msg: M;
-    /** Milliseconds to wait before sending this step. Default: 0. */
-    delay?: number;
-};
-/** Options for {@link runScript}, extending the base {@link RunOptions}. */
-export interface RunScriptOptions extends RunOptions {
-    /** Capture each rendered frame. */
-    onFrame?: (frame: Surface, index: number) => void;
-    /** Pulse frequency used to drive animation commands. Set to `false` to disable. */
-    pulseFps?: number | false;
-}
-/**
- * Result returned by {@link runScript} after all steps have been processed.
- *
- * @template Model - The application model type.
- */
-export interface RunScriptResult<Model> {
-    /** Final model state after all steps. */
-    model: Model;
-    /** All rendered frames in order. */
-    frames: Surface[];
-    /** Total elapsed time in milliseconds. */
-    elapsed: number;
-}
-/** Options for {@link testRuntime}. */
-export interface TestRuntimeOptions extends RunScriptOptions {
-}
-/** Final outcome recorded for a command observed by {@link testRuntime}. */
-export type TestRuntimeCommandResolution = 'pending' | 'message' | 'quit' | 'cleanup' | 'void' | 'rejected';
-/**
- * Recorded command behavior captured by a {@link TestHarness}.
- *
- * `emitted` contains messages pushed through the command's `emit()` callback,
- * while `result` records the command's final return value when it settles.
- */
-export interface TestRuntimeCommandRecord<M> {
-    /** Stable id assigned in runtime execution order. */
-    readonly id: number;
-    /** Whether the command originated from `init()` or an `update()` turn. */
-    readonly source: 'init' | 'update';
-    /** Index into {@link TestHarness.messages} for update-triggered commands. */
-    readonly triggerIndex: number | null;
-    /** Messages emitted incrementally through `emit(msg)`. */
-    readonly emitted: readonly M[];
-    /** How the command ultimately settled. */
-    readonly resolution: TestRuntimeCommandResolution;
-    /** Final returned value when the command settled with a value or error. */
-    readonly result?: M | unknown;
-    /** Whether runtime teardown disposed the command's cleanup handle. */
-    readonly cleanedUp: boolean;
-    /** Whether the command has finished executing. */
-    readonly settled: boolean;
-}
-/**
- * Render/model checkpoint captured by a {@link TestHarness}.
- *
- * The initial snapshot is recorded after `init()` renders. Later snapshots are
- * recorded after each handled message.
- */
-export interface TestRuntimeSnapshot<Model, M> {
-    /** Zero-based snapshot index. */
-    readonly index: number;
-    /** Whether this frame came from initial render or an update turn. */
-    readonly cause: 'init' | 'update';
-    /** Message that triggered the update render, when applicable. */
-    readonly message?: BusMsg<M>;
-    /** Model value visible to the view at this snapshot. */
-    readonly model: Model;
-    /** Normalized rendered frame. */
-    readonly frame: Surface;
-}
-/**
- * Interactive test harness for a TEA runtime.
- *
- * Provides direct assertions on snapshots, handled messages, command
- * resolution, and cleanup disposal without reaching into `EventBus` internals.
- */
-export interface TestHarness<Model, M> {
-    /** Latest model state. */
-    readonly model: Model;
-    /** Latest rendered frame. */
-    readonly frame: Surface;
-    /** All rendered frames in order, including the initial render. */
-    readonly frames: readonly Surface[];
-    /** Recorded render/model checkpoints. */
-    readonly snapshots: readonly TestRuntimeSnapshot<Model, M>[];
-    /** All handled runtime messages in delivery order. */
-    readonly messages: readonly BusMsg<M>[];
-    /** Custom messages emitted or returned by commands. */
-    readonly emittedMessages: readonly M[];
-    /** Recorded command lifecycle outcomes. */
-    readonly commands: readonly TestRuntimeCommandRecord<M>[];
-    /** Milliseconds elapsed on the active runtime clock. */
-    readonly elapsed: number;
-    /** Whether the harness is still accepting steps. */
-    readonly running: boolean;
-    /** Return the latest snapshot. */
-    snapshot(): TestRuntimeSnapshot<Model, M>;
-    /** Wait until in-flight commands settle. */
-    settle(): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Feed a single scripted step through the runtime. */
-    step(step: ScriptStep<M>): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Feed multiple scripted steps through the runtime. */
-    run(steps: ScriptStep<M>[]): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Emit a key step. */
-    press(key: string, delay?: number): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Emit a resize step. */
-    resize(columns: number, rows: number, delay?: number): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Emit a pulse step. */
-    pulse(dt: number, delay?: number): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Emit a mouse step. */
-    mouse(message: MouseMsg, delay?: number): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Emit a custom application message directly. */
-    emit(msg: M, delay?: number): Promise<TestRuntimeSnapshot<Model, M>>;
-    /** Stop the runtime and dispose retained command cleanups. */
-    teardown(): Promise<void>;
-}
-/**
- * Start a TEA app inside an inspectable test harness.
- *
- * The harness renders the initial frame, settles init commands, and then lets
- * callers feed steps one at a time while asserting against snapshots, handled
- * messages, command outcomes, and cleanup disposal.
- */
-export declare function testRuntime<Model, M>(app: App<Model, M>, options?: TestRuntimeOptions): Promise<TestHarness<Model, M>>;
-/**
- * Run a TEA app with a scripted key sequence.
- *
- * Internally creates an EventBus and feeds parsed keys from the script.
- * Captures all frames rendered via `view()`. Returns the final model
- * and all frames for assertion or GIF generation.
- *
- * The app quits when:
- * - A command returns QUIT
- * - All script steps are exhausted (auto-quits)
- *
- * Between steps the driver waits for the event bus to go idle, so command
- * chains settle deterministically without relying on microtask-only yields.
- *
- * @template Model - The application model type.
- * @template M     - The message (action) type for the TEA update cycle.
- * @param app     - The TEA application definition (init, update, view).
- * @param steps   - Ordered key events to feed into the app.
- * @param options - Optional callbacks and runtime configuration.
- * @returns The final model, all rendered frames, and elapsed time.
- */
-export declare function runScript<Model, M>(app: App<Model, M>, steps: ScriptStep<M>[], options?: RunScriptOptions): Promise<RunScriptResult<Model>>;
+/** Stable scripted-driver facade over focused interaction modules. */
+export { mouseMove, mousePress, mouseRelease, mouseWheel, sgrMouse, } from './driver-mouse.js';
+export { testRuntime } from './driver-harness.js';
+export { runScript } from './driver-script.js';
+export type { MouseMoveStepOptions, MouseScriptStep, MouseScriptStepOptions, MouseWheelDirection, RunScriptOptions, RunScriptResult, ScriptStep, TestHarness, TestRuntimeCommandRecord, TestRuntimeCommandResolution, TestRuntimeOptions, TestRuntimeSnapshot, } from './driver-contract.js';
 //# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EACL,SAAS,EACT,UAAU,EACV,YAAY,EACZ,UAAU,EACV,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,WAAW,EACX,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/driver.js

@@ -1,389 +1,5 @@
-/**
- * Scripted driver for TEA applications.
- *
- * Feeds a sequence of key events into an app and captures all rendered
- * frames. Useful for automated demos, integration tests, and CI.
- *
- * ```ts
- * const result = await runScript(counterApp, [
- *   { key: 'up' },
- *   { key: 'up' },
- *   { key: 'down' },
- *   { key: 'q' },
- * ]);
- * console.log(result.model);   // final model state
- * console.log(result.frames);  // all rendered frames
- * ```
- */
-import { isCmdCleanup, isResizeMsg, QUIT } from './types.js';
-import { createEventBus } from './eventbus.js';
-import { parseKey } from './keys.js';
-import { resolveClock, sleep } from '@flyingrobots/bijou';
-import { installBCSSResolver } from './css/install.js';
-import { normalizeViewOutput } from './view-output.js';
-// ---------------------------------------------------------------------------
-// Implementation
-// ---------------------------------------------------------------------------
-function initialSize(ctx) {
-    return {
-        width: Math.max(0, Math.floor(ctx?.runtime.columns || 80)),
-        height: Math.max(0, Math.floor(ctx?.runtime.rows || 24)),
-    };
-}
-function normalizeFrame(app, model, size) {
-    return normalizeViewOutput(app.view(model), size).surface;
-}
-/**
- * Start a TEA app inside an inspectable test harness.
- *
- * The harness renders the initial frame, settles init commands, and then lets
- * callers feed steps one at a time while asserting against snapshots, handled
- * messages, command outcomes, and cleanup disposal.
- */
-export async function testRuntime(app, options) {
-    const clock = resolveClock(options?.ctx);
-    const start = clock.now();
-    const frames = [];
-    const snapshots = [];
-    const handledMessages = [];
-    const emittedMessages = [];
-    const commandRecords = [];
-    const bus = createEventBus({ clock });
-    const ctx = options?.ctx;
-    let commandId = 0;
-    let running = true;
-    let tornDown = false;
-    let model;
-    let currentSize = initialSize(ctx);
-    if (ctx != null) {
-        installBCSSResolver(ctx, options?.css);
-    }
-    if (options?.pulseFps !== false) {
-        bus.startPulse(options?.pulseFps ?? ctx?.runtime.refreshRate ?? 60);
-    }
-    function latestSnapshot() {
-        return snapshots[snapshots.length - 1];
-    }
-    function captureSnapshot(cause, message) {
-        const frame = normalizeFrame(app, model, currentSize);
-        frames.push(frame);
-        options?.onFrame?.(frame, frames.length - 1);
-        const snapshot = {
-            index: snapshots.length,
-            cause,
-            message,
-            model,
-            frame,
-        };
-        snapshots.push(snapshot);
-        return snapshot;
-    }
-    function wrapCommand(cmd, source, triggerIndex) {
-        const record = {
-            id: commandId++,
-            source,
-            triggerIndex,
-            emitted: [],
-            resolution: 'pending',
-            cleanedUp: false,
-            settled: false,
-        };
-        commandRecords.push(record);
-        return async (emit, caps) => {
-            const trackedEmit = (msg) => {
-                record.emitted.push(msg);
-                emittedMessages.push(msg);
-                emit(msg);
-            };
-            try {
-                const result = await cmd(trackedEmit, caps);
-                record.settled = true;
-                if (isCmdCleanup(result)) {
-                    record.resolution = 'cleanup';
-                    record.result = result;
-                    if (typeof result === 'function') {
-                        return () => {
-                            record.cleanedUp = true;
-                            result();
-                        };
-                    }
-                    return {
-                        dispose() {
-                            record.cleanedUp = true;
-                            result.dispose();
-                        },
-                    };
-                }
-                if (result === QUIT) {
-                    record.resolution = 'quit';
-                    return result;
-                }
-                if (result !== undefined) {
-                    record.resolution = 'message';
-                    record.result = result;
-                    emittedMessages.push(result);
-                    return result;
-                }
-                record.resolution = 'void';
-                return undefined;
-            }
-            catch (error) {
-                record.settled = true;
-                record.resolution = 'rejected';
-                record.result = error;
-                throw error;
-            }
-        };
-    }
-    async function settle() {
-        await bus.drain();
-        return latestSnapshot();
-    }
-    async function processStep(step) {
-        if (tornDown || !running)
-            return latestSnapshot();
-        if (step.delay && step.delay > 0) {
-            await sleep(clock, step.delay);
-        }
-        if (tornDown || !running)
-            return latestSnapshot();
-        if ('key' in step) {
-            bus.emit(parseKey(step.key));
-        }
-        else if ('pulse' in step) {
-            bus.emit({ type: 'pulse', dt: step.pulse.dt });
-        }
-        else if ('resize' in step) {
-            const resizeMsg = {
-                type: 'resize',
-                columns: step.resize.columns,
-                rows: step.resize.rows,
-            };
-            bus.emit(resizeMsg);
-        }
-        else if ('mouse' in step) {
-            bus.emit(step.mouse);
-        }
-        else if ('msg' in step) {
-            bus.emit(step.msg);
-        }
-        else {
-            const _exhaustive = step;
-            throw new Error(`runScript: unhandled script step variant: ${JSON.stringify(_exhaustive)}`);
-        }
-        return settle();
-    }
-    async function teardown() {
-        if (tornDown)
-            return;
-        tornDown = true;
-        running = false;
-        bus.stopPulse();
-        bus.dispose();
-        await Promise.resolve();
-    }
-    bus.onQuit(() => {
-        running = false;
-    });
-    bus.on((msg) => {
-        if (!running)
-            return;
-        handledMessages.push(msg);
-        const [nextModel, cmds] = app.update(msg, model);
-        model = nextModel;
-        if (isResizeMsg(msg)) {
-            currentSize = {
-                width: Math.max(0, msg.columns),
-                height: Math.max(0, msg.rows),
-            };
-        }
-        captureSnapshot('update', msg);
-        const triggerIndex = handledMessages.length - 1;
-        for (const cmd of cmds) {
-            bus.runCmd(wrapCommand(cmd, 'update', triggerIndex));
-        }
-    });
-    try {
-        const [initModel, initCmds] = app.init();
-        model = initModel;
-        captureSnapshot('init');
-        for (const cmd of initCmds) {
-            bus.runCmd(wrapCommand(cmd, 'init', null));
-        }
-        await bus.drain();
-    }
-    catch (error) {
-        await teardown();
-        throw error;
-    }
-    return {
-        get model() {
-            return model;
-        },
-        get frame() {
-            return latestSnapshot().frame;
-        },
-        get frames() {
-            return frames;
-        },
-        get snapshots() {
-            return snapshots;
-        },
-        get messages() {
-            return handledMessages;
-        },
-        get emittedMessages() {
-            return emittedMessages;
-        },
-        get commands() {
-            return commandRecords;
-        },
-        get elapsed() {
-            return clock.now() - start;
-        },
-        get running() {
-            return running && !tornDown;
-        },
-        snapshot: latestSnapshot,
-        settle,
-        step: processStep,
-        async run(steps) {
-            for (const step of steps) {
-                if (tornDown || !running)
-                    break;
-                await processStep(step);
-            }
-            return settle();
-        },
-        press(key, delay = 0) {
-            return processStep({ key, delay });
-        },
-        resize(columns, rows, delay = 0) {
-            return processStep({ resize: { columns, rows }, delay });
-        },
-        pulse(dt, delay = 0) {
-            return processStep({ pulse: { dt }, delay });
-        },
-        mouse(message, delay = 0) {
-            return processStep({ mouse: message, delay });
-        },
-        emit(msg, delay = 0) {
-            return processStep({ msg, delay });
-        },
-        teardown,
-    };
-}
-/**
- * Run a TEA app with a scripted key sequence.
- *
- * Internally creates an EventBus and feeds parsed keys from the script.
- * Captures all frames rendered via `view()`. Returns the final model
- * and all frames for assertion or GIF generation.
- *
- * The app quits when:
- * - A command returns QUIT
- * - All script steps are exhausted (auto-quits)
- *
- * Between steps the driver waits for the event bus to go idle, so command
- * chains settle deterministically without relying on microtask-only yields.
- *
- * @template Model - The application model type.
- * @template M     - The message (action) type for the TEA update cycle.
- * @param app     - The TEA application definition (init, update, view).
- * @param steps   - Ordered key events to feed into the app.
- * @param options - Optional callbacks and runtime configuration.
- * @returns The final model, all rendered frames, and elapsed time.
- */
-export async function runScript(app, steps, options) {
-    const clock = resolveClock(options?.ctx);
-    const start = clock.now();
-    const frames = [];
-    const bus = createEventBus({ clock });
-    const ctx = options?.ctx;
-    if (ctx != null) {
-        installBCSSResolver(ctx, options?.css);
-    }
-    const [initModel, initCmds] = app.init();
-    let model = initModel;
-    let running = true;
-    let currentSize = initialSize(ctx);
-    if (options?.pulseFps !== false) {
-        bus.startPulse(options?.pulseFps ?? ctx?.runtime.refreshRate ?? 60);
-    }
-    function shutdown() {
-        running = false;
-    }
-    bus.onQuit(shutdown);
-    bus.on((msg) => {
-        if (!running)
-            return;
-        const [newModel, cmds] = app.update(msg, model);
-        model = newModel;
-        if (isResizeMsg(msg)) {
-            currentSize = {
-                width: Math.max(0, msg.columns),
-                height: Math.max(0, msg.rows),
-            };
-        }
-        const frame = normalizeFrame(app, model, currentSize);
-        frames.push(frame);
-        options?.onFrame?.(frame, frames.length - 1);
-        for (const cmd of cmds) {
-            bus.runCmd(cmd);
-        }
-    });
-    try {
-        const initFrame = normalizeFrame(app, model, currentSize);
-        frames.push(initFrame);
-        options?.onFrame?.(initFrame, 0);
-        for (const cmd of initCmds) {
-            bus.runCmd(cmd);
-        }
-        await bus.drain();
-        for (const step of steps) {
-            if (!running)
-                break;
-            if (step.delay && step.delay > 0) {
-                await sleep(clock, step.delay);
-            }
-            if (!running)
-                break;
-            if ('key' in step) {
-                bus.emit(parseKey(step.key));
-            }
-            else if ('pulse' in step) {
-                bus.emit({ type: 'pulse', dt: step.pulse.dt });
-            }
-            else if ('resize' in step) {
-                const resizeMsg = {
-                    type: 'resize',
-                    columns: step.resize.columns,
-                    rows: step.resize.rows,
-                };
-                bus.emit(resizeMsg);
-            }
-            else if ('mouse' in step) {
-                bus.emit(step.mouse);
-            }
-            else if ('msg' in step) {
-                bus.emit(step.msg);
-            }
-            else {
-                const _exhaustive = step;
-                throw new Error(`runScript: unhandled script step variant: ${JSON.stringify(_exhaustive)}`);
-            }
-            await bus.drain();
-        }
-        await bus.drain();
-        return {
-            model,
-            frames,
-            elapsed: clock.now() - start,
-        };
-    }
-    finally {
-        bus.stopPulse();
-        bus.dispose();
-    }
-}
+/** Stable scripted-driver facade over focused interaction modules. */
+export { mouseMove, mousePress, mouseRelease, mouseWheel, sgrMouse, } from './driver-mouse.js';
+export { testRuntime } from './driver-harness.js';
+export { runScript } from './driver-script.js';
 //# sourceMappingURL=driver.js.map