@rezi-ui/testkit 0.1.0-alpha.1

package/fixtures/layout/hit_test_ties.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "name": "Overlapping siblings: later sibling wins (preorder last-wins)",
+      "tree": {
+        "ref": "root",
+        "kind": "column",
+        "props": {},
+        "children": [
+          { "ref": "a", "kind": "button", "props": { "id": "a", "label": "A" } },
+          { "ref": "b", "kind": "button", "props": { "id": "b", "label": "B" } }
+        ]
+      },
+      "layoutRects": {
+        "root": { "x": 0, "y": 0, "w": 4, "h": 1 },
+        "a": { "x": 0, "y": 0, "w": 4, "h": 1 },
+        "b": { "x": 0, "y": 0, "w": 4, "h": 1 }
+      },
+      "points": [{ "x": 1, "y": 0, "expectedId": "b" }]
+    },
+    {
+      "name": "Multiple overlaps: last in preorder wins (a < b < c)",
+      "tree": {
+        "ref": "root",
+        "kind": "column",
+        "props": {},
+        "children": [
+          { "ref": "a", "kind": "button", "props": { "id": "a", "label": "A" } },
+          { "ref": "b", "kind": "button", "props": { "id": "b", "label": "B" } },
+          { "ref": "c", "kind": "button", "props": { "id": "c", "label": "C" } }
+        ]
+      },
+      "layoutRects": {
+        "root": { "x": 0, "y": 0, "w": 4, "h": 1 },
+        "a": { "x": 0, "y": 0, "w": 4, "h": 1 },
+        "b": { "x": 0, "y": 0, "w": 4, "h": 1 },
+        "c": { "x": 0, "y": 0, "w": 4, "h": 1 }
+      },
+      "points": [{ "x": 1, "y": 0, "expectedId": "c" }]
+    }
+  ]
+}

package/fixtures/layout/layout_cases.json

@@ -0,0 +1,138 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "name": "row_pad_gap_start",
+      "axis": "row",
+      "viewport": { "x": 0, "y": 0, "w": 10, "h": 3 },
+      "tree": {
+        "ref": "root",
+        "kind": "row",
+        "props": { "pad": 1, "gap": 1, "align": "start" },
+        "children": [
+          { "ref": "t1", "kind": "text", "text": "hi", "props": {} },
+          { "ref": "b1", "kind": "button", "props": { "id": "b1", "label": "ok" } },
+          { "ref": "s1", "kind": "spacer", "props": { "size": 2 } }
+        ]
+      },
+      "expect": {
+        "rects": {
+          "root": { "x": 0, "y": 0, "w": 9, "h": 3 },
+          "t1": { "x": 1, "y": 1, "w": 2, "h": 1 },
+          "b1": { "x": 4, "y": 1, "w": 4, "h": 1 },
+          "s1": { "x": 9, "y": 1, "w": 0, "h": 0 }
+        }
+      }
+    },
+    {
+      "name": "column_center_cross_axis",
+      "axis": "column",
+      "viewport": { "x": 0, "y": 0, "w": 6, "h": 4 },
+      "tree": {
+        "ref": "root",
+        "kind": "column",
+        "props": { "align": "center" },
+        "children": [
+          { "ref": "t1", "kind": "text", "text": "aa", "props": {} },
+          { "ref": "t2", "kind": "text", "text": "\u754c", "props": {} },
+          { "ref": "s1", "kind": "spacer", "props": { "size": 2 } }
+        ]
+      },
+      "expect": {
+        "rects": {
+          "root": { "x": 0, "y": 0, "w": 2, "h": 4 },
+          "t1": { "x": 0, "y": 0, "w": 2, "h": 1 },
+          "t2": { "x": 0, "y": 1, "w": 2, "h": 1 },
+          "s1": { "x": 1, "y": 2, "w": 0, "h": 2 }
+        }
+      }
+    },
+    {
+      "name": "box_border_pad_children_column",
+      "axis": "column",
+      "viewport": { "x": 0, "y": 0, "w": 10, "h": 5 },
+      "tree": {
+        "ref": "root",
+        "kind": "box",
+        "props": { "border": "single", "pad": 1, "title": "ignored" },
+        "children": [
+          { "ref": "b1", "kind": "button", "props": { "id": "b1", "label": "X" } },
+          { "ref": "t1", "kind": "text", "text": "hi", "props": {} }
+        ]
+      },
+      "expect": {
+        "rects": {
+          "root": { "x": 0, "y": 0, "w": 7, "h": 5 },
+          "b1": { "x": 2, "y": 2, "w": 3, "h": 1 },
+          "t1": { "x": 2, "y": 3, "w": 0, "h": 0 }
+        }
+      }
+    },
+    {
+      "name": "row_exhaustion_zero_sized_children",
+      "axis": "row",
+      "viewport": { "x": 0, "y": 0, "w": 3, "h": 1 },
+      "tree": {
+        "ref": "root",
+        "kind": "row",
+        "props": { "gap": 1 },
+        "children": [
+          { "ref": "t1", "kind": "text", "text": "ab", "props": {} },
+          { "ref": "b1", "kind": "button", "props": { "id": "b1", "label": "Z" } },
+          { "ref": "t2", "kind": "text", "text": "x", "props": {} }
+        ]
+      },
+      "expect": {
+        "rects": {
+          "root": { "x": 0, "y": 0, "w": 2, "h": 1 },
+          "t1": { "x": 0, "y": 0, "w": 2, "h": 1 },
+          "b1": { "x": 3, "y": 0, "w": 0, "h": 0 },
+          "t2": { "x": 3, "y": 0, "w": 0, "h": 0 }
+        }
+      }
+    },
+    {
+      "name": "row_pad_gap_with_input_capped",
+      "axis": "row",
+      "viewport": { "x": 0, "y": 0, "w": 10, "h": 3 },
+      "tree": {
+        "ref": "root",
+        "kind": "row",
+        "props": { "pad": 1, "gap": 1, "align": "start" },
+        "children": [
+          { "ref": "t1", "kind": "text", "text": "hi", "props": {} },
+          { "ref": "i1", "kind": "input", "props": { "id": "i1", "value": "abcdefghij" } }
+        ]
+      },
+      "expect": {
+        "rects": {
+          "root": { "x": 0, "y": 0, "w": 10, "h": 3 },
+          "t1": { "x": 1, "y": 1, "w": 2, "h": 1 },
+          "i1": { "x": 4, "y": 1, "w": 5, "h": 1 }
+        }
+      }
+    },
+    {
+      "name": "input_empty_intrinsic_min_2",
+      "axis": "column",
+      "viewport": { "x": 0, "y": 0, "w": 4, "h": 1 },
+      "tree": { "ref": "root", "kind": "input", "props": { "id": "i1", "value": "" } },
+      "expect": { "rects": { "root": { "x": 0, "y": 0, "w": 2, "h": 1 } } }
+    },
+    {
+      "name": "invalid_props_row_align",
+      "axis": "row",
+      "viewport": { "x": 0, "y": 0, "w": 5, "h": 1 },
+      "tree": {
+        "ref": "root",
+        "kind": "row",
+        "props": { "align": "nope" },
+        "children": [{ "ref": "t1", "kind": "text", "text": "x", "props": {} }]
+      },
+      "expectFatal": {
+        "code": "ZRUI_INVALID_PROPS",
+        "detail": "row.align must be one of \"start\" | \"center\" | \"end\" | \"stretch\""
+      }
+    }
+  ]
+}

package/fixtures/routing/.gitkeep

@@ -0,0 +1 @@
+

package/fixtures/routing/input_editing.json

@@ -0,0 +1,316 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "name": "basic insert/move/delete (docs/18)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "",
+      "initialCursor": 0,
+      "steps": [
+        {
+          "event": { "kind": "text", "timeMs": 0, "codepoint": 97 },
+          "expected": {
+            "value": "a",
+            "cursor": 1,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "a",
+              "cursor": 1
+            }
+          }
+        },
+        {
+          "event": { "kind": "text", "timeMs": 1, "codepoint": 98 },
+          "expected": {
+            "value": "ab",
+            "cursor": 2,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "ab",
+              "cursor": 2
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 22, "mods": 0, "action": "down" },
+          "expected": { "value": "ab", "cursor": 1, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 3, "key": 4, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "b",
+            "cursor": 0,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "b",
+              "cursor": 0
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 4, "key": 11, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "",
+            "cursor": 0,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "",
+              "cursor": 0
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 5, "key": 12, "mods": 0, "action": "repeat" },
+          "expected": { "value": "", "cursor": 0, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 6, "key": 13, "mods": 0, "action": "down" },
+          "expected": { "value": "", "cursor": 0, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 7, "key": 23, "mods": 0, "action": "up" },
+          "expected": { "value": "", "cursor": 0, "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "tab/enter + newline ignored (docs/18 single-line)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "hi",
+      "initialCursor": 2,
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "value": "hi", "cursor": 2, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 2, "mods": 0, "action": "down" },
+          "expected": { "value": "hi", "cursor": 2, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "text", "timeMs": 2, "codepoint": 10 },
+          "expected": { "value": "hi", "cursor": 2, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "text", "timeMs": 3, "codepoint": 33 },
+          "expected": {
+            "value": "hi!",
+            "cursor": 3,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "hi!",
+              "cursor": 3
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "combining mark grapheme editing (docs/18 boundaries)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "a\u0301b",
+      "initialCursor": 3,
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 22, "mods": 0, "action": "down" },
+          "expected": { "value": "a\u0301b", "cursor": 2, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 22, "mods": 0, "action": "down" },
+          "expected": { "value": "a\u0301b", "cursor": 0, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 23, "mods": 0, "action": "repeat" },
+          "expected": { "value": "a\u0301b", "cursor": 2, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 3, "key": 4, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "b",
+            "cursor": 0,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "b",
+              "cursor": 0
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 4, "key": 11, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "",
+            "cursor": 0,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "",
+              "cursor": 0
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "ZWJ emoji cluster movement + deletion (docs/18 GB11)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "\ud83d\udc69\u200d\ud83d\udcbbx",
+      "initialCursor": 6,
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 4, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "\ud83d\udc69\u200d\ud83d\udcbb",
+            "cursor": 5,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "\ud83d\udc69\u200d\ud83d\udcbb",
+              "cursor": 5
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 22, "mods": 0, "action": "repeat" },
+          "expected": {
+            "value": "\ud83d\udc69\u200d\ud83d\udcbb",
+            "cursor": 0,
+            "emittedKinds": ["engine"]
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 11, "mods": 0, "action": "down" },
+          "expected": {
+            "value": "",
+            "cursor": 0,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "",
+              "cursor": 0
+            }
+          }
+        }
+      ]
+    },
+    {
+      "name": "paste strips CR/LF and replaces invalid UTF-8 (docs/18)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "hi",
+      "initialCursor": 2,
+      "steps": [
+        {
+          "event": { "kind": "paste", "timeMs": 0, "bytes": [65, 10, 66, 13, 195, 40] },
+          "expected": {
+            "value": "hiAB\ufffd(",
+            "cursor": 6,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "hiAB\ufffd(",
+              "cursor": 6
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 12, "mods": 0, "action": "down" },
+          "expected": { "value": "hiAB\ufffd(", "cursor": 0, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "paste", "timeMs": 2, "bytes": [10, 13] },
+          "expected": { "value": "hiAB\ufffd(", "cursor": 0, "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "invalid text codepoints map to U+FFFD (docs/18)",
+      "enabledById": { "inputId": true },
+      "initialFocusedId": "inputId",
+      "initialValue": "",
+      "initialCursor": 0,
+      "steps": [
+        {
+          "event": { "kind": "text", "timeMs": 0, "codepoint": 1114112 },
+          "expected": {
+            "value": "\ufffd",
+            "cursor": 1,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "\ufffd",
+              "cursor": 1
+            }
+          }
+        },
+        {
+          "event": { "kind": "text", "timeMs": 1, "codepoint": 55296 },
+          "expected": {
+            "value": "\ufffd\ufffd",
+            "cursor": 2,
+            "emittedKinds": ["engine", "action"],
+            "action": {
+              "kind": "action",
+              "id": "inputId",
+              "action": "input",
+              "value": "\ufffd\ufffd",
+              "cursor": 2
+            }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 22, "mods": 0, "action": "down" },
+          "expected": { "value": "\ufffd\ufffd", "cursor": 1, "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "unfocused/disabled input yields no edits (docs/18)",
+      "enabledById": { "inputId": false },
+      "initialFocusedId": "inputId",
+      "initialValue": "x",
+      "initialCursor": 1,
+      "steps": [
+        {
+          "event": { "kind": "text", "timeMs": 0, "codepoint": 97 },
+          "expected": { "value": "x", "cursor": 1, "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 4, "mods": 0, "action": "down" },
+          "expected": { "value": "x", "cursor": 1, "emittedKinds": ["engine"] }
+        }
+      ]
+    }
+  ]
+}

package/fixtures/routing/key_routing.json

@@ -0,0 +1,81 @@
+{
+  "schemaVersion": 1,
+  "cases": [
+    {
+      "name": "Tab / Shift+Tab traversal + wrap-around (docs/10 Example A)",
+      "focusList": ["a", "b", "c", "d"],
+      "enabledById": { "a": true, "b": true, "c": true, "d": true },
+      "initialFocusedId": null,
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "b", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "c", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 3, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "d", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 4, "key": 3, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "a", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 5, "key": 3, "mods": 1, "action": "down" },
+          "expected": { "focusedId": "d", "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "Disabled focus + press suppression (docs/10 + docs/11)",
+      "focusList": ["a"],
+      "enabledById": { "a": true, "b": false },
+      "initialFocusedId": "b",
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 2, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "b", "emittedKinds": ["engine"] }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 32, "mods": 0, "action": "down" },
+          "expected": { "focusedId": "b", "emittedKinds": ["engine"] }
+        }
+      ]
+    },
+    {
+      "name": "Enter/Space press emits action immediately after engine (docs/10 + docs/14)",
+      "focusList": ["a"],
+      "enabledById": { "a": true },
+      "initialFocusedId": "a",
+      "steps": [
+        {
+          "event": { "kind": "key", "timeMs": 0, "key": 2, "mods": 0, "action": "down" },
+          "expected": {
+            "focusedId": "a",
+            "emittedKinds": ["engine", "action"],
+            "action": { "id": "a", "action": "press" }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 1, "key": 32, "mods": 0, "action": "down" },
+          "expected": {
+            "focusedId": "a",
+            "emittedKinds": ["engine", "action"],
+            "action": { "id": "a", "action": "press" }
+          }
+        },
+        {
+          "event": { "kind": "key", "timeMs": 2, "key": 2, "mods": 0, "action": "up" },
+          "expected": { "focusedId": "a", "emittedKinds": ["engine"] }
+        }
+      ]
+    }
+  ]
+}