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

package/README.md

@@ -93,13 +93,16 @@ import '@iswangh/element-plus-kit-form/style.css'
 | reset | 重置按钮点击事件 | - |
 | submit | 提交按钮点击事件 | - |
 | cancel | 取消按钮点击事件 | - |
+| expand | 展开状态变化事件 | `(value: boolean)` |
 
 ### Slots
 
 | 插槽名 | 说明 | 作用域参数 |
 | --- | --- | --- |
+| `{prop}` | 自定义组件插槽，当 `comp` 为 `custom` 时使用 | `FormItemSlotScope` |
 | `form-item-{prop}` | 表单项插槽，用于自定义表单项内容 | `FormItemSlotScope` |
 | `{prop}-{slotName}` | 动态组件插槽，如 `username-prefix`、`email-suffix` | `FormItemSlotScope` |
+| `expand-toggle` | 展开/折叠按钮插槽，用于自定义按钮 | `{ expanded: boolean, toggle: (value?: boolean) => void }` |
 
 ### FormItem 配置
 
@@ -111,6 +114,10 @@ interface FormItem<C extends FormItemComp = FormItemComp> {
   label: string                   // 标签文本
   comp: FormItemComp              // 组件类型（必填）
   compAttrs?: FormItemCompAttrs<C> // 组件属性配置
+  // 对于支持 options 的组件（如 select、cascader、radio、checkbox 等），compAttrs.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 属性）
@@ -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` 模式下可用）
 
 #### 自定义按钮
 
@@ -293,22 +302,146 @@ const formItems: FormItems = [
   <WForm
     :model="form"
     :form-items="formItems"
-    @change="handleChange"
-    @submit="handleSubmit"
+    @change="onChange"
+    @submit="onSubmit"
   />
 </template>
 
 <script setup lang="ts">
-const handleChange = (extendedParams: EventExtendedParams, value: any) => {
+const onChange = (extendedParams: EventExtendedParams, value: any) => {
   console.log('字段变化:', extendedParams.prop, value)
 }
 
-const handleSubmit = () => {
+const onSubmit = () => {
   console.log('提交表单:', form.value)
 }
 </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

@@ -4,10 +4,28 @@ interface Props {
     inline?: boolean;
     actionSlot?: Slot;
     config?: ActionConfig;
+    /** 展开/折叠状态（仅在 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;
 }, {}, {}, {}, 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;AAkEA,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;;AA2IvB,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,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"}

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

@@ -1 +1 @@
-{"version":3,"file":"FormItem.vue.d.ts","sourceRoot":"","sources":["../src/FormItem.vue"],"names":[],"mappings":"AACA;AA+HA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,KAAK,CAAA;AAC/B,OAAO,KAAK,EAAuB,QAAQ,EAAE,MAAM,SAAS,CAAA;AAK5D,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;AAyEzB,KAAK,iBAAiB,GAAG;IACzB,UAAU,CAAC,EAAE,GAAG,CAAC;CAChB,GAAG,WAAW,CAAC;AAKhB,iBAAS,cAAc;WA0GT,OAAO,IAA6B;;;;;UAXqC,GAAG;;;EAgBzF;AAoBD,KAAK,oBAAoB,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAC9D,QAAA,MAAM,eAAe;;;;;;;;;;;;;cA/NR,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;eAElB,SAAS;4EAuOrB,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;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"}

package/dist/composables/index.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,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

@@ -0,0 +1,35 @@
+/**
+ * Change 事件状态管理组合式函数
+ * 用于区分不同类型的值变化，防止重复触发 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;
+};
+//# sourceMappingURL=useChangeEventState.d.ts.map

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

@@ -0,0 +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"}

package/dist/config/action.d.ts

@@ -0,0 +1,29 @@
+import { ActionConfig, ActionConfigButtonItem } 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 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;
+        autoExpandOnError: boolean;
+    };
+    generateActionButtons(inline?: boolean): string[];
+    buildActionAttrs(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,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"}

package/dist/config/component.d.ts

@@ -0,0 +1,38 @@
+import { FormItem } from '../types';
+/**
+ * 需要从 FormItem 中排除的自定义属性键名
+ * 这些属性不会传递给 el-form-item 组件
+ */
+export declare const FORM_ITEM_EXCLUDED_KEYS: readonly ["comp", "compAttrs", "vIf", "vShow"];
+/**
+ * 表单组件类型映射配置
+ *
+ * 使用显式类型注解避免类型推断超出编译器序列化限制
+ * 类型提示通过 keyof 提取键名，不依赖完整的类型定义
+ */
+export declare const FORM_ITEM_COMP_MAP: Record<string, any>;
+/**
+ * 动态组件默认配置
+ */
+export declare const COMPONENT_DEFAULT_CONFIG: {
+    /**
+     * 获取组件默认属性
+     */
+    getDefaults(formItem: FormItem): {
+        [x: string]: any;
+        options?: import('../types').FormItemOptions<C>;
+    };
+    /**
+     * 判断组件类型
+     */
+    getComponentType(comp: string): "input" | "select" | "picker" | "other";
+    /**
+     * 动态生成 placeholder
+     */
+    generatePlaceholder(formItem: FormItem, type: string): string;
+    /**
+     * 构建组件属性
+     */
+    buildComponentAttrs(formItem: FormItem, type: string): Record<string, any>;
+};
+//# sourceMappingURL=component.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/config/component.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gDAAiD,CAAA;AAsCrF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAGzC,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC;;OAEG;0BACmB,QAAQ;;;;IAe9B;;OAEG;2BACoB,MAAM;IAoB7B;;OAEG;kCAC2B,QAAQ,QAAQ,MAAM;IAkBpD;;OAEG;kCAC2B,QAAQ,QAAQ,MAAM;CAYrD,CAAA"}

package/dist/config/form.d.ts

@@ -0,0 +1,6 @@
+import { FormProps } from 'element-plus';
+/**
+ * 表单属性默认配置
+ */
+export declare const DEFAULT_FORM_ATTRS: 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"}

package/dist/config/index.d.ts

@@ -1,65 +1,5 @@
-import { FormProps } from 'element-plus';
-import { ActionConfig, ActionConfigButtonItem, FormItem } from '../types';
-/**
- * 表单组件配置常量
- */
-/**
- * 需要从 FormItem 中排除的自定义属性键名
- * 这些属性不会传递给 el-form-item 组件
- */
-export declare const FORM_ITEM_EXCLUDED_KEYS: readonly ["comp", "compAttrs", "vIf", "vShow"];
-/**
- * 表单组件类型映射配置
- *
- * 使用显式类型注解避免类型推断超出编译器序列化限制
- * 类型提示通过 keyof 提取键名，不依赖完整的类型定义
- */
-export declare const FORM_ITEM_COMP_MAP: Record<string, any>;
-/**
- * 动态组件默认配置
- */
-export declare const COMPONENT_DEFAULT_CONFIG: {
-    /**
-     * 获取组件默认属性
-     */
-    getDefaults(formItem: FormItem): {
-        [x: string]: any;
-    };
-    /**
-     * 判断组件类型
-     */
-    getComponentType(comp: string): "input" | "select" | "picker" | "other";
-    /**
-     * 动态生成 placeholder
-     */
-    generatePlaceholder(formItem: FormItem, type: string): string;
-    /**
-     * 构建组件属性
-     */
-    buildComponentAttrs(formItem: FormItem, type: string): Record<string, any>;
-};
-/**
- * 表单属性默认配置
- */
-export declare const DEFAULT_FORM_ATTRS: Partial<FormProps>;
-/**
- * 表单动作按钮默认配置
- */
-export declare const DEFAULT_FORM_ACTION_BUTTONS: Record<string, Partial<Omit<ActionConfigButtonItem, '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[];
-    };
-    generateActionButtons(inline?: boolean): string[];
-    buildActionAttrs(inline?: boolean): {
-        buttons: string[];
-        vIf: boolean | undefined;
-        vShow: boolean;
-    };
-};
+export * from './action';
+export * from './component';
+export * from './form';
+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":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAI9E;;GAEG;AAEH;;;GAGG;AACH,eAAO,MAAM,uBAAuB,gDAAiD,CAAA;AAsCrF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAGzC,CAAA;AAEV;;GAEG;AACH,eAAO,MAAM,wBAAwB;IACnC;;OAEG;0BACmB,QAAQ;;;IAe9B;;OAEG;2BACoB,MAAM;IAoB7B;;OAEG;kCAC2B,QAAQ,QAAQ,MAAM;IAkBpD;;OAEG;kCAC2B,QAAQ,QAAQ,MAAM;CAYrD,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAQf,OAAO,CAAC,SAAS,CAAC,CAAA;AAElC;;GAEG;AACH,eAAO,MAAM,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC,CAK1G,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;yBACX,OAAO,iBAAiB,YAAY;6BAXgB,CAAC;+BACpE,CAAC;;;mCAkBwB,OAAO;8BAGZ,OAAO;;;;;CAOlC,CAAA"}
+{"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"}

package/dist/config/scroll.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 默认滚动选项配置
+ *
+ * 用于表单验证错误滚动和展开/收起功能滚动
+ */
+export declare const DEFAULT_SCROLL_OPTIONS: ScrollIntoViewOptions;
+//# sourceMappingURL=scroll.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scroll.d.ts","sourceRoot":"","sources":["../../src/config/scroll.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAIpC,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, FormItem, FormItemComp, FormItemCompAttrs, FormItems, FormItemSlotScope, RowAttrs, } from './types';
+export type { ActionConfig, ActionConfigButtonItem, Arrayable, ColAttrs, ElFormAttrs, EventExtendedParams, ExpandRule, FormItem, FormItemComp, FormItemCompAttrs, FormItems, FormItemSlotScope, RowAttrs, } 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;AAKpD,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,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,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"}