xpe 1.0.10 → 1.0.12

package/dist/host/xpe-host.js

@@ -10,7 +10,9 @@ export function createHost(options) {
         onHostNavigate: options.onHostNavigate,
         onRouteChange(event) {
             options.onNavigate?.(event);
-            void router.navigate(event.appCode, event.target);
+            void router.navigate(event.appCode, event.target).catch((error) => {
+                options.onError?.(error);
+            });
         },
     });
     const router = createAppPathRouter({

package/dist/kernel/effect.js

@@ -21,13 +21,30 @@ function patchCustomEvent(e, elementGetter) {
 /**
  * 手动触发事件回调
  */
-function manualInvokeElementEvent(element, event) {
+function manualInvokeElementEvent(element, event, sandboxId) {
+    // 动态 link/script 节点由子应用 realm 创建，但被 XPE 转发到宿主
+    // shadowRoot。此时节点上的原生 dispatchEvent 可能无法命中由子应用
+    // Node.prototype.addEventListener 注册的回调。事件代理已经把回调保存在
+    // sandbox 的缓存中，优先从缓存派发，保证 Vite 的 load/error Promise 收敛。
     const customEvent = new CustomEvent(event);
     const patchedEvent = patchCustomEvent(customEvent, () => element);
-    if (isFunction(element[`on${event}`])) {
+    const hasPropertyHandler = isFunction(element[`on${event}`]);
+    if (hasPropertyHandler) {
         element[`on${event}`](patchedEvent);
     }
-    else {
+    const listeners = sandboxId
+        ? getSandboxById(sandboxId)?.elementEventCacheMap.get(element)
+        : undefined;
+    const cachedListeners = listeners?.filter((listener) => listener.type === event) ?? [];
+    if (cachedListeners.length) {
+        cachedListeners.forEach((listener) => {
+            if (typeof listener.callback === "function")
+                listener.callback.call(element, patchedEvent);
+            else
+                listener.callback.handleEvent(patchedEvent);
+        });
+    }
+    else if (!hasPropertyHandler) {
         element.dispatchEvent(patchedEvent);
     }
 }
@@ -235,7 +252,7 @@ export function deferStyleSheetByHref(opts) {
         const target = element;
         finalize();
         if (target)
-            manualInvokeElementEvent(target, "error");
+            manualInvokeElementEvent(target, "error", sandboxId);
     }, DEFER_STYLE_HREF_TIMEOUT);
 }
 function rewriteAppendOrInsertChild(opts) {
@@ -296,12 +313,12 @@ function rewriteAppendOrInsertChild(opts) {
                                 rawDOMAppendOrInsertBefore.call(this, stylesheetElement, refChild);
                                 // 处理样式补丁
                                 handleStylesheetElementPatch(stylesheetElement, latestContext.sandbox);
-                                manualInvokeElementEvent(linkElement, "load");
+                                manualInvokeElementEvent(linkElement, "load", sandboxId);
                             }
                             if (element === linkElement)
                                 element = null;
                         }, () => {
-                            manualInvokeElementEvent(linkElement, "error");
+                            manualInvokeElementEvent(linkElement, "error", sandboxId);
                             if (element === linkElement)
                                 element = null;
                         }));
@@ -346,7 +363,7 @@ function rewriteAppendOrInsertChild(opts) {
                             if (!latestContext)
                                 return warn(XPE_TIPS_REPEAT_RENDER);
                             const onload = () => {
-                                manualInvokeElementEvent(element, "load");
+                                manualInvokeElementEvent(element, "load", sandboxId);
                                 element = null;
                             };
                             insertScriptToIframe({ ...scriptResult, onload }, latestContext.iframeWindow, element);
@@ -373,7 +390,7 @@ function rewriteAppendOrInsertChild(opts) {
                                 if (!execQueueLength)
                                     sandbox.execQueue.shift()();
                             }, () => {
-                                manualInvokeElementEvent(element, "error");
+                                manualInvokeElementEvent(element, "error", sandboxId);
                                 element = null;
                             }));
                         });

package/dist/kernel/entry.js

@@ -191,8 +191,7 @@ export default function importHTML(params) {
             .then((response) => {
             if (response.status >= 400) {
                 error(XPE_TIPS_HTML_ERROR_REQUESTED, { url, response });
-                loadError?.(url, new Error(XPE_TIPS_HTML_ERROR_REQUESTED));
-                return "";
+                throw new Error(XPE_TIPS_HTML_ERROR_REQUESTED);
             }
             return response.text();
         })

package/dist/kernel/index.js

@@ -27,10 +27,10 @@ function loadRuntimeEngine() {
     if (runtimeEngineModule)
         return Promise.resolve(runtimeEngineModule);
     if (!runtimeEngineModulePromise) {
-        // Keep a literal dynamic import so Vite/Rollup bundles the runtime engine
-        // into a deployable child chunk instead of leaving a missing relative URL
-        // in the host's optimized dependency directory.
-        // @ts-expect-error Vite/Rollup resolves the query-suffixed runtime chunk at build time.
+        // 保持字面量动态 import：Vite/Rollup 等消费方只有在构建期看见静态 specifier，
+        // 才会把懒加载内核生成成可部署 chunk。通过变量 import 会在 npm 消费方产物中
+        // 留下 ./runtime-engine.js，并错误解析到 Host 自己的 /assets 目录。
+        // @ts-expect-error Vite/Rollup 会解析查询参数并生成独立 chunk，TypeScript 不解析该运行时 specifier。
         runtimeEngineModulePromise = import("./runtime-engine.js?xpe-runtime").then((module) => {
             runtimeEngineModule = module;
             return runtimeEngineModule;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xpe",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "下一代微前端应用运行底座",
   "type": "module",
   "license": "MIT",
@@ -46,11 +46,12 @@
     "check:example-build": "pnpm run typecheck:browser-smoke && pnpm run build:example",
     "check:host-child-smoke": "node scripts/check-host-child-smoke.mjs",
     "check:dist-surface": "node scripts/check-dist-surface.mjs",
+    "check:vite-consumer-build": "node scripts/check-vite-consumer-build.mjs",
     "check:kernel-surface": "node scripts/check-kernel-surface.mjs",
     "check:pack": "pnpm pack --dry-run",
     "check:public-surface": "node scripts/check-public-surface.mjs",
     "check:release-metadata": "node scripts/check-release-metadata.mjs",
-    "verify": "pnpm run check:release-metadata && pnpm run typecheck && pnpm test && pnpm run build && pnpm run check:pack",
+    "verify": "pnpm run check:release-metadata && pnpm run typecheck && pnpm test && pnpm run build && pnpm run check:vite-consumer-build && pnpm run check:pack",
     "prepack": "pnpm run build",
     "prepublishOnly": "pnpm run verify",
     "test": "vitest run",