@tmagic/form 1.8.0-beta.25 → 1.8.0-beta.26

package/dist/es/fields/{DynamicField.vue_vue_type_script_setup_true_lang.js → DynamicField/Index.vue_vue_type_script_setup_true_lang.js}

@@ -1,12 +1,13 @@
-import { useAddField } from "../utils/useAddField.js";
-import { getConfig } from "../utils/config.js";
+import { getConfig } from "../../utils/config.js";
+import { useAddField } from "../../utils/useAddField.js";
+import { eachDynamicField } from "./effect.js";
 import { Fragment, createBlock, createElementBlock, createVNode, defineComponent, onBeforeUnmount, openBlock, reactive, renderList, unref, watch, withCtx } from "vue";
 import { TMagicForm, TMagicFormItem, TMagicInput } from "@tmagic/design";
-//#region packages/form/src/fields/DynamicField.vue?vue&type=script&setup=true&lang.ts
+//#region packages/form/src/fields/DynamicField/Index.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { class: "m-fields-dynamic-field" };
-var DynamicField_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+var Index_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	name: "MFormDynamicField",
-	__name: "DynamicField",
+	__name: "Index",
 	props: {
 		config: {},
 		model: {},
@@ -44,15 +45,10 @@ var DynamicField_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 			const fields = await props.config.returnFields(props.config, props.model, request);
 			fieldMap.value = {};
 			fieldLabelMap.value = {};
-			fields.forEach((v) => {
-				if (typeof v !== "object" || v.name === void 0) return;
-				let oldVal = props.model?.[v.name] || "";
-				if (!oldVal && v.defaultValue !== void 0) {
-					oldVal = v.defaultValue;
-					emit("change", oldVal, { modifyKey: v.name });
-				}
-				fieldMap.value[v.name] = oldVal;
-				fieldLabelMap.value[v.name] = v.label || "";
+			eachDynamicField(fields, props.model, (field, value, isDefaultApplied) => {
+				if (isDefaultApplied) emit("change", value, { modifyKey: field.name });
+				fieldMap.value[field.name] = value;
+				fieldLabelMap.value[field.name] = field.label || "";
 			});
 		};
 		const unwatch = watch(() => props.model?.[props.config.dynamicKey], (val) => {
@@ -91,4 +87,4 @@ var DynamicField_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ def
 	}
 });
 //#endregion
-export { DynamicField_vue_vue_type_script_setup_true_lang_default as default };
+export { Index_vue_vue_type_script_setup_true_lang_default as default };

package/dist/es/fields/DynamicField/effect.js

@@ -0,0 +1,40 @@
+import { getConfig } from "../../utils/config.js";
+import { setValueByKeyPath } from "@tmagic/utils";
+//#region packages/form/src/fields/DynamicField/effect.ts
+/**
+* 遍历动态字段列表，按「原值为空且声明了 defaultValue 则取默认值」求出每个字段当前的值。
+*
+* `isDefaultApplied` 为真表示该值来自 `defaultValue`，需要写回表单值
+* （组件通过 emit change 写回，初始化写入直接写 `values`）。
+*/
+var eachDynamicField = (fields, model, onField) => {
+	for (const field of fields) {
+		if (typeof field !== "object" || field?.name === void 0) continue;
+		let value = model?.[field.name] || "";
+		let isDefaultApplied = false;
+		if (!value && field.defaultValue !== void 0) {
+			value = field.defaultValue;
+			isDefaultApplied = true;
+		}
+		onField(field, value, isDefaultApplied);
+	}
+};
+/**
+* 同步 `returnFields` 的 defaultValue 按 prop 写入值根对象。
+*
+* 该组件读取的是同级 model，但写入走 Container 的 modifyKey 分支，落在 `${prop}.${key}`，
+* 这里保持与渲染一致（含这层不对称），避免两条链路产出不同的值。
+* 异步 returnFields 由组件挂载后的 watch 负责，此处不等待。
+*/
+var effect = ({ config, model, prop, values }) => {
+	const { returnFields, dynamicKey } = config;
+	if (typeof returnFields !== "function" || !model) return;
+	if (model[dynamicKey] === "") return;
+	const result = returnFields(config, model, getConfig("request"));
+	if (!result || typeof result.then === "function" || !Array.isArray(result)) return;
+	eachDynamicField(result, model, (field, value, isDefaultApplied) => {
+		if (isDefaultApplied) setValueByKeyPath(`${prop}.${field.name}`, value, values || model);
+	});
+};
+//#endregion
+export { eachDynamicField, effect };

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

@@ -1,5 +1,5 @@
-import { useAddField } from "../utils/useAddField.js";
 import { isGlobalFlat } from "../utils/config.js";
+import { useAddField } from "../utils/useAddField.js";
 import FormDialog_default from "../FormDialog.js";
 import { computed, createElementBlock, createTextVNode, createVNode, defineComponent, inject, normalizeStyle, openBlock, readonly, ref, toDisplayString, unref, withCtx } from "vue";
 import { TMagicButton, TMagicIcon } from "@tmagic/design";

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

@@ -1,5 +1,5 @@
-import { useAddField } from "../utils/useAddField.js";
 import { isGlobalFlat } from "../utils/config.js";
+import { useAddField } from "../utils/useAddField.js";
 import { createBlock, createCommentVNode, defineComponent, inject, openBlock, ref, unref, watch } from "vue";
 import { TMagicInputNumber } from "@tmagic/design";
 //#region packages/form/src/fields/Number.vue?vue&type=script&setup=true&lang.ts

package/dist/es/fields/NumberRange/Index.js

@@ -0,0 +1,5 @@
+import Index_vue_vue_type_script_setup_true_lang_default from "./Index.vue_vue_type_script_setup_true_lang.js";
+//#region packages/form/src/fields/NumberRange/Index.vue
+var Index_default = Index_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { Index_default as default };

package/dist/es/fields/{NumberRange.vue_vue_type_script_setup_true_lang.js → NumberRange/Index.vue_vue_type_script_setup_true_lang.js}

@@ -1,11 +1,11 @@
-import { useAddField } from "../utils/useAddField.js";
+import { useAddField } from "../../utils/useAddField.js";
 import { createElementBlock, createElementVNode, createVNode, defineComponent, openBlock, ref, unref, watch } from "vue";
 import { TMagicInput } from "@tmagic/design";
-//#region packages/form/src/fields/NumberRange.vue?vue&type=script&setup=true&lang.ts
+//#region packages/form/src/fields/NumberRange/Index.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { class: "m-fields-number-range" };
-var NumberRange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+var Index_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
 	name: "MFormNumberRange",
-	__name: "NumberRange",
+	__name: "Index",
 	props: {
 		config: {},
 		model: {},
@@ -35,7 +35,6 @@ var NumberRange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 			deep: true
 		});
 		useAddField(props.prop);
-		if (!Array.isArray(props.model[props.name])) props.model[props.name] = [];
 		const minChangeHandler = (v) => {
 			emit("change", [Number(v), props.model[props.name][1]]);
 		};
@@ -76,4 +75,4 @@ var NumberRange_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defi
 	}
 });
 //#endregion
-export { NumberRange_vue_vue_type_script_setup_true_lang_default as default };
+export { Index_vue_vue_type_script_setup_true_lang_default as default };

package/dist/es/fields/NumberRange/effect.js

@@ -0,0 +1,8 @@
+//#region packages/form/src/fields/NumberRange/effect.ts
+/** 值不是数组时修正为空数组。 */
+var effect = ({ config, model }) => {
+	const { name } = config;
+	if (model && !Array.isArray(model[name])) model[name] = [];
+};
+//#endregion
+export { effect };

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

@@ -1,8 +1,8 @@
-import { useAddField } from "../utils/useAddField.js";
 import { getConfig } from "../utils/config.js";
+import { useAddField } from "../utils/useAddField.js";
 import { Fragment, createBlock, createCommentVNode, createElementBlock, defineComponent, inject, mergeProps, nextTick, openBlock, ref, renderList, resolveDirective, resolveDynamicComponent, unref, watch, watchEffect, withCtx, withDirectives } from "vue";
-import { TMagicSelect, getDesignConfig } from "@tmagic/design";
 import { getValueByKeyPath } from "@tmagic/utils";
+import { TMagicSelect, getDesignConfig } from "@tmagic/design";
 //#region packages/form/src/fields/Select.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { key: 2 };
 var Select_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({

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

@@ -1,8 +1,8 @@
 import { useAddField } from "../utils/useAddField.js";
 import { Fragment, Teleport, computed, createBlock, createCommentVNode, createElementBlock, createElementVNode, createSlots, createTextVNode, createVNode, defineComponent, inject, normalizeClass, openBlock, readonly, ref, shallowRef, toDisplayString, unref, watch, withCtx, withModifiers } from "vue";
 import { debounce } from "lodash-es";
-import { TMagicButton, TMagicInput } from "@tmagic/design";
 import { isNumber } from "@tmagic/utils";
+import { TMagicButton, TMagicInput } from "@tmagic/design";
 import { createPopper } from "@popperjs/core";
 //#region packages/form/src/fields/Text.vue?vue&type=script&setup=true&lang.ts
 var _hoisted_1 = { key: 0 };

package/dist/es/headless.js

@@ -0,0 +1,13 @@
+import { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } from "./schema.js";
+import { isLeafFieldType } from "./utils/fieldValueEffects.js";
+import { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, stringifyExampleValue, validateTypeMatch } from "./utils/typeMatch.js";
+import { createFormStateProxy, mergeFormContexts } from "./utils/formStateProxy.js";
+import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, resolveItemType, sortArray, sortChange } from "./utils/form.js";
+import { FieldInnerConfigError, applyMountValueEffects, collectValidatableFields, isFieldInnerConfigError } from "./utils/collectFields.js";
+import { formatValidateError, getTextByName } from "./utils/validateError.js";
+import { createHeadlessFormState, validateValues } from "./utils/validateValues.js";
+import { submitForm, validateForm } from "./utils/submitHeadless.js";
+import { clearFields, getField, mergeFieldOptions, registerBuiltInFields, registerField, registerFields, unregisterField } from "./utils/registerField.js";
+import { builtInFields } from "./utils/builtInFields.js";
+export * from "@tmagic/form-schema";
+export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, adaptFormValidator, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, submitForm, unregisterField, validateForm, validateTypeMatch, validateValues };

package/dist/es/index.js

@@ -1,10 +1,14 @@
-import { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY } from "./schema.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 { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY } from "./schema.js";
+import { isLeafFieldType } from "./utils/fieldValueEffects.js";
+import { MAX_SUGGESTION_OPTIONS, clearTypeMatchRules, deleteTypeMatchRule, getTypeMatchRule, optionSuggestion, stringifyExampleValue, validateTypeMatch } from "./utils/typeMatch.js";
+import { createFormStateProxy, mergeFormContexts } from "./utils/formStateProxy.js";
+import { adaptFormValidator, appendProp, createFormStateBase, createObjectProp, createValues, datetimeFormatter, display, filterFunction, getDataByPage, getItemProp, getNativeRules, getRules, initValue, isValidName, resolveItemType, sortArray, sortChange } from "./utils/form.js";
+import { FieldInnerConfigError, applyMountValueEffects, collectValidatableFields, isFieldInnerConfigError } from "./utils/collectFields.js";
+import { formatValidateError, getTextByName } from "./utils/validateError.js";
+import { createHeadlessFormState, validateValues } from "./utils/validateValues.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 { clearFields, getField, mergeFieldOptions, registerBuiltInFields, registerField, registerFields, unregisterField } from "./utils/registerField.js";
 import Container_default from "./containers/Container.js";
 import Form_default from "./Form.js";
 import { stripTabItemsLazy, submitForm, validateForm } from "./submitForm.js";
@@ -19,26 +23,27 @@ import Tabs_default from "./containers/Tabs.js";
 import TableGroupList_default from "./containers/table-group-list/TableGroupList.js";
 import Text_default from "./fields/Text.js";
 import Number_default from "./fields/Number.js";
-import NumberRange_default from "./fields/NumberRange.js";
+import Index_default$5 from "./fields/NumberRange/Index.js";
 import Textarea_default from "./fields/Textarea.js";
-import Date_default from "./fields/Date.js";
-import DateTime_default from "./fields/DateTime.js";
+import Index_default$1 from "./fields/Date/Index.js";
+import Index_default$2 from "./fields/DateTime/Index.js";
 import Time_default from "./fields/Time.js";
 import Checkbox_default from "./fields/Checkbox.js";
 import Switch_default from "./fields/Switch.js";
 import Daterange_default from "./fields/Daterange.js";
 import Timerange_default from "./fields/Timerange.js";
 import ColorPicker_default from "./fields/ColorPicker.js";
-import CheckboxGroup_default from "./fields/CheckboxGroup.js";
+import Index_default from "./fields/CheckboxGroup/Index.js";
 import RadioGroup_default from "./fields/RadioGroup.js";
-import Display_default from "./fields/Display.js";
+import Index_default$3 from "./fields/Display/Index.js";
 import Link_default from "./fields/Link.js";
 import Select_default from "./fields/Select.js";
 import Cascader_default from "./fields/Cascader.js";
-import DynamicField_default from "./fields/DynamicField.js";
+import Index_default$4 from "./fields/DynamicField/Index.js";
+import { builtInFields } from "./utils/builtInFields.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, 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 };
+export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FieldInnerConfigError, MAX_SUGGESTION_OPTIONS, Cascader_default as MCascader, Checkbox_default as MCheckbox, Index_default as MCheckboxGroup, ColorPicker_default as MColorPicker, Container_default as MContainer, Index_default$1 as MDate, Index_default$2 as MDateTime, Daterange_default as MDaterange, Index_default$3 as MDisplay, Index_default$4 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, Index_default$5 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, appendProp, applyMountValueEffects, builtInFields, clearFields, clearTypeMatchRules, collectValidatableFields, createForm, createFormStateBase, createFormStateProxy, createHeadlessFormState, createObjectProp, createValues, datetimeFormatter, plugin_default as default, deleteTypeMatchRule, display, filterFunction, formatValidateError, getDataByPage, getField as getFormField, getItemProp, getNativeRules, getRules, getTextByName, getTypeMatchRule, initValue, isFieldInnerConfigError, isLeafFieldType, isValidName, mergeFieldOptions, mergeFormContexts, optionSuggestion, registerBuiltInFields, registerField, registerFields, resolveItemType, sortArray, sortChange, stringifyExampleValue, stripTabItemsLazy, submitForm, unregisterField, useAddField, validateForm, validateTypeMatch, validateValues };

package/dist/es/plugin.js

@@ -1,6 +1,6 @@
-import { registerTypeMatchRules } from "./utils/typeMatch.js";
-import Hidden_default from "./fields/Hidden.js";
 import { setConfig } from "./utils/config.js";
+import Hidden_default from "./fields/Hidden.js";
+import { registerBuiltInFields, registerFields } from "./utils/registerField.js";
 import Container_default from "./containers/Container.js";
 import Form_default from "./Form.js";
 import FormDialog_default from "./FormDialog.js";
@@ -13,65 +13,81 @@ import Tabs_default from "./containers/Tabs.js";
 import TableGroupList_default from "./containers/table-group-list/TableGroupList.js";
 import Text_default from "./fields/Text.js";
 import Number_default from "./fields/Number.js";
-import NumberRange_default from "./fields/NumberRange.js";
+import Index_default from "./fields/NumberRange/Index.js";
 import Textarea_default from "./fields/Textarea.js";
-import Date_default from "./fields/Date.js";
-import DateTime_default from "./fields/DateTime.js";
+import Index_default$1 from "./fields/Date/Index.js";
+import Index_default$2 from "./fields/DateTime/Index.js";
 import Time_default from "./fields/Time.js";
 import Checkbox_default from "./fields/Checkbox.js";
 import Switch_default from "./fields/Switch.js";
 import Daterange_default from "./fields/Daterange.js";
 import Timerange_default from "./fields/Timerange.js";
 import ColorPicker_default from "./fields/ColorPicker.js";
-import CheckboxGroup_default from "./fields/CheckboxGroup.js";
+import Index_default$3 from "./fields/CheckboxGroup/Index.js";
 import RadioGroup_default from "./fields/RadioGroup.js";
-import Display_default from "./fields/Display.js";
+import Index_default$4 from "./fields/Display/Index.js";
 import Link_default from "./fields/Link.js";
 import Select_default from "./fields/Select.js";
 import Cascader_default from "./fields/Cascader.js";
-import DynamicField_default from "./fields/DynamicField.js";
+import Index_default$5 from "./fields/DynamicField/Index.js";
+import { builtInFields } from "./utils/builtInFields.js";
 import Step_default from "./containers/Step.js";
 /* empty css            */
 //#region packages/form/src/plugin.ts
+var builtInFieldVue = {
+	text: { component: Text_default },
+	"img-upload": { component: Text_default },
+	number: { component: Number_default },
+	"number-range": { component: Index_default },
+	textarea: { component: Textarea_default },
+	hidden: { component: Hidden_default },
+	date: { component: Index_default$1 },
+	datetime: { component: Index_default$2 },
+	daterange: { component: Daterange_default },
+	timerange: { component: Timerange_default },
+	time: { component: Time_default },
+	checkbox: { component: Checkbox_default },
+	switch: { component: Switch_default },
+	"color-picker": { component: ColorPicker_default },
+	"checkbox-group": { component: Index_default$3 },
+	"radio-group": { component: RadioGroup_default },
+	display: { component: Index_default$4 },
+	link: { component: Link_default },
+	select: { component: Select_default },
+	cascader: { component: Cascader_default },
+	"dynamic-field": { component: Index_default$5 },
+	container: { container: Container_default },
+	tab: { container: Tabs_default },
+	row: { container: Row_default },
+	"flex-layout": { container: FlexLayout_default },
+	fieldset: { container: Fieldset_default },
+	panel: { container: Panel_default },
+	step: { container: Step_default },
+	table: { container: TableGroupList_default },
+	"group-list": { container: TableGroupList_default },
+	"table-group-list": { container: TableGroupList_default }
+};
 var defaultInstallOpt = {};
-var plugin_default = { install(app, opt = {}) {
-	const option = Object.assign(defaultInstallOpt, opt);
+var plugin_default = { 
+/**
+* 安装 `@tmagic/form`：登记内置字段、挂载 `m-form` / `m-form-dialog` / `m-form-drawer`。
+*
+* @param app - Vue 应用
+* @param [opt] - 安装选项
+*/
+install(app, opt = {}) {
+	const option = {
+		...defaultInstallOpt,
+		...opt
+	};
 	app.config.globalProperties.$MAGIC_FORM = option;
 	setConfig(option);
-	if (option.typeMatchRules) registerTypeMatchRules(option.typeMatchRules);
+	registerBuiltInFields(builtInFields);
+	registerBuiltInFields(builtInFieldVue, app);
+	if (option.fields) registerFields(option.fields, app);
 	app.component("m-form", Form_default);
 	app.component("m-form-dialog", FormDialog_default);
 	app.component("m-form-drawer", FormDrawer_default);
-	app.component("m-form-container", Container_default);
-	app.component("m-form-fieldset", Fieldset_default);
-	app.component("m-form-group-list", TableGroupList_default);
-	app.component("m-form-panel", Panel_default);
-	app.component("m-form-row", Row_default);
-	app.component("m-form-step", Step_default);
-	app.component("m-form-table", TableGroupList_default);
-	app.component("m-form-tab", Tabs_default);
-	app.component("m-form-flex-layout", FlexLayout_default);
-	app.component("m-fields-text", Text_default);
-	app.component("m-fields-img-upload", Text_default);
-	app.component("m-fields-number", Number_default);
-	app.component("m-fields-number-range", NumberRange_default);
-	app.component("m-fields-textarea", Textarea_default);
-	app.component("m-fields-hidden", Hidden_default);
-	app.component("m-fields-date", Date_default);
-	app.component("m-fields-datetime", DateTime_default);
-	app.component("m-fields-daterange", Daterange_default);
-	app.component("m-fields-timerange", Timerange_default);
-	app.component("m-fields-time", Time_default);
-	app.component("m-fields-checkbox", Checkbox_default);
-	app.component("m-fields-switch", Switch_default);
-	app.component("m-fields-color-picker", ColorPicker_default);
-	app.component("m-fields-checkbox-group", CheckboxGroup_default);
-	app.component("m-fields-radio-group", RadioGroup_default);
-	app.component("m-fields-display", Display_default);
-	app.component("m-fields-link", Link_default);
-	app.component("m-fields-select", Select_default);
-	app.component("m-fields-cascader", Cascader_default);
-	app.component("m-fields-dynamic-field", DynamicField_default);
 } };
 //#endregion
 export { plugin_default as default };

package/dist/es/schema.js

@@ -3,15 +3,13 @@ export * from "@tmagic/form-schema";
 var FORM_DIFF_CONFIG_KEY = Symbol("mFormDiffConfig");
 var FORM_TYPE_MATCH_VALID_KEY = Symbol("mFormTypeMatchValid");
 /**
-* 静默模式标记，由 `submitForm` / `validateForm` 以隐藏方式挂载临时表单时 provide（debug 弹层模式不提供）。
+* 宿主业务上下文，由 `MForm`（或更外层的 Editor）通过 `provide` 下发。
 *
-* Container 会基于该标记，并对照 `getSilentLeafFieldTypes()`（默认 `LEAF_FIELD_TYPES`）
-* 跳过叶子字段的渲染，只保留 FormItem：字段校验由 FormItem 基于 model 值完成，与叶子 UI 组件实例无关。
-* 重型字段组件（如 vs-code）也可 inject 该标记跳过自身渲染，省去无谓的实例化开销。
+* 嵌套表单（Link 子表单、FormBox、临时校验表单等）会自动继承最近祖先的 context，
+* 无需层层透传。
 *
-* 注意：仅「挂载无值副作用」（不在 onMounted/watch immediate 中 emit change、不依赖 DOM 计算值）的
-* 字段组件可以安全跳过，接入前需逐一审计；业务扩展请使用 `registerSilentLeafFieldTypes`。
+* 配置回调统一通过 `mForm.xxx` 读取，由 formState 的读穿 Proxy 落到这里。
 */
-var FORM_SILENT_MODE_KEY = Symbol("mFormSilentMode");
+var FORM_CONTEXT_KEY = Symbol("mFormContext");
 //#endregion
-export { FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY };
+export { FORM_CONTEXT_KEY, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY };

package/dist/es/style.css

@@ -269,6 +269,21 @@ fieldset.m-fieldset .m-form-tip {
   margin-left: 5px;
 }
 
+.m-fields-group-list {
+  --m-group-list-footer-padding-top: 12px;
+  --m-group-list-footer-padding-bottom: 16px;
+  --m-group-list-footer-button-height: 32px;
+  --m-group-list-footer-height: calc(
+    var(--m-group-list-footer-padding-top) +
+      var(--m-group-list-footer-button-height) +
+      var(--m-group-list-footer-padding-bottom)
+  );
+  --m-group-list-footer-bg: var(--el-bg-color, #fff);
+  --m-group-list-header-height: 65px;
+  --m-group-list-header-bg: #fff;
+  width: 100%;
+  min-width: 0;
+}
 .m-fields-group-list .m-fields-group-list-item.tmagic-design-card--flat:last-child {
   border: 0;
 }
@@ -284,22 +299,87 @@ fieldset.m-fieldset .m-form-tip {
   transform: rotate(90deg);
 }
 .m-fields-group-list .m-fields-group-list-item {
+  overflow: visible;
   border-bottom: 1px solid #ebeef5;
   margin-bottom: 7px;
 }
 .m-fields-group-list .m-fields-group-list-item:last-of-type {
   border-bottom: 0;
 }
+.m-fields-group-list .m-fields-group-list-item .el-card__body,
+.m-fields-group-list .m-fields-group-list-item .t-card__body {
+  overflow: visible;
+}
+.m-fields-group-list .m-fields-group-list-item .el-card__body > .m-container-row,
+.m-fields-group-list .m-fields-group-list-item .t-card__body > .m-container-row {
+  overflow: visible;
+}
+.m-fields-group-list .m-fields-group-list-item .el-card__body .tmagic-design-form-item,
+.m-fields-group-list .m-fields-group-list-item .t-card__body .tmagic-design-form-item {
+  margin-bottom: 16px;
+}
 .m-fields-group-list .m-fields-group-list-item .m-fields-group-list-item-header {
   display: flex;
   align-items: center;
   gap: 8px;
 }
-.m-fields-group-list .m-fields-group-list-footer {
+.m-fields-group-list .m-fields-group-list-item .m-fields-group-list-item-title {
+  flex: 1;
+  min-width: 0;
+}
+.m-fields-group-list .m-fields-group-list-item .m-fields-group-list-item-actions {
+  display: flex;
+  align-items: center;
+  flex-shrink: 0;
+  gap: 8px;
+}
+.m-fields-group-list .m-fields-group-list-item > .el-card__header,
+.m-fields-group-list .m-fields-group-list-item > .t-card__header {
+  position: sticky;
+  top: var(--m-group-list-header-sticky-top, 0px);
+  z-index: 7;
+  background-color: var(--m-group-list-header-bg, #fff);
+}
+.m-fields-group-list .m-fields-group-list-item .m-fields-group-list-item > .el-card__header,
+.m-fields-group-list .m-fields-group-list-item .m-fields-group-list-item > .t-card__header {
+  top: calc(var(--m-group-list-header-sticky-top, 0px) + var(--m-group-list-header-height));
+  z-index: 6;
+}
+.m-fields-group-list .el-table__empty-block {
+  width: 100%;
+  min-height: 0;
+}
+.m-fields-group-list .el-table__empty-text {
+  display: block;
+  box-sizing: border-box;
+  width: 100%;
+}
+.m-fields-group-list > .m-fields-group-list-footer {
+  display: flex;
   justify-content: space-between;
   margin-top: 10px;
   margin-bottom: 16px;
 }
+.m-fields-group-list > .m-fields-group-list-footer.is-sticky-full {
+  position: sticky;
+  bottom: 0;
+  z-index: 7;
+  margin-bottom: 0;
+  padding: var(--m-group-list-footer-padding-top) 0 var(--m-group-list-footer-padding-bottom);
+  background-color: var(--m-group-list-footer-bg);
+}
+.m-fields-group-list > .m-fields-group-list-footer.is-sticky-full > div {
+  justify-content: stretch;
+}
+.m-fields-group-list > .m-fields-group-list-footer.is-sticky-full .el-button,
+.m-fields-group-list > .m-fields-group-list-footer.is-sticky-full .tmagic-design-button {
+  width: 100%;
+  height: var(--m-group-list-footer-button-height);
+}
+.m-fields-group-list .m-fields-group-list-item .m-fields-group-list > .m-fields-group-list-footer.is-sticky-full {
+  bottom: var(--m-group-list-footer-height);
+  z-index: 7;
+}
 
 /** 最外层的groupList需要每个item需要增加空白区域界限时，增加outer-gorup_list可以实现 */
 .m-container-group-list.outer-gorup_list > .m-fields-group-list > .m-fields-group-list-item {