@dimina-kit/devtools 0.4.0-dev.20260630070008 → 0.4.0-dev.20260630094624

package/dist/main/index.bundle.js

@@ -4731,6 +4731,9 @@ function buildServiceHostSpawnUrl(opts) {
   if (opts.hostEnvSnapshot) {
     url.searchParams.set("hostEnv", encodeURIComponent(JSON.stringify(opts.hostEnvSnapshot)));
   }
+  if (opts.apiNamespaces && opts.apiNamespaces.length > 0) {
+    url.searchParams.set("apiNamespaces", opts.apiNamespaces.join(","));
+  }
   return url.toString();
 }
 function navigateServiceHost(win, url) {
@@ -5984,6 +5987,7 @@ async function handleSpawn(state, ctx, event, opts) {
   const workspaceProjectPath = typeof ctx.workspace.getProjectPath === "function" ? ctx.workspace.getProjectPath() : "";
   const pkgRoot = path16.resolve(opts.pkgRoot || workspaceProjectPath || process.cwd());
   const root = opts.root || "main";
+  const apiNamespaces = ctx.apiNamespaces ?? [];
   let resourceServer = null;
   let resourceBaseUrl;
   if (opts.resourceBaseUrl) {
@@ -6025,7 +6029,8 @@ async function handleSpawn(state, ctx, event, opts) {
       pkgRoot,
       root,
       resourceBaseUrl,
-      hostEnvSnapshot: hostEnv
+      hostEnvSnapshot: hostEnv,
+      apiNamespaces
     });
   }
   const appSession = {
@@ -6038,6 +6043,7 @@ async function handleSpawn(state, ctx, event, opts) {
     serviceWc: serviceWindow.webContents,
     simulatorWc,
     serviceLoaded: false,
+    logicInjected: null,
     resourceBaseUrl,
     resourceServer,
     hostEnv,
@@ -6059,6 +6065,7 @@ async function handleSpawn(state, ctx, event, opts) {
     renderWc: null,
     renderLoaded: false,
     resourceLoadedSent: false,
+    renderLoadPending: false,
     windowConfig: rootWindowConfig
   };
   state.appSessions.set(appSessionId, appSession);
@@ -6093,7 +6100,7 @@ async function handleSpawn(state, ctx, event, opts) {
       }
       if (!serviceWindow.webContents.getURL().includes("service.html")) return;
       serviceWindow.webContents.removeListener("did-finish-load", bootOnServiceLoad);
-      void bootServiceHost(state, appSession);
+      void bootServiceHost(state, appSession, ctx);
     };
     appSession.onServiceBoot = bootOnServiceLoad;
     serviceWindow.webContents.on("did-finish-load", bootOnServiceLoad);
@@ -6106,12 +6113,13 @@ async function handleSpawn(state, ctx, event, opts) {
         pkgRoot,
         root,
         resourceBaseUrl,
-        hostEnvSnapshot: hostEnv
+        hostEnvSnapshot: hostEnv,
+        apiNamespaces
       })
     );
   } else {
     serviceWindow.webContents.once("did-finish-load", () => {
-      void bootServiceHost(state, appSession);
+      void bootServiceHost(state, appSession, ctx);
     });
   }
   return {
@@ -6145,6 +6153,7 @@ async function handlePageOpen(state, event, opts) {
     renderWc: null,
     renderLoaded: false,
     resourceLoadedSent: false,
+    renderLoadPending: false,
     windowConfig
   };
   state.pageSessions.set(bridgeId, page);
@@ -6191,23 +6200,49 @@ function handleNavCallback(state, sender, payload) {
   }
   sendCallback(ap, payload.callbacks.complete, result);
 }
-async function bootServiceHost(state, ap) {
+async function bootServiceHost(state, ap, ctx) {
   if (state.appSessions.get(ap.appSessionId) !== ap) return;
-  await injectLogicBundle(ap);
+  ap.logicInjected = await injectLogicBundle(ap);
+  if (!ap.logicInjected) {
+    reportLogicLoadFailure(ap, ctx);
+    return;
+  }
   forwardToService(ap, makeLoadResource(ap, ap.pages.get(ap.appSessionId), "service"));
+  for (const page of ap.pages.values()) {
+    if (page.renderLoadPending) {
+      page.renderLoadPending = false;
+      sendRenderLoadResource(ap, page);
+    }
+  }
+}
+function sendRenderLoadResource(ap, page) {
+  if (page.renderWc && !page.renderWc.isDestroyed()) {
+    page.renderWc.send(BRIDGE_CHANNELS.TO_RENDER, { msg: makeLoadResource(ap, page, "render") });
+  }
+}
+function logicBundleUrl(ap) {
+  return ap.resourceServer ? new URL("logic.js", ap.resourceBaseUrl).toString() : new URL(`${ap.appId}/${ap.root}/logic.js`, ap.resourceBaseUrl).toString();
 }
 async function injectLogicBundle(ap) {
-  const logicUrl = ap.resourceServer ? new URL("logic.js", ap.resourceBaseUrl).toString() : new URL(`${ap.appId}/${ap.root}/logic.js`, ap.resourceBaseUrl).toString();
+  const logicUrl = logicBundleUrl(ap);
   try {
     const res = await fetch(logicUrl);
     if (!res.ok) throw new Error(`logic.js fetch ${res.status} at ${logicUrl}`);
     const logicContent = rewriteSourceMappingUrl(await res.text(), logicUrl);
     await ap.serviceWc.executeJavaScript(`${logicContent}
 //# sourceURL=${logicUrl}`, true);
+    return true;
   } catch (error) {
     console.warn("[bridge-router] unable to inject service logic.js:", error);
+    return false;
   }
 }
+function reportLogicLoadFailure(ap, ctx) {
+  const hint = ap.appId === "unknown" ? ' appId could not be resolved (it fell back to "unknown") \u2014 the mini-program likely failed to compile or its project manifest/app config is missing.' : "";
+  const message = `[dimina-kit] Failed to load the mini-program logic bundle from ${logicBundleUrl(ap)}. The service runtime has no registered modules, so no page can mount.` + hint + ` Verify the project compiled successfully and that the resource server serves "${ap.appId}/${ap.root}/".`;
+  console.error(message);
+  ctx.guestConsole?.emit({ source: "service", level: "error", args: [message] });
+}
 function maybeSendResourceLoaded(ap, page) {
   if (page.resourceLoadedSent || !ap.serviceLoaded || !page.renderLoaded) return;
   page.resourceLoadedSent = true;
@@ -6242,9 +6277,12 @@ function routeFromService(state, ap, defaultPage, msg, ctx) {
 }
 function routeFromRender(state, ap, page, msg, ctx) {
   if (msg.type === "renderHostReady") {
-    if (page.renderWc && !page.renderWc.isDestroyed()) {
-      page.renderWc.send(BRIDGE_CHANNELS.TO_RENDER, { msg: makeLoadResource(ap, page, "render") });
+    if (ap.logicInjected === false) return;
+    if (ap.logicInjected === null) {
+      page.renderLoadPending = true;
+      return;
     }
+    sendRenderLoadResource(ap, page);
     return;
   }
   if (msg.type === "renderResourceLoaded") {

package/dist/main/ipc/bridge-router.js

@@ -490,6 +490,11 @@ async function handleSpawn(state, ctx, event, opts) {
         : '';
     const pkgRoot = path.resolve(opts.pkgRoot || workspaceProjectPath || process.cwd());
     const root = opts.root || 'main';
+    // Host-config custom API namespaces (WorkbenchContext is the single owner).
+    // Threaded into the service-host spawn URL so its preload can install the
+    // namespace globals; the simulator-supplied `opts.apiNamespaces` is derived
+    // from the same host config and is not authoritative here.
+    const apiNamespaces = ctx.apiNamespaces ?? [];
     // Resource base resolution. Preferred: the simulator-supplied dev-server
     // origin, which statically serves the compiled `<appId>/<root>/…` tree (same
     // source the default dimina-fe `<webview>` reads). Fallback (no dev server —
@@ -550,6 +555,7 @@ async function handleSpawn(state, ctx, event, opts) {
             root,
             resourceBaseUrl,
             hostEnvSnapshot: hostEnv,
+            apiNamespaces,
         });
     }
     const appSession = {
@@ -562,6 +568,7 @@ async function handleSpawn(state, ctx, event, opts) {
         serviceWc: serviceWindow.webContents,
         simulatorWc,
         serviceLoaded: false,
+        logicInjected: null,
         resourceBaseUrl,
         resourceServer,
         hostEnv,
@@ -583,6 +590,7 @@ async function handleSpawn(state, ctx, event, opts) {
         renderWc: null,
         renderLoaded: false,
         resourceLoadedSent: false,
+        renderLoadPending: false,
         windowConfig: rootWindowConfig,
     };
     state.appSessions.set(appSessionId, appSession);
@@ -653,7 +661,7 @@ async function handleSpawn(state, ctx, event, opts) {
             if (!serviceWindow.webContents.getURL().includes('service.html'))
                 return;
             serviceWindow.webContents.removeListener('did-finish-load', bootOnServiceLoad);
-            void bootServiceHost(state, appSession);
+            void bootServiceHost(state, appSession, ctx);
         };
         appSession.onServiceBoot = bootOnServiceLoad;
         serviceWindow.webContents.on('did-finish-load', bootOnServiceLoad);
@@ -665,13 +673,14 @@ async function handleSpawn(state, ctx, event, opts) {
             root,
             resourceBaseUrl,
             hostEnvSnapshot: hostEnv,
+            apiNamespaces,
         }));
     }
     else {
         // Fresh window: its only navigation is service.html (issued inside
         // createServiceHostWindow), so the first did-finish-load is the spawn load.
         serviceWindow.webContents.once('did-finish-load', () => {
-            void bootServiceHost(state, appSession);
+            void bootServiceHost(state, appSession, ctx);
         });
     }
     return {
@@ -707,6 +716,7 @@ async function handlePageOpen(state, event, opts) {
         renderWc: null,
         renderLoaded: false,
         resourceLoadedSent: false,
+        renderLoadPending: false,
         windowConfig,
     };
     state.pageSessions.set(bridgeId, page);
@@ -761,26 +771,53 @@ function handleNavCallback(state, sender, payload) {
     sendCallback(ap, payload.callbacks.complete, result);
 }
 // ── Service-host boot & per-page resource handshake ──────────────────────────
-async function bootServiceHost(state, ap) {
+async function bootServiceHost(state, ap, ctx) {
     // Liveness guard: never boot a session that was already disposed. With pooling,
     // the service window is recycled, so a stale did-finish-load listener from an
     // early-disposed prior owner could otherwise fire here and inject the wrong
     // app's logic.js into the next spawn (the recycled webContents is shared).
     if (state.appSessions.get(ap.appSessionId) !== ap)
         return;
-    await injectLogicBundle(ap);
+    ap.logicInjected = await injectLogicBundle(ap);
+    if (!ap.logicInjected) {
+        // The compiled logic.js never executed, so `modDefine` registered nothing.
+        // Sending `loadResource` now would run `modRequire('app')` against an empty
+        // registry and throw the cryptic `module app not found` — masking the real
+        // cause (unreachable resource tree / failed compile / unresolved appId).
+        // Skip it and surface one actionable diagnostic instead; the render side
+        // gates on the same flag in `routeFromRender`.
+        reportLogicLoadFailure(ap, ctx);
+        return;
+    }
     // serviceLoaded is flipped only when service responds with
     // `serviceResourceLoaded`; see handleContainerMsg. Setting it here would
     // race a per-page `resourceLoaded` ahead of the service-side handler.
     forwardToService(ap, makeLoadResource(ap, ap.pages.get(ap.appSessionId), 'service'));
+    // Flush any render `loadResource` that arrived (renderHostReady) while
+    // injection was in-flight — now that the bundle is confirmed present.
+    for (const page of ap.pages.values()) {
+        if (page.renderLoadPending) {
+            page.renderLoadPending = false;
+            sendRenderLoadResource(ap, page);
+        }
+    }
+}
+function sendRenderLoadResource(ap, page) {
+    if (page.renderWc && !page.renderWc.isDestroyed()) {
+        page.renderWc.send(C.TO_RENDER, { msg: makeLoadResource(ap, page, 'render') });
+    }
+}
+/** The compiled logic.js URL `injectLogicBundle` fetches (mode-dependent). */
+function logicBundleUrl(ap) {
+    return ap.resourceServer
+        ? new URL('logic.js', ap.resourceBaseUrl).toString()
+        : new URL(`${ap.appId}/${ap.root}/logic.js`, ap.resourceBaseUrl).toString();
 }
 async function injectLogicBundle(ap) {
     // Fetch the compiled service logic over HTTP from the same base the render
     // host reads (`<base><appId>/<root>/logic.js`). The fallback local server
     // serves its root, so `<base>logic.js` resolves there too — both are http.
-    const logicUrl = ap.resourceServer
-        ? new URL('logic.js', ap.resourceBaseUrl).toString()
-        : new URL(`${ap.appId}/${ap.root}/logic.js`, ap.resourceBaseUrl).toString();
+    const logicUrl = logicBundleUrl(ap);
     try {
         const res = await fetch(logicUrl);
         if (!res.ok)
@@ -790,11 +827,31 @@ async function injectLogicBundle(ap) {
         // relative map would 404 and break sourcemapped console frames / Sources.
         const logicContent = rewriteSourceMappingUrl(await res.text(), logicUrl);
         await ap.serviceWc.executeJavaScript(`${logicContent}\n//# sourceURL=${logicUrl}`, true);
+        return true;
     }
     catch (error) {
         console.warn('[bridge-router] unable to inject service logic.js:', error);
+        return false;
     }
 }
+/**
+ * Emit one actionable diagnostic when the compiled logic bundle could not be
+ * loaded — the single point where "the app's compiled resource tree is
+ * unreachable" is known with certainty. Goes to the main-process log AND the
+ * guest console sink so it surfaces in the devtools Console panel where the
+ * developer would otherwise see only the misleading `module app not found`.
+ */
+function reportLogicLoadFailure(ap, ctx) {
+    const hint = ap.appId === 'unknown'
+        ? ' appId could not be resolved (it fell back to "unknown") — the mini-program likely failed to compile or its project manifest/app config is missing.'
+        : '';
+    const message = `[dimina-kit] Failed to load the mini-program logic bundle from ${logicBundleUrl(ap)}. `
+        + 'The service runtime has no registered modules, so no page can mount.'
+        + hint
+        + ` Verify the project compiled successfully and that the resource server serves "${ap.appId}/${ap.root}/".`;
+    console.error(message);
+    ctx.guestConsole?.emit({ source: 'service', level: 'error', args: [message] });
+}
 function maybeSendResourceLoaded(ap, page) {
     if (page.resourceLoadedSent || !ap.serviceLoaded || !page.renderLoaded)
         return;
@@ -842,9 +899,21 @@ function routeFromService(state, ap, defaultPage, msg, ctx) {
 }
 function routeFromRender(state, ap, page, msg, ctx) {
     if (msg.type === 'renderHostReady') {
-        if (page.renderWc && !page.renderWc.isDestroyed()) {
-            page.renderWc.send(C.TO_RENDER, { msg: makeLoadResource(ap, page, 'render') });
+        // Logic injection definitively failed: the render bundle shares the same
+        // (unreachable) resource tree, so `loadResource` here would only produce a
+        // second cryptic `module <pagePath> not found`. bootServiceHost already
+        // surfaced the actionable diagnostic — stay silent.
+        if (ap.logicInjected === false)
+            return;
+        // Injection still in-flight: the render guest fires `renderHostReady` on its
+        // own DOMContentLoaded, which routinely beats the async fetch+inject. Hold
+        // the render `loadResource` and let `bootServiceHost` flush it once the
+        // bundle settles, so a failed bundle never reaches the render side.
+        if (ap.logicInjected === null) {
+            page.renderLoadPending = true;
+            return;
         }
+        sendRenderLoadResource(ap, page);
         return;
     }
     if (msg.type === 'renderResourceLoaded') {

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

@@ -21,6 +21,13 @@ export interface ServiceHostWindowOptions {
     root?: string;
     resourceBaseUrl: string;
     hostEnvSnapshot?: Record<string, unknown>;
+    /**
+     * Custom API namespace names (host config `apiNamespaces`, e.g. `['qd']`).
+     * Encoded into the spawn URL so the service-host preload can install them as
+     * `globalThis.__diminaApiNamespaces` before service.js evaluates — without
+     * which page logic referencing `qd.*` throws `ReferenceError: qd is not defined`.
+     */
+    apiNamespaces?: string[];
 }
 /**
  * Construct an (un-navigated) service-host BrowserWindow. Split out from

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

@@ -60,6 +60,11 @@ export function buildServiceHostSpawnUrl(opts) {
         // Without this, sync-impls/system-info.ts falls back to generic defaults.
         url.searchParams.set('hostEnv', encodeURIComponent(JSON.stringify(opts.hostEnvSnapshot)));
     }
+    if (opts.apiNamespaces && opts.apiNamespaces.length > 0) {
+        // CSV of namespace names; the preload reads this back into
+        // `globalThis.__diminaApiNamespaces`. URLSearchParams round-trips the comma.
+        url.searchParams.set('apiNamespaces', opts.apiNamespaces.join(','));
+    }
     return url.toString();
 }
 /**

package/dist/service-host/preload.cjs

@@ -49,6 +49,17 @@ Object.defineProperty(globalThis, '__diminaSpawnContext', {
   configurable: false,
 })
 
+// Custom API namespace globals. service.js installs `globalThis[ns]` proxies for
+// `['dd','wx',...apiNamespaces]`, reading the host-configured namespaces from
+// `globalThis.__diminaApiNamespaces` first. Set it here (before service.js
+// evaluates) from the spawn URL's CSV param so page logic referencing e.g.
+// `qd.*` resolves instead of throwing `ReferenceError: qd is not defined`.
+// Absent/empty param → `[]`, leaving only the built-in `dd`/`wx`.
+const apiNamespacesRaw = params.get('apiNamespaces')
+globalThis.__diminaApiNamespaces = apiNamespacesRaw
+  ? apiNamespacesRaw.split(',').map((name) => name.trim()).filter(Boolean)
+  : []
+
 // Live host-env updates (native-host device dropdown). The binding above is
 // non-configurable, but the inner object's properties are writable — merge the
 // pushed metrics into `hostEnvSnapshot` in place. `sync-impls/system-info.ts`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dimina-kit/devtools",
-  "version": "0.4.0-dev.20260630070008",
+  "version": "0.4.0-dev.20260630094624",
   "description": "Dimina DevTools - modular developer tools for mini app debugging",
   "keywords": [
     "dimina",
@@ -85,9 +85,9 @@
     "chrome-remote-interface": "^0.34.0",
     "ws": "^8.20.0",
     "zod": "^4.3.6",
-    "@dimina-kit/devkit": "0.1.2-dev.20260630070008",
-    "@dimina-kit/electron-deck": "0.1.0-dev.20260630070008",
-    "@dimina-kit/view-anchor": "0.1.0-dev.20260630070008"
+    "@dimina-kit/devkit": "0.1.2-dev.20260630094624",
+    "@dimina-kit/electron-deck": "0.1.0-dev.20260630094624",
+    "@dimina-kit/view-anchor": "0.1.0-dev.20260630094624"
   },
   "devDependencies": {
     "@playwright/test": "^1.59.1",