@astryxdesign/core 0.7.5 → 0.7.6-canary.0135af4

package/src/DropdownMenu/DropdownMenu.spec.md

@@ -1,32 +1,30 @@
 ---
 schema_version: 3
-template_version: 3
+template_version: 7
 kind: component
 id: component:DropdownMenu
-authority: draft
+authority: current
 archive_reason: null
 superseded_by: null
-approved_by: null
-approved_at: null
+approved_by: cixzhang
+approved_at: 2026-10-31
 owners: [cixzhang]
 review_triggers: [accessibility, behavior, layout, public-api, theming]
 verified_by:
   [
     packages/core/src/DropdownMenu/DropdownMenu.test.tsx,
-    packages/core/src/DropdownMenu/DropdownMenuSelectable.test.tsx,
     packages/core/src/DropdownMenu/DropdownMenuSubMenu.test.tsx,
     packages/core/src/DropdownMenu/__tests__/DropdownMenuDrillIn.a11y.chromium.spec.ts,
     packages/core/src/DropdownMenu/__tests__/MenuPress.a11y.chromium.spec.ts,
     packages/core/src/DropdownMenu/__tests__/MenuHeaderFooter.a11y.chromium.spec.ts,
-    packages/core/src/BottomSheet/BottomSheet.test.tsx,
-    packages/core/src/List/List.test.tsx,
-    packages/core/src/Indicator/Indicator.test.tsx,
-    packages/core/src/Icon/Icon.test.tsx,
+    packages/core/src/DropdownMenu/__tests__/SubMenuHeaderFooter.a11y.chromium.spec.ts,
+    packages/core/src/ContextMenu/ContextMenu.test.tsx,
+    packages/core/src/theme/themingTargets.test.ts,
     scripts/check-knowledge.mjs,
   ]
 modules: [module:DropdownMenu/useMenuPress, module:DropdownMenu/useMenuHover]
 families: [family:overlay-dismissal, family:navigation-destinations]
-design_specs: []
+design_specs: [design:reduced-motion]
 architecture:
   [
     architecture:component-theming-surface,
@@ -34,34 +32,43 @@ architecture:
     architecture:layer-runtime,
   ]
 contributing: []
-system_specs: []
+system_specs: [spec:AST-020/FR15, spec:AST-094, spec:AST-102]
 ---
 
 # DropdownMenu component contract
 
+## Contract at a glance
+
+| Area                    | Contract                                                                                                                                                                                                                                                                                                                                        |
+| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Public contract         | None changes. DropdownMenu takes a `button` (Button props) or `renderTrigger`, data-driven `items` or compound children, `presentation`, `isMenuOpen` and `onOpenChange`, placement and alignment, `menuMaxHeight`, `header`, and `footer`.                                                                                                     |
+| Behavior                | A Menu Button trigger opens an anchored pointer menu or a bottom-sheet action list. Rows act on the release under the shared press model; sub-menus fly out beside their row or drill in on a compact touch display; a header or footer makes the pointer popover a modal dialog around the menu.                                               |
+| End-user impact         | People pick actions by mouse, finger, or keyboard; keyboard users get a focus return with a ring and pointer users without one; on a phone sub-menus replace the rows instead of flying off-screen. Under a finger the menu opens after a 500 ms hold or at a tap's click, does not grow from its trigger, and a pan outside does not close it. |
+| Builder impact          | Builders choose the trigger, the rows, and the regions; rows stay menu items and every non-item control goes in `header` or `footer`.                                                                                                                                                                                                           |
+| Compatibility/readiness | Records shipped behavior; no API or DOM change; the released default under a finger moves as `spec:AST-094` FR25 lists, with `presentation="popover"` keeping it. Finger press-open (FR8), touch grow and pan dismissal (FR21), and the delegated Trigger Button gaps are listed under Current-state impact.                                    |
+| Review checks           | Reject a control placed among the rows, a lost trigger ARIA wiring, a drilled-in view that leaves the menu box, a header or footer without the dialog, a lost focus-return modality, or a target moved off its painted element.                                                                                                                 |
+| Governing rules         | `spec:AST-020` FR15; `spec:AST-094` FR26–FR35; `module:DropdownMenu/useMenuPress`; `architecture:interaction-modality` INV1; `architecture:component-theming-surface`; `architecture:layer-runtime`; `family:overlay-dismissal`; `family:navigation-destinations`.                                                                              |
+
+This table is a review projection; the body below is authoritative.
+
 ## Intent
 
-DropdownMenu presents actions from a visible Button trigger in either an
-anchored pointer menu or a BottomSheet-hosted touch action list. This draft
-records current consumer anatomy, presentation-specific ownership, and theming
-reachability. Its press model — the row under the release acts and the
-highlight follows the pointer — is contracted by
-`module:DropdownMenu/useMenuPress`, which both presentations mount.
+DropdownMenu presents actions from a visible trigger in either an anchored
+pointer menu or a BottomSheet-hosted touch action list. Its press model — the
+row under the release acts and the highlight follows the pointer — is
+contracted by `module:DropdownMenu/useMenuPress`, which both presentations
+mount.
 
 ## Compatibility and migration
 
-- Released default preserved: `no` under a finger. The omitted
-  `presentation`, released as `'popover'`, follows `spec:AST-094` FR29 (open
-  on press) and this record's FR21 (the grow) under a finger; `presentation="popover"` keeps the released
-  behavior (`spec:AST-094` FR25). Mouse and keyboard are unchanged.
-- Compatibility class: compatible behavior correction; public API, DOM
-  shape, styling, and targets are preserved; the default under a finger
-  changes as above, and the press-model behavior delta is recorded in
-  `module:DropdownMenu/useMenuPress`
-- Controlled/uncontrolled behavior: unchanged
-- Migration decision: `module:DropdownMenu/useMenuPress/DEC-3`; proposed
-  `module:DropdownMenu/useMenuPress/DEC-4`; `spec:AST-094/DEC-4` (a caller
-  that needs the released tap-open passes `presentation="popover"`)
+- Released default preserved: `no` under a finger: the omitted `presentation`
+  follows `spec:AST-094` FR29, FR31, and FR32 (FR8, FR21);
+  `presentation="popover"` keeps the released behavior (`spec:AST-094` FR25)
+- Compatibility class: records shipped behavior; no public prop, export, or
+  DOM change
+- Controlled/uncontrolled behavior: `isMenuOpen` with `onOpenChange`, or
+  uncontrolled
+- Migration decision: `spec:AST-094` FR25 and DEC-4
 
 Consumer migration instructions belong in consumer docs and release notes.
 
@@ -69,16 +76,17 @@ Consumer migration instructions belong in consumer docs and release notes.
 
 **Owns**
 
-- The Pointer menu surface and Touch menu surface and their shared current
+- The Pointer menu surface and Touch menu surface and their shared
   `dropdown-menu` target.
 - Pointer action rows, pointer-only section headings and dividers, radio marker
   specialization, and submenu indicator presentation through the other five
-  current DropdownMenu targets.
-- Selecting between the current pointer and touch render paths after presentation
+  DropdownMenu targets.
+- Selecting between the pointer and touch render paths after presentation
   policy resolves.
-- Mounting the shared press model on both menu surfaces and (proposed) on
-  the Trigger button for mouse press-open and held-finger open; the model
-  itself is owned by `module:DropdownMenu/useMenuPress`.
+- Mounting the shared press model on both menu surfaces and on the Trigger
+  button; the model itself is owned by `module:DropdownMenu/useMenuPress`.
+- The `header` and `footer` regions, the dialog around them, and the drilled-in
+  view.
 
 **Does not own / non-goals**
 
@@ -87,55 +95,59 @@ Consumer migration instructions belong in consumer docs and release notes.
 - Touch action-list and row presentation — delegated to `component:List`.
 - Shared checkbox-indicator and ordinary icon presentation — delegated to
   `component:Indicator` and `component:Icon`.
+- Each row's own contract — owned by `component:DropdownMenuItem`,
+  `component:DropdownMenuCheckboxItem`, `component:DropdownMenuRadioGroup`,
+  `component:DropdownMenuRadioItem`, `component:DropdownMenuSubMenu`,
+  `component:DropdownMenuGroup`, and `component:DropdownMenuDivider`.
+- The flyout hover timing — owned by the menu hover module (`useMenuHover`).
 - Shared layer lifecycle or dismissal policy.
 
 ## Public concepts
 
 Consumer props, item shapes, subcomponents, and presentation policy remain
-documented in `DropdownMenu.doc.mjs` and the subcomponent docs. Four component-local concepts are added, by DEC-2, DEC-3, DEC-8 and proposed DEC-13; each
-keeps its released default.
-
-| Concept           | Closed values or states                                  | Meaning                                                                                                                                                                                          | Availability by variant/orientation/state | Default  | Owner                    | Stability | Invalid-value behavior                              |
-| ----------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------- | -------- | ------------------------ | --------- | --------------------------------------------------- |
-| Menu height cap   | `menuMaxHeight`: a number of pixels                      | Lifts the 300px cap for a menu that must fit its rows; the viewport still bounds it.                                                                                                             | Pointer presentation                      | `300px`  | `component:DropdownMenu` | stable    | Ignored by the touch sheet.                         |
-| Trigger source    | `button` (Button props) or `renderTrigger` (render prop) | Which control the menu hangs off. `trigger` receives `DropdownMenuTriggerProps` — the press model, keyboard opens, toggle click and ARIA wiring — and names the menu.                            | Both presentations                        | `button` | `component:DropdownMenu` | stable    | Both given: `trigger` wins and a dev warning fires. |
-| Header and footer | `header`, `footer`: any React node                       | Content above and below the rows, beside the menu inside the same popover or sheet — never inside the `role="menu"` element. With either, the pointer popover is a modal dialog around the menu. | Both presentations                        | none     | `component:DropdownMenu` | stable    | A false or empty value renders no region.           |
-| Sub-menu regions  | `header`, `footer` on a sub-menu: any React node         | Content above and below a sub-menu's rows, beside its menu inside its own surface; with either, that surface is a modal dialog named by the row (proposed FR20).                                 | Popover presentation                      | none     | `component:DropdownMenu` | proposed  | A false or empty value renders no region.           |
+documented in `DropdownMenu.doc.mjs` and the subcomponent docs. These are the
+component-local concepts; each keeps its released default.
+
+| Concept               | Closed values or states                                            | Meaning                                                                                                                                                                                          | Availability by variant/orientation/state                       | Default              | Owner                    | Stability | Invalid-value behavior                                           |
+| --------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------- | -------------------- | ------------------------ | --------- | ---------------------------------------------------------------- |
+| Menu height cap       | `menuMaxHeight`: a number of pixels                                | Lifts the 300px cap for a menu that must fit its rows; the viewport still bounds it.                                                                                                             | Pointer presentation                                            | `300px`              | `component:DropdownMenu` | stable    | Ignored by the touch sheet.                                      |
+| Trigger source        | `button` (Button props) or `renderTrigger` (render prop)           | Which control the menu hangs off. `renderTrigger` receives `DropdownMenuTriggerProps` — the press model, keyboard opens, toggle click and ARIA wiring — and names the menu.                      | Both presentations                                              | `button`             | `component:DropdownMenu` | stable    | Both given: `renderTrigger` wins and a dev warning fires.        |
+| Header and footer     | `header`, `footer`: any React node                                 | Content above and below the rows, beside the menu inside the same popover or sheet — never inside the `role="menu"` element. With either, the pointer popover is a modal dialog around the menu. | Both presentations                                              | none                 | `component:DropdownMenu` | stable    | A false or empty value renders no region.                        |
+| Sub-menu regions      | `header`, `footer` on a sub-menu: any React node                   | Content above and below a sub-menu's rows, beside its menu inside its own surface; with either, that surface is a modal dialog named by the row (FR20).                                          | Popover presentation                                            | none                 | `component:DropdownMenu` | stable    | A false or empty value renders no region.                        |
+| Row destination       | `href` (+ `target`, `rel`) on an action item                       | The row's act is navigation: the row itself is the link (`family:navigation-destinations`).                                                                                                      | Pointer action row and Touch action row, compound and data mode | none (an action row) | `component:DropdownMenu` | stable    | Blocked schemes follow the family rule; a disabled row has none. |
+| Sub-menu presentation | `presentation` on a sub-menu row: `flyout`, `drill-in`, `adaptive` | Whether a sub-menu opens beside its row or replaces the menu's rows with its own and a Back row, in the same box. `adaptive` drills in when a compact touch display opened the menu.             | Pointer presentation, compound and data mode                    | `adaptive`           | `component:DropdownMenu` | stable    | An unknown value reads as `adaptive`.                            |
 
 ## Behavioral and layout contract
 
-| ID                    | Candidate invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Basis                                                                                                                                                                         | Draft review state                                                                |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
-| FR1                   | Every current render contains a Trigger button. Pointer presentation renders a Pointer menu surface with pointer-owned rows and optional pointer headings, dividers, indicators, and nested flyouts. Touch presentation renders a Touch sheet frame containing a Touch menu surface, Touch heading, Touch action list, and Touch action rows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Current source, docs, and tests                                                                                                                                               | Verified current behavior; no new behavior decided                                |
-| FR2                   | The six current local targets are `dropdown-menu`, `dropdown-menu-item`, `dropdown-menu-radio`, `dropdown-menu-section-heading`, `dropdown-menu-divider`, and `dropdown-menu-indicator-icon`; every target remains on its current painted element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Current source, docs, and tests                                                                                                                                               | Verified current inventory; no target change                                      |
-| FR3                   | Button owns the Trigger button, BottomSheet owns the Touch sheet frame, List owns the Touch action list and Touch action rows, Indicator owns checkbox chrome, and Icon owns ordinary rendered icons.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Current source and owner docs                                                                                                                                                 | Verified current delegation; no ownership change                                  |
-| FR4                   | The same `dropdown-menu` target reaches the alternative Pointer menu surface and Touch menu surface. Pointer action rows retain `dropdown-menu-item`; touch action rows instead use List's `list-item` target.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Current source and tests                                                                                                                                                      | Verified modality split; no target change                                         |
-| FR5                   | Both menu surfaces carry `data-astryx-menu-press` and follow `module:DropdownMenu/useMenuPress` FR1–FR7: the row under the release acts, the highlight follows a held pointer, a mouse released outside closes and a finger leaves the menu open, the browser's stray click never acts, and the Pointer menu surface declares `touch-action` by overflow. Under a finger the press, the menu's grow and collapse, and its dismissal follow `spec:AST-094` FR26–FR35 (pending implementation). Trigger opening and keyboard navigation are unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `module:DropdownMenu/useMenuPress`; `DropdownMenu.test.tsx` press model suite                                                                                                 | Proposed; verified in jsdom and real Chromium                                     |
-| FR6                   | When the pointer menu closes, focus returns to the Trigger button with a visible ring only when the menu was driven by keyboard; a press outside that landed on a focusable control keeps focus there.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `architecture:interaction-modality` INV1; proposed in this change; `DropdownMenu.test.tsx` closing suite                                                                      | Proposed; verified in jsdom, pending owner review                                 |
-| FR7                   | `menuMaxHeight` MUST replace the 300px term of the menu's and its popover viewport's block-size cap while the viewport gutters still bound both; the touch sheet ignores it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | `component:DropdownMenu/DEC-3`                                                                                                                                                | Proposed; verified in jsdom; owner to confirm DEC-3                               |
-| FR8                   | The Trigger button opens the pointer menu on a mouse press-down, with the module's settle rule on the opening release, and under a finger as `spec:AST-094` FR29 states; pressing the trigger of an open menu closes it without reopening in the same gesture; a mouse click and the keyboard open as before (`module:DropdownMenu/useMenuPress` proposed FR8, FR9).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Proposed `module:DropdownMenu/useMenuPress/DEC-4`; `DropdownMenu.test.tsx` press model suite                                                                                  | Proposed; verified in jsdom, pending owner review                                 |
-| Trigger source        | `button` (Button props) or `renderTrigger` (render prop)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Which control the menu hangs off. `trigger` receives `DropdownMenuTriggerProps` — the press model, keyboard opens, toggle click and ARIA wiring — and names the menu.         | Both presentations                                                                | `button`             | `component:DropdownMenu` | stable | Both given: `trigger` wins and a dev warning fires.              |
-| FR9                   | With `renderTrigger`, the rendered control MUST carry `aria-haspopup`, `aria-expanded`, `aria-controls` and the `id` the menu's `aria-labelledby` points at, and MUST receive the same press-model, keyboard-open and toggle-click handlers as the Button path; the menu is named by that control. `button` and `trigger` are mutually exclusive: both given, `trigger` wins and a dev warning fires, in both presentations. A drilled-in Back row (FR11) returns to the menu by that same name: the caller's `aria-label` when given, else the control's accessible name, read as the menu opens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `component:DropdownMenu/DEC-2`                                                                                                                                                | Proposed; verified in jsdom; owner to confirm DEC-2                               |
-| Row destination       | `href` (+ `target`, `rel`) on an action item                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | The row's act is navigation: the row itself is the link (`family:navigation-destinations`).                                                                                   | Pointer action row and Touch action row, compound and data mode                   | none (an action row) | `component:DropdownMenu` | stable | Blocked schemes follow the family rule; a disabled row has none. |
-| FR10                  | An action row with `href` MUST render as one anchor carrying `role="menuitem"` (the pointer menu) or the touch sheet's link row, routed through `LinkProvider`; a plain click MUST run `onClick`, then close the menu (`hasCloseOnSelect`), then let the browser navigate; a modified click or middle click MUST be left to the browser and MUST NOT run `onClick`; Enter and Space MUST activate through a synthesized click that carries the key's modifiers. A disabled link row has no `href`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | `component:DropdownMenu/DEC-2`; `family:navigation-destinations`                                                                                                              | Proposed; verified in jsdom; owner to confirm DEC-1                               |
-| Sub-menu presentation | `presentation` on a sub-menu row: `flyout`, `drill-in`, `adaptive`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Whether a sub-menu opens beside its row or replaces the menu's rows with its own and a Back row, in the same box. `adaptive` drills in when a coarse pointer opened the menu. | Pointer presentation, compound and data mode                                      | `adaptive`           | `component:DropdownMenu` | stable | An unknown value reads as `adaptive`.                            |
-| FR11                  | When a compact touch display opened the pointer menu (`COMPACT_TOUCH_PRESENTATION_QUERY`, the same query the root presentation uses for its bottom sheet, sampled once as it opens) an `adaptive` sub-menu row MUST drill in: its rows and a leading Back row named "Back to <parent>" replace the menu's rows in the same Pointer menu surface, no flyout opens, the drilled list is a `menu` named by the row's label, and Back, Escape and ArrowLeft MUST return to the row with focus on it; a pick inside closes the whole menu. Roving focus and typeahead scope to the shown rows; sibling rows and dividers need no knowledge of it. `presentation="flyout"` keeps the flyout; `"drill-in"` drills in on any pointer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | `component:DropdownMenu/DEC-2`; `architecture:interaction-modality`                                                                                                           | Proposed; verified in jsdom and Chromium (coarse pointer); owner to confirm DEC-5 |
-| FR12                  | In the pointer menu ArrowDown on the last enabled row wraps to the first and ArrowUp on the first to the last; PageDown and PageUp move to the last and first fully visible enabled row and, pressed there again, one viewport further without wrapping; ArrowUp on the trigger opens with the last enabled row highlighted; the key that opened the menu and its auto-repeats do not activate; typeahead matches the row's label element alone and ignores Control/Command chords and input-method composition.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Proposed in this change; `DropdownMenu.test.tsx` keyboard suite, `useListFocus.test.tsx`, `useTypeahead.test.tsx`                                                             | Proposed; verified in jsdom, pending owner review                                 |
-| FR13                  | On a mouse, a nested flyout stays open while the pointer is inside the triangle from where it left its row to the flyout's near edge — including while the pointer is paused there — and closes after the existing delay once the pointer has left both the row and that triangle. The row's click toggle and its guard window are unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Proposed in this change; `DropdownMenuSubMenu.test.tsx` safe-triangle suite, `useMenuHover.test.tsx`                                                                          | Proposed; verified in jsdom, pending owner review                                 |
-| FR14                  | A compound `DropdownMenuGroup` is one `role="group"` named by its heading through `aria-labelledby`; the heading carries `dropdown-menu-section-heading`, is plain text rather than a menu item, and is skipped by roving focus and typeahead. An untitled group is an unnamed `role="group"`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | DEC-1, docs, and tests                                                                                                                                                        | Proposed; awaiting owner approval                                                 |
-| FR15                  | With `header` or `footer`, the pointer popover is a `role="dialog"` with `aria-modal="true"`, named like the menu, holding the header, then the `role="menu"` element, then the footer; the menu element holds only its rows. The trigger says `aria-haspopup="dialog"` and its `aria-controls` names the popover that holds the dialog. A region keeps its own keys and presses: neither the menu's key handling nor its press model claims an event that begins there. The menu is one Tab stop between the regions. Tab and Shift+Tab move through the header's controls, the menu, then the footer's controls, and wrap at either end; a control that is hidden, or under a hidden ancestor within its region, is not a stop. From a row, or a row of an open sub-menu, Tab and Shift+Tab close every open flyout and continue from the menu's stop. With no other stop, focus stays in the menu. Escape closes from anywhere in the popover, and focus returns to the trigger. The bottom sheet, already a dialog, shows the header above the actions and the footer below them. Without either prop, the menu renders and behaves exactly as it does without them: no dialog, `aria-haspopup="menu"`, and Tab closes the menu. | DEC-8, DEC-10, docs, and tests                                                                                                                                                | Proposed; awaiting owner approval                                                 |
-| FR16                  | `DropdownMenuCheckboxItem` MUST expose one `menuitemcheckbox` row whose `aria-checked` equals its controlled value; enabled activation reports `!value`, stays open by default, and composes consumer click and pointer-move handlers with owned activation and hover focus. Disabled activation calls no consumer activation handler.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Released subcomponent API; `architecture:public-component-api/INV5–INV8`; `DropdownMenuSelectable.test.tsx`                                                                   | Verified current behavior; consumer handlers are preserved                        |
-| FR17                  | Disabled menu rows SHOULD remain keyboard-discoverable while activation stays blocked. Current shared `useListFocus` deliberately skips every `aria-disabled` row, including checkbox items.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | WAI-ARIA Menu pattern; current shared navigation source/tests                                                                                                                 | Objective mismatch; shared mechanism remains undecided in OQ1                     |
-| FR20                  | With `header` or `footer` on a sub-menu (`DropdownMenuSubMenu`), its surface is a modal dialog named by its row (AR7), holding the header, the sub-menu's `role="menu"` (rows only), then the footer. It sits in a host `DropdownMenu` renders beside its menu, never inside a menu; under a root with no such host (`ContextMenu`) the sub-menu shows its rows alone. On a fine pointer the dialog is the flyout; on a compact touch display, the drilled-in view, which replaces the root's menu and regions until popped. A region keeps its own keys and presses. The rows are one Tab stop: Tab and Shift+Tab walk the header's controls, the rows, then the footer's, and wrap; from a deeper flyout, that flyout closes and the walk goes on from the rows. An open lands as for any sub-menu (FR11, FR12), not on a region. Escape in the dialog, outside an IME composition and unless a control there handled it, returns focus to the row and leaves the root open. A pointer leaving the flyout keeps it open until focus leaves, and it closes with the flyout holding its row. Without either prop nothing changes.                                                                                                    | Proposed DEC-13; FR15; AR5                                                                                                                                                    | Proposed; verified in jsdom and Chromium, pending owner review                    |
-| FR21                  | Under a finger, in the touch modes (`presentation` not pinned to `'popover'`), the pointer menu grows out of the Trigger button and collapses back into it (`spec:AST-094` FR31), and closes on a pan that starts outside it (FR32); a pinned `'popover'` keeps the layer's own entrance. A pan dismissal is the menu's own close: focus that was in the menu returns to the Trigger button, whose `aria-expanded` turns false. A mouse keeps the layer's own entrance and exit.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Owner decision, 2026-10-26; `spec:AST-094` FR31, FR32; `family:overlay-dismissal` AV6                                                                                         | Decided; pending implementation                                                   |
+| ID   | Invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Basis                                                                          |
+| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------ |
+| FR1  | Every render contains a Trigger button. Pointer presentation renders a Pointer menu surface with pointer-owned rows and optional pointer headings, dividers, indicators, and nested flyouts. Touch presentation renders a Touch sheet frame containing a Touch menu surface, Touch heading, Touch action list, and Touch action rows.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Current source, docs, and tests                                                |
+| FR2  | The six local targets are `dropdown-menu`, `dropdown-menu-item`, `dropdown-menu-radio`, `dropdown-menu-section-heading`, `dropdown-menu-divider`, and `dropdown-menu-indicator-icon`; every target stays on its painted element.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | `architecture:component-theming-surface`; current source                       |
+| FR3  | Button owns the Trigger button, BottomSheet owns the Touch sheet frame, List owns the Touch action list and Touch action rows, Indicator owns checkbox chrome, and Icon owns ordinary rendered icons. The Trigger button carries `component:Button`'s gaps: its press scale applies under reduced motion (`design:reduced-motion` DR1) and its height is fixed (`spec:AST-102` FR4).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Current source and owner docs; `design:reduced-motion` DR1; `spec:AST-102` FR4 |
+| FR4  | The same `dropdown-menu` target reaches the alternative Pointer menu surface and Touch menu surface. Pointer action rows carry `dropdown-menu-item`; touch action rows instead use List's `list-item` target.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Current source and tests                                                       |
+| FR5  | Both menu surfaces carry `data-astryx-menu-press` and follow `module:DropdownMenu/useMenuPress` FR1–FR7, FR10, and FR11: the row under the release acts, the highlight follows a held pointer, a mouse released outside closes and a finger leaves the menu open, the browser's stray click never acts, and the Pointer menu surface declares `touch-action` by overflow. The grow, collapse, and pan dismissal under a finger are FR21.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `module:DropdownMenu/useMenuPress`; `spec:AST-094` FR26–FR28                   |
+| FR6  | When the pointer menu closes, focus returns to the Trigger button with a visible ring only when the menu was driven by keyboard; a press outside that landed on a focusable control keeps focus there.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | `architecture:interaction-modality` INV1; DEC-1                                |
+| FR7  | `menuMaxHeight` replaces the 300px term of the menu's and its popover viewport's block-size cap while the viewport gutters still bound both; the touch sheet ignores it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | DEC-2                                                                          |
+| FR8  | The Trigger button opens the pointer menu on a mouse press-down, with a settle rule on the opening release, and pressing the trigger of an open menu closes it without reopening in the same gesture; a mouse click and the keyboard open as before. The mouse press-open is shipped behavior, not a requirement until `module:DropdownMenu/useMenuPress` DEC-4 is ruled. Under a finger the trigger MUST open the menu as `spec:AST-094` FR29 states: as the finger presses in a fixed bar, after the 150 ms content-touch delay or at a tap's lift inside a scroll view; `presentation="popover"` keeps the tap open. Implementation gap: a held finger opens it after a 500 ms hold, and a tap opens it at its click.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `module:DropdownMenu/useMenuPress` FR8, FR9; `spec:AST-094` FR29               |
+| FR9  | With `renderTrigger`, the rendered control carries `aria-haspopup`, `aria-expanded`, `aria-controls` and the `id` the menu's `aria-labelledby` points at, and receives the same press-model, keyboard-open and toggle-click handlers as the Button path; the menu is named by that control. A disabled custom trigger never opens the menu or the sheet. `button` and `renderTrigger` are mutually exclusive: both given, `renderTrigger` wins and a dev warning fires, in both presentations. A drilled-in Back row (FR11) returns to the menu by that same name: the caller's `aria-label` when given, else the control's accessible name, read as the menu opens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | DEC-3                                                                          |
+| FR10 | An action row with `href` renders as one anchor carrying `role="menuitem"` (the pointer menu) or the touch sheet's link row, routed through `LinkProvider`; a plain click runs `onClick`, then closes the menu (`hasCloseOnSelect`), then lets the browser navigate; a modified click does not run `onClick`, closes the menu, and is left to the browser; in the pointer menu a middle click closes the menu (`hasCloseOnSelect`), then runs the caller's `onAuxClick`, while the touch sheet leaves a middle click to the browser and stays open; a right click is left to the context menu; Enter and Space activate through a synthesized click that carries the key's modifiers. A disabled link row has no `href`; a blocked destination renders inertly.                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | Current behavior; `family:navigation-destinations`                             |
+| FR11 | When a compact touch display opened the pointer menu (the query the root presentation uses for its bottom sheet, sampled once as it opens), an `adaptive` sub-menu row drills in: its rows and a leading Back row named "Back to <parent>" replace the menu's rows in the same Pointer menu surface, no flyout opens, the drilled list is a `menu` named by the row's label, and Back, Escape and ArrowLeft return to the row with focus on it; a pick inside closes the whole menu, and closing the menu resets the drilled view. Roving focus and typeahead scope to the shown rows; sibling rows and dividers need no knowledge of it. `presentation="flyout"` keeps the flyout; `"drill-in"` drills in on any pointer.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | DEC-4; `spec:AST-094` FR34                                                     |
+| FR12 | In the pointer menu ArrowDown on the last enabled row wraps to the first and ArrowUp on the first to the last; PageDown and PageUp move to the last and first fully visible enabled row and, pressed there again, one viewport further without wrapping; ArrowUp on the trigger opens with the last enabled row highlighted; the key that opened the menu and its auto-repeats do not activate; typeahead matches the row's label element alone and ignores Control/Command chords and input-method composition.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Current source and tests                                                       |
+| FR13 | On a mouse, a nested flyout stays open while the pointer is inside the triangle from where it left its row to the flyout's near edge — including while the pointer is paused there — and closes after the existing delay once the pointer has left both the row and that triangle. The row's click toggle and its guard window are unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Current behavior                                                               |
+| FR14 | Compound groups follow `component:DropdownMenuGroup`; a data-mode `{type: 'section'}` entry is a `role="group"` named by its title, and an untitled section renders its rows without a heading.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | DEC-6; current tests                                                           |
+| FR15 | With `header` or `footer`, the pointer popover is a `role="dialog"` with `aria-modal="true"`, named like the menu, holding the header, then the `role="menu"` element, then the footer; the menu element holds only its rows. The trigger says `aria-haspopup="dialog"` and its `aria-controls` names the popover that holds the dialog. A region keeps its own keys and presses: neither the menu's key handling nor its press model claims an event that begins there. The menu is one Tab stop between the regions. Tab and Shift+Tab move through the header's controls, the menu, then the footer's controls, and wrap at either end; a control that is hidden, or under a hidden ancestor within its region, is not a stop. From a row, or a row of an open sub-menu, Tab and Shift+Tab close every open flyout and continue from the menu's stop. With no other stop, focus stays in the menu. Escape closes from anywhere in the popover, and focus returns to the trigger. The bottom sheet, already a dialog, shows the header above the actions and the footer below them. Without either prop, the menu renders and behaves exactly as it does without them: no dialog, `aria-haspopup="menu"`, and Tab closes the menu. | DEC-8, DEC-10                                                                  |
+| FR16 | Checkbox rows follow `component:DropdownMenuCheckboxItem`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Current source                                                                 |
+| FR17 | Arrow keys and typeahead skip disabled rows, including checkbox and radio rows. Shipped behavior, not a requirement until OQ1 is ruled.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Current source and tests                                                       |
+| FR20 | With `header` or `footer` on a sub-menu (`DropdownMenuSubMenu`), its surface is a modal dialog named by its row (AR7), holding the header, the sub-menu's `role="menu"` (rows only), then the footer. It sits in a host `DropdownMenu` renders beside its menu, never inside a menu; under a root with no such host (`ContextMenu`) the sub-menu shows its rows alone. On a fine pointer the dialog is the flyout; on a compact touch display, the drilled-in view, which replaces the root's menu and regions until popped. A region keeps its own keys and presses. The rows are one Tab stop: Tab and Shift+Tab walk the header's controls, the rows, then the footer's, and wrap; from a deeper flyout, that flyout closes and the walk goes on from the rows. An open lands as for any sub-menu (FR11, FR12), not on a region. Escape in the dialog, outside an IME composition and unless a control there handled it, returns focus to the row and leaves the root open. A pointer leaving the flyout keeps it open until focus leaves, and it closes with the flyout holding its row. Without either prop nothing changes.                                                                                                    | Current behavior; FR15; AR5                                                    |
+| FR21 | Under a finger, in the touch modes (`presentation` not pinned to `'popover'`), the pointer menu MUST grow out of the Trigger button and collapse back into it (`spec:AST-094` FR31), and MUST close as a pan that starts outside it begins (FR32); a pinned `'popover'` keeps the layer's own entrance. A pan dismissal is the menu's own close: focus that was in the menu returns to the Trigger button, whose `aria-expanded` turns false. A mouse keeps the layer's own entrance and exit. Implementation gap: the menu keeps the layer's own entrance and exit under a finger too, and has no pan-outside dismissal of its own.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `spec:AST-094` FR31, FR32; `family:overlay-dismissal` AV6                      |
 
 ### Allowed variation
 
 - **AV1 — Presentation.** `popover`, `bottom-sheet`, and resolved `adaptive`
-  presentation may select the current pointer or touch anatomy without changing
-  the ownership of either branch.
+  presentation may select the pointer or touch anatomy without changing the
+  ownership of either branch.
 - **AV2 — Content mode.** Data-driven and compound pointer menus may vary their
-  rows while preserving the current target owners. Touch presentation remains
+  rows while preserving the target owners. Touch presentation remains
   data-driven.
 - **AV3 — Optional content.** Icons, selectable indicators, headings, dividers,
   and nested actions render only when the supplied menu content requires them.
@@ -145,36 +157,41 @@ keeps its released default.
 | State                       | Required invariant                                                                                                              | Allowed variation                                                |
 | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
 | Anchored root menu          | Trigger button and Pointer menu surface render with pointer-owned rows.                                                         | Width, placement, alignment, and optional item content vary.     |
-| Anchored nested flyout      | Pointer action row opens another Pointer menu surface and may show the submenu indicator icon.                                  | Loading may replace the indicator with the current Spinner.      |
+| Anchored nested flyout      | Pointer action row opens another Pointer menu surface and may show the submenu indicator icon.                                  | Loading may replace the indicator with the Spinner.              |
+| Drilled-in sub-menu         | The Pointer menu surface shows a Back row then the sub-menu's rows; the parent rows are hidden, not unmounted.                  | Depth; which pointer opened the menu; a forced `presentation`.   |
 | Bottom-sheet root actions   | Trigger button opens Touch sheet frame, Touch menu surface, heading, action list, and action rows.                              | Icons, sections, dividers, and action descriptions may vary.     |
-| Bottom-sheet nested actions | The same frame and list owners remain while heading and rows change to the selected action level.                               | Back control and drill-in indicator follow current navigation.   |
-| Selectable pointer action   | Pointer action row may contain shared checkbox or radio chrome.                                                                 | Checked and disabled state follow the current item contracts.    |
+| Bottom-sheet nested actions | The same frame and list owners remain while heading and rows change to the selected action level.                               | Back control and drill-in indicator follow navigation.           |
+| Selectable pointer action   | Pointer action row may contain shared checkbox or radio chrome.                                                                 | Checked and disabled state follow the item contracts.            |
 | Custom-trigger menu         | The caller's control carries the trigger ARIA and names the menu; the Pointer menu surface is unchanged.                        | Any focusable control: icon button, chip, avatar, list row.      |
 | Link row                    | The Pointer action row (or Touch action row) is the anchor; `onClick`, close and navigation run in that order on a plain click. | `target`, `rel`, icon, description and destructive variant vary. |
+| Header or footer            | The popover is a named modal dialog holding header, menu, and footer; Tab wraps.                                                | Region content.                                                  |
 
 ### Transformation and precedence order
 
-- **ORD2 — Link row activation.** modified click → the browser alone; else
-  `onClick` → close (`hasCloseOnSelect`) → the browser navigates.
-  | Drilled-in sub-menu | The Pointer menu surface shows a Back row then the sub-menu's rows; the parent rows are hidden, not unmounted. | Depth; which pointer opened the menu; a forced `presentation`. |
-- No other presentation-resolution, open-state, positioning, or styling
-  precedence rule is introduced.
+- **ORD1 — Link row activation.** modified click → no `onClick`, close
+  (`hasCloseOnSelect`), the browser opens it; else `onClick` → close
+  (`hasCloseOnSelect`) → the browser navigates.
+- **ORD2 — Trigger source.** `renderTrigger` → `button`.
 
 ### Performance and resources
 
-- No new loading, listener, measurement, or render constraint is introduced.
+- **PR1 — Bounded resources.** While open, the pointer menu observes its own
+  size and content changes and listens for window and visual-viewport resizes
+  and image loads to decide whether it scrolls. A press-open, by a mouse press or a
+  held finger, adds document pointer-up and pointer-cancel listeners for the
+  length of the press. With
+  `presentation="adaptive"` the root subscribes to the compact-touch query while
+  mounted; the drill-in reads it once as the menu opens.
 
 ## Accessibility contract
 
-This draft does not change DropdownMenu's trigger naming, menu and dialog
-roles, keyboard navigation, item semantics, or dismissal ordering. While a
-pointer is held, the highlight is DOM focus per
+While a pointer is held, the highlight is DOM focus per
 `module:DropdownMenu/useMenuPress` AR1. Focus return on close follows FR6 and
 `architecture:interaction-modality` INV1 through the shared focus-return
 visibility helper.
 
-- **AR1 — A custom trigger still names the menu.** With `trigger`, the menu
-  carries `aria-labelledby` pointing at the control's `id` (the Button path
+- **AR1 — A custom trigger still names the menu.** With `renderTrigger`, the
+  menu carries `aria-labelledby` pointing at the control's `id` (the Button path
   keeps `aria-label`), and the control carries `aria-haspopup="menu"`,
   `aria-expanded` and `aria-controls`.
 - **AR2 — A row that navigates is a link element.** A row with an `href` is
@@ -194,7 +211,7 @@ visibility helper.
   Space opens the menu with focus on the first enabled row. As a named
   exception under that rule, the trigger also opens on ArrowDown (focus on the
   first enabled row) and ArrowUp (focus on the last enabled row), the keyboard
-  this component already ships. A `renderTrigger` control receives
+  this component already ships (DEC-9). A `renderTrigger` control receives
   `aria-haspopup`, `aria-expanded`, `aria-controls`, and the keyboard and focus
   handlers through the spread props (FR9); the caller's control supplies its
   own `button` role and accessible name. The bottom-sheet presentation and a
@@ -204,25 +221,22 @@ visibility helper.
   (Modal) pattern's required parts** (`spec:AST-020/FR15`): `role="dialog"`,
   `aria-modal="true"`, and an accessible name, the menu's; focus moves into
   the dialog on open, to the menu or its first enabled row as FR6 and FR12
-  already state; Tab and Shift+Tab cycle within it (FR15); Escape closes it
-  and focus returns to the trigger. The menu inside keeps AR1–AR3. The
-  trigger keeps `aria-expanded`; its `aria-haspopup` says `dialog`, and its
-  `aria-controls` names the popover that holds the dialog rather than the
-  menu, as Popover's own trigger does.
-- **AR6 — Checkbox rows remain one control.** The row owns
-  `menuitemcheckbox`, its accessible name, checked state, focus, and activation;
-  Indicator's checkbox marker is decorative. Disabled activation is inert.
-  Current shared navigation skips disabled rows instead of making them
-  discoverable as the WAI-ARIA Menu pattern recommends; FR17 and OQ1 retain that
-  gap without inventing a component-local focus path.
-- **AR7 (proposed) — A sub-menu with a header or footer adopts the same APG
-  Dialog (Modal) parts for its own surface** (`spec:AST-020/FR15`):
-  `role="dialog"`, `aria-modal="true"`, and an accessible name, its row's;
-  focus moves into the dialog on open, to the sub-menu's first row or its
-  menu as FR11 and FR12 already state; Tab and Shift+Tab cycle within it
-  (FR20); Escape closes it and focus returns to the row. The sub-menu's menu
-  inside keeps AR3. The row keeps `aria-expanded`; its `aria-haspopup` says
-  `dialog` and its `aria-controls` names the dialog.
+  state; Tab and Shift+Tab cycle within it (FR15); Escape closes it and focus
+  returns to the trigger. The menu inside keeps AR1–AR3. The trigger keeps
+  `aria-expanded`; its `aria-haspopup` says `dialog`, and its `aria-controls`
+  names the popover that holds the dialog rather than the menu, as Popover's
+  own trigger does.
+- **AR6 — Disabled rows are inert.** A disabled row runs no caller activation
+  handler and does not close the menu; FR17 records that the arrow keys skip
+  it.
+- **AR7 — A sub-menu with a header or footer adopts the same APG Dialog
+  (Modal) parts for its own surface** (`spec:AST-020/FR15`): `role="dialog"`,
+  `aria-modal="true"`, and an accessible name, its row's; focus moves into the
+  dialog on open, to the sub-menu's first row or its menu as FR11 and FR12
+  state; Tab and Shift+Tab cycle within it (FR20); Escape closes it and focus
+  returns to the row. The sub-menu's menu inside keeps AR3. The row keeps
+  `aria-expanded`; its `aria-haspopup` says `dialog` and its `aria-controls`
+  names the dialog.
 
 ## Design relationships
 
@@ -310,38 +324,54 @@ than adding a DropdownMenu-owned heading target.
 - `architecture:component-theming-surface` owns anatomy qualification, local
   target mapping, presentation-specific rows, and delegation rules.
 - `architecture:interaction-modality` owns the shared pointer, touch, keyboard,
-  and adaptive-presentation boundaries; this draft changes none of them.
-- `architecture:layer-runtime` owns the current `usePopover` host, native
-  light-dismiss reconciliation, anchor positioning, and nested `useLayer`
-  flyouts. Touch presentation delegates hosting to BottomSheet.
+  and adaptive-presentation boundaries.
+- `architecture:layer-runtime` owns the popover host, native light-dismiss
+  reconciliation, anchor positioning, and nested flyout layers. Touch
+  presentation delegates hosting to BottomSheet.
 - `family:overlay-dismissal` owns shared Escape and platform-close ordering.
-  DropdownMenu root participates through its Popover focus trap; the composed
-  BottomSheet and DropdownMenuSubMenu retain their recorded local-only adoption
-  gaps.
+  The DropdownMenu root participates through its popover focus trap; the
+  composed BottomSheet and DropdownMenuSubMenu retain their recorded local-only
+  adoption gaps.
+- `family:navigation-destinations` owns link-row destinations and blocked
+  schemes (FR10).
+- `spec:AST-094` owns the touch press, open, grow, and dismissal rules (FR5,
+  FR8, FR11, FR21).
 
 ## Verification map
 
-| Contract            | Verification                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | Representative states                                                                                                                                                                                                                                                                                                                    | Mutation or failure expectation                                                                                                                                                                                                                                                                                                    | Audit section                                  |
-| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
-| FR1, FR4            | `DropdownMenu.test.tsx` pointer, bottom-sheet, adaptive, section, divider, and drill-in suites                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Root pointer, nested pointer, root touch, drill-in                                                                                                                                                                                                                                                                                       | Collapsing presentation-specific parts or owners fails structure, target, or role assertions.                                                                                                                                                                                                                                      | `audit:DropdownMenu/anatomy`                   |
-| FR2                 | DropdownMenu target suites, source inspection, and theming target inventories                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | All six local targets                                                                                                                                                                                                                                                                                                                    | Removing, renaming, or assigning a current target to the wrong part fails evidence or inventory.                                                                                                                                                                                                                                   | `audit:DropdownMenu/theming`                   |
-| FR3                 | `DropdownMenuSelectable.test.tsx` plus BottomSheet, List, Indicator, Icon, and Divider owner tests                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Trigger, touch actions, icons, checkbox, radio                                                                                                                                                                                                                                                                                           | A composed part loses its owner target or is documented as a new local target.                                                                                                                                                                                                                                                     | `audit:DropdownMenu/theming`                   |
-| Layer relationships | `DropdownMenu.test.tsx`, `DropdownMenuSubMenu.test.tsx`, and current layer/dismissal architecture records                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Light dismiss, nested flyout, sheet dismissal                                                                                                                                                                                                                                                                                            | Documentation claims a shared owner where current source retains local behavior, or the reverse.                                                                                                                                                                                                                                   | `audit:DropdownMenu/behavior`                  |
-| FR5                 | `DropdownMenu.test.tsx` press model suite; the module record's own map                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | Finger slide across rows, outside release by mouse and finger, `touch-action`, root marker                                                                                                                                                                                                                                               | A row acting on the press or the stray click, a lost `touch-action`, or a finger release that closes fails.                                                                                                                                                                                                                        | `audit:DropdownMenu/behavior`                  |
-| FR6                 | `DropdownMenu.test.tsx` dismissal, closing and press model suites; `__tests__/MenuPress.a11y.chromium.spec.ts` in real Chromium                                                                                                                                                                                                                                                                                                                                                                                                                                        | keyboard/pointer dismissal, Escape after press-open, press outside on a control, pointer pick, closed menu                                                                                                                                                                                                                               | Focus left on the body after a pointer pick, on the control focused before a press-open, or a ring after pointer input, fails.                                                                                                                                                                                                     | `audit:DropdownMenu/behavior`                  |
-| FR7                 | `menuMaxHeight` MUST replace the 300px term of the menu's and its popover viewport's block-size cap while the viewport gutters still bound both; the touch sheet ignores it.                                                                                                                                                                                                                                                                                                                                                                                           | `component:DropdownMenu/DEC-3`                                                                                                                                                                                                                                                                                                           | Proposed; verified in jsdom; owner to confirm DEC-3                                                                                                                                                                                                                                                                                |
-| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | Canonical anatomy and current target inventory                                                                                                                                                                                                                                                                                           | Missing, extra, prefixed, stale, or unclassified mappings fail repository validation.                                                                                                                                                                                                                                              | `audit:DropdownMenu/theming`                   |
-| FR8                 | `DropdownMenu.test.tsx` press model suite (trigger cases)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | Press-open + drag-release, unsettled opening release, trigger toggle, held touch, tap                                                                                                                                                                                                                                                    | A menu that does not open on a mouse press, an unsettled release that acts, or a trigger that reopens in the same gesture fails.                                                                                                                                                                                                   | `audit:DropdownMenu/behavior`                  |
-| FR9                 | `DropdownMenu.test.tsx` custom trigger suite; `DropdownMenuSubMenu.test.tsx` custom-trigger Back row cases                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Icon button, chip, list row; open, toggle, keyboard open, name; drill-in Back row                                                                                                                                                                                                                                                        | A rendered control missing `aria-haspopup`, `aria-expanded` or `aria-controls`, an unnamed menu, a lost keyboard open, or a "Back to Menu" row, fails.                                                                                                                                                                             | `audit:DropdownMenu/anatomy`                   |
-| AR4                 | `DropdownMenu.test.tsx` cases "has aria-haspopup and aria-expanded attributes", "keyboard open via Enter focuses the first enabled item", "walks into a mounted-open menu with ArrowDown from the focused trigger", "keyboard open via ArrowDown skips a disabled leading item", "ArrowUp on the trigger opens with the last row highlighted", and "a custom trigger opens from the keyboard and lands on the first row"; Space opening and `aria-controls` under the Menu Button accessibility contract (`internal/a11y-spec`, pending) bound to the anchored trigger | Button and `renderTrigger` controls; closed/open; Enter, Space, ArrowDown, ArrowUp open                                                                                                                                                                                                                                                  | The trigger loses its name, `aria-haspopup="menu"`, `aria-expanded` or `aria-controls`; a keyboard open lands focus somewhere other than the first (or, for ArrowUp, last) enabled row                                                                                                                                             | `audit:DropdownMenu/accessibility`             |
-| FR8, AR2            | `DropdownMenu.test.tsx` "DropdownMenuItem href" suite (pointer menu and bottom sheet)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Plain click, ⌘-click, Enter with modifiers, disabled link row                                                                                                                                                                                                                                                                            | A row rendering an inner anchor, running `onClick` on a modified click, or a synthesized click dropping the modifiers fails.                                                                                                                                                                                                       | `audit:DropdownMenu/behavior`                  |
-| FR12, AR3           | `DropdownMenuSubMenu.test.tsx` "drill-in on a phone" suite; `__tests__/DropdownMenuDrillIn.a11y.chromium.spec.ts` (real Chromium, coarse pointer)                                                                                                                                                                                                                                                                                                                                                                                                                      | Drill in, Back, Escape, ArrowLeft, nested level, scoped typeahead, forced presentations, close resets                                                                                                                                                                                                                                    | A flyout opening on a coarse pointer, a missing Back row, sibling rows staying in the order, or focus not returning to the row fails.                                                                                                                                                                                              | `audit:DropdownMenu/behavior`                  |
-| FR10                | `DropdownMenuSubMenu.test.tsx` safe-triangle suite; `useMenuHover.test.tsx` `isPointInSafeTriangle` and click-guard suites                                                                                                                                                                                                                                                                                                                                                                                                                                             | diagonal path toward the flyout, a pause inside it, path away, click-opened and hover-opened guard windows                                                                                                                                                                                                                               | A flyout that closes while the pointer is inside the triangle or paused in it, one that never closes after leaving it, or a changed guard-window rule, fails.                                                                                                                                                                      | `audit:DropdownMenu/behavior`                  |
-| FR15                | `DropdownMenu.test.tsx` header and footer suite; `__tests__/MenuHeaderFooter.a11y.chromium.spec.ts` in real Chromium                                                                                                                                                                                                                                                                                                                                                                                                                                                   | dialog role, modality, name and trigger wiring; regions outside the menu element; typing in a header field; Tab walk header → menu → footer with wrap at both ends; Tab and Shift+Tab from an open sub-menu; hidden and hidden-wrapper controls; Escape from the header; a finger tap on a footer button; bottom sheet order; no regions | A region rendered inside the menu element, a popover with regions that is not a named modal dialog, a trigger still saying `aria-haspopup="menu"` with regions, a header key taken by typeahead, a Tab that leaves the dialog or closes it, focus stranded outside the dialog, or a footer tap swallowed by the press model fails. |
-| FR16                | `DropdownMenuSelectable.test.tsx`, source inspection, scoped `pr-a11y` over the `a11y/Checkbox pattern` stories, and owned Storybook states                                                                                                                                                                                                                                                                                                                                                                                                                            | checked, unchecked, disabled, caller click/pointer handlers, marker size and ownership                                                                                                                                                                                                                                                   | A dropped consumer handler, wrong checked state, nested semantic checkbox, disabled activation, or menu that closes by default fails.                                                                                                                                                                                              | `audit:DropdownMenuCheckboxItem/behavior`      |
-| FR21                | `DropdownMenu.test.tsx` touch motion and pan-outside cases; `menuSurfaceMotion.test.ts`; `__tests__/DropdownMenuTouchMotion.interaction.browser.spec.ts`                                                                                                                                                                                                                                                                                                                                                                                                               | open, close, an interrupted open and close, Reduce Motion, a mouse; a tap, a hold and a pan outside; focus in the menu at a pan dismissal                                                                                                                                                                                                | A pinned `'popover'` or a mouse open that grows from the trigger, a pan outside that leaves the menu open, or focus left in a hidden menu fails                                                                                                                                                                                    |
-| FR17, AR6           | Shared navigation source and DropdownMenu keyboard tests                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | disabled checkbox row first, middle, and last                                                                                                                                                                                                                                                                                            | Current tests prove the shared hook skips the row; no keyboard-discoverability proof exists until OQ1 is settled.                                                                                                                                                                                                                  | `audit:DropdownMenuCheckboxItem/accessibility` |
-| FR20, AR7           | `DropdownMenuSubMenu.test.tsx` "header and footer" suite; `ContextMenu.test.tsx` rows-alone case; `__tests__/SubMenuHeaderFooter.a11y.chromium.spec.ts` in real Chromium (fine pointer, coarse pointer)                                                                                                                                                                                                                                                                                                                                                                | flyout and phone view; dialog role, name, row wiring; regions outside menus; Tab walk and wrap from a field, row, deeper flyout; field keys, presses; Escape, IME and handled Escapes; keyboard open; pointer leaving, focus in then out; parent closing a nested flyout; view tracking its regions; ContextMenu rows alone              | A region inside a menu element, a surface with regions that is not a named modal dialog, a row still saying `aria-haspopup="menu"`, a field key taken by the menu, a Tab that leaves or closes the dialog, a flyout closed under focus by a pointer leaving, a flyout outliving its parent, or the root menu beside a view, fails. | `audit:DropdownMenu/behavior`                  |
+| Contract            | Verification                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Representative states                                                                  | Mutation or failure expectation                                                                                                                                                                                                                                                                  | Audit section                      |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- |
+| FR1, FR4            | `DropdownMenu.test.tsx` rendering cases ("renders menu with role=\"menu\"", "renders data-driven actions in a bottom sheet when requested", "uses the BottomSheet for adaptive presentation on compact touch", "uses the shared menu BottomSheet frame", "keeps adaptive presentation anchored without compact touch") and section, divider, and compound cases                                                                                               | Root pointer, root touch, adaptive                                                     | A missing surface, sheet frame, or menu role fails. Evidence gap: no test asserts the `dropdown-menu` target on the Touch menu surface or `list-item` on touch rows.                                                                                                                             | `audit:DropdownMenu/anatomy`       |
+| FR2                 | `DropdownMenu.test.tsx` theming-slot cases ("exposes a themeable slot on the section heading", "exposes a themeable slot on the menu divider"); `DropdownMenuSubMenu.test.tsx` "exposes a themeable slot on the submenu indicator icon"; `themingTargets.test.ts`                                                                                                                                                                                             | Heading, divider, submenu indicator                                                    | A missing heading, divider, or indicator target fails; a rendered class absent from the documented targets fails. Evidence gap: no test asserts `dropdown-menu`, `dropdown-menu-item`, or `dropdown-menu-radio` placement.                                                                       | `audit:DropdownMenu/theming`       |
+| FR3                 | `DropdownMenu.test.tsx` button customization, icon-only, and hasChevron cases                                                                                                                                                                                                                                                                                                                                                                                 | Button variants and sizes; icon-only; no chevron                                       | A Button prop that stops reaching the trigger fails. Evidence gap: the delegated Trigger Button gaps are asserted by `component:Button`'s own records, and no test here asserts the BottomSheet, List, Indicator, or Icon delegation beyond rendering.                                           | `audit:DropdownMenu/theming`       |
+| FR5                 | `DropdownMenu.test.tsx` press-model cases ("a finger that lands on one row and lifts on another acts on the second, once", "a mouse released outside closes the menu; a finger released outside leaves it open", "marks the menu as carrying the press model and owns touch scrolling"); `MenuPress.a11y.chromium.spec.ts`; the module record's own map                                                                                                       | Finger and mouse release; scrolling menu                                               | A row that acts on press-down, a mouse release outside that keeps the menu, or a missing press marker fails.                                                                                                                                                                                     | `audit:DropdownMenu/behavior`      |
+| FR6                 | `DropdownMenu.test.tsx` focus-return cases ("restores focus to the trigger after keyboard dismissal", "returns focus to the trigger after pointer dismissal without a focus ring", "leaves focus on the control a press outside landed on") and the "focus return after a pointer pick" and "a trigger the caller renders" cases                                                                                                                              | Keyboard and pointer close; Button and custom trigger                                  | A lost focus return, a ring after a pointer close, no ring after a keyboard close, or focus pulled off a control pressed outside fails.                                                                                                                                                          | `audit:DropdownMenu/accessibility` |
+| FR7                 | `DropdownMenu.test.tsx` menuMaxHeight cases                                                                                                                                                                                                                                                                                                                                                                                                                   | A cap above 300px; viewport bound                                                      | A menu clipped to 300px under a raised cap, or one that escapes the viewport, fails. Evidence gap: no test asserts that the touch sheet ignores the cap.                                                                                                                                         | `audit:DropdownMenu/layout`        |
+| FR8                 | `DropdownMenu.test.tsx` press-model trigger cases ("a mouse press on the trigger opens the menu and a drag-release acts on the row under it", "the opening release before the settle time acts on nothing and the menu stays", "pressing the trigger of an open menu closes it and does not reopen it in the same gesture", "a held touch on the trigger opens with the finger down and a slide picks", "a tap on the trigger still opens through its click") | Mouse press-open; held finger; tap                                                     | A mouse that opens only on click, an opening release that acts early, or a re-open in the closing gesture fails. The held-touch case asserts the current 500 ms hold, the FR8 gap pending conformance.                                                                                           | `audit:DropdownMenu/behavior`      |
+| FR9, AR1            | `DropdownMenu.test.tsx` custom trigger cases; `DropdownMenuSubMenu.test.tsx` "a menu hung off a custom trigger" cases                                                                                                                                                                                                                                                                                                                                         | Custom trigger open, keyboard, mouse, disabled; both props given; Back row names       | A custom trigger that does not open, toggle, or name the menu, a disabled one that opens, a missing warning, or a wrong Back row name fails.                                                                                                                                                     | `audit:DropdownMenu/accessibility` |
+| FR10, AR2, ORD1     | `DropdownMenu.test.tsx` "DropdownMenuItem href" and "link rows — the browser's own clicks" cases                                                                                                                                                                                                                                                                                                                                                              | Plain, modified, middle, and right click; Enter; bottom sheet; disabled; blocked       | A row that is not an anchor, a modified click that runs `onClick`, a middle click that does not close, a disabled row with an address, or a live blocked destination fails. Evidence gap: no test asserts the order of `onClick`, close, and navigation.                                         | `audit:DropdownMenu/behavior`      |
+| FR11, AR3           | `DropdownMenuSubMenu.test.tsx` "drill-in on a phone" cases; `DropdownMenuDrillIn.a11y.chromium.spec.ts`                                                                                                                                                                                                                                                                                                                                                       | Phone and laptop; forced presentations; theme breakpoint; reset on close               | A flyout on a phone, a drill-in on a laptop by default, a wrong name, a Back that loses focus, or a drilled view that survives a close fails.                                                                                                                                                    | `audit:DropdownMenu/accessibility` |
+| FR12, AR4           | `DropdownMenu.test.tsx` keyboard cases ("ArrowDown on the last row wraps to the first, ArrowUp on the first to the last", "ArrowUp on the trigger opens with the last row highlighted", "PageDown moves to the last row and PageUp back to the first", "the opening key's auto-repeat does not act on the highlighted row"), open-focus cases, typeahead cases, and "has aria-haspopup and aria-expanded attributes"                                          | Wrap, Page keys, open keys, auto-repeat, typeahead                                     | A missing wrap, a Page key that does not move, an ArrowUp open on the first row, an auto-repeat that acts, or a missing typeahead match fails. Evidence gap: no test asserts PageDown past the visible rows, typeahead ignoring chords or composition, or `aria-controls` on the Button trigger. | `audit:DropdownMenu/accessibility` |
+| FR13                | `DropdownMenuSubMenu.test.tsx` safe-triangle cases                                                                                                                                                                                                                                                                                                                                                                                                            | Diagonal path, pause inside, leaving both                                              | A flyout that closes inside the triangle or stays open after leaving it fails.                                                                                                                                                                                                                   | `audit:DropdownMenu/behavior`      |
+| FR14                | `DropdownMenu.test.tsx` section cases                                                                                                                                                                                                                                                                                                                                                                                                                         | Titled and untitled sections                                                           | A missing group role or title fails.                                                                                                                                                                                                                                                             | `audit:DropdownMenu/accessibility` |
+| FR15, AR5           | `DropdownMenu.test.tsx` header and footer cases, including the hidden-control, open-sub-menu, and header radio-group cases; `MenuHeaderFooter.a11y.chromium.spec.ts`                                                                                                                                                                                                                                                                                          | Regions present and absent; hidden controls; open flyout; custom trigger; bottom sheet | A region inside the menu, a missing or unnamed dialog, a wrong `aria-haspopup`, a Tab that leaves the popover, a hidden control taken as a stop, or a region whose keys the menu takes fails.                                                                                                    | `audit:DropdownMenu/accessibility` |
+| FR17, AR6           | `DropdownMenu.test.tsx` "skips aria-disabled menuitemradio and menuitemcheckbox items during arrow navigation" and "typeahead skips an aria-disabled item and matches the next enabled label" (the shipped behavior OQ1 leaves open); disabled-row cases                                                                                                                                                                                                      | Disabled rows                                                                          | A disabled row that runs a caller handler fails.                                                                                                                                                                                                                                                 | `audit:DropdownMenu/accessibility` |
+| FR20, AR7           | `DropdownMenuSubMenu.test.tsx` header and footer cases, including "on a phone"; `SubMenuHeaderFooter.a11y.chromium.spec.ts`; `ContextMenu.test.tsx` "shows a sub-menu with a header or footer as its rows alone, and says why in development"                                                                                                                                                                                                                 | Fine pointer and phone; Escape paths; nested flyouts; pointer leaving                  | A region inside a menu, an unnamed dialog, a Tab walk that does not wrap, an Escape that closes the root, or a flyout that closes while focus is inside fails.                                                                                                                                   | `audit:DropdownMenu/accessibility` |
+| FR21                | Evidence gap: no test, matching the FR21 gap                                                                                                                                                                                                                                                                                                                                                                                                                  | —                                                                                      | —                                                                                                                                                                                                                                                                                                | `audit:DropdownMenu/behavior`      |
+| PR1                 | Evidence gap: no test asserts the listener and observer bounds                                                                                                                                                                                                                                                                                                                                                                                                | —                                                                                      | —                                                                                                                                                                                                                                                                                                | `audit:DropdownMenu/behavior`      |
+| Theming anatomy map | `scripts/check-knowledge.mjs`                                                                                                                                                                                                                                                                                                                                                                                                                                 | Canonical anatomy and targets                                                          | Missing, extra, prefixed, stale, or alias-backed mappings fail repository validation.                                                                                                                                                                                                            | `audit:DropdownMenu/theming`       |
+
+## Current-state impact
+
+- **Finger press-open (FR8).** A held finger opens the menu after a 500 ms
+  hold, and a tap at its click, instead of as `spec:AST-094` FR29 states.
+- **Touch grow and pan dismissal (FR21).** Under a finger the menu appears and
+  leaves with the layer's own entrance and exit instead of growing out of and
+  back into the Trigger button, and a pan that starts outside does not close
+  it, against `spec:AST-094` FR31 and FR32.
+- **Delegated Trigger Button gaps (FR3).** The Trigger button scales on a press
+  under reduced motion and holds a fixed height, as `component:Button` records,
+  against `design:reduced-motion` DR1 and `spec:AST-102` FR4.
 
 ## Decision log
 
@@ -351,16 +381,32 @@ than adding a DropdownMenu-owned heading target.
 
 **Decider:** `cixzhang`, 2026-10-02
 
-The shipped behavior blurred the trigger after a pointer dismissal so Safari
-would not paint a ring after a touch pick. Focus falling to the page loses a
-keyboard user who reaches for the arrows next. Focus now returns to the
-trigger and the shared focus-return visibility helper suppresses the ring
+Blurring the trigger after a pointer dismissal would keep Safari from painting
+a ring after a touch pick, but focus falling to the page loses a keyboard user
+who reaches for the arrows next. Focus returns to the trigger and the shared focus-return visibility helper suppresses the ring
 after pointer input (`architecture:interaction-modality` INV1), as the
 bottom-sheet presentation already did. The press model's own decisions remain
 in `module:DropdownMenu/useMenuPress`.
 
 ### DEC-2 — `menuMaxHeight` is a number of pixels
 
+**Reference:** `component:DropdownMenu/DEC-2`
+**Decider:** `cixzhang`, `2026-10-02`
+
+`menuMaxHeight` replaces only the 300px term of the cap; the viewport gutters
+still bound the menu, so a menu that must show all of its rows (a docked phone
+menu of eleven 44px rows) can, without ever overflowing the screen. The dynamic
+value uses `100dvb` alone; every browser with anchor positioning has it.
+
+A prop rather than a theme variable, because the need is situational — one
+menu with many rows — rather than a product-wide preference, and a prop reads
+more clearly at the callsite that has the problem.
+
+The value is a number of pixels. Rejected: an arbitrary CSS length (`50vh`,
+`calc(...)`), which is product-shaped tuning on a shared component that
+`spec:AST-002` does not admit, and which lets a caller write a cap the
+viewport term cannot reason about.
+
 ### DEC-3 — Any control can open a menu
 
 **Reference:** `component:DropdownMenu/DEC-3`
@@ -425,48 +471,6 @@ menu; drill-in in data mode only — every menu in the app is compound; a
 `{label, children}` snapshot pushed onto the stack — unmounts the row and
 breaks focus return.
 
-## Open questions
-
-- **OQ1 — Which shared owner should make disabled menu rows keyboard-discoverable
-  without changing disabled behavior in non-menu composites?** (`human-api`)
-  WAI-ARIA's Menu pattern keeps disabled menu items focusable but inert. Current
-  `useListFocus` deliberately skips every `aria-disabled` item for all consumers,
-  and DropdownMenu's enabled-only focus-on-open and navigation tests depend on
-  that result. The requirement is objective; choosing a menu-specific hook policy
-  or a DropdownMenu-owned path changes a shared API and ownership boundary.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables, item examples, focus and
-positioning algorithms, implementation steps, or shared modality, layer,
-dismissal, and theming rules. It links to their owners.
-
-### DEC-5 — A row that goes somewhere is a link
-
-**Reference:** `component:DropdownMenu/DEC-5`
-
-**Decider:** vjeux, 2026-09-27 (owner confirmation pending)
-
-A menu row whose act is navigation renders as the anchor itself, not a row with
-an anchor inside, so a ⌘-click, Ctrl-click or middle click keeps the browser's
-meaning and `LinkProvider` routes it; `onClick` runs before navigation on a
-plain click and is skipped for a modified one, which the browser owns. The menu
-still closes on a modified click — the row acted. Keyboard activation
-synthesizes a click carrying the key's modifiers so ⌘-Enter opens a tab.
-
-Rejected: an `onClick` that calls `navigate()` — loses new-tab, middle-click
-and the router's prefetch; an inner anchor — two controls in one row.
-
-## Open questions
-
-OQ1 above remains the only open question.
-
-## Content boundary
-
-This file does not duplicate consumer prop tables, item examples, focus and
-positioning algorithms, implementation steps, or shared modality, layer,
-dismissal, and theming rules. It links to their owners.
-
 ### DEC-6 — A titled group of rows is `DropdownMenuGroup`
 
 **Reference:** `component:DropdownMenu/DEC-6`
@@ -494,25 +498,6 @@ focusable node inside a heading lands in the group but outside the roving
 focus order, so the arrow keys cannot reach it; the type does not prevent
 that and a case pins the behavior instead.
 
-### DEC-7 — A safe triangle protects the diagonal to a flyout
-
-**Reference:** `component:DropdownMenu/DEC-7`
-**Decider:** `cixzhang`, `2026-10-02`
-
-`menuMaxHeight` replaces only the 300px term of the cap; the viewport gutters
-still bound the menu, so a menu that must show all of its rows (a docked phone
-menu of eleven 44px rows) can, without ever overflowing the screen. The dynamic
-value uses `100dvb` alone; every browser with anchor positioning has it.
-
-A prop rather than a theme variable, because the need is situational — one
-menu with many rows — rather than a product-wide preference, and a prop reads
-more clearly at the callsite that has the problem.
-
-The value is a number of pixels. Rejected: an arbitrary CSS length (`50vh`,
-`calc(...)`), which is product-shaped tuning on a shared component that
-`spec:AST-002` does not admit, and which lets a caller write a cap the
-viewport term cannot reason about.
-
 ### DEC-8 — Controls beside the rows go in `header` and `footer`
 
 **Reference:** `component:DropdownMenu/DEC-8`
@@ -560,23 +545,18 @@ pattern requires; Escape and a press outside close it. Without either prop
 the component is unchanged: a Menu Button whose Tab closes the menu. Rejected:
 closing on Tab past either end, which leaves a modal dialog by Tab.
 
-### DEC-13 (proposed) — A sub-menu's header and footer make its surface a dialog beside the menu
-
-**Reference:** `component:DropdownMenu/DEC-13`
-**Decider:** proposed by `vjeux`, 2026-10-14; pending owner review
-
-A filter field above a sub-menu's rows, or a door below them, is a control
-that is not a menu item, so DEC-8 and DEC-10 apply to the sub-menu's own
-surface as they apply to the root's: the sub-menu's menu holds only its rows,
-and the surface around it is a named modal dialog whose Tab order wraps. A
-flyout renders inside the menu that holds its row, so a dialog there would
-still sit inside that menu; the `DropdownMenu` therefore renders a host beside its menu,
-inside its popover, and a sub-menu with regions renders its surface there (the
-flyout layer, or the drilled-in view, which then takes the root menu's place).
-Rendered there, a flyout no longer hides with the flyout that holds its row,
-so it closes with it. The pointer leaving that flyout does not close it while
-focus is inside, because what was typed into its field would go with it.
-Rejected: regions inside the flyout beside the sub-menu's menu,
-which puts them inside the parent menu; a separate DropdownMenu for the level,
-which loses the row, the drill-in and the single press model; and closing the
-flyout when the pointer leaves it as any flyout does.
+## Open questions
+
+- **OQ1 — Which shared owner should make disabled menu rows keyboard-discoverable
+  without changing disabled behavior in non-menu composites?** (`human-api`)
+  WAI-ARIA's Menu pattern keeps disabled menu items focusable but inert. Current
+  `useListFocus` deliberately skips every `aria-disabled` item for all consumers,
+  and DropdownMenu's enabled-only focus-on-open and navigation tests depend on
+  that result. The requirement is objective; choosing a menu-specific hook policy
+  or a DropdownMenu-owned path changes a shared API and ownership boundary.
+
+## Content boundary
+
+This file does not duplicate consumer prop tables, item examples, focus and
+positioning algorithms, implementation steps, or shared modality, layer,
+dismissal, and theming rules. It links to their owners.