@daxiangme/form-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,1679 @@
+/** 将勾选字段的默认值作为一个文档变更写入。 */
+export declare function applyDesignerBatchDefaults(document: DesignerDocument, values: Record<string, unknown>): number;
+
+/**
+ * 将指定外观维度批量恢复为继承表单默认值。
+ *
+ * @returns 实际发生配置变化的容器数量。
+ */
+export declare function applyDesignerContainerAppearanceInheritance(document: DesignerDocument, dimensions: readonly DesignerContainerAppearanceDimension[]): number;
+
+/** 按依赖拓扑执行一个子实体当前行的计算规则，并把结果写回该行值副本。 */
+export declare function applyDesignerCurrentRowValueRules(document: DesignerDocument, rowValues: Record<string, unknown>, entityCode: string, runtime: Omit<DesignerExpressionRuntimeContext, 'currentRow'>, options?: {
+    phase?: 'INITIALIZE' | 'CHANGE';
+    changedFieldIds?: Iterable<string>;
+    confirmationAdapter?: DesignerLinkageConfirmationAdapter;
+}): Promise<string[]>;
+
+/** 将预览中的直接字段设为统一 PC 跨度并清零偏移；移动布局保持不变。 */
+export declare function applyDesignerQuickGrid(document: DesignerDocument, selectedNodeId: string, span: 24 | 12 | 8 | 6): number;
+
+/** 按依赖拓扑执行字段计算与联动，并直接更新当前运行值副本。 */
+export declare function applyDesignerValueRules(document: DesignerDocument, valueStore: DesignerRuntimeValueStore, runtime: Omit<DesignerExpressionRuntimeContext, 'fields'>, options?: {
+    phase?: 'INITIALIZE' | 'CHANGE';
+    changedFieldIds?: Iterable<string>;
+    confirmationAdapter?: DesignerLinkageConfirmationAdapter;
+}): Promise<string[]>;
+
+/**
+ * 判断现有节点是否可以进入指定容器。
+ *
+ * @param nodes 当前完整布局树。
+ * @param nodeId 被移动节点标识。
+ * @param targetContainerId 目标容器标识；根布局传空值。
+ * @returns 不会形成自身后代循环时返回 `true`。
+ */
+export declare function canMoveDesignerNode(nodes: DesignerLayoutNode[], nodeId: string, targetContainerId: string | null): boolean;
+
+/** 使用 JSON 往返克隆设计文档，确保 Core 状态不携带 Vue 代理。 */
+export declare function cloneDesignerDocument(document: DesignerDocument): DesignerDocument;
+
+/**
+ * 深复制一条子表行并分配新身份，避免复制后的字段值与源行共享可变引用。
+ *
+ * @param source 源子表行。
+ * @returns 可独立编辑的新子表行。
+ */
+export declare function cloneDesignerSubtableRow(source: DesignerSubtableRow): DesignerSubtableRow;
+
+/** 返回允许批量设置默认值的语义字段。 */
+export declare function collectDesignerBatchDefaultFields(document: DesignerDocument): DesignerField[];
+
+/** 收集表达式直接读取的字段主键。 */
+export declare function collectDesignerExpressionFieldIds(expression: DesignerExpression): Set<string>;
+
+/** 返回当前文档已经放置到布局中的字段主键。 */
+export declare function collectPlacedFieldIds(nodes: DesignerLayoutNode[]): Set<string>;
+
+/** 收集已经在画布中放置的一级子表关系编码。 */
+export declare function collectPlacedRelationCodes(nodes: DesignerLayoutNode[]): Set<string>;
+
+/** 按语义类型返回允许切换的字段组件。 */
+export declare function compatibleDesignerComponents(semanticType: DesignerSemanticType): DesignerComponentRegistration[];
+
+/** 统计当前文档中支持表面外观的显式容器数量。 */
+export declare function countDesignerSurfaceContainers(document: DesignerDocument): number;
+
+/** 创建字段高级行为默认值。 */
+export declare function createDefaultDesignerFieldBehavior(): DesignerFieldBehavior;
+
+/** 创建首次打开时用于产品验收的扁平栅格示例。 */
+export declare function createDemoDesignerDocument(documentId: string): DesignerDocument;
+
+/** 为根字段、模块字段或子表行生成互不冲突的反馈键。 */
+export declare function createDesignerFieldFeedbackKey(fieldId: string, context?: {
+    viewCode?: string;
+    containerId?: string;
+    rowId?: string;
+}): string;
+
+/** 生成 Core 内部唯一标识；结果不承担数据库主键语义。 */
+export declare function createDesignerId(prefix: string): string;
+
+/** 将布局树投影成大纲数据。 */
+export declare function createDesignerOutline(document: DesignerDocument): DesignerOutlineItem[];
+
+/** 创建一个空弹层模块。 */
+export declare function createDesignerOverlayModule(document: DesignerDocument, kind: DesignerOverlayModule['kind']): DesignerOverlayModule;
+
+/** 为尚未放置的一级关系创建行子表或块子表容器。 */
+export declare function createDesignerRelationContainer(document: DesignerDocument, relationCode: string, componentType: 'row-subtable' | 'block-subtable'): DesignerContainerNode | undefined;
+
+/** 创建合法且可立即编辑的字段状态规则。 */
+export declare function createDesignerStateRule(document: DesignerDocument, field: DesignerField): DesignerFieldStateRule;
+
+/**
+ * 为子表所有呈现模式生成同一个列模板和最小宽度。
+ *
+ * @param columns 稳定列投影。
+ * @param options 序号列、操作列及其宽度配置。
+ * @returns 可直接绑定到表格滚动内容和每一行的布局参数。
+ */
+export declare function createDesignerSubtableGridLayout(columns: readonly DesignerSubtableColumn[], options?: DesignerSubtableGridOptions): DesignerSubtableGridLayout;
+
+/**
+ * 按当前列结构创建一条只存在于预览副本中的空白子表行。
+ *
+ * @param columns 当前子表列投影。
+ * @param seedValues 可选初始值；未声明列不会被擅自写入。
+ * @returns 具有全新行身份和值容器的子表行。
+ */
+export declare function createDesignerSubtableRow(columns: readonly DesignerSubtableColumn[], seedValues?: Readonly<Record<string, unknown>>): DesignerSubtableRow;
+
+/** 创建当前类型的严格验证规则默认值。 */
+export declare function createDesignerValidationRule(type: DesignerValidationRuleType, document: DesignerDocument, field: DesignerField, sequence: number): DesignerValidationRule;
+
+/** 创建公式或联动默认规则；联动显式携带覆盖策略。 */
+export declare function createDesignerValueRule(mode?: DesignerFieldValueRule['mode']): DesignerFieldValueRule;
+
+/** 创建一份不含业务绑定的空设计文档。 */
+export declare function createEmptyDesignerDocument(documentId: string, name?: string): DesignerDocument;
+
+/** 创建只包含本地主实体的数据模型目录。 */
+export declare function createLocalDesignerDataSchema(name: string): DesignerDocument['dataSchema'];
+
+/** 根据注册项原子创建本地字段或容器节点。 */
+export declare function createNodeFromComponent(document: DesignerDocument, componentType: string, overrides?: {
+    label?: string;
+    configuration?: Record<string, unknown>;
+    entityCode?: string;
+}): DesignerLayoutNode | undefined;
+
+/** 对未知输入进行解码和完整结构诊断。 */
+export declare function decodeDesignerDocument(source: unknown): DesignerDocumentDecodeResult;
+
+/** 新文档默认动作栏：只显示底部右侧提交按钮。 */
+export declare const DEFAULT_DESIGNER_ACTION_BAR: DesignerActionBar;
+
+/** 新旧文档共用的默认提交策略；普通隐藏字段默认仍参与提交。 */
+export declare const DEFAULT_DESIGNER_SUBMIT_POLICY: DesignerSubmitPolicy;
+
+/** 永久删除未放置字段，防止布局中出现悬空引用。 */
+export declare function deleteUnplacedDesignerField(document: DesignerDocument, fieldId: string): boolean;
+
+/** 45 类独立表单组件的完整静态注册表。 */
+export declare const DESIGNER_COMPONENTS: readonly DesignerComponentRegistration[];
+
+/** 数字字段的货币代码；运行时再映射为展示符号。 */
+export declare const DESIGNER_CURRENCY_PRESETS: DesignerPropertyOption[];
+
+/** 设计器文档当前稳定版本。 */
+export declare const DESIGNER_DOCUMENT_VERSION: "1.0";
+
+/** 文件大小预设，单位为 MB。 */
+export declare const DESIGNER_FILE_SIZE_PRESETS: DesignerPropertyOption[];
+
+/** 附件类型编辑器支持的已知扩展名和快捷分组。 */
+export declare const DESIGNER_FILE_TYPE_OPTIONS: Array<{
+    label: string;
+    extensions: string[];
+    group: boolean;
+}>;
+
+/** 属性面板共用的标准字号预设，单位为 px。 */
+export declare const DESIGNER_FONT_SIZE_PRESETS: DesignerPropertyOption[];
+
+/** Core 允许持久化的语义编码格式，不接受数据库表达式或路径。 */
+export declare const DESIGNER_IDENTIFIER_PATTERN: RegExp;
+
+/** 子表初始记录数量预设。 */
+export declare const DESIGNER_INITIAL_COUNT_PRESETS: DesignerPropertyOption[];
+
+/** 文本和意见控件共用的长度预设。 */
+export declare const DESIGNER_LENGTH_PRESETS: DesignerPropertyOption[];
+
+/** 主体视图使用的稳定内部编码。 */
+export declare const DESIGNER_MAIN_VIEW_CODE = "main";
+
+/** 移动端 24 栅格跨度预设。 */
+export declare const DESIGNER_MOBILE_SPAN_PRESETS: DesignerPropertyOption[];
+
+/** 支持 0 表示不限制的多选数量预设。 */
+export declare const DESIGNER_OPTIONAL_SELECTION_COUNT_PRESETS: DesignerPropertyOption[];
+
+/** 子表和引用列表共用的分页数量预设。 */
+export declare const DESIGNER_PAGE_SIZE_PRESETS: DesignerPropertyOption[];
+
+/** PC 端 24 栅格跨度预设。 */
+export declare const DESIGNER_PC_SPAN_PRESETS: DesignerPropertyOption[];
+
+/** 多选控件共用的数量上限预设。 */
+export declare const DESIGNER_SELECTION_COUNT_PRESETS: DesignerPropertyOption[];
+
+/** 属性面板共用的标准间距预设，单位为 px。 */
+export declare const DESIGNER_SPACING_PRESETS: DesignerPropertyOption[];
+
+/** 浏览器定位超时预设，存储值继续使用毫秒。 */
+export declare const DESIGNER_TIMEOUT_PRESETS: DesignerPropertyOption[];
+
+/** Core 仅保存声明式动作引用，不接受自由脚本。 */
+export declare interface DesignerAction {
+    code: string;
+    name: string;
+    handlerType: 'SAVE' | 'RESET' | 'DELETE' | 'PRINT' | 'NAVIGATE';
+    target?: string;
+}
+
+/** 表单运行态动作栏配置。 */
+export declare interface DesignerActionBar {
+    visible: boolean;
+    position: 'TOP' | 'BOTTOM' | 'BOTH';
+    align: 'LEFT' | 'CENTER' | 'RIGHT';
+    buttons: DesignerActionBarButton[];
+}
+
+/** 运行态动作栏中的受控按钮。 */
+export declare interface DesignerActionBarButton {
+    action: 'SUBMIT' | 'RESET' | 'PRINT';
+    label: string;
+    enabled: boolean;
+}
+
+/** 生成动作栏按钮约定使用的稳定词条 key。 */
+export declare function designerActionI18nKey(action: string): string;
+
+/** 表单整体外观配置。 */
+export declare interface DesignerAppearance {
+    labelPosition: 'TOP' | 'LEFT' | 'RIGHT';
+    labelWidth: number;
+    labelSuffix: string;
+    labelAlign: 'LEFT' | 'RIGHT';
+    defaultPlaceholder: string;
+    gridGutter: number;
+    /** 字段栅格的纵向行距，单位为 px，合法范围为 0～64。 */
+    rowGap: number;
+    defaultPcSpan: number;
+    defaultMobileSpan: number;
+    readonlyDisplayMode: 'CONTROL' | 'TEXT';
+    size: 'SMALL' | 'DEFAULT' | 'LARGE';
+    /** 普通字段控件统一使用的圆角；THEME 表示继续跟随系统主题。 */
+    controlRadius: DesignerRadiusPreset;
+    /** 支持表面的显式布局容器在未覆盖时使用的默认样式。 */
+    containerStyle: DesignerContainerStyle;
+    /** 支持表面的显式布局容器在未覆盖时使用的默认圆角。 */
+    containerRadius: DesignerRadiusPreset;
+}
+
+/** 本地字段与未来权威字段来源之间的绑定状态。 */
+export declare type DesignerBindingStatus = 'UNBOUND' | 'BOUND' | 'STALE' | 'INCOMPATIBLE' | 'MISSING';
+
+/** 24 栅格投影中的字段或布局节点单元。 */
+export declare interface DesignerCanvasCell {
+    nodeId: string;
+    index: number;
+    row: number;
+    start: number;
+    span: number;
+}
+
+/** 24 栅格投影中的空白可放置单元。 */
+export declare interface DesignerCanvasGap {
+    index: number;
+    row: number;
+    start: number;
+    span: number;
+}
+
+/** 设计态只读栅格投影，不作为第二份 Schema 持久化。 */
+export declare interface DesignerCanvasProjection {
+    cells: DesignerCanvasCell[];
+    gaps: DesignerCanvasGap[];
+    rowCount: number;
+}
+
+/** 设计器组件在静态 Core 中的能力状态。 */
+export declare type DesignerComponentAvailability = 'AVAILABLE' | 'CONDITIONAL' | 'UNAVAILABLE';
+
+/**
+ * 校验组件目录中的新组件能否放入目标容器。
+ *
+ * @param document 当前设计文档。
+ * @param componentType 待创建的稳定组件编码。
+ * @param target 包含目标容器、命名插槽、索引和可选栅格列的完整落点。
+ * @returns 空字符串表示允许，否则返回可直接展示的拒绝原因。
+ */
+export declare function designerComponentDropRejection(document: DesignerDocument, componentType: string, target: DesignerDropTarget): string;
+
+/** 组件可绑定的运行事件。 */
+export declare type DesignerComponentEvent = 'CHANGE' | 'BLUR' | 'FOCUS' | 'CLICK';
+
+/** 组件面板的稳定分类。 */
+export declare type DesignerComponentGroup = 'LAYOUT' | 'BASIC' | 'ADVANCED' | 'DYNAMIC' | 'SUBTABLE' | 'AUXILIARY';
+
+/** 组件注册项是组件目录、节点工厂、属性和渲染行为的唯一真源。 */
+export declare interface DesignerComponentRegistration {
+    componentType: string;
+    name: string;
+    icon: string;
+    group: DesignerComponentGroup;
+    nodeKind: 'FIELD' | 'CONTAINER';
+    semanticType: DesignerSemanticType;
+    compatibleSemanticTypes: DesignerSemanticType[];
+    configurationVersion: number;
+    defaultConfiguration: Readonly<Record<string, unknown>>;
+    defaultSpan: number;
+    /** 新建节点的外层字段标签默认状态；已有文档继续使用节点自身布局值。 */
+    defaultShowLabel: boolean;
+    /** 详情态外层标签策略；自描述组件可以隐藏重复标签，但不改写布局配置。 */
+    detailLabelPolicy: 'INHERIT' | 'HIDE';
+    /** 只有 SURFACE 容器才允许继承或覆盖表单级容器外观。 */
+    containerAppearance: 'NONE' | 'SURFACE';
+    availability: DesignerComponentAvailability;
+    unavailableReason: string;
+    acceptsChildren: boolean;
+    /** 注册项显式声明可绑定事件；未声明时不显示事件入口。 */
+    supportedEvents?: DesignerComponentEvent[];
+    properties: DesignerPropertyDefinition[];
+}
+
+/** 返回容器表面和圆角对应的公共主题工具类。 */
+export declare function designerContainerAppearanceClasses(resolved: DesignerResolvedContainerAppearance | undefined): string[];
+
+/** 批量恢复容器外观继承时可独立处理的配置维度。 */
+export declare type DesignerContainerAppearanceDimension = 'STYLE' | 'RADIUS';
+
+/** 显式布局或辅助组件节点。 */
+export declare interface DesignerContainerNode {
+    nodeType: 'CONTAINER';
+    id: string;
+    componentType: string;
+    configurationVersion: number;
+    configuration: Record<string, unknown>;
+    layout: DesignerResponsiveGrid;
+    slots: DesignerLayoutSlot[];
+    /** 容器或辅助组件仅保存注册表允许的事件绑定。 */
+    eventBindings?: Partial<Record<DesignerComponentEvent, string>>;
+}
+
+/** 容器节点对表单默认圆角的覆盖值。 */
+export declare type DesignerContainerRadiusOverride = 'INHERIT' | DesignerRadiusPreset;
+
+/** 表单显式布局容器允许使用的表面样式。 */
+export declare type DesignerContainerStyle = 'NONE' | 'BORDERED' | 'SHADOW';
+
+/** 容器节点对表单默认表面样式的覆盖值。 */
+export declare type DesignerContainerStyleOverride = 'INHERIT' | DesignerContainerStyle | 'FILLED';
+
+/** 返回字段控件圆角对应的公共主题工具类。 */
+export declare function designerControlRadiusClass(radius: DesignerRadiusPreset): string;
+
+/** 设计文档中的语义实体身份。 */
+export declare interface DesignerDataEntity {
+    id: string;
+    code: string;
+    name: string;
+}
+
+/** 首次参数初始化和来源索引构建的结果。 */
+export declare interface DesignerDataModelPreparation {
+    document: DesignerDocument;
+    sourceMetadata: DesignerSourceMetadataIndex;
+    diagnostics: DesignerDiagnostic[];
+    initialized: boolean;
+}
+
+/** 设计文档保存的外部数据模型身份；不包含物理表、物理列或键映射。 */
+export declare interface DesignerDataModelSource {
+    provider: string;
+    sourceId: string;
+    sourceRevision?: number;
+}
+
+/** 文档内持久化的数据模型目录。 */
+export declare interface DesignerDataSchema {
+    source?: DesignerDataModelSource;
+    rootEntity: DesignerDataEntity;
+    relations: DesignerOneToManyRelation[];
+    fields: DesignerField[];
+}
+
+/** 受控数据源运行 Adapter。 */
+export declare interface DesignerDataSourceAdapter {
+    execute: (definition: DesignerDataSourceDefinition, input: Record<string, unknown>) => Promise<Record<string, unknown>>;
+}
+
+/** Core 只保存稳定来源身份和映射，不保存 URL、SQL、请求头或凭据。 */
+export declare interface DesignerDataSourceDefinition {
+    id: string;
+    code: string;
+    name: string;
+    provider: string;
+    sourceId: string;
+    sourceRevision?: number;
+    inputMappings: DesignerDataSourceMapping[];
+    outputMappings: DesignerDataSourceMapping[];
+}
+
+/** 数据源输入或输出映射。 */
+export declare interface DesignerDataSourceMapping {
+    source: string;
+    target: string;
+}
+
+/**
+ * 根据日期组件的当前语义返回合法显示格式。
+ *
+ * @param sourceValue 日期类型或日期范围类型。
+ * @returns 可供属性编辑器展示的受控格式。
+ */
+export declare function designerDateFormatOptions(sourceValue: unknown): DesignerPropertyOption[];
+
+/** 设计器当前设备。移动端只复用同一份 Schema。 */
+export declare type DesignerDevice = 'desktop' | 'mobile';
+
+/** 单端 24 栅格配置。 */
+export declare interface DesignerDeviceGrid {
+    span: number;
+    offset: number;
+    showLabel: boolean;
+    labelPosition: 'INHERIT' | 'TOP' | 'LEFT' | 'RIGHT';
+}
+
+/** 设计文档的可定位诊断。 */
+export declare interface DesignerDiagnostic {
+    severity: DesignerDiagnosticSeverity;
+    code: string;
+    message: string;
+    path: string;
+}
+
+/** 文档诊断级别。 */
+export declare type DesignerDiagnosticSeverity = 'ERROR' | 'WARNING';
+
+/** 返回弹窗外壳圆角对应的公共主题工具类；旧内存态缺省时继续跟随系统。 */
+export declare function designerDialogRadiusClass(radius: DesignerRadiusPreset | undefined): string;
+
+/** 独立设计器完整文档。 */
+export declare interface DesignerDocument {
+    documentVersion: typeof DESIGNER_DOCUMENT_VERSION;
+    id: string;
+    name: string;
+    description: string;
+    dataSchema: DesignerDataSchema;
+    uiSchema: DesignerUiSchema;
+    appearance: DesignerAppearance;
+    submitPolicy: DesignerSubmitPolicy;
+    actionBar: DesignerActionBar;
+    variables: DesignerVariableDefinition[];
+    dataSources: DesignerDataSourceDefinition[];
+    eventFlows: DesignerEventFlow[];
+    i18n: DesignerI18nConfiguration;
+    actions: DesignerAction[];
+    extensions: Record<string, unknown>;
+}
+
+/** 文档解码结果。错误诊断存在时不返回文档。 */
+export declare interface DesignerDocumentDecodeResult {
+    document?: DesignerDocument;
+    diagnostics: DesignerDiagnostic[];
+}
+
+/** 设计态拖放会话；该状态只服务当前交互，不进入设计文档。 */
+export declare interface DesignerDragSession {
+    active: boolean;
+    source: 'PALETTE' | 'CANVAS' | null;
+    sourceNodeId: string;
+    target?: DesignerDropTarget;
+    accepted: boolean;
+    rejectionReason: string;
+}
+
+/** 画布中可接收新节点的稳定目标。 */
+export declare interface DesignerDropTarget {
+    containerId: string | null;
+    slotCode: string;
+    index: number;
+    placement?: 'BEFORE' | 'AFTER' | 'INSIDE' | 'GRID';
+    columnStart?: number;
+}
+
+/** 事件动作目录项的运行能力状态。 */
+export declare interface DesignerEventActionAvailability {
+    type: DesignerEventActionType;
+    available: boolean;
+    unavailableReason: string;
+}
+
+/** 引导式事件流中的单个动作。 */
+export declare interface DesignerEventActionStep {
+    id: string;
+    stepType: 'ACTION';
+    name: string;
+    actionType: DesignerEventActionType;
+    configuration: Record<string, unknown>;
+    guard?: DesignerExpression;
+    guardFailure: 'SKIP' | 'BLOCK';
+    onError: DesignerEventErrorPolicy;
+}
+
+/** 声明式动作步骤类型。 */
+export declare type DesignerEventActionType = 'SET_FIELD' | 'CLEAR_FIELD' | 'COPY_FIELD' | 'SET_VARIABLE' | 'VALIDATE' | 'SUBMIT' | 'RESET' | 'PRINT' | 'MESSAGE' | 'OPEN_MODULE' | 'CONFIRM_MODULE' | 'CANCEL_MODULE' | 'NAVIGATE_RESOURCE' | 'REFRESH_DATA_SOURCE' | 'HOST_ACTION';
+
+/** 条件分支。 */
+export declare interface DesignerEventConditionBranch {
+    id: string;
+    name: string;
+    condition: DesignerExpression;
+    steps: DesignerEventStep[];
+}
+
+/** 引导式事件流中的条件节点。 */
+export declare interface DesignerEventConditionStep {
+    id: string;
+    stepType: 'CONDITION';
+    name: string;
+    branches: DesignerEventConditionBranch[];
+    elseSteps: DesignerEventStep[];
+}
+
+/** 事件动作的错误处理策略。 */
+export declare type DesignerEventErrorPolicy = 'STOP' | 'CONTINUE';
+
+/** 事件流执行结果。 */
+export declare interface DesignerEventExecutionResult {
+    completed: boolean;
+    blocked: boolean;
+    executedStepIds: string[];
+    errors: string[];
+}
+
+/** 可由字段、容器或表单生命周期引用的声明式事件流。 */
+export declare interface DesignerEventFlow {
+    id: string;
+    code: string;
+    name: string;
+    trigger: {
+        scope: 'FORM';
+        event: DesignerFormEvent;
+    } | {
+        scope: 'COMPONENT';
+        event: DesignerComponentEvent;
+        nodeId: string;
+    };
+    enabled: boolean;
+    steps: DesignerEventStep[];
+}
+
+/** 事件流运行 Host；所有可能产生外部副作用的能力均由显式回调或 Adapter 提供。 */
+export declare interface DesignerEventRuntimeHost {
+    document: DesignerDocument;
+    valueStore: DesignerRuntimeValueStore;
+    variables: Record<string, unknown>;
+    currentRow?: Record<string, unknown>;
+    expressionContext: DesignerExpressionRuntimeContext['context'];
+    adapters?: DesignerRuntimeAdapters;
+    validate?: () => Promise<boolean>;
+    submit?: () => Promise<void>;
+    reset?: () => void;
+    print?: () => void;
+    message?: (message: string, level: 'SUCCESS' | 'INFO' | 'WARNING' | 'ERROR') => void;
+    openModule?: (moduleCode: string) => void;
+    confirmModule?: (moduleCode: string) => void;
+    cancelModule?: (moduleCode: string) => void;
+}
+
+/** 事件流递归步骤。 */
+export declare type DesignerEventStep = DesignerEventActionStep | DesignerEventConditionStep;
+
+/** 声明式表达式 AST；Core 不持久化或执行自由脚本。 */
+export declare type DesignerExpression = {
+    kind: 'LITERAL';
+    value: string | number | boolean | null;
+} | {
+    kind: 'FIELD';
+    fieldId: string;
+    scope: DesignerExpressionFieldScope;
+} | {
+    kind: 'VARIABLE';
+    variableCode: string;
+} | {
+    kind: 'CONTEXT';
+    key: DesignerExpressionContextKey;
+} | {
+    kind: 'CALL';
+    function: DesignerExpressionFunction;
+    arguments: DesignerExpression[];
+};
+
+/** 表达式可读取的受控上下文值。 */
+export declare type DesignerExpressionContextKey = 'RUNTIME_MODE' | 'DEVICE' | 'CURRENT_USER_ID' | 'CURRENT_TENANT_ID' | 'NOW';
+
+/** 表达式读取字段时的受控数据作用域。 */
+export declare type DesignerExpressionFieldScope = 'ROOT' | 'CURRENT_ROW';
+
+/** 表达式解释器允许的纯函数目录。 */
+export declare type DesignerExpressionFunction = 'AND' | 'OR' | 'NOT' | 'EQ' | 'NE' | 'GT' | 'GTE' | 'LT' | 'LTE' | 'EMPTY' | 'NOT_EMPTY' | 'IN' | 'CONTAINS' | 'ADD' | 'SUBTRACT' | 'MULTIPLY' | 'DIVIDE' | 'CONCAT' | 'COALESCE' | 'LENGTH' | 'IF';
+
+/** 运行表达式时由 Host 提供的只读上下文。 */
+export declare interface DesignerExpressionRuntimeContext {
+    fields: Record<string, unknown>;
+    currentRow?: Record<string, unknown>;
+    variables: Record<string, unknown>;
+    context: Partial<Record<DesignerExpressionContextKey, unknown>>;
+}
+
+/** 数据 Schema 中的本地语义字段。 */
+export declare interface DesignerField {
+    id: string;
+    /** 字段所属语义实体编码；根级字段必须属于主实体，子表列必须属于对应子实体。 */
+    entityCode: string;
+    key: string;
+    label: string;
+    semanticType: DesignerSemanticType;
+    componentType: string;
+    configurationVersion: number;
+    configuration: Record<string, unknown>;
+    defaultValue: unknown;
+    helpText: string;
+    required: boolean;
+    validation: DesignerFieldValidation;
+    /** 条件状态、计算联动、独立验证、提交投影和事件绑定。 */
+    behavior: DesignerFieldBehavior;
+    display: DesignerFieldDisplay;
+    bindingStatus: DesignerBindingStatus;
+    primaryKey: boolean;
+    systemField: boolean;
+    displayOrder: number;
+    binding?: DesignerFieldBinding;
+}
+
+/** 字段行为配置。 */
+export declare interface DesignerFieldBehavior {
+    stateRules: DesignerFieldStateRule[];
+    valueRules: DesignerFieldValueRule[];
+    validationRules: DesignerValidationRule[];
+    submitBehavior: DesignerFieldSubmitBehavior;
+    eventBindings: Partial<Record<DesignerComponentEvent, string>>;
+}
+
+/** 高级配置编辑器只消费能力状态，不持有 Adapter 实例。 */
+export declare interface DesignerFieldBehaviorCapabilities {
+    remoteValidation: boolean;
+    dataSource: boolean;
+    navigation: boolean;
+    hostAction: boolean;
+    linkageConfirmation: boolean;
+}
+
+/** 高级配置保存前可定位到页签与规则的诊断。 */
+export declare interface DesignerFieldBehaviorDiagnostic {
+    severity: DesignerDiagnosticSeverity;
+    code: string;
+    message: string;
+    path: string;
+    tab: 'state' | 'value' | 'validation' | 'submit';
+    ruleId?: string;
+}
+
+/** 可选外部字段绑定引用；Core 只保存稳定引用，不解释业务来源。 */
+export declare interface DesignerFieldBinding {
+    provider: string;
+    sourceId: string;
+    fieldId: string;
+    fieldPath: string;
+    sourceDataType: string;
+    sourceRevision?: number;
+}
+
+/** 字段展示配置。 */
+export declare interface DesignerFieldDisplay {
+    placeholder: string;
+    hidden: boolean;
+    readonly: boolean;
+}
+
+/** 字段下方分别展示的错误与非阻断警告。 */
+export declare interface DesignerFieldFeedback {
+    error?: string;
+    warning?: string;
+}
+
+/** 生成字段帮助文字约定使用的稳定词条 key。 */
+export declare function designerFieldHelpI18nKey(fieldKey: string): string;
+
+/** 生成字段标签约定使用的稳定词条 key。 */
+export declare function designerFieldLabelI18nKey(fieldKey: string): string;
+
+/** 引用数据字段的 UI 节点。 */
+export declare interface DesignerFieldNode {
+    nodeType: 'FIELD';
+    id: string;
+    fieldId: string;
+    layout: DesignerResponsiveGrid;
+}
+
+/** 校验字段从当前实体作用域移动到目标作用域是否被允许。 */
+export declare function designerFieldScopeDropRejection(document: DesignerDocument, field: DesignerField, targetContainerId: string | null): string;
+
+/** 字段运行状态规则。 */
+export declare interface DesignerFieldStateRule {
+    id: string;
+    target: 'VISIBLE' | 'REQUIRED' | 'DISABLED';
+    condition: DesignerExpression;
+    valueWhenTrue: boolean;
+    valueWhenFalse?: boolean;
+}
+
+/** 字段是否进入最终提交数据。 */
+export declare type DesignerFieldSubmitBehavior = 'AUTO' | 'INCLUDE' | 'EXCLUDE';
+
+/** 字段基础校验。专属校验继续存放在版本化组件配置中。 */
+export declare interface DesignerFieldValidation {
+    minimumLength?: number;
+    maximumLength?: number;
+    minimum?: number;
+    maximum?: number;
+    pattern?: string;
+    message?: string;
+}
+
+/** 字段计算或赋值联动规则。 */
+export declare type DesignerFieldValueRule = DesignerFormulaValueRule | DesignerLinkageValueRule;
+
+/** 表单生命周期事件。 */
+export declare type DesignerFormEvent = 'INITIALIZED' | 'BEFORE_SUBMIT' | 'AFTER_SUBMIT' | 'RESET';
+
+/** 确定性重算并使目标字段保持只读的计算公式。 */
+export declare interface DesignerFormulaValueRule {
+    id: string;
+    mode: 'FORMULA';
+    expression: DesignerExpression;
+    condition?: DesignerExpression;
+}
+
+/** 字段页一次生成主表和子表布局时的受控请求。 */
+export declare interface DesignerGenerateLayoutRequest {
+    fieldIds: string[];
+    relations: Array<{
+        relationCode: string;
+        componentType: 'row-subtable' | 'block-subtable';
+    }>;
+}
+
+/** Host 动作与同应用资源导航 Adapter。 */
+export declare interface DesignerHostActionAdapter {
+    execute: (actionCode: string, input: Record<string, unknown>) => Promise<void>;
+    navigateResource: (resourceCode: string, openInNewPage: boolean) => Promise<void>;
+}
+
+/** 表单国际化配置。 */
+export declare interface DesignerI18nConfiguration {
+    enabled: boolean;
+    defaultLocale: string;
+    locales: string[];
+    entries: DesignerI18nEntry[];
+}
+
+/** 国际化词条。 */
+export declare interface DesignerI18nEntry {
+    key: string;
+    values: Record<string, string>;
+}
+
+/** Host 首次初始化 Core 时使用的数据模型参数。 */
+export declare interface DesignerInitialDataModel {
+    provider: string;
+    sourceId: string;
+    sourceRevision?: number;
+    rootEntity: DesignerInitialEntity;
+    relations: DesignerInitialOneToManyRelation[];
+}
+
+/** Host 首次向独立 Core 注入的实体描述。 */
+export declare interface DesignerInitialEntity {
+    entityId: string;
+    entityCode: string;
+    entityName: string;
+    physicalTableName?: string;
+    fields: DesignerInitialField[];
+}
+
+/** Host 首次向独立 Core 注入的字段描述。 */
+export declare interface DesignerInitialField {
+    fieldId: string;
+    fieldCode: string;
+    fieldName: string;
+    sourceDataType: string;
+    semanticType: DesignerSemanticType;
+    defaultComponentType: string;
+    physicalColumnName?: string;
+    required?: boolean;
+    readonly?: boolean;
+    primaryKey?: boolean;
+    systemField?: boolean;
+    displayOrder?: number;
+}
+
+/** Host 首次向独立 Core 注入的一级一对多关系。 */
+export declare interface DesignerInitialOneToManyRelation {
+    relationId: string;
+    relationCode: string;
+    relationName: string;
+    parentEntityId: string;
+    childEntity: DesignerInitialEntity;
+    loadMode?: 'SYNC' | 'ASYNC';
+    keyMappings?: Array<{
+        parentFieldId: string;
+        childFieldId: string;
+    }>;
+}
+
+/** 设计器 UI Schema 节点。 */
+export declare type DesignerLayoutNode = DesignerFieldNode | DesignerContainerNode;
+
+/** 容器中的稳定命名插槽。 */
+export declare interface DesignerLayoutSlot {
+    id: string;
+    slotCode: string;
+    label: string;
+    children: DesignerLayoutNode[];
+}
+
+/** 联动覆盖已有字段值前由 Host 提供的受控确认 Adapter。 */
+export declare interface DesignerLinkageConfirmationAdapter {
+    confirmOverwrite: (request: {
+        fieldId: string;
+        fieldLabel: string;
+        currentValue: unknown;
+        nextValue: unknown;
+    }) => Promise<boolean>;
+}
+
+/** 联动规则覆盖已有目标值时采用的受控策略。 */
+export declare type DesignerLinkageOverwritePolicy = 'ALWAYS' | 'EMPTY_ONLY' | 'CONFIRM';
+
+/** 仅在依赖字段变化后执行的数据联动。 */
+export declare interface DesignerLinkageValueRule {
+    id: string;
+    mode: 'LINKAGE';
+    expression: DesignerExpression;
+    condition?: DesignerExpression;
+    overwritePolicy: DesignerLinkageOverwritePolicy;
+}
+
+/** 生成弹层模块名称约定使用的稳定词条 key。 */
+export declare function designerModuleI18nKey(moduleCode: string): string;
+
+/**
+ * 校验现有设计节点能否移动到目标容器。
+ *
+ * @param document 当前设计文档。
+ * @param nodeId 待移动节点标识。
+ * @param target 包含目标容器、命名插槽、索引和可选栅格列的完整落点。
+ * @returns 空字符串表示允许，否则返回可直接展示的拒绝原因。
+ */
+export declare function designerNodeDropRejection(document: DesignerDocument, nodeId: string, target: DesignerDropTarget): string;
+
+/** 数字字段格式化所需的受控配置。 */
+export declare interface DesignerNumberFormatConfiguration {
+    precision?: unknown;
+    currencyPrefix?: unknown;
+    thousandsSeparator?: unknown;
+    uppercaseRmb?: unknown;
+}
+
+/** 当前 Core 支持的主实体到一级子实体一对多关系。 */
+export declare interface DesignerOneToManyRelation {
+    id: string;
+    code: string;
+    name: string;
+    parentEntityId: string;
+    childEntity: DesignerDataEntity;
+    loadMode: 'SYNC' | 'ASYNC';
+}
+
+/** 静态选项的稳定结构。 */
+export declare interface DesignerOption {
+    label: string;
+    value: string | number | boolean;
+    disabled?: boolean;
+    children?: DesignerOption[];
+}
+
+/** 大纲使用的只读投影节点。 */
+export declare interface DesignerOutlineItem {
+    id: string;
+    label: string;
+    typeLabel: string;
+    children: DesignerOutlineItem[];
+}
+
+/** 弹层模块的数据草稿来源。 */
+export declare type DesignerOverlayDataContext = 'FORM_DRAFT' | 'SUBTABLE_ROW_DRAFT';
+
+/** 弹层模块类型。 */
+export declare type DesignerOverlayKind = 'DIALOG' | 'DRAWER';
+
+/** 弹窗在运行态允许使用的最大高度档位。 */
+export declare type DesignerOverlayMaxHeightPreset = 'COMPACT' | 'STANDARD' | 'SPACIOUS' | 'VIEWPORT';
+
+/** 主体之外可被事件打开的弹窗或抽屉视图。 */
+export declare interface DesignerOverlayModule {
+    id: string;
+    code: string;
+    name: string;
+    kind: DesignerOverlayKind;
+    dataContext: DesignerOverlayDataContext;
+    width: number;
+    /** 弹窗使用的受控圆角档位；抽屉保留该值但不渲染圆角。 */
+    radius: DesignerRadiusPreset;
+    /** 弹窗运行最大高度；抽屉保留该值但继续占满可用高度。 */
+    maxHeightPreset: DesignerOverlayMaxHeightPreset;
+    root: DesignerLayoutNode[];
+}
+
+/** 注册项贡献给属性工作台的结构化属性。 */
+export declare interface DesignerPropertyDefinition {
+    key: string;
+    label: string;
+    section: 'BASIC' | 'DATA' | 'DISPLAY' | 'CAPABILITY';
+    editor: DesignerPropertyEditor;
+    description?: string;
+}
+
+/**
+ * 组件注册项使用的业务语义属性编辑器。
+ *
+ * 判别联合把受控选项、单位、范围和专属能力集中在注册表，属性面板只解释该接口，
+ * 不再根据字段 key 或 JavaScript 值类型猜测应该使用哪一种输入控件。
+ */
+export declare type DesignerPropertyEditor = (DesignerPropertyEditorBase & {
+    type: 'TEXT';
+    maxLength?: number;
+}) | (DesignerPropertyEditorBase & {
+    type: 'TEXTAREA';
+    rows?: number;
+    maxLength?: number;
+}) | (DesignerPropertyEditorBase & {
+    type: 'NUMBER';
+    minimum?: number;
+    maximum?: number;
+    step?: number;
+    unit?: string;
+}) | (DesignerPropertyEditorBase & {
+    type: 'BOOLEAN';
+}) | (DesignerPropertyEditorBase & {
+    type: 'SELECT' | 'SEGMENTED';
+    options: DesignerPropertyOption[];
+}) | (DesignerPropertyEditorBase & {
+    type: 'PRESET_NUMBER';
+    options: DesignerPropertyOption[];
+    minimum?: number;
+    maximum?: number;
+    unit?: string;
+}) | (DesignerPropertyEditorBase & {
+    type: 'COLOR';
+}) | (DesignerPropertyEditorBase & {
+    type: 'OPTIONS';
+}) | (DesignerPropertyEditorBase & {
+    type: 'DATE_FORMAT';
+    sourceKey: string;
+}) | (DesignerPropertyEditorBase & {
+    type: 'FILE_TYPES';
+}) | (DesignerPropertyEditorBase & {
+    type: 'URL';
+    maxLength?: number;
+}) | (DesignerPropertyEditorBase & {
+    type: 'RESOURCE_REFERENCE';
+    resourceType: 'DICTIONARY' | 'PROCESS' | 'FORM' | 'ASSET_POLICY';
+    unavailableReason: string;
+}) | (DesignerPropertyEditorBase & {
+    type: 'GRID_SPAN';
+    device: DesignerDevice;
+}) | (DesignerPropertyEditorBase & {
+    type: 'GRID_OFFSET';
+    spanKey: string;
+}) | (DesignerPropertyEditorBase & {
+    type: 'IDENTIFIER';
+    maxLength?: number;
+});
+
+/** 属性编辑器的共享行为；历史值策略只影响编辑显示，不会改写文档。 */
+export declare interface DesignerPropertyEditorBase {
+    visibleWhen?: (configuration: Readonly<Record<string, unknown>>) => boolean;
+    legacyValuePolicy?: 'PRESERVE' | 'REJECT';
+    /** 为需要保留的旧枚举值提供可理解的显示名称，避免属性面板暴露内部编码。 */
+    legacyValueLabels?: Readonly<Record<string, string>>;
+}
+
+/** 属性编辑器中的稳定原子选项。 */
+export declare interface DesignerPropertyOption {
+    label: string;
+    value: string | number | boolean;
+    disabled?: boolean;
+}
+
+/** 当前容器快捷栅格的影响预览。 */
+export declare interface DesignerQuickGridPreview {
+    targetLabel: string;
+    affectedNodeIds: string[];
+    skippedCount: number;
+}
+
+/** 表单字段控件和显式容器共用的受控圆角档位。 */
+export declare type DesignerRadiusPreset = 'THEME' | 'NONE' | 'SMALL' | 'BASE' | 'LARGE';
+
+/** 一级子表关系可修改的语义身份属性。 */
+export declare interface DesignerRelationPatch {
+    name?: string;
+    code?: string;
+    childEntityName?: string;
+    childEntityCode?: string;
+}
+
+/** 受控远程验证 Adapter。 */
+export declare interface DesignerRemoteValidationAdapter {
+    validate: (request: {
+        provider: string;
+        validatorId: string;
+        value: unknown;
+        fieldId: string;
+    }) => Promise<{
+        valid: boolean;
+        message?: string;
+    }>;
+}
+
+/** 设计与运行渲染器共同消费的容器外观解析结果。 */
+export declare interface DesignerResolvedContainerAppearance {
+    style: Exclude<DesignerContainerStyleOverride, 'INHERIT'>;
+    radius: DesignerRadiusPreset;
+    styleSource: 'FORM' | 'COMPONENT';
+    radiusSource: 'FORM' | 'COMPONENT';
+}
+
+/** 字段解释后的运行状态。 */
+export declare interface DesignerResolvedFieldState {
+    visible: boolean;
+    required: boolean;
+    disabled: boolean;
+}
+
+/** PC 与移动端共用字段树时的响应式布局。 */
+export declare interface DesignerResponsiveGrid {
+    pc: DesignerDeviceGrid;
+    mobile: DesignerDeviceGrid;
+}
+
+/** 主实体可修改的语义身份属性。 */
+export declare type DesignerRootEntityPatch = Partial<Pick<DesignerDataEntity, 'name' | 'code'>>;
+
+/** 静态运行预览可选 Adapter 集合；缺少能力时必须失败关闭。 */
+export declare interface DesignerRuntimeAdapters {
+    asset?: FormAssetAdapter;
+    remoteValidation?: DesignerRemoteValidationAdapter;
+    dataSource?: DesignerDataSourceAdapter;
+    hostAction?: DesignerHostActionAdapter;
+    linkageConfirmation?: DesignerLinkageConfirmationAdapter;
+    navigation?: FormNavigationAdapter;
+    directory?: FormDirectoryAdapter;
+    ocr?: FormOcrAdapter;
+    scan?: FormScanAdapter;
+    location?: FormLocationAdapter;
+}
+
+/** 设计器与静态运行预览共用的模式。 */
+export declare type DesignerRuntimeMode = 'DESIGN' | 'CREATE' | 'EDIT' | 'READ_ONLY' | 'DETAIL';
+
+/**
+ * 静态运行预览的值仓库。
+ *
+ * 普通字段与集合值分开保存；集合以子表容器节点 ID 为键，整个仓库只属于预览副本，不允许写回设计文档。
+ */
+export declare interface DesignerRuntimeValueStore {
+    fields: Record<string, unknown>;
+    collections: Record<string, DesignerSubtableRow[]>;
+}
+
+/** 设计器字段的语义数据类型，不包含任何数据库方言。 */
+export declare type DesignerSemanticType = 'STRING' | 'LONG_TEXT' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'DATE_TIME' | 'FILE' | 'REFERENCE' | 'OBJECT' | 'ARRAY';
+
+/** Sortable 在设计器内部暴露的最小移动上下文，避免工作台依赖第三方完整事件类型。 */
+export declare interface DesignerSortableMoveEvent {
+    dragged: HTMLElement;
+    related: HTMLElement;
+    to: HTMLElement;
+    willInsertAfter?: boolean;
+}
+
+/** 物理来源信息只存在于当前 Core 会话，绝不进入设计文档。 */
+export declare interface DesignerSourceMetadataIndex {
+    provider: string;
+    sourceId: string;
+    sourceRevision?: number;
+    entities: Record<string, {
+        physicalTableName?: string;
+    }>;
+    fields: Record<string, {
+        physicalColumnName?: string;
+    }>;
+    relations: Record<string, {
+        keyMappings: Array<{
+            parentFieldId: string;
+            childFieldId: string;
+        }>;
+    }>;
+}
+
+/** 提交投影结果。 */
+export declare interface DesignerSubmissionProjection {
+    fields: Record<string, unknown>;
+    collections: Record<string, DesignerSubtableRow[]>;
+    excludedFieldIds: string[];
+}
+
+/** 表单提交时对普通隐藏字段的统一处理策略。 */
+export declare interface DesignerSubmitPolicy {
+    ignoreHiddenFields: boolean;
+}
+
+/**
+ * 子表各展示形态共用的只读列投影。
+ *
+ * 列标识来自布局节点，字段身份来自 Data Schema；该投影不进入设计文档，也不持有可变节点引用。
+ */
+export declare interface DesignerSubtableColumn {
+    columnId: string;
+    fieldId: string;
+    fieldKey: string;
+    label: string;
+    componentType: string;
+    semanticType: DesignerSemanticType;
+}
+
+/** 子表表头、编辑行和详情行共用的 CSS Grid 布局结果。 */
+export declare interface DesignerSubtableGridLayout {
+    template: string;
+    minimumWidth: string;
+}
+
+/** 子表栅格可选区域；序号列和操作列必须与数据列一起生成同一模板。 */
+export declare interface DesignerSubtableGridOptions {
+    showIndex?: boolean;
+    showActions?: boolean;
+    indexWidth?: number;
+    actionWidth?: number;
+}
+
+/** 子表列投影的设计态与运行态可见性选项。 */
+export declare interface DesignerSubtableProjectionOptions {
+    /** 设计态可保留历史隐藏字段以便用户修复；运行态必须保持关闭。 */
+    includeHidden?: boolean;
+}
+
+/**
+ * 静态预览中的子表行。
+ *
+ * `rowId` 只标识当前预览副本中的一行；`values` 使用字段 ID 作为键，避免字段编码调整后串行数据。
+ */
+export declare interface DesignerSubtableRow {
+    rowId: string;
+    values: Record<string, unknown>;
+}
+
+/** 可设计视图集合。主体 root 保持旧协议位置，弹层作为增量集合。 */
+export declare interface DesignerUiSchema {
+    root: DesignerLayoutNode[];
+    overlays: DesignerOverlayModule[];
+}
+
+/** 字段验证目录中的可创建规则。 */
+export declare interface DesignerValidationCatalogItem {
+    type: DesignerValidationRuleType;
+    label: string;
+    description: string;
+    available: boolean;
+    unavailableReason: string;
+}
+
+/** 跨字段比较允许的受控操作符。 */
+export declare type DesignerValidationComparisonOperator = 'EQ' | 'NE' | 'GT' | 'GTE' | 'LT' | 'LTE';
+
+/** 各验证规则类型对应的严格参数。 */
+export declare interface DesignerValidationConfigurationMap {
+    LENGTH: DesignerValidationRangeConfiguration;
+    RANGE: DesignerValidationRangeConfiguration;
+    PRECISION: {
+        scale: number;
+    };
+    FORMAT: {
+        format: 'EMAIL' | 'PHONE' | 'IDENTIFIER';
+    };
+    REGEX: {
+        pattern: string;
+    };
+    DATE: {
+        minimum?: string;
+        maximum?: string;
+    };
+    SELECTION: DesignerValidationRangeConfiguration;
+    FILE: {
+        maximumCount?: number;
+        maximumSizeMb?: number;
+        accept?: string;
+    };
+    COMPARE_FIELD: {
+        fieldId: string;
+        operator: DesignerValidationComparisonOperator;
+    };
+    EXPRESSION: {
+        expression: DesignerExpression;
+    };
+    SUBTABLE: {
+        containerId: string;
+        minimumRows?: number;
+        maximumRows?: number;
+    };
+    REMOTE: {
+        provider: string;
+        validatorId: string;
+    };
+}
+
+/** 最小值与最大值区间配置。 */
+export declare interface DesignerValidationRangeConfiguration {
+    minimum?: number;
+    maximum?: number;
+}
+
+/** 单条运行验证结果。 */
+export declare interface DesignerValidationResult {
+    fieldId: string;
+    ruleId: string;
+    severity: 'ERROR' | 'WARNING';
+    message: string;
+}
+
+/** 声明式字段验证规则判别联合，JSON 外形保持 `type + configuration`。 */
+export declare type DesignerValidationRule = {
+    [Type in DesignerValidationRuleType]: DesignerValidationRuleBase & {
+        type: Type;
+        configuration: DesignerValidationConfigurationMap[Type];
+    };
+}[DesignerValidationRuleType];
+
+/** 验证规则通用字段；规则参数由具体类型收紧。 */
+export declare interface DesignerValidationRuleBase {
+    id: string;
+    name: string;
+    enabled: boolean;
+    trigger: 'CHANGE' | 'BLUR' | 'SUBMIT';
+    severity: 'ERROR' | 'WARNING';
+    message: string;
+    condition?: DesignerExpression;
+}
+
+/** 字段验证规则类型。必填仍由字段 required 或状态规则独立决定。 */
+export declare type DesignerValidationRuleType = 'LENGTH' | 'RANGE' | 'PRECISION' | 'FORMAT' | 'REGEX' | 'DATE' | 'SELECTION' | 'FILE' | 'COMPARE_FIELD' | 'EXPRESSION' | 'SUBTABLE' | 'REMOTE';
+
+/** 表单持久化变量定义；运行值不写入设计文档。 */
+export declare interface DesignerVariableDefinition {
+    id: string;
+    code: string;
+    name: string;
+    valueType: 'STRING' | 'NUMBER' | 'BOOLEAN' | 'DATE' | 'OBJECT';
+    initialValue: string | number | boolean | null;
+}
+
+/** 诊断高级协议的白名单、引用、表达式和受控枚举。 */
+export declare function diagnoseDesignerAdvancedDocument(document: DesignerDocument): DesignerDiagnostic[];
+
+/** 对持久化数据模型目录执行实体、关系和字段作用域诊断。 */
+export declare function diagnoseDesignerDataModel(document: DesignerDocument): DesignerDiagnostic[];
+
+/**
+ * 校验未知文档输入的版本、字段、组件、布局、typed slots 和引用完整性。
+ *
+ * 该入口承担导入边界，任何非法结构都必须返回诊断而不能把类型异常抛给工作台。
+ */
+export declare function diagnoseDesignerDocument(source: unknown): DesignerDiagnostic[];
+
+/** 诊断表达式节点、字段/变量引用、作用域和复杂度。 */
+export declare function diagnoseDesignerExpression(expression: unknown, document: DesignerDocument, path: string, options?: {
+    allowCurrentRow: boolean;
+}): DesignerDiagnostic[];
+
+/**
+ * 使用行为与事件流草稿构造临时文档并返回字段级诊断。
+ *
+ * 文档诊断负责严格 Schema、表达式、循环与引用；本模块补充产品级重复名称和 Adapter 能力诊断。
+ */
+export declare function diagnoseDesignerFieldBehaviorDraft(input: {
+    document: DesignerDocument;
+    fieldId: string;
+    behavior: DesignerFieldBehavior;
+    eventFlows: DesignerEventFlow[];
+    capabilities: DesignerFieldBehaviorCapabilities;
+}): DesignerFieldBehaviorDiagnostic[];
+
+/** 复制节点及其字段引用，确保复制后的数据字段保持独立。 */
+export declare function duplicateDesignerNode(document: DesignerDocument, nodeId: string): DesignerLayoutNode | undefined;
+
+/** 复制模块及其视图节点；字段身份继续复用，节点身份全部重新生成。 */
+export declare function duplicateDesignerOverlayModule(document: DesignerDocument, moduleCode: string): DesignerOverlayModule | undefined;
+
+/** 复制子表时生成新的本地关系和子实体，禁止两个可写子表共享同一关系。 */
+export declare function duplicateDesignerSubtableRelation(document: DesignerDocument, source: Extract<DesignerLayoutNode, {
+    nodeType: 'CONTAINER';
+}>, copy: Extract<DesignerLayoutNode, {
+    nodeType: 'CONTAINER';
+}>): void;
+
+/** 为新建子表建立独立的一级一对多关系，并将稳定 relationCode 写入节点配置。 */
+export declare function ensureDesignerSubtableRelation(document: DesignerDocument, node: Extract<DesignerLayoutNode, {
+    nodeType: 'CONTAINER';
+}>): DesignerOneToManyRelation | undefined;
+
+/** 将表达式结果按布尔条件解释；异常和非布尔结果一律视为不成立。 */
+export declare function evaluateDesignerCondition(expression: DesignerExpression | undefined, runtime: DesignerExpressionRuntimeContext): boolean;
+
+/** 计算声明式表达式；未知函数、越界深度或非法数值运算会失败关闭。 */
+export declare function evaluateDesignerExpression(expression: DesignerExpression, runtime: DesignerExpressionRuntimeContext): unknown;
+
+/**
+ * 执行声明式事件流。
+ *
+ * 运行器限制最大深度、步骤数量和同一流重复进入；未提供的外部能力失败关闭。
+ */
+export declare function executeDesignerEventFlow(flow: DesignerEventFlow, host: DesignerEventRuntimeHost, activeFlowIds?: Set<string>): Promise<DesignerEventExecutionResult>;
+
+/** 按稳定组件编码读取注册项。 */
+export declare function findDesignerComponent(componentType: string): DesignerComponentRegistration | undefined;
+
+/** 查找当前布局中的节点。 */
+export declare function findDesignerNode(nodes: DesignerLayoutNode[], nodeId: string): DesignerLayoutNode | undefined;
+
+/** 查找已放置的关系容器。 */
+export declare function findSubtableNodeByRelationCode(nodes: DesignerLayoutNode[], relationCode: string): Extract<DesignerLayoutNode, {
+    nodeType: 'CONTAINER';
+}> | undefined;
+
+/** 文件上传、元数据解析与下载端口。物理删除不属于字段编辑语义。 */
+export declare interface FormAssetAdapter {
+    upload: (request: FormAssetUploadRequest) => Promise<FormAssetReference>;
+    resolve: (request: FormAssetResolveRequest) => Promise<FormAssetReference[]>;
+    download: (request: FormAssetDownloadRequest) => Promise<FormAssetDownloadResult>;
+}
+
+/** 文件下载请求。 */
+export declare interface FormAssetDownloadRequest {
+    assetId: string;
+    fieldId: string;
+    fieldCode: string;
+    context: FormRuntimeAdapterContext;
+}
+
+/** 文件下载结果；宿主可以返回可访问 URL 或需要浏览器保存的 Blob。 */
+export declare type FormAssetDownloadResult = {
+    kind: 'URL';
+    url: string;
+    fileName?: string;
+} | {
+    kind: 'BLOB';
+    blob: Blob;
+    fileName: string;
+    contentType?: string;
+};
+
+/** 文件上传完成后供运行表单展示的资源元数据。 */
+export declare interface FormAssetReference {
+    assetId: string;
+    name: string;
+    size: number;
+    contentType?: string;
+    downloadUrl?: string;
+}
+
+/** 文件元数据批量解析请求。 */
+export declare interface FormAssetResolveRequest {
+    assetIds: string[];
+    fieldId: string;
+    fieldCode: string;
+    context: FormRuntimeAdapterContext;
+}
+
+/** 文件上传请求；Schema 只保存约束，真实文件和宿主上下文只存在于本次调用。 */
+export declare interface FormAssetUploadRequest {
+    file: File;
+    fieldId: string;
+    fieldCode: string;
+    policyRef?: string;
+    context: FormRuntimeAdapterContext;
+}
+
+/**
+ * 将数字字段值格式化为设计、只读与详情共用的展示文本。
+ *
+ * @param value 原始数字值。
+ * @param configuration 数字组件的受控格式配置。
+ * @returns 包含精度、千分位、货币前缀和可选人民币大写的展示文本。
+ */
+export declare function formatDesignerNumber(value: number, configuration: DesignerNumberFormatConfiguration): string;
+
+/**
+ * 将数字转换为人民币大写文本。
+ *
+ * @param value 待转换金额。
+ * @returns 人民币大写文本；超出受控范围时返回明确说明。
+ */
+export declare function formatDesignerRmbUppercase(value: number): string;
+
+/** 人员、组织、角色和岗位等目录选择端口。 */
+export declare interface FormDirectoryAdapter {
+    query: (request: {
+        subjectType: string;
+        keyword: string;
+        pageNo: number;
+        pageSize: number;
+        context: FormRuntimeAdapterContext;
+    }) => Promise<{
+        items: Array<{
+            id: string;
+            label: string;
+            description?: string;
+        }>;
+        totalCount: number;
+    }>;
+}
+
+/** 定位端口。 */
+export declare interface FormLocationAdapter {
+    locate: (request: {
+        context: FormRuntimeAdapterContext;
+    }) => Promise<{
+        longitude: number;
+        latitude: number;
+        address?: string;
+    }>;
+}
+
+/** 同应用资源导航端口。 */
+export declare interface FormNavigationAdapter {
+    navigate: (request: {
+        resourceCode: string;
+        openInNewPage: boolean;
+        context: FormRuntimeAdapterContext;
+    }) => Promise<void>;
+}
+
+/** OCR 识别端口。 */
+export declare interface FormOcrAdapter {
+    recognize: (request: {
+        file: File;
+        fieldId: string;
+        fieldCode: string;
+        provider?: string;
+        context: FormRuntimeAdapterContext;
+    }) => Promise<Record<string, unknown>>;
+}
+
+/** 宿主注入给远程能力的稳定运行上下文，不包含认证凭据或传输配置。 */
+export declare interface FormRuntimeAdapterContext {
+    applicationCode?: string;
+    resourceCode?: string;
+    formId?: string;
+    recordToken?: string;
+    moduleCode?: string;
+    rowKey?: string;
+    extension?: Readonly<Record<string, unknown>>;
+}
+
+/** 对外公开的运行 Adapter 集合别名。 */
+export declare type FormRuntimeAdapters = DesignerRuntimeAdapters;
+
+/** 扫码端口。 */
+export declare interface FormScanAdapter {
+    scan: (request: {
+        context: FormRuntimeAdapterContext;
+    }) => Promise<{
+        text: string;
+    }>;
+}
+
+/**
+ * 将字段页选择的主实体字段和一级子关系作为一个布局事务写入文档。
+ *
+ * 已放置字段和关系会被跳过；主键、系统字段不会被自动生成成普通可写控件。
+ */
+export declare function generateDesignerDataModelLayout(document: DesignerDocument, request: DesignerGenerateLayoutRequest): {
+    createdNodeIds: string[];
+    skippedFieldIds: string[];
+};
+
+/**
+ * 为预设选择追加合法的历史当前值，避免打开旧草稿时出现空白或自动迁移。
+ *
+ * @param options 当前编辑器允许产生的预设选项。
+ * @param current 文档中已经存在的值。
+ * @param formatCurrent 历史值显示函数。
+ * @returns 保留原选项顺序并在必要时前置“当前值”的新数组。
+ */
+export declare function includeDesignerCurrentOption(options: readonly DesignerPropertyOption[], current: unknown, formatCurrent?: (value: string | number | boolean) => string): DesignerPropertyOption[];
+
+/** 在指定根或命名插槽中插入节点。 */
+export declare function insertDesignerNode(document: DesignerDocument, node: DesignerLayoutNode, target: DesignerDropTarget): boolean;
+
+/** 校验安全正则文本，拒绝回溯风险结构、反向引用和超长模式。 */
+export declare function isSafeDesignerRegularExpression(pattern: string): boolean;
+
+/** 原子移动现有节点，并阻止容器移动到自身后代。 */
+export declare function moveDesignerNode(document: DesignerDocument, nodeId: string, target: DesignerDropTarget): boolean;
+
+/**
+ * 在指定视图上下文中复用现有根布局算法。
+ *
+ * mutation 完成后始终恢复主表 root 引用，防止模块视图意外替换主体。
+ */
+export declare function mutateDesignerView(document: DesignerDocument, viewCode: string, mutation: (document: DesignerDocument) => void): void;
+
+/**
+ * 在克隆后的文档中补齐高级协议默认值。
+ *
+ * 旧文档动作栏保持隐藏以维持历史视觉；旧基础校验转换为稳定规则，但不会修改调用方原对象。
+ */
+export declare function normalizeDesignerAdvancedDocument(source: Record<string, unknown>): void;
+
+/**
+ * 规范化旧草稿的数据模型身份和一级子表关系。
+ *
+ * 该函数只补缺失值；已经存在但非法的值交给文档诊断失败关闭，避免静默修复用户输入。
+ */
+export declare function normalizeDesignerDataModel(document: DesignerDocument): void;
+
+/**
+ * 生成数值型受控选项。
+ *
+ * @param values 数值集合。
+ * @param labeler 显示文案函数。
+ * @returns Element Plus 可直接消费的稳定选项。
+ */
+export declare function numberOptions(values: number[], labeler: (value: number) => string): DesignerPropertyOption[];
+
+/** 将未放置字段放入其所属主实体或已存在的子表容器。 */
+export declare function placeDesignerDataField(document: DesignerDocument, fieldId: string): DesignerFieldNode | undefined;
+
+/**
+ * 以首次复制语义应用 Host 参数，并建立非持久化物理来源索引。
+ *
+ * 已存在字段、布局、关系或外部来源身份时不会覆盖当前文档；参数变化也不会形成命令历史。
+ */
+export declare function prepareDesignerDataModel(source: DesignerDocument, initialDataModel?: DesignerInitialDataModel): DesignerDataModelPreparation;
+
+/** 计算当前节点所在容器的直接普通字段，不进入嵌套布局或子表。 */
+export declare function previewDesignerQuickGrid(document: DesignerDocument, selectedNodeId: string): DesignerQuickGridPreview;
+
+/**
+ * 将顺序布局节点投影为只读 24 栅格行。
+ *
+ * 投影只负责设计态定位和空白落点，权威顺序、跨度与偏移仍保存在 UI Schema 中。
+ *
+ * @param nodes 当前根或命名插槽中的顺序节点。
+ * @param device 当前设计设备。
+ * @returns 可供画布渲染的节点单元、空白单元和总行数。
+ */
+export declare function projectDesignerCanvas(nodes: DesignerLayoutNode[], device: DesignerDevice): DesignerCanvasProjection;
+
+/** 将同一字段的一组验证结果折叠为错误与警告双通道。 */
+export declare function projectDesignerFieldFeedback(results: DesignerValidationResult[]): DesignerFieldFeedback | undefined;
+
+/**
+ * 根据表单策略、字段覆盖和最终运行状态生成提交投影。
+ *
+ * 技术隐藏字段始终保留；其他字段的 EXCLUDE 优先于全局策略。该函数只返回新对象，不修改预览值仓库。
+ */
+export declare function projectDesignerSubmission(document: DesignerDocument, valueStore: DesignerRuntimeValueStore, fieldStates: Record<string, DesignerResolvedFieldState>, options?: {
+    dirtyOverlayModuleIds?: string[];
+}): DesignerSubmissionProjection;
+
+/**
+ * 将容器的命名插槽投影为稳定子表列。
+ *
+ * 只有字段节点可以形成数据列；布局节点由 DropPolicy 拒绝，历史异常节点在投影阶段失败关闭，
+ * 不会被伪装为可编辑文本列。缺失字段仍保留列身份并标记为失效，方便设计态定位问题。
+ *
+ * @param container 子表容器节点。
+ * @param fields 文档中的本地字段集合。
+ * @param slotCode 可选命名插槽；省略时使用首个插槽。
+ * @param options 设计态或运行态的可见性选项。
+ * @returns 不持有可变节点引用的稳定列投影。
+ */
+export declare function projectDesignerSubtableColumns(container: DesignerContainerNode, fields: readonly DesignerField[], slotCode?: string, options?: DesignerSubtableProjectionOptions): DesignerSubtableColumn[];
+
+/** 从布局移除节点；字段仍保留在字段页以支持重新放置。 */
+export declare function removeDesignerNode(document: DesignerDocument, nodeId: string): DesignerLayoutNode | undefined;
+
+/** 删除弹层模块；字段定义和其他视图保持不变。 */
+export declare function removeDesignerOverlayModule(document: DesignerDocument, moduleCode: string): boolean;
+
+/**
+ * 解析显式容器最终生效的表面样式和圆角。
+ *
+ * 非表面组件不会获得容器外观类；非法值由文档诊断拒绝，这里只提供渲染期保守回退。
+ */
+export declare function resolveDesignerContainerAppearance(appearance: DesignerAppearance, node: DesignerContainerNode): DesignerResolvedContainerAppearance | undefined;
+
+/** 根据运行能力输出事件动作的可新增状态。 */
+export declare function resolveDesignerEventActionAvailability(type: DesignerEventActionType, capabilities: DesignerFieldBehaviorCapabilities): DesignerEventActionAvailability;
+
+/** 诊断字段计算依赖，并返回可安全执行的拓扑顺序。 */
+export declare function resolveDesignerFieldEvaluationOrder(document: DesignerDocument): {
+    orderedFields: DesignerField[];
+    diagnostics: DesignerDiagnostic[];
+};
+
+/** 根据静态配置和条件规则计算字段最终显示、必填及禁用状态。 */
+export declare function resolveDesignerFieldState(field: DesignerField, runtime: DesignerExpressionRuntimeContext): DesignerResolvedFieldState;
+
+/**
+ * 按当前语言、默认语言和原文的固定顺序解释设计器国际化词条。
+ *
+ * 空翻译不会遮蔽后续回退值，未启用国际化时直接返回原文。
+ */
+export declare function resolveDesignerLocalizedText(configuration: DesignerI18nConfiguration, key: string, locale: string, fallback: string): string;
+
+/**
+ * 解析数字输入与展示共同使用的有效精度。
+ *
+ * @param configuration 数字组件的受控格式配置。
+ * @returns 0～10 之间的整数；人民币大写只影响附加文本，不改变字段输入和主显示精度。
+ */
+export declare function resolveDesignerNumberPrecision(configuration: DesignerNumberFormatConfiguration): number;
+
+/** 将稳定高度档位解析为公共弹窗能够消费的 CSS 最大高度。 */
+export declare function resolveDesignerOverlayMaxHeight(preset: DesignerOverlayMaxHeightPreset): string;
+
+/** 返回目标落点对应的数据实体编码。 */
+export declare function resolveDesignerTargetEntityCode(document: DesignerDocument, containerId: string | null): string | undefined;
+
+/**
+ * 生成当前字段可创建的验证规则目录。
+ *
+ * 历史远程规则由编辑器额外保留；目录在缺少 Adapter 时只提供禁用说明，禁止新建。
+ */
+export declare function resolveDesignerValidationCatalog(document: DesignerDocument, field: DesignerField, capabilities: DesignerFieldBehaviorCapabilities): DesignerValidationCatalogItem[];
+
+/** 返回主体或指定模块的布局根节点。 */
+export declare function resolveDesignerViewRoot(document: DesignerDocument, viewCode: string): DesignerLayoutNode[];
+
+/** 将未放置字段重新加入根布局。 */
+export declare function restoreDesignerFieldNode(document: DesignerDocument, fieldId: string): DesignerFieldNode | undefined;
+
+/** 生成稳定排序的设计文档快照。 */
+export declare function serializeDesignerDocument(document: DesignerDocument): string;
+
+/** 将字段状态规则转换为列表摘要。 */
+export declare function summarizeDesignerStateRule(rule: DesignerFieldStateRule): string;
+
+/** 将验证规则转换为列表摘要。 */
+export declare function summarizeDesignerValidationRule(rule: DesignerValidationRule): string;
+
+/** 将公式或联动转换为列表摘要。 */
+export declare function summarizeDesignerValueRule(rule: DesignerFieldValueRule): string;
+
+/** 同步标签页配置与 typed slots，保留仍然存在的标签内容。 */
+export declare function synchronizeContainerSlots(node: DesignerContainerNode): void;
+
+/** 以一个事务修改一级子表关系及子实体身份，并同步引用和字段作用域。 */
+export declare function updateDesignerRelation(document: DesignerDocument, currentCode: string, patch: DesignerRelationPatch): string;
+
+/** 以一个事务修改主实体身份，并同步主实体字段作用域。 */
+export declare function updateDesignerRootEntity(document: DesignerDocument, patch: DesignerRootEntityPatch): string;
+
+/** 按触发时机验证一个字段；必填验证与规则验证互相独立。 */
+export declare function validateDesignerField(field: DesignerField, value: unknown, trigger: DesignerValidationRule['trigger'], runtime: DesignerExpressionRuntimeContext, options?: {
+    state?: DesignerResolvedFieldState;
+    remoteAdapter?: DesignerRemoteValidationAdapter;
+    collectionRows?: number;
+}): Promise<DesignerValidationResult[]>;
+
+export { }