Skip to content

spec(AST-094): the default look grows nothing for touch; 44 px hit areas never overlap a neighbor (FR42) #8633

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
cixzhang merged 10 commits into from
Oct 27, 2026
Merged

spec(AST-094): the default look grows nothing for touch; 44 px hit areas never overlap a neighbor (FR42) #8633

Changes from all commits
Commits
Show all changes
10 commits
Select commit Hold shift + click to select a range
d4bbaf0
spec(AST-094): the default look changes no size for touch; 44 px thro…
cixzhang Oct 27, 2026
dd5f239
spec(AST-094): FR42 — no size increase for touch, shrinking is fine; …
cixzhang Oct 27, 2026
cadff8d
Merge remote-tracking branch 'origin/main' into spec/ast094-no-mobile…
cixzhang Oct 27, 2026
6c32385
spec(AST-094): FR42 governs boxes; type sizing and deliberate hit are…
cixzhang Oct 27, 2026
ef63c83
Merge main (AST-094 FR19 scroll-edge exception) into spec/ast094-no-m…
cixzhang Oct 27, 2026
f8036e6
Merge remote-tracking branch 'origin/main' into spec/ast094-no-mobile…
cixzhang Oct 27, 2026
26f6b61
spec(AST-094): FR42's carve-outs reach its row and impact line; a box…
cixzhang Oct 27, 2026
81ce5a2
Merge main into spec/ast094-no-mobile-size
cixzhang Oct 27, 2026
0a9fe24
Merge main into spec/ast094-no-mobile-size
cixzhang Oct 27, 2026
5872deb
Merge main into spec/ast094-no-mobile-size
cixzhang Oct 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 33 additions & 1 deletion docs/specs/AST-094-touch-presentations/spec.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ a measured, sourced difference exists.
- Pointer (desktop) presentations. Their timing and easing stay with the
theme's duration and easing tokens (`architecture:theme-tokens`).
- Platform-matched look and feel: glass versus material surfaces, glyphs and
chrome. This record governs behavior only.
chrome. This record governs behavior, and touch sizing only as FR42 states.
- WebKit embedded in a native app and the native Swift package. This record
governs the web components themselves.
- Scroll physics. Scrolling stays native on every platform: on iOS an overflow
Expand Down Expand Up @@ -483,6 +483,21 @@ FR33 apply to menus only. A mouse keeps today's behavior.
This replaces `component:Selector` DEC-1's width-and-pointer query with the
FR13 rule for `adaptive`.

- **FR42 — The default look grows no box for touch.** The default Astryx
look makes no box size increase for phones or touch: row heights, control
sizes and target sizes stay as they are; a box may shrink to fit a compact
screen, such as an alert's phone width. Type sizing is outside this rule, including a box
that grows only with its text, such as a Button whose label follows the
16 px reading base:
the 16 px mobile reading base (`design:mobile-typography` DR1, DR3) and the
16 px text-entry floor (`family:input-fields` FR9) are unaffected. Under a
coarse pointer, touch targets meet 44 px through an invisible hit area. A
hit-area expansion never overlaps a neighboring interactive element's own
target: where neighbors are closer than 44 px, the expansion is clamped to
half the gap, or skipped, so each element stays reachable; an expansion a
component or module record sets on purpose, such as `component:Thumbnail` AR4's, is
unaffected. Mobile size increases belong to theme adaptations (DEC-20).

### Platform support

- Supported engines: Astryx's supported browsers (`spec:AST-013`) with touch
Expand Down Expand Up @@ -532,6 +547,9 @@ FR33 apply to menus only. A mouse keeps today's behavior.
and FR9 under a finger) are stated here (FR26–FR30); FR6's last sentence
gives way to the cell press profile (FR11); its mouse rules (FR8 and the
mouse halves of FR1–FR3) and its non-gesture rules stay in the module.
- Every component under a coarse pointer: no box grows for touch, and a
touch target reaches 44 px only through an invisible hit area clamped by
its neighbors, unless a component or module record sets its own (FR42).
- `component:DropdownMenu`, `component:ContextMenu` and `component:Popover`:
under a finger they follow FR26–FR35 as each applies.
- `component:AlertDialog`, `component:Dialog`, `component:BottomSheet`,
Expand Down Expand Up @@ -581,6 +599,7 @@ FR33 apply to menus only. A mouse keeps today's behavior.
| 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 |
| FR42 | Default-theme geometry tests under a coarse and a fine pointer, and hit-testing between adjacent targets | every component at phone width with a finger and with a mouse; a dense toolbar; a chip and its remove button; a Switch beside a label link | a default-theme box that grows under touch or at phone width other than with its text, or, where no component or module record sets the hit area, a touch target under 44 px where neighbors allow it or a hit area that overlaps a neighbor's target, 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 |

## Decision log
Expand Down Expand Up @@ -734,6 +753,19 @@ iOS 26.2 simulator measures it.

Rejected: the 150 ms delay on every menu row.

### DEC-20 — The default look grows nothing for touch

**Reference:** `spec:AST-094/DEC-20`
**Decider:** `cixzhang`, `2026-10-26`

Sizes do not grow on phones or under touch in the default look, so a product
looks the same everywhere unless its theme chooses otherwise; shrinking to fit
a compact screen is fine. Touch reach comes from invisible hit areas, clamped
so two close neighbors both stay reachable. Themes own mobile size increases
through their adaptations.

Rejected: touch-only row heights and control sizes in the default look.

### DEC-16 — Every touch presentation holds pointer input while it enters

**Reference:** `spec:AST-094/DEC-16`
Expand Down
Loading