@tmagic/form 1.8.0-beta.22 → 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

@@ -1,10 +1,10 @@
-import "./_virtual/_rolldown/runtime.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 { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, registerTypeMatchRule, registerTypeMatchRules, stringifyExampleValue, 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";
 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";
@@ -38,6 +38,7 @@ import Cascader_default from "./fields/Cascader.js";
 import DynamicField_default from "./fields/DynamicField.js";
 import plugin_default from "./plugin.js";
 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, 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, 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

@@ -1,4 +1,3 @@
-import "./_virtual/_rolldown/runtime.js";
 export * from "@tmagic/form-schema";
 //#region packages/form/src/schema.ts
 var FORM_DIFF_CONFIG_KEY = Symbol("mFormDiffConfig");
@@ -6,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/submitForm.js

@@ -85,13 +85,14 @@ var mountFormInstance = (options) => {
 					return () => h(userWrapper);
 				}
 			}) : userWrapper;
-			const app = createApp(hidden ? defineComponent({
+			const rootComponent = hidden ? defineComponent({
 				name: "MFormSilentProvider",
 				setup() {
 					provide(FORM_SILENT_MODE_KEY, true);
 					return () => h(wrapperComponent);
 				}
-			}) : wrapperComponent);
+			}) : wrapperComponent;
+			const app = createApp(rootComponent);
 			instance.app = app;
 			if (appContext) Object.assign(app._context, appContext);
 			if (!skipTimeout) timer = setTimeout(() => {

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/es/utils/typeMatch.js

@@ -89,17 +89,20 @@ var stringifyExampleValue = (value) => {
 	}
 	return String(value);
 };
+/** 参考建议中可选值全量展示上限；超出时仅举例 EXAMPLE_SUGGESTION_COUNT 个并标明总数。 */
 var MAX_SUGGESTION_OPTIONS = 20;
+var EXAMPLE_SUGGESTION_COUNT = 5;
 /**
-* 生成「请使用以下某一个值：xxx；xxx」形式的参考建议；无可选值时返回空字符串（不追加建议）。
-* 可选值超过 MAX_SUGGESTION_OPTIONS 个时仅展示前若干个并以「等」省略。
+* 生成可选项参考建议；无可选值时返回空字符串（不追加建议）。
+* 未超过 MAX_SUGGESTION_OPTIONS 时全部列举；超过时仅举例前 EXAMPLE_SUGGESTION_COUNT 个并标明总数，避免 AI 误以为仅有举例值合法。
 */
 var optionSuggestion = (optionValues) => {
 	const values = optionValues.filter((item) => typeof item !== "undefined");
 	if (!values.length) return "";
-	const shown = values.slice(0, MAX_SUGGESTION_OPTIONS).map(stringifyExampleValue);
-	const suffix = values.length > MAX_SUGGESTION_OPTIONS ? " 等" : "";
-	return `请使用以下某一个值：${shown.join("；")}${suffix}`;
+	const truncated = values.length > 20;
+	const shown = values.slice(0, truncated ? EXAMPLE_SUGGESTION_COUNT : values.length).map(stringifyExampleValue);
+	if (truncated) return `请从可选项中选用合法值（共 ${values.length} 个，例如：${shown.join("；")}）`;
+	return `请使用以下某一个值：${shown.join("；")}`;
 };
 /**
 * 基于真实 options 生成类型不匹配场景的「参考示例值」。
@@ -484,4 +487,4 @@ var createTypeMatchValidator = (mForm, props, rule) => {
 	};
 };
 //#endregion
-export { clearTypeMatchRules, createTypeMatchValidator, deleteTypeMatchRule, getTypeMatchRule, registerTypeMatchRule, registerTypeMatchRules, validateTypeMatch };
+export { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, createTypeMatchValidator, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, registerTypeMatchRule, registerTypeMatchRules, stringifyExampleValue, validateTypeMatch };