@robot-admin/naive-ui-components 0.7.1 → 0.8.0

package/dist/useDynamicFormState.d.ts

@@ -1,12 +1,18 @@
 import * as naive_ui0 from "naive-ui";
 import * as vue from "vue";
 import { CSSProperties, Component, ComputedRef, Ref, VNode } from "vue";
+import * as _robot_admin_form_validate0 from "@robot-admin/form-validate";
 import { FieldRule } from "@robot-admin/form-validate";
 import { FormInst } from "naive-ui/es";
 import * as naive_ui_es_form_src_interface0 from "naive-ui/es/form/src/interface";
 import { FormInst as FormInst$1, FormRules } from "naive-ui/es/form";
 
 //#region src/components/C_Form/types.d.ts
+/**
+ * 表单模式
+ * @description create = 新建（空白表单），edit = 编辑（回填已有数据 + 脏检查）
+ */
+type FormMode = "create" | "edit";
 /**
  * 支持的布局类型
  * @description 定义表单支持的所有布局模式
@@ -230,6 +236,18 @@ interface FormOption {
   required?: boolean;
   dependsOn?: string | string[];
   showWhen?: (formModel: Record<string, any>) => boolean;
+  /** 字段级禁用（优先级高于全局 config.disabled） */
+  disabled?: boolean | ((formModel: Record<string, any>) => boolean);
+  /** 字段级只读（优先级高于全局 config.readonly） */
+  readonly?: boolean | ((formModel: Record<string, any>) => boolean);
+  /** 联动赋值：其他字段变化时自动计算本字段的值 */
+  valueWhen?: (formModel: Record<string, any>) => any;
+  /** 异步数据源：select / cascader / checkbox / radio 的远程选项加载 */
+  asyncOptions?: (formModel: Record<string, any>) => Promise<OptionItem[]>;
+  /** 联动校验规则：根据表单数据动态返回校验规则 */
+  rulesWhen?: (formModel: Record<string, any>) => FieldRule[];
+  /** 跨字段校验：需要引用多个字段值的验证函数，返回错误消息或 null */
+  crossFieldValidator?: (formModel: Record<string, any>) => string | null;
 }
 /**
  * 表单提交事件参数
@@ -261,6 +279,16 @@ interface FormInstance {
   initialize(): void;
   layoutType: ComputedRef<LayoutType>;
   shouldShowDefaultActions: ComputedRef<boolean>;
+  /** 表单是否被修改过 */
+  isDirty: Ref<boolean>;
+  /** 获取被修改的字段列表 */
+  getChangedFields(): string[];
+  /** 检查某字段是否被修改 */
+  isFieldDirty(field: string): boolean;
+  /** 将当前值设为初始快照（常用于编辑模式加载数据后） */
+  markAsClean(): void;
+  /** 字段异步选项的 loading 状态 */
+  asyncLoadingMap: Ref<Record<string, boolean>>;
 }
 /**
  * 表单数据模型类型（泛型）
@@ -322,7 +350,7 @@ interface FormConfig extends LayoutCallbacks {
   /** 标签宽度，默认 'auto' */
   labelWidth?: string | number;
   /** 尺寸，默认 'medium' */
-  size?: "small" | "medium" | "large";
+  size?: 'small' | 'medium' | 'large';
   /** 禁用整个表单，默认 false */
   disabled?: boolean;
   /** 只读，默认 false */
@@ -331,6 +359,10 @@ interface FormConfig extends LayoutCallbacks {
   showActions?: boolean;
   /** 值变化时自动校验，默认 false */
   validateOnChange?: boolean;
+  /** 表单模式：create = 新建（默认），edit = 编辑（配合 initialValues 实现回填 + 脏检查） */
+  mode?: FormMode;
+  /** 编辑模式初始值：设置后自动作为脏检查基准 */
+  initialValues?: Record<string, any>;
   grid?: GridLayoutConfig;
   inline?: InlineLayoutConfig;
   card?: CardLayoutConfig;
@@ -340,7 +372,7 @@ interface FormConfig extends LayoutCallbacks {
   custom?: CustomLayoutConfig;
 }
 /** 解析后的配置（所有必填字段均已设置默认值） */
-interface ResolvedFormConfig extends Required<Omit<FormConfig, keyof LayoutCallbacks | "grid" | "inline" | "card" | "tabs" | "steps" | "dynamic" | "custom">> {
+interface ResolvedFormConfig extends Required<Omit<FormConfig, keyof LayoutCallbacks | 'grid' | 'inline' | 'card' | 'tabs' | 'steps' | 'dynamic' | 'custom' | 'initialValues'>> {
   grid?: GridLayoutConfig;
   inline?: InlineLayoutConfig;
   card?: CardLayoutConfig;
@@ -348,19 +380,20 @@ interface ResolvedFormConfig extends Required<Omit<FormConfig, keyof LayoutCallb
   steps?: StepsLayoutConfig;
   dynamic?: DynamicLayoutConfig;
   custom?: CustomLayoutConfig;
-  onTabChange?: LayoutCallbacks["onTabChange"];
-  onTabValidate?: LayoutCallbacks["onTabValidate"];
-  onStepChange?: LayoutCallbacks["onStepChange"];
-  onStepBeforeChange?: LayoutCallbacks["onStepBeforeChange"];
-  onStepValidate?: LayoutCallbacks["onStepValidate"];
-  onFieldAdd?: LayoutCallbacks["onFieldAdd"];
-  onFieldRemove?: LayoutCallbacks["onFieldRemove"];
-  onFieldToggle?: LayoutCallbacks["onFieldToggle"];
-  onFieldsClear?: LayoutCallbacks["onFieldsClear"];
-  onRenderModeChange?: LayoutCallbacks["onRenderModeChange"];
-  onGroupToggle?: LayoutCallbacks["onGroupToggle"];
-  onGroupReset?: LayoutCallbacks["onGroupReset"];
-  onFieldsChange?: LayoutCallbacks["onFieldsChange"];
+  onTabChange?: LayoutCallbacks['onTabChange'];
+  onTabValidate?: LayoutCallbacks['onTabValidate'];
+  onStepChange?: LayoutCallbacks['onStepChange'];
+  onStepBeforeChange?: LayoutCallbacks['onStepBeforeChange'];
+  onStepValidate?: LayoutCallbacks['onStepValidate'];
+  onFieldAdd?: LayoutCallbacks['onFieldAdd'];
+  onFieldRemove?: LayoutCallbacks['onFieldRemove'];
+  onFieldToggle?: LayoutCallbacks['onFieldToggle'];
+  onFieldsClear?: LayoutCallbacks['onFieldsClear'];
+  onRenderModeChange?: LayoutCallbacks['onRenderModeChange'];
+  onGroupToggle?: LayoutCallbacks['onGroupToggle'];
+  onGroupReset?: LayoutCallbacks['onGroupReset'];
+  onFieldsChange?: LayoutCallbacks['onFieldsChange'];
+  initialValues?: Record<string, any>;
 }
 declare const FORM_DEFAULTS: ResolvedFormConfig;
 /** 拥有自身控制按钮的布局（不显示默认操作按钮） */
@@ -427,6 +460,11 @@ declare const __VLS_base: vue.DefineComponent<CFormProps, {
   initialize: () => void;
   layoutType: vue.ComputedRef<LayoutType>;
   shouldShowDefaultActions: vue.ComputedRef<boolean>;
+  isDirty: vue.Ref<boolean, boolean>;
+  getChangedFields: () => string[];
+  isFieldDirty: (field: string) => boolean;
+  markAsClean: () => void;
+  asyncLoadingMap: vue.Ref<Record<string, boolean>, Record<string, boolean>>;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   "update:modelValue": (model: Record<string, any>) => any;
   submit: (payload: SubmitEventPayload) => any;
@@ -450,11 +488,7 @@ type __VLS_WithSlots<T, S> = T & {
 //#endregion
 //#region src/components/C_Form/composables/useFormState.d.ts
 /**
- * C_Form 状态引擎 — 管理表单数据模型、校验规则、验证 API、字段操作
- * @param options - 表单配置项（响应式）
- * @param config - 解析后的表单配置（响应式）
- * @param formRef - NForm 实例引用
- * @param emit - 组件事件发射器
+ * C_Form 状态引擎 — 管理表单数据模型、校验规则、验证 API、字段操作、脏检查、联动
  */
 declare function useFormState(options: ComputedRef<FormOption[]>, config: ComputedRef<ResolvedFormConfig>, formRef: Ref<FormInst$1 | null>, emit: {
   (e: 'update:modelValue', model: FormModel): void;
@@ -482,27 +516,44 @@ declare function useFormState(options: ComputedRef<FormOption[]>, config: Comput
   setFieldsValue: (fields: FormModel, shouldValidate?: boolean) => Promise<void>;
   handleSubmit: () => Promise<void>;
   handleReset: () => void;
+  isDirty: Ref<boolean, boolean>;
+  getChangedFields: () => string[];
+  isFieldDirty: (field: string) => boolean;
+  markAsClean: () => void;
+  asyncOptionsCache: Ref<Record<string, OptionItem[]>, Record<string, OptionItem[]>>;
+  asyncLoadingMap: Ref<Record<string, boolean>, Record<string, boolean>>;
 };
 //#endregion
 //#region src/components/C_Form/composables/useFormRenderer.d.ts
-/** 组件映射表 — 由调用方（C_Form）注入已解析的组件引用 */
 type ComponentMap = Record<string, Component>;
-/** 单个控件的渲染函数签名 */
 type FormRenderer = (baseProps: Record<string, any>, item: FormOption, config: ResolvedFormConfig, ctx?: {
   slots?: Record<string, any>;
   components?: ComponentMap;
 }) => VNode | null;
+interface UseFormRendererOptions {
+  formModel: FormModel;
+  visibleOptions: ComputedRef<FormOption[]>;
+  config: ComputedRef<ResolvedFormConfig>;
+  handleFieldChange: (field: string) => void;
+  componentMap: ComponentMap;
+  instanceSlots?: Record<string, any>;
+  asyncOptionsCache: Ref<Record<string, OptionItem[]>>;
+  asyncLoadingMap: Ref<Record<string, boolean>>;
+}
 /**
  * 运行时注册自定义渲染器 — 开闭原则
- * @param type - 控件类型名
- * @param renderer - 渲染函数
  */
 declare function registerRenderer(type: string, renderer: FormRenderer): void;
 /**
  * 渲染引擎 Composable — 生成 formItems VNode 数组
- * @param componentMap - 已解析的组件映射表（由 C_Form 的 <script setup> 提供）
+ *
+ * v0.8.0 增强：
+ * - 字段级 disabled / readonly
+ * - help / tooltip label 渲染
+ * - asyncOptions 远程选项合并
+ * - loading 占位
  */
-declare function useFormRenderer(formModel: FormModel, visibleOptions: ComputedRef<FormOption[]>, config: ComputedRef<ResolvedFormConfig>, handleFieldChange: (field: string) => void, componentMap: ComponentMap, instanceSlots?: Record<string, any>): {
+declare function useFormRenderer(opts: UseFormRendererOptions): {
   renderFormItem: (item: FormOption) => VNode | null;
   formItems: ComputedRef<VNode<vue.RendererNode, vue.RendererElement, {
     [key: string]: any;
@@ -510,6 +561,23 @@ declare function useFormRenderer(formModel: FormModel, visibleOptions: ComputedR
   getBaseProps: (item: FormOption) => Record<string, unknown>;
 };
 //#endregion
+//#region src/components/C_Form/composables/useFormDirty.d.ts
+interface UseFormDirtyReturn {
+  /** 表单是否已修改 */
+  isDirty: Ref<boolean>;
+  /** 获取发生变化的字段名列表 */
+  getChangedFields: () => string[];
+  /** 检查指定字段是否脏 */
+  isFieldDirty: (field: string) => boolean;
+  /** 保存当前值为干净快照 */
+  markAsClean: () => void;
+}
+/**
+ * 脏检查 Composable — 追踪 formModel 相对于初始快照的变化
+ * @param formModel 响应式表单数据对象（reactive）
+ */
+declare function useFormDirty(formModel: FormModel): UseFormDirtyReturn;
+//#endregion
 //#region node_modules/async-validator/dist-types/interface.d.ts
 declare type RuleType = 'string' | 'number' | 'boolean' | 'method' | 'regexp' | 'integer' | 'float' | 'array' | 'object' | 'enum' | 'date' | 'url' | 'hex' | 'email' | 'pattern' | 'any';
 interface ValidateOption {
@@ -1296,10 +1364,67 @@ declare const useDynamicFormState: () => {
       readonly rules?: readonly {
         readonly type?: RuleType | undefined;
         readonly required?: boolean | undefined;
+        readonly max?: number | undefined;
+        readonly level?: "warning" | "error" | undefined;
+        readonly key?: string | undefined;
+        readonly options?: {
+          readonly suppressWarning?: boolean | undefined;
+          readonly suppressValidatorError?: boolean | undefined;
+          readonly first?: boolean | undefined;
+          readonly firstFields?: boolean | readonly string[] | undefined;
+          readonly messages?: {
+            readonly default?: (string | ((...args: unknown[]) => string)) | undefined;
+            readonly required?: (string | ((args_0: string | undefined) => string)) | undefined;
+            readonly enum?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+            readonly whitespace?: (string | ((args_0: string | undefined) => string)) | undefined;
+            readonly date?: {
+              readonly format?: (string | ((...args: unknown[]) => string)) | undefined;
+              readonly parse?: (string | ((...args: unknown[]) => string)) | undefined;
+              readonly invalid?: (string | ((...args: unknown[]) => string)) | undefined;
+            } | undefined;
+            readonly types?: {
+              readonly string?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly method?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly array?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly object?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly number?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly date?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly boolean?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly integer?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly float?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly regexp?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly email?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly url?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly hex?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+            } | undefined;
+            readonly string?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly number?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly array?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly pattern?: {
+              readonly mismatch?: (string | ((args_0: string | undefined, args_1: any, args_2: string | RegExp | undefined) => string)) | undefined;
+            } | undefined;
+          } | undefined;
+          readonly keys?: readonly string[] | undefined;
+          readonly error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
+        } | undefined;
         readonly asyncValidator?: naive_ui_es_form_src_interface0.FormItemRuleAsyncValidator | undefined;
         readonly pattern?: (RegExp | string) | undefined;
         readonly min?: number | undefined;
-        readonly max?: number | undefined;
         readonly len?: number | undefined;
         readonly enum?: readonly (string | number | boolean | null | undefined)[] | undefined;
         readonly whitespace?: boolean | undefined;
@@ -1446,61 +1571,6 @@ declare const useDynamicFormState: () => {
             readonly validator?: ((rule: InternalRuleItem, value: Value, callback: (error?: string | Error) => void, source: Values, options: ValidateOption) => SyncValidateResult | void) | undefined;
           }[];
         } | undefined;
-        readonly options?: {
-          readonly suppressWarning?: boolean | undefined;
-          readonly suppressValidatorError?: boolean | undefined;
-          readonly first?: boolean | undefined;
-          readonly firstFields?: boolean | readonly string[] | undefined;
-          readonly messages?: {
-            readonly default?: (string | ((...args: unknown[]) => string)) | undefined;
-            readonly required?: (string | ((args_0: string | undefined) => string)) | undefined;
-            readonly enum?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-            readonly whitespace?: (string | ((args_0: string | undefined) => string)) | undefined;
-            readonly date?: {
-              readonly format?: (string | ((...args: unknown[]) => string)) | undefined;
-              readonly parse?: (string | ((...args: unknown[]) => string)) | undefined;
-              readonly invalid?: (string | ((...args: unknown[]) => string)) | undefined;
-            } | undefined;
-            readonly types?: {
-              readonly string?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly method?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly array?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly object?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly number?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly date?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly boolean?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly integer?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly float?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly regexp?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly email?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly url?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly hex?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-            } | undefined;
-            readonly string?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly number?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly array?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly pattern?: {
-              readonly mismatch?: (string | ((args_0: string | undefined, args_1: any, args_2: string | RegExp | undefined) => string)) | undefined;
-            } | undefined;
-          } | undefined;
-          readonly keys?: readonly string[] | undefined;
-          readonly error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
-        } | undefined;
         readonly defaultField?: {
           readonly type?: RuleType | undefined;
           readonly required?: boolean | undefined;
@@ -1928,10 +1998,8 @@ declare const useDynamicFormState: () => {
         }[] | undefined;
         readonly transform?: ((value: Value) => Value) | undefined;
         readonly message?: string | ((a?: string) => string) | undefined;
-        readonly key?: string | undefined;
         readonly trigger?: string | readonly string[] | undefined;
         readonly renderMessage?: (() => vue.VNodeChild) | undefined;
-        readonly level?: "warning" | "error" | undefined;
         readonly validator: NonNullable<naive_ui0.FormItemRule["validator"]>;
       }[] | undefined;
       readonly attrs?: {
@@ -3557,6 +3625,12 @@ declare const useDynamicFormState: () => {
       readonly required?: boolean | undefined;
       readonly dependsOn?: string | readonly string[] | undefined;
       readonly showWhen?: ((formModel: Record<string, any>) => boolean) | undefined;
+      readonly disabled?: boolean | ((formModel: Record<string, any>) => boolean) | undefined;
+      readonly readonly?: boolean | ((formModel: Record<string, any>) => boolean) | undefined;
+      readonly valueWhen?: ((formModel: Record<string, any>) => any) | undefined;
+      readonly asyncOptions?: ((formModel: Record<string, any>) => Promise<OptionItem[]>) | undefined;
+      readonly rulesWhen?: ((formModel: Record<string, any>) => _robot_admin_form_validate0.FieldRule[]) | undefined;
+      readonly crossFieldValidator?: ((formModel: Record<string, any>) => string | null) | undefined;
     }[];
     readonly dynamicFields: readonly {
       readonly id: string;
@@ -3573,10 +3647,67 @@ declare const useDynamicFormState: () => {
       readonly rules?: readonly {
         readonly type?: RuleType | undefined;
         readonly required?: boolean | undefined;
+        readonly max?: number | undefined;
+        readonly level?: "warning" | "error" | undefined;
+        readonly key?: string | undefined;
+        readonly options?: {
+          readonly suppressWarning?: boolean | undefined;
+          readonly suppressValidatorError?: boolean | undefined;
+          readonly first?: boolean | undefined;
+          readonly firstFields?: boolean | readonly string[] | undefined;
+          readonly messages?: {
+            readonly default?: (string | ((...args: unknown[]) => string)) | undefined;
+            readonly required?: (string | ((args_0: string | undefined) => string)) | undefined;
+            readonly enum?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+            readonly whitespace?: (string | ((args_0: string | undefined) => string)) | undefined;
+            readonly date?: {
+              readonly format?: (string | ((...args: unknown[]) => string)) | undefined;
+              readonly parse?: (string | ((...args: unknown[]) => string)) | undefined;
+              readonly invalid?: (string | ((...args: unknown[]) => string)) | undefined;
+            } | undefined;
+            readonly types?: {
+              readonly string?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly method?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly array?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly object?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly number?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly date?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly boolean?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly integer?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly float?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly regexp?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly email?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly url?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+              readonly hex?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
+            } | undefined;
+            readonly string?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly number?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly array?: {
+              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
+              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
+            } | undefined;
+            readonly pattern?: {
+              readonly mismatch?: (string | ((args_0: string | undefined, args_1: any, args_2: string | RegExp | undefined) => string)) | undefined;
+            } | undefined;
+          } | undefined;
+          readonly keys?: readonly string[] | undefined;
+          readonly error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
+        } | undefined;
         readonly asyncValidator?: naive_ui_es_form_src_interface0.FormItemRuleAsyncValidator | undefined;
         readonly pattern?: (RegExp | string) | undefined;
         readonly min?: number | undefined;
-        readonly max?: number | undefined;
         readonly len?: number | undefined;
         readonly enum?: readonly (string | number | boolean | null | undefined)[] | undefined;
         readonly whitespace?: boolean | undefined;
@@ -3723,61 +3854,6 @@ declare const useDynamicFormState: () => {
             readonly validator?: ((rule: InternalRuleItem, value: Value, callback: (error?: string | Error) => void, source: Values, options: ValidateOption) => SyncValidateResult | void) | undefined;
           }[];
         } | undefined;
-        readonly options?: {
-          readonly suppressWarning?: boolean | undefined;
-          readonly suppressValidatorError?: boolean | undefined;
-          readonly first?: boolean | undefined;
-          readonly firstFields?: boolean | readonly string[] | undefined;
-          readonly messages?: {
-            readonly default?: (string | ((...args: unknown[]) => string)) | undefined;
-            readonly required?: (string | ((args_0: string | undefined) => string)) | undefined;
-            readonly enum?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-            readonly whitespace?: (string | ((args_0: string | undefined) => string)) | undefined;
-            readonly date?: {
-              readonly format?: (string | ((...args: unknown[]) => string)) | undefined;
-              readonly parse?: (string | ((...args: unknown[]) => string)) | undefined;
-              readonly invalid?: (string | ((...args: unknown[]) => string)) | undefined;
-            } | undefined;
-            readonly types?: {
-              readonly string?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly method?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly array?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly object?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly number?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly date?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly boolean?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly integer?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly float?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly regexp?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly email?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly url?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-              readonly hex?: (string | ((args_0: string | undefined, args_1: string | undefined) => string)) | undefined;
-            } | undefined;
-            readonly string?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly number?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly array?: {
-              readonly len?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly min?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly max?: (string | ((args_0: string | undefined, args_1: number | undefined) => string)) | undefined;
-              readonly range?: (string | ((args_0: string | undefined, args_1: number | undefined, args_2: number | undefined) => string)) | undefined;
-            } | undefined;
-            readonly pattern?: {
-              readonly mismatch?: (string | ((args_0: string | undefined, args_1: any, args_2: string | RegExp | undefined) => string)) | undefined;
-            } | undefined;
-          } | undefined;
-          readonly keys?: readonly string[] | undefined;
-          readonly error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
-        } | undefined;
         readonly defaultField?: {
           readonly type?: RuleType | undefined;
           readonly required?: boolean | undefined;
@@ -4205,10 +4281,8 @@ declare const useDynamicFormState: () => {
         }[] | undefined;
         readonly transform?: ((value: Value) => Value) | undefined;
         readonly message?: string | ((a?: string) => string) | undefined;
-        readonly key?: string | undefined;
         readonly trigger?: string | readonly string[] | undefined;
         readonly renderMessage?: (() => vue.VNodeChild) | undefined;
-        readonly level?: "warning" | "error" | undefined;
         readonly validator: NonNullable<naive_ui0.FormItemRule["validator"]>;
       }[] | undefined;
     }[];
@@ -4244,5 +4318,5 @@ type DynamicFormStateType = ReturnType<typeof useDynamicFormState>;
  */
 declare const DYNAMIC_FORM_STATE_KEY: unique symbol;
 //#endregion
-export { LayoutConfig as A, DynamicFormState as C, GridLayoutConfig as D, FormOption as E, StepsLayoutConfig as M, SubmitEventPayload as N, InlineLayoutConfig as O, TabsLayoutConfig as P, DynamicFormConfig as S, FormModel as T, shouldShowActions as _, ComponentMap as a, CustomLayoutConfig as b, useFormRenderer as c, FORM_DEFAULTS as d, FormConfig as f, resolveFormConfig as g, ResolvedFormConfig as h, useDynamicFormState as i, LayoutType as j, LabelPlacement as k, useFormState as l, LayoutCallbacks as m, DynamicFormStateType as n, FormRenderer as o, LAYOUTS_WITH_OWN_CONTROLS as p, FIELD_TYPE_OPTIONS as r, registerRenderer as s, DYNAMIC_FORM_STATE_KEY as t, _default as u, CardLayoutConfig as v, FormInstance as w, DynamicFieldConfig as x, ComponentType as y };
+export { FormOption as A, CustomLayoutConfig as C, FormInstance as D, DynamicFormState as E, LayoutType as F, StepsLayoutConfig as I, SubmitEventPayload as L, InlineLayoutConfig as M, LabelPlacement as N, FormMode as O, LayoutConfig as P, TabsLayoutConfig as R, ComponentType as S, DynamicFormConfig as T, LayoutCallbacks as _, UseFormDirtyReturn as a, shouldShowActions as b, FormRenderer as c, useFormRenderer as d, useFormState as f, LAYOUTS_WITH_OWN_CONTROLS as g, FormConfig as h, useDynamicFormState as i, GridLayoutConfig as j, FormModel as k, UseFormRendererOptions as l, FORM_DEFAULTS as m, DynamicFormStateType as n, useFormDirty as o, _default as p, FIELD_TYPE_OPTIONS as r, ComponentMap as s, DYNAMIC_FORM_STATE_KEY as t, registerRenderer as u, ResolvedFormConfig as v, DynamicFieldConfig as w, CardLayoutConfig as x, resolveFormConfig as y };
 //# sourceMappingURL=useDynamicFormState.d.ts.map

package/dist/useEdgeInteraction.d.ts

@@ -259,11 +259,11 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: any) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  width: string | number;
-  height: string | number;
   readonly: boolean;
-  showToolbar: boolean;
+  height: string | number;
   theme: "light" | "dark";
+  width: string | number;
+  showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useGlobalSearch.d.ts

@@ -50,8 +50,8 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   openDialog: () => Promise<void>;
   closeDialog: () => void;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<Props> & Readonly<{}>, {
-  emptyText: string;
   placeholder: string;
+  emptyText: string;
   resultGroupTitle: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/useInfiniteScroll.d.ts

@@ -89,11 +89,11 @@ declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {
-  gap: number;
-  animationDuration: number;
   columns: number;
-  infinite: boolean;
   loading: boolean;
+  animationDuration: number;
+  gap: number;
+  infinite: boolean;
   lazy: boolean;
   skeleton: boolean;
   skeletonCount: number;

package/dist/useModalEdit.d.ts

@@ -827,7 +827,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   clearRowSelection: () => void;
   resetToFirstPage: () => void;
   getSelectedRows: () => DataRecord[];
-  getEditingData: () => vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+  getEditingData: () => DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
   isEditing: (rowKey: DataTableRowKey$1, columnKey?: string) => boolean;
   isExpanded: (rowKey: DataTableRowKey$1) => boolean;
   getManager: () => {
@@ -836,7 +836,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
       cancel(): void;
       save(): Promise<void>;
       isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean;
-      getEditingData(): vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+      getEditingData(): DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
     };
     expand: {
       row(rowKey: DataTableRowKey$1): Promise<void>;
@@ -885,7 +885,6 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   } | undefined;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   cancel: (rowData: DataRecord, rowIndex: number) => any;
-  save: (rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any;
   "pagination-change": (...args: unknown[]) => any;
   "row-delete": (...args: unknown[]) => any;
   "expand-change": (expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any;
@@ -893,6 +892,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   "child-selection-change": (parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any;
   "parent-child-link-change": (parentKey: DataTableRowKey$1, shouldSelect: boolean) => any;
   "update:data": (data: DataRecord[]) => any;
+  save: (rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any;
   "row-add": (newRow: DataRecord) => any;
   "row-copy": (originalRow: DataRecord, newRow: DataRecord) => any;
   "row-move": (row: DataRecord, fromIndex: number, toIndex: number) => any;
@@ -901,7 +901,6 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   "column-change": (columns: TableColumn[]) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
   onCancel?: ((rowData: DataRecord, rowIndex: number) => any) | undefined;
-  onSave?: ((rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any) | undefined;
   "onPagination-change"?: ((...args: unknown[]) => any) | undefined;
   "onRow-delete"?: ((...args: unknown[]) => any) | undefined;
   "onExpand-change"?: ((expandedKeys: DataTableRowKey$1[], row?: DataRecord | undefined, expanded?: boolean | undefined) => any) | undefined;
@@ -909,6 +908,7 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props, {
   "onChild-selection-change"?: ((parentKey: DataTableRowKey$1, childKeys: DataTableRowKey$1[], childRows: any[]) => any) | undefined;
   "onParent-child-link-change"?: ((parentKey: DataTableRowKey$1, shouldSelect: boolean) => any) | undefined;
   "onUpdate:data"?: ((data: DataRecord[]) => any) | undefined;
+  onSave?: ((rowData: DataRecord, rowIndex: number, columnKey?: string | undefined) => any) | undefined;
   "onRow-add"?: ((newRow: DataRecord) => any) | undefined;
   "onRow-copy"?: ((originalRow: DataRecord, newRow: DataRecord) => any) | undefined;
   "onRow-move"?: ((row: DataRecord, fromIndex: number, toIndex: number) => any) | undefined;
@@ -1158,7 +1158,7 @@ declare function useTableManager(params: TableManagerParams): {
       cancel(): void; /** 保存编辑 */
       save(): Promise<void>; /** 是否正在编辑 */
       isEditing(rowKey: DataTableRowKey$1, columnKey?: string): boolean; /** 获取当前编辑数据 */
-      getEditingData(): vue.Ref<Record<string, any>, Record<string, any>> | DataRecord | null;
+      getEditingData(): DataRecord | vue.Ref<Record<string, any>, Record<string, any>> | null;
     };
     expand: {
       /** 展开行 */row(rowKey: DataTableRowKey$1): Promise<void>; /** 折叠行 */

package/dist/useQRCode.d.ts

@@ -51,12 +51,12 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
   onError?: ((error: Error) => any) | undefined;
 }>, {
   size: number;
+  mode: RenderMode;
   label: string;
   color: string;
-  margin: number;
   showBorder: boolean;
+  margin: number;
   showLabel: boolean;
-  mode: RenderMode;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
   logo: LogoOptions;