fix(overlay): restore mpv focus and pointer state on macOS (#104)

src/main/overlay-runtime.ts

@@ -54,6 +54,7 @@ type RevealFallbackHandle = NonNullable<Parameters<typeof globalThis.clearTimeou
 
 export interface OverlayModalRuntimeOptions {
   onModalStateChange?: (isActive: boolean) => void;
+  onFinalModalClosed?: () => void;
   scheduleRevealFallback?: (callback: () => void, delayMs: number) => RevealFallbackHandle;
   clearRevealFallback?: (timeout: RevealFallbackHandle) => void;
 }
@@ -387,8 +388,14 @@ export function createOverlayModalRuntimeService(
       }
       modalWindowPrimedForImmediateShow = false;
       mainWindowMousePassthroughForcedByModal = false;
-      mainWindowHiddenByModal = false;
-      notifyModalStateChange(false);
+      setMainWindowVisibilityForModal(false);
+      try {
+        options.onFinalModalClosed?.();
+      } catch {
+        // Modal state still needs to deactivate if focus handoff fails.
+      } finally {
+        notifyModalStateChange(false);
+      }
     }
   };