Fix Windows overlay z-order on minimize/restore and improve hover stability

Use native synchronous z-order binding (koffi) instead of async PowerShell
for overlay positioning, eliminating the 200-500ms delay that left the overlay
behind mpv after restore. Hide the overlay immediately when mpv is minimized
so the full show/reveal/z-order flow triggers cleanly on restore.

Also adds hover suppression after visibility recovery and window resize to
prevent spurious auto-pause, Windows secondary subtitle titlebar fix, and
z-order sync burst retries on geometry changes.

src/core/services/overlay-visibility.test.ts

@@ -242,6 +242,7 @@ test('Windows visible overlay stays click-through and binds to mpv while tracked
 
 test('Windows visible overlay restores opacity after the deferred reveal delay', async () => {
   const { window, calls, getOpacity } = createMainWindowRecorder();
+  let syncWindowsZOrderCalls = 0;
   const tracker: WindowTrackerStub = {
     isTracking: () => true,
     getGeometry: () => ({ x: 0, y: 0, width: 1280, height: 720 }),
@@ -260,6 +261,7 @@ test('Windows visible overlay restores opacity after the deferred reveal delay',
       calls.push('ensure-level');
     },
     syncWindowsOverlayToMpvZOrder: () => {
+      syncWindowsZOrderCalls += 1;
       calls.push('sync-windows-z-order');
     },
     syncPrimaryOverlayWindowLayer: () => {
@@ -276,8 +278,10 @@ test('Windows visible overlay restores opacity after the deferred reveal delay',
   } as never);
 
   assert.equal(getOpacity(), 0);
+  assert.equal(syncWindowsZOrderCalls, 1);
   await new Promise<void>((resolve) => setTimeout(resolve, 60));
   assert.equal(getOpacity(), 1);
+  assert.equal(syncWindowsZOrderCalls, 2);
   assert.ok(calls.includes('opacity:1'));
 });
 

src/core/services/overlay-visibility.ts

@@ -25,7 +25,10 @@ function clearPendingWindowsOverlayReveal(window: BrowserWindow): void {
   pendingWindowsOverlayRevealTimeoutByWindow.delete(window);
 }
 
-function scheduleWindowsOverlayReveal(window: BrowserWindow): void {
+function scheduleWindowsOverlayReveal(
+  window: BrowserWindow,
+  onReveal?: (window: BrowserWindow) => void,
+): void {
   clearPendingWindowsOverlayReveal(window);
   const timeout = setTimeout(() => {
     pendingWindowsOverlayRevealTimeoutByWindow.delete(window);
@@ -33,6 +36,7 @@ function scheduleWindowsOverlayReveal(window: BrowserWindow): void {
       return;
     }
     setOverlayWindowOpacity(window, 1);
+    onReveal?.(window);
   }, WINDOWS_OVERLAY_REVEAL_DELAY_MS);
   pendingWindowsOverlayRevealTimeoutByWindow.set(window, timeout);
 }
@@ -154,14 +158,18 @@ export function updateVisibleOverlayVisibility(args: {
         setOverlayWindowOpacity(mainWindow, 0);
         mainWindow.showInactive();
         mainWindow.setIgnoreMouseEvents(true, { forward: true });
-        scheduleWindowsOverlayReveal(mainWindow);
+        scheduleWindowsOverlayReveal(mainWindow, shouldBindTrackedWindowsOverlay
+          ? (window) => args.syncWindowsOverlayToMpvZOrder?.(window)
+          : undefined);
       } else {
         if (args.isWindowsPlatform) {
           setOverlayWindowOpacity(mainWindow, 0);
         }
         mainWindow.show();
         if (args.isWindowsPlatform) {
-          scheduleWindowsOverlayReveal(mainWindow);
+          scheduleWindowsOverlayReveal(mainWindow, shouldBindTrackedWindowsOverlay
+            ? (window) => args.syncWindowsOverlayToMpvZOrder?.(window)
+            : undefined);
         }
       }
     }
@@ -199,6 +207,17 @@ export function updateVisibleOverlayVisibility(args: {
   }
 
   if (args.windowTracker && args.windowTracker.isTracking()) {
+    if (
+      args.isWindowsPlatform &&
+      typeof args.windowTracker.isTargetWindowMinimized === 'function' &&
+      args.windowTracker.isTargetWindowMinimized()
+    ) {
+      clearPendingWindowsOverlayReveal(mainWindow);
+      setOverlayWindowOpacity(mainWindow, 0);
+      mainWindow.hide();
+      args.syncOverlayShortcuts();
+      return;
+    }
     args.setTrackerNotReadyWarningShown(false);
     const geometry = args.windowTracker.getGeometry();
     if (geometry) {