fast-element-plus 1.0.21 → 2.0.1

package/dist/components/form/src/form.mjs

@@ -0,0 +1,119 @@
+import { useEmits } from "../../../utils/vue/emits.mjs";
+import { useExpose } from "../../../utils/vue/expose.mjs";
+import { definePropType, useProps } from "../../../utils/vue/props.mjs";
+import { useRender } from "../../../utils/vue/render.mjs";
+import { makeSlots } from "../../../utils/vue/slots.mjs";
+import { FaLayoutGrid } from "../../layoutGrid/index.mjs";
+import { formUtil } from "../utils/form.mjs";
+import { computed, createVNode, defineComponent, mergeProps, provide, reactive, ref } from "vue";
+import { ElForm, formEmits, formProps, useGlobalSize } from "element-plus";
+import { isNumber, isObject } from "lodash-unified";
+//#region src/components/form/src/form.tsx
+/** FaForm 的运行时 Props 定义。 */
+const faFormProps = {
+	...formProps,
+	/** @description Width of label, e.g. `'50px'`. All its direct child form items will inherit this value. `auto` is supported. */
+	labelWidth: {
+		type: [String, Number],
+		default: "auto"
+	},
+	/** @description Suffix of the label. */
+	labelSuffix: {
+		type: String,
+		default: "："
+	},
+	/** @description When validation fails, scroll to the first error form entry. */
+	scrollToError: {
+		type: Boolean,
+		default: true
+	},
+	/** @description 详情From，会删除 FormItem 的 paddinfa-bottom */
+	detailForm: Boolean,
+	/** @description Grid布局*/
+	grid: {
+		type: Boolean,
+		default: true
+	},
+	/** @description Grid布局列配置 */
+	cols: {
+		type: definePropType([
+			String,
+			Number,
+			Object
+		]),
+		default: () => ({
+			xs: 1,
+			sm: 2,
+			md: 3,
+			lg: 4,
+			xl: 5
+		})
+	}
+};
+/** FaForm 的运行时事件定义。 */
+const faFormEmits = { ...formEmits };
+var form_default = defineComponent({
+	name: "FaForm",
+	props: faFormProps,
+	emits: faFormEmits,
+	slots: makeSlots(),
+	setup(props, { slots, expose, emit }) {
+		const _globalSize = useGlobalSize();
+		const state = reactive({
+			cols: computed(() => {
+				if (isObject(props.cols)) return props.cols;
+				else {
+					const colsNumber = isNumber(props.cols) ? props.cols : Number(props.cols);
+					return {
+						xs: 1,
+						sm: colsNumber,
+						md: colsNumber,
+						lg: colsNumber,
+						xl: colsNumber
+					};
+				}
+			}),
+			gap: computed(() => _globalSize.value === "small" ? [15, 0] : [20, 0])
+		});
+		const formRef = ref();
+		provide("faFormCols", state.cols);
+		const elFormProps = useProps(props, formProps);
+		const elFormEmits = useEmits(formEmits, emit);
+		useRender(() => createVNode(ElForm, mergeProps(elFormProps.value, elFormEmits.value, {
+			"ref": formRef,
+			"class": [
+				"fa-form",
+				`fa-form-${_globalSize.value}`,
+				{ [`fa-form-detail fa-form-detail_${_globalSize.value}`]: props.detailForm }
+			]
+		}), { default: () => props.grid ? createVNode(FaLayoutGrid, {
+			"collapsed": true,
+			"gap": state.gap,
+			"cols": state.cols
+		}, { default: () => [slots.default?.(state)] }) : slots.default?.(state) }));
+		return useExpose(expose, {
+			/** @description 对整个表单的内容进行验证。 接收一个回调函数，或返回 Promise。 */
+			validate: (callback) => callback ? formRef.value?.validate(callback) ?? Promise.reject(/* @__PURE__ */ new Error("ElForm 实例尚未挂载。")) : formUtil.validate(formRef),
+			/** @description 验证具体的某个字段。 */
+			validateField: computed(() => formRef.value?.validateField),
+			/** @description 重置该表单项，将其值重置为初始值，并移除校验结果 */
+			resetFields: computed(() => formRef.value?.resetFields),
+			/** @description 清理某个字段的表单验证信息。 */
+			clearValidate: computed(() => formRef.value?.clearValidate),
+			/** @description 滚动到指定的字段 */
+			scrollToField: computed(() => formRef.value?.scrollToField),
+			/** @description 获取所有字段的 context */
+			fields: computed(() => formRef.value?.fields),
+			/** @description 获取指定字段的 context。 */
+			getField: computed(() => formRef.value?.getField),
+			/** @description 设置表单字段的初始值。 */
+			setInitialValues: computed(() => formRef.value?.setInitialValues),
+			/** @description 对整个表单的内容进行验证，带滚动。 接收一个回调函数，或返回 Promise。 */
+			validateScrollToField: () => formUtil.validateScrollToField(formRef)
+		});
+	}
+});
+//#endregion
+export { form_default as default, faFormEmits, faFormProps };
+
+//# sourceMappingURL=form.mjs.map

package/dist/components/form/src/form.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.mjs","names":[],"sources":["../../../../src/components/form/src/form.tsx"],"sourcesContent":["import { computed, defineComponent, provide, reactive, ref } from \"vue\";\nimport { ElForm, formEmits, formProps, useGlobalSize } from \"element-plus\";\nimport { isNumber, isObject } from \"lodash-unified\";\nimport { definePropType, makeSlots, useEmits, useExpose, useProps, useRender } from \"../../../utils\";\nimport { FaLayoutGrid } from \"../../layoutGrid\";\nimport { formUtil } from \"../utils/form\";\nimport type { FaLayoutGridBreakPoint } from \"../../layoutGrid\";\nimport type { FormInstance, FormItemContext, FormValidateCallback, FormValidationResult } from \"element-plus\";\n\n/** FaForm 的运行时 Props 定义。 */\nexport const faFormProps = {\n\t...formProps,\n\t/** @description Width of label, e.g. `'50px'`. All its direct child form items will inherit this value. `auto` is supported. */\n\tlabelWidth: {\n\t\ttype: [String, Number],\n\t\tdefault: \"auto\",\n\t},\n\t/** @description Suffix of the label. */\n\tlabelSuffix: {\n\t\ttype: String,\n\t\tdefault: \"：\",\n\t},\n\t/** @description When validation fails, scroll to the first error form entry. */\n\tscrollToError: {\n\t\ttype: Boolean,\n\t\tdefault: true,\n\t},\n\t/** @description 详情From，会删除 FormItem 的 paddinfa-bottom */\n\tdetailForm: Boolean,\n\t/** @description Grid布局*/\n\tgrid: {\n\t\ttype: Boolean,\n\t\tdefault: true,\n\t},\n\t/** @description Grid布局列配置 */\n\tcols: {\n\t\ttype: definePropType<string | number | Record<FaLayoutGridBreakPoint, number>>([String, Number, Object]),\n\t\tdefault: (): Record<FaLayoutGridBreakPoint, number> => ({ xs: 1, sm: 2, md: 3, lg: 4, xl: 5 }),\n\t},\n};\n\n/** FaForm 的运行时事件定义。 */\nexport const faFormEmits = {\n\t...formEmits,\n};\n\n/** FaForm 的插槽参数。 */\nexport interface FaFormSlots extends Record<string, unknown> {\n\t/** @description 默认内容插槽 */\n\tdefault: unknown;\n}\n\nexport default defineComponent({\n\tname: \"FaForm\",\n\tprops: faFormProps,\n\temits: faFormEmits,\n\tslots: makeSlots<FaFormSlots>(),\n\tsetup(props, { slots, expose, emit }) {\n\t\tconst _globalSize = useGlobalSize();\n\n\t\tconst state = reactive({\n\t\t\tcols: computed(() => {\n\t\t\t\tif (isObject(props.cols)) {\n\t\t\t\t\treturn props.cols;\n\t\t\t\t} else {\n\t\t\t\t\tconst colsNumber = isNumber(props.cols) ? props.cols : Number(props.cols);\n\t\t\t\t\treturn { xs: 1, sm: colsNumber, md: colsNumber, lg: colsNumber, xl: colsNumber };\n\t\t\t\t}\n\t\t\t}),\n\t\t\tgap: computed<[number, number]>(() => (_globalSize.value === \"small\" ? [15, 0] : [20, 0])),\n\t\t});\n\n\t\tconst formRef = ref<FormInstance>();\n\n\t\t// 注入 cols\n\t\tprovide(\"faFormCols\", state.cols);\n\n\t\tconst elFormProps = useProps(props, formProps);\n\t\tconst elFormEmits = useEmits(formEmits, emit);\n\n\t\tuseRender(() => (\n\t\t\t<ElForm\n\t\t\t\t{...elFormProps.value}\n\t\t\t\t{...elFormEmits.value}\n\t\t\t\tref={formRef}\n\t\t\t\tclass={[\"fa-form\", `fa-form-${_globalSize.value}`, { [`fa-form-detail fa-form-detail_${_globalSize.value}`]: props.detailForm }]}\n\t\t\t>\n\t\t\t\t{{\n\t\t\t\t\tdefault: () =>\n\t\t\t\t\t\tprops.grid ? (\n\t\t\t\t\t\t\t<FaLayoutGrid collapsed gap={state.gap} cols={state.cols}>\n\t\t\t\t\t\t\t\t{slots.default?.(state)}\n\t\t\t\t\t\t\t</FaLayoutGrid>\n\t\t\t\t\t\t) : (\n\t\t\t\t\t\t\tslots.default?.(state)\n\t\t\t\t\t\t),\n\t\t\t\t}}\n\t\t\t</ElForm>\n\t\t));\n\n\t\treturn useExpose(expose, {\n\t\t\t/** @description 对整个表单的内容进行验证。 接收一个回调函数，或返回 Promise。 */\n\t\t\tvalidate: (callback?: FormValidateCallback): FormValidationResult =>\n\t\t\t\tcallback ? (formRef.value?.validate(callback) ?? Promise.reject(new Error(\"ElForm 实例尚未挂载。\"))) : formUtil.validate(formRef),\n\t\t\t/** @description 验证具体的某个字段。 */\n\t\t\tvalidateField: computed(() => formRef.value?.validateField),\n\t\t\t/** @description 重置该表单项，将其值重置为初始值，并移除校验结果 */\n\t\t\tresetFields: computed(() => formRef.value?.resetFields),\n\t\t\t/** @description 清理某个字段的表单验证信息。 */\n\t\t\tclearValidate: computed(() => formRef.value?.clearValidate),\n\t\t\t/** @description 滚动到指定的字段 */\n\t\t\tscrollToField: computed(() => formRef.value?.scrollToField),\n\t\t\t/** @description 获取所有字段的 context */\n\t\t\tfields: computed(() => formRef.value?.fields as FormItemContext[]),\n\t\t\t/** @description 获取指定字段的 context。 */\n\t\t\tgetField: computed(() => formRef.value?.getField),\n\t\t\t/** @description 设置表单字段的初始值。 */\n\t\t\tsetInitialValues: computed(() => formRef.value?.setInitialValues),\n\t\t\t/** @description 对整个表单的内容进行验证，带滚动。 接收一个回调函数，或返回 Promise。 */\n\t\t\tvalidateScrollToField: (): FormValidationResult => formUtil.validateScrollToField(formRef),\n\t\t});\n\t},\n});\n"],"mappings":";;;;;;;;;;;;AAUA,MAAa,cAAc;CAC1B,GAAG;;CAEH,YAAY;EACX,MAAM,CAAC,QAAQ,MAAM;EACrB,SAAS;CACV;;CAEA,aAAa;EACZ,MAAM;EACN,SAAS;CACV;;CAEA,eAAe;EACd,MAAM;EACN,SAAS;CACV;;CAEA,YAAY;;CAEZ,MAAM;EACL,MAAM;EACN,SAAS;CACV;;CAEA,MAAM;EACL,MAAM,eAAyE;GAAC;GAAQ;GAAQ;EAAM,CAAC;EACvG,gBAAwD;GAAE,IAAI;GAAG,IAAI;GAAG,IAAI;GAAG,IAAI;GAAG,IAAI;EAAE;CAC7F;AACD;;AAGA,MAAa,cAAc,EAC1B,GAAG,UACJ;AAQA,IAAA,eAAe,gBAAgB;CAC9B,MAAM;CACN,OAAO;CACP,OAAO;CACP,OAAO,UAAuB;CAC9B,MAAM,OAAO,EAAE,OAAO,QAAQ,QAAQ;EACrC,MAAM,cAAc,cAAc;EAElC,MAAM,QAAQ,SAAS;GACtB,MAAM,eAAe;IACpB,IAAI,SAAS,MAAM,IAAI,GACtB,OAAO,MAAM;SACP;KACN,MAAM,aAAa,SAAS,MAAM,IAAI,IAAI,MAAM,OAAO,OAAO,MAAM,IAAI;KACxE,OAAO;MAAE,IAAI;MAAG,IAAI;MAAY,IAAI;MAAY,IAAI;MAAY,IAAI;KAAW;IAChF;GACD,CAAC;GACD,KAAK,eAAkC,YAAY,UAAU,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAE;EAC1F,CAAC;EAED,MAAM,UAAU,IAAkB;EAGlC,QAAQ,cAAc,MAAM,IAAI;EAEhC,MAAM,cAAc,SAAS,OAAO,SAAS;EAC7C,MAAM,cAAc,SAAS,WAAW,IAAI;EAE5C,gBAAU,YAAA,QAAA,WAEJ,YAAY,OACZ,YAAY,OAAK;GAAA,OAChB;GAAO,SACL;IAAC;IAAW,WAAW,YAAY;IAAS,GAAG,iCAAiC,YAAY,UAAU,MAAM,WAAW;GAAC;EAAC,CAAA,GAAA,EAG/H,eACC,MAAM,OAAI,YAAA,cAAA;GAAA,aAAA;GAAA,OACoB,MAAM;GAAG,QAAQ,MAAM;EAAI,GAAA,EAAA,eAAA,CACtD,MAAM,UAAU,KAAK,CAAC,EAAA,CAAA,IAGxB,MAAM,UAAU,KAAK,EACrB,CAAA,CAGJ;EAED,OAAO,UAAU,QAAQ;;GAExB,WAAW,aACV,WAAY,QAAQ,OAAO,SAAS,QAAQ,KAAK,QAAQ,uBAAO,IAAI,MAAM,gBAAgB,CAAC,IAAK,SAAS,SAAS,OAAO;;GAE1H,eAAe,eAAe,QAAQ,OAAO,aAAa;;GAE1D,aAAa,eAAe,QAAQ,OAAO,WAAW;;GAEtD,eAAe,eAAe,QAAQ,OAAO,aAAa;;GAE1D,eAAe,eAAe,QAAQ,OAAO,aAAa;;GAE1D,QAAQ,eAAe,QAAQ,OAAO,MAA2B;;GAEjE,UAAU,eAAe,QAAQ,OAAO,QAAQ;;GAEhD,kBAAkB,eAAe,QAAQ,OAAO,gBAAgB;;GAEhE,6BAAmD,SAAS,sBAAsB,OAAO;EAC1F,CAAC;CACF;AACD,CAAC"}

package/dist/components/form/src/formItem.d.ts

@@ -0,0 +1,208 @@
+/** FaFormItem 的运行时 Props 定义。 */
+export declare const faFormItemProps: {
+    /** @description Label tips 提示 */
+    tips: StringConstructor;
+    /** @description Grid 布局 */
+    grid: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** @description 偏移量 */
+    offset: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: number;
+    };
+    /** @description 栅格跨度 */
+    span: {
+        type: (NumberConstructor | StringConstructor)[];
+    };
+    /** @description 独占一行。如果设置 span 则无效 */
+    row: BooleanConstructor;
+    label: StringConstructor;
+    labelWidth: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<readonly [StringConstructor, NumberConstructor], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    labelPosition: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<StringConstructor, "" | "left" | "right" | "top", unknown, "", boolean>;
+    prop: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp) | (((new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    required: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    rules: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (... /** @description 验证表单项 */args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>) | (((new (...args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    error: StringConstructor;
+    validateStatus: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "success" | "error" | "validating", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    for: StringConstructor;
+    inlineMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    showMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+    size: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "default" | "small" | "large", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+};
+/** FaFormItem 的插槽参数。 */
+export interface FaFormItemSlots extends Record<string, unknown> {
+    /** @description 默认内容插槽 */
+    default: never;
+    /** @description 标签位置显示的内容 */
+    label: {
+        label: string;
+    };
+    /** @description 验证错误信息的显示内容 */
+    error: {
+        error: string;
+    };
+}
+declare const _default: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** @description Label tips 提示 */
+    tips: StringConstructor;
+    /** @description Grid 布局 */
+    grid: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** @description 偏移量 */
+    offset: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: number;
+    };
+    /** @description 栅格跨度 */
+    span: {
+        type: (NumberConstructor | StringConstructor)[];
+    };
+    /** @description 独占一行。如果设置 span 则无效 */
+    row: BooleanConstructor;
+    label: StringConstructor;
+    labelWidth: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<readonly [StringConstructor, NumberConstructor], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    labelPosition: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<StringConstructor, "" | "left" | "right" | "top", unknown, "", boolean>;
+    prop: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp) | (((new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    required: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    rules: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (... /** @description 验证表单项 */args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>) | (((new (...args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    error: StringConstructor;
+    validateStatus: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "success" | "error" | "validating", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    for: StringConstructor;
+    inlineMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    showMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+    size: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "default" | "small" | "large", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+}>, {
+    /** @description 表单项大小 */
+    size: import("vue").ComputedRef<"" | "small" | "default" | "large" | undefined>;
+    /** @description 校验消息 */
+    validateMessage: import("vue").ComputedRef<string | undefined>;
+    /** @description 校验状态 */
+    validateState: import("vue").ComputedRef<"" | "error" | "success" | "validating" | undefined>;
+    /** @description 验证表单项 */
+    validate: import("vue").ComputedRef<((trigger: string, callback?: import("element-plus").FormValidateCallback) => import("element-plus").FormValidationResult) | undefined>;
+    /** @description 移除该表单项的校验结果 */
+    clearValidate: import("vue").ComputedRef<(() => void) | undefined>;
+    /** @description 对该表单项进行重置，将其值重置为初始值并移除校验结果 */
+    resetField: import("vue").ComputedRef<(() => void) | undefined>;
+    /** @description 设置该表单项的初始值。 */
+    setInitialValue: import("vue").ComputedRef<((value: any) => void) | undefined>;
+}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** @description Label tips 提示 */
+    tips: StringConstructor;
+    /** @description Grid 布局 */
+    grid: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    /** @description 偏移量 */
+    offset: {
+        type: (NumberConstructor | StringConstructor)[];
+        default: number;
+    };
+    /** @description 栅格跨度 */
+    span: {
+        type: (NumberConstructor | StringConstructor)[];
+    };
+    /** @description 独占一行。如果设置 span 则无效 */
+    row: BooleanConstructor;
+    label: StringConstructor;
+    labelWidth: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<readonly [StringConstructor, NumberConstructor], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    labelPosition: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<StringConstructor, "" | "left" | "right" | "top", unknown, "", boolean>;
+    prop: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp) | (((new (...args: any[]) => string | string[]) | (() => import("element-plus").FormItemProp)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    required: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    rules: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<(new (... /** @description 验证表单项 */args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>) | (((new (...args: any[]) => import("element-plus").FormItemRule | import("element-plus").FormItemRule[]) | (() => import("element-plus/es/utils/typescript.mjs").Arrayable<import("element-plus").FormItemRule>)) | null)[], unknown, unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    error: StringConstructor;
+    validateStatus: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "success" | "error" | "validating", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+    for: StringConstructor;
+    inlineMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, undefined, boolean>;
+    showMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropFinalized<BooleanConstructor, unknown, unknown, true, boolean>;
+    size: {
+        readonly type: import("vue").PropType<import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "default" | "small" | "large", unknown>>;
+        readonly required: false;
+        readonly validator: ((val: unknown) => boolean) | undefined;
+        __epPropKey: true;
+    };
+}>> & Readonly<{}>, {
+    required: import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<BooleanConstructor, unknown, unknown>;
+    offset: string | number;
+    grid: boolean;
+    labelPosition: import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<StringConstructor, "" | "top" | "left" | "right", unknown>;
+    inlineMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<BooleanConstructor, unknown, unknown>;
+    showMessage: import("element-plus/es/utils/vue/props/types.mjs").EpPropMergeType<BooleanConstructor, unknown, unknown>;
+    row: boolean;
+}, import("../../../utils").TypedSlotsDeclaration<FaFormItemSlots>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/dist/components/form/src/formItem.mjs

@@ -0,0 +1,86 @@
+import { useExpose } from "../../../utils/vue/expose.mjs";
+import { useProps } from "../../../utils/vue/props.mjs";
+import { useRender } from "../../../utils/vue/render.mjs";
+import { makeSlots } from "../../../utils/vue/slots.mjs";
+import { FaLayoutGridItem } from "../../layoutGrid/index.mjs";
+import { FaFormItemTip } from "../../formItemTip/index.mjs";
+import { Fragment, computed, createVNode, defineComponent, inject, mergeProps, ref } from "vue";
+import { ElFormItem, formItemProps } from "element-plus";
+import { isNumber } from "lodash-unified";
+//#region src/components/form/src/formItem.tsx
+/** FaFormItem 的运行时 Props 定义。 */
+const faFormItemProps = {
+	...formItemProps,
+	/** @description Label tips 提示 */
+	tips: String,
+	/** @description Grid 布局 */
+	grid: {
+		type: Boolean,
+		default: true
+	},
+	/** @description 偏移量 */
+	offset: {
+		type: [String, Number],
+		default: 0
+	},
+	/** @description 栅格跨度 */
+	span: { type: [String, Number] },
+	/** @description 独占一行。如果设置 span 则无效 */
+	row: Boolean
+};
+var formItem_default = defineComponent({
+	name: "FaFormItem",
+	props: faFormItemProps,
+	slots: makeSlots(),
+	setup(props, { slots, expose }) {
+		const formItemRef = ref();
+		const cols = inject("cols", ref(4));
+		const getResponsive = () => {
+			if (!props.grid) return {};
+			if (props.span) return {
+				span: isNumber(props.span) ? props.span : Number(props.span),
+				offset: isNumber(props.offset) ? props.offset : Number(props.offset)
+			};
+			else {
+				const result = {
+					span: 1,
+					offset: isNumber(props.offset) ? props.offset : Number(props.offset)
+				};
+				if (props.row) result.span = cols.value;
+				return result;
+			}
+		};
+		const elFormItemProps = useProps(props, formItemProps);
+		const ParcelComponent = props.grid ? FaLayoutGridItem : Fragment;
+		useRender(() => createVNode(ParcelComponent, getResponsive(), { default: () => [createVNode(ElFormItem, mergeProps({ "ref": formItemRef }, elFormItemProps.value), {
+			default: () => slots.default?.() ?? [],
+			...slots.label && !props.tips && { label: ({ label }) => slots.label?.({ label }) ?? [] },
+			...slots.label && props.tips && { label: ({ label }) => [createVNode(FaFormItemTip, null, { label: () => slots.label?.({ label }) ?? [] })] },
+			...!slots.label && props.tips && { label: ({ label }) => [createVNode(FaFormItemTip, {
+				"label": label ?? props.label,
+				"tips": props.tips
+			}, null)] },
+			...slots.error && { error: ({ error }) => slots.error?.({ error }) ?? [] }
+		})] }));
+		return useExpose(expose, {
+			/** @description 表单项大小 */
+			size: computed(() => formItemRef.value?.size),
+			/** @description 校验消息 */
+			validateMessage: computed(() => formItemRef.value?.validateMessage),
+			/** @description 校验状态 */
+			validateState: computed(() => formItemRef.value?.validateState),
+			/** @description 验证表单项 */
+			validate: computed(() => formItemRef.value?.validate),
+			/** @description 移除该表单项的校验结果 */
+			clearValidate: computed(() => formItemRef.value?.clearValidate),
+			/** @description 对该表单项进行重置，将其值重置为初始值并移除校验结果 */
+			resetField: computed(() => formItemRef.value?.resetField),
+			/** @description 设置该表单项的初始值。 */
+			setInitialValue: computed(() => formItemRef.value?.setInitialValue)
+		});
+	}
+});
+//#endregion
+export { formItem_default as default, faFormItemProps };
+
+//# sourceMappingURL=formItem.mjs.map

package/dist/components/form/src/formItem.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"formItem.mjs","names":[],"sources":["../../../../src/components/form/src/formItem.tsx"],"sourcesContent":["import { Fragment, computed, defineComponent, inject, ref } from \"vue\";\nimport { ElFormItem, formItemProps } from \"element-plus\";\nimport { isNumber } from \"lodash-unified\";\nimport { makeSlots, useExpose, useProps, useRender } from \"../../../utils\";\nimport { FaFormItemTip } from \"../../formItemTip\";\nimport { FaLayoutGridItem } from \"../../layoutGrid\";\nimport type { FormItemInstance } from \"element-plus\";\nimport type { Ref, VNode } from \"vue\";\n\n/** FaFormItem 的运行时 Props 定义。 */\nexport const faFormItemProps = {\n\t...formItemProps,\n\t/** @description Label tips 提示 */\n\ttips: String,\n\t/** @description Grid 布局 */\n\tgrid: {\n\t\ttype: Boolean,\n\t\tdefault: true,\n\t},\n\t/** @description 偏移量 */\n\toffset: {\n\t\ttype: [String, Number],\n\t\tdefault: 0,\n\t},\n\t/** @description 栅格跨度 */\n\tspan: {\n\t\ttype: [String, Number],\n\t},\n\t/** @description 独占一行。如果设置 span 则无效 */\n\trow: Boolean,\n};\n\n/** FaFormItem 的插槽参数。 */\nexport interface FaFormItemSlots extends Record<string, unknown> {\n\t/** @description 默认内容插槽 */\n\tdefault: never;\n\t/** @description 标签位置显示的内容 */\n\tlabel: { label: string };\n\t/** @description 验证错误信息的显示内容 */\n\terror: { error: string };\n}\n\nexport default defineComponent({\n\tname: \"FaFormItem\",\n\tprops: faFormItemProps,\n\tslots: makeSlots<FaFormItemSlots>(),\n\tsetup(props, { slots, expose }) {\n\t\tconst formItemRef = ref<FormItemInstance>();\n\n\t\tconst cols = inject<Ref<number>>(\"cols\", ref(4));\n\n\t\t// 获取响应式设置\n\t\tconst getResponsive = (): {\n\t\t\tspan?: number;\n\t\t\toffset?: number;\n\t\t} => {\n\t\t\tif (!props.grid) return {};\n\t\t\tif (props.span) {\n\t\t\t\treturn {\n\t\t\t\t\tspan: isNumber(props.span) ? props.span : Number(props.span),\n\t\t\t\t\toffset: isNumber(props.offset) ? props.offset : Number(props.offset),\n\t\t\t\t};\n\t\t\t} else {\n\t\t\t\tconst result = {\n\t\t\t\t\tspan: 1,\n\t\t\t\t\toffset: isNumber(props.offset) ? props.offset : Number(props.offset),\n\t\t\t\t};\n\t\t\t\tif (props.row) {\n\t\t\t\t\tresult.span = cols.value;\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t};\n\n\t\tconst elFormItemProps = useProps(props, formItemProps);\n\n\t\tconst ParcelComponent = props.grid ? FaLayoutGridItem : Fragment;\n\n\t\tuseRender(() => (\n\t\t\t<ParcelComponent {...getResponsive()}>\n\t\t\t\t<ElFormItem ref={formItemRef} {...elFormItemProps.value}>\n\t\t\t\t\t{{\n\t\t\t\t\t\tdefault: () => slots.default?.() ?? [],\n\t\t\t\t\t\t...(slots.label && !props.tips && { label: ({ label }: { label: string }): VNode[] => slots.label?.({ label }) ?? [] }),\n\t\t\t\t\t\t...(slots.label &&\n\t\t\t\t\t\t\tprops.tips && {\n\t\t\t\t\t\t\t\tlabel: ({ label }: { label: string }): VNode[] => [\n\t\t\t\t\t\t\t\t\t<FaFormItemTip>\n\t\t\t\t\t\t\t\t\t\t{{\n\t\t\t\t\t\t\t\t\t\t\tlabel: () => slots.label?.({ label }) ?? [],\n\t\t\t\t\t\t\t\t\t\t}}\n\t\t\t\t\t\t\t\t\t</FaFormItemTip>,\n\t\t\t\t\t\t\t\t],\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t...(!slots.label &&\n\t\t\t\t\t\t\tprops.tips && {\n\t\t\t\t\t\t\t\tlabel: ({ label }: { label: string }): VNode[] => [<FaFormItemTip label={label ?? props.label} tips={props.tips} />],\n\t\t\t\t\t\t\t}),\n\t\t\t\t\t\t...(slots.error && { error: ({ error }: { error: string }): VNode[] => slots.error?.({ error }) ?? [] }),\n\t\t\t\t\t}}\n\t\t\t\t</ElFormItem>\n\t\t\t</ParcelComponent>\n\t\t));\n\n\t\treturn useExpose(expose, {\n\t\t\t/** @description 表单项大小 */\n\t\t\tsize: computed(() => formItemRef.value?.size),\n\t\t\t/** @description 校验消息 */\n\t\t\tvalidateMessage: computed(() => formItemRef.value?.validateMessage),\n\t\t\t/** @description 校验状态 */\n\t\t\tvalidateState: computed(() => formItemRef.value?.validateState),\n\t\t\t/** @description 验证表单项 */\n\t\t\tvalidate: computed(() => formItemRef.value?.validate),\n\t\t\t/** @description 移除该表单项的校验结果 */\n\t\t\tclearValidate: computed(() => formItemRef.value?.clearValidate),\n\t\t\t/** @description 对该表单项进行重置，将其值重置为初始值并移除校验结果 */\n\t\t\tresetField: computed(() => formItemRef.value?.resetField),\n\t\t\t/** @description 设置该表单项的初始值。 */\n\t\t\tsetInitialValue: computed(() => formItemRef.value?.setInitialValue),\n\t\t});\n\t},\n});\n"],"mappings":";;;;;;;;;;;AAUA,MAAa,kBAAkB;CAC9B,GAAG;;CAEH,MAAM;;CAEN,MAAM;EACL,MAAM;EACN,SAAS;CACV;;CAEA,QAAQ;EACP,MAAM,CAAC,QAAQ,MAAM;EACrB,SAAS;CACV;;CAEA,MAAM,EACL,MAAM,CAAC,QAAQ,MAAM,EACtB;;CAEA,KAAK;AACN;AAYA,IAAA,mBAAe,gBAAgB;CAC9B,MAAM;CACN,OAAO;CACP,OAAO,UAA2B;CAClC,MAAM,OAAO,EAAE,OAAO,UAAU;EAC/B,MAAM,cAAc,IAAsB;EAE1C,MAAM,OAAO,OAAoB,QAAQ,IAAI,CAAC,CAAC;EAG/C,MAAM,sBAGD;GACJ,IAAI,CAAC,MAAM,MAAM,OAAO,CAAC;GACzB,IAAI,MAAM,MACT,OAAO;IACN,MAAM,SAAS,MAAM,IAAI,IAAI,MAAM,OAAO,OAAO,MAAM,IAAI;IAC3D,QAAQ,SAAS,MAAM,MAAM,IAAI,MAAM,SAAS,OAAO,MAAM,MAAM;GACpE;QACM;IACN,MAAM,SAAS;KACd,MAAM;KACN,QAAQ,SAAS,MAAM,MAAM,IAAI,MAAM,SAAS,OAAO,MAAM,MAAM;IACpE;IACA,IAAI,MAAM,KACT,OAAO,OAAO,KAAK;IAEpB,OAAO;GACR;EACD;EAEA,MAAM,kBAAkB,SAAS,OAAO,aAAa;EAErD,MAAM,kBAAkB,MAAM,OAAO,mBAAmB;EAExD,gBAAU,YAAA,iBACY,cAAc,GAAC,EAAA,eAAA,CAAA,YAAA,YAAA,WAAA,EAAA,OAClB,YAAW,GAAM,gBAAgB,KAAK,GAAA;GAErD,eAAe,MAAM,UAAU,KAAK,CAAA;GACpC,GAAI,MAAM,SAAS,CAAC,MAAM,QAAQ,EAAE,QAAQ,EAAE,YAAwC,MAAM,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAA,EAAG;GACrH,GAAI,MAAM,SACT,MAAM,QAAQ,EACb,QAAQ,EAAE,YAAwC,CAAA,YAAA,eAAA,MAAA,EAG/C,aAAa,MAAM,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAA,EAAE,CAAA,CAAA,EAI/C;GACD,GAAI,CAAC,MAAM,SACV,MAAM,QAAQ,EACb,QAAQ,EAAE,YAAwC,CAAA,YAAA,eAAA;IAAA,SAAuB,SAAS,MAAM;IAAK,QAAQ,MAAM;GAAI,GAAA,IAAA,CAAA,EAChH;GACD,GAAI,MAAM,SAAS,EAAE,QAAQ,EAAE,YAAwC,MAAM,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAA,EAAG;EAAE,CAAA,CAAA,EAAA,CAAA,CAI3G;EAED,OAAO,UAAU,QAAQ;;GAExB,MAAM,eAAe,YAAY,OAAO,IAAI;;GAE5C,iBAAiB,eAAe,YAAY,OAAO,eAAe;;GAElE,eAAe,eAAe,YAAY,OAAO,aAAa;;GAE9D,UAAU,eAAe,YAAY,OAAO,QAAQ;;GAEpD,eAAe,eAAe,YAAY,OAAO,aAAa;;GAE9D,YAAY,eAAe,YAAY,OAAO,UAAU;;GAExD,iBAAiB,eAAe,YAAY,OAAO,eAAe;EACnE,CAAC;CACF;AACD,CAAC"}

package/dist/components/form/utils/form.d.ts

@@ -0,0 +1,83 @@
+import type { FormInstance, FormItemRule, FormValidationResult } from "element-plus";
+import type { Ref } from "vue";
+type ValidationCallback = (error?: Error) => void;
+/**
+ * 表单工具类
+ */
+export declare const formUtil: {
+    /**
+     * ElForm 表单验证
+     * @param elFormRef ElForm 组件ref
+     */
+    validate(elFormRef: Ref<FormInstance | undefined>): FormValidationResult;
+    /**
+     * ElForm 表单验证，带滚动
+     * @param elFormRef ElForm 组件ref
+     */
+    validateScrollToField(elFormRef: Ref<FormInstance | undefined>): FormValidationResult;
+    /**
+     * 手机号
+     */
+    mobile(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 电话号码
+     */
+    phone(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 邮箱
+     */
+    email(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 身份证
+     */
+    idCard(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 车牌号
+     */
+    carNumber(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * editor 必填
+     */
+    editorRequired(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 外部链接
+     */
+    external(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 有效的URL
+     */
+    url(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 邮政编码
+     */
+    postCode(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 账号（6-20位字母或数字，必须以字母开头，不能全为数字）
+     */
+    account(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 弱密码（只包含字母和数字，长度为6到18位）
+     */
+    password(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 强密码（8到20位，包含大小写字母、数字及特殊字符）
+     */
+    strongPassword(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 中文字符
+     */
+    chinese(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 英文字符
+     */
+    english(_rule: FormItemRule, value: string, callback: ValidationCallback): void;
+    /**
+     * 文本框必填
+     */
+    inputRequired(message: string, trigger?: string): FormItemRule;
+    /**
+     * 选择器必选
+     */
+    selectRequired(message: string, trigger?: string): FormItemRule;
+};
+export {};