light-h5-core-lib 2.10.0 → 2.10.1

package/LightCore.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.PoolObj = void 0;
+exports.CollisionDetectionUtil = exports.SelfDecrypt = exports.NumberUtil = exports.BooleanUtil = exports.Crc32Util = exports.PromiseUtil = exports.BeizerUtil = exports.UniqueIDUtil = exports.StringUtil = exports.RandomNumUtil = exports.FloatDigitUtil = exports.DateUtil = exports.BitUtil = exports.MD5 = exports.BaseSingleton = exports.SetterGetterBase = exports.ClassNameUtil = exports.PoolObj = void 0;
 var PoolObj_1 = require("./pool/PoolObj");
 Object.defineProperty(exports, "PoolObj", { enumerable: true, get: function () { return PoolObj_1.PoolObj; } });
 var BaseSingleton_1 = require("./common/base/BaseSingleton");
@@ -36,8 +36,14 @@ var SelfDecrypt_1 = require("./common/util/SelfDecrypt");
 Object.defineProperty(exports, "SelfDecrypt", { enumerable: true, get: function () { return SelfDecrypt_1.SelfDecrypt; } });
 var CollisionDetectionUtil_1 = require("./common/util/CollisionDetectionUtil");
 Object.defineProperty(exports, "CollisionDetectionUtil", { enumerable: true, get: function () { return CollisionDetectionUtil_1.CollisionDetectionUtil; } });
+var ClassNameUtil_1 = require("./common/util/ClassNameUtil");
+Object.defineProperty(exports, "ClassNameUtil", { enumerable: true, get: function () { return ClassNameUtil_1.ClassNameUtil; } });
+var SetterGetterBase_1 = require("./common/base/SetterGetterBase");
+Object.defineProperty(exports, "SetterGetterBase", { enumerable: true, get: function () { return SetterGetterBase_1.SetterGetterBase; } });
 module.exports = {
     PoolObj: PoolObj_1.PoolObj,
+    ClassNameUtil: ClassNameUtil_1.ClassNameUtil,
+    SetterGetterBase: SetterGetterBase_1.SetterGetterBase,
     BaseSingleton: BaseSingleton_1.BaseSingleton,
     MD5: MD5_1.MD5,
     BitUtil: BitUtil_1.BitUtil,

package/common/base/BaseSingleton.js

@@ -1,28 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseSingleton = void 0;
+var ClassNameUtil_1 = require("../util/ClassNameUtil");
 /**
- * 泛型单例基类
+ * 单例基类(简单非泛型)
+ * @description
+ * 使用方法【子类中实现】：
+ * ①，写一个static get install(): 子类<br>
+ * ②，重写destroy<br>
+ * ③，ctor相当于构造函数，只在new时执行一次
  * @author Aonaufly
  */
 var BaseSingleton = /** @class */ (function () {
     function BaseSingleton() {
-    }
-    BaseSingleton.getInstance = function (c) {
-        if (this._instance == null) {
-            this._instance = new c();
-            this._instance.ctor();
+        if (BaseSingleton._instance) {
+            var constructorName = ClassNameUtil_1.ClassNameUtil.getClassName(this);
+            throw new Error("".concat(constructorName, " is a singleton class, can't create new instance"));
+        }
+        else {
+            BaseSingleton._instance = this;
+            this.ctor();
         }
-        return this._instance;
-    };
-    /**
-     * 相当于构造函数
-     */
-    BaseSingleton.prototype.ctor = function () {
-    };
-    BaseSingleton.prototype.destroy = function () {
-        BaseSingleton._instance = null;
-    };
+    }
     BaseSingleton._instance = null;
     return BaseSingleton;
 }());

package/common/base/SetterGetterBase.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SetterGetterBase = void 0;
+/*
+ * setter/getter基类
+ * @author Aonaufly
+ */
+var SetterGetterBase = /** @class */ (function () {
+    function SetterGetterBase() {
+        this.installAccessors();
+    }
+    /**
+     * 扫描实例属性并自动创建访问器
+     */
+    SetterGetterBase.prototype.installAccessors = function () {
+        var proto = Object.getPrototypeOf(this);
+        var instanceProps = this.getEnumerableProperties(this);
+        var ignoreFieldArr = this.ignoreFields;
+        for (var _i = 0, instanceProps_1 = instanceProps; _i < instanceProps_1.length; _i++) {
+            var propName = instanceProps_1[_i];
+            // 只处理以下划线开头的私有/受保护字段
+            if (!propName.startsWith('_'))
+                continue;
+            var publicName = propName.slice(1);
+            if (!publicName)
+                continue;
+            if (ignoreFieldArr != null && ignoreFieldArr.length > 0) {
+                if (ignoreFieldArr.includes(publicName)) {
+                    continue;
+                }
+            }
+            // 检查原型上是否已存在对应访问器
+            var descriptor = Object.getOwnPropertyDescriptor(proto, publicName);
+            // 如果完全不存在，则创建 getter/setter
+            if (!descriptor) {
+                this.createAccessor(proto, propName, publicName);
+            }
+            // 如果只缺 getter 或 setter（高级场景）
+            else if (typeof descriptor.value !== 'undefined') {
+                // 如果是数据属性而非访问器，覆盖之
+                this.createAccessor(proto, propName, publicName);
+            }
+        }
+    };
+    /**
+     * 安全获取对象的可枚举属性（排除方法）
+     */
+    SetterGetterBase.prototype.getEnumerableProperties = function (obj) {
+        return Object.getOwnPropertyNames(obj).filter(function (name) {
+            var descriptor = Object.getOwnPropertyDescriptor(obj, name);
+            return descriptor && !descriptor.get && !descriptor.set && typeof descriptor.value !== 'function';
+        });
+    };
+    /**
+     * 在原型上动态创建访问器
+     */
+    SetterGetterBase.prototype.createAccessor = function (proto, privateName, publicName) {
+        Object.defineProperty(proto, publicName, {
+            get: function () {
+                return this[privateName];
+            },
+            set: function (value) {
+                var _a;
+                var oldValue = this[privateName];
+                if (oldValue === value)
+                    return;
+                this[privateName] = value;
+                // 可选：触发变更通知
+                (_a = this.onPropertyChanged) === null || _a === void 0 ? void 0 : _a.call(this, publicName, value, oldValue);
+            },
+            enumerable: true,
+            configurable: true,
+        });
+    };
+    return SetterGetterBase;
+}());
+exports.SetterGetterBase = SetterGetterBase;

package/common/md5/MD5.js

@@ -17,14 +17,30 @@ var __extends = (this && this.__extends) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MD5 = void 0;
 var BaseSingleton_1 = require("../base/BaseSingleton");
+/**
+ * MD5单例
+ * @author Aonaufly
+ */
 var MD5 = /** @class */ (function (_super) {
     __extends(MD5, _super);
     function MD5() {
-        var _this = _super.call(this) || this;
+        var _this = _super !== null && _super.apply(this, arguments) || this;
         _this.hexcase = 0; /* hex output format. 0 - lowercase; 1 - uppercase        */
         _this.b64pad = ""; /* base-64 pad character. "=" for strict RFC compliance   */
         return _this;
     }
+    MD5.prototype.ctor = function () {
+    };
+    Object.defineProperty(MD5, "install", {
+        get: function () {
+            if (!MD5._instance) {
+                MD5._instance = new MD5();
+            }
+            return MD5._instance;
+        },
+        enumerable: false,
+        configurable: true
+    });
     /*
      * These are the privates you'll usually want to call
      * They take string arguments and return either hex or base-64 encoded strings
@@ -341,6 +357,10 @@ var MD5 = /** @class */ (function (_super) {
     MD5.prototype.bit_rol = function (num, cnt) {
         return (num << cnt) | (num >>> (32 - cnt));
     };
+    MD5.prototype.destroy = function () {
+        MD5._instance = null;
+        delete MD5._instance;
+    };
     return MD5;
 }(BaseSingleton_1.BaseSingleton));
 exports.MD5 = MD5;

package/common/util/ClassNameUtil.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClassNameUtil = void 0;
+/**
+ * 获得类的名称
+ * @author Aonaufly
+ */
+var ClassNameUtil = /** @class */ (function () {
+    function ClassNameUtil() {
+    }
+    /**
+     * 获取类的名称
+     */
+    ClassNameUtil.getClassName = function (obj) {
+        var _a;
+        var constructor = (_a = Reflect.getPrototypeOf(obj)) === null || _a === void 0 ? void 0 : _a.constructor;
+        return constructor === null || constructor === void 0 ? void 0 : constructor.name;
+    };
+    return ClassNameUtil;
+}());
+exports.ClassNameUtil = ClassNameUtil;

package/common/util/StringUtil.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.StringUtil = void 0;
 /**
  * 字符串工具
- * @author aonaufly
+ * @author Aonaufly
  */
 var StringUtil = /** @class */ (function () {
     function StringUtil() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "light-h5-core-lib",
-  "version": "2.10.0",
+  "version": "2.10.1",
   "description": "light core lib",
   "main": "./LightCore.js",
   "types": "./type/index.d.ts",

package/type/index.d.ts

@@ -66,19 +66,25 @@ export declare class PoolObj<T> implements IClear {
 	destroy(isCleared?: boolean): void;
 }
 /**
- * 泛型单例基类
+ * 单例基类(简单非泛型)
+ * @description
+ * 使用方法【子类中实现】：
+ * ①，写一个static get install(): 子类<br>
+ * ②，重写destroy<br>
+ * ③，ctor相当于构造函数，只在new时执行一次
  * @author Aonaufly
  */
-export declare abstract class BaseSingleton<T> implements IDestroy {
-	private static _instance;
-	static getInstance<T>(c: {
-		new (): T;
-	}): T;
+export declare abstract class BaseSingleton implements IDestroy {
+	protected static _instance: BaseSingleton;
+	constructor();
+	/**
+	 * 销毁单例类
+	 */
+	abstract destroy(): void;
 	/**
 	 * 相当于构造函数
 	 */
-	protected ctor(): void;
-	destroy(): void;
+	protected abstract ctor(): void;
 }
 /**
  * 位操作工具(从右向左←)
@@ -214,7 +220,7 @@ export declare class RandomNumUtil {
 }
 /**
  * 字符串工具
- * @author aonaufly
+ * @author Aonaufly
  */
 export declare class StringUtil {
 	/**
@@ -290,10 +296,15 @@ export declare class BeizerUtil {
 	}[], precision?: number): number;
 	private static getBezierPoint;
 }
-export declare class MD5 extends BaseSingleton<MD5> {
+/**
+ * MD5单例
+ * @author Aonaufly
+ */
+export declare class MD5 extends BaseSingleton {
 	private hexcase;
 	private b64pad;
-	constructor();
+	protected ctor(): void;
+	static get install(): MD5;
 	hex_md5(s: string): string;
 	b64_md5(s: string): string;
 	any_md5(s: string, e: string): string;
@@ -319,6 +330,7 @@ export declare class MD5 extends BaseSingleton<MD5> {
 	md5_ii(a: any, b: any, c: any, d: any, x: any, s: any, t: any): number;
 	safe_add(x: any, y: any): number;
 	bit_rol(num: any, cnt: any): number;
+	destroy(): void;
 }
 /**
  * 异步处理工具
@@ -457,5 +469,38 @@ export interface IOBBInfo {
 	height: number;
 	angle: number;
 }
+/**
+ * 获得类的名称
+ * @author Aonaufly
+ */
+export declare class ClassNameUtil {
+	/**
+	 * 获取类的名称
+	 */
+	static getClassName(obj: object): string;
+}
+export declare abstract class SetterGetterBase<T extends Record<string, any>> {
+	constructor();
+	/**
+	 * 不需要添加setter / getter的字段（不需要加_前缀）
+	 */
+	protected abstract get ignoreFields(): string[];
+	/**
+	 * 扫描实例属性并自动创建访问器
+	 */
+	private installAccessors;
+	/**
+	 * 安全获取对象的可枚举属性（排除方法）
+	 */
+	private getEnumerableProperties;
+	/**
+	 * 在原型上动态创建访问器
+	 */
+	private createAccessor;
+	/**
+	 * 可选：属性变更钩子，子类可重写
+	 */
+	protected onPropertyChanged?(propertyName: string, newValue: any, oldValue: any): void;
+}
 
 export {};