@fulgurjs/federation 5.3.3 → 5.4.0

package/dist/bridge-app-vue.js

@@ -1,28 +1,65 @@
 import {
   bridgeLifecycleError
-} from "./chunk-DH2QMM4Y.js";
+} from "./chunk-JQF7KYZF.js";
 import "./chunk-OF2JCXTZ.js";
 
 // src/bridge-app-vue.ts
 var appsByEl = /* @__PURE__ */ new WeakMap();
-function defineBridgeApp(factory) {
+var PENDING_MARKER = { __fulgurjsPending: true };
+function entriesAborted(el) {
+  return appsByEl.get(el) !== PENDING_MARKER;
+}
+function defineBridgeApp(factory, options = {}) {
+  const attach = (el, app, mountOptions) => {
+    if (!app || typeof app.mount !== "function" || typeof app.unmount !== "function") {
+      throw new Error(
+        `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F VueApp\uFF08\u5F53\u524D ${app === null ? "null" : typeof app}\uFF09\uFF1B\u5DE5\u5382\u5FC5\u987B\u8FD4\u56DE createApp(...) \u521B\u5EFA\u7684\u5E94\u7528\u5B9E\u4F8B\u3002`
+      );
+    }
+    try {
+      app.mount(el);
+    } catch (e) {
+      try {
+        app.unmount();
+      } catch {
+      }
+      throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+    }
+    appsByEl.set(el, app);
+    void mountOptions;
+  };
   return {
-    mount(el, props) {
+    ...options.routing ? { routing: { protocol: 1 } } : {},
+    // 同步工厂保持同步语义（容器占用/工厂抛错同步抛，BN03/BN02 口径不变）；
+    // Promise 工厂（URL 同步初始路由准备）走异步续体：挂起期间作废（signal aborted）
+    // 则结果丢弃不落挂（迟到初始化不得复活，BN06 同源语义）。
+    mount(el, props, mountOptions) {
       if (appsByEl.has(el)) {
         throw bridgeLifecycleError("mount", "bridge", "\u540C\u4E00\u5BB9\u5668 el \u5DF2\u6302\u8F7D\u672C\u6865\u63A5\u5E94\u7528\uFF08\u5BB9\u5668\u5DF2\u88AB\u5360\u7528\uFF09\u3002", {
           reason: "container-occupied"
         });
       }
       const snapshot = { ...props ?? {} };
+      const ctx = { signal: mountOptions?.signal, routing: mountOptions?.routing };
       let app;
       try {
-        app = factory(snapshot);
-        if (!app || typeof app.mount !== "function" || typeof app.unmount !== "function") {
-          throw new Error(
-            `defineBridgeApp \u5DE5\u5382\u8FD4\u56DE\u503C\u4E0D\u662F VueApp\uFF08\u5F53\u524D ${app === null ? "null" : typeof app}\uFF09\uFF1B\u5DE5\u5382\u5FC5\u987B\u8FD4\u56DE createApp(...) \u521B\u5EFA\u7684\u5E94\u7528\u5B9E\u4F8B\u3002`
+        const produced = factory(snapshot, ctx);
+        const thenable = produced.then;
+        if (typeof thenable === "function") {
+          appsByEl.set(el, PENDING_MARKER);
+          return produced.then(
+            (resolved) => {
+              if (entriesAborted(el)) return;
+              attach(el, resolved, mountOptions);
+            },
+            (e) => {
+              if (entriesAborted(el)) return;
+              appsByEl.delete(el);
+              throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
+            }
           );
         }
-        app.mount(el);
+        app = produced;
       } catch (e) {
         if (app) {
           try {
@@ -32,12 +69,13 @@ function defineBridgeApp(factory) {
         }
         throw bridgeLifecycleError("mount", "bridge", e instanceof Error ? e : String(e));
       }
-      appsByEl.set(el, app);
+      attach(el, app, mountOptions);
     },
     unmount(el) {
       const app = appsByEl.get(el);
       if (!app) return;
       appsByEl.delete(el);
+      if (app === PENDING_MARKER) return;
       try {
         app.unmount();
       } catch (e) {

package/dist/bridge-core-BOWvVUxO.d.ts

@@ -0,0 +1,91 @@
+/** 统一逻辑位置：pathname 以 / 开头；search 空串或 ? 开头；hash 空串或 # 开头 */
+interface BridgeLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+type BridgeNavigationResult = {
+    status: 'committed';
+    location: BridgeLocation;
+} | {
+    status: 'cancelled';
+    location: BridgeLocation;
+};
+/** 宿主导航端口（宿主适配器把 Router 包装成本接口；逻辑路径不含部署 base） */
+interface BridgeHostNavigation {
+    getLocation(): BridgeLocation;
+    subscribe(listener: (location: BridgeLocation) => void): () => void;
+    navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;
+    go(delta: number): void;
+}
+/** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
+interface BridgeChildRoute {
+    getLocation(): BridgeLocation;
+    subscribe(listener: (location: BridgeLocation) => void): () => void;
+    navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;
+    go(delta: number): void;
+}
+/** 挂载控制参数（mount 第三参数；不混入业务 props） */
+interface BridgeMountOptions {
+    signal?: AbortSignal;
+    routing?: BridgeChildRoute;
+}
+/** 子应用路由协议声明（defineBridgeApp(工厂, { routing: true }) 时写入） */
+interface BridgeRoutingProtocol {
+    protocol: 1;
+}
+/** 宿主组件 routing prop（独立控制通道，不进 appProps/Context） */
+interface BridgeHostRouting {
+    /** 宿主路由视角的静态绝对路径，如 "/approval"；同页各同步实例不得相同或重叠 */
+    basePath: string;
+    navigation: BridgeHostNavigation;
+}
+
+/**
+ * 跨应用上下文标准字段表（§4.3，0.8.2 精简后）。
+ *
+ * 读写约定：宿主桥先写标准字段；远程 boot 只增不改宿主键；
+ * 嵌套对象（如 events）是引用共享，子应用挂属性即时可见（同 realm 直引用）。
+ *
+ * 精简记录（0.8.2）：`token` 快照与 `formUrl`/`baseUrl` 从默认 provide 集合移除——
+ * token 快照与 getToken 函数引用重复（快照会过期），formUrl/baseUrl 自 0.7.0
+ * remoteComponent 直渲染后无消费点；项目如需可经扩展位自行提供。
+ */
+interface AppContext {
+    /** 宿主登录用户原始形态（只读约定） */
+    user: Record<string, any>;
+    /** 取最新 token（拉取式防过期；0.8.2 起 bridge 不再传一次性 token 快照，用本函数取值） */
+    getToken?: () => string | undefined;
+    /** 宿主 pinia 实例：子应用 useUserStore(ctx.store) 拿共享响应式状态 */
+    store?: unknown;
+    /** 宿主 Vue App 实例（同 realm 直引用）：全局组件/指令注册目标 */
+    hostApp?: unknown;
+    /** EP locale 等 UI 配置（原 W4 字段） */
+    locale?: unknown;
+    /** 事件/方法池：events.main.* 宿主提供、events.bpm.* / events.lowcode.* 子应用反向注册 */
+    events?: Record<string, any>;
+    /**
+     * 非敏感登录代次 ID：宿主每次成功登录/重新登录生成新值，token 刷新但会话未变时沿用。
+     * 远程 onSession 按它去重（同一代次只执行一次）。不是用户 ID、不是 token、不作为授权凭证。
+     * 远程声明了 onSession 时必填（缺省即 MFU-013）。
+     */
+    sessionKey?: string;
+    /** 项目扩展位（formUrl/baseUrl 等自定义键，按需自行提供） */
+    [key: string]: unknown;
+}
+
+/** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
+interface BridgeApp {
+    /** 首次根提交完成时才算挂载成功；同一容器未卸载前重复 mount 是契约违例 */
+    mount(el: HTMLElement, props?: Record<string, unknown>, options?: BridgeMountOptions): void | Promise<void>;
+    /** 同步使当前挂载代次失效并清理已创建的 root；未知容器为 no-op */
+    unmount(el: HTMLElement): void;
+    /**
+     * 路由协议声明（URL 同步）：defineBridgeApp(工厂, { routing: true }) 时写入
+     * { protocol: 1 }。宿主启用 routing 时必须存在且 protocol === 1（MFU-031），
+     * 不允许静默退回 memory 假装深链成功。
+     */
+    routing?: BridgeRoutingProtocol;
+}
+
+export type { AppContext as A, BridgeHostRouting as B, BridgeApp as a };

package/dist/bridge-core.cjs

@@ -60,7 +60,15 @@ var BridgeErrorCodes = {
   /** 桥接准备或生命周期失败（details.phase = getContext | mount | unmount） */
   BRIDGE_LIFECYCLE_FAILED: "MFU-016",
   /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
-  BRIDGE_SESSION_MISMATCH: "MFU-017"
+  BRIDGE_SESSION_MISMATCH: "MFU-017",
+  /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
+  ROUTING_CONFIG_INVALID: "MFU-030",
+  /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
+  ROUTING_PROTOCOL_MISSING: "MFU-031",
+  /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
+  ROUTING_NAVIGATION_INVALID: "MFU-032",
+  /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
+  ROUTING_SYNC_FAILED: "MFU-033"
 };
 function invalidBridgeContractError(spec, mod) {
   const actual = mod === null ? "null" : typeof mod;

package/dist/bridge-core.d.cts

@@ -1,11 +1,18 @@
 import { AppContext } from './context.cjs';
+import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-BxBx-reP.cjs';
 
 /** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
 interface BridgeApp {
     /** 首次根提交完成时才算挂载成功；同一容器未卸载前重复 mount 是契约违例 */
-    mount(el: HTMLElement, props?: Record<string, unknown>): void | Promise<void>;
+    mount(el: HTMLElement, props?: Record<string, unknown>, options?: BridgeMountOptions): void | Promise<void>;
     /** 同步使当前挂载代次失效并清理已创建的 root；未知容器为 no-op */
     unmount(el: HTMLElement): void;
+    /**
+     * 路由协议声明（URL 同步）：defineBridgeApp(工厂, { routing: true }) 时写入
+     * { protocol: 1 }。宿主启用 routing 时必须存在且 protocol === 1（MFU-031），
+     * 不允许静默退回 memory 假装深链成功。
+     */
+    routing?: BridgeRoutingProtocol;
 }
 /** 远程模块 → 契约校验（默认导出须含函数类型的 mount/unmount，否则 MFU-015） */
 declare function assertBridgeContract(spec: string, mod: unknown): BridgeApp;

package/dist/bridge-core.d.ts

@@ -1,11 +1,18 @@
 import { AppContext } from './context.js';
+import { a as BridgeMountOptions, b as BridgeRoutingProtocol } from './bridge-router-core-BxBx-reP.js';
 
 /** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
 interface BridgeApp {
     /** 首次根提交完成时才算挂载成功；同一容器未卸载前重复 mount 是契约违例 */
-    mount(el: HTMLElement, props?: Record<string, unknown>): void | Promise<void>;
+    mount(el: HTMLElement, props?: Record<string, unknown>, options?: BridgeMountOptions): void | Promise<void>;
     /** 同步使当前挂载代次失效并清理已创建的 root；未知容器为 no-op */
     unmount(el: HTMLElement): void;
+    /**
+     * 路由协议声明（URL 同步）：defineBridgeApp(工厂, { routing: true }) 时写入
+     * { protocol: 1 }。宿主启用 routing 时必须存在且 protocol === 1（MFU-031），
+     * 不允许静默退回 memory 假装深链成功。
+     */
+    routing?: BridgeRoutingProtocol;
 }
 /** 远程模块 → 契约校验（默认导出须含函数类型的 mount/unmount，否则 MFU-015） */
 declare function assertBridgeContract(spec: string, mod: unknown): BridgeApp;

package/dist/bridge-core.js

@@ -6,8 +6,8 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-LE2G23E7.js";
-import "./chunk-DH2QMM4Y.js";
+} from "./chunk-PRUYHYX2.js";
+import "./chunk-JQF7KYZF.js";
 import "./chunk-TSYLDY6H.js";
 import "./chunk-OF2JCXTZ.js";
 export {

package/dist/bridge-errors.cjs

@@ -24,7 +24,11 @@ __export(bridge_errors_exports, {
   bridgeLifecycleError: () => bridgeLifecycleError,
   bridgeSessionMismatchError: () => bridgeSessionMismatchError,
   invalidBridgeContractError: () => invalidBridgeContractError,
-  invalidSessionKeyError: () => invalidSessionKeyError
+  invalidSessionKeyError: () => invalidSessionKeyError,
+  routingConfigError: () => routingConfigError,
+  routingNavigationError: () => routingNavigationError,
+  routingProtocolError: () => routingProtocolError,
+  routingSyncError: () => routingSyncError
 });
 module.exports = __toCommonJS(bridge_errors_exports);
 
@@ -47,7 +51,15 @@ var BridgeErrorCodes = {
   /** 桥接准备或生命周期失败（details.phase = getContext | mount | unmount） */
   BRIDGE_LIFECYCLE_FAILED: "MFU-016",
   /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
-  BRIDGE_SESSION_MISMATCH: "MFU-017"
+  BRIDGE_SESSION_MISMATCH: "MFU-017",
+  /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
+  ROUTING_CONFIG_INVALID: "MFU-030",
+  /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
+  ROUTING_PROTOCOL_MISSING: "MFU-031",
+  /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
+  ROUTING_NAVIGATION_INVALID: "MFU-032",
+  /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
+  ROUTING_SYNC_FAILED: "MFU-033"
 };
 function invalidBridgeContractError(spec, mod) {
   const actual = mod === null ? "null" : typeof mod;
@@ -104,11 +116,51 @@ function invalidSessionKeyError(spec, value) {
     { spec, value: String(value) }
   );
 }
+function routingConfigError(spec, reason) {
+  return new FgError(
+    BridgeErrorCodes.ROUTING_CONFIG_INVALID,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684 URL \u540C\u6B65\u914D\u7F6E\u65E0\u6CD5\u542F\u7528\u3002
+\u539F\u56E0\uFF1A${reason}
+\u4FEE\u6CD5\uFF1A\u4FEE\u6B63 routing.basePath \u4E3A\u5BBF\u4E3B\u8DEF\u7531\u89C6\u89D2\u7684\u9759\u6001\u7EDD\u5BF9\u8DEF\u5F84\uFF08\u5982 "/approval"\uFF09\uFF0C\u5E76\u4FDD\u8BC1\u540C\u9875\u5404\u540C\u6B65\u5B9E\u4F8B\u524D\u7F00\u4E92\u4E0D\u91CD\u53E0\uFF1B\u5BBF\u4E3B\u8DEF\u7531\u9700\u58F0\u660E\u5BF9\u5E94\u7684\u540E\u7F00\u5339\u914D\uFF08Vue "/approval/:pathMatch(.*)*"\u3001React "/approval/*"\uFF09\u3002`,
+    { spec }
+  );
+}
+function routingProtocolError(spec, reason) {
+  return new FgError(
+    BridgeErrorCodes.ROUTING_PROTOCOL_MISSING,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684 URL \u540C\u6B65\u901A\u9053\u4E0D\u53EF\u7528\u3002
+\u539F\u56E0\uFF1A${reason}
+\u4FEE\u6CD5\uFF1A\u5B50\u5E94\u7528\u4EE5 defineBridgeApp(\u5DE5\u5382, { routing: true }) \u58F0\u660E\u8DEF\u7531\u534F\u8BAE\u5E76\u5728\u5DE5\u5382\u7B2C\u4E8C\u53C2\u6570\u63A5\u6536 { signal, routing } \u63A5\u7EBF\u53D7\u63A7\u8DEF\u7531\uFF1B\u901A\u9053\u968F\u6302\u8F7D\u751F\u547D\u5468\u671F\u521B\u5EFA\uFF0C\u9500\u6BC1\u540E\u4E0D\u5F97\u590D\u7528\uFF08\u91CD\u6302\u4F1A\u5F97\u5230\u65B0\u901A\u9053\uFF09\u3002`,
+    { spec }
+  );
+}
+function routingNavigationError(spec, reason) {
+  return new FgError(
+    BridgeErrorCodes.ROUTING_NAVIGATION_INVALID,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684\u4E00\u6B21\u5BFC\u822A\u8BF7\u6C42\u88AB\u62D2\u7EDD\u3002
+\u539F\u56E0\uFF1A${reason}
+\u4FEE\u6CD5\uFF1A\u5B50\u5E94\u7528\u5BFC\u822A\u76EE\u6807\u5FC5\u987B\u4F4D\u4E8E\u81EA\u8EAB basePath \u524D\u7F00\u5185\uFF08\u8DE8\u524D\u7F00\u8BF7\u7528\u5BBF\u4E3B\u83DC\u5355/\u5BBF\u4E3B\u80FD\u529B\uFF09\uFF1Bgo \u53C2\u6570\u4E3A\u6709\u9650\u6574\u6570\u4E14 |delta| \u2264 50\u3002`,
+    { spec }
+  );
+}
+function routingSyncError(spec, reason, chain) {
+  return new FgError(
+    BridgeErrorCodes.ROUTING_SYNC_FAILED,
+    `\u73B0\u8C61\uFF1A\u6865\u63A5\u5E94\u7528 "${spec}" \u7684 URL \u540C\u6B65\u5728\u91CD\u5B9A\u5411\u94FE\u4E0A\u8D85\u51FA\u4E0A\u9650\uFF08${chain.length} \u6B21\uFF09\u3002
+\u539F\u56E0\uFF1A${reason}
+\u4FEE\u6CD5\uFF1A\u68C0\u67E5\u5B50\u5E94\u7528\u8DEF\u7531\u7684\u91CD\u5B9A\u5411\u89C4\u5219\u662F\u5426\u4E92\u76F8\u6210\u73AF\uFF1B\u540C\u6B65\u91CD\u5B9A\u5411\u4F7F\u7528 replace \u4E14\u4E0D\u5F97\u5BF9\u540C\u4E00\u4F4D\u7F6E\u91CD\u590D\u53D1\u8D77\u3002\u76EE\u6807\u94FE\uFF1A${chain.join(" \u2192 ")}\u3002`,
+    { spec, chain: [...chain] }
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BridgeErrorCodes,
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,
-  invalidSessionKeyError
+  invalidSessionKeyError,
+  routingConfigError,
+  routingNavigationError,
+  routingProtocolError,
+  routingSyncError
 });

package/dist/bridge-errors.d.cts

@@ -6,7 +6,7 @@ declare class FgError extends Error {
 }
 
 /**
- * 桥接层错误码表（MFU-015/016/017，任务书 D3）。
+ * 桥接层错误码表（MFU-015/016/017 + 路由同步 MFU-030~033，任务书 D3 / URL 同步 §6）。
  *
  * 与 runtime.js 解耦：桥接专用分支不进内核 bundle（runtime 内核零改动为首选目标）；
  * 码值登记于 src/diagnostics.ts 的 CODE_REGISTRY，由 scripts/check-manual-codes.mjs
@@ -21,6 +21,14 @@ declare const BridgeErrorCodes: {
     readonly BRIDGE_LIFECYCLE_FAILED: "MFU-016";
     /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
     readonly BRIDGE_SESSION_MISMATCH: "MFU-017";
+    /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
+    readonly ROUTING_CONFIG_INVALID: "MFU-030";
+    /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
+    readonly ROUTING_PROTOCOL_MISSING: "MFU-031";
+    /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
+    readonly ROUTING_NAVIGATION_INVALID: "MFU-032";
+    /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
+    readonly ROUTING_SYNC_FAILED: "MFU-033";
 };
 /** 桥接生命周期阶段（MFU-016 details.phase 取值） */
 type BridgePhase = 'getContext' | 'mount' | 'unmount';
@@ -32,5 +40,13 @@ declare function bridgeLifecycleError(phase: BridgePhase, spec: string, cause: u
 declare function bridgeSessionMismatchError(spec: string, controlled: string, actual: unknown, extra?: Record<string, unknown>): FgError;
 /** MFU-017：受控 sessionKey 值本身非法（空字符串/数字等，非 undefined/null/非空字符串） */
 declare function invalidSessionKeyError(spec: string, value: unknown): FgError;
+/** MFU-030：路由同步配置非法或前缀冲突（basePath 校验失败、同页重叠前缀登记） */
+declare function routingConfigError(spec: string, reason: string): FgError;
+/** MFU-031：路由协议缺失/通道失效（子应用未以 { routing: true } 声明协议，或通道已销毁仍被使用） */
+declare function routingProtocolError(spec: string, reason: string): FgError;
+/** MFU-032：非法导航（越界目标、非法 go 参数、失效通道请求被拒绝） */
+declare function routingNavigationError(spec: string, reason: string): FgError;
+/** MFU-033：路由准备/同步失败（重定向循环等；不伪装成功也不静默回退 memory） */
+declare function routingSyncError(spec: string, reason: string, chain: string[]): FgError;
 
-export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError };
+export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };

package/dist/bridge-errors.d.ts

@@ -6,7 +6,7 @@ declare class FgError extends Error {
 }
 
 /**
- * 桥接层错误码表（MFU-015/016/017，任务书 D3）。
+ * 桥接层错误码表（MFU-015/016/017 + 路由同步 MFU-030~033，任务书 D3 / URL 同步 §6）。
  *
  * 与 runtime.js 解耦：桥接专用分支不进内核 bundle（runtime 内核零改动为首选目标）；
  * 码值登记于 src/diagnostics.ts 的 CODE_REGISTRY，由 scripts/check-manual-codes.mjs
@@ -21,6 +21,14 @@ declare const BridgeErrorCodes: {
     readonly BRIDGE_LIFECYCLE_FAILED: "MFU-016";
     /** 桥接会话参数与 AppContext 不一致（受控 sessionKey 与全局会话矛盾） */
     readonly BRIDGE_SESSION_MISMATCH: "MFU-017";
+    /** 路由同步配置/前缀冲突（basePath 非法、同页前缀冲突或重叠） */
+    readonly ROUTING_CONFIG_INVALID: "MFU-030";
+    /** 路由协议缺失/通道失效（子应用未声明 routing 协议，或已销毁通道被再次使用） */
+    readonly ROUTING_PROTOCOL_MISSING: "MFU-031";
+    /** 非法导航（目标越界前缀、非法 go 参数、失效实例的请求） */
+    readonly ROUTING_NAVIGATION_INVALID: "MFU-032";
+    /** 路由准备/同步失败（重定向循环、子应用路由准备失败且已阻止错误页面显示） */
+    readonly ROUTING_SYNC_FAILED: "MFU-033";
 };
 /** 桥接生命周期阶段（MFU-016 details.phase 取值） */
 type BridgePhase = 'getContext' | 'mount' | 'unmount';
@@ -32,5 +40,13 @@ declare function bridgeLifecycleError(phase: BridgePhase, spec: string, cause: u
 declare function bridgeSessionMismatchError(spec: string, controlled: string, actual: unknown, extra?: Record<string, unknown>): FgError;
 /** MFU-017：受控 sessionKey 值本身非法（空字符串/数字等，非 undefined/null/非空字符串） */
 declare function invalidSessionKeyError(spec: string, value: unknown): FgError;
+/** MFU-030：路由同步配置非法或前缀冲突（basePath 校验失败、同页重叠前缀登记） */
+declare function routingConfigError(spec: string, reason: string): FgError;
+/** MFU-031：路由协议缺失/通道失效（子应用未以 { routing: true } 声明协议，或通道已销毁仍被使用） */
+declare function routingProtocolError(spec: string, reason: string): FgError;
+/** MFU-032：非法导航（越界目标、非法 go 参数、失效通道请求被拒绝） */
+declare function routingNavigationError(spec: string, reason: string): FgError;
+/** MFU-033：路由准备/同步失败（重定向循环等；不伪装成功也不静默回退 memory） */
+declare function routingSyncError(spec: string, reason: string, chain: string[]): FgError;
 
-export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError };
+export { BridgeErrorCodes, type BridgePhase, bridgeLifecycleError, bridgeSessionMismatchError, invalidBridgeContractError, invalidSessionKeyError, routingConfigError, routingNavigationError, routingProtocolError, routingSyncError };

package/dist/bridge-errors.js

@@ -3,13 +3,21 @@ import {
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,
-  invalidSessionKeyError
-} from "./chunk-DH2QMM4Y.js";
+  invalidSessionKeyError,
+  routingConfigError,
+  routingNavigationError,
+  routingProtocolError,
+  routingSyncError
+} from "./chunk-JQF7KYZF.js";
 import "./chunk-OF2JCXTZ.js";
 export {
   BridgeErrorCodes,
   bridgeLifecycleError,
   bridgeSessionMismatchError,
   invalidBridgeContractError,
-  invalidSessionKeyError
+  invalidSessionKeyError,
+  routingConfigError,
+  routingNavigationError,
+  routingProtocolError,
+  routingSyncError
 };

package/dist/{bridge-host-react-C55RmGll.d.ts → bridge-host-react-CMVd-ym0.d.ts}

@@ -1,5 +1,5 @@
 import { ReactNode } from 'react';
-import { A as AppContext } from './bridge-core-6uLJiMVa.js';
+import { A as AppContext } from './bridge-core-BOWvVUxO.js';
 
 /**
  * React 宿主桥接工厂（/bridge、/bridge/react 导出 createReactBridgeApp；任务书 §3.4）。