Skip to content

An open source design system that's fully customizable and agent ready

TypeScript

spec(AST-094): every touch presentation holds pointer input while it enters (FR35) (#8618)

Cindy Zhang2f492195cf03
diff --git a/docs/specs/AST-094-touch-presentations/spec.md b/docs/specs/AST-094-touch-presentations/spec.md
index cce70add68..d98116491b 100644
--- a/docs/specs/AST-094-touch-presentations/spec.md
+++ b/docs/specs/AST-094-touch-presentations/spec.md
@@ -323,7 +323,8 @@ drives it and the primary pointer is coarse (FR19); where the primary pointer
is fine, a finger in a menu keeps today's behavior (`spec:AST-017` FR59,
DEC-25), and menus make no per-gesture pointer read; FR29 applies to DropdownMenu's trigger under the same
condition; FR34 applies to menus;
-FR31 and FR35 apply to anchored menus and to Popover under a finger; FR32 and
+FR31 applies to anchored menus and to Popover under a finger, and FR35 to
+the entrances it lists; FR32 and
FR33 apply to menus only. A mouse keeps today's behavior.
- **FR26 — The lift decides.** A menu row MUST act when the finger lifts over
@@ -395,11 +396,18 @@ FR33 apply to menus only. A mouse keeps today's behavior.
opened it (`component:DropdownMenu` FR11 and FR20). The change between
levels plays on the motion roles `springs.subMenuOpen` and
`springs.subMenuBack` (FR4); under reduced motion FR8 applies.
-- **FR35 — A presentation takes no input while it grows.** Under a finger, a
- tap or a drag that lands while a Popover or an anchored menu is still
- growing out of its trigger MUST NOT close it, scroll the page, move focus,
- or reach anything beneath it; the presentation finishes and stays open. A
- pinch still zooms the page (FR10). A mouse keeps today's behavior.
+- **FR35 — A presentation takes no input while it enters.** Under a finger, a
+ tap or a drag that lands while a touch presentation is still entering, a
+ Popover or an anchored menu growing out of its trigger, an alert
+ (`component:AlertDialog`), a sheet, a dialog, a Drawer, MobileNav, or
+ Lightbox, MUST NOT close it, scroll the page, move focus, or reach anything
+ beneath it; the presentation finishes entering and stays open. Around a non-modal sheet
+ only a tap or a drag on the sheet is held; the page stays live
+ (`component:BottomSheet` FR11, `component:BottomSheetSwitcher` FR5). Only pointer
+ input is held: keys and assistive technology stay live, and the content stays
+ in the accessibility tree. A pinch still zooms the page (FR10). During an entrance this
+ rule applies instead of FR6's catch: the entrance finishes first. A mouse
+ keeps today's behavior (DEC-16).
### Release decisions
@@ -526,6 +534,17 @@ FR33 apply to menus only. A mouse keeps today's behavior.
mouse halves of FR1–FR3) and its non-gesture rules stay in the module.
- `component:DropdownMenu`, `component:ContextMenu` and `component:Popover`:
under a finger they follow FR26–FR35 as each applies.
+- `component:AlertDialog`, `component:Dialog`, `component:BottomSheet`,
+ `component:BottomSheetSwitcher`, `component:Drawer`, `component:MobileNav`
+ and `component:Lightbox`: under a finger, a tap or a drag during the
+ entrance is held (FR35), an exception during the entrance to
+ `component:BottomSheet` FR7, `component:BottomSheetSwitcher` FR6,
+ `component:Popover` DEC-8 (a Popover presented as a sheet),
+ `component:MobileNav` FR4 and `family:overlay-dismissal` AV4, which otherwise
+ let a scrim or overlay tap close at any time (`spec:AST-003` FR10 and
+ `architecture:layer-runtime` INV14 leave dismissal to the component). Toast and a non-modal sheet (`component:BottomSheetSwitcher` FR5 and its
+ Non-modal state) do not hold the page: the page behind them stays live, and
+ only the sheet itself holds a tap or a drag while it enters.
- BottomSheet, Toast, Lightbox, NavigationStack and keyboard dismissal: a
drag that commits follows FR36–FR40.
- `spec:AST-100` owns release velocity, which FR17 reads.
@@ -559,7 +578,7 @@ FR33 apply to menus only. A mouse keeps today's behavior.
| FR26–FR28, FR30 | Menu press tests on synthetic touch streams and a real-Chromium touch test | a slide from one row to another; a lift outside; a cancel; a second finger; edge autoscroll | an act on the press-start row, two acts for one gesture, a lift outside that closes, or a lit row after a cancel fails |
| FR29 | Trigger tests with explicit timestamps | a press in a fixed bar; a press in scrolling content held 149 and 150 ms; a quick tap in scrolling content; a scroll taking the touch before 150 ms; a drift of 12 and 14 pt; moves before and after the handoff; `presentation="popover"` | a fixed-bar press that waits, a held finger's scroll-view open before 150 ms or after a scroll, a quick tap that does not open at its lift, an open past the drift allowance, a lift that acts before the handoff, or a `popover` trigger that opens on press fails |
| FR31–FR33 | Browser tests and storyboards under a finger | a menu, a Popover and a ContextMenu lift: open, close, a pan outside, a tap outside, a pinch over the surface; a mouse | a surface that does not grow from and shrink into its trigger, a pan outside that leaves a menu open, a Popover whose dismissal changed, a pinch blocked other than by the author's `touch-action`, a tap outside that reaches the page, or a changed mouse path fails |
-| FR34, FR35 | Browser tests and storyboards under a finger | a sub-menu drilling in and its Back row returning; a tap and a drag during a popover's and a menu's growth; a pinch during growth; a mouse | a drill-in that leaves the parent's rows in place, a change between levels that does not play on its roles, a tap during growth that closes, scrolls or moves focus, a pinch blocked other than by the author's `touch-action`, or a changed mouse path fails |
+| FR34, FR35 | Browser tests and storyboards under a finger | a sub-menu drilling in and its Back row returning; a tap and a drag during a popover's and a menu's growth; a pinch during growth; a mouse; a tap and a drag during an alert's, a sheet's, and a dialog's entrance; a key and a screen reader during an entrance; a pinch during an alert's and a sheet's entrance; a tap and a scroll on the page beside an entering non-modal sheet, which pass | a drill-in that leaves the parent's rows in place, a change between levels that does not play on its roles, a tap during growth that closes, scrolls or moves focus, a pinch blocked other than by the author's `touch-action`, or a changed mouse path, a held key or assistive-technology activation, a hidden content tree, or a tap or drag during an entrance that closes the presentation, scrolls a held page, moves focus or reaches anything beneath, fails |
| FR36–FR40 | Release tests on synthetic touch streams with explicit timestamps, per use | below and past each commit point; a flick that projects past it; a slow drag past it; a release moving back; Reduce Motion; keyboard and mouse paths | a decision that changes mid-settle, a release moving back that commits, a settle that does not start at the release velocity, or an action with no keyboard or mouse path fails |
| FR41 | Browser tests with real touch input (`spec:AST-013` FR10) | a tap; a long press on a ContextMenu trigger, a DropdownMenu trigger the caller renders, a row with a context menu, and a slider thumb; a long press on a checkbox row's label and on plain text; a cancelled press; mouse and keyboard selection | a tap that selects, a hold with an action that starts a selection or callout, a label or plain text whose long press does not select natively, a suppression that outlives the press, or a change to native selection elsewhere or to mouse, keyboard, or assistive-technology selection fails |
| all | iOS simulator: the UIKit reference capture and the same gesture in Safari; real iOS Safari and Android Chrome devices | per component | an unmatched curve or timing is a parity defect |
@@ -715,6 +734,18 @@ iOS 26.2 simulator measures it.
Rejected: the 150 ms delay on every menu row.
+### DEC-16 — Every touch presentation holds pointer input while it enters
+
+**Reference:** `spec:AST-094/DEC-16`
+**Decider:** `cixzhang`, `2026-10-26`
+
+A tap or a drag that lands while an alert, a sheet, or a dialog is still
+entering is almost never aimed at it, so it is absorbed, as it already is for
+a popover or a menu growing out of its trigger. Only pointer input is held, so
+keyboard and assistive-technology users are never blocked.
+
+Rejected: holding input only for presentations that grow from a trigger.
+
### DEC-19 — A phone menu stays beside its trigger
**Reference:** `spec:AST-094/DEC-19`