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

package/types/index.d.ts

@@ -1,8 +1,6 @@
 import { App, AppContext, Component, ComputedRef, InjectionKey } from "vue";
 import { FlexLayoutConfig, FormItemConfig, GroupListConfig, TableConfig } from "@tmagic/form-schema";
 export * from "@tmagic/form-schema";
-
-//#region \0rolldown/runtime.js
 declare namespace schema_d_exports {
   export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormLabelSlotProps, FormSlots, ValidateError };
 }
@@ -37,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 {
@@ -278,20 +277,14 @@ declare const createValues: (mForm: schema_d_exports.FormState | undefined, conf
 declare const filterFunction: <T = any>(mForm: schema_d_exports.FormState | undefined, config: T | schema_d_exports.FilterFunction<T> | undefined, props: any) => T | undefined;
 declare const display: (mForm: schema_d_exports.FormState | undefined, config: any, props: any) => any;
 declare const getRules: (mForm: schema_d_exports.FormState | undefined, r: (schema_d_exports.Rule[] | schema_d_exports.Rule) | undefined, props: any, typeMatchValid?: ComputedRef<boolean>) => schema_d_exports.Rule[];
-declare const initValue: (mForm: schema_d_exports.FormState | undefined, {
-  initValues,
-  config
-}: {
+declare const initValue: (mForm: schema_d_exports.FormState | undefined, { initValues, config }: {
   initValues: schema_d_exports.FormValue;
   config: schema_d_exports.FormConfig;
 }) => Promise<schema_d_exports.FormValue>;
 declare const datetimeFormatter: (v: string | Date, defaultValue?: string, format?: string) => string | number;
 declare const getDataByPage: (data: any[] | undefined, pagecontext: number, pagesize: number) => any[];
 declare const sortArray: (data: any[], newIndex: number, oldIndex: number, sortKey?: string) => any[];
-declare const sortChange: (data: any[], {
-  prop,
-  order
-}: schema_d_exports.SortProp) => void;
+declare const sortChange: (data: any[], { prop, order }: schema_d_exports.SortProp) => void;
 /**
  * 将 extendState 返回的扩展字段合并进 formState。
  *
@@ -318,12 +311,17 @@ declare const useAddField: (prop?: string) => void;
 //#region temp/packages/form/src/Form.vue.d.ts
 type __VLS_Slots$5 = FormSlots;
 type __VLS_Props$30 = {
-  /** 表单配置 */config: schema_d_exports.FormConfig; /** 表单值 */
-  initValues: Record<string, any>; /** 需对比的值（开启对比模式时传入） */
-  lastValues?: Record<string, any>; /** 是否开启对比模式 */
+  /** 表单配置 */
+  config: schema_d_exports.FormConfig;
+  /** 表单值 */
+  initValues: Record<string, any>;
+  /** 需对比的值（开启对比模式时传入） */
+  lastValues?: Record<string, any>;
+  /** 是否开启对比模式 */
   isCompare?: boolean;
   parentValues?: Record<string, any>;
-  labelWidth?: string; /** 是否开启类型匹配校验 */
+  labelWidth?: string;
+  /** 是否开启类型匹配校验 */
   typeMatchValid?: boolean;
   /**
    * 初始化（`config` / `initValues` 就绪）后是否立即执行一次表单校验。
@@ -459,8 +457,10 @@ type __VLS_Props$29 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
   validateOnInit?: boolean;
   fullscreen?: boolean;
   disabled?: boolean;
@@ -475,8 +475,10 @@ type __VLS_Props$29 = {
   closeOnPressEscape?: boolean;
   destroyOnClose?: boolean;
   showClose?: boolean;
-  showCancel?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
-  useFieldTextInError?: boolean; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
+  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)` > 空串。
@@ -925,8 +927,10 @@ type __VLS_Props$28 = {
   values?: Object;
   parentValues?: Object;
   width?: string | number;
-  labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
   validateOnInit?: boolean;
   disabled?: boolean;
   closeOnPressEscape?: boolean;
@@ -936,9 +940,12 @@ type __VLS_Props$28 = {
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
-  useFieldTextInError?: boolean; /** 关闭前的回调，会暂停 Drawer 的关闭; done 是个 function type 接受一个 boolean 参数, 执行 done 使用 true 参数或不提供参数将会终止关闭 */
-  beforeClose?: (_done: (_cancel?: boolean) => void) => void; /** 透传给内部 `MForm`，用于扩展 `formState`（如注入 `$message` / `$store` 等） */
+  preventSubmitDefault?: boolean;
+  /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  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)` > 空串。
@@ -1392,19 +1399,22 @@ type __VLS_Props$27 = {
   parentValues?: Object;
   width?: number;
   height?: number;
-  labelWidth?: string; /** 是否开启类型匹配校验 */
-  typeMatchValid?: boolean; /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
+  labelWidth?: string;
+  /** 是否开启类型匹配校验 */
+  typeMatchValid?: boolean;
+  /** 透传给内部 `MForm`，初始化完成后是否立即校验（默认 `false`） */
   validateOnInit?: boolean;
   disabled?: boolean;
   size?: 'small' | 'default' | 'large';
   confirmText?: string;
   inline?: boolean;
   labelPosition?: string;
-  preventSubmitDefault?: boolean; /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
+  preventSubmitDefault?: boolean;
+  /** 透传给内部 `MForm`，控制表单校验失败时错误提示前缀是否使用字段的 text 文案 */
   useFieldTextInError?: boolean;
   extendState?: (_state: schema_d_exports.FormState) => Record<string, any> | Promise<Record<string, any>>;
 };
-declare var __VLS_16$1: {}, __VLS_18: {}, __VLS_20: {};
+declare var __VLS_16$1: {}, __VLS_18$1: {}, __VLS_20: {};
 type __VLS_Slots$2 = {} & {
   default?: (props: typeof __VLS_16$1) => any;
 } & {
@@ -1831,7 +1841,9 @@ type __VLS_WithSlots$2<T, S> = T & {
 //#region temp/packages/form/src/containers/Container.vue.d.ts
 type __VLS_Slots$1 = FormSlots;
 type __VLS_Props$26 = {
-  /** 表单值 */model: schema_d_exports.FormValue; /** 需对比的值（开启对比模式时传入） */
+  /** 表单值 */
+  model: schema_d_exports.FormValue;
+  /** 需对比的值（开启对比模式时传入） */
   lastValues?: schema_d_exports.FormValue;
   config: schema_d_exports.FormItemConfig;
   prop?: string;
@@ -1839,8 +1851,10 @@ type __VLS_Props$26 = {
   labelWidth?: string | number;
   expandMore?: boolean;
   stepActive?: string | number;
-  size?: string; /** 是否开启对比模式 */
-  isCompare?: boolean; /** 是否在行容器中 */
+  size?: string;
+  /** 是否开启对比模式 */
+  isCompare?: boolean;
+  /** 是否在行容器中 */
   isInRow?: boolean;
 };
 declare const __VLS_base$1: import("@vue/runtime-core").DefineComponent<__VLS_Props$26, {}, {}, {}, {}, import("@vue/runtime-core").ComponentOptionsMixin, import("@vue/runtime-core").ComponentOptionsMixin, {
@@ -2243,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;
@@ -2266,6 +2292,17 @@ declare const getTypeMatchRule: (type: string) => TypeMatchValidator | undefined
 declare const deleteTypeMatchRule: (type: string) => boolean;
 /** 清空所有自定义 typeMatch 校验规则 */
 declare const clearTypeMatchRules: () => void;
+/**
+ * 将值格式化为可读的参考示例字符串。
+ */
+declare const stringifyExampleValue: (value: any) => string;
+/** 参考建议中可选值全量展示上限；超出时仅举例 EXAMPLE_SUGGESTION_COUNT 个并标明总数。 */
+declare const MAX_SUGGESTION_OPTIONS = 20;
+/**
+ * 生成可选项参考建议；无可选值时返回空字符串（不追加建议）。
+ * 未超过 MAX_SUGGESTION_OPTIONS 时全部列举；超过时仅举例前 EXAMPLE_SUGGESTION_COUNT 个并标明总数，避免 AI 误以为仅有举例值合法。
+ */
+declare const optionSuggestion: (optionValues: any[]) => string;
 /**
  * 校验取值与字段 type 是否匹配；通过返回 undefined，否则返回错误文案。
  *
@@ -2284,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, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$16 as MTable, _default$16 as MTableGroupList, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, TypeMatchValidateContext, TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+  export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, FormInstallOptions, FormLabelSlotProps, FormSlots, 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, _default as MCascader, _default$1 as MCheckbox, _default$2 as MCheckboxGroup, _default$3 as MColorPicker, _default$4 as MContainer, _default$5 as MDate, _default$6 as MDateTime, _default$7 as MDaterange, _default$8 as MDisplay, _default$9 as MDynamicField, _default$10 as MFieldset, _default$11 as MFlexLayout, _default$12 as MForm, _default$13 as MFormBox, _default$14 as MFormDialog, _default$15 as MFormDrawer, _default$16 as MGroupList, _default$16 as MTable, _default$16 as MTableGroupList, _default$17 as MHidden, _default$18 as MLink, _default$19 as MNumber, _default$20 as MNumberRange, _default$21 as MPanel, _default$22 as MRadioGroup, _default$23 as MRow, _default$24 as MSelect, _default$25 as MSwitch, _default$26 as MTabs, _default$27 as MText, _default$28 as MTextarea, _default$29 as MTime, _default$30 as MTimerange, SubmitFormOptions, SubmitFormResult, type TypeMatchValidateContext, type TypeMatchValidator, ValidateError, ValidateFormOptions, adaptFormValidator, applyExtendState, clearTypeMatchRules, createForm, createObjectProp, createValues, datetimeFormatter, _default$31 as default, deleteField as deleteFormField, deleteTypeMatchRule, display, filterFunction, getDataByPage, getField as getFormField, getRules, getTypeMatchRule, initValue, registerField as registerFormField, registerTypeMatchRule, registerTypeMatchRules, sortArray, sortChange, stripTabItemsLazy, submitForm, useAddField, validateForm, validateTypeMatch };
+export { ChangeRecord, ContainerChangeEventData, FORM_DIFF_CONFIG_KEY, FORM_SILENT_MODE_KEY, FORM_TYPE_MATCH_VALID_KEY, FormDiffConfig, type FormInstallOptions, FormLabelSlotProps, FormSlots, 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 };

package/dist/es/_virtual/_rolldown/runtime.js

@@ -1,27 +0,0 @@
-//#region \0rolldown/runtime.js
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __exportAll = (all, no_symbols) => {
-	let target = {};
-	for (var name in all) __defProp(target, name, {
-		get: all[name],
-		enumerable: true
-	});
-	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
-	return target;
-};
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-//#endregion
-export { __exportAll, __reExport };