@fulgurjs/federation 0.9.1-test.1 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,70 @@
 # Changelog
 
+## 2.0.0（2026-09-22）
+
+### 破坏性变更（公开 API 去掉冗余品牌前缀，无兼容别名）
+
+背景：包名与子路径已承担命名空间职责（`@fulgurjs/federation/context` 等），标识符再挂 `Fulgurjs`
+前缀属纯冗余，且长度失控（`provideFulgurjsAppContext` 达 26 字符）。本版统一去前缀，**旧名直接移除**。
+
+| 子路径 | 旧名 | 新名 |
+|---|---|---|
+| `/context` | `provideFulgurjsAppContext` | `provideAppContext` |
+| | `getFulgurjsAppContext` | `getAppContext` |
+| | `requireFulgurjsAppContext` | `requireAppContext` |
+| | `FulgurjsAppContext` | `AppContext` |
+| `/pages` | `defineFulgurjsPages` | `definePages` |
+| | `validateFulgurjsPages` | `validatePages` |
+| | `FulgurjsPagesOptions` / `FulgurjsPageRouteLike` | `PagesOptions` / `PageRouteLike` |
+| `/config` | `defineFulgurjsConfig` | `defineRepoConfig` |
+| | `loadFulgurjsConfig` | `loadRepoConfig` |
+| | `FulgurjsRepoConfig` / `FulgurjsAppConfig` / `FulgurjsUserConfig` | `RepoConfig` / `AppConfig` / `UserConfig` |
+| | `FulgurjsHostConfig` / `FulgurjsRemoteConfig` / `FulgurjsDeployConfig` | `HostConfig` / `RemoteConfig` / `DeployConfig` |
+| | `FulgurjsPageEntry` / `FulgurjsRemoteAddress` | `PageEntry` / `RemoteAddress` |
+| 主入口 | `FulgurjsOptions` | `FederationOptions` |
+| 运行时 | `FulgurjsRuntime`（类型） | `FgRuntime` |
+| | `FulgurjsError`（内部类，仅经 `err.name` 可见） | `FgError` |
+
+两处命名取舍：
+
+- `defineRepoConfig` 而非 `defineConfig`——避开与 vite 的 `defineConfig` 撞名（`fulgurjs.config.ts`
+  描述的是「一个仓库的多个应用」）。
+- 运行时错误 `err.name` 由 `FulgurjsError` 变为 `FgError`：该类不在导出面（用户从不 import，
+  只经 `err.code` / `err.name` 观察），若有按 `name` 匹配错误的监控配置需同步。`err.code`（MFU-xxx 等）
+  语义与取值不变。
+
+### 刻意保持不变的品牌元素
+
+- **跨应用单例键** `globalThis.__FULGURJS_RUNTIME__` / `__FULGURJS_APP_CONFIG__` / `__FULGURJS_SCOPE__`：
+  跨版本互操作契约——改了会让新旧版本互相看不见对方的运行时与 context 存储。
+- 虚拟模块 `virtual:fulgurjs-runtime`、CLI `fulgurjs`、配置文件 `fulgurjs.config.ts`、错误码前缀 `[fulgurjs:MFU-001]`。
+- 运行时函数名（`loadRemote` / `loadShare` / `preloadRemote` / `registerRemote(s)` / `initSharing` /
+  `getContainer` / `getRuntime` / `unwrapDefault` / `parseSpec`）：对齐 webpack Module Federation 命名，便于迁移对照。
+
+### 迁移
+
+按上表把旧名替换为新名即可，语义一一对应、无行为变化。注意 `provide/get/requireFulgurjsAppContext`
+三个是「含前缀的完整函数名」，新名为 `provide/get/requireAppContext`（去的是 `Fulgurjs` 与 `AppContext`
+之间的品牌词，`AppContext` 保留）。
+
+## 1.0.0（2026-09-22）
+
+### 破坏性变更（正式定版，API 面冻结）
+
+- **删除旧配置 API**：`provideFulgurjsAppConfig` / `getFulgurjsAppConfig` 从 runtime、虚拟门面
+  （`virtual:fulgurjs-runtime` 委托模块）、`client.d.ts` 类型面全部移除——跨应用传值**唯一通道**为
+  `@fulgurjs/federation/context` 的 `provideFulgurjsAppContext` / `getFulgurjsAppContext` /
+  `requireFulgurjsAppContext`。存储本体即全局镜像对象 `window.__FULGURJS_APP_CONFIG__`（不再经
+  runtime 转发），runtime 包体相应缩减。
+- 迁移：全局搜索 `provideFulgurjsAppConfig` / `getFulgurjsAppConfig` 替换为 context 子路径对应函数
+  （语义一一对应，仅函数名与导入路径变化）。
+
+### 清理（无历史遗留）
+
+- **移除 `docs/manual.html`**（早期手册的历史存档，其引用的截图已不在仓库）——README 为唯一权威文档。
+- 设计文档状态勘误：D.2 / D.4 / D.5 已实施项的状态标记修正（原标注"待执行/未实现"）。
+
+
 ## 0.9.0（2026-09-21）
 
 ### 新增（发布可靠性 + IDE 边界 + 配置面）

package/DESIGN.md

@@ -2,7 +2,7 @@
 
 > **品牌**：fulgurjs，拉丁语「闪电 · 辉光」，取自作者名中「烨」字的意译。
 > 系列规划：`@fulgurjs/federation`（模块联邦）→ `@fulgurjs/micro`、`@fulgurjs/dts` …
-> 内外命名统一 `fulgurjs`（`virtual:fulgurjs-*` 虚拟模块、`window.__FULGURJS_*` 调试出口、`FulgurjsError` / MFU 错误码）。
+> 内外命名统一 `fulgurjs`（`virtual:fulgurjs-*` 虚拟模块、`window.__FULGURJS_*` 调试出口、`FgError` / MFU 错误码）。
 
 > 状态：已实现并验证（2026-09-13）。测试结果：单测 76/76、fixtures dev e2e 10/10、容错/HMR-L3 2/2、fixtures prod e2e 8/8（隔离 NGINX 8999）、testbed dev 实测全通、testbed prod（本地 NGINX 测试站点）最小宿主消费真实远程产物实测通过；runtime gzip 4.4KB。已知问题见手册 §7。
 > 日期：2026-09-12
@@ -158,9 +158,9 @@ remote 样式改动立即生效；host 自身业务 HMR 不受影响。
 - **dev 与 prod（NGINX）两套截图各自备齐**，手册按环境归档引用
 - 手动冒烟（如后台接口连通、NGINX reload）同样截图留证
 
-## 7. 交付物：HTML 使用手册（测试完成后编写）
+## 7. 文档交付物
 
-单文件 HTML（`docs/manual.html`，双击浏览器打开即可浏览全部功能，无外部服务依赖）：
+**唯一权威文档 = 仓库根 `README.md`**（随 npm 包发布，GitHub 与 npm 双端可读）；迁移路径见 `docs/迁移指南.md`。内容组织：
 
 1. **功能总览**：§2 配置对齐表直接入册——每个 webpack 选项/运行时语义一行，标注 **与 webpack 原版一致性**（✅ 完全一致 / 🔶 适配差异 + 差异说明），明确回答"是否和 webpack 一模一样"
 2. **快速开始**：安装、remote/host 配置完整代码块（高亮），配 vite.config 实际文件截图

package/README.md

@@ -32,10 +32,10 @@
 - **HMR 全链路**：remote 改动 → host 页面热更，L1 组件热替换 / L2 状态保留 / L3 错误覆盖与恢复
 - **零报错纪律**：配置问题启动瞬间三段式报错；联邦失败显式抛错（错误码 + 可执行修复建议），**无任何静默兜底路径**
 - **CLI（主包内置 bin）**：`fulgurjs init`——`fulgurjs.config.ts` 单配置驱动的迁移生成器（模板 = 真实工程验证形态：vite 配置/路由表/桥/联邦启动器/NGINX conf 全量编码，锚点补丁幂等可续跑）；`fulgurjs doctor`——部署面体检（remoteEntry/manifest/HTML 缓存头与形态、CORS、chunk 抽样可达、版本 skew 预演、`--dev` 端口探测）
-- **跨应用传值与方法引用**：`@fulgurjs/federation/context` 子路径——`provideFulgurjsAppContext` / `getFulgurjsAppContext` / `requireFulgurjsAppContext`（缺键 `CC-001` 三段式、独立直开远程页 `CC-002` 显式）。宿主桥一次写入页面级单例（user/token/getToken/store/hostApp/locale/events 标准字段 + 项目扩展位），远程 boot 显式校验消费；方法引用两条通道 = context 携带函数引用（热路径直调）+ exposes 方法模块 `loadRemote('remote/api')`（低频重逻辑）。旧名 `provideFulgurjsAppConfig/getFulgurjsAppConfig` 保留为 deprecated 别名（存储同一份）。数据语义 = 传输层快照 + 函数引用，非响应式（与乾坤 props 同语义；"实时"靠函数引用拉取 / 宿主 pinia 共享 / 登录刷新三通道）
+- **跨应用传值与方法引用**：`@fulgurjs/federation/context` 子路径——`provideAppContext` / `getAppContext` / `requireAppContext`（缺键 `CC-001` 三段式、独立直开远程页 `CC-002` 显式）。宿主桥一次写入页面级单例（user/token/getToken/store/hostApp/locale/events 标准字段 + 项目扩展位），远程 boot 显式校验消费；方法引用两条通道 = context 携带函数引用（热路径直调）+ exposes 方法模块 `loadRemote('remote/api')`（低频重逻辑）。数据语义 = 传输层快照 + 函数引用，非响应式（与乾坤 props 同语义；"实时"靠函数引用拉取 / 宿主 pinia 共享 / 登录刷新三通道）
 - **Vue 直渲染**：`remoteComponent('remote/X')`（`@fulgurjs/federation/vue` 子路径）——`defineAsyncComponent + loadRemote` 的标准封装，加载失败显式错误占位（错误码+根因+修法），runtime.js 零框架依赖零体积增量
 - **CSP 友好**：原生 ESM 加载路径全程无 `eval` / `new Function`，可在严格 CSP（无 `unsafe-eval`）下运行
-- **全链路错误码体系（32 码）**：CFG/DEV/BLD/MFU/CC 五段 + 手册 §8 码表防漂移校验
+- **全链路错误码体系（30 码）**：CFG/DEV/BLD/MFU/CC 五段 + 手册 §8 码表防漂移校验
 
 ## 安装
 
@@ -147,7 +147,7 @@ npx fulgurjs doctor --base http://localhost:5173 --apps app-a --dev
 
 ## API 参考
 
-以下覆盖插件的全部公开 API，签名与默认值与源码一致——**本 README 为唯一权威文档**（仓库内 `docs/manual.html` 为早期补充手册，部分内容基于较早形态，仅作参考）。
+以下覆盖插件的全部公开 API，签名与默认值与源码一致——**本 README 为唯一权威文档**。
 
 ### 1. `federation(options)` — Vite 插件（宿主/远程同一份 API）
 
@@ -162,7 +162,7 @@ import { federation } from '@fulgurjs/federation'
 | `name` | `string` **必填** | — | 容器名。同页面宿主/远程必须唯一（也是 uniqueName）；须匹配 `/^[a-zA-Z][\w.-]*$/` |
 | `filename` | `string` | `'fulgurjs-remoteEntry.js'` | prod 容器入口文件名（固定文件名，CDN 可长缓存） |
 | `exposes` | `Record<string, string \| { import: string; name?: string }>` | — | 对外暴露模块：键 `'./X'`，值源文件路径；`name` 为稳定 chunk 文件名 |
-| `remotes` | `Record<string, string \| RemoteConfig \| (() => Promise<any>)>` | — | 消费的远程，三种形态见下表 |
+| `remotes` | `Record<string, string \| RemoteEntryConfig \| (() => Promise<any>)>` | — | 消费的远程，三种形态见下表 |
 | `shared` | `string[] \| Record<string, string \| SharedHint>` | — | 共享依赖；字符串简写 = requiredVersion（缺省从本应用 package.json 推断） |
 | `shareScope` | `string` | `'default'` | 默认共享作用域名 |
 | `remoteType` | `string` | `'module'` | 仅支持 `'module'`（传其它值告警并回落） |
@@ -229,7 +229,7 @@ shared: {
 
 ```ts
 // 宿主页面、远程页面，写法完全一致
-import { loadRemote, provideFulgurjsAppConfig } from 'virtual:fulgurjs-runtime'
+import { loadRemote } from 'virtual:fulgurjs-runtime'
 ```
 
 > 仍可绕过代理直取全局单例（等价，调试用）：`(globalThis as any).__FULGURJS_RUNTIME__`。
@@ -244,13 +244,11 @@ import { loadRemote, provideFulgurjsAppConfig } from 'virtual:fulgurjs-runtime'
 | `loadShare` | `(name: string, opts?) => Promise<命名空间>` | 共享模块协商（最高版本胜出/已加载优先/singleton 收敛）。opts：`{ requiredVersion?, singleton?, strictVersion?, shareKey?, shareScope?, fallback? }` |
 | `preloadRemote` | `(spec: string, opts?: { mode?: 'preload' \| 'prefetch' }) => Promise<void>` | 按 manifest 精确预载该远程全部 expose chunk + CSS（prefetch = 空闲时低优先级） |
 | `getContainer` | `(name: string) => Promise<容器>` | 取远程容器（触发加载 + init），容器协议 `{ name, init, get }` |
-| `registerRemote` / `registerRemotes` | `(config \| list) => void` | 运行时注册远程（promise remote / 动态地址）。RemoteConfig：`{ name, entry, shareScope?, timeout?, retries?, fallback?, breaker? }` |
+| `registerRemote` / `registerRemotes` | `(config \| list) => void` | 运行时注册远程（promise remote / 动态地址）。`RemoteInput`：`{ name, entry, shareScope?, timeout?, retries?, fallback?, breaker? }` |
 | `registerShare` | `(scope, name, version, get, opts?) => void` | 手工注册共享模块（一般由 init 模块自动完成） |
 | `initSharing` | `(scopeName?) => ShareScopeMap` | 初始化共享作用域（一般由 init 模块自动完成） |
 | `registerPlugins` | `(plugins: RuntimePlugin[]) => void` | 注册运行时插件（见下） |
-| `provideFulgurjsAppConfig` | `(config: Record<string, any>) => void` | **@deprecated** 改用 `@fulgurjs/federation/context` 的 `provideFulgurjsAppContext`（存储同一份；见 §9） |
-| `getFulgurjsAppConfig` | `() => Record<string, any>` | **@deprecated** 改用 `@fulgurjs/federation/context` 的 `getFulgurjsAppContext`（存储同一份；见 §9） |
-| `getRuntime` | `() => FulgurjsRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
+| `getRuntime` | `() => FgRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
 | `version` | `string` | 运行时/插件版本（跨源副本一致性诊断用） |
 | `unwrapDefault` | `(ns: any) => any` | ESM/CJS default interop 工具 |
 
@@ -292,15 +290,15 @@ export default {
 | `window.__FULGURJS_APP_CONFIG__` | W4 全局配置镜像 |
 | `window` 事件 `fulgurjs:error` | `CustomEvent<{ remote, error }>`，所有远程加载/共享错误都会发出 |
 
-### 3. `defineFulgurjsPages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
+### 3. `definePages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
 
 宿主把「URL 路径 → 远程 exposes 键」的映射表交给它校验，带参路由的静默冲突在启动期报错而不是运行时加载错组件：
 
 ```ts
-import { defineFulgurjsPages } from '@fulgurjs/federation/pages'
+import { definePages } from '@fulgurjs/federation/pages'
 import remoteSchema from 'virtual:fulgurjs-remote-schema' // dev 自动生成；build 恒为空（诚实降级）
 
-export const PAGES = defineFulgurjsPages(
+export const PAGES = definePages(
   [
     { route: '/remote-a/home', name: 'RemoteAHome', title: '首页' },
     // 带参路由：缺省推导 spec = 去首段 + 剥 :参 段；与其它条目冲突时 ERROR，
@@ -326,14 +324,14 @@ export const PAGES = defineFulgurjsPages(
 | R4 | ERROR | 静态路由被更靠前的带参路由遮蔽（先到先得）／路由完全重复 |
 | R5 | WARN | name 重复（vue-router 命名跳转歧义） |
 
-`validateFulgurjsPages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
+`validatePages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
 
 ### 4. `fulgurjs.config.ts` — CLI 单配置文件（`@fulgurjs/federation/config`）
 
 ```ts
-import { defineFulgurjsConfig } from '@fulgurjs/federation/config'
+import { defineRepoConfig } from '@fulgurjs/federation/config'
 
-export default defineFulgurjsConfig({
+export default defineRepoConfig({
   root: process.cwd(),            // 工程根（monorepo 根或单应用仓库根）
   apps: [
     {
@@ -366,7 +364,7 @@ export default defineFulgurjsConfig({
 | `fulgurjs init --config <path>` | 校验配置（CFG 三段式报错）+ 输出各应用 `federation()` 粘贴块、NGINX no-cache 站点模板、8 条通用核对清单 |
 | `fulgurjs doctor --base <URL> --apps <a,b,c>` | 部署体检：remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、CORS、chunk 抽样可达、版本 skew 预演。`--dev` 检查 dev 容器入口；`--json` 输出 JSON（CI 断言）；`--chunk-sample N` 控制抽样数（默认 16）。**退出码：有 FAIL 即 1**，可直接做 CI 门禁 |
 
-### 6. 错误码总表（32 个）
+### 6. 错误码总表（30 个）
 
 | 段 | 码 | 含义 |
 |---|---|---|
@@ -380,11 +378,9 @@ export default defineFulgurjsConfig({
 | | `CFG-008` | shared 非法组合（eager+import:false / shareKey 重复声明） |
 | DEV 开发期 | `DEV-001` | remote dev server 不可达（manifest 拉取失败） |
 | | `DEV-002` | remote dev manifest 为空或格式不识别 |
-| | `DEV-003` | shared 键被 optimizeDeps.exclude（已撤回，码表保留） |
 | | `DEV-004` | 已知 UMD-only 依赖不在 optimizeDeps.include（预构建内联本地 vue 风险） |
 | | `DEV-005` | remotes dev URL 端口无监听 |
 | | `DEV-006` | 宿主/远程插件版本不一致 |
-| | `DEV-008` | 远程页面静态导入 virtual:fulgurjs-runtime（破坏渲染上下文） |
 | | `DEV-009` | 门面/虚拟模块 404（.vite 缓存漂移，需清缓存重启） |
 | | `DEV-010` | dev 冷启动预构建窗口提示（首轮 30~60s 瞬态，非故障） |
 | BLD 构建期 | `BLD-001` | expose 源文件解析失败 |
@@ -400,10 +396,10 @@ export default defineFulgurjsConfig({
 | | `MFU-008` | 未知远程 |
 | | `MFU-009` | 加载到的模块没有任何导出 |
 | | `MFU-010` | singleton 共享版本漂移（使用作用域版本，告警） |
-| CC 跨应用上下文 | `CC-001` | AppContext 必需字段缺失（三段式：got/expected/example，修法指向宿主桥 `provideFulgurjsAppContext`） |
+| CC 跨应用上下文 | `CC-001` | AppContext 必需字段缺失（三段式：got/expected/example，修法指向宿主桥 `provideAppContext`） |
 | | `CC-002` | 运行时单例不可用（独立直开远程页；修法 = 经宿主联邦加载，时序契约 bridge → federatedBoot → loadRemote） |
 
-错误排查三段式文案与「配置出错？报错看得懂」一节（下文）为准；`fulgurjs doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
+错误排查三段式文案见「配置出错？报错看得懂」一节（下文）；`fulgurjs doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
 
 ### 7. 产物与端点约定
 
@@ -445,15 +441,15 @@ const FederatedAmisForm = remoteComponent('demo-host/AmisFormRouterPage', {
 - `vue` 为**可选 peerDependency**（`peerDependenciesMeta.optional`）：仅使用 `./vue` 子路径时才需要安装 Vue；runtime.js 保持框架无关（不 import vue），体积零增量；
 - 运行时实例经 `globalThis.__FULGURJS_RUNTIME__` 页面级单例复用，与 `virtual:fulgurjs-runtime` 的导入殊途同归，无需额外接线。
 
-### 9. `FulgurjsAppContext` — 跨应用传值与方法引用（`@fulgurjs/federation/context`）
+### 9. `AppContext` — 跨应用传值与方法引用（`@fulgurjs/federation/context`）
 
 宿主向子应用传值、子应用向宿主反向注册方法，一律走这条一等公民通道（对标乾坤 `props`，但带类型与错误契约）——不再各自挂 `window.*` 裸口子。
 
 ```ts
 // —— 宿主桥（host/src/fulgurjs/host/bridge.ts）：登录完成后一次性提供 ——
-import { provideFulgurjsAppContext } from '@fulgurjs/federation/context'
+import { provideAppContext } from '@fulgurjs/federation/context'
 
-provideFulgurjsAppContext({
+provideAppContext({
   user,                                  // 宿主登录用户原始形态
   getToken,                              // 取最新 token（拉取式防过期）
   store: piniaInstance,                  // 宿主 pinia：子应用 useUserStore(ctx.store) 共享响应式状态
@@ -464,18 +460,18 @@ provideFulgurjsAppContext({
 })
 
 // —— 远程 boot（exposes/federatedBoot.ts）：显式校验消费 ——
-import { requireFulgurjsAppContext } from '@fulgurjs/federation/context'
+import { requireAppContext } from '@fulgurjs/federation/context'
 
-const { store, user, hostApp } = requireFulgurjsAppContext('store', 'user', 'hostApp')
+const { store, user, hostApp } = requireAppContext('store', 'user', 'hostApp')
 // 缺任一键 → [fulgurjs:CC-001] 三段式抛错（got / expected / example 指向宿主桥）；
 // 页面无运行时单例（独立直开远程页）→ [fulgurjs:CC-002] 显式，修法 = 经宿主联邦加载。
 
 // —— 远程页面读点 ——
-import { getFulgurjsAppContext } from '@fulgurjs/federation/context'
-const dict = getFulgurjsAppContext().events?.main?.getDictItems?.('sex')
+import { getAppContext } from '@fulgurjs/federation/context'
+const dict = getAppContext().events?.main?.getDictItems?.('sex')
 
 // —— 子应用反向注册方法给宿主（页面 onUnmounted 时记得摘除，见迁移指南「页面卸载清理清单」）——
-getFulgurjsAppContext().events!.bpm = { formEvent, formSubmitEvent }
+getAppContext().events!.bpm = { formEvent, formSubmitEvent }
 ```
 
 标准字段表：
@@ -494,7 +490,7 @@ getFulgurjsAppContext().events!.bpm = { formEvent, formSubmitEvent }
 
 - `provide` = 顶层 merge（后写覆盖，幂等可多次）；约定「宿主先写标准字段，远程只增不改宿主键」；嵌套对象（如 `events`）是**引用共享**，子应用挂属性即时可见（同 realm 直引用）；
 - 时序契约：**bridge（provide）→ federatedBoot（require）→ 页面 loadRemote**——违反即在 boot 处显式失败（CC-001），不静默；
-- 数据语义 = **传输层快照 + 函数引用，非响应式**（与乾坤 props 同语义）。"实时"由三条正规通道承担：① `getToken()` / `events.main.*` 函数引用每次调用执行宿主最新闭包；② `context.store` 把宿主 pinia 递给子应用（共享响应式实例）；③ 登录态变更 = 重新登录 = 页面刷新 = bridge 重跑全新 context。context 本体不做 Vue reactive（runtime 框架无关 + gzip 红线 + 跨包 proxy 双份陷阱）；"中途变更需通知"的场景 0.9 预留 `onAppContextChange` 订阅。
+- 数据语义 = **传输层快照 + 函数引用，非响应式**（与乾坤 props 同语义）。"实时"由三条正规通道承担：① `getToken()` / `events.main.*` 函数引用每次调用执行宿主最新闭包；② `context.store` 把宿主 pinia 递给子应用（共享响应式实例）；③ 登录态变更 = 重新登录 = 页面刷新 = bridge 重跑全新 context。context 本体不做 Vue reactive（runtime 框架无关 + gzip 红线 + 跨包 proxy 双份陷阱）；"中途变更需通知"的场景：等真实需求出现再设计（当前无此场景，不预留空 API）。
 
 方法引用两条通道：
 
@@ -522,7 +518,7 @@ const { getDictItems } = await loadRemote('demo-host/api')
 const res = await getDictItems('sex')
 ```
 
-存储说明：context 与全局镜像 `window.__FULGURJS_APP_CONFIG__` 是**同一份**存储——旧名 `provideFulgurjsAppConfig / getFulgurjsAppConfig`（`virtual:fulgurjs-runtime`）继续可用但已标 `@deprecated`，请统一使用 context 子路径。
+存储说明：context 的存储本体即全局镜像对象 `window.__FULGURJS_APP_CONFIG__`（页面级单例，跨 bundle 副本共享同一份；调试面板可直接查看）。
 
 ### 9.1 乾坤功能融合：保活 / 骨架屏 / 空闲预载 / 诊断面板（宿主与模板侧能力）
 
@@ -705,7 +701,6 @@ const Panel = await loadRemote('shop/Panel', {
 
 ## 文档
 
-- [`docs/manual.html`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/manual.html) — 早期使用手册（历史存档，不再随 npm 包发布）：webpack 逐项对齐总表与部分实测截图；**当前形态以本 README 为准**
 - [`docs/迁移指南.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/迁移指南.md) — qiankun 微前端 → 联邦的真实迁移案例（七步法 + 验收清单）
 - [`docs/webpack-mf-对照与缺口.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/webpack-mf-对照与缺口.md) — webpack MF 逐项对照与明确不支持清单
 - [`docs/沙箱边界审计.md`](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/沙箱边界审计.md) — CSS / 全局变量 / 公共依赖三维度互扰实测
@@ -714,15 +709,25 @@ const Panel = await loadRemote('shop/Panel', {
 ## 开发与测试
 
 ```bash
-pnpm install
-pnpm test        # 单测（148）+ fixtures dev e2e（10）+ prod e2e（8）
-pnpm test:unit   # 仅单测
-pnpm test:dev    # 仅 dev e2e（Vite 6/7/8 矩阵见 CI）
-pnpm test:prod   # 仅 prod e2e
+# 各子项目独立安装（根目录不是 workspace）；插件需先 build，
+# fixtures 经 link: 消费插件 dist，而 dist 运行时依赖就地安装在插件目录
+pnpm --dir packages/plugin install && pnpm --dir packages/plugin build
+for app in fixtures/host-vue fixtures/remote-a fixtures/remote-b e2e; do pnpm --dir "$app" install; done
+
+pnpm test:unit   # 单测（188）
+pnpm test:dev    # dev e2e（10）
+pnpm test:prod   # prod e2e（8，需 NGINX，见 e2e/scripts/prod-setup.sh）
+pnpm test        # unit + dev + prod 全跑
+pnpm --dir e2e exec playwright test --project=dev --project=fault   # dev + 容错 e2e（12）
 bash e2e/h7-install-test.sh   # H7 装后实测：pack → 干净目录 → dev+prod 双引擎断言
 ```
 
-CI（GitHub Actions）：单测 + fixtures e2e（Vite 6.4.3 / 7.3.6 / 8.3.0 矩阵）+ runtime gzip 5KB 红线守卫，每次推送自动运行。
+CI（GitHub Actions，每次推送/PR 自动运行）两个作业：
+
+- `test`：单测 + 双口径 typecheck（pinned / latest）+ build 门禁（runtime gzip ≤ 6144B、错误码三方一致性）；
+- `e2e`：fixtures e2e（dev + fault 共 12 例）× Vite 6.4.3 / 7.3.6 / 8.3.0 兼容矩阵。
+
+prod e2e 需 NGINX，不进 CI（本地或真实项目 testbed 验证）。
 
 ## License
 

package/client.d.ts

@@ -2,8 +2,9 @@
  * virtual:fulgurjs-runtime 客户端类型声明。
  *
  * 用法（二选一）：
- * 1. dev 启动后插件自动在 src/fulgurjs-types/fulgurjs-runtime.d.ts 生成加载垫片——
- *    只要 tsconfig include 了该目录（远程模块类型直连本就要求），运行时类型零配置生效；
+ * 1. dev 启动后插件自动在类型目录（默认 src/fulgurjs/types/，无 src 布局回退 .fulgurjs/types/）
+ *    生成 fulgurjs-runtime.d.ts 加载垫片——只要 tsconfig include 了该目录
+ *    （远程模块类型直连本就要求），运行时类型零配置生效；
  * 2. tsconfig.json → compilerOptions.types 加 "@fulgurjs/federation/client"（对齐 vite/client 模式）。
  *
  * ⚠️ 本文件必须是 script 形态（顶层不得出现 import/export）——环境模块声明
@@ -64,7 +65,7 @@ declare module 'virtual:fulgurjs-runtime' {
    * 此处仅类型随虚拟模块声明供 type-only import）；读写约定：宿主桥先写标准字段，
    * 远程 boot 只增不改宿主键；嵌套对象（如 events）引用共享。
    */
-  export interface FulgurjsAppContext {
+  export interface AppContext {
     /** 宿主登录用户原始形态（只读约定） */
     user: Record<string, any>
     /** 取最新 token（拉取式防过期；0.8.2 起 bridge 不再传一次性 token 快照） */
@@ -82,9 +83,9 @@ declare module 'virtual:fulgurjs-runtime' {
   }
 
   /** 运行时单例（与 globalThis.__FULGURJS_RUNTIME__ 同一实例，方法面冻结） */
-  export interface FulgurjsRuntime {
+  export interface FgRuntime {
     shareScopeMap: Record<string, Record<string, Record<string, ShareEntry>>>
-    initSharing(scopeName?: string): FulgurjsRuntime['shareScopeMap']
+    initSharing(scopeName?: string): FgRuntime['shareScopeMap']
     registerShare(
       scopeName: string,
       name: string,
@@ -100,17 +101,13 @@ declare module 'virtual:fulgurjs-runtime' {
     getContainer(name: string): Promise<{ name: string; init: (scope: unknown) => void | Promise<void>; get: (module: string) => Promise<any> }>
     preloadRemote(spec: string, opts?: PreloadRemoteOptions): Promise<void>
     parseSpec(spec: string): { remote: string; module: string }
-    /** @deprecated 0.8.0 起改用 '@fulgurjs/federation/context' 的 provideFulgurjsAppContext（存储同一份，新名语义更准） */
-    provideFulgurjsAppConfig(config: Record<string, any>): void
-    /** @deprecated 0.8.0 起改用 '@fulgurjs/federation/context' 的 getFulgurjsAppContext（存储同一份，新名语义更准） */
-    getFulgurjsAppConfig(): Record<string, any>
   }
 
   export const version: string
-  export const runtime: FulgurjsRuntime
-  export const shareScopeMap: FulgurjsRuntime['shareScopeMap']
-  export function getRuntime(): FulgurjsRuntime
-  export function initSharing(scopeName?: string): FulgurjsRuntime['shareScopeMap']
+  export const runtime: FgRuntime
+  export const shareScopeMap: FgRuntime['shareScopeMap']
+  export function getRuntime(): FgRuntime
+  export function initSharing(scopeName?: string): FgRuntime['shareScopeMap']
   export function registerShare(
     scopeName: string,
     name: string,
@@ -128,13 +125,9 @@ declare module 'virtual:fulgurjs-runtime' {
   ): Promise<{ name: string; init: (scope: unknown) => void | Promise<void>; get: (module: string) => Promise<any> }>
   export function preloadRemote(spec: string, opts?: PreloadRemoteOptions): Promise<void>
   export function parseSpec(spec: string): { remote: string; module: string }
-  /** @deprecated 0.8.0 起改用 '@fulgurjs/federation/context' 的 provideFulgurjsAppContext（存储同一份，新名语义更准） */
-  export function provideFulgurjsAppConfig(config: Record<string, any>): void
-  /** @deprecated 0.8.0 起改用 '@fulgurjs/federation/context' 的 getFulgurjsAppContext（存储同一份，新名语义更准） */
-  export function getFulgurjsAppConfig(): Record<string, any>
   /** 兜底解包：命名空间有 default 取 default，否则原样返回 */
   export function unwrapDefault<T>(ns: { default?: T } | T): T
   /** 与 globalThis.__FULGURJS_RUNTIME__ 同一实例（方法面冻结） */
-  const runtimeDefault: FulgurjsRuntime
+  const runtimeDefault: FgRuntime
   export default runtimeDefault
 }

package/dist/{chunk-CK42RK2O.js → chunk-3VBYOVH4.js}

@@ -1,10 +1,10 @@
 // src/runtime/errors.ts
-var FulgurjsError = class extends Error {
+var FgError = class extends Error {
   code;
   details;
   constructor(code, message, details) {
     super(`[fulgurjs:${code}] ${message}`);
-    this.name = "FulgurjsError";
+    this.name = "FgError";
     this.code = code;
     this.details = details;
   }
@@ -33,6 +33,6 @@ var ErrorCodes = {
 };
 
 export {
-  FulgurjsError,
+  FgError,
   ErrorCodes
 };

package/dist/{chunk-NXN26CWX.js → chunk-5GZKZWP2.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var RUNTIME_VERSION = "0.9.1-test.1";
+var RUNTIME_VERSION = "2.0.0";
 
 export {
   RUNTIME_VERSION

package/dist/cli.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-async function loadFulgurjsConfig(configPath) {
+async function loadRepoConfig(configPath) {
   const { pathToFileURL, fileURLToPath } = await import("node:url");
   const { createRequire } = await import("node:module");
   const fs2 = await import("node:fs");
@@ -187,7 +187,7 @@ function appSummary(app) {
   return lines.join("\n");
 }
 async function inspectConfig(configPath) {
-  const cfg = await loadFulgurjsConfig(configPath);
+  const cfg = await loadRepoConfig(configPath);
   const out = [];
   out.push(`${MARK} \u914D\u7F6E\u6821\u9A8C\u901A\u8FC7\uFF1Aroot=${cfg.root}\uFF0Capps=${cfg.apps.length}`);
   out.push("\u5E94\u7528\u6458\u8981\uFF1A");
@@ -205,8 +205,8 @@ async function inspectConfig(configPath) {
   out.push("2. expose \u4E00\u5F8B\u6307\u5411\u72EC\u7ACB\u9875\uFF08\u9875\u9762\u4ECE\u8DEF\u7531\u53D6\u53C2\uFF09\uFF1B\u7EC4\u4EF6\u9700\u8981\u5FC5\u586B props \u65F6\u7ED9\u9ED8\u8BA4\u503C\uFF08BLD-003\uFF09");
   out.push("3. shared \u91CC vue / vue-router / pinia \u5EFA\u8BAE singleton: true\u2014\u2014\u8DE8\u5E94\u7528\u5FC5\u987B\u540C\u5B9E\u4F8B\uFF08\u5168\u5C40\u54CD\u5E94\u6027\u3001getActivePinia\u3001\u8DEF\u7531\u6CE8\u5165\uFF09");
   out.push("4. \u8FDC\u7A0B\u7684\u5168\u5C40\u526F\u4F5C\u7528\uFF08\u5168\u5C40\u7EC4\u4EF6/\u6307\u4EE4/\u542F\u52A8\u671F\u521D\u59CB\u5316\uFF09\u5C01\u88C5\u4E3A\u542F\u52A8\u5668\u6A21\u5757\u5E76 expose\uFF0C\u5BBF\u4E3B\u5728 loadRemote \u9875\u9762\u524D\u8C03\u7528\uFF1B");
-  out.push("   \u8DE8\u5E94\u7528\u5168\u5C40\u914D\u7F6E\uFF08locale/size \u7B49\uFF09\u7528\u8FD0\u884C\u65F6 provideFulgurjsAppConfig / getFulgurjsAppConfig \u534F\u5546\uFF0C\u4E0D\u8981\u5404\u526F\u672C\u624B\u5DE5\u6CE8\u5165");
-  out.push("5. \u8FDC\u7A0B\u9875\u9762\u53D6\u5BBF\u4E3B\u8FD0\u884C\u65F6\u4E00\u5F8B\u8D70 globalThis.__FULGURJS_RUNTIME__ / getRuntime()\uFF0C\u7981\u6B62\u9759\u6001\u5BFC\u5165\u865A\u62DF\u8FD0\u884C\u65F6\uFF08DEV-008\uFF09");
+  out.push("   \u8DE8\u5E94\u7528\u4F20\u503C\uFF08locale/store/\u4E8B\u4EF6\u7B49\uFF09\u7EDF\u4E00\u8D70 @fulgurjs/federation/context\uFF1A\u5BBF\u4E3B provideAppContext \u4E00\u6B21\u5199\u5165\uFF0C\u8FDC\u7A0B boot \u7528 getAppContext / requireAppContext \u6D88\u8D39");
+  out.push("5. \u8FDC\u7A0B\u9875\u9762\u53EF\u76F4\u63A5\u9759\u6001\u5BFC\u5165 virtual:fulgurjs-runtime\uFF08\u63D2\u4EF6\u81EA\u52A8\u6539\u5199\u4E3A\u60F0\u6027\u5355\u4F8B\u59D4\u6258\uFF09\uFF1B\u7279\u9700\u76F4\u53D6\u5168\u5C40\u5355\u4F8B\u65F6\u7528 getRuntime()");
   out.push('6. dev \u51B7\u542F\u52A8\u9996\u8F6E 30~60s \u6709\u9884\u6784\u5EFA\u7A97\u53E3\uFF08\u77AC\u65F6 504/"ce"\uFF0CDEV-010\uFF09\uFF1A\u5148\u771F\u5B9E\u6253\u5F00\u9875\u9762\u9884\u70ED\u518D\u505A\u65AD\u8A00');
   out.push("7. \u90E8\u7F72\u540E\u4F53\u68C0\uFF1Afulgurjs doctor --base <URL> --apps <\u5E94\u7528...>\uFF08\u7F13\u5B58\u5934/\u8D44\u6E90\u5F62\u6001/CORS/chunk \u53EF\u8FBE/\u7248\u672C skew\uFF09");
   out.push("8. \u90E8\u7F72\u8BED\u4E49\uFF1AremoteEntry/manifest/index.html \u5FC5\u987B no-cache\uFF08\u4E25\u7981 immutable\uFF09\uFF1B\u5E26 hash \u7684 assets \u957F\u7F13\u5B58");
@@ -221,9 +221,9 @@ var init_init = __esm({
     STARTER_CONFIG = `// fulgurjs.config.ts \u2014\u2014 @fulgurjs/federation \u63A5\u5165\u914D\u7F6E\uFF08\u5355\u6587\u4EF6\u9A71\u52A8\uFF0C\u53EF\u5165\u5E93\u3001\u53EF\u590D\u8DD1\uFF09
 // \u7528\u6CD5\uFF1Anpx fulgurjs init --config fulgurjs.config.ts   \u6821\u9A8C\u914D\u7F6E\u5E76\u8F93\u51FA\u53EF\u7C98\u8D34\u6837\u677F\u4E0E\u6838\u5BF9\u6E05\u5355
 //       npx fulgurjs doctor --base http://<\u7AD9\u70B9> --apps <\u5E94\u7528\u76EE\u5F55\u540D...>   \u90E8\u7F72\u4F53\u68C0
-import { defineFulgurjsConfig } from '@fulgurjs/federation/config'
+import { defineRepoConfig } from '@fulgurjs/federation/config'
 
-export default defineFulgurjsConfig({
+export default defineRepoConfig({
   // \u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08monorepo \u6839\u6216\u5355\u5E94\u7528\u4ED3\u5E93\u6839\uFF09
   root: process.cwd(),
   apps: [

package/dist/config.cjs

@@ -30,15 +30,15 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/config.ts
 var config_exports = {};
 __export(config_exports, {
-  defineFulgurjsConfig: () => defineFulgurjsConfig,
-  loadFulgurjsConfig: () => loadFulgurjsConfig
+  defineRepoConfig: () => defineRepoConfig,
+  loadRepoConfig: () => loadRepoConfig
 });
 module.exports = __toCommonJS(config_exports);
 var import_meta = {};
-function defineFulgurjsConfig(config) {
+function defineRepoConfig(config) {
   return config;
 }
-async function loadFulgurjsConfig(configPath) {
+async function loadRepoConfig(configPath) {
   const { pathToFileURL, fileURLToPath } = await import("url");
   const { createRequire } = await import("module");
   const fs = await import("fs");
@@ -109,6 +109,6 @@ async function loadFulgurjsConfig(configPath) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  defineFulgurjsConfig,
-  loadFulgurjsConfig
+  defineRepoConfig,
+  loadRepoConfig
 });

package/dist/config.d.cts

@@ -3,7 +3,7 @@
  * 主包内置 bin + 单配置文件驱动，可入库可复跑）。
  * init 只消费该配置生成通用样板（见 init.ts）；插件运行时（federation()）不读取本文件。
  */
-interface FulgurjsPageEntry {
+interface PageEntry {
     /** 宿主路由路径（参数段用 :xx） */
     route: string;
     /** 路由 name（命名跳转依赖） */
@@ -13,25 +13,25 @@ interface FulgurjsPageEntry {
     /** 页签标题 */
     title?: string;
 }
-interface FulgurjsRemoteAddress {
+interface RemoteAddress {
     dev: string;
     prod: string;
 }
-interface FulgurjsHostConfig {
+interface HostConfig {
     /** 页面路由表 */
-    pages: FulgurjsPageEntry[];
+    pages: PageEntry[];
     /** 路由前缀 → 远程名 */
     remotePrefixes: Record<string, string>;
     /** 消费的远程地址（键 = import 前缀；裸 URL，对象形式不支持 name@ 前缀） */
-    remotes: Record<string, FulgurjsRemoteAddress>;
+    remotes: Record<string, RemoteAddress>;
 }
-interface FulgurjsRemoteConfig {
+interface RemoteConfig {
     /** exposes：./键 → 源文件（独立页） */
     exposes: Record<string, string>;
     /** 反向消费的远程（双向联邦时；dev 下自身源码参与协商需 devSharedSelf: true） */
-    remotes?: Record<string, FulgurjsRemoteAddress>;
+    remotes?: Record<string, RemoteAddress>;
 }
-interface FulgurjsAppConfig {
+interface AppConfig {
     /** 相对 root 的应用目录 */
     path: string;
     /** 联邦容器名 */
@@ -43,30 +43,30 @@ interface FulgurjsAppConfig {
     /** 部署目录名（缺省取 base 去斜杠） */
     deployDir?: string;
     /** 宿主角色 */
-    host?: FulgurjsHostConfig;
+    host?: HostConfig;
     /** 远程角色 */
-    remote?: FulgurjsRemoteConfig;
+    remote?: RemoteConfig;
     /** 该应用的 shared 表（缺省建议 vue/vue-router/pinia singleton，见 init 输出的样板） */
     shared?: Record<string, {
         singleton?: boolean;
         requiredVersion?: string;
     }>;
 }
-interface FulgurjsDeployConfig {
+interface DeployConfig {
     /** NGINX 站点根（样板输出用，可选） */
     webRoot?: string;
     /** 监听端口（样板输出用，可选） */
     listen?: number;
 }
-interface FulgurjsRepoConfig {
+interface RepoConfig {
     /** 工程根（monorepo 根或单应用仓库根） */
     root: string;
-    apps: FulgurjsAppConfig[];
-    deploy?: FulgurjsDeployConfig;
+    apps: AppConfig[];
+    deploy?: DeployConfig;
 }
-type FulgurjsUserConfig = Partial<FulgurjsRepoConfig>;
+type UserConfig = Partial<RepoConfig>;
 /** 用户配置文件入口：仅做类型收窄（identity），不引入运行时逻辑 */
-declare function defineFulgurjsConfig(config: FulgurjsUserConfig): FulgurjsUserConfig;
+declare function defineRepoConfig(config: UserConfig): UserConfig;
 /**
  * 加载 fulgurjs.config.ts（或 .js/.json）。
  * - 配置内的 `@fulgurjs/federation/config` 导入被重写为本包 dist/config.js 绝对路径——
@@ -74,6 +74,6 @@ declare function defineFulgurjsConfig(config: FulgurjsUserConfig): FulgurjsUserC
  * - TS 走 Node 原生类型剥离（Node ≥23.6 默认开启；配置文件须用可擦除语法——纯对象无 enum/namespace）；
  *   老版本 Node 回退 esbuild 转译（先试配置工程，再试 CLI 自带依赖树）。
  */
-declare function loadFulgurjsConfig(configPath: string): Promise<FulgurjsRepoConfig>;
+declare function loadRepoConfig(configPath: string): Promise<RepoConfig>;
 
-export { type FulgurjsAppConfig, type FulgurjsDeployConfig, type FulgurjsHostConfig, type FulgurjsPageEntry, type FulgurjsRemoteAddress, type FulgurjsRemoteConfig, type FulgurjsRepoConfig, type FulgurjsUserConfig, defineFulgurjsConfig, loadFulgurjsConfig };
+export { type AppConfig, type DeployConfig, type HostConfig, type PageEntry, type RemoteAddress, type RemoteConfig, type RepoConfig, type UserConfig, defineRepoConfig, loadRepoConfig };