@next2d/builder 0.4.2 → 0.4.4

package/dist/electron-config.d.ts

@@ -47,12 +47,13 @@ export declare const createElectronPackagerOptions: (root: string, config: IElec
             entitlements: string;
         };
     } | undefined;
-    extendInfo?: {
-        NSLocalNetworkUsageDescription: string;
-    } | undefined;
     extendHelperInfo?: {
         NSLocalNetworkUsageDescription: string;
     } | undefined;
+    extendInfo?: {
+        LSUIElement?: boolean | undefined;
+        NSLocalNetworkUsageDescription?: string | undefined;
+    } | undefined;
     icon?: string | undefined;
     name: string;
     executableName: string;

package/dist/electron-config.js

@@ -129,9 +129,16 @@ export const createElectronPackagerOptions = (root, config, os, resources) => {
         "extraResource": [resources, ...config.nativeBridge ? [path.join(path.dirname(resources), "native")] : []],
         "ignore": [/^\/native(?:\/|$)/, /^\/resources(?:\/|$)/, /^\/icons(?:\/|$)/, /^\/forge\.config\.[cm]?js$/, /^\/entitlements\.plist$/, /(?:^|\/)steam_appid\.txt$/],
         ...os !== "linux" && config.icons[os] ? { "icon": path.resolve(root, config.icons[os]) } : {},
-        ...os === "macos" && config.macos.localNetworkUsageDescription ? {
-            "extendInfo": { "NSLocalNetworkUsageDescription": config.macos.localNetworkUsageDescription },
-            "extendHelperInfo": { "NSLocalNetworkUsageDescription": config.macos.localNetworkUsageDescription }
+        ...os === "macos" && (config.macos.localNetworkUsageDescription || config.window.overlay?.enabled) ? {
+            "extendInfo": {
+                ...config.macos.localNetworkUsageDescription ? { "NSLocalNetworkUsageDescription": config.macos.localNetworkUsageDescription } : {},
+                // An overlay starts as an agent app (no Dock icon) so that a second launch, which quits at once,
+                // never shows one. The first instance shows its Dock icon itself (templates/electron/index.js).
+                ...config.window.overlay?.enabled ? { "LSUIElement": true } : {}
+            },
+            ...config.macos.localNetworkUsageDescription ? {
+                "extendHelperInfo": { "NSLocalNetworkUsageDescription": config.macos.localNetworkUsageDescription }
+            } : {}
         } : {},
         ...os === "macos" && sign ? {
             "osxSign": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next2d/builder",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Multi-platform builder for Next2d Framework, supporting export to various platforms such as macOS, Windows, iOS, Android and Web(HTML)",
   "author": "Toshiyuki Ienaga <ienaga@next2d.app>",
   "license": "MIT",

package/templates/electron/index.js

@@ -51,6 +51,21 @@ const overlayBounds = () => {
 const placeOverlay = () => {
     if (mainWindow && !mainWindow.isDestroyed()) mainWindow.setBounds(overlayBounds());
 };
+// The overlay never takes focus, so Windows does not raise it when another topmost window (the taskbar, another
+// always-on-top app) is activated, nor after the display is turned off and on. Put it back on top.
+const keepOnTop = () => {
+    if (!mainWindow || mainWindow.isDestroyed()) return;
+    mainWindow.setAlwaysOnTop(true, "floating");
+    mainWindow.moveTop();
+};
+// Windows forwards mouse moves to a click-through window with a system mouse hook, and Electron installs it only
+// when forwarding switches on. After sleep (closing the lid) the hook can be gone while Electron still thinks it is
+// installed, so the page never sees the pointer. Switching forwarding off and on again installs a fresh hook.
+const refreshForwarding = () => {
+    if (!overlayIgnore || !mainWindow || mainWindow.isDestroyed()) return;
+    mainWindow.setIgnoreMouseEvents(false);
+    mainWindow.setIgnoreMouseEvents(true, { forward: true });
+};
 const createWindow = async () => {
     const { width, height } = screen.getPrimaryDisplay().workAreaSize;
     // The preload reads these flags; each API is exposed only when its feature is configured.
@@ -89,10 +104,16 @@ const createWindow = async () => {
             mainWindow.setIgnoreMouseEvents(true, { forward: true });
         }
         const events = ["display-metrics-changed", "display-added", "display-removed"];
-        for (const name of events) screen.on(name, placeOverlay);
+        const onDisplayChange = () => { placeOverlay(); keepOnTop(); };
+        for (const name of events) screen.on(name, onDisplayChange);
         mainWindow.once("closed", () => {
-            for (const name of events) screen.removeListener(name, placeOverlay);
+            for (const name of events) screen.removeListener(name, onDisplayChange);
         });
+        if (process.platform === "win32") {
+            const timer = setInterval(() => { keepOnTop(); refreshForwarding(); }, 3000);
+            timer.unref?.();
+            mainWindow.once("closed", () => clearInterval(timer));
+        }
     }
     mainWindow.webContents.setWindowOpenHandler(() => ({ action: "deny" }));
     mainWindow.webContents.on("will-navigate", (event, url) => {
@@ -123,6 +144,9 @@ const createWindow = async () => {
 
 app.whenReady().then(async () => {
     if (!hasLock) return;
+    // The overlay app is packaged as an agent app (LSUIElement) so a second launch never shows a Dock icon;
+    // the instance that keeps running shows it.
+    if (process.platform === "darwin" && overlay) app.dock?.show();
     Menu.setApplicationMenu(process.platform === "darwin" ? Menu.buildFromTemplate([
         { role: "appMenu" }, { role: "editMenu" }, { role: "windowMenu" }
     ]) : null);
@@ -180,7 +204,7 @@ app.whenReady().then(async () => {
         // z-order/bounds. Apply the overlay state again and tell the page so it can recover too.
         const recoverOverlay = () => {
             if (!mainWindow || mainWindow.isDestroyed()) return;
-            mainWindow.setAlwaysOnTop(true, "floating");
+            keepOnTop();
             placeOverlay();
             mainWindow.setIgnoreMouseEvents(false);
             mainWindow.setIgnoreMouseEvents(overlayIgnore, overlayIgnore ? { forward: true } : undefined);