@aoao-y33/ui 0.0.2 → 0.0.5

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

@@ -1,4 +1,24 @@
 import { Component } from 'vue';
+/**
+ * 布局组件注册表
+ * 存储布局类型与对应 Vue 组件的映射关系
+ * @example
+ * // 注册自定义布局组件
+ * addLayoutField('sidebar', SidebarLayoutComponent)
+ */
 export declare const layoutFields: Record<string, Component>;
+/**
+ * 注册新的布局类型组件
+ * 将自定义布局组件添加到布局类型注册表中
+ *
+ * @param type - 布局类型标识符（唯一）
+ * @param component - 对应的 Vue 组件
+ *
+ * @warning 如果类型已存在，会输出警告信息并阻止重复注册
+ *
+ * @example
+ * import CustomLayout from './CustomLayout.vue'
+ * addLayoutField('custom-layout', CustomLayout)
+ */
 export declare const addLayoutField: (type: string, component: Component) => void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAEnC,eAAO,MAAM,YAAY,EAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,CAAC;AAGzD,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,SAAS,SAMhE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/layout/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAM,CAAC;AAEzD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,WAAW,SAAS,SAMhE,CAAA"}

package/dist/modal/components/form-modal/props.d.ts

@@ -5,15 +5,50 @@ import { FieldsConfig } from '@aoao-y33/hooks';
 import { AxButtonOptions } from '../../../button';
 import { EmitsToProps } from 'vue';
 import { DrawerEmits } from 'element-plus';
+/**
+ * AxFormModal 表单弹窗组件属性接口
+ * 继承自 AxModalProps（弹窗属性）和 AxFormProps（表单属性），组合了弹窗和表单的双重功能
+ * @template T - 表单数据类型，必须是对象类型
+ */
 export interface AxFormModalProps<T extends Record<string, any> = any> extends AxModalProps, Omit<AxFormProps<T>, 'size'> {
 }
+/**
+ * AxFormModal 表单弹窗组件事件发射接口
+ * @template T - 表单数据类型
+ */
 export interface AxFormModalEmits<T extends Record<string, any> = any> {
+    /**
+     * 弹窗显示状态变化事件（用于 v-model:open 双向绑定）
+     * @param data - 新的显示状态（true/false）
+     */
     'update:open': [data: boolean];
+    /**
+     * 确认按钮点击事件，触发表单验证和提交
+     * @param data - 验证通过后的表单数据
+     */
     'confirm': [data: T];
+    /** 取消按钮点击事件或关闭弹窗时触发 */
     'cancel': [];
 }
-export interface AxFormModalOptions<T extends Record<string, any> = any> extends Omit<AxFormModalProps<T>, 'open'>, EmitsToProps<DrawerEmits>, EmitsToEventProps<AxFormModalEmits<T>> {
+/**
+ * AxFormModal 表单弹窗配置选项接口
+ * 整合了弹窗属性、表单属性、事件处理和字段配置
+ * @template T - 表单数据类型
+ */
+export interface AxFormModalOptions<T extends Record<string, any> = any> extends Omit<AxFormModalProps<T>, 'open'>, // 排除 open 属性（由内部状态管理）
+EmitsToProps<DrawerEmits>, // 合并 Element Plus Drawer 的事件属性
+EmitsToEventProps<AxFormModalEmits<T>> {
+    /**
+     * 按钮配置映射表，用于配置弹窗中的操作按钮（确认、取消等）
+     * @see FieldsConfig - 字段配置类型
+     * @see AxButtonOptions - 按钮选项类型
+     */
     buttonConfig?: FieldsConfig<AxButtonOptions>;
+    /**
+     * 表单项配置映射表，用于配置弹窗内表单的各个字段
+     * @see FieldsConfig - 字段配置类型
+     * @see AxFormItemOptions - 表单项选项类型
+     */
     fieldConfig?: FieldsConfig<AxFormItemOptions>;
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/modal/components/form-modal/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/modal/components/form-modal/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;CAExH;AAGD,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACjE,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC9B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACpB,QAAQ,EAAE,EAAE,CAAA;CACf;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CACnE,SAAQ,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EACrC,YAAY,CAAC,WAAW,CAAC,EACzB,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC1C,YAAY,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAA;IAC5C,WAAW,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;CAChD"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/modal/components/form-modal/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,KAAK,CAAC;AACtC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAE,SAAQ,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC;CAExH;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACjE;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAE9B;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAEpB,uBAAuB;IACvB,QAAQ,EAAE,EAAE,CAAA;CACf;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CACnE,SAAQ,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAG,sBAAsB;AAC9D,YAAY,CAAC,WAAW,CAAC,EAAe,+BAA+B;AACvE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAA;IAE5C;;;;OAIG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;CAChD"}

package/dist/modal/components/modal/props.d.ts

@@ -3,22 +3,64 @@ import { AxButtonOptions, AxButtonProps } from '../../../button';
 import { EmitsToEventProps } from '@aoao-y33/utils';
 import { Component, EmitsToProps } from 'vue';
 import { FieldsConfig } from '@aoao-y33/hooks';
+/**
+ * AxModal 弹窗组件属性接口
+ * 继承自 Element Plus DrawerProps，扩展了通用弹窗功能
+ * 支持 Drawer（抽屉）和 Dialog（对话框）两种展示模式
+ */
 export interface AxModalProps extends DrawerProps {
+    /**
+     * 弹窗类型，决定使用哪种展示形式
+     * - 'drawer': 抽屉式弹窗，从屏幕边缘滑出
+     * - 'dialog': 对话框式弹窗，居中显示
+     * @default 'drawer'
+     */
     type?: 'drawer' | 'dialog';
+    /** 弹窗标题，显示在弹窗顶部 */
     title?: string;
+    /** 弹窗的显示/隐藏状态，用于外部控制 */
     open?: boolean;
+    /** 自定义 CSS 类名，用于样式定制 */
     className?: string;
+    /** 确认按钮的配置项，用于自定义确认按钮的外观和行为 */
     confirmButton?: AxButtonProps;
+    /** 取消按钮的配置项，用于自定义取消按钮的外观和行为 */
     cancelButton?: AxButtonProps;
+    /** 是否使用默认配置，启用后将自动应用预设的弹窗样式和按钮 */
     isDefault?: boolean;
 }
+/**
+ * AxModal 弹窗组件事件发射接口
+ */
 export interface AxModalEmits {
+    /**
+     * 弹窗显示状态变化事件（用于 v-model:open 双向绑定）
+     * @param data - 新的显示状态（true/false）
+     */
     'update:open': [data: boolean];
+    /** 取消按钮点击或关闭弹窗时触发 */
     'cancel': [];
+    /** 确认按钮点击时触发 */
     'confirm': [];
 }
-export interface AxModalOptions extends Omit<AxModalProps, 'open'>, EmitsToEventProps<AxModalEmits>, EmitsToProps<DrawerEmits> {
+/**
+ * AxModal 弹窗配置选项接口
+ * 整合了弹窗属性、事件处理和动态内容配置
+ */
+export interface AxModalOptions extends Omit<AxModalProps, 'open'>, // 排除 open 属性（由内部状态管理）
+EmitsToEventProps<AxModalEmits>, // 合并自定义事件处理函数
+EmitsToProps<DrawerEmits> {
+    /**
+     * 动态渲染的组件，用于在弹窗内容区域显示自定义组件
+     * @example
+     * component: UserFormComponent
+     */
     component?: Component;
+    /**
+     * 按钮配置映射表，用于配置弹窗中的各种操作按钮
+     * @see FieldsConfig - 字段配置类型
+     * @see AxButtonOptions - 按钮选项类型
+     */
     buttonConfig?: FieldsConfig<AxButtonOptions>;
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/modal/components/modal/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/modal/components/modal/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,KAAK,CAAC;AACjD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAElD,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC7C,IAAI,CAAC,EAAC,QAAQ,GAAC,QAAQ,CAAC;IACxB,KAAK,CAAC,EAAC,MAAM,CAAA;IACb,IAAI,CAAC,EAAC,OAAO,CAAA;IACb,SAAS,CAAC,EAAC,MAAM,CAAA;IACjB,aAAa,CAAC,EAAC,aAAa,CAAA;IAC5B,YAAY,CAAC,EAAC,aAAa,CAAA;IAC3B,SAAS,CAAC,EAAC,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,aAAa,EAAC,CAAC,IAAI,EAAC,OAAO,CAAC,CAAC;IAC7B,QAAQ,EAAC,EAAE,CAAA;IACX,SAAS,EAAC,EAAE,CAAA;CACf;AAED,MAAM,WAAW,cACb,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAC9B,iBAAiB,CAAC,YAAY,CAAC,EAC/B,YAAY,CAAC,WAAW,CAAC;IAC7B,SAAS,CAAC,EAAC,SAAS,CAAC;IACrB,YAAY,CAAC,EAAC,YAAY,CAAC,eAAe,CAAC,CAAA;CAC9C"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/modal/components/modal/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,SAAS,EAAE,YAAY,EAAC,MAAM,KAAK,CAAC;AACjD,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC7C;;;;;OAKG;IACH,IAAI,CAAC,EAAC,QAAQ,GAAC,QAAQ,CAAC;IAExB,mBAAmB;IACnB,KAAK,CAAC,EAAC,MAAM,CAAA;IAEb,wBAAwB;IACxB,IAAI,CAAC,EAAC,OAAO,CAAA;IAEb,wBAAwB;IACxB,SAAS,CAAC,EAAC,MAAM,CAAA;IAEjB,+BAA+B;IAC/B,aAAa,CAAC,EAAC,aAAa,CAAA;IAE5B,+BAA+B;IAC/B,YAAY,CAAC,EAAC,aAAa,CAAA;IAE3B,kCAAkC;IAClC,SAAS,CAAC,EAAC,OAAO,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB;;;OAGG;IACH,aAAa,EAAC,CAAC,IAAI,EAAC,OAAO,CAAC,CAAC;IAE7B,qBAAqB;IACrB,QAAQ,EAAC,EAAE,CAAA;IAEX,gBAAgB;IAChB,SAAS,EAAC,EAAE,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cACb,SAAQ,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,EAAO,sBAAsB;AAC3D,iBAAiB,CAAC,YAAY,CAAC,EAAO,cAAc;AACpD,YAAY,CAAC,WAAW,CAAC;IAC7B;;;;OAIG;IACH,SAAS,CAAC,EAAC,SAAS,CAAC;IAErB;;;;OAIG;IACH,YAAY,CAAC,EAAC,YAAY,CAAC,eAAe,CAAC,CAAA;CAC9C"}

package/dist/modal/hoc/useFormModal.d.ts

@@ -3,11 +3,61 @@ import { FieldsApi, StateApi } from '@aoao-y33/hooks';
 import { AxButtonOptions } from '../../button';
 import { AxFormItemOptions, FormApi, FormFetchApi } from '../../form';
 import { Component } from 'vue';
+/**
+ * UseFormModal Hook 返回的 API 接口
+ * 整合了弹窗控制、表单操作和请求管理的完整功能集
+ * @template T - 表单数据类型
+ */
 export interface UseFormModalApi<T extends Record<string, any>> extends ModalApi, FormApi<T>, FormFetchApi<T> {
+    /**
+     * 打开弹窗的方法
+     * 调用后将显示表单弹窗
+     */
     readonly open: () => void;
+    /** 按钮组件池 API，用于管理弹窗中的操作按钮（确认、取消等） */
     readonly buttonsApi: FieldsApi<AxButtonOptions>;
+    /**
+     * 弹窗属性状态管理器
+     * 用于动态更新弹窗配置（不包含 buttonConfig 和 fieldConfig）
+     */
     readonly setModal: StateApi<Omit<AxFormModalOptions, 'buttonConfig' | 'fieldConfig'>>;
+    /** 表单项组件池 API，用于管理弹窗内表单的各个字段配置 */
     readonly fieldsApi: FieldsApi<AxFormItemOptions>;
 }
+/**
+ * 表单弹窗 Hook，用于创建集成了表单功能的弹窗组件
+ *
+ * 该 Hook 封装了弹窗和表单的组合逻辑，包括：
+ * - 弹窗显示/隐藏控制
+ * - 表单字段动态配置
+ * - 按钮动态配置
+ * - 表单验证和提交
+ * - 数据双向绑定
+ *
+ * @param options - 表单弹窗初始配置选项
+ * @returns [Modal 组件, FormModal API] 元组
+ *
+ * @example
+ * const [FormModal, modalApi] = useFormModal({
+ *   title: '编辑用户',
+ *   api: submitUserData,
+ *   fieldConfig: {
+ *     username: { label: '用户名', type: 'input', vtypes: ['required'] },
+ *     email: { label: '邮箱', type: 'input', vtypes: ['required', 'mail'] }
+ *   },
+ *   buttonConfig: {
+ *     confirm: { text: '保存' },
+ *     cancel: { text: '取消' }
+ *   }
+ * })
+ *
+ * // 在模板中使用
+ * <FormModal />
+ *
+ * // 通过 API 控制弹窗
+ * modalApi.open()           // 打开弹窗
+ * modalApi.fieldsApi.addField('phone', { label: '电话', type: 'input' })
+ * modalApi.requestApi.submit()
+ */
 export declare function useFormModal<T extends Record<string, any> = any>(options?: AxFormModalOptions<T>): [Component, UseFormModalApi<T>];
 //# sourceMappingURL=useFormModal.d.ts.map

package/dist/modal/hoc/useFormModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormModal.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useFormModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,kBAAkB,EAA+B,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAC,KAAK,SAAS,EAAE,KAAK,QAAQ,EAA6B,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAW,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACxD,OAAO,EAAa,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,QAAQ,CAAC;AACxH,OAAO,EAAC,KAAK,SAAS,EAA0B,MAAM,KAAK,CAAC;AAE5D,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IACzG,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,eAAe,CAAC,CAAA;IAC/C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAA;IACrF,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAA;CACnD;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAoCtI"}
+{"version":3,"file":"useFormModal.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useFormModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,kBAAkB,EAA+B,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AAC5F,OAAO,EAAC,KAAK,SAAS,EAAE,KAAK,QAAQ,EAA6B,MAAM,iBAAiB,CAAC;AAE1F,OAAO,EAAW,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AACxD,OAAO,EAAa,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,QAAQ,CAAC;AACxH,OAAO,EAAC,KAAK,SAAS,EAA0B,MAAM,KAAK,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC;IACzG;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAE1B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,eAAe,CAAC,CAAA;IAE/C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,GAAG,aAAa,CAAC,CAAC,CAAA;IAErF,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,iBAAiB,CAAC,CAAA;CACnD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAAG,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,CAAC,CAAC,CAwEtI"}

package/dist/modal/hoc/useModal.d.ts

@@ -2,11 +2,66 @@ import { AxModalOptions, ModalApi } from '..';
 import { FieldsApi, StateApi } from '@aoao-y33/hooks';
 import { Component } from 'vue';
 import { AxButtonOptions } from '../../button';
+/**
+ * UseModal Hook 返回的 API 接口
+ * 提供完整的弹窗控制和内容管理能力
+ */
 export interface UseModalApi extends ModalApi {
+    /**
+     * 打开弹窗的方法
+     * 调用后将显示弹窗
+     */
     readonly open: () => void;
+    /** 按钮组件池 API，用于管理弹窗中的操作按钮（确认、取消等） */
     readonly buttonsApi: FieldsApi<AxButtonOptions>;
+    /**
+     * 弹窗属性状态管理器
+     * 用于动态更新弹窗配置（不包含 buttonConfig 和 component）
+     */
     readonly setModal: StateApi<Omit<AxModalOptions, 'buttonConfig' | 'component'>>;
+    /**
+     * 获取弹窗内动态组件实例的方法
+     * @returns 组件实例引用，可用于访问子组件的方法和属性
+     */
     readonly getComponent: () => any;
 }
+/**
+ * 通用弹窗 Hook，用于创建可配置的弹窗组件
+ *
+ * 该 Hook 封装了弹窗的核心逻辑，包括：
+ * - 弹窗显示/隐藏控制
+ * - 动态组件渲染（支持自定义内容组件）
+ * - 按钮动态配置
+ * - 弹窗状态管理
+ * - 组件实例访问
+ *
+ * @param options - 弹窗初始配置选项
+ * @returns [Modal 组件, Modal API] 元组
+ *
+ * @example
+ * // 基础用法
+ * const [Modal, modalApi] = useModal({
+ *   title: '提示',
+ *   type: 'dialog'
+ * })
+ *
+ * // 带自定义组件的用法
+ * import UserDetail from './UserDetail.vue'
+ * const [Modal, modalApi] = useModal({
+ *   title: '用户详情',
+ *   component: UserDetail,
+ *   buttonConfig: {
+ *     confirm: { text: '关闭' }
+ *   }
+ * })
+ *
+ * // 在模板中使用
+ * <Modal />
+ *
+ * // 通过 API 控制弹窗
+ * modalApi.open()                    // 打开弹窗
+ * modalApi.getComponent()            // 获取内部组件实例
+ * modalApi.setModal({ title: '新标题' })  // 动态修改弹窗属性
+ */
 export declare function useModal(options?: AxModalOptions): [Component, UseModalApi];
 //# sourceMappingURL=useModal.d.ts.map

package/dist/modal/hoc/useModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AACpE,OAAO,EAAC,KAAK,SAAS,EAAE,KAAK,QAAQ,EAA6B,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAC,KAAK,SAAS,EAAsC,MAAM,KAAK,CAAC;AAExE,OAAO,EAAW,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AAGxD,MAAM,WAAW,WAAY,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAC,SAAS,CAAC,eAAe,CAAC,CAAA;IAC9C,QAAQ,CAAC,QAAQ,EAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAC,WAAW,CAAC,CAAC,CAAA;IAC5E,QAAQ,CAAC,YAAY,EAAC,MAAI,GAAG,CAAA;CAChC;AACD,wBAAgB,QAAQ,CAAC,OAAO,GAAE,cAAmB,GAAE,CAAC,SAAS,EAAC,WAAW,CAAC,CAqC7E"}
+{"version":3,"file":"useModal.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useModal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAC,MAAM,SAAS,CAAC;AACpE,OAAO,EAAC,KAAK,SAAS,EAAE,KAAK,QAAQ,EAA6B,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAC,KAAK,SAAS,EAAsC,MAAM,KAAK,CAAC;AAExE,OAAO,EAAW,KAAK,eAAe,EAAC,MAAM,UAAU,CAAC;AAGxD;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,QAAQ;IACzC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC;IAE1B,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,eAAe,CAAC,CAAA;IAE/C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,WAAW,CAAC,CAAC,CAAA;IAE/E;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,QAAQ,CAAC,OAAO,GAAE,cAAmB,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CA8E/E"}

package/dist/modal/hoc/useModalExpose.d.ts

@@ -1,6 +1,30 @@
 import { Ref } from 'vue';
 import { AxModalInstance } from '..';
+/**
+ * ModalApi 类型定义
+ * 由 useModalExpose 函数返回的 API 对象类型
+ */
 export type ModalApi = ReturnType<typeof useModalExpose>;
+/**
+ * 弹窗暴露 API Hook，用于获取和控制弹窗实例的方法
+ *
+ * 该 Hook 提供了访问底层弹窗实例的能力，包括：
+ * - 关闭弹窗
+ * - 获取原生弹窗组件实例
+ *
+ * @param modal - 弹窗组件的 Ref 引用，指向 AxModalInstance 实例
+ * @returns 包含弹窗控制方法的 API 对象
+ *
+ * @example
+ * const modalRef = ref<AxModalInstance>();
+ * const modalApi = useModalExpose(modalRef);
+ *
+ * // 关闭弹窗
+ * modalApi.close()
+ *
+ * // 获取原生弹窗实例（如 Element Plus 的 Drawer/Dialog 实例）
+ * const instance = modalApi.getModal()
+ */
 export declare function useModalExpose(modal: Ref<AxModalInstance>): {
     close: () => void;
     getModal: () => import('element-plus').DrawerInstance | undefined;

package/dist/modal/hoc/useModalExpose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useModalExpose.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useModalExpose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACzD,wBAAgB,cAAc,CAAC,KAAK,EAAC,GAAG,CAAC,eAAe,CAAC;;;EAYxD"}
+{"version":3,"file":"useModalExpose.d.ts","sourceRoot":"","sources":["../../../src/modal/hoc/useModalExpose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,GAAG,EAAC,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAC,GAAG,CAAC,eAAe,CAAC;;;EAsBxD"}

package/dist/table/components/table/props.d.ts

@@ -2,42 +2,117 @@ import { TableProps } from 'element-plus';
 import { FetchOptions, FieldsConfig, RequestFetch } from '@aoao-y33/hooks';
 import { AxTableColumnsProps, AxTablePageOptions, AxTableSelectOptions } from '../..';
 import { AxButtonOptions } from '../../../button';
+/**
+ * 分页数据结构
+ * 用于封装分页查询返回的数据格式
+ * @template T - 列表项数据类型
+ */
 export interface PageData<T> {
+    /** 数据总条数 */
     total: number;
+    /** 当前页的数据列表 */
     list: T[];
+    /** 当前页码 */
     currentPage: number;
+    /** 每页显示条数 */
     currentSize: number;
 }
+/**
+ * AxTable 表格组件属性接口
+ * 继承自 Element Plus TableProps，扩展了数据请求和分页功能
+ * @template T - 表格行数据类型，必须是对象类型
+ */
 export interface AxTableProps<T extends Record<string, any> = any> extends Partial<TableProps<T>> {
+    /**
+     * 表格数据源（本地数据）
+     * 如果提供了 api，则优先使用 api 获取数据
+     */
     data?: T[];
+    /**
+     * API 请求函数，用于从服务器获取表格数据
+     * 支持返回普通数组或分页数据结构
+     * @see RequestFetch - 请求函数类型
+     */
     api?: RequestFetch<any, T[] | PageData<T>>;
+    /**
+     * API 请求配置项，包含请求参数、拦截器、转换函数等配置
+     * @see FetchOptions - 请求配置选项类型
+     */
     apiConfig?: FetchOptions<any, T[] | PageData<T>>;
 }
+/**
+ * AxTable 表格组件事件发射接口
+ * 封装了 Element Plus Table 的所有事件
+ * @template T - 表格行数据类型
+ */
 export interface AxTableEmits<T extends Record<string, any> = any> {
+    /** 滚动事件 */
     onScroll?: ((...args: T[]) => any) | undefined;
+    /** 选择行事件（点击复选框） */
     onSelect?: ((...args: T[]) => any) | undefined;
+    /** 展开行变化事件 */
     "onExpand-change"?: ((...args: T[]) => any) | undefined;
+    /** 当前页变化事件（分页） */
     "onCurrent-change"?: ((...args: T[]) => any) | undefined;
+    /** 全选事件 */
     "onSelect-all"?: ((...args: T[]) => any) | undefined;
+    /** 选中项变化事件 */
     "onSelection-change"?: ((...args: T[]) => any) | undefined;
+    /** 单元格鼠标进入事件 */
     "onCell-mouse-enter"?: ((...args: T[]) => any) | undefined;
+    /** 单元格鼠标离开事件 */
     "onCell-mouse-leave"?: ((...args: T[]) => any) | undefined;
+    /** 单元格右键菜单事件 */
     "onCell-contextmenu"?: ((...args: T[]) => any) | undefined;
+    /** 单元格单击事件 */
     "onCell-click"?: ((...args: T[]) => any) | undefined;
+    /** 单元格双击事件 */
     "onCell-dblclick"?: ((...args: T[]) => any) | undefined;
+    /** 行单击事件 */
     "onRow-click"?: ((...args: T[]) => any) | undefined;
+    /** 行右键菜单事件 */
     "onRow-contextmenu"?: ((...args: T[]) => any) | undefined;
+    /** 行双击事件 */
     "onRow-dblclick"?: ((...args: T[]) => any) | undefined;
+    /** 表头单击事件 */
     "onHeader-click"?: ((...args: T[]) => any) | undefined;
+    /** 表头右键菜单事件 */
     "onHeader-contextmenu"?: ((...args: T[]) => any) | undefined;
+    /** 排序变化事件 */
     "onSort-change"?: ((...args: T[]) => any) | undefined;
+    /** 筛选变化事件 */
     "onFilter-change"?: ((...args: T[]) => any) | undefined;
+    /** 表头拖拽结束事件 */
     "onHeader-dragend"?: ((...args: T[]) => any) | undefined;
 }
+/**
+ * AxTable 表格配置选项接口
+ * 整合了表格属性、事件、列配置、分页配置、工具栏和搜索配置
+ * @template T - 表格行数据类型
+ * @template R - 搜索条件数据类型
+ */
 export interface AxTableOptions<T extends Record<string, any> = any, R extends Record<string, any> = any> extends AxTableProps<T>, AxTableEmits<T>, AxTableEmits<T> {
+    /**
+     * 表格列配置映射表，用于定义表格的各个列（字段名、宽度、渲染方式等）
+     * @see FieldsConfig - 字段配置类型
+     * @see AxTableColumnsProps - 表格列属性类型
+     */
     columnConfig?: FieldsConfig<AxTableColumnsProps>;
+    /**
+     * 分页配置项，用于配置分页组件的显示和行为
+     * @see AxTablePageOptions - 分页选项类型
+     */
     pageConfig?: AxTablePageOptions;
+    /**
+     * 工具栏按钮配置映射表，用于配置表格上方的操作按钮（新增、删除、导出等）
+     * @see FieldsConfig - 字段配置类型
+     * @see AxButtonOptions - 按钮选项类型
+     */
     toolConfig?: FieldsConfig<AxButtonOptions>;
+    /**
+     * 搜索区域配置项，用于配置表格上方的搜索表单
+     * @see AxTableSelectOptions - 表格搜索选项类型
+     */
     searchConfig?: AxTableSelectOptions<R>;
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/table/components/table/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table/props.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table/props.ts"],"names":[],"mappings":"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"}

package/dist/table/components/table-column/props.d.ts

@@ -1,6 +1,25 @@
 import { TableColumnCtx } from 'element-plus';
+/**
+ * AxTableColumns 表格列组件属性接口
+ * 继承自 Element Plus TableColumnCtx，扩展了自定义列类型和组件配置功能
+ * @template T - 表格行数据类型，必须是对象类型
+ */
 export interface AxTableColumnsProps<T extends Record<string, any> = any> extends Partial<TableColumnCtx<T>> {
+    /**
+     * 列类型，决定该列的渲染方式
+     * @example
+     * - 'index': 索引列（显示行号）
+     * - 'selection': 选择列（复选框）
+     * - 'expand': 展开列（展开行内容）
+     * - 'custom': 自定义列（使用自定义组件渲染）
+     */
     type?: string;
+    /**
+     * 自定义组件的属性配置
+     * 当列使用自定义组件渲染时，透传给该组件的属性
+     * @example
+     * componentProps: { color: 'red', size: 'large' }
+     */
     componentProps?: Record<string, any>;
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/table/components/table-column/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-column/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAE,GAAG,CAAE,SAAQ,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvG,IAAI,CAAC,EAAC,MAAM,CAAC;IACb,cAAc,CAAC,EAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACtC"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-column/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAE,GAAG,CAAE,SAAQ,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACvG;;;;;;;OAOG;IACH,IAAI,CAAC,EAAC,MAAM,CAAC;IAEb;;;;;OAKG;IACH,cAAc,CAAC,EAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CACtC"}

package/dist/table/components/table-page/props.d.ts

@@ -1,13 +1,44 @@
 import { PaginationProps } from 'element-plus';
 import { EmitsToEventProps } from '@aoao-y33/utils';
+/**
+ * AxTablePage 表格分页组件属性接口
+ * 继承自 Element Plus PaginationProps，扩展了自定义参数名配置
+ */
 export interface AxTablePageProps extends Partial<PaginationProps> {
+    /**
+     * 页码参数名
+     * 用于自定义发送给后端的页码字段名称
+     * @default 'pageNum' 或 'page'
+     * @example 'currentPage', 'pageIndex'
+     */
     paramNo?: string;
+    /**
+     * 每页条数参数名
+     * 用于自定义发送给后端的每页显示数量字段名称
+     * @default 'pageSize' 或 'size'
+     * @example 'currentSize', 'limit'
+     */
     paramSize?: string;
 }
+/**
+ * AxTablePage 表格分页组件事件发射接口
+ */
 export interface AxTablePageEmits {
+    /**
+     * 页码变化事件
+     * @param data - 新的页码值
+     */
     'change-page': [data: number];
+    /**
+     * 每页显示条数变化事件
+     * @param data - 新的每页条数值
+     */
     'change-size': [data: number];
 }
+/**
+ * AxTablePage 表格分页配置选项接口
+ * 整合了分页属性和事件处理函数
+ */
 export interface AxTablePageOptions extends AxTablePageProps, Partial<EmitsToEventProps<AxTablePageEmits>> {
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/table/components/table-page/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-page/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAEvD,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC7B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC7B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAChC;AAED,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CACzG"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-page/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,OAAO,CAAC,eAAe,CAAC;IAC9D;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAE7B;;;OAGG;IACH,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB,EAAE,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CACzG"}

package/dist/table/components/table-select/props.d.ts

@@ -3,19 +3,68 @@ import { AxButtonOptions, AxButtonProps } from '../../../button';
 import { FieldsConfig } from '@aoao-y33/hooks';
 import { EmitsToEventProps } from '@aoao-y33/utils';
 import { Component } from 'vue';
+/**
+ * AxTableSelect 表格搜索组件属性接口
+ * 继承自 AxFormProps，排除了 api 和 apiConfig（搜索组件不直接处理数据提交）
+ * 用于配置表格上方的搜索表单区域
+ */
 export interface AxTableSelectProps extends Omit<AxFormProps, 'api' | 'apiConfig'> {
+    /** 重置按钮的配置项，用于自定义重置按钮的外观和行为 */
     resetButton?: AxButtonProps;
+    /**
+     * 是否启用折叠功能
+     * 当搜索字段较多时，可以折叠显示部分字段，提升界面简洁度
+     * @default false
+     */
     isRest?: boolean;
 }
+/**
+ * AxTableSelect 表格搜索组件事件发射接口
+ * @template T - 搜索条件数据类型
+ */
 export interface AxTableSelectEmits<T extends Record<string, any> = any> {
+    /**
+     * 搜索事件，点击搜索按钮或触发搜索时发射
+     * @param data - 当前搜索表单的数据
+     */
     search: [data: T];
+    /** 重置事件，点击重置按钮时发射，清空所有搜索条件 */
     reset: [];
+    /**
+     * 搜索条件变化事件，表单字段值改变时实时发射
+     * @param data - 变化后的搜索数据
+     */
     change: [data: T];
 }
+/**
+ * AxTableSelect 表格搜索配置选项接口
+ * 整合了搜索表单属性、事件、字段配置、按钮配置和扩展插槽
+ * @template T - 搜索条件数据类型
+ */
 export interface AxTableSelectOptions<T extends Record<string, any> = any> extends AxTableSelectProps, Partial<EmitsToEventProps<AxTableSelectEmits<T>>> {
+    /**
+     * 搜索字段配置映射表，用于定义搜索表单中的各个字段（输入框、下拉框、日期选择器等）
+     * @see FieldsConfig - 字段配置类型
+     * @see AxFormItemOptions - 表单项选项类型
+     */
     fieldConfig?: FieldsConfig<AxFormItemOptions>;
+    /**
+     * 按钮配置映射表，用于配置搜索区域的按钮（搜索、重置等）
+     * @see FieldsConfig - 字段配置类型
+     * @see AxButtonOptions - 按钮选项类型
+     */
     buttonConfig?: FieldsConfig<AxButtonOptions>;
+    /**
+     * 展开插槽组件，用于在搜索区域展开显示额外的内容或高级搜索选项
+     * @example
+     * expandSlot: AdvancedSearchComponent
+     */
     expandSlot?: Component;
+    /**
+     * 折叠阈值，控制超过多少个字段后自动启用折叠功能
+     * @default 3 或 4
+     * @example over: 2  // 超过2个字段时显示展开/折叠按钮
+     */
     over?: number;
 }
 //# sourceMappingURL=props.d.ts.map

package/dist/table/components/table-select/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-select/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAEnC,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,WAAW,CAAC;IAC9E,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACnE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IACjB,KAAK,EAAE,EAAE,CAAA;IACT,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CACrE,SAAQ,kBAAkB,EAAE,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E,WAAW,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;IAC7C,YAAY,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAA;IAC5C,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../../src/table/components/table-select/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,iBAAiB,EAAE,WAAW,EAAC,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EAAC,eAAe,EAAE,aAAa,EAAC,MAAM,UAAU,CAAC;AAC7D,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAC,iBAAiB,EAAC,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,KAAK,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,WAAW,EAAE,KAAK,GAAG,WAAW,CAAC;IAC9E,+BAA+B;IAC/B,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IACnE;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;IAEjB,8BAA8B;IAC9B,KAAK,EAAE,EAAE,CAAA;IAET;;;OAGG;IACH,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CACrE,SAAQ,kBAAkB,EAAE,OAAO,CAAC,iBAAiB,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7E;;;;OAIG;IACH,WAAW,CAAC,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAAA;IAE7C;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC,eAAe,CAAC,CAAA;IAE5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAA;IAEtB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CAChB"}