/**
 * 该文件为脚本自动生成文件，请勿随意修改。如需修改请联系 PMC
 * */
import { IsEmailOptions } from 'validator/es/lib/isEmail';
import { IsURLOptions } from 'validator/es/lib/isURL';
import type { TNode, FormResetEvent, FormSubmitEvent } from '../common';
export interface TdFormProps<FormData extends Data = Data> {
    /**
     * 是否在表单标签字段右侧显示冒号
     * @default false
     */
    colon?: boolean;
    /**
     * 表单内容对齐方式：左对齐、右对齐
     * @default left
     */
    contentAlign?: 'left' | 'right';
    /**
     * 是否禁用整个表单
     */
    disabled?: boolean;
    /**
     * 表单错误信息配置，示例：`{ idcard: '请输入正确的身份证号码', max: '字符长度不能超过 ${max}' }`
     */
    errorMessage?: FormErrorMessage;
    /**
     * 经 `Form.useForm()` 创建的 form 控制实例
     */
    form?: FormInstanceFunctions;
    /**
     * 表单原生的id属性，支持用于配合非表单内的按钮通过form属性来触发表单事件
     */
    id?: string;
    /**
     * 表单初始数据，重置时所需初始数据，优先级小于 FormItem 设置的 initialData
     */
    initialData?: object;
    /**
     * 表单字段标签对齐方式：左对齐、右对齐、顶部对齐
     * @default right
     */
    labelAlign?: 'left' | 'right' | 'top';
    /**
     * 可以整体设置label标签宽度，默认为81px
     * @default '81px'
     */
    labelWidth?: string | number;
    /**
     * 是否阻止表单提交默认事件（表单提交默认事件会刷新页面），设置为 `true` 可以避免刷新
     * @default true
     */
    preventSubmitDefault?: boolean;
    /**
     * 是否整个表单只读
     */
    readonly?: boolean;
    /**
     * 是否显示必填符号（*），默认显示
     */
    requiredMark?: boolean;
    /**
     * 表单必填符号（*）显示位置
     */
    requiredMarkPosition?: 'left' | 'right';
    /**
     * 重置表单的方式，值为 empty 表示重置表单为空，值为 initial 表示重置表单数据为初始值
     * @default empty
     */
    resetType?: 'empty' | 'initial';
    /**
     * 表单字段校验规则
     */
    rules?: FormRules<FormData>;
    /**
     * 表单校验不通过时，是否自动滚动到第一个校验不通过的字段，平滑滚动或是瞬间直达。值为空则表示不滚动
     */
    scrollToFirstError?: '' | 'smooth' | 'auto';
    /**
     * 校验不通过时，是否显示错误提示信息，统一控制全部表单项。如果希望控制单个表单项，请给 FormItem 设置该属性
     * @default true
     */
    showErrorMessage?: boolean;
    /**
     * 【讨论中】当校验结果只有告警信息时，是否触发 `submit` 提交事件
     * @default false
     */
    submitWithWarningMessage?: boolean;
    /**
     * 表单重置时触发
     */
    onReset?: (context: {
        e?: FormResetEvent;
    }) => void;
    /**
     * 表单提交时触发。其中 `context.validateResult` 表示校验结果，`context.firstError` 表示校验不通过的第一个规则提醒。`context.validateResult` 值为 `true` 表示校验通过；如果校验不通过，`context.validateResult` 值为校验结果列表。<br />【注意】⚠️ 默认情况，输入框按下 Enter 键会自动触发提交事件，如果希望禁用这个默认行为，可以给输入框添加  enter 事件，并在事件中设置 `e.preventDefault()`
     */
    onSubmit?: (context: SubmitContext<FormData>) => void;
    /**
     * 校验结束后触发，result 值为 true 表示校验通过；如果校验不通过，result 值为校验结果列表
     */
    onValidate?: (result: ValidateResultContext<FormData>) => void;
    /**
     * 字段值更新时触发的回调事件
     */
    onValuesChange?: (changedValues: Record<string, unknown>, allValues: Record<string, unknown>) => void;
}
/** 组件实例方法 */
export interface FormInstanceFunctions<FormData extends Data = Data> {
    /**
     * 清空校验结果。可使用 fields 指定清除部分字段的校验结果，fields 值为空则表示清除所有字段校验结果。清除邮箱校验结果示例：`clearValidate(['email'])`
     */
    clearValidate: (fields?: Array<keyof FormData>) => void;
    /**
     * 获取 form dom 元素
     */
    currentElement?: () => HTMLFormElement;
    /**
     * 获取 form dom 元素
     */
    getCurrentElement?: () => HTMLFormElement;
    /**
     * 获取单个字段值
     */
    getFieldValue: (field: NamePath) => unknown;
    /**
     * 获取一组字段名对应的值，当调用 getFieldsValue(true) 时返回所有表单数据
     */
    getFieldsValue: (nameList: string[] | boolean) => getFieldsValue<FormData>;
    /**
     * 获取校验结果，当调用 getValidateMessage() 时返回所有校验结果
     */
    getValidateMessage: (fields?: Array<keyof FormData>) => Array<FormRule> | void;
    /**
     * 重置表单，表单里面没有重置按钮`<button type=\"reset\" />`时可以使用该方法，默认重置全部字段为空，该方法会触发 `reset` 事件。<br />如果表单属性 `resetType='empty'` 或者 `reset.type='empty'` 会重置为空；<br />如果表单属性 `resetType='initial'` 或者 `reset.type='initial'` 会重置为表单初始值。<br />`reset.fields` 用于设置具体重置哪些字段，示例：`reset({ type: 'initial', fields: ['name', 'age'] })`
     */
    reset: (params?: FormResetParams<FormData>) => void;
    /**
     * 设置多组字段状态
     */
    setFields: (fields: FieldData[]) => void;
    /**
     * 设置表单字段值
     */
    setFieldsValue: (field: Data) => void;
    /**
     * 设置自定义校验结果，如远程校验信息直接呈现。注意需要在组件挂载结束后使用该方法。`FormData` 指表单数据泛型
     */
    setValidateMessage: (message: FormValidateMessage<FormData>) => void;
    /**
     * 提交表单，表单里面没有提交按钮`<button type=\"submit\" />`时可以使用该方法。`showErrorMessage` 表示是否在提交校验不通过时显示校验不通过的原因，默认显示。该方法会触发 `submit` 事件
     */
    submit: (params?: {
        showErrorMessage?: boolean;
    }) => void;
    /**
     * 校验函数，包含错误文本提示等功能。泛型 `FormData` 表示表单数据 TS 类型。<br/>【关于参数】`params.fields` 表示校验字段，如果设置了 `fields`，本次校验将仅对这些字段进行校验。`params.trigger` 表示本次触发校验的范围，'params.trigger = blur' 表示只触发校验规则设定为 trigger='blur' 的字段，'params.trigger = change' 表示只触发校验规则设定为 trigger='change' 的字段，默认触发全范围校验。`params.showErrorMessage` 表示校验结束后是否显示错误文本提示，默认显示。<br />【关于返回值】返回值为 true 表示校验通过；如果校验不通过，返回值为校验结果列表
     */
    validate: (params?: FormValidateParams) => Promise<FormValidateResult<FormData>>;
    /**
     * 纯净的校验函数，仅返回校验结果，不对组件进行任何操作。泛型 `FormData` 表示表单数据 TS 类型。参数和返回值含义同 `validate` 方法
     */
    validateOnly: (params?: Pick<FormValidateParams, 'fields' | 'trigger'>) => Promise<FormValidateResult<FormData>>;
}
export interface TdFormItemProps {
    /**
     * 是否显示右侧箭头
     * @default false
     */
    arrow?: boolean;
    /**
     * 表单内容对齐方式，优先级高于 Form.contentAlign
     */
    contentAlign?: 'left' | 'right';
    /**
     * label 原生属性
     * @default ''
     */
    for?: string;
    /**
     * 表单项说明内容
     */
    help?: TNode;
    /**
     * 表单初始数据，重置时所需初始数据
     */
    initialData?: InitialData;
    /**
     * 字段标签名称
     * @default ''
     */
    label?: TNode;
    /**
     * 表单字段标签对齐方式：左对齐、右对齐、顶部对齐。默认使用 Form 的对齐方式，优先级高于 Form.labelAlign
     */
    labelAlign?: 'left' | 'right' | 'top';
    /**
     * 可以整体设置标签宽度，优先级高于 Form.labelWidth
     */
    labelWidth?: string | number;
    /**
     * 表单字段名称
     */
    name?: NamePath;
    /**
     * 是否显示必填符号（*），优先级高于 Form.requiredMark
     */
    requiredMark?: boolean;
    /**
     * 表单字段校验规则
     */
    rules?: Array<FormRule>;
    /**
     * null
     * @default false
     */
    shouldUpdate?: boolean | ((prevValue: any, curValue: any) => boolean);
    /**
     * 校验不通过时，是否显示错误提示信息，优先级高于 `Form.showErrorMessage`
     */
    showErrorMessage?: boolean;
}
export interface FormRule {
    /**
     * 内置校验方法，校验值类型是否为布尔类型，示例：`{ boolean: true, message: '数据类型必须是布尔类型' }`
     */
    boolean?: boolean;
    /**
     * 内置校验方法，校验值是否为日期格式，[参数文档](https://github.com/validatorjs/validator.js)，示例：`{ date: { delimiters: '-' }, message: '日期分隔线必须是短横线（-）' }`
     */
    date?: boolean | IsDateOptions;
    /**
     * 内置校验方法，校验值是否为邮件格式，[参数文档](https://github.com/validatorjs/validator.js)，示例：`{ email: { ignore_max_length: true }, message: '请输入正确的邮箱地址' }`
     */
    email?: boolean | IsEmailOptions;
    /**
     * 内置校验方法，校验值是否属于枚举值中的值。示例：`{ enum: ['primary', 'info', 'warning'], message: '值只能是 primary/info/warning 中的一种' }`
     */
    enum?: Array<string>;
    /**
     * 内置校验方法，校验值是否为身份证号码，组件校验正则为 `/^(\\d{18,18}|\\d{15,15}|\\d{17,17}x)$/i`，示例：`{ idcard: true, message: '请输入正确的身份证号码' }`
     */
    idcard?: boolean;
    /**
     * 内置校验方法，校验值固定长度，如：len: 10 表示值的字符长度只能等于 10 ，中文表示 2 个字符，英文为 1 个字符。示例：`{ len: 10, message: '内容长度不对' }`。<br />如果希望字母和中文都是同样的长度，示例：`{ validator: (val) => val.length === 10, message: '内容文本长度只能是 10 个字' }`
     */
    len?: number | boolean;
    /**
     * 内置校验方法，校验值最大长度，如：max: 100 表示值最多不能超过 100 个字符，中文表示 2 个字符，英文为 1 个字符。示例：`{ max: 10, message: '内容超出' }`。<br />如果希望字母和中文都是同样的长度，示例：`{ validator: (val) => val.length <= 10, message: '内容文本长度不能超过 10 个字' }`<br />如果数据类型数字（Number），则自动变为数字大小的比对
     */
    max?: number | boolean;
    /**
     * 校验未通过时呈现的错误信息，值为空则不显示
     * @default ''
     */
    message?: string;
    /**
     * 内置校验方法，校验值最小长度，如：min: 10 表示值最多不能少于 10 个字符，中文表示 2 个字符，英文为 1 个字符。示例：`{ min: 10, message: '内容长度不够' }`。<br />如果希望字母和中文都是同样的长度，示例：`{ validator: (val) => val.length >= 10, message: '内容文本长度至少为 10 个字' }`。<br />如果数据类型数字（Number），则自动变为数字大小的比对
     */
    min?: number | boolean;
    /**
     * 内置校验方法，校验值是否为数字（1.2 、 1e5  都算数字），示例：`{ number: true, message: '请输入数字' }`
     */
    number?: boolean;
    /**
     * 内置校验方法，校验值是否符合正则表达式匹配结果，示例：`{ pattern: /@qq.com/, message: '请输入 QQ 邮箱' }`
     */
    pattern?: RegExp | string;
    /**
     * 内置校验方法，校验值是否已经填写。该值为 true，默认显示必填标记，可通过设置 `requiredMark: false` 隐藏必填标记
     */
    required?: boolean;
    /**
     * 内置校验方法，校验值是否为手机号码，校验正则为 `/^1[3-9]\d{9}$/`，示例：`{ telnumber: true, message: '请输入正确的手机号码' }`
     */
    telnumber?: boolean;
    /**
     * 校验触发方式
     * @default change
     */
    trigger?: ValidateTriggerType;
    /**
     * 校验未通过时呈现的错误信息类型，有 告警信息提示 和 错误信息提示 等两种
     * @default error
     */
    type?: 'error' | 'warning';
    /**
     * 内置校验方法，校验值是否为网络链接地址，[参数文档](https://github.com/validatorjs/validator.js)，示例：`{ url: { protocols: ['http','https','ftp'] }, message: '请输入正确的 Url 地址' }`
     */
    url?: boolean | IsURLOptions;
    /**
     * 自定义校验规则，context 中 formData 为当前完整表单值，name为该字段的标识，示例：`{ validator: (val) => val.length > 0, message: '请输入内容'}`
     */
    validator?: CustomValidator;
    /**
     * 内置校验方法，校验值是否为空格。示例：`{ whitespace: true, message: '值不能为空' }`
     */
    whitespace?: boolean;
}
export interface FormErrorMessage {
    /**
     * 布尔类型校验不通过时的表单项显示文案，全局配置默认是：`'${name}数据类型必须是布尔类型'`
     * @default ''
     */
    boolean?: string;
    /**
     * 日期校验规则不通过时的表单项显示文案，全局配置默认是：`'请输入正确的${name}'`
     * @default ''
     */
    date?: string;
    /**
     * 枚举值校验规则不通过时的表单项显示文案，全局配置默认是：`${name}只能是${validate}等`
     * @default ''
     */
    enum?: string;
    /**
     * 身份证号码校验不通过时的表单项显示文案，全局配置默认是：`'请输入正确的${name}'`
     * @default ''
     */
    idcard?: string;
    /**
     * 值长度校验不通过时的表单项显示文案，全局配置默认是：`'${name}字符长度必须是 ${validate}'`
     * @default ''
     */
    len?: string;
    /**
     * 值的长度太长或值本身太大时，校验不通过的表单项显示文案，全局配置默认是：`'${name}字符长度不能超过 ${validate} 个字符，一个中文等于两个字符'`
     * @default ''
     */
    max?: string;
    /**
     * 值的长度太短或值本身太小时，校验不通过的表单项显示文案，全局配置默认是：`'${name}字符长度不能少于 ${validate} 个字符，一个中文等于两个字符'`
     * @default ''
     */
    min?: string;
    /**
     * 数字类型校验不通过时的表单项显示文案，全局配置默认是：`'${name}必须是数字'`
     * @default ''
     */
    number?: string;
    /**
     * 正则表达式校验不通过时的表单项显示文案，全局配置默认是：`'请输入正确的${name}'`
     * @default ''
     */
    pattern?: string;
    /**
     * 没有填写必填项时的表单项显示文案，全局配置默认是：`'${name}必填'`
     * @default ''
     */
    required?: string;
    /**
     * 手机号号码校验不通过时的表单项显示文案，全局配置默认是：`'请输入正确的${name}'`
     * @default ''
     */
    telnumber?: string;
    /**
     * 链接校验规则不通过时的表单项显示文案，全局配置默认是：`'请输入正确的${name}'`
     * @default ''
     */
    url?: string;
    /**
     * 自定义校验规则校验不通过时的表单项显示文案，全局配置默认是：'${name}不符合要求'
     * @default ''
     */
    validator?: string;
    /**
     * 值为空格校验不通过时表单项显示文案，全局配置默认是：`'${name}不能为空`
     * @default ''
     */
    whitespace?: string;
}
export type FormRules<T extends Data = any> = {
    [field in keyof T]?: Array<FormRule>;
};
export interface SubmitContext<T extends Data = Data> {
    e?: FormSubmitEvent;
    validateResult: FormValidateResult<T>;
    firstError?: string;
    fields?: any;
}
export type FormValidateResult<T> = boolean | ValidateResultObj<T>;
export type ValidateResultObj<T> = {
    [key in keyof T]: boolean | ValidateResultList;
};
export type ValidateResultList = Array<AllValidateResult>;
export type AllValidateResult = CustomValidateObj | ValidateResultType;
export interface ValidateResultType extends FormRule {
    result: boolean;
}
export type ValidateResult<T> = {
    [key in keyof T]: boolean | ErrorList;
};
export type ErrorList = Array<FormRule>;
export type ValidateResultContext<T extends Data> = Omit<SubmitContext<T>, 'e'>;
export interface getFieldsValue<T> {
    (nameList: true): T;
    (nameList: any[]): Record<keyof T, unknown>;
}
export interface FormResetParams<FormData> {
    type?: 'initial' | 'empty';
    fields?: Array<keyof FormData>;
}
export interface FieldData {
    name: NamePath;
    value?: unknown;
    status?: string;
    validateMessage?: {
        type?: string;
        message?: string;
    };
}
export type FormValidateMessage<FormData> = {
    [field in keyof FormData]: FormItemValidateMessage[];
};
export interface FormItemValidateMessage {
    type: 'warning' | 'error';
    message: string;
}
export interface FormValidateParams {
    fields?: Array<string>;
    showErrorMessage?: boolean;
    trigger?: ValidateTriggerType;
}
export type ValidateTriggerType = 'blur' | 'change' | 'submit' | 'all';
export type Data = {
    [key: string]: any;
};
export type InitialData = any;
export type NamePath = string | number | Array<string | number>;
export interface IsDateOptions {
    format: string;
    strictMode: boolean;
    delimiters: string[];
}
export type CustomValidator = (val: ValueType, context?: {
    formData: Data;
    name: string;
}) => CustomValidateResolveType | Promise<CustomValidateResolveType>;
export type CustomValidateResolveType = boolean | CustomValidateObj;
export interface CustomValidateObj {
    result: boolean;
    message: string;
    type?: 'error' | 'warning' | 'success';
}
export type ValueType = any;