xframelib 0.3.7 → 0.4.2

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,36 @@
+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: string;
+    label?: string;
+    icon?: string;
+    container: LayoutContainerEnum;
+    component: Lazy<Component>;
+    preload?: boolean;
+    afterid?: 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;

package/dist/utils/H5Tool.d.ts

@@ -0,0 +1,98 @@
+/**
+ * 常用H5相关操作
+ */
+export default class H5Tool {
+    /**
+     * HTML元素事件监听
+     * @param element Window或HTMLElement
+     * @param type 事件名称
+     * @param handler 处理函数
+     */
+    static addHandler(element: Window | HTMLElement | any, type: string, handler: Function): void;
+    /**
+     * 窗体变化事件
+     * @param handlerFunc 窗体变化处理函数
+     */
+    static windowResizeHandler(handlerFunc: Function): void;
+    /**
+     * 是否支持全屏操作
+     * @returns true/false
+     */
+    static fullscreenEnabled(): boolean;
+    /**
+     * 全屏
+     * @param el HTML元素
+     * @param isfull 是否全屏
+     */
+    static fullScreen(element: any | Element, isfull: boolean): void;
+    /**
+     * 进入全屏
+     * @param element 全屏要素容器
+     */
+    static requestFullScreen(el?: any | Element): void;
+    /**
+     * 退出全屏
+     */
+    static exitFullScreen(): void;
+    /**
+     * 获取全屏的容器元素
+     * @returns 全屏的容器元素
+     */
+    static fullScreenElement(): Element | HTMLElement | Document | null;
+    /**
+     * 是否是全屏
+     * @returns 全屏状态
+     */
+    static isFullScreen(): boolean;
+    /**
+     * 监听全屏变化状态
+     * @param handlerFunc 全屏状态变化的处理函数
+     */
+    static onFullScreenChanged(handlerFunc: (isfullscreen: boolean) => any): void;
+    /**
+     * 解决对象Json化循环引用问题
+     * @param key
+     * @param value
+     * @returns
+     */
+    static stringifyCircularHandler(key: string, value: any): any;
+    /**
+     * 对象Json化——解决循环引用问题
+     * @param obj 传入对象参数
+     * @returns 无循环引用的新对象
+     */
+    static jsonStringify(obj: any): string;
+    /**
+     * 去掉JSON循环引用关系
+     * @param obj 传入对象参数
+     * @returns 无循环引用的新对象
+     */
+    static jsonParse(obj: any): any;
+    /**
+     * 获取input File的对象的数据路径
+     * @param file File对象
+     * @returns
+     */
+    static getObjectURL(file: any): string | undefined;
+    /**
+     * 获取文件的短MD5摘要
+     * @param fileObj file对象
+     * @param handleMd5Result 处理文件MD5结果
+     */
+    static getFileShortMD5(fileObj: any, handleMd5Result: (data: {
+        isOK: boolean;
+        data: string;
+    }) => void): any;
+    /**
+     * 提供MD5值计算
+     * @param content 字符串
+     * @param needRawHash 是否需要是二进制格式的结果，默认为false
+     * @returns MD5值
+     */
+    static MD5(content: string, needRawHash?: boolean): string;
+    /**
+     * 复制文本
+     * @param text
+     */
+    static copyText: (text: string) => Promise<unknown>;
+}

package/dist/utils/IsTool.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @description: 判断值是否未某个类型
+ */
+export declare function is(val: unknown, type: string): boolean;
+/**
+ * @description:  是否为函数
+ */
+export declare function isFunction<T = Function>(val: unknown): val is T;
+/**
+ * @description: 是否已定义
+ */
+export declare const isDef: <T = unknown>(val?: T | undefined) => val is T;
+export declare const isUnDef: <T = unknown>(val?: T | undefined) => val is T;
+export declare function isNull(val: unknown): val is null;
+export declare function isNullAndUnDef(val: unknown): val is null | undefined;
+export declare function isNullOrUnDef(val: unknown): val is null | undefined;
+/**
+ * @description: 是否为对象
+ */
+export declare const isObject: (val: any) => val is Record<any, any>;
+/**
+ * @description:  是否为时间
+ */
+export declare function isDate(val: unknown): val is Date;
+/**
+ * @description:  是否为数值
+ */
+export declare function isNumber(val: unknown): val is number;
+/**
+ * @description:  是否为AsyncFunction
+ */
+export declare function isAsyncFunction<T = any>(val: unknown): val is Promise<T>;
+/**
+ * @description:  是否为promise
+ */
+export declare function isPromise<T = any>(val: unknown): val is Promise<T>;
+/**
+ * @description:  是否为字符串
+ */
+export declare function isString(val: unknown): val is string;
+/**
+ * @description:  是否为boolean类型
+ */
+export declare function isBoolean(val: unknown): val is boolean;
+/**
+ * @description:  是否为数组
+ */
+export declare function isArray(val: any): val is Array<any>;
+/**
+ * @description: 是否客户端
+ */
+export declare const isClient: () => boolean;
+/**
+ * @description: 是否为浏览器
+ */
+export declare const isWindow: (val: any) => val is Window;
+export declare const isElement: (val: unknown) => val is Element;
+export declare const isServer: boolean;
+export declare function isImageDom(o: Element): boolean;
+/**
+ * 是否为空
+ * @param source
+ * @returns
+ */
+export declare function isEmpty(source: unknown): boolean;
+/**
+ * 是否是异常
+ * @param val
+ * @returns
+ */
+export declare function isError(val: unknown): boolean;
+/**
+ * 判断元素是否为WeakSet
+ * @param source
+ * @returns
+ */
+export declare function isWeakSet(source: unknown): boolean;
+/**
+ * @description 判断元素是否为WeakMap
+ * @param {*} source 元素
+ * @return {Boolen}
+ */
+export declare function isWeakMap(source: unknown): boolean;
+/**
+ * @description 判断元素是否为Symbol
+ * @param {*} source 元素
+ * @return {Boolen}
+ */
+export declare function isSymbol(source: unknown): boolean;
+/**
+ * @description 判断元素是否为Map
+ * @param {*} source 元素
+ * @return {Boolen}
+ */
+export declare function isMap(source: unknown): boolean;
+/**
+ * 是否有效的URL地址
+ * @param url
+ * @returns
+ */
+export declare const isValidURL: (url: string) => boolean;