@fulgurjs/federation 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.5.0（2026-09-19）
+
+### 变更（品牌全面对齐，breaking）
+
+- 全品牌从 `fulgur` 对齐为 **`fulgurjs`**（npm 上 fulgur 组织名被占用）：
+  - CLI 命令：`fulgur` → **`fulgurjs`**（`npx fulgurjs init` / `npx fulgurjs doctor`）
+  - 虚拟模块：`virtual:fulgur-runtime` → **`virtual:fulgurjs-runtime`**（代理模块同步更名）
+  - 全局单例：`__FULGUR_RUNTIME__` → **`__FULGURJS_RUNTIME__`**（`__FULGURJS_APP_CONFIG__` / `__FULGURJS_SCOPE__` / `__FULGURJS_INFO__` 同步）
+  - 产物文件名：`fulgur-remoteEntry.js` / `fulgur-manifest.json` → **`fulgurjs-remoteEntry.js`** / **`fulgurjs-manifest.json`**（NGINX 规则同步更名）
+  - 配置文件：`fulgur.config.ts` → **`fulgurjs.config.ts`**；错误前缀 `[fulgur:*]` → `[fulgurjs:*]`；运行时事件 `fulgur:error` → `fulgurjs:error`
+  - GitHub 仓库：**fulgurjs-federation**（旧地址自动重定向）
+- 升级方式：0.4.x 用户全局替换 `fulgur` → `fulgurjs`（导入/全局名/NGINX 文件名/CLI 命令）即可。
+
 ## 0.4.2（2026-09-19）
 
 ### 修复（npm 发布面）
@@ -13,7 +26,7 @@
 
 ### 变更（规则自动化）
 
-- **任何文件都可以直接 `import { ... } from 'virtual:fulgur-runtime'`**（原 DEV-008 规则自动化）：
+- **任何文件都可以直接 `import { ... } from 'virtual:fulgurjs-runtime'`**（原 DEV-008 规则自动化）：
   exposes 目标文件（远程页面）里的静态导入，dev 下由插件自动改写为惰性单例委托模块
   （求值期零副作用、调用期转发页面级运行时单例）。用户不再需要知道
   「宿主/远程页面取运行时的不同姿势」，0.4.0 的手工 globalThis 写法已无需使用。
@@ -22,22 +35,22 @@
 
 ### 修复
 
-- runtime 两个存量 TS 断言错误（as Error → as FulgurError）与 fallback 源码契约断言同步。
+- runtime 两个存量 TS 断言错误（as Error → as FulgurjsError）与 fallback 源码契约断言同步。
 
 ## 0.4.0（2026-09-18）
 
 开箱即用批次（A→E）全部落地；W7 发布链按用户指示顺延（未发布 npm）。
 
 ### 新增
-- **CLI（主包内置 bin `fulgur`）**
-  - `fulgur init`：起步模板（带注释的 `fulgur.config.ts`：宿主/远程/页面路由表/部署形态，
+- **CLI（主包内置 bin `fulgurjs`）**
+  - `fulgurjs init`：起步模板（带注释的 `fulgurjs.config.ts`：宿主/远程/页面路由表/部署形态，
     单文件可入库可复跑）+ 配置校验（CFG 三段式报错）+ 输出可直接粘贴的样板
     （各应用 federation() vite 块、NGINX no-cache 站点模板、通用接入核对清单）；
     **项目无关**——不内置任何具体项目的模板、锚点或文件改写
-  - `fulgur doctor`：部署面体检——remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、
+  - `fulgurjs doctor`：部署面体检——remoteEntry/manifest/index.html 的 200/no-cache/JS 形态、
     CORS、chunk 抽样可达（含 index.html 引用与一跳下钻、200-HTML 回退伪装识别）、
     版本协商 skew 预演、`--dev` 模式端口/容器入口探测；`--json` 供 CI
-- **W4 跨应用全局配置协商**：runtime 新增 `provideFulgurAppConfig` / `getFulgurAppConfig`
+- **W4 跨应用全局配置协商**：runtime 新增 `provideFulgurjsAppConfig` / `getFulgurjsAppConfig`
   （页面级单例、浅合并、globalThis 镜像）——EP locale/size 类跨副本配置的机制化收编
 - **W5 诊断补码**：CFG-007（remotes 对象形式误用 name@ 前缀）、CFG-008（shared 非法组合）、
   DEV-010（dev 冷启动预构建窗口提示）；BLD-003 必填 props 扫描器（按实测降级为手册核对项）
@@ -51,6 +64,6 @@
 
 ### 变更
 - **插件去项目化（2026-09-19 定调）**：移除 init 中曾内置的具体项目集成模板/锚点/补丁
-  （历史实现见 git 历史）；`fulgur init` 重写为纯通用脚手架，配置 schema 同步精简。
+  （历史实现见 git 历史）；`fulgurjs init` 重写为纯通用脚手架，配置 schema 同步精简。
   插件为所有项目服务，不做任何单一项目的形状。
 - runtime gzip 5212 B（红线 ≤5250 内）；单测 148/148；错误码 30 个全量文档对齐

package/DESIGN.md

@@ -1,8 +1,8 @@
 # @fulgurjs/federation 设计方案 v0.2（全量对齐 Webpack MF 版）
 
-> **品牌**：fulgur，拉丁语「闪电 · 辉光」，取自作者名中「烨」字的意译。
+> **品牌**：fulgurjs，拉丁语「闪电 · 辉光」，取自作者名中「烨」字的意译。
 > 系列规划：`@fulgurjs/federation`（模块联邦）→ `@fulgurjs/micro`、`@fulgurjs/dts` …
-> 内外命名统一 `fulgur`（`virtual:fulgur-*` 虚拟模块、`window.__FULGUR_*` 调试出口、`FulgurError` / MFU 错误码）。
+> 内外命名统一 `fulgurjs`（`virtual:fulgurjs-*` 虚拟模块、`window.__FULGURJS_*` 调试出口、`FulgurjsError` / 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
@@ -30,7 +30,7 @@
 
 ### 2A. 核心配置（webpack 官方文档全部选项）
 
-| # | webpack 选项 | fulgur | 实现方式与语义说明 |
+| # | webpack 选项 | fulgurjs | 实现方式与语义说明 |
 |---|---|---|---|
 | 1 | `name` | ✅ | 容器名；同时作为 uniqueName 决胜来源。重名冲突构建期检测并警告（对齐 webpack 对 `output.uniqueName` 的要求） |
 | 2 | `filename` | ✅ | remoteEntry 文件名，稳定命名，利于 CDN 长缓存 |
@@ -50,7 +50,7 @@
 
 ### 2B. 运行时行为语义（"效果一模一样"的实体，逐条 e2e 验收）
 
-| # | webpack 行为 | fulgur 验收语义 |
+| # | webpack 行为 | fulgurjs 验收语义 |
 |---|---|---|
 | 1 | 版本协商：消费方拿到 scope 中**满足其 requiredVersion 的最高版本** | e2e 断言双版本场景加载的是高版本 |
 | 2 | 多版本共存（非 singleton、不同 requiredVersion 可并存） | e2e 断言两版本模块图并存且各自正常 |
@@ -69,11 +69,11 @@
 | 15 | 静态 remote 自动加载；加载失败 → 等价 `ScriptExternalLoadError` 的统一错误码（MFU-0xx 体系） | e2e：kill remote 断言错误码 + UI 错误边界 |
 | 16 | `import('app1/Button')` 语法 + default/named unwrap 语义 | 所有用例的基础断言 |
 | 17 | exposed 模块的样式自动随模块注入（dev / prod 都生效） | e2e：远程组件样式生效断言 |
-| 18 | 异步边界：fulgur **自动注入**（等效 `automaticAsyncBoundary: true` 默认开启），用户不需要 webpack 的 bootstrap.js 手工模式；提供开关可关 | e2e：不写 bootstrap 直接跑通 |
+| 18 | 异步边界：fulgurjs **自动注入**（等效 `automaticAsyncBoundary: true` 默认开启），用户不需要 webpack 的 bootstrap.js 手工模式；提供开关可关 | e2e：不写 bootstrap 直接跑通 |
 
 ### 2C. MF 2.0 / @module-federation/enhanced 配置
 
-| # | 选项 | fulgur | 说明 |
+| # | 选项 | fulgurjs | 说明 |
 |---|---|---|---|
 | 1 | `manifest` | ✅ | `mf-manifest.json`（资源清单 + 版本 + 公共路径），部署回滚 = 切 manifest 指针 |
 | 2 | `runtimePlugins` | ✅ | runtime 钩子 API（init / get / loadShare 前后钩子） |
@@ -84,7 +84,7 @@
 
 ## 3. 比 webpack 更进一步的点
 
-1. **自动异步边界**——webpack 要求手工 `import('./bootstrap')`，fulgur 自动注入，配置零改动
+1. **自动异步边界**——webpack 要求手工 `import('./bootstrap')`，fulgurjs 自动注入，配置零改动
 2. **类型直连**——dev 下 remote 的补全与跳转是真源码级（webpack 需要额外 dts 工具链折腾）
 3. **runtime 内核 gzip < 5KB**（CI 硬指标，对比 @module-federation/runtime 的 40KB+）
 4. **一套配置 dev/prod 自动切换**——webpack 的 dev/prod 配置经常分裂两份
@@ -92,7 +92,7 @@
 
 ## 4. HMR 对齐承诺（dev 体验）
 
-webpack 里 remote 模块 HMR 天然可用（同一构建系统）。fulgur 通过 host↔remote 双 dev-server HMR 桥对齐，分三档自动化验收：
+webpack 里 remote 模块 HMR 天然可用（同一构建系统）。fulgurjs 通过 host↔remote 双 dev-server HMR 桥对齐，分三档自动化验收：
 
 - L1 组件热替换成功（页面不整页刷新）
 - L2 状态保留（组件热替换后 local state 不丢，对齐 vue HMR 行为）

package/README.md

@@ -1,6 +1,6 @@
 # @fulgurjs/federation
 
-> **fulgur** — 拉丁语「闪电 · 辉光」。
+> **fulgurjs** — 拉丁语「闪电 · 辉光」。
 > 一个把 Vite 模块联邦做到开箱即用的插件：**一套配置，dev / prod 双引擎，语义对齐 Webpack Module Federation**。
 
 ![tests](https://img.shields.io/badge/tests-148%20%2B%20e2e-green) ![runtime](https://img.shields.io/badge/runtime%20gzip-%3C%205KB-blue) ![vite](https://img.shields.io/badge/vite-5%20%7C%206%20%7C%207%20%7C%208-purple)
@@ -26,13 +26,13 @@
 - **exposes / remotes / shared 全语义**：`name@url` 语法、键重命名、promise-based remote、semver 全语法 requiredVersion、版本协商（最高版本胜出）、singleton / strictVersion、已加载版本永不替换、多版本共存、shareKey 重定向、多 shareScope
 - **UMD / CJS-only 依赖开箱即用**：element-plus、avue 等只有 UMD/CJS 产物的依赖直接进 `optimizeDeps.include` 即可——dev 期插件自动把预构建产物内的 shared 键改道协商门面；build 期自动把 CJS `require(<shared>)` 重定向到垫片，双运行时免疫
 - **自动异步边界**：top-level await 自动注入（es2022+），无需 webpack 式手工 `import('./bootstrap')`
-- **稳定产物**：remoteEntry 固定文件名利于 CDN 长缓存；`fulgur-manifest.json` 资源清单；expose 独立 chunk
+- **稳定产物**：remoteEntry 固定文件名利于 CDN 长缓存；`fulgurjs-manifest.json` 资源清单；expose 独立 chunk
 - **容错（对齐 webpack MF 2.0 errorLoadRemote）**：加载重试 / 熔断 / 超时内置；`loadRemote(spec, { retries, fallbackModule })` 单次调用级覆盖——失败时返回 fallback 模块，错误事件仍显式发出（**绝不静默兜底**，不传则照旧抛错）
 - **增强能力**：dts 类型直连（dev 补全直达 remote 源码）、`preloadRemote()` manifest 驱动精确预载、runtimePlugins 钩子
 - **HMR 全链路**：remote 改动 → host 页面热更，L1 组件热替换 / L2 状态保留 / L3 错误覆盖与恢复
 - **零报错纪律**：配置问题启动瞬间三段式报错；联邦失败显式抛错（错误码 + 可执行修复建议），**无任何静默兜底路径**
-- **CLI（主包内置 bin）**：`fulgur init`——`fulgur.config.ts` 单配置驱动的迁移生成器（模板 = 真实工程验证形态：vite 配置/路由表/桥/联邦启动器/NGINX conf 全量编码，锚点补丁幂等可续跑）；`fulgur doctor`——部署面体检（remoteEntry/manifest/HTML 缓存头与形态、CORS、chunk 抽样可达、版本 skew 预演、`--dev` 端口探测）
-- **跨应用全局配置协商（W4）**：`provideFulgurAppConfig({ locale, size, ... })` 一次写入运行时页面级单例，各远程副本经 `getFulgurAppConfig()` 消费注入（EP locale/size 类问题的机制化收编）
+- **CLI（主包内置 bin）**：`fulgurjs init`——`fulgurjs.config.ts` 单配置驱动的迁移生成器（模板 = 真实工程验证形态：vite 配置/路由表/桥/联邦启动器/NGINX conf 全量编码，锚点补丁幂等可续跑）；`fulgurjs doctor`——部署面体检（remoteEntry/manifest/HTML 缓存头与形态、CORS、chunk 抽样可达、版本 skew 预演、`--dev` 端口探测）
+- **跨应用全局配置协商（W4）**：`provideFulgurjsAppConfig({ locale, size, ... })` 一次写入运行时页面级单例，各远程副本经 `getFulgurjsAppConfig()` 消费注入（EP locale/size 类问题的机制化收编）
 - **全链路错误码体系（30 码）**：CFG/DEV/BLD/MFU 四段 + 手册 §8 码表防漂移校验
 
 ## 安装
@@ -97,7 +97,7 @@ export default defineConfig({
 import Button from 'remote-a/Button'
 
 // 动态导入 / 运行时 API
-import { loadRemote, registerRemote, preloadRemote } from 'virtual:fulgur-runtime'
+import { loadRemote, registerRemote, preloadRemote } from 'virtual:fulgurjs-runtime'
 
 const Chart = defineAsyncComponent(() => loadRemote('remote-a/Chart').then(m => m.default))
 
@@ -114,26 +114,26 @@ const Panel = await loadRemote('shop/Panel', {
 ```
 
 > **在任何文件都可以直接这样导入**——包括 exposes 目标文件（远程页面）。插件会自动把远程页面里的
-> 该导入改写为惰性单例委托（0.4.1 起，原 0.4.0 要求手工改用 `globalThis.__FULGUR_RUNTIME__` 的规则已废除），
+> 该导入改写为惰性单例委托（0.4.1 起，原 0.4.0 要求手工改用 `globalThis.__FULGURJS_RUNTIME__` 的规则已废除），
 > 求值期零副作用、调用期自动转发页面级运行时单例，无需关心宿主/远程的区别。
 
 > 以上只是最小面。**全部选项（remotes 四形态/shared 九个开关/dts/runtimePlugins…）、运行时 API、CLI、错误码见下方 [API 参考](#api-参考)。**
 
-**没有别的步骤了。** dev 下 remote 跑它自己的 `vite dev`（容器入口 `/@fulgur-entry.js` 由插件中间件直出）；build 下 expose 自动拆独立 chunk、shared 自动剥离——同一份配置两端通用。
+**没有别的步骤了。** dev 下 remote 跑它自己的 `vite dev`（容器入口 `/@fulgurjs-entry.js` 由插件中间件直出）；build 下 expose 自动拆独立 chunk、shared 自动剥离——同一份配置两端通用。
 
 ## CLI：init 起步模板 + doctor 部署体检
 
 ```bash
-# 1) 生成带注释的 fulgur.config.ts 起步模板（宿主/远程/页面路由表/部署形态，单文件可入库）
-npx fulgur init                                # 已存在则拒绝，--force 覆盖
-# 样例：examples/fulgur.config.example.ts（通用字段示例）
+# 1) 生成带注释的 fulgurjs.config.ts 起步模板（宿主/远程/页面路由表/部署形态，单文件可入库）
+npx fulgurjs init                                # 已存在则拒绝，--force 覆盖
+# 样例：examples/fulgurjs.config.example.ts（通用字段示例）
 
 # 2) 校验配置并输出可直接粘贴的样板：各应用 federation() 块、NGINX no-cache 站点模板、接入核对清单
-npx fulgur init --config fulgur.config.ts
+npx fulgurjs init --config fulgurjs.config.ts
 
 # 3) 部署体检（CI 可嵌）：缓存头/资源形态/CORS/chunk 可达/版本 skew
-npx fulgur doctor --base http://your-site --apps app-a,app-b
-npx fulgur doctor --base http://localhost:5173 --apps app-a --dev
+npx fulgurjs doctor --base http://your-site --apps app-a,app-b
+npx fulgurjs doctor --base http://localhost:5173 --apps app-a --dev
 ```
 
 **插件保持项目无关**：init 不改写任何项目文件，不内置任何具体项目的模板或补丁；权限路由、
@@ -154,7 +154,7 @@ import { federation } from '@fulgurjs/federation'
 | 选项 | 类型 | 默认 | 说明 |
 |---|---|---|---|
 | `name` | `string` **必填** | — | 容器名。同页面宿主/远程必须唯一（也是 uniqueName）；须匹配 `/^[a-zA-Z][\w.-]*$/` |
-| `filename` | `string` | `'fulgur-remoteEntry.js'` | prod 容器入口文件名（固定文件名，CDN 可长缓存） |
+| `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>)>` | — | 消费的远程，三种形态见下表 |
 | `shared` | `string[] \| Record<string, string \| SharedHint>` | — | 共享依赖；字符串简写 = requiredVersion（缺省从本应用 package.json 推断） |
@@ -163,7 +163,7 @@ import { federation } from '@fulgurjs/federation'
 | `library` | `{ type?: string }` | — | 仅接受 esm/module（webpack 宿主 interop 尚未支持，告警） |
 | `runtime` | `string \| false` | 内置运行时 | 自定义运行时模块路径；`false` 禁用内置运行时 |
 | `runtimeChunk` | `boolean \| 'single'` | — | 运行时是否拆独立 chunk |
-| `manifest` | `boolean` | `true` | prod 构建生成 `fulgur-manifest.json`（preloadRemote 依赖它） |
+| `manifest` | `boolean` | `true` | prod 构建生成 `fulgurjs-manifest.json`（preloadRemote 依赖它） |
 | `runtimePlugins` | `string[]` | `[]` | 运行时插件模块路径列表（写法见「运行时插件」） |
 | `dts` | `boolean \| { dir?: string }` | `true` | dev 下拉取远程 manifest 生成类型声明——宿主写 `import X from 'remote-a/X'` 补全直达远程源码 |
 | `devSharedSelf` | `boolean` | 纯远程 `true`；有 `remotes` 的宿主 `false` | dev 下自身源码（含依赖）是否参与 shared 协商改写。**双向联邦**（既 expose 又消费 remote）的宿主/远程需显式 `true`，否则 prod 双 vue 实例 |
@@ -175,7 +175,7 @@ import { federation } from '@fulgurjs/federation'
 
 ```ts
 remotes: {
-  // ① 字符串单地址：dev 自动拼 /@fulgur-entry.js，prod 自动拼 filename
+  // ① 字符串单地址：dev 自动拼 /@fulgurjs-entry.js，prod 自动拼 filename
   'remote-a': 'http://localhost:5101',
   // ② '自报名@url'：重命名语义（仅字符串形式支持；对象形式不支持 name@，配置期即报 CFG-007）
   'checkout': 'shop@http://localhost:5102',
@@ -217,16 +217,16 @@ shared: {
 
 版本裁决语义对齐 webpack：满足 requiredVersion 的最高版本胜出；已加载版本永不替换；singleton 收敛到唯一实例（skew 告警 MFU-010）；strictVersion 不满足抛 MFU-003。
 
-### 2. 运行时 API — `virtual:fulgur-runtime`
+### 2. 运行时 API — `virtual:fulgurjs-runtime`
 
 **任何文件都直接静态导入**——宿主页面、exposes 目标文件（远程页面）都一样，插件自动保证同一页面只有一个运行时实例（远程页面里的导入会被自动改写为惰性单例委托，0.4.1 起）：
 
 ```ts
 // 宿主页面、远程页面，写法完全一致
-import { loadRemote, provideFulgurAppConfig } from 'virtual:fulgur-runtime'
+import { loadRemote, provideFulgurjsAppConfig } from 'virtual:fulgurjs-runtime'
 ```
 
-> 仍可绕过代理直取全局单例（等价，调试用）：`(globalThis as any).__FULGUR_RUNTIME__`。
+> 仍可绕过代理直取全局单例（等价，调试用）：`(globalThis as any).__FULGURJS_RUNTIME__`。
 
 #### 函数总表
 
@@ -240,9 +240,9 @@ import { loadRemote, provideFulgurAppConfig } from 'virtual:fulgur-runtime'
 | `registerShare` | `(scope, name, version, get, opts?) => void` | 手工注册共享模块（一般由 init 模块自动完成） |
 | `initSharing` | `(scopeName?) => ShareScopeMap` | 初始化共享作用域（一般由 init 模块自动完成） |
 | `registerPlugins` | `(plugins: RuntimePlugin[]) => void` | 注册运行时插件（见下） |
-| `provideFulgurAppConfig` | `(config: Record<string, any>) => void` | **跨应用全局配置写入**（宿主桥一次写入；浅合并；镜像到 `globalThis.__FULGUR_APP_CONFIG__`） |
-| `getFulgurAppConfig` | `() => Record<string, any>` | 读取全局配置（远程 federatedBoot 消费注入 locale/size 等） |
-| `getRuntime` | `() => FulgurRuntime` | 取运行时单例本体（与 `__FULGUR_RUNTIME__` 同一实例） |
+| `provideFulgurjsAppConfig` | `(config: Record<string, any>) => void` | **跨应用全局配置写入**（宿主桥一次写入；浅合并；镜像到 `globalThis.__FULGURJS_APP_CONFIG__`） |
+| `getFulgurjsAppConfig` | `() => Record<string, any>` | 读取全局配置（远程 federatedBoot 消费注入 locale/size 等） |
+| `getRuntime` | `() => FulgurjsRuntime` | 取运行时单例本体（与 `__FULGURJS_RUNTIME__` 同一实例） |
 | `version` | `string` | 运行时/插件版本（跨源副本一致性诊断用） |
 | `unwrapDefault` | `(ns: any) => any` | ESM/CJS default interop 工具 |
 
@@ -257,10 +257,10 @@ const Panel = await loadRemote('shop/Panel', {
 })
 ```
 
-#### 运行时插件（`runtimePlugins: ['./src/fulgurPlugin.ts']`）
+#### 运行时插件（`runtimePlugins: ['./src/fulgurjsPlugin.ts']`）
 
 ```ts
-import type { RuntimePlugin } from 'virtual:fulgur-runtime'
+import type { RuntimePlugin } from 'virtual:fulgurjs-runtime'
 
 export default {
   name: 'my-plugin',
@@ -279,20 +279,20 @@ export default {
 
 | 出口 | 内容 |
 |---|---|
-| `window.__FULGUR_SCOPE__` | share scope 实时协商结果（键 → 版本 → `{ get, from, loaded }`） |
-| `window.__FULGUR_INFO__` | `{ remotes: { [名]: { entry, status, lastLoadMs, error } }, errors: [] }` |
-| `window.__FULGUR_APP_CONFIG__` | W4 全局配置镜像 |
-| `window` 事件 `fulgur:error` | `CustomEvent<{ remote, error }>`，所有远程加载/共享错误都会发出 |
+| `window.__FULGURJS_SCOPE__` | share scope 实时协商结果（键 → 版本 → `{ get, from, loaded }`） |
+| `window.__FULGURJS_INFO__` | `{ remotes: { [名]: { entry, status, lastLoadMs, error } }, errors: [] }` |
+| `window.__FULGURJS_APP_CONFIG__` | W4 全局配置镜像 |
+| `window` 事件 `fulgurjs:error` | `CustomEvent<{ remote, error }>`，所有远程加载/共享错误都会发出 |
 
-### 3. `defineFulgurPages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
+### 3. `defineFulgurjsPages` — 宿主页面路由表（`@fulgurjs/federation/pages`）
 
 宿主把「URL 路径 → 远程 exposes 键」的映射表交给它校验，带参路由的静默冲突在启动期报错而不是运行时加载错组件：
 
 ```ts
-import { defineFulgurPages } from '@fulgurjs/federation/pages'
-import remoteSchema from 'virtual:fulgur-remote-schema' // dev 自动生成；build 恒为空（诚实降级）
+import { defineFulgurjsPages } from '@fulgurjs/federation/pages'
+import remoteSchema from 'virtual:fulgurjs-remote-schema' // dev 自动生成；build 恒为空（诚实降级）
 
-export const PAGES = defineFulgurPages(
+export const PAGES = defineFulgurjsPages(
   [
     { route: '/remote-a/home', name: 'RemoteAHome', title: '首页' },
     // 带参路由：缺省推导 spec = 去首段 + 剥 :参 段；与其它条目冲突时 ERROR，
@@ -318,14 +318,14 @@ export const PAGES = defineFulgurPages(
 | R4 | ERROR | 静态路由被更靠前的带参路由遮蔽（先到先得）／路由完全重复 |
 | R5 | WARN | name 重复（vue-router 命名跳转歧义） |
 
-`validateFulgurPages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
+`validateFulgurjsPages(pages, options)` 为独立导出：返回违例清单不抛错，便于自测。
 
-### 4. `fulgur.config.ts` — CLI 单配置文件（`@fulgurjs/federation/config`）
+### 4. `fulgurjs.config.ts` — CLI 单配置文件（`@fulgurjs/federation/config`）
 
 ```ts
-import { defineFulgurConfig } from '@fulgurjs/federation/config'
+import { defineFulgurjsConfig } from '@fulgurjs/federation/config'
 
-export default defineFulgurConfig({
+export default defineFulgurjsConfig({
   root: process.cwd(),            // 工程根（monorepo 根或单应用仓库根）
   apps: [
     {
@@ -354,9 +354,9 @@ export default defineFulgurConfig({
 
 | 命令 | 说明 |
 |---|---|
-| `fulgur init` | 在当前目录生成带注释的 `fulgur.config.ts` 起步模板；`--template <path>` 指定输出路径；已存在拒绝覆盖，`--force` 强制 |
-| `fulgur init --config <path>` | 校验配置（CFG 三段式报错）+ 输出各应用 `federation()` 粘贴块、NGINX no-cache 站点模板、8 条通用核对清单 |
-| `fulgur 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 门禁 |
+| `fulgurjs init` | 在当前目录生成带注释的 `fulgurjs.config.ts` 起步模板；`--template <path>` 指定输出路径；已存在拒绝覆盖，`--force` 强制 |
+| `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. 错误码总表（30 个）
 
@@ -376,7 +376,7 @@ export default defineFulgurConfig({
 | | `DEV-004` | 已知 UMD-only 依赖不在 optimizeDeps.include（预构建内联本地 vue 风险） |
 | | `DEV-005` | remotes dev URL 端口无监听 |
 | | `DEV-006` | 宿主/远程插件版本不一致 |
-| | `DEV-008` | 远程页面静态导入 virtual:fulgur-runtime（破坏渲染上下文） |
+| | `DEV-008` | 远程页面静态导入 virtual:fulgurjs-runtime（破坏渲染上下文） |
 | | `DEV-009` | 门面/虚拟模块 404（.vite 缓存漂移，需清缓存重启） |
 | | `DEV-010` | dev 冷启动预构建窗口提示（首轮 30~60s 瞬态，非故障） |
 | BLD 构建期 | `BLD-001` | expose 源文件解析失败 |
@@ -393,18 +393,18 @@ export default defineFulgurConfig({
 | | `MFU-009` | 加载到的模块没有任何导出 |
 | | `MFU-010` | singleton 共享版本漂移（使用作用域版本，告警） |
 
-每个码的完整排查文案见 [`docs/manual.html`](./docs/manual.html) §8；`fulgur doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
+每个码的完整排查文案见 [`docs/manual.html`](./docs/manual.html) §8；`fulgurjs doctor` 可提前把部署面的 MFU-001 类问题拦在上线前。
 
 ### 7. 产物与端点约定
 
 | 环境 | 路径 | 说明 |
 |---|---|---|
-| dev | `/<base>/@fulgur-entry.js` | 远程容器入口（插件中间件直出，自包含） |
-| dev | `/<base>/@fulgur-manifest.json` | dev manifest（宿主 dts / preloadRemote 消费） |
-| prod | `/<base>/fulgur-remoteEntry.js` | 固定文件名容器入口（内容每次构建变——**必须 no-cache**） |
-| prod | `/<base>/fulgur-manifest.json` | expose chunk/CSS 清单（preloadRemote 消费，**no-cache**） |
+| dev | `/<base>/@fulgurjs-entry.js` | 远程容器入口（插件中间件直出，自包含） |
+| dev | `/<base>/@fulgurjs-manifest.json` | dev manifest（宿主 dts / preloadRemote 消费） |
+| prod | `/<base>/fulgurjs-remoteEntry.js` | 固定文件名容器入口（内容每次构建变——**必须 no-cache**） |
+| prod | `/<base>/fulgurjs-manifest.json` | expose chunk/CSS 清单（preloadRemote 消费，**no-cache**） |
 
-NGINX 部署模板（no-cache 规则 + 深链回退）用 `fulgur init --config` 自动生成，样例见 [`docs/manual.html`](./docs/manual.html)。
+NGINX 部署模板（no-cache 规则 + 深链回退）用 `fulgurjs init --config` 自动生成，样例见 [`docs/manual.html`](./docs/manual.html)。
 
 ## ⚠️ 首次使用避坑指南（真实迁移项目踩坑实录）
 
@@ -467,7 +467,7 @@ const Panel = await loadRemote('shop/Panel', {
 所有配置问题在 `vite` 启动瞬间即报，固定三段式，可直接照抄修正：
 
 ```
-[fulgur] Invalid federation() config — remotes["remote-a"] has no address (need one of external / dev / prod)
+[fulgurjs] Invalid federation() config — remotes["remote-a"] has no address (need one of external / dev / prod)
   got:      {"dev":""}
   expected: at least one address; with only one URL it is used for both dev and prod
   example:  remotes: { 'remote-a': 'http://localhost:5101' }
@@ -478,13 +478,13 @@ const Panel = await loadRemote('shop/Panel', {
 
 统一错误码体系（CFG/DEV/BLD/MFU 四段共 30 个）——**完整总表见上方 [API 参考 §6](#6-错误码总表30-个)**；报错文案一律「现象 → 根因 → 修法」三段式。
 
-调试出口：`window.__FULGUR_SCOPE__`（share 协商实时结果）、`window.__FULGUR_INFO__`（remote 状态/耗时/错误）。
+调试出口：`window.__FULGURJS_SCOPE__`（share 协商实时结果）、`window.__FULGURJS_INFO__`（remote 状态/耗时/错误）。
 
 ## 边界（明确不支持）
 
 - 仅 Vue 3 生态（React 适配不在当前范围）；不兼容 originjs 的 `virtual:__federation__` 旧写法
 - 不支持 SSR（检测到即警告并禁用钩子）
-- 无浏览器 DevTools 扩展（提供 `window.__FULGUR_SCOPE__ / __FULGUR_INFO__` 调试面）
+- 无浏览器 DevTools 扩展（提供 `window.__FULGURJS_SCOPE__ / __FULGURJS_INFO__` 调试面）
 - 无 JS 沙箱 / CSS 隔离——联邦是同 realm 共存架构，靠 shared 单例协商防止双运行时（详见 `docs/沙箱边界审计.md` 的三维度实测）
 
 ## 文档

package/dist/cli.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 };
 
 // src/config.ts
-async function loadFulgurConfig(configPath) {
+async function loadFulgurjsConfig(configPath) {
   const { pathToFileURL, fileURLToPath } = await import("node:url");
   const { createRequire } = await import("node:module");
   const fs2 = await import("node:fs");
@@ -18,8 +18,8 @@ async function loadFulgurConfig(configPath) {
   const path2 = await import("node:path");
   const selfDir = path2.dirname(fileURLToPath(import.meta.url));
   const selfConfigJs = path2.join(selfDir, "config.js");
-  const SELF_SPEC = fs2.existsSync(selfConfigJs) ? pathToFileURL(selfConfigJs).href : "@fulgur-federation-config-unavailable";
-  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgur\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
+  const SELF_SPEC = fs2.existsSync(selfConfigJs) ? pathToFileURL(selfConfigJs).href : "@fulgurjs-federation-config-unavailable";
+  const rewriteSelfImports = (source) => source.replace(/(['"])@fulgurjs\/federation\/config\1/g, (_m, q) => `${q}${SELF_SPEC}${q}`);
   const importConfigs = async (cacheKey) => {
     return await import(`${cacheKey}?t=${Date.now()}`);
   };
@@ -28,7 +28,7 @@ async function loadFulgurConfig(configPath) {
     mod = { default: JSON.parse(fs2.readFileSync(configPath, "utf8")) };
   } else {
     const source = rewriteSelfImports(fs2.readFileSync(configPath, "utf8"));
-    const tmpBase = path2.join(os.tmpdir(), `fulgur-config-${Date.now()}`);
+    const tmpBase = path2.join(os.tmpdir(), `fulgurjs-config-${Date.now()}`);
     if (/\.(ts|mts|cts)$/.test(configPath)) {
       try {
         const tmpTs = `${tmpBase}.ts`;
@@ -60,18 +60,18 @@ async function loadFulgurConfig(configPath) {
   const cfg = mod.default;
   if (!cfg?.root) {
     throw new Error(
-      `[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 root\uFF08\u5DE5\u7A0B\u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF09
+      `[fulgurjs:init] \u914D\u7F6E\u7F3A\u5C11 root\uFF08\u5DE5\u7A0B\u6839\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84\uFF09
 \u6839\u56E0\uFF1ACLI \u9700\u8981\u77E5\u9053\u5728\u54EA\u4E2A\u5DE5\u7A0B\u4E0A\u505A\u96C6\u6210
-\u4FEE\u6CD5\uFF1Afulgur.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgur init\uFF09`
+\u4FEE\u6CD5\uFF1Afulgurjs.config.ts \u9876\u5C42\u8865 root: '/abs/path/to/repo'\uFF08\u8D77\u6B65\u6A21\u677F\uFF1Afulgurjs init\uFF09`
     );
   }
   if (!Array.isArray(cfg.apps) || cfg.apps.length === 0) {
-    throw new Error("[fulgur:init] \u914D\u7F6E\u7F3A\u5C11 apps\uFF08\u81F3\u5C11\u4E00\u4E2A\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u5E94\u7528\uFF09");
+    throw new Error("[fulgurjs:init] \u914D\u7F6E\u7F3A\u5C11 apps\uFF08\u81F3\u5C11\u4E00\u4E2A\u5BBF\u4E3B\u6216\u8FDC\u7A0B\u5E94\u7528\uFF09");
   }
   for (const app of cfg.apps) {
     if (!app.host && !app.remote) {
       throw new Error(
-        `[fulgur:init] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
+        `[fulgurjs:init] \u5E94\u7528 "${app.path}" \u65E2\u65E0 host \u4E5F\u65E0 remote \u89D2\u8272
 \u6839\u56E0\uFF1A\u5E94\u7528\u5FC5\u987B\u81F3\u5C11\u58F0\u660E\u4E00\u4E2A\u89D2\u8272
 \u4FEE\u6CD5\uFF1A\u5BBF\u4E3B\u8865 host: { pages, remotePrefixes, remotes }\uFF0C\u8FDC\u7A0B\u8865 remote: { exposes }`
       );
@@ -142,11 +142,11 @@ function nginxSnippetFor(cfg) {
       return `  location ${b} {
     try_files $uri $uri/ ${hostIndex};
 
-    location = ${b}/fulgur-remoteEntry.js {
+    location = ${b}/fulgurjs-remoteEntry.js {
       add_header Cache-Control "no-cache";
       add_header Access-Control-Allow-Origin "*";
     }
-    location = ${b}/fulgur-manifest.json {
+    location = ${b}/fulgurjs-manifest.json {
       add_header Cache-Control "no-cache";
       add_header Access-Control-Allow-Origin "*";
     }
@@ -187,7 +187,7 @@ function appSummary(app) {
   return lines.join("\n");
 }
 async function inspectConfig(configPath) {
-  const cfg = await loadFulgurConfig(configPath);
+  const cfg = await loadFulgurjsConfig(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,10 +205,10 @@ 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 provideFulgurAppConfig / getFulgurAppConfig \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.__FULGUR_RUNTIME__ / getRuntime()\uFF0C\u7981\u6B62\u9759\u6001\u5BFC\u5165\u865A\u62DF\u8FD0\u884C\u65F6\uFF08DEV-008\uFF09");
+  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('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\uFF1Afulgur doctor --base <URL> --apps <\u5E94\u7528...>\uFF08\u7F13\u5B58\u5934/\u8D44\u6E90\u5F62\u6001/CORS/chunk \u53EF\u8FBE/\u7248\u672C skew\uFF09");
+  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");
   return out.join("\n");
 }
@@ -217,13 +217,13 @@ var init_init = __esm({
   "src/init.ts"() {
     "use strict";
     init_config();
-    MARK = "[fulgur:init]";
-    STARTER_CONFIG = `// fulgur.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 fulgur init --config fulgur.config.ts   \u6821\u9A8C\u914D\u7F6E\u5E76\u8F93\u51FA\u53EF\u7C98\u8D34\u6837\u677F\u4E0E\u6838\u5BF9\u6E05\u5355
-//       npx fulgur doctor --base http://<\u7AD9\u70B9> --apps <\u5E94\u7528\u76EE\u5F55\u540D...>   \u90E8\u7F72\u4F53\u68C0
-import { defineFulgurConfig } from '@fulgurjs/federation/config'
+    MARK = "[fulgurjs:init]";
+    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'
 
-export default defineFulgurConfig({
+export default defineFulgurjsConfig({
   // \u5DE5\u7A0B\u6839\u76EE\u5F55\uFF08monorepo \u6839\u6216\u5355\u5E94\u7528\u4ED3\u5E93\u6839\uFF09
   root: process.cwd(),
   apps: [
@@ -424,7 +424,7 @@ async function runDoctor(opts) {
   const chunkSample = opts.chunkSample ?? 16;
   for (const app of opts.apps) {
     const root = `${opts.base.replace(/\/$/, "")}/${app.replace(/^\//, "")}`;
-    const entry = await checkStatus(`${root}/fulgur-remoteEntry.js`, app, "fulgur-remoteEntry.js", {
+    const entry = await checkStatus(`${root}/fulgurjs-remoteEntry.js`, app, "fulgurjs-remoteEntry.js", {
       expectJs: true,
       expectNoCache: !opts.dev
     });
@@ -440,7 +440,7 @@ async function runDoctor(opts) {
         fix: acao ? void 0 : 'nginx \u5BF9 remoteEntry add_header Access-Control-Allow-Origin "*"'
       });
     }
-    const manifestRes = await checkStatus(`${root}/fulgur-manifest.json`, app, "fulgur-manifest.json", {
+    const manifestRes = await checkStatus(`${root}/fulgurjs-manifest.json`, app, "fulgurjs-manifest.json", {
       expectNoCache: !opts.dev
     });
     if (manifestRes.check) checks.push(manifestRes.check);
@@ -454,7 +454,7 @@ async function runDoctor(opts) {
           app,
           item: "manifest \u89E3\u6790",
           level: "FAIL",
-          symptom: "fulgur-manifest.json \u4E0D\u662F\u5408\u6CD5 JSON",
+          symptom: "fulgurjs-manifest.json \u4E0D\u662F\u5408\u6CD5 JSON",
           cause: "\u4EA7\u7269\u4E0D\u5B8C\u6574\u6216\u88AB\u4E2D\u95F4\u5C42\u6539\u5199",
           fix: "\u91CD\u65B0\u6784\u5EFA\u90E8\u7F72\uFF1B\u786E\u8BA4 nginx \u672A\u5BF9\u8BE5\u8DEF\u5F84\u505A sub/\u62FC\u63A5\u6539\u5199"
         });
@@ -467,7 +467,7 @@ async function runDoctor(opts) {
       htmlBody = html.res?.body ?? "";
     }
     if (opts.dev) {
-      const devEntry = await checkStatus(`${root}/@fulgur-entry.js`, app, "@fulgur-entry.js\uFF08dev \u5BB9\u5668\u5165\u53E3\uFF09", {
+      const devEntry = await checkStatus(`${root}/@fulgurjs-entry.js`, app, "@fulgurjs-entry.js\uFF08dev \u5BB9\u5668\u5165\u53E3\uFF09", {
         expectJs: true
       });
       if (devEntry.check) checks.push(devEntry.check);
@@ -549,7 +549,7 @@ async function runDoctor(opts) {
 function formatDoctorReport(checks) {
   const lines = [];
   for (const c of checks) {
-    const head = `[fulgur:doctor] ${c.level} [${c.app}] ${c.item}`;
+    const head = `[fulgurjs:doctor] ${c.level} [${c.app}] ${c.item}`;
     lines.push(c.level === "PASS" ? `${head} \u2014 ${c.symptom}` : `${head}
   \u73B0\u8C61\uFF1A${c.symptom}`);
     if (c.cause) lines.push(`  \u6839\u56E0\uFF1A${c.cause}`);
@@ -558,25 +558,25 @@ function formatDoctorReport(checks) {
   const fail = checks.filter((c) => c.level === "FAIL").length;
   const warn = checks.filter((c) => c.level === "WARN").length;
   const pass = checks.filter((c) => c.level === "PASS").length;
-  lines.push(`[fulgur:doctor] \u6C47\u603B\uFF1A${pass} PASS / ${warn} WARN / ${fail} FAIL`);
+  lines.push(`[fulgurjs:doctor] \u6C47\u603B\uFF1A${pass} PASS / ${warn} WARN / ${fail} FAIL`);
   return lines.join("\n");
 }
 
 // src/cli.ts
-var HELP = `fulgur \u2014 Vite Module Federation CLI (@fulgurjs/federation)
+var HELP = `fulgurjs \u2014 Vite Module Federation CLI (@fulgurjs/federation)
 
 \u7528\u6CD5\uFF1A
-  fulgur init [--template <path>] [--force]      \u751F\u6210\u5E26\u6CE8\u91CA\u7684 fulgur.config.ts \u8D77\u6B65\u6A21\u677F
-  fulgur init --config <path>                    \u6821\u9A8C\u914D\u7F6E\uFF1B\u8F93\u51FA\u5404\u5E94\u7528 federation() \u7C98\u8D34\u5757\u3001
+  fulgurjs init [--template <path>] [--force]      \u751F\u6210\u5E26\u6CE8\u91CA\u7684 fulgurjs.config.ts \u8D77\u6B65\u6A21\u677F
+  fulgurjs init --config <path>                    \u6821\u9A8C\u914D\u7F6E\uFF1B\u8F93\u51FA\u5404\u5E94\u7528 federation() \u7C98\u8D34\u5757\u3001
                                                  NGINX no-cache \u7AD9\u70B9\u6A21\u677F\u4E0E\u63A5\u5165\u6838\u5BF9\u6E05\u5355
-  fulgur doctor --base <URL> --apps <a,b,c> [--dev] [--json] [--chunk-sample N]
-  fulgur --help
+  fulgurjs doctor --base <URL> --apps <a,b,c> [--dev] [--json] [--chunk-sample N]
+  fulgurjs --help
 
 \u793A\u4F8B\uFF1A
-  fulgur init                                    # \u5F53\u524D\u76EE\u5F55\u5199 fulgur.config.ts\uFF08\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF0C--force \u8986\u76D6\uFF09
-  fulgur init --config fulgur.config.ts          # \u6821\u9A8C + \u8F93\u51FA\u6837\u677F
-  fulgur doctor --base http://your-site --apps app-a,app-b
-  fulgur doctor --base http://localhost:5173 --apps app-a --dev
+  fulgurjs init                                    # \u5F53\u524D\u76EE\u5F55\u5199 fulgurjs.config.ts\uFF08\u5DF2\u5B58\u5728\u5219\u62D2\u7EDD\uFF0C--force \u8986\u76D6\uFF09
+  fulgurjs init --config fulgurjs.config.ts          # \u6821\u9A8C + \u8F93\u51FA\u6837\u677F
+  fulgurjs doctor --base http://your-site --apps app-a,app-b
+  fulgurjs doctor --base http://localhost:5173 --apps app-a --dev
 `;
 async function main() {
   const argv = process.argv.slice(2);
@@ -602,25 +602,25 @@ async function main() {
         return 2;
       }
     }
-    const target = resolve(argOf("--template") ?? "fulgur.config.ts");
+    const target = resolve(argOf("--template") ?? "fulgurjs.config.ts");
     const result = await writeConfigTemplate2(target, has("--force"));
     if (result === "exists") {
-      console.error(`[fulgur:init] ${target} \u5DF2\u5B58\u5728\uFF0C\u62D2\u7EDD\u8986\u76D6\uFF08--force \u5F3A\u5236\u8986\u76D6\uFF09`);
+      console.error(`[fulgurjs:init] ${target} \u5DF2\u5B58\u5728\uFF0C\u62D2\u7EDD\u8986\u76D6\uFF08--force \u5F3A\u5236\u8986\u76D6\uFF09`);
       return 2;
     }
-    console.log(`[fulgur:init] \u5DF2\u751F\u6210\u8D77\u6B65\u6A21\u677F ${target}
+    console.log(`[fulgurjs:init] \u5DF2\u751F\u6210\u8D77\u6B65\u6A21\u677F ${target}
 \u540E\u7EED\u6B65\u9AA4\uFF1A
-  1. \u7F16\u8F91 fulgur.config.ts\uFF1A\u586B\u5165\u4F60\u7684\u5E94\u7528\u76EE\u5F55/\u5BB9\u5668\u540D/\u7AEF\u53E3/base/\u9875\u9762\u8DEF\u7531\u8868/exposes
-  2. npx fulgur init --config fulgur.config.ts   # \u6821\u9A8C\u5E76\u8F93\u51FA\u53EF\u7C98\u8D34\u6837\u677F\u4E0E\u6838\u5BF9\u6E05\u5355
+  1. \u7F16\u8F91 fulgurjs.config.ts\uFF1A\u586B\u5165\u4F60\u7684\u5E94\u7528\u76EE\u5F55/\u5BB9\u5668\u540D/\u7AEF\u53E3/base/\u9875\u9762\u8DEF\u7531\u8868/exposes
+  2. npx fulgurjs init --config fulgurjs.config.ts   # \u6821\u9A8C\u5E76\u8F93\u51FA\u53EF\u7C98\u8D34\u6837\u677F\u4E0E\u6838\u5BF9\u6E05\u5355
   3. \u6309\u6E05\u5355\u628A federation() \u5757\u63A5\u5165\u5404\u5E94\u7528 vite.config.ts\uFF0C\u5B89\u88C5\u4F9D\u8D56
-  4. \u90E8\u7F72\u540E\uFF1Anpx fulgur doctor --base <URL> --apps <\u5E94\u7528...>`);
+  4. \u90E8\u7F72\u540E\uFF1Anpx fulgurjs doctor --base <URL> --apps <\u5E94\u7528...>`);
     return 0;
   }
   if (cmd === "doctor") {
     const base = argOf("--base");
     const appsRaw = argOf("--apps") ?? "main";
     if (!base) {
-      console.error("[fulgur:doctor] \u7F3A\u5C11 --base <URL>\uFF08\u7AD9\u70B9\u6839\u5730\u5740\uFF0C\u5982 http://your-site\uFF09");
+      console.error("[fulgurjs:doctor] \u7F3A\u5C11 --base <URL>\uFF08\u7AD9\u70B9\u6839\u5730\u5740\uFF0C\u5982 http://your-site\uFF09");
       return 2;
     }
     const apps = appsRaw.split(",").map((s) => s.trim()).filter(Boolean);
@@ -644,7 +644,7 @@ ${HELP}`);
 main().then(
   (code) => process.exit(code),
   (e) => {
-    console.error("[fulgur] \u6267\u884C\u5931\u8D25\uFF1A", e);
+    console.error("[fulgurjs] \u6267\u884C\u5931\u8D25\uFF1A", e);
     process.exit(2);
   }
 );