Window and popover conventions
Current macOS conventions:
| Interaction | Convention |
|---|---|
| Anchored transient menu | Native NSPopover |
| New-session or switch-agent selection | Separate two-pane React window |
| Server or session settings | Separate React window |
| Direct action modal response | Separate React action-display window |
| Notification modal request | Inline fallback in message/detail rail |
| Global application settings | Separate keyed React window opened from the application menu |
| Permanent local session note | Separate keyed React window |
| Connection/application banner | Message/detail-area rail |
| Session inline/banner/modal | Active ChatPane rail |
| Compact config dropdown or rich session-action list | Native NSPopover |
Do not introduce React Native Modal for desktop notification flows; the
current macOS runtime does not provide a reliable implementation. Direct action
modal responses use ActionDisplayWindow, opened through the generic
DesktopWindowManager.openReactWindow() path. Its body is bounded and
scrollable for lengthy content.
Global Settings and the View-menu Follow Active Tab in Sessions List and
Switch Connection with Active Tab items read and write their respective
native preferences. Notifications update every open main root and the
Settings root. Missing values default to Follow On and Switch Connection Off;
explicitly stored Follow values are retained.