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

package/dist/types/action.d.ts

@@ -0,0 +1,74 @@
+import { ButtonProps } from 'element-plus';
+/**
+ * 标准化的表单操作按钮配置项
+ *
+ * @extends {ButtonProps} el-button 的属性
+ * @property {string} label 按钮文字
+ * @property {string} eventName 事件名称
+ */
+export interface ActionConfigButtonItem extends Partial<ButtonProps> {
+  label?: string
+  eventName: string
+}
+
+/**
+ * 表单操作按钮配置项
+ *
+ * 可以是标准化的按钮配置对象，也可以是预定义的按钮类型字符串
+ */
+export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' | 'search' | 'reset' | 'expand'
+
+/**
+ * 展开规则基础配置
+ *
+ * **鼠标悬停自动展开**：
+ * - `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/types/common.d.ts

@@ -0,0 +1,9 @@
+import { FORM_ITEM_COMP_MAP } from '../config';
+/** 允许数组类型 */
+export type Arrayable<T> = T | T[]
+
+/**
+ * 表单组件配置映射类型
+ * 共享类型定义，避免在多个文件中重复定义导致冲突
+ */
+export type FormCompConfig = typeof FORM_ITEM_COMP_MAP

package/dist/types/el.d.ts

@@ -0,0 +1,43 @@
+import { ElCol, ElRow, FormItemInstance, FormRules } from 'element-plus';
+/**
+ * Element Plus Form Attributes
+ *
+ * 由于 `FormInstance['$slots']` 类型定义存在问题，
+ * 暂时无法直接使用 `FormInstance['$props']`，
+ * 因此手动定义了部分常用属性以确保类型安全。
+ *
+ * @see {@link https://element-plus.org/zh-CN/component/form.html#form-attributes Element Plus Form Attributes}
+ */
+export interface ElFormAttrs {
+  // 数据相关
+  model?: Record<string, any>
+  rules?: FormRules
+
+  // 布局相关
+  inline?: boolean
+  labelPosition?: 'left' | 'right' | 'top'
+  labelWidth?: string | number
+  labelSuffix?: string
+
+  // 样式相关
+  size?: 'large' | 'default' | 'small'
+  disabled?: boolean
+  hideRequiredAsterisk?: boolean
+
+  // 验证相关
+  showMessage?: boolean
+  inlineMessage?: boolean
+  statusIcon?: boolean
+  validateOnRuleChange?: boolean
+  scrollToError?: boolean
+  scrollIntoViewOptions?: ScrollIntoViewOptions
+}
+
+/** Element Plus FormItem 属性 */
+export type ElFormItemAttrs = FormItemInstance['$props']
+
+/** Element Plus Row 组件属性 */
+export type ElRowAttrs = InstanceType<typeof ElRow>['$props']
+
+/** Element Plus Col 组件属性 */
+export type ElColAttrs = InstanceType<typeof ElCol>['$props']

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

@@ -0,0 +1,109 @@
+import { FormCompConfig } from './common';
+import { ElColAttrs, ElFormItemAttrs, ElRowAttrs } from './el';
+import { GetComponentOptionsType, InferOptionsType, IsOptionsSupported } from './options';
+/** Row 布局属性（扩展自 Element Plus Row 组件属性） */
+export type RowAttrs = ElRowAttrs & { span?: number }
+
+/** Col 布局属性（Element Plus Col 组件属性） */
+export type ColAttrs = ElColAttrs
+
+/**
+ * 支持的表单组件枚举
+ *
+ * 显式定义所有可用的组件键名，确保类型提示正常工作
+ * 注意：由于 FORM_ITEM_COMP_MAP 使用了 Record<string, any> 避免类型推断超出限制，
+ * 我们需要显式定义键名类型，而不是从 typeof FORM_ITEM_COMP_MAP 中提取
+ */
+export type FormItemComp
+  = | 'autocomplete'
+    | 'cascader'
+    | 'checkbox'
+    | 'color-picker'
+    | 'color-picker-panel'
+    | 'date-picker'
+    | 'date-picker-panel'
+    | 'input'
+    | 'input-number'
+    | 'input-tag'
+    | 'mention'
+    | 'radio'
+    | 'rate'
+    | 'select'
+    | 'select-v2'
+    | 'slider'
+    | 'switch'
+    | 'time-picker'
+    | 'time-select'
+    | 'transfer'
+    | 'tree-select'
+    | 'custom'
+
+/**
+ * 根据组件类型推断对应的属性类型（排除事件处理器）
+ * @template T - 组件类型
+ */
+export type FormItemCompAttrs<T extends FormItemComp = FormItemComp>
+  = Omit<InstanceType<FormCompConfig[T]>['$props'], `on${string}`>
+
+/**
+ * 根据组件类型推断 options 类型
+ * 只有支持 options 的组件才会扩展 options 类型
+ * @template C - 组件类型
+ */
+export type FormItemOptions<C extends FormItemComp> = IsOptionsSupported<C> extends true
+  ? InferOptionsType<C, GetComponentOptionsType<C>>
+  : never
+
+/**
+ * FormItem 属性
+ *
+ * 扩展自 Element Plus 的 FormItem 组件属性，添加了自定义配置选项
+ *
+ * @template C - 组件类型
+ * @extends {ElFormItemAttrs} Element Plus FormItem 组件原始属性
+ * @property {C} comp 使用的组件类型
+ * @property {FormItemCompAttrs<C>} [compAttrs] 传递给组件的属性配置对象
+ * @property {boolean | ((data?: any) => boolean)} [vIf] 条件渲染控制，支持布尔值或接收表单数据的函数
+ * @property {boolean | ((data?: any) => boolean)} [vShow] 显示/隐藏控制，支持布尔值或接收表单数据的函数
+ *
+ * @see {@link https://element-plus.org/zh-CN/component/form.html#form-item-attributes Element Plus Form Item Attributes}
+ */
+export interface FormItem<
+  C extends FormItemComp = FormItemComp,
+> extends ElFormItemAttrs {
+  prop: string
+  comp: C
+  compAttrs?: IsOptionsSupported<C> extends true
+    ? FormItemCompAttrs<C> & { options?: FormItemOptions<C> } // 支持 options 的组件：直接覆盖 options 类型为扩展类型
+    : FormItemCompAttrs<C> // 不支持 options 的组件：使用原始属性类型
+  vIf?: boolean | ((data: Record<string, any>) => boolean)
+  vShow?: boolean | ((data: Record<string, any>) => boolean)
+  colAttrs?: ColAttrs
+}
+
+/** formItems 配置类型 - 推断每一项的 comp 对应的组件类型 */
+export type FormItems = { [K in FormItemComp]: FormItem<K> }[FormItemComp][]
+
+/**
+ * 事件拓展参数
+ * @template K 属性名类型
+ */
+export interface EventExtendedParams<K = string> {
+  prop: K
+  index: number
+  formItem: FormItem
+}
+
+/**
+ * 表单项插槽作用域参数
+ *
+ * @property {any} value 当前表单项组件的值
+ * @property {Record<string, any>} form 表单数据
+ * @property {FormItem} formItem 表单项配置
+ */
+export interface FormItemSlotScope {
+  value: any
+  form: Record<string, any>
+  formItem: FormItem
+  [key: string]: any // 允许 el-form-item 的其他作用域参数
+}

package/dist/types/index.d.ts

@@ -1,126 +1,6 @@
-import { ButtonProps, ElCol, ElRow, FormItemInstance, FormRules } from 'element-plus';
-import { FORM_ITEM_COMP_MAP } from '../config';
-/**
- * Element Plus Form Attributes
- *
- * 由于 `FormInstance['$slots']` 类型定义存在问题，
- * 暂时无法直接使用 `FormInstance['$props']`，
- * 因此手动定义了部分常用属性以确保类型安全。
- *
- * @see {@link https://element-plus.org/zh-CN/component/form.html#form-attributes Element Plus Form Attributes}
- */
-export interface ElFormAttrs {
-    model?: Record<string, any>;
-    rules?: FormRules;
-    inline?: boolean;
-    labelPosition?: 'left' | 'right' | 'top';
-    labelWidth?: string | number;
-    labelSuffix?: string;
-    size?: 'large' | 'default' | 'small';
-    disabled?: boolean;
-    hideRequiredAsterisk?: boolean;
-    showMessage?: boolean;
-    inlineMessage?: boolean;
-    statusIcon?: boolean;
-    validateOnRuleChange?: boolean;
-    scrollToError?: boolean;
-    scrollIntoViewOptions?: ScrollIntoViewOptions;
-}
-/** Element Plus FormItem 属性 */
-type ElFormItemAttrs = FormItemInstance['$props'];
-/**
- * 支持的表单组件枚举
- *
- * 显式定义所有可用的组件键名，确保类型提示正常工作
- * 注意：由于 FORM_ITEM_COMP_MAP 使用了 Record<string, any> 避免类型推断超出限制，
- * 我们需要显式定义键名类型，而不是从 typeof FORM_ITEM_COMP_MAP 中提取
- */
-export type FormItemComp = 'autocomplete' | 'cascader' | 'checkbox' | 'color-picker' | 'color-picker-panel' | 'date-picker' | 'date-picker-panel' | 'input' | 'input-number' | 'input-tag' | 'mention' | 'radio' | 'rate' | 'select' | 'select-v2' | 'slider' | 'switch' | 'time-picker' | 'time-select' | 'transfer' | 'tree-select' | 'custom';
-/** 表单组件配置映射类型 */
-type FormCompConfig = typeof FORM_ITEM_COMP_MAP;
-/**
- * 根据组件类型推断对应的属性类型（排除事件处理器）
- * @template T - 组件类型
- */
-export type FormItemCompAttrs<T extends FormItemComp = FormItemComp> = Omit<InstanceType<FormCompConfig[T]>['$props'], `on${string}`>;
-export type RowAttrs = InstanceType<typeof ElRow>['$props'] & {
-    span?: number;
-};
-export type ColAttrs = InstanceType<typeof ElCol>['$props'];
-/**
- * FormItem 属性
- *
- * 扩展自 Element Plus 的 FormItem 组件属性，添加了自定义配置选项
- *
- * @template C - 组件类型
- * @extends {ElFormItemAttrs} Element Plus FormItem 组件原始属性
- * @property {C} comp 使用的组件类型
- * @property {FormItemCompAttrs<C>} [compAttrs] 传递给组件的属性配置对象
- * @property {boolean | ((data?: any) => boolean)} [vIf] 条件渲染控制，支持布尔值或接收表单数据的函数
- * @property {boolean | ((data?: any) => boolean)} [vShow] 显示/隐藏控制，支持布尔值或接收表单数据的函数
- *
- * @see {@link https://element-plus.org/zh-CN/component/form.html#form-item-attributes Element Plus Form Item Attributes}
- */
-export interface FormItem<C extends FormItemComp = FormItemComp> extends ElFormItemAttrs {
-    prop: string;
-    comp: C;
-    compAttrs?: FormItemCompAttrs<C>;
-    vIf?: boolean | ((data?: any) => boolean);
-    vShow?: boolean | ((data?: any) => boolean);
-    colAttrs?: ColAttrs;
-}
-/** formItems 配置类型 - 推断每一项的 comp 对应的组件类型 */
-export type FormItems = {
-    [K in FormItemComp]: FormItem<K>;
-}[FormItemComp][];
-/**
- * 表单项插槽作用域参数
- *
- * @property {any} value 当前表单项组件的值
- * @property {Record<string, any>} form 表单数据
- * @property {FormItem} formItem 表单项配置
- */
-export interface FormItemSlotScope {
-    value: any;
-    form: Record<string, any>;
-    formItem: FormItem;
-    [key: string]: any;
-}
-/** 允许数组类型 */
-export type Arrayable<T> = T | T[];
-/**
- * 标准化的表单操作按钮配置项
- *
- * @extends {ButtonProps} el-button 的属性
- * @property {string} label 按钮文字
- * @property {string} eventName 事件名称
- */
-export interface ActionConfigButtonItem extends Partial<ButtonProps> {
-    label?: string;
-    eventName: string;
-}
-/** 表单操作按钮配置项  */
-export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' | 'search' | 'reset';
-/**
- * 表单操作项配置
- *
- * @property {boolean | ((data?: any) => boolean)} vIf 是否显示
- * @property {boolean | ((data?: any) => boolean)} vShow 是否显示
- * @property {ActionConfigButtons[]} buttons 按钮列表
- */
-export interface ActionConfig {
-    vIf?: boolean | ((data?: any) => boolean);
-    vShow?: boolean | ((data?: any) => boolean);
-    buttons?: ActionConfigButtons[];
-}
-/**
- * 事件拓展参数
- * @template K 属性名类型
- */
-export interface EventExtendedParams<K = string> {
-    prop: K;
-    index: number;
-    formItem: FormItem;
-}
-export {};
+export type * from './action';
+export type * from './common';
+export type * from './el';
+export type * from './form-item';
+export type * from './options';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,MAAM,CAAA;AACzB,mBAAmB,aAAa,CAAA;AAChC,mBAAmB,WAAW,CAAA"}

package/dist/types/options.d.ts

@@ -0,0 +1,89 @@
+import { FormCompConfig } from './common';
+import { FormItemComp } from './form-item';
+/**
+ * 检查组件类型是否包含 options 属性
+ * 通过检查组件实例的 $props 中是否包含 'options' 来判断
+ * @template C 组件类型
+ */
+type HasOptionsProp<C extends FormItemComp> = 'options' extends keyof InstanceType<FormCompConfig[C]>['$props']
+  ? true
+  : false
+
+/**
+ * 判断组件是否支持 options 属性
+ * 动态从组件类型定义中判断，不硬编码组件名称
+ * @template C 组件类型
+ */
+export type IsOptionsSupported<C extends FormItemComp> = HasOptionsProp<C>
+
+/**
+ * 支持 options 属性的组件类型
+ * 通过类型系统自动提取，不硬编码
+ */
+export type OptionsSupportedComp = FormItemComp extends infer C
+  ? C extends FormItemComp
+    ? IsOptionsSupported<C> extends true
+      ? C
+      : never
+    : never
+  : never
+
+/**
+ * Options 加载器函数类型
+ * @param formData 表单数据（外部依赖通过闭包访问）
+ * @returns 返回选项数组（支持同步和异步）
+ */
+export type OptionsLoader = (formData: Record<string, any>) => any[] | Promise<any[]>
+
+/**
+ * Options 对象模式配置
+ */
+export interface OptionsConfig {
+  /**
+   * 选项加载器函数
+   * @param formData 表单数据（外部依赖通过闭包访问）
+   * @returns 返回选项数组（支持同步和异步）
+   */
+  loader: OptionsLoader
+  /**
+   * 是否立即加载（默认 false，需要显式设置为 true 才会立即加载）
+   */
+  immediate?: boolean
+  /**
+   * 依赖字段列表，需要监听并获取
+   * 支持内部依赖（表单字段），外部依赖通过闭包访问
+   */
+  deps?: string[]
+}
+
+/**
+ * 根据组件类型推断 options 类型
+ * @template C 组件类型
+ * @template T 组件实例类型
+ */
+export type InferOptionsType<C extends FormItemComp, T = any> = IsOptionsSupported<C> extends true
+  ? T[] | OptionsLoader | OptionsConfig
+  : never
+
+/**
+ * 获取组件原始的 options 类型
+ * 从组件实例的 $props 中提取 options 属性的类型
+ * @template C 组件类型
+ */
+export type GetComponentOptionsType<C extends FormItemComp> = IsOptionsSupported<C> extends true
+  ? InstanceType<FormCompConfig[C]>['$props']['options']
+  : never
+
+/**
+ * 检查组件类型是否包含 loading 属性
+ * @template C 组件类型
+ */
+type HasLoadingProp<C extends FormItemComp> = 'loading' extends keyof InstanceType<FormCompConfig[C]>['$props']
+  ? true
+  : false
+
+/**
+ * 判断组件是否支持 loading 属性
+ * @template C 组件类型
+ */
+export type IsLoadingSupported<C extends FormItemComp> = HasLoadingProp<C>

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

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

@@ -0,0 +1 @@
+{"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/options.d.ts

@@ -0,0 +1,21 @@
+import { OptionsConfig } from '../types';
+/**
+ * 处理依赖列表：排除自身并去重
+ * @param deps 依赖字段列表
+ * @param currentProp 当前字段名，用于排除自己
+ */
+export declare function processDeps(deps: string[], currentProp?: string): string[];
+/**
+ * 获取依赖值
+ * @param deps 依赖字段列表
+ * @param formData 表单数据（外部依赖通过闭包访问）
+ * @param currentProp 当前字段名，用于排除自己
+ */
+export declare function getDepsValues(deps: string[], formData: Record<string, any>, currentProp?: string): Record<string, any>;
+/**
+ * 检查是否为对象模式的 options 配置
+ * @param options - 待检查的选项配置
+ * @returns 是否为对象模式配置
+ */
+export declare function isOptionsConfig(options: any): options is OptionsConfig;
+//# sourceMappingURL=options.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/utils/options.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAO1E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAOtH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,aAAa,CAEtE"}

package/dist/utils/value.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 检查值是否为空
+ */
+export declare function isEmpty(val: any): boolean;
+/**
+ * 检查当前值是否在新的选项中
+ * 用于判断是否需要自动清理值：如果值在新的选项中，保留；否则清理
+ * @param currentValue - 当前值
+ * @param options - 选项数组
+ * @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

@@ -0,0 +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;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.2",
+  "version": "0.1.4",
   "description": "Element Plus Kit 表单组件包",
   "license": "Apache-2.0",
   "sideEffects": [
@@ -31,18 +31,18 @@
     "vue": "^3.5.23"
   },
   "dependencies": {
-    "@iswangh/element-plus-kit-core": "0.1.2"
+    "@iswangh/element-plus-kit-core": "0.1.3"
   },
   "devDependencies": {
     "@element-plus/icons-vue": "^2.3.2",
     "@vitejs/plugin-vue": "^6.0.1",
-    "element-plus": "^2.11.7",
-    "sass": "^1.93.3",
-    "typescript": "^5.9.2",
-    "vite": "^7.1.5",
+    "element-plus": "^2.11.8",
+    "sass": "^1.94.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.2",
     "vite-plugin-dts": "^4.5.4",
-    "vue": "^3.5.23",
-    "vue-tsc": "^3.0.7"
+    "vue": "^3.5.24",
+    "vue-tsc": "^3.1.3"
   },
   "publishConfig": {
     "access": "public"
@@ -50,9 +50,6 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
-    "type-check": "vue-tsc --noEmit",
-    "version:patch": "pnpm version patch --no-git-tag-version",
-    "version:minor": "pnpm version minor --no-git-tag-version",
-    "version:major": "pnpm version major --no-git-tag-version"
+    "type-check": "vue-tsc --noEmit"
   }
 }