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

package/dist/main/index.bundle.js

@@ -885,15 +885,13 @@ function createMainWindow(opts) {
     }
   });
   mainWindow.once("ready-to-show", () => {
-    if (process.env.NODE_ENV === "test") {
-      mainWindow.showInactive();
-    } else {
-      if (opts.autoShow !== false) {
-        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);
@@ -2000,6 +1998,8 @@ function createViewManager(ctx) {
   function notifyHostToolbarHeight(height) {
     hostToolbarLastHeight = height;
     ctx.notify.hostToolbarHeightChanged(height);
+    if (settingsViewAdded) applySettingsBounds();
+    if (popoverView) applyPopoverBounds();
   }
   function setHostToolbarHeight(extent) {
     if (hostToolbarHeightMode !== "auto") return;
@@ -2056,15 +2056,18 @@ function createViewManager(ctx) {
       return hostToolbarPort.send(channel, payload);
     }
   };
+  function overlayHeaderHeight() {
+    return HEADER_H + hostToolbarLastHeight;
+  }
   function applySettingsBounds() {
     if (!settingsView || ctx.windows.mainWindow.isDestroyed()) return;
     const [w = 0, h = 0] = ctx.windows.mainWindow.getContentSize();
-    settingsView.setBounds(computeSettingsBounds(w, h, HEADER_H));
+    settingsView.setBounds(computeSettingsBounds(w, h, overlayHeaderHeight()));
   }
   function applyPopoverBounds() {
     if (!popoverView || ctx.windows.mainWindow.isDestroyed()) return;
     const [w = 0, h = 0] = ctx.windows.mainWindow.getContentSize();
-    popoverView.setBounds(computePopoverBounds(w, h, HEADER_H));
+    popoverView.setBounds(computePopoverBounds(w, h, overlayHeaderHeight()));
   }
   function clearNativeDevtoolsRetry() {
     nativeDevtoolsRetryToken++;
@@ -2950,7 +2953,9 @@ function createWorkspaceService(ctx) {
         try {
           await ctx.onBeforeOpenProject(projectPath);
         } catch (err) {
-          return { success: false, error: err instanceof Error ? err.message : String(err) };
+          const error = err instanceof Error ? err.message : String(err);
+          sendStatus("error", error);
+          return { success: false, error };
         }
       }
       clearSimulatorServicewechatReferer();
@@ -9151,9 +9156,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/services/views/view-manager.js

@@ -264,6 +264,10 @@ export function createViewManager(ctx) {
     function notifyHostToolbarHeight(height) {
         hostToolbarLastHeight = height;
         ctx.notify.hostToolbarHeightChanged(height);
+        if (settingsViewAdded)
+            applySettingsBounds();
+        if (popoverView)
+            applyPopoverBounds();
     }
     function setHostToolbarHeight(extent) {
         // While the host pins a fixed height, drop advertiser reports entirely —
@@ -357,17 +361,20 @@ export function createViewManager(ctx) {
             return hostToolbarPort.send(channel, payload);
         },
     };
+    function overlayHeaderHeight() {
+        return HEADER_H + hostToolbarLastHeight;
+    }
     function applySettingsBounds() {
         if (!settingsView || ctx.windows.mainWindow.isDestroyed())
             return;
         const [w = 0, h = 0] = ctx.windows.mainWindow.getContentSize();
-        settingsView.setBounds(layout.computeSettingsBounds(w, h, HEADER_H));
+        settingsView.setBounds(layout.computeSettingsBounds(w, h, overlayHeaderHeight()));
     }
     function applyPopoverBounds() {
         if (!popoverView || ctx.windows.mainWindow.isDestroyed())
             return;
         const [w = 0, h = 0] = ctx.windows.mainWindow.getContentSize();
-        popoverView.setBounds(layout.computePopoverBounds(w, h, HEADER_H));
+        popoverView.setBounds(layout.computePopoverBounds(w, h, overlayHeaderHeight()));
     }
     function clearNativeDevtoolsRetry() {
         nativeDevtoolsRetryToken++;

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

@@ -90,7 +90,15 @@ export function createWorkspaceService(ctx) {
                     await ctx.onBeforeOpenProject(projectPath);
                 }
                 catch (err) {
-                    return { success: false, error: err instanceof Error ? err.message : String(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();

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

@@ -22,21 +22,24 @@ export function createMainWindow(opts) {
         },
     });
     mainWindow.once('ready-to-show', () => {
-        if (process.env.NODE_ENV === 'test') {
-            mainWindow.showInactive();
-        }
-        else {
-            // 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) {
+        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();
-            }
-            // 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);

package/dist/native-host/render/render.js

@@ -364,7 +364,7 @@ var T = new class e {
 	}
 }();
 //#endregion
-//#region ../../node_modules/.pnpm/@vue+shared@3.5.37/node_modules/@vue/shared/dist/shared.esm-bundler.js
+//#region ../../node_modules/.pnpm/@vue+shared@3.5.38/node_modules/@vue/shared/dist/shared.esm-bundler.js
 // @__NO_SIDE_EFFECTS__
 function le(e) {
 	let t = /* @__PURE__ */ Object.create(null);
@@ -459,7 +459,7 @@ function ut(e) {
 	return e == null ? "initial" : typeof e == "string" ? e === "" ? " " : e : ((typeof e != "number" || !Number.isFinite(e)) && process.env.NODE_ENV !== "production" && console.warn("[Vue warn] Invalid value used for CSS binding. Expected a string or a finite number but received:", e), String(e));
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@vue+reactivity@3.5.37/node_modules/@vue/reactivity/dist/reactivity.esm-bundler.js
+//#region ../../node_modules/.pnpm/@vue+reactivity@3.5.38/node_modules/@vue/reactivity/dist/reactivity.esm-bundler.js
 function dt(e, ...t) {
 	console.warn(`[Vue warn] ${e}`, ...t);
 }
@@ -1289,7 +1289,7 @@ function Zn(e, t = Infinity, n) {
 	return e;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@vue+runtime-core@3.5.37/node_modules/@vue/runtime-core/dist/runtime-core.esm-bundler.js
+//#region ../../node_modules/.pnpm/@vue+runtime-core@3.5.38/node_modules/@vue/runtime-core/dist/runtime-core.esm-bundler.js
 var Qn = [];
 function $n(e) {
 	Qn.push(e);
@@ -3959,10 +3959,10 @@ function bc() {
 	}
 	window.devtoolsFormatters ? window.devtoolsFormatters.push(i) : window.devtoolsFormatters = [i];
 }
-var xc = "3.5.37", Sc = process.env.NODE_ENV === "production" ? de : z;
+var xc = "3.5.38", Sc = process.env.NODE_ENV === "production" ? de : z;
 process.env.NODE_ENV, process.env.NODE_ENV;
 //#endregion
-//#region ../../node_modules/.pnpm/@vue+runtime-dom@3.5.37/node_modules/@vue/runtime-dom/dist/runtime-dom.esm-bundler.js
+//#region ../../node_modules/.pnpm/@vue+runtime-dom@3.5.38/node_modules/@vue/runtime-dom/dist/runtime-dom.esm-bundler.js
 var Cc = void 0, wc = typeof window < "u" && window.trustedTypes;
 if (wc) try {
 	Cc = /* @__PURE__ */ wc.createPolicy("vue", { createHTML: (e) => e });
@@ -4313,7 +4313,7 @@ function wl(e) {
 	return process.env.NODE_ENV !== "production" && window.ShadowRoot && e instanceof window.ShadowRoot && e.mode === "closed" && Sc("mounting on a ShadowRoot with `{mode: \"closed\"}` may lead to unpredictable bugs"), e;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/vue@3.5.37_typescript@6.0.3/node_modules/vue/dist/vue.runtime.esm-bundler.js
+//#region ../../node_modules/.pnpm/vue@3.5.38_typescript@6.0.3/node_modules/vue/dist/vue.runtime.esm-bundler.js
 function Tl() {
 	bc();
 }