@tmagic/form 1.8.0-beta.14 → 1.8.0-beta.16

package/dist/es/Form.vue_vue_type_script_setup_true_lang.js

@@ -145,6 +145,17 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 			}
 		});
 		/**
+		* formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+		*
+		* 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+		* 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+		*
+		* 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+		* `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+		* 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+		*/
+		const reservedStateKeys = new Set(Reflect.ownKeys(formState));
+		/**
 		* `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
 		* 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
 		*
@@ -179,7 +190,7 @@ var Form_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompo
 				return;
 			}
 			if (stale) return;
-			applyExtendState(formState, state);
+			applyExtendState(formState, state, reservedStateKeys);
 		});
 		provide("mForm", formState);
 		/**

package/dist/es/containers/Col.vue_vue_type_script_setup_true_lang.js

@@ -40,7 +40,8 @@ var Col_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineCompon
 					size: __props.size,
 					disabled: __props.disabled,
 					onChange: changeHandler,
-					onAddDiffCount
+					onAddDiffCount,
+					"is-in-row": true
 				}, null, 8, [
 					"model",
 					"lastValues",

package/dist/es/containers/Container.vue_vue_type_script_setup_true_lang.js

@@ -3,7 +3,7 @@ import { createObjectProp, display, filterFunction, getRules } from "../utils/fo
 import Hidden_default from "../fields/Hidden.js";
 import { getField } from "../utils/config.js";
 import FormLabel_default from "./FormLabel.js";
-import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, createVNode, defineComponent, inject, mergeProps, normalizeClass, normalizeStyle, openBlock, readonly, ref, renderList, renderSlot, resolveComponent, resolveDynamicComponent, toDisplayString, toRaw, unref, watch, watchEffect, withCtx } from "vue";
+import { Fragment, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, createVNode, defineComponent, inject, mergeProps, normalizeClass, normalizeStyle, openBlock, provide, readonly, ref, renderList, renderSlot, resolveComponent, resolveDynamicComponent, toDisplayString, toRaw, unref, watch, watchEffect, withCtx } from "vue";
 import { isEqual } from "lodash-es";
 import { TMagicButton, TMagicFormItem, TMagicIcon, TMagicTooltip } from "@tmagic/design";
 import { getValueByKeyPath } from "@tmagic/utils";
@@ -44,7 +44,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 		isCompare: {
 			type: Boolean,
 			default: false
-		}
+		},
+		isInRow: { type: Boolean }
 	},
 	emits: ["change", "addDiffCount"],
 	setup(__props, { emit: __emit }) {
@@ -161,6 +162,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			if (items.value && !text.value && type.value && display$1.value) return;
 			if (display$1.value && showDiff && type.value) emit("addDiffCount");
 		}, { immediate: true });
+		provide("isInRow", props.isInRow ?? false);
 		const expandHandler = () => expand.value = !expand.value;
 		const key = (config) => config[mForm?.keyProps];
 		const filterHandler = (filter, value) => {

package/dist/es/index.js

@@ -1,5 +1,5 @@
 import "./_virtual/_rolldown/runtime.js";
-import { FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } from "./schema.js";
+import { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY } from "./schema.js";
 import { clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, registerTypeMatchRule, registerTypeMatchRules, validateTypeMatch } from "./utils/typeMatch.js";
 import { adaptFormValidator, applyExtendState, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getRules, initValue, sortArray, sortChange } from "./utils/form.js";
 import { useAddField } from "./utils/useAddField.js";
@@ -40,4 +40,4 @@ import plugin_default from "./plugin.js";
 export * from "@tmagic/form-schema";
 var createForm = (config) => config;
 //#endregion
-export { FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, Cascader_default as MCascader, Checkbox_default as MCheckbox, CheckboxGroup_default as MCheckboxGroup, ColorPicker_default as MColorPicker, Container_default as MContainer, Date_default as MDate, DateTime_default as MDateTime, Daterange_default as MDaterange, Display_default as MDisplay, DynamicField_default as MDynamicField, Fieldset_default as MFieldset, FlexLayout_default as MFlexLayout, Form_default as MForm, FormBox_default as MFormBox, FormDialog_default as MFormDialog, FormDrawer_default as MFormDrawer, TableGroupList_default as MGroupList, Hidden_default as MHidden, Link_default as MLink, Number_default as MNumber, NumberRange_default as MNumberRange, Panel_default as MPanel, RadioGroup_default as MRadioGroup, Row_default as MRow, Select_default as MSelect, Switch_default as MSwitch, TableGroupList_default as MTable, TableGroupList_default as MTableGroupList, Tabs_default as MTabs, Text_default as MText, Textarea_default as MTextarea, Time_default as MTime, Timerange_default as MTimerange, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, Cascader_default as MCascader, Checkbox_default as MCheckbox, CheckboxGroup_default as MCheckboxGroup, ColorPicker_default as MColorPicker, Container_default as MContainer, Date_default as MDate, DateTime_default as MDateTime, Daterange_default as MDaterange, Display_default as MDisplay, DynamicField_default as MDynamicField, Fieldset_default as MFieldset, FlexLayout_default as MFlexLayout, Form_default as MForm, FormBox_default as MFormBox, FormDialog_default as MFormDialog, FormDrawer_default as MFormDrawer, TableGroupList_default as MGroupList, Hidden_default as MHidden, Link_default as MLink, Number_default as MNumber, NumberRange_default as MNumberRange, Panel_default as MPanel, RadioGroup_default as MRadioGroup, Row_default as MRow, Select_default as MSelect, Switch_default as MSwitch, TableGroupList_default as MTable, TableGroupList_default as MTableGroupList, Tabs_default as MTabs, Text_default as MText, Textarea_default as MTextarea, Time_default as MTime, Timerange_default as MTimerange, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };

package/dist/es/schema.js

@@ -3,5 +3,15 @@ export * from "@tmagic/form-schema";
 //#region packages/form/src/schema.ts
 var FORM_DIFF_CONFIG_KEY = Symbol("mFormDiffConfig");
 var FORM_TYPE_MATCH_VALID_KEY = Symbol("mFormTypeMatchValid");
+/**
+* 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+*
+* 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
+* 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+*
+* 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
+* 字段组件可以安全跳过，接入前需逐一审计。
+*/
+var FORM_SILENT_MODE_KEY = Symbol("mFormSilentMode");
 //#endregion
-export { FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY };
+export { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY };

package/dist/es/submitForm.js

@@ -1,6 +1,7 @@
+import { FORM_SILENT_MODE_KEY } from "./schema.js";
 import { applyExtendState } from "./utils/form.js";
 import Form_default from "./Form.js";
-import { createApp, defineComponent, h, nextTick, ref, watch } from "vue";
+import { createApp, defineComponent, h, nextTick, provide, ref, watch } from "vue";
 //#region packages/form/src/submitForm.ts
 /**
 * submitForm / validateForm 的公共脚手架：
@@ -41,7 +42,7 @@ var mountFormInstance = (options) => {
 			resolve,
 			reject
 		});
-		const app = createApp(typeof extendState === "function" ? defineComponent({
+		const wrapperComponent = typeof extendState === "function" ? defineComponent({
 			name: "MFormExtendStateInjector",
 			setup() {
 				watch(() => formRef.value, (form) => {
@@ -53,7 +54,8 @@ var mountFormInstance = (options) => {
 						console.error("[MForm] extendState failed:", e);
 						return;
 					}
-					const apply = (state) => applyExtendState(form.formState, state);
+					const reservedStateKeys = new Set(Reflect.ownKeys(form.formState));
+					const apply = (state) => applyExtendState(form.formState, state, reservedStateKeys);
 					if (result && typeof result.then === "function") result.then(apply, (e) => console.error("[MForm] extendState failed:", e));
 					else apply(result);
 				}, {
@@ -62,7 +64,14 @@ var mountFormInstance = (options) => {
 				});
 				return () => h(userWrapper);
 			}
-		}) : userWrapper);
+		}) : userWrapper;
+		const app = createApp(hidden ? defineComponent({
+			name: "MFormSilentProvider",
+			setup() {
+				provide(FORM_SILENT_MODE_KEY, true);
+				return () => h(wrapperComponent);
+			}
+		}) : wrapperComponent);
 		instance.app = app;
 		if (appContext) Object.assign(app._context, appContext);
 		if (timeout > 0 && !skipTimeout) timer = setTimeout(() => {

package/dist/es/utils/form.js

@@ -211,15 +211,19 @@ var sortChange = (data, { prop, order }) => {
 * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
 *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
 *
-* 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
-* isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
-* 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
-* `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
-* 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+* 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+* 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+* config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+* post 等），命中这些 key 时统一跳过并告警。
+*
+* 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+* 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+* `TypeError: 'set' on proxy: trap returned falsish`。
 */
-var applyExtendState = (formState, state) => {
+var applyExtendState = (formState, state, reservedKeys) => {
 	if (!state) return;
 	for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+		if (reservedKeys?.has(key)) continue;
 		if (!("value" in descriptor)) {
 			descriptor.configurable = true;
 			Object.defineProperty(formState, key, descriptor);

package/dist/es/utils/typeMatch.js

@@ -89,7 +89,7 @@ var stringifyExampleValue = (value) => {
 	}
 	return String(value);
 };
-var MAX_SUGGESTION_OPTIONS = 5;
+var MAX_SUGGESTION_OPTIONS = 20;
 /**
 * 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
 * 可选值超过 MAX_SUGGESTION_OPTIONS 个时仅展示前若干个并以「等」省略。
@@ -313,6 +313,7 @@ var validateBuiltinTypeMatch = (value, fieldType, mForm, props, message) => {
 			return;
 		}
 		if (typeof config.filter === "function") return;
+		if (fieldType === "text" && isNumberValue(value)) return;
 		if (typeof value !== "string") return defaultMessage(message, `${value} 类型应为字符串`, typeExampleSuggestion(mForm, props, "\"文本内容\"", isStringValue));
 		return;
 	}
@@ -362,6 +363,7 @@ var validateBuiltinTypeMatch = (value, fieldType, mForm, props, message) => {
 };
 var validateTypeMatch = (value, mForm, props, message) => {
 	if (isEmptyValue(value) || isEmptyArray(value)) return;
+	if (!props.config?.name) return;
 	const rawFieldType = "type" in (props.config || {}) ? props.config.type : "";
 	if (typeof rawFieldType !== "string" || !rawFieldType) return;
 	const fieldType = toLine(rawFieldType);

package/dist/tmagic-form.umd.cjs

@@ -43,6 +43,16 @@
 	//#region packages/form/src/schema.ts
 	var FORM_DIFF_CONFIG_KEY = Symbol("mFormDiffConfig");
 	var FORM_TYPE_MATCH_VALID_KEY = Symbol("mFormTypeMatchValid");
+	/**
+	* 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+	*
+	* 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
+	* 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+	*
+	* 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
+	* 字段组件可以安全跳过，接入前需逐一审计。
+	*/
+	var FORM_SILENT_MODE_KEY = Symbol("mFormSilentMode");
 	//#endregion
 	//#region node_modules/.pnpm/lodash-es@4.17.21/node_modules/lodash-es/_freeGlobal.js
 	/** Detect free variable `global` from Node.js. */
@@ -2806,7 +2816,7 @@
 		}
 		return String(value);
 	};
-	var MAX_SUGGESTION_OPTIONS = 5;
+	var MAX_SUGGESTION_OPTIONS = 20;
 	/**
 	* 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
 	* 可选值超过 MAX_SUGGESTION_OPTIONS 个时仅展示前若干个并以「等」省略。
@@ -3030,6 +3040,7 @@
 				return;
 			}
 			if (typeof config.filter === "function") return;
+			if (fieldType === "text" && isNumberValue(value)) return;
 			if (typeof value !== "string") return defaultMessage(message, `${value} 类型应为字符串`, typeExampleSuggestion(mForm, props, "\"文本内容\"", isStringValue));
 			return;
 		}
@@ -3079,6 +3090,7 @@
 	};
 	var validateTypeMatch = (value, mForm, props, message) => {
 		if (isEmptyValue(value) || isEmptyArray(value)) return;
+		if (!props.config?.name) return;
 		const rawFieldType = "type" in (props.config || {}) ? props.config.type : "";
 		if (typeof rawFieldType !== "string" || !rawFieldType) return;
 		const fieldType = (0, _tmagic_utils.toLine)(rawFieldType);
@@ -3328,15 +3340,19 @@
 	* - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
 	*   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
 	*
-	* 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
-	* isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
-	* 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
-	* `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
-	* 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+	* 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+	* 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+	* config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+	* post 等），命中这些 key 时统一跳过并告警。
+	*
+	* 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+	* 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+	* `TypeError: 'set' on proxy: trap returned falsish`。
 	*/
-	var applyExtendState = (formState, state) => {
+	var applyExtendState = (formState, state, reservedKeys) => {
 		if (!state) return;
 		for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+			if (reservedKeys?.has(key)) continue;
 			if (!("value" in descriptor)) {
 				descriptor.configurable = true;
 				Object.defineProperty(formState, key, descriptor);
@@ -3494,7 +3510,8 @@
 			isCompare: {
 				type: Boolean,
 				default: false
-			}
+			},
+			isInRow: { type: Boolean }
 		},
 		emits: ["change", "addDiffCount"],
 		setup(__props, { emit: __emit }) {
@@ -3611,6 +3628,7 @@
 				if (items.value && !text.value && type.value && display$3.value) return;
 				if (display$3.value && showDiff && type.value) emit("addDiffCount");
 			}, { immediate: true });
+			(0, vue.provide)("isInRow", props.isInRow ?? false);
 			const expandHandler = () => expand.value = !expand.value;
 			const key = (config) => config[mForm?.keyProps];
 			const filterHandler = (filter, value) => {
@@ -4153,6 +4171,17 @@
 				}
 			});
 			/**
+			* formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+			*
+			* 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+			* 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+			*
+			* 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+			* `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+			* 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+			*/
+			const reservedStateKeys = new Set(Reflect.ownKeys(formState));
+			/**
 			* `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
 			* 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
 			*
@@ -4187,7 +4216,7 @@
 					return;
 				}
 				if (stale) return;
-				applyExtendState(formState, state);
+				applyExtendState(formState, state, reservedStateKeys);
 			});
 			(0, vue.provide)("mForm", formState);
 			/**
@@ -4430,7 +4459,7 @@
 				resolve,
 				reject
 			});
-			const app = (0, vue.createApp)(typeof extendState === "function" ? (0, vue.defineComponent)({
+			const wrapperComponent = typeof extendState === "function" ? (0, vue.defineComponent)({
 				name: "MFormExtendStateInjector",
 				setup() {
 					(0, vue.watch)(() => formRef.value, (form) => {
@@ -4442,7 +4471,8 @@
 							console.error("[MForm] extendState failed:", e);
 							return;
 						}
-						const apply = (state) => applyExtendState(form.formState, state);
+						const reservedStateKeys = new Set(Reflect.ownKeys(form.formState));
+						const apply = (state) => applyExtendState(form.formState, state, reservedStateKeys);
 						if (result && typeof result.then === "function") result.then(apply, (e) => console.error("[MForm] extendState failed:", e));
 						else apply(result);
 					}, {
@@ -4451,7 +4481,14 @@
 					});
 					return () => (0, vue.h)(userWrapper);
 				}
-			}) : userWrapper);
+			}) : userWrapper;
+			const app = (0, vue.createApp)(hidden ? (0, vue.defineComponent)({
+				name: "MFormSilentProvider",
+				setup() {
+					(0, vue.provide)(FORM_SILENT_MODE_KEY, true);
+					return () => (0, vue.h)(wrapperComponent);
+				}
+			}) : wrapperComponent);
 			instance.app = app;
 			if (appContext) Object.assign(app._context, appContext);
 			if (timeout > 0 && !skipTimeout) timer = setTimeout(() => {
@@ -5766,7 +5803,8 @@
 						size: __props.size,
 						disabled: __props.disabled,
 						onChange: changeHandler,
-						onAddDiffCount
+						onAddDiffCount,
+						"is-in-row": true
 					}, null, 8, [
 						"model",
 						"lastValues",
@@ -9204,6 +9242,7 @@
 	var createForm = (config) => config;
 	//#endregion
 	exports.FORM_DIFF_CONFIG_KEY = FORM_DIFF_CONFIG_KEY;
+	exports.FORM_SILENT_MODE_KEY = FORM_SILENT_MODE_KEY;
 	exports.FORM_TYPE_MATCH_VALID_KEY = FORM_TYPE_MATCH_VALID_KEY;
 	exports.MCascader = Cascader_default;
 	exports.MCheckbox = Checkbox_default;

package/package.json

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

package/src/Form.vue

@@ -261,6 +261,18 @@ const formState: FormState = reactive<FormState>({
   },
 });
 
+/**
+ * formState 的内置 key 快照（keyProp / values / $emit / fields / post 等）。
+ *
+ * 在 `extendState` 首次合并前捕获，`applyExtendState` 会据此禁止 `extendState`
+ * 覆盖这些已有字段（只能新增字段），避免表单核心状态被外部意外改写。
+ *
+ * 之所以在此处（effect 之外）捕获而不是在 `applyExtendState` 内动态取：
+ * `watchEffect` 会在依赖变化时重跑，若动态取，`extendState` 自己新增的字段在第二次
+ * 合并时也会被当成「已有 key」而拒绝刷新；这里只锁定内置字段即可规避该问题。
+ */
+const reservedStateKeys = new Set<string | symbol>(Reflect.ownKeys(formState));
+
 /**
  * `extendState` 的同步段（直到第一个 `await` 之前）所访问的任何响应式数据，
  * 都会被 `watchEffect` 自动跟踪。这样可以兼容历史用法 ——
@@ -299,7 +311,7 @@ watchEffect(async (onCleanup) => {
   }
   if (stale) return;
 
-  applyExtendState(formState, state);
+  applyExtendState(formState, state, reservedStateKeys);
 });
 
 provide('mForm', formState);

package/src/containers/Col.vue

@@ -12,6 +12,7 @@
       :disabled="disabled"
       @change="changeHandler"
       @add-diff-count="onAddDiffCount"
+      :is-in-row="true"
     ></Container>
   </TMagicCol>
 </template>

package/src/containers/Container.vue

@@ -240,7 +240,7 @@
 </template>
 
 <script setup lang="ts">
-import { computed, inject, readonly, ref, toRaw, watch, watchEffect } from 'vue';
+import { computed, inject, provide, readonly, ref, toRaw, watch, watchEffect } from 'vue';
 import { ArrowDown, ArrowUp, WarningFilled } from '@element-plus/icons-vue';
 import { isEqual } from 'lodash-es';
 
@@ -287,6 +287,8 @@ const props = withDefaults(
     size?: string;
     /** 是否开启对比模式 */
     isCompare?: boolean;
+    /** 是否在行容器中 */
+    isInRow?: boolean;
   }>(),
   {
     prop: '',
@@ -476,6 +478,8 @@ watch(
   },
 );
 
+provide('isInRow', props.isInRow ?? false);
+
 const expandHandler = () => (expand.value = !expand.value);
 
 const key = (config: any) => config[mForm?.keyProps];

package/src/schema.ts

@@ -29,6 +29,17 @@ export interface FormDiffConfig {
 export const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig> = Symbol('mFormDiffConfig');
 export const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>> = Symbol('mFormTypeMatchValid');
 
+/**
+ * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+ *
+ * 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
+ * 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+ *
+ * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
+ * 字段组件可以安全跳过，接入前需逐一审计。
+ */
+export const FORM_SILENT_MODE_KEY: InjectionKey<boolean> = Symbol('mFormSilentMode');
+
 export interface ValidateError {
   message: string;
   field: string;

package/src/submitForm.ts

@@ -16,11 +16,22 @@
  * limitations under the License.
  */
 
-import { type AppContext, type Component, createApp, defineComponent, h, nextTick, type Ref, ref, watch } from 'vue';
+import {
+  type AppContext,
+  type Component,
+  createApp,
+  defineComponent,
+  h,
+  nextTick,
+  provide,
+  type Ref,
+  ref,
+  watch,
+} from 'vue';
 
 import { applyExtendState } from './utils/form';
 import Form from './Form.vue';
-import type { ChangeRecord, FormConfig, FormState } from './schema';
+import { type ChangeRecord, FORM_SILENT_MODE_KEY, type FormConfig, type FormState } from './schema';
 
 // #region SubmitFormOptions
 /**
@@ -193,10 +204,14 @@ const mountFormInstance = <T>(options: MountFormInstanceOptions<T>): Promise<T>
                     console.error('[MForm] extendState failed:', e);
                     return;
                   }
+                  // formState 的内置 key 快照：在 extendState 合并前捕获，
+                  // 供 applyExtendState 禁止 extendState 覆盖这些已有字段（只能新增），
+                  // 与 Form.vue 中 reservedStateKeys 的语义保持一致。
+                  const reservedStateKeys = new Set<string | symbol>(Reflect.ownKeys(form.formState));
                   // 合并逻辑收口在 applyExtendState：props 派生的只读 getter 字段
                   // （keyProp 等）以普通字段形式返回时会被跳过并告警，避免 proxy set 抛错
                   const apply = (state: Record<string, any> | null | undefined) =>
-                    applyExtendState(form.formState, state);
+                    applyExtendState(form.formState, state, reservedStateKeys);
                   if (result && typeof result.then === 'function') {
                     result.then(apply, (e: any) => console.error('[MForm] extendState failed:', e));
                   } else {
@@ -210,7 +225,21 @@ const mountFormInstance = <T>(options: MountFormInstanceOptions<T>): Promise<T>
           })
         : userWrapper;
 
-    const app = createApp(wrapperComponent);
+    // 静默（隐藏挂载）模式下注入静默标记：vs-code 等重型字段组件可据此跳过自身渲染，
+    // 校验/取值依赖 FormItem 与 model 值，与叶子 UI 组件无关（见 FORM_SILENT_MODE_KEY 注释）。
+    // 用组件级 provide 而非 app.provide：appContext 合并后 app._context.provides 与父级应用
+    // 共享引用，app.provide 会把标记泄漏到父级应用。
+    const rootComponent = hidden
+      ? defineComponent({
+          name: 'MFormSilentProvider',
+          setup() {
+            provide(FORM_SILENT_MODE_KEY, true);
+            return () => h(wrapperComponent);
+          },
+        })
+      : wrapperComponent;
+
+    const app = createApp(rootComponent);
     instance.app = app;
 
     // 继承父级应用上下文（components / directives / provides / config 等）

package/src/utils/form.ts

@@ -449,16 +449,27 @@ export const sortChange = (data: any[], { prop, order }: SortProp) => {
  * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
  *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
  *
- * 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
- * isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
- * 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
- * `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
- * 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+ * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+ * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+ * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+ * post 等），命中这些 key 时统一跳过并告警。
+ *
+ * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+ * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`。
  */
-export const applyExtendState = (formState: FormState, state: Record<string, any> | null | undefined): void => {
+export const applyExtendState = (
+  formState: FormState,
+  state: Record<string, any> | null | undefined,
+  reservedKeys?: Set<string | symbol>,
+): void => {
   if (!state) return;
 
   for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(state))) {
+    if (reservedKeys?.has(key)) {
+      continue;
+    }
+
     if (!('value' in descriptor)) {
       descriptor.configurable = true;
       Object.defineProperty(formState, key, descriptor);

package/src/utils/typeMatch.ts

@@ -142,7 +142,7 @@ const stringifyExampleValue = (value: any): string => {
 };
 
 // 参考建议中最多展示的可选值个数，超出以「等」省略。
-const MAX_SUGGESTION_OPTIONS = 5;
+const MAX_SUGGESTION_OPTIONS = 20;
 
 /**
  * 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
@@ -558,6 +558,11 @@ const validateBuiltinTypeMatch = (
       return undefined;
     }
 
+    // text 常与数字（如 id、数量）绑定，值允许为数字；错误建议仍按字符串给出
+    if (fieldType === 'text' && isNumberValue(value)) {
+      return undefined;
+    }
+
     if (typeof value !== 'string') {
       return defaultMessage(
         message,
@@ -697,9 +702,13 @@ export const validateTypeMatch = (
     return undefined;
   }
 
+  if (!props.config?.name) {
+    return undefined;
+  }
+
   const rawFieldType = 'type' in (props.config || {}) ? props.config.type : '';
   if (typeof rawFieldType !== 'string' || !rawFieldType) {
-    return;
+    return undefined;
   }
 
   // 统一将驼峰形式（如 radioGroup）归一化为连字符形式（radio-group），与内置规则的 key 保持一致

package/types/index.d.ts

@@ -4,7 +4,7 @@ export * from "@tmagic/form-schema";
 
 //#region \0rolldown/runtime.js
 declare namespace schema_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
 }
 import * as import__tmagic_form_schema from "@tmagic/form-schema";
 /**
@@ -34,6 +34,16 @@ interface FormDiffConfig {
 }
 declare const FORM_DIFF_CONFIG_KEY: InjectionKey<FormDiffConfig>;
 declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
+/**
+ * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+ *
+ * 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
+ * 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+ *
+ * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
+ * 字段组件可以安全跳过，接入前需逐一审计。
+ */
+declare const FORM_SILENT_MODE_KEY: InjectionKey<boolean>;
 interface ValidateError {
   message: string;
   field: string;
@@ -280,13 +290,16 @@ declare const sortChange: (data: any[], {
  * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
  *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
  *
- * 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
- * isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
- * 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
- * `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
- * 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+ * 注意：extendState 只能向 formState「新增」字段，不允许覆盖其已有 key。
+ * 调用方可通过 `reservedKeys` 传入合并前已存在的内置 key 快照（keyProp / popperClass /
+ * config / initValues / isCompare / lastValues / parentValues / values / $emit / fields /
+ * post 等），命中这些 key 时统一跳过并告警。
+ *
+ * 兜底：未传 `reservedKeys` 时，仍会拦截 props 派生的只读 getter 字段（无 setter），
+ * 否则以普通字段形式赋值会让 proxy 的 set trap 抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`。
  */
-declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined) => void;
+declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined, reservedKeys?: Set<string | symbol>) => void;
 declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts
@@ -1773,7 +1786,8 @@ type __VLS_Props$26 = {
   expandMore?: boolean;
   stepActive?: string | number;
   size?: string; /** 是否开启对比模式 */
-  isCompare?: boolean;
+  isCompare?: boolean; /** 是否在行容器中 */
+  isInRow?: boolean;
 };
 declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (v: any, eventData: ContainerChangeEventData) => any;
@@ -2207,8 +2221,8 @@ declare const _default$31: {
   install(app: App, opt?: FormInstallOptions): void;
 };
 declare namespace index_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
 }
 declare const createForm: <T extends [] = []>(config: schema_d_exports.FormConfig | T) => schema_d_exports.FormConfig | T;
 //#endregion
-export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };