@fulgurjs/federation 6.8.7 → 6.9.0

package/examples/templates/vue-host-react-remote/scripts/prod.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/** Standalone template production launcher. Uses only Node and the existing dev.config.json. */
+import fs from 'node:fs'
+import path from 'node:path'
+import http from 'node:http'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const { apps } = JSON.parse(fs.readFileSync(path.join(root, 'scripts/dev.config.json'), 'utf8'))
+if (!Array.isArray(apps) || !apps.length) throw new Error('dev.config.json 未登记应用。')
+
+const mime = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json', '.svg': 'image/svg+xml', '.png': 'image/png', '.jpg': 'image/jpeg', '.woff': 'font/woff', '.woff2': 'font/woff2', '.map': 'application/json' }
+const inside = (file, directory) => file === directory || file.startsWith(directory + path.sep)
+const mounts = apps.map(app => {
+  const dir = path.resolve(root, app.dir, 'dist')
+  if (!inside(dir, root)) throw new Error(`${app.name}: 构建目录超出模板。`)
+  const index = path.join(dir, 'index.html')
+  if (!fs.existsSync(index)) throw new Error(`${app.name}: 缺少 dist/index.html，请先 pnpm build。`)
+  const html = fs.readFileSync(index, 'utf8')
+  const tags = [...html.matchAll(/<script\b[^>]*>/gi)]
+  const tag = tags.find(item => /\btype=["']module["']/i.test(item[0]))?.[0]
+  const src = tag?.match(/\bsrc=["']([^"']+)["']/i)?.[1]
+  if (!src || /^(?:https?:)?\/\//.test(src)) throw new Error(`${app.name}: 无可本地挂载的模块入口。`)
+  // Resolve the actual emitted file suffix, rather than guessing base from an app name.
+  const pathname = decodeURIComponent(new URL(src, 'http://template.local/').pathname)
+  const parts = pathname.split('/').filter(Boolean)
+  const bases = []
+  for (let i = 0; i < parts.length; i++) {
+    const file = path.resolve(dir, ...parts.slice(i))
+    if (inside(file, dir) && fs.existsSync(file) && fs.statSync(file).isFile()) bases.push('/' + parts.slice(0, i).join('/') + (i ? '/' : ''))
+  }
+  if (bases.length !== 1) throw new Error(`${app.name}: 无法唯一对应构建入口 ${src}；检查 Vite base 和干净构建输出。`)
+  return { ...app, dir, prefix: bases[0] }
+})
+const hosts = mounts.filter(app => app.host)
+if (!hosts.length) throw new Error('dev.config.json 未登记 host:true 的宿主。')
+const ports = new Set()
+const servers = []
+let stopping = false
+function stop(code = 0) {
+  if (stopping) return
+  stopping = true
+  for (const server of servers) server.close()
+  const timer = setTimeout(() => {
+    for (const server of servers) server.closeAllConnections?.()
+    process.exit(code)
+  }, 1000)
+  timer.unref()
+  process.exitCode = code
+}
+process.once('SIGINT', () => stop(0))
+process.once('SIGTERM', () => stop(0))
+process.once('uncaughtException', error => { console.error(error); stop(1) })
+
+for (const host of hosts) {
+  if (!Number.isInteger(host.port) || host.port < 1 || host.port > 65535 || ports.has(host.port)) throw new Error(`无效或重复宿主端口：${host.port}`)
+  ports.add(host.port)
+  const site = [host, ...mounts.filter(app => !app.host)].sort((a, b) => b.prefix.length - a.prefix.length)
+  const prefixes = new Set()
+  for (const app of site) {
+    if (prefixes.has(app.prefix)) throw new Error(`${host.name}: 构建 base ${app.prefix} 冲突；宿主和远程不能部署在同一路径。`)
+    prefixes.add(app.prefix)
+  }
+  const server = http.createServer((req, res) => {
+    try {
+      const url = new URL(req.url, `http://localhost:${host.port}`)
+      if (url.pathname === '/' && host.prefix !== '/') {
+        res.writeHead(302, { location: host.prefix, 'cache-control': 'no-cache' })
+        return res.end()
+      }
+      const app = site.find(item => url.pathname === item.prefix.slice(0, -1) || url.pathname.startsWith(item.prefix))
+      if (!app) { res.writeHead(404); return res.end('未登记此部署路径') }
+      const relative = decodeURIComponent(url.pathname.slice(app.prefix.length)) || 'index.html'
+      let file = path.resolve(app.dir, relative)
+      if (!inside(file, app.dir)) { res.writeHead(403); return res.end() }
+      if (!fs.existsSync(file) || fs.statSync(file).isDirectory()) {
+        if (path.extname(relative)) { res.writeHead(404); return res.end('资源不存在；不会回退成HTML') }
+        file = path.join(app.dir, 'index.html')
+      }
+      const stable = /(?:^|\/)(?:index\.html|fulgurjs-(?:remoteEntry\.js|manifest\.json)|_app\.config\.js)$/.test(file)
+      res.writeHead(200, {
+        'content-type': mime[path.extname(file)] ?? 'application/octet-stream',
+        'cache-control': stable ? 'no-cache' : 'public, max-age=31536000, immutable',
+        'access-control-allow-origin': '*',
+      })
+      res.end(fs.readFileSync(file))
+    } catch (error) {
+      console.error(`生产请求失败：${error.message}`)
+      if (!res.headersSent) res.writeHead(400)
+      res.end('无效请求或资源不可读')
+    }
+  })
+  servers.push(server)
+  server.on('error', error => {
+    console.error(`${host.name}:${host.port} 启动失败：${error.message}；停止本次全部生产服务器，不会按端口杀已有进程。`)
+    stop(1)
+  })
+  server.listen(host.port, '127.0.0.1', () => {
+    if (!stopping) console.log(`生产宿主 ${host.name}: http://localhost:${host.port}${host.prefix}（仅dist，无开发服务器）`)
+  })
+}

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

@@ -11,7 +11,7 @@
     "typecheck": "vue-tsc --noEmit"
   },
   "dependencies": {
-    "@fulgurjs/federation": "6.8.5",
+    "@fulgurjs/federation": "6.9.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "vue": "^3.5.13"

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

@@ -0,0 +1,5 @@
+import { createApp } from 'vue'
+import { defineApplication } from '@fulgurjs/federation/vue'
+import App from './App.vue'
+
+export default defineApplication(() => createApp(App))

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

@@ -1,4 +1,2 @@
-import { createApp } from 'vue'
-import App from './App.vue'
-
-createApp(App).mount('#app')
+import application from './application'
+void application.start('#app').catch(console.error)

package/examples/templates/vue-vue/README.md

@@ -1,5 +1,8 @@
 # Vue 联邦示例：宿主 + 远程（可直接复制运行）
 
+> 本目录是 6.9.0 源码候选：已改用 defineApplication，尚未测试和发布。源码依赖已锁定 6.9.0；正式发布前不要拿旧 registry 包运行这份代码。验收先使用本次候选 tarball，发布后再按下列冻结安装命令验证正式包。
+
+
 本目录是一对完整、可独立安装运行的 Vue 3 模块联邦演示：
 
 | 目录 | 角色 | 端口 | 说明 |
@@ -7,7 +10,7 @@
 | [`remote/`](./remote/) | **Vue 远程**（被消费方） | 5213 | 暴露可点击按钮组件、普通 TS 工具模块、联邦首页与参数详情页 |
 | [`host/`](./host/) | **Vue 宿主**（消费方） | 5214 | 消费 vue-remote 的组件/模块/页面，提供导航与懒加载 |
 
-- 包管理器为 **pnpm**；复制整个模板目录，包含 workspace 和锁文件。插件使用 registry 正式精确版本。
+- 包管理器为 **pnpm**；复制整个模板目录，包含 workspace 和锁文件。插件精确依赖本轮 6.9.0；正式包是否可用见本页顶部状态。
 
 ## 最快开始（从干净拷贝）
 
@@ -105,3 +108,24 @@ server {
 - 改remote（默认 5213）：① `remote/package.json` 的 `dev` 与 `preview` 两个脚本的 `--port 5213`；② `host/fulgurjs.config.ts` 里 `remotes['vue-remote'].dev` 的 `http://localhost:5213`；③ 根 `scripts/dev.config.json` 里 remote 的 `port`（**必改**：启动器预检/探活都读它）；④ 本 README 顶部端口表。
 - 改host（默认 5214）：① `host/package.json` 的 `dev`/`preview` `--port 5214`；② `scripts/dev.config.json`；③ 本 README 端口表。
 - 生产部署地址（`prod`，如 `/remote`）是站点路径，与 dev 端口无关，改端口不要动它。改名（容器名）不建议：还需同步 spec 前缀与页面表。
+
+## 一键运行生产产物
+
+```bash
+pnpm build
+pnpm prod
+```
+
+`prod` 只服务本次 dist，不启动远程开发服务器。它复用 scripts/dev.config.json 的宿主端口，从实际构建入口推导 base，并把远程静态产物挂在同源子路径。无需为本地复现手写 Nginx；部署真实服务器时仍按部署指南配置。多宿主模板分别启动各宿主地址，不把两个宿主的根资源混在一起。先停止 dev，端口占用会失败并停止本次已起服务；不会关闭已有占用进程。Ctrl+C 关闭本次生产服务。
+
+## 插件代码阅读地图
+
+| 文件 | 职责 |
+|---|---|
+| `host/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `remote/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
+| `remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
+| `scripts/dev.mjs` / `scripts/prod.mjs` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |
+
+`application` 是新增的插件装配文件，`main` 是已有入口接线；页面组件、业务路由、权限和数据不是每个项目都必写的联邦配置。跨框架基础组合不逐页登记子应用菜单；逐页远程页面模板的页面表仅服务它所展示的逐页场景。`src/fulgurjs/types/` 是插件生成目录，按远程实际版本同步，不维护人工伪造的声明或旧缓存。

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

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

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

@@ -0,0 +1,54 @@
+import { createApp, h } from 'vue'
+import { createRouter, createWebHistory, useRoute } from 'vue-router'
+import { defineApplication, createHostPages } from '@fulgurjs/federation/vue'
+import App from './App.vue'
+import HomePage from './pages/HomePage.vue'
+import UtilsDemo from './pages/UtilsDemo.vue'
+import { pages, remotePrefixes } from '../fulgurjs.config.ts'
+
+// 页面适配器：URL 解析、最长前缀远程归属、异步组件缓存、
+// 加载/错误占位（含「重试加载 / 刷新页面重试」）全部由插件完成。
+const hostPages = createHostPages({
+  pages,
+  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,
+        })
+    },
+  },
+}))
+
+// 应用装配只写一次；每次 start 创建自己的 router。
+export default defineApplication(() => {
+  const router = createRouter({
+    history: createWebHistory(import.meta.env.BASE_URL),
+    routes: [
+      { path: '/', component: HomePage },
+      { path: '/utils-demo', component: UtilsDemo },
+      ...remoteRoutes,
+    ],
+  })
+
+  return { app: createApp(App), router }
+})

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

@@ -1,51 +1,4 @@
-import { createApp, h } from 'vue'
-import { createRouter, createWebHistory, useRoute } from 'vue-router'
-import { createHostPages } from '@fulgurjs/federation/vue'
-import App from './App.vue'
-import HomePage from './pages/HomePage.vue'
-import UtilsDemo from './pages/UtilsDemo.vue'
-import { pages, remotePrefixes } from '../fulgurjs.config.ts'
+import application from './application'
 
-// 页面适配器：URL 解析、最长前缀远程归属、异步组件缓存、
-// 加载/错误占位（含「重试加载 / 刷新页面重试」）全部由插件完成。
-const hostPages = createHostPages({
-  pages,
-  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 },
-    ...remoteRoutes,
-  ],
-})
-
-createApp(App).use(router).mount('#app')
+// 独立入口只负责启动；初始化写在 application 中。
+void application.start('#app').catch(console.error)

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

@@ -6,6 +6,7 @@
     "dev:remote": "pnpm --dir remote dev",
     "dev:host": "pnpm --dir host dev",
     "dev": "node scripts/dev.mjs",
-    "build": "pnpm --dir remote build && pnpm --dir host build"
+    "build": "pnpm --dir remote build && pnpm --dir host build",
+    "prod": "node scripts/prod.mjs"
   }
 }

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

@@ -11,8 +11,8 @@ importers:
   host:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.8.5
-        version: 6.8.5(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.0(vite@6.4.4)(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)
@@ -36,8 +36,8 @@ importers:
   remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.8.5
-        version: 6.8.5(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.0(vite@6.4.4)(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)
@@ -386,8 +386,8 @@ packages:
     cpu: [x64]
     os: [win32]
 
-  '@fulgurjs/federation@6.8.5':
-    resolution: {integrity: sha512-RsaN4n2ZgGBtI9zVQxDclS3QxYVKAZiCGipXR3umreAg651tIYCmtqkVjqPELSCPW9tg/rYQvzzs/SOV6ZiQfg==}
+  '@fulgurjs/federation@6.9.0':
+    resolution: {tarball: https://registry.npmjs.org/@fulgurjs/federation/-/federation-6.9.0.tgz}
     engines: {node: '>=18'}
     hasBin: true
     peerDependencies:
@@ -955,7 +955,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@6.8.5(vite@6.4.4)(vue-router@4.6.4(vue@3.5.43(typescript@5.9.3)))(vue@3.5.43(typescript@5.9.3))':
+  '@fulgurjs/federation@6.9.0(vite@6.4.4)(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@6.8.5'
+  - '@fulgurjs/federation@6.9.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.8.5",
+    "@fulgurjs/federation": "6.9.0",
     "vue": "^3.5.13"
   },
   "devDependencies": {

package/examples/templates/vue-vue/remote/src/application.ts

@@ -0,0 +1,6 @@
+import { createApp } from 'vue'
+import { defineApplication } from '@fulgurjs/federation/vue'
+import App from './App.vue'
+
+// 普通组件远程不需要额外桥接/路由；独立调试仍由同一应用入口启动。
+export default defineApplication(() => createApp(App))

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

@@ -1,6 +1,4 @@
-import { createApp } from 'vue'
-import App from './App.vue'
+import application from './application'
 
-// 独立运行入口：单独开发/调试远程自身时使用。
-// 被宿主消费时走的是 fulgurjs-remoteEntry.js 容器入口，与本文件无关。
-createApp(App).mount('#app')
+// 独立入口只负责启动；初始化写在 application 中。
+void application.start('#app').catch(console.error)

package/examples/templates/vue-vue/scripts/prod.mjs

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+/** Standalone template production launcher. Uses only Node and the existing dev.config.json. */
+import fs from 'node:fs'
+import path from 'node:path'
+import http from 'node:http'
+import { fileURLToPath } from 'node:url'
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const { apps } = JSON.parse(fs.readFileSync(path.join(root, 'scripts/dev.config.json'), 'utf8'))
+if (!Array.isArray(apps) || !apps.length) throw new Error('dev.config.json 未登记应用。')
+
+const mime = { '.html': 'text/html; charset=utf-8', '.js': 'text/javascript', '.css': 'text/css', '.json': 'application/json', '.svg': 'image/svg+xml', '.png': 'image/png', '.jpg': 'image/jpeg', '.woff': 'font/woff', '.woff2': 'font/woff2', '.map': 'application/json' }
+const inside = (file, directory) => file === directory || file.startsWith(directory + path.sep)
+const mounts = apps.map(app => {
+  const dir = path.resolve(root, app.dir, 'dist')
+  if (!inside(dir, root)) throw new Error(`${app.name}: 构建目录超出模板。`)
+  const index = path.join(dir, 'index.html')
+  if (!fs.existsSync(index)) throw new Error(`${app.name}: 缺少 dist/index.html，请先 pnpm build。`)
+  const html = fs.readFileSync(index, 'utf8')
+  const tags = [...html.matchAll(/<script\b[^>]*>/gi)]
+  const tag = tags.find(item => /\btype=["']module["']/i.test(item[0]))?.[0]
+  const src = tag?.match(/\bsrc=["']([^"']+)["']/i)?.[1]
+  if (!src || /^(?:https?:)?\/\//.test(src)) throw new Error(`${app.name}: 无可本地挂载的模块入口。`)
+  // Resolve the actual emitted file suffix, rather than guessing base from an app name.
+  const pathname = decodeURIComponent(new URL(src, 'http://template.local/').pathname)
+  const parts = pathname.split('/').filter(Boolean)
+  const bases = []
+  for (let i = 0; i < parts.length; i++) {
+    const file = path.resolve(dir, ...parts.slice(i))
+    if (inside(file, dir) && fs.existsSync(file) && fs.statSync(file).isFile()) bases.push('/' + parts.slice(0, i).join('/') + (i ? '/' : ''))
+  }
+  if (bases.length !== 1) throw new Error(`${app.name}: 无法唯一对应构建入口 ${src}；检查 Vite base 和干净构建输出。`)
+  return { ...app, dir, prefix: bases[0] }
+})
+const hosts = mounts.filter(app => app.host)
+if (!hosts.length) throw new Error('dev.config.json 未登记 host:true 的宿主。')
+const ports = new Set()
+const servers = []
+let stopping = false
+function stop(code = 0) {
+  if (stopping) return
+  stopping = true
+  for (const server of servers) server.close()
+  const timer = setTimeout(() => {
+    for (const server of servers) server.closeAllConnections?.()
+    process.exit(code)
+  }, 1000)
+  timer.unref()
+  process.exitCode = code
+}
+process.once('SIGINT', () => stop(0))
+process.once('SIGTERM', () => stop(0))
+process.once('uncaughtException', error => { console.error(error); stop(1) })
+
+for (const host of hosts) {
+  if (!Number.isInteger(host.port) || host.port < 1 || host.port > 65535 || ports.has(host.port)) throw new Error(`无效或重复宿主端口：${host.port}`)
+  ports.add(host.port)
+  const site = [host, ...mounts.filter(app => !app.host)].sort((a, b) => b.prefix.length - a.prefix.length)
+  const prefixes = new Set()
+  for (const app of site) {
+    if (prefixes.has(app.prefix)) throw new Error(`${host.name}: 构建 base ${app.prefix} 冲突；宿主和远程不能部署在同一路径。`)
+    prefixes.add(app.prefix)
+  }
+  const server = http.createServer((req, res) => {
+    try {
+      const url = new URL(req.url, `http://localhost:${host.port}`)
+      if (url.pathname === '/' && host.prefix !== '/') {
+        res.writeHead(302, { location: host.prefix, 'cache-control': 'no-cache' })
+        return res.end()
+      }
+      const app = site.find(item => url.pathname === item.prefix.slice(0, -1) || url.pathname.startsWith(item.prefix))
+      if (!app) { res.writeHead(404); return res.end('未登记此部署路径') }
+      const relative = decodeURIComponent(url.pathname.slice(app.prefix.length)) || 'index.html'
+      let file = path.resolve(app.dir, relative)
+      if (!inside(file, app.dir)) { res.writeHead(403); return res.end() }
+      if (!fs.existsSync(file) || fs.statSync(file).isDirectory()) {
+        if (path.extname(relative)) { res.writeHead(404); return res.end('资源不存在；不会回退成HTML') }
+        file = path.join(app.dir, 'index.html')
+      }
+      const stable = /(?:^|\/)(?:index\.html|fulgurjs-(?:remoteEntry\.js|manifest\.json)|_app\.config\.js)$/.test(file)
+      res.writeHead(200, {
+        'content-type': mime[path.extname(file)] ?? 'application/octet-stream',
+        'cache-control': stable ? 'no-cache' : 'public, max-age=31536000, immutable',
+        'access-control-allow-origin': '*',
+      })
+      res.end(fs.readFileSync(file))
+    } catch (error) {
+      console.error(`生产请求失败：${error.message}`)
+      if (!res.headersSent) res.writeHead(400)
+      res.end('无效请求或资源不可读')
+    }
+  })
+  servers.push(server)
+  server.on('error', error => {
+    console.error(`${host.name}:${host.port} 启动失败：${error.message}；停止本次全部生产服务器，不会按端口杀已有进程。`)
+    stop(1)
+  })
+  server.listen(host.port, '127.0.0.1', () => {
+    if (!stopping) console.log(`生产宿主 ${host.name}: http://localhost:${host.port}${host.prefix}（仅dist，无开发服务器）`)
+  })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "6.8.7",
+  "version": "6.9.0",
   "type": "module",
   "description": "Vite Module Federation for Vue and React: remote modules, shared dependencies and app bridges.",
   "license": "MIT",
@@ -81,6 +81,10 @@
     "./internal/registry.js": {
       "types": "./types/registry.d.ts",
       "import": "./types/registry.mjs"
+    },
+    "./internal/vue-store.js": {
+      "types": "./dist/vue-store.d.ts",
+      "import": "./dist/vue-store.js"
     }
   },
   "typesVersions": {
@@ -110,15 +114,15 @@
     "docs/zh/reference/errors.md",
     "docs/en/reference/api.md",
     "docs/en/reference/errors.md",
-    "docs/maintainers/webpack-mf-\u5bf9\u7167\u4e0e\u7f3a\u53e3.md",
-    "docs/maintainers/\u6c99\u7bb1\u8fb9\u754c\u5ba1\u8ba1.md",
+    "docs/maintainers/webpack-mf-对照与缺口.md",
+    "docs/maintainers/沙箱边界审计.md",
     "docs/maintainers/compatibility-testing.md",
     "docs/zh/reference/types.md",
     "docs/en/reference/types.md",
     "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-\u5bf9\u7167\u4e0e\u7f3a\u53e3.md ../../docs/maintainers/\u6c99\u7bb1\u8fb9\u754c\u5ba1\u8ba1.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/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-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 --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-manual-codes.mjs",
     "dev": "tsup --watch",
     "test": "vitest run --dir tests",
     "typecheck": "tsc --noEmit",
@@ -136,23 +140,24 @@
     "@types/react": "19.3.0",
     "@types/react-dom": "19.3.0",
     "jsdom": "^24.0.0",
+    "pinia": "3.0.4",
     "react": "19.3.0",
     "react-dom": "19.3.0",
+    "react-router-dom": "^7.18.4",
     "tsup": "^8.4.0",
     "typescript": "^5.8.0",
     "vitest": "^3.1.0",
     "vue": "^3.5.22",
     "vue-router": "^4.6.4",
-    "react-router-dom": "^7.18.4",
     "vue-tsc": "^3.3.12"
   },
   "peerDependencies": {
-    "vite": ">=5.1.0",
-    "vue": ">=3.2.0",
     "react": ">=18.0.0 <20",
     "react-dom": ">=18.0.0 <20",
-    "vue-router": ">=4.1.0 <6",
-    "react-router-dom": ">=6.11.0 <8"
+    "react-router-dom": ">=6.11.0 <8",
+    "vite": ">=5.1.0",
+    "vue": ">=3.2.0",
+    "vue-router": ">=4.1.0 <6"
   },
   "pnpm": {
     "onlyBuiltDependencies": [

package/examples/templates/react-host-vue-remote/react-host/src/fulgurjs/types/bridge-vue-remote/metadata.json

@@ -1,15 +0,0 @@
-{
-  "generator": "@fulgurjs/federation",
-  "ambientFormat": 2,
-  "alias": "bridge-vue-remote",
-  "source": "/bridge-vue-remote/fulgurjs-remoteEntry.js",
-  "revision": "6e2e820a47f98238",
-  "files": [
-    "modules.d.ts",
-    "registry.d.ts"
-  ],
-  "externals": [
-    "@fulgurjs/federation"
-  ],
-  "syncedAt": 1791598089894
-}

package/examples/templates/react-host-vue-remote/react-host/src/fulgurjs/types/bridge-vue-remote/modules.d.ts

@@ -1,14 +0,0 @@
-// 自动生成：fulgurjs-federation 远程类型（remote: bridge-vue-remote，来源: /bridge-vue-remote/fulgurjs-remoteEntry.js，revision: 6e2e820a47f98238）。
-// 本文件由插件管理（dev 自动同步 / npx @fulgurjs/federation types），手动修改会被覆盖。
-// 外部类型依赖（宿主需可解析）：@fulgurjs/federation。
-declare module "bridge-vue-remote/bridge" {
-  /** props 类型：appProps 由宿主传入（label + 稳定回调 onReady） */
-  export interface BridgeVueProps {
-      label?: string;
-      onReady?: () => void;
-  }
-  const _default: import("@fulgurjs/federation/vue").BridgeApp & {
-      __fgBridgeProps?: Record<string, unknown> | undefined;
-  };
-  export default _default;
-}

package/examples/templates/react-host-vue-remote/react-host/src/fulgurjs/types/bridge-vue-remote/registry.d.ts

@@ -1,10 +0,0 @@
-// 自动生成：远程类型注册表（remote: bridge-vue-remote，revision: 6e2e820a47f98238）。
-// 向插件共享注册表（internal/registry.js 的 FgRemoteTypes）登记本远程全部公开入口；
-// loadRemote / remoteComponent / createVueBridgeApp / createReactBridgeApp 共享该注册表。
-import '@fulgurjs/federation/internal/registry.js'
-
-declare module '@fulgurjs/federation/internal/registry.js' {
-  interface FgRemoteTypes {
-    "bridge-vue-remote/bridge": typeof import("bridge-vue-remote/bridge")
-  }
-}