@maxtan/ez-ui 0.24.0 → 0.25.0

package/dist/types/index.d.ts

@@ -26,6 +26,7 @@ import { ExtractPropTypes as ExtractPropTypes_2 } from 'vue';
 import { EzFormItemProps as EzFormItemProps_2 } from '.';
 import { FastTableSolt as FastTableSolt_2 } from '.';
 import { FormData as FormData_3 } from '.';
+import { FormGroupConfig as FormGroupConfig_2 } from '.';
 import { FormItemConfig as FormItemConfig_2 } from '.';
 import { FormItemContext } from 'element-plus';
 import { FormItemProp } from 'element-plus';
@@ -206,6 +207,20 @@ export declare interface DynamicFormExpose {
     formRef: any;
 }
 
+/**
+ * 分组插槽作用域
+ */
+export declare interface DynamicFormGroupSlotScope {
+    /** 分组配置 */
+    group: FormGroupConfig;
+    /** 分组索引 */
+    index: number;
+    /** 分组内可见项 */
+    items: FormItemConfig[];
+    /** 完整表单数据 */
+    formData: FormData_2;
+}
+
 /**
  * 标签插槽作用域
  */
@@ -219,8 +234,10 @@ export declare interface DynamicFormLabelSlotScope {
  * 继承 FormProps，排除会干扰内部逻辑的属性，并添加组件特有属性
  */
 export declare interface DynamicFormProps extends Partial<Omit<FormProps, 'model' | 'rules' | 'showMessage'>> {
-    /** 表单配置项 */
-    items: FormItemConfig[];
+    /** 扁平表单配置项（兼容旧版） */
+    items?: FormItemConfig[];
+    /** 分组表单配置项（新版推荐） */
+    groups?: FormGroupConfig[];
     /** 双向绑定的表单数据 */
     modelValue?: FormData_2;
     /** 栅格布局列数（默认 1） */
@@ -235,10 +252,11 @@ export declare interface DynamicFormProps extends Partial<Omit<FormProps, 'model
  * 动态表单插槽
  */
 export declare interface DynamicFormSlots {
-    /** 表单项自定义插槽 */
-    [key: string]: (scope: DynamicFormSlotScope) => VNode_2 | VNode_2[];
-    /** 表单项标签插槽 */
-    [key: `label-${string}`]: (scope: DynamicFormLabelSlotScope) => VNode_2 | VNode_2[];
+    /**
+     * 动态表单支持项级与分组级的动态插槽，
+     * 统一放宽为 any 作用域，避免模板静态校验冲突。
+     */
+    [key: string]: ((scope: any) => VNode_2 | VNode_2[]) | undefined;
 }
 
 /**
@@ -365,9 +383,10 @@ export declare const EzDynamicForm: ({
     "update:modelValue": (value: FormData_3) => any;
     }, PublicProps, {
     items: FormItemConfig_2[];
+    groups: FormGroupConfig_2[];
     cols: number;
     gutter: number;
-    }, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+    }, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
     formRef: {
     $: ComponentInternalInstance;
     $data: {};
@@ -569,6 +588,7 @@ export declare const EzDynamicForm: ({
     formRef: any;
     }, {}, {}, {}, {
     items: FormItemConfig_2[];
+    groups: FormGroupConfig_2[];
     cols: number;
     gutter: number;
     }>;
@@ -590,6 +610,7 @@ formRef: any;
 "update:modelValue": (value: FormData_3) => any;
 }, string, {
 items: FormItemConfig_2[];
+groups: FormGroupConfig_2[];
 cols: number;
 gutter: number;
 }, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & VNodeProps & AllowedComponentProps & ComponentCustomProps & (new () => {
@@ -1475,6 +1496,44 @@ export declare type FormConditionFn = (formData: FormData_2) => boolean;
 declare type FormData_2 = Record<string, any>;
 export { FormData_2 as FormData }
 
+/**
+ * 表单分组配置
+ */
+export declare interface FormGroupConfig {
+    /** 分组唯一标识（用于 key、插槽名） */
+    name?: string;
+    /** 分组标题 */
+    title?: string;
+    /** 分组描述 */
+    description?: string;
+    /** 分组下的表单项 */
+    items: FormItemConfig[];
+    /** 分组内栅格列数（不传则继承全局 cols） */
+    cols?: number;
+    /** 分组内栅格间距（不传则继承全局 gutter） */
+    gutter?: number;
+    /** 是否隐藏分组 */
+    hidden?: boolean;
+    /** 分组显示条件 */
+    show?: FormConditionFn;
+    /** 分组容器 class */
+    className?: string;
+    /** 分组容器 style */
+    style?: string | Record<string, any>;
+    /** 分组头部 class */
+    headerClassName?: string;
+    /** 分组头部 style */
+    headerStyle?: string | Record<string, any>;
+    /** 分组主体 class */
+    bodyClassName?: string;
+    /** 分组主体 style */
+    bodyStyle?: string | Record<string, any>;
+    /** 自定义分组头插槽名 */
+    headerSlot?: string;
+    /** 自定义分组内容插槽名 */
+    slot?: string;
+}
+
 /**
  * 表单项配置
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maxtan/ez-ui",
   "type": "module",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "一个基于element-plus的拓展组件库",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -23,7 +23,7 @@
     "vue",
     "element-plus"
   ],
-  "author": "MaxTan<peng.tan0814@sinocare.com>",
+  "author": "MaxTan<maxtan330@163.com>",
   "homepage": "https://ezui.cc",
   "license": "MIT",
   "scripts": {