openxiangda 1.0.41 → 1.0.43

package/packages/sdk/dist/types-U26h_FIh.d.mts

@@ -0,0 +1,1073 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+type FormSectionVariant = 'plain' | 'card';
+type FormSectionAccent = 'blue' | 'green';
+type FormSectionIconKey = 'user' | 'calendar' | 'file' | 'device';
+interface FormSectionProps {
+    title: string;
+    description?: string;
+    variant?: FormSectionVariant;
+    accent?: FormSectionAccent;
+    icon?: React__default.ReactNode;
+    iconKey?: FormSectionIconKey;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    className?: string;
+    titleClassName?: string;
+    contentClassName?: string;
+    children: React__default.ReactNode;
+}
+declare function FormSection({ title, description, variant, accent, icon, iconKey, collapsible, defaultCollapsed, className, titleClassName, contentClassName, children, }: FormSectionProps): react_jsx_runtime.JSX.Element;
+
+/** 字段行为状态 */
+type FieldBehavior = 'NORMAL' | 'READONLY' | 'DISABLED' | 'HIDDEN';
+type FormEngineMode = 'submit' | 'edit' | 'readonly';
+type StandardFormPageMode = FormEngineMode | 'detail' | 'process';
+/** 校验预设模式 */
+type ValidationPreset = 'phone' | 'idCard' | 'email' | 'url' | 'bankCard';
+/** 校验规则 */
+interface ValidationRule {
+    required?: boolean;
+    message?: string;
+    min?: number;
+    max?: number;
+    minLength?: number;
+    maxLength?: number;
+    preset?: ValidationPreset;
+    pattern?: RegExp | string;
+    validator?: (value: any) => Promise<void> | void;
+}
+/** 字段声明（schema 中的每个字段定义） */
+interface FieldDefinition {
+    fieldId: string;
+    componentName: string;
+    label: string;
+    required?: boolean;
+    rules?: ValidationRule[];
+    behavior?: FieldBehavior;
+    placeholder?: string;
+    tips?: string;
+    defaultValue?: any;
+    defaultValueType?: 'static' | 'expression';
+    defaultValueExpression?: string;
+    [key: string]: any;
+}
+type DateShortcutType = 'today' | 'yesterday' | 'tomorrow' | 'currentWeek' | 'currentMonth' | 'pastDays' | 'futureDays';
+interface DateShortcutConfig {
+    type: DateShortcutType;
+    amount?: number;
+    format?: string;
+    includeTime?: boolean;
+}
+type PeopleShortcutType = 'currentUser' | 'currentDepartment' | 'parentDepartment' | 'role' | 'fixed' | 'currentUserManager' | 'currentUserManager2';
+interface PeopleShortcutConfig {
+    type: PeopleShortcutType;
+    roleId?: string;
+    values?: any[];
+}
+type TextShortcutType = 'currentUserName' | 'currentUserJobNumber' | 'currentDeptName' | 'uuid';
+interface TextShortcutConfig {
+    type: TextShortcutType;
+}
+interface LayoutVisibleWhen {
+    field: string;
+    operator: 'eq' | 'ne' | 'in' | 'notIn' | 'contains' | 'empty' | 'notEmpty' | 'between' | 'changed';
+    value?: any;
+}
+interface BaseLayoutNode {
+    id: string;
+    type: 'field' | 'section' | 'grid' | 'tabs' | 'steps';
+    hidden?: boolean;
+    visibleWhen?: LayoutVisibleWhen | LayoutVisibleWhen[];
+}
+interface FieldLayoutNode extends BaseLayoutNode {
+    type: 'field';
+    fieldId: string;
+    span?: number;
+    className?: string;
+}
+interface SectionLayoutNode extends BaseLayoutNode {
+    type: 'section';
+    title: string;
+    description?: string;
+    variant?: FormSectionVariant;
+    accent?: FormSectionAccent;
+    iconKey?: FormSectionIconKey;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    children: FormLayoutNode[];
+}
+interface GridLayoutCell {
+    key?: string;
+    children: FormLayoutNode[];
+}
+interface GridLayoutNode extends BaseLayoutNode {
+    type: 'grid';
+    columns?: 1 | 2 | 3 | 4;
+    gap?: number | string;
+    columnGap?: number | string;
+    rowGap?: number | string;
+    columnRatios?: number[];
+    layoutPreset?: string;
+    cells?: GridLayoutCell[];
+    children: FormLayoutNode[];
+}
+interface TabLayoutItem {
+    key: string;
+    label: string;
+    children: FormLayoutNode[];
+}
+interface TabsLayoutNode extends BaseLayoutNode {
+    type: 'tabs';
+    defaultActiveKey?: string;
+    items: TabLayoutItem[];
+}
+interface StepLayoutItem {
+    key: string;
+    title: string;
+    description?: string;
+    children: FormLayoutNode[];
+}
+interface StepsLayoutNode extends BaseLayoutNode {
+    type: 'steps';
+    items: StepLayoutItem[];
+}
+type FormLayoutNode = FieldLayoutNode | SectionLayoutNode | GridLayoutNode | TabsLayoutNode | StepsLayoutNode;
+interface FormTemplateConfig {
+    type?: 'standard';
+    defaultMode?: StandardFormPageMode;
+    formType?: 'form' | 'process';
+    submitSuccessMode?: 'redirect' | 'stay' | 'continue';
+    enableDraft?: boolean;
+    enableProcessPreview?: boolean;
+    enableEdit?: boolean;
+    enableDelete?: boolean;
+    enableChangeRecords?: boolean;
+    appearance?: FormAppearanceConfig;
+}
+interface FormAppearanceConfig {
+    layout?: 'horizontal' | 'vertical' | 'inline';
+    variant?: 'outlined' | 'borderless' | 'filled' | 'underlined';
+    size?: 'small' | 'middle' | 'large';
+    columns?: 1 | 2 | 3 | 4;
+    rendererSize?: 'compact' | 'default' | 'large';
+    gap?: number | string;
+    maxWidth?: 'sm' | 'md' | 'lg' | 'xl' | 'full' | number | string;
+    requiredMark?: boolean | 'optional';
+    colon?: boolean;
+    labelCol?: Record<string, any>;
+    wrapperCol?: Record<string, any>;
+    scrollToFirstError?: boolean | Record<string, any>;
+}
+interface FormRuntimeConfig {
+    version?: string;
+    generatedAt?: string;
+    editorVersion?: string;
+    currentUser?: UserItem;
+    currentDepartment?: DepartmentTreeNode;
+    currentUserManagers?: UserItem[];
+    appType?: string;
+    /**
+     * 运行时数据查询函数（带权限控制）
+     * 由宿主环境(app-workspace)注入，底层应调用 advancedSearch 接口
+     */
+    fetchFormData?: (params: RuntimeDataQueryParams) => Promise<RuntimeDataQueryResult>;
+    [key: string]: any;
+}
+interface RuntimeDataQueryParams {
+    formUuid: string;
+    appType: string;
+    filters?: Array<{
+        fieldId: string;
+        operator: string;
+        value?: any;
+    }>;
+    conditionLogic?: 'and' | 'or';
+    sort?: {
+        field: string;
+        order: 'asc' | 'desc';
+    };
+    fieldId?: string;
+    deduplicate?: boolean;
+    pageSize?: number;
+    currentPage?: number;
+}
+interface RuntimeDataQueryResult {
+    data: any[];
+    totalCount?: number;
+}
+/** 表单 Schema 定义 */
+interface FormSchema {
+    formMeta: {
+        formUuid: string;
+        appType: string;
+        title: string;
+    };
+    fields: FieldDefinition[];
+    layout?: FormLayoutNode[];
+    rules?: FormEffect[];
+    template?: FormTemplateConfig;
+    runtime?: FormRuntimeConfig;
+}
+interface LowcodePageMeta {
+    pageId?: string;
+    pageCode?: string;
+    routeKey?: string;
+    appType: string;
+    title: string;
+}
+type LowcodePageNodeType = 'PageSection' | 'PageGrid' | 'HeadingBlock' | 'TextBlock' | 'DataManagementList' | 'FormBlock';
+interface LowcodePageNode {
+    id: string;
+    type: LowcodePageNodeType | string;
+    props?: Record<string, any>;
+    children?: LowcodePageNode[];
+    cells?: Array<{
+        key?: string;
+        children: LowcodePageNode[];
+    }>;
+}
+interface LowcodePageSchema {
+    schemaKind: 'page';
+    pageMeta: LowcodePageMeta;
+    nodes: LowcodePageNode[];
+    dataSources?: Array<Record<string, any>>;
+    runtime?: Record<string, any>;
+}
+interface RuntimeResponse<T = any> {
+    code?: number;
+    success?: boolean;
+    data?: T;
+    result?: T;
+    message?: string;
+    error?: string;
+}
+interface RuntimeRequestConfig {
+    url: string;
+    method?: string;
+    params?: Record<string, any>;
+    data?: any;
+    headers?: Record<string, string>;
+    responseType?: 'json' | 'blob';
+}
+interface FormRuntimeApi {
+    request: <T = any>(config: RuntimeRequestConfig) => Promise<RuntimeResponse<T> | Blob>;
+    uploadFile: (file: File, bucketName?: string, onProgress?: (percent: number) => void) => Promise<AttachmentItem>;
+    deleteFile: (objectName: string, bucketName?: string) => Promise<{
+        success: boolean;
+    }>;
+    createDownloadTicket: (bucketName: string, objectName: string, fileName?: string) => Promise<any>;
+    createFileAccessTicket: (bucketName: string, objectName: string, fileName?: string, purpose?: 'download' | 'preview' | 'onlyoffice') => Promise<any>;
+    getUserById: (id: string) => Promise<any>;
+    getUserList: (params?: Record<string, any>) => Promise<any[]>;
+    getDepartmentRoots: () => Promise<any[]>;
+    getDepartmentChildren: (parentId: string) => Promise<any[]>;
+    getDepartmentParentDepartments: (id: string) => Promise<any[]>;
+    getDepartmentMembers: (id: string) => Promise<any[]>;
+    getDepartmentMembersPage: (id: string, params?: {
+        page?: number;
+        pageSize?: number;
+    }) => Promise<{
+        items: any[];
+        total: number;
+        page: number;
+        pageSize: number;
+    }>;
+    getChinaDivisions: (parentAdcode?: string) => Promise<any[]>;
+    advancedSearch: (params: Record<string, any>) => Promise<any>;
+    getDingTalkSignature: (url: string) => Promise<any>;
+    submitFormData: (payload: Record<string, any>) => Promise<any>;
+    updateFormData: (payload: Record<string, any>) => Promise<any>;
+}
+type FormRuntimeApiConfig = Partial<FormRuntimeApi> & {
+    baseUrl?: string;
+};
+/** 表单引擎配置 */
+interface FormEngineConfig {
+    mode: FormEngineMode;
+    formUuid: string;
+    appType: string;
+    formInstanceId?: string;
+    permissions?: {
+        fieldPermissions: Record<string, FieldBehavior>;
+        operations: string[];
+    };
+    submit?: {
+        beforeSubmit?: (values: Record<string, any>) => Promise<boolean | void>;
+        afterSubmit?: (response: any) => Promise<void>;
+        submitSuccessMode?: 'redirect' | 'stay' | 'callback';
+        redirectUrl?: string;
+    };
+    api?: FormRuntimeApiConfig;
+    navigation?: {
+        basePath?: string;
+    };
+    effects?: FormEffect[];
+}
+type FormEffectConditionOperator = 'eq' | 'ne' | 'in' | 'notIn' | 'contains' | 'empty' | 'notEmpty' | 'between' | 'changed';
+type FormEffectCondition = {
+    field: string;
+    operator: FormEffectConditionOperator;
+    value?: any;
+} | {
+    all: FormEffectCondition[];
+} | {
+    any: FormEffectCondition[];
+} | {
+    not: FormEffectCondition;
+};
+type FormEffectAction = {
+    field: string;
+    action: 'show' | 'hide' | 'enable' | 'disable' | 'setValue' | 'clearValue' | 'setRequired' | 'setOptions';
+    value?: any;
+} | {
+    target: string;
+    targetType?: 'field' | 'layout';
+    action: 'show' | 'hide' | 'enable' | 'disable' | 'setValue' | 'clearValue' | 'setRequired' | 'setOptions';
+    value?: any;
+};
+/** 字段联动效果 */
+interface FormEffect {
+    id?: string;
+    name?: string;
+    when: FormEffectCondition;
+    then: FormEffectAction[];
+}
+/** 基础字段组件 Props */
+interface BaseFieldProps {
+    fieldId: string;
+    label: string;
+    value?: any;
+    behavior?: FieldBehavior;
+    required?: boolean;
+    rules?: ValidationRule[];
+    placeholder?: string;
+    tips?: string;
+    className?: string;
+    labelClassName?: string;
+    inputClassName?: string;
+    tipsClassName?: string;
+    readonlyClassName?: string;
+    onChange?: (value: any) => void;
+    onBlur?: (value: any) => void;
+}
+/** TextField 专用 Props */
+interface TextFieldProps extends BaseFieldProps {
+    defaultValue?: string;
+    maxLength?: number;
+    showCount?: boolean;
+    allowClear?: boolean;
+    prefix?: string;
+    suffix?: string;
+    autoComplete?: string;
+    variant?: FormAppearanceConfig['variant'];
+    size?: FormAppearanceConfig['size'];
+    defaultShortcut?: TextShortcutConfig;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+    validationPresets?: ValidationPreset[];
+}
+/** NumberField 专用 Props */
+interface NumberFieldProps extends BaseFieldProps {
+    defaultValue?: number | null;
+    min?: number;
+    max?: number;
+    step?: number;
+    precision?: number;
+    unit?: string;
+    unitPosition?: 'prefix' | 'suffix';
+    thousandSeparator?: boolean;
+    controls?: boolean;
+    keyboard?: boolean;
+    stringMode?: boolean;
+    variant?: FormAppearanceConfig['variant'];
+    size?: FormAppearanceConfig['size'];
+}
+/** TextAreaField 专用 Props */
+interface TextAreaFieldProps extends BaseFieldProps {
+    defaultValue?: string;
+    rows?: number;
+    minRows?: number;
+    maxRows?: number;
+    autoSize?: boolean | {
+        minRows?: number;
+        maxRows?: number;
+    };
+    maxLength?: number;
+    showCount?: boolean;
+    allowClear?: boolean;
+    autoComplete?: string;
+    variant?: FormAppearanceConfig['variant'];
+    size?: FormAppearanceConfig['size'];
+    defaultShortcut?: TextShortcutConfig;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+}
+/** 选项类型 */
+interface OptionItem {
+    value: string;
+    label: string;
+    color?: string;
+    disabled?: boolean;
+}
+interface FieldValueSyncConfig {
+    targetFieldId: string;
+    valuePath?: 'value' | 'label';
+    emptyValue?: any;
+}
+type OptionSourceType = 'custom' | 'linkedForm' | 'dataLinkage';
+interface OptionSourceConfig {
+    type: OptionSourceType;
+    linkedForm?: LinkedFormOptionConfig;
+    dataLinkage?: DataLinkageConfig;
+}
+interface LinkedFormOptionConfig {
+    formUuid: string;
+    formTitle?: string;
+    fieldId: string;
+    fieldLabel?: string;
+    valueFieldId?: string;
+    valueFieldLabel?: string;
+    labelFieldId?: string;
+    labelFieldLabel?: string;
+    searchFieldId?: string;
+    searchFieldLabel?: string;
+    sortField?: string;
+    sortOrder?: 'asc' | 'desc';
+    filters?: DataFilter[];
+    deduplicate?: boolean;
+    pageSize?: number;
+    remoteSearch?: boolean;
+    remoteSearchMinChars?: number;
+}
+interface DataLinkageConfig {
+    formUuid: string;
+    formTitle?: string;
+    targetFieldId: string;
+    targetFieldLabel?: string;
+    conditions: DataLinkageCondition[];
+    conditionLogic?: 'and' | 'or';
+    deduplicate?: boolean;
+}
+interface DataLinkageCondition {
+    localFieldId: string;
+    localFieldLabel?: string;
+    localComponentName?: string;
+    operator: 'eq' | 'ne' | 'contains' | 'gt' | 'lt' | 'gte' | 'lte';
+    remoteFieldId: string;
+    remoteFieldLabel?: string;
+    remoteComponentName?: string;
+}
+interface DataFilter {
+    fieldId: string;
+    fieldLabel?: string;
+    componentName?: string;
+    operator: 'eq' | 'ne' | 'contains' | 'gt' | 'lt' | 'gte' | 'lte' | 'in' | 'notIn' | 'empty' | 'notEmpty';
+    value?: any;
+}
+interface DefaultValueLinkageConfig {
+    formUuid: string;
+    formTitle?: string;
+    targetFieldId: string;
+    targetFieldLabel?: string;
+    conditions: DataLinkageCondition[];
+    conditionLogic?: 'and' | 'or';
+}
+type DateRangeRestriction = 'none' | 'todayAndAfter' | 'todayAndBefore' | 'custom';
+interface DateRestrictionConfig {
+    type: DateRangeRestriction;
+    customStart?: string;
+    customEnd?: string;
+}
+type UserDisplayFormat = 'name' | 'nameWithJobNumber' | 'nameWithDepartment';
+/** SelectField 专用 Props */
+interface SelectFieldProps extends BaseFieldProps {
+    defaultValue?: OptionItem | null;
+    options: OptionItem[];
+    allowClear?: boolean;
+    showSearch?: boolean;
+    optionFilterProp?: string;
+    optionLabelProp?: string;
+    placement?: 'bottomLeft' | 'bottomRight' | 'topLeft' | 'topRight';
+    maxTagTextLength?: number;
+    variant?: FormAppearanceConfig['variant'];
+    size?: FormAppearanceConfig['size'];
+    optionEffects?: FormEffect[];
+    optionSource?: OptionSourceConfig;
+    coloredOptions?: boolean;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+    valueSync?: FieldValueSyncConfig[];
+}
+/** MultiSelectField 专用 Props */
+interface MultiSelectFieldProps extends BaseFieldProps {
+    defaultValue?: OptionItem[];
+    options: OptionItem[];
+    allowClear?: boolean;
+    showSearch?: boolean;
+    maxCount?: number;
+    maxTagCount?: number | 'responsive';
+    maxTagTextLength?: number;
+    optionFilterProp?: string;
+    optionLabelProp?: string;
+    placement?: 'bottomLeft' | 'bottomRight' | 'topLeft' | 'topRight';
+    variant?: FormAppearanceConfig['variant'];
+    size?: FormAppearanceConfig['size'];
+    optionEffects?: FormEffect[];
+    optionSource?: OptionSourceConfig;
+    coloredOptions?: boolean;
+}
+/** RadioField 专用 Props */
+interface RadioFieldProps extends BaseFieldProps {
+    defaultValue?: OptionItem | null;
+    options: OptionItem[];
+    direction?: 'horizontal' | 'vertical';
+    optionType?: 'default' | 'button';
+    buttonStyle?: 'outline' | 'solid';
+    size?: FormAppearanceConfig['size'];
+    optionEffects?: FormEffect[];
+    optionSource?: OptionSourceConfig;
+    coloredOptions?: boolean;
+}
+/** CheckboxField 专用 Props */
+interface CheckboxFieldProps extends BaseFieldProps {
+    defaultValue?: OptionItem[];
+    options: OptionItem[];
+    direction?: 'horizontal' | 'vertical';
+    maxCount?: number;
+    optionEffects?: FormEffect[];
+    optionSource?: OptionSourceConfig;
+    coloredOptions?: boolean;
+}
+/** DateField 专用 Props */
+interface DateFieldProps extends BaseFieldProps {
+    defaultValue?: string;
+    defaultShortcut?: DateShortcutConfig;
+    dateFormat?: string;
+    showTime?: boolean;
+    dateRestriction?: DateRestrictionConfig;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+}
+/** CascadeDateField 专用 Props */
+interface CascadeDateFieldProps extends BaseFieldProps {
+    defaultValue?: {
+        start: string;
+        end: string;
+    } | null;
+    defaultShortcut?: DateShortcutConfig;
+    dateFormat?: string;
+    showTime?: boolean;
+    startLabel?: string;
+    endLabel?: string;
+    dateRestriction?: DateRestrictionConfig;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+}
+/** 附件项 */
+interface AttachmentItem {
+    url: string;
+    name: string;
+    id: string;
+    uid?: string;
+    status?: 'uploading' | 'done' | 'error';
+    objectName?: string;
+    bucketName?: string;
+    originalName?: string;
+    contentType?: string;
+    mimeType?: string;
+    extension?: string;
+    previewUrl?: string;
+    downloadUrl?: string;
+    size?: number;
+    percent?: number;
+    error?: string;
+}
+/** AttachmentField 专用 Props */
+interface AttachmentFieldProps extends BaseFieldProps {
+    defaultValue?: AttachmentItem[];
+    maxCount?: number;
+    accept?: string;
+    maxSize?: number;
+    uploadAction?: string;
+    bucketName?: string;
+    multiple?: boolean;
+    allowedTypes?: string[];
+    showPreview?: boolean;
+    showDownload?: boolean;
+    showFileSize?: boolean;
+    showFileTypeBadge?: boolean;
+    previewPagePath?: string;
+    mobileDownloadMode?: 'auto' | 'direct' | 'ticketRelay';
+}
+/** ImageField 专用 Props */
+interface ImageFieldProps extends BaseFieldProps {
+    defaultValue?: AttachmentItem[];
+    maxCount?: number;
+    accept?: string;
+    uploadAction?: string;
+    bucketName?: string;
+    multiple?: boolean;
+    maxSize?: number;
+    listType?: 'text' | 'picture' | 'picture-card';
+    showPreviewIcon?: boolean;
+    showRemoveIcon?: boolean;
+    showDownloadIcon?: boolean;
+}
+/** 子表单列定义 */
+interface SubFormColumn {
+    fieldId: string;
+    label: string;
+    componentName: string;
+    [key: string]: any;
+}
+/** SubFormField 专用 Props */
+interface SubFormFieldProps extends BaseFieldProps {
+    defaultValue?: Record<string, any>[];
+    columns: SubFormColumn[];
+    maxRows?: number;
+    minRows?: number;
+}
+/** 用户数据源项 */
+interface UserItem {
+    id: string;
+    name: string;
+    value?: string;
+    label?: string;
+    username?: string;
+    jobNumber?: string;
+    avatar?: string;
+    departments?: Array<{
+        id?: string;
+        name?: string;
+    }>;
+}
+type InitiatorSelectScope = 'all' | 'members' | 'roles';
+type InitiatorSelectedApprovers = Record<string, string[]>;
+interface InitiatorSelectCandidate extends UserItem {
+    phone?: string;
+    email?: string;
+}
+interface InitiatorSelectRequirement {
+    nodeId: string;
+    nodeName: string;
+    scope: InitiatorSelectScope;
+    approvals?: string[];
+    approvalNames?: string[];
+    multiApprove?: 'all' | 'or' | 'oneByOne';
+    candidateUsers?: InitiatorSelectCandidate[];
+    totalCandidates?: number;
+}
+/** UserSelectField 专用 Props */
+interface UserSelectFieldProps extends BaseFieldProps {
+    defaultValue?: UserItem[];
+    defaultShortcut?: PeopleShortcutConfig;
+    multiple?: boolean;
+    searchable?: boolean;
+    dataSource?: UserItem[];
+    treeData?: DepartmentTreeNode[];
+    allowClear?: boolean;
+    maxCount?: number;
+    notFoundContent?: string;
+    displayFormat?: UserDisplayFormat;
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+}
+/** 部门树节点 */
+interface DepartmentTreeNode {
+    id: string;
+    name: string;
+    value?: string;
+    label?: string;
+    key?: string;
+    title?: string;
+    hasChildren?: boolean;
+    isLeaf?: boolean;
+    children?: DepartmentTreeNode[];
+}
+/** DepartmentSelectField 专用 Props */
+interface DepartmentSelectFieldProps extends BaseFieldProps {
+    defaultValue?: {
+        id: string;
+        name: string;
+    }[];
+    defaultShortcut?: PeopleShortcutConfig;
+    multiple?: boolean;
+    treeData?: DepartmentTreeNode[];
+    allowClear?: boolean;
+    maxCount?: number;
+    notFoundContent?: string;
+    showFullPath?: boolean;
+    scopeType?: 'all' | 'specified';
+    specifiedDepts?: string[];
+    defaultValueLinkage?: DefaultValueLinkageConfig;
+}
+interface CascadeSelectFieldProps extends BaseFieldProps {
+    defaultValue?: OptionItem[] | OptionItem[][];
+    options?: Array<OptionItem & {
+        children?: any[];
+        isLeaf?: boolean;
+    }>;
+    multiple?: boolean;
+    allowClear?: boolean;
+    changeOnSelect?: boolean;
+    showSearch?: boolean;
+    fieldNames?: {
+        label?: string;
+        value?: string;
+        children?: string;
+    };
+}
+interface AddressValue {
+    country?: OptionItem;
+    province?: OptionItem;
+    city?: OptionItem;
+    district?: OptionItem;
+    street?: OptionItem;
+    detail?: string;
+    fullAddress?: string;
+}
+interface AddressFieldProps extends BaseFieldProps {
+    defaultValue?: AddressValue;
+    mode?: 'province-city' | 'province-city-district' | 'province-city-district-street' | 'province-city-district-street-detail';
+    detailPlaceholder?: string;
+    allowClear?: boolean;
+}
+interface AssociationFormConfig {
+    appType: string;
+    formUuid: string;
+    mainFieldId: string;
+    selectorColumns?: Array<string | {
+        title?: string;
+        dataIndex: string;
+        key?: string;
+        width?: number;
+        ellipsis?: boolean;
+    }>;
+    dataFilterRules?: Array<{
+        key: string;
+        operator?: string;
+        componentName?: string;
+        value?: string | number;
+        valueType?: 'manual' | 'currentField';
+        currentFieldKey?: string;
+    }>;
+    dataFilterConditionType?: 'AND' | 'OR';
+    dataFillingEnabled?: boolean;
+    dataFillingRules?: {
+        mainRules?: Array<{
+            source: string;
+            target: string;
+            sourceType?: string;
+            targetType?: string;
+        }>;
+    };
+}
+interface AssociationValue {
+    label: string;
+    value: string | number;
+    record?: Record<string, any>;
+}
+interface AssociationFormFieldProps extends BaseFieldProps {
+    defaultValue?: AssociationValue | AssociationValue[];
+    associationForm?: AssociationFormConfig;
+    multiple?: boolean;
+    allowClear?: boolean;
+    showSearch?: boolean;
+}
+type EditorToolbarAction = 'undo' | 'redo' | 'heading' | 'fontFamily' | 'fontSize' | 'bold' | 'italic' | 'underline' | 'strike' | 'superscript' | 'subscript' | 'color' | 'highlight' | 'bulletList' | 'orderedList' | 'taskList' | 'blockquote' | 'codeBlock' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'link' | 'image' | 'imageUrl' | 'table' | 'addColumnBefore' | 'addColumnAfter' | 'deleteColumn' | 'addRowBefore' | 'addRowAfter' | 'deleteRow' | 'toggleHeaderRow' | 'deleteTable' | 'clear';
+interface EditorChoiceOption {
+    label: string;
+    value: string;
+}
+interface EditorFieldProps extends BaseFieldProps {
+    defaultValue?: string;
+    rows?: number;
+    maxLength?: number;
+    height?: number | string;
+    toolbarConfig?: 'full' | 'basic' | 'minimal' | EditorToolbarAction[] | string[];
+    uploadBucketName?: string;
+    maxImageSize?: number;
+    allowedImageTypes?: string[];
+    fontFamilies?: EditorChoiceOption[];
+    fontSizes?: EditorChoiceOption[];
+    colorPresets?: string[];
+}
+interface SerialNumberFieldProps extends BaseFieldProps {
+    defaultValue?: string;
+    serialNumberRule?: Array<Record<string, any>>;
+}
+interface LocationValue {
+    latitude: number;
+    longitude: number;
+    address?: string;
+    city?: string;
+    district?: string;
+    province?: string;
+    name?: string;
+    accuracy?: number;
+    source?: 'browser' | 'dingTalk' | 'manual';
+    time?: number;
+}
+interface LocationFieldProps extends BaseFieldProps {
+    defaultValue?: LocationValue;
+    allowClear?: boolean;
+    locateButtonText?: string;
+    clearButtonText?: string;
+}
+interface SignaturePoint {
+    x: number;
+    y: number;
+    t: number;
+}
+interface DigitalSignatureValue {
+    url?: string;
+    bucketName?: string;
+    objectName?: string;
+    previewUrl?: string;
+    points?: SignaturePoint[];
+    timestamp?: number;
+    hash?: string;
+}
+interface DigitalSignatureFieldProps extends BaseFieldProps {
+    defaultValue?: DigitalSignatureValue;
+    bucketName?: string;
+    allowClear?: boolean;
+}
+interface JSONFieldProps extends BaseFieldProps {
+    defaultValue?: any;
+}
+/** 流程状态 */
+type ProcessStatus = 'running' | 'waiting' | 'exception' | 'completed' | 'terminated' | 'withdrawn' | 'pending' | 'cancelled';
+/** 任务状态 */
+type TaskStatus = 'pending' | 'approved' | 'rejected' | 'returned' | 'suspended' | 'cancelled' | 'copied' | 'waiting' | 'simulated';
+/** 流程任务节点类型 */
+type ProcessNodeType = 'start' | 'approval' | 'copy' | 'end' | 'system' | 'originator_return' | 'callback_wait';
+/** 审批操作类型 */
+type ApprovalActionType = 'agree' | 'approved' | 'rejected' | 'reject' | 'transfer' | 'return' | 'save' | 'withdraw' | 'resubmit' | 'callback';
+/** 流程操作动作定义 */
+interface ProcessAction {
+    action: ApprovalActionType;
+    name: {
+        zh_CN: string;
+        en_US?: string;
+    };
+    text?: {
+        zh_CN?: string;
+        en_US?: string;
+    };
+    hidden?: boolean;
+    remark?: {
+        popUp: boolean;
+        required?: boolean;
+        content?: {
+            zh_CN: string;
+            en_US?: string;
+        };
+    };
+}
+/** 流程任务 */
+interface ProcessTask {
+    id?: string;
+    taskId: string;
+    nodeId: string;
+    nodeVisitId?: string;
+    nodeType: ProcessNodeType;
+    nodeName: string;
+    title?: string;
+    status: TaskStatus;
+    canApprove?: boolean;
+    assigneeId?: string;
+    assignee?: string;
+    assigneeName?: string;
+    departmentName?: string;
+    comments?: string;
+    createdAt?: string;
+    actionAt?: string;
+    actions?: ProcessAction[];
+    isSimulated?: boolean;
+    multiApproveMode?: 'and' | 'or' | string;
+}
+/** 流程基本信息 */
+interface ProcessBasicInfo {
+    instanceId: string;
+    processStatus: ProcessStatus;
+    formUuid: string;
+    appType: string;
+    title?: string;
+    originatorId: string;
+    originatorName: string;
+    originatorDepartment?: string;
+    createdAt: string;
+    currentTask?: ProcessTask;
+    isExecuting?: boolean;
+}
+/** 审批权限 */
+interface ApprovalPermission {
+    hasPermission: boolean;
+    canUndo: boolean;
+    isApprover: boolean;
+    currentTasks?: ProcessTask[];
+    futureTasksCount?: number;
+    details?: string;
+}
+/** 可退回节点 */
+interface ReturnableNode {
+    nodeId: string;
+    nodeName: string;
+    id?: string;
+    name?: string;
+    type?: string;
+}
+interface ReturnPolicy {
+    resubmitMode?: string;
+    [key: string]: any;
+}
+interface ReturnableNodeResult {
+    nodes: ReturnableNode[];
+    policy?: ReturnPolicy | null;
+}
+/** 流程预览路由 */
+interface ProcessRoute {
+    nodeId: string;
+    nodeName: string;
+    nodeType: ProcessNodeType;
+    assignees: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/** 流程定义 */
+interface ProcessDefinition {
+    processId: string;
+    flowConfig?: Record<string, Record<string, FieldBehavior>>;
+    startNodeId?: string;
+    nodes?: Array<Record<string, any>>;
+    definitionJson?: Record<string, any>;
+    viewJson?: Record<string, any>;
+}
+/** 视图权限摘要 */
+interface ViewPermissionSummary {
+    fieldPermissions: Record<string, 'FORM_FILED_HIDDEN' | 'FORM_FILED_VIEW' | 'FORM_FILED_EDIT'>;
+    operations: string[];
+}
+/** 表单实例数据 */
+interface FormInstanceData {
+    formInstanceId: string;
+    formUuid: string;
+    appType: string;
+    title?: string;
+    instanceTitle?: string;
+    data: Record<string, any>;
+    creator?: {
+        userId: string;
+        name: string;
+        avatar?: string;
+        department?: string;
+    };
+    createdBy?: string;
+    createdByName?: string;
+    createdByDepartmentId?: string;
+    createdByDepartmentName?: string;
+    createdAt: string;
+    updatedAt?: string;
+}
+/** 变更记录 */
+interface ChangeRecord {
+    id: string;
+    fieldId: string;
+    fieldLabel: string;
+    oldValue: any;
+    newValue: any;
+    operatorId: string;
+    operatorName: string;
+    operatedAt: string;
+    operatorDepartmentName?: string;
+    operationId?: string;
+    changeType?: 'create' | 'update' | 'delete' | string;
+    changeSource?: string;
+    changedCount?: number;
+    createdAt?: string;
+    changes?: Array<{
+        fieldKey?: string;
+        fieldLabel?: string;
+        beforeValue?: any;
+        afterValue?: any;
+    }>;
+}
+/** 变更记录列表响应 */
+interface ChangeRecordListResponse {
+    records: ChangeRecord[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+interface ApproveParams {
+    instanceId: string;
+    action: 'approved' | 'rejected';
+    comments?: string;
+    appType?: string;
+    formUuid?: string;
+    updateFormDataJson?: string;
+}
+interface TransferParams {
+    taskId: string;
+    newAssignee: string;
+    reason?: string;
+}
+interface ReturnParams {
+    taskId: string;
+    targetNodeId: string;
+    reason?: string;
+}
+interface WithdrawParams {
+    instanceId: string;
+    reason?: string;
+}
+interface SaveTaskParams {
+    instanceId: string;
+    formUuid: string;
+    appType: string;
+    updateFormDataJson: string;
+}
+interface ResubmitParams {
+    taskId: string;
+    formUuid: string;
+    appType: string;
+    updateFormDataJson: string;
+    comments?: string;
+    selectedApprovers?: InitiatorSelectedApprovers;
+    initiatorSelectedApprovers?: InitiatorSelectedApprovers;
+}
+interface PreviewParams {
+    formUuid: string;
+    appType: string;
+    data: Record<string, any>;
+    submissionDepartmentId?: string;
+    selectedApprovers?: InitiatorSelectedApprovers;
+    initiatorSelectedApprovers?: InitiatorSelectedApprovers;
+}
+interface FormDataQueryParams {
+    formInstanceId: string;
+    appType: string;
+    formUuid: string;
+}
+interface FormDataDeleteParams {
+    formInstanceId: string;
+    appType: string;
+    formUuid: string;
+}
+interface ChangeRecordQueryParams {
+    formUuid: string;
+    appType: string;
+    formInstanceId: string;
+    page?: number;
+    pageSize?: number;
+}
+interface ViewPermissionQueryParams {
+    formUuid: string;
+    appType: string;
+    formInstanceId?: string;
+}
+/** 状态元信息（用于 UI 渲染） */
+interface StatusMeta {
+    label: string;
+    tone: 'brand' | 'success' | 'danger' | 'neutral' | 'warning';
+}
+
+export { FormSection as $, type AddressFieldProps as A, type BaseFieldProps as B, type CascadeDateFieldProps as C, type DataFilter as D, type DigitalSignatureValue as E, type EditorChoiceOption as F, type EditorFieldProps as G, type EditorToolbarAction as H, type FieldBehavior as I, type FieldDefinition as J, type FieldLayoutNode as K, type FieldValueSyncConfig as L, type FormAppearanceConfig as M, type FormDataDeleteParams as N, type FormDataQueryParams as O, type FormEffect as P, type FormEffectAction as Q, type FormEffectCondition as R, type FormEffectConditionOperator as S, type FormEngineConfig as T, type FormEngineMode as U, type FormInstanceData as V, type FormLayoutNode as W, type FormRuntimeApi as X, type FormRuntimeApiConfig as Y, type FormRuntimeConfig as Z, type FormSchema as _, type AddressValue as a, type UserItem as a$, type FormSectionProps as a0, type FormTemplateConfig as a1, type GridLayoutCell as a2, type GridLayoutNode as a3, type ImageFieldProps as a4, type InitiatorSelectCandidate as a5, type InitiatorSelectRequirement as a6, type InitiatorSelectScope as a7, type InitiatorSelectedApprovers as a8, type JSONFieldProps as a9, type ReturnPolicy as aA, type ReturnableNode as aB, type ReturnableNodeResult as aC, type RuntimeDataQueryParams as aD, type RuntimeDataQueryResult as aE, type RuntimeRequestConfig as aF, type RuntimeResponse as aG, type SaveTaskParams as aH, type SectionLayoutNode as aI, type SelectFieldProps as aJ, type SerialNumberFieldProps as aK, type SignaturePoint as aL, type StandardFormPageMode as aM, type StatusMeta as aN, type StepLayoutItem as aO, type StepsLayoutNode as aP, type SubFormColumn as aQ, type SubFormFieldProps as aR, type TabLayoutItem as aS, type TabsLayoutNode as aT, type TaskStatus as aU, type TextAreaFieldProps as aV, type TextFieldProps as aW, type TextShortcutConfig as aX, type TextShortcutType as aY, type TransferParams as aZ, type UserDisplayFormat as a_, type LayoutVisibleWhen as aa, type LinkedFormOptionConfig as ab, type LocationFieldProps as ac, type LocationValue as ad, type LowcodePageMeta as ae, type LowcodePageNode as af, type LowcodePageNodeType as ag, type LowcodePageSchema as ah, type MultiSelectFieldProps as ai, type NumberFieldProps as aj, type OptionItem as ak, type OptionSourceConfig as al, type OptionSourceType as am, type PeopleShortcutConfig as an, type PeopleShortcutType as ao, type PreviewParams as ap, type ProcessAction as aq, type ProcessBasicInfo as ar, type ProcessDefinition as as, type ProcessNodeType as at, type ProcessRoute as au, type ProcessStatus as av, type ProcessTask as aw, type RadioFieldProps as ax, type ResubmitParams as ay, type ReturnParams as az, type ApprovalActionType as b, type UserSelectFieldProps as b0, type ValidationPreset as b1, type ValidationRule as b2, type ViewPermissionQueryParams as b3, type ViewPermissionSummary as b4, type WithdrawParams as b5, type ApprovalPermission as c, type ApproveParams as d, type AssociationFormConfig as e, type AssociationFormFieldProps as f, type AssociationValue as g, type AttachmentFieldProps as h, type AttachmentItem as i, type BaseLayoutNode as j, type CascadeSelectFieldProps as k, type ChangeRecord as l, type ChangeRecordListResponse as m, type ChangeRecordQueryParams as n, type CheckboxFieldProps as o, type DataLinkageCondition as p, type DataLinkageConfig as q, type DateFieldProps as r, type DateRangeRestriction as s, type DateRestrictionConfig as t, type DateShortcutConfig as u, type DateShortcutType as v, type DefaultValueLinkageConfig as w, type DepartmentSelectFieldProps as x, type DepartmentTreeNode as y, type DigitalSignatureFieldProps as z };