@iswangh/element-plus-kit-form 0.1.4 → 0.2.1

package/README.md

@@ -24,13 +24,13 @@ const formItems: FormItems = [
   {
     prop: 'username',
     label: '用户名',
-    comp: 'input',
+    compType: 'input',
   },
   {
     prop: 'email',
     label: '邮箱',
-    comp: 'input',
-    compAttrs: {
+    compType: 'input',
+    compProps: {
       type: 'email',
     },
   },
@@ -77,7 +77,7 @@ import '@iswangh/element-plus-kit-form/style.css'
 | --- | --- | --- | --- |
 | model | 表单数据对象 | `Record<string, any>` | `{}` |
 | formItems | 表单项配置数组 | `FormItems` | `[]` |
-| rowAttrs | 行布局属性（ElRow 属性） | `RowAttrs` | `{}` |
+| rowProps | 行布局属性（ElRow 属性） | `RowProps` | `{}` |
 | actionConfig | 操作按钮配置 | `ActionConfig` | `{}` |
 
 **继承 Element Plus Form 属性**：组件继承所有 `ElForm` 的属性，如 `rules`、`labelPosition`、`size` 等。
@@ -87,7 +87,7 @@ import '@iswangh/element-plus-kit-form/style.css'
 | 事件名 | 说明 | 参数 |
 | --- | --- | --- |
 | validate | 表单项验证事件 | `(prop: FormItemProp, isValid: boolean, message: string)` |
-| change | 表单项值变化事件 | `(extendedParams: EventExtendedParams, value: any)` |
+| change | 表单项值变化事件 | `(extendedParams: FormItemEventExtendedParams, value: any)` |
 | action | 操作按钮点击事件 | `(eventName: string)` |
 | search | 搜索按钮点击事件 | - |
 | reset | 重置按钮点击事件 | - |
@@ -95,15 +95,54 @@ import '@iswangh/element-plus-kit-form/style.css'
 | cancel | 取消按钮点击事件 | - |
 | expand | 展开状态变化事件 | `(value: boolean)` |
 
+**可配置化事件**：
+- 除了在 `WForm` 标签上监听事件，还可以在 `formItems` 配置对象的 `compProps` 中定义事件处理器
+- 事件名以 `on` 开头（如 `onBlur`、`onFocus`、`onInput` 等），直接接收原始事件参数（不需要 `extendedParams`）
+- 可配置化事件优先级高于 `WForm` 标签上的事件，如果同时定义了可配置化事件和标签事件，会优先使用可配置化事件
+- 示例：
+  ```typescript
+  {
+    prop: 'username',
+    compType: 'input',
+    compProps: {
+      onBlur: (event: FocusEvent) => {
+        console.log('onBlur 事件:', event)
+      },
+    },
+  }
+  ```
+
 ### Slots
 
 | 插槽名 | 说明 | 作用域参数 |
 | --- | --- | --- |
-| `{prop}` | 自定义组件插槽，当 `comp` 为 `custom` 时使用 | `FormItemSlotScope` |
+| `{prop}` | 自定义组件插槽，当 `compType` 为 `custom` 时使用 | `FormItemSlotScope` |
 | `form-item-{prop}` | 表单项插槽，用于自定义表单项内容 | `FormItemSlotScope` |
 | `{prop}-{slotName}` | 动态组件插槽，如 `username-prefix`、`email-suffix` | `FormItemSlotScope` |
 | `expand-toggle` | 展开/折叠按钮插槽，用于自定义按钮 | `{ expanded: boolean, toggle: (value?: boolean) => void }` |
 
+**可配置化插槽**：
+- 除了使用模板插槽，还可以在 `formItems` 配置对象中直接定义插槽
+- **FormItem 插槽**：在配置对象的 `slots` 字段中定义，用于自定义 `el-form-item` 的插槽（如 `label`、`error` 等）
+- **动态组件插槽**：在 `compProps.slots` 字段中定义，用于自定义动态组件的插槽（如 `prefix`、`suffix` 等）
+- 可配置化插槽优先级高于模板插槽，如果同时定义了可配置化插槽和模板插槽，会优先使用可配置化插槽
+- 插槽函数使用 `h()` 函数创建 VNode，接收 `FormItemSlotScope` 参数
+- 示例：
+  ```typescript
+  {
+    prop: 'username',
+    compType: 'input',
+    slots: {
+      label: props => h('span', {}, props.formItem.label),
+    },
+    compProps: {
+      slots: {
+        prefix: () => h(User),
+      },
+    },
+  }
+  ```
+
 ### FormItem 配置
 
 #### 基础配置
@@ -112,15 +151,15 @@ import '@iswangh/element-plus-kit-form/style.css'
 interface FormItem<C extends FormItemComp = FormItemComp> {
   prop: string                    // 表单字段名（必填）
   label: string                   // 标签文本
-  comp: FormItemComp              // 组件类型（必填）
-  compAttrs?: FormItemCompAttrs<C> // 组件属性配置
-  // 对于支持 options 的组件（如 select、cascader、radio、checkbox 等），compAttrs.options 支持三种模式：
+  compType: FormItemComp              // 组件类型（必填）
+  compProps?: FormItemCompProps<C> // 组件属性配置
+  // 对于支持 options 的组件（如 select、cascader、radio、checkbox 等），compProps.options 支持三种模式：
   // 1. 静态数组：options: [{ label: '选项1', value: '1' }]
   // 2. 函数模式：options: (formData) => [{ label: '选项1', value: '1' }]
   // 3. 对象模式：options: { loader: (formData) => [...], deps: ['field1'], immediate: true }
   vIf?: boolean | ((data?: any) => boolean)  // 条件渲染（v-if）
   vShow?: boolean | ((data?: any) => boolean) // 显示/隐藏（v-show）
-  colAttrs?: ColAttrs             // 列布局属性（ElCol 属性）
+  colProps?: ColProps             // 列布局属性（ElCol 属性）
   // ... 其他 ElFormItem 属性
 }
 ```
@@ -159,8 +198,8 @@ const formItems: FormItems = [
   {
     prop: 'username',
     label: '用户名',
-    comp: 'input',
-    compAttrs: {
+    compType: 'input',
+    compProps: {
       placeholder: '请输入用户名',
       clearable: true,
     },
@@ -171,8 +210,8 @@ const formItems: FormItems = [
   {
     prop: 'age',
     label: '年龄',
-    comp: 'input-number',
-    compAttrs: {
+    compType: 'input-number',
+    compProps: {
       min: 0,
       max: 120,
       step: 1,
@@ -183,8 +222,8 @@ const formItems: FormItems = [
   {
     prop: 'gender',
     label: '性别',
-    comp: 'select',
-    compAttrs: {
+    compType: 'select',
+    compProps: {
       options: [
         { label: '男', value: 'male' },
         { label: '女', value: 'female' },
@@ -253,12 +292,12 @@ const formItems: FormItems = [
   {
     prop: 'username',
     label: '用户名',
-    comp: 'input',
+    compType: 'input',
   },
   {
     prop: 'email',
     label: '邮箱',
-    comp: 'input',
+    compType: 'input',
     // 只有当用户名存在时才显示邮箱字段
     vIf: (data) => !!data?.username,
   },
@@ -267,7 +306,7 @@ const formItems: FormItems = [
 
 ### 自定义插槽
 
-使用插槽自定义表单项内容：
+使用模板插槽自定义表单项内容：
 
 ```vue
 <template>
@@ -279,6 +318,39 @@ const formItems: FormItems = [
 </template>
 ```
 
+### 可配置化插槽
+
+除了使用模板插槽，还可以在 `formItems` 配置对象中直接定义插槽：
+
+```typescript
+import { h } from 'vue'
+import { User } from '@element-plus/icons-vue'
+
+const formItems: FormItems = [
+  {
+    prop: 'username',
+    label: '用户名',
+    compType: 'input',
+    // FormItem 插槽配置
+    slots: {
+      label: props => h('span', { class: 'flex items-center gap-1' }, [
+        h('span', props.formItem.label),
+        h('span', { class: 'text-red-500' }, '*'),
+      ]),
+    },
+    // 动态组件插槽配置
+    compProps: {
+      placeholder: '请输入用户名',
+      slots: {
+        prefix: () => h(User, { class: 'text-gray-400' }),
+      },
+    },
+  },
+]
+```
+
+**优先级**：可配置化插槽优先级高于模板插槽，如果同时定义了可配置化插槽和模板插槽，会优先使用可配置化插槽。
+
 ### 表单验证
 
 ```typescript
@@ -286,7 +358,7 @@ const formItems: FormItems = [
   {
     prop: 'email',
     label: '邮箱',
-    comp: 'input',
+    compType: 'input',
     rules: [
       { required: true, message: '请输入邮箱', trigger: 'blur' },
       { type: 'email', message: '请输入正确的邮箱格式', trigger: 'blur' },
@@ -297,6 +369,8 @@ const formItems: FormItems = [
 
 ### 监听事件
 
+在 `WForm` 标签上监听事件：
+
 ```vue
 <template>
   <WForm
@@ -308,7 +382,7 @@ const formItems: FormItems = [
 </template>
 
 <script setup lang="ts">
-const onChange = (extendedParams: EventExtendedParams, value: any) => {
+const onChange = (extendedParams: FormItemEventExtendedParams, value: any) => {
   console.log('字段变化:', extendedParams.prop, value)
 }
 
@@ -318,6 +392,32 @@ const onSubmit = () => {
 </script>
 ```
 
+### 可配置化事件
+
+除了在 `WForm` 标签上监听事件，还可以在 `formItems` 配置对象中直接定义事件处理器：
+
+```typescript
+const formItems: FormItems = [
+  {
+    prop: 'username',
+    label: '用户名',
+    compType: 'input',
+    compProps: {
+      placeholder: '请输入用户名',
+      // 动态组件的事件在 compProps 中定义
+      onBlur: (event: FocusEvent) => {
+        console.log('onBlur 事件:', event)
+      },
+      onFocus: (event: FocusEvent) => {
+        console.log('onFocus 事件:', event)
+      },
+    },
+  },
+]
+```
+
+**优先级**：可配置化事件优先级高于 `WForm` 标签上的事件，如果同时定义了可配置化事件和标签事件，会优先使用可配置化事件。
+
 ### 展开/折叠功能
 
 表单支持展开/折叠功能，可以控制表单项的显示和隐藏，适用于字段较多的表单场景。

package/dist/FormAction.vue.d.ts

@@ -1,9 +1,9 @@
 import { Slot } from 'vue';
-import { ActionConfig } from './types';
+import { FormActionConfig } from './types';
 interface Props {
     inline?: boolean;
     actionSlot?: Slot;
-    config?: ActionConfig;
+    config?: FormActionConfig;
     /** 展开/折叠状态（仅在 buttons 包含 'expand' 时有效） */
     expanded?: boolean;
     /** 是否启用鼠标悬停自动展开 */
@@ -43,7 +43,7 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
 }>, {
     expanded: boolean;
     inline: boolean;
-    config: ActionConfig;
+    config: FormActionConfig;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;

package/dist/FormAction.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormAction.vue.d.ts","sourceRoot":"","sources":["../src/FormAction.vue"],"names":[],"mappings":"AACA;AAkKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAA0B,MAAM,SAAS,CAAA;AAMnE,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,MAAM,CAAC,EAAE,YAAY,CAAA;IACrB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mBAAmB;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAwGD,iBAAS,cAAc;WAsHT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAoBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;mBArPiB,MAAM;eAAS,GAAG;;;;;;;;mBAAlB,MAAM;eAAS,GAAG;;;cAV3C,OAAO;YAJT,OAAO;YAEP,YAAY;4EAwQrB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAC7C,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAC,CAAC,GAC5C,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AACF,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AACjE,KAAK,uBAAuB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9D;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE;CACzD,CAAC;AACF,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC;AACF,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"FormAction.vue.d.ts","sourceRoot":"","sources":["../src/FormAction.vue"],"names":[],"mappings":"AACA;AAkKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAwB,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAMrE,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,MAAM,CAAC,EAAE,gBAAgB,CAAA;IACzB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,mBAAmB;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,8BAA8B;IAC9B,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAwGD,iBAAS,cAAc;WAsHT,OAAO,IAA6B;;yBAVpB,GAAG;;;;EAehC;AAoBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;mBArPiB,MAAM;eAAS,GAAG;;;;;;;;mBAAlB,MAAM;eAAS,GAAG;;;cAV3C,OAAO;YAJT,OAAO;YAEP,gBAAgB;4EAwQzB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAC7C,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAC,CAAC,GAC5C,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AACF,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AACjE,KAAK,uBAAuB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9D;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE;CACzD,CAAC;AACF,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC;AACF,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/dist/FormItem.vue.d.ts

@@ -6,8 +6,8 @@ interface ProcessedSlot {
     slotFn: Slot;
 }
 interface FormSlots {
-    formItemSlots: ProcessedSlot[];
-    dynamicComponentSlots: Map<string, ProcessedSlot[]>;
+    formItemSlots: Map<string, ProcessedSlot[]>;
+    dynamicCompSlots: Map<string, ProcessedSlot[]>;
 }
 interface Props {
     formItem: FormItem;
@@ -20,34 +20,22 @@ type __VLS_Props = Props;
 type __VLS_PublicProps = {
     modelValue?: any;
 } & __VLS_Props;
-declare function __VLS_template(): {
-    attrs: Partial<{}>;
-    slots: Partial<Record<string, (_: {
-        value: unknown;
-        form: Record<string, any>;
-        formItem: FormItem<import('./types').FormItemComp>;
-    }) => any>>;
-    refs: {};
-    rootEl: any;
-};
-type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
-declare const __VLS_component: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
+declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
     formData: () => {};
     formSlots: () => {
-        formItemSlots: never[];
-        dynamicComponentSlots: Map<any, any>;
+        formItemSlots: Map<any, any>;
+        dynamicCompSlots: Map<any, any>;
     };
 }>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<__VLS_PublicProps>, {
     formData: () => {};
     formSlots: () => {
-        formItemSlots: never[];
-        dynamicComponentSlots: Map<any, any>;
+        formItemSlots: Map<any, any>;
+        dynamicCompSlots: Map<any, any>;
     };
 }>>> & Readonly<{}>, {
     formData: Record<string, any>;
     formSlots: FormSlots;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
 export default _default;
 type __VLS_WithDefaults<P, D> = {
     [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
@@ -63,11 +51,6 @@ type __VLS_TypePropsToOption<T> = {
         required: true;
     };
 };
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};
 type __VLS_PrettifyLocal<T> = {
     [K in keyof T]: T[K];
 } & {};

package/dist/FormItem.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormItem.vue.d.ts","sourceRoot":"","sources":["../src/FormItem.vue"],"names":[],"mappings":"AACA;AAgYA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAuB,QAAQ,EAAgC,MAAM,SAAS,CAAA;AAO1F,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,IAAI,CAAA;CACb;AAED,UAAU,SAAS;IACjB,aAAa,EAAE,aAAa,EAAE,CAAA;IAC9B,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;CACpD;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAA;IAC1D,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAQD,KAAK,WAAW,GAAG,KAAK,CAAC;AAwUzB,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WAuGT,OAAO,IAA6B;;;;;UAXqC,GAAG;;;EAgBzF;AAoBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;cA3dR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;eAElB,SAAS;4EAmerB,CAAC;wBACkB,uBAAuB,CAAC,OAAO,eAAe,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;AAAnG,wBAAoG;AAEpG,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAC7C,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAC,CAAC,GAC5C,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AACF,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AACjE,KAAK,uBAAuB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9D;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE;CACzD,CAAC;AACF,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG;IACxC,QAAO;QACN,MAAM,EAAE,CAAC,CAAC;KAEV,CAAA;CACD,CAAC;AACF,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}
+{"version":3,"file":"FormItem.vue.d.ts","sourceRoot":"","sources":["../src/FormItem.vue"],"names":[],"mappings":"AACA;AAkaA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAA6D,MAAM,SAAS,CAAA;AAOlG,UAAU,aAAa;IACrB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,IAAI,CAAA;CACb;AAED,UAAU,SAAS;IACjB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;IAC3C,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;CAC/C;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC9B,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC,CAAA;IAC1D,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAQD,KAAK,WAAW,GAAG,KAAK,CAAC;AAkWzB,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,WAAW,CAAC;;;;;;;;;;;;;;cA/WH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;eAElB,SAAS;;AAwfvB,wBAUG;AAEH,KAAK,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI;KAC9B,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,MAAM,CAAC,GAC7C,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;KAAC,CAAC,GAC5C,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AACF,KAAK,sBAAsB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;AACjE,KAAK,uBAAuB,CAAC,CAAC,IAAI;KAChC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9D;QAAE,IAAI,EAAE,OAAO,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAAC,QAAQ,EAAE,IAAI,CAAA;KAAE;CACzD,CAAC;AACF,KAAK,mBAAmB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAG,GAAG,EAAE,CAAC"}

package/dist/composables/index.d.ts

@@ -1,3 +1,4 @@
 export * from './useAutoExpandOnHover';
 export * from './useChangeEventState';
+export * from './useClearState';
 //# sourceMappingURL=index.d.ts.map

package/dist/composables/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/composables/useChangeEventState.d.ts

@@ -3,33 +3,11 @@
  * 用于区分不同类型的值变化，防止重复触发 change 事件
  */
 export declare function useChangeEventState(): {
-    /** 是否正在清理 */
-    readonly isClearing: boolean;
     /** 是否用户交互 */
-    readonly isUserInteraction: boolean;
-    /**
-     * 开始清理操作
-     * @param value - 清理前的值
-     */
-    startClearing(value: any): void;
-    /**
-     * 结束清理操作（在 nextTick 中调用）
-     */
-    endClearing(): void;
-    /**
-     * 开始用户交互
-     */
-    startUserInteraction(): void;
-    /**
-     * 结束用户交互（在 nextTick 中调用）
-     */
-    endUserInteraction(): void;
-    /**
-     * 判断是否是清理操作
-     * @param oldValue - 旧值
-     * @param newValue - 新值
-     * @param isEmpty - 检查值是否为空的函数
-     */
-    isClearingOperation(oldValue: any, newValue: any, isEmpty: (val: any) => boolean): boolean;
+    readonly isUser: boolean;
+    /** 开始用户交互 */
+    start(): void;
+    /** 结束用户交互（在 nextTick 中调用） */
+    end(): void;
 };
 //# sourceMappingURL=useChangeEventState.d.ts.map

package/dist/composables/useChangeEventState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChangeEventState.d.ts","sourceRoot":"","sources":["../../src/composables/useChangeEventState.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,wBAAgB,mBAAmB;IAO/B,aAAa;;IAKb,aAAa;;IAKb;;;OAGG;yBACkB,GAAG;IAMxB;;OAEG;;IAOH;;OAEG;;IAKH;;OAEG;;IAKH;;;;;OAKG;kCAC2B,GAAG,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,GAAG,OAAO;EAgB7F"}
+{"version":3,"file":"useChangeEventState.d.ts","sourceRoot":"","sources":["../../src/composables/useChangeEventState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,mBAAmB;IAI/B,aAAa;;IAKb,aAAa;;IAKb,6BAA6B;;EAKhC"}

package/dist/composables/useClearState.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 清理状态管理组合式函数
+ * 用于管理依赖变更时的清理操作，支持用户在 change 事件中设置默认值
+ */
+export declare function useClearState(): {
+    /** 是否正在处理依赖变更 */
+    readonly changing: boolean;
+    /** 用户是否在 change 事件中设置了值 */
+    readonly hasUserValue: boolean;
+    /** 开始依赖变更处理 */
+    start(): void;
+    /** 结束依赖变更处理 */
+    end(): void;
+    /** 标记用户在 change 事件中设置了值 */
+    markValue(): void;
+};
+//# sourceMappingURL=useClearState.d.ts.map

package/dist/composables/useClearState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClearState.d.ts","sourceRoot":"","sources":["../../src/composables/useClearState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,aAAa;IAKzB,iBAAiB;;IAKjB,2BAA2B;;IAK3B,eAAe;;IAMf,eAAe;;IAMf,2BAA2B;;EAK9B"}

package/dist/config/action.d.ts

@@ -1,25 +1,30 @@
-import { ActionConfig, ActionConfigButtonItem } from '../types';
+import { FormActionButtonItem, FormActionConfig } from '../types';
 /**
  * 表单动作按钮默认配置
  */
-export declare const DEFAULT_FORM_ACTION_BUTTONS: Record<string, Partial<Omit<ActionConfigButtonItem, 'eventName'>>>;
-/**
- * 展开/收起功能默认滚动选项
- */
-export declare const DEFAULT_EXPAND_SCROLL_OPTIONS: ScrollIntoViewOptions;
+export declare const DEFAULT_FORM_ACTION_BUTTONS: Record<string, Partial<Omit<FormActionButtonItem, 'eventName'>>>;
 /**
  * 表单动作默认配置
  */
-export declare const ACTION_DEFAULT_CONFIG: {
-    getDefaults(inline?: boolean, actionConfig?: ActionConfig): {
-        vIf: boolean | ((data?: any) => boolean);
-        vShow: boolean | ((data?: any) => boolean);
-        buttons: string[] | import('../types').ActionConfigButtons[];
-        expand?: import('..').ExpandRule;
+export declare const FORM_ACTION_DEFAULT_CONFIG: {
+    /**
+     * 获取动作默认属性
+     */
+    getDefaults(inline?: boolean, actionConfig?: FormActionConfig): {
+        vIf: import('../types').Condition;
+        vShow: import('../types').Condition;
+        buttons: string[] | import('../types').FormActionButtons[];
+        expand?: import('../types').FormExpandRule;
         autoExpandOnError: boolean;
     };
-    generateActionButtons(inline?: boolean): string[];
-    buildActionAttrs(inline?: boolean): {
+    /**
+     * 获取动作按钮列表
+     */
+    getActionButtons(inline?: boolean): string[];
+    /**
+     * 构建动作属性
+     */
+    buildActionProps(inline?: boolean): {
         buttons: string[];
         vIf: boolean | undefined;
         autoExpandOnError: boolean;

package/dist/config/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/config/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAIpE;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC,CAM1G,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B,uBAAyB,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,qBAAqB;yBACX,OAAO,iBAAiB,YAAY;6BAoB4gB,CAAC;+BAAmF,CAAC;;;;;mCAZ3nB,OAAO;8BAGZ,OAAO;;;;;;CAQlC,CAAA"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/config/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAGtE;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAAC,CAMxG,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,0BAA0B;IACrC;;OAEG;yBACkB,OAAO,iBAAiB,gBAAgB;;;;;;;IAI7D;;OAEG;8BACuB,OAAO;IAGjC;;OAEG;8BACuB,OAAO;;;;;;CAQlC,CAAA"}

package/dist/config/comp.d.ts

@@ -0,0 +1,44 @@
+import { FormItem } from '../types';
+/**
+ * 拓展的组件映射
+ * 导出以便在类型文件中使用 typeof 提取类型
+ */
+export declare const EXPAND_COMP_MAP: {
+    readonly custom: "div";
+};
+/**
+ * 表单组件类型映射配置
+ *
+ * 使用显式类型注解避免类型推断超出编译器序列化限制
+ * 类型提示通过 keyof 提取键名，不依赖完整的类型定义
+ *
+ * 注意：虽然这里使用 Record<string, any>，但实际的类型定义
+ * 通过类型工具在 comp.d.ts 中从 EL_COMP_MAP 和 EXPAND_COMP_MAP 提取
+ */
+export declare const FORM_ITEM_COMP_MAP: Record<string, any>;
+/**
+ * 动态组件默认配置
+ */
+export declare const COMP_DEFAULT_CONFIG: {
+    /**
+     * 获取组件默认属性
+     */
+    getDefaults(formItem: FormItem): {
+        [x: string]: any;
+        options?: any[] | import('../types').OptionsLoader | import('../types').OptionsConfig | undefined;
+        slots?: import('../types').CompSlotsConfig<import('../types').FormItemComp> | undefined;
+    };
+    /**
+     * 判断组件类型
+     */
+    getCompType(comp: string): "input" | "select" | "picker" | "other";
+    /**
+     * 动态生成 placeholder
+     */
+    generatePlaceholder(formItem: FormItem, type: string): string;
+    /**
+     * 构建组件属性
+     */
+    buildCompProps(formItem: FormItem, type: string): Record<string, any>;
+};
+//# sourceMappingURL=comp.d.ts.map

package/dist/config/comp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comp.d.ts","sourceRoot":"","sources":["../../src/config/comp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;GAGG;AACH,eAAO,MAAM,eAAe;;CAA6B,CAAA;AA+BzD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAwD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAE1G;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B;;OAEG;0BACmB,QAAQ;;;;;IAe9B;;OAEG;sBACe,MAAM;IAoBxB;;OAEG;kCAC2B,QAAQ,QAAQ,MAAM;IAkBpD;;OAEG;6BACsB,QAAQ,QAAQ,MAAM;CAYhD,CAAA"}

package/dist/config/form-item.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 需要从 FormItem 中排除的自定义属性键名
+ * 这些属性不会传递给 el-form-item 组件
+ */
+export declare const FORM_ITEM_EXCLUDED_KEYS: readonly ["compType", "compProps", "slots", "vIf", "vShow"];
+//# sourceMappingURL=form-item.d.ts.map

package/dist/config/form-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-item.d.ts","sourceRoot":"","sources":["../../src/config/form-item.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,6DAA8D,CAAA"}

package/dist/config/form.d.ts

@@ -2,5 +2,5 @@ import { FormProps } from 'element-plus';
 /**
  * 表单属性默认配置
  */
-export declare const DEFAULT_FORM_ATTRS: Partial<FormProps>;
+export declare const DEFAULT_FORM_PROPS: Partial<FormProps>;
 //# sourceMappingURL=form.d.ts.map

package/dist/config/index.d.ts

@@ -1,5 +1,6 @@
 export * from './action';
-export * from './component';
+export * from './comp';
 export * from './form';
+export * from './form-item';
 export * from './scroll';
 //# sourceMappingURL=index.d.ts.map

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
 export { default } from './Form.vue';
 export { default as WForm } from './Form.vue';
-export type { ActionConfig, ActionConfigButtonItem, Arrayable, ColAttrs, ElFormAttrs, EventExtendedParams, ExpandRule, FormItem, FormItemComp, FormItemCompAttrs, FormItems, FormItemSlotScope, RowAttrs, } from './types';
+export type { FormActionConfig, FormItemEventExtendedParams, FormItems, FormItemSlotScope } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,2CAA2C,CAAA;AAClD,OAAO,gDAAgD,CAAA;AAEvD,OAAO,0CAA0C,CAAA;AACjD,OAAO,0CAA0C,CAAA;AAEjD,OAAO,6CAA6C,CAAA;AAEpD,OAAO,2CAA2C,CAAA;AAKlD,OAAO,4CAA4C,CAAA;AACnD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,gDAAgD,CAAA;AACvD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,8CAA8C,CAAA;AAErD,OAAO,6CAA6C,CAAA;AACpD,OAAO,gDAAgD,CAAA;AACvD,OAAO,+CAA+C,CAAA;AACtD,OAAO,kDAAkD,CAAA;AAEzD,OAAO,kDAAkD,CAAA;AACzD,OAAO,wDAAwD,CAAA;AAC/D,OAAO,kDAAkD,CAAA;AACzD,OAAO,kDAAkD,CAAA;AAEzD,OAAO,qDAAqD,CAAA;AAC5D,OAAO,kDAAkD,CAAA;AACzD,OAAO,6CAA6C,CAAA;AACpD,OAAO,6CAA6C,CAAA;AACpD,OAAO,2CAA2C,CAAA;AAClD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,yDAAyD,CAAA;AAChE,OAAO,+CAA+C,CAAA;AAEtD,OAAO,oBAAoB,CAAA;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAE7C,YAAY,EACV,YAAY,EACZ,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,QAAQ,GACT,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,2CAA2C,CAAA;AAClD,OAAO,gDAAgD,CAAA;AAEvD,OAAO,0CAA0C,CAAA;AACjD,OAAO,0CAA0C,CAAA;AAEjD,OAAO,6CAA6C,CAAA;AAEpD,OAAO,2CAA2C,CAAA;AAKlD,OAAO,4CAA4C,CAAA;AACnD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,gDAAgD,CAAA;AACvD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,8CAA8C,CAAA;AAErD,OAAO,6CAA6C,CAAA;AACpD,OAAO,gDAAgD,CAAA;AACvD,OAAO,+CAA+C,CAAA;AACtD,OAAO,kDAAkD,CAAA;AAEzD,OAAO,kDAAkD,CAAA;AACzD,OAAO,wDAAwD,CAAA;AAC/D,OAAO,kDAAkD,CAAA;AACzD,OAAO,kDAAkD,CAAA;AAEzD,OAAO,qDAAqD,CAAA;AAC5D,OAAO,kDAAkD,CAAA;AACzD,OAAO,6CAA6C,CAAA;AACpD,OAAO,6CAA6C,CAAA;AACpD,OAAO,2CAA2C,CAAA;AAClD,OAAO,mDAAmD,CAAA;AAC1D,OAAO,yDAAyD,CAAA;AAChE,OAAO,+CAA+C,CAAA;AAEtD,OAAO,oBAAoB,CAAA;AAE3B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAE7C,YAAY,EAAE,gBAAgB,EAAE,2BAA2B,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA"}