g-ui-web 1.3.59 → 1.3.60

package/lib/target-complete-rate/index.d.ts

@@ -1,2 +1,95 @@
-declare const TargetCompleteRate: any;
+declare const TargetCompleteRate: ({
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<globalThis.ExtractPropTypes<{
+        dbOptions: {
+            type: ObjectConstructor;
+            required: true;
+            default: () => {
+                data: never[];
+                fieldMap: {
+                    fullCyclePlan: string;
+                    fullCycleDynamic: string;
+                    plan: string;
+                    dynamic: string;
+                    offsetRatio: string;
+                };
+            };
+        };
+        fullCycleLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        actualLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, import('vue').PublicProps, {
+        dbOptions: Record<string, any>;
+        fullCycleLabel: string;
+        actualLabel: string;
+    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<globalThis.ExtractPropTypes<{
+        dbOptions: {
+            type: ObjectConstructor;
+            required: true;
+            default: () => {
+                data: never[];
+                fieldMap: {
+                    fullCyclePlan: string;
+                    fullCycleDynamic: string;
+                    plan: string;
+                    dynamic: string;
+                    offsetRatio: string;
+                };
+            };
+        };
+        fullCycleLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        actualLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{}>, {}, {}, {}, {}, {
+        dbOptions: Record<string, any>;
+        fullCycleLabel: string;
+        actualLabel: string;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<globalThis.ExtractPropTypes<{
+    dbOptions: {
+        type: ObjectConstructor;
+        required: true;
+        default: () => {
+            data: never[];
+            fieldMap: {
+                fullCyclePlan: string;
+                fullCycleDynamic: string;
+                plan: string;
+                dynamic: string;
+                offsetRatio: string;
+            };
+        };
+    };
+    fullCycleLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    actualLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+    dbOptions: Record<string, any>;
+    fullCycleLabel: string;
+    actualLabel: string;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & import('vue').Plugin) & Record<string, any>;
 export default TargetCompleteRate;

package/lib/target-complete-rate/src/index.vue.d.ts

@@ -0,0 +1,52 @@
+declare const _default: import('vue').DefineComponent<globalThis.ExtractPropTypes<{
+    dbOptions: {
+        type: ObjectConstructor;
+        required: true;
+        default: () => {
+            data: never[];
+            fieldMap: {
+                fullCyclePlan: string;
+                fullCycleDynamic: string;
+                plan: string;
+                dynamic: string;
+                offsetRatio: string;
+            };
+        };
+    };
+    fullCycleLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    actualLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<globalThis.ExtractPropTypes<{
+    dbOptions: {
+        type: ObjectConstructor;
+        required: true;
+        default: () => {
+            data: never[];
+            fieldMap: {
+                fullCyclePlan: string;
+                fullCycleDynamic: string;
+                plan: string;
+                dynamic: string;
+                offsetRatio: string;
+            };
+        };
+    };
+    fullCycleLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+    actualLabel: {
+        type: StringConstructor;
+        default: string;
+    };
+}>> & Readonly<{}>, {
+    dbOptions: Record<string, any>;
+    fullCycleLabel: string;
+    actualLabel: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

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

@@ -0,0 +1,185 @@
+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 {
+    /** 是否立即加载 */
+    immediate?: 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;
+    /**
+     * 清理配置，将旧版格式（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?: string, params?: Record<string, any>): Promise<any[]> | Promise<Record<string, any> | undefined>;
+}
+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

@@ -20,4 +20,4 @@ export default class DataSource {
  */
 export declare const resetDataSource: (data: any) => any;
 export declare const checkType: (value: any) => "数组" | "对象" | "字符串" | "其他类型";
-export {};
+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/package.json

@@ -2,7 +2,7 @@
     "name": "g-ui-web",
     "private": false,
     "description": "可视化组件库",
-    "version": "1.3.59",
+    "version": "1.3.60",
     "author": "wyu",
     "license": "MIT",
     "type": "module",
@@ -73,7 +73,8 @@
         "vue-tsc": "^2.0.24",
         "vuex": "^4.1.0",
         "vxe-table": "^4.10.5",
-        "sortablejs": "^1.15.6"
+        "sortablejs": "^1.15.6",
+        "js-cookie": "^3.0.5"
     },
     "repository": {
         "type": "git",
@@ -98,4 +99,4 @@
         "eslint-config-prettier": "^10.1.8",
         "prettier": "^3.6.2"
     }
-}
+}