SubMiner/backlog/tasks/task-285 - Investigate-inconsistent-mpv-y-t-overlay-toggle-after-menu-toggle.md at 20a0efe57259108b0411609d6ac704264d63e95c - SubMiner

mirror of https://github.com/ksyasuda/SubMiner.git synced 2026-04-11 04:19:26 -07:00

Files

Kyle 7698258f61 Fix Windows overlay tracking, z-order, and startup visibility

- switch Windows overlay tracking to native win32 polling with native owner and z-order helpers
- keep the visible overlay and stats overlay aligned across focus handoff, transient tracker misses, and minimize/restore cycles
- start the visible overlay click-through and hide the initial opaque startup frame until the tracked transparent state settles
- add a backlog task for the inconsistent mpv y-t overlay toggle after menu toggles

2026-04-10 01:00:53 -07:00

2.6 KiB

Raw Blame History

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, priority

title

status

assignee

created_date

updated_date

labels

dependencies

references

priority

TASK-285

Investigate inconsistent mpv y-t overlay toggle after menu toggle

To Do

2026-04-07 22:55

bug

overlay

keyboard

mpv

plugin/subminer/process.lua

plugin/subminer/ui.lua

src/renderer/handlers/keyboard.ts

src/main/runtime/autoplay-ready-gate.ts

src/core/services/overlay-window-input.ts

backlog/tasks/task-248 - Fix-macOS-visible-overlay-toggle-getting-immediately-restored.md

high

Description

User report: toggling the visible overlay with mpv y-t is inconsistent. After manually toggling through the y-y menu, y-t may allow one hide, but after toggling back on it can stop hiding the overlay again, forcing the user back into the menu path.

Initial assessment:

no active backlog item currently tracks this exact report
nearest prior work is TASK-248, which fixed a macOS-specific visible-overlay restore bug and is marked done
current targeted regressions for the old fix surface pass, including plugin ready-signal suppression, focused-overlay y-t proxy dispatch, autoplay-ready gate deduplication, and blur-path restacking guards

This should be treated as a fresh investigation unless reproduction proves it is the same closed macOS issue resurfacing on the current build.

Acceptance Criteria

#1 Reproduce the reported y-t / y-y inconsistency on the affected platform and identify the exact event sequence
#2 Determine whether the failure is in mpv plugin command dispatch, focused-overlay key forwarding, or main-process visible-overlay state transitions
#3 Fix the inconsistency so repeated hide/show/hide cycles work from y-t without requiring menu recovery
#4 Add regression coverage for the reproduced failing sequence
#5 Record whether this is a regression of TASK-248 or a distinct bug

Implementation Plan

Reproduce the report with platform/build details and capture whether the failing y-t press originates in raw mpv or the focused overlay y-chord proxy path.
Trace visible-overlay state mutations across plugin toggle commands, autoplay-ready callbacks, and main-process visibility/window blur handling.
Patch the narrowest failing path and add regression coverage for the exact hide/show/hide sequence.
Re-run targeted plugin, overlay visibility, overlay window, and renderer keyboard suites before broader verification.

2.6 KiB Raw Blame History

Description

Acceptance Criteria

Implementation Plan

2.6 KiB

Raw Blame History