@liuit/core 1.0.0

package/README.md

@@ -0,0 +1,26 @@
+###  core 核心工具包
+
+### 一. 本组介绍
+
+```
+   作者: 黑肱
+   邮箱: zuiwoxing@qq.com
+   1. 项目描述:  主要提供前端开发常用工具
+   2. 组件功能:
+       2.1 IOC容器,类似spring的IOC容器
+       2.2 AOP 面向切面的编程组件
+       2.3 Logger 日志组件
+       2.4 Common Util 包含常用的工具(日期,Cookie,枚举,代理,文件,浏览器,配置信息,正则,Url工具,零宽字符,事件总线等) 
+       2.5 安全工具包(提供客户端签名,加解密常用工具)
+```
+ 
+
+### 二. 组件安装
+
+```text
+   npm i @liuit/core
+   或者
+   yarn add @liuit/core
+```
+
+### 三. 组件使用

package/dist/aop/AopUtil.d.ts

@@ -0,0 +1,26 @@
+/**
+ *@desc aop代理工具类
+ *@author liudejian
+ *@date 2020-03-20 21:45
+ **/
+import { MethodHandler } from "./MethodHandler";
+/**
+ * AOP工具类
+ */
+export declare class AopUtil {
+    /**
+     * 创建代理实例
+     * @param classType 原始类
+     * @param handler 方法拦截器
+     * @return 返回原始代理类实例
+     */
+    static createProxyInstance<T>(classType: new () => T, handler: MethodHandler): T;
+    /**
+     * 创建代理
+     * @param classType 原始类
+     * @param handler 方法拦截器
+     * @param excludeMethods 排除的方法名[选填]
+     * @return 返回代理类
+     */
+    static createProxy<T>(classType: new () => T, handler: MethodHandler, excludeMethods?: Array<string>): new () => T;
+}

package/dist/aop/ClassUtil.d.ts

@@ -0,0 +1,39 @@
+import 'reflect-metadata';
+/**
+ *@desc
+ *@author liudejian
+ *@date 2023-12-24 11:00
+ **/
+export declare class ClassUtil {
+    /**
+     * 创建对象实例
+     * @param cls  类
+     * @param params 构造参数
+     */
+    static newInstance(cls: any, params: any): any;
+    /**
+     * 判断一个对象是class 还是 class实例
+     * @param obj
+     */
+    static isClass(obj: any): boolean;
+    /**
+     * 获取对象声明字段
+     * @param cls
+     */
+    static getFields(cls: any): Array<string>;
+    /**
+     * 获取所有 声明方法
+     * @param cls
+     */
+    static getMethodNames(cls: any): Array<string>;
+    /**
+     * 获取所有声明的方法
+     * @param cls
+     */
+    static getMethods(cls: any): Array<Function>;
+    /**
+     * 获取方法参数名
+     * @param method
+     */
+    static getMethodParamNames(method: Function): Array<string>;
+}

package/dist/aop/MethodHandler.d.ts

@@ -0,0 +1,33 @@
+/**
+ *@desc 方法处理
+ *@author liudejian
+ *@date 2020-03-20 21:59
+ **/
+export interface MethodHandler {
+    /**
+     * 执行前
+     * @param target 目标函数
+     * @param args 入参
+     */
+    before(target: Function, ...args: any): any;
+    /**
+     * 执行方法后
+     * @param target 目标函数
+     * @param result 执行方法返回的结果
+     * @param args 入参
+     */
+    after(target: Function, result: any, ...args: any): void;
+    /**
+     * 异常
+     * @param target 目标函数
+     * @param e
+     */
+    exception(target: Function, e: any): void;
+    /**
+     * 最终返回
+     * @param target 目标函数
+     * @param result 执行方法返回的结果
+     * @param args  入参
+     */
+    finally(target: Function, result: any, ...args: any): void;
+}

package/dist/aop/TestAopUtil.d.ts

@@ -0,0 +1,5 @@
+import { Logger } from "../logger";
+export default class TestAopUtil {
+    static logger: Logger;
+    static testPersonService(): void;
+}

package/dist/common/Constant.d.ts

@@ -0,0 +1,8 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2020-04-30 23:07
+ **/
+export default class Constant {
+    static readonly OWER_MENU: string;
+}

package/dist/common/adapter/StorageApi.d.ts

@@ -0,0 +1,48 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2023-12-29 21:16
+ **/
+export interface StorageApi {
+    /**
+     * 获取localStorage中的所有KEY
+     */
+    getLocalStorageKeys(): Array<string>;
+    /**
+     * 获取sessionStorage中的所有KEY
+     */
+    getSessionStorageKeys(): Array<string>;
+    /**
+     * 设置session key对应的值
+     * @param key
+     * @param value
+     */
+    setSessionStorage(key: string, value: any): void;
+    /**
+     * 获取session存储
+     * @param key
+     */
+    getSessionStorage(key: string): any;
+    /**
+     * 删除session对应的缓存
+     * @param key
+     */
+    removeSessionStorage(key: string): void;
+    /**
+     * 清理sesssion
+     */
+    clearSessionStorage(): void;
+    /**
+     * session存储
+     * @param key
+     * @param value
+     */
+    setLocalStorage(key: string, value: any): void;
+    /**
+     * session获取
+     * @param key
+     */
+    getLocalStorage(key: string): any;
+    removeLocalStorage(key: string): void;
+    clearLocalStorage(): void;
+}

package/dist/common/auto/AutoSize.d.ts

@@ -0,0 +1,56 @@
+/**
+ *@desc 自动获取浏览器窗口 高宽
+ *@author liudejian
+ *@date 2023-03-31 14:41
+ **/
+export declare class DataSize {
+    /**
+     * 高度
+     * @private
+     */
+    height: number;
+    /**
+     * 宽度
+     * @private
+     */
+    width: number;
+    static of(height: number, width: number): DataSize;
+}
+/**
+ * 动态获取高宽
+ */
+export declare class AutoSize {
+    flag: boolean;
+    /**
+     * 抹去的高度/宽度
+     * @private
+     */
+    private eraseSize;
+    /**
+     * 1= window.innerHeight / window.innerWidth
+     * 2= document.body.clientHeight / document.body.clientWidth
+     * @private
+     */
+    private clientType;
+    /**
+     * 结果高度/宽度
+     * @private
+     */
+    private resultSize;
+    /**
+     * 回调函数
+     * @private
+     */
+    private callback;
+    /**
+     * 结果 高宽
+     */
+    getSize(): DataSize;
+    /**
+     *
+     * @param eraseHeight 抹去的高度
+     * @param callback 高度变化就回调
+     */
+    constructor(callback: Function, eraseSize?: DataSize, clientType?: number);
+    private initWindowResize;
+}

package/dist/common/enums/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2022-09-19 11:14
+ **/
+export declare enum Sex {
+    MALE = 1,
+    FEMALE = 2
+}
+export declare enum CommonYn {
+    YES = 1,
+    NO = 2
+}
+export declare enum Status {
+    ENABLE = 1,
+    DISABLE = 2
+}
+export declare enum LoginType {
+    BASIC = 1,
+    TOKEN = 2,
+    MOBILE = 3,
+    OPENID = 4,
+    PASSWORD = 5,
+    EMAIL = 6
+}

package/dist/common/index.d.ts

@@ -0,0 +1,20 @@
+export { AssertUtil } from "./utils/AssertUtil";
+export { CommonUtil } from "./utils/CommonUtil";
+export { CookieUtil } from "./utils/CookieUtil";
+export { DateUtil } from "./utils/DateUtil";
+export { EnumUtil } from "./utils/EnumUtil";
+export { EventBus } from "./utils/EventBus";
+export { FileUtil } from "./utils/FileUtil";
+export { OssUtil } from "./utils/OssUtil";
+export { ProxyUtil } from "./utils/ProxyUtil";
+export { StorageUtil } from "./utils/StorageUtil";
+export { UrlUtil } from "./utils/UrlUtil";
+export { ZeroUtil } from "./utils/ZeroUtil";
+export { CommonTreeUtil } from "./utils/CommonTreeUtil";
+export { ConfigUtil } from "./utils/ConfigUtil";
+export { RegexUtil, Word } from "./utils/RegexUtil";
+export { AutoSize, DataSize } from "./auto/AutoSize";
+export { BrowserUtil } from "./utils/BrowserUtil";
+export type { ThumbnailMode } from "./utils/OssUtil";
+export type { ImageHw } from "./utils/FileUtil";
+export type { StorageApi } from "./adapter/StorageApi";

package/dist/common/utils/AssertUtil.d.ts

@@ -0,0 +1,17 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2020-06-12 10:11
+ **/
+export declare class AssertUtil {
+    /**
+     * 不能为空判断
+     * @param obj
+     */
+    static notNull(obj: any, message?: string): any;
+    /**
+     * 包装空对象
+     * @param obj
+     */
+    static wrapNull(obj: any): any;
+}

package/dist/common/utils/BrowserUtil.d.ts

@@ -0,0 +1,11 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2025-09-24 9:41
+ **/
+export declare class BrowserUtil {
+    /**
+     * 获取客户端浏览器唯一标识
+     */
+    static getBrowerUniqueId(): Promise<string>;
+}

package/dist/common/utils/CommonTreeUtil.d.ts

@@ -0,0 +1,20 @@
+/**
+ *@desc 通用树
+ *@author liudejian
+ *@date 2020-07-03 16:03
+ **/
+import { CommonTree } from "../../model/CommonTree";
+export declare class CommonTreeUtil {
+    /**
+     * 将分类转为树结构
+     * @param categorys
+     * @param checkedIds
+     * @param maxLevel
+     */
+    static convertToTree(treeBos: Array<CommonTree>, checkedIds: Array<number>, maxLevel: number): Array<CommonTree>;
+    /**
+     * 排序
+     * @param rts
+     */
+    static sortTree(rts: Array<CommonTree>): void;
+}

package/dist/common/utils/CommonUtil.d.ts

@@ -0,0 +1,200 @@
+export declare class CommonUtil {
+    /**
+     * 雪花算法ID (18位)
+     */
+    static genSnowflake(): number | bigint;
+    /**
+     * map 转对象
+     * @param mapData
+     */
+    static mapToObject(mapData: Map<string, any>): any;
+    /**
+     * 随机数生成
+     * @param min 最小值
+     * @param max 最大值
+     */
+    static genRandom(min: number, max: number): number;
+    /**
+     * 产生UID
+     * @param len 长度
+     * @param radix 因子长度
+     * @returns {string}
+     */
+    static genUid(len: number, radix?: number): string;
+    /**
+     * 左右对其
+     * @param str
+     */
+    static trim(str: string): string;
+    /**
+     * 判断obj对象是否为空
+     * @method isEmptyObject
+     * @param { * } obj 需要判断的对象
+     * @remind 如果判断的对象是NULL， 将直接返回true， 如果是数组且为空， 返回true， 如果是字符串， 且字符串为空，
+     *          返回true， 如果是普通对象， 且该对象没有任何实例属性， 返回true
+     * @return { Boolean } 对象是否为空
+     * @example
+     * ```javascript
+     *
+     * //output: true
+     * console.log( utils.isEmptyObject( {} ) );
+     *
+     * //output: true
+     * console.log( utils.isEmptyObject( [] ) );
+     *
+     * //output: true
+     * console.log( utils.isEmptyObject( "" ) );
+     *
+     * //output: false
+     * console.log( utils.isEmptyObject( { key: 1 } ) );
+     *
+     * //output: false
+     * console.log( utils.isEmptyObject( [1] ) );
+     *
+     * //output: false
+     * console.log( utils.isEmptyObject( "1" ) );
+     *
+     * ```
+     */
+    static isEmptyObject(obj: any): boolean;
+    /**
+     * 单词首字母大写
+     * @param str
+     * @returns {string}
+     */
+    static firstWordUpperCase(str: string): string;
+    /**
+     * 获取模板值
+     * @param template 模板 {username}/{age}
+     * @param data {username:'good',age:100}
+     * @return good/100
+     * @example  templateEngine(template,data);
+     */
+    static templateEngine(template: string, json: any): string;
+    static isArray(object: any): boolean;
+    static isNumber(object: any): boolean;
+    static isString(object: any): boolean;
+    static isFunction(object: any): boolean;
+    static isObject(object: any): boolean;
+    static isDate(object: any): boolean;
+    static isRegExp(object: any): boolean;
+    static isMap(object: any): boolean;
+    static isSet(object: any): boolean;
+    /**
+     * 对象copy
+     * @param target 目标对象
+     * @param source 原始对象
+     * @param deep 是否深度copy
+     */
+    static copy(target: any, source: any, deep: boolean): any;
+    /**
+     * 空判断
+     * @param str
+     * @returns {boolean}
+     */
+    static isBlank(str: string): boolean;
+    /**
+     *
+     * @param str
+     * @returns {boolean}
+     */
+    static isNotBlank(str: string): boolean;
+    /**
+     * 开始
+     * @param str
+     * @param prefix 前缀
+     */
+    static startWith(str: string, prefix: string): boolean;
+    /**
+     * 以 stuff结尾
+     * @param str
+     * @param stuff
+     * @returns {boolean}
+     */
+    static endWith(str: string, stuff: string): boolean;
+    /**
+     * 时间格式化
+     * @param time 后台时间长整型/date
+     * @param fmt 时间格式 yyyy-MM-dd hh:mm:ss
+     */
+    static dateFormat(time: Date | number | string, fmt?: string): string;
+    /**
+     * 数据格式化(针对el-table-column的)
+     * @param datas 数据集
+     * @param keyName 指定对比KEY名称
+     * @param returnValueName 返回值 KEY名称
+     * @returns {{}|*}
+     */
+    static dataFormat(datas: Array<any>, returnValueName: string, keyName: string, value: string | number): string;
+    /**
+     * 根据编码获取对应的标签值
+     * @param appCode 应用编号
+     * @param dictCode 枚举字典编码
+     * @param code  对应的枚举值编码
+     * @param codeName
+     * @param codeCnName
+     */
+    static getEnumLabelByCode(appCode: string, dictCode: string, code: number, codeName?: string, codeCnName?: string): string;
+    /**
+     * @param enumAlls 枚举集合[AppCode:[{codeCn: "用户系统", code: 1, ordianl: 0, codeEn: "UC"},{codeCn: "代理系统", code: 2, ordianl: 1, codeEn: "PROXY"}]]
+     * @param enumName 枚举名称 AppCode
+     * @param key 比如: code
+     * @param keyValue 比如:1
+     * @param keyCnName 比如:codeCn
+     */
+    static getEnumValue(enumAlls: Map<string, Array<any>>, enumName: string, key: string, keyValue: string | number, keyCnName: string): string | number;
+    /**
+     *
+     * @param enums
+     * @param code
+     * @param codeName
+     * @param codeCnName
+     */
+    static getEnumLabel(enums: any[], code: number, codeName?: string, codeCnName?: string): string;
+    /**
+     * 枚举格式化(针对el-table-column的)
+     * @param enums 枚举集合
+     * @param row  行
+     * @param column 列
+     * @param cellVal 当前值
+     * @param  index  当前值的行索引
+     * @param manulEnumName 手动传入枚举名称
+     * @param appCode 应用编码
+     * @returns {*}
+     */
+    static enumFormat(enums: Map<string, Array<any>>, row: any, column: any, cellVal?: any, manulEnumName?: string): string | number;
+    /**
+     * 枚举格式化(针对el-table-column的)
+     * @param enums 枚举集合
+     * @param row  行
+     * @param column 列
+     * @param cellVal 当前值
+     * @param  index  当前值的行索引
+     * @param manulEnumName 手动传入枚举名称
+     * @param appCode 应用编码
+     * @returns {*}
+     */
+    static enumDefaultFormat(row: any, column: any, cellVal?: any, manulEnumName?: any, appCode?: any): string | number;
+    /**
+     * 添加前缀
+     * @param value
+     * @param prefix
+     */
+    static addPrefix(value: any, prefix: any): any;
+    /**
+     * 添加后缀
+     * @param value
+     * @param suffix
+     */
+    static addSuffix(value: any, suffix: any): any;
+    /**
+     * 清空一个数组
+     * @param ary
+     */
+    static clearArray(ary: Array<any>): Array<any>;
+    /**
+     * 将时间秒转为HH:MM:SS
+     * @param second 时间秒
+     */
+    static formatSecondToHms(seconds: number): string;
+}

package/dist/common/utils/ConfigUtil.d.ts

@@ -0,0 +1,13 @@
+/**
+ *@desc
+ *@author liudejian
+ *@date 2020-04-05 22:17
+ **/
+export declare class ConfigUtil {
+    static getConfigMap(): Map<string, any>;
+    static getConfigMapToObject(): any;
+    static put(key: string, value: any): Map<string, any>;
+    static remove(key: string): boolean;
+    static get(key: string): any;
+    static has(key: string): boolean;
+}

package/dist/common/utils/CookieUtil.d.ts

@@ -0,0 +1,50 @@
+/**
+ *@desc cookie工具
+ *@author liudejian
+ *@date 2020-03-26 17:28
+ **/
+import { CookieAttributes } from 'js-cookie';
+/**
+ * cookie工具
+ */
+export declare class CookieUtil {
+    /**
+     * 默认cookie配置
+     */
+    static defaultCookieConfig(): CookieAttributes;
+    /**
+     * 设置cookie
+     * @param key
+     * @param value
+     * @param options
+     */
+    static setCookie(key: string, value: string, options: CookieAttributes): string | undefined;
+    /**
+     * 设置cookie
+     * @param key
+     * @param value
+     */
+    static setDefaultCookie(key: string, value: string): string | undefined;
+    /**
+     * 设置对象cookie
+     * @param key
+     * @param value
+     * @param options
+     */
+    static setObjCookie(key: string, value: any, options: CookieAttributes): string | undefined;
+    /**
+     * 获取cookie
+     * @param key
+     */
+    static getObjCookie<T>(key: string): T;
+    /**
+     * 获取cookie
+     * @param key
+     */
+    static getCookie(key: string): string | undefined;
+    /**
+     * 删除cookie
+     * @param key
+     */
+    static removeCookie(key: string): void;
+}

package/dist/common/utils/DateUtil.d.ts

@@ -0,0 +1,50 @@
+/**
+ *@desc 日期工具类
+ *@author liudejian
+ *@date 2020-01-13 17:47
+ **/
+export declare class DateUtil {
+    /**
+     * 时间格式化
+     * @param time 后台时间长整型/date
+     * @param fmt 时间格式 yyyy-MM-dd hh:mm:ss
+     * @returns {*}
+     */
+    static dateFormat(time: Date | number, fmt?: string): string;
+    static formatDate(date: Date, format?: string): string;
+    /**
+     * 10秒：  10 * 1000
+     * 1分：   60 * 1000
+     * 1小时： 60 * 60 * 1000
+     * 24小时：60 * 60 * 24 * 1000
+     * 3天：   60 * 60* 24 * 1000 * 3
+     *
+     * let data = new Date()
+     * formatPast(data)                                           // 刚刚
+     * formatPast(data - 11 * 1000)                               // 11秒前
+     * formatPast(data - 2 * 60 * 1000)                           // 2分钟前
+     * formatPast(data - 60 * 60 * 2 * 1000)                      // 2小时前
+     * formatPast(data - 60 * 60 * 2 * 1000)                      // 2小时前
+     * formatPast(data - 60 * 60 * 71 * 1000)                     // 2天前
+     * formatPast("2020-06-01")                                   // 2020-06-01
+     * formatPast("2020-06-01", "YYYY-mm-dd HH:MM:SS WWW QQQQ")   // 2020-06-01 08:00:00 星期一 第二季度
+     */
+    static formatPast(param: any, format?: string): string;
+    /**
+     * formatAxis(new Date())   // 上午好
+     */
+    static formatAxis(param: any): string;
+    /**
+     * 获取当前月第一天
+     */
+    static getMonthFirstDay(): Date;
+    /**
+     * 获取当前月最后一天
+     */
+    static getMonthLastDay(): Date;
+    /**
+     * 将时间秒转为HH:MM:SS
+     * @param second 时间秒
+     */
+    static formatSecondToHms(second: any): string;
+}