g-ui-web 1.4.21 → 1.4.23

package/lib/utils/DataSource/DataProvider.d.ts

@@ -0,0 +1,186 @@
+import { Ref } from 'vue';
+import { AxiosRequestConfig } from 'axios';
+/** 数据源类型 */
+type DataSourceType = 'static' | 'api';
+/** 加载状态 */
+type LoadingStatus = 'idle' | 'loading' | 'success' | 'error';
+/** 单个数据源配置 */
+interface DataSourceConfig<T = any> {
+    /** 数据源唯一标识 */
+    key: string;
+    /** 数据源类型 */
+    type: DataSourceType;
+    /** 静态数据（type 为 static 时使用） */
+    data?: T;
+    /** API 请求配置（type 为 api 时使用） */
+    api?: {
+        url: string;
+        method?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+        params?: Record<string, any>;
+        data?: Record<string, any>;
+        headers?: Record<string, string>;
+        /** 响应数据字段路径，如 '/artists' 或 'data.items' */
+        fieldPath?: string;
+        /** 响应数据转换函数 */
+        transform?: (response: any) => T;
+    };
+}
+/** 数据源状态 */
+interface DataSourceState<T = any> {
+    data: T | null;
+    status: LoadingStatus;
+    error: Error | null;
+    lastUpdated: Date | null;
+}
+/** 融合数据转换函数参数 */
+type MergeDataMap = Record<string, any>;
+/** DataSource 构造配置 */
+interface DataSourceOptions {
+    /** 是否立即加载 */
+    autoLoad?: boolean;
+    /** 请求失败重试次数 */
+    retryCount?: number;
+    /** 重试延迟（毫秒） */
+    retryDelay?: number;
+    /** 全局请求拦截器 */
+    onRequest?: (config: AxiosRequestConfig) => AxiosRequestConfig;
+    /** 全局响应拦截器 */
+    onResponse?: (response: any) => any;
+    /** 全局错误处理 */
+    onError?: (error: Error, key: string) => void;
+    /** 融合数据的转换函数，参数为 { key: data } 形式的对象，配置后自动融合所有数据源 */
+    mergeTransformer?: (dataMap: MergeDataMap) => any[];
+}
+/** 数据更新监听器 */
+type DataUpdateListener<T = any> = (key: string, data: T, state: DataSourceState<T>) => void;
+declare class DataSource {
+    /** 数据源配置映射 */
+    private _configMap;
+    /** 数据源状态映射 */
+    private _stateMap;
+    /** 配置选项 */
+    private _options;
+    /** 数据更新监听器列表 */
+    private _listeners;
+    /** 响应式状态（用于 Vue 响应式更新） */
+    reactiveStates: Record<string, DataSourceState>;
+    /** 全局加载状态 */
+    isLoading: Ref<boolean>;
+    /** 全局错误状态 */
+    hasError: Ref<boolean>;
+    /** 调试模式 */
+    debugMode: boolean;
+    constructor(sources: any, options?: DataSourceOptions);
+    /**
+     * 添加数据源
+     */
+    addSource<T>(config: DataSourceConfig<T>): void;
+    /**
+     * 移除数据源
+     */
+    removeSource(key: string): boolean;
+    /**
+     * 加载单个数据源
+     */
+    private loadSingle;
+    /**
+     * 从对象中按路径获取值
+     * 支持两种路径格式：
+     * - 点分隔：'data.users'
+     * - 斜杠分隔：'/data/users' 或 'data/users'
+     */
+    private pickPath;
+    /**
+     * 带重试的请求
+     */
+    private fetchWithRetry;
+    /**
+     * 延迟函数
+     */
+    private delay;
+    /**
+     * 更新状态
+     */
+    private updateState;
+    /**
+     * 更新全局状态
+     */
+    private updateGlobalStatus;
+    /**
+     * 通知所有监听器
+     */
+    private notifyListeners;
+    private normalizeMethod;
+    private isOldDataSource;
+    /**
+     * 清理配置，将旧版格式（path + resPath）转换为新版 DataSourceConfig
+     * - 支持新版 fieldPath
+     * - 兼容旧版 resPath，将其转换为 fieldPath
+     */
+    private cleanConfig;
+    /**
+     * 加载数据（支持加载全部或指定的数据源）
+     * 返回融合后的数组数据
+     */
+    loadData(keys?: string | string[]): Promise<any[]>;
+    /**
+     * 刷新数据（参数变更时重新请求，或手动更新数据）
+     * @param key 数据源标识
+     * @param paramsOrData 请求参数或直接更新的数据
+     * @param manual 是否手动更新本地数据（true: 直接更新本地数据，false: 从数据源加载）
+     */
+    refreshData<T = any>(key: string, paramsOrData?: Record<string, any> | T, manual?: boolean): Promise<T>;
+    /**
+     * 刷新所有数据源
+     * 返回融合后的数组数据
+     */
+    refreshAll(params?: Record<string, Record<string, any>>): Promise<any[]>;
+    /**
+     * 获取数据
+     */
+    getData<T = any>(key: string): T | null;
+    /**
+     * 获取所有数据
+     */
+    getAllData(): Record<string, any>;
+    /**
+     * 获取状态
+     */
+    getState(key: string): DataSourceState | undefined;
+    /**
+     * 获取所有状态
+     */
+    getAllStates(): Record<string, DataSourceState>;
+    /**
+     * 获取加载状态
+     */
+    getLoadingStatus(key: string): LoadingStatus;
+    /**
+     * 检查是否正在加载
+     */
+    isSourceLoading(key: string): boolean;
+    /**
+     * 添加数据更新监听器
+     */
+    onDataUpdate(listener: DataUpdateListener): () => void;
+    /**
+     * 融合所有数据源数据
+     * @param transformer 可选的转换函数（不传则使用 options 中配置的 mergeTransformer）
+     * @returns 融合后的数组数据
+     */
+    mergeData<T = any>(transformer?: (dataMap: MergeDataMap) => T[]): T[];
+    /**
+     * 清除所有数据
+     */
+    clear(): void;
+    /**
+     * 销毁实例
+     */
+    destroy(): void;
+    /**
+     * 旧版本兼容
+     */
+    reload(key?: any, params?: Record<string, any>): Promise<any>;
+}
+export { DataSource, type DataSourceConfig, type DataSourceState, type DataSourceOptions, type DataSourceType, type LoadingStatus, type DataUpdateListener, };
+export { useDataSource, type UseDataSourceOptions } from './useDataSource';

package/lib/utils/DataSource/debugStore.d.ts

@@ -0,0 +1,28 @@
+declare const debugStore: {
+    markedComponentIds: Set<string> & Omit<Set<string>, keyof Set<any>>;
+};
+/**
+ * 标记组件用于调试
+ */
+export declare function markComponentForDebug(componentId: string): void;
+/**
+ * 取消标记组件
+ */
+export declare function unmarkComponentForDebug(componentId: string): void;
+/**
+ * 切换组件的调试标记状态
+ */
+export declare function toggleComponentDebug(componentId: string): boolean;
+/**
+ * 检查组件是否被标记用于调试
+ */
+export declare function isComponentMarkedForDebug(componentId: string): boolean;
+/**
+ * 获取所有被标记的组件 ID
+ */
+export declare function getMarkedComponentIds(): string[];
+/**
+ * 清除所有调试标记
+ */
+export declare function clearAllDebugMarks(): void;
+export { debugStore };

package/lib/utils/DataSource/index.d.ts

@@ -0,0 +1,23 @@
+type EventCallback = (data: any) => void;
+export default class DataSource {
+    dsKey: string;
+    data: any;
+    dataUrl: any;
+    events: {
+        [key: string]: EventCallback[];
+    };
+    constructor(dataUrl: any);
+    loadStaticData(data: any): void;
+    load(dataUrl: any): Promise<void>;
+    reload(params: any): void;
+    on(event: string, callback: EventCallback): void;
+    trigger(event: string, data: any): void;
+}
+/**
+ *
+ * @param data 有 静态形式 包含 array / object；或者dataUrl形式 包含 string / object；或者 DataSource形式
+ * @returns
+ */
+export declare const resetDataSource: (data: any) => any;
+export declare const checkType: (value: any) => "数组" | "对象" | "字符串" | "其他类型";
+export { toggleComponentDebug, isComponentMarkedForDebug, markComponentForDebug, unmarkComponentForDebug, getMarkedComponentIds, clearAllDebugMarks, debugStore } from './debugStore';

package/lib/utils/DataSource/useDataSource.d.ts

@@ -0,0 +1,66 @@
+import { Ref } from 'vue';
+import { DataSource, DataSourceConfig, DataSourceOptions } from './DataProvider';
+interface UseDataSourceOptions extends DataSourceOptions {
+    /** 是否在 onMounted 时自动加载 */
+    autoLoad?: boolean;
+    /** 监听的参数，参数变化时自动刷新 */
+    watchParams?: Ref<Record<string, any>> | (() => Record<string, any>);
+    /** 参数变化时刷新的数据源 key */
+    watchKeys?: string[];
+}
+declare function useDataSource(sources: DataSourceConfig | DataSourceConfig[] | any, options?: UseDataSourceOptions): {
+    /** DataSource 实例 */
+    _sourceInstance: DataSource;
+    /** 融合后的数组数据 */
+    sourceData: import('vue').Reactive<any[]>;
+    /** 所有状态 */
+    sourceState: Record<string, import('./DataProvider').DataSourceState<any>>;
+    /** 全局加载状态 */
+    isLoading: Ref<boolean, boolean>;
+    /** 全局错误状态 */
+    hasError: Ref<boolean, boolean>;
+    /** 加载数据 */
+    loadData: (keys?: string | string[]) => Promise<any[]>;
+    /** 刷新单个数据源 */
+    refreshData: (key: string, params?: Record<string, any>) => Promise<Record<string, any> | undefined>;
+    /** 兼容旧版 reload 行为 */
+    reload: (key?: string, params?: Record<string, any>) => Promise<any[] | Record<string, any> | undefined>;
+    /** 刷新所有数据源 */
+    refreshAll: (params?: Record<string, Record<string, any>>) => Promise<any[]>;
+    /** 更新数据 */
+    updateData: <T>(key: string, newData: T) => Promise<T>;
+    /** 获取状态 */
+    getState: (key: string) => import('./DataProvider').DataSourceState<any>;
+    /** 融合数据（调用 DataSource 的 mergeData） */
+    mergeData: <T = any>(transformer?: (dataMap: {
+        [x: string]: any;
+    }) => T[]) => T[];
+    /** 添加数据更新监听器 */
+    onDataUpdate: (listener: import('./DataProvider').DataUpdateListener) => () => void;
+    /** 清除数据 */
+    clear: () => void;
+    /** 销毁实例 */
+    destroy: () => void;
+};
+/**
+ * 处理静态数据，将其转换为数组格式
+ * @param data 静态数据，可能是数字、字符串、数组或对象
+ * @param dataField 如果数据是数字、字符串，指定dataField作为数组元素的键
+ * @returns 转换后的数组格式数据
+ */
+declare const convertDataToArray: (data: any, dataField?: any) => Promise<any[] | undefined>;
+/**
+ * 判断是否是 DataSource 类实例
+ */
+declare function isSourceClass(val: any): val is DataSource;
+/**
+ * 判断是否是 useDataSource 返回的实例
+ */
+declare function isSourceHook(val: any): val is ReturnType<typeof useDataSource>;
+/**
+ * 创建调试右键点击处理器
+ * @param dbOptions 组件的数据源配置对象
+ * @returns 右键点击事件处理器
+ */
+declare function createDebugHandler(dbOptions?: any): (e: MouseEvent) => Promise<void>;
+export { useDataSource, isSourceHook, isSourceClass, convertDataToArray, createDebugHandler, type UseDataSourceOptions, };

package/lib/utils/api/index.d.ts

@@ -0,0 +1,4 @@
+declare const _default: {
+    getList(props: any): any;
+};
+export default _default;

package/lib/utils/api/load.d.ts

@@ -0,0 +1,4 @@
+export declare const loads: (dataUrl: any) => Promise<{
+    resData: any;
+    res: any;
+}>;

package/lib/utils/directives/click-outside/index.d.ts

@@ -0,0 +1,3 @@
+import { ObjectDirective } from 'vue';
+declare const ClickOutside: ObjectDirective;
+export default ClickOutside;

package/lib/utils/index.d.ts

@@ -0,0 +1,57 @@
+type Func = (...args: any[]) => any;
+/**
+ * 防抖函数
+ * @param { Function } func 函数
+ * @param { Number } delay 防抖时间
+ * @param { Boolean } immediate 是否立即执行
+ * @param { Function } resultCallback
+ */
+export declare function debounce(func: Func, delay?: number, immediate?: boolean, resultCallback?: Func): {
+    (this: unknown, ...args: any[]): Promise<unknown>;
+    cancel(): void;
+};
+/**
+ * 节流函数
+ * @param { Function } func
+ * @param { Boolean } interval
+ * @param { Object } options
+ * leading:初始 trailing:结尾
+ */
+export declare function throttle(func: Func, interval: number, options?: {
+    leading: boolean;
+    trailing: boolean;
+}): {
+    (this: unknown, ...args: any[]): void;
+    cancel(): void;
+};
+/**
+ * 驼峰转换下划线
+ * @param { String } name
+ */
+export declare function toLine(name: string): string;
+export declare function formatNumber(value: number | string, precision?: number, separator?: string, decimal?: string, prefix?: string, suffix?: string): string;
+export declare const formatNumberDigit: (num: any, digit: any) => any;
+export declare const formatPercentage: (number: any) => string;
+/**
+ * 数据转化
+ */
+export declare const getNestedValue: (obj: any, keys: any) => any;
+/**
+ * 设置项目配置
+ */
+interface configProps {
+    baseURL: string;
+    sysCode: string;
+    appType: string;
+    tokenName: string;
+    token: string;
+    key: string;
+}
+export declare const setAjaxConfig: (config?: configProps) => void;
+export declare const getAjaxConfig: (key?: string) => any;
+export declare const typeofXAxis: (item: any) => "function" | "string" | "number" | "object" | "boolean" | "undefined" | "bigint" | "symbol" | "null";
+export declare const typeIsEmpty: (item: any) => boolean;
+export default class ExportTable {
+    constructor(exportConfig: any, searchParam: any[], header: any);
+}
+export {};

package/lib/utils/loading/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 页面全局 Loading
+ * @method start 创建 loading
+ * @method done 移除 loading
+ */
+export declare const loading: {
+    start: (className?: string, size?: string) => void;
+    done: (className: any, time?: number) => void;
+};

package/lib/utils/request/interface/config.d.ts

@@ -0,0 +1,93 @@
+/**
+ * 定义一个Ajax请求的配置接口
+ * @interface AjaxOptions
+ * @property {string} url - 请求的URL地址
+ * @property {string} baseURL - 请求的baseURL地址
+ * @property {string} [method] - 请求的方法，默认为GET，可选值包括GET, POST, PUT, DELETE等
+ * @property {string} [ContentType] - 请求的内容类型，例如 'application/json' 或 'application/x-www-form-urlencoded'
+ * @property {any} [params] - 请求的参数，可以是任意类型的对象，通常用于拼接在URL后
+ * @property {any} [data] - 请求发送的数据，可以是任意类型的对象
+ * @property {number} [timeout] - 请求的超时时间，单位为毫秒
+ * @property {boolean} [withCredentials] - 是否携带跨域请求的凭证（cookies）
+ * @property {'json' | 'text' | 'blob' | 'arraybuffer' | 'document' | 'stream'} [ResponseType] - 期望的响应类型
+ * @property {boolean} [isLoading] - 标记请求是否正在加载
+ * @property {any} [loadingConfig] - 加载状态的配置项，可以是任意类型的对象
+ * @property {(data: any) => any} [resultFilter] - 请求返回数据的过滤器函数，可用于数据处理和转换
+ */
+export interface AjaxOptions {
+    url: string;
+    baseURL: string;
+    method?: string;
+    ContentType?: string;
+    params?: any;
+    data?: any;
+    timeout?: number;
+    withCredentials?: boolean;
+    ResponseType?: 'json' | 'text' | 'blob' | 'arraybuffer' | 'document' | 'stream';
+    isLoading?: boolean;
+    loadingConfig?: any;
+    headers?: any;
+    resultFilter?: (data: any) => any;
+}
+/**
+ * 定义一个Ajax请求的配置接口
+ * 该接口用于配置Ajax请求的各种行为，包括加载状态切换、请求锁定、请求完成、成功回调、错误回调和取消回调等
+ */
+export interface AjaxConfig {
+    /**
+     * 加载状态切换的回调函数
+     * @param value boolean类型，表示加载状态是否开启
+     * 该函数用于在请求开始和结束时切换页面的加载状态（如显示或隐藏加载动画）
+     */
+    loadingSwitch?: (value: boolean) => void;
+    /**
+     * 请求锁定的函数
+     * @returns boolean类型，表示是否允许继续发送请求
+     * 该函数用于在请求发送前进行一些检查，如防止重复发送请求等
+     */
+    lock?: () => boolean;
+    /**
+     * 请求完成的回调函数
+     * @param url string类型，表示完成请求的URL
+     * 该函数在请求无论成功或失败，只要完成就会被调用，可用于记录日志等操作
+     */
+    complete?: (url: string) => void;
+    /**
+     * 请求成功时的回调函数
+     * @param data any类型，表示请求成功返回的数据
+     * 该函数用于处理请求成功后需要执行的操作，如将数据渲染到页面等
+     */
+    callback?: (data: any) => void;
+    /**
+     * 请求错误时的回调函数
+     * @param message any类型，表示错误信息
+     * @param status number类型，表示HTTP状态码
+     * 该函数用于处理请求错误时需要执行的操作，如显示错误信息等
+     */
+    errorCallback?: (message: any, status: number) => void;
+    /**
+     * 请求取消时的回调函数
+     * @param err any类型，表示取消请求时的错误信息
+     * 该函数用于处理请求取消时需要执行的操作，如清理资源等
+     */
+    cancelCallback?: (err: any) => void;
+}
+/**
+ * 定义默认的HTTP请求头。
+ *
+ * 这是一个对象，键是请求头的字段名，值是字段的值。
+ * 主要用于设置跨域请求的Access-Control-Allow-Origin以及标识请求类型为XMLHttpRequest。
+ */
+export declare const defaultHeaders: {
+    'Access-Control-Allow-Origin': string;
+    'X-Requested-With': string;
+};
+/**
+ * 获取完整URL
+ *
+ * @param options 配置选项
+ * @param options.baseURL 基础URL
+ * @param options.url 路径或相对URL
+ * @returns 拼接后的完整URL
+ */
+export declare function getFullUrl(options: any): string;

package/lib/utils/request/interface/index.d.ts

@@ -0,0 +1,3 @@
+import { AjaxConfig } from './config';
+declare function interfaceAxios(options: any, ajaxConfig?: AjaxConfig): any;
+export default interfaceAxios;

package/lib/utils/request/interface/interface.d.ts

@@ -0,0 +1,3 @@
+import { AjaxOptions, AjaxConfig } from './config';
+declare function ImplementAxios(options: AjaxOptions, ajaxConfig: AjaxConfig): Promise<void>;
+export default ImplementAxios;

package/lib/utils/request/utils/code.d.ts

@@ -0,0 +1,6 @@
+interface HttpCodeMessage {
+    message: string;
+    status?: number;
+}
+export default function httpCodeFilter(code: number): HttpCodeMessage;
+export {};

package/lib/utils/request/utils/filter.d.ts

@@ -0,0 +1,2 @@
+declare const paramsFilter: (params: any, ContentType?: string) => any;
+export default paramsFilter;

package/lib/utils/request/utils/loading.d.ts

@@ -0,0 +1,14 @@
+type LoadingConfig = {
+    text?: string;
+    background?: string;
+};
+type LoadingState = {
+    hide: any;
+    show: any;
+    instance: any;
+    count: number;
+};
+export declare const loading: LoadingState;
+export declare const showLoading: (config?: LoadingConfig) => void;
+export declare const hideLoading: () => void;
+export {};

package/lib/utils/storage.d.ts

@@ -0,0 +1,27 @@
+/**
+ * window.localStorage 浏览器永久缓存
+ * @method set 设置永久缓存
+ * @method get 获取永久缓存
+ * @method remove 移除永久缓存
+ * @method clear 移除全部永久缓存
+ */
+export declare const Local: {
+    setKey(key: string): string;
+    set<T>(key: string, val: T): void;
+    get(key: string): any;
+    remove(key: string): void;
+    clear(): void;
+};
+/**
+ * window.sessionStorage 浏览器临时缓存
+ * @method set 设置临时缓存
+ * @method get 获取临时缓存
+ * @method remove 移除临时缓存
+ * @method clear 移除全部临时缓存
+ */
+export declare const Session: {
+    set<T>(key: string, val: T): void;
+    get(key: string): any;
+    remove(key: string): void;
+    clear(): void;
+};

package/lib/utils/theme/config/black-blue.d.ts

@@ -0,0 +1,130 @@
+declare const theme: {
+    name: string;
+    bgColor: string;
+    boxColor: string;
+    textFontColor: string;
+    backColor: string;
+    backBorderColor: string;
+    contentFillColor: string;
+    primary: string;
+    primary1: string;
+    primary2: string;
+    primary3: string;
+    primary4: string;
+    primary5: string;
+    primary6: string;
+    primary7: string;
+    primaryLight: string;
+    primaryLight1: string;
+    primaryLight2: string;
+    primaryLight3: string;
+    primaryLight4: string;
+    primaryLight5: string;
+    primaryLight6: string;
+    primaryLight7: string;
+    success: string;
+    success1: string;
+    success2: string;
+    success3: string;
+    success4: string;
+    success5: string;
+    success6: string;
+    success7: string;
+    warning: string;
+    warning1: string;
+    warning2: string;
+    warning3: string;
+    warning4: string;
+    warning5: string;
+    warning6: string;
+    warning7: string;
+    danger: string;
+    danger1: string;
+    danger2: string;
+    danger3: string;
+    danger4: string;
+    danger5: string;
+    danger6: string;
+    danger7: string;
+    error: string;
+    info: string;
+    info1: string;
+    info2: string;
+    info3: string;
+    info4: string;
+    info5: string;
+    info6: string;
+    info7: string;
+    text: {
+        primary: string;
+        regular: string;
+        secondary: string;
+        placeholder: string;
+        disabled: string;
+        light: string;
+    };
+    border: {
+        border: string;
+        light: string;
+        lighter: string;
+        extraLight: string;
+        dark: string;
+        darker: string;
+    };
+    fill: {
+        fill: string;
+        light: string;
+        lighter: string;
+        extraLight: string;
+        dark: string;
+        darker: string;
+        blank: string;
+        bgExtraLight: string;
+        bgDark: string;
+    };
+    scrollColor: string;
+    bg: {
+        bg: string;
+        page: string;
+        overlay: string;
+    };
+    chartOption: {
+        fontSize: number;
+        barWidth: number;
+        symbolSize: number;
+        backgroundColor: string;
+        padding: number[];
+        margin: number;
+        grid: {
+            top: string;
+            left: string;
+            right: string;
+            bottom: string;
+        };
+        colors: string[];
+        auxiliaryColors: string[];
+        chartTitleColor: string;
+        chartSubtitleColor: string;
+        chartMarkTextColor: string;
+        chartLegendTextColor: string;
+        chartAxisLineColor: string;
+        chartAxisTickColor: string;
+        chartAxisLabelColor: string;
+    };
+    aMapStyle: string;
+    aMapScatterColor: string;
+    tooltipFill: string;
+    tableHeaderBgColor: string;
+    tableHeaderTextColor: string;
+    rankingRed: string;
+    rankingBlack: string;
+    cupTitleColor: string;
+    cupNameColor: string;
+    cupTextColor: string;
+    cupChangeTextColor: string;
+    cupRateTextColor: string;
+    cupTHeadTextColor: string;
+    cupTHeadBgColor: string;
+    cupTbodyBgColor: string;
+};
+export default theme;