@fulgurjs/federation 6.8.7 → 6.9.0

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

@@ -0,0 +1,28 @@
+import { createApp } from 'vue'
+import { createRouter, createWebHistory } from 'vue-router'
+import { defineApplication } from '@fulgurjs/federation/vue'
+import App from './App.vue'
+import HomePage from './pages/HomePage.vue'
+import AboutPage from './pages/AboutPage.vue'
+import BridgeReactPage from './pages/BridgeReactPage.vue'
+import { initBridgeRouting } from './routing'
+import { installGuard } from './guard'
+import { installPopStateLogger } from './demo-log'
+
+export default defineApplication((_props, { signal }) => {
+  const router = createRouter({
+    history: createWebHistory(import.meta.env.BASE_URL),
+    routes: [
+      { path: '/', component: HomePage },
+      { path: '/about', component: AboutPage },
+      // catch-all：子应用挂载在 /br-react 前缀下，内部导航全部命中同一条路由记录
+      { path: '/br-react/:pathMatch(.*)*', component: BridgeReactPage },
+    ],
+  })
+
+  initBridgeRouting(router)
+  installGuard(router)
+  installPopStateLogger(signal)
+
+  return { app: createApp(App), router }
+})

package/examples/templates/showcase/vue-host/src/demo-log.ts

@@ -37,13 +37,10 @@ export function handleChildEvent(event: DemoChildEvent): void {
   logNav(event.source, `${event.action} ${event.detail}`)
 }
 
-let popInstalled = false
-
-/** 浏览器前进后退（POP）在 main.ts 安装一次；push/replace 由各自来源显式标注 */
-export function installPopStateLogger(): void {
-  if (popInstalled) return
-  popInstalled = true
+/** POP 观测属于本应用实例；卸载后由 signal 移除，不遗留窗口监听。 */
+export function installPopStateLogger(signal: AbortSignal): void {
+  if (signal.aborted) return
   window.addEventListener('popstate', () => {
     logNav('浏览器前进后退', window.location.pathname + window.location.search)
-  })
+  }, { signal })
 }

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

@@ -1,30 +1,2 @@
-/**
- * examples/templates/showcase/vue-host/src/main.ts — 宿主入口。
- * 宿主 Router 是浏览器历史唯一写入方；catch-all 路由（/br-react/* 单条记录渲染同一组件）
- * 保证子应用内部导航不重挂宿主组件。守卫与 POP 日志在此一次性安装。
- */
-import { createApp } from 'vue'
-import { createRouter, createWebHistory } from 'vue-router'
-import App from './App.vue'
-import HomePage from './pages/HomePage.vue'
-import AboutPage from './pages/AboutPage.vue'
-import BridgeReactPage from './pages/BridgeReactPage.vue'
-import { initBridgeRouting } from './routing'
-import { installGuard } from './guard'
-import { installPopStateLogger } from './demo-log'
-
-const router = createRouter({
-  history: createWebHistory(),
-  routes: [
-    { path: '/', component: HomePage },
-    { path: '/about', component: AboutPage },
-    // catch-all：子应用挂载在 /br-react 前缀下，内部导航全部命中同一条路由记录
-    { path: '/br-react/:pathMatch(.*)*', component: BridgeReactPage },
-  ],
-})
-
-initBridgeRouting(router)
-installGuard(router)
-installPopStateLogger()
-
-createApp(App).use(router).mount('#app')
+import application from './application'
+void application.start('#app').catch(console.error)

package/examples/templates/showcase/vue-host/src/routing.ts

@@ -1,6 +1,6 @@
 /**
  * examples/templates/showcase/vue-host/src/routing.ts — 桥接宿主导航端口（模块级单例）。
- * main.ts 组装宿主 router 后初始化一次：createVueBridgeNavigation(router)——
+ * application.ts 组装宿主 router 后初始化一次：createVueBridgeNavigation(router)——
  * Vue Router fullPath 已剥离 history base，逻辑路径无需再处理部署前缀；
  * 端口引用保持稳定 → routing 键不变，宿主不重挂、不重复订阅。
  */
@@ -16,6 +16,6 @@ export function initBridgeRouting(router: Router): void {
 }
 
 export function getBridgeRouting(): BridgeHostRouting {
-  if (!routing) throw new Error('桥接路由端口未初始化：请先在 main.ts 调用 initBridgeRouting(router)')
+  if (!routing) throw new Error('桥接路由端口未初始化：请先在 application.ts 调用 initBridgeRouting(router)')
   return routing
 }

package/examples/templates/showcase/vue-remote/fulgurjs.config.ts

@@ -9,7 +9,7 @@ export default {
   name: 'vue-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './bridge': './src/bridge.ts',
+    './bridge': './src/application.ts',
   },
   shared: {
     vue: { singleton: true },

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

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

package/examples/templates/showcase/vue-remote/src/ChildLayout.vue

@@ -7,7 +7,8 @@
 import { getCurrentInstance } from 'vue'
 import { hasBridgeMount } from '@fulgurjs/federation/vue'
 import { RouterView, useRouter } from 'vue-router'
-import { getMountCount, reportNav } from './child-bus'
+import { useChildReporter } from './child-bus'
+const { getMountCount, reportNav } = useChildReporter()
 
 // 查询当前 app，而不是页面是否存在其他桥接实例。
 const bridged = hasBridgeMount(getCurrentInstance()?.appContext.app)
@@ -39,7 +40,7 @@ const handleGoForward = (): void => {
   <section class="demo-child">
     <p data-demo-bridge-mode>当前应用被桥接：{{ String(bridged) }}</p>
     <p class="demo-child-title">
-      <strong>Vue 子应用</strong>（受控 memory 路由）· 本会话挂载次数：{{ getMountCount() }}
+      <strong>Vue 子应用</strong>（{{ bridged ? '受控 memory' : '独立 web' }} 路由）· 本会话挂载次数：{{ getMountCount() }}
     </p>
     <div class="demo-row">
       <button @click="handlePushDemo">子应用 push /orders?q=演示&amp;page=2</button>

package/examples/templates/showcase/vue-remote/src/{bridge.ts → application.ts}

@@ -1,17 +1,13 @@
-/**
- * examples/templates/showcase/vue-remote/src/bridge.ts — Vue 子应用桥接契约（exposes './bridge'）。
- * defineBridgeApp(factory, { routing: true }) 声明路由协议（缺失时宿主启用同步即 MFU-031 占位）。
- * 返回 { app, router }，插件等待初始位置、安装路由、挂载并在卸载时释放连接。
- */
+// 独立与桥接装配唯一入口；返回未安装的 app/router，交给插件等待与挂载。
 import { createApp } from 'vue'
-import { createMemoryHistory, createRouter, type RouteRecordRaw } from 'vue-router'
-import { defineBridgeApp } from '@fulgurjs/federation/vue'
+import { createMemoryHistory, createWebHistory, createRouter, type RouteRecordRaw } from 'vue-router'
+import { defineApplication } from '@fulgurjs/federation/vue'
 import ChildLayout from './ChildLayout.vue'
 import OrderList from './pages/OrderList.vue'
 import OrderDetail from './pages/OrderDetail.vue'
 import Settings from './pages/Settings.vue'
 import Locked from './pages/Locked.vue'
-import { bindReporter, reportNav } from './child-bus'
+import { createChildReporter, childReporterKey, type ChildProps } from './child-bus'
 
 const routes: RouteRecordRaw[] = [
   // 根路径以 replace 规范化到 /orders（不产生额外历史条目）
@@ -22,19 +18,20 @@ const routes: RouteRecordRaw[] = [
   { path: '/locked', component: Locked },
 ]
 
-export default defineBridgeApp((props, ctx) => {
-  bindReporter(props)
+export default defineApplication<ChildProps>((props, ctx) => {
+  const reporter = createChildReporter(props, ctx.signal)
   // 初始位置先读快照（规范化 replace 后对比上报）
   const init = ctx?.routing?.getLocation()
   const initPath = init ? init.pathname + init.search + init.hash : ''
-  const router = createRouter({ history: createMemoryHistory(), routes })
-  const app = createApp(ChildLayout, props)
+  const router = createRouter({ history: ctx.mode === 'bridge' ? createMemoryHistory() : createWebHistory(import.meta.env.BASE_URL), routes })
+  const app = createApp(ChildLayout)
+  app.provide(childReporterKey, reporter)
   // afterEach 记录初始导航结果；路由安装与连接清理由插件负责。
   let reported = false
   router.afterEach((to, _from, failure) => {
     if (reported || failure) return
     reported = true
-    reportNav(
+    reporter.reportNav(
       '子应用初始化',
       'init',
       to.fullPath !== initPath

package/examples/templates/showcase/vue-remote/src/child-bus.ts

@@ -1,32 +1,32 @@
-/**
- * examples/templates/showcase/vue-remote/src/child-bus.ts — 子应用 → 宿主观测台上报总线。
- * 宿主经 appProps 传入稳定回调 onChildEvent；本模块持有该引用并维护挂载计数。
- * 单页单实例假设：同一宿主页同时只挂一个本子应用实例（路由同步前缀互斥的常规形态）。
- */
-export type DemoChildNavAction = 'push' | 'replace' | 'go' | 'init'
+/** 应用实例自己的观测回调，通过原生 provide/Context 传给实际消费树。 */
+import { inject, type InjectionKey } from 'vue'
 
+export type DemoChildNavAction = 'push' | 'replace' | 'go' | 'init'
 export type DemoChildEvent =
   | { type: 'mounted'; mountCount: number }
   | { type: 'nav'; source: string; action: DemoChildNavAction; detail: string }
-
 export type DemoChildReporter = (event: DemoChildEvent) => void
-
-const bus: { report: DemoChildReporter | undefined } = { report: undefined }
-let mountCount = 0
-
-/** 桥接工厂内调用：从 props 快照中取出宿主回调，并上报本次挂载计数 */
-export function bindReporter(props: Record<string, unknown> | undefined): void {
-  const candidate = (props as { onChildEvent?: DemoChildReporter } | undefined)?.onChildEvent
-  bus.report = typeof candidate === 'function' ? candidate : undefined
-  mountCount += 1
-  bus.report?.({ type: 'mounted', mountCount })
+export interface ChildReporter {
+  reportNav(source: string, action: DemoChildNavAction, detail: string): void
+  getMountCount(): number
 }
-
-/** 导航来源上报（子应用 Link / 子应用 push·replace / 子应用 go / 子应用初始化） */
-export function reportNav(source: string, action: DemoChildNavAction, detail: string): void {
-  bus.report?.({ type: 'nav', source, action, detail })
+export interface ChildProps { onChildEvent?: DemoChildReporter }
+// 仅观测编号跨挂载累加；回调和所属实例不放在模块全局。
+let nextMount = 0
+export function createChildReporter(props: ChildProps, signal: AbortSignal): ChildReporter {
+  const mountCount = ++nextMount
+  if (!signal.aborted) props.onChildEvent?.({ type: 'mounted', mountCount })
+  return {
+    getMountCount: () => mountCount,
+    reportNav(source, action, detail) {
+      if (!signal.aborted) props.onChildEvent?.({ type: 'nav', source, action, detail })
+    },
+  }
 }
 
-export function getMountCount(): number {
-  return mountCount
+export const childReporterKey: InjectionKey<ChildReporter> = Symbol('child-reporter')
+export function useChildReporter(): ChildReporter {
+  const reporter = inject(childReporterKey)
+  if (!reporter) throw new Error('子应用观测台未装配；从 application 工厂启动本应用。')
+  return reporter
 }

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

@@ -1,16 +1,2 @@
-/**
- * examples/templates/showcase/vue-remote/src/main.ts — 独立运行入口（仅 dev 占位）。
- * 子应用真实能力经 exposes './bridge' 被宿主加载；直开本页仅作 dev server 健康检查。
- */
-import { createApp, h } from 'vue'
-
-createApp({
-  render: () =>
-    h('div', { style: "font-family: 'PingFang SC', 'Microsoft YaHei', sans-serif; padding: 24px" }, [
-      h('h1', null, 'vue-remote（联邦子应用，默认端口 5335，改端口见 README「改端口」清单）'),
-      h('p', null, '本应用通过 expose ./bridge（defineBridgeApp + routing 协议）被宿主加载。'),
-      h('p', null, [
-        h('a', { href: 'http://localhost:5336/br-vue/orders' }, '打开 React 宿主桥接页（默认 5336）'),
-      ]),
-    ]),
-}).mount('#app')
+import application from './application'
+void application.start('#app').catch(console.error)

package/examples/templates/showcase/vue-remote/src/pages/Locked.vue

@@ -4,7 +4,8 @@
  * 前往本页的导航会被宿主守卫（Vue：异步 beforeEach；React：useBlocker）拦截，等待「继续/取消」。
  */
 import { useRouter } from 'vue-router'
-import { reportNav } from '../child-bus'
+import { useChildReporter } from '../child-bus'
+const { reportNav } = useChildReporter()
 
 const router = useRouter()
 

package/examples/templates/showcase/vue-remote/src/pages/OrderDetail.vue

@@ -5,7 +5,8 @@
  */
 import { computed } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { reportNav } from '../child-bus'
+import { useChildReporter } from '../child-bus'
+const { reportNav } = useChildReporter()
 
 const route = useRoute()
 const router = useRouter()

package/examples/templates/showcase/vue-remote/src/pages/OrderList.vue

@@ -6,7 +6,8 @@
  */
 import { computed, ref } from 'vue'
 import { useRoute, useRouter } from 'vue-router'
-import { reportNav } from '../child-bus'
+import { useChildReporter } from '../child-bus'
+const { reportNav } = useChildReporter()
 
 interface OrderItem {
   id: number

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

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

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

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

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

@@ -11,8 +11,8 @@ importers:
   react-remote:
     dependencies:
       '@fulgurjs/federation':
-        specifier: 6.8.5
-        version: 6.8.5(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.4)(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.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.4)(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: 6.8.5
-        version: 6.8.5(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.4)(vue@3.5.43(typescript@5.9.3))
+        specifier: 6.9.0
+        version: 6.9.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.4)(vue@3.5.43(typescript@5.9.3))
       react:
         specifier: ^19.1.0
         version: 19.3.0
@@ -470,8 +470,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:
@@ -1284,7 +1284,7 @@ snapshots:
   '@esbuild/win32-x64@0.27.7':
     optional: true
 
-  '@fulgurjs/federation@6.8.5(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.4)(vue@3.5.43(typescript@5.9.3))':
+  '@fulgurjs/federation@6.9.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.4)(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@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-host-react-remote/react-remote/README.md

@@ -1,25 +1,25 @@
-# bridge-react-remote — React 桥接子应用示例
+# react-remote — React 子应用
 
-`@fulgurjs/federation` 跨框架桥接的 **React 18/19 子应用**侧示例：以 `defineBridgeApp`（`@fulgurjs/federation/react`）导出 `mount/unmount` 契约，可被 **Vue 宿主**（配合 `examples/templates/vue-host-react-remote/vue-host-react-remote/vue-host`）整站挂载。
+本模板对应未验收的 6.9.0 源码候选，状态与安装方法见[组合说明](../README.md)。复制整个组合目录，在组合根启动。
 
-## 运行
+## 按顺序读源码
 
-复制整个 `vue-host-react-remote/` 模板，在模板根执行：
+1. `fulgurjs.config.ts`：`./bridge` 直接 expose `src/application.tsx`，公开模块名称不受文件名称约束。
+2. `src/application.tsx`：`defineApplication` 唯一装配；独立模式用浏览器路由，桥接模式用本地 memory 路由，两者显示同一套真实页面、计数与 props。
+3. `src/main.tsx`：只调用 application.start，不再复制初始化或新增转发文件。
+4. `vue-host/`：宿主的挂载、会话与回调，见[组合说明](../README.md)。
 
-```bash
-pnpm install --frozen-lockfile
-pnpm dev                         # 同时启动宿主和子应用
-pnpm build                       # 构建完整组合
-# 单独启动本应用：pnpm --dir react-remote dev
-```
+应用代码只从 `@fulgurjs/federation/react` 导入插件 API；子应用不因跨框架嵌入而安装另一框架。这个基础组合不启用宿主 URL 同步；需要地址双向同步时使用 showcase 模板。
 
-端口、复制范围与部署路径见[组合说明](../README.md)。
+独立启动可以切换首页/关于页，桥接也使用相同页面；卸载与首次挂载由插件管理。Vue 返回未安装的 app/router，React 返回 BrowserRouter/MemoryRouter 内的同一组件树。
 
-## 关键点
+## 运行
 
-- `src/bridge.tsx`：`defineBridgeApp((props) => <MemoryRouter>…</MemoryRouter>)`，作为 `./bridge` expose 的默认导出。
-- `mount` 的 Promise 在**首次根提交完成后**才 resolve（契约内建提交探针）；首次渲染前报错会拒绝挂载并转 MFU-016。
-- `react-dom/client` 在实际 mount 时才按需加载；共享子路径 `react-dom/client` 与 `react/jsx-runtime` 由宿主/子应用 shared 配方协商单实例。
-- 子应用只安装并共享 `react` + `react-dom`（+ `react-router-dom` 为直接依赖），**不安装 Vue**。
+```bash
+pnpm install --frozen-lockfile
+pnpm dev
+pnpm build
+pnpm prod
+```
 
-配套阅读：根目录 README §8.2「跨框架桥接 API — /bridge」。
+以上正式安装命令须在 6.9.0 发布后执行；候选验收先按组合根的候选说明使用本轮 tarball。

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

@@ -1,14 +1,14 @@
 import type { FederationOptions } from '@fulgurjs/federation'
 
 /**
- * React 子应用联邦配置：`./bridge` expose = defineBridgeApp 契约模块（任务书 §3.3）。
+ * React 子应用联邦配置：`./bridge` expose = defineApplication 统一应用契约。
  * 子应用只安装并共享自己的框架（react + react-dom），不为桥接安装 Vue。
  */
 export default {
   name: 'bridge-react-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './bridge': './src/bridge.tsx',
+    './bridge': './src/application.tsx',
   },
   shared: {
     react: { singleton: true },

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

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

package/examples/templates/vue-host-react-remote/react-remote/src/{bridge.tsx → application.tsx}

@@ -1,12 +1,6 @@
-/**
- * React 子应用桥接契约（./bridge expose 的默认导出，任务书 §3.3）。
- *
- * defineBridgeApp 工厂接收 props 快照、返回 ReactElement；
- * createRoot/首次提交探测/unmount 由契约实现负责（react-dom/client 在实际 mount 时按需加载）。
- */
 import { useEffect, useState } from 'react'
-import { MemoryRouter, Route, Routes, useLocation, useNavigate } from 'react-router-dom'
-import { defineBridgeApp } from '@fulgurjs/federation/react'
+import { BrowserRouter, MemoryRouter, Route, Routes, useLocation, useNavigate } from 'react-router-dom'
+import { defineApplication } from '@fulgurjs/federation/react'
 
 /** 挂载即回调（宿主验证函数引用跨 root 传递） */
 function OnReady({ onReady }: { onReady?: () => void }) {
@@ -27,14 +21,16 @@ function Counter() {
   )
 }
 
-function Shell(props: Record<string, unknown>) {
+export interface BridgeReactProps { label?: string; onReady?: () => void }
+
+function Shell(props: BridgeReactProps) {
   const location = useLocation()
   const navigate = useNavigate()
   return (
     <div style={{ border: '1px solid #61dafb', borderRadius: 8, padding: 12, fontFamily: 'sans-serif' }}>
       <p style={{ margin: '0 0 6px', fontWeight: 600, color: '#0b7285' }}>React 子应用</p>
       <p data-testid="demo-react-props" style={{ margin: '0 0 6px' }}>
-        {`appProps.label = ${(props as any).label || '（未传）'}`}
+        {`appProps.label = ${props.label || '（未传）'}`}
       </p>
       <p data-testid="demo-react-route" style={{ margin: '0 0 8px' }}>{`memory 路由：${location.pathname}`}</p>
       <nav style={{ marginBottom: 8 }}>
@@ -50,17 +46,10 @@ function Shell(props: Record<string, unknown>) {
   )
 }
 
-export function App() {
-  return (
-    <MemoryRouter>
-      <Shell />
-    </MemoryRouter>
-  )
-}
-
-export default defineBridgeApp((props) => (
-  <MemoryRouter>
-    <OnReady onReady={(props as any).onReady} />
-    <Shell {...props} />
-  </MemoryRouter>
-))
+// 独立入口与桥接共享同一套页面、状态和 onReady。
+export default defineApplication<BridgeReactProps>((props, { mode }) => {
+  const content = <><OnReady onReady={props.onReady} /><Shell {...props} /></>
+  return mode === 'bridge'
+    ? <MemoryRouter>{content}</MemoryRouter>
+    : <BrowserRouter basename={import.meta.env.BASE_URL}>{content}</BrowserRouter>
+})

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

@@ -1,7 +1,2 @@
-import { createElement } from 'react'
-import { createRoot } from 'react-dom/client'
-import { App } from './bridge'
-
-// 独立运行入口：单独开发/调试子应用自身时使用。
-// 被桥接宿主消费时走 fulgurjs-remoteEntry.js 容器入口与 ./bridge 契约，与本文件无关。
-createRoot(document.getElementById('root')!).render(createElement(App))
+import application from './application'
+void application.start('#root', { label: '独立 React 子应用' }).catch(console.error)