mirror of
https://github.com/ksyasuda/SubMiner.git
synced 2026-06-09 15:13:32 -07:00
sudacode
ac1926a5dd
- 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
28 lines
1.0 KiB
Markdown
28 lines
1.0 KiB
Markdown
<!-- read_when: changing overlay notification hover, macOS mouse passthrough, or notification actions -->
|
|
|
|
# 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.
|