@whitesev/utils 2.7.1 → 2.7.2

package/dist/types/src/ColorConversion.d.ts

@@ -1,4 +1,4 @@
-declare class ColorConversion {
+export declare class ColorConversion {
     /**
      * 判断是否是16进制颜色
      * @param str
@@ -7,7 +7,7 @@ declare class ColorConversion {
     /**
      * 16进制颜色转rgba
      *
-     * #ff0000 转 rgba(123,123,123, 0.4)
+     * 例如：`#ff0000` 转为 `rgba(123,123,123, 0.4)`
      * @param hex
      * @param opacity
      */
@@ -15,30 +15,25 @@ declare class ColorConversion {
     /**
      * hex转rgb
      * @param str
-     * @returns
      */
-    hexToRgb(str: string): RegExpMatchArray | null;
+    hexToRgb(str: string): RegExpMatchArray;
     /**
      * rgb转hex
      * @param redValue
      * @param greenValue
      * @param blueValue
-     * @returns
      */
     rgbToHex(redValue: string | number, greenValue: string | number, blueValue: string | number): string;
     /**
      * 获取颜色变暗或亮
      * @param color 颜色
      * @param level 0~1.0
-     * @returns
      */
     getDarkColor(color: string, level: string): string;
     /**
      * 获取颜色变亮
      * @param color 颜色
      * @param level 0~1.0
-     * @returns
      */
     getLightColor(color: string, level: number): string;
 }
-export { ColorConversion };

package/dist/types/src/Dictionary.d.ts

@@ -1,7 +1,19 @@
-declare class UtilsDictionary<K, V> {
+export declare class UtilsDictionary<K extends string | number | symbol, V extends unknown> {
     private items;
     constructor();
     constructor(key: K, value: V);
+    /**
+     * 获取字典的长度，同this.size
+     */
+    get length(): number;
+    /**
+     * 迭代器
+     */
+    get entries(): () => IterableIterator<[K, V]>;
+    /**
+     * 是否可遍历
+     */
+    get [Symbol.iterator](): () => IterableIterator<[K, V]>;
     /**
      * 检查是否有某一个键
      * @param key 键
@@ -54,24 +66,19 @@ declare class UtilsDictionary<K, V> {
     /**
      * 返回字典本身
      */
-    getItems(): UtilsDictionary<K, V>;
+    getItems(): {
+        [key: string]: V;
+        [key: number]: V;
+        [key: symbol]: V;
+    };
     /**
      * 合并另一个字典
      * @param data 需要合并的字典
      */
     concat(data: UtilsDictionary<K, V>): void;
-    forEach(callbackfn: (value: V, key: K, dictionary: UtilsDictionary<K, V>) => void): void;
-    /**
-     * 获取字典的长度，同this.size
-     */
-    get length(): number;
-    /**
-     * 迭代器
-     */
-    get entries(): () => IterableIterator<[K, V]>;
     /**
-     * 是否可遍历
+     * 迭代字典
+     * @param callbackfn 回调函数
      */
-    get [Symbol.iterator](): () => IterableIterator<[K, V]>;
+    forEach(callbackfn: (value: V, key: K, dictionary: UtilsDictionary<K, V>) => void): void;
 }
-export { UtilsDictionary };

package/dist/types/src/GBKEncoder.d.ts

@@ -1,4 +1,4 @@
-declare class GBKEncoder {
+export declare class GBKEncoder {
     #private;
     constructor();
     private handleText;
@@ -14,4 +14,3 @@ declare class GBKEncoder {
      */
     decode(str: string): string;
 }
-export { GBKEncoder };

package/dist/types/src/Hooks.d.ts

@@ -1,4 +1,4 @@
-declare class Hooks {
+export declare class Hooks {
     /**
      * 在Function原型上添加自定义方法.hook和.unhook
      */
@@ -8,4 +8,3 @@ declare class Hooks {
      */
     cleanEnv(): boolean;
 }
-export { Hooks };

package/dist/types/src/Httpx.d.ts

@@ -1,11 +1,11 @@
 import type { HttpxHookErrorData, HttpxRequestOption, HttpxResponse, HttpxResponseData, HttpxPromise, HttpxInitOption } from "./types/Httpx";
-declare class Httpx {
+export declare class Httpx {
     #private;
     private GM_Api;
     private HttpxRequestHook;
     private HttpxResponseHook;
     private HttpxRequestOption;
-    private HttpxCallBack;
+    private HttpxResponseCallBack;
     private HttpxRequest;
     /**
      * 实例化
@@ -70,11 +70,6 @@ declare class Httpx {
      * @param httpRequest 网络请求函数
      */
     setXMLHttpRequest(httpRequest: Function): void;
-    /**
-     * GET 请求
-     * @param url 网址
-     */
-    get<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
     /**
      * GET 请求
      * @param details 配置
@@ -82,26 +77,31 @@ declare class Httpx {
     get<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * GET 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    get<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    get<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * POST 请求
      * @param details 配置
      */
-    post<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
-    /**
-     * POST 请求
-     * @param url 网址
-     */
-    post<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
+    post<T extends HttpxRequestOption>(details?: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * POST 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    post<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    post<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * HEAD 请求
      * @param details 配置
@@ -109,15 +109,15 @@ declare class Httpx {
     head<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * HEAD 请求
-     * @param url 网址
-     */
-    head<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
-    /**
-     * HEAD 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    head<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    head<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * OPTIONS 请求
      * @param details 配置
@@ -125,15 +125,15 @@ declare class Httpx {
     options<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * OPTIONS 请求
-     * @param url 网址
-     */
-    options<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
-    /**
-     * OPTIONS 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    options<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    options<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * DELETE 请求
      * @param details 配置
@@ -141,15 +141,15 @@ declare class Httpx {
     delete<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * DELETE 请求
-     * @param url 网址
-     */
-    delete<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
-    /**
-     * DELETE 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    delete<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    delete<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * PUT 请求
      * @param details 配置
@@ -157,15 +157,15 @@ declare class Httpx {
     put<T extends HttpxRequestOption>(details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * PUT 请求
-     * @param url 网址
-     */
-    put<T extends HttpxRequestOption>(url: string): HttpxPromise<HttpxResponse<T>>;
-    /**
-     * PUT 请求
-     * @param url 网址
+     * @param url 请求的url
      * @param details 配置
      */
-    put<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    put<T extends Omit<HttpxRequestOption, "url">>(url: string, details?: T): HttpxPromise<HttpxResponse<T & {
+        /**
+         * 请求的url
+         */
+        url: string;
+    }>>;
     /**
      * 发送请求
      * @param details 配置
@@ -173,4 +173,3 @@ declare class Httpx {
      */
     request<T extends HttpxRequestOption>(details: T, beforeRequestOption?: (option: Required<T>) => void): HttpxPromise<HttpxResponse<T>>;
 }
-export { Httpx };

package/dist/types/src/LockFunction.d.ts

@@ -1,4 +1,4 @@
-declare class LockFunction<K extends (...args: any[]) => any | Promise<any> | void> {
+export declare class LockFunction<K extends (...args: any[]) => any | Promise<any> | void> {
     #private;
     lock: () => void;
     unlock: () => void;
@@ -16,4 +16,3 @@ declare class LockFunction<K extends (...args: any[]) => any | Promise<any> | vo
      */
     constructor(callback: K, context?: any, delayTime?: number);
 }
-export { LockFunction };

package/dist/types/src/Log.d.ts

@@ -1,5 +1,5 @@
 import type { UtilsLogOptions } from "./types/Log";
-declare class Log {
+export declare class Log {
     #private;
     /** 前面的TAG标志 */
     tag: string;
@@ -73,4 +73,3 @@ declare class Log {
     /** 恢复输出 */
     recovery(): void;
 }
-export { Log };

package/dist/types/src/Progress.d.ts

@@ -1,5 +1,5 @@
 import type { ProgressParamConfig } from "./types/Progress";
-declare class Progress {
+export declare class Progress {
     #private;
     /**
      *
@@ -15,4 +15,3 @@ declare class Progress {
      */
     draw(): void;
 }
-export { Progress };

package/dist/types/src/UtilsGMMenu.d.ts

@@ -1,5 +1,5 @@
 import type { UtilsGMMenuConstructorOptions, UtilsGMMenuOption } from "./types/UtilsGMMenu";
-declare class GMMenu {
+export declare class GMMenu {
     private GM_Api;
     private MenuHandle;
     constructor(details: UtilsGMMenuConstructorOptions);
@@ -118,4 +118,3 @@ declare class GMMenu {
      */
     setLocalStorageKeyName(keyName: string): void;
 }
-export { GMMenu };

package/dist/types/src/WindowApi.d.ts

@@ -1,5 +1,5 @@
 import type { WindowApiOption } from "./types/WindowApi";
-declare class WindowApi {
+export declare class WindowApi {
     /** 默认的配置 */
     private defaultApi;
     /** 使用的配置 */
@@ -11,4 +11,3 @@ declare class WindowApi {
     get self(): Window & typeof globalThis;
     get top(): Window;
 }
-export { WindowApi };

package/dist/types/src/indexedDB.d.ts

@@ -1,4 +1,4 @@
-declare class indexedDB {
+export declare class indexedDB {
     #private;
     /**
      * @param dbName 数据存储名，默认为：default_db
@@ -129,4 +129,3 @@ declare class indexedDB {
         } & Event;
     }>;
 }
-export { indexedDB };

package/dist/types/src/types/Httpx.d.ts

@@ -1039,24 +1039,23 @@ export declare interface HttpxAllowInterceptConfig {
  */
 export declare interface HttpxRequestOption {
 	/**
-	 * 网址
+	 * 请求的url
 	 */
-	url?: string;
+	url: string;
 	/**
 	 * 请求方法
 	 * @default "GET"
 	 */
 	method?: HttpxMethod;
 	/**
-	 * 超时时间，默认5000，可为空
+	 * 请求的超时时间
 	 *
-	 * 当fetch为true时，该值不生效
+	 * 当`fetch`为`true`时，该值不生效，也就是请求不会超时
 	 * @default 5000
 	 */
 	timeout?: number;
 	/**
 	 * 响应类型，默认document，可为空
-	 *
 	 * @default "document"
 	 */
 	responseType?: keyof HttpxResponseTypeMap;
@@ -1070,39 +1069,39 @@ export declare interface HttpxRequestOption {
 	data?: string | FormData | object;
 	/**
 	 * 是否自动对data进行处理
-	 * @default true
-	 * 处理以下请求类型
-	 * + GET 自动进行URLSearchParams转换
-	 * + HEAD 自动进行URLSearchParams转换
-	 * + POST 处理Content-Type不为空的情况
 	 *
-	 * application/json
+	 * ## 处理以下请求类型
+	 * + `GET` 自动进行`URLSearchParams`转换
+	 * + `HEAD` 自动进行`URLSearchParams`转换
+	 * + `POST` 处理`Content-Type`不为空的情况
+	 *
+	 * ### `application/json`
 	 *
-	 * + string: 不做处理
-	 * + FormData: 转为JSON并进行JSON.stringify处理
-	 * + object: 进行JSON.stringify处理
+	 * + `string`: 不做处理
+	 * + `FormData`: 转为`JSON`并进行`JSON.stringify`处理
+	 * + `object`: 进行`JSON.stringify`处理
 	 *
-	 * application/x-www-form-urlencoded
+	 * ### `application/x-www-form-urlencoded`
 	 *
-	 * + string: 不做处理
-	 * + FormData: 转为URLSearchParams，再转为string
-	 * + object: 转为URLSearchParams，再转为string
+	 * + `string`: 不做处理
+	 * + `FormData`: 转为`URLSearchParams`，再转为`string`
+	 * + `object`: 转为`URLSearchParams`，再转为`string`
 	 *
-	 * multipart/form-data
-	 * （上传文件专用）
-	 * + string: 不做处理
-	 * + FormData: 移除Content-Type
-	 * + object: 不做处理
+	 * ### `multipart/form-data`（上传文件专用）
+	 *
+	 * + `string`: 不做处理
+	 * + `FormData`: 移除`Content-Type`
+	 * + `object`: 不做处理
+	 * @default true
 	 */
 	processData?: boolean;
 	/**
-	 * 当触发重定向的使用规则，默认follow，可为空
-	 *
+	 * 当触发重定向的使用规则
 	 * @default "follow"
 	 */
 	redirect?: HttpxRedirect;
 	/**
-	 * 自定义Cookie，可为空
+	 * 自定义的Cookie
 	 */
 	cookie?: string;
 	/**
@@ -1126,52 +1125,53 @@ export declare interface HttpxRequestOption {
 		topLevelSite?: string;
 	};
 	/**
-	 * 以二进制模式发送数据字符串，可为空
+	 * 以二进制模式发送数据字符串
 	 */
 	binary?: HttpxBinary;
 	/**
-	 * 是否缓存资源，默认true，可为空
+	 * 是否缓存资源
+	 * @default true
 	 */
 	nocache?: boolean;
 	/**
-	 * 是否重新验证可能缓存的内容，默认true，可为空
+	 * 是否重新验证可能缓存的内容
+	 * @default true
 	 */
 	revalidate?: boolean;
 	/**
-	 * 将该对象添加到响应的属性中，可为空
+	 * 自定义对象（自动存在响应里）
 	 */
 	context?: any;
 	/**
-	 * 重写mimeType，可为空
+	 * 重写mimeType，默认不重写
 	 */
 	overrideMimeType?: string;
 	/**
-	 * 是否匿名不发送Cookie，默认为false，可为空
-	 *
+	 * 是否匿名不发送Cookie
 	 * @default false
 	 */
 	anonymous?: boolean;
 	/**
-	 * 是否使用fetch来发送请求，默认为false，可为空
-	 *
+	 * 是否使用fetch来发送请求
 	 * @default false
 	 */
 	fetch?: boolean;
 	/**
-	 * 使用fetch请求的配置
+	 * 当`fetch`为`true`时的配置项，默认使用自定义的配置
 	 */
 	fetchInit?: HttpxRequestInit;
 	/**
 	 * 拒绝拦截配置
+	 *
 	 * 如果设置了相关配置，那么intercept将不会生效
 	 */
 	allowInterceptConfig?: Partial<HttpxAllowInterceptConfig> | boolean;
 	/**
-	 * 身份验证的用户名
+	 * （可选）身份验证的用户名
 	 */
 	user?: string;
 	/**
-	 * 身份验证的密码
+	 * （可选）身份验证的密码
 	 */
 	password?: string;
 	/**
@@ -1197,13 +1197,13 @@ export declare interface HttpxRequestOption {
 	/**
 	 * （可选）当请求状态改变，触发该回调
 	 *
-	 * fetch为true时该回调不触发
+	 * `fetch`为`true`时该回调不会触发
 	 */
 	onreadystatechange?: (...args: any[]) => void;
 	/**
 	 * （可选）当请求上传文件进度改变，触发该回调
 	 *
-	 * fetch为true时该回调不触发
+	 * `fetch`为`true`时该回调不会触发
 	 */
 	onprogress?: (...args: any[]) => void;
 }
@@ -1216,12 +1216,12 @@ export declare interface HttpxRequestOptionConfig extends HttpxInitOption {}
  */
 export declare interface HttpxResponseData<T extends HttpxRequestOption> {
 	/**
-	 * 如果fetch为true，且返回的headers中的Content-Type存在text/event-stream或者是主动设置的responseType为stream
-	 * 则存在该属性为true
+	 * 当请求中配置`fetch`为`true`时，且返回的`headers`中的`Content-Type`存在`text/event-stream`或者是主动设置的`responseType`为`stream`
+	 * 则存在该属性为`true`
 	 */
 	isStream?: boolean;
 	/**
-	 * 如果fetch为true，则存在该属性为true
+	 * 当请求中配置`fetch`为`true`时，则存在该属性为`true`
 	 */
 	isFetch?: boolean;
 	/**
@@ -1230,31 +1230,31 @@ export declare interface HttpxResponseData<T extends HttpxRequestOption> {
 	finalUrl: string;
 	/**
 	 * 数据准备状态
-	 * + 0 未初始化
-	 * + 1 载入
-	 * + 2 载入完成
-	 * + 3 交互
-	 * + 4 完成
+	 * + `0`：未初始化
+	 * + `1`：载入
+	 * + `2`：载入完成
+	 * + `3`：交互
+	 * + `4`：完成
 	 *
-	 * 当请求头fetch为true时，该值固定为4
+	 * 当请求中配置`fetch`为`true`时，该值固定为`4`
 	 */
 	readyState: 0 | 1 | 2 | 3 | 4;
 	/**
-	 * 状态码，2xx为成功
+	 * 响应的状态码，2xx为成功
 	 */
 	status: HttpxStatus | number;
 	/**
-	 * 关于status的解释
+	 * 对`status`的解释
 	 */
 	statusText: "OK" | "" | string;
 	/**
-	 *  响应内容，根据responseType，如果是html，那就是Document类型，如果是json，那么类型是Object类型
+	 *  响应内容，根据`responseType`，如果是`html`，那就是`Document`类型，如果是`json`，那么类型是`Object`类型
 	 */
 	response: T["responseType"] extends keyof HttpxResponseTypeMap
 		? HttpxResponseTypeMap[T["responseType"]]
 		: HttpxResponseTypeMap["html"];
 	/**
-	 * 当请求头fetch为true时，该属性存在
+	 * 当请求中配置`fetch`为`true`时，该属性存在
 	 */
 	responseFetchHeaders?: Headers;
 	/**
@@ -1266,7 +1266,7 @@ export declare interface HttpxResponseData<T extends HttpxRequestOption> {
 	 */
 	responseText: string;
 	/**
-	 * 是请求中设置的responseType，没有设置的话默认为undefined
+	 * 请求中配置的`responseType`，没有的话默认为`undefined`
 	 */
 	responseType?: T["responseType"];
 	/**
@@ -1281,14 +1281,14 @@ export declare interface HttpxResponse<T extends HttpxRequestOption> {
 	/**
 	 * 是否请求成功
 	 *
-	 * 状态码在200-300之间为true，否则为false
+	 * 状态码在`200-300`之间为`true`，否则为`false`
 	 */
 	status: boolean;
 	/**
 	 * 响应状态码
 	 *
-	 * + -1 onabort触发
-	 * + 0 ontimeout触发
+	 * + `-1` 触发来源：`onabort`
+	 * + `0`  触发来源：`ontimeout`
 	 */
 	statusCode: HttpxStatus | number;
 	/**
@@ -1313,13 +1313,21 @@ export declare interface HttpxResponse<T extends HttpxRequestOption> {
  * httpx的hook错误的回调数据
  */
 export declare interface HttpxHookErrorData {
-	/** 触发的函数名 */
+	/**
+	 * 触发的函数名
+	 */
 	type: "onerror" | "ontimeout" | "onabort";
-	/** 触发的错误 */
+	/**
+	 * 触发的错误
+	 */
 	error: Error;
-	/** 触发的响应 */
+	/**
+	 * 触发的响应
+	 */
 	response: any;
-	/** 请求的配置 */
+	/**
+	 * 请求的配置
+	 */
 	details: HttpxRequestOption;
 }
 
@@ -1335,20 +1343,18 @@ export declare interface HttpxPromise<T> extends Promise<T> {
  */
 export declare interface HttpxInitOption extends HttpxRequestOption {
 	/**
-	 * 实例化，可传入GM_xmlhttpRequest，未传入则使用window.fetch
+	 * 实例化，可传入`GM_xmlhttpRequest`，未传入则使用`window.fetch`
 	 */
 	xmlHttpRequest?: Function;
 	/**
 	 * `baseURL` 将自动加在 `url` 前面，除非 `url` 是一个绝对 URL。
 	 */
 	baseURL?: string | undefined;
-	/**
-	 * 重试次数
-	 * @default 0
-	 */
-	retry?: number;
 	/**
 	 * （可选）是否输出请求配置
 	 */
 	logDetails?: boolean;
 }
+
+export declare interface HttpxRequestOptionWithDoubleParams
+	extends Omit<HttpxRequestOption, "url"> {}

package/dist/types/src/types/env.d.ts

@@ -0,0 +1,2 @@
+declare var jQuery: any;
+declare var unsafeWindow: Window;

package/dist/types/src/types/global.d.ts

@@ -18,11 +18,14 @@ export type ArgsType<T extends JSTypeNames[]> = {
 export declare interface UtilsOwnObject<V extends any> {
 	[key: string]: V | UtilsOwnObject<V>;
 }
+
 export declare interface AnyObject {
 	[key: string]: any | AnyObject;
 	toString(): string;
 }
+
 export type PartialKeys<T, K extends keyof T> = {
 	[P in K]?: T[P];
 };
+
 export type Values<T> = T[keyof T];