@fulgurjs/federation 6.11.6 → 6.12.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 当前发布说明
 
+## 6.12.0
+
+- Vue 宿主桥接新增 session 身份 getter，插件自动管理登录代次、同会话恢复、换号和登出；token刷新不作为换代依据，移除应用登录流程中的手工 renew/clear 接线。自动会话仅 Vue 宿主；React 宿主仍使用显式受控 sessionKey。
+- setup 允许只声明 onSession/globalComponents/pageProviders，不再强制默认导出空函数；错误默认导出与空模块仍严格拒绝。
+- init 接入计划支持 --application 复用已有统一装配；复杂入口输出真实依赖与逐步整理清单，不猜测业务代码；补齐单一路径首次接入指南。
+- 新增自动会话完整回归（身份生命周期、token 轮换不重挂、离页登出、多实例共享、非法 getter、代次冲突与存储降级）。
+
+## 6.11.7
+
+- 新增接入代码统一集中在 src/fulgurjs：host/ 管宿主挂载与上下文，exposes/ 管远程装配与对外内容，types/ 管自动声明；根部只按需保留 setup.ts。
+- init 接入计划默认生成 exposes/application 和 host/RemoteApplication，迁移最小入口时同步重定位 App、样式等相对导入，支持自定义嵌套入口，保留冲突保护和重复执行语义。
+- 五个可复制模板及同框架演示同步目录、导入与配置，模板目录门禁防止接线重新散落；中英文接入指南和 AI 接手规则同步。
+
 ## 6.11.6
 
 - types 命令识别应用实际 tsconfig 纳入的 Vite 虚拟模块环境声明及 project references，不再把已有 client 声明的虚拟 ID 误报为缺失 npm 包；缺失或不在配置输入内的声明仍严格报错，支持声明的单星号模块模式。

package/README.en.md

@@ -11,6 +11,8 @@ To reduce duplicated standalone/bridge startup code, see [application assembly a
 
 For existing projects, `fulgurjs init --plan` previews wiring and `--write` explicitly applies it. Complex business assembly remains an explicit manual task. Unified `/vue` and `/react` imports support tree shaking without internal import paths.
 
+For an existing complete application, follow [one end-to-end integration path](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/en/guide/first-integration.md) before consulting individual APIs.
+
 ## Quick start
 
 **New project** (recommended): scaffold a fully runnable federation workspace from a template:

package/README.md

@@ -7,7 +7,7 @@
 [English](https://github.com/chenmingye/fulgurjs-federation/blob/master/README.en.md) ｜ **[完整文档中心](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/README.md)**（中文 [docs/zh](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/README.md) · English [docs/en](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/en/README.md)）
 
 
-已有应用希望减少独立启动/桥接重复代码，参阅[统一装配与接入预检](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/guide/existing-apps.md)。
+第一次接入完整应用，从[一条完整接入流程](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/guide/first-integration.md)开始；统一装配与预检参考[已有应用接入](https://github.com/chenmingye/fulgurjs-federation/blob/master/docs/zh/guide/existing-apps.md)。
 
 已有工程可先用 `fulgurjs init --plan` 预览接线，审查后再用 `--write`；复杂业务装配会明确列出人工待办。统一 `/vue`、`/react` 入口支持按使用裁剪，不需要改用内部路径。
 
@@ -43,7 +43,7 @@ export default {
 // Vue 应用代码统一入口 @fulgurjs/federation/vue
 import { loadRemote, remoteComponent } from '@fulgurjs/federation/vue'
 const RemoteButton = remoteComponent('remote-a/Button')
-const math = await loadRemote<{ add(a: number, b: number): number }>('remote-a/math')
+const math = await loadRemote('remote-a/math')
 ```
 
 ```tsx
@@ -71,7 +71,7 @@ import { loadRemote, loadShare } from '@fulgurjs/federation/runtime'
 
 - **组件与模块**：`remoteComponent`（Vue/React）、`useLoadRemote`、`RemoteErrorBoundary`、`loadRemote` —— 失败显式错误态可重试，不静默兜底。
 - **逐页接入**：`definePages` + `createHostPages`（宿主页面路由表 → 远程页面），CLI `check-pages` 启动期契约核对。
-- **完整子应用桥接**：`defineBridgeApp`（子应用）+ `createVueBridgeApp` / `createReactBridgeApp`（宿主）；挂载/卸载、会话代次、卸载失败封锁。
+- **完整子应用桥接**：`defineApplication`（独立/嵌入共用装配；自定义契约可用 `defineBridgeApp`）+ `createVueBridgeApp` / `createReactBridgeApp`（宿主）；挂载/卸载、会话代次、卸载失败封锁。
 - **URL 同步**：`createVueBridgeNavigation` / `createReactBridgeNavigation`（宿主）+ Vue 工厂返回 `{ app, router }` / `createReactBridgeRouter`（子应用）；深链刷新、守卫取消、query/hash 保留。
 - **共享依赖**：singleton / requiredVersion / strictVersion / shareScope / eager，同步与异步裁决，React 18/19 多版本隔离。
 - **远程类型**：提供方随构建产出可分发声明（SFC 真实 props/泛型/重载），宿主 dev 自动同步——普通 import 与 `loadRemote`/`remoteComponent`/桥接工厂共用一套类型，拼错入口编译期报错；CLI `types` 供 CI 在 typecheck 前同步校验。

package/dist/{application-core-DWI3eKme.d.ts → application-core-C72tVRT7.d.ts}

@@ -1,4 +1,4 @@
-import { a as BridgeApp } from './bridge-core-CoQRVgnZ.js';
+import { a as BridgeApp } from './bridge-core-Dm6ABUxQ.js';
 
 /** Shared start/stop bookkeeping; framework contracts retain their own rendering semantics. */
 

package/dist/{application-core-BuhXQmLF.d.cts → application-core-Coa0CIre.d.cts}

@@ -1,4 +1,4 @@
-import { a as BridgeApp } from './bridge-core-77BT1__I.cjs';
+import { a as BridgeApp } from './bridge-core-CGFET9Qi.cjs';
 
 /** Shared start/stop bookkeeping; framework contracts retain their own rendering semantics. */
 

package/dist/bridge-app-react.d.cts

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
-import { B as BridgeChildRoute, a as BridgeApp } from './bridge-core-77BT1__I.cjs';
-import { A as Application } from './application-core-BuhXQmLF.cjs';
+import { B as BridgeChildRoute, a as BridgeApp } from './bridge-core-CGFET9Qi.cjs';
+import { A as Application } from './application-core-Coa0CIre.cjs';
 import './context.cjs';
 
 /**

package/dist/bridge-app-react.d.ts

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
-import { B as BridgeChildRoute, a as BridgeApp } from './bridge-core-CoQRVgnZ.js';
-import { A as Application } from './application-core-DWI3eKme.js';
+import { B as BridgeChildRoute, a as BridgeApp } from './bridge-core-Dm6ABUxQ.js';
+import { A as Application } from './application-core-C72tVRT7.js';
 import './context.js';
 
 /**

package/dist/bridge-app-react.js

@@ -3,7 +3,7 @@ import {
 } from "./chunk-6OB47FSR.js";
 import {
   markBridgeMount
-} from "./chunk-HDRZBSND.js";
+} from "./chunk-2MWIIRQZ.js";
 import "./chunk-GVWC7J7Q.js";
 import "./chunk-TSYLDY6H.js";
 import "./chunk-OF2JCXTZ.js";

package/dist/bridge-app-vue.d.cts

@@ -1,6 +1,6 @@
 import { App } from 'vue';
-import { B as BridgeChildRoute, V as VueRouterLike, a as BridgeApp } from './bridge-core-77BT1__I.cjs';
-import { A as Application } from './application-core-BuhXQmLF.cjs';
+import { B as BridgeChildRoute, V as VueRouterLike, a as BridgeApp } from './bridge-core-CGFET9Qi.cjs';
+import { A as Application } from './application-core-Coa0CIre.cjs';
 import './context.cjs';
 
 /**

package/dist/bridge-app-vue.d.ts

@@ -1,6 +1,6 @@
 import { App } from 'vue';
-import { B as BridgeChildRoute, V as VueRouterLike, a as BridgeApp } from './bridge-core-CoQRVgnZ.js';
-import { A as Application } from './application-core-DWI3eKme.js';
+import { B as BridgeChildRoute, V as VueRouterLike, a as BridgeApp } from './bridge-core-Dm6ABUxQ.js';
+import { A as Application } from './application-core-C72tVRT7.js';
 import './context.js';
 
 /**

package/dist/bridge-app-vue.js

@@ -6,7 +6,7 @@ import {
 } from "./chunk-6FMTBDIM.js";
 import {
   markBridgeMount
-} from "./chunk-HDRZBSND.js";
+} from "./chunk-2MWIIRQZ.js";
 import {
   routingChannelNotProvidedError,
   routingSyncError

package/dist/{bridge-core-77BT1__I.d.cts → bridge-core-CGFET9Qi.d.cts}

@@ -106,6 +106,7 @@ interface BridgeContextResolution {
  * 挂载前校验会话与上下文快照（同步、无副作用；只在全部通过后由调用方 provide）。
  *
  * - getter 抛错/返回非对象/thenable → MFU-016（phase: getContext）；
+ * - 自动会话可补入缺省的快照sessionKey；显式矛盾仍拒绝；
  * - 受控 sessionKey 与快照或现有 AppContext 不一致 → MFU-017（不写任何全局状态）；
  * - 新会话（与全局当前 sessionKey 不同）先 clearAppContext 清旧账号残留，
  *   避免 provideAppContext 顶层 merge 留下旧账号独有字段（BR06）。
@@ -116,7 +117,7 @@ interface BridgeContextResolution {
  * controlled 语义：非空字符串 = 受控校验；undefined = 不启用受控校验（快照照常提供，
  * 远程 onSession 由 runtime 按 AppContext.sessionKey 判定）；null 由调用方先行短路。
  */
-declare function resolveBridgeContext(spec: string, controlled: string | undefined, getContext: (() => Partial<AppContext> & Record<string, unknown>) | undefined): BridgeContextResolution;
+declare function resolveBridgeContext(spec: string, controlled: string | undefined, getContext: (() => Partial<AppContext> & Record<string, unknown>) | undefined, managedSession?: boolean): BridgeContextResolution;
 /** 受控 sessionKey 受控值合法性：只接受 undefined / null / 非空字符串（任务书 BN10） */
 declare function assertControlledSessionKey(spec: string, value: unknown): void;
 /** 适配层参数校验（与 vue/react 适配器同口径：retries 0-10 整数、timeout 正有限数） */

package/dist/{bridge-core-CoQRVgnZ.d.ts → bridge-core-Dm6ABUxQ.d.ts}

@@ -106,6 +106,7 @@ interface BridgeContextResolution {
  * 挂载前校验会话与上下文快照（同步、无副作用；只在全部通过后由调用方 provide）。
  *
  * - getter 抛错/返回非对象/thenable → MFU-016（phase: getContext）；
+ * - 自动会话可补入缺省的快照sessionKey；显式矛盾仍拒绝；
  * - 受控 sessionKey 与快照或现有 AppContext 不一致 → MFU-017（不写任何全局状态）；
  * - 新会话（与全局当前 sessionKey 不同）先 clearAppContext 清旧账号残留，
  *   避免 provideAppContext 顶层 merge 留下旧账号独有字段（BR06）。
@@ -116,7 +117,7 @@ interface BridgeContextResolution {
  * controlled 语义：非空字符串 = 受控校验；undefined = 不启用受控校验（快照照常提供，
  * 远程 onSession 由 runtime 按 AppContext.sessionKey 判定）；null 由调用方先行短路。
  */
-declare function resolveBridgeContext(spec: string, controlled: string | undefined, getContext: (() => Partial<AppContext> & Record<string, unknown>) | undefined): BridgeContextResolution;
+declare function resolveBridgeContext(spec: string, controlled: string | undefined, getContext: (() => Partial<AppContext> & Record<string, unknown>) | undefined, managedSession?: boolean): BridgeContextResolution;
 /** 受控 sessionKey 受控值合法性：只接受 undefined / null / 非空字符串（任务书 BN10） */
 declare function assertControlledSessionKey(spec: string, value: unknown): void;
 /** 适配层参数校验（与 vue/react 适配器同口径：retries 0-10 整数、timeout 正有限数） */

package/dist/bridge-core.cjs

@@ -159,7 +159,7 @@ function releaseBridgeSession(sessionKey) {
   if (n <= 1) activeBridgeSessions.delete(sessionKey);
   else activeBridgeSessions.set(sessionKey, n - 1);
 }
-function resolveBridgeContext(spec, controlled, getContext) {
+function resolveBridgeContext(spec, controlled, getContext, managedSession = false) {
   if (getContext) {
     let snapshot;
     try {
@@ -170,6 +170,9 @@ function resolveBridgeContext(spec, controlled, getContext) {
     if (snapshot === null || typeof snapshot !== "object" || typeof snapshot.then === "function") {
       throw bridgeLifecycleError("getContext", spec, describeContextValue(snapshot));
     }
+    if (managedSession && controlled !== void 0 && snapshot.sessionKey === void 0) {
+      snapshot = { ...snapshot, sessionKey: controlled };
+    }
     if (controlled !== void 0 && snapshot.sessionKey !== controlled) {
       throw bridgeSessionMismatchError(spec, controlled, snapshot.sessionKey, { reason: "getter-snapshot" });
     }

package/dist/bridge-core.d.cts

@@ -1,2 +1,2 @@
 import './context.cjs';
-export { a as BridgeApp, c as BridgeContextResolution, d as acquireBridgeSession, e as assertBridgeContract, f as assertBridgeOptions, g as assertControlledSessionKey, h as hasBridgeMount, m as markBridgeMount, r as releaseBridgeSession, i as resolveBridgeContext, w as withBridgeTimeout } from './bridge-core-77BT1__I.cjs';
+export { a as BridgeApp, c as BridgeContextResolution, d as acquireBridgeSession, e as assertBridgeContract, f as assertBridgeOptions, g as assertControlledSessionKey, h as hasBridgeMount, m as markBridgeMount, r as releaseBridgeSession, i as resolveBridgeContext, w as withBridgeTimeout } from './bridge-core-CGFET9Qi.cjs';

package/dist/bridge-core.d.ts

@@ -1,2 +1,2 @@
 import './context.js';
-export { a as BridgeApp, c as BridgeContextResolution, d as acquireBridgeSession, e as assertBridgeContract, f as assertBridgeOptions, g as assertControlledSessionKey, h as hasBridgeMount, m as markBridgeMount, r as releaseBridgeSession, i as resolveBridgeContext, w as withBridgeTimeout } from './bridge-core-CoQRVgnZ.js';
+export { a as BridgeApp, c as BridgeContextResolution, d as acquireBridgeSession, e as assertBridgeContract, f as assertBridgeOptions, g as assertControlledSessionKey, h as hasBridgeMount, m as markBridgeMount, r as releaseBridgeSession, i as resolveBridgeContext, w as withBridgeTimeout } from './bridge-core-Dm6ABUxQ.js';

package/dist/bridge-core.js

@@ -8,7 +8,7 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-HDRZBSND.js";
+} from "./chunk-2MWIIRQZ.js";
 import "./chunk-GVWC7J7Q.js";
 import "./chunk-TSYLDY6H.js";
 import "./chunk-OF2JCXTZ.js";

package/dist/bridge-host-react.cjs

@@ -208,7 +208,7 @@ function releaseBridgeSession(sessionKey) {
   if (n <= 1) activeBridgeSessions.delete(sessionKey);
   else activeBridgeSessions.set(sessionKey, n - 1);
 }
-function resolveBridgeContext(spec, controlled, getContext) {
+function resolveBridgeContext(spec, controlled, getContext, managedSession = false) {
   if (getContext) {
     let snapshot;
     try {
@@ -219,6 +219,9 @@ function resolveBridgeContext(spec, controlled, getContext) {
     if (snapshot === null || typeof snapshot !== "object" || typeof snapshot.then === "function") {
       throw bridgeLifecycleError("getContext", spec, describeContextValue(snapshot));
     }
+    if (managedSession && controlled !== void 0 && snapshot.sessionKey === void 0) {
+      snapshot = { ...snapshot, sessionKey: controlled };
+    }
     if (controlled !== void 0 && snapshot.sessionKey !== controlled) {
       throw bridgeSessionMismatchError(spec, controlled, snapshot.sessionKey, { reason: "getter-snapshot" });
     }

package/dist/bridge-host-react.d.cts

@@ -1,7 +1,7 @@
 import { ReactNode, ComponentType } from 'react';
 import { AppContext } from './context.cjs';
-import { b as BridgeHostRouting } from './bridge-core-77BT1__I.cjs';
-import { F as FgBridgeEntry, a as FgBridgeAppProps } from './remote-types-CStGOJwu.cjs';
+import { b as BridgeHostRouting } from './bridge-core-CGFET9Qi.cjs';
+import { F as FgBridgeEntry, a as FgBridgeAppProps } from './remote-types-Cf4SSzus.cjs';
 import { FgTypeAuto } from '@fulgurjs/federation/internal/registry.js';
 
 /**

package/dist/bridge-host-react.d.ts

@@ -1,7 +1,7 @@
 import { ReactNode, ComponentType } from 'react';
 import { AppContext } from './context.js';
-import { b as BridgeHostRouting } from './bridge-core-CoQRVgnZ.js';
-import { F as FgBridgeEntry, a as FgBridgeAppProps } from './remote-types-COmBhjRc.js';
+import { b as BridgeHostRouting } from './bridge-core-Dm6ABUxQ.js';
+import { F as FgBridgeEntry, a as FgBridgeAppProps } from './remote-types-CMtfvLcH.js';
 import { FgTypeAuto } from '@fulgurjs/federation/internal/registry.js';
 
 /**

package/dist/bridge-host-react.js

@@ -10,7 +10,7 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-HDRZBSND.js";
+} from "./chunk-2MWIIRQZ.js";
 import {
   bridgeHostError
 } from "./chunk-GVWC7J7Q.js";

package/dist/bridge-host-vue.cjs

@@ -208,7 +208,7 @@ function releaseBridgeSession(sessionKey) {
   if (n <= 1) activeBridgeSessions.delete(sessionKey);
   else activeBridgeSessions.set(sessionKey, n - 1);
 }
-function resolveBridgeContext(spec, controlled, getContext) {
+function resolveBridgeContext(spec, controlled, getContext, managedSession = false) {
   if (getContext) {
     let snapshot;
     try {
@@ -219,6 +219,9 @@ function resolveBridgeContext(spec, controlled, getContext) {
     if (snapshot === null || typeof snapshot !== "object" || typeof snapshot.then === "function") {
       throw bridgeLifecycleError("getContext", spec, describeContextValue(snapshot));
     }
+    if (managedSession && controlled !== void 0 && snapshot.sessionKey === void 0) {
+      snapshot = { ...snapshot, sessionKey: controlled };
+    }
     if (controlled !== void 0 && snapshot.sessionKey !== controlled) {
       throw bridgeSessionMismatchError(spec, controlled, snapshot.sessionKey, { reason: "getter-snapshot" });
     }
@@ -633,9 +636,16 @@ var BridgeErrorPlaceholder = /* @__PURE__ */ (0, import_vue.defineComponent)({
     };
   }
 });
-function createVueBridgeAppWithLoader(loadRemote) {
+function createVueBridgeAppWithLoader(loadRemote, automaticSession) {
   return function createVueBridgeApp(spec, options = {}) {
     assertBridgeOptions(`createVueBridgeApp("${spec}")`, options);
+    if (options.session !== void 0 && typeof options.session !== "function") {
+      throw new TypeError("createVueBridgeApp \u7684 session \u5FC5\u987B\u662F\u540C\u6B65\u8EAB\u4EFD getter\uFF0C\u4F8B\u5982 session: () => auth.userId\uFF1B\u5DF2\u9000\u51FA\u8FD4\u56DE null\uFF0C\u8EAB\u4EFD\u6062\u590D\u4E2D\u8FD4\u56DE undefined\u3002");
+    }
+    if (options.session && !automaticSession) throw new Error("Vue\u6865\u63A5\u5165\u53E3\u672A\u7ED1\u5B9A\u81EA\u52A8\u4F1A\u8BDD\u5B9E\u73B0\uFF1B\u8BF7\u4ECE @fulgurjs/federation/vue \u5BFC\u5165\uFF0C\u4E0D\u76F4\u63A5\u8C03\u7528\u5185\u90E8\u5DE5\u5382\u3002");
+    if (options.sessionStorageKey !== void 0 && (!options.session || typeof options.sessionStorageKey !== "string" || !options.sessionStorageKey.trim())) {
+      throw new TypeError("sessionStorageKey \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32\uFF0C\u5E76\u4E0E session \u8EAB\u4EFD getter \u4E00\u8D77\u914D\u7F6E\uFF1B\u540C\u4E00\u5BBF\u4E3B\u7684\u8FDC\u7A0B\u4F7F\u7528\u76F8\u540C\u952E\u3002");
+    }
     const componentName = "FulgurjsBridge_" + spec.replace(/[^A-Za-z0-9_-]/g, "_");
     return (0, import_vue.defineComponent)({
       name: componentName,
@@ -649,6 +659,8 @@ function createVueBridgeAppWithLoader(loadRemote) {
         routing: { type: Object, required: false, default: void 0 }
       },
       setup(props) {
+        const managedSession = options.session ? automaticSession(options.session, options.sessionStorageKey ?? "fulgurjs-bridge-session") : void 0;
+        const currentSession = () => managedSession ? managedSession.sessionKey.value : props.sessionKey;
         const status = (0, import_vue.ref)("idle");
         const error = (0, import_vue.shallowRef)(void 0);
         const container = (0, import_vue.ref)(null);
@@ -692,9 +704,19 @@ function createVueBridgeAppWithLoader(loadRemote) {
         const run = async (myGeneration) => {
           const el = container.value;
           if (!el) return;
-          const sk = props.sessionKey;
+          const sk = currentSession();
           status.value = "pending";
           error.value = void 0;
+          if (managedSession && props.sessionKey !== void 0) {
+            error.value = bridgeHostError("getContext", spec, new Error("session \u81EA\u52A8\u7BA1\u7406\u4E0E sessionKey prop \u4E0D\u80FD\u540C\u65F6\u8BBE\u7F6E\uFF1B\u4FDD\u7559 session \u8EAB\u4EFD getter\uFF0C\u79FB\u9664\u624B\u5DE5\u4EE3\u6B21\u7ED1\u5B9A\u3002"));
+            status.value = "error";
+            return;
+          }
+          if (managedSession?.error.value !== void 0) {
+            error.value = bridgeHostError("getContext", spec, managedSession.error.value);
+            status.value = "error";
+            return;
+          }
           if (sk === null) {
             status.value = "idle";
             return;
@@ -707,7 +729,12 @@ function createVueBridgeAppWithLoader(loadRemote) {
               acquireBridgeSession(spec, controlled);
               acquiredSession = controlled;
             }
-            const resolution = resolveBridgeContext(spec, controlled, options.getContext);
+            const resolution = resolveBridgeContext(
+              spec,
+              controlled,
+              options.getContext ?? (managedSession ? () => ({}) : void 0),
+              !!managedSession
+            );
             if (resolution.provide) provideAppContext(resolution.provide);
             const load = loadRemote(spec, { retries: options.retries });
             const mod = options.timeout !== void 0 ? await withBridgeTimeout(load, options.timeout, spec) : await load;
@@ -751,7 +778,17 @@ function createVueBridgeAppWithLoader(loadRemote) {
           const myGeneration = generation;
           void run(myGeneration);
         });
-        (0, import_vue.watch)(() => props.sessionKey, () => {
+        if (managedSession) {
+          (0, import_vue.watch)(() => [currentSession(), managedSession.error.value, props.sessionKey], (after, before) => {
+            const released = invalidate();
+            if (after[0] === null && typeof before[0] === "string") clearAppContext();
+            if (!released) return;
+            const ticket = generation;
+            void Promise.resolve().then(() => {
+              if (ticket === generation && !containerBlocked) void run(ticket);
+            });
+          }, { flush: "sync" });
+        } else (0, import_vue.watch)(() => props.sessionKey, () => {
           start();
         });
         (0, import_vue.watch)(() => routingKey(props.routing), (after, before) => {

package/dist/bridge-host-vue.d.cts

@@ -1,11 +1,12 @@
 import { DefineComponent, Component } from 'vue';
 import { AppContext } from './context.cjs';
-import { b as BridgeHostRouting } from './bridge-core-77BT1__I.cjs';
-import { a as FgBridgeAppProps, F as FgBridgeEntry } from './remote-types-CStGOJwu.cjs';
+import { createAutomaticBridgeSession } from './bridge-session-auto.cjs';
+import { b as BridgeHostRouting } from './bridge-core-CGFET9Qi.cjs';
+import { a as FgBridgeAppProps, F as FgBridgeEntry } from './remote-types-Cf4SSzus.cjs';
 import { FgTypeAuto } from '@fulgurjs/federation/internal/registry.js';
 
 /**
- * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ * Vue 宿主桥接工厂（公开入口 /vue 导出 createVueBridgeApp）。
  *
  * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
  * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
@@ -33,6 +34,13 @@ interface VueBridgeAppOptions {
     timeout?: number;
     /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
     getContext?: () => Partial<AppContext> & Record<string, unknown>;
+    /**
+     * 自动会话：响应式地返回非敏感用户标识；null=已退出，undefined=用户资料恢复中。
+     * 同身份刷新/token轮换不换代，换身份自动重挂。不要再传 sessionKey prop 或在上下文里手填代次。
+     */
+    session?: () => string | number | null | undefined;
+    /** 自动会话命名空间；同一宿主的多个远程应使用同一键，默认 fulgurjs-bridge-session。 */
+    sessionStorageKey?: string;
 }
 /**
  * 构建 Vue 宿主桥接工厂（dist 壳与 dev 门面绑定各自运行时的 loadRemote 后导出）。
@@ -44,6 +52,6 @@ type FgVueBridgeWrapperResolved<P0, S extends string> = DefineComponent<{
     routing?: BridgeHostRouting;
 }, {}, unknown>;
 type FgVueBridgeWrapper<S extends string> = FgVueBridgeWrapperResolved<FgTypeAuto, S>;
-declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn): <P0 = FgTypeAuto, S extends string = string>(spec: S & FgBridgeEntry<S>, options?: VueBridgeAppOptions) => FgVueBridgeWrapperResolved<P0, S>;
+declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn, automaticSession?: typeof createAutomaticBridgeSession): <P0 = FgTypeAuto, S extends string = string>(spec: S & FgBridgeEntry<S>, options?: VueBridgeAppOptions) => FgVueBridgeWrapperResolved<P0, S>;
 
 export { type FgVueBridgeWrapper, type FgVueBridgeWrapperResolved, type VueBridgeAppOptions, createVueBridgeAppWithLoader };

package/dist/bridge-host-vue.d.ts

@@ -1,11 +1,12 @@
 import { DefineComponent, Component } from 'vue';
 import { AppContext } from './context.js';
-import { b as BridgeHostRouting } from './bridge-core-CoQRVgnZ.js';
-import { a as FgBridgeAppProps, F as FgBridgeEntry } from './remote-types-COmBhjRc.js';
+import { createAutomaticBridgeSession } from './bridge-session-auto.js';
+import { b as BridgeHostRouting } from './bridge-core-Dm6ABUxQ.js';
+import { a as FgBridgeAppProps, F as FgBridgeEntry } from './remote-types-CMtfvLcH.js';
 import { FgTypeAuto } from '@fulgurjs/federation/internal/registry.js';
 
 /**
- * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ * Vue 宿主桥接工厂（公开入口 /vue 导出 createVueBridgeApp）。
  *
  * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
  * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
@@ -33,6 +34,13 @@ interface VueBridgeAppOptions {
     timeout?: number;
     /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
     getContext?: () => Partial<AppContext> & Record<string, unknown>;
+    /**
+     * 自动会话：响应式地返回非敏感用户标识；null=已退出，undefined=用户资料恢复中。
+     * 同身份刷新/token轮换不换代，换身份自动重挂。不要再传 sessionKey prop 或在上下文里手填代次。
+     */
+    session?: () => string | number | null | undefined;
+    /** 自动会话命名空间；同一宿主的多个远程应使用同一键，默认 fulgurjs-bridge-session。 */
+    sessionStorageKey?: string;
 }
 /**
  * 构建 Vue 宿主桥接工厂（dist 壳与 dev 门面绑定各自运行时的 loadRemote 后导出）。
@@ -44,6 +52,6 @@ type FgVueBridgeWrapperResolved<P0, S extends string> = DefineComponent<{
     routing?: BridgeHostRouting;
 }, {}, unknown>;
 type FgVueBridgeWrapper<S extends string> = FgVueBridgeWrapperResolved<FgTypeAuto, S>;
-declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn): <P0 = FgTypeAuto, S extends string = string>(spec: S & FgBridgeEntry<S>, options?: VueBridgeAppOptions) => FgVueBridgeWrapperResolved<P0, S>;
+declare function createVueBridgeAppWithLoader(loadRemote: LoadRemoteFn, automaticSession?: typeof createAutomaticBridgeSession): <P0 = FgTypeAuto, S extends string = string>(spec: S & FgBridgeEntry<S>, options?: VueBridgeAppOptions) => FgVueBridgeWrapperResolved<P0, S>;
 
 export { type FgVueBridgeWrapper, type FgVueBridgeWrapperResolved, type VueBridgeAppOptions, createVueBridgeAppWithLoader };

package/dist/bridge-host-vue.js

@@ -10,11 +10,12 @@ import {
   releaseBridgeSession,
   resolveBridgeContext,
   withBridgeTimeout
-} from "./chunk-HDRZBSND.js";
+} from "./chunk-2MWIIRQZ.js";
 import {
   bridgeHostError
 } from "./chunk-GVWC7J7Q.js";
 import {
+  clearAppContext,
   provideAppContext
 } from "./chunk-TSYLDY6H.js";
 import "./chunk-OF2JCXTZ.js";
@@ -92,9 +93,16 @@ var BridgeErrorPlaceholder = /* @__PURE__ */ defineComponent({
     };
   }
 });
-function createVueBridgeAppWithLoader(loadRemote) {
+function createVueBridgeAppWithLoader(loadRemote, automaticSession) {
   return function createVueBridgeApp(spec, options = {}) {
     assertBridgeOptions(`createVueBridgeApp("${spec}")`, options);
+    if (options.session !== void 0 && typeof options.session !== "function") {
+      throw new TypeError("createVueBridgeApp \u7684 session \u5FC5\u987B\u662F\u540C\u6B65\u8EAB\u4EFD getter\uFF0C\u4F8B\u5982 session: () => auth.userId\uFF1B\u5DF2\u9000\u51FA\u8FD4\u56DE null\uFF0C\u8EAB\u4EFD\u6062\u590D\u4E2D\u8FD4\u56DE undefined\u3002");
+    }
+    if (options.session && !automaticSession) throw new Error("Vue\u6865\u63A5\u5165\u53E3\u672A\u7ED1\u5B9A\u81EA\u52A8\u4F1A\u8BDD\u5B9E\u73B0\uFF1B\u8BF7\u4ECE @fulgurjs/federation/vue \u5BFC\u5165\uFF0C\u4E0D\u76F4\u63A5\u8C03\u7528\u5185\u90E8\u5DE5\u5382\u3002");
+    if (options.sessionStorageKey !== void 0 && (!options.session || typeof options.sessionStorageKey !== "string" || !options.sessionStorageKey.trim())) {
+      throw new TypeError("sessionStorageKey \u5FC5\u987B\u662F\u975E\u7A7A\u5B57\u7B26\u4E32\uFF0C\u5E76\u4E0E session \u8EAB\u4EFD getter \u4E00\u8D77\u914D\u7F6E\uFF1B\u540C\u4E00\u5BBF\u4E3B\u7684\u8FDC\u7A0B\u4F7F\u7528\u76F8\u540C\u952E\u3002");
+    }
     const componentName = "FulgurjsBridge_" + spec.replace(/[^A-Za-z0-9_-]/g, "_");
     return defineComponent({
       name: componentName,
@@ -108,6 +116,8 @@ function createVueBridgeAppWithLoader(loadRemote) {
         routing: { type: Object, required: false, default: void 0 }
       },
       setup(props) {
+        const managedSession = options.session ? automaticSession(options.session, options.sessionStorageKey ?? "fulgurjs-bridge-session") : void 0;
+        const currentSession = () => managedSession ? managedSession.sessionKey.value : props.sessionKey;
         const status = ref("idle");
         const error = shallowRef(void 0);
         const container = ref(null);
@@ -151,9 +161,19 @@ function createVueBridgeAppWithLoader(loadRemote) {
         const run = async (myGeneration) => {
           const el = container.value;
           if (!el) return;
-          const sk = props.sessionKey;
+          const sk = currentSession();
           status.value = "pending";
           error.value = void 0;
+          if (managedSession && props.sessionKey !== void 0) {
+            error.value = bridgeHostError("getContext", spec, new Error("session \u81EA\u52A8\u7BA1\u7406\u4E0E sessionKey prop \u4E0D\u80FD\u540C\u65F6\u8BBE\u7F6E\uFF1B\u4FDD\u7559 session \u8EAB\u4EFD getter\uFF0C\u79FB\u9664\u624B\u5DE5\u4EE3\u6B21\u7ED1\u5B9A\u3002"));
+            status.value = "error";
+            return;
+          }
+          if (managedSession?.error.value !== void 0) {
+            error.value = bridgeHostError("getContext", spec, managedSession.error.value);
+            status.value = "error";
+            return;
+          }
           if (sk === null) {
             status.value = "idle";
             return;
@@ -166,7 +186,12 @@ function createVueBridgeAppWithLoader(loadRemote) {
               acquireBridgeSession(spec, controlled);
               acquiredSession = controlled;
             }
-            const resolution = resolveBridgeContext(spec, controlled, options.getContext);
+            const resolution = resolveBridgeContext(
+              spec,
+              controlled,
+              options.getContext ?? (managedSession ? () => ({}) : void 0),
+              !!managedSession
+            );
             if (resolution.provide) provideAppContext(resolution.provide);
             const load = loadRemote(spec, { retries: options.retries });
             const mod = options.timeout !== void 0 ? await withBridgeTimeout(load, options.timeout, spec) : await load;
@@ -210,7 +235,17 @@ function createVueBridgeAppWithLoader(loadRemote) {
           const myGeneration = generation;
           void run(myGeneration);
         });
-        watch(() => props.sessionKey, () => {
+        if (managedSession) {
+          watch(() => [currentSession(), managedSession.error.value, props.sessionKey], (after, before) => {
+            const released = invalidate();
+            if (after[0] === null && typeof before[0] === "string") clearAppContext();
+            if (!released) return;
+            const ticket = generation;
+            void Promise.resolve().then(() => {
+              if (ticket === generation && !containerBlocked) void run(ticket);
+            });
+          }, { flush: "sync" });
+        } else watch(() => props.sessionKey, () => {
           start();
         });
         watch(() => routingKey(props.routing), (after, before) => {