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

package/dist/types/action.d.ts

@@ -11,18 +11,64 @@ export interface ActionConfigButtonItem extends Partial<ButtonProps> {
   eventName: string
 }
 
-/** 表单操作按钮配置项  */
-export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' | 'search' | 'reset'
+/**
+ * 表单操作按钮配置项
+ *
+ * 可以是标准化的按钮配置对象，也可以是预定义的按钮类型字符串
+ */
+export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' | 'search' | 'reset' | 'expand'
 
 /**
- * 表单操作项配置
+ * 展开规则基础配置
  *
- * @property {boolean | ((data?: any) => boolean)} vIf 是否显示
- * @property {boolean | ((data?: any) => boolean)} vShow 是否显示
- * @property {ActionConfigButtons[]} buttons 按钮列表
+ * **鼠标悬停自动展开**：
+ * - `autoExpandOnHover`：是否启用鼠标悬停自动展开功能
+ *   - 当鼠标移入表单区域时自动展开（延迟 500ms）
+ *   - 如果用户手动点击展开/收起按钮，则锁定状态，不再受鼠标移入影响
+ *
+ * **展开/收起后自动滚动**：
+ * - `scrollOnToggle`：是否在展开/收起后自动滚动到表单中心
+ *   - 默认值为 false
+ *   - 启用后，展开/收起动画完成后会自动滚动，使表单保持在页面中心
+ * - `scrollIntoViewOptions`：自定义滚动选项（仅在 `scrollOnToggle` 为 true 时生效）
+ *   - 用于自定义 `scrollIntoView` 的行为（如 `block`、`behavior`、`inline` 等）
+ *   - 默认值为 `{ behavior: 'smooth', block: 'center', inline: 'nearest' }`
+ *   - 支持所有 `ScrollIntoViewOptions` 类型的选项配置
+ */
+export interface ExpandRuleBase {
+  /** 是否启用鼠标悬停自动展开功能 */
+  autoExpandOnHover?: boolean
+  /** 是否在展开/收起后自动滚动到表单中心 */
+  scrollOnToggle?: boolean
+  /** 滚动选项配置（用于自定义 scrollIntoView 的行为） */
+  scrollIntoViewOptions?: ScrollIntoViewOptions
+}
+
+/**
+ * 默认展开规则（联合类型）
+ *
+ * 用于配置表单默认展开哪些字段，支持三种配置方式：
+ * - `count`：按字段数量展开（从第一个开始）
+ * - `include`：指定展示的字段（白名单，字段 prop 数组）
+ * - `exclude`：指定折叠的字段（黑名单，字段 prop 数组）
+ *
+ * **配置优先级**：`exclude` > `include` > `count`
+ */
+export type ExpandRule
+  = | ({ count: number } & ExpandRuleBase)
+    | ({ include: string[] } & ExpandRuleBase)
+    | ({ exclude: string[] } & ExpandRuleBase)
+
+/**
+ * 表单操作项配置
  */
 export interface ActionConfig {
+  /** 是否显示操作区域（支持函数动态判断） */
   vIf?: boolean | ((data?: any) => boolean)
+  /** 是否显示操作区域（支持函数动态判断，使用 v-show） */
   vShow?: boolean | ((data?: any) => boolean)
+  /** 操作按钮配置数组 */
   buttons?: ActionConfigButtons[]
+  /** 默认展开规则（仅在 buttons 包含 'expand' 时生效） */
+  expand?: ExpandRule
 }

package/dist/utils/action.d.ts

@@ -0,0 +1,10 @@
+import { ActionConfigButtons } from '../types';
+/**
+ * 判断按钮列表中是否包含指定的事件名
+ *
+ * @param buttons - 按钮配置数组
+ * @param eventName - 事件名称
+ * @returns 是否包含该事件名
+ */
+export declare function hasButtonEvent(buttons: ActionConfigButtons[] | string[] | undefined, eventName: string): boolean;
+//# sourceMappingURL=action.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/utils/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAEnD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIhH"}

package/dist/utils/debounce.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @file debounce.ts
+ * @description 防抖工具函数
+ */
+/**
+ * 防抖函数
+ *
+ * @param fn - 要防抖的函数
+ * @param delay - 延迟时间（毫秒），默认 100ms
+ * @returns 防抖后的函数
+ *
+ * @example
+ * ```typescript
+ * const debouncedFn = debounce(() => {
+ *   console.log('执行防抖函数')
+ * }, 300)
+ *
+ * // 频繁调用时，只会在最后一次调用后 300ms 执行
+ * debouncedFn()
+ * debouncedFn()
+ * debouncedFn() // 只有这一次会执行
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => any>(fn: T, delay?: number): (...args: Parameters<T>) => void;
+//# sourceMappingURL=debounce.d.ts.map

package/dist/utils/debounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debounce.d.ts","sourceRoot":"","sources":["../../src/utils/debounce.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EACxD,EAAE,EAAE,CAAC,EACL,KAAK,SAAM,GACV,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAYlC"}

package/dist/utils/index.d.ts

@@ -1,3 +1,5 @@
+export * from './action';
+export * from './debounce';
 export * from './options';
 export * from './value';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/dist/utils/value.d.ts

@@ -10,4 +10,18 @@ export declare function isEmpty(val: any): boolean;
  * @returns 是否在选项中（true 表示在选项中，不需要清理；false 表示不在，需要清理）
  */
 export declare function checkValueInOptions(currentValue: any, options: any[]): boolean;
+/**
+ * 深拷贝值（仅对对象和数组）
+ *
+ * @param value - 要深拷贝的值
+ * @returns 深拷贝后的值
+ *
+ * @example
+ * ```typescript
+ * const obj = { a: 1, b: { c: 2 } }
+ * const cloned = deepCloneValue(obj)
+ * cloned.b.c = 3 // 不会影响原对象
+ * ```
+ */
+export declare function deepCloneValue<T = Record<string, unknown>>(value: T): T;
 //# sourceMappingURL=value.d.ts.map

package/dist/utils/value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/utils/value.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAa9E"}
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/utils/value.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAEzC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,OAAO,CAa9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMvE"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iswangh/element-plus-kit-form",
   "type": "module",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Element Plus Kit 表单组件包",
   "license": "Apache-2.0",
   "sideEffects": [
@@ -50,9 +50,6 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
-    "type-check": "vue-tsc --noEmit",
-    "publish:patch": "pnpm version patch --no-git-tag-version && pnpm publish",
-    "publish:minor": "pnpm version minor --no-git-tag-version && pnpm publish",
-    "publish:major": "pnpm version major --no-git-tag-version && pnpm publish"
+    "type-check": "vue-tsc --noEmit"
   }
 }