Files
pipelines/app/notes/chat-open-container-transform.md
T
alan eea1361980 Grow the tapped chat row into the chat page on phones
Replace the identity-avatar Hero with a container transform: the row's
surface, tint and edge marker morph into the full page while the content
cross-fades, and Back, the Cupertino edge swipe or Android predictive back
shrink the page into the open chat's row. Reduced motion or a row off
screen fades instead; wide layouts are unchanged.
2026-11-10 03:11:05 +00:00

80 lines
4.4 KiB
Markdown

# Chat opens as a container transform from its row
User request: "for the hero animation in the chat list, I meant like the chat
expanding from the list, not just the icon".
## Behaviour
On a phone (list and chat not side by side) tapping a chat row grows the row
itself into the full chat page; Back shrinks the page back into the row.
- The surface morphs: bounds go from the row's rectangle to the full page
(`Curves.fastOutSlowIn`, played backwards for the close), colour goes from
the row's tint over the list background to the page background, and the
row's leading-edge marker (chat colour, 3 or 10 px) narrows to nothing.
- Content cross-fades: opening covers the row content in the first 20 % and
fades the page in over 25-70 %; closing fades the page out in the first
30 % and uncovers the real row underneath in the last 30 %.
- The list behind does not move (the route refuses a secondary transition);
it dims by at most 20 % (`Motion.containerTransformScrim`) with the
page's size.
- Timing: `Motion.containerTransform` (300 ms) and
`Motion.containerTransformReverse` (250 ms). The animation-speed setting
scales them through `timeDilation`, as for every route.
- Reduced motion: no movement; the page fades in place (Flutter's
`AnimationBehavior.normal` additionally shortens the route under the
system setting).
- No row on screen (deep link at start-up, the row scrolled away, or the page
switched to a chat whose row is not laid out): the page fades instead.
- Closing resolves the row again, so after Next chat or the quick-switch tape
the page shrinks into the row of the chat now open.
- Cupertino host: the native swipe from the start edge (20 px, or the notch
inset) drives the shrink with the finger, linearly; release commits by
fling or past halfway, otherwise it settles back, as iOS does. A page pushed
over the chat keeps the Cupertino parallax.
- Android: system predictive back drives the same shrink; cancel restores
the page, commit pops it.
- Wide layouts (list beside the pane) and the workspace-after-wide path are
unchanged: neither pushes this route.
- The old identity-avatar `Hero` (row avatar to header) is removed: a
separate flying avatar over a fading container does not compose, and
Material's container transform is itself the shared element.
## Code
- `lib/ui/motion/container_transform_route.dart`: `ContainerTransformPageRoute`
(durations, opacity, swipe settle logic).
- `lib/ui/motion/container_transform_flight.dart`: the morph itself; one fixed
widget tree in every state, so the chat page keeps its state and scroll.
- `lib/ui/motion/container_transform_gestures.dart`: Cupertino edge swipe and
Android predictive back forwarding.
- `lib/ui/motion/container_transform_source.dart`: rows register their
rectangle, surface and marker by id under a `ContainerTransformScope`.
- `lib/shell/detail_page.dart`: `DetailPageHost.sync(growFrom:)` and
`detailPageRoute(growFrom:)`; runs and pipelines keep the platform route.
- `lib/features/chat/screen.dart`: scope around the list; link resolves the
currently selected chat.
- `lib/features/chat/ui/sessions/session_row_content.dart`: row registers as a
source (tint via the new `AppListRow.tintFor`).
## Verification
- `tool/memwatch/full.sh 'test/features/chat test/shell test/ui'`: PASS,
1604 passed, 0 failed.
- `tool/analyze.sh`: clean.
- Tests: `test/ui/motion/container_transform_route_test.dart` (row rect to
full page and back, list stays put, reduced-motion fade, missing row fade,
Cupertino swipe follows the finger and commits, short swipe settles back,
Android predictive back cancel and commit) and
`test/features/chat/chat_open_transition_test.dart` (real `ChatScreen` at
390x844 grows and shrinks with no Hero, reduced-motion fade, 1280x800
opens beside the list with no transform, row surface/marker, Motion timing).
- Real Chrome, fixture `?chats=3&rich=1&colors=1`, 390x844, filmed with
`film=` (half animation speed so the headless screencast catches frames,
plus one at 1x): Material dark, Material light and Cupertino light open and
close contact sheets, and a held mid-swipe on Cupertino showing the page
shrunk toward the row. The kit warns about widths under 500 px; these
captures rendered correctly.
- Not verified on a device (iOS swipe and Android predictive back were only
exercised in widget tests and, for the swipe, with a mouse drag in Chrome).