Ensure overlay modal grabs input

src/core/services/ipc.test.ts

@@ -233,5 +233,6 @@ test('registerIpcHandlers ignores malformed fire-and-forget payloads', () => {
 
   handlers.on.get(IPC_CHANNELS.command.overlayModalClosed)!({}, 'not-a-modal');
   handlers.on.get(IPC_CHANNELS.command.overlayModalClosed)!({}, 'subsync');
-  assert.deepEqual(modals, ['subsync']);
+  handlers.on.get(IPC_CHANNELS.command.overlayModalClosed)!({}, 'kiku');
+  assert.deepEqual(modals, ['subsync', 'kiku']);
 });

src/core/services/overlay-bridge.ts

@@ -63,6 +63,8 @@ export function createFieldGroupingCallbackRuntime<T extends string>(options: {
     getResolver: options.getResolver,
     setResolver: options.setResolver,
     sendRequestToVisibleOverlay: (data) =>
-      options.sendToVisibleOverlay('kiku:field-grouping-request', data),
+      options.sendToVisibleOverlay('kiku:field-grouping-request', data, {
+        restoreOnModalClose: 'kiku' as T,
+      }),
   });
 }

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

@@ -11,6 +11,7 @@ test('overlay manager initializes with empty windows and hidden overlays', () =>
   assert.equal(manager.getMainWindow(), null);
   assert.equal(manager.getInvisibleWindow(), null);
   assert.equal(manager.getSecondaryWindow(), null);
+  assert.equal(manager.getModalWindow(), null);
   assert.equal(manager.getVisibleOverlayVisible(), false);
   assert.equal(manager.getInvisibleOverlayVisible(), false);
   assert.deepEqual(manager.getOverlayWindows(), []);
@@ -27,14 +28,19 @@ test('overlay manager stores window references and returns stable window order',
   const secondaryWindow = {
     isDestroyed: () => false,
   } as unknown as Electron.BrowserWindow;
+  const modalWindow = {
+    isDestroyed: () => false,
+  } as unknown as Electron.BrowserWindow;
 
   manager.setMainWindow(visibleWindow);
   manager.setInvisibleWindow(invisibleWindow);
   manager.setSecondaryWindow(secondaryWindow);
+  manager.setModalWindow(modalWindow);
 
   assert.equal(manager.getMainWindow(), visibleWindow);
   assert.equal(manager.getInvisibleWindow(), invisibleWindow);
   assert.equal(manager.getSecondaryWindow(), secondaryWindow);
+  assert.equal(manager.getModalWindow(), modalWindow);
   assert.equal(manager.getOverlayWindow('visible'), visibleWindow);
   assert.equal(manager.getOverlayWindow('invisible'), invisibleWindow);
   assert.deepEqual(manager.getOverlayWindows(), [visibleWindow, invisibleWindow, secondaryWindow]);
@@ -51,6 +57,9 @@ test('overlay manager excludes destroyed windows', () => {
   manager.setSecondaryWindow({
     isDestroyed: () => true,
   } as unknown as Electron.BrowserWindow);
+  manager.setModalWindow({
+    isDestroyed: () => false,
+  } as unknown as Electron.BrowserWindow);
 
   assert.equal(manager.getOverlayWindows().length, 1);
 });
@@ -93,6 +102,10 @@ test('overlay manager broadcasts to non-destroyed windows', () => {
   manager.setMainWindow(aliveWindow);
   manager.setInvisibleWindow(deadWindow);
   manager.setSecondaryWindow(secondaryWindow);
+  manager.setModalWindow({
+    isDestroyed: () => false,
+    webContents: { send: () => {} },
+  } as unknown as Electron.BrowserWindow);
   manager.broadcastToOverlayWindows('x', 1, 'a');
 
   assert.deepEqual(calls, [
@@ -123,9 +136,17 @@ test('overlay manager applies bounds by layer', () => {
       invisibleCalls.push(bounds);
     },
   } as unknown as Electron.BrowserWindow;
+  const modalCalls: Electron.Rectangle[] = [];
+  const modalWindow = {
+    isDestroyed: () => false,
+    setBounds: (bounds: Electron.Rectangle) => {
+      modalCalls.push(bounds);
+    },
+  } as unknown as Electron.BrowserWindow;
   manager.setMainWindow(visibleWindow);
   manager.setInvisibleWindow(invisibleWindow);
   manager.setSecondaryWindow(secondaryWindow);
+  manager.setModalWindow(modalWindow);
 
   manager.setOverlayWindowBounds('visible', {
     x: 10,
@@ -145,12 +166,19 @@ test('overlay manager applies bounds by layer', () => {
     width: 10,
     height: 11,
   });
+  manager.setModalWindowBounds({
+    x: 80,
+    y: 90,
+    width: 100,
+    height: 110,
+  });
 
   assert.deepEqual(visibleCalls, [{ x: 10, y: 20, width: 30, height: 40 }]);
   assert.deepEqual(invisibleCalls, [
     { x: 1, y: 2, width: 3, height: 4 },
     { x: 8, y: 9, width: 10, height: 11 },
   ]);
+  assert.deepEqual(modalCalls, [{ x: 80, y: 90, width: 100, height: 110 }]);
 });
 
 test('runtime-option and debug broadcasts use expected channels', () => {

src/core/services/overlay-manager.ts

@@ -1,4 +1,4 @@
-import { BrowserWindow } from 'electron';
+import type { BrowserWindow } from 'electron';
 import { RuntimeOptionState, WindowGeometry } from '../../types';
 import { updateOverlayWindowBounds } from './overlay-window';
 
@@ -11,9 +11,12 @@ export interface OverlayManager {
   setInvisibleWindow: (window: BrowserWindow | null) => void;
   getSecondaryWindow: () => BrowserWindow | null;
   setSecondaryWindow: (window: BrowserWindow | null) => void;
+  getModalWindow: () => BrowserWindow | null;
+  setModalWindow: (window: BrowserWindow | null) => void;
   getOverlayWindow: (layer: OverlayLayer) => BrowserWindow | null;
   setOverlayWindowBounds: (layer: OverlayLayer, geometry: WindowGeometry) => void;
   setSecondaryWindowBounds: (geometry: WindowGeometry) => void;
+  setModalWindowBounds: (geometry: WindowGeometry) => void;
   getVisibleOverlayVisible: () => boolean;
   setVisibleOverlayVisible: (visible: boolean) => void;
   getInvisibleOverlayVisible: () => boolean;
@@ -26,6 +29,7 @@ export function createOverlayManager(): OverlayManager {
   let mainWindow: BrowserWindow | null = null;
   let invisibleWindow: BrowserWindow | null = null;
   let secondaryWindow: BrowserWindow | null = null;
+  let modalWindow: BrowserWindow | null = null;
   let visibleOverlayVisible = false;
   let invisibleOverlayVisible = false;
 
@@ -42,6 +46,10 @@ export function createOverlayManager(): OverlayManager {
     setSecondaryWindow: (window) => {
       secondaryWindow = window;
     },
+    getModalWindow: () => modalWindow,
+    setModalWindow: (window) => {
+      modalWindow = window;
+    },
     getOverlayWindow: (layer) => (layer === 'visible' ? mainWindow : invisibleWindow),
     setOverlayWindowBounds: (layer, geometry) => {
       updateOverlayWindowBounds(geometry, layer === 'visible' ? mainWindow : invisibleWindow);
@@ -49,6 +57,9 @@ export function createOverlayManager(): OverlayManager {
     setSecondaryWindowBounds: (geometry) => {
       updateOverlayWindowBounds(geometry, secondaryWindow);
     },
+    setModalWindowBounds: (geometry) => {
+      updateOverlayWindowBounds(geometry, modalWindow);
+    },
     getVisibleOverlayVisible: () => visibleOverlayVisible,
     setVisibleOverlayVisible: (visible) => {
       visibleOverlayVisible = visible;

src/core/services/overlay-window.ts

@@ -5,7 +5,7 @@ import { createLogger } from '../../logger';
 
 const logger = createLogger('main:overlay-window');
 
-export type OverlayWindowKind = 'visible' | 'invisible' | 'secondary';
+export type OverlayWindowKind = 'visible' | 'invisible' | 'secondary' | 'modal';
 
 export function updateOverlayWindowBounds(
   geometry: WindowGeometry,
@@ -71,6 +71,7 @@ export function createOverlayWindow(
     resizable: false,
     hasShadow: false,
     focusable: true,
+    acceptFirstMouse: true,
     webPreferences: {
       preload: path.join(__dirname, '..', '..', 'preload.js'),
       contextIsolation: true,
@@ -115,6 +116,7 @@ export function createOverlayWindow(
   }
 
   window.webContents.on('before-input-event', (event, input) => {
+    if (kind === 'modal') return;
     if (!options.isOverlayVisible(kind)) return;
     if (!options.tryHandleOverlayShortcutLocalFallback(input)) return;
     event.preventDefault();