@rezi-ui/testkit 0.1.0-alpha.1

package/fixtures/routing/mouse_routing.json

@@ -0,0 +1,167 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "name": "Down captures pressedId + focuses target; up on same target presses (docs/10)",
+      "enabledById": { "a": true },
+      "initialFocusedId": null,
+      "initialPressedId": null,
+      "steps": [
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 0,
+            "x": 1,
+            "y": 1,
+            "mouseKind": 3,
+            "mods": 0,
+            "buttons": 1,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "a",
+          "expected": { "focusedId": "a", "pressedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 1,
+            "x": 1,
+            "y": 1,
+            "mouseKind": 4,
+            "mods": 0,
+            "buttons": 0,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "a",
+          "expected": {
+            "focusedId": "a",
+            "pressedId": null,
+            "emittedKinds": ["engine", "action"],
+            "action": { "id": "a", "action": "press" }
+          }
+        }
+      ]
+    },
+    {
+      "name": "Up on different target does not press; pressedId always clears on up (docs/10)",
+      "enabledById": { "a": true, "b": true },
+      "initialFocusedId": null,
+      "initialPressedId": null,
+      "steps": [
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 0,
+            "x": 1,
+            "y": 1,
+            "mouseKind": 3,
+            "mods": 0,
+            "buttons": 1,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "a",
+          "expected": { "focusedId": "a", "pressedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 1,
+            "x": 2,
+            "y": 1,
+            "mouseKind": 4,
+            "mods": 0,
+            "buttons": 0,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "b",
+          "expected": { "focusedId": "a", "pressedId": null, "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "Disabled target does not focus and does not capture (docs/10)",
+      "enabledById": { "a": true, "b": false },
+      "initialFocusedId": "a",
+      "initialPressedId": null,
+      "steps": [
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 0,
+            "x": 1,
+            "y": 1,
+            "mouseKind": 3,
+            "mods": 0,
+            "buttons": 1,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "b",
+          "expected": { "focusedId": "a", "pressedId": null, "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "Move/drag/wheel ignored and do not change pressedId (docs/10)",
+      "enabledById": { "a": true },
+      "initialFocusedId": null,
+      "initialPressedId": null,
+      "steps": [
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 0,
+            "x": 1,
+            "y": 1,
+            "mouseKind": 3,
+            "mods": 0,
+            "buttons": 1,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "a",
+          "expected": { "focusedId": "a", "pressedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 1,
+            "x": 2,
+            "y": 2,
+            "mouseKind": 1,
+            "mods": 0,
+            "buttons": 1,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": null,
+          "expected": { "focusedId": "a", "pressedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": {
+            "kind": "mouse",
+            "timeMs": 2,
+            "x": 2,
+            "y": 2,
+            "mouseKind": 4,
+            "mods": 0,
+            "buttons": 0,
+            "wheelX": 0,
+            "wheelY": 0
+          },
+          "hitTestTargetId": "a",
+          "expected": {
+            "focusedId": "a",
+            "pressedId": null,
+            "emittedKinds": ["engine", "action"],
+            "action": { "id": "a", "action": "press" }
+          }
+        }
+      ]
+    }
+  ]
+}

package/fixtures/text-measure/graphemes.json

@@ -0,0 +1,18 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    { "name": "ascii", "text": "A", "width": 1 },
+    { "name": "combining_sequence", "text": "a\u0301", "width": 1 },
+    { "name": "combining_mark_alone", "text": "\u0301", "width": 0 },
+    { "name": "zwj_alone", "text": "\u200d", "width": 0 },
+    { "name": "crlf_cluster", "text": "\r\n", "width": 0 },
+    { "name": "emoji_single", "text": "\ud83d\ude00", "width": 2 },
+    {
+      "name": "emoji_zwj_sequence_family",
+      "text": "\ud83d\udc68\u200d\ud83d\udc69\u200d\ud83d\udc67\u200d\ud83d\udc66",
+      "width": 2
+    },
+    { "name": "regional_indicator_pair_flag", "text": "\ud83c\uddfa\ud83c\uddf8", "width": 2 },
+    { "name": "cjk_wide", "text": "\u754c", "width": 2 }
+  ]
+}

package/fixtures/text-measure/invalid-surrogates.json

@@ -0,0 +1,12 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    { "name": "unpaired_high_surrogate", "text": "\ud800", "width": 1 },
+    { "name": "unpaired_low_surrogate", "text": "\udc00", "width": 1 },
+    { "name": "unpaired_high_then_ascii", "text": "\ud800A", "width": 2 },
+    { "name": "ascii_then_unpaired_low_then_ascii", "text": "A\udc00B", "width": 3 },
+    { "name": "valid_surrogate_pair_emoji", "text": "\ud83d\ude00", "width": 2 },
+    { "name": "broken_pair_high_then_ascii_then_low", "text": "\ud83dA\ude00", "width": 3 },
+    { "name": "two_unpaired_high_surrogates", "text": "\ud800\ud800", "width": 2 }
+  ]
+}

package/fixtures/text-measure/strings.json

@@ -0,0 +1,15 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    { "name": "empty", "text": "", "width": 0 },
+    { "name": "ascii_word", "text": "hello", "width": 5 },
+    { "name": "tab_not_special", "text": "a\tb", "width": 2 },
+    { "name": "newline_not_special", "text": "a\nb", "width": 2 },
+    { "name": "crlf_not_special", "text": "a\r\nb", "width": 2 },
+    { "name": "cjk_and_ascii", "text": "\u754ca", "width": 3 },
+    { "name": "emoji_in_string", "text": "A\ud83d\ude00B", "width": 4 },
+    { "name": "combining_clusters", "text": "a\u0301b", "width": 2 },
+    { "name": "leading_combining_mark", "text": "\u0301a", "width": 1 },
+    { "name": "two_flags", "text": "\ud83c\uddfa\ud83c\uddf8\ud83c\udde8\ud83c\udde6", "width": 4 }
+  ]
+}

package/fixtures/zrdl-v1/.gitkeep

@@ -0,0 +1 @@
+

package/fixtures/zrdl-v1/README.md

@@ -0,0 +1,78 @@
+# ZRDL v1 Golden Fixtures
+
+These fixtures are **byte-for-byte** golden buffers for the ZRDL v1 drawlist format.
+
+Reference: [ZRDL drawlists](../../../../docs/protocol/zrdl.md)
+
+They are generated deterministically by `@rezi-ui/core`’s ZRDL v1 builder and are
+checked by unit tests (no auto-update behavior).
+
+All integers are little-endian and all sections are 4-byte aligned. Any padding bytes
+are `0x00`.
+
+## Files
+
+### `golden/clear_only.bin`
+
+Command sequence:
+1. `clear()`
+
+Header expectations:
+- `cmd_count = 1`
+- `cmd_bytes = 8`
+- `strings_count = 0`, `strings_bytes_len = 0`
+- `blobs_count = 0`, `blobs_bytes_len = 0`
+- `total_size = 72`
+
+---
+
+### `golden/fill_rect.bin`
+
+Command sequence:
+1. `fillRect(1, 2, 3, 4, { fg: { r: 0, g: 255, b: 0 }, bold: true, underline: true })`
+
+Header expectations:
+- `cmd_count = 1`
+- `cmd_bytes = 40`
+- `strings_count = 0`, `strings_bytes_len = 0`
+- `blobs_count = 0`, `blobs_bytes_len = 0`
+- `total_size = 104`
+
+---
+
+### `golden/draw_text_interned.bin`
+
+Command sequence (tests deterministic string interning by first use):
+1. `drawText(0, 0, "hello", { fg: { r: 255, g: 255, b: 255 } })`
+2. `drawText(0, 1, "hello")` (same string; reuses `string_index=0`)
+3. `drawText(0, 2, "world", { bg: { r: 0, g: 0, b: 255 }, inverse: true })`
+
+String table expectations:
+- intern order: `"hello"` (index 0), then `"world"` (index 1)
+- string spans: `[off=0,len=5]`, `[off=5,len=5]`
+- `strings_bytes_len = 10` (`"helloworld"` in UTF-8)
+
+Header expectations:
+- `cmd_count = 3`
+- `cmd_bytes = 144`
+- `strings_count = 2`
+- `blobs_count = 0`, `blobs_bytes_len = 0`
+- `total_size = 236` (string bytes padded to 4-byte alignment)
+
+---
+
+### `golden/clip_nested.bin`
+
+Command sequence:
+1. `pushClip(0, 0, 10, 10)`
+2. `pushClip(1, 1, 8, 8)`
+3. `fillRect(2, 2, 3, 4, { bg: { r: 255, g: 0, b: 0 }, inverse: true })`
+4. `popClip()`
+5. `popClip()`
+
+Header expectations:
+- `cmd_count = 5`
+- `cmd_bytes = 104`
+- `strings_count = 0`, `strings_bytes_len = 0`
+- `blobs_count = 0`, `blobs_bytes_len = 0`
+- `total_size = 168`

package/fixtures/zrev-v1/.gitkeep

@@ -0,0 +1 @@
+

package/fixtures/zrev-v1/README.md

@@ -0,0 +1,102 @@
+# ZREV v1 Fixtures
+
+All fixtures are ZREV v1 event batches as specified by:
+- [Protocol overview](../../../../docs/protocol/index.md)
+- [ZREV event batches](../../../../docs/protocol/zrev.md)
+
+Paths are relative to `packages/testkit/fixtures/`.
+
+## Valid
+
+Each valid fixture parses with:
+- `ok === true`
+- `value.flags === 0`
+- exactly one decoded event in `value.events`
+
+### `zrev-v1/valid/key.bin`
+
+Expected event:
+```ts
+{ kind: "key", timeMs: 1000, key: 23, mods: 3, action: "down" }
+```
+
+### `zrev-v1/valid/text.bin`
+
+Expected event:
+```ts
+{ kind: "text", timeMs: 2000, codepoint: 0x41 }
+```
+
+### `zrev-v1/valid/paste.bin`
+
+Expected event:
+```ts
+{ kind: "paste", timeMs: 3000, bytes: Uint8Array.of(0x68,0x65,0x6c,0x6c,0x6f) } // "hello"
+```
+
+### `zrev-v1/valid/mouse.bin`
+
+Expected event:
+```ts
+{ kind: "mouse", timeMs: 4000, x: 10, y: 5, mouseKind: 1, mods: 0, buttons: 1, wheelX: 0, wheelY: -1 }
+```
+
+### `zrev-v1/valid/resize.bin`
+
+Expected event:
+```ts
+{ kind: "resize", timeMs: 5000, cols: 80, rows: 24 }
+```
+
+### `zrev-v1/valid/tick.bin`
+
+Expected event:
+```ts
+{ kind: "tick", timeMs: 6000, dtMs: 16 }
+```
+
+### `zrev-v1/valid/user.bin`
+
+Expected event:
+```ts
+{ kind: "user", timeMs: 7000, tag: 42, payload: Uint8Array.of(1,2,3) }
+```
+
+## Invalid
+
+Each invalid fixture parses with `ok === false` and the exact `error.code` and `error.offset` below.
+
+### `zrev-v1/invalid/truncated_header.bin`
+
+- `error.code === "ZR_TRUNCATED"`
+- `error.offset === 0`
+
+### `zrev-v1/invalid/truncated_record_header.bin`
+
+- `error.code === "ZR_TRUNCATED"`
+- `error.offset === 24`
+
+### `zrev-v1/invalid/truncated_payload.bin`
+
+- `error.code === "ZR_INVALID_RECORD"`
+- `error.offset === 24`
+
+### `zrev-v1/invalid/total_size_mismatch.bin`
+
+- `error.code === "ZR_SIZE_MISMATCH"`
+- `error.offset === 24`
+
+### `zrev-v1/invalid/misaligned_record_size.bin`
+
+- `error.code === "ZR_MISALIGNED"`
+- `error.offset === 24`
+
+### `zrev-v1/invalid/bad_magic.bin`
+
+- `error.code === "ZR_BAD_MAGIC"`
+- `error.offset === 0`
+
+### `zrev-v1/invalid/bad_version.bin`
+
+- `error.code === "ZR_UNSUPPORTED_VERSION"`
+- `error.offset === 4`

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@rezi-ui/testkit",
+  "version": "0.1.0-alpha.1",
+  "description": "Test utilities and fixtures for Rezi.",
+  "license": "Apache-2.0",
+  "homepage": "https://rtlzeromemory.github.io/Rezi/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RtlZeroMemory/Rezi.git",
+    "directory": "packages/testkit"
+  },
+  "bugs": {
+    "url": "https://github.com/RtlZeroMemory/Rezi/issues"
+  },
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "fixtures/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  }
+}