Skip to content

docs(SideNav, AppShell): the rail collapse motion is implemented (FR6, FR17) - #8790

Merged
cixzhang merged 1 commit into
mainfrom
spec/d38-evidence
Oct 28, 2026
Merged

cixzhang merged 1 commit into
mainfrom
spec/d38-evidence

Conversation

@cixzhang

Copy link
Copy Markdown
Contributor

Record accuracy (follow-up to #8723, D38).

User impact

None at runtime. The SideNav and AppShell records stop saying the collapse motion is missing now that it has shipped.

Changes

  • component:SideNav FR6: verified by SideNavRailMotion.test.tsx, with real-browser frame evidence still pending. The compatibility line no longer says it isn't implemented.
  • component:AppShell FR17: its current-state gap is removed. The glance and compatibility lines record it as shipped, a nonbreaking motion addition. Its verification row names the unit and boundary tests, with real-browser frame evidence pending.

Writing rubric results

  • R1 present tense: pass. R2 research: none. R3 verification: both rows name their tests and the pending browser evidence.
  • R4 rejected alternatives: none. R5 change references: none. R6 open questions: none.

@vercel

vercel Bot commented Oct 28, 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 28, 2026 8:42am UTC

Request Review

@cixzhang

Copy link
Copy Markdown
Contributor Author

/approve-spec 8b9118a

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

astracat-bot Bot commented Oct 28, 2026 •

Copy link
Copy Markdown

AI review status for this pull request.

Review status Updated
🟢 Reviewed (for maintainers only) Oct 28, 2026, 9:05 AM UTC

@github-actions github-actions Bot added the spec-auto-merge Auto-merge was enabled by the spec owner gate label Oct 28, 2026
@github-actions

Copy link
Copy Markdown
Contributor

PR Analysis Report

Previews ready: Storybook and Sandbox were built with this PR's docsite. CI evidence will be added when available.

View Storybook for this PR · View Sandbox for this PR

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

Recommend approving: the SideNav and AppShell records now describe the shipped rail collapse motion accurately, the FR6 and FR17 requirement text is unchanged, and the tests the records cite pass. One optional follow-up: add packages/core/src/SideNav/SideNavRailMotion.test.tsx and packages/core/src/motion/animatedLayout.boundary.test.ts to AppShell's verified_by, so pnpm specs:for links those tests to the record. The real-browser frame evidence both records list as pending remains the open item.

[Automated review]

| FR9–FR12 | `AppShell.test.tsx` mobile suites; `MobileNavCloseEdgeCases.test.tsx` AppShell drawer suites | Sidenav only; both navs; heading-only TopNav; custom node | A missing toggle, duplicated items, a stale drawer, or an early hide fails. | `audit:AppShell/behavior` |
| FR13, AR3 | `AppShell.test.tsx` keyboard drawer and `useAppShellMobile` suites | Outside a shell; inside, closed and open | A wrong id link or stale state fails. | `audit:AppShell/accessibility` |
| FR14, AR4 | `AppShell.test.tsx` breakpoint continuity test | Desktop to mobile and back with a focused input | Remounting content loses the value or focus. | `audit:AppShell/behavior` |
| FR17 | `SideNavRailMotion.test.tsx`, `animatedLayout.boundary.test.ts`; real-browser frame evidence of the content area during a side nav collapse (pending) | collapse and expand with an inline side nav; Reduce Motion under a coarse and under a fine primary pointer; `fill` and a scrolled `auto` page; a theme with `reducedMotion: 'always'`; a second toggle while the swap runs; an expand whose old wrap is not copied | a visible gap between the rail and the content, a content area that animates its width or moves on its own clock, an old wrap reachable by assistive technology or left after the swap, travel under Reduce Motion, anything but an opacity-only cross-fade of 200 ms or less under Reduce Motion on a coarse pointer (DR2), or any animated property under Reduce Motion on a fine pointer (DR3) fails | `audit:AppShell/behavior` |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Optional: this row now cites SideNavRailMotion.test.tsx and animatedLayout.boundary.test.ts, but the record's verified_by (lines 13–19) does not list them, so pnpm specs:for on either test does not reach component:AppShell. Adding both paths to verified_by, as MobileNavCloseEdgeCases.test.tsx already is, keeps the lookup complete.

@cixzhang
cixzhang merged commit 7d23f0b into main Oct 28, 2026
58 checks passed
@github-actions
github-actions Bot deleted the spec/d38-evidence branch October 31, 2026 06:09

This branch was successfully deployed

1 active deployment
Preview — 8b9118a9 Deployed Oct 28, 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. spec-auto-merge Auto-merge was enabled by the spec owner gate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant