xframelib 0.3.9 → 0.4.3

package/dist/mitt/index.d.ts

@@ -0,0 +1,25 @@
+export declare type EventType = string | symbol;
+export declare type Handler<T = any> = (event?: T) => void;
+export declare type WildcardHandler = (type: EventType, event?: any) => void;
+export declare type EventHandlerList = Array<Handler>;
+export declare type WildCardEventHandlerList = Array<WildcardHandler>;
+export declare type EventHandlerMap = Map<EventType, EventHandlerList | WildCardEventHandlerList>;
+export interface Emitter {
+    all: EventHandlerMap;
+    on<T = any>(type: EventType, handler: Handler<T>): void;
+    on(type: '*', handler: WildcardHandler): void;
+    off<T = any>(type: EventType, handler: Handler<T>): void;
+    off(type: '*', handler: WildcardHandler): void;
+    emit<T = any>(type: EventType, event?: T): void;
+    emit(type: '*', event?: any): void;
+}
+/**
+ * Mitt: Tiny (~200b) functional event emitter / pubsub.
+ * @name mitt
+ * @returns {Mitt}
+ */
+export default function mitt(all?: EventHandlerMap): Emitter;
+/**
+ * 默认全局总线对象
+ */
+export declare const GlobalMitt: Emitter;

package/dist/model/Config.d.ts

@@ -0,0 +1,94 @@
+/**
+ * UI界面相关
+ */
+export interface IUIObject {
+    /**
+     * 网站标题
+     */
+    SiteTitle: string;
+    /**
+     * 版权
+     */
+    CopyRight: string;
+    /**
+     * 官方链接
+     */
+    WebSite?: string;
+    /**
+     * 超时锁屏时间(单位：秒s)
+     */
+    LockTime?: number;
+    /**
+     * 其他扩展的属性
+     */
+    [props: string]: any;
+}
+/**
+ * 服务URL
+ */
+export interface IServiceURL {
+    /**
+     * 用户登录（统一用户登录）
+     */
+    LoginAuthURL: string;
+    /**
+     * Axios普通WebAPI的BaseURL
+     * 全局默认的http请求地址（一般与主hprose相同或不同）;文件上传地址
+     */
+    DefaultWebAPI?: string;
+    /**
+     * 默认HproseAPI的服务地址
+     */
+    DefaultHproseAPI?: string;
+    /**
+     * 其他扩展的URL属性
+     */
+    [props: string]: any;
+}
+/**
+ * 地图相关Keys
+ */
+export interface IMapKeys {
+    /**
+     * 天地图Key
+     */
+    TDTKey?: string;
+    /**
+     * MapboxKey
+     */
+    MapboxKey?: string;
+    /**
+     * Cesium Key
+     */
+    CesiumKey?: string;
+    /**
+     * Google地图Key
+     */
+    GoogleKey?: string;
+    /**
+     * 其他扩展的Key属性
+     */
+    [props: string]: any;
+}
+/**
+ * 系统配置信息
+ */
+export interface ISystemConfig {
+    /**
+     * 用户界面配置
+     */
+    UI?: IUIObject;
+    /**
+     * 服务URL
+     */
+    ServiceURL: IServiceURL;
+    /**
+     * 地图相关Keys
+     */
+    MapKeys?: IMapKeys;
+    /**
+     * API服务路径
+     */
+    APIPath?: object;
+    [props: string]: any;
+}

package/dist/model/Constants.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 刷新提前量(毫秒,ms)
+ */
+export declare const TOKEN_REFRESH_TIME: number;
+/**
+ * 用户和Token相关服务API
+ */
+export declare const USER_TOKEN_API: {
+    Login: string;
+    CheckLogin: string;
+    Logout: string;
+    ChangePWD: string;
+    RefreshToken: string;
+    CheckToken: string;
+};

package/dist/model/Layout.d.ts

@@ -0,0 +1,75 @@
+import { Component } from 'vue';
+export declare type Lazy<T> = () => Promise<T>;
+/**
+ *布局枚举类型
+ */
+export declare enum LayoutContainerEnum {
+    top = 0,
+    bottom = 1,
+    centerBack = 2,
+    centerMain = 3,
+    centerFront = 4,
+    left = 5,
+    right = 6
+}
+/**
+ * 组件布局
+ */
+export interface IWidgetLayout {
+    top?: number;
+    left?: number;
+    right?: number;
+    bottom?: number;
+    width?: string;
+    height?: string;
+}
+export interface IWidgetConfig {
+    /**
+     * 唯一ID,与组件名一致
+     */
+    id: string;
+    /**
+     * 标题或说明
+     */
+    label?: string;
+    /**
+     * 图标路径(备用)
+     */
+    icon?: string;
+    /**
+     * 所属容器，top/bottom/left/right等
+     */
+    container: LayoutContainerEnum;
+    /**
+     * 外部组件js url(备用)
+     */
+    jsURL?: string;
+    /**
+     * 外部组件css url(备用)
+     */
+    cssURL?: string;
+    /**
+     * 动态加载的组件
+     */
+    component: Lazy<Component>;
+    /**
+     * 是否初始化时，预加载
+     */
+    preload?: boolean;
+    /**
+     * 前置容器ID,一般也就是bindid
+     */
+    afterid?: string;
+    /**
+     * 绑定依赖容器ID,不一定有afterid
+     */
+    bindid?: string;
+    /**
+     * 所属组，用于业务分类
+     */
+    group?: string;
+    /**
+     * 外部定义布局(备用)
+     */
+    layout?: IWidgetLayout;
+}

package/dist/model/Token.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 当前存储的token对象
+ */
+export interface ITokenInfo {
+    id: string;
+    name: string;
+    token: string;
+    expire: string;
+    refresh: string;
+}
+/**
+ * 单个token对象内容
+ * 与后台相匹配
+ */
+export interface IToken {
+    /**
+     * token内容
+     */
+    tokenContent: string;
+    /**
+     * 超时时间
+     */
+    expires: string;
+}
+/**
+ * 双Token接口定义
+ */
+export interface IDoubleToken {
+    /**
+     * 当前有效token
+     */
+    accessToken: IToken;
+    /**
+     * 用于刷新的token
+     */
+    refreshToken: IToken;
+}
+/**
+ * 系统用户
+ */
+export interface ISystemUser {
+    /**
+     * 用户ID
+     */
+    id: string;
+    /**
+     * 用户名
+     */
+    name: string;
+    /**
+     * 用户组ID
+     */
+    groupid?: string;
+    photo?: string;
+    mobile?: string;
+    qq?: string;
+    email?: string;
+    img?: string;
+    issystem?: boolean;
+    createtime?: string;
+    updatetime?: string;
+    issecurity?: boolean;
+    appkey?: string;
+    role?: string;
+    doubleToken?: IDoubleToken;
+}

package/dist/model/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Config';
+export * from './Token';
+export * from './Constants';
+export * from './Layout';

package/dist/utils/AxiosHelper.d.ts

@@ -0,0 +1,51 @@
+export declare type ResponseType = 'arraybuffer' | 'blob' | 'document' | 'json' | 'text' | 'stream';
+/**
+ * Get服务请求
+ * @param apiUrl API接口路径
+ * @param baseUrl 基础服务路径
+ * @param _params 参数
+ * @param headers headers参数
+ * @param responseType 响应类型,默认为json
+ * @param cancelToken  取消标识
+ * @returns 返回Promise对象
+ */
+declare function requestGet(apiUrl: string, baseUrl?: string, _params?: any, headers?: any, responseType?: ResponseType, cancelToken?: any): Promise<any>;
+/**
+ * Post服务请求-FormData
+ * @param apiUrl API接口路径
+ * @param baseUrl 基础服务路径
+ * @param _params 参数
+ * @param headers headers参数
+ * @returns 返回Promise对象
+ */
+declare function requestPost(apiUrl: string, baseUrl?: string, _bodyParams?: any, _queryParams?: any, headers?: any, responseType?: ResponseType): Promise<any>;
+/**
+ * Post服务请求-Body方式
+ * @param apiUrl API接口路径
+ * @param baseUrl 基础服务路径
+ * @param _params 参数
+ * @returns 返回Promise对象
+ */
+declare function requestPostBody(apiUrl: string, baseUrl?: string, _bodyParams?: any, _queryParams?: any, headers?: any, responseType?: ResponseType): Promise<any>;
+/**
+ * 业务服务Get请求
+ * @param apiUrl API接口路径
+ * @param _params 参数
+ * @returns 返回Promise对象
+ */
+declare function get(apiUrl: string, _params?: any): Promise<any>;
+/**
+ * 业务服务Post请求
+ * @param apiUrl API接口路径
+ * @param _params 参数
+ * @returns 返回Promise对象
+ */
+declare function post(apiUrl: string, _params?: any): Promise<any>;
+/**
+ * 独立的外部Get请求（无token验证信息）
+ * @param fullRequestURL 完整请求路径
+ * @param _params 请求参数
+ * @returns  返回Promise对象
+ */
+declare function getData(fullRequestURL: string, _params?: any): Promise<any>;
+export { get, post, requestPost, requestGet, getData, requestPostBody };

package/dist/utils/BigFileDownload.d.ts

@@ -0,0 +1,106 @@
+/**
+ * 下载文件信息模型
+ */
+export interface IFileMeta {
+    id?: string;
+    name: string;
+    length: number;
+    downloadID: string;
+    chunkSize?: number;
+}
+/**
+ * 文件下载事件
+ */
+export declare type FileDownloadEvent = 'init' | 'info' | 'error' | 'downloadProgress' | 'saveProgress' | 'success';
+/**
+ * 大文件分片/断点续传下载
+ */
+export declare class BigFileDownload {
+    private fileID;
+    private downloadURL;
+    ChunkUnitM: number;
+    private chunkByteSize;
+    private totalChunks;
+    private currentDB?;
+    private keys?;
+    private fileMetaData;
+    private finishNum;
+    private eventTarget;
+    private cancelSource;
+    private isStarting;
+    private fileName?;
+    constructor(fileID: string, downloadURL: string, chunkSizeM?: number);
+    /**
+     * 订阅事件
+     */
+    on(eventName: FileDownloadEvent, fn: (event: any) => void): void;
+    /**
+     * 发送消息
+     */
+    private dispatch;
+    /**
+     * 抛出异常信息
+     * @param data 异常描述
+     */
+    private dispatchError;
+    /**
+     * 推送文字进度
+     * @param data 文字消息
+     */
+    private dispatchInfo;
+    /**
+     * Get请求获取文件元数据信息
+     * @param baseURL 根URL路径
+     * @param apiPath  方法路径
+     * @param queryParams 请求参数
+     * @returns IFileMeta
+     */
+    queryDownloadFileMeta(baseURL: string, apiPath?: string, queryParams?: any): Promise<IFileMeta | null>;
+    /**
+     *获取本地的File元数据信息
+     */
+    getIFileMeta(): Promise<IFileMeta | null>;
+    /**
+     * 初始化信息
+     */
+    private initIndexDB;
+    /**
+     * 初始化要下载的文件元数据
+     * @param url 下载路径
+     * @returns
+     */
+    init(fileMeta: IFileMeta): Promise<void>;
+    /**
+     * 获取分片大小
+     * @returns
+     */
+    getTotalChunks(): number;
+    /**
+     * 暂停下载
+     */
+    pause(): void;
+    /**
+     * 重新开始
+     */
+    restart(): void;
+    /**
+     * 删除下载任务
+     */
+    delete(): void;
+    /**
+     * 开始分段下载
+     */
+    download(downURL?: string): void;
+    /**
+     * 下载完成进度
+     */
+    private downloadProgress;
+    /**
+     * 输出保存文件进度-分片统计
+     */
+    private outputProgress;
+    /**
+     * 保存文件
+     */
+    private savefile;
+}

package/dist/utils/Color.d.ts

@@ -0,0 +1,74 @@
+/**
+ * rgb转十六进制
+ * @param colorRGB rgb颜色值
+ * @returns
+ */
+export declare function getHexColor(colorRGB: string): string;
+/**
+ * 十六进制转RGB
+ * @param color16 十六进制颜色值
+ * @returns
+ */
+export declare function getRGBColor(color16: string): string;
+/**
+ * 解决十六进制短颜色问题
+ * @param colorHex 十六进制颜色
+ * @returns
+ */
+export declare function getLongHexColor(colorHex: string): string;
+export declare enum EnumColor {
+    RGBA = 0,
+    Hex = 1,
+    Hsla = 2
+}
+/**
+ * 判断是否是16进制颜色
+ * @param colorStr 颜色字符串
+ * @returns
+ */
+export declare function isEnumColor(colorStr: string): EnumColor | undefined;
+export declare function getRGBColorFromHSLA(colorHSLA: string): string | undefined;
+/**
+ * 判断是否 十六进制颜色值.
+ * 输入形式可为 #fff000 #f00
+ *
+ * @param   String  color   十六进制颜色值
+ * @return  Boolean
+ */
+export declare function isHexColor(color: string): boolean;
+/**
+ * RGB 颜色值转换为 十六进制颜色值.
+ * r, g, 和 b 需要在 [0, 255] 范围内
+ *
+ * @return  String          类似#ff00ff
+ * @param r
+ * @param g
+ * @param b
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Transform a HEX color to its RGB representation
+ * @param {string} hex The color to transform
+ * @returns The RGB representation of the passed color
+ */
+export declare function hexToRGB(hex: string): string;
+export declare function colorIsDark(color: string): boolean | undefined;
+/**
+ * Darkens a HEX color given the passed percentage
+ * @param {string} color The color to process
+ * @param {number} amount The amount to change the color by
+ * @returns {string} The HEX representation of the processed color
+ */
+export declare function darken(color: string, amount: number): string;
+/**
+ * Lightens a 6 char HEX color according to the passed percentage
+ * @param {string} color The color to change
+ * @param {number} amount The amount to change the color by
+ * @returns {string} The processed color represented as HEX
+ */
+export declare function lighten(color: string, amount: number): string;
+/**
+ * Determines what the best text color is (black or white) based con the contrast with the background
+ * @param hexColor - Last selected color by the user
+ */
+export declare function calculateBestTextColor(hexColor: string): "#000000" | "#FFFFFF";

package/dist/utils/FileDownload.d.ts

@@ -0,0 +1,36 @@
+/**
+ * 下载文件
+ * @param content 文本或二进制文件
+ * @param filename 文件名
+ */
+declare const Download: (content: string | any, filename: string) => void;
+/**
+ * URL方式保存文件到本地
+ * @param data 文件的blob数据
+ * @param name 文件名
+ */
+declare function SaveAs(data: string | any, name: string): void;
+/**
+ * JSON对象下载为.json文件
+ * @param jsonObject Json对象
+ * @param jsonID 名称(不需要后缀名)
+ */
+declare const JsonDownload: (jsonObject: object, jsonID: string) => void;
+/**
+ * 从Web上下载文件
+ * （通过axios下载）
+ * @param requestUrl URL下载地址
+ * @param fileName 文件名
+ */
+declare const HttpDownload: (axios: any, requestUrl: string, fileName: string) => void;
+/**
+ * 根据文件地址下载文件
+ * (网站内部文件或外部图片地址)
+ * @param {*} sUrl
+ */
+declare function DownloadByUrl({ url, target, fileName }: {
+    url: string;
+    target?: '_self' | '_blank';
+    fileName?: string;
+}): Promise<boolean>;
+export { Download, SaveAs, JsonDownload, HttpDownload, DownloadByUrl };

package/dist/utils/FileUpload.d.ts

@@ -0,0 +1,90 @@
+import { XhrHeaders } from 'xhr';
+export declare type FileEventName = 'attempt' | 'attemptFailure' | 'chunkSuccess' | 'error' | 'offline' | 'online' | 'progress' | 'success';
+export declare type AllowedMethods = 'PUT' | 'POST' | 'PATCH';
+/**
+ * 文件上传配置
+ */
+export interface FileUploadOptions {
+    endpoint: string | ((file?: File) => Promise<string>);
+    file: File;
+    method?: AllowedMethods;
+    headers?: XhrHeaders;
+    maxFileSize?: number;
+    chunkSize?: number;
+    attempts?: number;
+    /**
+     * 单位：秒
+     */
+    delayBeforeAttempt?: number;
+    md5?: string;
+}
+/**
+ * 文件上传类
+ */
+export default class FileUpload {
+    endpoint: string | ((file?: File) => Promise<string>);
+    file: File;
+    headers: XhrHeaders;
+    method: AllowedMethods;
+    chunkSize: number;
+    attempts: number;
+    delayBeforeAttempt: number;
+    md5: string;
+    private chunk?;
+    private chunkCount;
+    private chunkByteSize;
+    private maxFileBytes;
+    private endpointValue?;
+    private totalChunks;
+    private attemptCount;
+    private offline;
+    private paused;
+    private success;
+    private currentXhr?;
+    private reader;
+    private eventTarget;
+    private fileName;
+    constructor(options: FileUploadOptions);
+    /**
+     * 订阅事件
+     */
+    on(FileEventName: FileEventName, fn: (event: any) => void): void;
+    abort(): void;
+    pause(): void;
+    resume(): void;
+    /**
+     * 发送消息
+     */
+    private dispatch;
+    /**
+     *验证参数的正确性
+     */
+    private validateOptions;
+    /**
+     * Endpoint can either be a URL or a function that returns a promise that resolves to a string.
+     */
+    private getEndpoint;
+    /**
+     * Get portion of the file of x bytes corresponding to chunkSize
+     */
+    private getChunk;
+    private xhrPromise;
+    /**
+     * Send chunk of the file with appropriate headers and add post parameters if it's last chunk
+     */
+    private sendChunk;
+    /**
+     * 失败处理和尝试
+     */
+    private manageRetries;
+    /**
+     * 进行分片上传，并处理错误和重试
+     */
+    private sendChunks;
+}
+/**
+ * 创建文件上传对象方法
+ * @param options
+ * @returns
+ */
+export declare const createFileUpload: (options: FileUploadOptions) => FileUpload;