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

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";
 
@@ -888,7 +888,9 @@ function createMainWindow(opts) {
     if (process.env.NODE_ENV === "test") {
       mainWindow.showInactive();
     } else {
-      mainWindow.show();
+      if (opts.autoShow !== false) {
+        mainWindow.show();
+      }
       if (!app3.isPackaged && process.env.DIMINA_DEVTOOLS_MAIN_INSPECTOR === "1") {
         mainWindow.webContents.openDevTools({ mode: "detach" });
       }
@@ -943,6 +945,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 +985,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 +2726,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 +2946,13 @@ 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) {
+          return { success: false, error: err instanceof Error ? err.message : String(err) };
+        }
+      }
       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;

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,19 @@ 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) {
+                    return { success: false, error: err instanceof Error ? err.message : String(err) };
+                }
+            }
             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

@@ -26,7 +26,11 @@ export function createMainWindow(opts) {
             mainWindow.showInactive();
         }
         else {
-            mainWindow.show();
+            // A login-gating host opts out via `autoShow: false` and shows the
+            // window itself once auth passes — don't flash an un-authed window.
+            if (opts.autoShow !== false) {
+                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.

package/dist/shared/types.d.ts

@@ -108,6 +108,14 @@ export interface WorkbenchWindowConfig {
     height?: number;
     minWidth?: number;
     minHeight?: number;
+    /**
+     * Auto-show the main window on `ready-to-show`. Defaults to `true`. Set
+     * `false` when the host gates the window behind its own startup flow (e.g. a
+     * login screen) and wants to call `mainWindow.show()` itself once ready —
+     * avoids an un-authed window flashing on screen. Does not affect the test
+     * environment, which always uses `showInactive()` (e2e depends on it).
+     */
+    autoShow?: boolean;
 }
 export interface UpdateInfo {
     /** New version string (e.g. '1.2.0') */
@@ -205,6 +213,15 @@ export interface WorkbenchAppConfig extends WorkbenchConfig {
     onSetup?: (instance: WorkbenchHostInstance) => void | Promise<void>;
     /** Called before window close when a session is active. Session disposal happens automatically after this hook. */
     onBeforeClose?: (instance: WorkbenchHostInstance) => void | Promise<void>;
+    /**
+     * Called before a project is opened, BEFORE any side effect (session
+     * teardown, compile, dev-server). Use to gate the open on login/permission
+     * state. THROW to veto: `openProject` then resolves `{ success: false,
+     * error }`, leaves any currently-active session untouched, and never spins
+     * up the adapter. Resolve normally (or omit) to allow the open. The
+     * declarative alternative to monkey-patching `workspace.openProject`.
+     */
+    onBeforeOpenProject?: (projectPath: string) => void | Promise<void>;
     /** Custom update checker. If provided, enables the check-for-updates feature. */
     updateChecker?: UpdateChecker;
     /** Extra options applied when an updateChecker is provided. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimina-kit/devtools",
-  "version": "0.4.0-dev.20260615083030",
+  "version": "0.4.0-dev.20260616024534",
   "description": "Dimina DevTools - modular developer tools for mini app debugging",
   "keywords": [
     "dimina",
@@ -86,9 +86,9 @@
     "monaco-editor": "^0.55.1",
     "ws": "^8.20.0",
     "zod": "^4.3.6",
-    "@dimina-kit/devkit": "0.1.2-dev.20260615083030",
-    "@dimina-kit/view-anchor": "0.1.0-dev.20260615083030",
-    "@dimina-kit/electron-deck": "0.1.0-dev.20260615083030"
+    "@dimina-kit/devkit": "0.1.2-dev.20260616024534",
+    "@dimina-kit/view-anchor": "0.1.0-dev.20260616024534",
+    "@dimina-kit/electron-deck": "0.1.0-dev.20260616024534"
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",