@fulgurjs/federation 5.9.2 → 6.0.0

package/dist/vue.d.ts

@@ -0,0 +1,576 @@
+import * as vue from 'vue';
+import { Component, App } from 'vue';
+
+/**
+ * 跨应用上下文标准字段表（§4.3，0.8.2 精简后）。
+ *
+ * 读写约定：宿主桥先写标准字段；远程 boot 只增不改宿主键；
+ * 嵌套对象（如 events）是引用共享，子应用挂属性即时可见（同 realm 直引用）。
+ *
+ * 精简记录（0.8.2）：`token` 快照与 `formUrl`/`baseUrl` 从默认 provide 集合移除——
+ * token 快照与 getToken 函数引用重复（快照会过期），formUrl/baseUrl 自 0.7.0
+ * remoteComponent 直渲染后无消费点；项目如需可经扩展位自行提供。
+ */
+interface AppContext {
+    /** 宿主登录用户原始形态（只读约定） */
+    user: Record<string, any>;
+    /** 取最新 token（拉取式防过期；0.8.2 起 bridge 不再传一次性 token 快照，用本函数取值） */
+    getToken?: () => string | undefined;
+    /** 宿主 pinia 实例：子应用 useUserStore(ctx.store) 拿共享响应式状态 */
+    store?: unknown;
+    /** 宿主 Vue App 实例（同 realm 直引用）：全局组件/指令注册目标 */
+    hostApp?: unknown;
+    /** EP locale 等 UI 配置（原 W4 字段） */
+    locale?: unknown;
+    /** 事件/方法池：events.main.* 宿主提供、events.bpm.* / events.lowcode.* 子应用反向注册 */
+    events?: Record<string, any>;
+    /**
+     * 非敏感登录代次 ID：宿主每次成功登录/重新登录生成新值，token 刷新但会话未变时沿用。
+     * 远程 onSession 按它去重（同一代次只执行一次）。不是用户 ID、不是 token、不作为授权凭证。
+     * 远程声明了 onSession 时必填（缺省即 MFU-013）。
+     */
+    sessionKey?: string;
+    /** 项目扩展位（formUrl/baseUrl 等自定义键，按需自行提供） */
+    [key: string]: unknown;
+}
+/**
+ * 宿主写入跨应用上下文（merge 语义，幂等可多次调用，后写覆盖同键）。
+ *
+ * 宿主桥（host/src/fulgurjs/host/bridge.ts）在登录完成后调用：
+ * provideAppContext({ user, getToken, store, hostApp, locale, sessionKey, events: { main: mainEvents }, ... })
+ * 登录态变化（换账号/token 刷新）时再次调用即以最新值覆盖同键——不要用布尔闩锁把桥封成只跑一次。
+ */
+declare function provideAppContext(config: Partial<AppContext> & Record<string, unknown>): void;
+/**
+ * 宿主退出登录时清理：删除整个 context 对象（旧 user/getToken 引用一并失效），并通知
+ * 运行时单例作废全部远程的会话信号与 onSession 去重状态（下次登录必须重新执行 onSession）。
+ *
+ * 边界（契约）：只清 AppContext 与会话初始化状态；不重置远程模块缓存、共享模块图与
+ * 应用级 setup 注册（同一页面内组件与共享实例继续复用）。页面无运行时单例时静默幂等
+ * （退出动作不依赖联邦形态，不得因缺运行时而打断登出流程）。
+ */
+declare function clearAppContext(): void;
+/**
+ * 读上下文快照（传输层快照：顶层 merge 结果 + 嵌套对象引用共享）。
+ * 页面无运行时单例（独立直开远程页）→ CC-002 显式抛错，不静默回空。
+ */
+declare function getAppContext(): AppContext;
+/**
+ * 显式校验读取（远程 setup/boot 消费入口）：任一键缺失 → CC-001 三段式。
+ *
+ * 用法：const { store, user, hostApp } = requireAppContext('store', 'user', 'hostApp')
+ * 时序契约：宿主桥先 provide，远程 setup/onSession 后 require——违反即在初始化处显式失败。
+ */
+declare function requireAppContext(...keys: string[]): AppContext;
+
+/**
+ * Vue 宿主桥接工厂（/bridge、/bridge/vue 导出 createVueBridgeApp；任务书 §3.4）。
+ *
+ * 定位：接收注入的 loadRemote（不静态引用运行时内核，dist 壳绑定），返回一个
+ * 包装组件 `{ appProps: P; sessionKey?: string | null }`，负责：
+ * - DOM 所有权（§4.5）：只创建并保持稳定的空挂载 el（多根 fragment 的固定子节点）；
+ *   pending/error 占位是它的兄弟节点，宿主重渲染不 patch 子应用 root 内部；
+ * - 会话代次（§4.3）：受控 sessionKey 驱动 挂载/换会话/登出；同会话重渲染不重挂；
+ * - 错误诊断：契约非法 MFU-015、生命周期失败 MFU-016（phase 区分）、会话矛盾 MFU-017；
+ *   默认占位含「重试加载 / 刷新页面重试」两条恢复操作（§4.4）。
+ *
+ * appProps 是挂载时浅拷贝快照（顶层替换不追踪、不重渲染子应用，重挂由 :key 重建）；
+ * sessionKey 是桥接控制参数，不混入业务 props。
+ */
+
+interface VueBridgeAppOptions {
+    /** 加载 pending 占位组件（默认无占位节点） */
+    loadingComponent?: Component;
+    /** 加载/挂载失败占位（完全接管，契约不变：只接收 error prop；默认内置中文诊断 + 两条恢复操作） */
+    errorComponent?: Component;
+    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
+    retries?: number;
+    /** 本次桥接加载等待上限 ms；不取消已发出的共享请求，迟到结果一律丢弃 */
+    timeout?: number;
+    /** 无副作用的同步 getter：首次、重试及换会话的实际加载前返回本次所需上下文快照 */
+    getContext?: () => Partial<AppContext> & Record<string, unknown>;
+}
+
+/**
+ * D.2 宿主路由表校验器（definePages）
+ *
+ * 背景：带参路由缺省推导 spec 时会剥离 :参数 段，可能与其它条目（如列表页）的
+ * expose 键收敛相同 → 静默加载错误组件（真实事故：复制流程误走更新语义）。
+ *
+ * 定位：纯同步纯函数，dev（宿主浏览器模块求值）与 build（node）行为一致；
+ * 只校验不改写入参；ERROR 级聚合一次 throw（strict:false 降级 console.error），
+ * WARN 级聚合 console.warn。
+ *
+ * 规则：
+ * - R1 [ERROR] 带参路由（无显式 spec）的推导 spec 与任一其它条目的有效 spec 相同
+ * - R2 [WARN]  多条目的有效 spec 完全相同（可能是刻意的菜单别名，要求有意识）
+ * - R3 [ERROR] schema 提供时：有效 spec 的 exposes 键不在对应 remote 清单中
+ *              （把运行时 MFU-006 提前到启动期；schema 缺失/remote 不可达则跳过）
+ * - R4 [ERROR] 静态路由被数组中更靠前的带参路由遮蔽（先到先得 → 静态路由成死路由）；
+ *              含路由完全重复
+ * - R5 [WARN]  name 字段重复（vue-router 命名跳转歧义）
+ */
+interface PageRouteLike {
+    /** 宿主路由路径（:param 段） */
+    route: string;
+    /** 显式 spec（缺省走推导） */
+    spec?: string;
+    /** 其余字段（name/title/...）由宿主自由扩展，校验器按需读取 */
+    name?: string;
+    [key: string]: unknown;
+}
+interface RemoteSchemaEntry {
+    /** 该 remote 的 exposes 键清单（与 spec 同口径，剥 ./ 前缀比较） */
+    exposes: string[];
+    /** manifest 是否成功拉取（false 时跳过该 remote 的 R3，诚实降级） */
+    exists?: boolean;
+}
+interface PagesOptions {
+    /**
+     * 带参路由的缺省 spec 推导规则（宿主私有约定，如
+     * (route) => `pages/${route 去前缀去 :参}`）。
+     * 缺省 = 去掉首段（远程前缀）+ 剥 :参 段（无 pages/ 前缀）——
+     * 推导只需在全部条目间自洽即可保持冲突判定成立。
+     */
+    deriveSpec?: (route: string) => string;
+    /** 路由前缀 → remote 名（R3 用：{'/remote-a/': 'remote-a'}）；缺省跳过 R3 */
+    remotes?: Record<string, string>;
+    /** remote exposes 清单（dev 由 virtual:fulgurjs-remote-schema 提供）；缺省跳过 R3 */
+    schema?: Record<string, RemoteSchemaEntry>;
+    /** false = ERROR 降级 console.error（默认 true = throw） */
+    strict?: boolean;
+}
+interface PageViolation {
+    rule: 'R1' | 'R2' | 'R3' | 'R4' | 'R5';
+    level: 'error' | 'warn';
+    message: string;
+}
+/**
+ * 校验路由表（独立导出便于单测）：返回违例清单（不抛错）。
+ */
+declare function validatePages(pages: PageRouteLike[], options?: PagesOptions): PageViolation[];
+/**
+ * 宿主路由表定义入口：校验（聚合报错）后原样返回入参，不改写任何字段。
+ * 违反 ERROR 级规则时默认 throw（dev overlay / build 失败直接可见）；
+ * strict: false 时降级 console.error。WARN 级始终 console.warn。
+ */
+declare function definePages<P extends PageRouteLike[]>(pages: P, options?: PagesOptions): P;
+
+/**
+ * 宿主页面表纯解析核心（框架无关）。
+ *
+ * 5.1.0 从 vue-adapter 提取：definePages 校验接入、最长前缀远程归属、缺省 spec 推导、
+ * base 剥离、段式参数匹配——Vue 与 React 适配器共用同一份解析，组件缓存/错误边界/
+ * 保活策略由各框架适配器自行负责（不把 Vue 的卸载策略强加给 React，反之亦然）。
+ */
+
+/** 页面表数据项（两个框架适配器共用；展示项 fallback/error 等在各适配器定义） */
+interface HostPagesCoreOptions {
+    /** 页面表（宿主路由与布局共用的唯一数据源；definePages R1–R5 校验照常执行） */
+    pages: PageRouteLike[];
+    /** 路由前缀 → remote 名（最长前缀匹配；页面路由无匹配前缀时创建期即报错） */
+    remotePrefixes: Record<string, string>;
+    /** 缺省 spec 推导（缺省 = 去首段前缀 + 剥 :参数 段，同 definePages 默认） */
+    deriveSpec?: (route: string) => string;
+    /** 远程 exposes 清单（dev 由 remoteSchema 提供；build 为空表时按语义诚实降级） */
+    schema?: Record<string, RemoteSchemaEntry>;
+    /** ERROR 级校验失败是否 throw（默认 true） */
+    strict?: boolean;
+    /** 站点 base 前缀（如 '/main'）：resolve 时先剥离再匹配路由空间 */
+    base?: string;
+}
+interface ResolvedHostPage {
+    /** 原页面记录（含宿主自由扩展字段 name/title/keepAlive/...） */
+    page: PageRouteLike;
+    /** 命中的 remote 名 */
+    remote: string;
+    /** 完整加载 spec（`<remote>/<exposes 键>`，loadRemote 直用） */
+    spec: string;
+    /** 路径参数（解码失败只让该次匹配失败，不让页面初始化崩溃） */
+    params: Record<string, string>;
+}
+
+/** Vue 适配层只接收加载函数，不静态引用运行时内核。 */
+
+interface RemoteComponentOptions {
+    loadingComponent?: Component;
+    errorComponent?: Component;
+    retries?: number;
+    delay?: number;
+    timeout?: number;
+}
+interface HostPagesOptions extends HostPagesCoreOptions {
+    /** 每次页面模块实际加载前执行（同步或异步）；宿主在此提供最新 context */
+    beforeLoad?: () => void | Promise<void>;
+    /** 加载期占位组件（骨架屏） */
+    loadingComponent?: Component;
+    /** 错误占位组件（缺省 = 内置错误占位：错误码+根因+修法+重试加载/刷新页面重试；自定义时完全接管） */
+    errorComponent?: Component;
+    /** 骨架屏延迟 ms（默认 200，防闪） */
+    delay?: number;
+}
+interface HostPages {
+    /** 原页面记录 */
+    pages: PageRouteLike[];
+    /** 路径 → 页面解析（兼容 base 前缀与深链；无匹配返回 null） */
+    resolve(path: string): ResolvedHostPage | null;
+    /** 按 spec 取异步页面组件（同 spec 复用；换登录代次后重建以触发会话同步） */
+    component(spec: string): Component;
+    /** 保活白名单：keepAlive 页面的组件 name（与实际被 KeepAlive 缓存的包装组件一致） */
+    keepAliveNames: string[];
+}
+declare function createHostPages$1(options: HostPagesOptions, load: (spec: string, opts?: {
+    retries?: number;
+}) => Promise<any>): HostPages;
+
+/** 统一错误码体系（对齐 webpack ScriptExternalLoadError 等运行时错误的可诊断性） */
+declare class FgError extends Error {
+    code: string;
+    details?: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+
+interface ShareEntry {
+    version: string;
+    get: () => Promise<any>;
+    from: string;
+    eager: boolean;
+    loaded?: boolean;
+    /** 首次 loadShare 成功后缓存的实例值；getLoadedShare 同步查询与 CJS 垫片依赖它 */
+    value?: any;
+    /** 进行中的 get()：并发 loadShare 共享同一次加载，落定后清除（失败后允许重新加载） */
+    pendingGet?: Promise<any>;
+}
+type ShareScope = Record<string, Record<string, ShareEntry>>;
+type ShareScopeMap = Record<string, ShareScope>;
+interface RemoteConfig {
+    name: string;
+    entry: string;
+    shareScope?: string;
+    /**
+     * 加载超时 ms，默认 15000。注意：超时只代表"调用方不再等待"，浏览器不会取消已发出的
+     * 动态 import——下一次调用复用同一条 in-flight 记录，不会重复初始化同一容器。
+     */
+    timeout?: number;
+    /** 失败重试次数，默认 2（上限 10；配置期与运行时注册均校验，非法当场抛错） */
+    retries?: number;
+    /** 备用 remoteEntry 地址（首个失败后依次尝试） */
+    fallback?: string[];
+    breaker?: {
+        threshold?: number;
+        resetMs?: number;
+    };
+    /** promise-based remote：运行时解析出容器或容器地址（其解析同样受 timeout 约束） */
+    promise?: () => Promise<any>;
+    /** 内部：远程自报的发布路径（preload 用） */
+    manifestUrl?: string;
+}
+/** @deprecated 兼容旧版公开类型；新代码使用 RemoteConfig。 */
+interface RemoteInput extends RemoteConfig {
+    container?: unknown;
+    containerPromise?: Promise<unknown>;
+}
+interface LoadRemoteOptions {
+    shareScope?: string;
+    retries?: number;
+    fallbackModule?: () => any;
+}
+interface PreloadRemoteOptions {
+    mode?: 'preload' | 'prefetch';
+}
+interface LoadShareOptions {
+    requiredVersion?: string | false;
+    singleton?: boolean;
+    strictVersion?: boolean;
+    shareKey?: string;
+    shareScope?: string;
+    /** 本地副本兜底（webpack shared.import） */
+    fallback?: () => Promise<any>;
+    /** 内部：本地副本的版本号（fallback 回写共享作用域与 CJS 垫片 pin 使用；不参与快照键） */
+    localVersion?: string;
+}
+interface RuntimePlugin {
+    name?: string;
+    init?: (hooks: RuntimeHooks) => void;
+}
+interface RuntimeHooks {
+    /** 覆写共享版本裁决结果：返回 ShareEntry 即生效 */
+    resolveShare?: (shareInfo: {
+        shareKey: string;
+        shareScope: string;
+        requiredVersion?: string | false;
+        picked?: ShareEntry;
+        available: ShareEntry[];
+    }) => Promise<ShareEntry | void> | ShareEntry | void;
+    beforeLoadRemote?: (info: {
+        remote: string;
+        module: string;
+    }) => void;
+    afterLoadRemote?: (info: {
+        remote: string;
+        module: string;
+        module_ns?: any;
+    }) => void;
+    onRemoteError?: (info: {
+        remote: string;
+        error: FgError;
+    }) => void;
+}
+interface RemoteDebugInfo {
+    entry: string;
+    status: 'idle' | 'loading' | 'loaded' | 'failed';
+    lastLoadMs?: number;
+    error?: string;
+    /** setup 生命周期状态（§3.3.1）：none=未配置 / pending=执行中 / ready=应用级已完成 / failed=失败可重试 */
+    setup?: 'none' | 'pending' | 'ready' | 'failed';
+}
+/**
+ * 远程初始化上下文（federation({ setup }) 模块的默认导出与具名 onSession 收到的参数）。
+ * appContext 是调用时从页面级 AppContext 取得的当前快照（不缓存旧引用）；
+ * signal 在登录代次变化或退出清理时失效，业务异步写回前必须检查 aborted。
+ */
+interface RemoteSetupContext {
+    appContext: Readonly<Record<string, any>>;
+    sessionKey?: string;
+    signal: AbortSignal;
+}
+/** setup 模块的固定导出契约：默认导出必为函数；onSession 可选且必须是函数 */
+interface RemoteSetupModule {
+    default: (ctx: RemoteSetupContext) => void | Promise<void>;
+    onSession?: (ctx: RemoteSetupContext) => void | Promise<void>;
+}
+declare function createRuntime(): {
+    shareScopeMap: ShareScopeMap;
+    initSharing: (scopeName?: string) => ShareScopeMap;
+    registerShare: (scopeName: string, name: string, version: string, get: () => Promise<any>, opts?: {
+        from?: string;
+        eager?: boolean;
+        loaded?: boolean;
+    }) => void;
+    registerRemotes: (list: RemoteConfig[]) => void;
+    registerRemote: (remote: RemoteConfig) => void;
+    registerPlugins: (list: RuntimePlugin[]) => void;
+    loadShare: (name: string, opts?: LoadShareOptions) => Promise<any>;
+    loadShareSync: (name: string, opts: LoadShareOptions) => {
+        kind: "ready" | "local";
+        value?: any;
+    };
+    prepareShares: (requests: Array<{
+        name: string;
+        opts: LoadShareOptions;
+    }>) => Promise<void>;
+    getLoadedShare: (name: string, opts?: LoadShareOptions) => any;
+    pinLoadedShare: (name: string, opts: LoadShareOptions, localVersion: string, instance: unknown) => void;
+    loadRemote: <T = Record<string, any>>(spec: string, opts?: LoadRemoteOptions) => Promise<T>;
+    getContainer: (name: string) => Promise<any>;
+    preloadRemote: (spec: string, opts?: PreloadRemoteOptions) => Promise<void>;
+    parseSpec: (spec: string) => {
+        remote: string;
+        module: string;
+    };
+    clearSessionState: () => void;
+};
+type FgRuntime = ReturnType<typeof createRuntime>;
+/** 插件版本（与 package.json 同步维护于 src/version.ts，测试拦截漂移；用于跨源副本一致性诊断） */
+declare const version: string;
+/**
+ * 取当前页面生效的运行时单例（与 globalThis.__FULGURJS_RUNTIME__ 同一实例）。
+ *
+ * 远程页面禁止静态 import 'virtual:fulgurjs-runtime'——该虚拟模块由远程 dev server
+ * 求值，会在远程模块图内实例化独立的运行时副本，破坏渲染上下文
+ * （resolveComponent / withDirectives / ref owner 告警、内容区空白）。
+ * 跨源取运行时一律用本入口，或直接读全局单例。
+ */
+declare function getRuntime(): FgRuntime;
+declare const initSharing: (scopeName?: string) => ShareScopeMap;
+declare const registerShare: (scopeName: string, name: string, version: string, get: () => Promise<any>, opts?: {
+    from?: string;
+    eager?: boolean;
+    loaded?: boolean;
+}) => void;
+declare const registerRemotes: (list: RemoteConfig[]) => void;
+declare const registerRemote: (remote: RemoteConfig) => void;
+declare const registerPlugins: (list: RuntimePlugin[]) => void;
+declare const loadShare: (name: string, opts?: LoadShareOptions) => Promise<any>;
+/** CJS 垫片专用同步查询（内部使用，不进公开入口壳清单） */
+declare const getLoadedShare: (name: string, opts?: LoadShareOptions) => any;
+declare const pinLoadedShare: (name: string, opts: LoadShareOptions, localVersion: string, instance: unknown) => void;
+declare const loadRemote: <T = Record<string, any>>(spec: string, opts?: LoadRemoteOptions) => Promise<T>;
+declare const getContainer: (name: string) => Promise<any>;
+declare const preloadRemote: (spec: string, opts?: PreloadRemoteOptions) => Promise<void>;
+declare const parseSpec: (spec: string) => {
+    remote: string;
+    module: string;
+};
+/** 退出清理的运行时侧：作废全部远程的会话信号与 onSession 去重状态（clearAppContext 调用） */
+declare const clearSessionState: () => void;
+declare const shareScopeMap: ShareScopeMap;
+/** default 导出 interop：ESM 取 .default；CJS 命名空间回退整体 */
+declare function unwrapDefault(ns: any): any;
+
+/** 统一逻辑位置：pathname 以 / 开头；search 空串或 ? 开头；hash 空串或 # 开头 */
+interface BridgeLocation {
+    pathname: string;
+    search: string;
+    hash: string;
+}
+type BridgeNavigationResult = {
+    status: 'committed';
+    location: BridgeLocation;
+} | {
+    status: 'cancelled';
+    location: BridgeLocation;
+};
+/** 宿主导航端口（宿主适配器把 Router 包装成本接口；逻辑路径不含部署 base） */
+interface BridgeHostNavigation {
+    getLocation(): BridgeLocation;
+    subscribe(listener: (location: BridgeLocation) => void): () => void;
+    navigate(target: BridgeLocation, action: 'push' | 'replace', options?: {
+        signal?: AbortSignal;
+    }): Promise<BridgeNavigationResult>;
+    go(delta: number): void;
+}
+/** 子应用路由通道（桥接宿主按挂载代次创建，随 mount 第三参数交给子应用） */
+interface BridgeChildRoute {
+    /**
+     * 远程 spec（宿主创建通道时标注，如 "remote-b/bridge"）；子应用路由接线
+     * （connectVueBridgeRouter/createReactBridgeRouter）的诊断错误用它定位真实远程，
+     * 缺省（纯 memory 小部件自建通道）回退 'child-router'。
+     */
+    readonly spec?: string;
+    getLocation(): BridgeLocation;
+    subscribe(listener: (location: BridgeLocation) => void): () => void;
+    navigate(target: BridgeLocation, action: 'push' | 'replace'): Promise<BridgeNavigationResult>;
+    go(delta: number): void;
+}
+/** 挂载控制参数（mount 第三参数；不混入业务 props） */
+interface BridgeMountOptions {
+    signal?: AbortSignal;
+    routing?: BridgeChildRoute;
+}
+/** 子应用路由协议声明（defineBridgeApp(工厂, { routing: true }) 时写入） */
+interface BridgeRoutingProtocol {
+    protocol: 1;
+}
+/** 宿主组件 routing prop（独立控制通道，不进 appProps/Context） */
+interface BridgeHostRouting {
+    /** 宿主路由视角的静态绝对路径，如 "/approval"；同页各同步实例不得相同或重叠 */
+    basePath: string;
+    navigation: BridgeHostNavigation;
+}
+/**
+ * vue-router 实例的最小结构面（/vue 路由同步端口参数；真实 vue-router Router 结构兼容可赋值）。
+ * 6.0.0 可选依赖边界：/vue 的 d.ts 不得 import vue-router 类型——未安装 vue-router 的
+ * 纯组件工程在 skipLibCheck:false 下也必须能通过类型检查；结构类型的宽化只影响
+ * 路由同步端口处的精确提示，业务代码自己的 Router 类型不受影响。
+ */
+interface VueRouterLike {
+    currentRoute: {
+        value: {
+            fullPath: string;
+        };
+    };
+    push(to: string): Promise<unknown>;
+    replace(to: string): Promise<unknown>;
+    go(delta: number): void;
+    back(): void;
+    forward(): void;
+    afterEach(handler: (to: unknown, from: unknown, failure?: unknown) => void): () => void;
+    beforeResolve(handler: () => unknown): () => void;
+    beforeEach(handler: () => unknown): () => void;
+}
+
+/** 子应用桥接契约（远程 ./bridge 模块的默认导出；任务书 §3.2） */
+interface BridgeApp {
+    /** 首次根提交完成时才算挂载成功；同一容器未卸载前重复 mount 是契约违例 */
+    mount(el: HTMLElement, props?: Record<string, unknown>, options?: BridgeMountOptions): void | Promise<void>;
+    /** 同步使当前挂载代次失效并清理已创建的 root；未知容器为 no-op */
+    unmount(el: HTMLElement): void;
+    /**
+     * 路由协议声明（URL 同步）：defineBridgeApp(工厂, { routing: true }) 时写入
+     * { protocol: 1 }。宿主启用 routing 时必须存在且 protocol === 1（MFU-031），
+     * 不允许静默退回 memory 假装深链成功。
+     */
+    routing?: BridgeRoutingProtocol;
+}
+
+/**
+ * Vue 子应用桥接适配（/runtime 导出 defineBridgeApp；任务书 §3.3 D1/D2）。
+ *
+ * 工厂形态：接收 props 快照，返回已装配完整的 VueApp（router/pinia 等由子应用自行装配）；
+ * helper 负责 app.mount(el) / app.unmount() 与按容器 el 的实例跟踪。
+ *
+ * 契约语义（§3.2）：
+ * - 契约实例按容器 el 分键（WeakMap）：同一契约多处挂载互不干扰；
+ * - 同一容器未卸载再次 mount → 拒绝（容器占用，原始错误原样抛出）且不覆盖原实例；
+ * - Vue 的 app.mount 同步完成首次渲染，mount 成功即返回 void（首次根提交语义由 Vue 保证）；
+ * - mount 抛错时清理已创建的 app（best-effort unmount），不留半挂状态；
+ * - unmount 未知容器为 no-op；mount/unmount 的原始错误**原样抛出**——MFU-016 包装
+ *   （真实 spec + phase + cause）由宿主适配器在生命周期边界统一完成（见 bridgeHostError）。
+ *
+ * 本文件零 React：/runtime 导入图隔离由 tests/runtime-entry-graph.test.ts 守护。
+ */
+
+/** 工厂第二参数：挂载生命周期与路由通道（URL 同步；不混入业务 props） */
+interface VueBridgeAppContext {
+    /** 会话代次信号（登出/换代即 aborted；异步写回前必须检查） */
+    signal?: AbortSignal;
+    /** 路由通道（宿主启用 URL 同步时存在）；配 connectVueBridgeRouter 使用 */
+    routing?: BridgeChildRoute;
+}
+/**
+ * Vue 子应用工厂：接收挂载时 props 快照与生命周期上下文，返回装配完成的 VueApp。
+ * 允许返回 Promise<VueApp>（URL 同步子应用的初始 memory 路由准备是异步的——
+ * 必须等初始 push 落定再 app.use(router)，否则 install 的初始导航会覆盖深链位置；
+ * 见 /bridge/router/vue 的 connectVueBridgeRouter 与任务书 §1 原型结论 1）。
+ * Promise 被作废（signal aborted / 容器已换代）时结果丢弃，不落挂。
+ */
+type VueBridgeAppFactory = (props: Record<string, unknown>, ctx?: VueBridgeAppContext) => App | Promise<App>;
+interface DefineVueBridgeAppOptions {
+    /**
+     * 声明路由协议（URL 同步）：契约写入 routing: { protocol: 1 }，宿主启用 routing 时
+     * 校验；未声明而宿主启用同步 → MFU-031（不静默退回 memory 假装深链成功）。
+     */
+    routing?: boolean;
+}
+/**
+ * 定义 Vue 子应用的桥接契约（远程 ./bridge 模块默认导出）。
+ *
+ * ```ts
+ * import { createApp } from 'vue'
+ * import { defineBridgeApp } from '@fulgurjs/federation/vue'
+ * export default defineBridgeApp((props) => { const app = createApp(App, props); app.use(router); return app })
+ * ```
+ */
+declare function defineBridgeApp$1(factory: VueBridgeAppFactory, options?: DefineVueBridgeAppOptions): BridgeApp;
+
+/** Vue Router 4/5 的宿主导航端口与子应用 memory router 接线（统一入口 /vue 提供）。 */
+
+interface VueBridgeNavigationOptions {
+    /** 保留配置兼容；Vue Router fullPath 已剥离 history base，不再二次剥离。 */
+    routerBase?: string;
+}
+declare function createVueBridgeNavigation(router: VueRouterLike, _options?: VueBridgeNavigationOptions): BridgeHostNavigation;
+interface VueBridgeRouterConnection {
+    /** 必须 await ready 后再 app.use(router)，初始错误会拒绝此 Promise。 */
+    ready: Promise<void>;
+    dispose(): void;
+}
+/** 接线限子应用自己的 memory router；dispose 恢复原始导航方法。 */
+declare function connectVueBridgeRouter(routing: BridgeChildRoute, router: VueRouterLike, options?: {
+    signal?: AbortSignal;
+}): VueBridgeRouterConnection;
+
+declare const remoteComponent: (spec: string, opts?: RemoteComponentOptions) => vue.Component;
+/** 宿主页面适配器（绑定本包运行时的 loadRemote；选项与返回值类型见 vue-adapter） */
+declare function createHostPages(options: Parameters<typeof createHostPages$1>[0]): HostPages;
+/** Vue 子应用桥接契约（远程 ./bridge 模块默认导出） */
+declare const defineBridgeApp: typeof defineBridgeApp$1;
+/** Vue 宿主桥接工厂：返回 `{ appProps: P; sessionKey?: string | null }` 形态的包装组件 */
+declare const createVueBridgeApp: <P = Record<string, unknown>>(spec: string, options?: VueBridgeAppOptions) => vue.Component;
+
+type RemoteSchema = Record<string, RemoteSchemaEntry>;
+/** 无插件转换的场景（构建、Node 导入）如实返回空清单。 */
+declare const remoteSchema: RemoteSchema;
+
+export { type AppContext, type BridgeApp, type BridgeHostRouting, type FgRuntime, type HostPages, type HostPagesOptions, type LoadRemoteOptions, type LoadShareOptions, type PageRouteLike, type PageViolation, type PagesOptions, type PreloadRemoteOptions, type RemoteComponentOptions, type RemoteConfig, type RemoteDebugInfo, type RemoteInput, type RemoteSchema, type RemoteSchemaEntry, type RemoteSetupContext, type RemoteSetupModule, type ResolvedHostPage, type RuntimeHooks, type RuntimePlugin, type ShareEntry, type ShareScope, type ShareScopeMap, type VueBridgeAppFactory, type VueBridgeAppOptions, type VueBridgeNavigationOptions, type VueBridgeRouterConnection, clearAppContext, clearSessionState, connectVueBridgeRouter, createHostPages, createVueBridgeApp, createVueBridgeNavigation, defineBridgeApp, definePages, getAppContext, getContainer, getLoadedShare, getRuntime, initSharing, loadRemote, loadShare, parseSpec, pinLoadedShare, preloadRemote, provideAppContext, registerPlugins, registerRemote, registerRemotes, registerShare, remoteComponent, remoteSchema, requireAppContext, shareScopeMap, unwrapDefault, validatePages, version };

package/dist/vue.js

@@ -1,6 +1,14 @@
+export { initSharing, registerShare, registerRemotes, registerRemote, registerPlugins, loadShare, loadRemote, getLoadedShare, pinLoadedShare, getContainer, preloadRemote, parseSpec, getRuntime, shareScopeMap, unwrapDefault, version, clearSessionState } from "./runtime.js";
+export { provideAppContext, getAppContext, requireAppContext, clearAppContext } from "./context.js";
+export { definePages, validatePages } from "./pages.js";
 import { loadRemote } from "./runtime.js";
 import { createRemoteComponent, createHostPages as createHostPagesWithLoader } from "./vue-adapter.js";
 import { defineBridgeApp as defineVueBridgeApp } from "./bridge-app-vue.js";
+import { createVueBridgeAppWithLoader } from "./bridge-host-vue.js";
+import { createVueBridgeNavigation, connectVueBridgeRouter } from "./bridge-router-vue.js";
 export const remoteComponent = createRemoteComponent(loadRemote);
 export const createHostPages = (options) => createHostPagesWithLoader(options, loadRemote);
 export const defineBridgeApp = defineVueBridgeApp;
+export const createVueBridgeApp = createVueBridgeAppWithLoader(loadRemote);
+export { createVueBridgeNavigation, connectVueBridgeRouter };
+export const remoteSchema = {};