Files
pipelines/app/notes/topbar-island-motion.md
T
alan 05798a56c8 Top bar: every piece pops in like the tab buttons
One shared pop (pop_entrance.dart: PopTransition, popWindow, PopEntrance)
drives the floating tab buttons and the top bar, on Motion.tabEntrance*
(0.6 -> 1, 260 ms, 70 ms stagger, ease-out-back, glass fading in).
SegmentedEntrance and the barEntrance* constants are gone.

Back, the title, the actions pill and each action pop in turn from the
leading edge (SegmentedEntrancePlanner). A lone action pops once, with its
pill. A newcomer pops alone. Rebuilds and title changes never replay it.
The shell passes published actions one by one, keyed by their screen
(actionsKey), not as one cross-fading Row. The chat thread's model and mode
are separate actions. The folder picker now uses SegmentedBar.
2026-11-03 00:30:44 +00:00

47 lines
3.2 KiB
Markdown

# Top bar island motion and press feedback
- Entrance: the top bar pops in exactly like the floating tab buttons. Both
use `lib/ui/adaptive/pop_entrance.dart` (`PopTransition`, `popWindow`; the
self-driven `PopEntrance` for the bar) and the `Motion.tabEntrance*`
constants: from 0.6, rising 6 px, `easeOutBack` over 260 ms, fading in
over the first 60%, 70 ms apart. The old 0.85/240 ms/40 ms bar constants
and `SegmentedEntrance` are gone.
- Each piece pops on its own: Back, the title or field pill, the actions
pill, and each action in it. `SegmentedEntrancePlanner`
(`segmented_bar_entrance.dart`) times them. On the bar's first frame they
go in turn from the leading edge: Back, title, pill, then each action left
to right. A lone action is the whole pill, so it pops once, with the pill.
A pill that turns up later pops at once and its actions follow it in turn.
An action added to a pill that is already there pops alone. Pieces are keyed
by role and actions by identity (their key, or their type and position,
within `SegmentedBar.actionsKey`), so a rebuild, a new title or scrolling
never replays them. Under reduced motion nothing animates.
- Shell tab switch: the shell passes the open screen's owner as
`actionsKey` and its published actions one by one. It used to wrap them in
one cross-fading `Row`, which made them a single action. On a switch Back
and the title stay put, and the new screen's actions pop in turn. A screen
republishing its bar keeps them.
- Actions after the first keep their natural width, capped at an even share
of the pill. That keeps the chat's mode beside the model, and icons in a
narrow split pane squeeze instead of overflowing.
- Rerouted bars: the chat thread's model and permission mode used to be one
`LayoutBuilder` `Row` action and are now two actions. The folder picker
used a stock `AppBar` / `CupertinoNavigationBar` and is now a
`SegmentedBar` (round Back that climbs a folder, title, Cancel). Every other
screen already built its bar through `SegmentedBar` with separate actions.
- Glass fades through `GlassReveal` (`glass_pill.dart`): the fill, the hairline,
the blur sigma and the content fade together. An opacity layer would hide
the backdrop from `BackdropFilter.grouped` until the fade ended. Grouping is
unchanged (checked in `test/ui/adaptive/segmented_bar_motion_test.dart`).
- Press: `SegmentedPress` listens for pointer events only, so tap targets and
hit testing are unchanged. While pressed it sinks to 0.94 in 90 ms under a
stadium tint (text colour at 14%), then springs back. A quick tap plays the
full press first. It wraps Back, a pressable title (and the title action
separately when expanded), a lone action as its whole pill, and each action
when there are several. Native ink and Cupertino dimming still show.
- Evidence: films at 560x900 in Material and Cupertino, light and dark, are in
`/tmp/topbar-evidence/` (strips `strip-*.png`, zoomed presses `zoom-press*.png`).
The shared pop is filmed in `/tmp/topbar-pop/` (`material/`, `cupertino/`:
Pipelines <-> Runs, Search, run detail, Chat list and thread; `folder-*`:
the folder picker; `strip-*.png` stack the bar of every frame).