@tmagic/form 1.8.0-beta.23 → 1.8.0-beta.24

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

@@ -1,7 +1,8 @@
-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 { createObjectProp, display, filterFunction, getRules } from "../utils/form.js";
 import Hidden_default from "../fields/Hidden.js";
 import { getField } from "../utils/config.js";
+import { getSilentLeafFieldTypes } from "../utils/silentLeafFieldTypes.js";
 import FormLabel_default from "./FormLabel.js";
 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";
@@ -117,6 +118,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 			return new Set(DEFAULT_SELF_DIFF_FIELD_TYPES);
 		});
 		const isSelfDiffField = computed(() => effectiveSelfDiffFieldTypes.value.has(type.value));
+		const silentMode = inject(FORM_SILENT_MODE_KEY, false);
+		const shouldRenderLeafField = computed(() => !silentMode || !getSilentLeafFieldTypes().has(type.value));
 		const disabled = computed(() => props.disabled || filterFunction(mForm, props.config.disabled, props));
 		const text = computed(() => filterFunction(mForm, props.config.text, props));
 		const tooltip = computed(() => {
@@ -292,7 +295,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 				"label-width",
 				"style"
 			])) : type.value && display$1.value && !showDiff.value ? (openBlock(), createElementBlock(Fragment, { key: 2 }, [createVNode(unref(TMagicFormItem), mergeProps(formItemProps.value, { class: { "tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value } }), {
-				label: withCtx(() => [renderSlot(_ctx.$slots, "label", {
+				label: withCtx(() => [shouldRenderLeafField.value ? renderSlot(_ctx.$slots, "label", {
 					config: __props.config,
 					type: type.value,
 					text: text.value,
@@ -310,8 +313,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 					"use-label",
 					"label-title",
 					"text"
-				]), __props.config.titleExtra && __props.config.labelPosition === "top" ? (openBlock(), createElementBlock("span", _hoisted_2, toDisplayString(__props.config.titleExtra), 1)) : createCommentVNode("v-if", true)])]),
-				default: withCtx(() => [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
+				]), __props.config.titleExtra && __props.config.labelPosition === "top" ? (openBlock(), createElementBlock("span", _hoisted_2, toDisplayString(__props.config.titleExtra), 1)) : createCommentVNode("v-if", true)], void 0, 0) : createCommentVNode("v-if", true)]),
+				default: withCtx(() => [shouldRenderLeafField.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
 					key: 0,
 					placement: tooltip.value.placement
 				}, {
@@ -338,9 +341,9 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 					"model",
 					"last-values",
 					"is-compare"
-				]))]),
+				]))], 64)) : createCommentVNode("v-if", true)]),
 				_: 3
-			}, 16, ["class"]), __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
+			}, 16, ["class"]), shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
 				key: 0,
 				placement: "top"
 			}, {
@@ -360,7 +363,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 					"tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value,
 					"self-diff": true
 				} }), {
-					label: withCtx(() => [renderSlot(_ctx.$slots, "label", {
+					label: withCtx(() => [shouldRenderLeafField.value ? renderSlot(_ctx.$slots, "label", {
 						config: __props.config,
 						type: type.value,
 						text: text.value,
@@ -378,8 +381,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 						"use-label",
 						"label-title",
 						"text"
-					])])]),
-					default: withCtx(() => [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
+					])], void 0, 0) : createCommentVNode("v-if", true)]),
+					default: withCtx(() => [shouldRenderLeafField.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
 						key: 0,
 						placement: tooltip.value.placement
 					}, {
@@ -404,7 +407,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 						"model",
 						"last-values",
 						"is-compare"
-					]))]),
+					]))], 64)) : createCommentVNode("v-if", true)]),
 					_: 3
 				}, 16, ["class"])) : (openBlock(), createElementBlock(Fragment, { key: 1 }, [
 					createCommentVNode(" 普通字段：渲染前后两份独立的组件用于对比 "),
@@ -413,7 +416,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 						"tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value,
 						"show-before-diff": true
 					} }), {
-						label: withCtx(() => [renderSlot(_ctx.$slots, "label", {
+						label: withCtx(() => [shouldRenderLeafField.value ? renderSlot(_ctx.$slots, "label", {
 							config: __props.config,
 							type: type.value,
 							text: text.value,
@@ -431,8 +434,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 							"use-label",
 							"label-title",
 							"text"
-						])])]),
-						default: withCtx(() => [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
+						])], void 0, 0) : createCommentVNode("v-if", true)]),
+						default: withCtx(() => [shouldRenderLeafField.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
 							key: 0,
 							placement: tooltip.value.placement
 						}, {
@@ -445,10 +448,10 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 						}, 8, ["placement"])) : (openBlock(), createBlock(resolveDynamicComponent(tagName.value), mergeProps({ key: 1 }, fieldsProps.value, {
 							model: __props.lastValues,
 							onChange: onChangeHandler
-						}), null, 16, ["model"]))]),
+						}), null, 16, ["model"]))], 64)) : createCommentVNode("v-if", true)]),
 						_: 3
 					}, 16, ["class"]),
-					__props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
+					shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
 						key: 0,
 						placement: "top"
 					}, {
@@ -470,7 +473,7 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 							"show-after-diff": true
 						}
 					}), {
-						label: withCtx(() => [renderSlot(_ctx.$slots, "label", {
+						label: withCtx(() => [shouldRenderLeafField.value ? renderSlot(_ctx.$slots, "label", {
 							config: __props.config,
 							type: type.value,
 							text: text.value,
@@ -488,8 +491,8 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 							"use-label",
 							"label-title",
 							"text"
-						])])]),
-						default: withCtx(() => [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
+						])], void 0, 0) : createCommentVNode("v-if", true)]),
+						default: withCtx(() => [shouldRenderLeafField.value ? (openBlock(), createElementBlock(Fragment, { key: 0 }, [tooltip.value.text ? (openBlock(), createBlock(unref(TMagicTooltip), {
 							key: 0,
 							placement: tooltip.value.placement
 						}, {
@@ -502,10 +505,10 @@ var Container_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ define
 						}, 8, ["placement"])) : (openBlock(), createBlock(resolveDynamicComponent(tagName.value), mergeProps({ key: 1 }, fieldsProps.value, {
 							model: __props.model,
 							onChange: onChangeHandler
-						}), null, 16, ["model"]))]),
+						}), null, 16, ["model"]))], 64)) : createCommentVNode("v-if", true)]),
 						_: 3
 					}, 16, ["style", "class"]),
-					__props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
+					shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? (openBlock(), createBlock(unref(TMagicTooltip), {
 						key: 1,
 						placement: "top"
 					}, {

package/dist/es/index.js

@@ -4,6 +4,7 @@ import { adaptFormValidator, applyExtendState, createObjectProp, createValues, d
 import { useAddField } from "./utils/useAddField.js";
 import Hidden_default from "./fields/Hidden.js";
 import { deleteField, getField, registerField } from "./utils/config.js";
+import { clearSilentLeafFieldTypes, getSilentLeafFieldTypes, registerSilentLeafFieldTypes } from "./utils/silentLeafFieldTypes.js";
 import Container_default from "./containers/Container.js";
 import Form_default from "./Form.js";
 import { stripTabItemsLazy, submitForm, validateForm } from "./submitForm.js";
@@ -40,4 +41,4 @@ export * from "@tmagic/form-schema";
 //#region packages/form/src/index.ts
 var createForm = (config) => config;
 //#endregion
-export { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, MAX_SUGGESTION_OPTIONS, 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, optionSuggestion, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, MAX_SUGGESTION_OPTIONS, 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, clearSilentLeafFieldTypes, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getSilentLeafFieldTypes, getTypeMatchRule, initValue, optionSuggestion, registerField as registerFormField, registerSilentLeafFieldTypes, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };

package/dist/es/schema.js

@@ -5,11 +5,12 @@ var FORM_TYPE_MATCH_VALID_KEY = Symbol("mFormTypeMatchValid");
 /**
 * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
 *
-* 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
-* 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+* Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
+* 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
+* 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
 *
 * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
-* 字段组件可以安全跳过，接入前需逐一审计。
+* 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
 */
 var FORM_SILENT_MODE_KEY = Symbol("mFormSilentMode");
 //#endregion

package/dist/es/utils/silentLeafFieldTypes.js

@@ -0,0 +1,49 @@
+import { toLine } from "@tmagic/utils";
+//#region packages/form/src/utils/silentLeafFieldTypes.ts
+/**
+* 可在静默校验模式下跳过渲染的内置叶子字段（默认集合）。
+*
+* 这些字段只渲染一个输入控件，内部没有嵌套 FormItem，且不会依赖组件挂载修改 model；
+* 字段值由初始化逻辑处理（包括 defaultValue），因此跳过不影响校验结果。
+*
+* 业务侧可通过 `registerSilentLeafFieldTypes` 追加已审计的安全自定义字段。
+*/
+var LEAF_FIELD_TYPES = /* @__PURE__ */ new Set([
+	"text",
+	"textarea",
+	"number",
+	"time",
+	"daterange",
+	"timerange",
+	"checkbox",
+	"radio-group",
+	"switch",
+	"select",
+	"cascader",
+	"color-picker",
+	"link"
+]);
+/** 业务侧追加的静默叶子字段（不含内置默认集合） */
+var extraSilentLeafFieldTypes = /* @__PURE__ */ new Set();
+/**
+* 注册可在静默校验中跳过渲染的叶子字段 type（追加到默认 `LEAF_FIELD_TYPES` 之上）。
+*
+* 仅应纳入「无嵌套 FormItem、无挂载值副作用」的字段；复合 / 动态子表单不可加入。
+*/
+var registerSilentLeafFieldTypes = (types) => {
+	for (const type of types) {
+		if (typeof type !== "string" || !type) continue;
+		extraSilentLeafFieldTypes.add(toLine(type));
+	}
+};
+/** 当前生效的静默叶子字段集合：内置默认 ∪ 已注册扩展 */
+var getSilentLeafFieldTypes = () => {
+	if (extraSilentLeafFieldTypes.size === 0) return LEAF_FIELD_TYPES;
+	return /* @__PURE__ */ new Set([...LEAF_FIELD_TYPES, ...extraSilentLeafFieldTypes]);
+};
+/** 清空业务侧追加的静默叶子字段（不影响内置默认集合；主要用于单测） */
+var clearSilentLeafFieldTypes = () => {
+	extraSilentLeafFieldTypes.clear();
+};
+//#endregion
+export { LEAF_FIELD_TYPES, clearSilentLeafFieldTypes, getSilentLeafFieldTypes, registerSilentLeafFieldTypes };

package/dist/tmagic-form.umd.cjs

@@ -46,11 +46,12 @@
 	/**
 	* 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
 	*
-	* 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
-	* 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+	* Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
+	* 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
+	* 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
 	*
 	* 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
-	* 字段组件可以安全跳过，接入前需逐一审计。
+	* 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
 	*/
 	var FORM_SILENT_MODE_KEY = Symbol("mFormSilentMode");
 	//#endregion
@@ -3507,6 +3508,53 @@
 	var getField = (tagName) => fieldRegistry.get(tagName);
 	var deleteField = (tagName) => fieldRegistry.delete(tagName);
 	//#endregion
+	//#region packages/form/src/utils/silentLeafFieldTypes.ts
+	/**
+	* 可在静默校验模式下跳过渲染的内置叶子字段（默认集合）。
+	*
+	* 这些字段只渲染一个输入控件，内部没有嵌套 FormItem，且不会依赖组件挂载修改 model；
+	* 字段值由初始化逻辑处理（包括 defaultValue），因此跳过不影响校验结果。
+	*
+	* 业务侧可通过 `registerSilentLeafFieldTypes` 追加已审计的安全自定义字段。
+	*/
+	var LEAF_FIELD_TYPES = /* @__PURE__ */ new Set([
+		"text",
+		"textarea",
+		"number",
+		"time",
+		"daterange",
+		"timerange",
+		"checkbox",
+		"radio-group",
+		"switch",
+		"select",
+		"cascader",
+		"color-picker",
+		"link"
+	]);
+	/** 业务侧追加的静默叶子字段（不含内置默认集合） */
+	var extraSilentLeafFieldTypes = /* @__PURE__ */ new Set();
+	/**
+	* 注册可在静默校验中跳过渲染的叶子字段 type（追加到默认 `LEAF_FIELD_TYPES` 之上）。
+	*
+	* 仅应纳入「无嵌套 FormItem、无挂载值副作用」的字段；复合 / 动态子表单不可加入。
+	*/
+	var registerSilentLeafFieldTypes = (types) => {
+		for (const type of types) {
+			if (typeof type !== "string" || !type) continue;
+			extraSilentLeafFieldTypes.add((0, _tmagic_utils.toLine)(type));
+		}
+	};
+	/** 当前生效的静默叶子字段集合：内置默认 ∪ 已注册扩展 */
+	var getSilentLeafFieldTypes = () => {
+		if (extraSilentLeafFieldTypes.size === 0) return LEAF_FIELD_TYPES;
+		return /* @__PURE__ */ new Set([...LEAF_FIELD_TYPES, ...extraSilentLeafFieldTypes]);
+	};
+	/** 清空业务侧追加的静默叶子字段（不影响内置默认集合；主要用于单测） */
+	var clearSilentLeafFieldTypes = () => {
+		extraSilentLeafFieldTypes.clear();
+	};
+	//#endregion
 	//#region packages/form/src/containers/FormLabel.vue?vue&type=script&setup=true&lang.ts
 	var _hoisted_1$15 = {
 		key: 0,
@@ -3667,6 +3715,8 @@
 				return new Set(DEFAULT_SELF_DIFF_FIELD_TYPES);
 			});
 			const isSelfDiffField = (0, vue.computed)(() => effectiveSelfDiffFieldTypes.value.has(type.value));
+			const silentMode = (0, vue.inject)(FORM_SILENT_MODE_KEY, false);
+			const shouldRenderLeafField = (0, vue.computed)(() => !silentMode || !getSilentLeafFieldTypes().has(type.value));
 			const disabled = (0, vue.computed)(() => props.disabled || filterFunction(mForm, props.config.disabled, props));
 			const text = (0, vue.computed)(() => filterFunction(mForm, props.config.text, props));
 			const tooltip = (0, vue.computed)(() => {
@@ -3842,7 +3892,7 @@
 					"label-width",
 					"style"
 				])) : type.value && display$3.value && !showDiff.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 2 }, [(0, vue.createVNode)((0, vue.unref)(_tmagic_design.TMagicFormItem), (0, vue.mergeProps)(formItemProps.value, { class: { "tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value } }), {
-					label: (0, vue.withCtx)(() => [(0, vue.renderSlot)(_ctx.$slots, "label", {
+					label: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? (0, vue.renderSlot)(_ctx.$slots, "label", {
 						config: __props.config,
 						type: type.value,
 						text: text.value,
@@ -3860,8 +3910,8 @@
 						"use-label",
 						"label-title",
 						"text"
-					]), __props.config.titleExtra && __props.config.labelPosition === "top" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_2$8, (0, vue.toDisplayString)(__props.config.titleExtra), 1)) : (0, vue.createCommentVNode)("v-if", true)])]),
-					default: (0, vue.withCtx)(() => [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+					]), __props.config.titleExtra && __props.config.labelPosition === "top" ? ((0, vue.openBlock)(), (0, vue.createElementBlock)("span", _hoisted_2$8, (0, vue.toDisplayString)(__props.config.titleExtra), 1)) : (0, vue.createCommentVNode)("v-if", true)], void 0, 0) : (0, vue.createCommentVNode)("v-if", true)]),
+					default: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 						key: 0,
 						placement: tooltip.value.placement
 					}, {
@@ -3888,9 +3938,9 @@
 						"model",
 						"last-values",
 						"is-compare"
-					]))]),
+					]))], 64)) : (0, vue.createCommentVNode)("v-if", true)]),
 					_: 3
-				}, 16, ["class"]), __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+				}, 16, ["class"]), shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 					key: 0,
 					placement: "top"
 				}, {
@@ -3910,7 +3960,7 @@
 						"tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value,
 						"self-diff": true
 					} }), {
-						label: (0, vue.withCtx)(() => [(0, vue.renderSlot)(_ctx.$slots, "label", {
+						label: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? (0, vue.renderSlot)(_ctx.$slots, "label", {
 							config: __props.config,
 							type: type.value,
 							text: text.value,
@@ -3928,8 +3978,8 @@
 							"use-label",
 							"label-title",
 							"text"
-						])])]),
-						default: (0, vue.withCtx)(() => [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+						])], void 0, 0) : (0, vue.createCommentVNode)("v-if", true)]),
+						default: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 							key: 0,
 							placement: tooltip.value.placement
 						}, {
@@ -3954,7 +4004,7 @@
 							"model",
 							"last-values",
 							"is-compare"
-						]))]),
+						]))], 64)) : (0, vue.createCommentVNode)("v-if", true)]),
 						_: 3
 					}, 16, ["class"])) : ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 1 }, [
 						(0, vue.createCommentVNode)(" 普通字段：渲染前后两份独立的组件用于对比 "),
@@ -3963,7 +4013,7 @@
 							"tmagic-form-hidden": `${itemLabelWidth.value}` === "0" || !text.value,
 							"show-before-diff": true
 						} }), {
-							label: (0, vue.withCtx)(() => [(0, vue.renderSlot)(_ctx.$slots, "label", {
+							label: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? (0, vue.renderSlot)(_ctx.$slots, "label", {
 								config: __props.config,
 								type: type.value,
 								text: text.value,
@@ -3981,8 +4031,8 @@
 								"use-label",
 								"label-title",
 								"text"
-							])])]),
-							default: (0, vue.withCtx)(() => [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+							])], void 0, 0) : (0, vue.createCommentVNode)("v-if", true)]),
+							default: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 								key: 0,
 								placement: tooltip.value.placement
 							}, {
@@ -3995,10 +4045,10 @@
 							}, 8, ["placement"])) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)(tagName.value), (0, vue.mergeProps)({ key: 1 }, fieldsProps.value, {
 								model: __props.lastValues,
 								onChange: onChangeHandler
-							}), null, 16, ["model"]))]),
+							}), null, 16, ["model"]))], 64)) : (0, vue.createCommentVNode)("v-if", true)]),
 							_: 3
 						}, 16, ["class"]),
-						__props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+						shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 							key: 0,
 							placement: "top"
 						}, {
@@ -4020,7 +4070,7 @@
 								"show-after-diff": true
 							}
 						}), {
-							label: (0, vue.withCtx)(() => [(0, vue.renderSlot)(_ctx.$slots, "label", {
+							label: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? (0, vue.renderSlot)(_ctx.$slots, "label", {
 								config: __props.config,
 								type: type.value,
 								text: text.value,
@@ -4038,8 +4088,8 @@
 								"use-label",
 								"label-title",
 								"text"
-							])])]),
-							default: (0, vue.withCtx)(() => [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+							])], void 0, 0) : (0, vue.createCommentVNode)("v-if", true)]),
+							default: (0, vue.withCtx)(() => [shouldRenderLeafField.value ? ((0, vue.openBlock)(), (0, vue.createElementBlock)(vue.Fragment, { key: 0 }, [tooltip.value.text ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 								key: 0,
 								placement: tooltip.value.placement
 							}, {
@@ -4052,10 +4102,10 @@
 							}, 8, ["placement"])) : ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.resolveDynamicComponent)(tagName.value), (0, vue.mergeProps)({ key: 1 }, fieldsProps.value, {
 								model: __props.model,
 								onChange: onChangeHandler
-							}), null, 16, ["model"]))]),
+							}), null, 16, ["model"]))], 64)) : (0, vue.createCommentVNode)("v-if", true)]),
 							_: 3
 						}, 16, ["style", "class"]),
-						__props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
+						shouldRenderLeafField.value && __props.config.tip && type.value === "checkbox" && !__props.config.useLabel ? ((0, vue.openBlock)(), (0, vue.createBlock)((0, vue.unref)(_tmagic_design.TMagicTooltip), {
 							key: 1,
 							placement: "top"
 						}, {
@@ -9410,6 +9460,7 @@
 	exports.MTimerange = Timerange_default;
 	exports.adaptFormValidator = adaptFormValidator;
 	exports.applyExtendState = applyExtendState;
+	exports.clearSilentLeafFieldTypes = clearSilentLeafFieldTypes;
 	exports.clearTypeMatchRules = clearTypeMatchRules;
 	exports.createForm = createForm;
 	exports.createObjectProp = createObjectProp;
@@ -9423,10 +9474,12 @@
 	exports.getDataByPage = getDataByPage;
 	exports.getFormField = getField;
 	exports.getRules = getRules;
+	exports.getSilentLeafFieldTypes = getSilentLeafFieldTypes;
 	exports.getTypeMatchRule = getTypeMatchRule;
 	exports.initValue = initValue;
 	exports.optionSuggestion = optionSuggestion;
 	exports.registerFormField = registerField;
+	exports.registerSilentLeafFieldTypes = registerSilentLeafFieldTypes;
 	exports.registerTypeMatchRule = registerTypeMatchRule;
 	exports.registerTypeMatchRules = registerTypeMatchRules;
 	exports.sortArray = sortArray;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.0-beta.23",
+  "version": "1.8.0-beta.24",
   "name": "@tmagic/form",
   "type": "module",
   "sideEffects": [
@@ -51,10 +51,10 @@
   },
   "peerDependencies": {
     "typescript": "^6.0.3",
-    "vue": "^3.5.40",
-    "@tmagic/design": "1.8.0-beta.23",
-    "@tmagic/form-schema": "1.8.0-beta.23",
-    "@tmagic/utils": "1.8.0-beta.23"
+    "vue": "^3.5.41",
+    "@tmagic/design": "1.8.0-beta.24",
+    "@tmagic/utils": "1.8.0-beta.24",
+    "@tmagic/form-schema": "1.8.0-beta.24"
   },
   "peerDependenciesMeta": {
     "typescript": {

package/src/containers/Container.vue

@@ -27,7 +27,15 @@
     <template v-else-if="type && display && !showDiff">
       <TMagicFormItem v-bind="formItemProps" :class="{ 'tmagic-form-hidden': `${itemLabelWidth}` === '0' || !text }">
         <template #label>
-          <slot name="label" :config="config" :type="type" :text="text" :prop="itemProp" :disabled="disabled">
+          <slot
+            v-if="shouldRenderLeafField"
+            name="label"
+            :config="config"
+            :type="type"
+            :text="text"
+            :prop="itemProp"
+            :disabled="disabled"
+          >
             <FormLabel
               :tip="config.tip"
               :type="type"
@@ -41,8 +49,25 @@
           </slot>
         </template>
 
-        <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+        <!-- 静默校验时只保留 FormItem：校验依赖其 prop / rules 与 model 值，与字段组件实例无关 -->
+        <template v-if="shouldRenderLeafField">
+          <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+            <component
+              v-bind="fieldsProps"
+              :is="tagName"
+              :model="model"
+              :last-values="lastValues"
+              :is-compare="isCompare"
+              @change="onChangeHandler"
+              @addDiffCount="onAddDiffCount"
+            ></component>
+            <template #content>
+              <div v-html="tooltip.text"></div>
+            </template>
+          </TMagicTooltip>
+
           <component
+            v-else
             v-bind="fieldsProps"
             :is="tagName"
             :model="model"
@@ -51,24 +76,13 @@
             @change="onChangeHandler"
             @addDiffCount="onAddDiffCount"
           ></component>
-          <template #content>
-            <div v-html="tooltip.text"></div>
-          </template>
-        </TMagicTooltip>
-
-        <component
-          v-else
-          v-bind="fieldsProps"
-          :is="tagName"
-          :model="model"
-          :last-values="lastValues"
-          :is-compare="isCompare"
-          @change="onChangeHandler"
-          @addDiffCount="onAddDiffCount"
-        ></component>
+        </template>
       </TMagicFormItem>
 
-      <TMagicTooltip v-if="config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel" placement="top">
+      <TMagicTooltip
+        v-if="shouldRenderLeafField && config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel"
+        placement="top"
+      >
         <TMagicIcon style="line-height: 40px; margin-left: 5px"><warning-filled /></TMagicIcon>
         <template #content>
           <div v-html="config.tip"></div>
@@ -88,7 +102,15 @@
         }"
       >
         <template #label>
-          <slot name="label" :config="config" :type="type" :text="text" :prop="itemProp" :disabled="disabled">
+          <slot
+            v-if="shouldRenderLeafField"
+            name="label"
+            :config="config"
+            :type="type"
+            :text="text"
+            :prop="itemProp"
+            :disabled="disabled"
+          >
             <FormLabel
               :tip="config.tip"
               :type="type"
@@ -98,8 +120,23 @@
             ></FormLabel>
           </slot>
         </template>
-        <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+        <template v-if="shouldRenderLeafField">
+          <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+            <component
+              v-bind="fieldsProps"
+              :is="tagName"
+              :model="model"
+              :last-values="lastValues"
+              :is-compare="isCompare"
+              @change="onChangeHandler"
+            ></component>
+            <template #content>
+              <div v-html="tooltip.text"></div>
+            </template>
+          </TMagicTooltip>
+
           <component
+            v-else
             v-bind="fieldsProps"
             :is="tagName"
             :model="model"
@@ -107,20 +144,7 @@
             :is-compare="isCompare"
             @change="onChangeHandler"
           ></component>
-          <template #content>
-            <div v-html="tooltip.text"></div>
-          </template>
-        </TMagicTooltip>
-
-        <component
-          v-else
-          v-bind="fieldsProps"
-          :is="tagName"
-          :model="model"
-          :last-values="lastValues"
-          :is-compare="isCompare"
-          @change="onChangeHandler"
-        ></component>
+        </template>
       </TMagicFormItem>
 
       <!-- 普通字段：渲染前后两份独立的组件用于对比 -->
@@ -131,7 +155,15 @@
           :class="{ 'tmagic-form-hidden': `${itemLabelWidth}` === '0' || !text, 'show-before-diff': true }"
         >
           <template #label>
-            <slot name="label" :config="config" :type="type" :text="text" :prop="itemProp" :disabled="disabled">
+            <slot
+              v-if="shouldRenderLeafField"
+              name="label"
+              :config="config"
+              :type="type"
+              :text="text"
+              :prop="itemProp"
+              :disabled="disabled"
+            >
               <FormLabel
                 :tip="config.tip"
                 :type="type"
@@ -141,23 +173,28 @@
               ></FormLabel>
             </slot>
           </template>
-          <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
-            <component v-bind="fieldsProps" :is="tagName" :model="lastValues" @change="onChangeHandler"></component>
-            <template #content>
-              <div v-html="tooltip.text"></div>
-            </template>
-          </TMagicTooltip>
-
-          <component
-            v-else
-            v-bind="fieldsProps"
-            :is="tagName"
-            :model="lastValues"
-            @change="onChangeHandler"
-          ></component>
+          <template v-if="shouldRenderLeafField">
+            <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+              <component v-bind="fieldsProps" :is="tagName" :model="lastValues" @change="onChangeHandler"></component>
+              <template #content>
+                <div v-html="tooltip.text"></div>
+              </template>
+            </TMagicTooltip>
+
+            <component
+              v-else
+              v-bind="fieldsProps"
+              :is="tagName"
+              :model="lastValues"
+              @change="onChangeHandler"
+            ></component>
+          </template>
         </TMagicFormItem>
 
-        <TMagicTooltip v-if="config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel" placement="top">
+        <TMagicTooltip
+          v-if="shouldRenderLeafField && config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel"
+          placement="top"
+        >
           <TMagicIcon style="line-height: 40px; margin-left: 5px"><warning-filled /></TMagicIcon>
           <template #content>
             <div v-html="config.tip"></div>
@@ -171,7 +208,15 @@
           :class="{ 'tmagic-form-hidden': `${itemLabelWidth}` === '0' || !text, 'show-after-diff': true }"
         >
           <template #label>
-            <slot name="label" :config="config" :type="type" :text="text" :prop="itemProp" :disabled="disabled">
+            <slot
+              v-if="shouldRenderLeafField"
+              name="label"
+              :config="config"
+              :type="type"
+              :text="text"
+              :prop="itemProp"
+              :disabled="disabled"
+            >
               <FormLabel
                 :tip="config.tip"
                 :type="type"
@@ -181,17 +226,22 @@
               ></FormLabel>
             </slot>
           </template>
-          <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
-            <component v-bind="fieldsProps" :is="tagName" :model="model" @change="onChangeHandler"></component>
-            <template #content>
-              <div v-html="tooltip.text"></div>
-            </template>
-          </TMagicTooltip>
-
-          <component v-else v-bind="fieldsProps" :is="tagName" :model="model" @change="onChangeHandler"></component>
+          <template v-if="shouldRenderLeafField">
+            <TMagicTooltip v-if="tooltip.text" :placement="tooltip.placement">
+              <component v-bind="fieldsProps" :is="tagName" :model="model" @change="onChangeHandler"></component>
+              <template #content>
+                <div v-html="tooltip.text"></div>
+              </template>
+            </TMagicTooltip>
+
+            <component v-else v-bind="fieldsProps" :is="tagName" :model="model" @change="onChangeHandler"></component>
+          </template>
         </TMagicFormItem>
 
-        <TMagicTooltip v-if="config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel" placement="top">
+        <TMagicTooltip
+          v-if="shouldRenderLeafField && config.tip && type === 'checkbox' && !(config as CheckboxConfig).useLabel"
+          placement="top"
+        >
           <TMagicIcon style="line-height: 40px; margin-left: 5px"><warning-filled /></TMagicIcon>
           <template #content>
             <div v-html="config.tip"></div>
@@ -260,9 +310,10 @@ import type {
   FormValue,
   ToolTipConfigType,
 } from '../schema';
-import { FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } from '../schema';
+import { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY } from '../schema';
 import { getField } from '../utils/config';
 import { createObjectProp, display as displayFunction, filterFunction, getRules } from '../utils/form';
+import { getSilentLeafFieldTypes } from '../utils/silentLeafFieldTypes';
 
 import FormLabel from './FormLabel.vue';
 
@@ -407,6 +458,11 @@ const effectiveSelfDiffFieldTypes = computed<Set<string>>(() => {
 
 const isSelfDiffField = computed(() => effectiveSelfDiffFieldTypes.value.has(type.value));
 
+// 静默模式下仅白名单叶子字段跳过渲染；扩展字段通过 registerSilentLeafFieldTypes 注册
+const silentMode = inject(FORM_SILENT_MODE_KEY, false);
+
+const shouldRenderLeafField = computed(() => !silentMode || !getSilentLeafFieldTypes().has(type.value));
+
 const disabled = computed(() => props.disabled || filterFunction(mForm, props.config.disabled, props));
 
 const text = computed(() => filterFunction(mForm, props.config.text, props));

package/src/index.ts

@@ -63,6 +63,12 @@ export {
   registerField as registerFormField,
 } from './utils/config';
 
+export {
+  clearSilentLeafFieldTypes,
+  getSilentLeafFieldTypes,
+  registerSilentLeafFieldTypes,
+} from './utils/silentLeafFieldTypes';
+
 export {
   clearTypeMatchRules,
   deleteTypeMatchRule,

package/src/schema.ts

@@ -32,11 +32,12 @@ export const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>> = Sym
 /**
  * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
  *
- * 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
- * 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+ * Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
+ * 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
+ * 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
  *
  * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
- * 字段组件可以安全跳过，接入前需逐一审计。
+ * 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
  */
 export const FORM_SILENT_MODE_KEY: InjectionKey<boolean> = Symbol('mFormSilentMode');
 

package/src/utils/silentLeafFieldTypes.ts

@@ -0,0 +1,71 @@
+/*
+ * Tencent is pleased to support the open source community by making TMagicEditor available.
+ *
+ * Copyright (C) 2025 Tencent.  All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { toLine } from '@tmagic/utils';
+
+/**
+ * 可在静默校验模式下跳过渲染的内置叶子字段（默认集合）。
+ *
+ * 这些字段只渲染一个输入控件，内部没有嵌套 FormItem，且不会依赖组件挂载修改 model；
+ * 字段值由初始化逻辑处理（包括 defaultValue），因此跳过不影响校验结果。
+ *
+ * 业务侧可通过 `registerSilentLeafFieldTypes` 追加已审计的安全自定义字段。
+ */
+export const LEAF_FIELD_TYPES: ReadonlySet<string> = new Set([
+  'text',
+  'textarea',
+  'number',
+  'time',
+  'daterange',
+  'timerange',
+  'checkbox',
+  'radio-group',
+  'switch',
+  'select',
+  'cascader',
+  'color-picker',
+  'link',
+]);
+
+/** 业务侧追加的静默叶子字段（不含内置默认集合） */
+const extraSilentLeafFieldTypes = new Set<string>();
+
+/**
+ * 注册可在静默校验中跳过渲染的叶子字段 type（追加到默认 `LEAF_FIELD_TYPES` 之上）。
+ *
+ * 仅应纳入「无嵌套 FormItem、无挂载值副作用」的字段；复合 / 动态子表单不可加入。
+ */
+export const registerSilentLeafFieldTypes = (types: Iterable<string>): void => {
+  for (const type of types) {
+    if (typeof type !== 'string' || !type) continue;
+    extraSilentLeafFieldTypes.add(toLine(type));
+  }
+};
+
+/** 当前生效的静默叶子字段集合：内置默认 ∪ 已注册扩展 */
+export const getSilentLeafFieldTypes = (): ReadonlySet<string> => {
+  if (extraSilentLeafFieldTypes.size === 0) {
+    return LEAF_FIELD_TYPES;
+  }
+  return new Set([...LEAF_FIELD_TYPES, ...extraSilentLeafFieldTypes]);
+};
+
+/** 清空业务侧追加的静默叶子字段（不影响内置默认集合；主要用于单测） */
+export const clearSilentLeafFieldTypes = (): void => {
+  extraSilentLeafFieldTypes.clear();
+};

package/types/index.d.ts

@@ -35,11 +35,12 @@ declare const FORM_TYPE_MATCH_VALID_KEY: InjectionKey<ComputedRef<boolean>>;
 /**
  * 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
  *
- * 重型字段组件（如 vs-code）可 inject 该标记并跳过自身渲染：字段校验由 FormItem 基于 model 值完成，
- * 与叶子 UI 组件实例无关，跳过可省去无谓的实例化开销（如 monaco worker / model 的创建）。
+ * Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
+ * 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
+ * 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
  *
  * 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
- * 字段组件可以安全跳过，接入前需逐一审计。
+ * 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
  */
 declare const FORM_SILENT_MODE_KEY: InjectionKey<boolean>;
 interface ValidateError {
@@ -2256,6 +2257,18 @@ declare const registerField: (tagName: string, component: Component) => void;
 declare const getField: (tagName: string) => Component | undefined;
 declare const deleteField: (tagName: string) => boolean;
 //#endregion
+//#region temp/packages/form/src/utils/silentLeafFieldTypes.d.ts
+/**
+ * 注册可在静默校验中跳过渲染的叶子字段 type（追加到默认 `LEAF_FIELD_TYPES` 之上）。
+ *
+ * 仅应纳入「无嵌套 FormItem、无挂载值副作用」的字段；复合 / 动态子表单不可加入。
+ */
+declare const registerSilentLeafFieldTypes: (types: Iterable<string>) => void;
+/** 当前生效的静默叶子字段集合：内置默认 ∪ 已注册扩展 */
+declare const getSilentLeafFieldTypes: () => ReadonlySet<string>;
+/** 清空业务侧追加的静默叶子字段（不影响内置默认集合；主要用于单测） */
+declare const clearSilentLeafFieldTypes: () => void;
+//#endregion
 //#region temp/packages/form/src/utils/typeMatch.d.ts
 interface TypeMatchValidateContext {
   fieldType: string;
@@ -2308,8 +2321,8 @@ declare const _default$31: {
   install(app: App, opt?: FormInstallOptions): void;
 };
 declare namespace index_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, MAX_SUGGESTION_OPTIONS, _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, optionSuggestion, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, 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, MAX_SUGGESTION_OPTIONS, _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, clearSilentLeafFieldTypes, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getSilentLeafFieldTypes, getTypeMatchRule, initValue, optionSuggestion, registerField as registerFormField, registerSilentLeafFieldTypes, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, 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_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, MAX_SUGGESTION_OPTIONS, _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, optionSuggestion, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, 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, MAX_SUGGESTION_OPTIONS, _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, clearSilentLeafFieldTypes, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getSilentLeafFieldTypes, getTypeMatchRule, initValue, optionSuggestion, registerField as registerFormField, registerSilentLeafFieldTypes, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };