@jzg223/design-runtime 0.0.0-stage → 0.0.1

package/dist/types/components/design-table/row-actions/navigate-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/navigate-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/other-action.vue.d.ts

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

package/dist/types/components/design-tools/add-tool.vue.d.ts

@@ -0,0 +1,23 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    gridApi?: any;
+    /** 表格注入的额外参数（如树节点过滤字段），作为表单初始值预填 */
+    extraParams?: Record<string, any>;
+    /**
+     * 字段映射表达式作用域：由宿主视图注入，键即表达式可引用的数据源。
+     * 如列表 { params }、树形 { node, params }、表单/组合 { params, data }。
+     * 表达式示例：params.deptId、node.deptId、data.id
+     */
+    mappingScope?: Record<string, any>;
+};
+declare function open(): Promise<void>;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof open;
+}, {}, {}, {}, 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-tools/command-executor.d.ts

@@ -0,0 +1,80 @@
+import type { DesignTableTool, RowAction } from '../../types';
+/**
+ * 执行后台配置的 JS 脚本（搬自宿主 `design-tools/src/command-executor.ts`）
+ *
+ * 脚本内可直接访问：
+ * - `row`    当前行数据（工具栏操作时为 {}）
+ * - `action` 触发的 action/tool 配置
+ * - `ctx`    完整上下文（含 gridApi / category / pfield）
+ * - `api`    内置 helper（openUrl / navigate / openComponent / openDialog / refresh / message / confirm）
+ *
+ * ## 迁移时改的四处（都是「宿主能力不能 import」）
+ *
+ * 1. `~~#~~/router` 的 `router` → **上下文里的 `nav`**：组件用 `useRouter()` 拿到后传进来
+ *    （vue-router 是 peer，组件里直接用是合法的；而本文件不是组件，拿不到 `useRouter()`，
+ *    所以由调用方注入，避免为它再造一个全局单例）。
+ * 2. `window.message` / `window.modal` → `host.message` / `host.modal` 注入；
+ *    缺失时不静默：warn 一次并说明怎么注入。
+ * 3. `openComponent('/src/views/x.vue')` 的**源码路径动态加载**（`import.meta.glob('/src/**')`）→
+ *    **comname 注册表**（`resolveDesignComponent`）。旧的路径式解析把配置绑死在宿主源码结构上，
+ *    一重构就全废（该方案已废弃，见 README 设计约束）。
+ * 4. `loadRemoteComponent`（UMD 清单）→ **删除**：宿主项目已全面退役 UMD 那套
+ *    （`public/ext/`、`window.__HCM_UI__`、`window.__HCM_FIELDS__` 均已删，见 TODO P1-15）。
+ */
+/** 路由跳转能力（调用方把 `useRouter()` 的结果传进来） */
+export interface CommandNav {
+    push: (to: any) => any;
+    replace?: (to: any) => any;
+}
+/** 命令执行上下文 */
+export interface CommandContext {
+    /** 触发的 action / tool 配置 */
+    action: DesignTableTool | RowAction;
+    /** 模块分类 */
+    category?: string;
+    /** 表格 grid API */
+    gridApi?: any;
+    /** 路由跳转能力（组件内 `useRouter()` 传入） */
+    nav?: CommandNav;
+    /** 主键字段名 */
+    pfield?: string;
+    /** 当前行数据（行操作有值，工具栏操作无） */
+    row?: Record<string, any>;
+}
+/** 脚本内可用的辅助函数（由调用方按需注入） */
+export interface CommandHelpers {
+    [key: string]: any;
+}
+/** openComponent 的渲染选项 */
+export interface OpenComponentOptions {
+    /** 组件事件监听（如 `{ saved: fn }`） */
+    on?: Record<string, Function>;
+    /** 传入组件的 props */
+    props?: Record<string, any>;
+    /** 弹窗标题 */
+    title?: string;
+    /** 弹窗宽度 */
+    width?: number | string;
+}
+/**
+ * 动态加载组件并在 Modal 中渲染。
+ *
+ * `comname` 必须是宿主注册过的名字（`registerComponents({...})`），
+ * 与配置里的自定义组件是同一套名字 —— 写错会抛带 comname 的明确错误。
+ */
+export declare function openComponent(comname: string, opts?: OpenComponentOptions): Promise<{
+    close: () => void;
+}>;
+/**
+ * 执行后台配置的 JS 脚本（函数体）。
+ *
+ * 示例脚本：
+ * ```js
+ * openComponent('employee-select', { props: { id: row.id }, title: row.name });
+ * api.openUrl('/detail?id=' + row.id);
+ * api.navigate('/detail?id=' + row.id);
+ * api.navigate({ path: '/detail', query: { id: row.id } }, { replace: true });
+ * api.message.success('已处理 ' + row.name);
+ * ```
+ */
+export declare function executeCommand(command: string | undefined, context: CommandContext, helpers?: CommandHelpers): Promise<any>;

package/dist/types/components/design-tools/export-tool.vue.d.ts

@@ -0,0 +1,9 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+};
+declare function execute(): Promise<void>;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof execute;
+}, {}, {}, {}, 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-tools/import-tool.vue.d.ts

@@ -0,0 +1,14 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    gridApi?: any;
+};
+declare function open(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof open;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    imported: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onImported?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/design-tools/index.d.ts

@@ -0,0 +1,23 @@
+import type { Component } from 'vue';
+/**
+ * 工具条 `type` → 组件
+ *
+ * ## 为什么是 `defineAsyncComponent`（和 row-actions 同一个原因）
+ *
+ * 工具与设计组件互相引用：`design-table.vue` 渲染工具，而 `modal-table-tool` 又要渲染
+ * `design-table.vue`（`modal-form/comb/tree` 与 `add` 同理）。静态 import + 模块顶层
+ * `markRaw(Comp)` 会在 ESM 初始化阶段去读还没初始化的绑定，实测抛
+ * `ReferenceError: Cannot access '_sfc_main$N' before initialization`。
+ *
+ * 懒加载后：① 无初始化顺序问题；② 每个工具单独成 chunk，不点就不加载；
+ * ③ 与本库的 comname 注册表、行操作表同一套思路。
+ *
+ * 2026-10-27：**12 个全部迁入**。
+ */
+export declare const toolComponentMap: Record<string, Component>;
+/** 尚未迁移的工具类型（现已全部迁入，保留空数组以兼容调用方的判断逻辑） */
+export declare const pendingToolTypes: string[];
+/** 已迁入的工具类型（顺序稳定，便于诊断页/文档使用） */
+export declare const toolTypes: string[];
+/** 按 type 取工具组件；未知类型 warn 一次并返回 undefined */
+export declare function resolveToolComponent(type?: string): Component | undefined;

package/dist/types/components/design-tools/modal-comb-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }） */
+    mappingScope?: Record<string, any>;
+};
+declare function trigger(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof trigger;
+}, {}, {}, {}, 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-tools/modal-form-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }） */
+    mappingScope?: Record<string, any>;
+};
+declare function trigger(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof trigger;
+}, {}, {}, {}, 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-tools/modal-hcm-tool.vue.d.ts

@@ -0,0 +1,23 @@
+import type { DesignTableTool as TableTool } from '../../types';
+/**
+ * 工具条「自定义组件」(type='hcm-tool'，2026-10-21)
+ *
+ * 按钮由宿主工具条渲染（和 modal-form 等一致，组件本身无 UI），点击 `trigger()` 打开 antd Modal，
+ * 里面渲染业务组件（宿主 `src/components/hcm/` 里的那些，按 `tool.comname` 解析注册表）。
+ *
+ * 组件拿到：`cell`（工具项配置）、`rows`（当前选中行）、`params`、`api{request,message,reload,close}`。
+ * 组件名没配/没注册 → 回退占位框 + warn，弹窗不炸。
+ */
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    /** 表达式/参数作用域（宿主视图注入，如 { params }） */
+    mappingScope?: Record<string, any>;
+    /** vxe grid（取选中行 + 刷新列表用） */
+    gridApi?: any;
+};
+declare function trigger(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof trigger;
+}, {}, {}, {}, 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-tools/modal-table-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }）；结果作为目标列表 parentParams */
+    mappingScope?: Record<string, any>;
+};
+declare function trigger(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof trigger;
+}, {}, {}, {}, 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-tools/modal-tree-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool as TableTool } from '../../types';
+type __VLS_Props = {
+    tool: TableTool;
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }）；结果作为目标树形视图 parentParams */
+    mappingScope?: Record<string, any>;
+};
+declare function trigger(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof trigger;
+}, {}, {}, {}, 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-tools/navigate-comb-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool } from '../../types';
+type __VLS_Props = {
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }）；跳转 query = mappings 求值结果 + expressId 作为 id */
+    mappingScope?: Record<string, any>;
+    tool: DesignTableTool;
+};
+declare function execute(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof execute;
+}, {}, {}, {}, 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-tools/navigate-form-tool.vue.d.ts

@@ -0,0 +1,11 @@
+import type { DesignTableTool } from '../../types';
+type __VLS_Props = {
+    category?: string;
+    mappingScope?: Record<string, any>;
+    tool: DesignTableTool;
+};
+declare function execute(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof execute;
+}, {}, {}, {}, 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-tools/navigate-table-tool.vue.d.ts

@@ -0,0 +1,12 @@
+import type { DesignTableTool } from '../../types';
+type __VLS_Props = {
+    category?: string;
+    /** 映射表达式作用域（由宿主视图注入，如 { params }）；跳转 query = mappings 求值结果 */
+    mappingScope?: Record<string, any>;
+    tool: DesignTableTool;
+};
+declare function execute(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof execute;
+}, {}, {}, {}, 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-tools/other-tool.vue.d.ts

@@ -0,0 +1,16 @@
+import type { DesignTableTool } from '../../types';
+type __VLS_Props = {
+    category?: string;
+    gridApi?: any;
+    pfield?: string;
+    tool: DesignTableTool;
+};
+declare function execute(): void;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    trigger: typeof execute;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    command: (tool: DesignTableTool) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onCommand?: ((tool: DesignTableTool) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/flow-status-cell/flow-status-cell.vue.d.ts

@@ -0,0 +1,14 @@
+import type { DesignFlowStatusVo } from '../../flow';
+type __VLS_Props = {
+    /** 流程状态映射: businessId → 状态行 */
+    flowMap?: Record<string, DesignFlowStatusVo>;
+    /** 主键字段名（取 businessId 用） */
+    pfield?: string;
+    row: Record<string, any>;
+};
+declare const _default: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    changed: () => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onChanged?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/types/components/index.d.ts

@@ -0,0 +1,33 @@
+/** 组件集中导出（每个组件一个文件，便于 tree-shaking 与后续按需引入） */
+export { default as ApiSwitch } from './ApiSwitch.vue';
+export { default as DesignTable } from './design-table/design-table.vue';
+export { default as DesignTableInner } from './design-table/design-table-inner.vue';
+export { default as DesignTableFlowStatusCell } from './flow-status-cell/flow-status-cell.vue';
+/**
+ * 调试台（开发模式）：`dev-state-button` + `dev-mode-toggle` + `dev-mode` + `expr-eval`。
+ * 设计组件模板里自带 `<DesignDevStateButton>`，由 `?dev=1` 或 localStorage 打开（默认零渲染）。
+ */
+export { default as DesignDevModeToggle } from './design-debug/dev-mode-toggle.vue';
+export { default as DesignDevStateButton } from './design-debug/dev-state-button.vue';
+export { setDevMode, useDevMode } from './design-debug/dev-mode';
+export { evalExpression } from './design-debug/expr-eval';
+export { default as DesignComb } from '../comb/design-comb.vue';
+export { default as DesignSearch } from '../search/design-search.vue';
+export { default as DesignTree } from '../tree/design-tree.vue';
+export { default as DesignForm } from '../form/design-form.vue';
+export { default as DesignFormInner } from '../form/design-form-inner.vue';
+/**
+ * 设计组件之间的共用件（不是组件本体）：
+ * - `buildHostApi` / `hostRequest`：交给业务自定义组件的平台能力（见文件头说明）
+ * - `usePopupHost` / `DESIGN_POPUP_HOST_KEY`：弹层体系切换（vben 抽屉 ↔ antd 弹窗）
+ */
+export { buildHostApi, hostRequest, platformMessage } from './design-shared/host-api';
+export type { DesignHostApi, DesignHostSlot } from './design-shared/host-api';
+/** 工具条（design-tools）：12 种全部迁入，按 type 懒加载 */
+export { pendingToolTypes, resolveToolComponent, toolComponentMap, toolTypes, } from './design-tools';
+export { executeCommand, openComponent } from './design-tools/command-executor';
+export type { CommandContext, CommandHelpers, CommandNav, OpenComponentOptions, } from './design-tools/command-executor';
+export { DESIGN_POPUP_HOST_KEY, usePopupHost } from './design-shared/popup-host';
+export type { DesignPopupHost } from './design-shared/popup-host';
+/** 行操作（design-table）：12 个类型全部迁入，按 type 懒加载 */
+export { pendingRowActionTypes, resolveRowActionComponent, rowActionComponentMap, rowActionTypes, } from './design-table/row-actions';

package/dist/types/flow.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 低代码业务-流程关联（`design_flow_data`）运行时接口
+ * 后端: `org.dromara.design.controller.DesignFlowDataController`（`/design/flowData/*`）
+ *
+ * 与宿主 `components/design/flow-api.ts` 对齐，只把 alova 换成注入的 http。
+ *
+ * 静默口径：`designFlowStatus` 是**列表每次取数后都要批量调**的读接口（并发多条），
+ * 必须 `silent: true`；`submit` / `remove` 是用户点出来的动作，走宿主的默认提示。
+ */
+/** 发起流程参数 */
+export interface DesignFlowSubmitParams {
+    /** 业务归属（运行时业务表 code，与列表取状态同口径） */
+    businessType: string;
+    /** 业务行主键 */
+    businessId: number | string;
+    /** 流程定义编码 */
+    flowCode: string;
+    /** 冗余业务标题（可选） */
+    businessTitle?: string;
+    /** 流程变量（建议含 __designMeta / entity / 条件字段） */
+    variables?: Record<string, any>;
+}
+/** 发起流程返回: Warm-Flow 实例 id + 首个（申请人）任务 id */
+export interface DesignFlowStartResult {
+    processInstanceId: number | string;
+    taskId: number | string;
+}
+/** 流程状态行（列表合并展示） */
+export interface DesignFlowStatusVo {
+    businessId: string;
+    flowCode?: string;
+    instanceId?: number | string;
+    businessTitle?: string;
+    /** draft / waiting / finish / back / cancel / invalid / termination */
+    status?: string;
+    statusName?: string;
+    startTime?: string;
+    finishTime?: string;
+}
+/** 批量状态 / 删除入参 */
+export interface DesignFlowQueryParams {
+    businessType: string;
+    businessIds: Array<number | string>;
+}
+/** 发起流程: 校验 → Warm-Flow 启动 → 写 flow_data(waiting) */
+export declare function designFlowSubmit(body: DesignFlowSubmitParams): Promise<DesignFlowStartResult>;
+/** 批量查询业务行流程状态（读接口，一页一次，必须静默） */
+export declare function designFlowStatus(body: DesignFlowQueryParams): Promise<DesignFlowStatusVo[]>;
+/** 删除业务行前的流程关联清理（审批中会被后端拒绝） */
+export declare function designFlowRemove(body: DesignFlowQueryParams): Promise<void>;

package/dist/types/form/cell-condition.d.ts

@@ -0,0 +1,35 @@
+import type { PlatformFormCell } from '../types';
+/** 作用域键能否注入表达式 */
+export declare function isInjectableScopeKey(key: string): boolean;
+/**
+ * 条件表达式作用域：**只有派生字段值**（裸名 + `derivedValues` 对象）。
+ * 注意 `derivedValues` 放在最后：若某个派生字段正好叫 `derivedValues`，以对象本身为准（不被它覆盖）。
+ */
+export declare function buildConditionScope(derivedValues: Record<string, any> | undefined): Record<string, any>;
+/** 条件求值结果 */
+export interface CellConditionResult {
+    /** 渲染条件（vif）是否通过：true = 渲染。未配置 → true */
+    render: boolean;
+    /** 显示条件（vshow）是否通过：true = 显示。未配置 → true */
+    show: boolean;
+    /** 表达式求值异常信息（异常按「不隐藏」处理，这里留痕给告警与开发面板） */
+    error?: string;
+}
+/** 单个 cell 的条件求值结果（未配任何条件 → 全部通过） */
+export declare function evalCellCondition(cell: PlatformFormCell | undefined, scope: Record<string, any>): CellConditionResult;
+/** 是否被条件隐藏（渲染条件为假 或 显示条件为假）—— 校验跳过、必填底色等都用它 */
+export declare function isConditionHidden(result: CellConditionResult): boolean;
+/** 开发面板里的一行：一个配了条件的单元格「到底算成什么」 */
+export interface CellConditionDebugItem {
+    row: number;
+    col: number;
+    name?: string;
+    title?: string;
+    vif?: string;
+    vshow?: string;
+    render: boolean;
+    show: boolean;
+    error?: string;
+}
+/** 只收「配了 vif/vshow 的格」的条件求值快照（开发面板用；没配条件的格不进快照，避免噪声） */
+export declare function computeConditionDebug(cells: PlatformFormCell[] | undefined, scope: Record<string, any>): CellConditionDebugItem[];

package/dist/types/form/derived-express.d.ts

@@ -0,0 +1,28 @@
+import type { PlatformFormCell } from '../types';
+/**
+ * 「派生取值表达式」（cell.derivedExpress）的求值内核（纯函数，便于单测 —— 见 __tests__/derived-express.test.ts）。
+ *
+ * 派生字段是**表单级变量空间**，与具体输入项没有绑定关系：
+ *   输入项 → 派生字段：`deriveTo`（选中/输入后把值赋给派生字段）
+ *   派生字段 → 输入项：`dictFilter`（下拉按派生值过滤选项）、`derivedExpress`（监听派生值并回填本格）
+ * 典型用例：表单声明 `idCard` / `birthDate` 两个变量，身份证输入项把值赋给 `idCard`，
+ * 出生日期输入项用 `derivedExpress` 从 `idCard` 提取出生日期回填自己。
+ *
+ * 求值口径与工具条字段映射（design-tools/mapping.ts）**完全一致**：`new Function(...作用域键, 'return (表达式)')`。
+ */
+/** 表达式作用域：表单值 + 派生值裸名（同名时**派生值覆盖**，与 dictFilter 的 data 口径一致），另给两个对象 */
+export declare function buildDerivedScope(formData: Record<string, any>, derivedValues: Record<string, any>): Record<string, any>;
+/**
+ * 单个 cell 的应回填值。
+ * 返回 undefined 表示「不动本格」：未配表达式、求值抛错、或结果本身是 null/undefined。
+ * 注意：显式返回 ''（如 `idCard ? 提取 : ''`）属于有效结果，会清空本格。
+ */
+export declare function evalDerivedExpress(cell: PlatformFormCell | undefined, formData: Record<string, any>, derivedValues: Record<string, any>): any;
+/**
+ * 需要回填的 `{name, value}` 列表：只收「配了表达式 + 有 name + 值确实变了」的 cell。
+ * 已相等（含 '' 与 undefined 归一相等）的跳过 —— 既避免无意义回写，也避免派生值→回填→派生值 的重复触发。
+ */
+export declare function computeDerivedFills(cells: PlatformFormCell[] | undefined, formData: Record<string, any>, derivedValues: Record<string, any>): Array<{
+    name: string;
+    value: any;
+}>;

package/dist/types/form/design-form-inner.vue.d.ts

@@ -0,0 +1,55 @@
+import type { CellConditionDebugItem } from './cell-condition';
+import type { FormGridConfig } from './transformer';
+type __VLS_Props = {
+    gridConfig?: FormGridConfig;
+    labelWidth?: number;
+    source?: Record<string, any>;
+    /** 表单主键字段名（内嵌列表 embedded-list 激活判定用） */
+    pfield?: string;
+    /** 表单外部参数（路由/上游 parentParams；内嵌列表关系映射的 params 作用域） */
+    extraParams?: Record<string, any>;
+    /** 表单所在模块（内嵌列表未存 module 时的兜底） */
+    category?: string;
+};
+/** 本格是否被条件隐藏（渲染条件为假 或 显示条件为假）：隐藏格跳过必填/正则校验（隐藏=无需填写） */
+declare function isCellHidden(cell: {
+    row: number;
+    col: number;
+}): boolean;
+/** 提交值：用户录入 + persist=true 的派生字段 */
+declare function getSubmitValues(): Record<string, any>;
+declare const _default: import("vue").DefineComponent<__VLS_Props, {
+    formApi: {
+        getValues: typeof getSubmitValues;
+        setValues: (values: Record<string, any>) => void;
+        resetForm: () => void;
+        form: {
+            values: Record<string, any>;
+        };
+        /** 派生字段值空间（开发模式调试用） */
+        derivedValues: Record<string, any>;
+    };
+    isCellHidden: typeof isCellHidden;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "data-change": (data: Record<string, any>) => any;
+    "derived-change": (snapshot: Record<string, any>) => any;
+    "condition-change": (snapshot: {
+        scope: Record<string, any>;
+        items: CellConditionDebugItem[];
+    }) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onData-change"?: ((data: Record<string, any>) => any) | undefined;
+    "onDerived-change"?: ((snapshot: Record<string, any>) => any) | undefined;
+    "onCondition-change"?: ((snapshot: {
+        scope: Record<string, any>;
+        items: CellConditionDebugItem[];
+    }) => any) | undefined;
+}>, {
+    source: Record<string, any>;
+    labelWidth: number;
+    category: string;
+    pfield: string;
+    extraParams: Record<string, any>;
+    gridConfig: FormGridConfig;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+export default _default;