@epxing/core 5.3.0-beta.2 → 5.3.0-beta.4

package/API.md

@@ -1,559 +1,560 @@
-# @epxing/core API
-
-Vue 3 应用启动、公共混入、实体请求、元数据、状态、路由和运行时服务。
-
-本页对应包版本 `5.3.0-beta.2`。导出名、子路径和签名从当前源码、package.json 与类型声明生成。
-
-## 安装与使用
-
-
-```sh
-pnpm add @epxing/core@5.3.0-beta.2
-```
-
-
-```js
-import { createApp } from '@epxing/core'
-import Hr from './hr'
-
-const app = createApp()
-app.use(Hr)
-app.mount('#app')
-
-// 也可覆盖默认服务：createApp({ rootComponent: App, store, router, http: productHttp })
-```
-
-## 接入约定
-
-createApp 返回 Vue App，可继续 app.use / app.component / app.mount。自建 Vue 应用时使用 app.use(EpxCore, { store, router, http })；store 与 router 必须提供。产品 HTTP 客户端需实现页面实际调用的实体协议，方法和参数见 HttpClient 与 EntityRequest 类型。
-
-仅安装 core 会创建核心运行环境；产品插件负责业务路由和页面。需要基础组件、业务选择器、设计器或看板时，另外安装并导入对应包，样式自动加载。getSystemMeta/getSysId/usePlugin 等依赖当前系统上下文，初始化系统后再调用。
-
-本版 JS 入口自动加载本包聚合样式，根导入和稳定子路径均无需手动 import style.css；保留显式样式入口以兼容旧代码。样式按包加载，产品覆盖样式放在框架导入之后。
-
-## 根入口完整导出
-
-| 导出名 | 形态 | 用途 | 参数 / 配置 / 事件 |
-| --- | --- | --- | --- |
-| `installCore` | 函数 | 向现有 Vue 应用安装核心服务，返回 app、store、router、http、fieldFactory 上下文。 | 见下方签名或接入约定 |
-| `ComponentMixin` | 对象 / 常量 | 配置驱动组件的公共混入，提供 $configs、服务访问、查询上下文、刷新和组件通信协议。 | [详细参考](../../docs/revision/core/api/mixins/component.md) |
-| `GlobalMixin` | 对象 / 常量 | 全局公共混入；通常由 core 安装，包含平台公共实例能力。 | [详细参考](../../docs/revision/core/api/mixins/global.md) |
-| `mixins` | 对象 / 常量 | 混入集合：component 与 ComponentMixin 相同，global 与 GlobalMixin 相同。 | [详细参考](../../docs/revision/core/api/mixins/index.md) |
-| `axios` | 对象 / 常量 | 平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。 | [详细参考](../../docs/revision/core/api/axios.md) |
-| `http` | 对象 / 常量 | 平台实体请求客户端，包含 list/find/get/save/update/getCount/getCodes/getTree/apply 与 $get/$post/$request 等方法。 | [详细参考](../../docs/revision/core/api/api/index.md) |
-| `util` | 对象 / 常量 | 平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `getSystemMeta` | 函数 | 按元数据代码取得当前系统对应的元数据标识；依赖已初始化的系统上下文。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `getFileUrl` | 函数 | 按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `getSysId` | 函数 | 读取当前系统标识；未初始化系统时可能返回 undefined。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `toLogin` | 函数 | 按当前客户端跳转登录页，clearPath 控制是否清理路径。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `usePlugin` | 函数 | 异步加载并缓存指定产品插件，返回加载结果。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `runExpByScope` | 函数 | 按范围条件计算数据是否匹配；依赖组件查询上下文时使用 runExpByScope.call(vm, scopeList, data)。 | [详细参考](../../docs/revision/utils/api/util.md) |
-| `FieldFactory` | 对象 / 常量 | 兼容旧用法的字段工厂默认实例；独立上下文优先使用 createFieldFactory。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
-| `FieldFactoryClass` | 类 | 字段工厂类，按元数据生成表单/列表字段；可传入对应应用的 store。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
-| `createFieldFactory` | 函数 | 创建独立字段工厂实例，避免产品之间共享可变字段状态。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
-| `Meta` | 类 | 将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。 | [详细参考](../../docs/revision/utils/api/meta.md) |
-| `PdfViewer` | 类 | 浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。 | [详细参考](../../docs/revision/utils/api/pdf.viewer.md) |
-| `createFrameStore` | 函数 | 创建平台 Vuex store；每次调用产生独立模块状态，可传入 StoreOptions。 | 见下方签名或接入约定 |
-| `createStoreModules` | 函数 | 返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。 | 见下方签名或接入约定 |
-| `storeModules` | 对象 / 常量 | 平台 Vuex 模块模板，供产品手工 createStore({ modules: storeModules }) 使用。 | 见下方签名或接入约定 |
-| `createFrameRouter` | 函数 | 创建包含平台基础路由和守卫的 Vue Router；默认 hash history，可指定 routes/history/beforeEach。 | 见下方签名或接入约定 |
-| `routerConfig` | 对象 / 常量 | 平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。 | 见下方签名或接入约定 |
-| `createEventBus` | 函数 | 创建独立事件总线，支持 on/off/emit 以及兼容的 $on/$off/$once/$emit。 | [详细参考](../../docs/revision/core/api/vue.bus.md) |
-| `getEventBus` | 函数 | 取得当前已安装应用的事件总线；应在 core 安装后调用。 | [详细参考](../../docs/revision/core/api/vue.bus.md) |
-| `getApp` | 函数 | 取得当前运行时登记的 Vue 应用，尚未登记时返回 null。 | [详细参考](../../docs/revision/core/api/app.md) |
-| `setApp` | 函数 | 登记当前 Vue 应用；一般由 core 安装流程维护。 | [详细参考](../../docs/revision/core/api/app.md) |
-| `registerComponent` | 函数 | 向当前应用登记组件名和实现，供配置渲染及远程产品解析。 | [详细参考](../../docs/revision/core/api/app.md) |
-| `resolveComponent` | 函数 | 按注册名取得组件实现，找不到时返回 undefined。 | [详细参考](../../docs/revision/core/api/app.md) |
-| `configureRuntime` | 函数 | 配置当前核心运行时的 store、router、HTTP 等依赖；通常由安装流程完成。 | 见下方签名或接入约定 |
-| `registerRouteComponents` | 函数 | 登记平台路由使用的页面组件映射。 | 见下方签名或接入约定 |
-| `nav` | 对象 / 常量 | 导航服务对象，提供平台菜单/页面打开与路由激活方法。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-| `publishCoreRuntime` | 函数 | 将当前 core、utils、Vue、Vuex 命名空间交给远程产品共享注册表；安装 core 时自动调用。 | 见下方签名或接入约定 |
-| `createCore` | 函数 | 预置安装选项，返回可交给 app.use 的 core 插件；安装时传入的选项覆盖预置值。 | 见下方签名或接入约定 |
-| `createApp` | 函数 | 创建已安装 core 的 Vue 3 应用。默认提供独立 store、hash router 和平台 HTTP；产品可覆盖服务并通过 app.use 安装业务插件。 | 见下方签名或接入约定 |
-| `default` | 默认导出 | EpxCore 插件对象，同时提供 createApp/createCore/installCore 和公开工具成员。 | 见下方签名或接入约定 |
-
-## 函数、类与工具对象
-
-签名中的 any 表示现有声明未进一步限定结构；源代码方法签名保留默认参数。异步结果与泛型以声明为准。
-
-### installCore
-
-向现有 Vue 应用安装核心服务，返回 app、store、router、http、fieldFactory 上下文。
-
-```ts
-installCore(app: App<any>, options: CoreOptions): CoreContext
-```
-
-### axios
-
-平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。
-
-```ts
-axios<T = any, R = AxiosResponse<T, any, {}>, D = any>(config: AxiosRequestConfig<D>): Promise<R>
-axios<T = any, R = AxiosResponse<T, any, {}>, D = any>(url: string, config?: AxiosRequestConfig<D>): Promise<R>
-```
-
-[详细参考](../../docs/revision/core/api/axios.md)，包括参数、返回值与运行约束。
-
-### util
-
-平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。
-
-| 方法 | 说明 |
-| --- | --- |
-| `getSysId()` | 返回当前工具保存的系统标识。 |
-| `setSysId(sysId)` | 更新工具维护的系统标识。 |
-| `getPublicPath()` | 读取平台静态资源公开基路径。 |
-| `getStaticJsDir()` | 返回按需脚本目录，优先采用运行时 STATIC_JS_DIR 配置。 |
-| `getRootPath()` | 读取当前应用部署的根路径。 |
-| `getRoutePath()` | 根据路由环境读取有效应用路径。 |
-| `getClientCode()` | 从当前路由/配置读取客户端代码。 |
-| `setToken(v, routeClientCode)` | 实现见本节的详细参考。 |
-| `getToken(routeClientCode)` | 实现见本节的详细参考。 |
-| `removeToken(routeClientCode)` | 实现见本节的详细参考。 |
-| `consumeUrlToken(routeClientCode)` | 实现见本节的详细参考。 |
-| `search(name, path)` | 从指定地址或当前 location 中解析 URL 查询参数；这里不是实体列表的 search(scopeParams)。 |
-| `getCurrentLanguage(routeClientCode)` | 按客户端配置与本地偏好取得当前语言。 |
-| `setCurrentLanguage(language)` | 保存当前客户端语言选择。 |
-| `isChineseLanguage(language = this.getCurrentLanguage())` | 判断传入或当前语言是否为中文。 |
-| `toPx(v)` | 将尺寸值转换为像素样式表达式。 |
-| `toLogin(clearPath)` | 按当前客户端跳转登录页，clearPath 控制是否清理路径。 |
-| `urlToBase64(url)` | 在浏览器中获取资源并转换为 Base64/Data URL，仍受跨域和资源权限约束。 |
-| `getFileUrl(id, client, flag = true, useSignOrigin = false)` | 按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。 |
-| `getOfficeFileUrl(id, client, flag = true, useSignOrigin = false)` | 实现见本节的详细参考。 |
-| `getOfficeServerUrl()` | 读取 ONLYOFFICE Document Server 的运行时地址。 |
-| `getAbsPath(path, params = {})` | 结合部署环境和参数生成绝对访问地址。 |
-| `getPlatformRequestUrl(params = {})` | 生成平台项目的请求 URL，与当前产品系统接口地址区分。 |
-| `getRequestUrl(params = {}, { requestKey = 'api' } = {})` | 实现见本节的详细参考。 |
-| `getSystemMeta(metaCode)` | 获取当前系统对应的元数据信息。 |
-| `isWeiXin()` | 检测当前环境是否为微信内置浏览器。 |
-| `isFeishu()` | 检测当前环境是否为飞书客户端。 |
-| `isDingTalk()` | 检测当前环境是否为钉钉客户端。 |
-| `isIos()` | 检测当前环境是否为 iOS。 |
-| `canPreviewPdfInline()` | 判断当前客户端是否适合内嵌 PDF 预览。 |
-| `printHtml(html)` | 创建/组织 HTML 内容的打印流程。 |
-| `printWindow(win)` | 对指定窗口发起打印。 |
-| `pdfDocToImages(pdfDoc, scale = 3)` | 将已加载的 PDF 文档逐页转换为图片，scale 决定渲染分辨率。 |
-| `getBrowserVersion()` | 读取浏览器类型或版本信息用于兼容判断。 |
-| `runExp(exp, point)` | 按指定数据上下文执行配置表达式。 |
-| `runExpByScope(scopeList, data = {})` | 根据范围条件集合判断当前数据是否满足条件。 |
-| `awaitWrap(promise)` | 实现见本节的详细参考。 |
-| `isLoadLibrary(systemCode)` | 检查指定系统远程库的加载记录。 |
-| `loadJS(options)` | 实现见本节的详细参考。 |
-| `loadJs(file, cb)` | 实现见本节的详细参考。 |
-| `loadCss(options)` | 实现见本节的详细参考。 |
-| `dataURLtoBlob(dataurl)` | 将 Data URL 转成 Blob，保留对应 MIME 信息。 |
-| `dataURLtoFile(dataurl, filename)` | 将 Data URL 转成指定文件名的 File。 |
-| `usePlugin(plugin)` | 异步加载并缓存指定产品插件，返回加载结果。 |
-| `utf8to16(str)` | 对字符串执行历史编码转换。 |
-| `genId(length = 3)` | 实现见本节的详细参考。 |
-| `uuid()` | 实现见本节的详细参考。 |
-| `copyToClipboard(text, callback)` | 复制文本到剪贴板并按调用约定回调。 |
-| `getQueryValue(path, obj)` | 实现见本节的详细参考。 |
-| `getValueByPath(path, obj)` | 实现见本节的详细参考。 |
-| `formatAfterTriggerParams(afterTriggerParams, { res, data } = {}, ctx = {})` | 将操作按钮的后续事件参数与响应、数据及上下文合成。 |
-| `evalExpression(el, data, errorValue = false)` | 按数据上下文求值配置表达式，并按 errorValue 处理异常。 |
-| `openWindow(url)` | 按当前客户端环境打开访问地址。 |
-| `encrypt(content, key, { type } = {})` | 按 type/key 选择现有加密实现，异步库加载及服务端算法必须配套。 |
-| `decrypt(content, { type, key })` | 按 type/key 解密已有内容，不能替代认证与授权。 |
-| `appendCss(id, css)` | 实现见本节的详细参考。 |
-| `removeCss(id)` | 实现见本节的详细参考。 |
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### getSystemMeta
-
-按元数据代码取得当前系统对应的元数据标识；依赖已初始化的系统上下文。
-
-```ts
-getSystemMeta(metaCode: string): string
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### getFileUrl
-
-按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。
-
-```ts
-getFileUrl(id?: string, client?: string | FileUrlOptions, flag?: boolean, useSignOrigin?: boolean): string
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### getSysId
-
-读取当前系统标识；未初始化系统时可能返回 undefined。
-
-```ts
-getSysId(): string
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### toLogin
-
-按当前客户端跳转登录页，clearPath 控制是否清理路径。
-
-```ts
-toLogin(clearPath?: boolean): void
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### usePlugin
-
-异步加载并缓存指定产品插件，返回加载结果。
-
-```ts
-usePlugin<T = any>(plugin: string): Promise<T>
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### runExpByScope
-
-按范围条件计算数据是否匹配；依赖组件查询上下文时使用 runExpByScope.call(vm, scopeList, data)。
-
-```ts
-runExpByScope(this: void | Record<string, any>, scopeList: ScopeCondition[], data?: Record<string, any>): boolean
-```
-
-[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
-
-### FieldFactoryClass
-
-字段工厂类，按元数据生成表单/列表字段；可传入对应应用的 store。
-
-```js
-new FieldFactoryClass(store = runtimeStore)
-```
-
-| 方法 | 说明 |
-| --- | --- |
-| `createFields({ fields, fieldScope, meta, pageType = 'DETAIL', metaId = '', metaViewId, hiddenFields = [], defaultFieldConfigs = {}, type = 'list' })` | 创建字段配置 |
-| `createFieldConfig({ fieldFromMeta, fieldConfig, fieldName })` | 实现见本节的详细参考。 |
-| `setList(dataType, codeKey, { optionType })` | 实现见本节的详细参考。 |
-
-[详细参考](../../docs/revision/utils/api/fieldFactory.md)，包括参数、返回值与运行约束。
-
-### createFieldFactory
-
-创建独立字段工厂实例，避免产品之间共享可变字段状态。
-
-```ts
-createFieldFactory(store?: Store<any>): FieldFactoryClass
-```
-
-[详细参考](../../docs/revision/utils/api/fieldFactory.md)，包括参数、返回值与运行约束。
-
-### Meta
-
-将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。
-
-```js
-new Meta(props = {})
-```
-
-| 方法 | 说明 |
-| --- | --- |
-| `getId()` | 返回元数据 ID。 |
-| `getCode()` | 返回元数据代码。 |
-| `getName()` | 返回元数据名称。 |
-| `getLabel()` | 返回元数据标签字段。 |
-| `getSystemId()` | 返回所属系统 ID。 |
-| `getSystemCode()` | 返回所属系统代码。 |
-| `getServerCode()` | 返回对应服务代码。 |
-| `getKeyType()` | 返回主键类型。 |
-| `getAttributes()` | 返回对象属性集合。 |
-| `getAttriIds()` | 取得属性 ID 集合。 |
-| `getAttriNames()` | 取得属性名称集合。 |
-| `getKeyNames()` | 实现见本节的详细参考。 |
-| `getRelatedEntitys()` | 返回关联实体集合。 |
-| `getModel()` | 实现见本节的详细参考。 |
-| `getAttribute(field)` | 按字段名查找元属性。 |
-| `getAllFields()` | 返回全部字段名。 |
-| `getListFields()` | 返回列表默认字段。 |
-| `getFormFields()` | 返回表单默认字段。 |
-| `getAllFieldConfigs()` | 返回全部字段的默认配置。 |
-| `getIndex(orderNum, fields)` | 实现见本节的详细参考。 |
-| `getExportFields()` | 返回导出所使用的字段配置。 |
-| `getKey()` | 返回主键字段名称。 |
-| `getKeyAttribute()` | 返回主键字段的元属性。 |
-| `getBusiKeyAttrs()` | 返回业务键属性。 |
-| `getAttris()` | 获取所有属性 |
-| `getIdLabelAttris()` | ID对应LAVEL |
-| `getNameLabelAttris()` | NAME对应LAVEL |
-| `getAttriNameById(attriId)` | 根据字段ID获取字段Name |
-| `getLabelByField(field)` | 取得指定字段对应的显示标签。 |
-| `getDataType(field)` | 取得指定字段的数据类型。 |
-| `getRelationByMetaId(relatedMetaId)` | 按关联元数据查找关系。 |
-| `getRelationIdByMetaId(linkLabel)` | 实现见本节的详细参考。 |
-| `getRelations()` | 返回关系集合。 |
-| `getRelatedEntitysOfEdit()` | 返回编辑场景可用的关联实体。 |
-| `getRelatedEntitysOfDetail()` | 返回详情场景关联实体。 |
-| `getRelationByFlag(flag)` | 按关系标识查找关联配置。 |
-| `getLinkAttrs()` | 返回关系连接属性。 |
-| `getLinkAttr(key)` | 按键查找连接属性。 |
-
-[详细参考](../../docs/revision/utils/api/meta.md)，包括参数、返回值与运行约束。
-
-### PdfViewer
-
-浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。
-
-```js
-new PdfViewer()
-```
-
-| 方法 | 说明 |
-| --- | --- |
-| `destroy()` | 页面 div 是 append 进容器的，实例不销毁就会跟下一份预览叠在一起；；scroll 监听和 ResizeObserver 也得一并摘掉，否则每预览一次多留一份。 |
-| `searchTextInPDF(searchText)` | 实现见本节的详细参考。 |
-| `calculateTextBoundingBox(textItem, startIndex, endIndex, viewport, currentScale)` | 实现见本节的详细参考。 |
-| `highlightText(pageNum, x, y, width, height)` | 实现见本节的详细参考。 |
-| `clearHighlights()` | 实现见本节的详细参考。 |
-| `scrollToPage({ pageNum, x, y, width, height })` | 实现见本节的详细参考。 |
-| `loadPdf()` | 实现见本节的详细参考。 |
-| `run(config)` | 实现见本节的详细参考。 |
-| `load(pdfDocument)` | 实现见本节的详细参考。 |
-| `createPageView({ container, id })` | 实现见本节的详细参考。 |
-| `resetPageStyle()` | 实现见本节的详细参考。 |
-| `updatePageView()` | 实现见本节的详细参考。 |
-| `scrollUpdate()` | 实现见本节的详细参考。 |
-| `getVisiblePages()` | 实现见本节的详细参考。 |
-| `resizeVisiblePages(newCacheSize)` | 实现见本节的详细参考。 |
-| `destroyPageView({ id })` | 实现见本节的详细参考。 |
-| `renderPageView(visible, cb)` | 实现见本节的详细参考。 |
-| `drawerCanvas(num)` | 实现见本节的详细参考。 |
-| `scaleChanged(scale)` | 实现见本节的详细参考。 |
-| `rotateChanged(delta)` | 实现见本节的详细参考。 |
-| `print()` | 实现见本节的详细参考。 |
-
-[详细参考](../../docs/revision/utils/api/pdf.viewer.md)，包括参数、返回值与运行约束。
-
-### createFrameStore
-
-创建平台 Vuex store；每次调用产生独立模块状态，可传入 StoreOptions。
-
-```ts
-createFrameStore(options?: StoreOptions<any>): Store<any>
-```
-
-### createStoreModules
-
-返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。
-
-```ts
-createStoreModules(overrides?: ModuleTree<any>): ModuleTree<any>
-```
-
-### createFrameRouter
-
-创建包含平台基础路由和守卫的 Vue Router；默认 hash history，可指定 routes/history/beforeEach。
-
-```ts
-createFrameRouter(options?: FrameRouterOptions): Router
-```
-
-### routerConfig
-
-平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。
-
-| 方法 | 说明 |
-| --- | --- |
-| `beforeEach(to, from, next)` | 实现见对应源码。 |
-
-### createEventBus
-
-创建独立事件总线，支持 on/off/emit 以及兼容的 $on/$off/$once/$emit。
-
-```ts
-createEventBus(): EventBus
-```
-
-[详细参考](../../docs/revision/core/api/vue.bus.md)，包括参数、返回值与运行约束。
-
-### getEventBus
-
-取得当前已安装应用的事件总线；应在 core 安装后调用。
-
-```ts
-getEventBus(): EventBus
-```
-
-[详细参考](../../docs/revision/core/api/vue.bus.md)，包括参数、返回值与运行约束。
-
-### getApp
-
-取得当前运行时登记的 Vue 应用，尚未登记时返回 null。
-
-```ts
-getApp(): App<any>
-```
-
-[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
-
-### setApp
-
-登记当前 Vue 应用；一般由 core 安装流程维护。
-
-```ts
-setApp(app: App<any>): void
-```
-
-[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
-
-### registerComponent
-
-向当前应用登记组件名和实现，供配置渲染及远程产品解析。
-
-```ts
-registerComponent(name: string, component: Component): void
-```
-
-[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
-
-### resolveComponent
-
-按注册名取得组件实现，找不到时返回 undefined。
-
-```ts
-resolveComponent(name: string): Component
-```
-
-[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
-
-### configureRuntime
-
-配置当前核心运行时的 store、router、HTTP 等依赖；通常由安装流程完成。
-
-```ts
-configureRuntime(options?: Partial<CoreOptions>): void
-```
-
-### registerRouteComponents
-
-登记平台路由使用的页面组件映射。
-
-```ts
-registerRouteComponents(components: Record<string, Component>): void
-```
-
-### nav
-
-导航服务对象，提供平台菜单/页面打开与路由激活方法。
-
-| 方法 | 说明 |
-| --- | --- |
-| `toMenu(keyOrId, { replace = false, query } = {})` | 跳到某菜单（key=编号或 ID）。等同用户点击菜单，URL 一并更新 |
-| `menuUrl(keyOrId, query)` | 生成某菜单的可分享 URL（含 /m/:key，不含 role——打开者用自己的角色） |
-| `currentMenuKey()` | 当前 URL 上的菜单键（无则 ''） |
-| `getMenuKey(menu)` | 读取菜单 MODULE_CODE，缺少代码时回退到 ID。 |
-| `findMenuByKey(menus = [], key)` | 递归查找菜单，优先精确匹配 MODULE_CODE，再匹配 ID。 |
-
-[详细参考](../../docs/revision/core/api/navigation.md)，包括参数、返回值与运行约束。
-
-### publishCoreRuntime
-
-将当前 core、utils、Vue、Vuex 命名空间交给远程产品共享注册表；安装 core 时自动调用。
-
-```ts
-publishCoreRuntime(): void
-```
-
-### createCore
-
-预置安装选项，返回可交给 app.use 的 core 插件；安装时传入的选项覆盖预置值。
-
-```ts
-createCore(options?: Partial<CoreOptions>): Plugin
-```
-
-### createApp
-
-创建已安装 core 的 Vue 3 应用。默认提供独立 store、hash router 和平台 HTTP；产品可覆盖服务并通过 app.use 安装业务插件。
-
-```ts
-createApp(options?: CreateAppOptions): App<any>
-```
-
-## 稳定子路径
-
-下表按实际 package.json 的公开入口列出。default 使用默认导入，其他名称使用具名导入；类型接口用 import type。
-
-| 导入路径 | 完整导出名 | 用途 / 详细说明 |
-| --- | --- | --- |
-| `@epxing/core/app` | `setApp`、`getApp`、`resolveComponent`、`registerComponent`、`useVuePlugin`、`default` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 [详细参考](../../docs/revision/core/api/app.md) |
-| `@epxing/core/http` | `default` | 平台实体请求客户端，包含 list/find/get/save/update/getCount/getCodes/getTree/apply 与 $get/$post/$request 等方法。 [详细参考](../../docs/revision/core/api/api/index.md) |
-| `@epxing/core/axios` | `default` | 平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。 [详细参考](../../docs/revision/core/api/axios.md) |
-| `@epxing/core/navigation` | `getMenuKey`、`findMenuByKey`、`findMenuPath`、`roleStorage`、`resolveRouteRole`、`MENU_ROUTE_ALIAS`、`effectiveRouteName`、`menuLocation`、`activateMenu`、`syncMenuUrl`、`clearMenuUrl`、`activateFromRoute`、`activateHome`、`nav`、`default`、`MenuRecord`（类型）、`MenuActivationOptions`（类型） | 导航服务对象，提供平台菜单/页面打开与路由激活方法。 [详细参考](../../docs/revision/core/api/navigation.md) |
-| `@epxing/core/component-mixin` | `default` | 配置驱动组件的公共混入，提供 $configs、服务访问、查询上下文、刷新和组件通信协议。 [详细参考](../../docs/revision/core/api/mixins/component.md) |
-| `@epxing/core/global-mixin` | `default` | 全局公共混入；通常由 core 安装，包含平台公共实例能力。 [详细参考](../../docs/revision/core/api/mixins/global.md) |
-| `@epxing/core/field-factory` | `FieldFactory`、`createFieldFactory`、`default` | 兼容旧用法的字段工厂默认实例；独立上下文优先使用 createFieldFactory。 [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
-| `@epxing/core/meta` | `default` | 将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。 [详细参考](../../docs/revision/utils/api/meta.md) |
-| `@epxing/core/pdf-viewer` | `default` | 浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。 [详细参考](../../docs/revision/utils/api/pdf.viewer.md) |
-| `@epxing/core/util` | `getSystemMeta`、`getFileUrl`、`getSysId`、`toLogin`、`usePlugin`、`runExpByScope`、`default` | 平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。 [详细参考](../../docs/revision/utils/api/util.md) |
-| `@epxing/core/store` | `createStoreModules`、`storeModules`、`createFrameStore` | 返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。 |
-| `@epxing/core/runtime` | `getConfiguredRuntimeService`、`configureRuntime`、`getRuntimeService`、`runtimeStore`、`runtimeRouter`、`registerRouteComponents`、`runtimeRouteComponent`、`loadBusinessComponents`、`RuntimeServices`（类型）、`BusinessComponentRegistry`（类型） | 对应 `runtime` 模块。 |
-| `@epxing/core/mixins` | `default`、`global`、`component` | 混入集合：component 与 ComponentMixin 相同，global 与 GlobalMixin 相同。 [详细参考](../../docs/revision/core/api/mixins/index.md) |
-| `@epxing/core/router` | `routerConfig`、`createFrameRouter`、`default`、`FrameRouterOptions`（类型） | 平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。 |
-| `@epxing/core/event-bus` | `createEventBus`、`getEventBus`、`default`、`EventBus`（类型）、`EventListener`（类型） | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 [详细参考](../../docs/revision/core/api/vue.bus.md) |
-| `@epxing/core/style.css` | 可选的显式样式入口 | JS 入口自动加载本包样式；保留此路径以兼容旧代码。 |
-
-## 子路径补充导出
-
-本节列出仅在稳定子路径中提供的具名 API；从本节标题对应路径导入。
-
-### @epxing/core/app
-
-| 导出 / 调用签名 | 用途 | 详细接口 |
-| --- | --- | --- |
-| `useVuePlugin(plugin: Plugin & { runtime?: string; }, options?: any): void \| App<any> \| Promise<void>` | 向当前应用安装远程插件；runtime: vue3 使用原生 app.use，旧插件按兼容开关加载垫片。 | [详细参考](../../docs/revision/core/api/app.md) |
-
-### @epxing/core/navigation
-
-| 导出 / 调用签名 | 用途 | 详细接口 |
-| --- | --- | --- |
-| `getMenuKey(menu?: MenuRecord): string` | 读取菜单 MODULE_CODE，缺少代码时回退到 ID。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `findMenuByKey(menus: MenuRecord[], key: string): MenuRecord` | 递归查找菜单，优先精确匹配 MODULE_CODE，再匹配 ID。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `findMenuPath(menus: MenuRecord[], key: string): MenuRecord[]` | 返回从根到目标菜单的路径，包含目标菜单；不存在时返回空数组。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `roleStorage` | 按客户和系统维度读写当前角色，包含 key/get/set 方法及响应式缓存。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `resolveRouteRole(route?: Pick<RouteLocationNormalizedGeneric, "params">): string \| string[]` | 读取路由角色，URL 优先，缺少时回退到角色存储。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `MENU_ROUTE_ALIAS` | 直达菜单路由到基础路由的别名映射：appMenu → app1，hallMenu → hall。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `effectiveRouteName(name?: string \| symbol): string \| symbol` | 将直达菜单路由名归一为对应基础路由名。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `menuLocation(route: RouteLocationNormalizedGeneric, key: string, query?: LocationQueryRaw): string \| RouteLocationAsRelativeGeneric \| RouteLocationAsPathGeneric` | 根据当前路由、菜单键和查询参数生成菜单直达位置。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
-| `activateMenu(menuId: string, extraProps?: Record<string, any>, options?: MenuActivationOptions): boolean` | 按菜单 ID 激活页面，可控制同步 URL、替换历史和查询参数。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-| `syncMenuUrl(menu: MenuRecord, options?: { replace?: boolean; query?: LocationQueryRaw; }): void` | 将当前菜单写入 URL；只处理受支持的应用/大厅路由。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-| `clearMenuUrl(options?: { replace?: boolean; }): void` | 移除 URL 中的菜单键并返回基础应用/大厅路由。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-| `activateFromRoute(route: RouteLocationNormalizedGeneric): boolean` | 按 URL 中的 menuKey 激活对应菜单，找不到时返回 false。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-| `activateHome(): boolean` | 激活已存在或暂存的应用首页；没有首页时返回 false。 | [详细参考](../../docs/revision/core/api/navigation.md) |
-
-### @epxing/core/runtime
-
-| 导出 / 调用签名 | 用途 | 详细接口 |
-| --- | --- | --- |
-| `getConfiguredRuntimeService<K extends keyof RuntimeServices>(name: K): RuntimeServices[K]` | 读取显式注入的核心服务；未配置时返回 undefined，不访问 window 回退。 | 见声明及接入约定 |
-| `getRuntimeService<K extends keyof RuntimeServices>(name: K): RuntimeServices[K]` | 读取已注入服务，兼容 window 回退；缺少服务时抛出初始化错误。 | 见声明及接入约定 |
-| `runtimeStore` | 当前运行时 store 的代理，访问成员时解析实际注入的 store。 | 见声明及接入约定 |
-| `runtimeRouter` | 当前运行时 router 的代理，访问成员时解析实际注入的 router。 | 见声明及接入约定 |
-| `runtimeRouteComponent(name: string): () => Promise<Component>` | 按登记名生成异步路由组件加载函数；尚未登记时加载失败。 | 见声明及接入约定 |
-| `loadBusinessComponents(app: App<any>): Promise<BusinessComponentRegistry>` | 调用已配置的业务组件加载器；没有加载器时返回空解析器。 | 见声明及接入约定 |
-
-### @epxing/core/mixins
-
-| 导出 / 调用签名 | 用途 | 详细接口 |
-| --- | --- | --- |
-| `global` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 | [详细参考](../../docs/revision/core/api/mixins/global.md) |
-| `component` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 | [详细参考](../../docs/revision/core/api/mixins/component.md) |
-
-## 导出的 TypeScript 类型
-
-以下名称仅存在于类型系统，用 import type 导入，不作为运行时对象使用。
-
-### CoreOptions
-
-```ts
+# @epxing/core API
+
+Vue 3 应用启动、公共混入、实体请求、元数据、状态、路由和运行时服务。
+
+本页对应包版本 `5.3.0-beta.4`。导出名、子路径和签名从当前源码、package.json 与类型声明生成。
+
+## 安装与使用
+
+
+```sh
+pnpm add @epxing/core@5.3.0-beta.3
+```
+
+
+```js
+import { createApp } from '@epxing/core'
+import Hr from './hr'
+
+const app = createApp()
+app.use(Hr)
+app.mount('#app')
+
+// 也可覆盖默认服务：createApp({ rootComponent: App, store, router, http: productHttp })
+```
+
+## 接入约定
+
+createApp 返回 Vue App，可继续 app.use / app.component / app.mount。自建 Vue 应用时使用 app.use(EpxCore, { store, router, http })；store 与 router 必须提供。产品 HTTP 客户端需实现页面实际调用的实体协议，方法和参数见 HttpClient 与 EntityRequest 类型。
+
+仅安装 core 会创建核心运行环境；产品插件负责业务路由和页面。需要基础组件、业务选择器、设计器或看板时，另外安装并导入对应包，样式自动加载。getSystemMeta/getSysId/usePlugin 等依赖当前系统上下文，初始化系统后再调用。
+
+本版 JS 入口自动加载本包聚合样式，根导入和稳定子路径均无需手动 import style.css；保留显式样式入口以兼容旧代码。样式按包加载，产品覆盖样式放在框架导入之后。
+
+## 根入口完整导出
+
+| 导出名 | 形态 | 用途 | 参数 / 配置 / 事件 |
+| --- | --- | --- | --- |
+| `installCore` | 函数 | 向现有 Vue 应用安装核心服务，返回 app、store、router、http、fieldFactory 上下文。 | 见下方签名或接入约定 |
+| `ComponentMixin` | 对象 / 常量 | 配置驱动组件的公共混入，提供 $configs、服务访问、查询上下文、刷新和组件通信协议。 | [详细参考](../../docs/revision/core/api/mixins/component.md) |
+| `GlobalMixin` | 对象 / 常量 | 全局公共混入；通常由 core 安装，包含平台公共实例能力。 | [详细参考](../../docs/revision/core/api/mixins/global.md) |
+| `mixins` | 对象 / 常量 | 混入集合：component 与 ComponentMixin 相同，global 与 GlobalMixin 相同。 | [详细参考](../../docs/revision/core/api/mixins/index.md) |
+| `axios` | 对象 / 常量 | 平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。 | [详细参考](../../docs/revision/core/api/axios.md) |
+| `http` | 对象 / 常量 | 平台实体请求客户端，包含 list/find/get/save/update/getCount/getCodes/getTree/apply 与 $get/$post/$request 等方法。 | [详细参考](../../docs/revision/core/api/api/index.md) |
+| `util` | 对象 / 常量 | 平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `getSystemMeta` | 函数 | 按元数据代码取得当前系统对应的元数据标识；依赖已初始化的系统上下文。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `getFileUrl` | 函数 | 按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `getSysId` | 函数 | 读取当前系统标识；未初始化系统时可能返回 undefined。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `toLogin` | 函数 | 按当前客户端跳转登录页，clearPath 控制是否清理路径。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `usePlugin` | 函数 | 异步加载并缓存指定产品插件，返回加载结果。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `runExpByScope` | 函数 | 按范围条件计算数据是否匹配；依赖组件查询上下文时使用 runExpByScope.call(vm, scopeList, data)。 | [详细参考](../../docs/revision/utils/api/util.md) |
+| `FieldFactory` | 对象 / 常量 | 兼容旧用法的字段工厂默认实例；独立上下文优先使用 createFieldFactory。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
+| `FieldFactoryClass` | 类 | 字段工厂类，按元数据生成表单/列表字段；可传入对应应用的 store。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
+| `createFieldFactory` | 函数 | 创建独立字段工厂实例，避免产品之间共享可变字段状态。 | [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
+| `Meta` | 类 | 将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。 | [详细参考](../../docs/revision/utils/api/meta.md) |
+| `PdfViewer` | 类 | 浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。 | [详细参考](../../docs/revision/utils/api/pdf.viewer.md) |
+| `createFrameStore` | 函数 | 创建平台 Vuex store；每次调用产生独立模块状态，可传入 StoreOptions。 | 见下方签名或接入约定 |
+| `createStoreModules` | 函数 | 返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。 | 见下方签名或接入约定 |
+| `storeModules` | 对象 / 常量 | 平台 Vuex 模块模板，供产品手工 createStore({ modules: storeModules }) 使用。 | 见下方签名或接入约定 |
+| `createFrameRouter` | 函数 | 创建包含平台基础路由和守卫的 Vue Router；默认 hash history，可指定 routes/history/beforeEach。 | 见下方签名或接入约定 |
+| `routerConfig` | 对象 / 常量 | 平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。 | 见下方签名或接入约定 |
+| `createEventBus` | 函数 | 创建独立事件总线，支持 on/off/emit 以及兼容的 $on/$off/$once/$emit。 | [详细参考](../../docs/revision/core/api/vue.bus.md) |
+| `getEventBus` | 函数 | 取得当前已安装应用的事件总线；应在 core 安装后调用。 | [详细参考](../../docs/revision/core/api/vue.bus.md) |
+| `getApp` | 函数 | 取得当前运行时登记的 Vue 应用，尚未登记时返回 null。 | [详细参考](../../docs/revision/core/api/app.md) |
+| `setApp` | 函数 | 登记当前 Vue 应用；一般由 core 安装流程维护。 | [详细参考](../../docs/revision/core/api/app.md) |
+| `registerComponent` | 函数 | 向当前应用登记组件名和实现，供配置渲染及远程产品解析。 | [详细参考](../../docs/revision/core/api/app.md) |
+| `resolveComponent` | 函数 | 按注册名取得组件实现，找不到时返回 undefined。 | [详细参考](../../docs/revision/core/api/app.md) |
+| `configureRuntime` | 函数 | 配置当前核心运行时的 store、router、HTTP 等依赖；通常由安装流程完成。 | 见下方签名或接入约定 |
+| `registerRouteComponents` | 函数 | 登记平台路由使用的页面组件映射。 | 见下方签名或接入约定 |
+| `routeComponents` | 对象 / 常量 | 基础路由页面映射，包含 App、Module、AppRoleSelect、Error，随 core 自动注册。 | 可由 options.routeComponents 覆盖 |
+| `nav` | 对象 / 常量 | 导航服务对象，提供平台菜单/页面打开与路由激活方法。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+| `publishCoreRuntime` | 函数 | 将当前 core、utils、Vue、Vuex 命名空间交给远程产品共享注册表；安装 core 时自动调用。 | 见下方签名或接入约定 |
+| `createCore` | 函数 | 预置安装选项，返回可交给 app.use 的 core 插件；安装时传入的选项覆盖预置值。 | 见下方签名或接入约定 |
+| `createApp` | 函数 | 创建已安装 core 的 Vue 3 应用。默认提供独立 store、hash router 和平台 HTTP；产品可覆盖服务并通过 app.use 安装业务插件。 | 见下方签名或接入约定 |
+| `default` | 默认导出 | EpxCore 插件对象，同时提供 createApp/createCore/installCore 和公开工具成员。 | 见下方签名或接入约定 |
+
+## 函数、类与工具对象
+
+签名中的 any 表示现有声明未进一步限定结构；源代码方法签名保留默认参数。异步结果与泛型以声明为准。
+
+### installCore
+
+向现有 Vue 应用安装核心服务，返回 app、store、router、http、fieldFactory 上下文。
+
+```ts
+installCore(app: App<any>, options: CoreOptions): CoreContext
+```
+
+### axios
+
+平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。
+
+```ts
+axios<T = any, R = AxiosResponse<T, any, {}>, D = any>(config: AxiosRequestConfig<D>): Promise<R>
+axios<T = any, R = AxiosResponse<T, any, {}>, D = any>(url: string, config?: AxiosRequestConfig<D>): Promise<R>
+```
+
+[详细参考](../../docs/revision/core/api/axios.md)，包括参数、返回值与运行约束。
+
+### util
+
+平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。
+
+| 方法 | 说明 |
+| --- | --- |
+| `getSysId()` | 返回当前工具保存的系统标识。 |
+| `setSysId(sysId)` | 更新工具维护的系统标识。 |
+| `getPublicPath()` | 读取平台静态资源公开基路径。 |
+| `getStaticJsDir()` | 返回按需脚本目录，优先采用运行时 STATIC_JS_DIR 配置。 |
+| `getRootPath()` | 读取当前应用部署的根路径。 |
+| `getRoutePath()` | 根据路由环境读取有效应用路径。 |
+| `getClientCode()` | 从当前路由/配置读取客户端代码。 |
+| `setToken(v, routeClientCode)` | 实现见本节的详细参考。 |
+| `getToken(routeClientCode)` | 实现见本节的详细参考。 |
+| `removeToken(routeClientCode)` | 实现见本节的详细参考。 |
+| `consumeUrlToken(routeClientCode)` | 实现见本节的详细参考。 |
+| `search(name, path)` | 从指定地址或当前 location 中解析 URL 查询参数；这里不是实体列表的 search(scopeParams)。 |
+| `getCurrentLanguage(routeClientCode)` | 按客户端配置与本地偏好取得当前语言。 |
+| `setCurrentLanguage(language)` | 保存当前客户端语言选择。 |
+| `isChineseLanguage(language = this.getCurrentLanguage())` | 判断传入或当前语言是否为中文。 |
+| `toPx(v)` | 将尺寸值转换为像素样式表达式。 |
+| `toLogin(clearPath)` | 按当前客户端跳转登录页，clearPath 控制是否清理路径。 |
+| `urlToBase64(url)` | 在浏览器中获取资源并转换为 Base64/Data URL，仍受跨域和资源权限约束。 |
+| `getFileUrl(id, client, flag = true, useSignOrigin = false)` | 按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。 |
+| `getOfficeFileUrl(id, client, flag = true, useSignOrigin = false)` | 实现见本节的详细参考。 |
+| `getOfficeServerUrl()` | 读取 ONLYOFFICE Document Server 的运行时地址。 |
+| `getAbsPath(path, params = {})` | 结合部署环境和参数生成绝对访问地址。 |
+| `getPlatformRequestUrl(params = {})` | 生成平台项目的请求 URL，与当前产品系统接口地址区分。 |
+| `getRequestUrl(params = {}, { requestKey = 'api' } = {})` | 实现见本节的详细参考。 |
+| `getSystemMeta(metaCode)` | 获取当前系统对应的元数据信息。 |
+| `isWeiXin()` | 检测当前环境是否为微信内置浏览器。 |
+| `isFeishu()` | 检测当前环境是否为飞书客户端。 |
+| `isDingTalk()` | 检测当前环境是否为钉钉客户端。 |
+| `isIos()` | 检测当前环境是否为 iOS。 |
+| `canPreviewPdfInline()` | 判断当前客户端是否适合内嵌 PDF 预览。 |
+| `printHtml(html)` | 创建/组织 HTML 内容的打印流程。 |
+| `printWindow(win)` | 对指定窗口发起打印。 |
+| `pdfDocToImages(pdfDoc, scale = 3)` | 将已加载的 PDF 文档逐页转换为图片，scale 决定渲染分辨率。 |
+| `getBrowserVersion()` | 读取浏览器类型或版本信息用于兼容判断。 |
+| `runExp(exp, point)` | 按指定数据上下文执行配置表达式。 |
+| `runExpByScope(scopeList, data = {})` | 根据范围条件集合判断当前数据是否满足条件。 |
+| `awaitWrap(promise)` | 实现见本节的详细参考。 |
+| `isLoadLibrary(systemCode)` | 检查指定系统远程库的加载记录。 |
+| `loadJS(options)` | 实现见本节的详细参考。 |
+| `loadJs(file, cb)` | 实现见本节的详细参考。 |
+| `loadCss(options)` | 实现见本节的详细参考。 |
+| `dataURLtoBlob(dataurl)` | 将 Data URL 转成 Blob，保留对应 MIME 信息。 |
+| `dataURLtoFile(dataurl, filename)` | 将 Data URL 转成指定文件名的 File。 |
+| `usePlugin(plugin)` | 异步加载并缓存指定产品插件，返回加载结果。 |
+| `utf8to16(str)` | 对字符串执行历史编码转换。 |
+| `genId(length = 3)` | 实现见本节的详细参考。 |
+| `uuid()` | 实现见本节的详细参考。 |
+| `copyToClipboard(text, callback)` | 复制文本到剪贴板并按调用约定回调。 |
+| `getQueryValue(path, obj)` | 实现见本节的详细参考。 |
+| `getValueByPath(path, obj)` | 实现见本节的详细参考。 |
+| `formatAfterTriggerParams(afterTriggerParams, { res, data } = {}, ctx = {})` | 将操作按钮的后续事件参数与响应、数据及上下文合成。 |
+| `evalExpression(el, data, errorValue = false)` | 按数据上下文求值配置表达式，并按 errorValue 处理异常。 |
+| `openWindow(url)` | 按当前客户端环境打开访问地址。 |
+| `encrypt(content, key, { type } = {})` | 按 type/key 选择现有加密实现，异步库加载及服务端算法必须配套。 |
+| `decrypt(content, { type, key })` | 按 type/key 解密已有内容，不能替代认证与授权。 |
+| `appendCss(id, css)` | 实现见本节的详细参考。 |
+| `removeCss(id)` | 实现见本节的详细参考。 |
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### getSystemMeta
+
+按元数据代码取得当前系统对应的元数据标识；依赖已初始化的系统上下文。
+
+```ts
+getSystemMeta(metaCode: string): string
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### getFileUrl
+
+按附件 ID、客户端及签名选项生成访问地址；没有 ID 时返回 undefined。
+
+```ts
+getFileUrl(id?: string, client?: string | FileUrlOptions, flag?: boolean, useSignOrigin?: boolean): string
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### getSysId
+
+读取当前系统标识；未初始化系统时可能返回 undefined。
+
+```ts
+getSysId(): string
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### toLogin
+
+按当前客户端跳转登录页，clearPath 控制是否清理路径。
+
+```ts
+toLogin(clearPath?: boolean): void
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### usePlugin
+
+异步加载并缓存指定产品插件，返回加载结果。
+
+```ts
+usePlugin<T = any>(plugin: string): Promise<T>
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### runExpByScope
+
+按范围条件计算数据是否匹配；依赖组件查询上下文时使用 runExpByScope.call(vm, scopeList, data)。
+
+```ts
+runExpByScope(this: void | Record<string, any>, scopeList: ScopeCondition[], data?: Record<string, any>): boolean
+```
+
+[详细参考](../../docs/revision/utils/api/util.md)，包括参数、返回值与运行约束。
+
+### FieldFactoryClass
+
+字段工厂类，按元数据生成表单/列表字段；可传入对应应用的 store。
+
+```js
+new FieldFactoryClass(store = runtimeStore)
+```
+
+| 方法 | 说明 |
+| --- | --- |
+| `createFields({ fields, fieldScope, meta, pageType = 'DETAIL', metaId = '', metaViewId, hiddenFields = [], defaultFieldConfigs = {}, type = 'list' })` | 创建字段配置 |
+| `createFieldConfig({ fieldFromMeta, fieldConfig, fieldName })` | 实现见本节的详细参考。 |
+| `setList(dataType, codeKey, { optionType })` | 实现见本节的详细参考。 |
+
+[详细参考](../../docs/revision/utils/api/fieldFactory.md)，包括参数、返回值与运行约束。
+
+### createFieldFactory
+
+创建独立字段工厂实例，避免产品之间共享可变字段状态。
+
+```ts
+createFieldFactory(store?: Store<any>): FieldFactoryClass
+```
+
+[详细参考](../../docs/revision/utils/api/fieldFactory.md)，包括参数、返回值与运行约束。
+
+### Meta
+
+将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。
+
+```js
+new Meta(props = {})
+```
+
+| 方法 | 说明 |
+| --- | --- |
+| `getId()` | 返回元数据 ID。 |
+| `getCode()` | 返回元数据代码。 |
+| `getName()` | 返回元数据名称。 |
+| `getLabel()` | 返回元数据标签字段。 |
+| `getSystemId()` | 返回所属系统 ID。 |
+| `getSystemCode()` | 返回所属系统代码。 |
+| `getServerCode()` | 返回对应服务代码。 |
+| `getKeyType()` | 返回主键类型。 |
+| `getAttributes()` | 返回对象属性集合。 |
+| `getAttriIds()` | 取得属性 ID 集合。 |
+| `getAttriNames()` | 取得属性名称集合。 |
+| `getKeyNames()` | 实现见本节的详细参考。 |
+| `getRelatedEntitys()` | 返回关联实体集合。 |
+| `getModel()` | 实现见本节的详细参考。 |
+| `getAttribute(field)` | 按字段名查找元属性。 |
+| `getAllFields()` | 返回全部字段名。 |
+| `getListFields()` | 返回列表默认字段。 |
+| `getFormFields()` | 返回表单默认字段。 |
+| `getAllFieldConfigs()` | 返回全部字段的默认配置。 |
+| `getIndex(orderNum, fields)` | 实现见本节的详细参考。 |
+| `getExportFields()` | 返回导出所使用的字段配置。 |
+| `getKey()` | 返回主键字段名称。 |
+| `getKeyAttribute()` | 返回主键字段的元属性。 |
+| `getBusiKeyAttrs()` | 返回业务键属性。 |
+| `getAttris()` | 获取所有属性 |
+| `getIdLabelAttris()` | ID对应LAVEL |
+| `getNameLabelAttris()` | NAME对应LAVEL |
+| `getAttriNameById(attriId)` | 根据字段ID获取字段Name |
+| `getLabelByField(field)` | 取得指定字段对应的显示标签。 |
+| `getDataType(field)` | 取得指定字段的数据类型。 |
+| `getRelationByMetaId(relatedMetaId)` | 按关联元数据查找关系。 |
+| `getRelationIdByMetaId(linkLabel)` | 实现见本节的详细参考。 |
+| `getRelations()` | 返回关系集合。 |
+| `getRelatedEntitysOfEdit()` | 返回编辑场景可用的关联实体。 |
+| `getRelatedEntitysOfDetail()` | 返回详情场景关联实体。 |
+| `getRelationByFlag(flag)` | 按关系标识查找关联配置。 |
+| `getLinkAttrs()` | 返回关系连接属性。 |
+| `getLinkAttr(key)` | 按键查找连接属性。 |
+
+[详细参考](../../docs/revision/utils/api/meta.md)，包括参数、返回值与运行约束。
+
+### PdfViewer
+
+浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。
+
+```js
+new PdfViewer()
+```
+
+| 方法 | 说明 |
+| --- | --- |
+| `destroy()` | 页面 div 是 append 进容器的，实例不销毁就会跟下一份预览叠在一起；；scroll 监听和 ResizeObserver 也得一并摘掉，否则每预览一次多留一份。 |
+| `searchTextInPDF(searchText)` | 实现见本节的详细参考。 |
+| `calculateTextBoundingBox(textItem, startIndex, endIndex, viewport, currentScale)` | 实现见本节的详细参考。 |
+| `highlightText(pageNum, x, y, width, height)` | 实现见本节的详细参考。 |
+| `clearHighlights()` | 实现见本节的详细参考。 |
+| `scrollToPage({ pageNum, x, y, width, height })` | 实现见本节的详细参考。 |
+| `loadPdf()` | 实现见本节的详细参考。 |
+| `run(config)` | 实现见本节的详细参考。 |
+| `load(pdfDocument)` | 实现见本节的详细参考。 |
+| `createPageView({ container, id })` | 实现见本节的详细参考。 |
+| `resetPageStyle()` | 实现见本节的详细参考。 |
+| `updatePageView()` | 实现见本节的详细参考。 |
+| `scrollUpdate()` | 实现见本节的详细参考。 |
+| `getVisiblePages()` | 实现见本节的详细参考。 |
+| `resizeVisiblePages(newCacheSize)` | 实现见本节的详细参考。 |
+| `destroyPageView({ id })` | 实现见本节的详细参考。 |
+| `renderPageView(visible, cb)` | 实现见本节的详细参考。 |
+| `drawerCanvas(num)` | 实现见本节的详细参考。 |
+| `scaleChanged(scale)` | 实现见本节的详细参考。 |
+| `rotateChanged(delta)` | 实现见本节的详细参考。 |
+| `print()` | 实现见本节的详细参考。 |
+
+[详细参考](../../docs/revision/utils/api/pdf.viewer.md)，包括参数、返回值与运行约束。
+
+### createFrameStore
+
+创建平台 Vuex store；每次调用产生独立模块状态，可传入 StoreOptions。
+
+```ts
+createFrameStore(options?: StoreOptions<any>): Store<any>
+```
+
+### createStoreModules
+
+返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。
+
+```ts
+createStoreModules(overrides?: ModuleTree<any>): ModuleTree<any>
+```
+
+### createFrameRouter
+
+创建包含平台基础路由和守卫的 Vue Router；默认 hash history，可指定 routes/history/beforeEach。
+
+```ts
+createFrameRouter(options?: FrameRouterOptions): Router
+```
+
+### routerConfig
+
+平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。
+
+| 方法 | 说明 |
+| --- | --- |
+| `beforeEach(to, from, next)` | 实现见对应源码。 |
+
+### createEventBus
+
+创建独立事件总线，支持 on/off/emit 以及兼容的 $on/$off/$once/$emit。
+
+```ts
+createEventBus(): EventBus
+```
+
+[详细参考](../../docs/revision/core/api/vue.bus.md)，包括参数、返回值与运行约束。
+
+### getEventBus
+
+取得当前已安装应用的事件总线；应在 core 安装后调用。
+
+```ts
+getEventBus(): EventBus
+```
+
+[详细参考](../../docs/revision/core/api/vue.bus.md)，包括参数、返回值与运行约束。
+
+### getApp
+
+取得当前运行时登记的 Vue 应用，尚未登记时返回 null。
+
+```ts
+getApp(): App<any>
+```
+
+[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
+
+### setApp
+
+登记当前 Vue 应用；一般由 core 安装流程维护。
+
+```ts
+setApp(app: App<any>): void
+```
+
+[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
+
+### registerComponent
+
+向当前应用登记组件名和实现，供配置渲染及远程产品解析。
+
+```ts
+registerComponent(name: string, component: Component): void
+```
+
+[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
+
+### resolveComponent
+
+按注册名取得组件实现，找不到时返回 undefined。
+
+```ts
+resolveComponent(name: string): Component
+```
+
+[详细参考](../../docs/revision/core/api/app.md)，包括参数、返回值与运行约束。
+
+### configureRuntime
+
+配置当前核心运行时的 store、router、HTTP 等依赖；通常由安装流程完成。
+
+```ts
+configureRuntime(options?: Partial<CoreOptions>): void
+```
+
+### registerRouteComponents
+
+登记平台路由使用的页面组件映射。
+
+```ts
+registerRouteComponents(components: Record<string, Component>): void
+```
+
+### nav
+
+导航服务对象，提供平台菜单/页面打开与路由激活方法。
+
+| 方法 | 说明 |
+| --- | --- |
+| `toMenu(keyOrId, { replace = false, query } = {})` | 跳到某菜单（key=编号或 ID）。等同用户点击菜单，URL 一并更新 |
+| `menuUrl(keyOrId, query)` | 生成某菜单的可分享 URL（含 /m/:key，不含 role——打开者用自己的角色） |
+| `currentMenuKey()` | 当前 URL 上的菜单键（无则 ''） |
+| `getMenuKey(menu)` | 读取菜单 MODULE_CODE，缺少代码时回退到 ID。 |
+| `findMenuByKey(menus = [], key)` | 递归查找菜单，优先精确匹配 MODULE_CODE，再匹配 ID。 |
+
+[详细参考](../../docs/revision/core/api/navigation.md)，包括参数、返回值与运行约束。
+
+### publishCoreRuntime
+
+将当前 core、utils、Vue、Vuex 命名空间交给远程产品共享注册表；安装 core 时自动调用。
+
+```ts
+publishCoreRuntime(): void
+```
+
+### createCore
+
+预置安装选项，返回可交给 app.use 的 core 插件；安装时传入的选项覆盖预置值。
+
+```ts
+createCore(options?: Partial<CoreOptions>): Plugin
+```
+
+### createApp
+
+创建已安装 core 的 Vue 3 应用。默认提供独立 store、hash router 和平台 HTTP；产品可覆盖服务并通过 app.use 安装业务插件。
+
+```ts
+createApp(options?: CreateAppOptions): App<any>
+```
+
+## 稳定子路径
+
+下表按实际 package.json 的公开入口列出。default 使用默认导入，其他名称使用具名导入；类型接口用 import type。
+
+| 导入路径 | 完整导出名 | 用途 / 详细说明 |
+| --- | --- | --- |
+| `@epxing/core/app` | `setApp`、`getApp`、`resolveComponent`、`registerComponent`、`useVuePlugin`、`default` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 [详细参考](../../docs/revision/core/api/app.md) |
+| `@epxing/core/http` | `default` | 平台实体请求客户端，包含 list/find/get/save/update/getCount/getCodes/getTree/apply 与 $get/$post/$request 等方法。 [详细参考](../../docs/revision/core/api/api/index.md) |
+| `@epxing/core/axios` | `default` | 平台 Axios 实例及拦截器；用于通用网络请求。业务实体请求优先使用 http 或注入的 $http。 [详细参考](../../docs/revision/core/api/axios.md) |
+| `@epxing/core/navigation` | `getMenuKey`、`findMenuByKey`、`findMenuPath`、`roleStorage`、`resolveRouteRole`、`MENU_ROUTE_ALIAS`、`effectiveRouteName`、`menuLocation`、`activateMenu`、`syncMenuUrl`、`clearMenuUrl`、`activateFromRoute`、`activateHome`、`nav`、`default`、`MenuRecord`（类型）、`MenuActivationOptions`（类型） | 导航服务对象，提供平台菜单/页面打开与路由激活方法。 [详细参考](../../docs/revision/core/api/navigation.md) |
+| `@epxing/core/component-mixin` | `default` | 配置驱动组件的公共混入，提供 $configs、服务访问、查询上下文、刷新和组件通信协议。 [详细参考](../../docs/revision/core/api/mixins/component.md) |
+| `@epxing/core/global-mixin` | `default` | 全局公共混入；通常由 core 安装，包含平台公共实例能力。 [详细参考](../../docs/revision/core/api/mixins/global.md) |
+| `@epxing/core/field-factory` | `FieldFactory`、`createFieldFactory`、`default` | 兼容旧用法的字段工厂默认实例；独立上下文优先使用 createFieldFactory。 [详细参考](../../docs/revision/utils/api/fieldFactory.md) |
+| `@epxing/core/meta` | `default` | 将服务端元数据包装为模型，提供主键、属性、表单字段和列表字段访问方法。 [详细参考](../../docs/revision/utils/api/meta.md) |
+| `@epxing/core/pdf-viewer` | `default` | 浏览器 PDF 预览工具类；按调用需要加载 PDF 资源和渲染依赖。 [详细参考](../../docs/revision/utils/api/pdf.viewer.md) |
+| `@epxing/core/util` | `getSystemMeta`、`getFileUrl`、`getSysId`、`toLogin`、`usePlugin`、`runExpByScope`、`default` | 平台运行时工具单例，管理系统、资源地址、表达式、打印及远程插件加载等能力。 [详细参考](../../docs/revision/utils/api/util.md) |
+| `@epxing/core/store` | `createStoreModules`、`storeModules`、`createFrameStore` | 返回平台 Vuex 模块集合，模块 state 使用工厂函数；支持按模块覆盖。 |
+| `@epxing/core/runtime` | `getConfiguredRuntimeService`、`configureRuntime`、`getRuntimeService`、`runtimeStore`、`runtimeRouter`、`registerRouteComponents`、`runtimeRouteComponent`、`loadBusinessComponents`、`RuntimeServices`（类型）、`BusinessComponentRegistry`（类型） | 对应 `runtime` 模块。 |
+| `@epxing/core/mixins` | `default`、`global`、`component` | 混入集合：component 与 ComponentMixin 相同，global 与 GlobalMixin 相同。 [详细参考](../../docs/revision/core/api/mixins/index.md) |
+| `@epxing/core/router` | `routerConfig`、`createFrameRouter`、`default`、`FrameRouterOptions`（类型） | 平台基础 routes 与 beforeEach，供产品自行组装 router 时复用。 |
+| `@epxing/core/event-bus` | `createEventBus`、`getEventBus`、`default`、`EventBus`（类型）、`EventListener`（类型） | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 [详细参考](../../docs/revision/core/api/vue.bus.md) |
+| `@epxing/core/style.css` | 可选的显式样式入口 | JS 入口自动加载本包样式；保留此路径以兼容旧代码。 |
+
+## 子路径补充导出
+
+本节列出仅在稳定子路径中提供的具名 API；从本节标题对应路径导入。
+
+### @epxing/core/app
+
+| 导出 / 调用签名 | 用途 | 详细接口 |
+| --- | --- | --- |
+| `useVuePlugin(plugin: Plugin & { runtime?: string; }, options?: any): void \| App<any> \| Promise<void>` | 向当前应用安装远程插件；runtime: vue3 使用原生 app.use，旧插件按兼容开关加载垫片。 | [详细参考](../../docs/revision/core/api/app.md) |
+
+### @epxing/core/navigation
+
+| 导出 / 调用签名 | 用途 | 详细接口 |
+| --- | --- | --- |
+| `getMenuKey(menu?: MenuRecord): string` | 读取菜单 MODULE_CODE，缺少代码时回退到 ID。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `findMenuByKey(menus: MenuRecord[], key: string): MenuRecord` | 递归查找菜单，优先精确匹配 MODULE_CODE，再匹配 ID。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `findMenuPath(menus: MenuRecord[], key: string): MenuRecord[]` | 返回从根到目标菜单的路径，包含目标菜单；不存在时返回空数组。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `roleStorage` | 按客户和系统维度读写当前角色，包含 key/get/set 方法及响应式缓存。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `resolveRouteRole(route?: Pick<RouteLocationNormalizedGeneric, "params">): string \| string[]` | 读取路由角色，URL 优先，缺少时回退到角色存储。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `MENU_ROUTE_ALIAS` | 直达菜单路由到基础路由的别名映射：appMenu → app1，hallMenu → hall。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `effectiveRouteName(name?: string \| symbol): string \| symbol` | 将直达菜单路由名归一为对应基础路由名。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `menuLocation(route: RouteLocationNormalizedGeneric, key: string, query?: LocationQueryRaw): string \| RouteLocationAsRelativeGeneric \| RouteLocationAsPathGeneric` | 根据当前路由、菜单键和查询参数生成菜单直达位置。 | [详细参考](../../docs/revision/core/api/menu-route.md) |
+| `activateMenu(menuId: string, extraProps?: Record<string, any>, options?: MenuActivationOptions): boolean` | 按菜单 ID 激活页面，可控制同步 URL、替换历史和查询参数。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+| `syncMenuUrl(menu: MenuRecord, options?: { replace?: boolean; query?: LocationQueryRaw; context?: Record<string, any>; }): void` | 将当前菜单写入 URL，按需将来源容器存入 sessionStorage，供刷新恢复；只处理受支持的路由。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+| `clearMenuUrl(options?: { replace?: boolean; }): void` | 移除 URL 中的菜单键并返回基础应用/大厅路由。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+| `activateFromRoute(route: RouteLocationNormalizedGeneric): boolean` | 按 URL 中的 menuKey 激活对应菜单，找不到时返回 false。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+| `activateHome(): boolean` | 激活已存在或暂存的应用首页；没有首页时返回 false。 | [详细参考](../../docs/revision/core/api/navigation.md) |
+
+### @epxing/core/runtime
+
+| 导出 / 调用签名 | 用途 | 详细接口 |
+| --- | --- | --- |
+| `getConfiguredRuntimeService<K extends keyof RuntimeServices>(name: K): RuntimeServices[K]` | 读取显式注入的核心服务；未配置时返回 undefined，不访问 window 回退。 | 见声明及接入约定 |
+| `getRuntimeService<K extends keyof RuntimeServices>(name: K): RuntimeServices[K]` | 读取已注入服务，兼容 window 回退；缺少服务时抛出初始化错误。 | 见声明及接入约定 |
+| `runtimeStore` | 当前运行时 store 的代理，访问成员时解析实际注入的 store。 | 见声明及接入约定 |
+| `runtimeRouter` | 当前运行时 router 的代理，访问成员时解析实际注入的 router。 | 见声明及接入约定 |
+| `runtimeRouteComponent(name: string): () => Promise<Component>` | 按登记名生成异步路由组件加载函数；尚未登记时加载失败。 | 见声明及接入约定 |
+| `loadBusinessComponents(app: App<any>): Promise<BusinessComponentRegistry>` | 调用已配置的业务组件加载器；没有加载器时返回空解析器。 | 见声明及接入约定 |
+
+### @epxing/core/mixins
+
+| 导出 / 调用签名 | 用途 | 详细接口 |
+| --- | --- | --- |
+| `global` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 | [详细参考](../../docs/revision/core/api/mixins/global.md) |
+| `component` | 该模块提供平台运行或配置能力；下方按真实导出、依赖和调用事实说明接口。 | [详细参考](../../docs/revision/core/api/mixins/component.md) |
+
+## 导出的 TypeScript 类型
+
+以下名称仅存在于类型系统，用 import type 导入，不作为运行时对象使用。
+
+### CoreOptions
+
+```ts
 interface CoreOptions {
   store: Store<any>
   router: Router
@@ -565,172 +566,172 @@ interface CoreOptions {
   businessLoader?: (app: App) => Promise<{ resolve(app: App, name: string): Promise<Component | null> }>
   globalProperties?: Record<string, unknown>
   i18n?: unknown
-}
-```
-
-### CoreContext
-
-```ts
+}
+```
+
+### CoreContext
+
+```ts
 interface CoreContext {
   app: App
   store: Store<any>
   router: Router
   http: Record<string, any>
   fieldFactory: FieldFactoryClass
-}
-```
-
-### CreateAppOptions
-
-```ts
+}
+```
+
+### CreateAppOptions
+
+```ts
 interface CreateAppOptions extends Partial<CoreOptions> {
   rootComponent?: Component
   rootProps?: Record<string, any> | null
   routes?: RouteRecordRaw[]
   history?: RouterHistory
-}
-```
-
-### EntityRequest
-
-```ts
-interface EntityRequest extends Record<string, any> {
-  entityId?: string
-  metaId?: string
-  action?: string
-}
-```
-
-### EntityRequestMethod
-
-```ts
-interface EntityRequestMethod {
-  <T = any>(params?: EntityRequest | string, ...args: any[]): Promise<T>
-}
-```
-
-### HttpClient
-
-```ts
-interface HttpClient extends Record<string, any> {
-  list: EntityRequestMethod
-  find: EntityRequestMethod
-  get: EntityRequestMethod
-  save: EntityRequestMethod
-  update: EntityRequestMethod
-  getCount: EntityRequestMethod
-  getCodes: EntityRequestMethod
-  getTree: EntityRequestMethod
-  apply: EntityRequestMethod
-  $post: EntityRequestMethod
-  $get: EntityRequestMethod
-  $request: EntityRequestMethod
-}
-```
-
-### FileUrlOptions
-
-```ts
-interface FileUrlOptions { client?: string; flag?: boolean; useSignOrigin?: boolean }
-```
-
-### ScopeCondition
-
-```ts
-interface ScopeCondition extends Record<string, any> { field: string; mode?: string; values?: any }
-```
-
-### RuntimeUtil
-
-```ts
-interface RuntimeUtil extends Record<string, any> {
-  getSystemMeta: typeof getSystemMeta
-  getFileUrl: typeof getFileUrl
-  getSysId: typeof getSysId
-  toLogin: typeof toLogin
-  usePlugin: typeof usePlugin
-  runExpByScope: typeof runExpByScope
-}
-```
-
-### FrameRouterOptions
-
-```ts
-interface FrameRouterOptions extends Partial<RouterOptions> { beforeEach?: NavigationGuard | false }
-```
-
-### EventListener
-
-```ts
-type EventListener = (...args: any[]) => void
-```
-
-### EventBus
-
-```ts
-interface EventBus {
-  on(event: string, listener: EventListener): void
-  off(event?: string, listener?: EventListener): void
-  emit(event: string, ...args: any[]): void
-  $on(event: string | string[], listener: EventListener): EventBus
-  $off(event?: string | string[], listener?: EventListener): EventBus
-  $once(event: string, listener: EventListener): EventBus
-  $emit(event: string, ...args: any[]): EventBus
-}
-```
-
-### MenuRecord
-
-```ts
-interface MenuRecord { ID?: string; MODULE_CODE?: string; children?: MenuRecord[]; [key: string]: any }
-```
-
-### MenuActivationOptions
-
-```ts
-interface MenuActivationOptions { syncUrl?: boolean; replaceUrl?: boolean; query?: LocationQueryRaw }
-```
-
-### RuntimeServices
-
-```ts
-interface RuntimeServices { store: Store<any>; router: Router; http: HttpClient }
-```
-
-### BusinessComponentRegistry
-
-```ts
-interface BusinessComponentRegistry { resolve(app: App, name: string): Promise<Component | null> }
-```
-
-## 源码兼容与其他入口
-
-/src 路径保留给已有产品和源码级扩展，可能包含平台内部实现；新产品优先采用上方根导出与稳定子路径。通配符表示按实际文件名匹配，不代表所有源码都属于根入口。
-
-| 公开路径模式 | 实际目标 |
-| --- | --- |
-| `@epxing/core/src` | `./dist/src/index.js` |
-| `@epxing/core/src/api` | `./dist/src/api/index.js` |
-| `@epxing/core/src/components/draggable` | `./dist/src/components/draggable/index.js` |
-| `@epxing/core/src/mixins` | `./dist/src/mixins/index.js` |
-| `@epxing/core/src/router` | `./dist/src/router/index.js` |
-| `@epxing/core/src/store` | `./dist/src/store/index.js` |
-| `@epxing/core/src/store/modules` | `./dist/src/store/modules/index.js` |
-| `@epxing/core/src/*.css` | `./src/*.css` |
-| `@epxing/core/src/*.scss` | `./src/*.scss` |
-| `@epxing/core/src/*.png` | `./src/*.png` |
-| `@epxing/core/src/*.svg` | `./src/*.svg` |
-| `@epxing/core/src/*.jpg` | `./src/*.jpg` |
-| `@epxing/core/src/*.gif` | `./src/*.gif` |
-| `@epxing/core/src/*.woff` | `./src/*.woff` |
-| `@epxing/core/src/*.woff2` | `./src/*.woff2` |
-| `@epxing/core/src/*.ttf` | `./src/*.ttf` |
-| `@epxing/core/src/*.js` | `./dist/src/*.js` |
-| `@epxing/core/src/*.jsx` | `./dist/src/*.js` |
-| `@epxing/core/src/*.vue` | `./dist/src/*.js` |
-| `@epxing/core/src/*` | `./dist/src/*.js` |
-| `@epxing/core/package.json` | `./package.json` |
-
-## 文档维护
-
-本页由 build/gen-package-api-docs.mjs 生成。修改公开入口并更新构建产物和类型声明后，在框架根运行 `pnpm docs:api`；`pnpm docs:api:check` 检查清单、类型、包内文档与站点镜像是否同步，同时验证页面编译和文档链接。用途和示例维护在 build/package-api-notes.mjs，组件和源码方法的详细参考位于 docs/revision。
+}
+```
+
+### EntityRequest
+
+```ts
+interface EntityRequest extends Record<string, any> {
+  entityId?: string
+  metaId?: string
+  action?: string
+}
+```
+
+### EntityRequestMethod
+
+```ts
+interface EntityRequestMethod {
+  <T = any>(params?: EntityRequest | string, ...args: any[]): Promise<T>
+}
+```
+
+### HttpClient
+
+```ts
+interface HttpClient extends Record<string, any> {
+  list: EntityRequestMethod
+  find: EntityRequestMethod
+  get: EntityRequestMethod
+  save: EntityRequestMethod
+  update: EntityRequestMethod
+  getCount: EntityRequestMethod
+  getCodes: EntityRequestMethod
+  getTree: EntityRequestMethod
+  apply: EntityRequestMethod
+  $post: EntityRequestMethod
+  $get: EntityRequestMethod
+  $request: EntityRequestMethod
+}
+```
+
+### FileUrlOptions
+
+```ts
+interface FileUrlOptions { client?: string; flag?: boolean; useSignOrigin?: boolean }
+```
+
+### ScopeCondition
+
+```ts
+interface ScopeCondition extends Record<string, any> { field: string; mode?: string; values?: any }
+```
+
+### RuntimeUtil
+
+```ts
+interface RuntimeUtil extends Record<string, any> {
+  getSystemMeta: typeof getSystemMeta
+  getFileUrl: typeof getFileUrl
+  getSysId: typeof getSysId
+  toLogin: typeof toLogin
+  usePlugin: typeof usePlugin
+  runExpByScope: typeof runExpByScope
+}
+```
+
+### FrameRouterOptions
+
+```ts
+interface FrameRouterOptions extends Partial<RouterOptions> { beforeEach?: NavigationGuard | false }
+```
+
+### EventListener
+
+```ts
+type EventListener = (...args: any[]) => void
+```
+
+### EventBus
+
+```ts
+interface EventBus {
+  on(event: string, listener: EventListener): void
+  off(event?: string, listener?: EventListener): void
+  emit(event: string, ...args: any[]): void
+  $on(event: string | string[], listener: EventListener): EventBus
+  $off(event?: string | string[], listener?: EventListener): EventBus
+  $once(event: string, listener: EventListener): EventBus
+  $emit(event: string, ...args: any[]): EventBus
+}
+```
+
+### MenuRecord
+
+```ts
+interface MenuRecord { ID?: string; MODULE_CODE?: string; children?: MenuRecord[]; [key: string]: any }
+```
+
+### MenuActivationOptions
+
+```ts
+interface MenuActivationOptions { syncUrl?: boolean; replaceUrl?: boolean; query?: LocationQueryRaw }
+```
+
+### RuntimeServices
+
+```ts
+interface RuntimeServices { store: Store<any>; router: Router; http: HttpClient }
+```
+
+### BusinessComponentRegistry
+
+```ts
+interface BusinessComponentRegistry { resolve(app: App, name: string): Promise<Component | null> }
+```
+
+## 源码兼容与其他入口
+
+/src 路径保留给已有产品和源码级扩展，可能包含平台内部实现；新产品优先采用上方根导出与稳定子路径。通配符表示按实际文件名匹配，不代表所有源码都属于根入口。
+
+| 公开路径模式 | 实际目标 |
+| --- | --- |
+| `@epxing/core/src` | `./dist/src/index.js` |
+| `@epxing/core/src/api` | `./dist/src/api/index.js` |
+| `@epxing/core/src/components/draggable` | `./dist/src/components/draggable/index.js` |
+| `@epxing/core/src/mixins` | `./dist/src/mixins/index.js` |
+| `@epxing/core/src/router` | `./dist/src/router/index.js` |
+| `@epxing/core/src/store` | `./dist/src/store/index.js` |
+| `@epxing/core/src/store/modules` | `./dist/src/store/modules/index.js` |
+| `@epxing/core/src/*.css` | `./src/*.css` |
+| `@epxing/core/src/*.scss` | `./src/*.scss` |
+| `@epxing/core/src/*.png` | `./src/*.png` |
+| `@epxing/core/src/*.svg` | `./src/*.svg` |
+| `@epxing/core/src/*.jpg` | `./src/*.jpg` |
+| `@epxing/core/src/*.gif` | `./src/*.gif` |
+| `@epxing/core/src/*.woff` | `./src/*.woff` |
+| `@epxing/core/src/*.woff2` | `./src/*.woff2` |
+| `@epxing/core/src/*.ttf` | `./src/*.ttf` |
+| `@epxing/core/src/*.js` | `./dist/src/*.js` |
+| `@epxing/core/src/*.jsx` | `./dist/src/*.js` |
+| `@epxing/core/src/*.vue` | `./dist/src/*.js` |
+| `@epxing/core/src/*` | `./dist/src/*.js` |
+| `@epxing/core/package.json` | `./package.json` |
+
+## 文档维护
+
+本页由 build/gen-package-api-docs.mjs 生成。修改公开入口并更新构建产物和类型声明后，在框架根运行 `pnpm docs:api`；`pnpm docs:api:check` 检查清单、类型、包内文档与站点镜像是否同步，同时验证页面编译和文档链接。用途和示例维护在 build/package-api-notes.mjs，组件和源码方法的详细参考位于 docs/revision。