@fulgurjs/federation 1.0.0 → 2.0.0

package/CHANGELOG.md

@@ -1,5 +1,52 @@
 # 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 面冻结）

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

package/README.md

@@ -32,7 +32,7 @@
 - **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')`（低频重逻辑）。数据语义 = 传输层快照 + 函数引用，非响应式（与乾坤 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`）下运行
 - **全链路错误码体系（30 码）**：CFG/DEV/BLD/MFU/CC 五段 + 手册 §8 码表防漂移校验
@@ -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'`（传其它值告警并回落） |
@@ -244,11 +244,11 @@ import { loadRemote } 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` | 注册运行时插件（见下） |
-| `getRuntime` | `() => FulgurjsRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
+| `getRuntime` | `() => FgRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
 | `version` | `string` | 运行时/插件版本（跨源副本一致性诊断用） |
 | `unwrapDefault` | `(ns: any) => any` | ESM/CJS default interop 工具 |
 
@@ -290,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，
@@ -324,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: [
     {
@@ -396,7 +396,7 @@ 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 类问题拦在上线前。
@@ -441,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) 共享响应式状态
@@ -460,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 }
 ```
 
 标准字段表：
@@ -709,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,
@@ -103,10 +104,10 @@ declare module 'virtual:fulgurjs-runtime' {
   }
 
   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,
@@ -127,6 +128,6 @@ declare module 'virtual:fulgurjs-runtime' {
   /** 兜底解包：命名空间有 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-B5ZMYRN5.js → chunk-5GZKZWP2.js}

@@ -1,5 +1,5 @@
 // src/version.ts
-var RUNTIME_VERSION = "1.0.0";
+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,7 +205,7 @@ 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\u4F20\u503C\uFF08locale/store/\u4E8B\u4EF6\u7B49\uFF09\u7EDF\u4E00\u8D70 @fulgurjs/federation/context\uFF1A\u5BBF\u4E3B provideFulgurjsAppContext \u4E00\u6B21\u5199\u5165\uFF0C\u8FDC\u7A0B boot \u7528 getFulgurjsAppContext / requireFulgurjsAppContext \u6D88\u8D39");
+  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");
@@ -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 };

package/dist/config.d.ts

@@ -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 };

package/dist/config.js

@@ -1,8 +1,8 @@
 // src/config.ts
-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");
@@ -72,6 +72,6 @@ async function loadFulgurjsConfig(configPath) {
   return cfg;
 }
 export {
-  defineFulgurjsConfig,
-  loadFulgurjsConfig
+  defineRepoConfig,
+  loadRepoConfig
 };