feat: route raw input through self-drawn runtime

Author: Roy Lin

README.md

@@ -294,10 +294,15 @@ independently.
   exposure, published only after host commit, and discarded on rejection
 - retained resize, fractional-scale, damage, occlusion, redraw, delayed
   acknowledgement, and surface-loss replay without changing semantic identity
+- raw pointer, keyboard, Tab-focus, hover, press, cancellation, wheel, stable
+  action bubbling, and reducer dispatch over `PlatformElementId`; failed
+  reducers restore the complete staged interaction session
 - an identical-frame fast path that performs no layout, scene, host, or
   presentation work, plus semantic-only commits that skip pixel presentation
-- a software Graphics presenter and shared `self_drawn_calculator` smoke that
-  preserve the reviewed 410x620 layout and scene fingerprints
+- a software Graphics presenter and interactive shared
+  `self_drawn_calculator` smoke that preserves the reviewed 410x620 layout and
+  scene fingerprints, routes eight fake-host events through four reducers, and
+  reaches the expected display value `10`
 
 ## Roadmap at a glance
 
@@ -309,7 +314,7 @@ independently.
 | M3 · Layout and Scene | Current | Generic calculator rectangle slice landed; full flex, stacking, redraw scheduling, cross-platform fingerprints, and thin-host presentation remain |
 | M4 · Text and interaction cutover | Planned | Shaping, glyphs, GUI-owned input, IME, accessibility bridges, overlays, and complete calculator scenarios |
 | M5 · Default cutover | Planned | Make self-drawn content the default, then delete the three legacy widget renderers |
-| H0-H5 · Thin platform hosts | H0 complete; H1 in progress | Atomic shared frames, transactional presentation, lifecycle recovery, zero-toolkit firewalls, and calculator pixels landed; portable input/reducer routing and a real raw-surface presenter remain |
+| H0-H5 · Thin platform hosts | H0 complete; H1 in progress | Atomic frames, lifecycle recovery, stable-id raw input/reducer routing, zero-toolkit firewalls, and an interactive calculator landed; a real raw-surface presenter remains |
 | T0-T5 · TSX native authoring | Proposed | Automatic JSX runtime, versioned Node-to-host session, state/event runtime, self-drawn native window, packages, and stable SDK |
 | M6-M8 · React Aria components | Catalog pinned; conformance planned | 51/51 families mapped, eight public parts explicitly missing, Button scene smoke only; full software and three-OS self-drawn evidence required |
 
@@ -327,7 +332,7 @@ The default set is `headless + authoring + design-system + software-reference`.
 | `software-reference` | Deterministic retained reference renderer; implies `graphics` |
 | `gpu` | Owned offscreen GPU renderer and readback path; implies `graphics` |
 | `platform-host` | H0 zero-widget records, transaction trait, recording host, and conformance tests; no Graphics or OS dependency |
-| `platform-runtime` | H1 Native IR/layout/scene/accessibility frame orchestration over `platform-host + graphics`; no OS toolkit dependency |
+| `platform-runtime` | H1 Native IR/layout/scene/accessibility frames plus stable-id raw input, interaction, action, and reducer routing over `platform-host + graphics`; no OS toolkit dependency |
 | `host-macos`, `host-windows` | H0 target markers over `platform-host`; OS shell implementations land in H2/H3 |
 | `host-linux-wayland`, `host-linux-x11`, `host-linux` | H0 target markers over `platform-host`; Linux implementations land in H4 |
 | `authoring` | SWC-backed RSX parsing, `ComponentCx`, and explicit component registries |
@@ -461,7 +466,7 @@ src/
 |                        LayoutSnapshot to Graphics Scene lowering
 |- render_contract.rs    executable field/role/event milestone inventory
 |- platform_host/        H0 zero-widget records, transactions, recorder, and validation
-|- platform_runtime/     H1 atomic frames, presentation lifecycle, and Graphics smoke
+|- platform_runtime/     H1 atomic frames, presentation lifecycle, stable-id input/reducers, and Graphics smoke
 |- backend/ + platform/  legacy execution/planning migration baseline
 `- *_native/             AppKit, GTK4, and WinUI control hosts during migration
 

docs/platform-hosts.md

@@ -1,8 +1,8 @@
 # Self-Drawn Platform Host Architecture
 
-Status: H0 complete; H1 atomic frame orchestration and presentation lifecycle
-in progress. Portable input/reducer routing and real desktop OS shells are not
-implemented yet.
+Status: H0 complete; H1 atomic frames, presentation lifecycle, and portable
+input/reducer routing implemented. The real Graphics raw-surface presenter and
+desktop OS shells are not implemented yet.
 
 Updated: 2026-08-02
 
@@ -44,15 +44,15 @@ The repository currently contains three distinct layers:
    system-service records; atomic revision transactions; a recording host; and
    executable dependency/source firewalls.
 
-The first H1 layer now connects committed Native IR, layout, scene, hit-region,
-and accessibility state to the new host contract. It also owns transactional
-scene preparation/publication plus resize, scale, damage, occlusion, redraw,
-delayed acknowledgement, and surface-loss replay. Portable hit/focus/action
-routing is the next H1 slice. Production H2-H4 hosts must then attach Graphics
-to real top-level surfaces and return OS services without constructing content
-controls. The old control backends are frozen until this replacement passes
-its gates. They are migration inputs, not the target architecture and not a
-base for new TSX work.
+The shared H1 layer connects committed Native IR, layout, scene, hit-region,
+interaction, and accessibility state to the new host contract. It owns
+transactional scene preparation/publication; resize, scale, damage, occlusion,
+redraw, delayed acknowledgement, and surface-loss replay; and stable-id raw
+pointer, keyboard, focus, wheel, action, and reducer routing. Production H2-H4
+hosts must next attach Graphics to real top-level surfaces and return OS
+services without constructing content controls. The old control backends are
+frozen until this replacement passes its gates. They are migration inputs, not
+the target architecture and not a base for new TSX work.
 
 ## Target Pipeline
 
@@ -207,18 +207,21 @@ tests/platform_host_firewall.rs
 src/platform_runtime/
 |- frame.rs             committed Native IR/layout/scene/a11y snapshot
 |- runtime.rs           atomic candidate preparation and host commit
-|- events.rs            resize, scale, occlusion, redraw, and ack lifecycle
+|- events.rs            lifecycle plus ordered input/reducer dispatch
+|- interaction_tree.rs  stable path index, hit testing, and focus order
+|- interaction.rs       portable state, actions, changes, and event context
+|- input.rs             pointer capture, hover, press, and cancellation
+|- keyboard_input.rs    keyboard activation, Tab focus, and wheel routing
 |- presenter.rs         raw-surface prepare/publish contract and recorder
 |- reference_presenter.rs
 |                       transactional software Graphics evidence
 |- accessibility.rs     stable layout-path semantic projection
-`- tests.rs             atomicity, no-op, recovery, and identity gates
+`- tests.rs             atomicity, input, reducer, recovery, and identity gates
 
 tests/platform_runtime_firewall.rs
 examples/self_drawn_calculator.rs
 
 Planned next:
-src/platform_runtime/interaction.rs
 src/platform_host/macos/
 src/platform_host/windows/
 src/platform_host/linux/
@@ -325,7 +328,8 @@ Evidence:
 
 ### H1 - Shared self-drawn window runtime
 
-Status: in progress; atomic frame and presentation-lifecycle slice landed.
+Status: in progress; atomic frame, presentation lifecycle, and portable
+input/reducer slices landed. The raw-surface presenter remains.
 
 Deliverables:
 
@@ -347,16 +351,22 @@ Landed evidence:
   changes commit accessibility without presenting identical pixels
 - resize, fractional scale, damage, occlusion, redraw, delayed acknowledgements,
   dropped frames, and surface loss replay the retained scene deterministically
-- 14 focused runtime/software tests and three recursive feature/source
+- raw pointer, keyboard, Tab-focus, hover, press, cancellation, and wheel input
+  route through committed hit regions and stable `PlatformElementId` paths;
+  ordered action batches retain frame revision, event sequence, bubbling
+  target, input context, and static action payload
+- reducer errors restore the staged interaction state and sequence before the
+  event is exposed as successful; successful frame reconciliation preserves
+  focused stable ids, while rejected frames do not touch them
+- 20 focused runtime/software tests and three recursive feature/source
   firewall tests pass without any legacy renderer or OS toolkit dependency
-- `self_drawn_calculator` commits the existing 410x620 shared Native IR and
-  reproduces layout fingerprint `16529597026056060935`, scene fingerprint
-  `2100550662756266801`, and deterministic RGBA pixels
+- `self_drawn_calculator` reproduces layout fingerprint
+  `16529597026056060935`, scene fingerprint `2100550662756266801`, and
+  deterministic RGBA pixels, then routes eight fake-host events through four
+  reducers and reaches display value `10`
 
 Remaining before H1 is complete:
 
-- route raw host input through portable hit testing, focus, interaction state,
-  action selection, and the application reducer without a legacy widget plan
 - implement the Graphics raw-surface presenter used by H2-H4; the landed
   presenter contract and software implementation deliberately expose no raw
   handle to components or common host records
@@ -505,8 +515,8 @@ or dependency-boundary evidence.
 
 ## First Reviewable Commit Sequence
 
-1. Finish H1 portable hit/focus/reducer routing and bind its presenter contract
-   to the Graphics raw-surface edge.
+1. Finish the H1 Graphics raw-surface presenter edge using the landed portable
+   hit/focus/reducer routing.
 2. Present the rectangle-only shared calculator through the Windows host.
 3. Present the same rectangle-only calculator through the macOS host.
 4. Present it through Wayland, then add the separately gated X11 fallback.

docs/roadmap.md

@@ -458,9 +458,9 @@ Evidence:
 
 ### H1 - Shared self-drawn window runtime
 
-Status: in progress; atomic frame orchestration and presentation lifecycle
-landed, while portable input/reducer routing and a real raw-surface presenter
-remain.
+Status: in progress; atomic frame orchestration, presentation lifecycle, and
+portable input/reducer routing landed, while a real raw-surface presenter
+remains.
 
 - transact scene, hit-region, accessibility, and window state as one committed
   host frame
@@ -479,16 +479,24 @@ Landed evidence:
   semantic-only changes avoid redundant presentation
 - resize, fractional scale, damage, occlusion, redraw, delayed acknowledgement,
   dropped-frame, and surface-loss tests preserve stable semantic ids
-- the shared 410x620 calculator passes through the runtime and deterministic
-  software presenter with its reviewed layout and scene fingerprints unchanged
-- 14 focused runtime/software tests plus three recursive H1 firewall tests are
+- raw pointer, keyboard, Tab-focus, hover, press, cancellation, and wheel events
+  resolve through committed layout hit regions and `PlatformElementId` paths;
+  action selection shares the semantic callback rules used during migration
+  without importing a widget blueprint or legacy runtime
+- ordered action batches carry the hit-tested frame revision and monotonic
+  event sequence, preserve bubbling current targets and static payloads, and
+  restore staged interaction state if an application reducer fails
+- the shared 410x620 calculator preserves its reviewed layout and scene
+  fingerprints, routes eight fake-host events through four reducer actions,
+  commits the resulting frames, and reaches display value `10`
+- 20 focused runtime/software tests plus three recursive H1 firewall tests are
   included in `just verify`
 
 Remaining H1 work:
 
-- portable hit testing, focus, interaction, action, and reducer routing from
-  raw host events without depending on the legacy widget blueprint/runtime
-- a Graphics raw-surface presenter implementation for the H2-H4 OS shells
+- a Graphics raw-surface presenter implementation for the H2-H4 OS shells;
+  richer text editing, IME, overlay gestures, and component-specific
+  interaction conformance remain explicit M4 and M6-M8 work
 
 Gates:
 
@@ -790,8 +798,8 @@ A component or subsystem is complete only when:
 
 ## Immediate Commit Sequence
 
-1. Finish H1 portable event/reducer routing and the Graphics raw-surface
-   presenter edge.
+1. Finish the H1 Graphics raw-surface presenter edge now that portable
+   event/reducer routing is executable.
 2. Present the generic rectangle slice through the H2 Windows Win32 host.
 3. Present the same slice through the H3 macOS system-shell host.
 4. Present it through H4 Wayland, then the separately gated X11 fallback.

docs/tsx-native-runtime.md

@@ -321,7 +321,7 @@ window control use typed session commands with capability checks.
 | style object | scalar style map | `CompiledStyleValue` conversion |
 | portable props | resolved compiled props | semantic component and intrinsic mapping |
 | `aria-*`, HTML, `data-*` | typed fields or attribute map | accessibility and metadata projection |
-| event callback | action id in `events` | action registration and `EventRouter` |
+| event callback | action id in `events` | shared semantic action selection and the stable-id self-drawn interaction session |
 | `Window` | frame `window` metadata | platform window session |
 | custom function component | evaluated before transport | no native node |