@slowclap/rezi-core 0.1.0-fork.1

package/dist/protocol/mouseKinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mouseKinds.js","sourceRoot":"","sources":["../../src/protocol/mouseKinds.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AACxC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAU,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC"}

package/dist/protocol/types.d.ts

@@ -0,0 +1,119 @@
+/**
+ * packages/core/src/protocol/types.ts — ZREV event batch type definitions.
+ *
+ * Why: Defines the TypeScript representations of parsed ZREV events and parse
+ * results. These types form the contract between the binary parser and the
+ * runtime, ensuring type-safe event handling throughout the framework.
+ *
+ * ZREV format: Little-endian, 4-byte aligned event batch from the C engine.
+ *
+ * @see docs/protocol/abi.md
+ * @see docs/protocol/index.md
+ */
+/**
+ * Error codes for ZREV parsing failures.
+ *
+ * Error categories:
+ *   - ZR_BAD_MAGIC: Magic bytes don't match 'ZREV' (0x5A524556)
+ *   - ZR_UNSUPPORTED_VERSION: Format version not supported by this parser
+ *   - ZR_TRUNCATED: Buffer ends before declared size
+ *   - ZR_MISALIGNED: Offset/size not 4-byte aligned as required
+ *   - ZR_SIZE_MISMATCH: Declared size doesn't match actual data
+ *   - ZR_OUT_OF_BOUNDS: Record extends beyond batch total_size
+ *   - ZR_INVALID_RECORD: Record type/payload structure invalid
+ *   - ZR_LIMIT: Count/size exceeds configured parser cap
+ */
+export type ParseErrorCode = "ZR_BAD_MAGIC" | "ZR_UNSUPPORTED_VERSION" | "ZR_TRUNCATED" | "ZR_MISALIGNED" | "ZR_SIZE_MISMATCH" | "ZR_OUT_OF_BOUNDS" | "ZR_INVALID_RECORD" | "ZR_LIMIT";
+/** Key event action type: down (press), up (release), or repeat (held). */
+export type ZrevKeyAction = "down" | "up" | "repeat";
+/**
+ * Mouse event kind enumeration (matches ZREV binary values).
+ *   1 = move, 2 = drag, 3 = down, 4 = up, 5 = wheel
+ */
+export type ZrevMouseKind = 1 | 2 | 3 | 4 | 5;
+/**
+ * Structured parse error with precise diagnostic context.
+ * Offset points to the byte position where parsing failed.
+ */
+export type ParseError = Readonly<{
+    code: ParseErrorCode;
+    offset: number;
+    detail: string;
+}>;
+/**
+ * Discriminated union result type for parse operations.
+ * Enforces explicit error handling (no thrown exceptions for parse failures).
+ */
+export type ParseResult<T> = Readonly<{
+    ok: true;
+    value: T;
+}> | Readonly<{
+    ok: false;
+    error: ParseError;
+}>;
+/**
+ * Mutable state for unwrapping the engine's 32-bit millisecond timestamp into a
+ * monotonic number across u32 wrap-around (~49.7 days).
+ *
+ * Usage: pass the same object to parseEventBatchV1(..., { timeUnwrap: state })
+ * for each subsequent batch.
+ */
+export type EventTimeUnwrapState = {
+    epochMs: number;
+    lastRawMs: number | null;
+};
+/**
+ * Discriminated union of all ZREV event types.
+ *
+ * Event kinds (match ZREV record type values):
+ *   - key (1): Keyboard key press/release/repeat with modifier state
+ *   - text (2): Unicode codepoint from text input (distinct from raw keys)
+ *   - paste (3): Bracketed paste data as raw UTF-8 bytes
+ *   - mouse (4): Mouse movement, clicks, drags, and scrolling
+ *   - resize (5): Terminal viewport size change (cols/rows)
+ *   - tick (6): Frame timing event with delta milliseconds
+ *   - user (7): Application-defined event with tag and payload
+ *
+ * Ownership: paste.bytes and user.payload are subarray views into the
+ * original event batch buffer; they become invalid after batch release.
+ */
+export type ZrevEvent = {
+    kind: "key";
+    timeMs: number;
+    key: number;
+    mods: number;
+    action: ZrevKeyAction;
+} | {
+    kind: "text";
+    timeMs: number;
+    codepoint: number;
+} | {
+    kind: "paste";
+    timeMs: number;
+    bytes: Uint8Array;
+} | {
+    kind: "mouse";
+    timeMs: number;
+    x: number;
+    y: number;
+    mouseKind: ZrevMouseKind;
+    mods: number;
+    buttons: number;
+    wheelX: number;
+    wheelY: number;
+} | {
+    kind: "resize";
+    timeMs: number;
+    cols: number;
+    rows: number;
+} | {
+    kind: "tick";
+    timeMs: number;
+    dtMs: number;
+} | {
+    kind: "user";
+    timeMs: number;
+    tag: number;
+    payload: Uint8Array;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/protocol/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,wBAAwB,GACxB,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,UAAU,CAAC;AAEf,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB,QAAQ,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,GAChC,QAAQ,CAAC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACpD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,SAAS,EAAE,aAAa,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC"}

package/dist/protocol/types.js

@@ -0,0 +1,14 @@
+/**
+ * packages/core/src/protocol/types.ts — ZREV event batch type definitions.
+ *
+ * Why: Defines the TypeScript representations of parsed ZREV events and parse
+ * results. These types form the contract between the binary parser and the
+ * runtime, ensuring type-safe event handling throughout the framework.
+ *
+ * ZREV format: Little-endian, 4-byte aligned event batch from the C engine.
+ *
+ * @see docs/protocol/abi.md
+ * @see docs/protocol/index.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/protocol/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/protocol/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/protocol/zrev_v1.d.ts

@@ -0,0 +1,52 @@
+/**
+ * packages/core/src/protocol/zrev_v1.ts — ZREV v1 event batch parser.
+ *
+ * Why: Parses the binary ZREV event batch format produced by the Zireael C engine
+ * into type-safe TypeScript event objects. Enforces strict validation of all
+ * fields before producing output, ensuring no partial/invalid events propagate
+ * to the runtime.
+ *
+ * Format structure (ZREV v1):
+ *   - Header: 24 bytes (magic, version, total_size, event_count, flags, reserved)
+ *   - Records: Variable-length, each with 16-byte header + payload
+ *   - All offsets/sizes must be 4-byte aligned
+ *
+ * Invariants:
+ *   - No partial effects: returns error or complete batch, never partial
+ *   - All size/count fields validated against caps before use
+ *   - Cursor must exactly match total_size after parsing all events
+ *
+ * @see docs/protocol/abi.md
+ * @see docs/protocol/index.md
+ */
+import type { EventTimeUnwrapState, ParseResult, ZrevEvent } from "./types.js";
+/**
+ * Parser configuration options with cap enforcement.
+ * Caps prevent resource exhaustion from malformed/malicious input.
+ */
+export type ParseEventBatchV1Opts = Readonly<{
+    maxTotalSize?: number;
+    maxEvents?: number;
+    maxPasteBytes?: number;
+    maxUserPayloadBytes?: number;
+    /**
+     * Optional mutable state for unwrapping the engine's u32 millisecond
+     * timestamp across wrap-around (~49.7 days).
+     */
+    timeUnwrap?: EventTimeUnwrapState;
+}>;
+/**
+ * Parse a ZREV v1 event batch from raw bytes.
+ *
+ * Validates header magic/version, enforces configured caps, parses all event
+ * records, and verifies cursor matches declared total_size.
+ *
+ * @param bytes - Raw event batch bytes from the engine
+ * @param opts - Parser caps (defaults: maxEvents=4096, maxPasteBytes=256KiB, maxUserPayloadBytes=256KiB)
+ * @returns ParseResult with batch flags and event array on success, or error on failure
+ */
+export declare function parseEventBatchV1(bytes: Uint8Array, opts?: ParseEventBatchV1Opts): ParseResult<{
+    flags: number;
+    events: readonly ZrevEvent[];
+}>;
+//# sourceMappingURL=zrev_v1.d.ts.map

package/dist/protocol/zrev_v1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zrev_v1.d.ts","sourceRoot":"","sources":["../../src/protocol/zrev_v1.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAIH,OAAO,KAAK,EACV,oBAAoB,EAEpB,WAAW,EACX,SAAS,EAEV,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;CACnC,CAAC,CAAC;AAgCH;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,qBAA0B,GAC/B,WAAW,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC,CAoQ9D"}

package/dist/protocol/zrev_v1.js

@@ -0,0 +1,288 @@
+/**
+ * packages/core/src/protocol/zrev_v1.ts — ZREV v1 event batch parser.
+ *
+ * Why: Parses the binary ZREV event batch format produced by the Zireael C engine
+ * into type-safe TypeScript event objects. Enforces strict validation of all
+ * fields before producing output, ensuring no partial/invalid events propagate
+ * to the runtime.
+ *
+ * Format structure (ZREV v1):
+ *   - Header: 24 bytes (magic, version, total_size, event_count, flags, reserved)
+ *   - Records: Variable-length, each with 16-byte header + payload
+ *   - All offsets/sizes must be 4-byte aligned
+ *
+ * Invariants:
+ *   - No partial effects: returns error or complete batch, never partial
+ *   - All size/count fields validated against caps before use
+ *   - Cursor must exactly match total_size after parsing all events
+ *
+ * @see docs/protocol/abi.md
+ * @see docs/protocol/index.md
+ */
+import { ZREV_MAGIC, ZR_EVENT_BATCH_VERSION_V1 } from "../abi.js";
+import { BinaryReader } from "../binary/reader.js";
+/* --- Format Constants --- */
+const HEADER_SIZE = 24; /* magic(4) + version(4) + total_size(4) + event_count(4) + flags(4) + reserved(4) */
+const RECORD_HEADER_SIZE = 16; /* type(4) + size(4) + time_ms(4) + flags(4) */
+/** Construct a parse failure result with error context. */
+function fail(code, offset, detail) {
+    return { ok: false, error: { code, offset, detail } };
+}
+/** Round up to next 4-byte boundary. */
+function align4(n) {
+    const rem = n % 4;
+    return rem === 0 ? n : n + (4 - rem);
+}
+function isNonNegativeInteger(n) {
+    return Number.isInteger(n) && n >= 0;
+}
+function unwrapTimeMs(raw, state) {
+    if (!state)
+        return raw;
+    const prev = state.lastRawMs;
+    if (prev !== null && raw < prev) {
+        state.epochMs += 0x1_0000_0000;
+    }
+    state.lastRawMs = raw;
+    return state.epochMs + raw;
+}
+/**
+ * Parse a ZREV v1 event batch from raw bytes.
+ *
+ * Validates header magic/version, enforces configured caps, parses all event
+ * records, and verifies cursor matches declared total_size.
+ *
+ * @param bytes - Raw event batch bytes from the engine
+ * @param opts - Parser caps (defaults: maxEvents=4096, maxPasteBytes=256KiB, maxUserPayloadBytes=256KiB)
+ * @returns ParseResult with batch flags and event array on success, or error on failure
+ */
+export function parseEventBatchV1(bytes, opts = {}) {
+    if (!isNonNegativeInteger(bytes.byteLength)) {
+        return fail("ZR_INVALID_RECORD", 0, "bytes.byteLength must be a non-negative integer");
+    }
+    if (bytes.byteLength < HEADER_SIZE) {
+        return fail("ZR_TRUNCATED", 0, `need ${HEADER_SIZE} byte(s) for header but only ${bytes.byteLength} available`);
+    }
+    const maxTotalSize = opts.maxTotalSize === undefined
+        ? bytes.byteLength
+        : isNonNegativeInteger(opts.maxTotalSize)
+            ? opts.maxTotalSize
+            : Number.NaN;
+    const maxEvents = opts.maxEvents === undefined
+        ? 4096
+        : isNonNegativeInteger(opts.maxEvents)
+            ? opts.maxEvents
+            : Number.NaN;
+    const maxPasteBytes = opts.maxPasteBytes === undefined
+        ? 256 * 1024
+        : isNonNegativeInteger(opts.maxPasteBytes)
+            ? opts.maxPasteBytes
+            : Number.NaN;
+    const maxUserPayloadBytes = opts.maxUserPayloadBytes === undefined
+        ? 256 * 1024
+        : isNonNegativeInteger(opts.maxUserPayloadBytes)
+            ? opts.maxUserPayloadBytes
+            : Number.NaN;
+    if (!Number.isFinite(maxTotalSize) || !Number.isFinite(maxEvents)) {
+        return fail("ZR_LIMIT", 0, "invalid parser caps");
+    }
+    if (!Number.isFinite(maxPasteBytes) || !Number.isFinite(maxUserPayloadBytes)) {
+        return fail("ZR_LIMIT", 0, "invalid parser caps");
+    }
+    const r0 = new BinaryReader(bytes);
+    const magic = r0.readU32();
+    if (magic !== ZREV_MAGIC) {
+        return fail("ZR_BAD_MAGIC", 0, "magic must be ZREV");
+    }
+    const version = r0.readU32();
+    if (version !== ZR_EVENT_BATCH_VERSION_V1) {
+        return fail("ZR_UNSUPPORTED_VERSION", 4, "version must be 1");
+    }
+    const totalSize = r0.readU32();
+    const eventCount = r0.readU32();
+    const batchFlags = r0.readU32();
+    r0.readU32(); // reserved0
+    if (totalSize < HEADER_SIZE) {
+        return fail("ZR_SIZE_MISMATCH", 8, "total_size must be >= 24");
+    }
+    if ((totalSize & 3) !== 0) {
+        return fail("ZR_MISALIGNED", 8, "total_size must be 4-byte aligned");
+    }
+    if (totalSize > bytes.byteLength) {
+        return fail("ZR_TRUNCATED", 8, "total_size exceeds input length");
+    }
+    if (totalSize > maxTotalSize) {
+        return fail("ZR_LIMIT", 8, "total_size exceeds maxTotalSize");
+    }
+    if (eventCount > maxEvents) {
+        return fail("ZR_LIMIT", 12, "event_count exceeds maxEvents");
+    }
+    const bounded = bytes.subarray(0, totalSize);
+    const r = new BinaryReader(bounded);
+    r.skip(HEADER_SIZE);
+    const events = new Array(eventCount);
+    let eventIndex = 0;
+    const timeUnwrap = opts.timeUnwrap;
+    for (let i = 0; i < eventCount; i++) {
+        const recordStart = r.offset;
+        if (r.remaining < RECORD_HEADER_SIZE) {
+            return fail("ZR_TRUNCATED", recordStart, "truncated record header");
+        }
+        const type = r.readU32();
+        const size = r.readU32();
+        const timeMs = unwrapTimeMs(r.readU32(), timeUnwrap);
+        r.readU32(); // event flags (ignored)
+        if (size < RECORD_HEADER_SIZE) {
+            return fail("ZR_INVALID_RECORD", recordStart, "record size must be >= 16");
+        }
+        if ((size & 3) !== 0) {
+            return fail("ZR_MISALIGNED", recordStart, "record size must be 4-byte aligned");
+        }
+        const payloadBytes = size - RECORD_HEADER_SIZE;
+        if (payloadBytes > r.remaining) {
+            return fail("ZR_OUT_OF_BOUNDS", recordStart, "record exceeds total_size");
+        }
+        const payloadStart = r.offset;
+        switch (type) {
+            case 1: {
+                if (payloadBytes !== 16) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "KEY payload size mismatch");
+                }
+                const key = r.readU32();
+                const mods = r.readU32();
+                const actionRaw = r.readU32();
+                r.readU32(); // reserved0
+                const action = actionRaw === 1 ? "down" : actionRaw === 2 ? "up" : actionRaw === 3 ? "repeat" : null;
+                if (action === null)
+                    return fail("ZR_INVALID_RECORD", recordStart, "KEY invalid action");
+                events[eventIndex++] = { kind: "key", timeMs, key, mods, action };
+                break;
+            }
+            case 2: {
+                if (payloadBytes !== 8) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "TEXT payload size mismatch");
+                }
+                const codepoint = r.readU32();
+                r.readU32(); // reserved0
+                events[eventIndex++] = { kind: "text", timeMs, codepoint };
+                break;
+            }
+            case 3: {
+                if (payloadBytes < 8) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "PASTE payload too small");
+                }
+                if (r.remaining < 8)
+                    return fail("ZR_TRUNCATED", r.offset, "truncated PASTE header");
+                const byteLen = r.readU32();
+                r.readU32(); // reserved0
+                if (byteLen > maxPasteBytes) {
+                    return fail("ZR_LIMIT", payloadStart, "paste.byte_len exceeds maxPasteBytes");
+                }
+                const padded = align4(byteLen);
+                const expectedPayloadBytes = 8 + padded;
+                if (payloadBytes !== expectedPayloadBytes) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "PASTE payload size mismatch");
+                }
+                if (r.remaining < padded) {
+                    return fail("ZR_TRUNCATED", r.offset, "truncated PASTE bytes");
+                }
+                const paddedBytes = r.readBytes(padded);
+                const data = paddedBytes.subarray(0, byteLen);
+                events[eventIndex++] = { kind: "paste", timeMs, bytes: data };
+                break;
+            }
+            case 4: {
+                if (payloadBytes !== 32) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "MOUSE payload size mismatch");
+                }
+                const x = r.readI32();
+                const y = r.readI32();
+                const mouseKindRaw = r.readU32();
+                const mouseKind = mouseKindRaw === 1 ||
+                    mouseKindRaw === 2 ||
+                    mouseKindRaw === 3 ||
+                    mouseKindRaw === 4 ||
+                    mouseKindRaw === 5
+                    ? mouseKindRaw
+                    : null;
+                if (mouseKind === null) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "MOUSE invalid kind");
+                }
+                const mods = r.readU32();
+                const buttons = r.readU32();
+                const wheelX = r.readI32();
+                const wheelY = r.readI32();
+                r.readU32(); // reserved0
+                events[eventIndex++] = {
+                    kind: "mouse",
+                    timeMs,
+                    x,
+                    y,
+                    mouseKind,
+                    mods,
+                    buttons,
+                    wheelX,
+                    wheelY,
+                };
+                break;
+            }
+            case 5: {
+                if (payloadBytes !== 16) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "RESIZE payload size mismatch");
+                }
+                const cols = r.readU32();
+                const rows = r.readU32();
+                r.readU32(); // reserved0
+                r.readU32(); // reserved1
+                events[eventIndex++] = { kind: "resize", timeMs, cols, rows };
+                break;
+            }
+            case 6: {
+                if (payloadBytes !== 16) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "TICK payload size mismatch");
+                }
+                const dtMs = r.readU32();
+                r.readU32(); // reserved0
+                r.readU32(); // reserved1
+                r.readU32(); // reserved2
+                events[eventIndex++] = { kind: "tick", timeMs, dtMs };
+                break;
+            }
+            case 7: {
+                if (payloadBytes < 16) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "USER payload too small");
+                }
+                if (r.remaining < 16)
+                    return fail("ZR_TRUNCATED", r.offset, "truncated USER header");
+                const tag = r.readU32();
+                const byteLen = r.readU32();
+                r.readU32(); // reserved0
+                r.readU32(); // reserved1
+                if (byteLen > maxUserPayloadBytes) {
+                    return fail("ZR_LIMIT", payloadStart + 4, "user.byte_len exceeds maxUserPayloadBytes");
+                }
+                const padded = align4(byteLen);
+                const expectedPayloadBytes = 16 + padded;
+                if (payloadBytes !== expectedPayloadBytes) {
+                    return fail("ZR_INVALID_RECORD", recordStart, "USER payload size mismatch");
+                }
+                if (r.remaining < padded) {
+                    return fail("ZR_TRUNCATED", r.offset, "truncated USER payload");
+                }
+                const paddedBytes = r.readBytes(padded);
+                const payload = paddedBytes.subarray(0, byteLen);
+                events[eventIndex++] = { kind: "user", timeMs, tag, payload };
+                break;
+            }
+            default:
+                return fail("ZR_INVALID_RECORD", recordStart, `unknown record type: ${type}`);
+        }
+    }
+    if (r.offset !== totalSize) {
+        return fail("ZR_SIZE_MISMATCH", r.offset, "cursor does not match total_size");
+    }
+    if (eventIndex < events.length)
+        events.length = eventIndex;
+    return { ok: true, value: { flags: batchFlags, events } };
+}
+//# sourceMappingURL=zrev_v1.js.map

package/dist/protocol/zrev_v1.js.map

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

package/dist/renderer/boxGlyphs.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Box border glyphs for widget rendering.
+ *
+ * Deterministic constants for border rendering.
+ * Unicode: box drawing characters.
+ *
+ * Glyph positions:
+ *   TL ─── H ─── TR
+ *   │             │
+ *   V             V
+ *   │             │
+ *   BL ─── H ─── BR
+ *
+ * T-junction positions:
+ *   TH (├) - T pointing right (left edge with horizontal)
+ *   TV (┬) - T pointing down (top edge with vertical)
+ *   THL (┤) - T pointing left (right edge with horizontal)
+ *   TVB (┴) - T pointing up (bottom edge with vertical)
+ *   X (┼) - Cross junction
+ */
+/**
+ * Complete set of box border glyphs including T-junctions.
+ */
+export type BorderGlyphSet = Readonly<{
+    /** Top-left corner */
+    TL: string;
+    /** Top-right corner */
+    TR: string;
+    /** Bottom-left corner */
+    BL: string;
+    /** Bottom-right corner */
+    BR: string;
+    /** Horizontal line */
+    H: string;
+    /** Vertical line */
+    V: string;
+    /** T-junction horizontal right (├) */
+    TH: string;
+    /** T-junction vertical down (┬) */
+    TV: string;
+    /** T-junction horizontal left (┤) */
+    THL: string;
+    /** T-junction vertical up (┴) */
+    TVB: string;
+    /** Cross junction (┼) */
+    X: string;
+}>;
+/**
+ * Legacy type without T-junctions (backwards compatible).
+ */
+export type BorderGlyphs = Readonly<{
+    TL: string;
+    TR: string;
+    BL: string;
+    BR: string;
+    H: string;
+    V: string;
+}>;
+/** Single-line border glyphs (default). */
+export declare const SINGLE: BorderGlyphSet;
+/** Double-line border glyphs. */
+export declare const DOUBLE: BorderGlyphSet;
+/** Rounded corner border glyphs. */
+export declare const ROUNDED: BorderGlyphSet;
+/** Heavy/thick border glyphs. */
+export declare const HEAVY: BorderGlyphSet;
+/** Dashed border glyphs. */
+export declare const DASHED: BorderGlyphSet;
+/** Heavy dashed border glyphs. */
+export declare const HEAVY_DASHED: BorderGlyphSet;
+/**
+ * Border style names.
+ */
+export type BorderStyle = "none" | "single" | "double" | "rounded" | "heavy" | "dashed" | "heavy-dashed";
+/**
+ * Get border glyphs for a given style.
+ *
+ * @param style - Border style name
+ * @returns Border glyph set, or null for "none"
+ */
+export declare function getBorderGlyphs(style: BorderStyle): BorderGlyphSet | null;
+/**
+ * Check if a value is a valid border style.
+ */
+export declare function isBorderStyle(value: unknown): value is BorderStyle;
+export declare const TL: string, TR: string, BL: string, BR: string, H: string, V: string;
+//# sourceMappingURL=boxGlyphs.d.ts.map

package/dist/renderer/boxGlyphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boxGlyphs.d.ts","sourceRoot":"","sources":["../../src/renderer/boxGlyphs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,oBAAoB;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,yBAAyB;IACzB,CAAC,EAAE,MAAM,CAAC;CACX,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,CAAC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,MAAM,EAAE,cAYnB,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,MAAM,EAAE,cAYnB,CAAC;AAEH,oCAAoC;AACpC,eAAO,MAAM,OAAO,EAAE,cAYpB,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,KAAK,EAAE,cAYlB,CAAC;AAEH,4BAA4B;AAC5B,eAAO,MAAM,MAAM,EAAE,cAYnB,CAAC;AAEH,kCAAkC;AAClC,eAAO,MAAM,YAAY,EAAE,cAYzB,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,CAiBzE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAUlE;AAGD,eAAO,MAAQ,EAAE,UAAE,EAAE,UAAE,EAAE,UAAE,EAAE,UAAE,CAAC,UAAE,CAAC,QAAW,CAAC"}