@whitesev/utils 2.4.5 → 2.4.7

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

@@ -101,7 +101,7 @@ declare class Httpx {
      * @param url 网址
      * @param details 配置
      */
-    post<T extends HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
+    post<T = HttpxRequestOption>(url: string, details: T): HttpxPromise<HttpxResponse<T>>;
     /**
      * HEAD 请求
      * @param details 配置

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

@@ -13,10 +13,10 @@ import type { DOMUtils_EventType } from "./types/Event";
 import type { UtilsAjaxHookResult } from "./types/ajaxHooker";
 import { Vue } from "./Vue";
 import { type ArgsType, type JSTypeNames, type UtilsOwnObject } from "./types/global";
-import type { UtilsWindowApiOption } from "./types/WindowApi";
+import type { WindowApiOption } from "./types/WindowApi";
 declare class Utils {
     private windowApi;
-    constructor(option?: UtilsWindowApiOption);
+    constructor(option?: WindowApiOption);
     /** 版本号 */
     version: string;
     /**
@@ -1720,7 +1720,7 @@ declare class Utils {
      * @param option
      * @returns
      */
-    createUtils(option?: UtilsWindowApiOption): Utils;
+    createUtils(option?: WindowApiOption): Utils;
     /**
      * 将对象转换为FormData
      * @param data 待转换的对象
@@ -1751,6 +1751,15 @@ declare class Utils {
     generateUUID: () => string;
     /**
      * 自定义的动态响应对象
+     * @example
+     * let vue = new Utils.Vue();
+     * let reactive = new vue.reactive({});
+     * vue.watch(()=>reactive["name"], (newValue, oldValue)=>{
+     *     console.log("newValue ==> " + newValue);
+     *     console.log("oldValue ==> " + oldValue);
+     * })
+     * vue["name"] = "测试";
+     * > "测试"
      */
     Vue: typeof Vue;
 }

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

@@ -5,11 +5,24 @@ declare class GMMenu {
     constructor(details: UtilsGMMenuConstructorOptions);
     /**
      * 新增菜单数据
-     * @param paramData
+     * @param menuOption
      */
-    add(paramData: UtilsGMMenuOption[] | UtilsGMMenuOption): void;
+    private __add;
+    /**
+     * 新增菜单数据
+     *
+     * 自动调用.update()
+     * @param menuOption
+     */
+    add(menuOption: UtilsGMMenuOption[] | UtilsGMMenuOption): void;
     /**
      * 更新菜单数据
+     *
+     * 实现方式：先取消注册所有已注册的菜单、再依次注册所有菜单项
+     *
+     * 如果菜单不存在，新增菜单项
+     *
+     * 如果菜单已存在，新菜单项覆盖旧的菜单项
      * @param options 数据
      */
     update(options?: UtilsGMMenuOption[] | UtilsGMMenuOption): void;
@@ -21,6 +34,7 @@ declare class GMMenu {
     /**
      * 根据键值获取enable值
      * @param menuKey 菜单-键key
+     * @deprecated
      */
     get(menuKey: string): boolean;
     /**

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

@@ -1,10 +1,10 @@
-import type { UtilsWindowApiOption } from "./types/WindowApi";
+import type { WindowApiOption } from "./types/WindowApi";
 declare class WindowApi {
     /** 默认的配置 */
     private defaultApi;
     /** 使用的配置 */
     private api;
-    constructor(option?: UtilsWindowApiOption);
+    constructor(option?: WindowApiOption);
     get document(): Document;
     get window(): Window & typeof globalThis;
     get globalThis(): typeof globalThis | Window;

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

@@ -58,7 +58,7 @@ export interface UtilsGMMenuOptionData {
 	 * 对isStoreValue进行处理，如果未赋值，按默认的true赋值
 	 * 新增一个deleteMenu
 	 */
-	handleData: UtilsGMMenuHandledOption;
+	handleData?: UtilsGMMenuHandledOption;
 }
 
 export interface UtilsGMMenuConstructorOptions {

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

@@ -1,10 +1,10 @@
 /**
  * 配置类型
  */
-export type UtilsWindowApiOption = {
+export type WindowApiOption = {
 	document: Document;
 	window: Window & typeof globalThis;
-	globalThis: typeof globalThis | Window;
-	self: Window & typeof globalThis;
+	globalThis?: typeof globalThis | Window;
+	self?: Window & typeof globalThis;
 	top: Window;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whitesev/utils",
-  "version": "2.4.5",
+  "version": "2.4.7",
   "description": "一个常用的工具库",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",

package/src/Utils.ts

@@ -21,15 +21,15 @@ import {
 	type JSTypeNames,
 	type UtilsOwnObject,
 } from "./types/global";
-import type { UtilsWindowApiOption } from "./types/WindowApi";
+import type { WindowApiOption } from "./types/WindowApi";
 
 class Utils {
-	private windowApi: WindowApi;
-	constructor(option?: UtilsWindowApiOption) {
+	private windowApi: typeof WindowApi.prototype;
+	constructor(option?: WindowApiOption) {
 		this.windowApi = new WindowApi(option);
 	}
 	/** 版本号 */
-	version = "2024.11.1";
+	version = "2024.11.6";
 
 	/**
 	 * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
@@ -4978,7 +4978,7 @@ class Utils {
 	 * @param option
 	 * @returns
 	 */
-	createUtils(option?: UtilsWindowApiOption) {
+	createUtils(option?: WindowApiOption) {
 		return new Utils(option);
 	}
 
@@ -5052,6 +5052,15 @@ class Utils {
 	generateUUID = GenerateUUID;
 	/**
 	 * 自定义的动态响应对象
+	 * @example
+	 * let vue = new Utils.Vue();
+	 * let reactive = new vue.reactive({});
+	 * vue.watch(()=>reactive["name"], (newValue, oldValue)=>{
+	 *     console.log("newValue ==> " + newValue);
+	 *     console.log("oldValue ==> " + oldValue);
+	 * })
+	 * vue["name"] = "测试";
+	 * > "测试"
 	 */
 	Vue = Vue;
 }

package/src/UtilsGMMenu.ts

@@ -262,41 +262,58 @@ class GMMenu {
 	}
 	/**
 	 * 新增菜单数据
-	 * @param paramData
+	 * @param menuOption
 	 */
-	add(paramData: UtilsGMMenuOption[] | UtilsGMMenuOption) {
-		if (Array.isArray(paramData)) {
-			for (const _paramData of paramData) {
-				// @ts-ignore
+	private __add(menuOption: UtilsGMMenuOption[] | UtilsGMMenuOption) {
+		if (Array.isArray(menuOption)) {
+			for (let index = 0; index < menuOption.length; index++) {
+				const option = menuOption[index];
 				this.MenuHandle.$data.data.push({
-					data: _paramData,
+					data: option,
 					id: void 0,
 				});
 			}
 		} else {
-			// @ts-ignore
 			this.MenuHandle.$data.data.push({
-				data: paramData,
+				data: menuOption,
 				id: void 0,
 			});
 		}
+	}
+	/**
+	 * 新增菜单数据
+	 *
+	 * 自动调用.update()
+	 * @param menuOption
+	 */
+	add(menuOption: UtilsGMMenuOption[] | UtilsGMMenuOption) {
+		this.__add(menuOption);
 		this.update();
 	}
 	/**
 	 * 更新菜单数据
+	 *
+	 * 实现方式：先取消注册所有已注册的菜单、再依次注册所有菜单项
+	 *
+	 * 如果菜单不存在，新增菜单项
+	 *
+	 * 如果菜单已存在，新菜单项覆盖旧的菜单项
 	 * @param options 数据
 	 */
 	update(options?: UtilsGMMenuOption[] | UtilsGMMenuOption) {
-		let optionsList: UtilsGMMenuOption[] = [];
+		let menuOptionList: UtilsGMMenuOption[] = [];
 		if (Array.isArray(options)) {
-			optionsList = [...optionsList, ...options];
+			menuOptionList = [...menuOptionList, ...options];
 		} else if (options != null) {
-			optionsList = [...optionsList, options];
+			menuOptionList = [...menuOptionList, options];
 		}
-		optionsList.forEach((item) => {
-			let targetMenu = this.MenuHandle.getMenuOption(item.key);
-			if (targetMenu) {
-				Object.assign(targetMenu, item);
+		menuOptionList.forEach((menuOption) => {
+			let oldMenuOption = this.MenuHandle.getMenuOption(menuOption.key);
+			if (oldMenuOption) {
+				// 覆盖
+				Object.assign(oldMenuOption, menuOption);
+			} else {
+				this.__add(menuOption);
 			}
 		});
 		this.MenuHandle.$data.data.forEach((value) => {
@@ -317,6 +334,7 @@ class GMMenu {
 	/**
 	 * 根据键值获取enable值
 	 * @param menuKey 菜单-键key
+	 * @deprecated
 	 */
 	get(menuKey: string): boolean {
 		return this.getEnable(menuKey);
@@ -342,7 +360,7 @@ class GMMenu {
 	getShowTextValue(menuKey: string): string {
 		return this.MenuHandle.getMenuHandledOption(menuKey)!.showText(
 			this.getText(menuKey),
-			this.get(menuKey)
+			this.getEnable(menuKey)
 		);
 	}
 	/**

package/src/WindowApi.ts

@@ -1,8 +1,8 @@
-import type { UtilsWindowApiOption } from "./types/WindowApi";
+import type { WindowApiOption } from "./types/WindowApi";
 
 class WindowApi {
 	/** 默认的配置 */
-	private defaultApi: UtilsWindowApiOption = {
+	private defaultApi: Required<WindowApiOption> = {
 		document: document,
 		window: window,
 		globalThis: globalThis,
@@ -10,11 +10,20 @@ class WindowApi {
 		top: top!,
 	};
 	/** 使用的配置 */
-	private api: UtilsWindowApiOption;
-	constructor(option?: UtilsWindowApiOption) {
+	private api: Required<WindowApiOption>;
+	constructor(option?: WindowApiOption) {
+		if (option) {
+			if (option.globalThis == null) {
+				option.globalThis = option.window;
+			}
+			if (option.self == null) {
+				option.self = option.window;
+			}
+		}
 		if (!option) {
 			option = Object.assign({}, this.defaultApi);
 		}
+		// @ts-ignore
 		this.api = Object.assign({}, option);
 	}
 	get document() {

package/src/types/UtilsGMMenu.d.ts

@@ -58,7 +58,7 @@ export interface UtilsGMMenuOptionData {
 	 * 对isStoreValue进行处理，如果未赋值，按默认的true赋值
 	 * 新增一个deleteMenu
 	 */
-	handleData: UtilsGMMenuHandledOption;
+	handleData?: UtilsGMMenuHandledOption;
 }
 
 export interface UtilsGMMenuConstructorOptions {

package/src/types/WindowApi.d.ts

@@ -1,10 +1,10 @@
 /**
  * 配置类型
  */
-export type UtilsWindowApiOption = {
+export type WindowApiOption = {
 	document: Document;
 	window: Window & typeof globalThis;
-	globalThis: typeof globalThis | Window;
-	self: Window & typeof globalThis;
+	globalThis?: typeof globalThis | Window;
+	self?: Window & typeof globalThis;
 	top: Window;
 };