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

package/dist/css/text-style.d.ts

@@ -1,22 +1,7 @@
-import { type BijouContext, type Surface, type TokenValue } from '@flyingrobots/bijou';
-export interface StyledTextToken {
-    hex?: string;
-    bg?: string;
-    fgRGB?: [number, number, number];
-    bgRGB?: [number, number, number];
-    modifiers?: string[];
-}
-export interface BCSSIdentity {
-    type: string;
-    id?: string;
-    classes?: string[];
-}
-type BCSSStyles = Record<string, string>;
-export declare function mergeBCSSModifiers(base: readonly string[] | undefined, styles: BCSSStyles): string[] | undefined;
-export declare function toStyleToken(token: StyledTextToken): TokenValue;
-export declare function resolveBCSSTextToken(ctx: BijouContext, identity: BCSSIdentity, base?: StyledTextToken): StyledTextToken;
-export declare function styleTextWithBCSS(text: string, ctx: BijouContext | undefined, identity: BCSSIdentity, base?: StyledTextToken): string;
+import { type BijouContext, type Surface } from '@flyingrobots/bijou';
+import { type BCSSIdentity, type StyledTextToken } from './text-style-token.js';
+export { mergeBCSSModifiers, resolveBCSSTextToken, styleTextWithBCSS, toStyleToken, } from './text-style-token.js';
+export type { BCSSIdentity, StyledTextToken } from './text-style-token.js';
 export declare function createStyledTextSurfaceWithBCSS(text: string, width: number, ctx: BijouContext | undefined, identity: BCSSIdentity, base?: StyledTextToken): Surface;
 export declare function paintStyledTextSurfaceWithBCSS(surface: Surface | undefined, text: string, width: number, ctx: BijouContext | undefined, identity: BCSSIdentity, base?: StyledTextToken): Surface;
-export {};
 //# sourceMappingURL=text-style.d.ts.map

package/dist/css/text-style.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"text-style.d.ts","sourceRoot":"","sources":["../../src/css/text-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoD,KAAK,YAAY,EAAE,KAAK,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAG5J,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzC,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACnC,MAAM,EAAE,UAAU,GACjB,MAAM,EAAE,GAAG,SAAS,CAoCtB;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAE/D;AAED,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,YAAY,EACjB,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,eAAe,CAWjB;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,MAAM,CAkBR;AAyDD,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAKT;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAST"}
+{"version":3,"file":"text-style.d.ts","sourceRoot":"","sources":["../../src/css/text-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,OAAO,EACb,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAiE/B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,GACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE3E,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAKT;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,OAAO,GAAG,SAAS,EAC5B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,YAAY,GAAG,SAAS,EAC7B,QAAQ,EAAE,YAAY,EACtB,IAAI,GAAE,eAAoB,GACzB,OAAO,CAST"}

package/dist/css/text-style.js

@@ -1,77 +1,6 @@
-import { createSurface, isPackedSurface, segmentGraphemes } from '@flyingrobots/bijou';
+import { createSurface, isPackedSurface, segmentGraphemes, } from '@flyingrobots/bijou';
 import { parseHex, encodeModifiers } from '@flyingrobots/bijou/perf';
-export function mergeBCSSModifiers(base, styles) {
-    const modifiers = new Set(base ?? []);
-    const fontWeight = styles['font-weight']?.trim().toLowerCase();
-    if (fontWeight === 'bold' || fontWeight === '700' || fontWeight === '800' || fontWeight === '900') {
-        modifiers.add('bold');
-    }
-    else if (fontWeight === 'normal' || fontWeight === '400') {
-        modifiers.delete('bold');
-    }
-    const fontStyle = styles['font-style']?.trim().toLowerCase();
-    if (fontStyle === 'italic') {
-        modifiers.add('italic');
-    }
-    else if (fontStyle === 'normal') {
-        modifiers.delete('italic');
-    }
-    const decoration = styles['text-decoration']?.trim().toLowerCase();
-    if (decoration === 'none') {
-        modifiers.delete('underline');
-        modifiers.delete('curly-underline');
-        modifiers.delete('dotted-underline');
-        modifiers.delete('dashed-underline');
-        modifiers.delete('strikethrough');
-        modifiers.delete('strike');
-    }
-    else if (decoration) {
-        if (decoration.includes('underline')) {
-            modifiers.add('underline');
-        }
-        if (decoration.includes('line-through')) {
-            modifiers.add('strikethrough');
-            modifiers.delete('strike');
-        }
-    }
-    return modifiers.size > 0 ? Array.from(modifiers) : undefined;
-}
-function styleModifiers(modifiers) {
-    return modifiers?.filter((modifier) => /^(?:bold|dim|strikethrough|inverse|(?:curly-|dotted-|dashed-)?underline)$/u.test(modifier));
-}
-export function toStyleToken(token) {
-    return { hex: token.hex ?? '', bg: token.bg, fgRGB: token.fgRGB, bgRGB: token.bgRGB, modifiers: styleModifiers(token.modifiers) };
-}
-export function resolveBCSSTextToken(ctx, identity, base = {}) {
-    const styles = ctx.resolveBCSS(identity);
-    const hex = styles['color'] ?? base.hex;
-    const bg = styles['background'] ?? base.bg;
-    return {
-        hex,
-        bg,
-        fgRGB: styles['color'] != null ? (hex ? parseHex(hex) : undefined) : base.fgRGB,
-        bgRGB: styles['background'] != null ? (bg ? parseHex(bg) : undefined) : base.bgRGB,
-        modifiers: mergeBCSSModifiers(base.modifiers, styles),
-    };
-}
-export function styleTextWithBCSS(text, ctx, identity, base = {}) {
-    if (!ctx)
-        return text;
-    const styles = ctx.resolveBCSS(identity);
-    const hex = styles['color'] ?? base.hex;
-    const bg = styles['background'] ?? base.bg;
-    const token = {
-        hex,
-        bg,
-        fgRGB: styles['color'] != null ? (hex ? parseHex(hex) : undefined) : base.fgRGB,
-        bgRGB: styles['background'] != null ? (bg ? parseHex(bg) : undefined) : base.bgRGB,
-        modifiers: mergeBCSSModifiers(base.modifiers, styles),
-    };
-    if (token.hex == null && token.bg == null && (token.modifiers == null || token.modifiers.length === 0)) {
-        return text;
-    }
-    return ctx.style.styled(toStyleToken(token), text);
-}
+import { resolveBCSSTextToken, } from './text-style-token.js';
 function fillStyledText(surface, text, ctx, identity, base) {
     const safeWidth = surface.width;
     if (safeWidth === 0)
@@ -97,7 +26,9 @@ function fillStyledText(surface, text, ctx, identity, base) {
     });
     const graphemes = segmentGraphemes(text);
     const packed = isPackedSurface(surface);
-    const fg = packed ? (token.fgRGB ?? (token.hex ? parseHex(token.hex) : undefined)) : undefined;
+    const fg = packed
+        ? (token.fgRGB ?? (token.hex ? parseHex(token.hex) : undefined))
+        : undefined;
     if (packed && fg) {
         const [fR, fG, fB] = fg;
         const bg = token.bgRGB ?? (token.bg ? parseHex(token.bg) : undefined);
@@ -124,6 +55,7 @@ function fillStyledText(surface, text, ctx, identity, base) {
         }
     }
 }
+export { mergeBCSSModifiers, resolveBCSSTextToken, styleTextWithBCSS, toStyleToken, } from './text-style-token.js';
 export function createStyledTextSurfaceWithBCSS(text, width, ctx, identity, base = {}) {
     const safeWidth = Number.isFinite(width) ? Math.max(0, Math.floor(width)) : 0;
     const surface = createSurface(safeWidth, 1, { char: ' ', empty: false });

package/dist/css/text-style.js.map

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

package/dist/driver-contract.d.ts

@@ -0,0 +1,38 @@
+import type { ClockPort, Surface } from '@flyingrobots/bijou';
+import type { EventBus } from './eventbus.js';
+import type { App } from './types.js';
+import type { BusMsg } from './eventbus.js';
+import type { TestRuntimeCommandRecord, TestRuntimeCommandResolution, TestRuntimeOptions, TestRuntimeSnapshot } from './driver-harness-contract.js';
+export type { TestHarness, TestRuntimeCommandRecord, TestRuntimeCommandResolution, TestRuntimeOptions, TestRuntimeSnapshot, } from './driver-harness-contract.js';
+export type { MouseMoveStepOptions, MouseScriptStep, MouseScriptStepOptions, MouseWheelDirection, RunScriptOptions, RunScriptResult, ScriptStep, } from './driver-script-contract.js';
+export interface DriverRuntimeState {
+    running: boolean;
+    tornDown: boolean;
+}
+export interface HarnessState<Model, M> {
+    readonly app: App<Model, M>;
+    readonly options: TestRuntimeOptions | undefined;
+    readonly bus: EventBus<M>;
+    readonly clock: ClockPort;
+    readonly start: number;
+    readonly runtime: DriverRuntimeState;
+    readonly frames: Surface[];
+    readonly snapshots: TestRuntimeSnapshot<Model, M>[];
+    readonly messages: BusMsg<M>[];
+    readonly emittedMessages: M[];
+    readonly commands: MutableCommandRecord<M>[];
+    model: Model;
+    currentSize: {
+        width: number;
+        height: number;
+    };
+    nextCommandId: number;
+}
+export interface MutableCommandRecord<M> extends TestRuntimeCommandRecord<M> {
+    emitted: M[];
+    resolution: TestRuntimeCommandResolution;
+    result?: unknown;
+    cleanedUp: boolean;
+    settled: boolean;
+}
+//# sourceMappingURL=driver-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-contract.d.ts","sourceRoot":"","sources":["../src/driver-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,OAAO,EACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EACV,GAAG,EACJ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EACV,WAAW,EACX,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY,CAAC,KAAK,EAAE,CAAC;IACpC,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC;IACpD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,CAAC,EAAE,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,CACrC,SAAQ,wBAAwB,CAAC,CAAC,CAAC;IACnC,OAAO,EAAE,CAAC,EAAE,CAAC;IACb,UAAU,EAAE,4BAA4B,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/driver-contract.js

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

package/dist/driver-contract.js.map

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

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

@@ -0,0 +1,4 @@
+import type { HarnessState, TestHarness } from './driver-contract.js';
+/** Bind mutable harness state behind the public read-only test API. */
+export declare function createHarnessApi<Model, M>(state: HarnessState<Model, M>): TestHarness<Model, M>;
+//# sourceMappingURL=driver-harness-api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-api.d.ts","sourceRoot":"","sources":["../src/driver-harness-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAS9B,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,CAAC,EACvC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,GAC5B,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAiCvB"}

package/dist/driver-harness-api.js

@@ -0,0 +1,34 @@
+import { latestSnapshot, processHarnessStep, settleHarness, teardownHarness, } from './driver-harness-state.js';
+import { isStopped } from './driver-runtime.js';
+/** Bind mutable harness state behind the public read-only test API. */
+export function createHarnessApi(state) {
+    return {
+        get model() { return state.model; },
+        get frame() { return latestSnapshot(state).frame; },
+        get frames() { return state.frames; },
+        get snapshots() { return state.snapshots; },
+        get messages() { return state.messages; },
+        get emittedMessages() { return state.emittedMessages; },
+        get commands() { return state.commands; },
+        get elapsed() { return state.clock.now() - state.start; },
+        get running() { return !isStopped(state.runtime); },
+        snapshot: () => latestSnapshot(state),
+        settle: () => settleHarness(state),
+        step: (step) => processHarnessStep(state, step),
+        async run(steps) {
+            for (const step of steps) {
+                if (isStopped(state.runtime))
+                    break;
+                await processHarnessStep(state, step);
+            }
+            return settleHarness(state);
+        },
+        press: (key, delay = 0) => processHarnessStep(state, { key, delay }),
+        resize: (columns, rows, delay = 0) => processHarnessStep(state, { resize: { columns, rows }, delay }),
+        pulse: (dt, delay = 0) => processHarnessStep(state, { pulse: { dt }, delay }),
+        mouse: (mouse, delay = 0) => processHarnessStep(state, { mouse, delay }),
+        emit: (msg, delay = 0) => processHarnessStep(state, { msg, delay }),
+        teardown: () => teardownHarness(state),
+    };
+}
+//# sourceMappingURL=driver-harness-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-api.js","sourceRoot":"","sources":["../src/driver-harness-api.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAC9B,KAA6B;IAE7B,OAAO;QACL,IAAI,KAAK,KAAK,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACnC,IAAI,KAAK,KAAK,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QACnD,IAAI,MAAM,KAAK,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,IAAI,SAAS,KAAK,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;QAC3C,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,IAAI,eAAe,KAAK,OAAO,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzC,IAAI,OAAO,KAAK,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACzD,IAAI,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnD,QAAQ,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;QACrC,MAAM,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC;QAClC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC;QAC/C,KAAK,CAAC,GAAG,CAAC,KAAK;YACb,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC;oBAAE,MAAM;gBACpC,MAAM,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CACxB,kBAAkB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CACnC,kBAAkB,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;QACjE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CACvB,kBAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QACrD,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CAC1B,kBAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,CAAC,EAAE,EAAE,CACvB,kBAAkB,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;QAC3C,QAAQ,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC;KACvC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+import { type Cmd } from './types.js';
+import type { HarnessState } from './driver-contract.js';
+/** Wrap a command with observable settlement and cleanup facts. */
+export declare function observeCommand<Model, M>(state: HarnessState<Model, M>, cmd: Cmd<M>, source: 'init' | 'update', triggerIndex: number | null): Cmd<M>;
+//# sourceMappingURL=driver-harness-command.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver-harness-command.d.ts","sourceRoot":"","sources":["../src/driver-harness-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,GAAG,EACT,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EACV,YAAY,EAEb,MAAM,sBAAsB,CAAC;AAE9B,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,CAAC,EACrC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,EAC7B,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EACX,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,YAAY,EAAE,MAAM,GAAG,IAAI,GAC1B,GAAG,CAAC,CAAC,CAAC,CAuDR"}

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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"}