@fulgurjs/federation 5.0.3 → 5.1.0

package/dist/react.d.ts

@@ -0,0 +1,442 @@
+import * as react from 'react';
+import { ComponentType, ReactNode, Component, ErrorInfo } from 'react';
+
+/** 统一错误码体系（对齐 webpack ScriptExternalLoadError 等运行时错误的可诊断性） */
+declare class FgError extends Error {
+    code: string;
+    details?: Record<string, unknown>;
+    constructor(code: string, message: string, details?: Record<string, unknown>);
+}
+
+interface ShareEntry {
+    version: string;
+    get: () => Promise<any>;
+    from: string;
+    eager: boolean;
+    loaded?: boolean;
+}
+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>;
+}
+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>;
+    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>;
+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;
+};
+declare const shareScopeMap: ShareScopeMap;
+/** default 导出 interop：ESM 取 .default；CJS 命名空间回退整体 */
+declare function unwrapDefault(ns: any): any;
+
+/**
+ * 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>;
+}
+
+/**
+ * React 适配层：remoteComponent() / useLoadRemote() / RemoteErrorBoundary /
+ * createReactHostPages()。只接收加载函数，不静态引用运行时内核（同 vue-adapter 形态，
+ * dist/react.js 由构建脚本绑定 loadRemote 后再导出）。
+ *
+ * 语义要点（README React 章节的实现依据）：
+ * - remoteComponent：工厂与页面表声明零加载副作用；首次渲染才 loadRemote；
+ *   加载状态机自带 pending/error/ready 三态，不用 React.lazy——lazy 的失败 Promise
+ *   会缓存在实例上，仅重置错误边界无法恢复，必须重建加载尝试。retry 以受控 attempt
+ *   计数触发（不在普通 render 中重建加载器，组件本地状态不因重渲染反复重置）。
+ * - timeout 是本次组件加载等待上限（适配层实现），不取消 loadRemote 的共享请求，
+ *   不修改远程入口配置超时；迟到的成功/失败一律丢弃，不产生未处理 rejection。
+ *   retry 对已成功缓存的模块不重新下载（运行时缓存），只重走生命周期（onSession 按代次去重）。
+ * - 渲染期异常由内置 RemoteRenderBoundary 捕获，与网络/导出错误分开记录与展示；
+ *   ErrorBoundary 不捕获事件处理器与任意异步回调（React 边界语义，README 已声明）。
+ * - 代码全部 createElement（无 JSX）：适配器自身不依赖 jsx-runtime，减少共享子路径面。
+ */
+
+type LoadRemoteFn = (spec: string, opts?: LoadRemoteOptions) => Promise<any>;
+/** 渲染函数形态的错误占位：(error, retry) => ReactNode；与 remoteComponent.error 一致 */
+type RemoteErrorFallback = (error: unknown, retry: () => void) => ReactNode;
+interface ReactRemoteComponentOptions {
+    /** 本次加载 pending 时的占位（区别于失败占位）；默认 null */
+    fallback?: ReactNode;
+    /** 加载失败或子树渲染错误的展示；默认内置中文占位（错误码+根因+修法+重试） */
+    error?: ReactNode | RemoteErrorFallback;
+    /** 透传现行 loadRemote 的重试选项（0-10 整数），不另叠自动重试 */
+    retries?: number;
+    /** 本次组件加载等待上限 ms；不提供则沿用 loadRemote 自身超时。不取消已发出的共享请求 */
+    timeout?: number;
+}
+interface RemoteErrorBoundaryProps {
+    children?: ReactNode;
+    /** 错误占位：节点或 ({ error, reset }) 渲染函数；默认内置中文占位 */
+    fallback?: ReactNode | ((args: {
+        error: unknown;
+        reset: () => void;
+    }) => ReactNode);
+    /** 渲染异常回调（error + React componentStack 信息） */
+    onError?: (error: unknown, info: ErrorInfo) => void;
+    /** 任一项变化时重置边界状态（受控重试的常用形态：传 [retryEpoch]） */
+    resetKeys?: readonly unknown[];
+}
+interface BoundaryState {
+    error: unknown | null;
+}
+/**
+ * 页面级错误边界：只捕获传到它的子树渲染错误。remoteComponent 内置边界已处理自身错误，
+ * 外层边界看不到内层已消费的异常。reset 只重置边界状态；子组件若持有失败缓存
+ * （如 React.lazy），还需要由调用方重建加载尝试（remoteComponent 的 retry 已含两者）。
+ */
+declare class RemoteErrorBoundary extends Component<RemoteErrorBoundaryProps, BoundaryState> {
+    state: BoundaryState;
+    static getDerivedStateFromError(error: unknown): BoundaryState;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    componentDidUpdate(prev: RemoteErrorBoundaryProps): void;
+    readonly reset: () => void;
+    render(): ReactNode;
+}
+interface UseLoadRemoteOptions {
+    /** 透传 loadRemote 的 shareScope */
+    shareScope?: string;
+    /** 透传 loadRemote 的重试次数（0-10 整数） */
+    retries?: number;
+    /**
+     * 用户显式配置的失败兜底模块（透传 loadRemote.fallbackModule）：配置后加载失败返回
+     * 兜底值而不写 error。这是显式声明的行为，不是静默成功——README 已说明。
+     */
+    fallbackModule?: () => any;
+}
+interface UseLoadRemoteResult<Module = any> {
+    /** 加载成功后的模块命名空间；未成功时 undefined */
+    data: Module | undefined;
+    /** 失败原因；无错误时恒为 undefined（统一空值） */
+    error: unknown;
+    /** 是否有请求在途 */
+    loading: boolean;
+    /** 重新走一次加载生命周期；已成功的模块经运行时缓存不会重新下载。Promise<void> 正常结束（不抛） */
+    reload: () => Promise<void>;
+}
+interface ReactHostPagesOptions extends HostPagesCoreOptions {
+    /** 每次页面模块实际加载尝试前执行（同步或异步）；宿主在此提供最新 context */
+    beforeLoad?: () => void | Promise<void>;
+    /** 页面加载 pending 占位（同 remoteComponent.fallback） */
+    fallback?: ReactNode;
+    /** 页面加载/渲染错误占位（同 remoteComponent.error） */
+    error?: ReactNode | RemoteErrorFallback;
+    /** 透传 loadRemote 重试（0-10 整数） */
+    retries?: number;
+    /** 单次页面组件加载等待上限 ms（同 remoteComponent.timeout） */
+    timeout?: number;
+}
+interface ReactHostPages {
+    /** 原页面记录 */
+    pages: PageRouteLike[];
+    /** 路径 → 页面解析（base 前缀、最长前缀、参数解码、R1–R5 语义与 Vue 完全一致） */
+    resolve(path: string): ResolvedHostPage | null;
+    /** 按 spec 取页面组件（同 spec 同登录代次复用；新非空 sessionKey 到来时重建以触发 onSession） */
+    component<P = Record<string, unknown>>(spec: string): ComponentType<P>;
+}
+declare function createReactHostPages$1(options: ReactHostPagesOptions, loadRemote: LoadRemoteFn): ReactHostPages;
+
+/**
+ * 跨应用上下文标准字段表（§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;
+
+declare const remoteComponent: <P = Record<string, unknown>>(spec: string, opts?: ReactRemoteComponentOptions) => react.ComponentType<P & {
+    ref?: react.Ref<unknown>;
+}>;
+declare const useLoadRemote: <Module = any>(spec: string, opts?: UseLoadRemoteOptions) => UseLoadRemoteResult<Module>;
+/** 宿主页面适配器（绑定本包运行时的 loadRemote；选项与返回值类型见 react-adapter） */
+declare function createReactHostPages(options: Parameters<typeof createReactHostPages$1>[0]): ReactHostPages;
+
+type RemoteSchema = Record<string, RemoteSchemaEntry>;
+/** 无插件转换的场景（构建、Node 导入）如实返回空清单。 */
+declare const remoteSchema: RemoteSchema;
+
+export { type AppContext, type FgRuntime, type LoadRemoteOptions, type LoadShareOptions, type PageRouteLike, type PageViolation, type PagesOptions, type PreloadRemoteOptions, type ReactHostPages, type ReactHostPagesOptions, type ReactRemoteComponentOptions, type RemoteConfig, type RemoteDebugInfo, RemoteErrorBoundary, type RemoteErrorBoundaryProps, type RemoteErrorFallback, type RemoteInput, type RemoteSchema, type RemoteSchemaEntry, type RemoteSetupContext, type RemoteSetupModule, type ResolvedHostPage, type RuntimeHooks, type RuntimePlugin, type ShareEntry, type ShareScope, type ShareScopeMap, type UseLoadRemoteOptions, type UseLoadRemoteResult, clearAppContext, createReactHostPages, definePages, getAppContext, getContainer, getRuntime, initSharing, loadRemote, loadShare, parseSpec, preloadRemote, provideAppContext, registerPlugins, registerRemote, registerRemotes, registerShare, remoteComponent, remoteSchema, requireAppContext, shareScopeMap, unwrapDefault, useLoadRemote, validatePages, version };

package/dist/react.js

@@ -0,0 +1,10 @@
+export { initSharing, registerShare, registerRemotes, registerRemote, registerPlugins, loadShare, loadRemote, getContainer, preloadRemote, parseSpec, getRuntime, shareScopeMap, unwrapDefault, version } from "./runtime.js";
+export { provideAppContext, getAppContext, requireAppContext, clearAppContext } from "./context.js";
+export { definePages, validatePages } from "./pages.js";
+import { loadRemote } from "./runtime.js";
+import { createRemoteComponent, createUseLoadRemote, RemoteErrorBoundary, createReactHostPages as createReactHostPagesWithLoader } from "./react-adapter.js";
+export const remoteComponent = createRemoteComponent(loadRemote);
+export const useLoadRemote = createUseLoadRemote(loadRemote);
+export { RemoteErrorBoundary };
+export const createReactHostPages = (options) => createReactHostPagesWithLoader(options, loadRemote);
+export const remoteSchema = {};

package/dist/runtime-entry.d.ts

@@ -292,16 +292,16 @@ declare function validatePages(pages: PageRouteLike[], options?: PagesOptions):
  */
 declare function definePages<P extends PageRouteLike[]>(pages: P, options?: PagesOptions): P;
 
-/** Vue 适配层只接收加载函数，不静态引用运行时内核。 */
+/**
+ * 宿主页面表纯解析核心（框架无关）。
+ *
+ * 5.1.0 从 vue-adapter 提取：definePages 校验接入、最长前缀远程归属、缺省 spec 推导、
+ * base 剥离、段式参数匹配——Vue 与 React 适配器共用同一份解析，组件缓存/错误边界/
+ * 保活策略由各框架适配器自行负责（不把 Vue 的卸载策略强加给 React，反之亦然）。
+ */
 
-interface RemoteComponentOptions {
-    loadingComponent?: Component;
-    errorComponent?: Component;
-    retries?: number;
-    delay?: number;
-    timeout?: number;
-}
-interface HostPagesOptions {
+/** 页面表数据项（两个框架适配器共用；展示项 fallback/error 等在各适配器定义） */
+interface HostPagesCoreOptions {
     /** 页面表（宿主路由与布局共用的唯一数据源；definePages R1–R5 校验照常执行） */
     pages: PageRouteLike[];
     /** 路由前缀 → remote 名（最长前缀匹配；页面路由无匹配前缀时创建期即报错） */
@@ -314,14 +314,6 @@ interface HostPagesOptions {
     strict?: boolean;
     /** 站点 base 前缀（如 '/main'）：resolve 时先剥离再匹配路由空间 */
     base?: string;
-    /** 每次页面模块实际加载前执行（同步或异步）；宿主在此提供最新 context */
-    beforeLoad?: () => void | Promise<void>;
-    /** 加载期占位组件（骨架屏） */
-    loadingComponent?: Component;
-    /** 错误占位组件（缺省 = 内置三段式错误占位：错误码+根因+修法） */
-    errorComponent?: Component;
-    /** 骨架屏延迟 ms（默认 200，防闪） */
-    delay?: number;
 }
 interface ResolvedHostPage {
     /** 原页面记录（含宿主自由扩展字段 name/title/keepAlive/...） */
@@ -333,6 +325,26 @@ interface ResolvedHostPage {
     /** 路径参数（解码失败只让该次匹配失败，不让页面初始化崩溃） */
     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[];