@fulgurjs/federation 5.2.4 → 5.3.0

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

@@ -0,0 +1,21 @@
+{
+  "name": "fulgurjs-demo-bridge-vue-remote",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite --port 5313 --strictPort",
+    "build": "vite build",
+    "preview": "vite preview --port 5313 --strictPort"
+  },
+  "dependencies": {
+    "@fulgurjs/federation": "5.3.0",
+    "vue": "^3.5.13",
+    "vue-router": "^4.5.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "typescript": "^5.8.0",
+    "vite": "^6.3.5"
+  }
+}

package/examples/bridge/vue-remote/src/App.vue

@@ -0,0 +1,12 @@
+<script setup lang="ts">
+import { ref } from 'vue'
+
+// 子应用自身的页面组件（独立运行态与桥接态共用）
+const count = ref(0)
+</script>
+
+<template>
+  <div>
+    <button data-testid="demo-vue-counter" @click="count++">本地状态：{{ count }}</button>
+  </div>
+</template>

package/examples/bridge/vue-remote/src/bridge.ts

@@ -0,0 +1,57 @@
+/**
+ * Vue 子应用桥接契约（./bridge expose 的默认导出，任务书 §3.3）。
+ *
+ * defineBridgeApp 工厂接收 props 快照，返回装配完整的 VueApp——
+ * 路由、状态库等插件在这里自行装配；挂载/卸载与按容器跟踪由契约负责。
+ */
+import { createApp, defineComponent, h, ref } from 'vue'
+import { createMemoryHistory, createRouter, RouterView, useRoute, useRouter } from 'vue-router'
+import { defineBridgeApp } from '@fulgurjs/federation/runtime'
+
+/** props 类型：appProps 由宿主传入（label + 稳定回调 onReady） */
+export interface BridgeVueProps {
+  label?: string
+  onReady?: () => void
+}
+
+const Root = defineComponent({
+  name: 'BridgeVueRoot',
+  props: {
+    label: { type: String, default: '' },
+    onReady: { type: Function, default: undefined },
+  },
+  setup(props) {
+    const route = useRoute()
+    const router = useRouter()
+    const mountTime = ref(new Date().toLocaleTimeString())
+    props.onReady?.()
+    return () =>
+      h('div', { style: 'border:1px solid #42b883;border-radius:8px;padding:12px;font-family:sans-serif' }, [
+        h('p', { style: 'margin:0 0 6px;font-weight:600;color:#42b883' }, `Vue 子应用（挂载于 ${mountTime.value}）`),
+        h('p', { 'data-testid': 'demo-vue-props', style: 'margin:0 0 6px' }, `appProps.label = ${props.label || '（未传）'}`),
+        h('p', { 'data-testid': 'demo-vue-route', style: 'margin:0 0 8px' }, `memory 路由：${String(route.path)}`),
+        h('nav', { style: 'margin-bottom:8px' }, [
+          h('button', { onClick: () => router.push('/'), style: 'margin-right:8px' }, '首页'),
+          h('button', { onClick: () => router.push('/about') }, '关于'),
+        ]),
+        h(RouterView),
+      ])
+  },
+})
+
+const HomePage = defineComponent({ setup: () => () => h('p', { 'data-testid': 'demo-vue-page' }, '页面：首页') })
+const AboutPage = defineComponent({ setup: () => () => h('p', { 'data-testid': 'demo-vue-page' }, '页面：关于') })
+
+export default defineBridgeApp((props) => {
+  const router = createRouter({
+    // 子应用内部用 memory 路由（v1 不与宿主 URL 同步，见 README §12）
+    history: createMemoryHistory(),
+    routes: [
+      { path: '/', component: HomePage },
+      { path: '/about', component: AboutPage },
+    ],
+  })
+  const app = createApp(Root, props)
+  app.use(router)
+  return app
+})

package/examples/bridge/vue-remote/src/env.d.ts

@@ -0,0 +1,7 @@
+/// <reference types="vite/client" />
+
+declare module '*.vue' {
+  import type { DefineComponent } from 'vue'
+  const component: DefineComponent<Record<string, never>, Record<string, never>, unknown>
+  export default component
+}

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

@@ -0,0 +1,15 @@
+import { createApp, defineComponent, h } from 'vue'
+import App from './App.vue'
+
+// 独立运行入口：单独开发/调试子应用自身时使用（渲染同一套页面组件）。
+// 被桥接宿主消费时走 fulgurjs-remoteEntry.js 容器入口与 ./bridge 契约，与本文件无关。
+const Standalone = defineComponent({
+  setup() {
+    return () =>
+      h('div', { style: 'font-family:sans-serif;padding:16px' }, [
+        h('h1', 'bridge-vue-remote（独立运行态）'),
+        h(App),
+      ])
+  },
+})
+createApp(Standalone).mount('#app')

package/examples/bridge/vue-remote/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "jsx": "preserve",
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["vite/client"]
+  },
+  "include": ["src", "fulgurjs.config.ts", "vite.config.ts"]
+}

package/examples/bridge/vue-remote/vite.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { federation } from '@fulgurjs/federation'
+import fulgurjsConfig from './fulgurjs.config'
+
+export default defineConfig(({ command }) => ({
+  base: command === 'build' ? '/bridge-vue-remote/' : undefined,
+  plugins: [vue(), federation(fulgurjsConfig)],
+}))

package/examples/react/host/package-lock.json

@@ -8,7 +8,7 @@
       "name": "fulgurjs-demo-react-host",
       "version": "0.0.0",
       "dependencies": {
-        "@fulgurjs/federation": "5.2.4",
+        "@fulgurjs/federation": "5.2.5",
         "react": "^19.1.0",
         "react-dom": "^19.1.0",
         "react-router-dom": "^7.1.0"
@@ -720,8 +720,8 @@
       }
     },
     "node_modules/@fulgurjs/federation": {
-      "version": "5.2.4",
-      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.4.tgz",
+      "version": "5.2.5",
+      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.5.tgz",
       "license": "MIT",
       "dependencies": {
         "es-module-lexer": "^1.6.0",

package/examples/react/host/package.json

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

package/examples/react/remote/package-lock.json

@@ -8,7 +8,7 @@
       "name": "fulgurjs-demo-react-remote",
       "version": "0.0.0",
       "dependencies": {
-        "@fulgurjs/federation": "5.2.4",
+        "@fulgurjs/federation": "5.2.5",
         "react": "^19.1.0",
         "react-dom": "^19.1.0"
       },
@@ -719,8 +719,8 @@
       }
     },
     "node_modules/@fulgurjs/federation": {
-      "version": "5.2.4",
-      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.4.tgz",
+      "version": "5.2.5",
+      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.5.tgz",
       "license": "MIT",
       "dependencies": {
         "es-module-lexer": "^1.6.0",

package/examples/react/remote/package.json

@@ -9,7 +9,7 @@
     "preview": "vite preview --port 5203 --strictPort"
   },
   "dependencies": {
-    "@fulgurjs/federation": "5.2.4",
+    "@fulgurjs/federation": "5.2.5",
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },

package/examples/react/remote/vite.config.ts

@@ -3,6 +3,7 @@ import react from '@vitejs/plugin-react'
 import { federation } from '@fulgurjs/federation'
 import fulgurjsConfig from './fulgurjs.config.ts'
 
-export default defineConfig({
+export default defineConfig(({ command }) => ({
+  base: command === 'build' ? '/react-remote/' : undefined,
   plugins: [react(), federation(fulgurjsConfig)],
-})
+}))

package/examples/vue/README.md

@@ -48,7 +48,7 @@ cd vue/remote && npm run build -- --base=/vue-remote/   # 产物 remote/dist/（
 cd vue/host   && npm run build   # 产物 host/dist/
 ```
 
-部署形态：宿主部署在站点根 `/`，远程部署在子路径 `/vue-remote/`（与 `host/fulgurjs.config.ts` 的 `prod: '/vue-remote'` 对应）。远程构建产物内部的 chunk 引用是相对路径，天然适配子路径。最小 Nginx 配置（SPA fallback + 联邦入口正确 Content-Type）：
+部署形态：宿主部署在站点根 `/`，远程部署在子路径 `/vue-remote/`（与 `host/fulgurjs.config.ts` 的 `prod: '/vue-remote'` 对应）。远程工程的 `vite.config.ts` 已配置 `base` 随 `build` 命令自动切换为 `/vue-remote/`（dev 不变）——Vite 的 preload helper 会把依赖链接转成根绝对路径，远程子路径部署必须带此 base。最小 Nginx 配置（SPA fallback + 联邦入口正确 Content-Type）：
 
 ```nginx
 server {

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

@@ -8,7 +8,7 @@
       "name": "fulgurjs-demo-vue-host",
       "version": "0.0.0",
       "dependencies": {
-        "@fulgurjs/federation": "5.2.4",
+        "@fulgurjs/federation": "5.2.5",
         "vue": "^3.5.13",
         "vue-router": "^4.5.0"
       },
@@ -481,8 +481,8 @@
       }
     },
     "node_modules/@fulgurjs/federation": {
-      "version": "5.2.4",
-      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.4.tgz",
+      "version": "5.2.5",
+      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.5.tgz",
       "license": "MIT",
       "dependencies": {
         "es-module-lexer": "^1.6.0",

package/examples/vue/host/package.json

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

package/examples/vue/remote/README.md

@@ -40,7 +40,7 @@ utils.sumNumbers(2, 3, 7) // 12
 npm run build        # dist/（含 fulgurjs-remoteEntry.js 与 fulgurjs-manifest.json）
 ```
 
-部署到 Nginx 子路径 `/vue-remote/`（与宿主 `fulgurjs.config.ts` 的 `prod: '/vue-remote'` 对应；产物内 chunk 引用为相对路径，天然适配子路径）。完整 Nginx 示例见[组合说明](../README.md#生产构建与最小-nginx-部署)。
+部署到 Nginx 子路径 `/vue-remote/`（与宿主 `fulgurjs.config.ts` 的 `prod: '/vue-remote'` 对应；`vite.config.ts` 已配置 `base` 随 `build` 自动切换为 `/vue-remote/`（dev 不受影响）；不要去掉它，否则 modulepreload 链接会指向站点根导致 404）。完整 Nginx 示例见[组合说明](../README.md#生产构建与最小-nginx-部署)。
 
 ## 故障演练（配合宿主）
 

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

@@ -8,7 +8,7 @@
       "name": "fulgurjs-demo-vue-remote",
       "version": "0.0.0",
       "dependencies": {
-        "@fulgurjs/federation": "5.2.4",
+        "@fulgurjs/federation": "5.2.5",
         "vue": "^3.5.13"
       },
       "devDependencies": {
@@ -480,8 +480,8 @@
       }
     },
     "node_modules/@fulgurjs/federation": {
-      "version": "5.2.4",
-      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.4.tgz",
+      "version": "5.2.5",
+      "resolved": "https://registry.npmjs.org/@fulgurjs/federation/-/federation-5.2.5.tgz",
       "license": "MIT",
       "dependencies": {
         "es-module-lexer": "^1.6.0",

package/examples/vue/remote/package.json

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

package/examples/vue/remote/vite.config.ts

@@ -3,6 +3,7 @@ import vue from '@vitejs/plugin-vue'
 import { federation } from '@fulgurjs/federation'
 import fulgurjsConfig from './fulgurjs.config.ts'
 
-export default defineConfig({
+export default defineConfig(({ command }) => ({
+  base: command === 'build' ? '/vue-remote/' : undefined,
   plugins: [vue(), federation(fulgurjsConfig)],
-})
+}))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "5.2.4",
+  "version": "5.3.0",
   "type": "module",
   "description": "Vite Module Federation with full Webpack MF parity. Dev & production, no compromise.",
   "license": "MIT",
@@ -21,6 +21,18 @@
       "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",
@@ -41,6 +53,26 @@
       "types": "./dist/react-adapter.d.ts",
       "import": "./dist/react-adapter.js",
       "require": "./dist/react-adapter.cjs"
+    },
+    "./internal/bridge-core.js": {
+      "types": "./dist/bridge-core.d.ts",
+      "import": "./dist/bridge-core.js"
+    },
+    "./internal/bridge-app-vue.js": {
+      "types": "./dist/bridge-app-vue.d.ts",
+      "import": "./dist/bridge-app-vue.js"
+    },
+    "./internal/bridge-app-react.js": {
+      "types": "./dist/bridge-app-react.d.ts",
+      "import": "./dist/bridge-app-react.js"
+    },
+    "./internal/bridge-host-vue.js": {
+      "types": "./dist/bridge-host-vue.d.ts",
+      "import": "./dist/bridge-host-vue.js"
+    },
+    "./internal/bridge-host-react.js": {
+      "types": "./dist/bridge-host-react.d.ts",
+      "import": "./dist/bridge-host-react.js"
     }
   },
   "typesVersions": {
@@ -50,6 +82,15 @@
       ],
       "react": [
         "dist/react.d.ts"
+      ],
+      "bridge/vue": [
+        "dist/bridge-vue.d.ts"
+      ],
+      "bridge/react": [
+        "dist/bridge-react.d.ts"
+      ],
+      "bridge": [
+        "dist/bridge.d.ts"
       ]
     }
   },
@@ -67,7 +108,7 @@
     "docs/P5-vite7-8兼容矩阵.md"
   ],
   "scripts": {
-    "build": "cp ../../README.md README.md && cp ../../README.en.md README.en.md && mkdir -p docs && cp ../../docs/迁移指南.md ../../docs/webpack-mf-对照与缺口.md ../../docs/沙箱边界审计.md ../../docs/P5-vite7-8兼容矩阵.md docs/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && rm -rf examples && cp -R ../../examples examples && find examples \\( -name node_modules -o -name dist -o -path '*/src/fulgurjs/types' \\) -exec rm -rf {} + && 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 --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 && 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 && cp ../../docs/迁移指南.md ../../docs/webpack-mf-对照与缺口.md ../../docs/沙箱边界审计.md ../../docs/P5-vite7-8兼容矩阵.md docs/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && rm -rf examples && cp -R ../../examples examples && find examples \\( -name node_modules -o -name dist -o -path '*/src/fulgurjs/types' \\) -exec rm -rf {} + && 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 && 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",
     "typecheck": "tsc --noEmit",