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

package/types/index.d.ts

@@ -272,6 +272,21 @@ declare const sortChange: (data: any[], {
   prop,
   order
 }: schema_d_exports.SortProp) => void;
+/**
+ * 将 extendState 返回的扩展字段合并进 formState。
+ *
+ * - data 描述符（普通字段）通过 `formState[key] = value` 写入，走 reactive proxy 的 set，
+ *   触发依赖通知；
+ * - accessor 描述符（`{ get stage() { return ... } }`）按原样 defineProperty，调用方
+ *   可控制读时求值；强制 `configurable: true` 以便下一次合并可再 define。
+ *
+ * 注意：formState 上由 props 派生的字段（keyProp / popperClass / config / initValues /
+ * isCompare / lastValues / parentValues）是只读 getter（无 setter），extendState 若以
+ * 普通字段形式返回同名 key，直接赋值会让 proxy 的 set trap 失败并抛出
+ * `TypeError: 'set' on proxy: trap returned falsish`，这里统一跳过并告警；
+ * 如确需覆盖，可在 extendState 中以 get 访问器形式返回。
+ */
+declare const applyExtendState: (formState: schema_d_exports.FormState, state: Record<string, any> | null | undefined) => void;
 declare const createObjectProp: (prop: string, key: string, name?: string | number) => string;
 //#endregion
 //#region temp/packages/form/src/utils/useAddField.d.ts
@@ -335,6 +350,15 @@ type __VLS_Props$30 = {
    * 通过 provide 下发，对整棵表单的所有层级 Container 生效，只需在 MForm 这一层传一次。
    */
   selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+  /**
+   * 主题名称：对应 `packages/form/src/theme/themes/<theme>/index.scss` 的目录名。
+   *
+   * 设置后会在表单根元素上追加 `m-form--<theme>` 修饰类，配合按需引入
+   * `@tmagic/form/dist/themes/<theme>.css` 即可启用主题样式。
+   *
+   * 例如：`<MForm theme="magic-admin" />` + `import '@tmagic/form/dist/themes/magic-admin.css'`。
+   */
+  theme?: string;
 };
 declare const __VLS_base$5: import("@vue/runtime-core").DefineComponent<__VLS_Props$30, {
   values: import("@vue/reactivity").Ref<schema_d_exports.FormValue, schema_d_exports.FormValue>;
@@ -422,6 +446,12 @@ type __VLS_Props$29 = {
   showCancel?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
   useFieldTextInError?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
+   * 计算结果会再次 `provide` 出去，使得 Dialog 被 Teleport 到 body 后，内部子树
+   * （包括 `MForm` 以及更深的 popover / dropdown）仍能拿到主题。
+   */
+  theme?: string;
 };
 declare var __VLS_19: {}, __VLS_34: {}, __VLS_42: {};
 type __VLS_Slots$4 = {} & {
@@ -460,6 +490,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -503,6 +534,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -599,6 +631,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -646,6 +679,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -689,6 +723,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -785,6 +820,7 @@ declare const __VLS_base$4: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -860,6 +896,12 @@ type __VLS_Props$28 = {
   useFieldTextInError?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
   beforeClose?: (_done: (_cancel?: boolean) => void) => void; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
+  /**
+   * 主题名。优先级：传入 `theme` prop > 祖先 `provide(M_THEME_KEY)` > 空串。
+   * 计算结果会再次 `provide` 出去，使得 Drawer 被 Teleport 到 body 后，内部子树
+   * （包括 `MForm` 以及更深的 popover / dropdown）仍能拿到主题。
+   */
+  theme?: string;
 };
 declare var __VLS_23: {}, __VLS_38: {}, __VLS_46: {};
 type __VLS_Slots$3 = {} & {
@@ -898,6 +940,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -941,6 +984,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1037,6 +1081,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -1084,6 +1129,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -1127,6 +1173,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1223,6 +1270,7 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -1245,8 +1293,11 @@ declare const __VLS_base$3: import("@vue/runtime-core").DefineComponent<__VLS_Pr
   }) | undefined>;
   saveFetch: import("@vue/reactivity").Ref<boolean, boolean>;
   bodyHeight: import("@vue/reactivity").Ref<number, number>;
+  close: () => void;
   show: () => void;
   hide: () => void;
+  save: () => Promise<void>;
+  cancel: () => void;
   handleClose: () => void;
 }, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   error: (...args: any[]) => void;
@@ -1334,6 +1385,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -1377,6 +1429,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1473,6 +1526,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -1520,6 +1574,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean) | undefined;
       readonly selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]) | undefined;
+      readonly theme?: string | undefined;
       readonly onError?: ((...args: any[]) => any) | undefined;
       readonly onChange?: ((...args: any[]) => any) | undefined;
       readonly "onField-input"?: ((...args: any[]) => any) | undefined;
@@ -1563,6 +1618,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
         config: any;
       }) => boolean;
       selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+      theme?: string;
     }> & Readonly<{
       onError?: ((...args: any[]) => any) | undefined;
       onChange?: ((...args: any[]) => any) | undefined;
@@ -1659,6 +1715,7 @@ declare const __VLS_base$2: import("@vue/runtime-core").DefineComponent<__VLS_Pr
       config: any;
     }) => boolean;
     selfDiffFieldTypes?: string[] | ((_defaultTypes: string[]) => string[]);
+    theme?: string;
   }> & Readonly<{
     onError?: ((...args: any[]) => any) | undefined;
     onChange?: ((...args: any[]) => any) | undefined;
@@ -1797,6 +1854,7 @@ type __VLS_Props$23 = {
   prop?: string;
   size?: string;
   disabled?: boolean;
+  hideExpand?: boolean;
 };
 declare var __VLS_16: {}, __VLS_18: {};
 type __VLS_Slots = {} & {
@@ -2046,7 +2104,9 @@ declare const __VLS_export$4: import("@vue/runtime-core").DefineComponent<__VLS_
 declare const _default$8: typeof __VLS_export$4;
 //#endregion
 //#region temp/packages/form/src/fields/Link.vue.d.ts
-type __VLS_Props$3 = schema_d_exports.FieldProps<schema_d_exports.LinkConfig>;
+type __VLS_Props$3 = schema_d_exports.FieldProps<schema_d_exports.LinkConfig> & {
+  theme?: string;
+};
 declare const __VLS_export$3: import("@vue/runtime-core").DefineComponent<__VLS_Props$3, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
   change: (...args: any[]) => void;
 }, string, import("@vue/runtime-core").PublicProps, Readonly<__VLS_Props$3> & Readonly<{
@@ -2138,6 +2198,7 @@ declare const validateTypeMatch: (value: any, mForm: schema_d_exports.FormState
 //#endregion
 //#region temp/packages/form/src/plugin.d.ts
 interface FormInstallOptions {
+  flat?: boolean;
   /** 自定义字段 type 的 typeMatch 校验规则，可覆盖内置规则或扩展业务字段 */
   typeMatchRules?: Record<string, TypeMatchValidator>;
   [key: string]: any;
@@ -2146,8 +2207,8 @@ declare const _default$31: {
   install(app: App, opt?: FormInstallOptions): void;
 };
 declare namespace index_d_exports {
-  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
 }
 declare const createForm: <T extends [] = []>(config: schema_d_exports.FormConfig | T) => schema_d_exports.FormConfig | T;
 //#endregion
-export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };