@fulgurjs/federation 0.9.1-test.1 → 2.0.0

package/docs//350/277/201/347/247/273/346/214/207/345/215/227.md

@@ -75,27 +75,27 @@ const FederatedBusinessForm = remoteComponent('demo-host/FormRouterPage')
 `(globalThis as any).__FULGURJS_RUNTIME__` 直取全局单例仅剩"独立访问远程页 vs 联邦加载"的
 realm 检测等特殊场景，常规集成无需使用。
 
-## 三C、跨应用传值：FulgurjsAppContext
+## 三C、跨应用传值：AppContext
 
 原 qiankun `props` / `globalState` / `window.*` 裸口子，统一收编为 context 一等公民通道（对标乾坤 props，带类型与错误契约）：
 
 ```ts
 // 宿主桥（admin/src/fulgurjs/host/bridge.ts）——登录完成后一次性提供
-import { provideFulgurjsAppContext } from '@fulgurjs/federation/context'
-provideFulgurjsAppContext({
+import { provideAppContext } from '@fulgurjs/federation/context'
+provideAppContext({
   user, getToken, store, hostApp, locale,   // 只传有真实消费的键（token 一律 getToken() 拉取）
   events: { main: mainEvents },       // 方法池：宿主提供 main.*，子应用反向注册 bpm.* / lowcode.*
   // 项目扩展位：自定义键按需自行提供（如 baseUrl）
 })
 
 // 远程启动引导（xxx/src/fulgurjs/exposes/federatedBoot.ts）——显式校验消费
-import { requireFulgurjsAppContext } from '@fulgurjs/federation/context'
-const { store, user, hostApp } = requireFulgurjsAppContext('store', 'user', 'hostApp')
+import { requireAppContext } from '@fulgurjs/federation/context'
+const { store, user, hostApp } = requireAppContext('store', 'user', 'hostApp')
 // 缺键 → [fulgurjs:CC-001]（三段式，指向宿主桥）；独立直开远程页 → [fulgurjs:CC-002]
 
 // 页面读点（替代 window.mainAppProps?.xxx）
-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')
 ```
 
 要点：
@@ -104,7 +104,6 @@ const dict = getFulgurjsAppContext().events?.main?.getDictItems?.('sex')
 - **数据语义**：传输层快照 + 函数引用，非响应式（与乾坤 props 同语义）。"实时"三通道 = ①函数引用拉取（`getToken()` / `events.main.*` 每次执行宿主最新闭包）②宿主 pinia 共享响应式（`useUserStore(ctx.store)`）③登录变更 = 刷新重跑；
 - **嵌套对象（events）是引用共享**：子应用挂属性即时可见（同 realm 直引用）；
 - **方法引用两条通道**：高频热路径（token/字典/文件 URL、反向注册）走 context 函数引用；低频/重逻辑跨应用调用走 exposes 方法模块——远程 `src/fulgurjs/exposes/api.ts` 导出纯函数（不挂 Vue 组件），对面 `await loadRemote('remote/api')`；
-- 旧名 `provideFulgurjsAppConfig / getFulgurjsAppConfig` 存储同一份，已标 `@deprecated`，存量代码请迁新名。
 
 ## 三D、页面卸载清理清单
 
@@ -112,7 +111,7 @@ const dict = getFulgurjsAppContext().events?.main?.getDictItems?.('sex')
 
 | 资源 | 清理方式 |
 |---|---|
-| `context.events.bpm.xxx = fn` 反向注册 | `onUnmounted(() => { delete getFulgurjsAppContext().events?.bpm?.xxx })` |
+| `context.events.bpm.xxx = fn` 反向注册 | `onUnmounted(() => { delete getAppContext().events?.bpm?.xxx })` |
 | `window.addEventListener(...)` | 记住函数引用，`onUnmounted` 里 `removeEventListener` |
 | `setInterval` / `setTimeout` | `onUnmounted` 里 `clearInterval` / `clearTimeout` |
 | `window.__FULGURJS_INFO__.errors.push(...)` 之外的自挂全局 | 同理显式删除 |
@@ -120,9 +119,9 @@ const dict = getFulgurjsAppContext().events?.main?.getDictItems?.('sex')
 ```ts
 import { onUnmounted } from 'vue'
 const onBpmEvent = (e: unknown) => { /* ... */ }
-getFulgurjsAppContext().events!.bpm!.formEvent = onBpmEvent
+getAppContext().events!.bpm!.formEvent = onBpmEvent
 onUnmounted(() => {
-  const events = getFulgurjsAppContext().events
+  const events = getAppContext().events
   if (events?.bpm?.formEvent === onBpmEvent) delete events.bpm.formEvent
 })
 ```

package/examples/{fulgur.config.example.ts → fulgurjs.config.example.ts}

@@ -3,9 +3,9 @@
  * 用法：npx fulgurjs init --config examples/fulgurjs.config.example.ts
  * 完整字段说明见 `fulgurjs init` 生成的起步模板（fulgurjs init --template fulgurjs.config.ts）。
  */
-import { defineFulgurjsConfig } from '@fulgurjs/federation/config'
+import { defineRepoConfig } from '@fulgurjs/federation/config'
 
-export default defineFulgurjsConfig({
+export default defineRepoConfig({
   root: process.cwd(),
   apps: [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "0.9.1-test.1",
+  "version": "2.0.0",
   "type": "module",
   "description": "Vite Module Federation with full Webpack MF parity. Dev & production, no compromise.",
   "license": "MIT",
@@ -62,14 +62,14 @@
     "CHANGELOG.md",
     "DESIGN.md",
     "examples",
-    "docs/迁移指南.md",
-    "docs/webpack-mf-对照与缺口.md",
-    "docs/沙箱边界审计.md",
-    "docs/P5-vite7-8兼容矩阵.md",
+    "docs/\u8fc1\u79fb\u6307\u5357.md",
+    "docs/webpack-mf-\u5bf9\u7167\u4e0e\u7f3a\u53e3.md",
+    "docs/\u6c99\u7bb1\u8fb9\u754c\u5ba1\u8ba1.md",
+    "docs/P5-vite7-8\u517c\u5bb9\u77e9\u9635.md",
     "docs/vite-upstream-issue-irregexp.md"
   ],
   "scripts": {
-    "build": "cp ../../README.md README.md && mkdir -p docs && cp ../../docs/迁移指南.md ../../docs/webpack-mf-对照与缺口.md ../../docs/沙箱边界审计.md ../../docs/P5-vite7-8兼容矩阵.md ../../docs/vite-upstream-issue-irregexp.md docs/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && rm -rf examples && cp -r ../../examples examples && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime.mjs && tsup src/index.ts src/pages.ts src/config.ts src/vue.ts src/context.ts --format esm,cjs --dts --external vite --target node18 --clean && esbuild src/cli.ts --bundle --format=esm --target=node18 --platform=node --outfile=dist/cli.js && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/check-gzip.mjs",
+    "build": "cp ../../README.md README.md && mkdir -p docs && cp ../../docs/\u8fc1\u79fb\u6307\u5357.md ../../docs/webpack-mf-\u5bf9\u7167\u4e0e\u7f3a\u53e3.md ../../docs/\u6c99\u7bb1\u8fb9\u754c\u5ba1\u8ba1.md ../../docs/P5-vite7-8\u517c\u5bb9\u77e9\u9635.md ../../docs/vite-upstream-issue-irregexp.md docs/ && cp ../../CHANGELOG.md CHANGELOG.md && cp ../../DESIGN.md DESIGN.md && rm -rf examples && cp -r ../../examples examples && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/gen-runtime.mjs && tsup src/index.ts src/pages.ts src/config.ts src/vue.ts src/context.ts --format esm,cjs --dts --external vite --target node18 --clean && esbuild src/cli.ts --bundle --format=esm --target=node18 --platform=node --outfile=dist/cli.js && esbuild src/runtime/index.ts --bundle --format=esm --target=es2022 --minify --outfile=dist/runtime.js && node scripts/check-gzip.mjs && node scripts/check-manual-codes.mjs",
     "dev": "tsup --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",