@whitesev/utils 2.4.5 → 2.4.6

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

@@ -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/types/UtilsGMMenu.d.ts

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

package/package.json

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

package/src/Utils.ts

@@ -29,7 +29,7 @@ class Utils {
 		this.windowApi = new WindowApi(option);
 	}
 	/** 版本号 */
-	version = "2024.11.1";
+	version = "2024.11.5";
 
 	/**
 	 * 在页面中增加style元素，如果html节点存在子节点，添加子节点第一个，反之，添加到html节点的子节点最后一个
@@ -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/types/UtilsGMMenu.d.ts

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