@rezi-ui/core 0.1.0-alpha.7 → 0.1.0-alpha.71

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

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

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

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

package/dist/testing/scenario.js

@@ -0,0 +1,57 @@
+export function createScenarioScreenSnapshot(viewport, text) {
+    const rawLines = text.split("\n");
+    const lines = [];
+    for (let row = 0; row < viewport.rows; row++) {
+        const raw = rawLines[row] ?? "";
+        lines.push(raw.padEnd(viewport.cols, " ").slice(0, viewport.cols));
+    }
+    return Object.freeze({
+        cols: viewport.cols,
+        rows: viewport.rows,
+        lines: Object.freeze(lines),
+    });
+}
+export function validateScenarioDefinition(scenario) {
+    const mismatches = [];
+    if (scenario.schemaVersion !== 1) {
+        mismatches.push({
+            code: "ZR_SCENARIO_INVALID",
+            path: "schemaVersion",
+            detail: `Expected schemaVersion=1 (got ${String(scenario.schemaVersion)})`,
+            expected: 1,
+            actual: scenario.schemaVersion,
+        });
+    }
+    if (scenario.evidenceRefs.length === 0) {
+        mismatches.push({
+            code: "ZR_SCENARIO_INVALID",
+            path: "evidenceRefs",
+            detail: "Scenario must include at least one evidenceRef",
+        });
+    }
+    if (scenario.expectedScreenCheckpoints.length === 0) {
+        mismatches.push({
+            code: "ZR_SCENARIO_INVALID",
+            path: "expectedScreenCheckpoints",
+            detail: "Scenario must include at least one screen checkpoint",
+        });
+    }
+    if (scenario.invariants.length === 0) {
+        mismatches.push({
+            code: "ZR_SCENARIO_INVALID",
+            path: "invariants",
+            detail: "Scenario must include at least one invariant",
+        });
+    }
+    if (scenario.theme.mode !== "named" || scenario.theme.value !== "default") {
+        mismatches.push({
+            code: "ZR_SCENARIO_UNSUPPORTED",
+            path: "theme",
+            detail: `Only theme { mode: \"named\", value: \"default\" } is supported in this scenario harness`,
+            expected: { mode: "named", value: "default" },
+            actual: scenario.theme,
+        });
+    }
+    return Object.freeze(mismatches);
+}
+//# sourceMappingURL=scenario.js.map

package/dist/testing/scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenario.js","sourceRoot":"","sources":["../../src/testing/scenario.ts"],"names":[],"mappings":"AA4JA,MAAM,UAAU,4BAA4B,CAC1C,QAAkD,EAClD,IAAY;IAEZ,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAA4B;IAE5B,MAAM,UAAU,GAAuB,EAAE,CAAC;IAC1C,IAAI,QAAQ,CAAC,aAAa,KAAK,CAAC,EAAE,CAAC;QACjC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,eAAe;YACrB,MAAM,EAAE,iCAAiC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG;YAC1E,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,QAAQ,CAAC,aAAa;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,gDAAgD;SACzD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,yBAAyB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,2BAA2B;YACjC,MAAM,EAAE,sDAAsD;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,qBAAqB;YAC3B,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,8CAA8C;SACvD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1E,UAAU,CAAC,IAAI,CAAC;YACd,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,0FAA0F;YAClG,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE;YAC7C,MAAM,EAAE,QAAQ,CAAC,KAAK;SACvB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC"}

package/dist/testing/semanticScenario.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"semanticScenario.d.ts","sourceRoot":"","sources":["../../src/testing/semanticScenario.ts"],"names":[],"mappings":"AA2CA,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EAIvB,MAAM,eAAe,CAAC;AA+NvB,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,QAAQ,CAAC;IACb,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,aAAa,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;CAC1C,CAAC,GACD,OAAO,CAAC,iBAAiB,CAAC,CA0I5B"}