@fulgurjs/federation 6.11.7 → 6.12.1

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

@@ -1,68 +1,37 @@
 <script setup lang="ts">
-/**
- * Vue 宿主 × React 桥接子应用（examples 版，含全部关键语义注释）。
- * 先启动 examples/templates/react-remote（5303）再启动本宿主。
- */
-import { ref } from 'vue'
-import { clearAppContext } from '@fulgurjs/federation/runtime'
+/** Vue宿主嵌React完整应用：只绑定业务身份与上下文，不手写联邦登录代次。 */
+import { computed, ref } from 'vue'
 import { createVueBridgeApp } from '@fulgurjs/federation/vue'
-import { getLatestHostContext, login, logout } from './fulgurjs/host/session'
+import { currentUser, sessionIdentity, getLatestHostContext, login, logout, refreshToken } from './fulgurjs/host/context'
 
-// 工厂选项：retries 透传 loadRemote；getContext 在每次实际加载前同步取最新快照
 const RemoteReactApp = createVueBridgeApp('bridge-react-remote/bridge', {
   retries: 1,
-  getContext: () => getLatestHostContext(),
+  session: sessionIdentity,
+  getContext: getLatestHostContext,
 })
-
-// sessionKey 是桥接控制参数（非敏感登录代次 ID），不是业务 props
-const sessionKey = ref<string | null>('login-1-alice')
-const userName = ref('Alice')
+const userName = computed(() => currentUser()?.name ?? '')
 const label = ref('来自 Vue 宿主')
 const readyCount = ref(0)
-
-function handleReady(): void {
-  readyCount.value++
-}
-
-function nextFrame(): Promise<void> {
-  return new Promise((r) => requestAnimationFrame(() => r()))
-}
-
-// 换账号推荐顺序（§4.3）：受控 prop 置 null → 等卸载 → clearAppContext 清 A 残留
-// → 登录 B → 更新受控 prop 触发新代次（getContext + loadRemote + onSession 全走一遍）
-async function switchUser(): Promise<void> {
-  sessionKey.value = null
-  await nextFrame()
-  clearAppContext()
-  login('login-2-bob', { id: 2, name: 'Bob' })
-  userName.value = 'Bob'
-  sessionKey.value = 'login-2-bob'
-}
-
-// 登出：prop 置 null → 桥接立即卸载且不再请求 → 宿主清理全局 context
-async function doLogout(): Promise<void> {
-  sessionKey.value = null
-  await nextFrame()
-  clearAppContext()
-  logout()
-  userName.value = ''
-}
+function handleReady(): void { readyCount.value++ }
+// 这些函数只改业务状态；换代、清理旧上下文与卸载顺序由插件负责。
+function switchUser(): void { login({ id: 2, name: 'Bob' }) }
+function doLogout(): void { logout() }
 </script>
 
 <template>
   <div style="font-family: sans-serif; padding: 16px; max-width: 720px">
     <h1>Vue 宿主 × React 子应用（@fulgurjs/federation/vue）</h1>
-    <p data-testid="demo-session">会话：{{ sessionKey ?? '未登录' }}（{{ userName || '—' }}）· onReady 次数：{{ readyCount }}</p>
+    <p data-testid="demo-session">当前用户：{{ userName || '未登录' }}· onReady 次数：{{ readyCount }}</p>
 
     <p>
-      <button data-testid="demo-switch" @click="switchUser">切换到 Bob（clearAppContext → 重挂）</button>
-      <button data-testid="demo-logout" @click="doLogout">登出（sessionKey → null）</button>
+      <button data-testid="demo-switch" @click="switchUser">切换到 Bob（自动重挂）</button>
+      <button data-testid="demo-refresh-token" @click="refreshToken">刷新 token（不重挂）</button>
+      <button data-testid="demo-logout" @click="doLogout">登出（自动卸载）</button>
     </p>
 
     <!-- 外层元素控制桥接区域外观；appProps 是挂载时浅拷贝快照，换引用不重挂，重挂用 :key -->
     <section style="margin-top: 12px">
       <RemoteReactApp
-        :session-key="sessionKey"
         :app-props="{ label, onReady: handleReady }"
       />
     </section>

package/examples/templates/vue-host-react-remote/vue-host/src/fulgurjs/host/context.ts

@@ -0,0 +1,28 @@
+/**
+ * 演示宿主的业务登录状态与上下文。真实工程复用已有登录 store，不复制本示例的假账号。
+ * session getter 仅返回非敏感用户ID；插件负责代次/恢复/卸载，token刷新不触发重挂。
+ * 一个响应式快照让用户与token同时提交，避免在换号中间态把旧用户配上新凭据。
+ */
+import { shallowRef } from 'vue'
+
+interface HostUser { id: number; name: string }
+const current = shallowRef<{ user: HostUser; token: string } | null>({
+  user: { id: 1, name: 'Alice' }, token: 'demo-alice-token',
+})
+
+export const currentUser = () => current.value?.user ?? null
+export const sessionIdentity = () => current.value?.user.id ?? null
+
+/** 业务快照不填sessionKey；桥接层从自动会话补入，函数每次读取当前登录状态。 */
+export function getLatestHostContext() {
+  return { user: current.value?.user ?? {}, getToken: () => current.value?.token }
+}
+
+export function login(user: HostUser): void {
+  current.value = { user, token: `demo-token-${user.id}-${Date.now()}` }
+}
+export function logout(): void { current.value = null }
+/** 只换凭据：身份不变，插件保持同一个子应用实例。 */
+export function refreshToken(): void {
+  if (current.value) current.value = { ...current.value, token: `demo-refresh-${Date.now()}` }
+}

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

@@ -11,7 +11,7 @@
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@fulgurjs/federation": "6.11.4",
+    "@fulgurjs/federation": "6.12.0",
     "vue": "^3.5.13",
     "vue-router": "^4.5.0"
   },

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

@@ -11,8 +11,8 @@ importers:
   host:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.11.4
-        version: 6.11.4(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(typescript@5.9.3))
+        specifier: 6.12.0
+        version: 6.12.0(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(typescript@5.9.3))
       vue:
         specifier: ^3.5.13
         version: 3.5.44(typescript@5.9.3)
@@ -36,8 +36,8 @@ importers:
   remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.11.4
-        version: 6.11.4(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(typescript@5.9.3))
+        specifier: 6.12.0
+        version: 6.12.0(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(typescript@5.9.3))
       vue:
         specifier: ^3.5.13
         version: 3.5.44(typescript@5.9.3)
@@ -386,8 +386,8 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@fulgurjs/federation@6.11.4':
-    resolution: {integrity: sha512-FyBLpBwRbMcLY7tlUIGl2HJBCa+U1GmpQvhTITdJun8pFWfW+9uyNVf3CxZB8S1WizhbXgVuPeWyOgujdsF7rw==}
+  '@fulgurjs/federation@6.12.0':
+    resolution: {integrity: sha512-l37+A1drLgzIztZBTthhQKWuLXUwtsjfv5WQ2cqOHwMxVu/2qYwaacAk4OgDcN/6M4Vyjj8hMGNQL6Hd3Zr46Q==}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -955,7 +955,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@6.11.4(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(typescript@5.9.3))':
+  '@fulgurjs/federation@6.12.0(vite@6.4.4)(vue-router@4.6.4(vue@3.5.44(typescript@5.9.3)))(vue@3.5.44(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@6.11.4'
+  - '@fulgurjs/federation@6.11.4 || 6.12.0'
 # pnpm >=12 构建脚本批准（12 起弃用 onlyBuiltDependencies；pnpm 9-11 忽略本键：
 # esbuild >=0.16 二进制经 optionalDependencies 平台包分发，postinstall 仅校验，不阻塞安装）
 allowBuilds:

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

@@ -11,7 +11,7 @@
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@fulgurjs/federation": "6.11.4",
+    "@fulgurjs/federation": "6.12.0",
     "vue": "^3.5.13"
   },
   "devDependencies": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "6.11.7",
+  "version": "6.12.1",
   "type": "module",
   "description": "Vite Module Federation for Vue and React: remote modules, shared dependencies and app bridges.",
   "license": "MIT",
@@ -85,6 +85,10 @@
     "./internal/vue-store.js": {
       "types": "./dist/vue-store.d.ts",
       "import": "./dist/vue-store.js"
+    },
+    "./internal/bridge-session-auto.js": {
+      "types": "./dist/bridge-session-auto.d.ts",
+      "import": "./dist/bridge-session-auto.js"
     }
   },
   "typesVersions": {
@@ -122,7 +126,7 @@
     "types"
   ],
   "scripts": {
-    "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/types.md docs/zh/reference/ && cp ../../docs/en/reference/api.md ../../docs/en/reference/errors.md ../../docs/en/reference/types.md docs/en/reference/ && cp ../../docs/maintainers/webpack-mf-对照与缺口.md ../../docs/maintainers/沙箱边界审计.md ../../docs/maintainers/compatibility-testing.md docs/maintainers/ && cp ../../CHANGELOG.md CHANGELOG.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-session.ts src/bridge-app-vue.ts src/bridge-app-react.ts src/vue-store.ts src/bridge-host-vue.ts src/bridge-host-react.ts --format esm,cjs --dts --external vite --external @fulgurjs/federation/internal/registry.js --target node18 --clean && tsup src/runtime-entry.ts --format esm --dts --external vite --external @fulgurjs/federation/internal/registry.js --target node18 && tsup src/vue.ts --format esm --dts --external vite,vue,vue-router,@fulgurjs/federation/internal/registry.js --target node18 && tsup src/react.ts --format esm --dts --external vite,react,react-dom,react-router-dom,@fulgurjs/federation/internal/registry.js --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-tree-shaking.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/types.md docs/zh/reference/ && cp ../../docs/en/reference/api.md ../../docs/en/reference/errors.md ../../docs/en/reference/types.md docs/en/reference/ && cp ../../docs/maintainers/webpack-mf-对照与缺口.md ../../docs/maintainers/沙箱边界审计.md ../../docs/maintainers/compatibility-testing.md docs/maintainers/ && cp ../../CHANGELOG.md CHANGELOG.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-session.ts src/bridge-app-vue.ts src/bridge-app-react.ts src/vue-store.ts src/bridge-host-vue.ts src/bridge-host-react.ts src/bridge-session-auto.ts --format esm,cjs --dts --external vite --external @fulgurjs/federation/internal/registry.js --target node18 --clean && tsup src/runtime-entry.ts --format esm --dts --external vite --external @fulgurjs/federation/internal/registry.js --target node18 && tsup src/vue.ts --format esm --dts --external vite,vue,vue-router,@fulgurjs/federation/internal/registry.js --target node18 && tsup src/react.ts --format esm --dts --external vite,react,react-dom,react-router-dom,@fulgurjs/federation/internal/registry.js --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-tree-shaking.mjs && node scripts/check-manual-codes.mjs",
     "dev": "tsup --watch",
     "test": "vitest run --dir tests",
     "typecheck": "tsc --noEmit",

package/examples/templates/vue-host-react-remote/vue-host/src/fulgurjs/host/session.ts

@@ -1,29 +0,0 @@
-/**
- * 宿主自有会话源（示例实现）：返回「当前登录用户」的完整 AppContext 快照。
- * 要求（任务书 §4.3）：纯同步、无副作用、不调 provideAppContext、不返回 Promise。
- * 真实项目里通常读登录 store / token 管理器——只要保持「同步快照 getter」语义即可。
- */
-export interface HostSession {
-  key: string | null
-  user: { id: number; name: string }
-}
-
-let current: HostSession = { key: 'login-1-alice', user: { id: 1, name: 'Alice' } }
-
-export function getLatestHostContext(): Record<string, unknown> & { sessionKey: string } {
-  if (current.key === null) throw new Error('已登出：此刻不应有桥接代次请求 context')
-  return {
-    sessionKey: current.key,
-    user: current.user,
-    // 取最新 token 用拉取式函数引用，防止快照过期（README §9）
-    getToken: () => `token-for-${current.key}`,
-  }
-}
-
-export function login(key: string, user: { id: number; name: string }): void {
-  current = { key, user }
-}
-
-export function logout(): void {
-  current = { key: null, user: { id: 0, name: '' } }
-}