@fulgurjs/federation 6.11.5 → 6.11.7

package/examples/templates/vue-host-react-remote/react-remote/src/{application.tsx → fulgurjs/exposes/application.tsx}

@@ -1,3 +1,4 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 import { useEffect, useState } from 'react'
 import { BrowserRouter, MemoryRouter, Route, Routes, useLocation, useNavigate } from 'react-router-dom'
 import { defineApplication } from '@fulgurjs/federation/react'

package/examples/templates/vue-host-react-remote/react-remote/src/main.tsx

@@ -1,2 +1,2 @@
-import application from './application'
+import application from './fulgurjs/exposes/application'
 void application.start('#root', { label: '独立 React 子应用' }).catch(console.error)

package/examples/templates/vue-host-react-remote/vue-host/README.md

@@ -20,6 +20,6 @@ pnpm build                       # 构建完整组合
 - **双框架安装合同**：本宿主同时安装 `vue` + `react` + `react-dom`，shared 三键全部 `singleton: true`。
 - **入口选择**：统一入口 `@fulgurjs/federation/vue`——宿主代码全部来自 /vue，不会加载 React 适配代码（6.0.0 起 /bridge、/bridge/* 深层入口已移除）。
 - **`sessionKey`**：受控登录代次（非业务 props）。置 `null` = 登出态（立即卸载、不再请求）；换账号走「null → `clearAppContext()` → 新代次」顺序，保证 A 的 context 字段零残留。
-- **`getContext`**：同步纯 getter（`src/host-session.ts`），桥接层校验其快照的 `sessionKey` 后才代写 AppContext。
+- **`getContext`**：同步纯 getter（`src/fulgurjs/host/session.ts`），桥接层校验其快照的 `sessionKey` 后才代写 AppContext。
 - **`appProps`**：挂载时浅拷贝快照；函数引用（`onReady`）保留原引用；换顶层引用不重挂，需要重置时用 `:key`。
 - 错误占位默认内置中文诊断 +「重试加载 / 刷新页面重试」；可用 `errorComponent` 完全接管。

package/examples/templates/vue-host-react-remote/vue-host/src/App.vue

@@ -6,7 +6,7 @@
 import { ref } from 'vue'
 import { clearAppContext } from '@fulgurjs/federation/runtime'
 import { createVueBridgeApp } from '@fulgurjs/federation/vue'
-import { getLatestHostContext, login, logout } from './host-session'
+import { getLatestHostContext, login, logout } from './fulgurjs/host/session'
 
 // 工厂选项：retries 透传 loadRemote；getContext 在每次实际加载前同步取最新快照
 const RemoteReactApp = createVueBridgeApp('bridge-react-remote/bridge', {

package/examples/templates/vue-host-react-remote/vue-host/src/fulgurjs/host/application.ts

@@ -0,0 +1,6 @@
+/** 宿主装配入口：main 只调用 start；在这里连接本工程的路由与远程挂载，原业务页面仍在 pages/。 */
+import { createApp } from 'vue'
+import { defineApplication } from '@fulgurjs/federation/vue'
+import App from '../../App.vue'
+
+export default defineApplication(() => createApp(App))

package/examples/templates/vue-host-react-remote/vue-host/src/main.ts

@@ -1,2 +1,2 @@
-import application from './application'
+import application from './fulgurjs/host/application'
 void application.start('#app').catch(console.error)

package/examples/templates/vue-vue/README.md

@@ -34,9 +34,9 @@ pnpm dev                       # 同时启动远程和宿主
 
 | 功能 | 位置 |
 | --- | --- |
-| 远程可点击组件（计数、本地状态在远程组件内） | `remote/src/exposes/ClickButton.vue`，宿主首页消费 |
-| 普通 TS 模块调用 | `remote/src/exposes/utils.ts`，`host/src/pages/UtilsDemo.vue` |
-| 联邦页面（远程首页 / 带参数详情页） | `remote/src/exposes/pages/`，页面表见 `host/fulgurjs.config.ts` |
+| 远程可点击组件（计数、本地状态在远程组件内） | `remote/src/fulgurjs/exposes/ClickButton.vue`，宿主首页消费 |
+| 普通 TS 模块调用 | `remote/src/fulgurjs/exposes/utils.ts`，`host/src/pages/UtilsDemo.vue` |
+| 联邦页面（远程首页 / 带参数详情页） | `remote/src/fulgurjs/exposes/pages/`，页面表见 `host/fulgurjs.config.ts` |
 | 宿主导航 + 懒加载（不批量预取） | `host/src/App.vue` + `host/src/main.ts`（路由级按需加载） |
 | 默认加载/错误/恢复占位 | 插件内置（`remoteComponent` / `createHostPages`），示例不自建错误组件 |
 
@@ -45,7 +45,7 @@ pnpm dev                       # 同时启动远程和宿主
 启动后打开 <http://localhost:5214/utils-demo>（菜单「TS 模块调用」）。页面会显示真实计算结果：`sumNumbers(2, 3, 7) = 12`、`DEMO_ANSWER = 42`、`formatPrice(12.5)`，以及远程详情组件的 `id=7`、`tab=type-demo`。
 
 1. 用编辑器打开整个模板目录，启用 Vue 官方扩展 **Vue - Official**。
-2. 打开 [`host/src/type-demo.ts`](host/src/type-demo.ts)，在 `utils.` 后触发补全，或悬停 `sumNumbers`：应显示数字参数和数字返回值。类型直接来自远程，没有手写接口或显式泛型。
+2. 打开 [`host/src/fulgurjs/host/type-demo.ts`](host/src/fulgurjs/host/type-demo.ts)，在 `utils.` 后触发补全，或悬停 `sumNumbers`：应显示数字参数和数字返回值。类型直接来自远程，没有手写接口或显式泛型。
 3. 打开 [`host/src/pages/UtilsDemo.vue`](host/src/pages/UtilsDemo.vue)，在 `<RemoteDetail>` 上查看属性提示。把 `id="7"` 临时改成 `:id="7"`，应提示数字不能赋给字符串；检查后还原。
 4. 在模板根执行：
 
@@ -122,8 +122,8 @@ pnpm prod
 
 | 文件 | 职责 |
 |---|---|
-| `host/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
-| `remote/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `host/src/fulgurjs/host/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `remote/src/fulgurjs/exposes/application.ts` | 本应用唯一装配；main 只负责调用 start |
 | `host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `scripts/dev.mjs` / `scripts/prod.mjs` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |

package/examples/templates/vue-vue/host/src/{application.ts → fulgurjs/host/application.ts}

@@ -1,10 +1,11 @@
+/** 宿主装配入口：main 只调用 start；在这里连接本工程的路由与远程挂载，原业务页面仍在 pages/。 */
 import { createApp, h } from 'vue'
 import { createRouter, createWebHistory, useRoute } from 'vue-router'
 import { defineApplication, createHostPages } from '@fulgurjs/federation/vue'
-import App from './App.vue'
-import HomePage from './pages/HomePage.vue'
-import UtilsDemo from './pages/UtilsDemo.vue'
-import { pages, remotePrefixes } from '../fulgurjs.config.ts'
+import App from '../../App.vue'
+import HomePage from '../../pages/HomePage.vue'
+import UtilsDemo from '../../pages/UtilsDemo.vue'
+import { pages, remotePrefixes } from '../../../fulgurjs.config.ts'
 
 // 页面适配器：URL 解析、最长前缀远程归属、异步组件缓存、
 // 加载/错误占位（含「重试加载 / 刷新页面重试」）全部由插件完成。

package/examples/templates/vue-vue/host/src/main.ts

@@ -1,4 +1,4 @@
-import application from './application'
+import application from './fulgurjs/host/application'
 
 // 独立入口只负责启动；初始化写在 application 中。
 void application.start('#app').catch(console.error)

package/examples/templates/vue-vue/host/src/pages/UtilsDemo.vue

@@ -12,7 +12,7 @@
     <button data-testid="demo-utils-reload" @click="load">重新调用</button>
     <section data-testid="demo-types-guide">
       <h3>远程类型提示：像使用本地代码一样</h3>
-      <p>打开 <code>host/src/type-demo.ts</code>，在 <code>utils.</code> 后触发补全，或悬停查看函数参数和返回值。</p>
+      <p>打开 <code>host/src/fulgurjs/host/type-demo.ts</code>，在 <code>utils.</code> 后触发补全，或悬停查看函数参数和返回值。</p>
       <p>下面的详情组件来自远程，<code>id</code> 和 <code>tab</code> 都是字符串。把本文件中的 <code>id="7"</code> 改成 <code>:id="7"</code>，编辑器和类型检查会提示错误；体验后请还原。</p>
       <RemoteDetail id="7" tab="type-demo" />
       <p>执行 <code>pnpm --dir host typecheck</code> 可检查正确调用和五条错误示例。错误示例不在浏览器中执行；移除其中一行的 <code>@ts-expect-error</code> 后再检查，就能看到具体诊断。</p>

package/examples/templates/vue-vue/remote/README.md

@@ -17,10 +17,10 @@ pnpm --dir remote dev
 
 | expose 键 | 源文件 | 说明 |
 | --- | --- | --- |
-| `./ClickButton` | `src/exposes/ClickButton.vue` | 可点击计数按钮（本地状态在组件内） |
-| `./utils` | `src/exposes/utils.ts` | 普通 TS 模块：`sumNumbers` / `DEMO_ANSWER` / `formatPrice` |
-| `./pages/HomePage` | `src/exposes/pages/HomePage.vue` | 联邦页面：远程首页 |
-| `./pages/DetailPage` | `src/exposes/pages/DetailPage.vue` | 联邦页面：详情页（接收宿主路由的 `id` / `tab` props） |
+| `./ClickButton` | `src/fulgurjs/exposes/ClickButton.vue` | 可点击计数按钮（本地状态在组件内） |
+| `./utils` | `src/fulgurjs/exposes/utils.ts` | 普通 TS 模块：`sumNumbers` / `DEMO_ANSWER` / `formatPrice` |
+| `./pages/HomePage` | `src/fulgurjs/exposes/pages/HomePage.vue` | 联邦页面：远程首页 |
+| `./pages/DetailPage` | `src/fulgurjs/exposes/pages/DetailPage.vue` | 联邦页面：详情页（接收宿主路由的 `id` / `tab` props） |
 
 宿主如何调用 `./utils`（宿主侧代码）：
 

package/examples/templates/vue-vue/remote/fulgurjs.config.ts

@@ -9,10 +9,10 @@ export default {
   // 生产构建的容器入口文件名（部署后宿主 prod 地址指向它所在目录）
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './ClickButton': './src/exposes/ClickButton.vue',
-    './utils': './src/exposes/utils.ts',
-    './pages/HomePage': './src/exposes/pages/HomePage.vue',
-    './pages/DetailPage': './src/exposes/pages/DetailPage.vue',
+    './ClickButton': './src/fulgurjs/exposes/ClickButton.vue',
+    './utils': './src/fulgurjs/exposes/utils.ts',
+    './pages/HomePage': './src/fulgurjs/exposes/pages/HomePage.vue',
+    './pages/DetailPage': './src/fulgurjs/exposes/pages/DetailPage.vue',
   },
   shared: {
     vue: { singleton: true, requiredVersion: '^3.4.0' },

package/examples/templates/vue-vue/remote/src/App.vue

@@ -12,5 +12,5 @@
 </template>
 
 <script setup lang="ts">
-import ClickButton from './exposes/ClickButton.vue'
+import ClickButton from './fulgurjs/exposes/ClickButton.vue'
 </script>

package/examples/templates/vue-vue/remote/src/{application.ts → fulgurjs/exposes/application.ts}

@@ -1,6 +1,7 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 import { createApp } from 'vue'
 import { defineApplication } from '@fulgurjs/federation/vue'
-import App from './App.vue'
+import App from '../../App.vue'
 
 // 普通组件远程不需要额外桥接/路由；独立调试仍由同一应用入口启动。
 export default defineApplication(() => createApp(App))

package/examples/templates/vue-vue/remote/src/main.ts

@@ -1,4 +1,4 @@
-import application from './application'
+import application from './fulgurjs/exposes/application'
 
 // 独立入口只负责启动；初始化写在 application 中。
 void application.start('#app').catch(console.error)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fulgurjs/federation",
-  "version": "6.11.5",
+  "version": "6.11.7",
   "type": "module",
   "description": "Vite Module Federation for Vue and React: remote modules, shared dependencies and app bridges.",
   "license": "MIT",

package/examples/templates/vue-host-react-remote/vue-host/src/application.ts

@@ -1,5 +0,0 @@
-import { createApp } from 'vue'
-import { defineApplication } from '@fulgurjs/federation/vue'
-import App from './App.vue'
-
-export default defineApplication(() => createApp(App))