@fulgurjs/federation 5.9.3 → 6.0.0

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-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.0.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);