@whitesev/utils 1.0.0

package/dist/src/UtilsCore.d.ts

@@ -0,0 +1,9 @@
+declare const UtilsCore: {
+    init(option?: UtilsCoreOption): void;
+    readonly document: Document;
+    readonly window: Window;
+    readonly globalThis: typeof globalThis;
+    readonly self: typeof globalThis;
+    readonly top: Window;
+};
+export { UtilsCore };

package/dist/src/UtilsGMCookie.d.ts

@@ -0,0 +1,36 @@
+declare interface UtilsGMCookieListResult {
+    /** 为 window.location.hostname */
+    domain: string;
+    expirationDate: null;
+    hostOnly: true;
+    httpOnly: false;
+    name: string;
+    path: "/";
+    sameSite: "unspecified";
+    secure: true;
+    session: false;
+    value: string;
+}
+declare class UtilsGMCookie {
+    /**
+     *  获取Cookie
+     * @param paramDetails
+     * @param callback
+     * + cookies object[]
+     * + error string|undefined
+     **/
+    list(paramDetails?: Partial<UtilsGMCookieListResult>, callback?: (resultData: UtilsGMCookieListResult[], error?: Error) => void): void;
+    /**
+     * 设置Cookie
+     * @param paramDetails
+     * @param callback
+     */
+    set(paramDetails?: {}, callback?: (error?: Error) => void): void;
+    /**
+     * 删除Cookie
+     * @param paramDetails
+     * @param callback
+     */
+    delete(paramDetails?: {}, callback?: (error?: Error) => void): void;
+}
+export { UtilsGMCookie };

package/dist/src/UtilsGMMenu.d.ts

@@ -0,0 +1,119 @@
+/**
+ *
+ * @param {UtilsGMMenuConstructorOptions} details
+ */
+export function GMMenu(details: UtilsGMMenuConstructorOptions): void;
+export class GMMenu {
+    constructor(details: UtilsGMMenuConstructorOptions);
+    /**
+     * 新增菜单数据
+     * @param {UtilsGMMenuOption[]|UtilsGMMenuOption} paramData
+     */
+    add: (paramData: UtilsGMMenuOption[] | UtilsGMMenuOption) => void;
+    /**
+     * 更新菜单数据
+     * @param { ?UtilsGMMenuOption[]|UtilsGMMenuOption } options 数据
+     */
+    update: (options: (UtilsGMMenuOption[] | UtilsGMMenuOption) | null) => void;
+    /**
+     * 卸载菜单
+     * @param {number} menuId 已注册的菜单id
+     */
+    delete: (menuId: number) => void;
+    /**
+     * 根据键值获取enable值
+     * @param {string} menuKey 菜单-键key
+     * @returns {boolean}
+     */
+    get: (menuKey: string) => boolean;
+    /**
+     * 根据键值获取enable值
+     * @param {string} menuKey 菜单-键key
+     * @returns {boolean}
+     */
+    getEnable: (menuKey: string) => boolean;
+    /**
+     * 根据键值获取text值
+     * @param {string} menuKey 菜单-键key
+     * @returns {string}
+     */
+    getText: (menuKey: string) => string;
+    /**
+     * 根据键值获取showText函数的值
+     * @param {string} menuKey 菜单-键key
+     * @returns {string}
+     */
+    getShowTextValue: (menuKey: string) => string;
+    /**
+     * 获取当前已注册菜单的id
+     * @param {string} menuKey
+     * @returns {?number}
+     */
+    getMenuId: (menuKey: string) => number | null;
+    /**
+     * 根据键值获取accessKey值
+     * @param {string} menuKey 菜单-键key
+     * @returns {?string}
+     */
+    getAccessKey: (menuKey: string) => string | null;
+    /**
+     * 根据键值获取autoClose值
+     * @param {string} menuKey 菜单-键key
+     * @returns {?boolean}
+     */
+    getAutoClose: (menuKey: string) => boolean | null;
+    /**
+     * 根据键值获取autoReload值
+     * @param {string} menuKey 菜单-键key
+     * @returns {boolean}
+     */
+    getAutoReload: (menuKey: string) => boolean;
+    /**
+     * 根据键值获取callback函数
+     * @param {string} menuKey 菜单-键key
+     * @returns {?Function}
+     */
+    getCallBack: (menuKey: string) => Function | null;
+    /**
+     * 获取当enable为true时默认显示在菜单中前面的emoji图标
+     * @returns {string}
+     */
+    getEnableTrueEmoji: () => string;
+    /**
+     * 获取当enable为false时默认显示在菜单中前面的emoji图标
+     * @returns {string}
+     */
+    getEnableFalseEmoji: () => string;
+    /**
+     * 获取本地存储的菜单外部的键名
+     * @param {string} keyName
+     */
+    getLocalStorageKeyName: () => string;
+    /**
+     * 设置菜单的值
+     * @param {string} menuKey 菜单-键key
+     * @param {any} value 需要设置的值
+     */
+    setValue: (menuKey: string, value: any) => void;
+    /**
+     * 设置菜单的值
+     * @param {string} menuKey 菜单-键key
+     * @param {boolean} value 需要设置的值
+     */
+    setEnable: (menuKey: string, value: boolean) => void;
+    /**
+     * 设置当enable为true时默认显示在菜单中前面的emoji图标
+     * @param {string} emojiString
+     */
+    setEnableTrueEmoji: (emojiString: string) => void;
+    /**
+     * 设置当enable为false时默认显示在菜单中前面的emoji图标
+     * @param {string} emojiString
+     */
+    setEnableFalseEmoji: (emojiString: string) => void;
+    /**
+     * 设置本地存储的菜单外部的键名
+     * @param {string} keyName
+     */
+    setLocalStorageKeyName: (keyName: string) => void;
+}

package/dist/src/ajaxHooker.d.ts

@@ -0,0 +1,6 @@
+export namespace ajaxHooker {
+    function hook(fn: any): number;
+    function filter(arr: any): void;
+    function protect(): void;
+    function unhook(): void;
+}

package/dist/src/indexedDB.d.ts

@@ -0,0 +1,165 @@
+export function indexedDB(dbName?: string, storeName?: string, dbVersion?: number): void;
+export class indexedDB {
+    constructor(dbName?: string, storeName?: string, dbVersion?: number);
+    dbName: string;
+    slqVersion: string;
+    dbVersion: number;
+    storeName: string;
+    indexedDB: IDBFactory;
+    db: {};
+    store: any;
+    errorCode: {
+        success: {
+            code: number;
+            msg: string;
+        };
+        error: {
+            code: number;
+            msg: string;
+        };
+        open: {
+            code: number;
+            msg: string;
+        };
+        save: {
+            code: number;
+            msg: string;
+        };
+        get: {
+            code: number;
+            msg: string;
+        };
+        delete: {
+            code: number;
+            msg: string;
+        };
+        deleteAll: {
+            code: number;
+            msg: string;
+        };
+    };
+    /**
+     * 创建 “表”
+     * @param {string} dbName 表名
+     * @returns
+     */
+    createStore: (dbName: string) => any;
+    /**
+     * 打开数据库
+     * @param {function} callback  回调
+     * @param {string} dbName 数据库名
+     */
+    open: (callback: Function, dbName: string) => void;
+    /**
+     * 保存数据到数据库
+     * @param {string} key 数据key
+     * @param {any} value 数据值
+     * @returns {Promise< {
+     *    code: number,
+     *    msg: string,
+     *    success: boolean
+     * }>}
+     */
+    save: (key: string, value: any) => Promise<{
+        code: number;
+        msg: string;
+        success: boolean;
+    }>;
+    /**
+     * 根据key获取值
+     * @param {string} key 数据key
+     * @returns {Promise< {
+     *    code: number,
+     *    msg: string,
+     *    data: [...any],
+     *    success: true
+     * }| {
+     *    code: number,
+     *    msg: string,
+     *    error: Error,
+     *    result: any,
+     * } >}
+     */
+    get: (key: string) => Promise<{
+        code: number;
+        msg: string;
+        data: [...any];
+        success: true;
+    } | {
+        code: number;
+        msg: string;
+        error: Error;
+        result: any;
+    }>;
+    /**
+     * 正则获取数据
+     * @param {string} key 数据键
+     * @returns { Promise<{
+     *    code: number,
+     *    msg: string,
+     *    data: [...any],
+     *    success: true
+     * }|{
+     *    code: number,
+     *    msg: string,
+     *    error: Error,
+     *    result: any,
+     * }> }
+     */
+    regexpGet: (key: string) => Promise<{
+        code: number;
+        msg: string;
+        data: [...any];
+        success: true;
+    } | {
+        code: number;
+        msg: string;
+        error: Error;
+        result: any;
+    }>;
+    /**
+     * 删除数据
+     * @param {string} key 数据键
+     * @returns {Promise<{
+     *    code: number,
+     *    msg: string,
+     *    success: true,
+     * }|{
+     *    code: number,
+     *    msg: string,
+     *    error: Error,
+     * }>}
+     */
+    delete: (key: string) => Promise<{
+        code: number;
+        msg: string;
+        success: true;
+    } | {
+        code: number;
+        msg: string;
+        error: Error;
+    }>;
+    /**
+     * 删除所有数据
+     * @returns {Promise<{
+     *    code: number,
+     *    msg: string,
+     *    error: Error,
+     *    result: any,
+     * }|{
+     *    code: number,
+     *    msg: string,
+     *    success: true,
+     * }>}
+     */
+    deleteAll: () => Promise<{
+        code: number;
+        msg: string;
+        error: Error;
+        result: any;
+    } | {
+        code: number;
+        msg: string;
+        success: true;
+    }>;
+}

package/dist/src/tryCatch.d.ts

@@ -0,0 +1,31 @@
+/**
+ *
+ * @param  {...any} args
+ * @returns
+ */
+export function TryCatch(...args: any[]): {
+    (): void;
+    /**
+     * 配置
+     * @param {{
+     * log: boolean
+     * }} paramDetails
+     */
+    config(paramDetails: {
+        log: boolean;
+    }): any;
+    /**
+     * 设置错误处理函数。
+     * @param {function|string} handler 错误处理函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
+     * @returns 返回 tryCatchObj 函数。
+     */
+    error(handler: Function | string): any;
+    /**
+     * 执行传入的函数并捕获其可能抛出的错误，并通过传入的错误处理函数进行处理。
+     * @param {function|string} callback 待执行函数，可以是 function 或者 string 类型。如果是 string 类型，则会被当做代码进行执行。
+     * @param {object|null} [__context__] 待执行函数的作用域，用于apply指定
+     * @returns 如果函数有返回值，则返回该返回值；否则返回 tryCatchObj 函数以支持链式调用。
+     * @throws {Error} 如果传入参数不符合要求，则会抛出相应类型的错误。
+     */
+    run(callback: Function | string, __context__?: object | null | undefined): any;
+};

package/index.ts

@@ -0,0 +1,3 @@
+import { Utils } from "./src/Utils";
+
+export default Utils;

package/package.json

@@ -0,0 +1,34 @@
+{
+	"name": "@whitesev/utils",
+	"version": "1.0.0",
+	"description": "一个常用的工具库",
+	"main": "dist/index.cjs.js",
+	"module": "dist/node/index.esm.js",
+	"types": "dist/index.d.ts",
+	"jsdelivr": "dist/index.umd.js",
+	"exports": {
+		"./package.json": "./package.json",
+		".": {
+			"import": "./dist/index.esm.js",
+			"require": "./dist/index.cjs.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "rollup --config"
+	},
+	"keywords": [
+		"typescript"
+	],
+	"author": "WhiteSev",
+	"license": "MIT",
+	"dependencies": {
+		"@rollup/plugin-commonjs": "^25.0.8",
+		"@rollup/plugin-node-resolve": "^15.2.3",
+		"@rollup/plugin-typescript": "^11.1.6",
+		"tslib": "^2.6.2"
+	},
+	"devDependencies": {
+		"typescript": "^5.4.5"
+	}
+}

package/rollup.config.js

@@ -0,0 +1,28 @@
+// 允许使用 node 或 umd 包
+const commonjs = require("@rollup/plugin-commonjs");
+const { nodeResolve } = require("@rollup/plugin-node-resolve");
+// 编译 TS 代码
+const typescript = require("@rollup/plugin-typescript");
+
+module.exports = {
+	plugins: [nodeResolve(), commonjs(), typescript()],
+	input: "./index.ts", // 源文件入口
+	output: [
+		{
+			file: "dist/index.esm.js", // package.json 中 "module": "dist/index.esm.js"
+			format: "esm", // es module 形式的包， 用来import 导入， 可以tree shaking
+			sourcemap: true,
+		},
+		{
+			file: "dist/index.cjs.js", // package.json 中 "main": "dist/index.cjs.js",
+			format: "cjs", // commonjs 形式的包， require 导入
+			sourcemap: true,
+		},
+		{
+			file: "dist/index.umd.js",
+			name: "Utils", // 模块名
+			format: "umd", // umd 兼容形式的包， 可以直接应用于网页 script
+			sourcemap: true,
+		},
+	],
+};

package/src/ColorConversion.ts

@@ -0,0 +1,124 @@
+class ColorConversion {
+	constructor() {}
+	/**
+	 * 判断是否是16进制颜色
+	 * @param str
+	 */
+	isHex(str: string) {
+		if (typeof str !== "string") {
+			return false;
+		}
+		if (!str.match(/^(\#|)[0-9a-fA-F]{6}$/)) {
+			return false;
+		}
+		return true;
+	}
+	/**
+	 * 16进制颜色转rgba
+	 *
+	 * #ff0000 转 rgba(123,123,123, 0.4)
+	 * @param hex
+	 * @param opacity
+	 */
+	hexToRgba(hex: string, opacity: number) {
+		if (!this.isHex(hex)) {
+			throw new TypeError("输入错误的hex" + hex);
+		}
+		return hex && hex.replace(/\s+/g, "").length === 7
+			? "rgba(" +
+					parseInt("0x" + hex.slice(1, 3)) +
+					"," +
+					parseInt("0x" + hex.slice(3, 5)) +
+					"," +
+					parseInt("0x" + hex.slice(5, 7)) +
+					"," +
+					opacity +
+					")"
+			: "";
+	}
+	/**
+	 * hex转rgb
+	 * @param str
+	 * @returns
+	 */
+	hexToRgb(str: string) {
+		if (!this.isHex(str)) {
+			throw new TypeError("输入错误的hex" + str);
+		}
+		/* replace替换查找的到的字符串 */
+		str = str.replace("#", "");
+		/* match得到查询数组 */
+		let hxs = str.match(/../g);
+		if (hxs == null) {
+			throw new TypeError("输入错误的hex" + str);
+		}
+		for (let index = 0; index < 3; index++)
+			hxs[index] = parseInt(hxs[index], 16).toString();
+		return hxs;
+	}
+	/**
+	 * rgb转hex
+	 * @param redValue
+	 * @param greenValue
+	 * @param blueValue
+	 * @returns
+	 */
+	rgbToHex(
+		redValue: string | number,
+		greenValue: string | number,
+		blueValue: string | number
+	) {
+		/* 验证输入的rgb值是否合法 */
+		let validPattern = /^\d{1,3}$/;
+		if (
+			!validPattern.test(redValue.toString()) ||
+			!validPattern.test(greenValue.toString()) ||
+			!validPattern.test(blueValue.toString())
+		)
+			throw new TypeError("输入错误的rgb颜色值");
+		let hexs = [
+			redValue.toString(16),
+			greenValue.toString(16),
+			blueValue.toString(16),
+		];
+		for (let index = 0; index < 3; index++)
+			if (hexs[index].length == 1) hexs[index] = "0" + hexs[index];
+		return "#" + hexs.join("");
+	}
+	/**
+	 * 获取颜色变暗或亮
+	 * @param color 颜色
+	 * @param level 0~1.0
+	 * @returns
+	 */
+	getDarkColor(color: string, level: number) {
+		if (!this.isHex(color)) {
+			throw new TypeError("输入错误的hex" + color);
+		}
+		let rgbc = this.hexToRgb(color);
+		for (let index = 0; index < 3; index++)
+			// @ts-ignore
+			rgbc[index] = Math.floor(rgbc[index] * (1 - level)).toString();
+		return this.rgbToHex(rgbc[0], rgbc[1], rgbc[2]);
+	}
+	/**
+	 * 获取颜色变亮
+	 * @param color 颜色
+	 * @param level 0~1.0
+	 * @returns
+	 */
+	getLightColor(color: string, level: number) {
+		if (!this.isHex(color)) {
+			throw new TypeError("输入错误的hex" + color);
+		}
+		let rgbc = this.hexToRgb(color);
+		for (let index = 0; index < 3; index++)
+			rgbc[index] = Math.floor(
+				// @ts-ignore
+				(255 - rgbc[index]) * level + rgbc[index]
+			).toString();
+		return this.rgbToHex(rgbc[0], rgbc[1], rgbc[2]);
+	}
+}
+
+export { ColorConversion };