@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/src/DropdownMenu/DropdownMenuItem.spec.md

@@ -1,215 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:DropdownMenuItem
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-31
-owners: [cixzhang]
-review_triggers: [public-api, behavior, accessibility, theming, testing]
-verified_by:
-  [
-    packages/core/src/DropdownMenu/DropdownMenu.test.tsx,
-    packages/core/src/DropdownMenu/__tests__/Menu.a11y.test.tsx,
-    packages/core/src/theme/themingTargets.test.ts,
-    apps/storybook/rtl-audit/verified-not-applicable.json,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: [family:navigation-destinations]
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-theming-surface,
-    architecture:component-test-sufficiency,
-    architecture:interaction-modality,
-  ]
-contributing: []
-system_specs: [spec:AST-020]
----
-
-# DropdownMenuItem component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                                                           |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | One compound pointer-menu row for an action or destination, with label, supporting content, disabled state, destructive paint, optional close suppression, root inputs, and a forwarded ref.       |
-| Behavior                | The parent menu owns roving focus and keyboard activation; the row owns click order, disabled suppression, close-on-select, destination handoff, hover focus, and its visible content composition. |
-| End-user impact         | Actions and destinations preserve keyboard, pointer, and browser link behavior while unavailable rows remain inert and destructive actions remain identifiable.                                    |
-| Builder impact          | Destinations use `href`; supporting content stays non-interactive; `hasCloseOnSelect=false` is reserved for in-place result feedback.                                                              |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change.                                                                                                                                          |
-| Review checks           | Reject nested controls, disabled activation, lost destination safety, broken modified-click behavior, dropped root inputs, a second keyboard owner, or state/target reflection moved off the row.  |
-| Governing rules         | `family:navigation-destinations/FR1–FR5`; `architecture:public-component-api/INV5–INV9`; `architecture:component-theming-surface/INV3–INV6`; `spec:AST-020/FR1,FR2,FR6,FR15`.                      |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-DropdownMenuItem renders one compound-mode row in the pointer presentation of
-DropdownMenu. It owns the row element, content slots, action-versus-destination
-branch, activation order, disabled and destructive state, root composition, and
-`dropdown-menu-item` theme target. DropdownMenu owns the surrounding menu,
-keyboard collection, focus movement, typeahead, presentation choice, and close
-lifecycle.
-
-## Compatibility and migration
-
-- Released default preserved: yes.
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change.
-- Controlled/uncontrolled behavior: not applicable.
-- Migration decision: none.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- One `role="menuitem"` root and its label, description, icon, end content,
-  disabled state, destructive variant, ref, supported host inputs, and styling inputs.
-- Action callback order and `hasCloseOnSelect` behavior.
-- Link-row rendering, destination handoff, modified/middle-click preservation,
-  target and relationship handling, and disabled-link inertness.
-- Pointer hover focus and the row's press/hover/focus paint.
-- The `dropdown-menu-item` target and its size/variant state reflection.
-
-**Does not own / non-goals**
-
-- Menu naming, open/close state, focus entry, roving focus, typeahead, and keyboard
-  click synthesis — owned by DropdownMenu and its shared hooks.
-- Touch and bottom-sheet row rendering — the parent presentation delegates those
-  rows to List.
-- Destination acceptance and blocking — owned by `family:navigation-destinations`.
-- Interactive controls inside label, description, or end content. Controls belong
-  beside the menu or as separate rows.
-
-## Public concepts
-
-| Concept      | Closed values or states                             | Meaning                                                                        | Availability                | Default | Owner                           | Stability | Invalid-value behavior                                       |
-| ------------ | --------------------------------------------------- | ------------------------------------------------------------------------------ | --------------------------- | ------- | ------------------------------- | --------- | ------------------------------------------------------------ |
-| Row act      | action; destination                                 | Runs a callback or exposes a browser/router destination from the row itself.   | Every enabled row           | action  | component and navigation family | stable    | A blocked destination is inert; a disabled link has no href. |
-| Availability | enabled; disabled                                   | Controls whether the row can receive focus or activate.                        | Every row                   | enabled | component and parent menu       | stable    | Disabled suppresses activation and destination.              |
-| Close policy | close; remain open                                  | Whether successful activation closes the parent menu.                          | Action and destination rows | close   | component                       | stable    | Omission closes.                                             |
-| Visual state | default; destructive; hover; focus; press; disabled | Paints row meaning and interaction state without changing menuitem semantics.  | Pointer row                 | default | component                       | stable    | Unknown variants are rejected by the public type.            |
-| Root surface | ref; DOM/data/ARIA; class/style/xstyle/events       | Extends the row root while preserving component-owned role and keyboard state. | Every pointer row           | omitted | public component API            | stable    | Accepted inputs compose; owned role/tab stop remain fixed.   |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                                                                                                                                                                                    | Basis                                                              |
-| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ |
-| FR1 | The pointer row exposes one `role="menuitem"` root. Label, description, icon, and end content are presentational content of that row rather than nested controls.                                                                                                                                                                            | `spec:AST-020` FR15; current source and docs                       |
-| FR2 | Enabled activation runs the row callback before optional close. Disabled rows expose `aria-disabled=true`, remove link destinations, and run neither callback nor close.                                                                                                                                                                     | Current behavior and tests                                         |
-| FR3 | A destination row renders as the link root through LinkProvider. Plain activation runs the callback then closes and navigates; a modified click does not run the callback, closes the menu, and is left to the browser; a middle click closes the menu (`hasCloseOnSelect`), then runs the caller's `onAuxClick`; blocked schemes are inert. | `family:navigation-destinations` FR1–FR5; current tests            |
-| FR4 | The parent menu is the only keyboard owner. It synthesizes click activation with modifiers, moves focus, and runs typeahead; the row focuses itself on mouse hover and creates no second roving-focus model.                                                                                                                                 | `architecture:interaction-modality`; current parent tests          |
-| FR5 | The visible root carries `dropdown-menu-item`; size and destructive state reflect on it (`data-size`, `data-variant`); semantic tokens own layout and paint before caller styling inputs compose.                                                                                                                                            | `architecture:component-theming-surface`; current source and tests |
-| FR6 | Ref, supported host attributes and handlers, `className`, `style`, and `xstyle` reach or compose on the row root without replacing owned role, tab stop, disabled behavior, destination handling, or activation order.                                                                                                                       | `architecture:public-component-api` INV5–INV9; current tests       |
-| FR7 | Disabled menu rows are inert, and the parent menu's arrow keys and typeahead skip them. Shipped behavior, not a requirement until OQ1 is ruled.                                                                                                                                                                                              | `component:DropdownMenu` FR17, OQ1                                 |
-| FR8 | Keyboard focus paints the row's hover background with no outline, about 1.1:1 against the menu surface in the default themes; in forced-colors mode that background is not drawn, so focus has no visible indicator. Shipped behavior; the focus treatment is OQ2.                                                                           | Current source                                                     |
-
-### Allowed variation
-
-- **AV1 — Content.** Non-interactive icons, text, descriptions, shortcuts, badges,
-  and status text may vary without changing the row's menuitem semantics.
-- **AV2 — Theme paint.** A theme may restyle the target's admitted properties while
-  preserving visible state distinctions and forced-colors focus.
-- **AV3 — Parent size.** The parent menu supplies `sm`, `md`, or `lg`; the row reflects
-  that state and may vary its tokenized insets.
-
-### Representative states
-
-| State                  | Required invariant                                                                  | Allowed variation                            |
-| ---------------------- | ----------------------------------------------------------------------------------- | -------------------------------------------- |
-| Enabled action         | Callback runs, then close follows the close policy.                                 | Content, size, and visual variant.           |
-| In-place result action | Callback runs and the menu remains open.                                            | Label/end content may update.                |
-| Disabled action        | `aria-disabled=true`; callback, hover focus, and close are suppressed.              | Content remains visible.                     |
-| Destination            | One anchor root preserves safe destination and browser activation behavior.         | Target, rel, router provider, and content.   |
-| Destructive            | Error-role paint applies to label, icon, and description without changing behavior. | Other row content remains consumer-authored. |
-| Keyboard focus         | Parent focus lands on the row and remains visible.                                  | Exact theme-owned paint may vary.            |
-| RTL / narrow viewport  | Logical insets and start alignment follow direction without horizontal overflow.    | Menu placement remains parent-owned.         |
-
-### Transformation and precedence order
-
-- **ORD1 — Activation.** Disabled guard → browser-navigation classification → row
-  callback where applicable → close policy → browser/router navigation.
-- **ORD2 — Root composition.** Parent size → base row styles → variant/disabled state
-  → caller `xstyle`; target metadata and caller class/style compose on the same root.
-
-### Performance and resources
-
-- **PR1 — Shared press listeners.** The row shares the press controller's
-  window and document listeners; it adds no per-row listener, observer, timer,
-  or request.
-
-## Accessibility contract
-
-- **AR1 — Menu item semantics.** The root is one named `menuitem`; supporting content
-  does not introduce a nested interactive descendant.
-- **AR2 — Disabled state.** Disabled rows expose state and cannot activate or navigate.
-- **AR3 — Keyboard ownership.** DropdownMenu owns focus collection and activation;
-  the item remains a single row in that model.
-- **AR4 — Focus perception.** Focus paints a low-contrast row background in
-  ordinary themes and no indicator in forced-colors mode (FR8, OQ2).
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                                                  | Representation authority                        | Hierarchy role | Component contract |
-| ---------------- | ----------------------------------------------------------------------------------- | ----------------------------------------------- | -------------- | ------------------ |
-| Row              | One full-width action/destination target with tokenized insets and start alignment. | Current source and parent menu composition      | prominent      | FR1–FR6            |
-| Supporting text  | Description and end content remain subordinate to the row label.                    | Delegated Item layout and current consumer docs | supporting     | FR1                |
-| Interaction      | Hover, focus, press, disabled, and destructive states remain distinguishable.       | Current source; forced-colors focus is OQ2      | prominent      | FR5, FR8, AR4      |
-
-No component-local visual decision is recorded.
-
-## Family and system relationships
-
-- `family:navigation-destinations` owns destination acceptance and blocked-scheme
-  behavior; this component supplies the destination-bearing row.
-- `architecture:public-component-api` owns root input composition, refs, and released
-  compatibility.
-- `architecture:component-theming-surface` owns target placement and state reflection.
-- `architecture:component-test-sufficiency` owns proportionate observable evidence.
-- `architecture:interaction-modality` and DropdownMenu own parent keyboard behavior.
-- `spec:AST-020` supplies WCAG/APG adoption and evidence-layer boundaries.
-
-## Verification map
-
-| Contract       | Verification                                                                                                                                                                                                                                                                                                               | Representative states                                     | Mutation or failure expectation                                                                                                                                                                | Audit section                          |
-| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
-| FR1, AR1       | `DropdownMenu.test.tsx` compound-mode cases ("renders JSX children as menu items", "renders endContent after the item label"); `Menu.a11y.test.tsx` menu binding cases                                                                                                                                                     | Action row with content                                   | A row that is not a `menuitem` or loses its content fails. Evidence gap: no test asserts that supporting content holds no nested control.                                                      | `audit:DropdownMenuItem/semantics`     |
-| FR2, AR2, ORD1 | `DropdownMenu.test.tsx` item cases ("calls onClick when item is clicked", "closes the menu after an item is activated", "keeps the menu open when the item opts out of closing", "does not call onClick when disabled"), "has aria-disabled on disabled compound items", and "a disabled href row renders no address"      | Enabled, disabled, close and stay-open                    | A callback while disabled, a missing `aria-disabled`, a close that ignores the policy, or a disabled row with an address fails. Evidence gap: no test asserts the callback-before-close order. | `audit:DropdownMenuItem/behavior`      |
-| FR3            | `DropdownMenu.test.tsx` "DropdownMenuItem href" and "link rows — the browser's own clicks" cases; "a middle click on a link row runs the caller's onAuxClick and still closes the menu"                                                                                                                                    | Plain, modified, middle, right click; blocked destination | A non-anchor row, a modified click that runs the callback, a middle click that does not close, or a live blocked destination fails.                                                            | `audit:DropdownMenuItem/behavior`      |
-| FR4, AR3       | `DropdownMenu.test.tsx` keyboard-access cases ("moves focus to the item the mouse hovers, keeping a single highlight", "does not move focus on hover for a disabled item", "does not move focus for a non-mouse (touch) pointer") and "keeps the row's own role, tab stop and hover focus beside a caller's onPointerMove" | Mouse hover, touch, disabled                              | A second highlight, hover focus on a disabled row or under touch, or a lost tab stop fails.                                                                                                    | `audit:DropdownMenuItem/accessibility` |
-| FR5            | `DropdownMenu.test.tsx` destructive-variant cases; `themingTargets.test.ts`                                                                                                                                                                                                                                                | Default and destructive; data and compound mode           | A missing `data-variant` fails; a rendered class absent from the documented targets fails. Evidence gap: no test asserts the `dropdown-menu-item` class or `data-size`.                        | `audit:DropdownMenuItem/theming`       |
-| FR6            | `DropdownMenu.test.tsx` ref and host-attribute cases ("a ref reaches the menuitem element", "puts aria-\*, data-\* and id on the row root, a link row included", "runs the DOM handlers the caller attaches, such as a drop target")                                                                                       | Ref; host attributes; caller handlers                     | A dropped ref, attribute, or handler fails. Evidence gap: no test asserts `className`, `style`, or `xstyle` on the row.                                                                        | `audit:DropdownMenuItem/api`           |
-| FR7            | `DropdownMenu.test.tsx` "skips aria-disabled menuitemradio and menuitemcheckbox items during arrow navigation" (the shipped behavior OQ1 leaves open)                                                                                                                                                                      | Disabled rows                                             | A disabled row that activates fails.                                                                                                                                                           | `audit:DropdownMenuItem/accessibility` |
-| FR8, AR4, PR1  | Evidence gap: no test asserts the focus paint, forced-colors focus, or the listener bound                                                                                                                                                                                                                                  | —                                                         | —                                                                                                                                                                                              | `audit:DropdownMenuItem/visual`        |
-| RTL            | `apps/storybook/rtl-audit/verified-not-applicable.json` DropdownMenuItem entry                                                                                                                                                                                                                                             | LTR and RTL                                               | A changed source hash fails the receipt.                                                                                                                                                       | `audit:DropdownMenuItem/rtl`           |
-
-## Current-state impact
-
-- **Focus visibility (FR8).** Keyboard focus on a row shows only a background
-  tint about 1.1:1 against the menu surface, and no indicator in forced-colors
-  mode; the treatment is OQ2.
-
-## Decision log
-
-No component-local decision.
-
-## Open questions
-
-- **OQ1 — Which shared keyboard owner should keep disabled menu items discoverable
-  while preserving their inert behavior?** (`human-api`)
-- **OQ2 — Should forced-colors focus use a component-specific system outline, or a
-  shared row-focus treatment that also governs ordinary themes?** (`human-design`)
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, current audit scores,
-screenshot matrices, implementation steps, or family/system rules. It links to
-their owners.

package/src/DropdownMenu/DropdownMenuRadioGroup.spec.md

@@ -1,187 +0,0 @@
----
-schema_version: 3
-template_version: 7
-kind: component
-id: component:DropdownMenuRadioGroup
-authority: current
-archive_reason: null
-superseded_by: null
-approved_by: cixzhang
-approved_at: 2026-10-31
-owners: [cixzhang]
-review_triggers: [public-api, behavior, accessibility, theming, testing]
-verified_by:
-  [
-    packages/core/src/DropdownMenu/DropdownMenuSelectable.test.tsx,
-    packages/core/src/DropdownMenu/DropdownMenu.test.tsx,
-    packages/core/src/DropdownMenu/__tests__/Menu.a11y.test.tsx,
-    apps/storybook/rtl-audit/verified-not-applicable.json,
-    scripts/check-knowledge.mjs,
-  ]
-modules: []
-families: []
-design_specs: []
-architecture:
-  [
-    architecture:public-component-api,
-    architecture:component-test-sufficiency,
-    architecture:interaction-modality,
-  ]
-contributing: []
-system_specs: [spec:AST-020]
----
-
-# DropdownMenuRadioGroup component contract
-
-## Contract at a glance
-
-| Area                    | Contract                                                                                                                                                 |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | One controlled, named single-selection group of `DropdownMenuRadioItem` children with value, change callback, close policy, root inputs, and a ref.      |
-| Behavior                | The group supplies selection and close-policy context; radio items emit values; the parent DropdownMenu owns keyboard navigation and menu lifecycle.     |
-| End-user impact         | Assistive technology encounters one named group with exactly one current choice when a value matches, while pointer and keyboard selection stay aligned. |
-| Builder impact          | Keep the value controlled, provide a stable accessible label, and place only DropdownMenuRadioItem options inside the group.                             |
-| Compatibility/readiness | Records shipped behavior; no API, default, or DOM change.                                                                                                |
-| Review checks           | Reject unnamed groups, local selection state, dropped root inputs, a second keyboard owner, or a close policy that bypasses the controlled callback.     |
-| Governing rules         | `spec:AST-020`; `architecture:public-component-api/INV5–INV9`; `architecture:component-test-sufficiency/INV1–INV7`; `spec:AST-020/FR1,FR2,FR6`.          |
-
-This table is a review projection; the body below is authoritative.
-
-## Intent
-
-DropdownMenuRadioGroup renders one named `role="group"` wrapper inside the
-pointer presentation of DropdownMenu. It owns controlled selection context,
-close policy, root composition, and the tokenized gap between children.
-DropdownMenuRadioItem owns each `menuitemradio` row and its checked state;
-DropdownMenu owns focus movement, typeahead, keyboard activation, presentation,
-and menu open/close lifecycle.
-
-## Compatibility and migration
-
-- Released default preserved: yes (`hasCloseOnSelect=true`).
-- Compatibility class: records shipped behavior; no public prop, default,
-  export, or DOM change.
-- Controlled behavior: `value` is caller-owned and `onChange` is the only commit path.
-- Migration decision: none.
-
-Consumer migration instructions belong in consumer docs and release notes.
-
-## Ownership boundary
-
-**Owns**
-
-- One `role="group"` root with an `aria-label` from the required `label` prop.
-- Controlled `value`, `onChange`, and `hasCloseOnSelect` context for radio items.
-- Composition of `children`, supported host inputs, ref, `className`, `style`, and
-  `xstyle` on the group root.
-- Column layout and the semantic menu inter-item gap.
-
-**Does not own / non-goals**
-
-- The `menuitemradio` role, `aria-checked`, disabled behavior, indicator paint,
-  label, description, icon, or end content — owned by DropdownMenuRadioItem.
-- Focus entry, arrow-key navigation, typeahead, Enter/Space synthesis, and menu
-  close implementation — owned by DropdownMenu and shared menu hooks.
-- Touch and bottom-sheet selectable-row rendering — owned by the parent presentation.
-- Uncontrolled selection state or child-value registration.
-
-## Public concepts
-
-| Concept         | Closed values or states                       | Meaning                                                              | Default  | Owner                    | Stability | Invalid-value behavior                                |
-| --------------- | --------------------------------------------- | -------------------------------------------------------------------- | -------- | ------------------------ | --------- | ----------------------------------------------------- |
-| Selection       | matching value; no matching value             | Controls which child reports checked.                                | none     | caller and radio item    | stable    | No match leaves every child unchecked.                |
-| Commit          | child value                                   | Emits the selected child value through `onChange`.                   | required | group context            | stable    | Children outside the group throw from the item owner. |
-| Close policy    | close; remain open                            | Controls whether an item asks DropdownMenu to close after selection. | close    | group context and parent | stable    | Omission closes.                                      |
-| Accessible name | required label; optional labelledby           | Names the group; `aria-labelledby` may point at visible text.        | label    | group root               | stable    | `label` remains required by the public type.          |
-| Root surface    | ref; DOM/data/ARIA; class/style/xstyle/events | Extends the group root while preserving its role and name.           | omitted  | public component API     | stable    | Accepted inputs compose; owned role and label win.    |
-
-## Behavioral and layout contract
-
-| ID  | Invariant                                                                                                                                                                              | Basis                                                        |
-| --- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
-| FR1 | The root exposes `role="group"` and a non-empty accessible name. The required `label` supplies `aria-label`; a caller `aria-labelledby` may reference visible text.                    | `spec:AST-020`; current source and tests                     |
-| FR2 | The group is controlled. It compares each radio item's value with caller `value` and emits a selected child value only through caller `onChange`; a radio item outside a group throws. | Current public API and tests                                 |
-| FR3 | `hasCloseOnSelect` defaults to true. When false, a selection updates through `onChange` while the parent menu stays open.                                                              | Current behavior and tests                                   |
-| FR4 | DropdownMenu is the only keyboard owner. The group adds no tab stop, key handler, typeahead, or click synthesis; it only provides context to child rows.                               | `architecture:interaction-modality`; parent tests            |
-| FR5 | Ref, supported host attributes and handlers, `className`, `style`, and `xstyle` reach or compose on the group root without replacing the owned role or `aria-label`.                   | `architecture:public-component-api` INV5–INV9; current tests |
-| FR6 | The wrapper is a logical column whose tokenized gap matches the surrounding menu's item rhythm; it adds no component-specific directional paint or navigation.                         | Current source                                               |
-
-### Allowed variation
-
-- **AV1 — Children.** The number, labels, descriptions, icons, and supporting
-  content of DropdownMenuRadioItem children may vary.
-- **AV2 — Selection.** Any string value, including no matching value, may be
-  caller-controlled without adding local group state.
-- **AV3 — Root styling.** Caller style inputs may extend the wrapper while the
-  role, accessible label, column flow, and child semantics remain intact.
-
-### Representative states
-
-| State             | Required invariant                                                         | Allowed variation                    |
-| ----------------- | -------------------------------------------------------------------------- | ------------------------------------ |
-| Matching value    | Exactly the matching child reports `aria-checked=true`.                    | Child content and menu size.         |
-| No matching value | Every child reports `aria-checked=false`.                                  | Empty or unmatched caller value.     |
-| Default close     | Selection emits the value and closes through the parent.                   | Pointer or synthesized keyboard act. |
-| Retained open     | Selection emits the value, updates controlled state, and leaves menu open. | Result copy and selected child.      |
-| RTL / narrow      | Column order and tokenized gap hold with no horizontal overflow.           | Parent menu placement.               |
-
-### Transformation and precedence order
-
-- **ORD1 — Selection.** Child activation → disabled guard in the item owner →
-  group `onChange(value)` → optional parent close.
-- **ORD2 — Root composition.** Base column/gap → caller `xstyle`; supported host
-  inputs and class/style compose while owned role and label remain fixed.
-
-### Performance and resources
-
-- **PR1 — Context only.** The group memoizes a small context value and owns no
-  Effect, listener, observer, timer, request, DOM read, or resource lifecycle.
-
-## Accessibility contract
-
-- **AR1 — Named group.** The wrapper is one named `group` inside the parent menu.
-- **AR2 — Radio rows.** Child items own `menuitemradio` and `aria-checked`; the
-  group does not add nested native inputs or duplicate row semantics.
-- **AR3 — Keyboard ownership.** DropdownMenu owns focus collection and activation;
-  the group itself never enters the tab or arrow-key sequence.
-
-## Design relationships
-
-| Anatomy or state | Design requirement                                               | Representation authority           | Hierarchy role | Component contract |
-| ---------------- | ---------------------------------------------------------------- | ---------------------------------- | -------------- | ------------------ |
-| Group wrapper    | Logical column with the menu's semantic inter-item gap.          | Current source and spacing tokens  | structural     | FR1, FR5, FR6      |
-| Selected child   | One child reflects caller value through `aria-checked`.          | DropdownMenuRadioItem              | prominent      | FR2, AR2           |
-| Direction/narrow | Child order and gap hold without physical-direction assumptions. | Bidirectionality and parent layout | structural     | FR6                |
-
-No component-local visual decision is recorded.
-
-## Family and system relationships
-
-- `architecture:public-component-api` owns root input composition and released compatibility.
-- `architecture:component-test-sufficiency` owns proportionate observable evidence.
-- `architecture:interaction-modality` and DropdownMenu own keyboard behavior.
-- `spec:AST-020` supplies WCAG/APG adoption and evidence-layer boundaries.
-
-## Verification map
-
-| Contract      | Verification                                                                                                                                                                                                    | Representative states                                | Mutation or failure expectation                                                                                                              | Audit section                                |
-| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
-| FR1, AR1      | `DropdownMenuSelectable.test.tsx` "names and composes the group root when no value matches"                                                                                                                     | Label and caller `aria-labelledby`                   | A missing group role, `aria-label`, or caller `aria-labelledby` fails.                                                                       | `audit:DropdownMenuRadioGroup/semantics`     |
-| FR2           | `DropdownMenuSelectable.test.tsx` "calls onChange with the selected value", "names and composes the group root when no value matches" (no item checked), and "throws when a radio item is used outside a group" | Matching and no matching value; item outside a group | A wrong checked row, a selection that skips `onChange`, or an item that works outside a group fails.                                         | `audit:DropdownMenuRadioGroup/behavior`      |
-| FR3           | `DropdownMenuSelectable.test.tsx` "keeps the menu open while controlled selection updates when requested"                                                                                                       | `hasCloseOnSelect={false}`                           | A close despite the opt-out fails. Evidence gap: no test here asserts the default close after a selection.                                   | `audit:DropdownMenuRadioGroup/behavior`      |
-| FR4, AR2, AR3 | `DropdownMenu.test.tsx` "arrow navigation reaches consumer-rendered menuitemradio and menuitemcheckbox items" and "activates a focused menuitemradio with Enter and a menuitemcheckbox with Space"              | Arrow keys and Enter on radio rows                   | A radio row the arrows skip or Enter does not activate fails. Evidence gap: no test asserts that the group adds no tab stop or key handler.  | `audit:DropdownMenuRadioGroup/accessibility` |
-| FR5           | `DropdownMenuSelectable.test.tsx` "names and composes the group root when no value matches"                                                                                                                     | Ref, host attribute, class, style, handler           | A dropped ref, attribute, class, style, or handler, or a replaced role or label, fails. Evidence gap: no test asserts `xstyle` on the group. | `audit:DropdownMenuRadioGroup/api`           |
-| FR6, PR1      | `apps/storybook/rtl-audit/verified-not-applicable.json` DropdownMenuRadioGroup entry. Evidence gap: no test asserts the column gap or the absence of lifecycle resources                                        | LTR and RTL                                          | A changed source hash fails the receipt.                                                                                                     | `audit:DropdownMenuRadioGroup/layout`        |
-
-## Decision log
-
-No component-local decision.
-
-## Open questions
-
-None.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables/examples, current audit scores,
-screenshot matrices, implementation steps, or parent/item contracts. It links to their owners.