@fulgurjs/federation 5.9.3 → 6.1.0

package/dist/bridge-host-vue.cjs

@@ -97,7 +97,7 @@ function invalidBridgeContractError(spec, mod) {
     `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u6A21\u5757 "${spec}" \u7684\u9ED8\u8BA4\u5BFC\u51FA\u4E0D\u662F\u5408\u6CD5\u7684\u6865\u63A5\u5951\u7EA6\uFF08BridgeApp\uFF09\u3002
   \u6839\u56E0: \u5BFC\u51FA\u503C\u4E3A ${actual}` + (missing.length ? `\uFF0C\u7F3A\u5C11\u51FD\u6570\u7C7B\u578B\u7684 ${missing.map((m) => `"${m}"`).join(" / ")} \u5BFC\u51FA\u3002` : "\u3002") + `
   \u4FEE\u6CD5: \u8FDC\u7A0B\u4FA7\u7528 defineBridgeApp(...) \u521B\u5EFA\u5951\u7EA6\u5E76\u4F5C\u4E3A\u6A21\u5757\u9ED8\u8BA4\u5BFC\u51FA\u2014\u2014
-        Vue \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/runtime'\uFF1B
+        Vue \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/vue'\uFF1B
         React \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/react'\u3002
         \u5951\u7EA6\u5FC5\u987B\u5305\u542B mount(el, props?) \u4E0E unmount(el) \u4E24\u4E2A\u51FD\u6570\u3002`,
     { spec, missing, actual }

package/dist/bridge-host-vue.js

@@ -1,7 +1,7 @@
 import {
   RoutingChannel,
   assertBridgeRoutingProtocol
-} from "./chunk-YKIFZIBH.js";
+} from "./chunk-77JZ6U6V.js";
 import {
   acquireBridgeSession,
   assertBridgeContract,
@@ -10,10 +10,10 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-Q6V5O5Y6.js";
+} from "./chunk-ENT3BOTX.js";
 import {
   bridgeHostError
-} from "./chunk-WRJG2YG6.js";
+} from "./chunk-ZAYNS7YQ.js";
 import {
   provideAppContext
 } from "./chunk-TSYLDY6H.js";

package/dist/bridge-router-react.d.ts

@@ -1,5 +1,5 @@
 import { ReactElement } from 'react';
-import { RouteObject } from 'react-router-dom';
+import { createMemoryRouter, RouterProvider, RouteObject } from 'react-router-dom';
 
 /** 统一逻辑位置：pathname 以 / 开头；search 空串或 ? 开头；hash 空串或 # 开头 */
 interface BridgeLocation {
@@ -43,7 +43,7 @@ interface BridgeHostRouting {
     navigation: BridgeHostNavigation;
 }
 
-/** React Router data router 的宿主端口与子应用 memory router 接线（按需入口）。 */
+/** React Router data router 的宿主导航端口与子应用 memory router 接线（统一入口 /react 提供）。 */
 
 type ReactBridgeCancelPolicy = (next: BridgeLocation) => boolean;
 interface ReactDataRouterLike {
@@ -68,6 +68,12 @@ interface ReactDataRouterLike {
         replace?: boolean;
     }): void | Promise<void>;
 }
+type ReactRouterModule = {
+    createMemoryRouter: typeof createMemoryRouter;
+    RouterProvider: typeof RouterProvider;
+};
+/** 内部时序缝隙：等待模块级预热落定（仅测试使用；生产代码不需要等待——未就绪时走惰性宿主） */
+declare const __reactRouterDomReady: Promise<void>;
 /** canNavigate 是可选预判；最终结果同时核对真实 blocker 与已提交位置。 */
 declare function createReactBridgeNavigation(router: ReactDataRouterLike, options?: {
     canNavigate?: ReactBridgeCancelPolicy;
@@ -76,10 +82,23 @@ declare function createReactBridgeNavigation(router: ReactDataRouterLike, option
 interface ReactBridgeRouterConnection {
     element: ReactElement;
     dispose(): void;
+    /**
+     * 已接线 memory router 的就绪合同（可加性导出）：
+     * fast 路径（预热已就绪）= 同步已 resolve 的 Promise（element.props.router 等价）；
+     * slow 路径（预热未落定/缺依赖）= 惰性宿主接线完成时 resolve（缺依赖时 reject 清晰错误）。
+     * 宿主内省请优先用它，不要假设 element.props.router 同步存在。
+     */
+    routerReady: Promise<WiredRouter['router']>;
+}
+/** 已接线的 memory router（fast 路径同步产出；slow 路径由惰性宿主补挂） */
+interface WiredRouter {
+    router: ReturnType<ReactRouterModule['createMemoryRouter']>;
+    RouterProvider: ReactRouterModule['RouterProvider'];
+    dispose(): void;
 }
 /** 返回 RouterProvider 元素，直接作为 defineBridgeApp 工厂的 ReactElement 返回值。 */
 declare function createReactBridgeRouter(routing: BridgeChildRoute, routes: RouteObject[], options?: {
     signal?: AbortSignal;
 }): ReactBridgeRouterConnection;
 
-export { type BridgeHostRouting, type ReactBridgeCancelPolicy, type ReactBridgeRouterConnection, type ReactDataRouterLike, createReactBridgeNavigation, createReactBridgeRouter };
+export { type BridgeHostRouting, type ReactBridgeCancelPolicy, type ReactBridgeRouterConnection, type ReactDataRouterLike, __reactRouterDomReady, createReactBridgeNavigation, createReactBridgeRouter };

package/dist/bridge-router-react.js

@@ -1,6 +1,5 @@
 // src/bridge-router-react.tsx
-import { createElement } from "react";
-import { RouterProvider, createMemoryRouter } from "react-router-dom";
+import { createElement, useEffect, useState } from "react";
 
 // src/runtime/errors.ts
 var FgError = class extends Error {
@@ -118,6 +117,24 @@ function connectChildNavigation(routing, apply, onError) {
 }
 
 // src/bridge-router-react.tsx
+var routerDomModule = null;
+var routerDomFailure = null;
+var routerDomReady = import("react-router-dom").then(
+  (m) => {
+    const candidate = m;
+    if (candidate && typeof candidate.createMemoryRouter === "function" && typeof candidate.RouterProvider === "function") {
+      routerDomModule = candidate;
+    } else {
+      routerDomFailure = new Error(
+        "[fulgurjs] react-router-dom \u672A\u5B89\u88C5\u6216\u4E0D\u53EF\u7528\uFF08createMemoryRouter/RouterProvider \u7F3A\u5931\uFF09\u3002createReactBridgeRouter\uFF08URL \u540C\u6B65\u53D7\u63A7\u8DEF\u7531\uFF09\u9700\u8981 react-router-dom \u22656.11\uFF1B\u4E0D\u4F7F\u7528\u8DEF\u7531\u540C\u6B65\u7684\u7EAF React \u7EC4\u4EF6\u5DE5\u7A0B\u65E0\u9700\u5B89\u88C5\u3002"
+      );
+    }
+  },
+  (e) => {
+    routerDomFailure = e;
+  }
+);
+var __reactRouterDomReady = routerDomReady;
 function createReactBridgeNavigation(router, options = {}) {
   const base = options.basename && options.basename !== "/" ? options.basename.replace(/\/$/, "") : "";
   const toLogic = () => {
@@ -205,15 +222,16 @@ function createReactBridgeNavigation(router, options = {}) {
     }
   };
 }
-function createReactBridgeRouter(routing, routes, options = {}) {
+function wireReactBridgeRouter(m, routing, routes, options) {
   const init = routing.getLocation();
-  const router = createMemoryRouter(routes, { initialEntries: [init.pathname + init.search + init.hash] });
+  const router = m.createMemoryRouter(routes, { initialEntries: [init.pathname + init.search + init.hash] });
   const navigate = router.navigate.bind(router);
   let disposed = false;
+  const report = collapseConsecutiveReports((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error));
   const sync = connectChildNavigation(routing, async (loc) => {
     const cur = router.state.location;
     if (!sameLocation(cur, loc)) await navigate(loc.pathname + loc.search + loc.hash, { replace: true });
-  }, collapseConsecutiveReports((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error)));
+  }, report);
   router.navigate = ((to, options2) => {
     if (typeof to === "number") {
       if (!disposed) routing.go(to);
@@ -225,7 +243,7 @@ function createReactBridgeRouter(routing, routes, options = {}) {
       return { pathname: l.pathname, search: l.search, hash: l.hash };
     }, options2?.replace ? "replace" : "push").then(() => {
     });
-    void task.catch(collapseConsecutiveReports((error) => console.error("[fulgurjs] \u5B50\u5E94\u7528 React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error)));
+    void task.catch(report);
     return task;
   });
   let unwatch = () => {
@@ -236,22 +254,102 @@ function createReactBridgeRouter(routing, routes, options = {}) {
     const actual = router.state.location;
     if (!sameLocation(actual, init)) void sync.enqueue(async () => actual, "replace").catch((error) => console.error("[fulgurjs] \u521D\u59CB React \u8DEF\u7531\u540C\u6B65\u5931\u8D25\uFF1A", error));
   });
-  const connection = {
-    element: createElement(RouterProvider, { router }),
+  const wired = {
+    router,
+    RouterProvider: m.RouterProvider,
     dispose() {
       if (disposed) return;
-      options.signal?.removeEventListener("abort", connection.dispose);
       disposed = true;
+      options.signal?.removeEventListener("abort", disposeWired);
       unwatch();
       sync.dispose();
       router.dispose();
     }
   };
+  const disposeWired = () => wired.dispose();
+  options.signal?.addEventListener("abort", disposeWired, { once: true });
+  if (options.signal?.aborted) wired.dispose();
+  return wired;
+}
+function LazyRouterProviderHost(props) {
+  const [wired, setWired] = useState(null);
+  const [failure, setFailure] = useState(routerDomFailure);
+  useEffect(() => {
+    if (wired || failure !== null) return;
+    let alive = true;
+    void routerDomReady.then(
+      () => {
+        if (!alive) return;
+        if (routerDomFailure) {
+          setFailure(routerDomFailure);
+          return;
+        }
+        if (!routerDomModule || props.isDisposed()) return;
+        const w = wireReactBridgeRouter(routerDomModule, props.routing, props.routes, { signal: props.signal });
+        props.onWired(w);
+        setWired(w);
+      },
+      (e) => {
+        if (alive) setFailure(e);
+      }
+    );
+    return () => {
+      alive = false;
+    };
+  }, [wired, failure, props]);
+  if (failure !== null) {
+    throw failure instanceof Error ? failure : new Error(String(failure));
+  }
+  return wired ? createElement(wired.RouterProvider, { router: wired.router }) : null;
+}
+function createReactBridgeRouter(routing, routes, options = {}) {
+  let disposed = false;
+  let wired = null;
+  const dispose = () => {
+    if (disposed) return;
+    disposed = true;
+    wired?.dispose();
+  };
+  if (routerDomModule) {
+    wired = wireReactBridgeRouter(routerDomModule, routing, routes, options);
+    const fastRouter = wired.router;
+    const connection2 = {
+      element: createElement(wired.RouterProvider, { router: wired.router }),
+      dispose,
+      routerReady: Promise.resolve(fastRouter)
+    };
+    options.signal?.addEventListener("abort", connection2.dispose, { once: true });
+    if (options.signal?.aborted) connection2.dispose();
+    return connection2;
+  }
+  let wireResolve = () => {
+  };
+  const routerReady = new Promise((resolve, reject) => {
+    wireResolve = resolve;
+    void routerDomReady.then(() => {
+      if (routerDomFailure && !routerDomModule) reject(routerDomFailure);
+    }, (e) => reject(e));
+  });
+  const connection = {
+    element: createElement(LazyRouterProviderHost, {
+      routing,
+      routes,
+      signal: options.signal,
+      isDisposed: () => disposed,
+      onWired: (w) => {
+        wired = w;
+        wireResolve(w.router);
+      }
+    }),
+    dispose,
+    routerReady
+  };
   options.signal?.addEventListener("abort", connection.dispose, { once: true });
   if (options.signal?.aborted) connection.dispose();
   return connection;
 }
 export {
+  __reactRouterDomReady,
   createReactBridgeNavigation,
   createReactBridgeRouter
 };

package/dist/bridge-router-vue.d.ts

@@ -1,5 +1,3 @@
-import { Router } from 'vue-router';
-
 /** 统一逻辑位置：pathname 以 / 开头；search 空串或 ? 开头；hash 空串或 # 开头 */
 interface BridgeLocation {
     pathname: string;
@@ -41,21 +39,42 @@ interface BridgeHostRouting {
     basePath: string;
     navigation: BridgeHostNavigation;
 }
+/**
+ * vue-router 实例的最小结构面（/vue 路由同步端口参数；真实 vue-router Router 结构兼容可赋值）。
+ * 6.0.0 可选依赖边界：/vue 的 d.ts 不得 import vue-router 类型——未安装 vue-router 的
+ * 纯组件工程在 skipLibCheck:false 下也必须能通过类型检查；结构类型的宽化只影响
+ * 路由同步端口处的精确提示，业务代码自己的 Router 类型不受影响。
+ */
+interface VueRouterLike {
+    currentRoute: {
+        value: {
+            fullPath: string;
+        };
+    };
+    push(to: string): Promise<unknown>;
+    replace(to: string): Promise<unknown>;
+    go(delta: number): void;
+    back(): void;
+    forward(): void;
+    afterEach(handler: (to: unknown, from: unknown, failure?: unknown) => void): () => void;
+    beforeResolve(handler: () => unknown): () => void;
+    beforeEach(handler: () => unknown): () => void;
+}
 
-/** Vue Router 4/5 的宿主导航端口与子应用 memory router 接线（按需入口）。 */
+/** Vue Router 4/5 的宿主导航端口与子应用 memory router 接线（统一入口 /vue 提供）。 */
 
 interface VueBridgeNavigationOptions {
     /** 保留配置兼容；Vue Router fullPath 已剥离 history base，不再二次剥离。 */
     routerBase?: string;
 }
-declare function createVueBridgeNavigation(router: Router, _options?: VueBridgeNavigationOptions): BridgeHostNavigation;
+declare function createVueBridgeNavigation(router: VueRouterLike, _options?: VueBridgeNavigationOptions): BridgeHostNavigation;
 interface VueBridgeRouterConnection {
     /** 必须 await ready 后再 app.use(router)，初始错误会拒绝此 Promise。 */
     ready: Promise<void>;
     dispose(): void;
 }
 /** 接线限子应用自己的 memory router；dispose 恢复原始导航方法。 */
-declare function connectVueBridgeRouter(routing: BridgeChildRoute, router: Router, options?: {
+declare function connectVueBridgeRouter(routing: BridgeChildRoute, router: VueRouterLike, options?: {
     signal?: AbortSignal;
 }): VueBridgeRouterConnection;
 

package/dist/bridge-router-vue.js

@@ -1,6 +1,3 @@
-// src/bridge-router-vue.ts
-import { isNavigationFailure, NavigationFailureType } from "vue-router";
-
 // src/runtime/errors.ts
 var FgError = class extends Error {
   code;
@@ -117,6 +114,8 @@ function connectChildNavigation(routing, apply, onError) {
 }
 
 // src/bridge-router-vue.ts
+var NAVIGATION_FAILURE_CANCELLED = 8;
+var isCancelledNavigationFailure = (failure) => !!failure && typeof failure === "object" && failure.type === NAVIGATION_FAILURE_CANCELLED;
 var locationFromPath = (path) => {
   const raw = new URL(path || "/", "http://f.invalid");
   return { pathname: raw.pathname, search: raw.search, hash: raw.hash };
@@ -160,7 +159,7 @@ function connectVueBridgeRouter(routing, router, options = {}) {
     if (router.currentRoute.value.fullPath !== path) {
       const failure = await replace.call(router, path);
       if (failure && router.currentRoute.value.fullPath !== path) {
-        if (isNavigationFailure(failure, NavigationFailureType.cancelled)) return;
+        if (isCancelledNavigationFailure(failure)) return;
         throw routingSyncError(spec, `\u5B50\u5E94\u7528\u5B88\u536B\u62D2\u7EDD\u5E94\u7528\u5BBF\u4E3B\u786E\u8BA4\u7684\u4F4D\u7F6E\uFF08\u76EE\u6807 ${path}\uFF09\uFF1B\u8BF7\u5728\u5BBF\u4E3B\u4FA7\u8BBE\u7F6E\u53D6\u6D88\u5B88\u536B\u3002`, []);
       }
     }
@@ -189,7 +188,7 @@ function connectVueBridgeRouter(routing, router, options = {}) {
         await ready;
         failure = await native.call(router, to);
         return failure ? void 0 : locationFromPath(router.currentRoute.value.fullPath);
-      }, typeof to === "object" && to.replace ? "replace" : action);
+      }, typeof to === "object" && to?.replace ? "replace" : action);
       if (failure) return failure;
       if (result.status === "cancelled") {
         const remove = router.beforeEach(() => false);

package/dist/{chunk-YKIFZIBH.js → chunk-77JZ6U6V.js}

@@ -3,7 +3,7 @@ import {
   routingNavigationError,
   routingProtocolError,
   routingSyncError
-} from "./chunk-WRJG2YG6.js";
+} from "./chunk-ZAYNS7YQ.js";
 
 // src/bridge-router-core.ts
 var MAX_REDIRECT_PER_REQUEST = 5;

package/dist/{chunk-Q6V5O5Y6.js → chunk-ENT3BOTX.js}

@@ -3,7 +3,7 @@ import {
   bridgeSessionMismatchError,
   invalidBridgeContractError,
   invalidSessionKeyError
-} from "./chunk-WRJG2YG6.js";
+} from "./chunk-ZAYNS7YQ.js";
 import {
   clearAppContext
 } from "./chunk-TSYLDY6H.js";

package/dist/{chunk-WRJG2YG6.js → chunk-ZAYNS7YQ.js}

@@ -29,7 +29,7 @@ function invalidBridgeContractError(spec, mod) {
     `\u73B0\u8C61\uFF1A\u8FDC\u7A0B\u6A21\u5757 "${spec}" \u7684\u9ED8\u8BA4\u5BFC\u51FA\u4E0D\u662F\u5408\u6CD5\u7684\u6865\u63A5\u5951\u7EA6\uFF08BridgeApp\uFF09\u3002
   \u6839\u56E0: \u5BFC\u51FA\u503C\u4E3A ${actual}` + (missing.length ? `\uFF0C\u7F3A\u5C11\u51FD\u6570\u7C7B\u578B\u7684 ${missing.map((m) => `"${m}"`).join(" / ")} \u5BFC\u51FA\u3002` : "\u3002") + `
   \u4FEE\u6CD5: \u8FDC\u7A0B\u4FA7\u7528 defineBridgeApp(...) \u521B\u5EFA\u5951\u7EA6\u5E76\u4F5C\u4E3A\u6A21\u5757\u9ED8\u8BA4\u5BFC\u51FA\u2014\u2014
-        Vue \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/runtime'\uFF1B
+        Vue \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/vue'\uFF1B
         React \u5B50\u5E94\u7528: import { defineBridgeApp } from '@fulgurjs/federation/react'\u3002
         \u5951\u7EA6\u5FC5\u987B\u5305\u542B mount(el, props?) \u4E0E unmount(el) \u4E24\u4E2A\u51FD\u6570\u3002`,
     { spec, missing, actual }