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

package/dist/terminalCaps.d.ts

@@ -41,6 +41,12 @@ export type TerminalCaps = Readonly<{
     supportsCursorShape: boolean;
     /** Output wait/drain support for backpressure */
     supportsOutputWaitWritable: boolean;
+    /** Extended underline style variants (double/curly/dotted/dashed) */
+    supportsUnderlineStyles: boolean;
+    /** Independent underline color (SGR 58 / 59) */
+    supportsColoredUnderlines: boolean;
+    /** OSC 8 hyperlinks */
+    supportsHyperlinks: boolean;
     /** Bitmask of supported SGR text attributes */
     sgrAttrsSupported: number;
 }>;
@@ -50,12 +56,12 @@ export type TerminalCaps = Readonly<{
  */
 export declare const DEFAULT_TERMINAL_CAPS: TerminalCaps;
 /**
- * Check if the terminal supports Drawlist v2 cursor protocol.
+ * Check if the terminal supports the native cursor protocol.
  *
  * @param caps - Terminal capabilities
  * @returns true if SET_CURSOR commands will work
  */
-export declare function supportsCursorProtocol(caps: TerminalCaps): boolean;
+export declare function supportsCursorProtocol(_caps: TerminalCaps): boolean;
 /**
  * Check if cursor shaping is fully supported.
  *

package/dist/terminalCaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"terminalCaps.d.ts","sourceRoot":"","sources":["../src/terminalCaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtC,eAAO,MAAM,kBAAkB,EAAE,SAAa,CAAC;AAC/C,eAAO,MAAM,aAAa,EAAE,SAAa,CAAC;AAC1C,eAAO,MAAM,cAAc,EAAE,SAAa,CAAC;AAC3C,eAAO,MAAM,cAAc,EAAE,SAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,gDAAgD;IAChD,SAAS,EAAE,SAAS,CAAC;IAErB,0BAA0B;IAC1B,aAAa,EAAE,OAAO,CAAC;IAEvB,mCAAmC;IACnC,sBAAsB,EAAE,OAAO,CAAC;IAEhC,6CAA6C;IAC7C,mBAAmB,EAAE,OAAO,CAAC;IAE7B,sCAAsC;IACtC,aAAa,EAAE,OAAO,CAAC;IAEvB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAE5B,4BAA4B;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAE9B,2DAA2D;IAC3D,mBAAmB,EAAE,OAAO,CAAC;IAE7B,iDAAiD;IACjD,0BAA0B,EAAE,OAAO,CAAC;IAEpC,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAWlC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAGlE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAGpF"}
+{"version":3,"file":"terminalCaps.d.ts","sourceRoot":"","sources":["../src/terminalCaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEtC,eAAO,MAAM,kBAAkB,EAAE,SAAa,CAAC;AAC/C,eAAO,MAAM,aAAa,EAAE,SAAa,CAAC;AAC1C,eAAO,MAAM,cAAc,EAAE,SAAa,CAAC;AAC3C,eAAO,MAAM,cAAc,EAAE,SAAa,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,gDAAgD;IAChD,SAAS,EAAE,SAAS,CAAC;IAErB,0BAA0B;IAC1B,aAAa,EAAE,OAAO,CAAC;IAEvB,mCAAmC;IACnC,sBAAsB,EAAE,OAAO,CAAC;IAEhC,6CAA6C;IAC7C,mBAAmB,EAAE,OAAO,CAAC;IAE7B,sCAAsC;IACtC,aAAa,EAAE,OAAO,CAAC;IAEvB,gDAAgD;IAChD,kBAAkB,EAAE,OAAO,CAAC;IAE5B,4BAA4B;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAE9B,2DAA2D;IAC3D,mBAAmB,EAAE,OAAO,CAAC;IAE7B,iDAAiD;IACjD,0BAA0B,EAAE,OAAO,CAAC;IAEpC,qEAAqE;IACrE,uBAAuB,EAAE,OAAO,CAAC;IAEjC,gDAAgD;IAChD,yBAAyB,EAAE,OAAO,CAAC;IAEnC,uBAAuB;IACvB,kBAAkB,EAAE,OAAO,CAAC;IAE5B,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAclC,CAAC;AAEH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEnE;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,GAAG,SAAS,CAGpF"}

package/dist/terminalCaps.js

@@ -25,16 +25,18 @@ export const DEFAULT_TERMINAL_CAPS = Object.freeze({
     supportsScrollRegion: false,
     supportsCursorShape: false,
     supportsOutputWaitWritable: false,
+    supportsUnderlineStyles: false,
+    supportsColoredUnderlines: false,
+    supportsHyperlinks: false,
     sgrAttrsSupported: 0,
 });
 /**
- * Check if the terminal supports Drawlist v2 cursor protocol.
+ * Check if the terminal supports the native cursor protocol.
  *
  * @param caps - Terminal capabilities
  * @returns true if SET_CURSOR commands will work
  */
-export function supportsCursorProtocol(caps) {
-    // The engine may support cursor visibility even without shape support
+export function supportsCursorProtocol(_caps) {
     return true;
 }
 /**

package/dist/terminalCaps.js.map

@@ -1 +1 @@
-{"version":3,"file":"terminalCaps.js","sourceRoot":"","sources":["../src/terminalCaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,CAAC,MAAM,kBAAkB,GAAc,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAc,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAC;AAwC3C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC/D,SAAS,EAAE,kBAAkB;IAC7B,aAAa,EAAE,KAAK;IACpB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,KAAK;IAC1B,aAAa,EAAE,KAAK;IACpB,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,KAAK;IAC1B,0BAA0B,EAAE,KAAK;IACjC,iBAAiB,EAAE,CAAC;CACrB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAkB;IACvD,sEAAsE;IACtE,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO,IAAI,CAAC,mBAAmB,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,SAAoB;IACvE,IAAI,IAAI,CAAC,SAAS,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC"}
+{"version":3,"file":"terminalCaps.js","sourceRoot":"","sources":["../src/terminalCaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,MAAM,CAAC,MAAM,kBAAkB,GAAc,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,aAAa,GAAc,CAAC,CAAC;AAC1C,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAC;AAC3C,MAAM,CAAC,MAAM,cAAc,GAAc,CAAC,CAAC;AAiD3C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC/D,SAAS,EAAE,kBAAkB;IAC7B,aAAa,EAAE,KAAK;IACpB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,KAAK;IAC1B,aAAa,EAAE,KAAK;IACpB,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,KAAK;IAC1B,0BAA0B,EAAE,KAAK;IACjC,uBAAuB,EAAE,KAAK;IAC9B,yBAAyB,EAAE,KAAK;IAChC,kBAAkB,EAAE,KAAK;IACzB,iBAAiB,EAAE,CAAC;CACrB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAmB;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACtD,OAAO,IAAI,CAAC,mBAAmB,CAAC;AAClC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAkB,EAAE,SAAoB;IACvE,IAAI,IAAI,CAAC,SAAS,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC"}

package/dist/terminalProfile.d.ts

@@ -0,0 +1,16 @@
+import type { TerminalCaps } from "./terminalCaps.js";
+export type TerminalProfile = Readonly<{
+    id: string;
+    versionString: string;
+    supportsKittyGraphics: boolean;
+    supportsSixel: boolean;
+    supportsIterm2Images: boolean;
+    supportsUnderlineStyles: boolean;
+    supportsColoredUnderlines: boolean;
+    supportsHyperlinks: boolean;
+    cellWidthPx: number;
+    cellHeightPx: number;
+}>;
+export declare const DEFAULT_TERMINAL_PROFILE: TerminalProfile;
+export declare function terminalProfileFromCaps(caps: TerminalCaps): TerminalProfile;
+//# sourceMappingURL=terminalProfile.d.ts.map

package/dist/terminalProfile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalProfile.d.ts","sourceRoot":"","sources":["../src/terminalProfile.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,OAAO,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,uBAAuB,EAAE,OAAO,CAAC;IACjC,yBAAyB,EAAE,OAAO,CAAC;IACnC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC,CAAC;AAEH,eAAO,MAAM,wBAAwB,EAAE,eAWrC,CAAC;AAIH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAwB3E"}

package/dist/terminalProfile.js

@@ -0,0 +1,36 @@
+export const DEFAULT_TERMINAL_PROFILE = Object.freeze({
+    id: "unknown",
+    versionString: "",
+    supportsKittyGraphics: false,
+    supportsSixel: false,
+    supportsIterm2Images: false,
+    supportsUnderlineStyles: false,
+    supportsColoredUnderlines: false,
+    supportsHyperlinks: false,
+    cellWidthPx: 0,
+    cellHeightPx: 0,
+});
+const SGR_UNDERLINE = 1 << 2;
+export function terminalProfileFromCaps(caps) {
+    const capsRecord = caps;
+    const supportsUnderlineBySgr = (caps.sgrAttrsSupported & SGR_UNDERLINE) !== 0;
+    const supportsUnderlineStyles = caps.supportsUnderlineStyles === true ||
+        (typeof capsRecord.supportsUnderlineStyles === "boolean"
+            ? capsRecord.supportsUnderlineStyles
+            : false) ||
+        supportsUnderlineBySgr;
+    const supportsColoredUnderlines = caps.supportsColoredUnderlines === true ||
+        (typeof capsRecord.supportsColoredUnderlines === "boolean"
+            ? capsRecord.supportsColoredUnderlines
+            : false) ||
+        supportsUnderlineStyles;
+    const supportsHyperlinks = caps.supportsHyperlinks === true ||
+        (typeof capsRecord.supportsHyperlinks === "boolean" ? capsRecord.supportsHyperlinks : false);
+    return Object.freeze({
+        ...DEFAULT_TERMINAL_PROFILE,
+        supportsUnderlineStyles,
+        supportsColoredUnderlines,
+        supportsHyperlinks,
+    });
+}
+//# sourceMappingURL=terminalProfile.js.map

package/dist/terminalProfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminalProfile.js","sourceRoot":"","sources":["../src/terminalProfile.ts"],"names":[],"mappings":"AAeA,MAAM,CAAC,MAAM,wBAAwB,GAAoB,MAAM,CAAC,MAAM,CAAC;IACrE,EAAE,EAAE,SAAS;IACb,aAAa,EAAE,EAAE;IACjB,qBAAqB,EAAE,KAAK;IAC5B,aAAa,EAAE,KAAK;IACpB,oBAAoB,EAAE,KAAK;IAC3B,uBAAuB,EAAE,KAAK;IAC9B,yBAAyB,EAAE,KAAK;IAChC,kBAAkB,EAAE,KAAK;IACzB,WAAW,EAAE,CAAC;IACd,YAAY,EAAE,CAAC;CAChB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,CAAC,IAAI,CAAC,CAAC;AAE7B,MAAM,UAAU,uBAAuB,CAAC,IAAkB;IACxD,MAAM,UAAU,GAAG,IAAwD,CAAC;IAC5E,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAC,iBAAiB,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,uBAAuB,GAC3B,IAAI,CAAC,uBAAuB,KAAK,IAAI;QACrC,CAAC,OAAO,UAAU,CAAC,uBAAuB,KAAK,SAAS;YACtD,CAAC,CAAC,UAAU,CAAC,uBAAuB;YACpC,CAAC,CAAC,KAAK,CAAC;QACV,sBAAsB,CAAC;IACzB,MAAM,yBAAyB,GAC7B,IAAI,CAAC,yBAAyB,KAAK,IAAI;QACvC,CAAC,OAAO,UAAU,CAAC,yBAAyB,KAAK,SAAS;YACxD,CAAC,CAAC,UAAU,CAAC,yBAAyB;YACtC,CAAC,CAAC,KAAK,CAAC;QACV,uBAAuB,CAAC;IAC1B,MAAM,kBAAkB,GACtB,IAAI,CAAC,kBAAkB,KAAK,IAAI;QAChC,CAAC,OAAO,UAAU,CAAC,kBAAkB,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,wBAAwB;QAC3B,uBAAuB;QACvB,yBAAyB;QACzB,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC"}

package/dist/testing/assertions.d.ts

@@ -0,0 +1,7 @@
+import type { RoutedAction } from "../runtime/router/types.js";
+import type { ScenarioCursorAssertion, ScenarioCursorSnapshot, ScenarioDefinition, ScenarioMismatch, ScenarioRunResult, ScenarioScreenRegionAssertion, ScenarioScreenSnapshot } from "./scenario.js";
+export declare function assertScenarioActions(actual: readonly RoutedAction[], expected: readonly RoutedAction[] | undefined): readonly ScenarioMismatch[];
+export declare function assertScreenRegion(screen: ScenarioScreenSnapshot, args: ScenarioScreenRegionAssertion, path: string): ScenarioMismatch | null;
+export declare function assertCursor(actual: ScenarioCursorSnapshot | null, expected: ScenarioCursorAssertion | undefined): ScenarioMismatch | null;
+export declare function evaluateScenarioResult(scenario: ScenarioDefinition, partial: Omit<ScenarioRunResult, "status" | "pass" | "mismatches">): ScenarioRunResult;
+//# sourceMappingURL=assertions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../../src/testing/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EACV,uBAAuB,EACvB,sBAAsB,EACtB,kBAAkB,EAElB,gBAAgB,EAChB,iBAAiB,EACjB,6BAA6B,EAC7B,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAuCvB,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,GAC5C,SAAS,gBAAgB,EAAE,CA2B7B;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,6BAA6B,EACnC,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,IAAI,CA0BzB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,sBAAsB,GAAG,IAAI,EACrC,QAAQ,EAAE,uBAAuB,GAAG,SAAS,GAC5C,gBAAgB,GAAG,IAAI,CAkCzB;AA+BD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC,GACjE,iBAAiB,CAgCnB"}

package/dist/testing/assertions.js

@@ -0,0 +1,187 @@
+function isObjectRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function matchesSubset(actual, expected) {
+    if (expected === undefined)
+        return true;
+    if (Array.isArray(expected)) {
+        if (!Array.isArray(actual) || actual.length !== expected.length)
+            return false;
+        for (let i = 0; i < expected.length; i++) {
+            if (!matchesSubset(actual[i], expected[i]))
+                return false;
+        }
+        return true;
+    }
+    if (isObjectRecord(expected)) {
+        if (!isObjectRecord(actual))
+            return false;
+        for (const [key, value] of Object.entries(expected)) {
+            if (!matchesSubset(actual[key], value))
+                return false;
+        }
+        return true;
+    }
+    return Object.is(actual, expected);
+}
+function actionPayload(action) {
+    const payload = {};
+    for (const [key, value] of Object.entries(action)) {
+        if (key === "id" || key === "action")
+            continue;
+        payload[key] = value;
+    }
+    return payload;
+}
+function actionEquals(expected, actual) {
+    if (expected.id !== actual.id || expected.action !== actual.action)
+        return false;
+    return matchesSubset(actionPayload(actual), actionPayload(expected));
+}
+export function assertScenarioActions(actual, expected) {
+    if (expected === undefined)
+        return Object.freeze([]);
+    const mismatches = [];
+    if (actual.length !== expected.length) {
+        mismatches.push({
+            code: "ZR_SCENARIO_ACTION_COUNT_MISMATCH",
+            path: "expectedActions",
+            detail: `Expected ${String(expected.length)} actions, observed ${String(actual.length)}`,
+            expected: expected.length,
+            actual: actual.length,
+        });
+    }
+    const max = Math.max(actual.length, expected.length);
+    for (let index = 0; index < max; index++) {
+        const want = expected[index];
+        const got = actual[index];
+        if (want === undefined || got === undefined)
+            continue;
+        if (actionEquals(want, got))
+            continue;
+        mismatches.push({
+            code: "ZR_SCENARIO_ACTION_MISMATCH",
+            path: `expectedActions[${String(index)}]`,
+            detail: `Observed action does not match expected action at index ${String(index)}`,
+            expected: want,
+            actual: got,
+        });
+    }
+    return Object.freeze(mismatches);
+}
+export function assertScreenRegion(screen, args, path) {
+    const expectedSource = typeof args.text === "string" ? args.text.split("\n") : [...args.text];
+    const expectedLines = expectedSource.map((line) => line.padEnd(args.width, " ").slice(0, args.width));
+    const actualLines = [];
+    for (let row = 0; row < args.height; row++) {
+        const line = screen.lines[args.y + row] ?? "".padEnd(screen.cols, " ");
+        actualLines.push(line.slice(args.x, args.x + args.width).padEnd(args.width, " "));
+    }
+    const matchMode = args.match ?? "exact";
+    const passed = matchMode === "includes"
+        ? expectedLines.every((line, index) => (actualLines[index] ?? "").includes(line.trimEnd()))
+        : expectedLines.length === actualLines.length &&
+            expectedLines.every((line, index) => line === (actualLines[index] ?? ""));
+    if (passed)
+        return null;
+    return {
+        code: "ZR_SCENARIO_SCREEN_MISMATCH",
+        path,
+        detail: `Screen region assertion failed (${matchMode})`,
+        expected: expectedLines,
+        actual: actualLines,
+    };
+}
+export function assertCursor(actual, expected) {
+    if (expected === undefined)
+        return null;
+    if (actual === null) {
+        return {
+            code: "ZR_SCENARIO_CURSOR_MISMATCH",
+            path: "expectedCursorState",
+            detail: "Expected cursor snapshot but none was captured",
+            expected,
+            actual: null,
+        };
+    }
+    if (actual.visible !== expected.visible ||
+        actual.shape !== expected.shape ||
+        actual.blink !== expected.blink) {
+        return {
+            code: "ZR_SCENARIO_CURSOR_MISMATCH",
+            path: "expectedCursorState",
+            detail: "Cursor visibility or styling did not match expected state",
+            expected,
+            actual,
+        };
+    }
+    if (expected.visible && actual.visible && (actual.x !== expected.x || actual.y !== expected.y)) {
+        return {
+            code: "ZR_SCENARIO_CURSOR_MISMATCH",
+            path: "expectedCursorState",
+            detail: "Cursor position did not match expected state",
+            expected,
+            actual,
+        };
+    }
+    return null;
+}
+function assertInvariant(actual, invariant, path) {
+    if (invariant.kind === "action_absence") {
+        const found = actual.find((action) => {
+            if (invariant.action.id !== undefined && action.id !== invariant.action.id)
+                return false;
+            if (invariant.action.action !== undefined && action.action !== invariant.action.action) {
+                return false;
+            }
+            return matchesSubset(actionPayload(action), invariant.action.payloadSubset);
+        });
+        if (found === undefined)
+            return null;
+        return {
+            code: "ZR_SCENARIO_INVARIANT_MISMATCH",
+            path,
+            detail: "Invariant failed: forbidden action was observed",
+            expected: invariant,
+            actual: found,
+        };
+    }
+    return {
+        code: "ZR_SCENARIO_UNSUPPORTED",
+        path,
+        detail: `Unsupported invariant kind ${String(invariant.kind)}`,
+    };
+}
+export function evaluateScenarioResult(scenario, partial) {
+    const mismatches = [];
+    mismatches.push(...assertScenarioActions(partial.actions, scenario.expectedActions));
+    for (const checkpoint of scenario.expectedScreenCheckpoints) {
+        const step = partial.steps.find((item) => item.step === checkpoint.afterStep);
+        if (!step) {
+            mismatches.push({
+                code: "ZR_SCENARIO_SCREEN_MISMATCH",
+                path: `expectedScreenCheckpoints.${checkpoint.id}`,
+                detail: `No observation was captured for step ${String(checkpoint.afterStep)}`,
+            });
+            continue;
+        }
+        const mismatch = assertScreenRegion(step.screen, checkpoint.args, `expectedScreenCheckpoints.${checkpoint.id}`);
+        if (mismatch)
+            mismatches.push(mismatch);
+    }
+    const cursorMismatch = assertCursor(partial.finalCursor, scenario.expectedCursorState);
+    if (cursorMismatch)
+        mismatches.push(cursorMismatch);
+    for (const invariant of scenario.invariants) {
+        const mismatch = assertInvariant(partial.actions, invariant.args, `invariants.${invariant.id}`);
+        if (mismatch)
+            mismatches.push(mismatch);
+    }
+    return Object.freeze({
+        ...partial,
+        status: mismatches.length === 0 ? "PASS" : "FAIL",
+        pass: mismatches.length === 0,
+        mismatches: Object.freeze(mismatches),
+    });
+}
+//# sourceMappingURL=assertions.js.map

package/dist/testing/assertions.js.map

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

package/dist/testing/events.d.ts

@@ -0,0 +1,168 @@
+/**
+ * packages/core/src/testing/events.ts — Test event encoding and fluent builders.
+ *
+ * Why: Integration tests should not need to hand-encode ZREV binary batches.
+ * This module provides:
+ *   - A stable ZREV v1 encoder for test events
+ *   - A fluent TestEventBuilder API for readable test setup
+ *   - A BackendEventBatch helper for polling backends in tests
+ */
+import type { BackendEventBatch } from "../backend.js";
+import type { ZrevKeyAction, ZrevMouseKind } from "../protocol/types.js";
+export declare const TEST_MOUSE_KIND_DOWN: ZrevMouseKind;
+export declare const TEST_MOUSE_KIND_UP: ZrevMouseKind;
+export declare const TEST_MOUSE_KIND_SCROLL: ZrevMouseKind;
+export type TestZrevEvent = Readonly<{
+    kind: "key";
+    timeMs: number;
+    key: number;
+    mods?: number;
+    action: ZrevKeyAction;
+}> | Readonly<{
+    kind: "text";
+    timeMs: number;
+    codepoint: number;
+}> | Readonly<{
+    kind: "paste";
+    timeMs: number;
+    bytes: Uint8Array;
+}> | Readonly<{
+    kind: "mouse";
+    timeMs: number;
+    x: number;
+    y: number;
+    mouseKind: ZrevMouseKind;
+    mods?: number;
+    buttons?: number;
+    wheelX?: number;
+    wheelY?: number;
+}> | Readonly<{
+    kind: "resize";
+    timeMs: number;
+    cols: number;
+    rows: number;
+}> | Readonly<{
+    kind: "tick";
+    timeMs: number;
+    dtMs?: number;
+}> | Readonly<{
+    kind: "user";
+    timeMs: number;
+    tag: number;
+    payload: Uint8Array;
+}>;
+export type TestEventInput = Readonly<{
+    kind: "key";
+    timeMs?: number;
+    key: number | string;
+    mods?: number;
+    action?: ZrevKeyAction;
+}> | Readonly<{
+    kind: "text";
+    timeMs?: number;
+    codepoint: number;
+}> | Readonly<{
+    kind: "paste";
+    timeMs?: number;
+    bytes: Uint8Array;
+}> | Readonly<{
+    kind: "mouse";
+    timeMs?: number;
+    x: number;
+    y: number;
+    mouseKind: ZrevMouseKind;
+    mods?: number;
+    buttons?: number;
+    wheelX?: number;
+    wheelY?: number;
+}> | Readonly<{
+    kind: "resize";
+    timeMs?: number;
+    cols: number;
+    rows: number;
+}> | Readonly<{
+    kind: "tick";
+    timeMs?: number;
+    dtMs?: number;
+}> | Readonly<{
+    kind: "user";
+    timeMs?: number;
+    tag: number;
+    payload: Uint8Array;
+}>;
+export type TestEventBuilderOptions = Readonly<{
+    startTimeMs?: number;
+    stepMs?: number;
+}>;
+type KeyPressOptions = Readonly<{
+    timeMs?: number;
+    mods?: number;
+    action?: ZrevKeyAction;
+}>;
+type TypeOptions = Readonly<{
+    timeMs?: number;
+}>;
+type ClickOptions = Readonly<{
+    timeMs?: number;
+    releaseTimeMs?: number;
+    mods?: number;
+    buttonMask?: number;
+}>;
+type ScrollOptions = Readonly<{
+    timeMs?: number;
+    mods?: number;
+    buttons?: number;
+    wheelX?: number;
+}>;
+/**
+ * Encode a ZREV v1 batch from typed test events.
+ *
+ * This mirrors the parser layout in protocol/zrev_v1.ts and intentionally keeps
+ * defaults lightweight (mods/buttons/wheel/dt default to 0).
+ */
+export declare function encodeZrevBatchV1(opts: Readonly<{
+    flags?: number;
+    events?: readonly TestZrevEvent[];
+}>): Uint8Array;
+export declare function makeBackendBatch(opts: Readonly<{
+    bytes: Uint8Array;
+    droppedBatches?: number;
+    onRelease?: () => void;
+}>): BackendEventBatch;
+/**
+ * Fluent helper for deterministic integration-test event streams.
+ *
+ * Example:
+ *   const events = new TestEventBuilder();
+ *   events.pressKey("Enter").type("hello@example.com").click(10, 5).resize(120, 40);
+ *   backend.pushBatch(events.buildBatch());
+ */
+export declare class TestEventBuilder {
+    private readonly initialTimeMs;
+    private readonly stepMs;
+    private nextTimeMs;
+    private readonly queue;
+    constructor(opts?: TestEventBuilderOptions);
+    private consumeTime;
+    add(input: TestEventInput): this;
+    pressKey(key: number | string, opts?: KeyPressOptions): this;
+    keyDown(key: number | string, opts?: Omit<KeyPressOptions, "action">): this;
+    keyUp(key: number | string, opts?: Omit<KeyPressOptions, "action">): this;
+    type(text: string, opts?: TypeOptions): this;
+    click(x: number, y: number, opts?: ClickOptions): this;
+    scroll(x: number, y: number, wheelY: number, opts?: ScrollOptions): this;
+    resize(cols: number, rows: number, timeMs?: number): this;
+    tick(dtMs?: number, timeMs?: number): this;
+    paste(bytes: Uint8Array, timeMs?: number): this;
+    user(tag: number, payload: Uint8Array, timeMs?: number): this;
+    events(): readonly TestZrevEvent[];
+    build(flags?: number): Uint8Array;
+    buildBatch(opts?: Readonly<{
+        flags?: number;
+        droppedBatches?: number;
+        onRelease?: () => void;
+    }>): BackendEventBatch;
+    reset(): this;
+}
+export {};
+//# sourceMappingURL=events.d.ts.map

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

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