docs: pin React Aria 1.19 behavior deltas

Author: Roy Lin

docs/react-aria-component-matrix.json

@@ -1,11 +1,37 @@
 {
-  "schema_version": 1,
+  "schema_version": 2,
   "upstream": {
     "package": "react-aria-components",
     "version": "1.19.0",
     "release_date": "2026-06-18",
     "catalog_url": "https://react-aria.adobe.com/",
-    "release_url": "https://react-aria.adobe.com/releases/v1-19-0"
+    "release_url": "https://react-aria.adobe.com/releases/v1-19-0",
+    "contract_deltas": [
+      {
+        "id": "grid-tree-embedded-interaction",
+        "families": ["GridList", "Tree"],
+        "milestone": "M7",
+        "requirement": "Support keyboardNavigationBehavior for keyboard traversal between rows and embedded interactive controls."
+      },
+      {
+        "id": "menu-action-key-value",
+        "families": ["Menu"],
+        "milestone": "M7",
+        "requirement": "Deliver both the item key and action value through Menu onAction without losing stable native identity."
+      },
+      {
+        "id": "popover-arbitrary-target-rect",
+        "families": ["Popover"],
+        "milestone": "M7",
+        "requirement": "Position Popover against an arbitrary target or character rectangle equivalent to getTargetRect."
+      },
+      {
+        "id": "drag-types-multiple-wildcards",
+        "families": ["DropZone", "GridList", "ListBox", "Table", "Tree"],
+        "milestone": "M7",
+        "requirement": "Match multiple MIME types and wildcard patterns in portable drag and drop type negotiation."
+      }
+    ]
   },
   "acceptance_dimensions": [
     "authoring",

docs/react-aria-native.md

@@ -35,6 +35,12 @@ The matrix currently establishes these facts without overstating parity:
 - no family may be marked `conformant` without software, macOS, Windows, and
   Linux evidence in addition to its semantic and accessibility tests.
 
+The version gate also records behavior changes that do not add a top-level
+family. For 1.19.0 these are embedded-control keyboard navigation in GridList
+and Tree, Menu actions carrying both key and value, Popover positioning against
+an arbitrary target rectangle, and multi-type/wildcard drag negotiation. They
+are executable matrix obligations, not optional release notes.
+
 `tests/react_aria_component_matrix.rs` schema-checks the file, pins the exact
 official family list, verifies every available A3S mapping against the built-in
 component registry, and rejects unsupported completion claims. Each upstream
@@ -115,6 +121,17 @@ migration evidence and are removed after equivalent self-drawn host gates pass.
 
 The first shared interaction milestone is available in the portable runtime:
 
+- `SelfDrawnWindowRuntime` builds its hit/focus/action index from the atomically
+  committed Native IR and layout snapshot. Raw pointer, keyboard, Tab-focus,
+  hover, press, cancellation, wheel, bubbling, and reducer dispatch retain
+  stable `PlatformElementId` identity without importing a widget blueprint or
+  platform content-control runtime.
+- `SelfDrawnActionInvocation` carries the committed frame revision, monotonic
+  event sequence, target/current-target pair, modality and input context, plus
+  static action payloads. Reducer failure restores the staged interaction
+  session and sequence; keyed successful frames reconcile focus and transient
+  state by stable id.
+
 - `NativeInputModality` represents keyboard, mouse, touch, pen, virtual, and
   unknown input.
 - `NativeEventContext` carries modality, key modifiers, local position,
@@ -547,7 +564,7 @@ props:
 | Priority | Area | Required outcome |
 | --- | --- | --- |
 | P0 | Self-drawn component accounting | Keep all 51 React Aria 1.19.0 families in the executable matrix, implement the eight recorded public-part gaps, and require every upstream catalog delta to update code, matrix, tests, and milestones together. |
-| P0 | Shared self-drawn interaction | Route raw host input through hit testing, focus, interaction, action, and reducer state so component behavior no longer depends on AppKit, GTK4, or WinUI content controls. |
+| P0 | Shared self-drawn interaction | Extend the landed stable-id pointer, keyboard, Tab-focus, hover, press, cancellation, wheel, bubbling, and reducer path with long press, move/drag, focus-scope restoration, overlay gestures, text editing/IME, and accessibility activation. |
 | P0 | Native input conformance | WinUI's complete 98-case V1 manifest passes real OS automation. Populate the AppKit and GTK4 manifests with platform-run mouse, pen, touch where applicable, keyboard, assistive activation, disabled, cancellation, and keyed-rerender fixtures for every role currently marked native; then close or retain evidence-backed menu/item exceptions. |
 | P1 | Event propagation | Add platform-run conformance fixtures for conditional `Stop`/`Continue` across nested native controls. |
 | P1 | Focus management | Add platform-run conformance fixtures for post-mount `autoFocus`, nested containment, and restoration. |

docs/roadmap.md

@@ -703,6 +703,9 @@ self-drawn conformance.
   typeahead, range selection, and collection mutation
 - implement ToastList and ToastContent and preserve drag/drop, focus-scope,
   selection-indicator, collection-section, and load-more semantic parts
+- close the executable 1.19.0 behavior deltas: embedded-control keyboard
+  navigation for GridList/Tree, Menu action key plus value, arbitrary Popover
+  target rectangles, and multi-MIME/wildcard drag type negotiation
 
 ### M8 - Date, color, tables, and advanced data
 

tests/react_aria_component_matrix.rs

@@ -76,6 +76,16 @@ struct Upstream {
     release_date: String,
     catalog_url: String,
     release_url: String,
+    contract_deltas: Vec<ContractDelta>,
+}
+
+#[derive(Debug, Deserialize)]
+#[serde(deny_unknown_fields)]
+struct ContractDelta {
+    id: String,
+    families: Vec<String>,
+    milestone: String,
+    requirement: String,
 }
 
 #[derive(Debug, Deserialize)]
@@ -106,7 +116,7 @@ fn matrix() -> ComponentMatrix {
 fn matrix_pins_the_complete_official_1_19_component_catalog() {
     let matrix = matrix();
 
-    assert_eq!(matrix.schema_version, 1);
+    assert_eq!(matrix.schema_version, 2);
     assert_eq!(matrix.upstream.package, "react-aria-components");
     assert_eq!(matrix.upstream.version, "1.19.0");
     assert_eq!(matrix.upstream.release_date, "2026-06-18");
@@ -115,6 +125,30 @@ fn matrix_pins_the_complete_official_1_19_component_catalog() {
         matrix.upstream.release_url,
         "https://react-aria.adobe.com/releases/v1-19-0"
     );
+    let contract_ids = matrix
+        .upstream
+        .contract_deltas
+        .iter()
+        .map(|delta| delta.id.as_str())
+        .collect::<BTreeSet<_>>();
+    assert_eq!(
+        contract_ids,
+        BTreeSet::from([
+            "drag-types-multiple-wildcards",
+            "grid-tree-embedded-interaction",
+            "menu-action-key-value",
+            "popover-arbitrary-target-rect",
+        ])
+    );
+    for delta in &matrix.upstream.contract_deltas {
+        assert_eq!(delta.milestone, "M7");
+        assert!(!delta.requirement.trim().is_empty());
+        assert!(!delta.families.is_empty());
+        assert!(delta
+            .families
+            .iter()
+            .all(|family| OFFICIAL_COMPONENT_FAMILIES.contains(&family.as_str())));
+    }
 
     let names = matrix
         .families