easy-ep-ui 0.1.1 → 0.1.2

package/lib/components/ee-form-table/src/hooks/useForm.d.ts

@@ -4,7 +4,7 @@ import { DrawerConfig } from '../../types';
  * @param props.drawerConfig - 抽屉/弹窗的外观配置
  * @param props.rowKey - 数据行的唯一键（用于编辑时取 ID）
  * @returns formVisible - 表单是否显示
- * @returns isEditing - 是否为编辑模式（false 为新增）
+ * @returns formMode - 表单模式：add | edit | view
  * @returns editingRow - 当前编辑的行数据（新增时为 null）
  * @returns formData - 表单绑定的数据对象
  * @returns saving - 是否正在保存（加载状态）
@@ -12,6 +12,7 @@ import { DrawerConfig } from '../../types';
  * @returns drawerCfg - 合并默认值后的配置
  * @returns openAdd - 打开新增表单
  * @returns openEdit - 打开编辑表单
+ * @returns openView - 打开查看表单
  * @returns closeForm - 关闭表单
  */
 export declare function useForm(props: {
@@ -19,7 +20,7 @@ export declare function useForm(props: {
     rowKey?: string;
 }): {
     formVisible: ReturnType<typeof ref<boolean>>;
-    isEditing: ReturnType<typeof ref<boolean>>;
+    formMode: ReturnType<typeof ref<'add' | 'edit' | 'view'>>;
     editingRow: ReturnType<typeof ref<Record<string, unknown> | null>>;
     formData: ReturnType<typeof ref<Record<string, unknown>>>;
     saving: ReturnType<typeof ref<boolean>>;
@@ -27,5 +28,6 @@ export declare function useForm(props: {
     drawerCfg: DrawerConfig;
     openAdd: () => void;
     openEdit: (row: Record<string, unknown>) => void;
+    openView: (row: Record<string, unknown>) => void;
     closeForm: () => void;
 };

package/lib/components/ee-form-table/src/index.vue.d.ts

@@ -31,7 +31,7 @@ declare function __VLS_template(): {
         row: import('element-plus/es/components/table/src/table/defaults.mjs').DefaultRow;
         index: number;
         column: TableColumn;
-    }) => any>> & Partial<Record<string, (_: any) => any>> & {
+    }) => any>> & {
         'search-action'?(_: {
             params: Record<string, unknown>;
         }): any;
@@ -43,6 +43,18 @@ declare function __VLS_template(): {
             row: import('element-plus/es/components/table/src/table/defaults.mjs').DefaultRow;
         }): any;
         empty?(_: {}): any;
+        'add-form'?(_: {
+            row: Record<string, unknown> | null;
+            formData: Record<string, unknown>;
+        }): any;
+        'edit-form'?(_: {
+            row: Record<string, unknown> | null;
+            formData: Record<string, unknown>;
+        }): any;
+        'view-form'?(_: {
+            row: Record<string, unknown> | null;
+            formData: Record<string, unknown>;
+        }): any;
     };
     refs: {
         tableRef: {

package/lib/components/ee-form-table/types.d.ts

@@ -23,6 +23,8 @@ export type ExportMode = 'current' | 'all';
 export type SearchFieldType = 'input' | 'number' | 'select' | 'radio' | 'checkbox' | 'date' | 'date-range' | 'textarea';
 /** Element Plus 按钮类型 */
 export type ButtonType = 'primary' | 'success' | 'warning' | 'danger' | 'info' | 'default';
+/** 表单字段控件类型 */
+export type FormFieldType = 'input' | 'number' | 'select' | 'radio' | 'checkbox' | 'date' | 'date-range' | 'textarea' | 'switch';
 export interface DictOption {
     value: string | number;
     label: string;
@@ -37,6 +39,37 @@ export interface ColumnSearchItem {
     props?: Record<string, unknown>;
     field?: string;
 }
+export interface ColumnFormItem {
+    /** 是否在新增表单中展示（默认 true） */
+    add?: boolean;
+    /** 是否在编辑表单中展示（默认同 add） */
+    edit?: boolean;
+    /** 表单控件类型，默认 'input' */
+    type?: FormFieldType;
+    /** 占位符 */
+    placeholder?: string;
+    /** 静态选项（select/radio/checkbox） */
+    options?: {
+        value: any;
+        label: string;
+    }[];
+    /** 字典 key（优先于 options） */
+    dictKey?: string;
+    /** 透传给控件的 props */
+    props?: Record<string, unknown>;
+    /** Element Plus 校验规则 */
+    rules?: Record<string, unknown>[];
+    /** 栅格跨列数（默认 1） */
+    colSpan?: number;
+    /** 必填标记（自动加 required 校验） */
+    required?: boolean;
+    /** 编辑时只读 */
+    readonly?: boolean;
+    /** 新增时的默认值 */
+    defaultValue?: unknown;
+    /** 强制隐藏 */
+    hide?: boolean;
+}
 export interface TableColumn {
     prop: string;
     label: string;
@@ -50,6 +83,7 @@ export interface TableColumn {
     dictKey?: string;
     slotName?: string;
     search?: ColumnSearchItem;
+    form?: ColumnFormItem;
     auth?: string;
     children?: TableColumn[];
     [key: string]: unknown;
@@ -158,6 +192,13 @@ export interface DrawerConfig {
     closeOnReset?: boolean;
     addTitle?: string;
     editTitle?: string;
+    viewTitle?: string;
+    /** 表单每行展示列数（默认 2） */
+    formCols?: number;
+    /** 表单标签宽度（默认 '80px'） */
+    formLabelWidth?: string;
+    /** 表单组件尺寸 */
+    formSize?: ComponentSize;
 }
 export interface ColumnSettingConfig {
     show?: boolean;

package/lib/components/ee-remote-select/index.d.ts

@@ -0,0 +1,2 @@
+import { default as EeRemoteSelect } from './src/index.vue';
+export default EeRemoteSelect;

package/lib/components/ee-remote-select/src/index.vue.d.ts

@@ -0,0 +1,30 @@
+import { EeRemoteSelectProps } from '../type';
+declare const _default: import('vue').DefineComponent<EeRemoteSelectProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    search: (keyword: string) => any;
+    clear: () => any;
+    "update:modelValue": (val: string | number | (string | number)[]) => any;
+    change: (val: string | number | (string | number)[]) => any;
+    blur: (evt: FocusEvent) => any;
+    focus: (evt: FocusEvent) => any;
+    "load-success": (options: any[]) => any;
+}, string, import('vue').PublicProps, Readonly<EeRemoteSelectProps> & Readonly<{
+    onSearch?: ((keyword: string) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onChange?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onBlur?: ((evt: FocusEvent) => any) | undefined;
+    onFocus?: ((evt: FocusEvent) => any) | undefined;
+    "onLoad-success"?: ((options: any[]) => any) | undefined;
+}>, {
+    pageNumKey: string;
+    pageSizeKey: string;
+    pageSize: number;
+    searchKey: string;
+    labelField: string;
+    valueField: string;
+    size: "large" | "default" | "small";
+    mode: "single" | "multiple";
+    clearable: boolean;
+    filterable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/lib/components/ee-remote-select/type.d.ts

@@ -0,0 +1,53 @@
+import { AxiosInstance } from 'axios';
+import { DictOption } from '../../utils/types';
+/** EeRemoteSelect 组件属性 */
+export interface EeRemoteSelectProps {
+    /** 双向绑定值 */
+    modelValue?: string | number | (string | number)[];
+    /** 远程列表查询接口地址（必填） */
+    apiUrl: string;
+    /** ID 回显详情查询接口地址（必填） */
+    detailEchoUrl: string;
+    /** 选择模式，默认 single */
+    mode?: 'single' | 'multiple';
+    /** 选项 label 字段名，默认 label */
+    labelField?: string;
+    /** 选项 value 字段名，默认 value */
+    valueField?: string;
+    /** 搜索关键词参数字段名，默认 keyword */
+    searchKey?: string;
+    /** 分页页码字段名，默认 pageNum */
+    pageNumKey?: string;
+    /** 分页条数字段名，默认 pageSize */
+    pageSizeKey?: string;
+    /** 每页条数，默认 20 */
+    pageSize?: number;
+    /** 固定附加请求参数 */
+    extraParams?: Record<string, any>;
+    /** 外部 axios 请求实例，不传则从全局配置获取 */
+    requestInstance?: AxiosInstance;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否可清空，默认 true */
+    clearable?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否可搜索过滤，默认 true */
+    filterable?: boolean;
+    /** 组件尺寸 */
+    size?: 'large' | 'default' | 'small';
+    /** 静态选项数据，优先级最高，传入后不走接口 */
+    options?: DictOption[];
+}
+/** EeRemoteSelect 组件事件 */
+export interface EeRemoteSelectEmits {
+    (e: 'update:modelValue', val: string | number | (string | number)[]): void;
+    (e: 'change', val: string | number | (string | number)[]): void;
+    (e: 'clear'): void;
+    (e: 'blur', evt: FocusEvent): void;
+    (e: 'focus', evt: FocusEvent): void;
+    (e: 'search', keyword: string): void;
+    (e: 'load-success', options: any[]): void;
+}

package/lib/components/ee-role-select/index.d.ts

@@ -0,0 +1,2 @@
+import { default as EeRoleSelect } from './src/index.vue';
+export default EeRoleSelect;

package/lib/components/ee-role-select/src/index.vue.d.ts

@@ -0,0 +1,29 @@
+import { EeRoleSelectProps } from '../type';
+declare const _default: import('vue').DefineComponent<EeRoleSelectProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    search: (keyword: string) => any;
+    clear: () => any;
+    "update:modelValue": (val: string | number | (string | number)[]) => any;
+    change: (val: string | number | (string | number)[]) => any;
+    blur: (evt: FocusEvent) => any;
+    focus: (evt: FocusEvent) => any;
+    "load-success": (options: any[]) => any;
+}, string, import('vue').PublicProps, Readonly<EeRoleSelectProps> & Readonly<{
+    onSearch?: ((keyword: string) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onChange?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onBlur?: ((evt: FocusEvent) => any) | undefined;
+    onFocus?: ((evt: FocusEvent) => any) | undefined;
+    "onLoad-success"?: ((options: any[]) => any) | undefined;
+}>, {
+    apiUrl: string;
+    searchKey: string;
+    labelField: string;
+    valueField: string;
+    size: "large" | "default" | "small";
+    detailEchoUrl: string;
+    mode: "single" | "multiple";
+    clearable: boolean;
+    filterable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/lib/components/ee-role-select/type.d.ts

@@ -0,0 +1,44 @@
+import { AxiosInstance } from 'axios';
+/** EeRoleSelect 组件属性 */
+export interface EeRoleSelectProps {
+    /** 双向绑定值 */
+    modelValue?: string | number | (string | number)[];
+    /** 自定义角色列表接口地址，覆盖默认接口 */
+    apiUrl?: string;
+    /** 自定义角色详情回显接口地址 */
+    detailEchoUrl?: string;
+    /** 选择模式，默认 single */
+    mode?: 'single' | 'multiple';
+    /** 选项 label 字段名，默认 label */
+    labelField?: string;
+    /** 选项 value 字段名，默认 value */
+    valueField?: string;
+    /** 搜索关键词参数字段名，默认 keyword */
+    searchKey?: string;
+    /** 固定附加请求参数 */
+    extraParams?: Record<string, any>;
+    /** 外部 axios 请求实例，不传则从全局配置获取 */
+    requestInstance?: AxiosInstance;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否可清空，默认 true */
+    clearable?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否可搜索过滤，默认 true */
+    filterable?: boolean;
+    /** 组件尺寸 */
+    size?: 'large' | 'default' | 'small';
+}
+/** EeRoleSelect 组件事件 */
+export interface EeRoleSelectEmits {
+    (e: 'update:modelValue', val: string | number | (string | number)[]): void;
+    (e: 'change', val: string | number | (string | number)[]): void;
+    (e: 'clear'): void;
+    (e: 'blur', evt: FocusEvent): void;
+    (e: 'focus', evt: FocusEvent): void;
+    (e: 'search', keyword: string): void;
+    (e: 'load-success', options: any[]): void;
+}

package/lib/components/ee-search-bar/src/index.vue.d.ts

@@ -9,12 +9,12 @@ type __VLS_Props = {
     size?: 'large' | 'default' | 'small';
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
-    "update:modelValue": (val: Record<string, any>) => any;
     search: (val: Record<string, any>) => any;
+    "update:modelValue": (val: Record<string, any>) => any;
     reset: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    "onUpdate:modelValue"?: ((val: Record<string, any>) => any) | undefined;
     onSearch?: ((val: Record<string, any>) => any) | undefined;
+    "onUpdate:modelValue"?: ((val: Record<string, any>) => any) | undefined;
     onReset?: (() => any) | undefined;
 }>, {
     size: "large" | "default" | "small";
@@ -60,10 +60,45 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
         $options: import('vue').ComponentOptionsBase<Readonly<import('element-plus').FormProps> & Readonly<{
             onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
         }>, {
-            validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
-            validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
-            resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
-            clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            validate: (callback
+            /**
+             * EeSearchBar 搜索栏组件
+             *
+             * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+             * 搜索/重置按钮、字段显隐控制。
+             */
+            ?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            validateField: (props
+            /**
+             * EeSearchBar 搜索栏组件
+             *
+             * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+             * 搜索/重置按钮、字段显隐控制。
+             */
+            ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback
+            /**
+             * EeSearchBar 搜索栏组件
+             *
+             * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+             * 搜索/重置按钮、字段显隐控制。
+             */
+            ?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+            resetFields: (props
+            /**
+             * EeSearchBar 搜索栏组件
+             *
+             * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+             * 搜索/重置按钮、字段显隐控制。
+             */
+            ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+            clearValidate: (props
+            /**
+             * EeSearchBar 搜索栏组件
+             *
+             * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+             * 搜索/重置按钮、字段显隐控制。
+             */
+            ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
             scrollToField: (prop: import('element-plus').FormItemProp) => void;
             getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
             fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;
@@ -109,10 +144,45 @@ declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {
     }> & Omit<Readonly<import('element-plus').FormProps> & Readonly<{
         onValidate?: ((prop: import('element-plus').FormItemProp, isValid: boolean, message: string) => any) | undefined;
     }>, "fields" | "labelWidth" | "labelPosition" | "requireAsteriskPosition" | "labelSuffix" | "showMessage" | "validateOnRuleChange" | "scrollIntoViewOptions" | "validate" | "validateField" | "resetFields" | "clearValidate" | "scrollToField" | "getField" | "setInitialValues"> & {
-        validate: (callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
-        validateField: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
-        resetFields: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
-        clearValidate: (props?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        validate: (callback
+        /**
+         * EeSearchBar 搜索栏组件
+         *
+         * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+         * 搜索/重置按钮、字段显隐控制。
+         */
+        ?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        validateField: (props
+        /**
+         * EeSearchBar 搜索栏组件
+         *
+         * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+         * 搜索/重置按钮、字段显隐控制。
+         */
+        ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>, callback
+        /**
+         * EeSearchBar 搜索栏组件
+         *
+         * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+         * 搜索/重置按钮、字段显隐控制。
+         */
+        ?: import('element-plus').FormValidateCallback) => import('element-plus').FormValidationResult;
+        resetFields: (props
+        /**
+         * EeSearchBar 搜索栏组件
+         *
+         * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+         * 搜索/重置按钮、字段显隐控制。
+         */
+        ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
+        clearValidate: (props
+        /**
+         * EeSearchBar 搜索栏组件
+         *
+         * 基于 el-form 封装的搜索栏，支持多字段类型（input/select/datepicker）、
+         * 搜索/重置按钮、字段显隐控制。
+         */
+        ?: import('element-plus/es/utils/typescript.mjs').Arrayable<import('element-plus').FormItemProp>) => void;
         scrollToField: (prop: import('element-plus').FormItemProp) => void;
         getField: (prop: import('element-plus').FormItemProp) => import('element-plus').FormItemContext | undefined;
         fields: import('vue').Reactive<import('element-plus').FormItemContext[]>;

package/lib/components/ee-status-tag/src/index.vue.d.ts

@@ -8,6 +8,6 @@ type __VLS_Props = {
 };
 declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     defaultType: "primary" | "success" | "warning" | "danger" | "info";
-    defaultEffect: "dark" | "light" | "plain";
+    defaultEffect: "plain" | "light" | "dark";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 export default _default;

package/lib/components/ee-user-select/index.d.ts

@@ -0,0 +1,2 @@
+import { default as EeUserSelect } from './src/index.vue';
+export default EeUserSelect;

package/lib/components/ee-user-select/src/index.vue.d.ts

@@ -0,0 +1,29 @@
+import { EeUserSelectProps } from '../type';
+declare const _default: import('vue').DefineComponent<EeUserSelectProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    search: (keyword: string) => any;
+    clear: () => any;
+    "update:modelValue": (val: string | number | (string | number)[]) => any;
+    change: (val: string | number | (string | number)[]) => any;
+    blur: (evt: FocusEvent) => any;
+    focus: (evt: FocusEvent) => any;
+    "load-success": (options: any[]) => any;
+}, string, import('vue').PublicProps, Readonly<EeUserSelectProps> & Readonly<{
+    onSearch?: ((keyword: string) => any) | undefined;
+    onClear?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onChange?: ((val: string | number | (string | number)[]) => any) | undefined;
+    onBlur?: ((evt: FocusEvent) => any) | undefined;
+    onFocus?: ((evt: FocusEvent) => any) | undefined;
+    "onLoad-success"?: ((options: any[]) => any) | undefined;
+}>, {
+    apiUrl: string;
+    searchKey: string;
+    labelField: string;
+    valueField: string;
+    size: "large" | "default" | "small";
+    detailEchoUrl: string;
+    mode: "single" | "multiple";
+    clearable: boolean;
+    filterable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/lib/components/ee-user-select/type.d.ts

@@ -0,0 +1,46 @@
+import { AxiosInstance } from 'axios';
+/** EeUserSelect 组件属性 */
+export interface EeUserSelectProps {
+    /** 双向绑定值 */
+    modelValue?: string | number | (string | number)[];
+    /** 自定义人员列表接口地址，覆盖默认接口 */
+    apiUrl?: string;
+    /** 自定义人员详情回显接口地址 */
+    detailEchoUrl?: string;
+    /** 选择模式，默认 single */
+    mode?: 'single' | 'multiple';
+    /** 筛选指定部门下人员 */
+    deptId?: string | number;
+    /** 选项 label 字段名，默认 label */
+    labelField?: string;
+    /** 选项 value 字段名，默认 value */
+    valueField?: string;
+    /** 搜索关键词参数字段名，默认 keyword */
+    searchKey?: string;
+    /** 固定附加请求参数 */
+    extraParams?: Record<string, any>;
+    /** 外部 axios 请求实例，不传则从全局配置获取 */
+    requestInstance?: AxiosInstance;
+    /** 占位符文本 */
+    placeholder?: string;
+    /** 是否可清空，默认 true */
+    clearable?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否可搜索过滤，默认 true */
+    filterable?: boolean;
+    /** 组件尺寸 */
+    size?: 'large' | 'default' | 'small';
+}
+/** EeUserSelect 组件事件 */
+export interface EeUserSelectEmits {
+    (e: 'update:modelValue', val: string | number | (string | number)[]): void;
+    (e: 'change', val: string | number | (string | number)[]): void;
+    (e: 'clear'): void;
+    (e: 'blur', evt: FocusEvent): void;
+    (e: 'focus', evt: FocusEvent): void;
+    (e: 'search', keyword: string): void;
+    (e: 'load-success', options: any[]): void;
+}

package/lib/hooks/index.d.ts

@@ -0,0 +1,4 @@
+export { useRemoteSelectPagination } from './useRemoteSelectPagination';
+export { useSelectEcho } from './useSelectEcho';
+export type { RemotePaginationOption, RemoteSelectOption } from './useRemoteSelectPagination';
+export type { EchoOption } from './useSelectEcho';

package/lib/hooks/useRemoteSelectPagination.d.ts

@@ -0,0 +1,68 @@
+import { AxiosInstance } from 'axios';
+/**
+ * 远程分页下拉配置选项
+ */
+export interface RemotePaginationOption {
+    /** 外部 axios 请求实例，不传则从全局配置获取 */
+    requestInstance?: AxiosInstance;
+    /** 远程接口地址（必填） */
+    apiUrl: string;
+    /** 页码字段名，默认 pageNum */
+    pageNumKey?: string;
+    /** 每页条数字段名，默认 pageSize */
+    pageSizeKey?: string;
+    /** 每页条数，默认 20 */
+    pageSize?: number;
+    /** 搜索关键词字段名，默认 keyword */
+    searchKey?: string;
+    /** 附加请求参数 */
+    extraParams?: Record<string, any>;
+    /** 选项文本字段名，默认 label */
+    labelField?: string;
+    /** 选项值字段名，默认 value */
+    valueField?: string;
+    /** 子节点字段名（树形数据预留），默认 children */
+    childrenField?: string;
+    /** 关键词防抖延迟（毫秒），默认 300 */
+    debounceDelay?: number;
+}
+/**
+ * 远程下拉选项项类型
+ */
+export interface RemoteSelectOption {
+    [key: string]: any;
+    /** 显示文本 */
+    label?: string;
+    /** 选项值 */
+    value?: any;
+}
+/**
+ * 创建远程分页下拉控制器
+ *
+ * @param option - 远程分页配置
+ * @returns loading / options / noMore / loadData / loadMore / resetList / onKeywordChange
+ */
+export declare function useRemoteSelectPagination(option: RemotePaginationOption): {
+    /** 是否正在加载 */
+    loading: import('vue').Ref<boolean, boolean>;
+    /** 当前选项列表 */
+    options: import('vue').Ref<{
+        [x: string]: any;
+        label?: string
+        /** 选项值 */
+         | undefined;
+        value?: any;
+    }[], RemoteSelectOption[] | {
+        [x: string]: any;
+        label?: string
+        /** 选项值 */
+         | undefined;
+        value?: any;
+    }[]>;
+    /** 是否没有更多数据 */
+    noMore: import('vue').Ref<boolean, boolean>;
+    loadData: (searchVal?: string, reset?: boolean) => Promise<void>;
+    loadMore: () => Promise<void>;
+    resetList: () => void;
+    onKeywordChange: (val: string) => void;
+};

package/lib/hooks/useSelectEcho.d.ts

@@ -0,0 +1,27 @@
+import { AxiosInstance } from 'axios';
+/**
+ * 回显配置选项
+ */
+export interface EchoOption {
+    /** 外部 axios 请求实例，不传则从全局配置获取 */
+    requestInstance?: AxiosInstance;
+    /** 详情回显接口地址（必填） */
+    detailApiUrl: string;
+    /** 选项文本字段名，默认 label */
+    labelField?: string;
+    /** 选项值字段名，默认 value */
+    valueField?: string;
+    /** 选择模式，默认 single */
+    mode?: 'single' | 'multiple';
+}
+/**
+ * 创建选项回显控制器
+ *
+ * @param option - 回显配置
+ * @returns echoText / echoValue
+ */
+export declare function useSelectEcho(option: EchoOption): {
+    /** 当前回显文本（单选为 string，多选为 string[]） */
+    echoText: import('vue').Ref<string | string[], string | string[]>;
+    echoValue: (modelVal: any) => Promise<void>;
+};