Skip to content

chore(core): the iOS 26 search bar's values in the UIKit table - #8180

Draft
vjeux wants to merge 1684 commits into
meta:mainfrom
vjeux:uikit/c09-search-table
Draft

vjeux wants to merge 1684 commits into
meta:mainfrom
vjeux:uikit/c09-search-table

Conversation

@vjeux

@vjeux vjeux commented Oct 24, 2026 •

Copy link
Copy Markdown
Contributor

Depends on #8360. Review only this PR's change: vjeux/astryx@045f666...1fb1000

User need

On a phone, Astryx's search field should move like iOS 26's: a tap narrows the field, slides in a close button and lifts the large title away on one 383 ms clock. Nothing records those values yet, so SearchField and its host bars would each guess and drift apart.

Problem and solution fit

What led to it: the UIKit-parity program measures each behavior once, in a UIKit app on the iOS 26.2 simulator, into the internal UIKit table components read. This PR adds the search bar's entry, motion/uikit/search.ts:

  • Activation and cancel: one 383.3 ms animator on UIKit's ease-in-ease-out (the timing.curves.move role).
  • Stacked field: 44 pt tall, 16 pt insets; the close button slides in from 44 pt to rest 11 pt after the field.
  • Navigation bar: the back button and large title fade on fixed curves of the progress.
  • Scroll-away: 10 pt of hysteresis, a 230 ms snap; the threshold is an estimate (M-SE1 in MEASUREMENTS.md).
  • Bottom placement: a 38 pt field resting 17 pt above the keyboard.

Current specification

spec:AST-094 FR1, FR2 and FR13, with spec:AST-012 FR9/DEC-6's compact screen.

Public delta and caller burden

None: internal table entries (motion/uikit, not exported), with a [chore] changeset.

Design and alternatives

  • Values inside SearchField: simplest, but host bars would copy them and drift.
  • Public tokens or theme roles: these are UIKit measurements, not a theme contract, and touch tables register only spec:AST-094 FR4's roles.
  • The internal UIKit table, chosen: the program's other measurements live there, and the field and its bars share one clock. Tradeoff: products can't override these values; the curve is the public timing.curves.move role, which themes can change.

A tab bar's search tab stays with the tab bar's own values.

Evidence

  • search.test.ts checks each value against its frames (for example, the 17 pt gap from the measured coordinates) and the curve against UIKit's ease-in-ease-out.
  • uikit.test.ts checks that every value names its source.

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.

Merge after #8360, which carries the motion stack through #8076.

Testing

What I ran and what it showed:

  1. pnpm exec vitest run packages/core/src/motion/uikit: the derived values agree with the measured frames, and every value names its source.
  2. Storybook's Lab/SearchField (feat(lab): SearchField — the iOS 26 search field that activates on UIKit's clock #8181, stacked here) on the iOS simulator: a tap narrows the field and slides the close button in over the measured 383 ms.

@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:52pm UTC

Request Review

@astracat-bot

astracat-bot Bot commented Oct 24, 2026 •

Copy link
Copy Markdown

AI review status for this pull request.

Review status Updated
🟡 Reviewed (for maintainers only) Oct 29, 2026, 10:08 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

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/CheckboxInput 49.9KB 50.0KB +105B 9.3KB 9.3KB 0B
core/CheckboxListItem 54.0KB 54.1KB +92B 10.5KB 10.5KB 0B
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.8KB +87B 14.6KB 14.6KB 0B
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 14.7KB 0B
core/DropdownMenuCheckboxItem 16.1KB 16.2KB +106B 5.6KB 5.6KB 0B
core/DropdownMenuItem 15.4KB 15.5KB +101B 5.2KB 5.2KB 0B
core/DropdownMenuRadioItem 16.2KB 16.3KB +110B 5.6KB 5.6KB 0B
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.6KB +103B 10.5KB 10.5KB 0B
core/Markdown 144.5KB 144.5KB +79B 17.4KB 17.4KB 0B
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 14.7KB 0B
core/MultiSelector 76.2KB 76.3KB +110B 14.6KB 14.6KB 0B
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.8KB +105B 15.3KB 15.3KB 0B
core/Popover 49.8KB 49.9KB +84B 12.1KB 12.1KB 0B
core/PowerSearch 155.1KB 155.1KB +87B 18.6KB 18.6KB 0B
core/RadioListItem 52.1KB 52.3KB +111B 9.7KB 9.7KB 0B
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 +81B 15.0KB 15.0KB 0B
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/TabMenu 51.6KB 51.7KB +83B 10.0KB 10.0KB 0B
core/Table 84.0KB 84.0KB +71B 15.1KB 15.1KB 0B
core/TableCell 78.8KB 78.9KB +89B 14.8KB 14.8KB 0B
core/TableHeaderCell 78.6KB 78.7KB +92B 14.8KB 14.8KB 0B
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

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
Package stylesheet Gzip before Gzip after Delta
@astryxdesign/core 34.6KB 34.6KB 0B

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.

Approval is on hold until an engineering owner approves the draft spec:AST-094 requirements this table rests on (FR1 and FR2, and the amendments it proposes to current records) by commenting /approve-spec d3942fae7b785ce0bd61baa7ec5e523647a93b7a on this pull request; the author may do so as an engineering owner. Whatever that decision, these need changes:

  • Against main the diff is 26,347 authored lines, of which uikit.search is 257; land the stacked pull requests first so this one shows only its own commit.
  • search.bottom.keyboardCenterOffset is 36, but the frames it cites (centre y 520, keyboard at 539) give 19 pt and no gap; fix whichever is wrong and derive the 17 pt test from those frames.
  • The stacked touch-presentation changeset says an iPad mini in portrait keeps the popover, but at 744 px it moves from the bottom sheet to the popover.

[Automated review]

* iPhone 17 Pro, the field pinned to keyboardLayoutGuide (centre y 520
* with the keyboard at 539), Oct 24 2026
*/
keyboardCenterOffset: 36,

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 cited frames (centre y 520, keyboard at 539) put the field's centre 19 pt above the keyboard, and with the 38 pt field that leaves no gap, not 36 pt and a 17 pt gap. Could you re-read the frames and fix whichever of the value or the citation is wrong?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

The citation at this head reads centre y 503 with the keyboard's top at 539 (search.ts lines 174-175): 539 - 503 = 36 pt, and with the 38 pt field that leaves 539 - (503 + 19) = 17 pt, the gap the comment states. The 520 figure isn't in this file at 8a593cc; it may come from an earlier revision. The test that derives the gap from the table's own values is being changed to compute it from these cited coordinates, as you suggest in the other comment.


it('rests the bottom field 17 pt above the keyboard', () => {
const {fieldHeight, keyboardCenterOffset} = search.bottom;
expect(keyboardCenterOffset - fieldHeight / 2).toBe(17);

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 derives the gap from the table's own values, so it passes for any keyboardCenterOffset; computing it from the cited coordinates (keyboard top minus centre minus half the height) would check the measurement.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fixed in 8445d60: the gap is now computed from the cited coordinates (centre 503, keyboard top 539).

* iPhone 17 Pro, Reduce Motion on: the same frames and alphas as without
* it, Oct 24 2026
*/
reducedMotion: 'keep',

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 source records Reduce Motion only; draft AST-094 FR8 takes Reduce Motion with Prefer Cross-Fade Transitions on as the reference, so it would help to note that setting for this capture.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Resolved in 8831bec: the table no longer carries a Reduce Motion setting, since design:reduced-motion decides through the animator. The comment that replaces it records that UIKit keeps the travel with Prefer Cross-Fade off and on (both measured).

Comment thread .changeset/touch-presentation.md Outdated
'@astryxdesign/core': patch
---

[feat] `presentation="adaptive"` on DropdownMenu, ContextMenu, MoreMenu, Selector and MultiSelector chooses the bottom sheet on a compact touch screen: a coarse primary pointer and a viewport narrower than 744px or shorter than 500px (it was 768px wide and below). An iPad mini in portrait keeps the anchored popover; a phone in landscape now gets the sheet.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

An iPad mini in portrait is 744 CSS px wide, so the old (max-width: 768px) and (pointer: coarse) gave it the bottom sheet; with the new query it moves to the popover, so 'keeps the anchored popover' misdescribes the change.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This changeset belongs to #8062, stacked below; at this head #8062's resolver takes compact from the theme's definition.

@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 until an engineering owner approves the draft spec:AST-094 requirements this table rests on (FR1 and FR2, and the amendments it proposes to current records) by commenting /approve-spec 5c3f25f5f004580bbac2f1ccc6c346abec4789f2 on this pull request; the author may do so as an engineering owner. The keyboard citation for search.bottom.keyboardCenterOffset now matches its value. Whatever the owner decides, two things still need changes:

  • Against main the diff is 26,347 authored lines, of which uikit.search is 257; land the stacked pull requests first so this one shows only its own commit.
  • The stacked touch-presentation changeset says an iPad mini in portrait keeps the popover, but at 744 px it moves there from the bottom sheet, and default sub-menus switch between drill-in and flyout on the same screens; please say so and name the options that pin a surface.

[Automated review]

Comment thread .changeset/touch-presentation.md Outdated
'@astryxdesign/core': patch
---

[feat] `presentation="adaptive"` on DropdownMenu, ContextMenu, MoreMenu, Selector and MultiSelector chooses the bottom sheet on a compact touch screen: a coarse primary pointer and a viewport narrower than 744px or shorter than 500px (it was 768px wide and below). An iPad mini in portrait keeps the anchored popover; a phone in landscape now gets the sheet.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

An iPad mini in portrait is 744 CSS px wide: the old (max-width: 768px) and (pointer: coarse) gave it the bottom sheet, and the new rule gives it the popover, so it does not keep the popover. Default DropdownMenuSubMenu rows (presentation = 'adaptive') also switch between drill-in and flyout on the same screens through useMenuDrillIn. Could the note say both, and name the options that pin a surface (presentation="bottom-sheet" or "popover" on the menu, "drill-in" or "flyout" on a sub-menu)?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Same as above: #8062's changeset, stacked below.

/**
* The bottom (toolbar) field's height at rest, pt; it is 336 wide at
* the bottom of a 402 pt screen. (A tab bar's search tab keeps its own
* glass geometry in `tabBar`.)

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

There is no tabBar domain under motion/uikit/ at this head, so this pointer leads nowhere; could it say the tab bar's geometry will get its own table, or wait until that table lands?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fixed in 8445d60: the note no longer points at a tab bar table.


/**
* The UIKit constants table, read-only: `uikit.springs`, `uikit.scroll`,
* `uikit.timing`, `uikit.navigation`, `uikit.UIKIT_GESTURES` and the haptic

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 list of the uikit namespace leaves out uikit.search, which uikit/index.ts now re-exports.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fixed in 8445d60: the list names uikit.search.

@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 until an engineering owner decides whether themes may retune touch motion: the draft spec:AST-094 this table rests on says they may not (FR4, DEC-1), while this pull request registers the search clock, curve and scroll-away snap as theme roles. Once the record and the code agree, an engineering owner records the decision by commenting /approve-spec 8a593cc361864f20d218db27d636ae4d3d60aabb on this pull request, and the author may do so as an engineering owner. Whatever that decision, these need changes:

  • Against main the diff is 28,770 authored lines, of which this pull request's own commit is 326; land the stacked pull requests first so this one shows only its own change.
  • The stacked platform adaptation condition adds a field to the vocabulary spec:AST-012 FR2 keeps closed; remove it, or amend FR2 first.
  • defineTheme refuses a motion role set under the wrong group only when the motion tables happen to be imported first, and accepts any unknown role id; please validate against a role list the theme module owns.
  • The stacked touch-presentation changeset says an iPad mini in portrait keeps the popover, but at 744 px it moves there from the bottom sheet, and default sub-menus switch with it; please say so and name the options that pin a surface.

[Automated review]

// (motion/roles.ts). The thresholds (`scrollAway.hysteresisPt`,
// `scrollAway.collapseThresholdPt`) and the geometry are not durations,
// springs or curves, so they never become roles.
registerMotionTable('search', search);

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 makes the clock, curve and scroll-away snap theme-retunable roles, but draft spec:AST-094 FR4 says a touch presentation reads its motion from the table on every theme, and DEC-1 rejects tuning touch motion per theme. Could the record and this registration be brought into line, in whichever direction an engineering owner approves?

@vjeux vjeux Oct 25, 2026 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

spec:AST-094, now current through #8378, settles it in FR4 and DEC-3: touch motion is themeable, so the search table's clock, curve and scroll-away snap are theme motion roles, registered by registerSearchTable(), which SearchField's touch module calls once before its first animation. Adding these three to FR4's role list is the record's to do; this table supplies their measured, sourced values (FR1, FR2).

* is everything else. Pair `ios` with `pointer: 'coarse'` for a touch
* profile, such as touch motion tuned per platform.
*/
platform?: 'ios' | 'other';

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

platform is a fifth when field, but spec:AST-012 FR2 limits the vocabulary to width, pointer, contrast and motion and asks for an explicit addition to that closed vocabulary first. Could this wait for an approved FR2 amendment, or leave the stack?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Not in this PR's commits: the platform condition comes from #8076 (765a094), stacked below.

`${location}: a motion role is named by its table path, such as "sheet.present" or "springs.navigationPush".`,
);
}
const registered = motionRole(id);

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

motionRole(id) only knows tables some module has already imported, and this module imports roles.ts alone, so the same defineTheme input throws here in one process and passes in another; the test hides it with import '../motion/uikit'. Could the theme validate against a role list it owns, and refuse unknown role ids?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Resolved at this head by #8076, stacked below (1dcf753): theme motion role ids are checked against the generated list of roles.

follows.
- **FR7 — Exits animate as UIKit's do.** A touch presentation MUST play the
exit its UIKit counterpart plays. **Proposed; pending owner review:** this
departs from the draft `spec:AST-090` FR1 (exits off by default) and FR10

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

No AST-090 record exists at this head or on main, so this amendment names nothing an owner can rule on. Which record should FR7 point at?

@vjeux vjeux Oct 25, 2026 •

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

This is the AST-094 spec (now current on main through #8378), not this PR's commits.

@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 until an engineering owner decides whether themes may retune touch motion: the draft spec:AST-094 this table rests on says they may not (FR4, DEC-1), while this pull request registers the search clock, curve and scroll-away snap as theme roles. Once the record and the code agree, an engineering owner records the decision by commenting /approve-spec a06235c742beb6df559e7ea086d05e465ed925a7 on this pull request, and the author may do so as an engineering owner. Whatever that decision, these need changes:

  • Against main the diff is 28,775 authored lines, of which this pull request's own commits are 335; land the stacked pull requests first so this one shows only its own change.
  • search.reducedMotion: 'keep' keeps the activation's travel under Reduce Motion, and the stack's reduced-motion cross-fade runs 500 ms by default and is a theme role (300 ms in the defineTheme example), while the current design:reduced-motion asks for an opacity-only fade of 200 ms or less that no theme value can lengthen.
  • The stack's compact-touch resolver keeps its own 744 px line, while the current spec:AST-012 FR9 defines compact as below the theme's md point (768) or under 500 px tall, and its platform adaptation condition is outside FR2's closed vocabulary.
  • defineTheme refuses a misfiled motion role only when the motion tables happen to be imported first and accepts unknown role ids; please validate against a role list the theme module owns.

[Automated review]

Comment on lines +61 to +67
* Reduce Motion keeps the activation's travel and adds no cross-fade:
* `'keep'` in the animator's terms.
* @source measured: UIKit lab (injected host app), iOS 26.2 simulator,
* iPhone 17 Pro, Reduce Motion on with Prefer Cross-Fade Transitions off
* (M-16): the same frames and alphas as without it, Oct 24 2026
*/
reducedMotion: 'keep',

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

'keep' plays the activation's travel unchanged under Reduce Motion. The current design:reduced-motion record asks a touch transition to change opacity only, in 200 ms or less, with no core value able to keep travel (DR1, DR2, DR4), and draft AST-094 FR8 also takes Prefer Cross-Fade Transitions on as the reference. Could this leaf record the cross-fade form, or leave the table until a cross-fade capture of the search bar exists? Separately, M-16 names no row in motion/MEASUREMENTS.md (its reduced-motion capture is M-RM1), and the table check only resolves @measure IDs, so nothing catches it.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Fixed in 8831bec: reducedMotion: 'keep' is gone, so the animator applies design:reduced-motion. The comment that replaces it cites the measurement without the lab id.

Comment on lines +75 to +79
export const COMPACT_QUERY = '(width < 744px), (height < 500px)';

/** Both: presentations such as a sheet in place of a popover. */
export const COMPACT_TOUCH_QUERY =
'(width < 744px) and (pointer: coarse), (height < 500px) and (pointer: coarse)';

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-012 FR9, current on main, defines compact as width below the theme's effective md point (768 by default) or height below 500, and asks the web touch presentation resolver to use that one definition with no size numbers of its own. With 744 here a 744–767 px touch screen gets the popover and flyout where FR9 gives the sheet and drill-in, and an overridden md changes nothing. Could this follow FR9?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Resolved at this head: #8062's resolver, in #8076's base, takes compact from the theme's definition (width below md, or height below 500).

Comment thread packages/core/src/theme/defineTheme.ts Outdated
* // A softer sheet and a slower reduced-motion fade:
* motion: {
* springs: { 'springs.sheetPresent': { duration: 0.6, bounce: 0.1 } },
* durations: { 'timing.reducedMotionCrossFadeMs': 300 },

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 documents a theme setting the reduced-motion cross-fade to 300 ms and calls it slower, though the table's default is 500 ms. The current design:reduced-motion DR2 caps a touch cross-fade at 200 ms and DR4 says theme values offer no way to keep a longer animation under reduced motion. Could timing.reducedMotionCrossFadeMs stay out of the theme roles (as press.scrollBrakeMs is excluded), the default come within 200 ms, and this example go?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Resolved at this head: #8076 (63e5356) takes timing.reducedMotionCrossFadeMs out of the theme roles at 200 ms, and the example now retunes navigation.transitionMs.

@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:

  • Reduced motion. core/src/motion/uikit/search.ts:67 offers reducedMotion: 'keep'. Per design:reduced-motion DR4, core has no reduced-motion opt-out: the animator should be the one place that resolves reduced motion (touch cross-fades in 200 ms or less with no travel, a fine pointer changes at once), so the 'keep' option should be removed.

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.

@vjeux
vjeux force-pushed the uikit/c09-search-table branch from a06235c to f1b2b56 Compare October 24, 2026 23:28
@github-actions github-actions Bot added the needs:design-review Affects visuals — Design should review label Oct 24, 2026
vjeux added 25 commits October 28, 2026 11:33
meta#8076's new head carries main 70ea859 with meta#8073's writer of the press
attribute on main's press controller, and its README names both writers.
utils/pressFeedback.ts keeps that controller with this line's own changes
on it: the pointer, drag, scroll and visibility listeners through the
shared input stream (meta#8356) and touchcancel only while the primary pointer
is coarse (meta#8270); the key path stays at the window's bubble phase, so a
Space press the page cancels paints nothing. usePressTracker stays in its
own module, one tracker for a component's life (meta#8315), so meta#8073's
rebuilt-tracker hook and its test are not taken. The harness files are
meta#8076's.
…s, and the action-group tracker writes its own

The header and writePress called it the one writer of the press attribute,
but main's action-group tracker writes its groups' presses itself. They now
say what holds, as meta#8076's gestures README does.
…he press attribute

The release note said every press painter writes data-astryx-press
through one internal writer, but the action-group tracker
(hooks/actionGroupTracker.ts) writes its groups' presses itself, as the
gestures README and utils/pressFeedback.ts already say. The note now says
paintPress writes every press it tracks and the action-group tracker
writes its own.
…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.
…esture host's subscriptions

The gesture host subscribes no click: the one cancelling click subscriber
is the click guard's, added at a window's first arm and kept. The release
note, the stream's header and the gestures README listed click with the
host's touchend and contextmenu; they now name the guard's own.

@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.

Requesting changes: the search table itself is well sourced and fits spec:AST-094 FR1 and FR2, but this diff still carries the whole open #8360 chain, 27,234 of its 27,499 authored lines against this pull request's 265. Please land #8360 and the pull requests beneath it (#8076 first), or rebase onto main once they land, so this pull request is just its six search-table files.

  • Merged as it stands, it would also ship that chain's released changes: a 13 px DropdownMenu trigger drift allowance, press feedback on a shared window-capture input stream, and a treeshakeCompensation: true default for astryxStylex({stylexOptions}) in @astryxdesign/build.

[Automated review]

@vjeux

vjeux commented Oct 29, 2026

Copy link
Copy Markdown
Contributor Author

Stacked on purpose: this merges after #8360, as the description's first line says, so that chain lands with #8360 and the PRs under it, not here. Once they land, this diff is just the six search-table files. Nothing else to change.

@vjeux
vjeux marked this pull request as draft October 29, 2026 22:33
vjeux added a commit to vjeux/astryx that referenced this pull request Oct 30, 2026

This branch was successfully deployed

1 active deployment
Preview — 1fb10005 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