feat(core): add Electron runtime, services, and app composition

src/core/services/overlay-bridge.ts

@@ -0,0 +1,68 @@
+import { KikuFieldGroupingChoice, KikuFieldGroupingRequestData } from '../../types';
+import { createFieldGroupingCallback } from './field-grouping';
+import { BrowserWindow } from 'electron';
+
+export function sendToVisibleOverlayRuntime<T extends string>(options: {
+  mainWindow: BrowserWindow | null;
+  visibleOverlayVisible: boolean;
+  setVisibleOverlayVisible: (visible: boolean) => void;
+  channel: string;
+  payload?: unknown;
+  restoreOnModalClose?: T;
+  restoreVisibleOverlayOnModalClose: Set<T>;
+}): boolean {
+  if (!options.mainWindow || options.mainWindow.isDestroyed()) return false;
+  const wasVisible = options.visibleOverlayVisible;
+  if (!options.visibleOverlayVisible) {
+    options.setVisibleOverlayVisible(true);
+  }
+  if (!wasVisible && options.restoreOnModalClose) {
+    options.restoreVisibleOverlayOnModalClose.add(options.restoreOnModalClose);
+  }
+  const sendNow = (): void => {
+    if (options.payload === undefined) {
+      options.mainWindow!.webContents.send(options.channel);
+    } else {
+      options.mainWindow!.webContents.send(options.channel, options.payload);
+    }
+  };
+  if (options.mainWindow.webContents.isLoading()) {
+    options.mainWindow.webContents.once('did-finish-load', () => {
+      if (
+        options.mainWindow &&
+        !options.mainWindow.isDestroyed() &&
+        !options.mainWindow.webContents.isLoading()
+      ) {
+        sendNow();
+      }
+    });
+    return true;
+  }
+  sendNow();
+  return true;
+}
+
+export function createFieldGroupingCallbackRuntime<T extends string>(options: {
+  getVisibleOverlayVisible: () => boolean;
+  getInvisibleOverlayVisible: () => boolean;
+  setVisibleOverlayVisible: (visible: boolean) => void;
+  setInvisibleOverlayVisible: (visible: boolean) => void;
+  getResolver: () => ((choice: KikuFieldGroupingChoice) => void) | null;
+  setResolver: (resolver: ((choice: KikuFieldGroupingChoice) => void) | null) => void;
+  sendToVisibleOverlay: (
+    channel: string,
+    payload?: unknown,
+    runtimeOptions?: { restoreOnModalClose?: T },
+  ) => boolean;
+}): (data: KikuFieldGroupingRequestData) => Promise<KikuFieldGroupingChoice> {
+  return createFieldGroupingCallback({
+    getVisibleOverlayVisible: options.getVisibleOverlayVisible,
+    getInvisibleOverlayVisible: options.getInvisibleOverlayVisible,
+    setVisibleOverlayVisible: options.setVisibleOverlayVisible,
+    setInvisibleOverlayVisible: options.setInvisibleOverlayVisible,
+    getResolver: options.getResolver,
+    setResolver: options.setResolver,
+    sendRequestToVisibleOverlay: (data) =>
+      options.sendToVisibleOverlay('kiku:field-grouping-request', data),
+  });
+}