Files
SubMiner/docs/plans/2026-06-09-macos-notification-hover-design.md
T
sudacode ac1926a5dd fix(notifications): stabilize overlay startup and macOS hover passthroug
- Skip re-append for cards already in stack to avoid replaying enter animation
- Track enter animation end to remove `entering` class after first render
- Gate mouseenter interactive state on cards with explicit actions only
- Bind interactive hover only to action buttons and their close buttons
- Add regression tests for passive vs action-bearing notification hover
2026-06-09 01:59:11 -07:00

1.0 KiB

macOS Notification Hover Stability Design

Status: approved Date: 2026-06-09

Problem

On macOS, hovering a character dictionary build notification can make the card flicker and slide as if it is hiding, then snap back. The likely trigger is the notification stack changing the overlay window's mouse-passthrough state for a progress card that has no user action.

Chosen Approach

Keep non-action overlay notifications visually stable and click-through on hover. Only notifications with explicit actions should request interactive overlay input. The notification history panel keeps its existing interactive behavior.

This avoids a macOS mouseenter/mouseleave passthrough loop for passive progress cards while preserving clickable notification actions.

Checks

  • Add a renderer regression test for passive notification hover.
  • Keep action-bearing notification cards interactive.
  • Run the targeted overlay notification and mouse-ignore tests.