@fulgurjs/federation 6.11.6 → 6.11.7

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

@@ -1,9 +1,10 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 import { createApp } from 'vue'
 import { createMemoryHistory, createWebHistory, createRouter } from 'vue-router'
 import { defineApplication } from '@fulgurjs/federation/vue'
-import App from './App.vue'
-import HomePage from './HomePage.vue'
-import AboutPage from './AboutPage.vue'
+import App from '../../App.vue'
+import HomePage from '../../HomePage.vue'
+import AboutPage from '../../AboutPage.vue'
 
 export interface BridgeVueProps { label?: string; onReady?: () => void }
 

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

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

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

@@ -34,9 +34,9 @@ pnpm dev                       # 同时启动远程和宿主
 
 | 功能 | 位置 |
 | --- | --- |
-| 远程可点击组件（Hooks 计数） | `remote/src/exposes/ClickButton.tsx`，宿主首页消费 |
-| 普通 TS 模块调用（useLoadRemote） | `remote/src/exposes/utils.ts`，`host/src/pages/UtilsDemo.tsx` |
-| 联邦页面（远程首页 / 带参数详情页） | `remote/src/exposes/pages/`，页面表见 `host/fulgurjs.config.ts` |
+| 远程可点击组件（Hooks 计数） | `remote/src/fulgurjs/exposes/ClickButton.tsx`，宿主首页消费 |
+| 普通 TS 模块调用（useLoadRemote） | `remote/src/fulgurjs/exposes/utils.ts`，`host/src/pages/UtilsDemo.tsx` |
+| 联邦页面（远程首页 / 带参数详情页） | `remote/src/fulgurjs/exposes/pages/`，页面表见 `host/fulgurjs.config.ts` |
 | 宿主导航 + 懒加载（不批量预取） | `host/src/main.tsx`（路由级按需加载） |
 | 默认加载/错误/恢复占位 | 插件内置（`remoteComponent` / `createReactHostPages`），示例不自建错误组件 |
 
@@ -100,8 +100,8 @@ pnpm prod
 
 | 文件 | 职责 |
 |---|---|
-| `host/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
-| `remote/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `host/src/fulgurjs/host/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `remote/src/fulgurjs/exposes/application.tsx` | 本应用唯一装配；main 只负责调用 start |
 | `host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `scripts/dev.mjs` / `scripts/prod.mjs` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |

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

@@ -19,7 +19,7 @@ pnpm --dir host dev
 | --- | --- |
 | `fulgurjs.config.ts` | **联邦唯一声明**：remotes 地址（dev/prod）、页面表 `pages`、前缀归属 `remotePrefixes` |
 | `vite.config.ts` | 标准 Vite 配置，`federation(fulgurjsConfig)` 挂载插件 |
-| `src/remotePages.tsx` | `createReactHostPages({ pages, remotePrefixes })`（模块顶层一次）；`component(spec)` 取远程页面组件 |
+| `src/fulgurjs/host/remotePages.tsx` | `createReactHostPages({ pages, remotePrefixes })`（模块顶层一次）；`component(spec)` 取远程页面组件 |
 | `src/App.tsx` | `remoteComponent('react-remote/ClickButton')` 消费单个远程组件 |
 | `src/pages/UtilsDemo.tsx` | `useLoadRemote('react-remote/utils')` 调用普通 TS 模块 |
 | `src/main.tsx` | react-router 路由；参数页把 `params`/`query` 透传给远程组件 |

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

@@ -1,8 +1,9 @@
+/** 宿主装配入口：main 只调用 start；在这里连接本工程的路由与远程挂载，原业务页面仍在 pages/。 */
 import { StrictMode } from 'react'
 import { defineApplication } from '@fulgurjs/federation/react'
 import { BrowserRouter, Link, Route, Routes, useParams, useSearchParams } from 'react-router-dom'
-import App from './App'
-import UtilsDemo from './pages/UtilsDemo'
+import App from '../../App'
+import UtilsDemo from '../../pages/UtilsDemo'
 import { RemoteHomePage, RemoteDetailPage } from './remotePages'
 
 export default defineApplication(() => (

package/examples/templates/react-react/host/src/{remotePages.tsx → fulgurjs/host/remotePages.tsx}

@@ -1,5 +1,5 @@
 import { createReactHostPages } from '@fulgurjs/federation/react'
-import { pages, remotePrefixes } from '../fulgurjs.config.ts'
+import { pages, remotePrefixes } from '../../../fulgurjs.config.ts'
 
 // 页面适配器：URL 解析、最长前缀远程归属、异步组件缓存、
 // 加载/错误占位（含「重试加载 / 刷新页面重试」）全部由插件完成。

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

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

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

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

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

@@ -8,10 +8,10 @@ export default {
   name: 'react-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './ClickButton': './src/exposes/ClickButton.tsx',
-    './utils': './src/exposes/utils.ts',
-    './pages/HomePage': './src/exposes/pages/HomePage.tsx',
-    './pages/DetailPage': './src/exposes/pages/DetailPage.tsx',
+    './ClickButton': './src/fulgurjs/exposes/ClickButton.tsx',
+    './utils': './src/fulgurjs/exposes/utils.ts',
+    './pages/HomePage': './src/fulgurjs/exposes/pages/HomePage.tsx',
+    './pages/DetailPage': './src/fulgurjs/exposes/pages/DetailPage.tsx',
   },
   shared: {
     react: { singleton: true },

package/examples/templates/react-react/remote/src/App.tsx

@@ -1,4 +1,4 @@
-import ClickButton from './exposes/ClickButton'
+import ClickButton from './fulgurjs/exposes/ClickButton'
 
 /** 独立运行壳：联邦消费方按 exposes 加载下列模块 */
 export default function App() {

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

@@ -1,6 +1,7 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 import { StrictMode } from 'react'
 import { defineApplication } from '@fulgurjs/federation/react'
-import App from './App'
+import App from '../../App'
 
 // 独立运行入口：单独开发/调试远程自身时使用。
 // 被宿主消费时走的是 fulgurjs-remoteEntry.js 容器入口，与本文件无关。

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

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

package/examples/templates/showcase/README.md

@@ -84,14 +84,14 @@ curl --noproxy '*' -s -o /dev/null -w '%{http_code}\n' http://localhost:5335/@fu
 
 | 插件公开 API | 入口 | 本演示接线位置 |
 |---|---|---|
-| `createVueBridgeApp(spec, options)` | `@fulgurjs/federation/vue` | `vue-host/src/pages/BridgeReactPage.vue`（`<RemoteReactBridge :routing="routing" :app-props="appProps" />`） |
-| `createVueBridgeNavigation(router)` | `@fulgurjs/federation/vue` | `vue-host/src/routing.ts`（宿主导航端口，application.ts 组装后 `initBridgeRouting(router)`） |
-| `defineApplication(factory, { routing: true })` → 返回 `{ app, router }` | `@fulgurjs/federation/vue` | `vue-remote/src/application.ts`（根据 mode 选择 web/memory history；插件等待初始路由并安装） |
-| `createReactBridgeApp(spec, options)` | `@fulgurjs/federation/react` | `react-host/src/pages/BridgeVuePage.tsx`（`<RemoteVueBridge routing={routing} appProps={appProps} />`） |
-| `createReactBridgeNavigation(router, { canNavigate?, basename? })`（仅 data router） | `@fulgurjs/federation/react` | `react-host/src/routing.ts`（`createBrowserRouter` 实例组装后初始化） |
-| `createReactBridgeRouter(routing, routes, { signal })` → `{ element, dispose }` 作为工厂返回值 | `@fulgurjs/federation/react` | `react-remote/src/application.tsx`（`/` 经 loader `redirect('/orders')` 以 replace 规范化） |
-| `defineApplication(factory, { routing: true })`（协议声明，缺失即 MFU-031） | `@fulgurjs/federation/vue`（Vue）/ `@fulgurjs/federation/react`（React） | `vue-remote/src/application.ts`、`react-remote/src/application.tsx`（实例 mode/signal；独立与桥接复用同一套路由） |
-| `BridgeHostRouting`（`{ basePath, navigation }` 组件 prop，独立控制通道不进 appProps） | 类型面见 [API 参考](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/reference/api.md) | `vue-host/src/routing.ts`、`react-host/src/routing.ts`（basePath 常量 `BRIDGE_BASE_PATH`） |
+| `createVueBridgeApp(spec, options)` | `@fulgurjs/federation/vue` | `vue-host/src/fulgurjs/host/BridgeReactPage.vue`（`<RemoteReactBridge :routing="routing" :app-props="appProps" />`） |
+| `createVueBridgeNavigation(router)` | `@fulgurjs/federation/vue` | `vue-host/src/fulgurjs/host/routing.ts`（宿主导航端口，application.ts 组装后 `initBridgeRouting(router)`） |
+| `defineApplication(factory, { routing: true })` → 返回 `{ app, router }` | `@fulgurjs/federation/vue` | `vue-remote/src/fulgurjs/exposes/application.ts`（根据 mode 选择 web/memory history；插件等待初始路由并安装） |
+| `createReactBridgeApp(spec, options)` | `@fulgurjs/federation/react` | `react-host/src/fulgurjs/host/BridgeVuePage.tsx`（`<RemoteVueBridge routing={routing} appProps={appProps} />`） |
+| `createReactBridgeNavigation(router, { canNavigate?, basename? })`（仅 data router） | `@fulgurjs/federation/react` | `react-host/src/fulgurjs/host/routing.ts`（`createBrowserRouter` 实例组装后初始化） |
+| `createReactBridgeRouter(routing, routes, { signal })` → `{ element, dispose }` 作为工厂返回值 | `@fulgurjs/federation/react` | `react-remote/src/fulgurjs/exposes/application.tsx`（`/` 经 loader `redirect('/orders')` 以 replace 规范化） |
+| `defineApplication(factory, { routing: true })`（协议声明，缺失即 MFU-031） | `@fulgurjs/federation/vue`（Vue）/ `@fulgurjs/federation/react`（React） | `vue-remote/src/fulgurjs/exposes/application.ts`、`react-remote/src/fulgurjs/exposes/application.tsx`（实例 mode/signal；独立与桥接复用同一套路由） |
+| `BridgeHostRouting`（`{ basePath, navigation }` 组件 prop，独立控制通道不进 appProps） | 类型面见 [API 参考](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/reference/api.md) | `vue-host/src/fulgurjs/host/routing.ts`、`react-host/src/fulgurjs/host/routing.ts`（basePath 常量 `BRIDGE_BASE_PATH`） |
 | `BridgeChildRoute` / `BridgeLocation`（通道与位置契约） | `@fulgurjs/federation/vue`、`@fulgurjs/federation/react` | 由插件随 mount 第三参数注入子应用；两端仓库源码 `packages/plugin/src/bridge-router-core.ts` |
 
 ## 配置要点（复刻到其他工程时必读）
@@ -101,7 +101,7 @@ curl --noproxy '*' -s -o /dev/null -w '%{http_code}\n' http://localhost:5335/@fu
 - **vue-remote 的 vue-router 双实例防护**：`resolve.dedupe: ['vue', 'vue-router']` + `optimizeDeps.exclude: ['vue-router']`（vue-router 纯 ESM，exclude 后其 vue 导入被插件 dev 改写到 shared 门面；同 `fixtures/remote-a`）。
 - **react-remote 的 react-router-dom 必须正常进预构建**（同 e2e 实测的 `fixtures/remote-react`：不 exclude、不 alias）：其传递依赖 cookie 是 CJS-only 包，exclude 后浏览器报 `does not provide an export named 'parse'`；预构建内的 react 导入不会双实例——插件 dev 会向预构建注入 shared 键外部化 resolver（`fulgurjs:optimize-shared-external`）。
 - **远程类型自动同步**：宿主 dev 启动时插件自动同步远程声明闭包到 `src/fulgurjs/types/<远程名>/`（ambient 声明 + 类型注册表），普通 import 与字符串 API 共用同一套类型；跨框架（React 宿主消费 Vue 远程）同样工作，无需 tsconfig paths 或 exclude。CI 在 typecheck 前运行 `pnpm run types`（= `fulgurjs types`）。
-- **守卫与 go 的交互**：守卫按目标路径拦截（不区分会话内触发方式），子应用 `go(-1)` 回到受守卫页面同样会弹确认；Vue 宿主守卫在任何新导航开始时自动作废旧待确认（`vue-host/src/guard.ts` 的 `invalidatePending`），避免确认横幅悬挂。两宿主守卫都**不拦截本会话的首跳**：整页刷新的深链恢复直接渲染（操作 15），Vue 宿主以 `router.isReady()` 解除首跳武装，与 React 宿主 `useBlocker` 随组件挂载生效的语义对齐。
+- **守卫与 go 的交互**：守卫按目标路径拦截（不区分会话内触发方式），子应用 `go(-1)` 回到受守卫页面同样会弹确认；Vue 宿主守卫在任何新导航开始时自动作废旧待确认（`vue-host/src/fulgurjs/host/guard.ts` 的 `invalidatePending`），避免确认横幅悬挂。两宿主守卫都**不拦截本会话的首跳**：整页刷新的深链恢复直接渲染（操作 15），Vue 宿主以 `router.isReady()` 解除首跳武装，与 React 宿主 `useBlocker` 随组件挂载生效的语义对齐。
 
 ## 构建 / 类型检查
 
@@ -145,10 +145,10 @@ pnpm prod
 
 | 文件 | 职责 |
 |---|---|
-| `react-host/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
-| `react-remote/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
-| `vue-host/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
-| `vue-remote/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `react-host/src/fulgurjs/host/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `react-remote/src/fulgurjs/exposes/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `vue-host/src/fulgurjs/host/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `vue-remote/src/fulgurjs/exposes/application.ts` | 本应用唯一装配；main 只负责调用 start |
 | `react-host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `react-remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `vue-host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |

package/examples/templates/showcase/react-host/src/GuardBanner.tsx

@@ -5,8 +5,8 @@
  */
 import type { ReactElement } from 'react'
 import { useBlocker } from 'react-router-dom'
-import { logNav } from './demo-log'
-import { BRIDGE_BASE_PATH } from './routing'
+import { logNav } from './fulgurjs/host/demo-log'
+import { BRIDGE_BASE_PATH } from './fulgurjs/host/routing'
 
 export default function GuardBanner(): ReactElement | null {
   const blocker = useBlocker(({ nextLocation }) => nextLocation.pathname.startsWith(`${BRIDGE_BASE_PATH}/locked`))

package/examples/templates/showcase/react-host/src/Layout.tsx

@@ -5,7 +5,7 @@
 import { Outlet, useNavigate } from 'react-router-dom'
 import type { ReactElement } from 'react'
 import GuardBanner from './GuardBanner'
-import { logNav } from './demo-log'
+import { logNav } from './fulgurjs/host/demo-log'
 
 interface MenuItem {
   label: string

package/examples/templates/showcase/react-host/src/ObsPanel.tsx

@@ -6,8 +6,8 @@
 import { useEffect, useState, useSyncExternalStore } from 'react'
 import type { ReactElement } from 'react'
 import { useLocation } from 'react-router-dom'
-import { demoLog } from './demo-log'
-import { BRIDGE_BASE_PATH } from './routing'
+import { demoLog } from './fulgurjs/host/demo-log'
+import { BRIDGE_BASE_PATH } from './fulgurjs/host/routing'
 
 export default function ObsPanel(): ReactElement {
   const snapshot = useSyncExternalStore(demoLog.subscribe, demoLog.getSnapshot)

package/examples/templates/showcase/react-host/src/{pages → fulgurjs/host}/BridgeVuePage.tsx

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/react-host/src/pages/BridgeVuePage.tsx — 桥接演示页（React 宿主 × Vue 子应用）。
+ * examples/templates/showcase/react-host/src/fulgurjs/host/BridgeVuePage.tsx — 桥接演示页（React 宿主 × Vue 子应用）。
  * createReactBridgeApp + routing prop（basePath=/br-vue + createReactBridgeNavigation 端口）；
  * catch-all 路由（/br-vue/* 单条记录）保证子应用内部导航不重挂本组件；
  * appProps 携带稳定回调供子应用上报事件。
@@ -8,9 +8,9 @@ import { useState } from 'react'
 import type { ChangeEvent, ReactElement } from 'react'
 import { useLocation, useNavigate } from 'react-router-dom'
 import { createReactBridgeApp } from '@fulgurjs/federation/react'
-import { BRIDGE_BASE_PATH, getBridgeRouting } from '../routing'
-import { handleChildEvent, logNav } from '../demo-log'
-import ObsPanel from '../ObsPanel'
+import { BRIDGE_BASE_PATH, getBridgeRouting } from './routing'
+import { handleChildEvent, logNav } from './demo-log'
+import ObsPanel from '../../ObsPanel'
 
 const RemoteVueBridge = createReactBridgeApp('vue-remote/bridge', { retries: 1 })
 const appProps = { onChildEvent: handleChildEvent }

package/examples/templates/showcase/react-host/src/{application.tsx → fulgurjs/host/application.tsx}

@@ -1,9 +1,10 @@
+/** 宿主装配入口：main 只调用 start；在这里连接本工程的路由与远程挂载，原业务页面仍在 pages/。 */
 import { defineApplication } from '@fulgurjs/federation/react'
 import { createBrowserRouter, RouterProvider } from 'react-router-dom'
-import Layout from './Layout'
-import HomePage from './pages/HomePage'
-import AboutPage from './pages/AboutPage'
-import BridgeVuePage from './pages/BridgeVuePage'
+import Layout from '../../Layout'
+import HomePage from '../../pages/HomePage'
+import AboutPage from '../../pages/AboutPage'
+import BridgeVuePage from './BridgeVuePage'
 import { initBridgeRouting } from './routing'
 import { installPopStateLogger } from './demo-log'
 

package/examples/templates/showcase/react-host/src/{demo-log.ts → fulgurjs/host/demo-log.ts}

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/react-host/src/demo-log.ts — URL 同步观测台数据源（模块级单例，跨宿主页面存活）。
+ * examples/templates/showcase/react-host/src/fulgurjs/host/demo-log.ts — URL 同步观测台数据源（模块级单例，跨宿主页面存活）。
  * 事件来源标注：宿主菜单 / 深链粘贴 / 子应用 Link / 子应用 push·replace / 子应用 go /
  * 子应用初始化 / 浏览器前进后退 / 宿主守卫。最多保留 10 条。
  * 外部经 useSyncExternalStore(demoLog.subscribe, demoLog.getSnapshot) 订阅。

package/examples/templates/showcase/react-host/src/{routing.ts → fulgurjs/host/routing.ts}

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/react-host/src/routing.ts — 桥接宿主导航端口（模块级单例）。
+ * examples/templates/showcase/react-host/src/fulgurjs/host/routing.ts — 桥接宿主导航端口（模块级单例）。
  * createReactBridgeNavigation 仅支持 data router 模式（createBrowserRouter/createHashRouter）；
  * dev 下 Vite base 为 '/' 无需 basename；子目录部署时与 createBrowserRouter 同源传 basename。
  * 端口引用保持稳定 → routing 键不变，宿主不重挂、不重复订阅。

package/examples/templates/showcase/react-host/src/main.tsx

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

package/examples/templates/showcase/react-remote/fulgurjs.config.ts

@@ -9,7 +9,7 @@ export default {
   name: 'react-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './bridge': './src/application.tsx',
+    './bridge': './src/fulgurjs/exposes/application.tsx',
   },
   shared: {
     react: { singleton: true },

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

@@ -1,12 +1,13 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 // 独立与桥接使用同一套真实业务路由；每次工厂创建自己的 router。
 import { createBrowserRouter, RouterProvider, redirect } from 'react-router-dom'
 import { defineApplication, createReactBridgeRouter, hasBridgeMount } from '@fulgurjs/federation/react'
-import ChildLayout from './ChildLayout'
-import OrderList from './pages/OrderList'
-import OrderDetail from './pages/OrderDetail'
-import Settings from './pages/Settings'
-import Locked from './pages/Locked'
-import { createChildReporter, ChildReporterContext, type ChildProps, type ChildReporter } from './child-bus'
+import ChildLayout from '../../ChildLayout'
+import OrderList from '../../pages/OrderList'
+import OrderDetail from '../../pages/OrderDetail'
+import Settings from '../../pages/Settings'
+import Locked from '../../pages/Locked'
+import { createChildReporter, ChildReporterContext, type ChildProps, type ChildReporter } from '../../child-bus'
 
 /** 初始位置读取用的最小 data router 结构面（避免耦合 react-router 内部类型路径） */
 interface MemoryRouterProbe {

package/examples/templates/showcase/react-remote/src/main.tsx

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

package/examples/templates/showcase/vue-host/src/App.vue

@@ -5,7 +5,7 @@
  */
 import { RouterView, useRouter } from 'vue-router'
 import GuardBanner from './GuardBanner.vue'
-import { logNav } from './demo-log'
+import { logNav } from './fulgurjs/host/demo-log'
 
 interface MenuItem {
   label: string

package/examples/templates/showcase/vue-host/src/GuardBanner.vue

@@ -3,7 +3,7 @@
  * examples/templates/showcase/vue-host/src/GuardBanner.vue — 宿主守卫确认横幅（异步 beforeEach 等待用户选择）。
  * 「取消」= Vue Router 导航失败 → 通道收到 cancelled，URL/子应用位置保持不变。
  */
-import { guardPending, resolveGuard } from './guard'
+import { guardPending, resolveGuard } from './fulgurjs/host/guard'
 </script>
 
 <template>

package/examples/templates/showcase/vue-host/src/ObsPanel.vue

@@ -7,8 +7,8 @@
 import { computed, getCurrentInstance, onMounted, onUnmounted, ref, watch } from 'vue'
 import { hasBridgeMount } from '@fulgurjs/federation/vue'
 import { useRoute } from 'vue-router'
-import { navLog, mountCount } from './demo-log'
-import { BRIDGE_BASE_PATH } from './routing'
+import { navLog, mountCount } from './fulgurjs/host/demo-log'
+import { BRIDGE_BASE_PATH } from './fulgurjs/host/routing'
 
 // 宿主自己是独立 app；子应用挂载不会改变宿主的模式。
 const bridged = hasBridgeMount(getCurrentInstance()?.appContext.app)

package/examples/templates/showcase/vue-host/src/{pages → fulgurjs/host}/BridgeReactPage.vue

@@ -1,15 +1,15 @@
 <script setup lang="ts">
 /**
- * examples/templates/showcase/vue-host/src/pages/BridgeReactPage.vue — 桥接演示页（Vue 宿主 × React 子应用）。
+ * examples/templates/showcase/vue-host/src/fulgurjs/host/BridgeReactPage.vue — 桥接演示页（Vue 宿主 × React 子应用）。
  * createVueBridgeApp + routing prop（basePath=/br-react + createVueBridgeNavigation 端口）；
  * catch-all 路由保证子应用内部导航不重挂本组件；appProps 携带稳定回调供子应用上报事件。
  */
 import { ref } from 'vue'
 import { useRouter } from 'vue-router'
 import { createVueBridgeApp } from '@fulgurjs/federation/vue'
-import { BRIDGE_BASE_PATH, getBridgeRouting } from '../routing'
-import { handleChildEvent, logNav } from '../demo-log'
-import ObsPanel from '../ObsPanel.vue'
+import { BRIDGE_BASE_PATH, getBridgeRouting } from './routing'
+import { handleChildEvent, logNav } from './demo-log'
+import ObsPanel from '../../ObsPanel.vue'
 
 const RemoteReactBridge = createVueBridgeApp('react-remote/bridge', { retries: 1 })
 const routing = getBridgeRouting()

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

@@ -1,10 +1,11 @@
+/** 宿主装配入口：main 只调用 start；在这里连接本工程的路由与远程挂载，原业务页面仍在 pages/。 */
 import { createApp } from 'vue'
 import { createRouter, createWebHistory } from 'vue-router'
 import { defineApplication } from '@fulgurjs/federation/vue'
-import App from './App.vue'
-import HomePage from './pages/HomePage.vue'
-import AboutPage from './pages/AboutPage.vue'
-import BridgeReactPage from './pages/BridgeReactPage.vue'
+import App from '../../App.vue'
+import HomePage from '../../pages/HomePage.vue'
+import AboutPage from '../../pages/AboutPage.vue'
+import BridgeReactPage from './BridgeReactPage.vue'
 import { initBridgeRouting } from './routing'
 import { installGuard } from './guard'
 import { installPopStateLogger } from './demo-log'

package/examples/templates/showcase/vue-host/src/{demo-log.ts → fulgurjs/host/demo-log.ts}

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/vue-host/src/demo-log.ts — URL 同步观测台数据源（模块级单例，跨宿主页面存活）。
+ * examples/templates/showcase/vue-host/src/fulgurjs/host/demo-log.ts — URL 同步观测台数据源（模块级单例，跨宿主页面存活）。
  * 事件来源标注：宿主菜单 / 深链粘贴 / 子应用 Link / 子应用 push·replace / 子应用 go /
  * 子应用初始化 / 浏览器前进后退 / 宿主守卫。最多保留 10 条。
  */

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

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/vue-host/src/guard.ts — 宿主真实权限守卫（Vue Router 4）。
+ * examples/templates/showcase/vue-host/src/fulgurjs/host/guard.ts — 宿主真实权限守卫（Vue Router 4）。
  * /br-react/locked 需人工确认：异步 beforeEach 返回 Promise → Vue Router 等待用户选择；
  * 返回 false = 真实取消（NavigationFailure）→ 桥接通道收到 cancelled，URL/历史/子应用位置
  * 全部保持最后确认状态，插件绝不自动重试。

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

@@ -1,5 +1,5 @@
 /**
- * examples/templates/showcase/vue-host/src/routing.ts — 桥接宿主导航端口（模块级单例）。
+ * examples/templates/showcase/vue-host/src/fulgurjs/host/routing.ts — 桥接宿主导航端口（模块级单例）。
  * application.ts 组装宿主 router 后初始化一次：createVueBridgeNavigation(router)——
  * Vue Router fullPath 已剥离 history base，逻辑路径无需再处理部署前缀；
  * 端口引用保持稳定 → routing 键不变，宿主不重挂、不重复订阅。

package/examples/templates/showcase/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/showcase/vue-remote/fulgurjs.config.ts

@@ -9,7 +9,7 @@ export default {
   name: 'vue-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './bridge': './src/application.ts',
+    './bridge': './src/fulgurjs/exposes/application.ts',
   },
   shared: {
     vue: { singleton: true },

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

@@ -1,13 +1,14 @@
+/** 应用装配入口：main 只调用 start；独立与嵌入复用本工厂，每次挂载的实例和清理由插件管理。 */
 // 独立与桥接装配唯一入口；返回未安装的 app/router，交给插件等待与挂载。
 import { createApp } from 'vue'
 import { createMemoryHistory, createWebHistory, createRouter, type RouteRecordRaw } from 'vue-router'
 import { defineApplication } from '@fulgurjs/federation/vue'
-import ChildLayout from './ChildLayout.vue'
-import OrderList from './pages/OrderList.vue'
-import OrderDetail from './pages/OrderDetail.vue'
-import Settings from './pages/Settings.vue'
-import Locked from './pages/Locked.vue'
-import { createChildReporter, childReporterKey, type ChildProps } from './child-bus'
+import ChildLayout from '../../ChildLayout.vue'
+import OrderList from '../../pages/OrderList.vue'
+import OrderDetail from '../../pages/OrderDetail.vue'
+import Settings from '../../pages/Settings.vue'
+import Locked from '../../pages/Locked.vue'
+import { createChildReporter, childReporterKey, type ChildProps } from '../../child-bus'
 
 const routes: RouteRecordRaw[] = [
   // 根路径以 replace 规范化到 /orders（不产生额外历史条目）

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

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

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

@@ -39,8 +39,8 @@ pnpm prod
 
 | 文件 | 职责 |
 |---|---|
-| `react-remote/src/application.tsx` | 本应用唯一装配；main 只负责调用 start |
-| `vue-host/src/application.ts` | 本应用唯一装配；main 只负责调用 start |
+| `react-remote/src/fulgurjs/exposes/application.tsx` | 本应用唯一装配；main 只负责调用 start |
+| `vue-host/src/fulgurjs/host/application.ts` | 本应用唯一装配；main 只负责调用 start |
 | `react-remote/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `vue-host/fulgurjs.config.ts` | 本应用的远程地址、exposes、实际共享依赖 |
 | `scripts/dev.mjs` / `scripts/prod.mjs` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |

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

@@ -4,8 +4,8 @@
 
 ## 按顺序读源码
 
-1. `fulgurjs.config.ts`：`./bridge` 直接 expose `src/application.tsx`，公开模块名称不受文件名称约束。
-2. `src/application.tsx`：`defineApplication` 唯一装配；独立模式用浏览器路由，桥接模式用本地 memory 路由，两者显示同一套真实页面、计数与 props。
+1. `fulgurjs.config.ts`：`./bridge` 直接 expose `src/fulgurjs/exposes/application.tsx`，公开模块名称不受文件名称约束。
+2. `src/fulgurjs/exposes/application.tsx`：`defineApplication` 唯一装配；独立模式用浏览器路由，桥接模式用本地 memory 路由，两者显示同一套真实页面、计数与 props。
 3. `src/main.tsx`：只调用 application.start，不再复制初始化或新增转发文件。
 4. `vue-host/`：宿主的挂载、会话与回调，见[组合说明](../README.md)。
 

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

@@ -8,7 +8,7 @@ export default {
   name: 'bridge-react-remote',
   filename: 'fulgurjs-remoteEntry.js',
   exposes: {
-    './bridge': './src/application.tsx',
+    './bridge': './src/fulgurjs/exposes/application.tsx',
   },
   shared: {
     react: { singleton: true },

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` | 统一开发/生产启动器；业务接入不复制它们到应用源码 |