diff --git a/app/notes/quick-switch-library-settings.md b/app/notes/quick-switch-library-settings.md new file mode 100644 index 00000000..87f4009b --- /dev/null +++ b/app/notes/quick-switch-library-settings.md @@ -0,0 +1,57 @@ +# Quick-switch library, preview and themed Settings tabs + +Settings now groups controls into Appearance, Connection, Notifications, Tools +and Updates. Pages mount on first visit, preserve drafts and independent scroll +positions, and stop hidden tickers. Native Material tabs and Cupertino segmented +controls remain horizontally scrollable at narrow widths and large text sizes. +No setting or server capability was removed. + +Appearance offers eleven device-local styles: Tape, Swap, Card deck, Deck slide, +Fan, Slide, Push, Crossfade, Zoom, Flip and Rolodex. Tape remains the default; +old stored cardStack selections use the corrected Card deck, while the previous +hinged effect is available as Rolodex. The two deck styles reveal a full incoming +card already behind the opaque front card, clear that front card sideways before +changing stacking order, then return it behind. No deck hinge rotation is used. +Global animation speed and reduced motion apply to every style. + +The preview is the actual ChatWorkspace renderer with two local sample panes, +not a separate imitation. It plays once on selection and offers Replay animation; +there is no perpetual timer, server call or change to the operator's pane layout. +Reduced motion keeps it still. Shared pose/geometry functions and retained live +views preserve drafts and scroll state. See mobile-quick-switch-profile.md for +measured layout improvements and the remaining raster tail; browser timings do +not establish physical Android performance. + +Research references (inspiration, original Flutter implementation): +- React Bits Card Swap: https://reactbits.dev/components/card-swap +- Animata Card Stack: https://animata.design/docs/card/card-stack +- Codrops CardStackEffects: https://github.com/codrops/CardStackEffects + +Code: settings_tabs.dart and settings_topic_pages.dart organize sections; +quick_switch_preview.dart embeds the local workspace; quick_switch_effect.dart +shares poses and geometry; chat_motion_viewport.dart bounds transcript layout +work during non-tape transitions. The existing desktop selection-border fade +is retained. + +Validation: +- Full chat/settings/motion/application integration: 1279 passed, peak2383MB, + 111s, /tmp/memwatch/out.4le2Y1. +- Final deck geometry/fill plus preview regression: 64 passed, + /tmp/memwatch/out.BMiUMQ. Analyzer clean (flutter-analyze.GvPMna before the + small final geometry polish; final analyzer recorded in deployment evidence). +- Browser captures /tmp/review/settings-library-films-fixed record all eleven + previews plus all Settings categories; reviewed every preview sheet. +- Material dark phone and Cupertino light phone/desktop Settings reviewed in + /tmp/review/settings-library-cupertino. The native segmented tabs stay below + the shell bar and the content does not double-consume its top padding. +- Final polished deck previews, two- and three-pane exchanges, cycling and + unfolding reviewed in /tmp/review/deck-release-final. The real small preview + was scrolled to its bottom; the browser assertion verifies pixels reaches max + and viewport equals its visible height (report.json). +- Repeated films initially inherited Chrome's scratch contact-sheet tab's + compositor crop. The capture kit now restores the target/viewport before + filming; repeated film sizes and all previews were checked again. Earlier + cropped captures remain in /tmp/review/settings-library-final, not the final + animation evidence. Obsolete fixture-title attempts also remain identified. +- No connected Android test device; managed AVD data is missing. No device was + created and the personal Fold was not used. Publication is not installation.