@dimina-kit/devtools 0.4.0-dev.20260615083030 → 0.4.0-dev.20260616085026

package/dist/main/app/app.js

@@ -6,6 +6,7 @@ import path from 'path';
 import { rendererDir as defaultRendererDir, defaultPreloadPath } from '../utils/paths.js';
 import { installThemeBackgroundSync } from '../utils/theme.js';
 import { createMainWindow, wireMainWindowEvents } from '../windows/main-window/index.js';
+import { isAppQuitting } from './lifecycle.js';
 // eslint-disable-next-line no-restricted-syntax -- grandfathered(workbench-context): shrink-only
 import { createWorkbenchContext } from '../services/workbench-context.js';
 import { loadWorkbenchSettings, applyTheme } from '../services/settings/index.js';
@@ -131,6 +132,7 @@ function createConfiguredMainWindow(config, rendererDir) {
         height: config.window?.height,
         minWidth: config.window?.minWidth,
         minHeight: config.window?.minHeight,
+        autoShow: config.window?.autoShow,
     });
     // Set window/taskbar icon if provided (Linux/Windows; macOS uses app bundle icon)
     if (config.icon) {
@@ -157,6 +159,7 @@ function createContext(config, mainWindow, rendererDir) {
         projectTemplates: config.projectTemplates,
         builtinTemplates: config.builtinTemplates,
         customCreateProjectDialog: config.customCreateProjectDialog,
+        onBeforeOpenProject: config.onBeforeOpenProject,
     });
 }
 function registerBuiltinModules(config, context) {
@@ -229,6 +232,14 @@ function wireAppWindowEvents(config, instance) {
         context,
         onResize: () => context.views.repositionAll(),
         onClose: async (e) => {
+            // A real application quit (⌘Q / menu "Quit" / app.quit()) fires
+            // `before-quit` first, then this window's `close`. Let it through so the
+            // app actually exits — do NOT convert it into "close the project".
+            // Without this, `hasActiveSession()` would be true and the quit gets
+            // swallowed into closeProject(), so the app can never be quit while a
+            // project is open.
+            if (isAppQuitting())
+                return;
             if (!context.workspace.hasActiveSession())
                 return;
             // Close button while a project session is open: stay in the workbench

package/dist/main/app/lifecycle.d.ts

@@ -1,2 +1,3 @@
+export declare function isAppQuitting(): boolean;
 export declare function registerAppLifecycle(): void;
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/main/app/lifecycle.js

@@ -1,10 +1,20 @@
 import { app, globalShortcut } from 'electron';
+// Flips to `true` once Electron's `before-quit` fires — a real application
+// quit (⌘Q / menu "Quit" / app.quit()) is underway. `before-quit` is emitted
+// BEFORE each window's `close` event, so the main-window onClose handler can
+// read this to tell "the whole app is exiting" apart from "the user closed a
+// single project window" and avoid swallowing the quit.
+let appIsQuitting = false;
+export function isAppQuitting() {
+    return appIsQuitting;
+}
 export function registerAppLifecycle() {
     app.on('window-all-closed', () => {
         globalShortcut.unregisterAll();
         app.quit();
     });
     app.on('before-quit', () => {
+        appIsQuitting = true;
         globalShortcut.unregisterAll();
     });
 }

package/dist/main/index.bundle.js

@@ -761,7 +761,7 @@ function registerProjectFsIpc(ctx) {
 }
 
 // src/main/app/app.ts
-import { app as app14, BrowserWindow as BrowserWindow8, nativeImage, session as session4 } from "electron";
+import { app as app15, BrowserWindow as BrowserWindow8, nativeImage, session as session4 } from "electron";
 import fs10 from "fs";
 import path21 from "path";
 
@@ -885,13 +885,13 @@ function createMainWindow(opts) {
     }
   });
   mainWindow.once("ready-to-show", () => {
-    if (process.env.NODE_ENV === "test") {
-      mainWindow.showInactive();
-    } else {
-      mainWindow.show();
-      if (!app3.isPackaged && process.env.DIMINA_DEVTOOLS_MAIN_INSPECTOR === "1") {
-        mainWindow.webContents.openDevTools({ mode: "detach" });
-      }
+    const isTest = process.env.NODE_ENV === "test";
+    if (opts.autoShow !== false) {
+      if (isTest) mainWindow.showInactive();
+      else mainWindow.show();
+    }
+    if (!isTest && !app3.isPackaged && process.env.DIMINA_DEVTOOLS_MAIN_INSPECTOR === "1") {
+      mainWindow.webContents.openDevTools({ mode: "detach" });
     }
   });
   const rendererDir2 = path5.dirname(opts.indexHtml);
@@ -943,6 +943,23 @@ function wireMainWindowEvents(win, state = {}) {
   return registry;
 }
 
+// src/main/app/lifecycle.ts
+import { app as app4, globalShortcut as globalShortcut2 } from "electron";
+var appIsQuitting = false;
+function isAppQuitting() {
+  return appIsQuitting;
+}
+function registerAppLifecycle() {
+  app4.on("window-all-closed", () => {
+    globalShortcut2.unregisterAll();
+    app4.quit();
+  });
+  app4.on("before-quit", () => {
+    appIsQuitting = true;
+    globalShortcut2.unregisterAll();
+  });
+}
+
 // src/main/services/workbench-context.ts
 import {
   createConnectionRegistry,
@@ -966,12 +983,12 @@ function createWorkbenchSenderPolicy(ctx) {
 
 // src/main/services/default-adapter.ts
 import path6 from "path";
-import { app as app4 } from "electron";
+import { app as app5 } from "electron";
 var defaultAdapter = {
   async openProject(opts) {
     const diminaKit = await import("@dimina-kit/devkit");
     const openProjectOpts = {
-      outputDir: path6.join(app4.getPath("userData"), "dimina-fe-output"),
+      outputDir: path6.join(app5.getPath("userData"), "dimina-fe-output"),
       ...opts,
       simulatorDir
     };
@@ -2707,12 +2724,12 @@ async function openSettingsWindow(deps) {
 import { z as z2 } from "zod";
 
 // src/main/services/projects/project-repository.ts
-import { app as app5 } from "electron";
+import { app as app6 } from "electron";
 import path9 from "path";
 import fs4 from "fs";
 var log2 = createLogger("projects");
 function getProjectsFile() {
-  return path9.join(app5.getPath("userData"), "dimina-projects.json");
+  return path9.join(app6.getPath("userData"), "dimina-projects.json");
 }
 function load() {
   try {
@@ -2927,6 +2944,15 @@ function createWorkspaceService(ctx) {
     },
     validateProjectDir: async (dirPath) => provider.validateProjectDir ? provider.validateProjectDir(dirPath) : null,
     async openProject(projectPath) {
+      if (ctx.onBeforeOpenProject) {
+        try {
+          await ctx.onBeforeOpenProject(projectPath);
+        } catch (err) {
+          const error = err instanceof Error ? err.message : String(err);
+          sendStatus("error", error);
+          return { success: false, error };
+        }
+      }
       clearSimulatorServicewechatReferer();
       logGeneration++;
       await disposeSession();
@@ -3046,9 +3072,9 @@ function createWorkspaceService(ctx) {
 import { createHash } from "crypto";
 import fs5 from "fs";
 import path10 from "path";
-import { app as app6 } from "electron";
+import { app as app7 } from "electron";
 function getThumbnailDir() {
-  return path10.join(app6.getPath("userData"), "thumbnails");
+  return path10.join(app7.getPath("userData"), "thumbnails");
 }
 function hashProjectPath(projectPath) {
   return createHash("sha256").update(projectPath).digest("hex").slice(0, 16);
@@ -3157,6 +3183,7 @@ function createWorkbenchContext(opts) {
     opts.builtinTemplates ?? "all"
   );
   ctx.customCreateProjectDialog = opts.customCreateProjectDialog;
+  ctx.onBeforeOpenProject = opts.onBeforeOpenProject;
   ctx.workspace = createWorkspaceService(ctx);
   ctx.senderPolicy = createWorkbenchSenderPolicy(ctx);
   return ctx;
@@ -3463,7 +3490,7 @@ var popoverModule = {
 };
 
 // src/main/ipc/projects.ts
-import { app as app7, dialog } from "electron";
+import { app as app8, dialog } from "electron";
 import path13 from "path";
 
 // src/main/services/projects/create-project-service.ts
@@ -3617,7 +3644,7 @@ function registerProjectsIpc(ctx) {
 }
 function safeAppPath(name) {
   try {
-    return app7.getPath(name);
+    return app8.getPath(name);
   } catch {
     return null;
   }
@@ -3671,7 +3698,7 @@ var sessionModule = {
 };
 
 // src/main/ipc/settings.ts
-import { app as app8 } from "electron";
+import { app as app9 } from "electron";
 
 // src/main/services/mcp/status.ts
 var status = { running: false, port: null, error: null };
@@ -3710,8 +3737,8 @@ function registerSettingsIpc(ctx) {
     applyTheme(theme);
   }).handle(WorkbenchSettingsChannel.GetCdpStatus, () => {
     const settings = loadWorkbenchSettings();
-    const switchValue = app8.commandLine.getSwitchValue("remote-debugging-port");
-    const implicitDevDefault = !app8.isPackaged && !settings.cdp.enabled && switchValue === String(DEFAULT_CDP_PORT);
+    const switchValue = app9.commandLine.getSwitchValue("remote-debugging-port");
+    const implicitDevDefault = !app9.isPackaged && !settings.cdp.enabled && switchValue === String(DEFAULT_CDP_PORT);
     return {
       configured: settings.cdp.enabled,
       port: settings.cdp.port,
@@ -3772,7 +3799,7 @@ var settingsModule = {
 import { DisposableRegistry as DisposableRegistry6 } from "@dimina-kit/electron-deck/main";
 
 // src/main/ipc/bridge-router.ts
-import { app as app11, ipcMain as ipcMain3, protocol as protocol2, session as electronSession, webContents as webContents2 } from "electron";
+import { app as app12, ipcMain as ipcMain3, protocol as protocol2, session as electronSession, webContents as webContents2 } from "electron";
 import path16 from "node:path";
 import { pathToFileURL as pathToFileURL3 } from "node:url";
 
@@ -3880,7 +3907,7 @@ function setCorsHeaders(res) {
 }
 
 // src/main/windows/service-host-window/create.ts
-import { app as app9, BrowserWindow as BrowserWindow4 } from "electron";
+import { app as app10, BrowserWindow as BrowserWindow4 } from "electron";
 import path15 from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 var SERVICE_HOST_PARTITION = SHARED_MINIAPP_PARTITION;
@@ -3921,7 +3948,7 @@ function navigateServiceHost(win, url) {
     () => void 0,
     () => void 0
   );
-  if (!app9.isPackaged && process.env.NODE_ENV !== "test") {
+  if (!app10.isPackaged && process.env.NODE_ENV !== "test") {
     const w = win;
     if (w.__diminaDevToolsHook) {
       try {
@@ -4318,7 +4345,7 @@ function createConsoleForwarder(bridge) {
 }
 
 // src/main/services/simulator-storage/index.ts
-import { app as app10, webContents as wcStatic } from "electron";
+import { app as app11, webContents as wcStatic } from "electron";
 import { DisposableRegistry as DisposableRegistry5 } from "@dimina-kit/electron-deck/main";
 
 // src/main/services/simulator-storage/service-storage-ops.ts
@@ -4688,9 +4715,9 @@ function setupSimulatorStorage(host, options) {
       }
     }
   };
-  app10.on("web-contents-created", onWcCreated);
+  app11.on("web-contents-created", onWcCreated);
   registry.add(() => {
-    app10.removeListener("web-contents-created", onWcCreated);
+    app11.removeListener("web-contents-created", onWcCreated);
   });
   registry.add(async () => {
     const subs = Array.from(wcSubs.values());
@@ -5864,7 +5891,7 @@ function makeHostEnv(snapshot) {
     windowWidth: 390,
     windowHeight: 844,
     statusBarHeight: 24,
-    language: app11.getLocale(),
+    language: app12.getLocale(),
     theme: "light",
     ...snapshot
   };
@@ -8661,7 +8688,7 @@ function setupSimulatorSessionPolicy() {
 }
 
 // src/main/services/update/update-manager.ts
-import { app as app12, shell as shell3 } from "electron";
+import { app as app13, shell as shell3 } from "electron";
 var UpdateManager = class {
   checker;
   mainWindow;
@@ -8684,7 +8711,7 @@ var UpdateManager = class {
   constructor(opts) {
     this.checker = opts.checker;
     this.mainWindow = opts.mainWindow;
-    this.getCurrentVersion = opts.getCurrentVersion ?? (() => app12.getVersion());
+    this.getCurrentVersion = opts.getCurrentVersion ?? (() => app13.getVersion());
     this.ipc = new IpcRegistry(opts.senderPolicy);
     this.registerIpc();
     this.startPeriodicCheck(opts.checkInterval ?? 60 * 60 * 1e3, opts.initialDelay ?? 5e3);
@@ -8725,7 +8752,7 @@ var UpdateManager = class {
   install() {
     if (this.downloadedPath) {
       shell3.openPath(this.downloadedPath);
-      app12.quit();
+      app13.quit();
     }
   }
   /**
@@ -8759,7 +8786,7 @@ var UpdateManager = class {
 };
 
 // src/main/services/update/github-release-checker.ts
-import { app as app13 } from "electron";
+import { app as app14 } from "electron";
 
 // src/main/app/app.ts
 import { toDisposable as toDisposable8 } from "@dimina-kit/electron-deck/main";
@@ -8834,7 +8861,8 @@ function createConfiguredMainWindow(config, rendererDir2) {
     width: config.window?.width,
     height: config.window?.height,
     minWidth: config.window?.minWidth,
-    minHeight: config.window?.minHeight
+    minHeight: config.window?.minHeight,
+    autoShow: config.window?.autoShow
   });
   if (config.icon) {
     const icon = nativeImage.createFromPath(config.icon);
@@ -8858,7 +8886,8 @@ function createContext(config, mainWindow, rendererDir2) {
     projectsProvider: config.projectsProvider,
     projectTemplates: config.projectTemplates,
     builtinTemplates: config.builtinTemplates,
-    customCreateProjectDialog: config.customCreateProjectDialog
+    customCreateProjectDialog: config.customCreateProjectDialog,
+    onBeforeOpenProject: config.onBeforeOpenProject
   });
 }
 function registerBuiltinModules(config, context) {
@@ -8903,7 +8932,7 @@ async function setupAutomation(instance) {
 function setupMcp() {
   const settings = loadWorkbenchSettings();
   if (!settings.mcp.enabled) return null;
-  const cdpPortSwitch = app14.commandLine.getSwitchValue("remote-debugging-port");
+  const cdpPortSwitch = app15.commandLine.getSwitchValue("remote-debugging-port");
   const cdpPort2 = cdpPortSwitch ? parseInt(cdpPortSwitch, 10) : settings.cdp.port;
   return startMcpServer(cdpPort2, settings.mcp.port);
 }
@@ -8914,6 +8943,7 @@ function wireAppWindowEvents(config, instance) {
     context,
     onResize: () => context.views.repositionAll(),
     onClose: async (e) => {
+      if (isAppQuitting()) return;
       if (!context.workspace.hasActiveSession()) return;
       e.preventDefault();
       if (closing) return;
@@ -8931,7 +8961,7 @@ function wireAppWindowEvents(config, instance) {
   });
 }
 function enableDevRendererAutoReload(rendererDir2) {
-  if (app14.isPackaged) {
+  if (app15.isPackaged) {
     return toDisposable8(() => {
     });
   }
@@ -8954,7 +8984,7 @@ function enableDevRendererAutoReload(rendererDir2) {
 }
 function runDevtoolsBootstrap(config = {}) {
   try {
-    app14.setName(config.appName ?? "Dimina DevTools");
+    app15.setName(config.appName ?? "Dimina DevTools");
   } catch {
   }
   setupCdpPort();
@@ -8962,7 +8992,7 @@ function runDevtoolsBootstrap(config = {}) {
   registerDifileScheme();
 }
 async function createDevtoolsRuntime(config = {}) {
-  await app14.whenReady();
+  await app15.whenReady();
   applyTheme(loadWorkbenchSettings().theme);
   const rendererDir2 = config.rendererDir ?? rendererDir;
   const mainWindow = createConfiguredMainWindow(config, rendererDir2);
@@ -9111,18 +9141,6 @@ async function createDevtoolsRuntime(config = {}) {
   return instance;
 }
 
-// src/main/app/lifecycle.ts
-import { app as app15, globalShortcut as globalShortcut2 } from "electron";
-function registerAppLifecycle() {
-  app15.on("window-all-closed", () => {
-    globalShortcut2.unregisterAll();
-    app15.quit();
-  });
-  app15.on("before-quit", () => {
-    globalShortcut2.unregisterAll();
-  });
-}
-
 // src/main/runtime/devtools-backend.ts
 function createDevtoolsBackend(config = {}) {
   let instance = null;
@@ -9133,9 +9151,11 @@ function createDevtoolsBackend(config = {}) {
     // NOTE: `ownsWindows` is NOT structurally required — the framework's
     // `mainWindowWebPreferences()` + `onMainWindowCreated()` hooks can supply both,
     // and the project close→back lifecycle maps onto the Window facade's
-    // `onClose`/`newSession` (probe-validated). Retained for now; migrating to
-    // `runtime.windows.main` is the documented next step. (The `persist:simulator`
-    // partition is a fixed session used by child WCVs, not main-window state.)
+    // `onClose`/`newSession` (probe-validated). It is RETAINED BY DECISION, not
+    // inertia: migrating to `runtime.windows.main` buys no user value at high
+    // regression cost (see docs/deck-adoption-decision.md, F1). (The
+    // `persist:simulator` partition is a fixed session used by child WCVs, not
+    // main-window state.)
     ownsWindows: true,
     // Pre-ready: app name / CDP port / CSP / privileged scheme — must run before
     // the framework awaits app.whenReady().

package/dist/main/runtime/devtools-backend.d.ts

@@ -12,6 +12,11 @@ import type { WorkbenchAppConfig } from '../../shared/types.js';
  * backend is present), so `assemble` ignores the framework `runtime` and builds
  * the real devtools main window itself. Trust/frame unification and surfacing
  * the runtime facade are deferred (see framework-extraction-v2.md §7).
+ *
+ * NOT migrating onto deck's high-level host API (Window facade / runtime.view /
+ * DeckSession / grants) is a DELIBERATE, reviewed decision — not a backlog item.
+ * The ROI matrix (every candidate NO-GO) + revisit conditions live in
+ * docs/deck-adoption-decision.md. Read it before re-proposing such a migration.
  */
 export declare function createDevtoolsBackend(config?: WorkbenchAppConfig): RuntimeBackend;
 //# sourceMappingURL=devtools-backend.d.ts.map

package/dist/main/runtime/devtools-backend.js

@@ -12,6 +12,11 @@ import { registerAppLifecycle } from '../app/lifecycle.js';
  * backend is present), so `assemble` ignores the framework `runtime` and builds
  * the real devtools main window itself. Trust/frame unification and surfacing
  * the runtime facade are deferred (see framework-extraction-v2.md §7).
+ *
+ * NOT migrating onto deck's high-level host API (Window facade / runtime.view /
+ * DeckSession / grants) is a DELIBERATE, reviewed decision — not a backlog item.
+ * The ROI matrix (every candidate NO-GO) + revisit conditions live in
+ * docs/deck-adoption-decision.md. Read it before re-proposing such a migration.
  */
 export function createDevtoolsBackend(config = {}) {
     // Hoisted so `onShutdown` can reach the assembled context (assigned by `assemble`).
@@ -23,9 +28,11 @@ export function createDevtoolsBackend(config = {}) {
         // NOTE: `ownsWindows` is NOT structurally required — the framework's
         // `mainWindowWebPreferences()` + `onMainWindowCreated()` hooks can supply both,
         // and the project close→back lifecycle maps onto the Window facade's
-        // `onClose`/`newSession` (probe-validated). Retained for now; migrating to
-        // `runtime.windows.main` is the documented next step. (The `persist:simulator`
-        // partition is a fixed session used by child WCVs, not main-window state.)
+        // `onClose`/`newSession` (probe-validated). It is RETAINED BY DECISION, not
+        // inertia: migrating to `runtime.windows.main` buys no user value at high
+        // regression cost (see docs/deck-adoption-decision.md, F1). (The
+        // `persist:simulator` partition is a fixed session used by child WCVs, not
+        // main-window state.)
         ownsWindows: true,
         // Pre-ready: app name / CDP port / CSP / privileged scheme — must run before
         // the framework awaits app.whenReady().

package/dist/main/runtime/miniapp-runtime.d.ts

@@ -15,8 +15,10 @@
  *    syntax: under strictFunctionTypes method signatures compare bivariantly,
  *    which would let a wrongly-narrowed implementation or host override slip
  *    past the drift sentinel.
- *  - `workspace.openProject` stays writable (no `readonly`): qdmp gates
- *    project permissions by reassigning it (documented monkey-patch contract).
+ *  - `workspace.openProject` stays writable (no `readonly`) for backward
+ *    compat: hosts MAY still gate permissions by reassigning it. The preferred
+ *    path is now the declarative `WorkbenchAppConfig.onBeforeOpenProject` hook
+ *    (runs before any side effect, throw to veto) — see host-migration.md §7.
  *
  * `asMiniappRuntime(ctx)` is an identity return — the contract is a typed
  * VIEW onto the live context, not a snapshot/projection. That is what makes

package/dist/main/services/workbench-context.d.ts

@@ -74,6 +74,13 @@ export interface WorkbenchContext {
         parentWindow: BrowserWindow;
         templates: ProjectTemplate[];
     }) => Promise<CustomCreateProjectDialogResult>;
+    /**
+     * Host permission gate consulted by `workspace.openProject` BEFORE any side
+     * effect. Throwing vetoes the open (see `WorkbenchAppConfig.onBeforeOpenProject`).
+     * Wired from the config by `createDevtoolsRuntime`; undefined for the
+     * single-tenant default.
+     */
+    onBeforeOpenProject?: (projectPath: string) => void | Promise<void>;
     /**
      * Trust predicate consulted by `IpcRegistry` for every incoming IPC.
      * Resolves the currently-trusted senders (main renderer + overlays)
@@ -183,6 +190,8 @@ export interface CreateContextOptions extends Pick<WorkbenchConfig, 'adapter' |
     builtinTemplates?: 'all' | 'none' | readonly string[];
     /** Host-supplied "新建项目" dialog hook. */
     customCreateProjectDialog?: WorkbenchContext['customCreateProjectDialog'];
+    /** Host permission gate run before a project opens (throw to veto). */
+    onBeforeOpenProject?: WorkbenchContext['onBeforeOpenProject'];
 }
 export declare function createWorkbenchContext(opts: CreateContextOptions): WorkbenchContext;
 export { sanitizeTemplates };

package/dist/main/services/workbench-context.js

@@ -37,6 +37,7 @@ export function createWorkbenchContext(opts) {
     ctx.projectsProvider = opts.projectsProvider ?? createLocalProjectsProvider();
     ctx.projectTemplates = resolveTemplates(BUILTIN_TEMPLATES, opts.projectTemplates ?? [], opts.builtinTemplates ?? 'all');
     ctx.customCreateProjectDialog = opts.customCreateProjectDialog;
+    ctx.onBeforeOpenProject = opts.onBeforeOpenProject;
     ctx.workspace = createWorkspaceService(ctx);
     ctx.senderPolicy = createWorkbenchSenderPolicy(ctx);
     return ctx;

package/dist/main/services/workspace/workspace-service.js

@@ -80,6 +80,27 @@ export function createWorkspaceService(ctx) {
             ? provider.validateProjectDir(dirPath)
             : null,
         async openProject(projectPath) {
+            // Host permission gate — runs BEFORE any side effect (referer reset,
+            // session teardown, compile/dev-server spin-up). A throwing hook vetoes
+            // the open: return early with the error and leave the currently-active
+            // session fully intact. The declarative replacement for monkey-patching
+            // this method. See WorkbenchAppConfig.onBeforeOpenProject.
+            if (ctx.onBeforeOpenProject) {
+                try {
+                    await ctx.onBeforeOpenProject(projectPath);
+                }
+                catch (err) {
+                    // Surface the veto to the status bar — symmetric with the
+                    // validateProjectDir rejection below (which already emits an error
+                    // status). The framework caught the error, so it owns the minimal
+                    // user-visible feedback; a host gate must not have to thread
+                    // `notify` through a singleton just to report why the open was
+                    // denied. The host can still layer richer UX (e.g. a dialog).
+                    const error = err instanceof Error ? err.message : String(err);
+                    sendStatus('error', error);
+                    return { success: false, error };
+                }
+            }
             clearSimulatorServicewechatReferer();
             // Invalidate the outgoing session's onLog BEFORE teardown starts (same
             // order as closeProject below): the dying compile worker flushes

package/dist/main/windows/main-window/create.d.ts

@@ -6,6 +6,12 @@ export interface WindowOptions {
     minWidth?: number;
     minHeight?: number;
     indexHtml: string;
+    /**
+     * Auto-show the window on `ready-to-show` in non-test envs. Defaults to
+     * `true`. `false` lets a login-gating host keep the window hidden and call
+     * `show()` itself. The test env always uses `showInactive()` regardless.
+     */
+    autoShow?: boolean;
 }
 export declare function createMainWindow(opts: WindowOptions): BrowserWindow;
 //# sourceMappingURL=create.d.ts.map

package/dist/main/windows/main-window/create.js

@@ -22,17 +22,24 @@ export function createMainWindow(opts) {
         },
     });
     mainWindow.once('ready-to-show', () => {
-        if (process.env.NODE_ENV === 'test') {
-            mainWindow.showInactive();
+        const isTest = process.env.NODE_ENV === 'test';
+        // Visibility is governed by `autoShow` in BOTH envs. A login-gating host
+        // opts out via `autoShow: false` and reveals the window itself once auth
+        // passes — don't flash an un-authed window. The env only chooses HOW to
+        // show: test uses showInactive() so e2e windows don't steal focus, prod
+        // uses show(). The framework must never force-show when the host opted
+        // out, in test env either (that would fight the host's own reveal handler).
+        if (opts.autoShow !== false) {
+            if (isTest)
+                mainWindow.showInactive();
+            else
+                mainWindow.show();
         }
-        else {
-            mainWindow.show();
-            // Don't auto-open a detached DevTools for the devtools UI shell itself —
-            // it's noise for normal use (the mini-app's Console lives in the embedded
-            // right-panel DevTools, not here). Opt in via env for debugging the shell.
-            if (!app.isPackaged && process.env.DIMINA_DEVTOOLS_MAIN_INSPECTOR === '1') {
-                mainWindow.webContents.openDevTools({ mode: 'detach' });
-            }
+        // Don't auto-open a detached DevTools for the devtools UI shell itself —
+        // it's noise for normal use (the mini-app's Console lives in the embedded
+        // right-panel DevTools, not here). Opt in via env for debugging the shell.
+        if (!isTest && !app.isPackaged && process.env.DIMINA_DEVTOOLS_MAIN_INSPECTOR === '1') {
+            mainWindow.webContents.openDevTools({ mode: 'detach' });
         }
     });
     const rendererDir = path.dirname(opts.indexHtml);