@sunny-base-web/effects 0.4.0 → 0.6.0

package/dist/index.d.ts

@@ -1,13 +1,20 @@
+import { AllowedComponentProps } from 'vue';
 import { App } from 'vue';
 import { AxiosInstance } from 'axios';
 import { AxiosRequestConfig } from 'axios';
 import { AxiosResponse } from 'axios';
 import { BusinessSearchAdapter } from '../../../@ui/src/index.ts';
+import { ComponentCustomProperties } from 'vue';
+import { ComponentCustomProps } from 'vue';
+import { ComponentInternalInstance } from 'vue';
+import { ComponentOptionsBase } from 'vue';
 import { ComponentOptionsMixin } from 'vue';
 import { ComponentProvideOptions } from 'vue';
+import { ComponentPublicInstance } from 'vue';
 import { ComputedRef } from 'vue';
 import { CreateAxiosDefaults } from 'axios';
 import { CreateComponentPublicInstanceWithMixins } from 'vue';
+import { DebuggerEvent } from 'vue';
 import { DefineComponent } from 'vue';
 import { DefineSetupFnComponent } from 'vue';
 import { ExtractPropTypes } from 'vue';
@@ -16,20 +23,39 @@ import { FavoriteState } from '@sunny-base-web/stores';
 import { FormApi } from '../../../@ui/src/index.ts';
 import { FormCommonConfig } from '../../../@ui/src/index.ts';
 import { FormSchema } from '../../../../../@ui/src/index.ts';
+import { FormSchema as FormSchema_2 } from '../../../../../../@ui/src/index.ts';
+import { FormSchema as FormSchema_3 } from '../../../@ui/src/index.ts';
 import { GlobalComponents } from 'vue';
 import { GlobalDirectives } from 'vue';
 import { InjectionKey } from 'vue';
 import { InternalAxiosRequestConfig } from 'axios';
+import { ModalProps } from '../../../../../@ui/src/feedback/modal/types';
+import { nextTick } from 'vue';
+import { OnCleanup } from '@vue/reactivity';
 import { PiniaCustomStateProperties } from 'pinia';
 import { PropType } from 'vue';
 import { PublicProps } from 'vue';
 import { Ref } from 'vue';
 import { RendererElement } from 'vue';
 import { RendererNode } from 'vue';
+import { SelectFieldMapping } from '../../../@ui/src/index.ts';
+import { SelectOption } from '../../../@ui/src/index.ts';
+import { SelectOptionsAdapter } from '../../../@ui/src/index.ts';
+import { ShallowUnwrapRef } from 'vue';
+import { Slot } from 'vue';
 import { Store } from 'pinia';
 import { VNode } from 'vue';
+import { VNodeProps } from 'vue';
 import { VxeGridApi } from '../../../@ui/src/data/query-grid/api';
-import { VxeGridProps } from 'vxe-table';
+import { VxeGridProps } from '../../../../../@ui/src/index.ts';
+import { VxeGridPropTypes } from '@sunny-base-web/ui';
+import { WatchOptions } from 'vue';
+import { WatchStopHandle } from 'vue';
+
+declare type __VLS_Props = {
+    type?: 'nprogress' | 'spinner' | 'loading' | 'none';
+    minLoadingTime?: number;
+};
 
 /**
  * 添加收藏菜单
@@ -140,6 +166,21 @@ export declare const businessCodeResponseInterceptor: ({ businessCodes, onBusine
     onBusinessError: (code: number, message: string) => Promise<void> | void;
 }) => ResponseInterceptorConfig;
 
+/**
+ * 收集 Schema 中的字典声明（工具函数）
+ * Collect dictionary declarations from Schema (utility function)
+ *
+ * @param schema - 表单 Schema
+ * @returns 字典编码列表
+ *
+ * @example
+ * ```typescript
+ * const dictCodes = collectSchemaDictCodes(searchFormSchema);
+ * console.log(dictCodes); // ['SFQY', 'LANG']
+ * ```
+ */
+export declare function collectSchemaDictCodes(schema: FormSchema_3[]): (string | number)[];
+
 /**
  * 创建 @effects 插件实例
  * 在 Vue 应用入口文件 (main.ts/bootstrap.ts) 中使用 app.use() 安装
@@ -229,6 +270,14 @@ export declare const defaultResponseInterceptor: ({ codeField, dataField, succes
     successCode: ((code: any) => boolean) | number | string;
 }) => ResponseInterceptorConfig;
 
+/**
+ * 默认的 Select 选项适配器实现
+ * Default Select options adapter implementation
+ * @description 调用 /core/contact/findAuthDictList 接口批量加载字典选项
+ * @description Calls /core/contact/findAuthDictList API to batch load dictionary options
+ */
+export declare const defaultSelectOptionsAdapter: SelectOptionsAdapter;
+
 declare type DownloadRequestConfig = {
     /**
      * 定义期望获得的数据类型。
@@ -363,6 +412,12 @@ declare class FileUploader {
     }, config?: RequestClientConfig): Promise<T>;
 }
 
+/**
+ * 根据选项key、list返回对应name
+ * @param {*} optionlist
+ */
+export declare function filterSelect(val: string, optionlist: Option_2[]): string;
+
 /**
  * 获取所有系统设置
  */
@@ -393,16 +448,72 @@ declare interface FormItem {
  */
 export declare function getEnterStrategy(data?: any): Promise<ResponseResult<LoginStrategyResult>>;
 
+export declare const getJobGroupConfig: ({ t }: JobGroupConfig) => {
+    searchFormSchema: FormSchema_2[];
+    tableColumns: VxeGridPropTypes.Columns<JobGroupVO>;
+    statusOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+    zcfsOpts: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+};
+
+export declare const getJobInfoConfig: ({ t }: JobInfoConfig) => {
+    searchFormSchema: FormSchema_2[];
+    tableColumns: VxeGridPropTypes.Columns<JobInfoVO>;
+    scheduleTypeOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+    glueTypeOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+    triggerStatusOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+};
+
+export declare const getJobLogConfig: ({ t }: JobLogConfig) => {
+    searchFormSchema: FormSchema_2[];
+    tableColumns: VxeGridPropTypes.Columns<JobLogVO>;
+    triggerCodeOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+    handleCodeOptions: {
+        cKeyname: string;
+        cKeynumb: string;
+    }[];
+};
+
+export declare const getOperationLogConfig: ({ t }: OperationLogConfig) => {
+    searchFormSchema: FormSchema[];
+    tableColumns: VxeGridPropTypes.Columns<OperationLogVO>;
+};
+
 /**
  * 根据字段配置项构建options
  * @param {*} resource
  */
 export declare function getOptionsForSelectType(item: any): any;
 
-export declare function getResourceByParIdOrModnumb({ parId, modnumb }: {
-    parId?: string;
-    modnumb?: string;
-}): Promise<any> | undefined;
+export declare const getRoleConfig: ({ t, formApi }: RoleConfig) => {
+    searchFormSchema: FormSchema[];
+    tableColumns: VxeGridPropTypes.Columns<any>;
+    resourceConfig: {
+        resourceId: string;
+        nResourceid: number;
+        cModnumb: string;
+    };
+    addEditFormSchema: FormSchema[];
+    authFormSchema: FormSchema[];
+    authGridColumns: VxeGridPropTypes.Columns<any>;
+};
 
 /**
  * 获取滑动验证码
@@ -414,6 +525,31 @@ export declare function getSlideVerificationCode(data: any): Promise<any>;
  */
 export declare let globalConfig: EffectsConfig;
 
+export declare const GlobalLoading: DefineComponent<__VLS_Props, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, false, {}, any>;
+
+/**
+ * GlobalLoading 组件属性类型定义
+ */
+/**
+ * GlobalLoading 组件属性
+ */
+export declare interface GlobalLoadingProps {
+    /**
+     * 加载动画类型
+     * - 'nprogress': 顶部进度条（由外部控制）
+     * - 'spinner': 方块跳跃动画
+     * - 'loading': 四点旋转动画
+     * - 'none': 禁用加载动画
+     * @default 'spinner'
+     */
+    type?: 'nprogress' | 'spinner' | 'loading' | 'none';
+    /**
+     * 最小加载时间（毫秒），避免闪烁
+     * @default 50
+     */
+    minLoadingTime?: number;
+}
+
 export declare interface HttpResponse<T = any> {
     /**
      * 0 表示成功 其他表示失败
@@ -441,6 +577,7 @@ export declare function initButtonItem(data: any): {
     cSubArea: any;
     name: any;
     code: any;
+    params: string;
 };
 
 /**
@@ -449,6 +586,10 @@ export declare function initButtonItem(data: any): {
  */
 export declare function initFormItem(data: any): FormItem;
 
+/**
+ * 根据资源接口返回构建配置（表单、表格、按钮）项
+ * @param {*} resource
+ */
 export declare function initResourceConstructor(result: any): {
     resFieldList: Record<string, any[]>;
     resButtonList: Record<string, any[]>;
@@ -469,6 +610,308 @@ declare class InterceptorManager {
     addResponseInterceptor<T = any>({ fulfilled, rejected, }?: ResponseInterceptorConfig<T>): void;
 }
 
+declare interface JobGroupConfig {
+    t: (key: string) => string;
+}
+
+export declare const JobGroupQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+formRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+success: () => any;
+"update:visible": (value: boolean) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+formRef: any;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+
+/**
+ * 执行器信息VO
+ */
+export declare interface JobGroupVO {
+    /**
+     * Appname
+     */
+    appname: string;
+    /**
+     * 名称
+     */
+    title: string;
+    /**
+     * 注册方式
+     */
+    addressType: string;
+    /**
+     * OnLine地址列表
+     */
+    addressList: string;
+}
+
+declare interface JobInfoConfig {
+    t: (key: string) => string;
+}
+
+export declare const JobInfoQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+formRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+success: () => any;
+"update:visible": (value: boolean) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+formRef: any;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, {}> | null;
+onceRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+success: () => any;
+"update:visible": (value: boolean) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+formRef: any;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, {}> | null;
+codeRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+success: () => any;
+"update:visible": (value: boolean) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+visible: boolean;
+formData?: any;
+}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (data?: any) => void;
+}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+
+/**
+ * 定时任务信息VO
+ */
+export declare interface JobInfoVO {
+    /**
+     * 任务id
+     */
+    id: string | number;
+    /**
+     * 任务描述
+     */
+    jobDesc: string;
+    /**
+     * 执行器
+     */
+    jobGroupTitle: string;
+    /**
+     * 调度类型
+     */
+    scheduleType: string;
+    /**
+     * 运行模式
+     */
+    glueType: string;
+    /**
+     * 负责人
+     */
+    author: string;
+    /**
+     * 状态
+     */
+    triggerStatus: string;
+}
+
+declare interface JobLogConfig {
+    t: (key: string) => string;
+}
+
+export declare const JobLogQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+logListRef: CreateComponentPublicInstanceWithMixins<Readonly<{
+visible: boolean;
+}> & Readonly<{
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (id: string) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+"update:visible": (value: boolean) => any;
+}, PublicProps, {}, false, {}, {}, GlobalComponents, GlobalDirectives, string, {
+logboxRef: HTMLDivElement;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{
+visible: boolean;
+}> & Readonly<{
+"onUpdate:visible"?: ((value: boolean) => any) | undefined;
+}>, {
+show: (id: string) => Promise<void>;
+}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+
+/**
+ * 调度日志信息VO
+ */
+export declare interface JobLogVO {
+    /**
+     * 任务ID
+     */
+    jobld: string | number;
+    /**
+     * 任务描述
+     */
+    jobDesc: string;
+    /**
+     * 调度结果
+     */
+    triggerCode: string;
+    /**
+     * 调度时间
+     */
+    triggerTime: string;
+    /**
+     * 本次执行地址
+     */
+    executorAddress: string;
+    /**
+     * 执行任务
+     */
+    executorHandler: string;
+    /**
+     * 执行参数
+     */
+    executorParam: string;
+    /**
+     * 调度备注
+     */
+    handleDdbz: string;
+    /**
+     * 执行时间
+     */
+    handleTime: string;
+    /**
+     * 执行结果
+     */
+    handleCode: string;
+    /**
+     * 执行备注
+     */
+    handleMsg: string;
+    /**
+     * 执行日志
+     */
+    handleZxrz: string;
+}
+
+/**
+ * 全局加载状态管理器
+ * @description 单例模式，管理全局加载动画的显示状态
+ * @since 简化版：仅使用布尔值，不使用计数器（因为只处理路由导航）
+ */
+export declare class LoadingManager {
+    private static instance;
+    private _isLoading;
+    /**
+     * 当前是否处于加载状态（响应式）
+     */
+    readonly isLoading: ComputedRef<boolean>;
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): LoadingManager;
+    /**
+     * 开始加载
+     */
+    startLoading(): void;
+    /**
+     * 结束加载
+     */
+    stopLoading(): void;
+    /**
+     * 强制停止加载（等同于 stopLoading，为了保持 API 兼容性）
+     */
+    forceStop(): void;
+}
+
+export declare const loadingManager: LoadingManager;
+
 export declare const Login: DefineComponent<ExtractPropTypes<    {
 bg01: {
 type: StringConstructor;
@@ -588,6 +1031,10 @@ export declare interface MetaItem {
     value: string;
 }
 
+declare interface OperationLogConfig {
+    t: (key: string) => string;
+}
+
 export declare const OperationLogQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {}, HTMLDivElement>;
 
 /**
@@ -621,6 +1068,48 @@ export declare interface OperationLogVO {
     nSecond: number;
 }
 
+declare interface Option_2 {
+    label: string;
+    value: string;
+}
+
+/**
+ * 路由守卫预加载工具
+ * Route guard pre-loading utility
+ *
+ * @description 用于在路由级别预加载字典选项
+ * @description Used for pre-loading dictionary options at route level
+ *
+ * @param dictCodes - 字典编码列表
+ * @param fieldMapping - 字段映射配置
+ * @returns 加载函数
+ *
+ * @example
+ * ```typescript
+ * // router/guard.ts
+ * import { preLoadSelectOptions } from '@sunny-base-web/effects';
+ *
+ * router.beforeEach(async (to, from, next) => {
+ *   if (to.meta.selectOptions) {
+ *     await preLoadSelectOptions(to.meta.selectOptions as string[]);
+ *   }
+ *   next();
+ * });
+ *
+ * // router/index.ts
+ * {
+ *   path: '/setting/demo/test',
+ *   meta: {
+ *     selectOptions: ['SFQY', 'LANG']
+ *   }
+ * }
+ * ```
+ */
+export declare function preLoadSelectOptions(dictCodes: (string | number)[], fieldMapping?: {
+    label?: string;
+    value?: string;
+}): Promise<void>;
+
 /**
  * 查询数据字典
  */
@@ -824,11 +1313,445 @@ export declare interface ResponseResult<T = any> {
     timestamp: number;
 }
 
+export declare const RoleAdd: DefineComponent<    {}, {
+addInit: () => Promise<void>;
+editInit: (record: any) => Promise<void>;
+detailInit: (record: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, string, PublicProps, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+modalRef: ({
+$: ComponentInternalInstance;
+$data: {};
+$props: {
+readonly modelValue?: boolean | undefined;
+readonly title?: string | undefined;
+readonly width?: string | number | undefined;
+readonly top?: string | number | undefined;
+readonly zIndex?: number | undefined;
+readonly helpMessage?: string | undefined;
+readonly closeOnEsc?: boolean | undefined;
+readonly fullscreen?: boolean | undefined;
+readonly closeOnClickModal?: boolean | undefined;
+readonly okText?: string | undefined;
+readonly cancelText?: string | undefined;
+readonly okLoading?: boolean | undefined;
+readonly confirmLoading?: boolean | undefined;
+readonly hideCancel?: boolean | undefined;
+readonly okButtonProps?: any;
+readonly cancelButtonProps?: any;
+readonly onVisibleChange?: ((visible: boolean) => void) | undefined;
+readonly onBeforeOk?: ((done?: (closed: boolean) => void) => void | boolean | Promise<void | boolean>) | undefined;
+readonly onBeforeCancel?: (() => boolean | Promise<boolean>) | undefined;
+readonly onClose?: ((() => void) & (() => any)) | undefined;
+readonly onOk?: ((() => void) & (() => any)) | undefined;
+readonly "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+readonly "onFullscreen-change"?: ((value: boolean) => any) | undefined;
+} & VNodeProps & AllowedComponentProps & ComponentCustomProps;
+$attrs: {
+[x: string]: unknown;
+};
+$refs: {
+[x: string]: unknown;
+};
+$slots: Readonly<{
+[name: string]: Slot<any> | undefined;
+}>;
+$root: ComponentPublicInstance | null;
+$parent: ComponentPublicInstance | null;
+$host: Element | null;
+$emit: ((event: "close") => void) & ((event: "update:modelValue", value: boolean) => void) & ((event: "ok") => void) & ((event: "fullscreen-change", value: boolean) => void);
+$el: any;
+$options: ComponentOptionsBase<Readonly<ModalProps> & Readonly<{
+onClose?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+onOk?: (() => any) | undefined;
+"onFullscreen-change"?: ((value: boolean) => any) | undefined;
+}>, {
+toggleMaximize: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+"update:modelValue": (value: boolean) => any;
+ok: () => any;
+"fullscreen-change": (value: boolean) => any;
+}, string, {
+title: string;
+modelValue: boolean;
+width: string | number;
+zIndex: number;
+helpMessage: string;
+closeOnEsc: boolean;
+fullscreen: boolean;
+closeOnClickModal: boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
+beforeCreate?: (() => void) | (() => void)[];
+created?: (() => void) | (() => void)[];
+beforeMount?: (() => void) | (() => void)[];
+mounted?: (() => void) | (() => void)[];
+beforeUpdate?: (() => void) | (() => void)[];
+updated?: (() => void) | (() => void)[];
+activated?: (() => void) | (() => void)[];
+deactivated?: (() => void) | (() => void)[];
+beforeDestroy?: (() => void) | (() => void)[];
+beforeUnmount?: (() => void) | (() => void)[];
+destroyed?: (() => void) | (() => void)[];
+unmounted?: (() => void) | (() => void)[];
+renderTracked?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+renderTriggered?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+};
+$forceUpdate: () => void;
+$nextTick: typeof nextTick;
+$watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, OnCleanup]) => any : (...args: [any, any, OnCleanup]) => any, options?: WatchOptions): WatchStopHandle;
+} & Readonly<{
+title: string;
+modelValue: boolean;
+width: string | number;
+zIndex: number;
+helpMessage: string;
+closeOnEsc: boolean;
+fullscreen: boolean;
+closeOnClickModal: boolean;
+}> & Omit<Readonly<ModalProps> & Readonly<{
+onClose?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+onOk?: (() => any) | undefined;
+"onFullscreen-change"?: ((value: boolean) => any) | undefined;
+}>, "toggleMaximize" | ("title" | "modelValue" | "width" | "zIndex" | "helpMessage" | "closeOnEsc" | "fullscreen" | "closeOnClickModal")> & ShallowUnwrapRef<    {
+toggleMaximize: () => void;
+}> & {} & ComponentCustomProperties & {} & {
+$slots: {
+default?(_: {}): any;
+title?(_: {}): any;
+footer?(_: {}): any;
+insertFooter?(_: {}): any;
+centerFooter?(_: {}): any;
+appendFooter?(_: {}): any;
+};
+}) | null;
+treeRef: any;
+}, any>;
+
+export declare const RoleAuth: DefineComponent<    {}, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, string, PublicProps, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+RoleChooseUserRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onChooseUserEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+chooseUserEmit: (...args: any[]) => void;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onChooseUserEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, {}> | null;
+}, any>;
+
+declare interface RoleConfig {
+    t: (key: string) => string;
+    formApi?: any;
+}
+
+export declare const RoleQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+RoleAddRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+addInit: () => Promise<void>;
+editInit: (record: any) => Promise<void>;
+detailInit: (record: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+modalRef: ({
+$: ComponentInternalInstance;
+$data: {};
+$props: {
+readonly modelValue?: boolean | undefined;
+readonly title?: string | undefined;
+readonly width?: string | number | undefined;
+readonly top?: string | number | undefined;
+readonly zIndex?: number | undefined;
+readonly helpMessage?: string | undefined;
+readonly closeOnEsc?: boolean | undefined;
+readonly fullscreen?: boolean | undefined;
+readonly closeOnClickModal?: boolean | undefined;
+readonly okText?: string | undefined;
+readonly cancelText?: string | undefined;
+readonly okLoading?: boolean | undefined;
+readonly confirmLoading?: boolean | undefined;
+readonly hideCancel?: boolean | undefined;
+readonly okButtonProps?: any;
+readonly cancelButtonProps?: any;
+readonly onVisibleChange?: ((visible: boolean) => void) | undefined;
+readonly onBeforeOk?: ((done?: (closed: boolean) => void) => void | boolean | Promise<void | boolean>) | undefined;
+readonly onBeforeCancel?: (() => boolean | Promise<boolean>) | undefined;
+readonly onClose?: ((() => void) & (() => any)) | undefined;
+readonly onOk?: ((() => void) & (() => any)) | undefined;
+readonly "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+readonly "onFullscreen-change"?: ((value: boolean) => any) | undefined;
+} & VNodeProps & AllowedComponentProps & ComponentCustomProps;
+$attrs: {
+[x: string]: unknown;
+};
+$refs: {
+[x: string]: unknown;
+};
+$slots: Readonly<{
+[name: string]: Slot<any> | undefined;
+}>;
+$root: ComponentPublicInstance | null;
+$parent: ComponentPublicInstance | null;
+$host: Element | null;
+$emit: ((event: "close") => void) & ((event: "update:modelValue", value: boolean) => void) & ((event: "ok") => void) & ((event: "fullscreen-change", value: boolean) => void);
+$el: any;
+$options: ComponentOptionsBase<Readonly<ModalProps> & Readonly<{
+onClose?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+onOk?: (() => any) | undefined;
+"onFullscreen-change"?: ((value: boolean) => any) | undefined;
+}>, {
+toggleMaximize: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {} & {
+close: () => any;
+"update:modelValue": (value: boolean) => any;
+ok: () => any;
+"fullscreen-change": (value: boolean) => any;
+}, string, {
+title: string;
+modelValue: boolean;
+width: string | number;
+zIndex: number;
+helpMessage: string;
+closeOnEsc: boolean;
+fullscreen: boolean;
+closeOnClickModal: boolean;
+}, {}, string, {}, GlobalComponents, GlobalDirectives, string, ComponentProvideOptions> & {
+beforeCreate?: (() => void) | (() => void)[];
+created?: (() => void) | (() => void)[];
+beforeMount?: (() => void) | (() => void)[];
+mounted?: (() => void) | (() => void)[];
+beforeUpdate?: (() => void) | (() => void)[];
+updated?: (() => void) | (() => void)[];
+activated?: (() => void) | (() => void)[];
+deactivated?: (() => void) | (() => void)[];
+beforeDestroy?: (() => void) | (() => void)[];
+beforeUnmount?: (() => void) | (() => void)[];
+destroyed?: (() => void) | (() => void)[];
+unmounted?: (() => void) | (() => void)[];
+renderTracked?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+renderTriggered?: ((e: DebuggerEvent) => void) | ((e: DebuggerEvent) => void)[];
+errorCaptured?: ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: ComponentPublicInstance | null, info: string) => boolean | void)[];
+};
+$forceUpdate: () => void;
+$nextTick: nextTick;
+$watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, OnCleanup]) => any : (...args: [any, any, OnCleanup]) => any, options?: WatchOptions): WatchStopHandle;
+} & Readonly<{
+title: string;
+modelValue: boolean;
+width: string | number;
+zIndex: number;
+helpMessage: string;
+closeOnEsc: boolean;
+fullscreen: boolean;
+closeOnClickModal: boolean;
+}> & Omit<Readonly<ModalProps> & Readonly<{
+onClose?: (() => any) | undefined;
+"onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
+onOk?: (() => any) | undefined;
+"onFullscreen-change"?: ((value: boolean) => any) | undefined;
+}>, "toggleMaximize" | ("title" | "modelValue" | "width" | "zIndex" | "helpMessage" | "closeOnEsc" | "fullscreen" | "closeOnClickModal")> & ShallowUnwrapRef<    {
+toggleMaximize: () => void;
+}> & {} & ComponentCustomProperties & {} & {
+$slots: {
+default?(_: {}): any;
+title?(_: {}): any;
+footer?(_: {}): any;
+insertFooter?(_: {}): any;
+centerFooter?(_: {}): any;
+appendFooter?(_: {}): any;
+};
+}) | null;
+treeRef: any;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+addInit: () => Promise<void>;
+editInit: (record: any) => Promise<void>;
+detailInit: (record: any) => void;
+}, {}, {}, {}, {}> | null;
+RoleAuthRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+RoleChooseUserRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onChooseUserEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+chooseUserEmit: (...args: any[]) => void;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onChooseUserEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, {}> | null;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+
+/**
+ * 角色查询参数
+ */
+export declare interface RoleQueryParams {
+    /**
+     * 页码
+     */
+    pageNo: number;
+    /**
+     * 每页大小
+     */
+    pageSize: number;
+    /**
+     * 角色信息
+     */
+    authRole: {
+        /**
+         * 角色编号
+         */
+        cRolenumb?: string;
+        /**
+         * 角色名称
+         */
+        cRolename?: string;
+        /**
+         * 所属系统
+         */
+        CSystem?: string;
+        /**
+         * 所属组织
+         */
+        corg?: string;
+        /**
+         * 所属类型
+         */
+        сType?: string;
+    };
+}
+
+/**
+ * 角色信息VO
+ */
+export declare interface RoleVO {
+    /**
+     * ID
+     */
+    id: string;
+    /**
+     * 角色编号
+     */
+    cRolenumb: string;
+    /**
+     * 角色名称
+     */
+    cRolename: string;
+    /**
+     * 所属系统
+     */
+    CSystem: string;
+    /**
+     * 所属组织
+     */
+    corg: string;
+    /**
+     * 所属类型
+     */
+    сType: string;
+    /**
+     * 敏感角色
+     */
+    nSensitive: string;
+    /**
+     * 创建人
+     */
+    cCrename: string;
+    /**
+     * 创建时间
+     */
+    dCredate: string;
+}
+
 /**
  * 保存所有系统设置
  */
 export declare function saveAllSettings(settings: SysSettingItem[]): Promise<any>;
 
+/**
+ * Schema 选项加载器返回值
+ * Schema options loader return value
+ */
+export declare interface SchemaOptionsLoaderReturn {
+    /**
+     * 增强后的 Schema（自动注入 options）
+     * Enhanced Schema (with auto-injected options)
+     */
+    enhancedSchema: ComputedRef<FormSchema_3[]>;
+    /**
+     * 选项映射表
+     * Options map
+     */
+    optionsMap: Ref<Record<string, SelectOption[]>>;
+    /**
+     * 加载状态
+     * Loading state
+     */
+    loading: Ref<boolean>;
+    /**
+     * 手动加载
+     * Manual load
+     */
+    load: () => Promise<void>;
+}
+
 /**
  * 搜索表单配置
  */
@@ -846,6 +1769,66 @@ export declare const searchPlanApi: {
     findDefSearchPlan: (data: any) => Promise<any>;
 };
 
+/**
+ * Select 选项缓存管理器
+ * Select options cache manager
+ * @description 统一管理所有 Select 的选项加载和缓存，支持请求去重
+ * @description Unified management of all Select option loading and caching with request deduplication
+ */
+declare class SelectOptionsManager {
+    /**
+     * 选项缓存
+     * Options cache
+     * @description 缓存已加载的选项数据
+     * @description Cache loaded option data
+     */
+    private readonly cache;
+    /**
+     * 加载中的 Promise（避免重复请求）
+     * Loading Promises (avoid duplicate requests)
+     * @description 当多个组件同时加载相同字典时，共享同一个 Promise
+     * @description When multiple components load the same dictionary simultaneously, share the same Promise
+     */
+    private readonly loadingPromises;
+    /**
+     * 批量加载选项（带缓存和去重）
+     * Batch load options (with cache and deduplication)
+     * @param numbList - 字典编码列表
+     * @param fieldMapping - 字段映射配置
+     * @param forceReload - 是否强制刷新（忽略缓存）
+     * @returns 选项映射表 { dictCode: options }
+     */
+    loadOptions(numbList: (string | number)[], fieldMapping?: SelectFieldMapping, forceReload?: boolean): Promise<Record<string, SelectOption[]>>;
+    /**
+     * 获取单个字典的选项（从缓存）
+     * Get single dictionary options (from cache)
+     * @param dictCode - 字典编码
+     * @returns 选项数组
+     */
+    getOptions(dictCode: string | number): SelectOption[];
+    /**
+     * 清除指定字典的缓存
+     * Clear cache for specified dictionary
+     * @param dictCode - 字典编码（可选，不传则清除所有）
+     */
+    clearCache(dictCode?: string | number): void;
+    /**
+     * 检查字典是否已缓存
+     * Check if dictionary is cached
+     * @param dictCode - 字典编码
+     * @returns 是否已缓存
+     */
+    hasCache(dictCode: string | number): boolean;
+    /**
+     * 获取缓存大小
+     * Get cache size
+     * @returns 缓存的字典数量
+     */
+    getCacheSize(): number;
+}
+
+export declare const selectOptionsManager: SelectOptionsManager;
+
 /**
  * 初始化业务表单配置
  *
@@ -978,7 +1961,7 @@ export declare interface SystemSettingForm {
 /**
  * 表格列配置
  */
-export declare const tableColumns: VxeGridProps<OperationLogVO>['columns'];
+export declare const tableColumns: VxeGridProps<DataDictionaryVO>['columns'];
 
 /**
  * Composition API Hook: 获取全局配置
@@ -1036,6 +2019,45 @@ export declare function useFavorite(): {
     }>;
 };
 
+export declare function useGlobalLoading(): UseGlobalLoadingReturn;
+
+/**
+ * 全局加载动画控制 Composable
+ * @description 提供编程式控制全局加载动画的 API
+ * @example
+ * ```ts
+ * const { start, stop, withLoading } = useGlobalLoading();
+ *
+ * // 手动控制
+ * start();
+ * await fetchData();
+ * stop();
+ *
+ * // 自动包装
+ * await withLoading(fetchUserData());
+ * ```
+ */
+export declare interface UseGlobalLoadingReturn {
+    /**
+     * 显示全局加载动画
+     */
+    start: () => void;
+    /**
+     * 隐藏全局加载动画
+     */
+    stop: () => void;
+    /**
+     * 包装异步函数，自动显示/隐藏加载
+     * @param fn - 异步函数
+     * @example
+     * ```ts
+     * const { withLoading } = useGlobalLoading();
+     * await withLoading(fetchUserData());
+     * ```
+     */
+    withLoading: <T>(fn: Promise<T>) => Promise<T>;
+}
+
 /**
  * 列表页通用配置
  * @param options 配置选项
@@ -1072,6 +2094,27 @@ export declare function useList<T>(options: {
      * 表格事件配置
      */
     gridEvents?: any;
+    /**
+     * 树形配置
+     */
+    treeConfig?: any;
+    /**
+     * 树形表格懒加载方法
+     */
+    loadMethod?: (row: any) => Promise<any[]>;
+    /**
+     * 对象转值字段列表
+     * 用于将 BusinessSearch 等返回的对象数组转换为值字符串
+     */
+    objectToValueFields?: string[];
+    /**
+     * 是否开启懒加载
+     */
+    lazy?: boolean;
+    /**
+     * 是否自动加载数据
+     */
+    autoLoad?: boolean;
 }): {
     QueryForm: DefineComponent<    {}, () => VNode<RendererNode, RendererElement, {
     [key: string]: any;
@@ -1091,6 +2134,138 @@ export declare function useList<T>(options: {
     fetchResourceConfig: () => Promise<void>;
 };
 
+export declare const UserQuery: DefineComponent<    {}, {}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, ComponentProvideOptions, true, {
+UserAddRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+addInit: () => void;
+editInit: (record: any) => Promise<void>;
+detailInit: (record: any) => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+addInit: () => void;
+editInit: (record: any) => Promise<void>;
+detailInit: (record: any) => void;
+}, {}, {}, {}, {}> | null;
+UserAuthRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {
+UserChooseRoleRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onChooseRoleEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+chooseRoleEmit: (...args: any[]) => void;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onChooseRoleEmit?: ((...args: any[]) => any) | undefined;
+}>, {
+openInit: () => void;
+}, {}, {}, {}, {}> | null;
+}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, {}> | null;
+UserBindMacRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, {}> | null;
+UserOtherAuthRef: CreateComponentPublicInstanceWithMixins<Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+success: () => any;
+}, PublicProps, {}, true, {}, {}, GlobalComponents, GlobalDirectives, string, {}, any, ComponentProvideOptions, {
+P: {};
+B: {};
+D: {};
+C: {};
+M: {};
+Defaults: {};
+}, Readonly<{}> & Readonly<{
+onSuccess?: (() => any) | undefined;
+}>, {
+openInit: (record: any) => Promise<void>;
+}, {}, {}, {}, {}> | null;
+}, HTMLDivElement>;
+
+/**
+ * 处理声明式 Schema 的选项加载
+ * Process declarative Schema options loading
+ *
+ * @param schema - 表单 Schema
+ * @param immediate - 是否立即加载
+ * @returns 增强后的 Schema 和加载方法
+ *
+ * @example
+ * ```typescript
+ * // 在 config.ts 中声明式配置
+ * export const searchFormSchema: FormSchema[] = [
+ *   {
+ *     fieldName: 'nZt',
+ *     component: 'Select',
+ *     selectOptions: {
+ *       dictCode: 'SFQY',
+ *       fieldMapping: { label: 'cName', value: 'cXuhao' }
+ *     }
+ *   }
+ * ]
+ *
+ * // 在组件中使用
+ * const { enhancedSchema, optionsMap } = useSchemaOptionsLoader(searchFormSchema);
+ *
+ * // 传递给 useList
+ * useList({
+ *   searchFormSchema: enhancedSchema.value,
+ *   ...
+ * })
+ * ```
+ */
+export declare function useSchemaOptionsLoader(schema: FormSchema_3[] | Ref<FormSchema_3[]>, immediate?: boolean): SchemaOptionsLoaderReturn;
+
 /**
  * 查询方案 API 实现
  * 所有模块通用的查询方案 API 配置
@@ -1104,6 +2279,134 @@ export declare const useSearchPlanApi: () => {
     findDefSearchPlan: (data: any) => Promise<any>;
 };
 
+/**
+ * Select 选项加载 Hook
+ * Select options loading Hook
+ * @description 批量加载多个字典选项，自动缓存和去重
+ * @description Batch load multiple dictionary options with automatic caching and deduplication
+ *
+ * @param params - Hook 参数
+ * @returns 选项数据和加载方法
+ *
+ * @example
+ * ```ts
+ * // 基础用法
+ * const { optionsMap } = useSelectOptions({
+ *   numbList: ['SFQY', 'LANG']
+ * });
+ *
+ * // 在 Schema 中使用
+ * componentProps: {
+ *   options: optionsMap.value['SFQY']
+ * }
+ *
+ * // 自定义字段映射
+ * const { optionsMap } = useSelectOptions({
+ *   numbList: ['USER_STATUS'],
+ *   fieldMapping: {
+ *     label: 'statusName',
+ *     value: 'statusCode'
+ *   }
+ * });
+ *
+ * // 手动加载
+ * const { optionsMap, load } = useSelectOptions({
+ *   numbList: ['USER_LIST'],
+ *   immediate: false
+ * });
+ *
+ * // 在需要时调用
+ * await load();
+ * ```
+ */
+export declare function useSelectOptions(params: UseSelectOptionsParams): UseSelectOptionsReturn;
+
+/**
+ * Hook 参数
+ * Hook parameters
+ */
+export declare interface UseSelectOptionsParams {
+    /**
+     * 字典编码列表
+     * Dictionary code list
+     * @description 需要批量加载的字典编码
+     * @description Dictionary codes to be batch loaded
+     */
+    numbList: (string | number)[];
+    /**
+     * 字段映射配置
+     * Field mapping configuration
+     * @description 自定义 label 和 value 对应的后端字段名
+     * @description Customize backend field names for label and value
+     */
+    fieldMapping?: SelectFieldMapping;
+    /**
+     * 是否立即加载
+     * Whether to load immediately
+     * @default true
+     * @description 设置为 false 时，需要手动调用 load() 方法
+     * @description When set to false, need to manually call load() method
+     */
+    immediate?: boolean;
+    /**
+     * 是否强制刷新
+     * Whether to force reload
+     * @default false
+     * @description 设置为 true 时，忽略缓存重新加载
+     * @description When set to true, ignore cache and reload
+     */
+    forceReload?: boolean;
+}
+
+/**
+ * Hook 返回值
+ * Hook return value
+ */
+export declare interface UseSelectOptionsReturn {
+    /**
+     * 选项映射表
+     * Options map
+     * @description 响应式的选项数据，按字典编码分组
+     * @description Reactive option data, grouped by dictionary code
+     * @example
+     * ```ts
+     * optionsMap.value['SFQY'] // 获取 SFQY 字典的选项
+     * ```
+     */
+    optionsMap: Ref<Record<string, SelectOption[]>>;
+    /**
+     * 加载状态
+     * Loading state
+     */
+    loading: Ref<boolean>;
+    /**
+     * 手动加载
+     * Manual load
+     * @description 手动触发加载选项
+     * @description Manually trigger loading options
+     */
+    load: () => Promise<void>;
+    /**
+     * 获取单个字典的选项
+     * Get single dictionary options
+     * @param dictCode - 字典编码
+     * @returns 选项数组
+     */
+    getOptions: (dictCode: string | number) => SelectOption[];
+    /**
+     * 刷新指定字典的选项
+     * Reload specific dictionary options
+     * @param dictCode - 字典编码
+     */
+    reload: (dictCode: string | number) => Promise<void>;
+    /**
+     * 清除指定字典的缓存
+     * Clear cache for specific dictionary
+     * @param dictCode - 字典编码（可选）
+     */
+    clearCache: (dictCode?: string | number) => void;
+}
+
 /**
  * 弱密码项
  */