@jzg223/design-runtime 0.0.0-stage → 0.0.1

package/dist/types/table/transformer.d.ts

@@ -0,0 +1,59 @@
+import type { PlatformTableConfig } from '../types';
+/**
+ * 平台表格配置 → vxe-grid 配置（从宿主 `design-table/src/transformer.ts` 搬入）
+ *
+ * 迁移时只动了两处，其余逐字保留（行为对齐是验收标准）：
+ * 1. `renderDict`（宿主 `#/utils/render`，依赖宿主的字典 store 与 DictTag 组件）改为
+ *    **调用方注入** `TransformHost.renderDict`：字典属于宿主的业务数据，库不该也不可能有。
+ * 2. 取数走本库 `fetchTableData`（注入的 http），不再 import 宿主的 `api.ts`。
+ *
+ * 类型口径：`gridOptions` 刻意标成 `Record<string, any>` 而不是 `VxeGridProps`。
+ * 原因：`VxeGridProps` 在宿主里来自 `#/adapter/vxe-table`（= `@vben/plugins/vxe-table`），
+ * 那些包是 vben monorepo 的 **源码导出**（exports 直接指向 `./src/*.ts`），
+ * 发到 npm 的本库若在 .d.ts 里引用它，外部使用方就解析不到类型了。
+ * 用结构化宽类型换「装进任何 vben 项目都能编译」，vxe 侧的具体校验留给宿主。
+ */
+/**
+ * 「自定义列」/「扩展包工具条 / 操作列」需要的宿主能力（2026-10-21）
+ *
+ * 由 design-table 注入而不是在模块里直接 import 字段注册中心：transformer 被 design-table 引用，
+ * 而字段注册中心（design-form 的 fields）里又间接引用了 design-table（内嵌列表），
+ * 直接 import 会把这条循环依赖钉死在模块初始化期。
+ */
+export interface TransformHost {
+    /** 扩展列的平台能力（request / message / reload） */
+    getApi?: () => any;
+    /** 表格自身参数（扩展列渲染时用，取实时值） */
+    getParams?: () => Record<string, any>;
+    /**
+     * 合计行的值（2026-10-22）：数据接口返回的 `summaries`，footerMethod 渲染时读取
+     */
+    getSummaries?: () => Record<string, any>;
+    /** 收到新的合计值（与数据同一次响应返回，先存起来再渲染 footer） */
+    onSummaries?: (summaries: Record<string, any>) => void;
+    /**
+     * 数据接口带回的运行时标题（2026-10-22）：列表的标题表达式由后端求值，
+     * 随 pager 响应返回 `runtimeTitle`，这里回调给 design-table 抛 `update:title`。
+     */
+    onRuntimeTitle?: (title: string) => void;
+    /**
+     * 字典渲染（宿主注入）：`formater: 'dict-XXX'` 的列用它把值翻成标签。
+     * 未注入时**降级为原值**并 warn 一次 —— 字典数据在宿主（`#/utils/render` 读宿主字典 store），
+     * 库里既没有数据也不能自建一份。
+     */
+    renderDict?: (value: any, dictName: string) => any;
+    /** 按 comname 解析扩展包组件（design-table 传 resolveCellComponent） */
+    resolveCustom?: (comname: string) => any;
+}
+export interface TransformTableResult {
+    /** 预留：查询表单配置（当前宿主实现恒为 false，表单由 search prop 提供） */
+    formOptions?: Record<string, any>;
+    /** vxe-grid 配置（宽类型，见文件头「类型口径」） */
+    gridOptions: Record<string, any>;
+    hasSearchForm: boolean;
+    isPager: boolean;
+}
+/**
+ * 将平台表格配置转换为 VXE-Grid 所需格式
+ */
+export declare function transformTableConfig(config: PlatformTableConfig, tableHeight?: number | string, host?: TransformHost): TransformTableResult;

package/dist/types/tree/design-tree.vue.d.ts

@@ -0,0 +1,33 @@
+import type { DesignTableTool as TableTool, PlatformTreeViewConfig } from '../types';
+type __VLS_Props = {
+    /** 模块分类 */
+    category?: string;
+    /** 配置名称 */
+    name?: string;
+    /** 直接传入配置（可选，跳过 API 请求） */
+    config?: PlatformTreeViewConfig | null;
+    /** 上游组件推过来的参数（其他组件跳转携带，如 deptId）；与路由参数合并为组件自身 extraParams，并透传给关联目标 */
+    parentParams?: Record<string, any>;
+    /** dev 悬浮按钮距容器顶部距离(px)；嵌套在其它设计组件内时下移，避免与父组件按钮重叠 */
+    devButtonTop?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "config-loaded": (config: any) => any;
+    "update:title": (title: string) => any;
+    "tool-command": (tool: TableTool) => any;
+    "update:remarks": (remarks: string) => any;
+    "update:has-config": (hasConfig: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onConfig-loaded"?: ((config: any) => any) | undefined;
+    "onUpdate:title"?: ((title: string) => any) | undefined;
+    "onTool-command"?: ((tool: TableTool) => any) | undefined;
+    "onUpdate:remarks"?: ((remarks: string) => any) | undefined;
+    "onUpdate:has-config"?: ((hasConfig: boolean) => any) | undefined;
+}>, {
+    name: string;
+    config: PlatformTreeViewConfig | null;
+    category: string;
+    parentParams: Record<string, any>;
+    devButtonTop: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/types.d.ts

@@ -0,0 +1,525 @@
+/**
+ * 配置契约类型（设计端 design-ui 保存、运行端渲染的那份 JSON 的**稳定子集**）
+ *
+ * 为什么要单独定义：这些类型是「设计端 / 后端快照 / 运行端」三方的公共语言，
+ * 属于本库对外的契约面。破坏性改动必须升大版本，并在 CHANGELOG 写清迁移方式。
+ */
+/** 字段映射的一行：表达式求值结果 → 目标参数名 */
+export interface DesignMapping {
+    /** 目标参数名（推送出去时用的键） */
+    paramName?: string;
+    /** 取值表达式，作用域由宿主提供（如 `params.deptId`、`node.deptId`） */
+    express?: string;
+}
+/** 列表工具条按钮（本库只用其中与映射有关的字段） */
+export interface DesignTableTool {
+    /** 工具类型：add / export / navigate-* / modal-* / hcm-tool / other */
+    type?: string;
+    /** 按钮文案 */
+    title?: string;
+    /** 老版本的文案字段 */
+    label?: string;
+    /** 扩展组件名（type = hcm-tool 时用） */
+    comname?: string;
+    /** 弹窗宽度（px） */
+    modalWidth?: number | string;
+    /** 目标组件定位（跳转/弹窗类） */
+    targetCategory?: string;
+    targetFormCategory?: string;
+    targetFormName?: string;
+    targetTableCategory?: string;
+    targetTableName?: string;
+    targetComboCategory?: string;
+    targetComboName?: string;
+    /** 参数映射：作用域 → 目标参数 */
+    mappings?: DesignMapping[];
+    /** id 提取表达式（目标组件需要 source-id 时用） */
+    expressId?: string;
+    /** 允许设计端扩展任意字段，避免过窄的类型挡住真实配置 */
+    [key: string]: any;
+}
+/** 行操作「跳转/弹窗」的参数映射项：与 DesignMapping 同一形状（paramName + express） */
+export type RowActionMapping = DesignMapping;
+/** 行操作按钮配置 */
+export interface RowAction {
+    /** 操作类型: edit=编辑, delete=删除, view=查看, other=自定义脚本 */
+    type: 'delete' | 'edit' | 'other' | 'view' | string;
+    /** 按钮文字 */
+    title: string;
+    /** edit/view: 目标表单分类 */
+    targetFormCategory?: string;
+    /** edit/view: 目标表单名称 */
+    targetFormName?: string;
+    /** edit/view: 表单抽屉宽度（默认 600px） */
+    formWidth?: number;
+    /** navigate-table: 目标表格分类（可选，默认沿用当前表格 category） */
+    targetTableCategory?: string;
+    /** navigate-table: 目标表格名称 */
+    targetTableName?: string;
+    /** navigate-combo: 目标组合视图分类（可选，默认沿用当前表格 category） */
+    targetComboCategory?: string;
+    /** navigate-combo: 目标组合视图名称 */
+    targetComboName?: string;
+    /** navigate-tree: 目标树形视图分类（可选，默认沿用当前表格 category） */
+    targetTreeCategory?: string;
+    /** navigate-tree: 目标树形视图名称 */
+    targetTreeName?: string;
+    /** navigate-*: 参数映射（跳转时传给目标视图的参数，作用域 params + row） */
+    mappings?: RowActionMapping[];
+    /**
+     * modal-custom: 弹窗里渲染的**业务组件名**（宿主注册表登记的名字，如 `employee-select`）。
+     * 解析走本库的 comname 注册表（见 registry.ts）。
+     */
+    comname?: string;
+    /** modal-custom: 弹窗宽度（px，默认 800） */
+    modalWidth?: number;
+    /** other: 需要执行的 JS 脚本（函数体，脚本内可直接访问 row/action/api） */
+    command?: string;
+}
+/** 平台表格列配置（content JSON 解析后的每一项） */
+export interface PlatformColumn {
+    /** 列名：这一列在行数据里的名字（服务端反显写它、运行端读它）。留空 = 来源字段 */
+    name?: string;
+    /**
+     * 是否显示这一列：`false`（或 `0`/`'0'`/`'false'`）= 配置了但不渲染。
+     * 注意隐藏**不影响接口返回**：列上配的字段照样返回（行操作 mappings 可能要用），
+     * 少返回字段靠不配这一列 —— 后端按列配置裁剪 pager/list 的返回字段。缺省 = 显示。
+     */
+    isShow?: boolean | number | string;
+    /** 来源字段（数据字段）：这一列从哪个字段取值 */
+    field?: string;
+    /** 列标题 */
+    title: string;
+    /** 列宽度，支持 "120" 或 "120:200:300"（width:minWidth:maxWidth） */
+    width?: string;
+    /** 列类型: seNo=序号, dataSelect=复选框 */
+    type?: 'dataSelect' | 'seNo' | string;
+    /** 格式化器/插槽名: action=操作列, dict-{code}=字典, file=文件, 其他=自定义slot */
+    formater?: string;
+    /** 固定列: left | right */
+    fixed?: string;
+    /** 行内编辑配置 JSON 字符串: {text_type, name, type, isneed, validate, ...} */
+    edit?: string;
+}
+/** 平台表格配置（API 返回的 config 对象） */
+export interface PlatformTableConfig {
+    id: number;
+    name: string;
+    title: string;
+    /** JSON 字符串: PlatformColumn[] */
+    content: string;
+    /** 数据接口路径 */
+    url: string;
+    /** 是否分页: 1=分页, 0=不分页 */
+    pager: number;
+    /** 每页条数 */
+    pagesize: number;
+    /** 模块名 */
+    moduleName?: string;
+    /** 表名 */
+    tableName?: string;
+    /** 主键字段名（edittable 用） */
+    pfield?: string;
+    /** 表格列（从外部传入，直接使用） */
+    columns?: any[];
+    /** 工具栏按钮配置 */
+    toolBars?: DesignTableTool[];
+    /** 行操作按钮配置 */
+    rowActions?: RowAction[];
+    /** 删除接口 */
+    deleteUrl?: string;
+    /** 查看/编辑时加载表单数据的接口 */
+    showUrl?: string;
+    /** @deprecated 见宿主 RelationTextResolver：反显文本现在写在行数据的「列名」上 */
+    dataSets?: Record<string, any[]>;
+    /** 树组件：树数据接口地址 */
+    treeUrl?: string;
+    /** 树组件：选中树节点后注入表格查询的字段名（如 deptId） */
+    treeFilterField?: string;
+    /** 绑定的查询表单名称（渲染在表格上方，通过 category + 该 name 调 sform 接口拉取配置） */
+    searchForm?: null | string;
+    /**
+     * 查询参数（列表基本信息里配置的 JSON 对象，后端 design_tabledesign.query_params）：
+     * 取数时并入请求体的 `params`（表达式 env，供动作条件里的 ${params.x} 取值），**不进 search**；
+     * 与运行时参数同名时**以配置为准**；空白/非法 JSON/非对象 → 忽略（见 parseConfigParams）。
+     */
+    queryParams?: null | Record<string, any> | string;
+    /**
+     * 附加配置（JSON 字符串或对象，后端 design_tabledesign.extra_config）。
+     * 约定键：
+     *   - `query.when`：加载条件表达式（作用域 `search` / `params`），假值不加载；
+     *   - `query.tip` ：未满足时的提示文案。
+     */
+    extraConfig?: null | Record<string, any> | string;
+}
+/** 表格数据 API 响应（宿主拦截器已剥 `{code,data}`，这里按后端原始形状兼容读） */
+export interface TableDataResponse {
+    code?: number;
+    datas?: any[];
+    message?: string;
+    records?: any[];
+    summaries?: Record<string, any>;
+    total?: number;
+    /** 运行时标题（后端按标题表达式求值，随 pager 响应返回） */
+    runtimeTitle?: string;
+    [key: string]: any;
+}
+/** 字典项（dicts 数组元素） */
+export interface PlatformDictItem {
+    dictLabel: string;
+    dictValue: string;
+    dictType?: string;
+    dictCode?: number;
+    dictSort?: number;
+    isDefault?: string;
+    cssClass?: string;
+    listClass?: string;
+    default?: boolean;
+    remark?: string;
+    /** select_sql 查询场景：SQL 该行全部字段（树形/其它列直接取用） */
+    data?: Record<string, any>;
+    [key: string]: any;
+}
+/** cell 样式 */
+export interface PlatformCellStyle {
+    fontColor?: null | string;
+    fontSize?: null | string;
+    fontFamily?: null | string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: null | string;
+    strikethrough?: null | string;
+    bgColor?: null | string;
+    colWidth?: number;
+    rowHeight?: number;
+    mergeColCount?: number;
+    mergeRowCount?: number;
+    border?: {
+        t?: {
+            s: number;
+            cl: {
+                rgb: string;
+            };
+        };
+        r?: {
+            s: number;
+            cl: {
+                rgb: string;
+            };
+        };
+        b?: {
+            s: number;
+            cl: {
+                rgb: string;
+            };
+        };
+        l?: {
+            s: number;
+            cl: {
+                rgb: string;
+            };
+        };
+    };
+}
+/** 平台表单字段 cell（content.cells 数组元素） */
+export interface PlatformFormCell {
+    /** 行索引 */
+    row: number;
+    /** 列索引 */
+    col: number;
+    /** 标签标题（label 用 title，有 name 的才是字段） */
+    title: string;
+    /** 字段名（有 name 的是表单字段，无 name 的是纯标签/说明） */
+    name?: string;
+    /** 字段类型: text|select|date|month|time|tree|radio|checkbox|image|file|fj|switch|splitline|org-select|orgs-select|my */
+    type?: string;
+    /** 自定义组件名（构建端「类型=自定义」时填的名字，运行端按 comname 注册表解析） */
+    comname?: string;
+    /** 子类型: text=文本, number=数字, textarea=多行文本, password=密码 */
+    text_type?: string;
+    /** 小数位数（text_type=number 时用） */
+    decimalLen?: number | string;
+    /** 只读: "0"=可编辑, "1"=有值时只读, "2"=始终只读 */
+    readonly?: string;
+    /** 是否必填: "1"=必填 */
+    isneed?: string;
+    /** 正则校验表达式 */
+    validate?: string;
+    /** 备注说明：有值时单元格最右侧显示 ? 图标 */
+    remark?: string;
+    /** 选择项: "01| 男\n02| 女" 格式 */
+    select_options?: string;
+    /** 字典数据（select/checkbox/radio 用，优先于 select_options） */
+    dicts?: PlatformDictItem[];
+    /** 字典编码（tree 类型用） */
+    dict?: string;
+    /** 日期返回类型: "0"=时间戳 */
+    returnType?: string;
+    /** 日期类型: yyyy-MM-dd, yyyy-MM-dd HH:mm:ss 等 */
+    dateType?: string;
+    /** 后置文本 */
+    after?: string;
+    /** 前置文本 */
+    before?: string;
+    /** 隐藏条件表达式（历史遗留，运行端不消费；用 vif/vshow） */
+    hidd?: string;
+    /** 渲染条件（v-if 语义）：假 → 不渲染输入组件但保留表格占位 */
+    vif?: string;
+    /** 显示条件（v-show 语义）：假 → 照常渲染但不可见 */
+    vshow?: string;
+    /** 样式 */
+    style?: PlatformCellStyle;
+    /** 合并列数 */
+    mergeColCount?: number;
+    /** 合并行数 */
+    mergeRowCount?: number;
+    /** splitline: 分割线方向 */
+    orientation?: string;
+    /** splitline: 是否虚线 */
+    dashed?: number | string;
+    /** splitline: 是否正文样式 */
+    plain?: number | string;
+    /** 选项过滤表达式：row=选项整行，data=derivedValues 全量值空间 */
+    dictFilter?: string;
+    /** 派生赋值：本 cell 值变化后，把选中项的 source 属性赋给派生字段 field */
+    deriveTo?: Array<{
+        field: string;
+        source: string;
+    }>;
+    /** 绑定派生字段（依赖声明） */
+    bindDerived?: string;
+    /** 取值表达式（JS）：派生值变化时求值并回填本 cell 的 name 字段 */
+    derivedExpress?: string;
+    /** 内嵌列表（embedded-list）：引用的本模块列表 */
+    embeddedList?: {
+        module?: string;
+        name?: string;
+        title?: string;
+    };
+    /** 内嵌列表关系映射 */
+    mappings?: RowActionMapping[];
+    /** 内嵌列表数据区高度(px) */
+    embeddedHeight?: number;
+}
+/** 平台表单 content（JSON 解析后） */
+export interface PlatformFormContent {
+    cells: PlatformFormCell[];
+    totalRow: number;
+    totalCol: number;
+    colWidths: number[];
+    rowHeights: number[];
+}
+/** 派生字段定义（表单维护「派生字段」弹窗配置） */
+export interface PlatformDerivedField {
+    /** 派生字段名（= 数据库列名） */
+    name: string;
+    /** 标题 */
+    title?: string;
+    /** 类型 */
+    type?: string;
+    /** 来源声明（运行时派生值由组件 deriveTo emit，此字段仅说明） */
+    source?: string;
+    /** 是否随表单提交存库 */
+    persist?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+}
+/** 平台表单配置（API 返回或前端传入） */
+export interface PlatformFormConfig {
+    id: number;
+    name: string;
+    title: string;
+    /** JSON 字符串: PlatformFormContent（旧格式）；新格式为 null，用 `config` */
+    content: null | string;
+    /** label 宽度 */
+    labelwidth: number;
+    /**
+     * 表单宽度（用于抽屉/弹窗）
+     * ⚠ 后端落库是字符串（"800" / "" / "0"），运行端必须归一化成数字，
+     * 直接传 antd Drawer/Modal 会因类型非法被丢弃 → 面板 0px，只剩遮罩
+     */
+    width?: number | string;
+    /** 模块名 */
+    moduleName?: string;
+    /** 新增接口 */
+    insertUrl?: string;
+    /** 更新接口 */
+    updateUrl?: string;
+    /** 删除接口 */
+    deleteUrl?: string;
+    /** 查看接口 */
+    showUrl?: string;
+    /** 按参数查询接口（无 source-id 时带 extraParams 调它取单条） */
+    showByParamsUrl?: string;
+    /** 主键字段名 */
+    pfield?: string;
+    /** 变更回调 */
+    changecallback?: null | string;
+    /** 工具条 */
+    toolBars?: DesignTableTool[];
+    /** 新格式：直接包含 cells 对象 */
+    config?: null | PlatformFormContent;
+    /** 派生字段 */
+    derivedFieldList?: PlatformDerivedField[];
+}
+/** AMIS 页面组件 */
+export interface PlatformViewComponent {
+    type: 'chart' | 'iframe' | 'tpl' | string;
+    id?: string;
+    tpl?: string;
+    wrapperComponent?: string;
+    inline?: boolean;
+    src?: string;
+    height?: string;
+    config?: Record<string, any>;
+    replaceChartOption?: boolean;
+    dataFilter?: string;
+    body?: PlatformViewComponent[];
+}
+/** 平台视图/页面配置（content JSON 解析后） */
+export interface PlatformViewContent {
+    type: 'page';
+    body: PlatformViewComponent[];
+    id: string;
+    asideResizor?: boolean;
+    pullRefresh?: {
+        disabled: boolean;
+    };
+}
+/** 平台视图配置（API 返回的 config 对象） */
+export interface PlatformViewConfig {
+    id: number;
+    name: string;
+    title: string;
+    /** JSON 字符串: PlatformViewContent */
+    content: string;
+    moduleName?: string;
+    toolBars?: DesignTableTool[];
+}
+/** 查询表单字段 cell（比表单 cell 简单） */
+export interface SearchFieldCell {
+    /** 字段标签 */
+    title: string;
+    /** 字段名（查询参数名） */
+    name?: string;
+    /** 字段类型: text|select|date|time|tree|radio|checkbox 等 */
+    type?: string;
+    /** 只读: "0"=可编辑, "1"=有值时只读, "2"=始终只读 */
+    readonly?: string;
+    /** 子类型: text=文本, number=数字, textarea=多行文本 */
+    text_type?: string;
+    /** 选择项: "01| 男\n02| 女" 格式 */
+    select_options?: string;
+    /** 字典数据（select/radio/checkbox 用） */
+    dicts?: PlatformDictItem[];
+    /** 占位提示 */
+    placeholder?: string;
+    /** 是否必填 */
+    isneed?: string;
+    [key: string]: any;
+}
+/**
+ * 查询表单配置：二维数组，每个内层数组是一行，元素为该行的字段 cell。
+ * 示例: [[{ title: '名称', name: 'name', type: 'text' }]]
+ */
+export type PlatformSearchConfig = SearchFieldCell[][];
+/** 查询表单配置对象（sform 接口返回的结构） */
+export interface SearchFormConfig {
+    /** 二维数组，每个内层数组是一行查询字段 */
+    cells: SearchFieldCell[][];
+    [key: string]: any;
+}
+/** 组合视图的单个渲染目标 */
+export interface PlatformCombItem {
+    /** 渲染类型: form=表单, table=表格, view=视图 */
+    type: string;
+    /** 目标配置名称 */
+    name: string;
+    /** 目标分类（可选，为空时沿用组合视图自身的 category） */
+    module?: string;
+    /** Tab 标签文字 */
+    title?: string;
+    /** id 提取表达式（覆盖 comb 级别的 expressId） */
+    expressId?: string;
+    /** 字段映射：表达式作用域 params / data */
+    mappings?: RowActionMapping[];
+    [key: string]: any;
+}
+/** 组合视图配置（API 返回的 config 对象） */
+export interface PlatformCombConfig {
+    id: number;
+    name: string;
+    title: string;
+    /** 待渲染目标数组（后端可能返回 JSON 字符串或已解析数组） */
+    config: PlatformCombItem[] | string;
+    /** 显示方式: tabs=左侧页签（默认） / flat=平铺上下堆叠 */
+    displayMode?: 'flat' | 'tabs';
+    /** 数据接口 URL：获取组合视图上下文数据（用于生成标题） */
+    dataUrl?: string;
+    /** 标题表达式：模板占位 ${字段名} */
+    expressTitle?: string;
+    /** id 提取表达式：模板占位 ${字段路径} */
+    expressId?: string;
+    /** 副标题 */
+    remarks?: string;
+    moduleName?: string;
+    [key: string]: any;
+}
+/** 树节点→关联目标参数的映射项 */
+export interface PlatformTreeMapping {
+    /** 传给关联目标的参数名 */
+    paramName: string;
+    /** 映射表达式：作用域含 node（当前节点）、router（路由参数），如 node.dept_id */
+    express: string;
+}
+/**
+ * 树形视图「节点数量」配置（写进 design_tree_view.extra_config.nodeCount）。
+ * 发布时后端收敛成运行端要的展示参数，SQL / 数据集编码不下发；
+ * 取数统一走 `POST /design/treeView/nodeCount`。
+ */
+export interface TreeNodeCountConfig {
+    /** 是否启用（后端只在启用时下发本对象） */
+    enabled?: boolean;
+    /** 取值方式：dataset=关联数据集 / sql=关联SQL（主库） */
+    mode?: 'dataset' | 'sql';
+    /** 关联字段：结果集里用来匹配节点的列 */
+    keyColumn?: string;
+    /** 值字段：数量所在列 */
+    valueColumn?: string;
+    /** 节点上取哪个字段做匹配值；留空 = node.key */
+    matchField?: string;
+    /** 未命中时显示什么（如 0）；留空 = 不显示徽标 */
+    defaultValue?: string;
+    /** 数字后缀（如 人 / 条） */
+    suffix?: string;
+    /** 数量为 0 时是否隐藏 */
+    hideZero?: boolean;
+}
+/** 树形视图配置（API 返回的 config 对象） */
+export interface PlatformTreeViewConfig {
+    id: number;
+    name: string;
+    title: string;
+    /** 绑定数据集编码（运行时先取配置，再按它调 /design/dataSet/* 加载树数据） */
+    dataSetName?: string;
+    /** @deprecated 树数据已不随配置返回，用 /design/dataSet/tree/sync 或 tree/async */
+    datas?: any[];
+    /** 关联类型: form=表单, table=表格, comboView=组合视图, tree=树形视图 */
+    relationType?: string;
+    /** 关联目标名称 */
+    relationTargetName?: string;
+    /** id 提取表达式（JS）：作用域 node / params / router */
+    expressId?: string;
+    /** 描述文字（展示在页面标题下方） */
+    remarks?: string;
+    /** 节点→参数映射 */
+    mappings?: PlatformTreeMapping[];
+    /** 树宽度(px)：左侧树面板初始宽度，可拖拽调整（本地记忆覆盖） */
+    treeWidth?: number;
+    /** 工具栏按钮配置 */
+    toolBars?: DesignTableTool[];
+    /** 节点数量：有值且 enabled=true → 树加载后按节点批量取数量 */
+    nodeCount?: null | TreeNodeCountConfig;
+    moduleName?: string;
+    [key: string]: any;
+}

package/dist/types/utils/default-value.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 查询表单字段「默认值」解析（搬自宿主 `components/design/design-runtime/default-value.ts`）
+ *
+ * 约定（设计端「额外属性」里配）：
+ *   - `defaultNow = 1`  → 当前时间：month 类型输出 `YYYY-MM`，其它日期类型按 `dateType`，兜底 `YYYY-MM-DD`
+ *   - `defaultValue`    → 固定默认值；支持 `${now}`（同上按类型格式化）与 `${now:YYYY/MM/DD}` 自定义格式
+ *
+ * 设计上刻意只支持这几种 token，**不跑任意 JS**：默认值来自配置，安全边界比"表达式"低一档。
+ */
+/** 按格式串把日期拼出来（只支持 YYYY / MM / DD / HH / mm / ss，够用且无依赖） */
+export declare function formatNow(format?: string, date?: Date): string;
+/**
+ * 解析默认值：返回 undefined 表示"没有默认值"
+ * （调用方不要再写空串，否则会覆盖字段的真实空态）。
+ */
+export declare function resolveDefaultValue(cell: null | Record<string, any> | undefined): any;

package/dist/types/utils/download.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 文件下载工具（搬自宿主 `#/utils/file/download`，只取设计组件真正用到的部分）
+ *
+ * 导出类工具（`export`）走后端文件流，返回 Blob 后交给这里落盘。
+ * `downloadByBase64` / `downloadByOnlineUrl` 需要宿主的 base64 转换工具，本库用不到，未搬。
+ *
+ * 只在浏览器里可用（用到 `document` / `URL`），SSR 环境调用会抛错 —— 导出本来就是浏览器行为。
+ */
+export declare function downloadByData(data: BlobPart, filename: string, mime?: string, bom?: BlobPart): void;

package/dist/types/utils/popup-width.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 弹层（抽屉/弹窗）宽度归一化（搬自宿主 `components/design/popup-width.ts`）
+ *
+ * 背景：构建端表单设计里的「宽度」落库是**字符串**（`design_formdesign.width`），
+ * 运行端拿到的是 `"800"` / `""` / `"0"` 这类值。而 antd `Drawer` 的 `width`
+ * 只接受 **number**：传字符串会被判定为非法值直接丢弃（控制台只报
+ * `Invalid value type of 'width' or 'height' which should be number type instead`），
+ * 抽屉面板宽度算成 `0px` —— 结果就是**只出现遮罩（整页变灰）、看不到抽屉和表单**。
+ *
+ * 所以凡是「配置宽度 → 弹层宽度」的地方，都要先过这里：
+ * 数字/数字字符串都能解析，非正数（0/负数）、空、非法值统一回退。
+ */
+/** 弹层默认宽度（与构建端「未设置宽度」时的运行端默认保持一致） */
+export declare const DEFAULT_POPUP_WIDTH = 600;
+/** 解析单个宽度值：能解析成正数就返回整数，否则 undefined（0/空/非法都视为「没配」） */
+export declare function toPopupWidth(raw: unknown): number | undefined;
+/**
+ * 按优先级取第一个可用宽度（如 `cfg.width` → `tool.formWidth` → 默认 600）。
+ * 空字符串、`"0"`、`NaN`、`undefined` 都会被跳过，不会产出 0px 的隐形弹层。
+ */
+export declare function resolvePopupWidth(...candidates: unknown[]): number;