@iswangh/element-plus-kit-form 0.1.3 → 0.2.0

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,19 +87,22 @@ 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 | 重置按钮点击事件 | - |
 | submit | 提交按钮点击事件 | - |
 | cancel | 取消按钮点击事件 | - |
+| expand | 展开状态变化事件 | `(value: boolean)` |
 
 ### Slots
 
 | 插槽名 | 说明 | 作用域参数 |
 | --- | --- | --- |
+| `{prop}` | 自定义组件插槽，当 `compType` 为 `custom` 时使用 | `FormItemSlotScope` |
 | `form-item-{prop}` | 表单项插槽，用于自定义表单项内容 | `FormItemSlotScope` |
 | `{prop}-{slotName}` | 动态组件插槽，如 `username-prefix`、`email-suffix` | `FormItemSlotScope` |
+| `expand-toggle` | 展开/折叠按钮插槽，用于自定义按钮 | `{ expanded: boolean, toggle: (value?: boolean) => void }` |
 
 ### FormItem 配置
 
@@ -109,11 +112,15 @@ import '@iswangh/element-plus-kit-form/style.css'
 interface FormItem<C extends FormItemComp = FormItemComp> {
   prop: string                    // 表单字段名（必填）
   label: string                   // 标签文本
-  comp: FormItemComp              // 组件类型（必填）
-  compAttrs?: FormItemCompAttrs<C> // 组件属性配置
+  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 属性
 }
 ```
@@ -152,8 +159,8 @@ const formItems: FormItems = [
   {
     prop: 'username',
     label: '用户名',
-    comp: 'input',
-    compAttrs: {
+    compType: 'input',
+    compProps: {
       placeholder: '请输入用户名',
       clearable: true,
     },
@@ -164,8 +171,8 @@ const formItems: FormItems = [
   {
     prop: 'age',
     label: '年龄',
-    comp: 'input-number',
-    compAttrs: {
+    compType: 'input-number',
+    compProps: {
       min: 0,
       max: 120,
       step: 1,
@@ -176,8 +183,8 @@ const formItems: FormItems = [
   {
     prop: 'gender',
     label: '性别',
-    comp: 'select',
-    compAttrs: {
+    compType: 'select',
+    compProps: {
       options: [
         { label: '男', value: 'male' },
         { label: '女', value: 'female' },
@@ -196,6 +203,7 @@ interface ActionConfig {
   vIf?: boolean | ((data?: any) => boolean)  // 是否显示操作区域
   vShow?: boolean | ((data?: any) => boolean) // 显示/隐藏操作区域
   buttons?: ActionConfigButtons[]            // 按钮列表
+  expand?: ExpandRule                        // 默认展开规则（仅在 buttons 包含 'expand' 时生效）
 }
 ```
 
@@ -207,6 +215,7 @@ interface ActionConfig {
 - `'reset'` - 重置按钮
 - `'search'` - 搜索按钮
 - `'cancel'` - 取消按钮
+- `'expand'` - 展开/折叠按钮（仅在 `inline` 模式下可用）
 
 #### 自定义按钮
 
@@ -244,12 +253,12 @@ const formItems: FormItems = [
   {
     prop: 'username',
     label: '用户名',
-    comp: 'input',
+    compType: 'input',
   },
   {
     prop: 'email',
     label: '邮箱',
-    comp: 'input',
+    compType: 'input',
     // 只有当用户名存在时才显示邮箱字段
     vIf: (data) => !!data?.username,
   },
@@ -277,7 +286,7 @@ const formItems: FormItems = [
   {
     prop: 'email',
     label: '邮箱',
-    comp: 'input',
+    compType: 'input',
     rules: [
       { required: true, message: '请输入邮箱', trigger: 'blur' },
       { type: 'email', message: '请输入正确的邮箱格式', trigger: 'blur' },
@@ -299,7 +308,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)
 }
 
@@ -309,6 +318,130 @@ const onSubmit = () => {
 </script>
 ```
 
+### 展开/折叠功能
+
+表单支持展开/折叠功能，可以控制表单项的显示和隐藏，适用于字段较多的表单场景。
+
+**重要说明**：
+- 展开/折叠功能仅在 `inline` 模式下可用（`inline: true`）
+- 通过 `actionConfig.buttons` 包含 `'expand'` 来启用展开/折叠功能
+- 通过 `actionConfig.expand` 配置展开规则
+
+#### 基础用法
+
+```vue
+<template>
+  <WForm
+    :model="form"
+    :form-items="formItems"
+    inline
+    :action-config="{
+      buttons: ['expand', 'search', 'reset'],
+      expand: {
+        count: 3, // 默认展开前 3 个字段
+      },
+    }"
+  />
+</template>
+```
+
+#### 配置说明
+
+展开规则通过 `actionConfig.expand` 配置，支持三种配置方式：
+
+| 配置方式 | 说明 | 类型 | 示例 |
+| --- | --- | --- | --- |
+| `count` | 按字段数量展开（从第一个开始） | `{ count: number }` | `{ count: 3 }` |
+| `include` | 指定展示的字段（白名单，字段 prop 数组） | `{ include: string[] }` | `{ include: ['field1', 'field2'] }` |
+| `exclude` | 指定折叠的字段（黑名单，字段 prop 数组） | `{ exclude: string[] }` | `{ exclude: ['field3', 'field4'] }` |
+
+**配置优先级**：`exclude` > `include` > `count`
+
+#### 展开规则高级配置
+
+展开规则还支持以下高级配置：
+
+| 配置项 | 说明 | 类型 | 默认值 |
+| --- | --- | --- | --- |
+| `autoExpandOnHover` | 是否启用鼠标悬停自动展开功能 | `boolean` | `false` |
+| `scrollOnToggle` | 是否在展开/收起后自动滚动到表单中心 | `boolean` | `false` |
+| `scrollIntoViewOptions` | 自定义滚动选项（仅在 `scrollOnToggle` 为 true 时生效） | `ScrollIntoViewOptions` | `{ behavior: 'smooth', block: 'center', inline: 'nearest' }` |
+
+**使用示例**：
+
+```typescript
+const actionConfig: ActionConfig = {
+  buttons: ['expand', 'search', 'reset'],
+  expand: {
+    count: 3, // 默认展开前 3 个字段
+    autoExpandOnHover: true, // 鼠标悬停时自动展开
+    scrollOnToggle: true, // 展开/收起后自动滚动
+  },
+}
+```
+
+#### 受控模式
+
+使用 `v-model:expanded` 实现受控模式：
+
+```vue
+<template>
+  <WForm
+    v-model:expanded="isExpanded"
+    :model="form"
+    :form-items="formItems"
+    inline
+    :action-config="{
+      buttons: ['expand', 'search', 'reset'],
+      expand: { count: 3 },
+    }"
+  />
+  <el-button @click="formRef?.toggleExpand(true)">展开</el-button>
+  <el-button @click="formRef?.toggleExpand(false)">折叠</el-button>
+</template>
+
+<script setup lang="ts">
+const isExpanded = ref(false)
+const formRef = ref<InstanceType<typeof WForm>>()
+
+// 或者使用组件暴露的方法
+function toggle() {
+  formRef.value?.toggleExpand() // 切换
+  formRef.value?.toggleExpand(true) // 展开
+  formRef.value?.toggleExpand(false) // 折叠
+}
+
+// 或者直接使用 v-model:expanded
+function toggleExpanded() {
+  isExpanded.value = !isExpanded.value
+}
+</script>
+```
+
+#### 自定义按钮
+
+使用 `expand-toggle` 插槽自定义展开/折叠按钮：
+
+```vue
+<template>
+  <WForm
+    :model="form"
+    :form-items="formItems"
+    inline
+    :action-config="{
+      buttons: ['expand', 'search', 'reset'],
+      expand: { count: 3 },
+    }"
+  >
+    <template #expand-toggle="{ expanded, toggle }">
+      <el-button type="success" :icon="expanded ? ArrowUp : ArrowDown" @click="toggle()">
+        {{ expanded ? '收起高级搜索' : '展开高级搜索' }}
+      </el-button>
+    </template>
+  </WForm>
+</template>
+```
+
 ## 🔗 相关链接
 
 - [主包文档](../kit/README.md)

package/dist/FormAction.vue.d.ts

@@ -1,13 +1,31 @@
 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;
+    /** 是否启用鼠标悬停自动展开 */
+    autoExpandOnHover?: boolean;
+    /** 鼠标移入事件处理函数（用于空白区域和展开图标） */
+    onMouseEnter?: () => void;
+    /** 鼠标移出事件处理函数（用于空白区域和展开图标） */
+    onMouseLeave?: () => void;
 }
-declare const _default: import('vue').DefineComponent<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        default?(_: {}): 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<Props>, {
     inline: boolean;
     config: () => {};
+    expanded: boolean;
 }>>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     action: (payload: {
         eventName: string;
@@ -16,15 +34,18 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
 }, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<__VLS_WithDefaults<__VLS_TypePropsToOption<Props>, {
     inline: boolean;
     config: () => {};
+    expanded: boolean;
 }>>> & Readonly<{
     onAction?: ((payload: {
         eventName: string;
         data?: any;
     }) => any) | undefined;
 }>, {
+    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;
 type __VLS_WithDefaults<P, D> = {
     [K in keyof Pick<P, keyof P>]: K extends keyof D ? __VLS_PrettifyLocal<P[K] & {
@@ -40,6 +61,11 @@ 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/FormAction.vue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormAction.vue.d.ts","sourceRoot":"","sources":["../src/FormAction.vue"],"names":[],"mappings":"AACA;AAsEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAE,YAAY,EAA0B,MAAM,SAAS,CAAA;AAKnE,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,IAAI,CAAA;IACjB,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;;;;;;mBAGqC,MAAM;eAAS,GAAG;;;;;;;mBAAlB,MAAM;eAAS,GAAG;;;YAN7C,OAAO;YAEP,YAAY;;AA+IvB,wBAOG;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"}
+{"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

@@ -8,6 +8,7 @@ interface ProcessedSlot {
 interface FormSlots {
     formItemSlots: ProcessedSlot[];
     dynamicComponentSlots: Map<string, ProcessedSlot[]>;
+    customComponentSlots: Map<string, ProcessedSlot[]>;
 }
 interface Props {
     formItem: FormItem;
@@ -20,34 +21,24 @@ 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>;
+        customComponentSlots: 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>;
+        customComponentSlots: 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 +54,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;AA8XA,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;AAsUzB,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;;;;;;;;;;;;;cAzdR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;eAElB,SAAS;4EAierB,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;AAsaA,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,aAAa,EAAE,CAAA;IAC9B,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;IACnD,oBAAoB,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC,CAAA;CACnD;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;AAmWzB,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,WAAW,CAAC;;;;;;;;;;;;;;;;cAhXH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;eAElB,SAAS;;AAggBvB,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,2 +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,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/useAutoExpandOnHover.d.ts

@@ -0,0 +1,15 @@
+import { ComputedRef, Ref } from 'vue';
+/**
+ * 鼠标悬停自动展开组合式函数
+ *
+ * @param isExpanded - 展开/折叠状态
+ * @param autoExpandOnHover - 是否启用鼠标悬停自动展开
+ * @param onToggleExpanded - 切换展开/折叠状态的回调函数
+ * @returns 鼠标事件处理函数和记录手动操作状态的函数
+ */
+export declare function useAutoExpandOnHover(isExpanded: Ref<boolean>, autoExpandOnHover: ComputedRef<boolean> | Ref<boolean>, onToggleExpanded: (value: boolean) => void): {
+    onMouseEnter: () => void;
+    onMouseLeave: () => void;
+    recordManualToggle: () => void;
+};
+//# sourceMappingURL=useAutoExpandOnHover.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAutoExpandOnHover.d.ts","sourceRoot":"","sources":["../../src/composables/useAutoExpandOnHover.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAG3C;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,EACxB,iBAAiB,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,EACtD,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;;;;EAkF3C"}

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

@@ -0,0 +1,34 @@
+import { FormActionButtonItem, FormActionConfig } from '../types';
+/**
+ * 表单动作按钮默认配置
+ */
+export declare const DEFAULT_FORM_ACTION_BUTTONS: Record<string, Partial<Omit<FormActionButtonItem, 'eventName'>>>;
+/**
+ * 表单动作默认配置
+ */
+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;
+    };
+    /**
+     * 获取动作按钮列表
+     */
+    getActionButtons(inline?: boolean): string[];
+    /**
+     * 构建动作属性
+     */
+    buildActionProps(inline?: boolean): {
+        buttons: string[];
+        vIf: boolean | undefined;
+        autoExpandOnError: boolean;
+        vShow: boolean;
+    };
+};
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"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,48 @@
+import { FormItem } from '../types';
+/**
+ * 需要从 FormItem 中排除的自定义属性键名
+ * 这些属性不会传递给 el-form-item 组件
+ */
+export declare const FORM_ITEM_EXCLUDED_KEYS: readonly ["compType", "compProps", "vIf", "vShow"];
+/**
+ * 拓展的组件映射
+ * 导出以便在类型文件中使用 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;
+    };
+    /**
+     * 判断组件类型
+     */
+    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,uBAAuB,oDAAqD,CAAA;AAEzF;;;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.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../src/config/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAG7C;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAIf,OAAO,CAAC,SAAS,CAAC,CAAA"}