@fulgurjs/federation 5.9.3 → 6.1.0

package/examples/templates/vue-host-react-remote/pnpm-lock.yaml

@@ -11,8 +11,8 @@ importers:
   react-remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 5.9.2
-        version: 5.9.2(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.0.0
+        version: 6.0.0(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))
       react:
         specifier: ^19.1.0
         version: 19.3.0
@@ -42,8 +42,8 @@ importers:
   vue-host:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 5.9.2
-        version: 5.9.2(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.0.0
+        version: 6.0.0(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))
       react:
         specifier: ^19.1.0
         version: 19.3.0
@@ -467,8 +467,8 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@fulgurjs/federation@5.9.2':
-    resolution: {integrity: sha512-uLjNX4wBmTfSfJmPKl34bJzdfwpFhliQEufxZtvPXvqI6QJAMxbVWXYs7AzbTI5OsbD3a8KSopov0pNx4dWZqQ==}
+  '@fulgurjs/federation@6.0.0':
+    resolution: {integrity: sha512-h3/ZvxdJZVtbvQcQ/OycsTQq7J9LYTfDjpjtoLli0eMk1gOjr2xdvtYaKw57Rt+ccGyfJgYPCsF2U48vVkRFpg==}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -1221,7 +1221,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@5.9.2(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))':
+  '@fulgurjs/federation@6.0.0(react-dom@19.3.0(react@19.3.0))(react-router-dom@7.18.4(react-dom@19.3.0(react@19.3.0))(react@19.3.0))(react@19.3.0)(vite@6.4.3)(vue@3.5.43(typescript@5.9.3))':
     dependencies:
       es-module-lexer: 1.7.0
       esbuild: 0.27.7

package/examples/templates/vue-host-react-remote/pnpm-workspace.yaml

@@ -2,7 +2,7 @@ packages:
   - vue-host
   - react-remote
 minimumReleaseAgeExclude:
-  - '@fulgurjs/federation@5.7.1 || 5.8.0 || 5.9.0 || 5.9.1 || 5.9.2'
+  - '@fulgurjs/federation@6.0.0'
 # pnpm >=12 构建脚本批准（12 起弃用 onlyBuiltDependencies；pnpm 9-11 忽略本键：
 # esbuild >=0.16 二进制经 optionalDependencies 平台包分发，postinstall 仅校验，不阻塞安装）
 allowBuilds:

package/examples/templates/vue-host-react-remote/react-remote/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview --port 5303 --strictPort"
   },
   "dependencies": {
-    "@fulgurjs/federation": "5.9.2",
+    "@fulgurjs/federation": "6.0.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "react-router-dom": "^7.1.0"

package/examples/templates/vue-host-react-remote/scripts/dev.config.json

@@ -1,6 +1,15 @@
 {
   "apps": [
-    { "name": "react-remote", "dir": "react-remote", "port": 5303 },
-    { "name": "vue-host", "dir": "vue-host", "port": 5314 }
+    {
+      "name": "react-remote",
+      "dir": "react-remote",
+      "port": 5303
+    },
+    {
+      "name": "vue-host",
+      "dir": "vue-host",
+      "port": 5314,
+      "host": true
+    }
   ]
 }

package/examples/templates/vue-host-react-remote/vue-host/README.md

@@ -1,6 +1,6 @@
 # bridge-vue-host — Vue 宿主 × React 桥接子应用示例
 
-`@fulgurjs/federation` 跨框架桥接的 **Vue 3 宿主**侧示例：用 `createVueBridgeApp`（`@fulgurjs/federation/bridge/vue`）把 `bridge-react-remote/bridge` 作为受控组件挂载。
+`@fulgurjs/federation` 跨框架桥接的 **Vue 3 宿主**侧示例：用 `createVueBridgeApp`（统一入口 `@fulgurjs/federation/vue`）把 `bridge-react-remote/bridge` 作为受控组件挂载。
 
 ## 运行
 
@@ -18,7 +18,7 @@ pnpm build                       # 构建完整组合
 ## 关键点（对应 README §8.2）
 
 - **双框架安装合同**：本宿主同时安装 `vue` + `react` + `react-dom`，shared 三键全部 `singleton: true`。
-- **入口选择**：`@fulgurjs/federation/bridge/vue` 只携带 Vue 宿主适配器——dev 原生 ESM 与生产构建都不会加载 React 宿主适配代码（聚合入口 `/bridge` 会同时执行两者，仅兼容保留）。
+- **入口选择**：统一入口 `@fulgurjs/federation/vue`——宿主代码全部来自 /vue，不会加载 React 适配代码（6.0.0 起 /bridge、/bridge/* 深层入口已移除）。
 - **`sessionKey`**：受控登录代次（非业务 props）。置 `null` = 登出态（立即卸载、不再请求）；换账号走「null → `clearAppContext()` → 新代次」顺序，保证 A 的 context 字段零残留。
 - **`getContext`**：同步纯 getter（`src/host-session.ts`），桥接层校验其快照的 `sessionKey` 后才代写 AppContext。
 - **`appProps`**：挂载时浅拷贝快照；函数引用（`onReady`）保留原引用；换顶层引用不重挂，需要重置时用 `:key`。

package/examples/templates/vue-host-react-remote/vue-host/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview --port 5314 --strictPort"
   },
   "dependencies": {
-    "@fulgurjs/federation": "5.9.2",
+    "@fulgurjs/federation": "6.0.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "vue": "^3.5.13"

package/examples/templates/vue-host-react-remote/vue-host/src/App.vue

@@ -5,7 +5,7 @@
  */
 import { ref } from 'vue'
 import { clearAppContext } from '@fulgurjs/federation/runtime'
-import { createVueBridgeApp } from '@fulgurjs/federation/bridge/vue'
+import { createVueBridgeApp } from '@fulgurjs/federation/vue'
 import { getLatestHostContext, login, logout } from './host-session'
 
 // 工厂选项：retries 透传 loadRemote；getContext 在每次实际加载前同步取最新快照
@@ -51,7 +51,7 @@ async function doLogout(): Promise<void> {
 
 <template>
   <div style="font-family: sans-serif; padding: 16px; max-width: 720px">
-    <h1>Vue 宿主 × React 子应用（@fulgurjs/federation/bridge/vue）</h1>
+    <h1>Vue 宿主 × React 子应用（@fulgurjs/federation/vue）</h1>
     <p data-testid="demo-session">会话：{{ sessionKey ?? '未登录' }}（{{ userName || '—' }}）· onReady 次数：{{ readyCount }}</p>
 
     <p>

package/examples/templates/vue-vue/host/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview --port 5214 --strictPort"
   },
   "dependencies": {
-    "@fulgurjs/federation": "5.9.2",
+    "@fulgurjs/federation": "6.0.0",
     "vue": "^3.5.13",
     "vue-router": "^4.5.0"
   },

package/examples/templates/vue-vue/host/src/main.ts

@@ -1,6 +1,6 @@
 import { createApp, h } from 'vue'
 import { createRouter, createWebHistory, useRoute } from 'vue-router'
-import { createHostPages } from '@fulgurjs/federation/runtime'
+import { createHostPages } from '@fulgurjs/federation/vue'
 import App from './App.vue'
 import HomePage from './pages/HomePage.vue'
 import UtilsDemo from './pages/UtilsDemo.vue'
@@ -13,31 +13,38 @@ const hostPages = createHostPages({
   remotePrefixes,
 })
 
+// 远程页面 Router 记录从页面表派生（route + spec 唯一来源 = fulgurjs.config.ts 的 pages；
+// 业务自有路由仍归本 Router 管理——业务 Router 与联邦页面映射是两类事实）。
+// 远程名按最长前缀从 remotePrefixes 解析（与运行时归属一致）；params + query 全量透传给
+// 远程页面组件（响应式：路由变化即重渲染）。
+const remoteNameOf = (route: string): string => {
+  const prefix = Object.keys(remotePrefixes)
+    .filter((p) => route === p || route.startsWith(p + '/') || route.startsWith(p))
+    .sort((a, b) => b.length - a.length)[0]
+  const name = prefix ? remotePrefixes[prefix] : undefined
+  if (!name) throw new Error(`页面 ${route} 不匹配任何 remotePrefixes 前缀——请核对 fulgurjs.config.ts`)
+  return name
+}
+const remoteRoutes = pages.map((page) => ({
+  path: page.route,
+  component: {
+    setup() {
+      const route = useRoute()
+      return () =>
+        h(hostPages.component(`${remoteNameOf(page.route)}/${page.spec}`), {
+          ...route.params,
+          ...route.query,
+        })
+    },
+  },
+}))
+
 const router = createRouter({
   history: createWebHistory(),
   routes: [
     { path: '/', component: HomePage },
     { path: '/utils-demo', component: UtilsDemo },
-    {
-      // 远程页面：spec 经 hostPages.component(spec) 取异步组件（spec = 远程名 + exposes 键）；
-      // route.params + route.query 作为 props 透传给远程页面组件
-      path: '/remote/home',
-      component: { render: () => h(hostPages.component('vue-remote/pages/HomePage')) },
-    },
-    {
-      path: '/remote/detail/:id',
-      // params + query 全量透传给远程页面组件（响应式：路由变化即重渲染）
-      component: {
-        setup() {
-          const route = useRoute()
-          return () =>
-            h(hostPages.component('vue-remote/pages/DetailPage'), {
-              id: route.params.id as string,
-              tab: (route.query.tab as string | undefined) ?? undefined,
-            })
-        },
-      },
-    },
+    ...remoteRoutes,
   ],
 })
 

package/examples/templates/vue-vue/host/src/pages/HomePage.vue

@@ -8,7 +8,7 @@
 </template>
 
 <script setup lang="ts">
-import { remoteComponent } from '@fulgurjs/federation/runtime'
+import { remoteComponent } from '@fulgurjs/federation/vue'
 
 // remoteComponent：首次渲染才真正加载远程模块；失败时插件呈现默认错误占位
 // （含「重试加载 / 刷新页面重试」），无需自己实现错误组件。

package/examples/templates/vue-vue/pnpm-lock.yaml

@@ -11,8 +11,8 @@ importers:
   host:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 5.9.2
-        version: 5.9.2(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.0.0
+        version: 6.0.0(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
       vue:
         specifier: ^3.5.13
         version: 3.5.43(typescript@5.9.3)
@@ -33,8 +33,8 @@ importers:
   remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 5.9.2
-        version: 5.9.2(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.0.0
+        version: 6.0.0(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
       vue:
         specifier: ^3.5.13
         version: 3.5.43(typescript@5.9.3)
@@ -380,8 +380,8 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@fulgurjs/federation@5.9.2':
-    resolution: {integrity: sha512-uLjNX4wBmTfSfJmPKl34bJzdfwpFhliQEufxZtvPXvqI6QJAMxbVWXYs7AzbTI5OsbD3a8KSopov0pNx4dWZqQ==}
+  '@fulgurjs/federation@6.0.0':
+    resolution: {integrity: sha512-h3/ZvxdJZVtbvQcQ/OycsTQq7J9LYTfDjpjtoLli0eMk1gOjr2xdvtYaKw57Rt+ccGyfJgYPCsF2U48vVkRFpg==}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -889,7 +889,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@5.9.2(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))':
+  '@fulgurjs/federation@6.0.0(vite@6.4.3)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))':
     dependencies:
       es-module-lexer: 1.7.0
       esbuild: 0.27.7

package/examples/templates/vue-vue/pnpm-workspace.yaml

@@ -2,7 +2,7 @@ packages:
   - host
   - remote
 minimumReleaseAgeExclude:
-  - '@fulgurjs/federation@5.7.1 || 5.8.0 || 5.9.0 || 5.9.1 || 5.9.2'
+  - '@fulgurjs/federation@6.0.0'
 # pnpm >=12 构建脚本批准（12 起弃用 onlyBuiltDependencies；pnpm 9-11 忽略本键：
 # esbuild >=0.16 二进制经 optionalDependencies 平台包分发，postinstall 仅校验，不阻塞安装）
 allowBuilds:

package/examples/templates/vue-vue/remote/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview --port 5213 --strictPort"
   },
   "dependencies": {
-    "@fulgurjs/federation": "5.9.2",
+    "@fulgurjs/federation": "6.0.0",
     "vue": "^3.5.13"
   },
   "devDependencies": {

package/examples/templates/vue-vue/scripts/dev.config.json

@@ -1,6 +1,15 @@
 {
   "apps": [
-    { "name": "remote", "dir": "remote", "port": 5213 },
-    { "name": "host", "dir": "host", "port": 5214 }
+    {
+      "name": "remote",
+      "dir": "remote",
+      "port": 5213
+    },
+    {
+      "name": "host",
+      "dir": "host",
+      "port": 5214,
+      "host": true
+    }
   ]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "5.9.3",
+  "version": "6.1.0",
   "type": "module",
   "description": "Vite Module Federation for Vue and React: remote modules, shared dependencies and app bridges.",
   "license": "MIT",
@@ -13,6 +13,10 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./vue": {
+      "types": "./dist/vue.d.ts",
+      "import": "./dist/vue.js"
+    },
     "./runtime": {
       "types": "./dist/runtime-entry.d.ts",
       "import": "./dist/runtime-entry.js"
@@ -21,18 +25,6 @@
       "types": "./dist/react.d.ts",
       "import": "./dist/react.js"
     },
-    "./bridge": {
-      "types": "./dist/bridge.d.ts",
-      "import": "./dist/bridge.js"
-    },
-    "./bridge/vue": {
-      "types": "./dist/bridge-vue.d.ts",
-      "import": "./dist/bridge-vue.js"
-    },
-    "./bridge/react": {
-      "types": "./dist/bridge-react.d.ts",
-      "import": "./dist/bridge-react.js"
-    },
     "./package.json": "./package.json",
     "./internal/context.js": {
       "types": "./dist/context.d.ts",
@@ -74,37 +66,29 @@
       "types": "./dist/bridge-host-react.d.ts",
       "import": "./dist/bridge-host-react.js"
     },
-    "./bridge/router/vue": {
+    "./internal/bridge-router-core.js": {
+      "types": "./dist/bridge-router-core.d.ts",
+      "import": "./dist/bridge-router-core.js"
+    },
+    "./internal/bridge-router-vue.js": {
       "types": "./dist/bridge-router-vue.d.ts",
       "import": "./dist/bridge-router-vue.js"
     },
-    "./bridge/router/react": {
+    "./internal/bridge-router-react.js": {
       "types": "./dist/bridge-router-react.d.ts",
       "import": "./dist/bridge-router-react.js"
     }
   },
   "typesVersions": {
     "*": {
+      "vue": [
+        "dist/vue.d.ts"
+      ],
       "runtime": [
         "dist/runtime-entry.d.ts"
       ],
       "react": [
         "dist/react.d.ts"
-      ],
-      "bridge/vue": [
-        "dist/bridge-vue.d.ts"
-      ],
-      "bridge/react": [
-        "dist/bridge-react.d.ts"
-      ],
-      "bridge": [
-        "dist/bridge.d.ts"
-      ],
-      "bridge/router/vue": [
-        "dist/bridge-router-vue.d.ts"
-      ],
-      "bridge/router/react": [
-        "dist/bridge-router-react.d.ts"
       ]
     }
   },
@@ -116,15 +100,18 @@
     "CHANGELOG.md",
     "DESIGN.md",
     "examples",
-    "docs/迁移指南.md",
-    "docs/webpack-mf-对照与缺口.md",
-    "docs/沙箱边界审计.md",
-    "docs/P5-vite7-8兼容矩阵.md",
-    "docs/API.md",
-    "docs/API.en.md"
+    "docs/zh/reference/api.md",
+    "docs/zh/reference/errors.md",
+    "docs/zh/migration.md",
+    "docs/en/reference/api.md",
+    "docs/en/reference/errors.md",
+    "docs/en/migration.md",
+    "docs/maintainers/webpack-mf-对照与缺口.md",
+    "docs/maintainers/沙箱边界审计.md",
+    "docs/maintainers/P5-vite7-8兼容矩阵.md"
   ],
   "scripts": {
-    "build": "cp ../../README.md README.md && cp ../../README.en.md README.en.md && mkdir -p docs && cp ../../docs/API.md ../../docs/API.en.md ../../docs/迁移指南.md ../../docs/webpack-mf-对照与缺口.md ../../docs/沙箱边界审计.md ../../docs/P5-vite7-8兼容矩阵.md docs/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && node scripts/sync-package-examples.mjs && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime.mjs && tsup src/index.ts src/pages.ts src/vue-adapter.ts src/react-adapter.ts src/context.ts src/bridge-core.ts src/bridge-errors.ts src/bridge-app-vue.ts src/bridge-app-react.ts src/bridge-host-vue.ts src/bridge-host-react.ts --format esm,cjs --dts --external vite --target node18 --clean && tsup src/runtime-entry.ts --format esm --dts --external vite,vue --target node18 && tsup src/react.ts --format esm --dts --external vite,react --target node18 && tsup src/bridge.ts src/bridge-vue.ts src/bridge-react.ts --format esm --dts --external vite,vue,react,react-dom --target node18 && tsup src/bridge-router-vue.ts --format esm --dts --external vite,vue,vue-router --target node18 && tsup src/bridge-router-react.tsx --format esm --dts --external vite,react,react-dom,react-router-dom --target node18 && esbuild src/cli.ts --bundle --format=esm --target=node18 --platform=node --outfile=dist/cli.js && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime-entry.mjs && node scripts/check-gzip.mjs && node scripts/check-manual-codes.mjs",
+    "build": "cp ../../README.md README.md && cp ../../README.en.md README.en.md && mkdir -p docs && mkdir -p docs/zh/reference docs/en/reference docs/maintainers && cp ../../docs/zh/reference/api.md ../../docs/zh/reference/errors.md docs/zh/reference/ && cp ../../docs/zh/migration.md docs/zh/ && cp ../../docs/en/reference/api.md ../../docs/en/reference/errors.md docs/en/reference/ && cp ../../docs/en/migration.md docs/en/ && cp ../../docs/maintainers/webpack-mf-对照与缺口.md ../../docs/maintainers/沙箱边界审计.md ../../docs/maintainers/P5-vite7-8兼容矩阵.md docs/maintainers/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && node scripts/sync-package-examples.mjs && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime.mjs && tsup src/index.ts src/pages.ts src/vue-adapter.ts src/react-adapter.ts src/context.ts src/bridge-core.ts src/bridge-errors.ts src/bridge-app-vue.ts src/bridge-app-react.ts src/bridge-host-vue.ts src/bridge-host-react.ts --format esm,cjs --dts --external vite --target node18 --clean && tsup src/runtime-entry.ts --format esm --dts --external vite --target node18 && tsup src/vue.ts --format esm --dts --external vite,vue,vue-router --target node18 && tsup src/react.ts --format esm --dts --external vite,react,react-dom,react-router-dom --target node18 && tsup src/bridge-router-vue.ts --format esm --dts --external vite,vue,vue-router --target node18 && tsup src/bridge-router-react.tsx --format esm --dts --external vite,react,react-dom,react-router-dom --target node18 && esbuild src/cli.ts --bundle --format=esm --target=node18 --platform=node --outfile=dist/cli.js && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime-entry.mjs && node scripts/check-gzip.mjs && node scripts/check-manual-codes.mjs",
     "dev": "tsup --watch",
     "test": "vitest run --dir tests",
     "typecheck": "tsc --noEmit",

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

@@ -1,99 +0,0 @@
-/** 统一逻辑位置：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', options?: {
-        signal?: AbortSignal;
-    }): Promise<BridgeNavigationResult>;
-    go(delta: number): void;
-}
-/** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
-interface BridgeChildRoute {
-    /**
-     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
-     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
-     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
-     */
-    readonly spec?: string;
-    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-host-react-CGymCzD2.d.ts

@@ -1,35 +0,0 @@
-import { ReactNode } from 'react';
-import { A as AppContext } from './bridge-core-D37VanBl.js';
-
-/**
- * React 宿主桥接工厂（/bridge、/bridge/react 导出 createReactBridgeApp；任务书 §3.4）。
- *
- * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回
- * `ComponentType<{ appProps: P; sessionKey?: string | null }>`，负责：
- * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（fragment 的固定子节点）；
- *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
- * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
- * - StrictMode 安全（§4.5）：双 effect 走 cleanup(作废+卸载)→setup(新代次) 顺序，
- *   顺序 unmount/mount 不产生双实例或残留；
- * - unmount 抛错（BN09）：报告 MFU-016（phase: unmount）并封锁该容器的新挂载。
- *
- * appProps 是挂载时浅拷贝快照（顶层替换不追踪，重挂由 key 重建）；sessionKey
- * 是桥接控制参数，不混入业务 props。
- */
-
-/** 渲染函数形态的错误占位：(error, retry) => ReactNode */
-type BridgeErrorFallback = (error: unknown, retry: () => void) => ReactNode;
-interface ReactBridgeAppOptions {
-    /** 加载 pending 占位（默认 null） */
-    fallback?: ReactNode;
-    /** 加载/挂载失败占位；默认内置中文诊断 + 「重试加载 / 刷新页面重试」 */
-    error?: ReactNode | BridgeErrorFallback;
-    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
-    retries?: number;
-    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
-    timeout?: number;
-    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
-    getContext?: () => Partial<AppContext> & Record<string, unknown>;
-}
-
-export type { BridgeErrorFallback as B, ReactBridgeAppOptions as R };

package/dist/bridge-host-vue-B3GHaQAC.d.ts

@@ -1,32 +0,0 @@
-import { Component } from 'vue';
-import { A as AppContext } from './bridge-core-D37VanBl.js';
-
-/**
- * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
- *
- * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
- * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
- * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（多根 fragment 的固定子节点）；
- *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
- * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
- * - 错误诊断：契约非法 MFU-015、生命周期失败 MFU-016（phase 区分）、会话矛盾 MFU-017；
- *   默认占位含「重试加载 / 刷新页面重试」两条恢复操作（§4.4）。
- *
- * appProps 是挂载时浅拷贝快照（顶层替换不追踪、不重渲染子应用，重挂由 :key 重建）；
- * sessionKey 是桥接控制参数，不混入业务 props。
- */
-
-interface VueBridgeAppOptions {
-    /** 加载 pending 占位组件（默认无占位节点） */
-    loadingComponent?: Component;
-    /** 加载/挂载失败占位（完全接管，契约不变：只接收 error prop；默认内置中文诊断 + 两条恢复操作） */
-    errorComponent?: Component;
-    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
-    retries?: number;
-    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
-    timeout?: number;
-    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
-    getContext?: () => Partial<AppContext> & Record<string, unknown>;
-}
-
-export type { VueBridgeAppOptions as V };

package/dist/bridge-react.d.ts

@@ -1,14 +0,0 @@
-import * as react from 'react';
-import { B as BridgeHostRouting } from './bridge-core-D37VanBl.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
-import { R as ReactBridgeAppOptions } from './bridge-host-react-CGymCzD2.js';
-export { B as BridgeErrorFallback } from './bridge-host-react-CGymCzD2.js';
-
-/** React 宿主桥接工厂：返回 `ComponentType<{ appProps: P; sessionKey?: string | null }>` */
-declare const createReactBridgeApp: <P = Record<string, unknown>>(spec: string, options?: ReactBridgeAppOptions) => react.ComponentType<{
-    appProps?: P;
-    sessionKey?: string | null;
-    routing?: BridgeHostRouting;
-}>;
-
-export { ReactBridgeAppOptions, createReactBridgeApp };

package/dist/bridge-react.js

@@ -1,3 +0,0 @@
-import { loadRemote } from "./runtime.js";
-import { createReactBridgeAppWithLoader } from "./bridge-host-react.js";
-export const createReactBridgeApp = createReactBridgeAppWithLoader(loadRemote);

package/dist/bridge-vue.d.ts

@@ -1,8 +0,0 @@
-import * as vue from 'vue';
-import { V as VueBridgeAppOptions } from './bridge-host-vue-B3GHaQAC.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
-
-/** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
-declare const createVueBridgeApp: <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => vue.Component;
-
-export { VueBridgeAppOptions, createVueBridgeApp };

package/dist/bridge-vue.js

@@ -1,3 +0,0 @@
-import { loadRemote } from "./runtime.js";
-import { createVueBridgeAppWithLoader } from "./bridge-host-vue.js";
-export const createVueBridgeApp = createVueBridgeAppWithLoader(loadRemote);

package/dist/bridge.d.ts

@@ -1,18 +0,0 @@
-import * as react from 'react';
-import { B as BridgeHostRouting } from './bridge-core-D37VanBl.js';
-export { A as AppContext, a as BridgeApp } from './bridge-core-D37VanBl.js';
-import { R as ReactBridgeAppOptions } from './bridge-host-react-CGymCzD2.js';
-export { B as BridgeErrorFallback } from './bridge-host-react-CGymCzD2.js';
-import * as vue from 'vue';
-import { V as VueBridgeAppOptions } from './bridge-host-vue-B3GHaQAC.js';
-
-/** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
-declare const createVueBridgeApp: <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => vue.Component;
-/** React 宿主桥接工厂：返回 `ComponentType<{ appProps: P; sessionKey?: string | null }>` */
-declare const createReactBridgeApp: <P = Record<string, unknown>>(spec: string, options?: ReactBridgeAppOptions) => react.ComponentType<{
-    appProps?: P;
-    sessionKey?: string | null;
-    routing?: BridgeHostRouting;
-}>;
-
-export { ReactBridgeAppOptions, VueBridgeAppOptions, createReactBridgeApp, createVueBridgeApp };

package/dist/bridge.js

@@ -1,5 +0,0 @@
-import { loadRemote } from "./runtime.js";
-import { createVueBridgeAppWithLoader } from "./bridge-host-vue.js";
-import { createReactBridgeAppWithLoader } from "./bridge-host-react.js";
-export const createVueBridgeApp = createVueBridgeAppWithLoader(loadRemote);
-export const createReactBridgeApp = createReactBridgeAppWithLoader(loadRemote);