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

package/dist/types/action.d.ts

@@ -1,4 +1,5 @@
 import { ButtonProps } from 'element-plus';
+import { Condition } from './common';
 /**
  * 标准化的表单操作按钮配置项
  *
@@ -6,7 +7,7 @@ import { ButtonProps } from 'element-plus';
  * @property {string} label 按钮文字
  * @property {string} eventName 事件名称
  */
-export interface ActionConfigButtonItem extends Partial<ButtonProps> {
+export interface FormActionButtonItem extends Partial<ButtonProps> {
   label?: string
   eventName: string
 }
@@ -16,7 +17,7 @@ export interface ActionConfigButtonItem extends Partial<ButtonProps> {
  *
  * 可以是标准化的按钮配置对象，也可以是预定义的按钮类型字符串
  */
-export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' | 'search' | 'reset' | 'expand'
+export type FormActionButtons = FormActionButtonItem | 'submit' | 'cancel' | 'search' | 'reset' | 'expand'
 
 /**
  * 展开规则基础配置
@@ -35,7 +36,7 @@ export type ActionConfigButtons = ActionConfigButtonItem | 'submit' | 'cancel' |
  *   - 默认值为 `{ behavior: 'smooth', block: 'center', inline: 'nearest' }`
  *   - 支持所有 `ScrollIntoViewOptions` 类型的选项配置
  */
-export interface ExpandRuleBase {
+export interface FormExpandRuleBase {
   /** 是否启用鼠标悬停自动展开功能 */
   autoExpandOnHover?: boolean
   /** 是否在展开/收起后自动滚动到表单中心 */
@@ -54,21 +55,21 @@ export interface ExpandRuleBase {
  *
  * **配置优先级**：`exclude` > `include` > `count`
  */
-export type ExpandRule
-  = | ({ count: number } & ExpandRuleBase)
-    | ({ include: string[] } & ExpandRuleBase)
-    | ({ exclude: string[] } & ExpandRuleBase)
+export type FormExpandRule
+  = | ({ count: number } & FormExpandRuleBase)
+    | ({ include: string[] } & FormExpandRuleBase)
+    | ({ exclude: string[] } & FormExpandRuleBase)
 
 /**
  * 表单操作项配置
  */
-export interface ActionConfig {
+export interface FormActionConfig {
   /** 是否显示操作区域（支持函数动态判断） */
-  vIf?: boolean | ((data?: any) => boolean)
+  vIf?: Condition
   /** 是否显示操作区域（支持函数动态判断，使用 v-show） */
-  vShow?: boolean | ((data?: any) => boolean)
+  vShow?: Condition
   /** 操作按钮配置数组 */
-  buttons?: ActionConfigButtons[]
+  buttons?: FormActionButtons[]
   /** 默认展开规则（仅在 buttons 包含 'expand' 时生效） */
-  expand?: ExpandRule
+  expand?: FormExpandRule
 }

package/dist/types/common.d.ts

@@ -1,9 +1,10 @@
-import { FORM_ITEM_COMP_MAP } from '../config';
+/* eslint-disable ts/no-explicit-any */
 /** 允许数组类型 */
 export type Arrayable<T> = T | T[]
 
 /**
- * 表单组件配置映射类型
- * 共享类型定义，避免在多个文件中重复定义导致冲突
+ * 条件类型
+ * 支持布尔值或接收数据的函数
+ * @template T - 数据类型，默认为 Record<string, any>
  */
-export type FormCompConfig = typeof FORM_ITEM_COMP_MAP
+export type Condition<T = Record<string, any>> = boolean | ((data: T) => boolean)

package/dist/types/comp.d.ts

@@ -0,0 +1,93 @@
+import { ElAutocomplete, ElCascader, ElCheckboxGroup, ElColorPicker, ElColorPickerPanel, ElDatePicker, ElDatePickerPanel, ElInput, ElInputNumber, ElInputTag, ElMention, ElRadioGroup, ElRate, ElSelect, ElSelectV2, ElSlider, ElSwitch, ElTimePicker, ElTimeSelect, ElTransfer, ElTreeSelect } from 'element-plus';
+import { EXPAND_COMP_MAP } from '../config';
+/**
+ * Element Plus 组件映射类型
+ *
+ * 手动定义类型映射，避免从 EL_COMP_MAP 使用 typeof 时类型推断超出编译器序列化限制
+ * 与 comp.ts 中的 EL_COMP_MAP 保持同步
+ */
+interface ElCompMap {
+  readonly 'autocomplete': typeof ElAutocomplete
+  readonly 'cascader': typeof ElCascader
+  readonly 'checkbox': typeof ElCheckboxGroup
+  readonly 'color-picker-panel': typeof ElColorPickerPanel
+  readonly 'color-picker': typeof ElColorPicker
+  readonly 'date-picker-panel': typeof ElDatePickerPanel
+  readonly 'date-picker': typeof ElDatePicker
+  readonly 'input': typeof ElInput
+  readonly 'input-number': typeof ElInputNumber
+  readonly 'input-tag': typeof ElInputTag
+  readonly 'mention': typeof ElMention
+  readonly 'radio': typeof ElRadioGroup
+  readonly 'rate': typeof ElRate
+  readonly 'select': typeof ElSelect
+  readonly 'select-v2': typeof ElSelectV2
+  readonly 'slider': typeof ElSlider
+  readonly 'switch': typeof ElSwitch
+  readonly 'time-picker': typeof ElTimePicker
+  readonly 'time-select': typeof ElTimeSelect
+  readonly 'transfer': typeof ElTransfer
+  readonly 'tree-select': typeof ElTreeSelect
+}
+
+/**
+ * 表单组件配置映射类型
+ *
+ * 合并 Element Plus 组件映射和扩展组件映射的类型
+ * - ElCompMap: 手动定义，避免类型推断超出限制
+ * - typeof EXPAND_COMP_MAP: 从运行时值提取类型（简单映射，不会超出限制）
+ *
+ * 注意：不使用 typeof FORM_ITEM_COMP_MAP，因为 FORM_ITEM_COMP_MAP 使用了
+ * Record<string, any> 避免类型推断超出编译器序列化限制
+ */
+export type FormCompConfig = ElCompMap & typeof EXPAND_COMP_MAP
+
+/**
+ * 支持的表单组件枚举
+ *
+ * 显式定义所有可用的组件键名，确保类型提示正常工作
+ * 注意：由于 FORM_ITEM_COMP_MAP 使用了 Record<string, any> 避免类型推断超出限制，
+ * 我们需要显式定义键名类型，而不是从 typeof FORM_ITEM_COMP_MAP 中提取
+ */
+export type FormItemComp = 'custom'
+  | '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 FormItemCompInstance<T extends FormItemComp> = InstanceType<FormCompConfig[T]>
+
+/**
+ * 根据组件类型推断对应的 Props 类型（包含事件处理器）
+ * @template T - 组件类型
+ */
+export type FormItemCompProps<T extends FormItemComp = FormItemComp>
+  = FormItemCompInstance<T>['$props']
+
+/**
+ * 根据组件类型推断对应的插槽类型
+ * @template T - 组件类型
+ */
+export type FormItemCompSlots<T extends FormItemComp> = FormItemCompInstance<T>['$slots']

package/dist/types/el.d.ts

@@ -1,6 +1,6 @@
 import { ElCol, ElRow, FormItemInstance, FormRules } from 'element-plus';
 /**
- * Element Plus Form Attributes
+ * Element Plus Form Props
  *
  * 由于 `FormInstance['$slots']` 类型定义存在问题，
  * 暂时无法直接使用 `FormInstance['$props']`，
@@ -8,7 +8,7 @@ import { ElCol, ElRow, FormItemInstance, FormRules } from 'element-plus';
  *
  * @see {@link https://element-plus.org/zh-CN/component/form.html#form-attributes Element Plus Form Attributes}
  */
-export interface ElFormAttrs {
+export interface ElFormProps {
   // 数据相关
   model?: Record<string, any>
   rules?: FormRules
@@ -33,11 +33,14 @@ export interface ElFormAttrs {
   scrollIntoViewOptions?: ScrollIntoViewOptions
 }
 
-/** Element Plus FormItem 属性 */
-export type ElFormItemAttrs = FormItemInstance['$props']
+/** Element Plus FormItem Props */
+export type ElFormItemProps = FormItemInstance['$props']
 
-/** Element Plus Row 组件属性 */
-export type ElRowAttrs = InstanceType<typeof ElRow>['$props']
+/** Element Plus FormItem Slots */
+export type ElFormItemSlots = FormItemInstance['$slots']
 
-/** Element Plus Col 组件属性 */
-export type ElColAttrs = InstanceType<typeof ElCol>['$props']
+/** Element Plus Row 组件 Props */
+export type ElRowProps = InstanceType<typeof ElRow>['$props']
+
+/** Element Plus Col 组件 Props */
+export type ElColProps = InstanceType<typeof ElCol>['$props']

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

@@ -1,109 +1,53 @@
-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
-
+import { Condition } from './common';
+import { FormItemComp, FormItemCompProps } from './comp';
+import { ElFormItemProps } from './el';
+import { ColProps } from './layout';
+import { InferOptionsType, IsOptionsSupported } from './options';
+import { CompSlotsConfig, FormItemSlotsConfig } from './scope';
 /**
- * 支持的表单组件枚举
- *
- * 显式定义所有可用的组件键名，确保类型提示正常工作
- * 注意：由于 FORM_ITEM_COMP_MAP 使用了 Record<string, any> 避免类型推断超出限制，
- * 我们需要显式定义键名类型，而不是从 typeof FORM_ITEM_COMP_MAP 中提取
+ * 根据组件类型推断 options 类型
+ * 只有支持 options 的组件才会扩展 options 类型
+ * @template T - 组件类型
  */
-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'
+export type FormItemOptions<T extends FormItemComp> = IsOptionsSupported<T> extends true
+  ? InferOptionsType<T>
+  : never
 
 /**
- * 根据组件类型推断对应的属性类型（排除事件处理器）
+ * 根据组件类型推断 compProps 类型（扩展版本）
+ * 支持扩展属性，如 options、slots 等
  * @template T - 组件类型
  */
-export type FormItemCompAttrs<T extends FormItemComp = FormItemComp>
-  = Omit<InstanceType<FormCompConfig[T]>['$props'], `on${string}`>
+export type FormItemCompPropsExtended<T extends FormItemComp>
+  = (IsOptionsSupported<T> extends true
+    ? Omit<FormItemCompProps<T>, 'options'> & { options?: FormItemOptions<T> }
+    : FormItemCompProps<T>)
+  & { slots?: CompSlotsConfig<T> }
 
 /**
- * 根据组件类型推断 options 类型
- * 只有支持 options 的组件才会扩展 options 类型
- * @template C - 组件类型
- */
-export type FormItemOptions<C extends FormItemComp> = IsOptionsSupported<C> extends true
-  ? InferOptionsType<C, GetComponentOptionsType<C>>
-  : never
-
-/**
- * FormItem 属性
+ * FormItem Props
  *
- * 扩展自 Element Plus 的 FormItem 组件属性，添加了自定义配置选项
+ * 扩展自 Element Plus 的 FormItem 组件 Props，添加了自定义配置选项
  *
- * @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] 显示/隐藏控制，支持布尔值或接收表单数据的函数
+ * @template T - 组件类型
+ * @extends {ElFormItemProps} Element Plus FormItem 组件原始 Props（包含事件处理器）
+ * @property {T} compType 使用的组件类型
+ * @property {FormItemCompPropsExtended<T>} [compProps] 传递给组件的 Props 配置对象（包含事件处理器和插槽，用于动态组件）
+ * @property {FormItemSlotsConfig} [slots] FormItem 插槽配置（用于 el-form-item 的插槽）
+ * @property {Condition} [vIf] 条件渲染控制，支持布尔值或接收表单数据的函数
+ * @property {Condition} [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 {
+export interface FormItem<T extends FormItemComp = FormItemComp> extends ElFormItemProps {
   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
+  compType: T
+  compProps?: FormItemCompPropsExtended<T> // 包含事件处理器和插槽（动态组件的事件和插槽）
+  slots?: FormItemSlotsConfig // FormItem 插槽配置
+  vIf?: Condition
+  vShow?: Condition
+  colProps?: ColProps
 }
 
-/** formItems 配置类型 - 推断每一项的 comp 对应的组件类型 */
+/** formItems 配置类型 - 推断每一项的 compType 对应的组件类型 */
 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,6 +1,9 @@
 export type * from './action';
 export type * from './common';
+export type * from './comp';
 export type * from './el';
 export type * from './form-item';
+export type * from './layout';
 export type * from './options';
+export type * from './scope';
 //# 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":"AAAA,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,MAAM,CAAA;AACzB,mBAAmB,aAAa,CAAA;AAChC,mBAAmB,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,QAAQ,CAAA;AAC3B,mBAAmB,MAAM,CAAA;AACzB,mBAAmB,aAAa,CAAA;AAChC,mBAAmB,UAAU,CAAA;AAC7B,mBAAmB,WAAW,CAAA;AAC9B,mBAAmB,SAAS,CAAA"}

package/dist/types/layout.d.ts

@@ -0,0 +1,6 @@
+import { ElColProps, ElRowProps } from './el';
+/** Row 布局 Props（扩展自 Element Plus Row 组件 Props） */
+export type RowProps = ElRowProps & { span?: number }
+
+/** Col 布局 Props（Element Plus Col 组件 Props） */
+export type ColProps = ElColProps

package/dist/types/options.d.ts

@@ -1,29 +1,28 @@
-import { FormCompConfig } from './common';
-import { FormItemComp } from './form-item';
+import { FormItemComp, FormItemCompProps } from './comp';
 /**
  * 检查组件类型是否包含 options 属性
  * 通过检查组件实例的 $props 中是否包含 'options' 来判断
- * @template C 组件类型
+ * @template T 组件类型
  */
-type HasOptionsProp<C extends FormItemComp> = 'options' extends keyof InstanceType<FormCompConfig[C]>['$props']
+type HasOptionsProp<T extends FormItemComp> = 'options' extends keyof FormItemCompProps<T>
   ? true
   : false
 
 /**
  * 判断组件是否支持 options 属性
  * 动态从组件类型定义中判断，不硬编码组件名称
- * @template C 组件类型
+ * @template T 组件类型
  */
-export type IsOptionsSupported<C extends FormItemComp> = HasOptionsProp<C>
+export type IsOptionsSupported<T extends FormItemComp> = HasOptionsProp<T>
 
 /**
  * 支持 options 属性的组件类型
  * 通过类型系统自动提取，不硬编码
  */
-export type OptionsSupportedComp = FormItemComp extends infer C
-  ? C extends FormItemComp
-    ? IsOptionsSupported<C> extends true
-      ? C
+export type OptionsSupportedComp = FormItemComp extends infer T
+  ? T extends FormItemComp
+    ? IsOptionsSupported<T> extends true
+      ? T
       : never
     : never
   : never
@@ -58,32 +57,17 @@ export interface OptionsConfig {
 
 /**
  * 根据组件类型推断 options 类型
- * @template C 组件类型
- * @template T 组件实例类型
+ * @template T 组件类型
  */
-export type InferOptionsType<C extends FormItemComp, T = any> = IsOptionsSupported<C> extends true
-  ? T[] | OptionsLoader | OptionsConfig
+export type InferOptionsType<T extends FormItemComp> = IsOptionsSupported<T> extends true
+  ? OptionsLoader | OptionsConfig | any[]
   : never
 
 /**
  * 获取组件原始的 options 类型
  * 从组件实例的 $props 中提取 options 属性的类型
- * @template C 组件类型
+ * @template T 组件类型
  */
-export type GetComponentOptionsType<C extends FormItemComp> = IsOptionsSupported<C> extends true
-  ? InstanceType<FormCompConfig[C]>['$props']['options']
+export type GetCompOptionsType<T extends FormItemComp> = IsOptionsSupported<T> extends true
+  ? FormItemCompProps<T>['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/types/scope.d.ts

@@ -0,0 +1,64 @@
+import { VNode } from 'vue';
+import { FormItemComp, FormItemCompSlots } from './comp';
+import { ElFormItemSlots } from './el';
+import { FormItem } from './form-item';
+/**
+ * 表单项事件扩展参数
+ *
+ * 表单组件事件的扩展参数，包含字段名、索引和表单项配置
+ * 用于 change 等事件，未来可扩展用于其他表单项相关事件
+ *
+ * @template K 属性名类型
+ * @property {K} prop 表单字段名
+ * @property {number} index 表单项索引
+ * @property {FormItem} formItem 表单项配置
+ */
+export interface FormItemEventExtendedParams<K = string> {
+  prop: K
+  index: number
+  formItem: FormItem
+}
+
+/**
+ * 表单项插槽作用域参数
+ *
+ * 表单项插槽的作用域参数，包含当前值、表单数据和表单项配置
+ * 用于 form-item 插槽、动态组件插槽、自定义组件插槽等
+ *
+ * @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 的其他作用域参数
+}
+
+/**
+ * 插槽渲染函数类型
+ *
+ * 允许返回 VNode 或 VNode[]，兼容 h() 函数返回单个 VNode 的情况
+ * Vue 的 component :is 可以接受返回 VNode 或 VNode[] 的函数
+ * 用于插槽配置，提供比 Vue 的 Slot 类型更灵活的返回值支持
+ * 接受 FormItemSlotScope 参数（或扩展类型），包含 value、form、formItem 等属性
+ * 使用泛型支持扩展参数类型，如 FormItemSlotScope & { label: string } 用于 label 插槽
+ */
+export type SlotRenderFn<T extends FormItemSlotScope = FormItemSlotScope> = (props: T) => VNode | VNode[]
+
+/**
+ * 动态组件插槽配置类型
+ *
+ * @template T - 组件类型
+ */
+export type CompSlotsConfig<T extends FormItemComp> = {
+  [K in keyof FormItemCompSlots<T>]?: SlotRenderFn
+}
+
+/**
+ * FormItem 插槽配置类型
+ */
+export type FormItemSlotsConfig = {
+  [K in keyof ElFormItemSlots]?: SlotRenderFn
+}

package/dist/utils/action.d.ts

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

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

@@ -1 +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"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/utils/action.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAEjD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAI9G"}

package/dist/utils/index.d.ts

@@ -1,5 +1,5 @@
 export * from './action';
-export * from './debounce';
+export * from './lodash';
 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,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,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,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA"}

package/dist/utils/lodash.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @file lodash.ts
+ * @description lodash-es 方法统一导出
+ */
+export { cloneDeep, debounce, isEmpty } from 'lodash-es';
+//# sourceMappingURL=lodash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lodash.d.ts","sourceRoot":"","sources":["../../src/utils/lodash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA"}

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

@@ -1 +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"}
+{"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,CAGtH;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,aAAa,CAEtE"}

package/dist/utils/value.d.ts

@@ -1,27 +1,21 @@
 /**
- * 检查值是否为空
+ * 检查值是否在选项中的参数
  */
-export declare function isEmpty(val: any): boolean;
+export interface CheckValueInOptionsParams {
+    /** 当前值（支持单个值或数组值） */
+    modelValue: any;
+    /** 选项数组 */
+    options: any[];
+    /** 表单项配置，用于获取组件类型等信息 */
+    formItem: {
+        compType: string;
+    };
+}
 /**
  * 检查当前值是否在新的选项中
  * 用于判断是否需要自动清理值：如果值在新的选项中，保留；否则清理
- * @param currentValue - 当前值
- * @param options - 选项数组
+ * @param params - 检查参数
  * @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;
+export declare function checkValueInOptions(params: CheckValueInOptionsParams): boolean;
 //# 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;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAMvE"}
+{"version":3,"file":"value.d.ts","sourceRoot":"","sources":["../../src/utils/value.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,qBAAqB;IACrB,UAAU,EAAE,GAAG,CAAA;IACf,WAAW;IACX,OAAO,EAAE,GAAG,EAAE,CAAA;IACd,wBAAwB;IACxB,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/B;AA4BD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CA+B9E"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iswangh/element-plus-kit-form",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Element Plus Kit 表单组件包",
   "license": "Apache-2.0",
   "sideEffects": [
@@ -31,10 +31,12 @@
     "vue": "^3.5.23"
   },
   "dependencies": {
-    "@iswangh/element-plus-kit-core": "0.1.3"
+    "lodash-es": "^4.17.21",
+    "@iswangh/element-plus-kit-core": "0.2.1"
   },
   "devDependencies": {
     "@element-plus/icons-vue": "^2.3.2",
+    "@types/lodash-es": "^4.17.12",
     "@vitejs/plugin-vue": "^6.0.1",
     "element-plus": "^2.11.8",
     "sass": "^1.94.0",
@@ -50,6 +52,6 @@
   "scripts": {
     "build": "vite build",
     "dev": "vite build --watch",
-    "type-check": "vue-tsc --noEmit"
+    "type-check": "vue-tsc --build"
   }
 }