@rezi-ui/core 0.1.0-alpha.60 → 0.1.0-alpha.68

package/dist/testing/referenceScenarios/virtualListResizeStorm.js

@@ -0,0 +1,88 @@
+import { ui } from "../../ui.js";
+export const referenceVirtualListResizeStormScenario = Object.freeze({
+    schemaVersion: 1,
+    id: "virtual-list-resize-storm-stays-interactive",
+    title: "Virtual list stays interactive through a resize storm",
+    widgetFamily: "table-tree-virtual-list",
+    behaviorStatement: "Repeated viewport changes must not wedge a virtual list; later keyboard navigation and activation still work.",
+    evidenceRefs: Object.freeze([
+        "docs/widgets/virtual-list.md",
+        "docs/terminal-io-contract.md",
+        "packages/core/src/widgets/__tests__/virtualList.contract.test.ts",
+        "packages/core/src/app/__tests__/widgetBehavior.contracts.test.ts",
+    ]),
+    viewport: Object.freeze({ cols: 40, rows: 10 }),
+    theme: Object.freeze({ mode: "named", value: "default" }),
+    capabilityProfile: Object.freeze({
+        supportsMouse: false,
+        supportsBracketedPaste: false,
+        supportsFocusEvents: false,
+        supportsOsc52: false,
+        colorMode: "none",
+    }),
+    scriptedInput: Object.freeze([
+        Object.freeze({ atMs: 0, event: Object.freeze({ kind: "resize", cols: 52, rows: 12 }) }),
+        Object.freeze({ atMs: 10, event: Object.freeze({ kind: "resize", cols: 34, rows: 8 }) }),
+        Object.freeze({ atMs: 20, event: Object.freeze({ kind: "resize", cols: 60, rows: 14 }) }),
+        Object.freeze({ atMs: 30, event: Object.freeze({ kind: "resize", cols: 40, rows: 10 }) }),
+        Object.freeze({ atMs: 60, event: Object.freeze({ kind: "key", key: "down" }) }),
+        Object.freeze({ atMs: 70, event: Object.freeze({ kind: "key", key: "enter" }) }),
+    ]),
+    expectedScreenCheckpoints: Object.freeze([
+        Object.freeze({
+            id: "activation-after-resize-storm",
+            afterStep: 6,
+            assertionRef: "screen_region_assertion",
+            args: Object.freeze({
+                x: 0,
+                y: 0,
+                width: 40,
+                height: 2,
+                match: "includes",
+                text: Object.freeze(["Activated:1"]),
+            }),
+        }),
+    ]),
+    invariants: Object.freeze([
+        Object.freeze({
+            id: "no-ghost-activation",
+            assertionRef: "invariant_assertion",
+            args: Object.freeze({
+                kind: "action_absence",
+                action: Object.freeze({
+                    id: "missing-list-action",
+                    action: "press",
+                }),
+            }),
+        }),
+    ]),
+    fidelityRequirement: "terminal-real",
+    notes: "The oracle stays behavior-first: later activation must still work after repeated resizes, without asserting exact row geometry during the storm.",
+});
+export const createReferenceVirtualListResizeStormFixture = () => {
+    let app;
+    const items = Object.freeze(Array.from({ length: 100 }, (_, index) => index));
+    return Object.freeze({
+        initialState: Object.freeze({ activated: "-" }),
+        setup(nextApp) {
+            app = nextApp;
+        },
+        view(state) {
+            return ui.focusTrap({ id: "resize-trap", active: true, initialFocus: "list" }, [
+                ui.column({}, [
+                    ui.text(`Activated:${state.activated}`),
+                    ui.virtualList({
+                        id: "list",
+                        items,
+                        itemHeight: 1,
+                        renderItem: (item, _index, focused) => ui.text(focused ? `> ${String(item)}` : String(item)),
+                        onSelect: (item) => {
+                            app.update({ activated: String(item) });
+                        },
+                    }),
+                ]),
+            ]);
+        },
+    });
+};
+//# sourceMappingURL=virtualListResizeStorm.js.map

package/dist/testing/referenceScenarios/virtualListResizeStorm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtualListResizeStorm.js","sourceRoot":"","sources":["../../../src/testing/referenceScenarios/virtualListResizeStorm.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAOjC,MAAM,CAAC,MAAM,uCAAuC,GAAuB,MAAM,CAAC,MAAM,CAAC;IACvF,aAAa,EAAE,CAAC;IAChB,EAAE,EAAE,6CAA6C;IACjD,KAAK,EAAE,uDAAuD;IAC9D,YAAY,EAAE,yBAAyB;IACvC,iBAAiB,EACf,+GAA+G;IACjH,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;QAC1B,8BAA8B;QAC9B,8BAA8B;QAC9B,kEAAkE;QAClE,kEAAkE;KACnE,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC/C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACzD,iBAAiB,EAAE,MAAM,CAAC,MAAM,CAAC;QAC/B,aAAa,EAAE,KAAK;QACpB,sBAAsB,EAAE,KAAK;QAC7B,mBAAmB,EAAE,KAAK;QAC1B,aAAa,EAAE,KAAK;QACpB,SAAS,EAAE,MAAM;KAClB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC;QAC3B,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;QACzF,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;KACjF,CAAC;IACF,yBAAyB,EAAE,MAAM,CAAC,MAAM,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,+BAA+B;YACnC,SAAS,EAAE,CAAC;YACZ,YAAY,EAAE,yBAAyB;YACvC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;gBAClB,CAAC,EAAE,CAAC;gBACJ,CAAC,EAAE,CAAC;gBACJ,KAAK,EAAE,EAAE;gBACT,MAAM,EAAE,CAAC;gBACT,KAAK,EAAE,UAAU;gBACjB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;aACrC,CAAC;SACH,CAAC;KACH,CAAC;IACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;QACxB,MAAM,CAAC,MAAM,CAAC;YACZ,EAAE,EAAE,qBAAqB;YACzB,YAAY,EAAE,qBAAqB;YACnC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;gBAClB,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;oBACpB,EAAE,EAAE,qBAAqB;oBACzB,MAAM,EAAE,OAAO;iBAChB,CAAC;aACH,CAAC;SACH,CAAC;KACH,CAAC;IACF,mBAAmB,EAAE,eAAe;IACpC,KAAK,EACH,kJAAkJ;CACrJ,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,4CAA4C,GAErD,GAAG,EAAE;IACP,IAAI,GAAsC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC/C,KAAK,CAAC,OAAO;YACX,GAAG,GAAG,OAAO,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,KAAK;YACR,OAAO,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE;gBAC7E,EAAE,CAAC,MAAM,CAAC,EAAE,EAAE;oBACZ,EAAE,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,SAAS,EAAE,CAAC;oBACvC,EAAE,CAAC,WAAW,CAAC;wBACb,EAAE,EAAE,MAAM;wBACV,KAAK;wBACL,UAAU,EAAE,CAAC;wBACb,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,CACpC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;wBACvD,QAAQ,EAAE,CAAC,IAAY,EAAE,EAAE;4BACzB,GAAG,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;wBAC1C,CAAC;qBACF,CAAC;iBACH,CAAC;aACH,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/testing/replayScenario.d.ts

@@ -0,0 +1,6 @@
+import { type ScenarioDefinition, type ScenarioFixtureFactory, type ScenarioRunResult } from "./scenario.js";
+export declare function runReplayScenario<S>(opts: Readonly<{
+    scenario: ScenarioDefinition;
+    createFixture: ScenarioFixtureFactory<S>;
+}>): Promise<ScenarioRunResult>;
+//# sourceMappingURL=replayScenario.d.ts.map

package/dist/testing/replayScenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayScenario.d.ts","sourceRoot":"","sources":["../../src/testing/replayScenario.ts"],"names":[],"mappings":"AA6CA,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,sBAAsB,EAE3B,KAAK,iBAAiB,EAIvB,MAAM,eAAe,CAAC;AA2RvB,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,IAAI,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,aAAa,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;CAC1C,CAAC,GACD,OAAO,CAAC,iBAAiB,CAAC,CAkK5B"}

package/dist/testing/replayScenario.js

@@ -0,0 +1,399 @@
+import { ZR_KEY_BACKSPACE, ZR_KEY_DELETE, ZR_KEY_DOWN, ZR_KEY_END, ZR_KEY_ENTER, ZR_KEY_ESCAPE, ZR_KEY_F1, ZR_KEY_F2, ZR_KEY_F3, ZR_KEY_F4, ZR_KEY_F5, ZR_KEY_F6, ZR_KEY_F7, ZR_KEY_F8, ZR_KEY_F9, ZR_KEY_F10, ZR_KEY_F11, ZR_KEY_F12, ZR_KEY_HOME, ZR_KEY_LEFT, ZR_KEY_PAGE_DOWN, ZR_KEY_PAGE_UP, ZR_KEY_RIGHT, ZR_KEY_SPACE, ZR_KEY_TAB, ZR_KEY_UP, ZR_MOD_ALT, ZR_MOD_CTRL, ZR_MOD_META, ZR_MOD_SHIFT, charToKeyCode, } from "../keybindings/keyCodes.js";
+import { runReproReplayHarness, } from "../repro/index.js";
+import { DEFAULT_TERMINAL_CAPS } from "../terminalCaps.js";
+import { defaultTheme } from "../theme/defaultTheme.js";
+import { compileTheme } from "../theme/theme.js";
+import { evaluateScenarioResult } from "./assertions.js";
+import { encodeZrevBatchV1 } from "./events.js";
+import { createTestRenderer } from "./renderer.js";
+import { createScenarioScreenSnapshot, } from "./scenario.js";
+function colorModeToCapsColor(mode) {
+    if (mode === "16")
+        return 1;
+    if (mode === "256")
+        return 2;
+    if (mode === "truecolor")
+        return 3;
+    return 0;
+}
+function toTerminalCaps(profile) {
+    return Object.freeze({
+        ...DEFAULT_TERMINAL_CAPS,
+        colorMode: colorModeToCapsColor(profile.colorMode),
+        supportsMouse: profile.supportsMouse,
+        supportsBracketedPaste: profile.supportsBracketedPaste,
+        supportsFocusEvents: profile.supportsFocusEvents,
+        supportsOsc52: profile.supportsOsc52,
+        supportsCursorShape: true,
+    });
+}
+function keyNameToCode(key) {
+    if (typeof key === "number")
+        return key;
+    const normalized = key.trim().toLowerCase();
+    if (normalized.length === 1)
+        return charToKeyCode(normalized) ?? 0;
+    const functionKey = /^f(\d{1,2})$/u.exec(normalized);
+    if (functionKey) {
+        const functionKeyCodes = [
+            ZR_KEY_F1,
+            ZR_KEY_F2,
+            ZR_KEY_F3,
+            ZR_KEY_F4,
+            ZR_KEY_F5,
+            ZR_KEY_F6,
+            ZR_KEY_F7,
+            ZR_KEY_F8,
+            ZR_KEY_F9,
+            ZR_KEY_F10,
+            ZR_KEY_F11,
+            ZR_KEY_F12,
+        ];
+        const index = Number(functionKey[1]) - 1;
+        const code = functionKeyCodes[index];
+        if (code !== undefined)
+            return code;
+    }
+    switch (normalized) {
+        case "enter":
+        case "return":
+            return ZR_KEY_ENTER;
+        case "escape":
+        case "esc":
+            return ZR_KEY_ESCAPE;
+        case "tab":
+            return ZR_KEY_TAB;
+        case "space":
+            return ZR_KEY_SPACE;
+        case "backspace":
+            return ZR_KEY_BACKSPACE;
+        case "delete":
+        case "del":
+            return ZR_KEY_DELETE;
+        case "home":
+            return ZR_KEY_HOME;
+        case "end":
+            return ZR_KEY_END;
+        case "pageup":
+            return ZR_KEY_PAGE_UP;
+        case "pagedown":
+            return ZR_KEY_PAGE_DOWN;
+        case "left":
+            return ZR_KEY_LEFT;
+        case "right":
+            return ZR_KEY_RIGHT;
+        case "up":
+            return ZR_KEY_UP;
+        case "down":
+            return ZR_KEY_DOWN;
+        default:
+            throw new Error(`Unsupported replay scenario key ${JSON.stringify(key)}`);
+    }
+}
+function keyModsToMask(mods) {
+    let mask = 0;
+    for (const mod of mods ?? []) {
+        if (mod === "shift")
+            mask |= ZR_MOD_SHIFT;
+        else if (mod === "ctrl")
+            mask |= ZR_MOD_CTRL;
+        else if (mod === "alt")
+            mask |= ZR_MOD_ALT;
+        else if (mod === "meta")
+            mask |= ZR_MOD_META;
+    }
+    return mask;
+}
+function eventToZrevEvents(event) {
+    switch (event.kind) {
+        case "text":
+            return Object.freeze(Array.from(event.text).map((glyph) => ({
+                kind: "text",
+                timeMs: 1,
+                codepoint: glyph.codePointAt(0) ?? 0,
+            })));
+        case "paste":
+            return Object.freeze([
+                {
+                    kind: "paste",
+                    timeMs: 1,
+                    bytes: new TextEncoder().encode(event.text),
+                },
+            ]);
+        case "resize":
+            return Object.freeze([
+                {
+                    kind: "resize",
+                    timeMs: 1,
+                    cols: event.cols,
+                    rows: event.rows,
+                },
+            ]);
+        case "terminalBytes":
+            throw new Error("Replay scenarios do not support terminalBytes input");
+        case "key":
+            return Object.freeze([
+                {
+                    kind: "key",
+                    timeMs: 1,
+                    key: keyNameToCode(event.key),
+                    mods: keyModsToMask(event.mods),
+                    action: "down",
+                },
+            ]);
+    }
+}
+function bytesToHex(bytes) {
+    let out = "";
+    for (const byte of bytes)
+        out += byte.toString(16).padStart(2, "0");
+    return out;
+}
+function resizeEventsFrom(event) {
+    if (event.kind !== "resize")
+        return Object.freeze([]);
+    return Object.freeze([
+        Object.freeze({ eventIndex: 0, cols: event.cols, rows: event.rows, timeMs: 1 }),
+    ]);
+}
+function toReplayExpectedActions(expected) {
+    const out = [];
+    for (const action of expected ?? []) {
+        if (action.action === "press") {
+            out.push(Object.freeze({ id: action.id, action: "press" }));
+            continue;
+        }
+        if (action.action === "input") {
+            out.push(Object.freeze({
+                id: action.id,
+                action: "input",
+                value: action.value,
+                cursor: action.cursor,
+            }));
+            continue;
+        }
+        throw new Error(`Replay scenario runner supports only press/input expectedActions (got ${action.action})`);
+    }
+    return Object.freeze(out);
+}
+function toScenarioAction(action) {
+    if (action.action === "input") {
+        return Object.freeze({
+            id: action.id,
+            action: "input",
+            value: action.value,
+            cursor: action.cursor,
+        });
+    }
+    return Object.freeze({ id: action.id, action: "press" });
+}
+function createReplayBundle(scenario) {
+    let previousAtMs = 0;
+    const batches = scenario.scriptedInput.map((step, index) => {
+        const deltaMs = Math.max(0, step.atMs - previousAtMs);
+        previousAtMs = step.atMs;
+        const encodedEvents = eventToZrevEvents(step.event);
+        const bytes = encodeZrevBatchV1({ events: encodedEvents });
+        return Object.freeze({
+            step: index + 1,
+            deltaMs,
+            byteLength: bytes.byteLength,
+            bytesHex: bytesToHex(bytes),
+            eventCount: encodedEvents.length,
+            droppedBatches: 0,
+            resizeEvents: resizeEventsFrom(step.event),
+        });
+    });
+    return Object.freeze({
+        schema: "rezi-repro-v1",
+        captureConfig: Object.freeze({
+            captureRawEvents: true,
+            captureDrawlistBytes: false,
+            maxEventBytes: 1 << 20,
+            maxDrawlistBytes: 0,
+            maxFrames: 1024,
+            fpsCap: 60,
+            cursorProtocolVersion: 2,
+        }),
+        capsSnapshot: Object.freeze({
+            terminalCaps: toTerminalCaps(scenario.capabilityProfile),
+            backendCaps: Object.freeze({
+                maxEventBytes: 1 << 20,
+                fpsCap: 60,
+                cursorProtocolVersion: 2,
+            }),
+        }),
+        timingModel: Object.freeze({
+            kind: "deterministic",
+            clock: "monotonic-ms",
+            replayStrategy: "recorded-delta",
+            timeUnit: "ms",
+            baseTimeMs: 0,
+        }),
+        eventCapture: Object.freeze({
+            ordering: "poll-order",
+            timing: "step-delta-ms",
+            bounds: Object.freeze({
+                maxBatches: Math.max(1, batches.length),
+                maxEvents: Math.max(1, batches.reduce((sum, item) => sum + item.eventCount, 0)),
+                maxBytes: Math.max(1, batches.reduce((sum, item) => sum + item.byteLength, 0)),
+            }),
+            totals: Object.freeze({
+                capturedBatches: batches.length,
+                capturedEvents: batches.reduce((sum, item) => sum + item.eventCount, 0),
+                capturedBytes: batches.reduce((sum, item) => sum + item.byteLength, 0),
+                runtimeDroppedBatches: 0,
+                omittedBatches: 0,
+                omittedEvents: 0,
+                omittedBytes: 0,
+            }),
+            truncation: Object.freeze({
+                mode: "drop-tail-batch",
+                truncated: false,
+                reason: null,
+                firstOmittedStep: null,
+            }),
+            batches: Object.freeze(batches),
+        }),
+    });
+}
+export async function runReplayScenario(opts) {
+    if (opts.scenario.scriptedInput.some((step) => step.event.kind === "terminalBytes")) {
+        return Object.freeze({
+            mode: "replay",
+            status: "FAIL",
+            pass: false,
+            actions: Object.freeze([]),
+            steps: Object.freeze([]),
+            finalScreen: createScenarioScreenSnapshot(opts.scenario.viewport, ""),
+            finalCursor: null,
+            mismatches: Object.freeze([
+                Object.freeze({
+                    code: "ZR_SCENARIO_UNSUPPORTED",
+                    path: "scriptedInput",
+                    detail: "Replay scenarios do not support terminalBytes input; use PTY mode",
+                }),
+            ]),
+        });
+    }
+    const fixture = opts.createFixture();
+    const compiledTheme = compileTheme(fixture.theme ?? defaultTheme.definition);
+    const renderer = createTestRenderer({
+        viewport: opts.scenario.viewport,
+        theme: fixture.theme ?? defaultTheme.definition,
+    });
+    async function captureStateAfterSteps(stepCount) {
+        const prefixFixture = opts.createFixture();
+        let finalState = prefixFixture.initialState;
+        const prefixReplayResult = await runReproReplayHarness({
+            bundle: createReplayBundle({
+                ...opts.scenario,
+                scriptedInput: Object.freeze(opts.scenario.scriptedInput.slice(0, stepCount)),
+            }),
+            view: () => prefixFixture.view(prefixFixture.initialState),
+            initialState: prefixFixture.initialState,
+            statefulView: (state) => prefixFixture.view(state),
+            ...(prefixFixture.setup !== undefined
+                ? {
+                    setupApp: (app) => {
+                        prefixFixture.setup?.(app);
+                    },
+                }
+                : {}),
+            ...(stepCount > 0
+                ? {
+                    onCompleteState: (state) => {
+                        finalState = state;
+                    },
+                }
+                : {}),
+            initialViewport: opts.scenario.viewport,
+            theme: compiledTheme,
+            expectedActions: Object.freeze([]),
+        });
+        let viewport = { ...opts.scenario.viewport };
+        for (const scriptedStep of opts.scenario.scriptedInput.slice(0, stepCount)) {
+            if (scriptedStep.event.kind === "resize") {
+                viewport = { cols: scriptedStep.event.cols, rows: scriptedStep.event.rows };
+            }
+        }
+        return Object.freeze({
+            viewport,
+            state: finalState,
+            actions: Object.freeze(prefixReplayResult.replay.actions.map((action) => toScenarioAction(action))),
+        });
+    }
+    const replayResult = await runReproReplayHarness({
+        bundle: createReplayBundle(opts.scenario),
+        view: () => fixture.view(fixture.initialState),
+        initialState: fixture.initialState,
+        statefulView: (state) => fixture.view(state),
+        ...(fixture.setup !== undefined
+            ? {
+                setupApp: (app) => {
+                    fixture.setup?.(app);
+                },
+            }
+            : {}),
+        initialViewport: opts.scenario.viewport,
+        theme: compiledTheme,
+        expectedActions: toReplayExpectedActions(opts.scenario.expectedActions),
+        invariants: { noFatal: true, noOverrun: true },
+    });
+    const replayActionsWithSteps = replayResult.replay.actions.map((action) => Object.freeze({
+        step: action.step,
+        action: toScenarioAction(action),
+    }));
+    const scenarioActions = Object.freeze(replayActionsWithSteps.map((item) => item.action));
+    const steps = [];
+    for (let index = 0; index < opts.scenario.scriptedInput.length; index += 1) {
+        const step = index + 1;
+        const stepState = await captureStateAfterSteps(step);
+        const text = renderer
+            .render(fixture.view(stepState.state), {
+            viewport: stepState.viewport,
+            theme: fixture.theme ?? defaultTheme.definition,
+            focusedId: null,
+        })
+            .toText();
+        steps.push(Object.freeze({
+            step,
+            screen: createScenarioScreenSnapshot(stepState.viewport, text),
+            cursor: null,
+            actions: stepState.actions,
+        }));
+    }
+    const finalScreen = (() => {
+        const finalStep = steps.at(-1);
+        if (finalStep !== undefined)
+            return finalStep.screen;
+        return createScenarioScreenSnapshot(opts.scenario.viewport, renderer
+            .render(fixture.view(fixture.initialState), {
+            viewport: opts.scenario.viewport,
+            theme: fixture.theme ?? defaultTheme.definition,
+            focusedId: null,
+        })
+            .toText());
+    })();
+    const result = evaluateScenarioResult(opts.scenario, {
+        mode: "replay",
+        actions: scenarioActions,
+        steps: Object.freeze(steps),
+        finalScreen,
+        finalCursor: null,
+    });
+    if (opts.scenario.expectedCursorState === undefined)
+        return result;
+    const mismatch = Object.freeze({
+        code: "ZR_SCENARIO_UNSUPPORTED",
+        path: "expectedCursorState",
+        detail: "Replay scenario runner does not capture live cursor state; use semantic or PTY mode for cursor-dependent scenarios",
+    });
+    return Object.freeze({
+        ...result,
+        status: "FAIL",
+        pass: false,
+        mismatches: Object.freeze([...result.mismatches, mismatch]),
+    });
+}
+//# sourceMappingURL=replayScenario.js.map

package/dist/testing/replayScenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayScenario.js","sourceRoot":"","sources":["../../src/testing/replayScenario.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,WAAW,EACX,WAAW,EACX,YAAY,EACZ,aAAa,GACd,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,qBAAqB,EAAqB,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,EAAsB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EASL,4BAA4B,GAC7B,MAAM,eAAe,CAAC;AAEvB,SAAS,oBAAoB,CAC3B,IAA4C;IAE5C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAC5B,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,WAAW;QAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,cAAc,CAAC,OAAkC;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,qBAAqB;QACxB,SAAS,EAAE,oBAAoB,CAAC,OAAO,CAAC,SAAS,CAAC;QAClD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;QACtD,mBAAmB,EAAE,OAAO,CAAC,mBAAmB;QAChD,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,mBAAmB,EAAE,IAAI;KAC1B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,GAAoB;IACzC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,gBAAgB,GAAG;YACvB,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,SAAS;YACT,UAAU;YACV,UAAU;YACV,UAAU;SACF,CAAC;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;IACtC,CAAC;IACD,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC;QACb,KAAK,QAAQ;YACX,OAAO,YAAY,CAAC;QACtB,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK;YACR,OAAO,aAAa,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,WAAW;YACd,OAAO,gBAAgB,CAAC;QAC1B,KAAK,QAAQ,CAAC;QACd,KAAK,KAAK;YACR,OAAO,aAAa,CAAC;QACvB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,UAAU,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,cAAc,CAAC;QACxB,KAAK,UAAU;YACb,OAAO,gBAAgB,CAAC;QAC1B,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB,KAAK,IAAI;YACP,OAAO,SAAS,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,WAAW,CAAC;QACrB;YACE,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAmC;IACxD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,GAAG,IAAI,IAAI,IAAI,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,KAAK,OAAO;YAAE,IAAI,IAAI,YAAY,CAAC;aACrC,IAAI,GAAG,KAAK,MAAM;YAAE,IAAI,IAAI,WAAW,CAAC;aACxC,IAAI,GAAG,KAAK,KAAK;YAAE,IAAI,IAAI,UAAU,CAAC;aACtC,IAAI,GAAG,KAAK,MAAM;YAAE,IAAI,IAAI,WAAW,CAAC;IAC/C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAiC;IAC1D,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC,MAAM,CAClB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACrC,IAAI,EAAE,MAAe;gBACrB,MAAM,EAAE,CAAC;gBACT,SAAS,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;aACrC,CAAC,CAAC,CACJ,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB;oBACE,IAAI,EAAE,OAAgB;oBACtB,MAAM,EAAE,CAAC;oBACT,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;iBAC5C;aACF,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB;oBACE,IAAI,EAAE,QAAiB;oBACvB,MAAM,EAAE,CAAC;oBACT,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF,CAAC,CAAC;QACL,KAAK,eAAe;YAClB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB;oBACE,IAAI,EAAE,KAAc;oBACpB,MAAM,EAAE,CAAC;oBACT,GAAG,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC;oBAC7B,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC;oBAC/B,MAAM,EAAE,MAAM;iBACf;aACF,CAAC,CAAC;IACP,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAiC;IAMzD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;KAChF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,QAAuD;IAEvD,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,MAAM,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QACpC,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC9B,GAAG,CAAC,IAAI,CACN,MAAM,CAAC,MAAM,CAAC;gBACZ,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,MAAM,EAAE,OAAO;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CACH,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,IAAI,KAAK,CACb,yEAAyE,MAAM,CAAC,MAAM,GAAG,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CACvB,MAUM;IAEN,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,MAAM,EAAE,OAAgB;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,OAAgB,EAAE,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA4B;IACtD,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,CAAC;QACtD,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;QACzB,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,KAAK,GAAG,CAAC;YACf,OAAO;YACP,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,UAAU,CAAC,KAAK,CAAC;YAC3B,UAAU,EAAE,aAAa,CAAC,MAAM;YAChC,cAAc,EAAE,CAAC;YACjB,YAAY,EAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,eAAe;QACvB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC;YAC3B,gBAAgB,EAAE,IAAI;YACtB,oBAAoB,EAAE,KAAK;YAC3B,aAAa,EAAE,CAAC,IAAI,EAAE;YACtB,gBAAgB,EAAE,CAAC;YACnB,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,EAAE;YACV,qBAAqB,EAAE,CAAC;SACzB,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,YAAY,EAAE,cAAc,CAAC,QAAQ,CAAC,iBAAiB,CAAC;YACxD,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;gBACzB,aAAa,EAAE,CAAC,IAAI,EAAE;gBACtB,MAAM,EAAE,EAAE;gBACV,qBAAqB,EAAE,CAAC;aACzB,CAAC;SACH,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,CAAC;YACzB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,cAAc;YACrB,cAAc,EAAE,gBAAgB;YAChC,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,CAAC;SACd,CAAC;QACF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC1B,QAAQ,EAAE,YAAY;YACtB,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACpB,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC;gBACvC,SAAS,EAAE,IAAI,CAAC,GAAG,CACjB,CAAC,EACD,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CACxD;gBACD,QAAQ,EAAE,IAAI,CAAC,GAAG,CAChB,CAAC,EACD,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CACxD;aACF,CAAC;YACF,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;gBACpB,eAAe,EAAE,OAAO,CAAC,MAAM;gBAC/B,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvE,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;gBACtE,qBAAqB,EAAE,CAAC;gBACxB,cAAc,EAAE,CAAC;gBACjB,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;aAChB,CAAC;YACF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,IAAI,EAAE,iBAAiB;gBACvB,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,IAAI;gBACZ,gBAAgB,EAAE,IAAI;aACvB,CAAC;YACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;SAChC,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAGE;IAEF,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,eAAe,CAAC,EAAE,CAAC;QACpF,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxB,WAAW,EAAE,4BAA4B,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;YACrE,WAAW,EAAE,IAAI;YACjB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC;gBACxB,MAAM,CAAC,MAAM,CAAC;oBACZ,IAAI,EAAE,yBAAkC;oBACxC,IAAI,EAAE,eAAe;oBACrB,MAAM,EAAE,mEAAmE;iBAC5E,CAAC;aACH,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;IACrC,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7E,MAAM,QAAQ,GAAG,kBAAkB,CAAC;QAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;QAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,UAAU;KAChD,CAAC,CAAC;IAEH,KAAK,UAAU,sBAAsB,CAAC,SAAiB;QAOrD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAC3C,IAAI,UAAU,GAAG,aAAa,CAAC,YAAY,CAAC;QAC5C,MAAM,kBAAkB,GAAG,MAAM,qBAAqB,CAAC;YACrD,MAAM,EAAE,kBAAkB,CAAC;gBACzB,GAAG,IAAI,CAAC,QAAQ;gBAChB,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;aAC9E,CAAC;YACF,IAAI,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;YAC1D,YAAY,EAAE,aAAa,CAAC,YAAY;YACxC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,KAAoB,CAAC;YACjE,GAAG,CAAC,aAAa,CAAC,KAAK,KAAK,SAAS;gBACnC,CAAC,CAAC;oBACE,QAAQ,EAAE,CAAC,GAAyC,EAAE,EAAE;wBACtD,aAAa,CAAC,KAAK,EAAE,CAAC,GAAwB,CAAC,CAAC;oBAClD,CAAC;iBACF;gBACH,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,SAAS,GAAG,CAAC;gBACf,CAAC,CAAE;oBACC,eAAe,EAAE,CAAC,KAAc,EAAE,EAAE;wBAClC,UAAU,GAAG,KAAoB,CAAC;oBACpC,CAAC;iBAGD;gBACJ,CAAC,CAAC,EAAE,CAAC;YACP,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YACvC,KAAK,EAAE,aAAa;YACpB,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;SACnC,CAAC,CAAC;QAEH,IAAI,QAAQ,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC7C,KAAK,MAAM,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC;YAC3E,IAAI,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACzC,QAAQ,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YAC9E,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,QAAQ;YACR,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,MAAM,CAAC,MAAM,CACpB,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAC5E;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,qBAAqB,CAAC;QAC/C,MAAM,EAAE,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC;QACzC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC;QAC9C,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAoB,CAAC;QAC3D,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAC7B,CAAC,CAAC;gBACE,QAAQ,EAAE,CAAC,GAAyC,EAAE,EAAE;oBACtD,OAAO,CAAC,KAAK,EAAE,CAAC,GAAwB,CAAC,CAAC;gBAC5C,CAAC;aACF;YACH,CAAC,CAAC,EAAE,CAAC;QACP,eAAe,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;QACvC,KAAK,EAAE,aAAa;QACpB,eAAe,EAAE,uBAAuB,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;QACvE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;KAC/C,CAAC,CAAC;IAEH,MAAM,sBAAsB,GAAG,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACxE,MAAM,CAAC,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,gBAAgB,CAAC,MAAM,CAAC;KACjC,CAAC,CACH,CAAC;IACF,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAEzF,MAAM,KAAK,GAA8B,EAAE,CAAC;IAC5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC;QACvB,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,QAAQ;aAClB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;YACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,UAAU;YAC/C,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI;YACJ,MAAM,EAAE,4BAA4B,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC;YAC9D,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE,SAAS,CAAC,OAAO;SAC3B,CAAC,CACH,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;QACxB,MAAM,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC,MAAM,CAAC;QACrD,OAAO,4BAA4B,CACjC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EACtB,QAAQ;aACL,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAChC,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,UAAU;YAC/C,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,MAAM,EAAE,CACZ,CAAC;IACJ,CAAC,CAAC,EAAE,CAAC;IAEL,MAAM,MAAM,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE;QACnD,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC3B,WAAW;QACX,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,IAAI,IAAI,CAAC,QAAQ,CAAC,mBAAmB,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACnE,MAAM,QAAQ,GAAqB,MAAM,CAAC,MAAM,CAAC;QAC/C,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,qBAAqB;QAC3B,MAAM,EACJ,oHAAoH;KACvH,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,MAAM;QACT,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;KAC5D,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/scenario.d.ts

@@ -0,0 +1,145 @@
+import type { CursorShape } from "../abi.js";
+import type { App } from "../app/types.js";
+import type { RoutedAction } from "../runtime/router/types.js";
+import type { ThemeDefinition } from "../theme/tokens.js";
+import type { VNode } from "../widgets/types.js";
+export type ScenarioWidgetFamily = "input-textarea" | "select-dropdown" | "modal-overlay-dialog" | "table-tree-virtual-list";
+export type ScenarioColorMode = "none" | "16" | "256" | "truecolor";
+export type ScenarioTheme = Readonly<{
+    mode: "named";
+    value: "default";
+}>;
+export type ScenarioKeyMod = "shift" | "ctrl" | "alt" | "meta";
+export type ScenarioCapabilityProfile = Readonly<{
+    supportsMouse: boolean;
+    supportsBracketedPaste: boolean;
+    supportsFocusEvents: boolean;
+    supportsOsc52: boolean;
+    colorMode: ScenarioColorMode;
+}>;
+export type ScenarioScriptedInputEvent = Readonly<{
+    kind: "text";
+    text: string;
+}> | Readonly<{
+    kind: "paste";
+    text: string;
+}> | Readonly<{
+    kind: "resize";
+    cols: number;
+    rows: number;
+}> | Readonly<{
+    kind: "terminalBytes";
+    bytes: string;
+}> | Readonly<{
+    kind: "key";
+    key: string | number;
+    mods?: readonly ScenarioKeyMod[];
+}>;
+export type ScenarioScriptedInputStep = Readonly<{
+    atMs: number;
+    event: ScenarioScriptedInputEvent;
+}>;
+export type ScenarioExpectedAction = RoutedAction;
+export type ScenarioScreenRegionAssertion = Readonly<{
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    match?: "exact" | "includes";
+    text: string | readonly string[];
+}>;
+export type ScenarioCursorAssertion = Readonly<{
+    visible: false;
+    shape: CursorShape;
+    blink: boolean;
+}> | Readonly<{
+    visible: true;
+    x: number;
+    y: number;
+    shape: CursorShape;
+    blink: boolean;
+}>;
+export type ScenarioInvariantAssertion = Readonly<{
+    kind: "action_absence";
+    action: Readonly<{
+        id?: string;
+        action?: RoutedAction["action"];
+        payloadSubset?: Readonly<Record<string, unknown>>;
+    }>;
+}>;
+export type ScenarioScreenCheckpoint = Readonly<{
+    id: string;
+    afterStep: number;
+    assertionRef: "screen_region_assertion";
+    args: ScenarioScreenRegionAssertion;
+}>;
+export type ScenarioInvariant = Readonly<{
+    id: string;
+    assertionRef: "invariant_assertion";
+    args: ScenarioInvariantAssertion;
+}>;
+export type ScenarioDefinition = Readonly<{
+    schemaVersion: 1;
+    id: string;
+    title: string;
+    widgetFamily: ScenarioWidgetFamily;
+    behaviorStatement: string;
+    evidenceRefs: readonly string[];
+    viewport: Readonly<{
+        cols: number;
+        rows: number;
+    }>;
+    theme: ScenarioTheme;
+    capabilityProfile: ScenarioCapabilityProfile;
+    scriptedInput: readonly ScenarioScriptedInputStep[];
+    expectedActions?: readonly ScenarioExpectedAction[];
+    expectedScreenCheckpoints: readonly ScenarioScreenCheckpoint[];
+    expectedCursorState?: ScenarioCursorAssertion;
+    invariants: readonly ScenarioInvariant[];
+    fidelityRequirement: "semantic-only" | "terminal-real";
+    notes?: string;
+    unresolvedAssumptions?: readonly string[];
+}>;
+export type ScenarioScreenSnapshot = Readonly<{
+    cols: number;
+    rows: number;
+    lines: readonly string[];
+}>;
+export type ScenarioCursorSnapshot = ScenarioCursorAssertion;
+export type ScenarioStepObservation = Readonly<{
+    step: number;
+    screen: ScenarioScreenSnapshot;
+    cursor: ScenarioCursorSnapshot | null;
+    actions: readonly ScenarioExpectedAction[];
+}>;
+export type ScenarioMismatchCode = "ZR_SCENARIO_INVALID" | "ZR_SCENARIO_UNSUPPORTED" | "ZR_SCENARIO_ACTION_COUNT_MISMATCH" | "ZR_SCENARIO_ACTION_MISMATCH" | "ZR_SCENARIO_SCREEN_MISMATCH" | "ZR_SCENARIO_CURSOR_MISMATCH" | "ZR_SCENARIO_INVARIANT_MISMATCH" | "ZR_SCENARIO_RUNTIME_FATAL";
+export type ScenarioMismatch = Readonly<{
+    code: ScenarioMismatchCode;
+    path: string;
+    detail: string;
+    expected?: unknown;
+    actual?: unknown;
+}>;
+export type ScenarioRunResult = Readonly<{
+    mode: "semantic" | "replay" | "pty";
+    status: "PASS" | "FAIL";
+    pass: boolean;
+    actions: readonly ScenarioExpectedAction[];
+    steps: readonly ScenarioStepObservation[];
+    finalScreen: ScenarioScreenSnapshot;
+    finalCursor: ScenarioCursorSnapshot | null;
+    mismatches: readonly ScenarioMismatch[];
+}>;
+export type ScenarioFixture<S> = Readonly<{
+    initialState: S;
+    theme?: ThemeDefinition;
+    setup?: (app: App<S>) => void;
+    view: (state: S) => VNode;
+}>;
+export type ScenarioFixtureFactory<S> = () => ScenarioFixture<S>;
+export declare function createScenarioScreenSnapshot(viewport: Readonly<{
+    cols: number;
+    rows: number;
+}>, text: string): ScenarioScreenSnapshot;
+export declare function validateScenarioDefinition(scenario: ScenarioDefinition): readonly ScenarioMismatch[];
+//# sourceMappingURL=scenario.d.ts.map