easy-ep-ui 0.1.1 → 0.2.0

package/es/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;
@@ -46,10 +79,12 @@ export interface TableColumn {
     fixed?: FixedType;
     sortable?: boolean;
     show?: boolean;
+    showTooltip?: boolean;
     formatter?: (row: Record<string, unknown>, column: TableColumn, cellValue: unknown, index: number) => unknown;
     dictKey?: string;
     slotName?: string;
     search?: ColumnSearchItem;
+    form?: ColumnFormItem;
     auth?: string;
     children?: TableColumn[];
     [key: string]: unknown;
@@ -72,13 +107,15 @@ export interface PaginationConfig {
 }
 export interface ActionButton {
     text: string;
-    icon?: string;
+    icon?: any;
     type?: ButtonType;
     code?: string;
     auth?: string;
     show?: (row: Record<string, unknown>) => boolean;
     handler: (row: Record<string, unknown>) => void;
 }
+/** 操作列按钮展示模式 */
+export type ActionButtonMode = 'text' | 'icon' | 'icon-text';
 export interface ActionConfig {
     show?: boolean;
     label?: string;
@@ -87,17 +124,28 @@ export interface ActionConfig {
     showView?: boolean;
     showEdit?: boolean;
     showDelete?: boolean;
+    showVersion?: boolean;
     viewText?: string;
     editText?: string;
     deleteText?: string;
+    versionText?: string;
     viewAuth?: string;
     editAuth?: string;
     deleteAuth?: string;
+    versionAuth?: string;
     fixed?: FixedType;
     confirmDelete?: boolean;
     deleteConfirmTitle?: string;
     deleteConfirmMessage?: string;
     customButtons?: ActionButton[];
+    beforeButtons?: ActionButton[];
+    afterButtons?: ActionButton[];
+    buttonMode?: ActionButtonMode;
+    maxButtons?: number;
+    onView?: (row: Record<string, unknown>) => void;
+    onAdd?: () => void;
+    onEdit?: (row: Record<string, unknown>) => void;
+    onDelete?: (row: Record<string, unknown>) => void;
 }
 export interface ToolbarButton {
     text: string;
@@ -113,6 +161,7 @@ export interface ToolbarConfig {
     showImport?: boolean;
     showExport?: boolean;
     showBatchDelete?: boolean;
+    showRefresh?: boolean;
     addText?: string;
     importText?: string;
     exportText?: string;
@@ -132,12 +181,38 @@ export interface CrudApi {
     edit?: (data: Record<string, unknown>) => Promise<unknown>;
     delete?: (id: string | number) => Promise<unknown>;
     batchDelete?: (ids: (string | number)[]) => Promise<unknown>;
+    version?: (id: string | number) => Promise<Record<string, unknown>[]>;
 }
 export interface CrudConfig {
     api: CrudApi;
     baseParams?: Record<string, unknown>;
     requestMethod?: 'GET' | 'POST';
     requestInstance?: unknown;
+    /** 各操作的自定义 URL，优先级高于 api 函数 */
+    urls?: {
+        list?: string;
+        add?: string;
+        edit?: string;
+        delete?: string;
+        batchDelete?: string;
+        version?: string;
+    };
+    /** 各操作的自定义参数 */
+    params?: {
+        list?: Record<string, unknown>;
+        add?: Record<string, unknown>;
+        edit?: Record<string, unknown>;
+        delete?: Record<string, unknown>;
+        batchDelete?: Record<string, unknown>;
+        version?: Record<string, unknown>;
+    };
+    /** 版本管理配置 */
+    versionConfig?: {
+        /** 自定义版本请求 URL（优先级高于 api.version） */
+        url?: string;
+        /** 自定义参数 */
+        params?: Record<string, unknown>;
+    };
 }
 export interface SelectionConfig {
     show?: boolean;
@@ -158,10 +233,19 @@ export interface DrawerConfig {
     closeOnReset?: boolean;
     addTitle?: string;
     editTitle?: string;
+    viewTitle?: string;
+    /** 表单每行展示列数（默认 2） */
+    formCols?: number;
+    /** 表单标签宽度（默认 '80px'） */
+    formLabelWidth?: string;
+    /** 表单组件尺寸 */
+    formSize?: ComponentSize;
 }
 export interface ColumnSettingConfig {
     show?: boolean;
     storageKey?: string;
+    /** 是否默认显示行号列 */
+    showIndex?: boolean;
 }
 export interface AutoHeightConfig {
     offset?: number;
@@ -170,6 +254,7 @@ export interface EeFormTableProps {
     columns: TableColumn[];
     data?: Record<string, unknown>[];
     loading?: boolean;
+    readOnly?: boolean;
     searchConfig?: SearchConfig | boolean;
     pagination?: PaginationConfig | boolean;
     actionConfig?: ActionConfig | boolean;

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

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

package/es/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/es/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/es/components/ee-role-select/index.d.ts

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

package/es/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/es/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/es/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/es/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/es/components/ee-user-select/index.d.ts

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

package/es/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/es/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/es/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/es/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/es/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>;
+};