@jzg223/design-runtime 0.0.0-stage → 0.0.1

package/dist/types/api.d.ts

@@ -0,0 +1,83 @@
+import type { PlatformCombConfig, PlatformFormConfig, PlatformSearchConfig, PlatformTableConfig, PlatformTreeViewConfig, PlatformViewConfig } from './types';
+/**
+ * 清空配置缓存（`resetDesignHost()` 之后、或需要强制重取配置时用）。
+ * 登出 / 切换租户后不清会拿到上一个身份的配置。
+ */
+export declare function clearDesignApiCache(): void;
+/**
+ * 获取表格配置
+ * API: POST /{category}/{name}/table
+ *
+ * 请求体与**数据接口同形状**：`{ search: {}, params: {...} }`。
+ * 后端用这里的 params/search 求标题表达式；不带的话 `params.month` 全是 nil，
+ * 标题会算成 `null发放批次123`。配置本身与参数无关，只有标题需要这份 env。
+ */
+export declare const fetchTableConfig: (category: string, name: string, params?: Record<string, any> | undefined) => Promise<PlatformTableConfig>;
+/** 获取表单配置 API: POST /{category}/{name}/form */
+export declare const fetchFormConfig: (category: string, name: string) => Promise<PlatformFormConfig>;
+/**
+ * 获取查询表单（搜索）配置
+ * API: POST /{category}/{name}/sform
+ * 返回二维数组，每个内层数组是一行查询字段。
+ */
+export declare const fetchSearchConfig: (category: string, name: string) => Promise<PlatformSearchConfig>;
+/** 获取视图/页面配置 API: POST /{category}/{name}/view */
+export declare const fetchViewConfig: (category: string, name: string) => Promise<PlatformViewConfig>;
+/** 获取组合视图配置 API: POST /{category}/{name}/comb */
+export declare const fetchCombConfig: (category: string, name: string) => Promise<PlatformCombConfig>;
+/**
+ * 获取组合视图数据（dataUrl 数据接口，返回单个对象，用于生成标题）
+ * @param url 配置中的 dataUrl 字段（相对路径）
+ * @param params 查询参数（路由 query 参数，如 id）
+ */
+export declare function fetchCombData(url: string, params?: Record<string, any>): Promise<Record<string, any>>;
+/**
+ * 获取树形视图配置
+ * API: POST /{category}/{name}/tree
+ * 说明：本接口只返回配置，不内嵌树数据；树数据由下面的 `/design/dataSet/*` 按数据集类型加载
+ * （后端负责父子层级）。
+ */
+export declare const fetchTreeViewConfig: (category: string, name: string) => Promise<PlatformTreeViewConfig>;
+/**
+ * 获取 design-ui 构建端地址（开发模式「编辑/设计」跳转用）
+ * API: GET /design/uiConfig → { uiUrl }
+ */
+export declare const fetchDesignUiConfig: () => Promise<{
+    uiUrl: string;
+}>;
+/**
+ * 获取数据集数据（树形视图的树数据来源）
+ * API: POST /system/dataset/{dataSetName}/data
+ * 返回行数据数组（或 { datas: [...] } / { data: [...] }，调用方负责归一化）。
+ */
+export declare function fetchDataSetData(dataSetName: string): Promise<any>;
+/** 数据集运行时元信息：前端据此决定取数方式（requestMode）与节点展示约定 */
+export interface DataSetMeta {
+    setCode: string;
+    setName?: string;
+    /** tree-树形 / list-列表型 */
+    setType?: string;
+    /** sync-同步 / async-异步 */
+    requestMode?: string;
+    idField?: string;
+    titleField?: string;
+    parentIdField?: string;
+}
+/** 列表数据提取（扁平行） */
+export declare function fetchDataSetListData(setCode: string, params?: Record<string, any>): Promise<any[]>;
+/** 同步树：后端整树嵌套返回（节点含原始行字段 + key/title + children/hasChild/isLeaf） */
+export declare function fetchDataSetTreeSync(setCode: string, params?: Record<string, any>): Promise<any[]>;
+/** 异步树：parentId 为空=根集合，否则=该父节点直接子集 */
+export declare function fetchDataSetTreeAsync(setCode: string, parentId?: null | number | string, params?: Record<string, any>): Promise<any[]>;
+/** 数据集元信息 */
+export declare function fetchDataSetMeta(setCode: string): Promise<DataSetMeta>;
+/**
+ * 树节点数量：按本次加载的节点批量取数量（500 个一批，服务端做）。
+ * 返回**只含有命中的 key**（未命中的由调用方按 `defaultValue` 补）。
+ *
+ * @param moduleName 模块编码（category）
+ * @param code 树形视图名称
+ * @param keys 本次加载节点的匹配值（matchField 留空时就是 node.key）
+ * @param params 组件自身参数（extraParams）
+ */
+export declare function fetchTreeNodeCount(moduleName: string, code: string, keys: any[], params?: Record<string, any>): Promise<Record<string, any>>;

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

@@ -0,0 +1,38 @@
+import type { DesignTableTool as TableTool, PlatformCombConfig } from '../types';
+type __VLS_Props = {
+    /** 模块分类 */
+    category?: string;
+    /** 配置名称 */
+    name?: string;
+    /** 直接传入配置（可选，跳过 API 请求） */
+    config?: PlatformCombConfig | null;
+    /**
+     * 当前记录 id（上级如树/表单推送，对齐 DesignForm.sourceId）。
+     * 有值时作为权威 id：驱动 dataUrl 取单条（不再依赖组合级 expressId 从参数现算），
+     * 并进入表达上下文顶层 id 供组合项/标题读取；空 / 字面量 'undefined' / 'null' 忽略。
+     */
+    sourceId?: string | number;
+    /** 上游组件推过来的参数；与路由参数合并为组件自身 extraParams（透传 dataUrl/内嵌子组件） */
+    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;
+}, 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;
+}>, {
+    name: string;
+    config: PlatformCombConfig | null;
+    category: string;
+    sourceId: string | number;
+    parentParams: Record<string, any>;
+    devButtonTop: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/compat.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 运行时兼容自检
+ *
+ * 背景：本库把 `vue` / `antdv-next` 声明为 **peerDependencies**（构建时 external），
+ * 运行时用的是宿主那一份 —— 好处是全站只有一个实例，代价是**宿主装什么版本就用什么版本**。
+ * 版本对不上时的典型症状是"某个 prop 不生效""样式不对""Teleport 错位"，
+ * 而且要排查很久才想到是版本问题。所以在宿主接入时主动查一次，**明确报出来**。
+ *
+ * 策略（与项目口径一致：不做偷偷兜底）：
+ * - 低于/超出支持区间 → `console.error` 输出一条能直接照着改的提示；
+ * - 需要"启动即失败"的宿主，传 `{ throwOnError: true }`（或
+ *   `installDesignPlatform({ strictCompat: true })`）→ 直接抛错。
+ */
+/** 声明支持区间（改这里要同步 package.json 的 peerDependencies、README「版本兼容与支持矩阵」与 CHANGELOG） */
+export declare const SUPPORTED_VERSIONS: Record<string, string>;
+export interface CompatCheckItem {
+    found: string;
+    ok: boolean;
+    /** 声明支持区间 */
+    supported: string;
+    /** 包名 */
+    pkg: string;
+}
+export interface CompatReport {
+    ok: boolean;
+    items: CompatCheckItem[];
+    /** 一句话结论（有问题的包列在里面） */
+    message: string;
+}
+/**
+ * 极简 semver 匹配：只为自检服务，支持 `^` / `~` / `>=` / `>` / `<=` / `<` / 精确 / `*`。
+ * 不引第三方库，避免"为了检查依赖又加一个依赖"。
+ */
+export declare function satisfiesRange(version: string, range: string): boolean;
+/**
+ * 检查宿主实际安装的版本是否落在支持区间内。
+ *
+ * ```ts
+ * // 宿主 bootstrap（或 CI 冒烟脚本里）
+ * const report = checkDesignRuntimeCompat({ throwOnError: true })
+ * ```
+ */
+export declare function checkDesignRuntimeCompat(options?: {
+    silent?: boolean;
+    throwOnError?: boolean;
+}): CompatReport;

package/dist/types/components/ApiSwitch.vue.d.ts

@@ -0,0 +1,31 @@
+import type { SwitchProps } from 'antdv-next';
+interface Props {
+    /** 选中时的文案，默认「启用」 */
+    checkedText?: string;
+    /** 未选中时的文案，默认「禁用」 */
+    unCheckedText?: string;
+    disabled?: boolean;
+    /** 真正执行更新的逻辑（内部已双向绑定，可直接拿到新值） */
+    api: (checked: SwitchProps['checked']) => PromiseLike<void> | void;
+    /** 更新前是否弹窗确认 */
+    confirm?: boolean;
+    /** 确认框文案（可自定义），默认「确认要更新状态吗？」 */
+    confirmText?: (checked: SwitchProps['checked']) => string;
+}
+type __VLS_Props = Props;
+type __VLS_PublicProps = __VLS_Props & {
+    'value'?: SwitchProps['checked'];
+};
+declare const _default: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    reload: () => any;
+    "update:value": (value: import("antdv-next/dist/switch/index").CheckedValueType | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onReload?: (() => any) | undefined;
+    "onUpdate:value"?: ((value: import("antdv-next/dist/switch/index").CheckedValueType | undefined) => any) | undefined;
+}>, {
+    checkedText: string;
+    unCheckedText: string;
+    confirm: boolean;
+    confirmText: (checked: SwitchProps["checked"]) => string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-debug/dev-mode-toggle.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/types/components/design-debug/dev-mode.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 设置开发模式开关。
+ * on=true：持久化到 localStorage（后续访问自动进入）；
+ * on=false：清理 localStorage，并移除 URL 参数，保证刷新后保持关闭。
+ */
+export declare function setDevMode(on: boolean): void;
+/** 获取共享的开发模式状态（ref，模板中可直接 v-if / 解包） */
+export declare function useDevMode(): import("vue").Ref<boolean, boolean>;

package/dist/types/components/design-debug/dev-state-button.vue.d.ts

@@ -0,0 +1,55 @@
+type __VLS_Props = {
+    /** 组件显示名（弹窗标题用），如 "DesignForm" */
+    title: string;
+    /**
+     * 状态分 tab：key=tab 名（parentParams / extraParams / route / config / ...），
+     * value=任意可 JSON 序列化的数据。传入的是响应式 computed 时弹窗内实时更新。
+     */
+    state: Record<string, any>;
+    /**
+     * 设计器类型（form/table/search/combo/tree/view）。
+     * 传入后在开发模式弹窗内显示「编辑」「设计」按钮，
+     * window.open 打开 design-ui 构建端并深链到目标配置。
+     */
+    designerType?: string;
+    /** 模块编码（design-ui 的 module code） */
+    designerCategory?: string;
+    /** 配置名称（design-ui 的 name） */
+    designerName?: string;
+    /**
+     * 「表达式计算」用的真实映射作用域（可选，如 { params, data } / { params, node, router }）。
+     * **传入后独占**：弹窗里的「可用作用域」= 该组件表达式真正能用的变量，
+     * 因此面板算出的值 = 映射实际会算出的值。各组件作用域不同，不要互相照抄：
+     *   DesignForm / DesignComb → params + data；DesignTree → params + node；
+     *   DesignTable / DesignView → params；DesignSearch → data（无字段映射）。
+     */
+    exprScope?: Record<string, any>;
+    /**
+     * 「表达式计算」的**第二个可选作用域**（可选）。传入后表达式 tab 顶部出现作用域切换按钮，
+     * 可在「映射作用域」与它之间切换 —— 用于调试**非映射类**表达式（如单元格渲染条件 vif /
+     * 显示条件 vshow，其作用域只有派生字段值）。
+     * **不传时行为与改动前完全一致**（只有映射作用域，无切换按钮）。
+     */
+    exprScopeExtra?: {
+        /** 切换按钮文字，如「条件作用域（派生值）」 */
+        label: string;
+        /** 该作用域的变量空间 */
+        scope: Record<string, any>;
+        /** 选中时显示在提示行里的说明（可选） */
+        hint?: string;
+    };
+    /**
+     * 各作用域变量的含义（可选，如 { params: '组件自身参数（extraParams）' }），
+     * 拼进 chip 提示，让「params 到底是什么」在面板里直接可见。
+     */
+    exprScopeLabels?: Record<string, string>;
+    /**
+     * 悬浮按钮距容器顶部的距离(px)。
+     * 嵌套在其它设计组件内（如 tree 内嵌 table）时传更大值，避免与父组件按钮重叠。
+     */
+    top?: number;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    top: number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-debug/expr-eval.d.ts

@@ -0,0 +1,55 @@
+/**
+ * 开发面板「表达式计算」的求值内核（纯函数，便于单测 —— 见同目录 __tests__/expr-eval.test.ts）。
+ *
+ * 语义与 design-tools/mapping.ts 的 evaluateMappedExpress **完全一致**：
+ * 把表达式包成 `return (表达式)`，把作用域对象的所有键作为函数形参名注入。
+ * 因此开发面板里算出来的值，就是工具条「字段映射」真正会算出来的值 —— 这是这套工具的价值所在。
+ */
+/** 作用域键能否注入表达式（非法键名会让 new Function 直接语法报错，故剔除） */
+export declare function isValidScopeKey(key: string): boolean;
+/**
+ * 组装表达式作用域。
+ *
+ * **组件传入 exprScope 时以它为准且独占**：「可用作用域」= 该组件表达式真正能用的变量，
+ * 各组件互不相同 ——
+ *   - DesignForm / DesignComb → `params`（组件自身参数 extraParams）+ `data`
+ *   - DesignTree            → `params` + `node`（不含 router：路由参数已并入 extraParams）
+ *   - DesignTable / DesignView → `params`
+ *   - DesignSearch          → `data`（查询表单当前值；该组件无字段映射）
+ * 不把开发面板的 state 键（props/route/config/...）混进来，否则面板里能算出值、
+ * 真实映射里却取不到，反而给出错误信心。
+ *
+ * 未接线组件的最小兜底：只给 `params`（按项目约定指向 extraParams）。
+ */
+export declare function buildExprScope(state?: Record<string, any> | null, exprScope?: Record<string, any> | null): Record<string, any>;
+/** 可在表达式里使用的变量名（非法标识符不进作用域，也不在面板里展示） */
+export declare function listScopeKeys(scope: Record<string, any>): string[];
+/**
+ * 作用域变量 chip 的提示文本：`含义 —— 类型与结构`。
+ * labels 由组件传入（如 { params: '组件自身参数（extraParams）' }），
+ * 让「可用作用域」自己说清 params 到底是什么、各组件差别在哪。
+ */
+export declare function scopeKeyTip(key: string, value: any, labels?: Record<string, string> | null): string;
+export interface ExprEvalResult {
+    /** 是否求值成功（语法错误 / 运行时报错时为 false） */
+    ok: boolean;
+    /** 结果类型标签：string / number / boolean / object / array / null / undefined / function */
+    type: string;
+    /** 结果展示文本（对象/数组为格式化 JSON，字符串带引号） */
+    text: string;
+    /** 是否未取到值（undefined / null）—— 排查「映射配了但没传值」时最常见的原因 */
+    empty: boolean;
+    /** 失败原因（ok=false 时） */
+    error?: string;
+}
+/** 把求值结果整理成展示信息：类型 + 文本 + 是否空值 */
+export declare function describeValue(value: any): ExprEvalResult;
+/**
+ * 对表达式求值并整理结果；表达式为空返回 null（面板据此显示引导文案）。
+ * 与 design-tools/mapping.ts 同款动态执行：仅用于开发模式面板中开发者本人输入的调试表达式。
+ */
+export declare function evalExpression(expr: string, scope: Record<string, any>): ExprEvalResult | null;
+/** 作用域变量的取值预览（面板 chips 的 title，先看清结构再写表达式） */
+export declare function previewScopeValue(value: any): string;
+/** 点击作用域变量：把键名追加到表达式末尾（接在 `.` 后则不再补空格） */
+export declare function appendScopeKey(expression: string, key: string): string;

package/dist/types/components/design-shared/host-api.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 扩展包组件（业务自定义组件）在**任意宿主插槽**里拿到的平台能力
+ * （搬自宿主 `components/design/design-runtime/host-api.ts`）
+ *
+ * 五个插槽用的是同一套 `api`，差异只在多出的上下文 props：
+ *   form-field  → cell / modelValue / disabled
+ *   table-cell  → cell / row / value
+ *   toolbar     → cell（工具项）/ rows（选中行）
+ *   row-action  → cell（操作项）/ row
+ *   page        → route（query / params / path）
+ *
+ * 设计原则（与宿主侧 `HcmFieldContext` 一致）：**扩展包不 import 基座内部模块**，
+ * 能力一律从这里传进去 —— 这样业务组件既能被本库渲染，也能被别处复用。
+ *
+ * 迁移时的两处替换：
+ * - `alovaInstance` → **注入的 http**（`requireHttp()`，没有第二套拦截器）
+ * - antd `message` 静态方法 → 优先用注入的 `host.message`（宿主那份支持主题与
+ *   `ConfigProvider` 上下文），未注入时才回退 antdv-next 的静态 `message`
+ *   （这是**外观能力**，不是业务口径，所以可以回退；业务口径如 http 一律不回退）
+ */
+/** 宿主位置（扩展包组件用它区分自己被谁渲染了） */
+export type DesignHostSlot = 'form' | 'page' | 'row-action' | 'table-cell' | 'toolbar';
+export interface DesignHostApi {
+    /** 平台轻提示（loading 返回关闭函数） */
+    message: {
+        error: (msg: string) => void;
+        loading: (content: string) => () => void;
+        success: (msg: string) => void;
+        warning: (msg: string) => void;
+    };
+    /** 平台请求（走注入的 http，返回值已解包成业务数据） */
+    request: (config: {
+        data?: any;
+        method?: string;
+        params?: Record<string, any>;
+        url: string;
+    }) => Promise<any>;
+    /** 仅弹窗类插槽：关闭弹窗 */
+    close?: () => void;
+    /** 仅列表类插槽：刷新当前列表 */
+    reload?: () => void;
+}
+/** 平台请求：POST 带 body，其余按 GET 带 query */
+export declare function hostRequest(config: {
+    data?: any;
+    method?: string;
+    params?: Record<string, any>;
+    url: string;
+}): Promise<any>;
+/**
+ * 平台轻提示：优先注入的 `host.message`（支持宿主主题/ConfigProvider 上下文），
+ * 未注入时回退 antdv-next 的静态 `message`。
+ * 这是**外观能力**，不是业务口径 —— 业务口径（http / 鉴权 / 字典）一律不回落。
+ */
+export declare function platformMessage(): DesignHostApi['message'];
+/** 组装平台能力（`extra` 是插槽专属的可选能力：reload / close） */
+export declare function buildHostApi(extra?: {
+    close?: () => void;
+    reload?: () => void;
+}): DesignHostApi;

package/dist/types/components/design-shared/popup-host.d.ts

@@ -0,0 +1,13 @@
+import type { InjectionKey } from 'vue';
+/**
+ * design 运行时弹层的宿主体系（搬自宿主 `components/design/popup-host.ts`）
+ *
+ * 页面级（独立页/树右区/组合项等）默认用 vben(reka-ui) 弹层（抽屉/弹窗）；
+ * 当列表/树/组合/表单被放进 antd `<Modal>`（弹窗列表/弹窗树/弹窗表单/弹窗组合 动作或工具）
+ * 打开时，容器内再叠 vben 抽屉会与 antd Modal 的焦点管理冲突（点不进表单、Tab 进不去），
+ * 因此容器组件 provide 'antd'，其子树里的 AddTool / EditAction 等改为打开同体系的 antd 弹窗。
+ */
+export type DesignPopupHost = 'antd' | 'vben';
+export declare const DESIGN_POPUP_HOST_KEY: InjectionKey<DesignPopupHost>;
+/** 读取当前弹层宿主（默认 vben） */
+export declare function usePopupHost(defaultHost?: DesignPopupHost): DesignPopupHost;

package/dist/types/components/design-table/design-table-inner.vue.d.ts

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    formOptions?: Record<string, any>;
+    gridOptions?: Record<string, any>;
+    tableTitle?: string;
+};
+declare var __VLS_7: string | number, __VLS_8: any;
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_7>]?: (props: typeof __VLS_8) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    gridApi: any;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/design-table/design-table.vue.d.ts

@@ -0,0 +1,70 @@
+import type { DesignTableTool as TableTool, PlatformTableConfig, RowAction } from '../../types';
+type __VLS_Props = {
+    /** 模块分类 */
+    category?: string;
+    /** 配置名称 */
+    name?: string;
+    /** 直接传入配置（可选，跳过 API 请求） */
+    config?: PlatformTableConfig | null;
+    /**
+     * 上游组件推过来的参数（如树节点参数）；与路由参数合并为组件自身 extraParams。
+     * ⚠ 它只进请求体的 `params`（表达式 env，供配置里 `${params.x}` / 动作条件用），
+     * **不参与 search 过滤**（想按列过滤请在列表上配查询表单字段或 pager 动作条件）。
+     */
+    parentParams?: Record<string, any>;
+    /**
+     * 页面显式传入的查询条件（如 DesignSearch 点「查询」后的值）：
+     * 每次取数时读最新值，作为 `search` 参数下发（见 buildQuerySearch 的优先级说明）。
+     * 与 parentParams/extraParams 分开：它只是取数条件，不参与字段映射、不随保存下发。
+     */
+    search?: Record<string, any>;
+    /** 不使用 Page 包裹 */
+    noPage?: boolean;
+    /** 表格高度（vxe-grid height，如 '100%' 撑满容器滚动；默认 'auto' 跟随内容） */
+    tableHeight?: string;
+    /** dev 悬浮按钮距容器顶部距离(px)；嵌套在其它设计组件内时下移，避免与父组件按钮重叠 */
+    devButtonTop?: number;
+};
+declare function handleDelete(row: Record<string, any>): Promise<void>;
+declare var __VLS_91: string | number, __VLS_92: any, __VLS_164: string | number, __VLS_165: any;
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_91>]?: (props: typeof __VLS_92) => any;
+} & {
+    [K in NonNullable<typeof __VLS_164>]?: (props: typeof __VLS_165) => any;
+};
+declare const __VLS_component: import("vue").DefineComponent<__VLS_Props, {
+    gridApi: any;
+    handleDelete: typeof handleDelete;
+    reload: () => void;
+    /** 开发面板用的状态快照（本库不渲染面板，留给宿主调试台按需读取） */
+    devState: import("vue").ComputedRef<Record<string, any>>;
+    exprScope: import("vue").ComputedRef<Record<string, any>>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    deleted: () => any;
+    "update:title": (title: string) => any;
+    "tool-command": (tool: TableTool) => any;
+    "row-command": (action: RowAction, row: Record<string, any>) => any;
+    loaded: (config: PlatformTableConfig | null) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDeleted?: (() => any) | undefined;
+    "onUpdate:title"?: ((title: string) => any) | undefined;
+    "onTool-command"?: ((tool: TableTool) => any) | undefined;
+    "onRow-command"?: ((action: RowAction, row: Record<string, any>) => any) | undefined;
+    onLoaded?: ((config: PlatformTableConfig | null) => any) | undefined;
+}>, {
+    name: string;
+    config: PlatformTableConfig | null;
+    search: Record<string, any>;
+    category: string;
+    parentParams: Record<string, any>;
+    devButtonTop: number;
+    noPage: boolean;
+    tableHeight: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: __VLS_WithSlots<typeof __VLS_component, __VLS_Slots>;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/components/design-table/row-actions/delete-action.vue.d.ts

@@ -0,0 +1,12 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    gridApi?: any;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    deleted: (row: Record<string, any>) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onDeleted?: ((row: Record<string, any>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/edit-action.vue.d.ts

@@ -0,0 +1,14 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    row: Record<string, any>;
+    category?: string;
+    pfield?: string;
+    gridApi?: any;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    saved: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSaved?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/index.d.ts

@@ -0,0 +1,25 @@
+import type { Component } from 'vue';
+/**
+ * 行操作 `type` → 组件
+ *
+ * ## 为什么用 `defineAsyncComponent` 而不是静态 import + markRaw
+ *
+ * 行操作与设计组件本身是**相互引用**的：`design-table.vue` 渲染行操作，而
+ * `modal-table-action` 又要渲染 `design-table.vue`（`modal-tree` / `modal-combo` 同理）。
+ * 静态 import + 模块顶层 `markRaw(Comp)` 会在 ESM 初始化阶段就去读那个还没初始化的绑定，
+ * 实测直接抛 `ReferenceError: Cannot access '_sfc_main$8' before initialization`。
+ *
+ * 改成懒加载后：① 没有初始化顺序问题；② 每个动作单独成 chunk，表格不打开弹窗就不加载；
+ * ③ 与自定义组件注册表（`src/registry.ts`）同一套「懒加载 + 异步包装」思路。
+ *
+ * ## 未知 type 的处理
+ *
+ * {@link resolveRowActionComponent} 对未知 type **warn 一次**并返回 undefined，
+ * 调用方据此降级（不要静默渲染成空按钮）。
+ */
+export declare const rowActionComponentMap: Record<string, Component>;
+/** 尚未迁移的行操作类型（现已全部迁入，保留空数组以兼容调用方的判断逻辑） */
+export declare const pendingRowActionTypes: string[];
+/** 按 type 取行操作组件；未知类型 warn 一次并返回 undefined */
+export declare function resolveRowActionComponent(type?: string): Component | undefined;
+export declare const rowActionTypes: string[];

package/dist/types/components/design-table/row-actions/modal-comb-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/modal-custom-action.vue.d.ts

@@ -0,0 +1,15 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    gridApi?: any;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    saved: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSaved?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/modal-form-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/modal-table-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/modal-tree-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/navigate-comb-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-table/row-actions/navigate-form-action.vue.d.ts

@@ -0,0 +1,10 @@
+import type { RowAction } from '../../../types';
+type __VLS_Props = {
+    action: RowAction;
+    category?: string;
+    params?: Record<string, any>;
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;