@tmagic/form 1.8.0-manmanyu.13 → 1.8.0-manmanyu.15

package/dist/es/Form.vue_vue_type_script_setup_true_lang.js

@@ -35,6 +35,10 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 		keyProp: { default: "__key" },
 		popperClass: {},
 		preventSubmitDefault: { type: Boolean },
+		useFieldTextInError: {
+			type: Boolean,
+			default: true
+		},
 		extendState: {},
 		showDiff: {},
 		selfDiffFieldTypes: {},
@@ -279,7 +283,7 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 					Object.entries(invalidFields).forEach(([prop, ValidateError]) => {
 						ValidateError.forEach(({ field, message }) => {
 							const name = field || prop;
-							const text = getTextByName(name, props.config) || name;
+							const text = (props.useFieldTextInError ? getTextByName(name, props.config) : void 0) || name;
 							error.push(`${text} -> ${message}`);
 						});
 					});

package/dist/es/FormBox.vue_vue_type_script_setup_true_lang.js

@@ -19,6 +19,10 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 		inline: { type: Boolean },
 		labelPosition: {},
 		preventSubmitDefault: { type: Boolean },
+		useFieldTextInError: {
+			type: Boolean,
+			default: true
+		},
 		extendState: {}
 	},
 	emits: [
@@ -81,6 +85,7 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 					"label-position": __props.labelPosition,
 					inline: __props.inline,
 					"prevent-submit-default": __props.preventSubmitDefault,
+					"use-field-text-in-error": __props.useFieldTextInError,
 					"extend-state": __props.extendState,
 					onChange: changeHandler
 				}, null, 8, [
@@ -93,6 +98,7 @@ var FormBox_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCo
 					"label-position",
 					"inline",
 					"prevent-submit-default",
+					"use-field-text-in-error",
 					"extend-state"
 				]), renderSlot(_ctx.$slots, "default")]),
 				_: 3

package/dist/es/FormDialog.vue_vue_type_script_setup_true_lang.js

@@ -41,6 +41,10 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 			type: Boolean,
 			default: true
 		},
+		useFieldTextInError: {
+			type: Boolean,
+			default: true
+		},
 		extendState: {},
 		theme: {}
 	},
@@ -195,6 +199,7 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"label-position": __props.labelPosition,
 					inline: __props.inline,
 					"prevent-submit-default": __props.preventSubmitDefault,
+					"use-field-text-in-error": __props.useFieldTextInError,
 					"extend-state": __props.extendState,
 					theme: effectiveTheme.value,
 					onChange: changeHandler
@@ -209,6 +214,7 @@ var FormDialog_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"label-position",
 					"inline",
 					"prevent-submit-default",
+					"use-field-text-in-error",
 					"extend-state",
 					"theme"
 				]), renderSlot(_ctx.$slots, "default")], 4)) : createCommentVNode("v-if", true)]),

package/dist/es/FormDrawer.vue_vue_type_script_setup_true_lang.js

@@ -24,6 +24,10 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 		inline: { type: Boolean },
 		labelPosition: {},
 		preventSubmitDefault: { type: Boolean },
+		useFieldTextInError: {
+			type: Boolean,
+			default: true
+		},
 		beforeClose: {},
 		extendState: {},
 		theme: {}
@@ -171,6 +175,7 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"label-position": __props.labelPosition,
 					inline: __props.inline,
 					"prevent-submit-default": __props.preventSubmitDefault,
+					"use-field-text-in-error": __props.useFieldTextInError,
 					"extend-state": __props.extendState,
 					theme: effectiveTheme.value,
 					onChange: changeHandler
@@ -184,6 +189,7 @@ var FormDrawer_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defin
 					"label-position",
 					"inline",
 					"prevent-submit-default",
+					"use-field-text-in-error",
 					"extend-state",
 					"theme"
 				]), renderSlot(_ctx.$slots, "default")], 512)) : createCommentVNode("v-if", true)]),

package/dist/es/containers/table/useTableColumns.js

@@ -1,15 +1,15 @@
+import { isGlobalFlat } from "../../utils/config.js";
 import { display, getDataByPage, sortArray } from "../../utils/form.js";
 import Container_default from "../Container.js";
 import ActionsColumn_default from "./ActionsColumn.js";
 import SortColumn_default from "./SortColumn.js";
 import { computed, h, inject } from "vue";
 import { cloneDeep } from "lodash-es";
-import { TMagicIcon, TMagicTooltip, isMagicAdminTheme } from "@tmagic/design";
+import { TMagicIcon, TMagicTooltip } from "@tmagic/design";
 import { WarningFilled } from "@element-plus/icons-vue";
 //#region packages/form/src/containers/table/useTableColumns.ts
 var useTableColumns = (props, emit, currentPage, pageSize, modelName) => {
 	const mForm = inject("mForm");
-	const isMagicAdmin = isMagicAdminTheme();
 	const display$1 = (fuc) => display(mForm, fuc, props);
 	const lastData = computed(() => props.config.pagination ? getDataByPage(props.lastValues[modelName.value], currentPage.value, pageSize.value) : props.lastValues[modelName.value] || []);
 	const itemExtra = (fuc, index) => {
@@ -67,10 +67,10 @@ var useTableColumns = (props, emit, currentPage, pageSize, modelName) => {
 			type: "selection",
 			width: 45
 		} });
-		const defaultFixed = isMagicAdmin.value ? "right" : "left";
+		const defaultFixed = isGlobalFlat.value ? "right" : "left";
 		let actionFixed = props.config.fixed === false ? void 0 : defaultFixed;
 		if (typeof props.config.fixed === "string" && ["left", "right"].includes(props.config.fixed)) actionFixed = props.config.fixed;
-		const actionFlat = props.config.flat === void 0 && isMagicAdmin.value ? true : props.config.flat;
+		const actionFlat = props.config.flat === void 0 && isGlobalFlat.value ? true : props.config.flat;
 		const actionColumn = {
 			props: {
 				label: "操作",

package/dist/es/fields/Link.vue_vue_type_script_setup_true_lang.js

@@ -1,7 +1,8 @@
 import { useAddField } from "../utils/useAddField.js";
+import { isGlobalFlat } from "../utils/config.js";
 import FormDialog_default from "../FormDialog.js";
 import { computed, createElementBlock, createTextVNode, createVNode, defineComponent, inject, normalizeStyle, openBlock, readonly, ref, toDisplayString, unref, withCtx } from "vue";
-import { TMagicButton, TMagicIcon, isMagicAdminTheme } from "@tmagic/design";
+import { TMagicButton, TMagicIcon } from "@tmagic/design";
 import { Notebook } from "@element-plus/icons-vue";
 //#region packages/form/src/fields/Link.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = ["href"];
@@ -33,7 +34,6 @@ var Link_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 	setup(__props, { emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
-		const isMagicAdmin = isMagicAdminTheme(props);
 		useAddField(props.prop);
 		const formValue = ref({});
 		const editor = ref();
@@ -71,7 +71,7 @@ var Link_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 			editor.value && (editor.value.dialogVisible = false);
 		};
 		return (_ctx, _cache) => {
-			return unref(isMagicAdmin) && __props.config.href && !__props.disabled ? (openBlock(), createElementBlock("a", {
+			return unref(isGlobalFlat) && __props.config.href && !__props.disabled ? (openBlock(), createElementBlock("a", {
 				key: 0,
 				target: "_blank",
 				href: href.value,

package/dist/es/fields/Number.vue_vue_type_script_setup_true_lang.js

@@ -1,6 +1,7 @@
 import { useAddField } from "../utils/useAddField.js";
+import { isGlobalFlat } from "../utils/config.js";
 import { createBlock, createCommentVNode, defineComponent, inject, openBlock, ref, unref, watch } from "vue";
-import { TMagicInputNumber, isMagicAdminTheme } from "@tmagic/design";
+import { TMagicInputNumber } from "@tmagic/design";
 //#region packages/form/src/fields/Number.vue?vue&type=script&setup=true&lang.ts
 var Number_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	name: "MFormNumber",
@@ -24,7 +25,6 @@ var Number_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCom
 	setup(__props, { emit: __emit }) {
 		const props = __props;
 		const emit = __emit;
-		const isMagicAdmin = isMagicAdminTheme();
 		const value = ref();
 		watch(() => props.model[props.name], (v) => {
 			value.value = v;
@@ -44,7 +44,7 @@ var Number_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCom
 				modelValue: value.value,
 				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => value.value = $event),
 				clearable: "",
-				"controls-position": unref(isMagicAdmin) ? "" : "right",
+				"controls-position": unref(isGlobalFlat) ? "" : "right",
 				size: __props.size,
 				max: __props.config.max,
 				min: __props.config.min,

package/dist/es/submitForm.js

@@ -28,13 +28,20 @@ import { createApp, defineComponent, h, nextTick, ref, watch } from "vue";
 *   initValues: { name: 'foo' },
 *   returnChangeRecords: true,
 * });
+*
+* // 调试模式：可见地渲染表单，点击「确定」才提交：
+* const values = await submitForm({
+*   config: [...],
+*   initValues: { name: 'foo' },
+*   debug: true,
+* });
 * ```
 */
 var submitForm = (options) => {
-	const { native, appContext, timeout = 1e4, returnChangeRecords, ...formProps } = options;
+	const { native, appContext, timeout = 1e4, returnChangeRecords, debug = false, ...formProps } = options;
 	return new Promise((resolve, reject) => {
 		const container = document.createElement("div");
-		container.style.display = "none";
+		if (!debug) container.style.display = "none";
 		document.body.appendChild(container);
 		let cleaned = false;
 		let timer = null;
@@ -42,22 +49,106 @@ var submitForm = (options) => {
 			name: "MFormSubmitWrapper",
 			setup() {
 				const formRef = ref(null);
-				const stop = watch(() => formRef.value?.initialized, async (initialized) => {
-					if (!initialized) return;
-					stop();
+				const errorMsg = ref("");
+				const doSubmit = async () => {
 					try {
 						await nextTick();
-						const changeRecords = [...formRef.value.changeRecords ?? []];
+						const changeRecords = [...formRef.value?.changeRecords ?? []];
 						const result = await formRef.value.submitForm(native);
 						resolve(returnChangeRecords ? {
 							values: result,
 							changeRecords
 						} : result);
+						cleanup();
 					} catch (err) {
+						if (debug) {
+							errorMsg.value = err instanceof Error ? err.message : String(err);
+							return;
+						}
 						reject(err);
-					} finally {
 						cleanup();
 					}
+				};
+				if (debug) {
+					const handleCancel = () => {
+						reject(/* @__PURE__ */ new Error("submitForm canceled in debug mode."));
+						cleanup();
+					};
+					const btnBase = {
+						padding: "8px 20px",
+						fontSize: "14px",
+						lineHeight: "1",
+						border: "1px solid #dcdfe6",
+						borderRadius: "4px",
+						cursor: "pointer"
+					};
+					return () => h("div", { style: {
+						position: "fixed",
+						inset: "0",
+						zIndex: "10000",
+						display: "flex",
+						alignItems: "center",
+						justifyContent: "center",
+						background: "rgba(0, 0, 0, 0.5)"
+					} }, [h("div", { style: {
+						display: "flex",
+						flexDirection: "column",
+						width: "600px",
+						maxWidth: "90vw",
+						maxHeight: "85vh",
+						background: "#fff",
+						borderRadius: "8px",
+						boxShadow: "0 8px 24px rgba(0, 0, 0, 0.2)",
+						overflow: "hidden"
+					} }, [
+						h("div", { style: {
+							padding: "16px 20px",
+							fontSize: "16px",
+							fontWeight: "600",
+							borderBottom: "1px solid #ebeef5"
+						} }, "submitForm 调试"),
+						h("div", { style: {
+							flex: "1",
+							padding: "20px",
+							overflow: "auto"
+						} }, [h(Form_default, {
+							...formProps,
+							ref: formRef
+						}), errorMsg.value ? h("div", {
+							style: {
+								marginTop: "12px",
+								color: "#f56c6c",
+								fontSize: "13px",
+								lineHeight: "1.5"
+							},
+							innerHTML: errorMsg.value
+						}) : null]),
+						h("div", { style: {
+							display: "flex",
+							justifyContent: "flex-end",
+							gap: "12px",
+							padding: "12px 20px",
+							borderTop: "1px solid #ebeef5"
+						} }, [h("button", {
+							type: "button",
+							onClick: handleCancel,
+							style: { ...btnBase }
+						}, "取消"), h("button", {
+							type: "button",
+							onClick: doSubmit,
+							style: {
+								...btnBase,
+								color: "#fff",
+								background: "#409eff",
+								borderColor: "#409eff"
+							}
+						}, "确定")])
+					])]);
+				}
+				const stop = watch(() => formRef.value?.initialized, (initialized) => {
+					if (!initialized) return;
+					stop();
+					doSubmit();
 				}, {
 					flush: "post",
 					immediate: true
@@ -81,7 +172,7 @@ var submitForm = (options) => {
 			} catch {}
 			container.parentNode?.removeChild(container);
 		};
-		if (timeout > 0) timer = setTimeout(() => {
+		if (timeout > 0 && !debug) timer = setTimeout(() => {
 			if (!cleaned) {
 				reject(/* @__PURE__ */ new Error(`submitForm timeout after ${timeout}ms: form is not initialized.`));
 				cleanup();

package/dist/es/utils/config.js

@@ -1,7 +1,10 @@
+import { ref } from "vue";
 //#region packages/form/src/utils/config.ts
 var $MAGIC_FORM = {};
+var isGlobalFlat = ref(false);
 var setConfig = (option) => {
 	$MAGIC_FORM = option;
+	isGlobalFlat.value = option.flat ?? false;
 };
 var getConfig = (key) => $MAGIC_FORM[key];
 var fieldRegistry = /* @__PURE__ */ new Map();
@@ -12,4 +15,4 @@ var registerField = (tagName, component) => {
 var getField = (tagName) => fieldRegistry.get(tagName);
 var deleteField = (tagName) => fieldRegistry.delete(tagName);
 //#endregion
-export { deleteField, getConfig, getField, registerField, setConfig };
+export { deleteField, getConfig, getField, isGlobalFlat, registerField, setConfig };

package/dist/tmagic-form.umd.cjs

@@ -2654,8 +2654,10 @@
 	//#endregion
 	//#region packages/form/src/utils/config.ts
 	var $MAGIC_FORM = {};
+	var isGlobalFlat = (0, vue.ref)(false);
 	var setConfig = (option) => {
 		$MAGIC_FORM = option;
+		isGlobalFlat.value = option.flat ?? false;
 	};
 	var getConfig = (key) => $MAGIC_FORM[key];
 	var fieldRegistry = /* @__PURE__ */ new Map();
@@ -3465,6 +3467,10 @@
 			keyProp: { default: "__key" },
 			popperClass: {},
 			preventSubmitDefault: { type: Boolean },
+			useFieldTextInError: {
+				type: Boolean,
+				default: true
+			},
 			extendState: {},
 			showDiff: {},
 			selfDiffFieldTypes: {},
@@ -3709,7 +3715,7 @@
 						Object.entries(invalidFields).forEach(([prop, ValidateError]) => {
 							ValidateError.forEach(({ field, message }) => {
 								const name = field || prop;
-								const text = getTextByName(name, props.config) || name;
+								const text = (props.useFieldTextInError ? getTextByName(name, props.config) : void 0) || name;
 								error.push(`${text} -> ${message}`);
 							});
 						});
@@ -3801,13 +3807,20 @@
 	*   initValues: { name: 'foo' },
 	*   returnChangeRecords: true,
 	* });
+	*
+	* // 调试模式：可见地渲染表单，点击「确定」才提交：
+	* const values = await submitForm({
+	*   config: [...],
+	*   initValues: { name: 'foo' },
+	*   debug: true,
+	* });
 	* ```
 	*/
 	var submitForm = (options) => {
-		const { native, appContext, timeout = 1e4, returnChangeRecords, ...formProps } = options;
+		const { native, appContext, timeout = 1e4, returnChangeRecords, debug = false, ...formProps } = options;
 		return new Promise((resolve, reject) => {
 			const container = document.createElement("div");
-			container.style.display = "none";
+			if (!debug) container.style.display = "none";
 			document.body.appendChild(container);
 			let cleaned = false;
 			let timer = null;
@@ -3815,22 +3828,106 @@
 				name: "MFormSubmitWrapper",
 				setup() {
 					const formRef = (0, vue.ref)(null);
-					const stop = (0, vue.watch)(() => formRef.value?.initialized, async (initialized) => {
-						if (!initialized) return;
-						stop();
+					const errorMsg = (0, vue.ref)("");
+					const doSubmit = async () => {
 						try {
 							await (0, vue.nextTick)();
-							const changeRecords = [...formRef.value.changeRecords ?? []];
+							const changeRecords = [...formRef.value?.changeRecords ?? []];
 							const result = await formRef.value.submitForm(native);
 							resolve(returnChangeRecords ? {
 								values: result,
 								changeRecords
 							} : result);
+							cleanup();
 						} catch (err) {
+							if (debug) {
+								errorMsg.value = err instanceof Error ? err.message : String(err);
+								return;
+							}
 							reject(err);
-						} finally {
 							cleanup();
 						}
+					};
+					if (debug) {
+						const handleCancel = () => {
+							reject(/* @__PURE__ */ new Error("submitForm canceled in debug mode."));
+							cleanup();
+						};
+						const btnBase = {
+							padding: "8px 20px",
+							fontSize: "14px",
+							lineHeight: "1",
+							border: "1px solid #dcdfe6",
+							borderRadius: "4px",
+							cursor: "pointer"
+						};
+						return () => (0, vue.h)("div", { style: {
+							position: "fixed",
+							inset: "0",
+							zIndex: "10000",
+							display: "flex",
+							alignItems: "center",
+							justifyContent: "center",
+							background: "rgba(0, 0, 0, 0.5)"
+						} }, [(0, vue.h)("div", { style: {
+							display: "flex",
+							flexDirection: "column",
+							width: "600px",
+							maxWidth: "90vw",
+							maxHeight: "85vh",
+							background: "#fff",
+							borderRadius: "8px",
+							boxShadow: "0 8px 24px rgba(0, 0, 0, 0.2)",
+							overflow: "hidden"
+						} }, [
+							(0, vue.h)("div", { style: {
+								padding: "16px 20px",
+								fontSize: "16px",
+								fontWeight: "600",
+								borderBottom: "1px solid #ebeef5"
+							} }, "submitForm 调试"),
+							(0, vue.h)("div", { style: {
+								flex: "1",
+								padding: "20px",
+								overflow: "auto"
+							} }, [(0, vue.h)(Form_default, {
+								...formProps,
+								ref: formRef
+							}), errorMsg.value ? (0, vue.h)("div", {
+								style: {
+									marginTop: "12px",
+									color: "#f56c6c",
+									fontSize: "13px",
+									lineHeight: "1.5"
+								},
+								innerHTML: errorMsg.value
+							}) : null]),
+							(0, vue.h)("div", { style: {
+								display: "flex",
+								justifyContent: "flex-end",
+								gap: "12px",
+								padding: "12px 20px",
+								borderTop: "1px solid #ebeef5"
+							} }, [(0, vue.h)("button", {
+								type: "button",
+								onClick: handleCancel,
+								style: { ...btnBase }
+							}, "取消"), (0, vue.h)("button", {
+								type: "button",
+								onClick: doSubmit,
+								style: {
+									...btnBase,
+									color: "#fff",
+									background: "#409eff",
+									borderColor: "#409eff"
+								}
+							}, "确定")])
+						])]);
+					}
+					const stop = (0, vue.watch)(() => formRef.value?.initialized, (initialized) => {
+						if (!initialized) return;
+						stop();
+						doSubmit();
 					}, {
 						flush: "post",
 						immediate: true
@@ -3854,7 +3951,7 @@
 				} catch {}
 				container.parentNode?.removeChild(container);
 			};
-			if (timeout > 0) timer = setTimeout(() => {
+			if (timeout > 0 && !debug) timer = setTimeout(() => {
 				if (!cleaned) {
 					reject(/* @__PURE__ */ new Error(`submitForm timeout after ${timeout}ms: form is not initialized.`));
 					cleanup();
@@ -3911,6 +4008,10 @@
 				type: Boolean,
 				default: true
 			},
+			useFieldTextInError: {
+				type: Boolean,
+				default: true
+			},
 			extendState: {},
 			theme: {}
 		},
@@ -4065,6 +4166,7 @@
 						"label-position": __props.labelPosition,
 						inline: __props.inline,
 						"prevent-submit-default": __props.preventSubmitDefault,
+						"use-field-text-in-error": __props.useFieldTextInError,
 						"extend-state": __props.extendState,
 						theme: effectiveTheme.value,
 						onChange: changeHandler
@@ -4079,6 +4181,7 @@
 						"label-position",
 						"inline",
 						"prevent-submit-default",
+						"use-field-text-in-error",
 						"extend-state",
 						"theme"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")], 4)) : (0, vue.createCommentVNode)("v-if", true)]),
@@ -4124,6 +4227,10 @@
 			inline: { type: Boolean },
 			labelPosition: {},
 			preventSubmitDefault: { type: Boolean },
+			useFieldTextInError: {
+				type: Boolean,
+				default: true
+			},
 			beforeClose: {},
 			extendState: {},
 			theme: {}
@@ -4271,6 +4378,7 @@
 						"label-position": __props.labelPosition,
 						inline: __props.inline,
 						"prevent-submit-default": __props.preventSubmitDefault,
+						"use-field-text-in-error": __props.useFieldTextInError,
 						"extend-state": __props.extendState,
 						theme: effectiveTheme.value,
 						onChange: changeHandler
@@ -4284,6 +4392,7 @@
 						"label-position",
 						"inline",
 						"prevent-submit-default",
+						"use-field-text-in-error",
 						"extend-state",
 						"theme"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")], 512)) : (0, vue.createCommentVNode)("v-if", true)]),
@@ -4321,6 +4430,10 @@
 			inline: { type: Boolean },
 			labelPosition: {},
 			preventSubmitDefault: { type: Boolean },
+			useFieldTextInError: {
+				type: Boolean,
+				default: true
+			},
 			extendState: {}
 		},
 		emits: [
@@ -4383,6 +4496,7 @@
 						"label-position": __props.labelPosition,
 						inline: __props.inline,
 						"prevent-submit-default": __props.preventSubmitDefault,
+						"use-field-text-in-error": __props.useFieldTextInError,
 						"extend-state": __props.extendState,
 						onChange: changeHandler
 					}, null, 8, [
@@ -4395,6 +4509,7 @@
 						"label-position",
 						"inline",
 						"prevent-submit-default",
+						"use-field-text-in-error",
 						"extend-state"
 					]), (0, vue.renderSlot)(_ctx.$slots, "default")]),
 					_: 3
@@ -5741,7 +5856,6 @@
 	//#region packages/form/src/containers/table/useTableColumns.ts
 	var useTableColumns = (props, emit, currentPage, pageSize, modelName) => {
 		const mForm = (0, vue.inject)("mForm");
-		const isMagicAdmin = (0, _tmagic_design.isMagicAdminTheme)();
 		const display$1 = (fuc) => display(mForm, fuc, props);
 		const lastData = (0, vue.computed)(() => props.config.pagination ? getDataByPage(props.lastValues[modelName.value], currentPage.value, pageSize.value) : props.lastValues[modelName.value] || []);
 		const itemExtra = (fuc, index) => {
@@ -5799,10 +5913,10 @@
 				type: "selection",
 				width: 45
 			} });
-			const defaultFixed = isMagicAdmin.value ? "right" : "left";
+			const defaultFixed = isGlobalFlat.value ? "right" : "left";
 			let actionFixed = props.config.fixed === false ? void 0 : defaultFixed;
 			if (typeof props.config.fixed === "string" && ["left", "right"].includes(props.config.fixed)) actionFixed = props.config.fixed;
-			const actionFlat = props.config.flat === void 0 && isMagicAdmin.value ? true : props.config.flat;
+			const actionFlat = props.config.flat === void 0 && isGlobalFlat.value ? true : props.config.flat;
 			const actionColumn = {
 				props: {
 					label: "操作",
@@ -6563,7 +6677,6 @@
 		setup(__props, { emit: __emit }) {
 			const props = __props;
 			const emit = __emit;
-			const isMagicAdmin = (0, _tmagic_design.isMagicAdminTheme)();
 			const value = (0, vue.ref)();
 			(0, vue.watch)(() => props.model[props.name], (v) => {
 				value.value = v;
@@ -6583,7 +6696,7 @@
 					modelValue: value.value,
 					"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => value.value = $event),
 					clearable: "",
-					"controls-position": (0, vue.unref)(isMagicAdmin) ? "" : "right",
+					"controls-position": (0, vue.unref)(isGlobalFlat) ? "" : "right",
 					size: __props.size,
 					max: __props.config.max,
 					min: __props.config.min,
@@ -7459,7 +7572,6 @@
 		setup(__props, { emit: __emit }) {
 			const props = __props;
 			const emit = __emit;
-			const isMagicAdmin = (0, _tmagic_design.isMagicAdminTheme)(props);
 			useAddField(props.prop);
 			const formValue = (0, vue.ref)({});
 			const editor = (0, vue.ref)();
@@ -7497,7 +7609,7 @@
 				editor.value && (editor.value.dialogVisible = false);
 			};
 			return (_ctx, _cache) => {
-				return (0, vue.unref)(isMagicAdmin) && __props.config.href && !__props.disabled ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
+				return (0, vue.unref)(isGlobalFlat) && __props.config.href && !__props.disabled ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("a", {
 					key: 0,
 					target: "_blank",
 					href: href.value,

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0-manmanyu.13",
+  "version": "1.8.0-manmanyu.15",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -52,9 +52,9 @@
   "peerDependencies": {
     "vue": "^3.5.38",
     "typescript": "^6.0.3",
-    "@tmagic/form-schema": "1.8.0-manmanyu.13",
-    "@tmagic/utils": "1.8.0-manmanyu.13",
-    "@tmagic/design": "1.8.0-manmanyu.13"
+    "@tmagic/utils": "1.8.0-manmanyu.15",
+    "@tmagic/form-schema": "1.8.0-manmanyu.15",
+    "@tmagic/design": "1.8.0-manmanyu.15"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/containers/table/useTableColumns.ts

@@ -2,10 +2,11 @@ import { computed, h, inject, type Ref } from 'vue';
 import { WarningFilled } from '@element-plus/icons-vue';
 import { cloneDeep } from 'lodash-es';
 
-import { isMagicAdminTheme, type TableColumnOptions, TMagicIcon, TMagicTooltip } from '@tmagic/design';
+import { type TableColumnOptions, TMagicIcon, TMagicTooltip } from '@tmagic/design';
 import type { FormItemConfig, FormState, TableColumnConfig } from '@tmagic/form-schema';
 
 import type { ContainerChangeEventData } from '../../schema';
+import { isGlobalFlat } from '../../utils/config';
 import { display as displayFunc, getDataByPage, sortArray } from '../../utils/form';
 import Container from '../Container.vue';
 
@@ -21,9 +22,6 @@ export const useTableColumns = (
   modelName: Ref<string | number>,
 ) => {
   const mForm = inject<FormState | undefined>('mForm');
-  // magic-admin 主题下「操作列」默认固定在右侧；其它主题保持原默认「左侧」。
-  // 调用方仍可通过 `config.fixed`（'left' | 'right' | false）显式覆盖。
-  const isMagicAdmin = isMagicAdminTheme();
 
   const display = (fuc: any) => displayFunc(mForm, fuc, props);
 
@@ -114,13 +112,13 @@ export const useTableColumns = (
         },
       });
     }
-    const defaultFixed: 'left' | 'right' = isMagicAdmin.value ? 'right' : 'left';
+    const defaultFixed: 'left' | 'right' = isGlobalFlat.value ? 'right' : 'left';
     let actionFixed: 'left' | 'right' | undefined = props.config.fixed === false ? undefined : defaultFixed;
     if (typeof props.config.fixed === 'string' && ['left', 'right'].includes(props.config.fixed)) {
       actionFixed = props.config.fixed;
     }
 
-    const actionFlat = props.config.flat === undefined && isMagicAdmin.value ? true : props.config.flat;
+    const actionFlat = props.config.flat === undefined && isGlobalFlat.value ? true : props.config.flat;
 
     const actionColumn = {
       props: {

package/src/fields/Link.vue

@@ -2,7 +2,7 @@
   <a
     target="_blank"
     :href="href"
-    v-if="isMagicAdmin && config.href && !disabled"
+    v-if="isGlobalFlat && config.href && !disabled"
     class="magic-admin-link"
     :style="config.css || {}"
   >
@@ -31,10 +31,11 @@
 import { computed, inject, readonly, ref } from 'vue';
 import { Notebook } from '@element-plus/icons-vue';
 
-import { isMagicAdminTheme, TMagicButton, TMagicIcon } from '@tmagic/design';
+import { TMagicButton, TMagicIcon } from '@tmagic/design';
 
 import FormDialog from '../FormDialog.vue';
 import type { FieldProps, FormState, LinkConfig } from '../schema';
+import { isGlobalFlat } from '../utils/config';
 import { useAddField } from '../utils/useAddField';
 
 defineOptions({
@@ -45,8 +46,6 @@ const props = defineProps<FieldProps<LinkConfig> & { theme?: string }>();
 
 const emit = defineEmits(['change']);
 
-const isMagicAdmin = isMagicAdminTheme(props);
-
 useAddField(props.prop);
 
 const formValue = ref({});

package/src/fields/Number.vue

@@ -3,7 +3,7 @@
     v-if="model"
     v-model="value"
     clearable
-    :controls-position="isMagicAdmin ? '' : 'right'"
+    :controls-position="isGlobalFlat ? '' : 'right'"
     :size="size"
     :max="config.max"
     :min="config.min"
@@ -18,9 +18,10 @@
 <script lang="ts" setup>
 import { inject, ref, watch } from 'vue';
 
-import { isMagicAdminTheme, TMagicInputNumber } from '@tmagic/design';
+import { TMagicInputNumber } from '@tmagic/design';
 
 import type { FieldProps, FormState, NumberConfig } from '../schema';
+import { isGlobalFlat } from '../utils/config';
 import { useAddField } from '../utils/useAddField';
 
 defineOptions({
@@ -34,9 +35,6 @@ const emit = defineEmits<{
   input: [values: number];
 }>();
 
-// magic-admin 主题下输入框走"无右侧上下箭头"的极简样式（控件位置置空回到 ElInputNumber 默认两侧布局）
-const isMagicAdmin = isMagicAdminTheme();
-
 const value = ref<number>();
 
 watch(

package/src/plugin.ts

@@ -54,6 +54,7 @@ import FormDrawer from './FormDrawer.vue';
 import './theme/index.scss';
 
 export interface FormInstallOptions {
+  flat?: boolean;
   [key: string]: any;
 }
 

package/src/utils/config.ts

@@ -17,11 +17,17 @@
  */
 
 import type { Component } from 'vue';
+import { ref } from 'vue';
 
 let $MAGIC_FORM = {} as any;
+// 用 ref 持有 flat 全局开关：const 引用本身不可变，符合 `import/no-mutable-exports`；
+// 通过 `.value` 改值仍保持模块级响应式语义，与 editor/plugin.ts、design/index.ts 里
+// 的同名变量写法对齐。
+const isGlobalFlat = ref(false);
 
 const setConfig = (option: any): void => {
   $MAGIC_FORM = option;
+  isGlobalFlat.value = option.flat ?? false;
 };
 
 const getConfig = <T = unknown>(key: string): T => $MAGIC_FORM[key];
@@ -39,4 +45,4 @@ const getField = (tagName: string): Component | undefined => fieldRegistry.get(t
 
 const deleteField = (tagName: string): boolean => fieldRegistry.delete(tagName);
 
-export { deleteField, getConfig, getField, registerField, setConfig };
+export { deleteField, getConfig, getField, isGlobalFlat, registerField, setConfig };

package/types/index.d.ts

@@ -87,6 +87,11 @@ interface SubmitFormOptions {
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   * 默认 `true`，置为 `false` 时直接使用字段 name。
+   */
+  useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /** 透传给 Form.submitForm 的参数：是否直接返回原始响应式 values */
   native?: boolean;
@@ -102,6 +107,15 @@ interface SubmitFormOptions {
   appContext?: AppContext | null;
   /** 等待表单初始化的最长时间（毫秒），超时将以错误 reject。默认 10000ms */
   timeout?: number;
+  /**
+   * 调试模式。默认 `false`。
+   *
+   * - `false`：表单以隐藏方式挂载，初始化完成后自动提交（原有行为）。
+   * - `true`：将表单以弹层形式可见地渲染在页面上，需手动点击「确定」才会触发校验/提交，
+   *   点击「取消」则以 reject 中断；校验失败时保留弹层并展示错误信息，便于修正后重试。
+   *   调试模式下 `timeout` 不生效（等待人工操作）。
+   */
+  debug?: boolean;
 }
 /**
  * 开启 `returnChangeRecords` 时 submitForm 的返回结果
@@ -139,6 +153,13 @@ interface SubmitFormResult {
  *   initValues: { name: 'foo' },
  *   returnChangeRecords: true,
  * });
+ *
+ * // 调试模式：可见地渲染表单，点击「确定」才提交：
+ * const values = await submitForm({
+ *   config: [...],
+ *   initValues: { name: 'foo' },
+ *   debug: true,
+ * });
  * ```
  */
 declare const submitForm: (options: SubmitFormOptions) => Promise<any>;
@@ -185,6 +206,13 @@ type __VLS_Props$30 = {
   keyProp?: string;
   popperClass?: string;
   preventSubmitDefault?: boolean;
+  /**
+   * 表单校验失败时，错误提示前缀是否使用字段的 text 文案（通过 `getTextByName` 从 config 中查找）。
+   *
+   * - `true`（默认）：错误提示形如 `字段文案 -> 错误信息`，找不到 text 时回退为字段 name；
+   * - `false`：跳过查找，直接使用字段 name 作为错误提示前缀（形如 `字段name -> 错误信息`）。
+   */
+  useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /**
    * 自定义"是否展示对比内容"的判断函数（仅在 `isCompare === true` 时生效）。
@@ -262,6 +290,7 @@ declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   keyProp: string;
   parentValues: Record<string, any>;
   stepActive: string | number;
+  useFieldTextInError: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$30: __VLS_WithSlots$5<typeof __VLS_base$5, __VLS_Slots$5>;
 declare const _default$12: typeof __VLS_export$30;
@@ -291,7 +320,8 @@ type __VLS_Props$29 = {
   closeOnPressEscape?: boolean;
   destroyOnClose?: boolean;
   showClose?: boolean;
-  showCancel?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
+  showCancel?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /**
    * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
@@ -328,6 +358,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -370,6 +401,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -413,6 +445,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -446,6 +479,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -462,6 +496,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -476,7 +511,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -507,6 +542,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -549,6 +585,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -592,6 +629,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -625,6 +663,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -641,6 +680,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -655,7 +695,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -691,6 +731,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   destroyOnClose: boolean;
   showClose: boolean;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
   confirmText: string;
   showCancel: boolean;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
@@ -717,7 +758,8 @@ type __VLS_Props$28 = {
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
+  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
   beforeClose?: (_done: (_cancel?: boolean) => void) => void; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
   /**
@@ -755,6 +797,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -797,6 +840,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -840,6 +884,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -873,6 +918,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -889,6 +935,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -903,7 +950,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -934,6 +981,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -976,6 +1024,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -1019,6 +1068,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1052,6 +1102,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1068,6 +1119,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1082,7 +1134,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1123,6 +1175,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   values: Object;
   closeOnPressEscape: boolean;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
   confirmText: string;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$28: __VLS_WithSlots$3<typeof __VLS_base$3, __VLS_Slots$3>;
@@ -1146,7 +1199,8 @@ type __VLS_Props$27 = {
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean;
+  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
 };
 declare var __VLS_16$1: {}, __VLS_18$1: {}, __VLS_20: {};
@@ -1177,6 +1231,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -1219,6 +1274,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -1262,6 +1318,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1295,6 +1352,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1311,6 +1369,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1325,7 +1384,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1356,6 +1415,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       readonly keyProp?: string | undefined;
       readonly popperClass?: string | undefined;
       readonly preventSubmitDefault?: boolean | undefined;
+      readonly useFieldTextInError?: boolean | undefined;
       readonly extendState?: ((_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>) | undefined;
       readonly showDiff?: ((_data: {
         curValue: any;
@@ -1398,6 +1458,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp?: string;
       popperClass?: string;
       preventSubmitDefault?: boolean;
+      useFieldTextInError?: boolean;
       extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
       showDiff?: (_data: {
         curValue: any;
@@ -1441,6 +1502,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       keyProp: string;
       parentValues: Record<string, any>;
       stepActive: string | number;
+      useFieldTextInError: boolean;
     }, {}, string, {}, import("@vue/runtime-core").GlobalComponents, import("@vue/runtime-core").GlobalDirectives, string, import("@vue/runtime-core").ComponentProvideOptions> & {
       beforeCreate?: (() => void) | (() => void)[];
       created?: (() => void) | (() => void)[];
@@ -1474,6 +1536,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp: string;
     parentValues: Record<string, any>;
     stepActive: string | number;
+    useFieldTextInError: boolean;
   }> & Omit<Readonly<{
     config: schema_d_exports.FormConfig;
     initValues: Record<string, any>;
@@ -1490,6 +1553,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     keyProp?: string;
     popperClass?: string;
     preventSubmitDefault?: boolean;
+    useFieldTextInError?: boolean;
     extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
     showDiff?: (_data: {
       curValue: any;
@@ -1504,7 +1568,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
     "onField-input"?: ((...args: any[]) => any) | undefined;
     "onField-change"?: ((...args: any[]) => any) | undefined;
     "onUpdate:stepActive"?: ((...args: any[]) => any) | undefined;
-  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive")> & {
+  }>, "values" | "changeHandler" | "initialized" | "lastValuesProcessed" | "formState" | "changeRecords" | "resetForm" | "submitForm" | "getTextByName" | ("disabled" | "labelWidth" | "inline" | "labelPosition" | "config" | "height" | "initValues" | "lastValues" | "isCompare" | "keyProp" | "parentValues" | "stepActive" | "useFieldTextInError")> & {
     values: schema_d_exports.FormValue;
     lastValuesProcessed: schema_d_exports.FormValue;
     formState: schema_d_exports.FormState;
@@ -1531,6 +1595,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
 }>, {
   values: Object;
   config: schema_d_exports.FormConfig;
+  useFieldTextInError: boolean;
   confirmText: string;
 }, {}, {}, {}, string, import("@vue/runtime-core").ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$27: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
@@ -1957,6 +2022,7 @@ declare const deleteField: (tagName: string) => boolean;
 //#endregion
 //#region temp/packages/form/src/plugin.d.ts
 interface FormInstallOptions {
+  flat?: boolean;
   [key: string]: any;
 }
 declare const _default$31: {