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

package/dist/driver-harness-command.js

@@ -0,0 +1,60 @@
+import { isCmdCleanup, QUIT, } from './types.js';
+/** Wrap a command with observable settlement and cleanup facts. */
+export function observeCommand(state, cmd, source, triggerIndex) {
+    const record = {
+        id: state.nextCommandId++,
+        source,
+        triggerIndex,
+        emitted: [],
+        resolution: 'pending',
+        cleanedUp: false,
+        settled: false,
+    };
+    state.commands.push(record);
+    return async (emit, caps) => {
+        const trackedEmit = (msg) => {
+            record.emitted.push(msg);
+            state.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;
+                state.emittedMessages.push(result);
+                return result;
+            }
+            record.resolution = 'void';
+            return undefined;
+        }
+        catch (error) {
+            record.settled = true;
+            record.resolution = 'rejected';
+            record.result = error;
+            throw error;
+        }
+    };
+}
+//# sourceMappingURL=driver-harness-command.js.map

package/dist/driver-harness-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-command.js","sourceRoot":"","sources":["../src/driver-harness-command.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,IAAI,GAEL,MAAM,YAAY,CAAC;AAMpB,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAC5B,KAA6B,EAC7B,GAAW,EACX,MAAyB,EACzB,YAA2B;IAE3B,MAAM,MAAM,GAA4B;QACtC,EAAE,EAAE,KAAK,CAAC,aAAa,EAAE;QACzB,MAAM;QACN,YAAY;QACZ,OAAO,EAAE,EAAE;QACX,UAAU,EAAE,SAAS;QACrB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,KAAK;KACf,CAAC;IACF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,WAAW,GAAG,CAAC,GAAM,EAAQ,EAAE;YACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzB,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,CAAC,CAAC;QACZ,CAAC,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAC5C,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzB,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC9B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACvB,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;oBACjC,OAAO,GAAG,EAAE;wBACV,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;wBACxB,MAAM,EAAE,CAAC;oBACX,CAAC,CAAC;gBACJ,CAAC;gBACD,OAAO;oBACL,OAAO;wBACL,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;wBACxB,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,CAAC;iBACF,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;gBAC3B,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,UAAU,GAAG,SAAS,CAAC;gBAC9B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;gBACvB,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YACtB,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;YAC/B,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;YACtB,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/driver-harness-contract.d.ts

@@ -0,0 +1,87 @@
+import type { Surface } from '@flyingrobots/bijou';
+import type { BusMsg } from './eventbus.js';
+import type { MouseMsg } from './types.js';
+import type { RunScriptOptions, ScriptStep } from './driver-script-contract.js';
+/** Options for the interactive test runtime. */
+export type TestRuntimeOptions = RunScriptOptions;
+/** Final outcome recorded for a command observed by a test runtime. */
+export type TestRuntimeCommandResolution = 'pending' | 'message' | 'quit' | 'cleanup' | 'void' | 'rejected';
+/**
+ * Recorded command behavior captured by a test harness.
+ *
+ * `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 the handled 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?: 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 test harness. */
+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, inspectable test harness for a TEA runtime. */
+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>;
+}
+//# sourceMappingURL=driver-harness-contract.d.ts.map

package/dist/driver-harness-contract.d.ts.map

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

package/dist/driver-harness-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver-harness-contract.js.map

package/dist/driver-harness-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-contract.js","sourceRoot":"","sources":["../src/driver-harness-contract.ts"],"names":[],"mappings":""}

package/dist/driver-harness-state.d.ts

@@ -0,0 +1,8 @@
+import type { BusMsg } from './eventbus.js';
+import type { HarnessState, ScriptStep, TestRuntimeSnapshot } from './driver-contract.js';
+export declare function latestSnapshot<Model, M>(state: HarnessState<Model, M>): TestRuntimeSnapshot<Model, M>;
+export declare function captureSnapshot<Model, M>(state: HarnessState<Model, M>, cause: 'init' | 'update', message?: BusMsg<M>): TestRuntimeSnapshot<Model, M>;
+export declare function settleHarness<Model, M>(state: HarnessState<Model, M>): Promise<TestRuntimeSnapshot<Model, M>>;
+export declare function processHarnessStep<Model, M>(state: HarnessState<Model, M>, step: ScriptStep<M>): Promise<TestRuntimeSnapshot<Model, M>>;
+export declare function teardownHarness<Model, M>(state: HarnessState<Model, M>): Promise<void>;
+//# sourceMappingURL=driver-harness-state.d.ts.map

package/dist/driver-harness-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-state.d.ts","sourceRoot":"","sources":["../src/driver-harness-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAO9B,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,EACrC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAC5B,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAM/B;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,EACtC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAC7B,KAAK,EAAE,MAAM,GAAG,QAAQ,EACxB,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAClB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAa/B;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,CAAC,EAC1C,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAC5B,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAGxC;AAED,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,CAAC,EAC/C,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAC7B,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAIxC;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,EAC5C,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/driver-harness-state.js

@@ -0,0 +1,42 @@
+import { dispatchScriptStep, isStopped, normalizeFrame, } from './driver-runtime.js';
+export function latestSnapshot(state) {
+    const snapshot = state.snapshots.at(-1);
+    if (snapshot === undefined) {
+        throw new Error('testRuntime: no snapshots captured');
+    }
+    return snapshot;
+}
+export function captureSnapshot(state, cause, message) {
+    const frame = normalizeFrame(state.app, state.model, state.currentSize);
+    state.frames.push(frame);
+    state.options?.onFrame?.(frame, state.frames.length - 1);
+    const snapshot = {
+        index: state.snapshots.length,
+        cause,
+        message,
+        model: state.model,
+        frame,
+    };
+    state.snapshots.push(snapshot);
+    return snapshot;
+}
+export async function settleHarness(state) {
+    await state.bus.drain();
+    return latestSnapshot(state);
+}
+export async function processHarnessStep(state, step) {
+    if (isStopped(state.runtime))
+        return latestSnapshot(state);
+    await dispatchScriptStep(state.bus, state.clock, state.runtime, step);
+    return settleHarness(state);
+}
+export async function teardownHarness(state) {
+    if (state.runtime.tornDown)
+        return;
+    state.runtime.tornDown = true;
+    state.runtime.running = false;
+    state.bus.stopPulse();
+    state.bus.dispose();
+    await Promise.resolve();
+}
+//# sourceMappingURL=driver-harness-state.js.map

package/dist/driver-harness-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-state.js","sourceRoot":"","sources":["../src/driver-harness-state.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,cAAc,CAC5B,KAA6B;IAE7B,MAAM,QAAQ,GAAG,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAA6B,EAC7B,KAAwB,EACxB,OAAmB;IAEnB,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;IACxE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAkC;QAC9C,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM;QAC7B,KAAK;QACL,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,KAAK;KACN,CAAC;IACF,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,KAA6B;IAE7B,MAAM,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;IACxB,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAA6B,EAC7B,IAAmB;IAEnB,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;QAAE,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,kBAAkB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAA6B;IAE7B,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO;IACnC,KAAK,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;IAC9B,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;IACtB,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;IACpB,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;AAC1B,CAAC"}

package/dist/driver-harness.d.ts

@@ -0,0 +1,11 @@
+import type { TestHarness, TestRuntimeOptions } from './driver-contract.js';
+import type { App } from './types.js';
+/**
+ * Start a TEA app inside an inspectable deterministic test harness.
+ *
+ * The harness renders the initial frame, settles init commands, and then lets
+ * callers feed steps while inspecting snapshots, messages, command outcomes,
+ * and cleanup disposal.
+ */
+export declare function testRuntime<Model, M>(app: App<Model, M>, options?: TestRuntimeOptions): Promise<TestHarness<Model, M>>;
+//# sourceMappingURL=driver-harness.d.ts.map

package/dist/driver-harness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness.d.ts","sourceRoot":"","sources":["../src/driver-harness.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAGV,WAAW,EACX,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAW9B,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,CAAC,EACxC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAyEhC"}

package/dist/driver-harness.js

@@ -0,0 +1,91 @@
+import { resolveClock, } from '@flyingrobots/bijou';
+import { createEventBus } from './eventbus.js';
+import { installBCSSResolver } from './css/install.js';
+import { isResizeMsg } from './types.js';
+import { createHarnessApi } from './driver-harness-api.js';
+import { observeCommand } from './driver-harness-command.js';
+import { captureSnapshot, teardownHarness, } from './driver-harness-state.js';
+import { createDriverRuntimeState, initialSize, } from './driver-runtime.js';
+/**
+ * Start a TEA app inside an inspectable deterministic test harness.
+ *
+ * The harness renders the initial frame, settles init commands, and then lets
+ * callers feed steps while inspecting snapshots, messages, command outcomes,
+ * and cleanup disposal.
+ */
+export async function testRuntime(app, options) {
+    const clock = resolveClock(options?.ctx);
+    const start = clock.now();
+    const bus = createEventBus({ clock });
+    const frames = [];
+    const snapshots = [];
+    const messages = [];
+    const emittedMessages = [];
+    const commands = [];
+    if (options?.ctx != null) {
+        installBCSSResolver(options.ctx, options.css);
+    }
+    if (options?.pulseFps !== false) {
+        bus.startPulse(options?.pulseFps ?? options?.ctx?.runtime.refreshRate ?? 60);
+    }
+    const [initialModel, initialCommands] = (() => {
+        try {
+            return app.init();
+        }
+        catch (error) {
+            bus.stopPulse();
+            bus.dispose();
+            throw error;
+        }
+    })();
+    const state = {
+        app,
+        options,
+        bus,
+        clock,
+        start,
+        runtime: createDriverRuntimeState(),
+        frames,
+        snapshots,
+        messages,
+        emittedMessages,
+        commands,
+        model: initialModel,
+        currentSize: initialSize(options?.ctx),
+        nextCommandId: 0,
+    };
+    bus.onQuit(() => {
+        state.runtime.running = false;
+    });
+    bus.on((msg) => {
+        if (!state.runtime.running)
+            return;
+        state.messages.push(msg);
+        const [model, commands] = app.update(msg, state.model);
+        state.model = model;
+        if (isResizeMsg(msg)) {
+            state.currentSize = {
+                width: Math.max(0, msg.columns),
+                height: Math.max(0, msg.rows),
+            };
+        }
+        captureSnapshot(state, 'update', msg);
+        const triggerIndex = state.messages.length - 1;
+        for (const command of commands) {
+            bus.runCmd(observeCommand(state, command, 'update', triggerIndex));
+        }
+    });
+    try {
+        captureSnapshot(state, 'init');
+        for (const command of initialCommands) {
+            bus.runCmd(observeCommand(state, command, 'init', null));
+        }
+        await bus.drain();
+    }
+    catch (error) {
+        await teardownHarness(state);
+        throw error;
+    }
+    return createHarnessApi(state);
+}
+//# sourceMappingURL=driver-harness.js.map

package/dist/driver-harness.js.map

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

package/dist/driver-mouse.d.ts

@@ -0,0 +1,13 @@
+import type { MouseButton } from './types.js';
+import type { MouseMoveStepOptions, MouseScriptStep, MouseScriptStepOptions, MouseWheelDirection } from './driver-contract.js';
+/** Create a scripted mouse-move step. */
+export declare function mouseMove<M = never>(col: number, row: number, options?: MouseMoveStepOptions): MouseScriptStep<M>;
+/** Create a scripted mouse-press step. */
+export declare function mousePress<M = never>(button: Exclude<MouseButton, 'none'>, col: number, row: number, options?: MouseScriptStepOptions): MouseScriptStep<M>;
+/** Create a scripted mouse-release step. */
+export declare function mouseRelease<M = never>(button: Exclude<MouseButton, 'none'>, col: number, row: number, options?: MouseScriptStepOptions): MouseScriptStep<M>;
+/** Create a scripted mouse-wheel step. */
+export declare function mouseWheel<M = never>(direction: MouseWheelDirection, col: number, row: number, options?: MouseScriptStepOptions): MouseScriptStep<M>;
+/** Parse an SGR mouse escape sequence into a scripted mouse step. */
+export declare function sgrMouse<M = never>(raw: string, delay?: number): MouseScriptStep<M>;
+//# sourceMappingURL=driver-mouse.d.ts.map

package/dist/driver-mouse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-mouse.d.ts","sourceRoot":"","sources":["../src/driver-mouse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EAEZ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AA4B9B,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,CAAC,GAAG,KAAK,EACjC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,oBAAyB,GACjC,eAAe,CAAC,CAAC,CAAC,CAKpB;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,CAAC,GAAG,KAAK,EAClC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CAEpB;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,CAAC,GAAG,KAAK,EACpC,MAAM,EAAE,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,EACpC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CAKpB;AAED,0CAA0C;AAC1C,wBAAgB,UAAU,CAAC,CAAC,GAAG,KAAK,EAClC,SAAS,EAAE,mBAAmB,EAC9B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAAC,CAAC,CAAC,CAGpB;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,CAAC,GAAG,KAAK,EAChC,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,eAAe,CAAC,CAAC,CAAC,CAQpB"}

package/dist/driver-mouse.js

@@ -0,0 +1,42 @@
+import { parseMouse } from './keys.js';
+function mouseMsg(button, action, col, row, options) {
+    return {
+        type: 'mouse',
+        button,
+        action,
+        col,
+        row,
+        shift: options.shift ?? false,
+        alt: options.alt ?? false,
+        ctrl: options.ctrl ?? false,
+    };
+}
+function mouseStep(mouse, delay) {
+    return delay === undefined ? { mouse } : { mouse, delay };
+}
+/** Create a scripted mouse-move step. */
+export function mouseMove(col, row, options = {}) {
+    return mouseStep(mouseMsg(options.button ?? 'none', 'move', col, row, options), options.delay);
+}
+/** Create a scripted mouse-press step. */
+export function mousePress(button, col, row, options = {}) {
+    return mouseStep(mouseMsg(button, 'press', col, row, options), options.delay);
+}
+/** Create a scripted mouse-release step. */
+export function mouseRelease(button, col, row, options = {}) {
+    return mouseStep(mouseMsg(button, 'release', col, row, options), options.delay);
+}
+/** Create a scripted mouse-wheel step. */
+export function mouseWheel(direction, col, row, options = {}) {
+    const action = direction === 'up' ? 'scroll-up' : 'scroll-down';
+    return mouseStep(mouseMsg('none', action, col, row, options), options.delay);
+}
+/** Parse an SGR mouse escape sequence into a scripted mouse step. */
+export function sgrMouse(raw, delay) {
+    const mouse = parseMouse(raw);
+    if (mouse == null) {
+        throw new Error(`sgrMouse: invalid SGR mouse sequence: ${JSON.stringify(raw)}`);
+    }
+    return mouseStep(mouse, delay);
+}
+//# sourceMappingURL=driver-mouse.js.map

package/dist/driver-mouse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-mouse.js","sourceRoot":"","sources":["../src/driver-mouse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAYvC,SAAS,QAAQ,CACf,MAAmB,EACnB,MAA0B,EAC1B,GAAW,EACX,GAAW,EACX,OAA+B;IAE/B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,MAAM;QACN,MAAM;QACN,GAAG;QACH,GAAG;QACH,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK;QAC7B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;QACzB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,KAAe,EACf,KAAc;IAEd,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,yCAAyC;AACzC,MAAM,UAAU,SAAS,CACvB,GAAW,EACX,GAAW,EACX,UAAgC,EAAE;IAElC,OAAO,SAAS,CACd,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAC7D,OAAO,CAAC,KAAK,CACd,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CACxB,MAAoC,EACpC,GAAW,EACX,GAAW,EACX,UAAkC,EAAE;IAEpC,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAChF,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,YAAY,CAC1B,MAAoC,EACpC,GAAW,EACX,GAAW,EACX,UAAkC,EAAE;IAEpC,OAAO,SAAS,CACd,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAC9C,OAAO,CAAC,KAAK,CACd,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,UAAU,CACxB,SAA8B,EAC9B,GAAW,EACX,GAAW,EACX,UAAkC,EAAE;IAEpC,MAAM,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;IAChE,OAAO,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;AAC/E,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CACtB,GAAW,EACX,KAAc;IAEd,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CACb,yCAAyC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/driver-runtime.d.ts

@@ -0,0 +1,16 @@
+import { type ClockPort, type Surface } from '@flyingrobots/bijou';
+import type { EventBus } from './eventbus.js';
+import type { App, RunOptions } from './types.js';
+import type { DriverRuntimeState, ScriptStep } from './driver-contract.js';
+export declare function createDriverRuntimeState(): DriverRuntimeState;
+export declare function isStopped(state: DriverRuntimeState): boolean;
+export declare function initialSize(ctx: RunOptions['ctx']): {
+    width: number;
+    height: number;
+};
+export declare function normalizeFrame<Model, M>(app: App<Model, M>, model: Model, size: {
+    width: number;
+    height: number;
+}): Surface;
+export declare function dispatchScriptStep<M>(bus: EventBus<M>, clock: ClockPort, state: DriverRuntimeState, step: ScriptStep<M>): Promise<boolean>;
+//# sourceMappingURL=driver-runtime.d.ts.map

package/dist/driver-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-runtime.d.ts","sourceRoot":"","sources":["../src/driver-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,OAAO,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,KAAK,EACV,GAAG,EAEH,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EACX,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAE5D;AAED,wBAAgB,WAAW,CACzB,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAKnC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,EACrC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtC,OAAO,CAET;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,GAClB,OAAO,CAAC,OAAO,CAAC,CA4BlB"}

package/dist/driver-runtime.js

@@ -0,0 +1,53 @@
+import { sleep, } from '@flyingrobots/bijou';
+import { parseKey } from './keys.js';
+import { normalizeViewOutput } from './view-output.js';
+export function createDriverRuntimeState() {
+    return { running: true, tornDown: false };
+}
+export function isStopped(state) {
+    return state.tornDown || !state.running;
+}
+export function initialSize(ctx) {
+    return {
+        width: Math.max(0, Math.floor(ctx?.runtime.columns ?? 80)),
+        height: Math.max(0, Math.floor(ctx?.runtime.rows ?? 24)),
+    };
+}
+export function normalizeFrame(app, model, size) {
+    return normalizeViewOutput(app.view(model), size).surface;
+}
+export async function dispatchScriptStep(bus, clock, state, step) {
+    if (isStopped(state))
+        return false;
+    if (step.delay != null && step.delay > 0) {
+        await sleep(clock, step.delay);
+    }
+    if (isStopped(state))
+        return false;
+    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 resize = {
+            type: 'resize',
+            columns: step.resize.columns,
+            rows: step.resize.rows,
+        };
+        bus.emit(resize);
+    }
+    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 true;
+}
+//# sourceMappingURL=driver-runtime.js.map

package/dist/driver-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-runtime.js","sourceRoot":"","sources":["../src/driver-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GAGN,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAMrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAMvD,MAAM,UAAU,wBAAwB;IACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAyB;IACjD,OAAO,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,GAAsB;IAEtB,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC1D,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;KACzD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,GAAkB,EAClB,KAAY,EACZ,IAAuC;IAEvC,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAgB,EAChB,KAAgB,EAChB,KAAyB,EACzB,IAAmB;IAEnB,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QAClB,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IACjD,CAAC;SAAM,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAc;YACxB,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;SACvB,CAAC;QACF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,CAAC;SAAM,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,KAAK,IAAI,IAAI,EAAE,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAU,IAAI,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAC1E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/driver-script-contract.d.ts

@@ -0,0 +1,73 @@
+import type { Surface } from '@flyingrobots/bijou';
+import type { MouseButton, MouseMsg, RunOptions } from './types.js';
+/** A single step in a scripted interaction sequence. */
+export type ScriptStep<M = never> = {
+    /** Key to send as a raw terminal key string. */
+    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;
+};
+/** Script step variant carrying a mouse message. */
+export type MouseScriptStep<M = never> = Extract<ScriptStep<M>, {
+    mouse: MouseMsg;
+}>;
+/** Shared modifier and delay options for scripted mouse helpers. */
+export interface MouseScriptStepOptions {
+    /** Milliseconds to wait before sending this step. Default: 0. */
+    readonly delay?: number;
+    /** Whether the Shift modifier was held. Default: false. */
+    readonly shift?: boolean;
+    /** Whether the Alt/Option modifier was held. Default: false. */
+    readonly alt?: boolean;
+    /** Whether the Ctrl modifier was held. Default: false. */
+    readonly ctrl?: boolean;
+}
+/** Options for a scripted mouse-move step. */
+export interface MouseMoveStepOptions extends MouseScriptStepOptions {
+    /** Button carried by the movement event. Default: "none". */
+    readonly button?: MouseButton;
+}
+/** Direction for scripted wheel steps. */
+export type MouseWheelDirection = 'up' | 'down';
+/** Options for a scripted run, extending the base runtime options. */
+export interface RunScriptOptions extends RunOptions {
+    /** Capture each rendered frame. */
+    onFrame?: (frame: Surface, index: number) => void;
+    /** Pulse frequency used to drive animation commands, or false to disable. */
+    pulseFps?: number | false;
+}
+/** Result returned after all scripted steps have been processed. */
+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;
+}
+//# sourceMappingURL=driver-script-contract.d.ts.map

package/dist/driver-script-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-script-contract.d.ts","sourceRoot":"","sources":["../src/driver-script-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EACV,WAAW,EACX,QAAQ,EACR,UAAU,EACX,MAAM,YAAY,CAAC;AAEpB,wDAAwD;AACxD,MAAM,MAAM,UAAU,CAAC,CAAC,GAAG,KAAK,IAC5B;IACA,gDAAgD;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACC;IACA,4BAA4B;IAC5B,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACC;IACA,2BAA2B;IAC3B,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACC;IACA,2BAA2B;IAC3B,KAAK,EAAE,QAAQ,CAAC;IAChB,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GACC;IACA,oDAAoD;IACpD,GAAG,EAAE,CAAC,CAAC;IACP,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEJ,oDAAoD;AACpD,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,KAAK,IACnC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC;AAE9C,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAqB,SAAQ,sBAAsB;IAClE,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,0CAA0C;AAC1C,MAAM,MAAM,mBAAmB,GAAG,IAAI,GAAG,MAAM,CAAC;AAEhD,sEAAsE;AACtE,MAAM,WAAW,gBAAiB,SAAQ,UAAU;IAClD,mCAAmC;IACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC3B;AAED,oEAAoE;AACpE,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC,yCAAyC;IACzC,KAAK,EAAE,KAAK,CAAC;IACb,oCAAoC;IACpC,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/driver-script-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=driver-script-contract.js.map

package/dist/driver-script-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-script-contract.js","sourceRoot":"","sources":["../src/driver-script-contract.ts"],"names":[],"mappings":""}

package/dist/driver-script.d.ts

@@ -0,0 +1,12 @@
+import type { App } from './types.js';
+import type { RunScriptOptions, RunScriptResult, ScriptStep } from './driver-contract.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 declare function runScript<Model, M>(app: App<Model, M>, steps: ScriptStep<M>[], options?: RunScriptOptions): Promise<RunScriptResult<Model>>;
+//# sourceMappingURL=driver-script.d.ts.map

package/dist/driver-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-script.d.ts","sourceRoot":"","sources":["../src/driver-script.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,UAAU,EACX,MAAM,sBAAsB,CAAC;AAS9B;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,CAAC,EACtC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,EAClB,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,EACtB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAoDjC"}