Skip to content

feat(lab): CircleCheckIndicator, the iOS multiple-selection circle - #8255

Draft
vjeux wants to merge 1728 commits into
meta:mainfrom
vjeux:uikit/c06-lab-circle-check
Draft

vjeux wants to merge 1728 commits into
meta:mainfrom
vjeux:uikit/c06-lab-circle-check

Conversation

@vjeux

@vjeux vjeux commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Depends on #8226. Review only this PR's change: vjeux/astryx@bf74a5b...32cc71b (it also lists #8562's commits). Carries #8562 (Core's internal entries) as a dependency; if the entries land differently, this follows her decision.

User need

iOS marks multiple selection with a circle (Mail and Files edit modes, .multiselect() lists). Astryx only has the box, so iOS products hand-roll one.

  1. Why: core ships one multiSelection indicator, the box.
  2. Why: rounding the box gives neither the clear ring nor UIKit's checkmark.
  3. Why: iOS users read this circle as "pick several".

Evidence

iOS 26.2 Mobile Safari: a finger (magenta ring) toggling rows; each circle changes in one frame. Below, UIKit's circle and ours at 3×:

A finger toggling CircleCheckIndicator rows in iOS Safari

UIKit's multiselect circle and CircleCheckIndicator in iOS Safari

A held finger on a mapped CheckboxInput, iOS 26.2: a square before, round after. Android 15 Chrome: that press (½ speed) and a row tap (¼ speed):

The press on a mapped circle in iOS Safari, before and after

Android Before After
Held press before after
Tap before after

Both sizes, every state:

CircleCheckIndicator states in iOS Safari

Problem and solution fit

CircleCheckIndicator (lab), a multiSelection-family indicator, draws an empty ring, or a filled circle with a checkmark (a bar when partial).

  • Geometry is UIKit's (iOS 26.2), kept beside the circle (circleCheck.table.ts): md at Large text, sm at xSmall, mirrored for StyleX and held to the table by a test.
  • Colours are the theme's (accent fill, emphasized border).
  • Timing: one frame under a finger (TOUCH_QUERY), on every touch device; with a mouse the theme fade, instant under Reduce Motion.
  • Press and hover are round: the circle paints them from properties CheckboxInput hands down; the host's square layer stays off for an indicator marked indicatorPressScope + data-astryx-indicator-press="self".

Current specification

  • spec:AST-094 FR1, FR2, FR13; lab first, on Core's public subpaths. design:reduced-motion (current) DR3.
  • Themes already replace indicators by name; core's API is unchanged.
  • Proposed; pending owner review: the component and its name.

Public delta and caller burden

  • New lab export CircleCheckIndicator (IndicatorProps<'multiSelection'>). Opting in is one theme line; hosts keep semantics and focus:
const theme = defineTheme({name: 'ios', indicators: {checkbox: CircleCheckIndicator}});
  • Core: the indicatorPressScope marker; lab: the harness as a dev dependency.
  • Size: base → head per component in this pull request's CI Component Size report (analyze-pr.js).

Design and alternatives

  • The ring is an inset shadow (a border snaps to device pixels); forced colors falls back to a border.
  • Rejected: a shape prop (the registry swaps visuals by name) and a rounded box.
  • Not here: list edit mode, Dynamic Type, Bold Text, Increase Contrast; the docs say to map the circle only in an iOS theme.

Scope

  • One capability is added.
  • Unrelated fixes, cleanup, and policy changes were removed or split.
  • Consumer docs, focused tests, and migration evidence ship with the feature.
  • Public text and artifacts contain no internal Meta context.

Testing

@vercel

vercel Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
astryx Ready Ready Preview Oct 29, 2026 9:01pm UTC

Request Review

@meta-cla meta-cla Bot added the CLA Signed This label is managed by the Meta Open Source bot. label Oct 24, 2026
@astracat-bot

astracat-bot Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

AI review status for this pull request.

Review status Updated
❓ Needs maintainer input (for maintainers only) Oct 31, 2026, 1:42 PM UTC

@github-actions

github-actions Bot commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

PR Analysis Report

📚 Storybook Preview

View Storybook for this PR

🧪 Sandbox Preview

View Sandbox for this PR

New Components

CircleCheckIndicator (@astryxdesign/lab) · View in Storybook
Metric Value
Entry File (ESM) 183B
Lines of Code 244
Source Files 4
Complexity Medium (11)
Exports CircleCheckIndicator
Props Count N/A
Has Tests Yes
Has Stories Yes

Modified Components

CheckboxInput (@astryxdesign/core) · View in Storybook
Metric Before After Delta
Entry File (ESM) 478B 478B 0B
Lines of Code 355 381 -
Complexity Very High Very High (40) -

Component Size

Component Import before Import after Delta CSS before CSS after Delta
core/AlertDialog 56.9KB 57.0KB +117B 12.4KB 12.4KB 0B
core/AppShell 57.9KB 58.0KB +90B 11.6KB 11.6KB 0B
core/AvatarGroupOverflow 39.9KB 40.0KB +125B 6.4KB 6.4KB 0B
core/Banner 47.8KB 47.9KB +123B 9.9KB 9.9KB 0B
core/BaseTypeahead 54.3KB 54.4KB +111B 9.9KB 9.9KB 0B
core/BreadcrumbItem 66.4KB 66.5KB +105B 11.0KB 11.0KB 0B
core/Button 43.3KB 43.4KB +102B 9.2KB 9.2KB 0B
core/Calendar 54.9KB 55.0KB +110B 10.0KB 10.0KB 0B
core/Carousel 50.2KB 50.3KB +82B 10.2KB 10.2KB 0B
core/ChatComposer 60.6KB 60.7KB +100B 10.8KB 10.8KB 0B
core/ChatComposerInput 55.7KB 55.8KB +99B 10.1KB 10.1KB 0B
core/ChatComposerTokenElement 55.7KB 55.8KB +100B 10.1KB 10.1KB 0B
core/ChatDictationButton 46.5KB 46.6KB +107B 9.5KB 9.5KB 0B
core/ChatLayout 48.8KB 48.9KB +104B 9.9KB 9.9KB 0B
core/ChatLayoutScrollButton 46.4KB 46.5KB +84B 9.6KB 9.6KB 0B
core/ChatSendButton 45.8KB 45.9KB +96B 9.2KB 9.2KB 0B
core/CheckIndicator 9.0KB 9.0KB 0B 3.6KB 3.6KB 0B
core/CheckboxIndicator 4.1KB 4.1KB +32B 3.8KB 3.8KB +44B
core/CheckboxInput 49.9KB 50.1KB +223B 9.3KB 9.5KB +161B
core/CheckboxListItem 54.0KB 54.2KB +205B 10.5KB 10.6KB +163B
core/ClickableCard 12.8KB 12.9KB +117B 6.9KB 6.9KB 0B
core/CodeBlock 60.5KB 60.6KB +106B 10.7KB 10.7KB 0B
core/Collapsible 11.7KB 11.8KB +113B 4.2KB 4.2KB 0B
core/CommandPalette 50.9KB 51.0KB +104B 11.8KB 11.8KB 0B
core/CommandPaletteItem 8.4KB 8.5KB +110B 3.5KB 3.5KB 0B
core/ComplexSelector 55.8KB 55.9KB +132B 10.6KB 10.6KB 0B
core/ContextMenu 77.7KB 77.9KB +215B 14.6KB 14.8KB +203B
core/ContextMenuItem 16.6KB 16.7KB +117B 5.2KB 5.2KB 0B
core/DateInput 99.9KB 100.0KB +88B 14.8KB 14.8KB 0B
core/DateRangeInput 69.4KB 69.5KB +103B 11.2KB 11.2KB 0B
core/DateTimeInput 110.1KB 110.2KB +77B 15.2KB 15.2KB 0B
core/DialogHeader 48.8KB 48.9KB +101B 9.8KB 9.8KB 0B
core/DrawerHeader 48.9KB 49.0KB +97B 11.2KB 11.2KB 0B
core/DropdownMenu 72.7KB 72.8KB +106B 14.7KB 15.0KB +246B
core/DropdownMenuCheckboxItem 16.1KB 16.3KB +146B 5.6KB 5.6KB +39B
core/DropdownMenuItem 15.4KB 15.5KB +101B 5.2KB 5.2KB 0B
core/DropdownMenuRadioItem 16.2KB 16.3KB +144B 5.6KB 5.6KB +39B
core/DropdownMenuSubMenu 58.1KB 58.2KB +95B 9.5KB 9.5KB 0B
core/FileInput 54.1KB 54.2KB +102B 10.3KB 10.3KB 0B
core/IconButton 43.3KB 43.4KB +113B 9.2KB 9.2KB 0B
core/Item 11.4KB 11.5KB +98B 4.7KB 4.7KB 0B
core/LayerProvider 63.3KB 63.4KB +121B 10.1KB 10.1KB 0B
core/Lightbox 51.2KB 51.3KB +95B 9.8KB 9.8KB 0B
core/Link 43.5KB 43.6KB +112B 7.6KB 7.6KB 0B
core/ListItem 53.5KB 53.7KB +217B 10.5KB 10.6KB +163B
core/Markdown 144.5KB 144.6KB +193B 17.4KB 17.5KB +167B
core/MobileNav 51.0KB 51.1KB +97B 10.1KB 10.1KB 0B
core/MobileNavToggle 46.2KB 46.3KB +104B 9.4KB 9.4KB 0B
core/MoreMenu 72.9KB 73.0KB +103B 14.7KB 15.0KB +246B
core/MultiSelector 76.2KB 76.4KB +256B 14.6KB 14.8KB +195B
core/NumberInput 55.7KB 55.8KB +108B 10.7KB 10.7KB 0B
core/Outline 28.6KB 28.7KB +113B 4.0KB 4.0KB 0B
core/Pagination 87.7KB 87.9KB +155B 15.3KB 15.4KB +40B
core/Popover 49.8KB 49.9KB +84B 12.1KB 12.1KB 0B
core/PowerSearch 155.1KB 155.2KB +148B 18.6KB 18.7KB +42B
core/RadioIndicator 3.8KB 3.9KB +30B 3.7KB 3.8KB +43B
core/RadioListItem 52.1KB 52.3KB +149B 9.7KB 9.8KB +69B
core/SegmentedControlItem 8.6KB 8.7KB +116B 3.9KB 3.9KB 0B
core/SelectableCard 12.8KB 12.9KB +114B 7.1KB 7.1KB 0B
core/Selector 79.1KB 79.2KB +114B 15.0KB 15.1KB +85B
core/SelectorOption 14.5KB 14.6KB +97B 5.1KB 5.1KB 0B
core/SideNav 58.0KB 58.1KB +97B 10.6KB 10.6KB 0B
core/SideNavCollapseButton 46.6KB 46.7KB +90B 9.5KB 9.5KB 0B
core/SideNavHeading 54.7KB 54.8KB +96B 10.1KB 10.1KB 0B
core/SideNavItem 54.5KB 54.6KB +97B 10.1KB 10.1KB 0B
core/Step 32.4KB 32.5KB +118B 5.3KB 5.3KB 0B
core/Stepper 47.4KB 47.5KB +106B 9.6KB 9.6KB 0B
core/Switch 48.4KB 48.5KB +111B 9.3KB 9.3KB 0B
core/Tab 9.7KB 9.8KB +119B 4.1KB 4.1KB 0B
core/TabList 40.2KB 40.2KB 0B 7.2KB 7.2KB 0B
core/TabMenu 51.6KB 51.7KB +83B 10.0KB 10.0KB 0B
core/Table 84.0KB 84.2KB +220B 15.1KB 15.3KB +181B
core/TableCell 78.8KB 79.0KB +229B 14.8KB 15.0KB +208B
core/TableHeaderCell 78.6KB 78.8KB +237B 14.8KB 15.0KB +221B
core/TableSelectionToolbar 52.4KB 52.5KB +98B 11.2KB 11.2KB 0B
core/TextInput 53.5KB 53.6KB +100B 10.5KB 10.5KB 0B
core/Thumbnail 50.7KB 50.8KB +103B 11.0KB 11.0KB 0B
core/TimeInput 86.8KB 86.9KB +83B 13.8KB 13.8KB 0B
core/Timestamp 27.5KB 27.5KB 0B 9.5KB 9.5KB 0B
core/Toast 59.8KB 59.9KB +105B 9.7KB 9.7KB 0B
core/ToggleButton 44.1KB 44.2KB +91B 9.3KB 9.3KB 0B
core/Token 29.6KB 29.7KB +111B 4.5KB 4.5KB 0B
core/Tokenizer 64.8KB 64.9KB +114B 11.7KB 11.7KB 0B
core/TopNav 51.9KB 52.0KB +104B 10.4KB 10.4KB 0B
core/TopNavHeading 54.2KB 54.3KB +101B 9.9KB 9.9KB 0B
core/TopNavItem 9.0KB 9.2KB +116B 3.8KB 3.8KB 0B
core/TopNavMegaMenu 54.2KB 54.3KB +121B 10.8KB 10.8KB 0B
core/TopNavMegaMenuItem 9.1KB 9.2KB +119B 4.1KB 4.1KB 0B
core/TopNavMenu 53.6KB 53.7KB +97B 10.1KB 10.1KB 0B
core/TreeList 32.5KB 32.6KB +111B 4.7KB 4.7KB 0B
core/Typeahead 61.5KB 61.6KB +101B 11.3KB 11.3KB 0B
lab/CircleCheckIndicator N/A 4.3KB N/A N/A 1.0KB N/A

Sizes are gzip. Import counts the JavaScript the import loads eagerly; CSS counts the package stylesheet rules referenced by the modules it can load from its own package, lazily loaded ones included.

Bundle Size Summary

Gzip figures measure each package's entry file, not the code an import pulls in.

Package Entry (ESM) Entry gzip before Entry gzip after Delta
@astryxdesign/core 4.9KB 1.2KB 1.2KB 0B
@astryxdesign/lab 4.8KB 1.9KB 2.0KB +74B
Package stylesheet Gzip before Gzip after Delta
@astryxdesign/core 34.6KB 34.7KB +124B
@astryxdesign/lab 11.1KB 11.6KB +467B

Accessibility Audit

Status: No accessibility violations detected.

Visual Regression

55 of 502 shot(s) changed.

A change here is a question, not a failure: check whether the after is the
picture you intended. Record that review on the PR. Baseline maintenance is an
explicit dispatch of CI; this report never rewrites the baseline or adds a release gate.

component story theme mode pixels
Selector Indicator Space Bottom Sheet Narrow End RTL neutral light 753,933
Selector Indicator Space Bottom Sheet Wide Start neutral light 740,072
RichTextEditor Markdown parity: side by side probe dark 558,840
RichTextEditor Markdown parity: side by side probe light 540,756
Chat Full AI Chat probe light 230,823
Chat Full AI Chat probe dark 229,805
AppShell With Mobile Nav probe light 217,010
AppShell With Mobile Nav probe dark 216,960
Collapsible Dividers probe dark 66,445
Collapsible Dividers probe light 66,445
AppShell Playground neutral dark 65,198
AppShell Playground neutral light 63,788
Chat Default neutral dark 36,304
Chat Default neutral light 35,767
Chat Empty State probe light 23,531
Chat Empty State probe dark 22,622
ChatAutoScroll Scroll Behavior Comparison neutral dark 15,378
ChatAutoScroll Scroll Behavior Comparison neutral light 14,107
Chat With Attachments probe light 13,406
Chat With Attachments probe dark 11,232

and 35 more.


Generated by PR Enrichment workflow | Storybook | Sandbox | View full report

@astracat-bot astracat-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This pull request is on hold for a spec decision. CircleCheckIndicator, its selection.multiselectCircle table entry and the one-frame touch timing of the core checkbox and radio marks rest only on the draft spec:AST-094 (FR1, FR2 and FR4, including FR4's narrowing of architecture:theme-tokens). An engineering owner needs to approve those claims, or name the spec that governs them, by commenting /approve-spec <full head SHA> on this pull request; the author may do so as an engineering owner. These changes are needed either way:

  • Rebase or retarget once #8076, #8226 and their predecessors land, so this pull request carries only its own commit (about 1,270 lines) instead of 28,039 authored lines.
  • CheckboxInput's press layer stays a 24 px rounded square over the 21.8 px circle, so every press tints past the circle; paint it on the indicator element or clip it to the indicator's radius.
  • CircleCheckIndicator.doc.mjs documents 20/24 px, but the circle draws at 18/21.8 px.
  • .changeset/selection-marks-touch-one-frame.md should be [feat], since it changes visual direction rather than restoring it.

[Automated review]

{
name: 'size',
type: "'sm' | 'md'",
description: 'Control size: 20px or 24px.',

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The circle draws at 18 px (sm) and 21.8 px (md) (circleCheck.stylex.ts:42, :52), not 20/24 px. The same text is repeated at :109 and :198.

{
guidance: true,
description:
'Map it with defineTheme({indicators: {checkbox: CircleCheckIndicator}}) so CheckboxInput and CheckboxList keep their semantics and focus ring.',

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mapped into CheckboxInput (and CheckboxList rows, which render one), the host still paints its 24 px, 4 px-radius press layer (CheckboxInput.tsx:88-119). Every mouse or touch press therefore tints a rounded square past the 21.8 px circle. Painting that layer on the indicator element, as the focus ring already is, or clipping it to the indicator's radius would keep the press round.

'@astryxdesign/core': patch
---

[fix] Under a finger, a checkbox or radio mark now changes in the frame the selection lands, the way iOS shows a selection mark. The box or circle used to fade between its two colors over the theme duration, so a tap first showed half-filled frames. With a mouse the marks keep the theme duration and easing, and Reduce Motion is unchanged.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

spec:AST-017 FR3 uses [fix] for a change that restores current visual authority and [feat] for one that intentionally changes visual direction. No current record states one-frame touch marks, so this should be [feat].

@astracat-bot astracat-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approval of this pull request waits on an owner decision. The new lab CircleCheckIndicator, its selection.multiselectCircle table entry and the one-frame touch timing of core's checkbox and radio marks rest only on draft spec:AST-094 FR1, FR2 and FR4, including FR4's narrowing of architecture:theme-tokens to pointer presentations, and no engineering owner has approved them. An engineering owner records that decision by commenting /approve-spec <full head SHA> on this pull request, or names the spec that should govern instead; the author may do so if they are an engineering owner. Whatever the decision, please land the predecessor pull requests and rebase so only this change remains (the compare carries about 28,000 authored lines), then fix:

  • CheckboxInput's 24 px press layer shows as a square around the 21.8 px circle (CheckboxInput.tsx:88-119).
  • The docs give 20px and 24px, but the circle draws 18 px and 21.8 px (CircleCheckIndicator.doc.mjs:32, :109, :198).
  • uikit.selection needs @experimental (selection.ts:33), and the one-frame marks changeset should be [feat], not [fix].

[Automated review]

{
name: 'size',
type: "'sm' | 'md'",
description: 'Control size: 20px or 24px.',

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The circle draws 21.8 px at md and 18 px at sm (circleCheck.stylex.ts:42, :52), but this line, :109 and :198 say 20px or 24px. Please state the drawn diameters.

{
guidance: true,
description:
'Map it with defineTheme({indicators: {checkbox: CircleCheckIndicator}}) so CheckboxInput and CheckboxList keep their semantics and focus ring.',

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Mapped hosts do keep their focus ring. However, CheckboxInput's press layer (CheckboxInput.tsx:88-119) is a 24 px rounded square, with a 6 px radius in the Storybook theme, so pressing tints a square around the 21.8 px circle. Painting the press on the indicator, or rounding the layer with the indicator's radius, would keep this promise.

* circleCheck.test.tsx checks it).
*/

export const selection = {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Every other declaration the uikit namespace re-exports carries @experimental, motion/experimental.ts:14-15 promises it, and AST-017 FR21 requires it ("Declarations carry @experimental"). Please add a JSDoc block with @experimental here.

'@astryxdesign/core': patch
---

[fix] Under a finger, a checkbox or radio mark now changes in the frame the selection lands, the way iOS shows a selection mark. The box or circle used to fade between its two colors over the theme duration, so a tap first showed half-filled frames. With a mouse the marks keep the theme duration and easing, and Reduce Motion is unchanged.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

AST-017 FR3 uses [fix] for a change that restores current visual authority and [feat] for one that intentionally changes visual direction. No current record states one-frame touch marks, so this should be [feat].

});
}, [ref, recognizer, manageStyle]);

useIsomorphicLayoutEffect(() => {

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Turning a live recognizer off cancels it (GestureRecognizer.ts:557-561), which calls onGesture from this layout effect. architecture:react-component-runtime INV3 asks the effect to name the external system it synchronizes; a comment here would cover it.

@vjeux
vjeux force-pushed the uikit/c06-lab-circle-check branch from 1ccf210 to 8b5b198 Compare October 24, 2026 22:52
@cixzhang

Copy link
Copy Markdown
Contributor

Posted by Cindy's agent on her behalf.

Parts of this PR re-implement behavior that already exists, or is being specified, as a shared part of core. Converging keeps one implementation per behavior:

This is about where the behavior lives, not about the PR's intent.

@vjeux

vjeux commented Oct 24, 2026

Copy link
Copy Markdown
Contributor Author

Agreed: one implementation.

  • Touch gating: the circle's mark keys on the touch resolver's TOUCH_QUERY alone, with no platform gate, and the circle's own press layer has no pointer check at all: it paints the host's press paint, which stays transparent unless the shared controller presses the row. The mark's key moves to the resolver's importable constant when that lands. Commit 4295e04, in the next push.
  • Reduced motion: the local reduced-motion arm is replaced by the instant key of the shared policy (motion/reducedMotion.ts), which applies to a mouse; under a finger the mark already changes in one frame. Same commit and push.

@vjeux
vjeux force-pushed the uikit/c06-lab-circle-check branch from 8b5b198 to 4295e04 Compare October 24, 2026 23:41
@vjeux

vjeux commented Oct 24, 2026

Copy link
Copy Markdown
Contributor Author

Pushed in 4295e04: the circle's mark keys on TOUCH_QUERY alone, its press layer has no pointer check, and a mouse under Reduce Motion takes the shared policy's instant key.

@vjeux

vjeux commented Oct 25, 2026

Copy link
Copy Markdown
Contributor Author

Pushed in 5023c80: core's press arm imports touchKeys.touch; the circle's own mark keeps the two keys spelled, with a comment, until a lab import of core's keys compiles in every build (#8324).

vjeux added 26 commits October 28, 2026 17:39
…llowance under every primary pointer

The useMenuPress record's FR9 puts the trigger's held finger under
spec:AST-094 FR29 under every primary pointer (FR43), so a finger on a
touchscreen laptop may drift 13 pt before the open, as on a phone. The
trigger read (pointer: coarse) as its press started and took the long
press's 10 px where the pointer was fine. Three cases fail until it does
not: a 12 pt drift opens under a fine pointer too, a (12, 12) settle
opens there, and nothing reads a pointer query, the trigger's press
included.
…lowance under every primary pointer

The useMenuPress record's FR9 governs the trigger's held finger by
spec:AST-094 FR29 under every primary pointer (FR43). The trigger now
hands the long press FR29's 13 px drift allowance whatever the primary
pointer, so it no longer reads (pointer: coarse) as its press starts, and
the menus drop their coarsePointer import. ContextMenu keeps the long
press's own allowable movement. The changeset says the same.
Strict ESLint reported six unused bindings in files this pull request
carries: the host's HAPTIC_SWITCH_ATTRIBUTE import, two unused imports
in the pan's tests (scrollProbe, ScreenEdgePanGestureRecognizer), the
swipe test's drift, the presented-hit-testing test's gestures, and a
GestureHost test's before, which now asserts what it was read for: a
second finger's moves leave the pan where it was.
…eal angular speed

The release velocity of a rotation whose listener sets rotation = 0 on
each change, at 2 degrees every 16 ms, read 4.363 rad/s against the
2.182 rad/s of the same stream without a re-base: the test asserted only
more than 1.5. It now asserts the 2.18 rad/s (spec:AST-100 FR2), and
fails.
The rotation's velocity tracker samples the raw unwrapped angle, which
setting rotation does not move, so the setter's shift of the samples read
each re-base as extra turn and doubled the release velocity of a
listener that re-bases on every change. The setter no longer touches the
tracker.
…mates while it runs

The proof read the element's animations 230 ms in, after the dip had
ended, and asserted only that every animated key is opacity, which an
empty list passes: with the cross-fade removed from the plan (the move
still landing), the proof still passed. It now reads the keyframe keys
right after the call starts and asserts they include opacity and nothing
else; the same mutant fails it. Chromium and WebKit pass. (F1's in-flight
read from c648034.)
…roller, and its claimed moves are cancelled under pointer events

Two comparisons stop at the shadow boundary, each failing a case:
- once the host's listener on a recognizer's inner node has seen the
  finger, isFingerDownIn reads it as outside a light-DOM scroller around
  that root, so a scroll under it is not the finger's (FR20);
- under inputMode 'pointer-events', a claimed pan on a shadow host
  cancels none of its finger's moves over the inner content, since the
  finger's target is the inner node and its touches reach the host
  retargeted (FR19).
…the flat tree

isFingerDownIn and the pointer-events finger match compare with
containsAlongFlatTree, as the scroll watch already does: a finger on
content inside an open shadow root is down in the scroller around that
root, and its touches, retargeted to the shadow host, match its pointer
finger, so a claimed pan cancels its moves there (spec:AST-094 FR19,
FR20).
…achments asks, and only then

The host let the last attachment decide whether an element is an action
group (useGestureRecognizer always passes the option), and never
recomputed it at a detach: a plain attachment after the group's turned
the group off, and a group's attachment released left a recognizer that
never asked taking presses under a fine pointer. Fails until the host
counts the attachments that ask.
…ents asks

The host counts the attachments that pass actionGroup: true and keeps the
element a group while one remains, recomputed at each detach. An
attachment that passes false, as useGestureRecognizer does by default,
no longer turns a group off, and a group's last asking attachment taking
its leave ends the group.
… that content

The presented hit test takes the document's elementFromPoint, which
answers a shadow host for anything inside its open root, and compares
with Node.contains, which stops at the boundary: a recognizer on a
control inside a moving sheet's shadow root gets no finger, and the tap's
click goes to the host. Fails until the hit test descends into open roots
and compares along the flat tree.
Where a moving element is drawn away from its layout box, the host
hit-tests what is drawn under the finger with the document's
elementFromPoint, which answers a shadow host for anything inside its
open root. The hit test now descends through each open root's own
elementFromPoint and compares with the movers along the flat tree, so a
recognizer on a control inside a moving sheet's shadow root gets its
finger and the tap clicks that control.
…nt lets go

The host's touch-action rules sit in an adopted sheet or a style element
per document or shadow root, and were never removed, so a page whose
last recognizer detached kept them, against spec:AST-094 FR24 (nothing
touch-related remains after the last instance unmounts). Fails until a
root's rules go with its last marked element.
…th its last marked element

The touch-action writer records which elements it marked in each
document or shadow root, and when the last one is unmarked (its last
recognizer detached) it removes that root's adopted sheet or style
element, so nothing touch-related remains after the last instance
unmounts (spec:AST-094 FR24). A later mark writes the rules again; an
element marked in another root first lets go of the old one.
… the inline style it reads

- The motion registry, the host's engine gate and the README name the
  presented hit test as an engine workaround (spec:AST-013 FR6) with its
  review condition (re-measure on each iOS release; remove it once iOS
  WebKit hit-tests a compositor-moved element where it is drawn) and its
  regression fixture.
- While a curve runs the animator holds the value it starts from inline,
  so presentation.ts and the README no longer say the inline style holds
  the end.
…core/internal/touch

Core ships the internal entry @astryxdesign/core/internal/touch, which
re-exports the gesture primitives for Astryx's own packages, and the
Lab-import guard fails a Lab import of core outside core's exports
(architecture:react-component-runtime INV13). The README and the barrel's
header named internal workspace imports and said nothing here is
exported; they now name that entry.
…ill needs the element, and the listeners that cancel

The release note, the stream's header, the host's comment and the README
said the stream is one passive listener per event type and that a
document-capture stopPropagation no longer starves the recognizers. Such a
stop never hid a listener on the same node, and some subscriptions cancel.
They now say what changed: an app's window-capture stopPropagation, or a
document-capture stopImmediatePropagation registered before core, no
longer hides a touch; a recognizer that must claim still needs the touch to
reach its element; the gesture host's touchend, click and contextmenu
cancel while a claimer is attached and the page hold's touchmove while it
holds; and the stream stays ahead of an app's window-capture listener only
until a type's listener is re-added. The README's list of blocking
touchmove listeners gains the claimed touch's target and the document
while a claiming element moves.
…default it moves

The {stylexOptions} form of astryxStylex now passes StyleX
treeshakeCompensation: true unless the caller sets it. spec:AST-017 FR3
asks the release note to name the old and new default and the option
that restores the old one; it now does.
…er and for the two stops the input stream fixes

- A still finger with sub-pixel jitter over a scroll view keeps its tap
  and scrolls nothing (spec:AST-094 FR18–FR22).
- A tap is still recognized under an app's window-capture
  stopPropagation, and under a document-capture
  stopImmediatePropagation registered before core's: the recognizers hear
  touches on the window's capture phase.
Chromium and WebKit pass.
…s once

Where nothing that claims is attached, the host's touchend listener is
passive and cannot cancel the engine's own click after a retargeted tap
clicks what is drawn. The shared click guard swallows that late click
whatever is attached; this case pins it, as asked on meta#8293.
This pull request sat on meta#8073's old head and carried old copies of the
harness meta#8045 and meta#8046 landed on main. meta#8360 carries that foundation with
main's harness, so after the merge this pull request's own diff is its
three commits (the touch style keys, internal, and the press paint's
priority over the coarse-pointer :active reset). The merge is clean.
The touch keys are internal, and core spells these conditions as literal
keys wherever a style needs them. The stylex file's header called it the
one place core spells them and cited spec:AST-012 FR2, and a test title
said "for other packages": the header now names the keys as the reference
spellings each literal is pinned to (spec:AST-094 FR13, spec:AST-012 FR9),
and the test holds the same keys the resolver defines.
…r, not the devices

A changeset tells consumers what changes, so it names the condition (a
coarse primary pointer) and no longer claims "every touch device"; the
simulator and emulator evidence stays in the pull request's description.

@astracat-bot astracat-bot Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approval is on hold for an engineering owner's spec decision: no current record governs the Lab CircleCheckIndicator (its name, iOS look and measured geometry), its indicatorPressScope seam lets an indicator switch off CheckboxInput's pressed overlay and paint from CheckboxInput's private variables against component:CheckboxInput AV1 and architecture:component-theming-surface INV11, and the circle's 0 ms mark needs a ruling under spec:AST-094 FR4. An engineering owner records that decision by commenting /approve-spec followed by the full head SHA, and the author may do so as one. Whatever the decision, these changes are needed:

  • Rebase once #8226 and #8562 land, so the pull request carries only its own 20 files; today 28,693 of its 30,389 authored lines come from those two.
  • Scope the circle's touch press image to its CheckboxInput row (CircleCheckIndicator.tsx:98-101): a mapped DropdownMenuCheckboxItem paints the press twice inside the ring.
  • Pass a mode to the nested Theme in both mapped stories, and correct the cross-package reason in CircleCheckIndicator.tsx:59-62 and CheckboxInput.tsx:77-81, since Lab's StyleX resolution lets it match core's markers.

[Automated review]

Comment on lines +98 to +101
backgroundImage: {
default: null,
'@media (pointer: coarse)': 'var(--_press-paint-image, none)',
},

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This paints whatever --_press-paint-image an ancestor declares, not only CheckboxInput's. With the circle mapped to checkbox, a DropdownMenuCheckboxItem row (an interactive Item styled with interactionOverlayStyles.backgroundColor) paints its own press and this layer paints the same image again over the unchecked ring's clear interior, so the ring reads two coats where the rest of the row reads one. CheckboxInput's own layer keys its image on its row (stylex.when.ancestor('[data-astryx-press="on"]', indicatorScope)); handing down a dedicated image variable, as the row already does for the mouse fill, or keying this to the CheckboxInput row would keep it to one coat. A mapped menu row in the browser spec would hold it.

Comment on lines +59 to +62
// Hover and press come from the host as inherited private properties
// (CheckboxInput's indicatorStateVars): an ancestor selector on core's
// scope marker compiles to a different class in this package, so it never
// matches.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lab compiles core's .stylex imports through scripts/stylex-module-resolution.cjs (packages/lab/babel.config.cjs), which exists so that a compile-time stylex.when.ancestor() on a core marker does match, so an ancestor selector on indicatorScope from this file would match. The private variables matter only for indicators compiled as app code; this comment (and CheckboxInput.tsx:77-81) should name that constraint, or the circle can read hover and press through indicatorScope as CheckboxIndicator does.

render: function MappedCheckboxListStory() {
const [value, setValue] = useState<string[]>(['beach']);
return (
<Theme theme={circleTheme}>

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This nested Theme has no mode, so it defaults to 'system' (colorScheme: 'light dark') and follows the operating system rather than Storybook's colour-mode toolbar: in dark mode on a light system this story and MappedCheckboxInput (line 88) render light-theme ink on the dark canvas. Passing the toolbar's mode (or a pinned one) fixes both.

Comment on lines +116 to +122
content: {
default: '""',
[stylex.when.descendant(
'[data-astryx-indicator-press="self"]',
indicatorPressScope,
)]: 'none',
},

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Over a marked indicator CheckboxInput stops painting its pressed overlay. component:CheckboxInput AV1 (current) says a theme may replace the indicator but "CheckboxInput still paints focus and pressed feedback on the resolved root", and the comment above this layer says it exists so "a theme replacement cannot accidentally drop the component's pressed contract". An indicator that carries the marker and paints nothing now drops it. This needs an engineering owner's ruling (amend the record, or keep the owner painting) before it can land.

Comment on lines +21 to +33
/**
* Marks a theme indicator that paints its own press layer, for a shape the
* owner's rounded-square layer would tint past (a circle).
*
* The indicator applies this marker together with
* `data-astryx-indicator-press="self"` and paints the press itself from what
* the owner hands down as inherited private properties (CheckboxInput:
* `--_indicator-press-fill` for a mouse press, `--_press-paint-image` for a
* touch press, `--_indicator-hover` for hover). The owner finds it with
* `stylex.when.descendant()` and leaves its own layer off.
*/
export const indicatorPressScope: ReturnType<typeof stylex.defineMarker> =
stylex.defineMarker();

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This ships on the stable @astryxdesign/core/Indicator/indicator.markers.stylex subpath with no experimental boundary, and its contract tells theme indicators to read CheckboxInput's private: true variables, which architecture:component-theming-surface INV11 says "must not be authored directly or relied on by consumers". Once indicators outside Astryx rely on it, renaming those variables breaks them; the owner ruling on the open spec question decides whether this lands, and in what form.

@vjeux
vjeux marked this pull request as draft October 29, 2026 22:35

This branch was successfully deployed

1 active deployment
Preview — 32cc71be Deployed Oct 29, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Meta Open Source bot. needs:design-review Affects visuals — Design should review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants