@lowentry/utils 1.21.1 → 1.22.1

package/build/classes/EventEmitter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * A simple event emitter class that allows you to register listeners for events, emit events, and remove listeners.
+ */
+export class EventEmitter {
+    /**
+     * Registers a listener for a specific event.
+     *
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} listener - The function to call when the event is emitted.
+     * @returns {{remove:(()=>void)}}
+     */
+    on(event: string, listener: Function): {
+        remove: (() => void);
+    };
+    /**
+     * Registers a listener for a specific event, this listener will be called only once.
+     *
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} listener - The function to call when the event is emitted.
+     * @returns {{remove:()=>void}}
+     */
+    once(event: string, listener: Function): {
+        remove: () => void;
+    };
+    /**
+     * Removes a listener for a specific event.
+     *
+     * @param {string} event - The name of the event to stop listening for.
+     * @param {Function} listener - The function to remove from the event listeners.
+     */
+    off(event: string, listener: Function): void;
+    /**
+     * Emits an event, calling all registered listeners with the provided arguments.
+     *
+     * @param {string} event - The name of the event to emit.
+     * @param {...*} args - The arguments to pass to the listeners.
+     */
+    emit(event: string, ...args: any[]): void;
+    /**
+     * Clears all listeners for a specific event or all events if no event is specified.
+     *
+     * @param {string} [event] - The name of the event to clear listeners for. If not provided, all events will be cleared.
+     */
+    clear(event?: string): void;
+    #private;
+}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export { LeUtils } from "./LeUtils.js";
+export { EventEmitter } from "./classes/EventEmitter.js";
 export { LinkedList } from "./classes/LinkedList.js";
 export { SerializableMap } from "./classes/SerializableMap.js";
 export { TreeSet } from "./classes/TreeSet.js";

package/index.d.ts

@@ -1,5 +1,52 @@
 export declare function ARRAY(value: any): any[];
 
+/**
+ * A simple event emitter class that allows you to register listeners for events, emit events, and remove listeners.
+ */
+export declare class EventEmitter {
+    /**
+     * Registers a listener for a specific event.
+     *
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} listener - The function to call when the event is emitted.
+     * @returns {{remove:(()=>void)}}
+     */
+    on(event: string, listener: Function): {
+        remove: (() => void);
+    };
+    /**
+     * Registers a listener for a specific event, this listener will be called only once.
+     *
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} listener - The function to call when the event is emitted.
+     * @returns {{remove:()=>void}}
+     */
+    once(event: string, listener: Function): {
+        remove: () => void;
+    };
+    /**
+     * Removes a listener for a specific event.
+     *
+     * @param {string} event - The name of the event to stop listening for.
+     * @param {Function} listener - The function to remove from the event listeners.
+     */
+    off(event: string, listener: Function): void;
+    /**
+     * Emits an event, calling all registered listeners with the provided arguments.
+     *
+     * @param {string} event - The name of the event to emit.
+     * @param {...*} args - The arguments to pass to the listeners.
+     */
+    emit(event: string, ...args: any[]): void;
+    /**
+     * Clears all listeners for a specific event or all events if no event is specified.
+     *
+     * @param {string} [event] - The name of the event to clear listeners for. If not provided, all events will be cleared.
+     */
+    clear(event?: string): void;
+    #private;
+}
+
 export declare function FLOAT(value: any): number;
 
 export declare function FLOAT_ANY(...values: any): number;

package/index.js

@@ -8,8 +8,8 @@ import _wrapAsyncGenerator from '@babel/runtime/helpers/wrapAsyncGenerator';
 import _regeneratorRuntime from '@babel/runtime/regenerator';
 import FastDeepEqual from 'fast-deep-equal';
 import CloneDeep from 'clone-deep';
-import _createClass from '@babel/runtime/helpers/createClass';
 import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
 import _possibleConstructorReturn from '@babel/runtime/helpers/possibleConstructorReturn';
 import _getPrototypeOf from '@babel/runtime/helpers/getPrototypeOf';
 import _inherits from '@babel/runtime/helpers/inherits';
@@ -214,9 +214,9 @@ var FLOAT_LAX_ANY = function FLOAT_LAX_ANY() {
 
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
-function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
-function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _createForOfIteratorHelper$1(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray$1(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray$1(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray$1(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray$1(r, a) : void 0; } }
+function _arrayLikeToArray$1(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 
 /**
  * @param {LeUtils_TransactionalValue} transactionalValue
@@ -704,7 +704,7 @@ var LeUtils = {
     }
     if (typeof (elements === null || elements === void 0 ? void 0 : elements[Symbol.iterator]) === 'function') {
       var i = 0;
-      var _iterator = _createForOfIteratorHelper(elements),
+      var _iterator = _createForOfIteratorHelper$1(elements),
         _step;
       try {
         for (_iterator.s(); !(_step = _iterator.n()).done;) {
@@ -820,7 +820,7 @@ var LeUtils = {
               _context.next = 17;
               break;
             }
-            _iterator2 = _createForOfIteratorHelper(elements);
+            _iterator2 = _createForOfIteratorHelper$1(elements);
             _context.prev = 10;
             _iterator2.s();
           case 11:
@@ -852,7 +852,7 @@ var LeUtils = {
               _context.next = 25;
               break;
             }
-            _iterator3 = _createForOfIteratorHelper(elements);
+            _iterator3 = _createForOfIteratorHelper$1(elements);
             _context.prev = 18;
             _iterator3.s();
           case 19:
@@ -904,7 +904,7 @@ var LeUtils = {
               break;
             }
             _i4 = 0;
-            _iterator4 = _createForOfIteratorHelper(elements);
+            _iterator4 = _createForOfIteratorHelper$1(elements);
             _context.prev = 30;
             _iterator4.s();
           case 31:
@@ -999,7 +999,7 @@ var LeUtils = {
    */
   each: function each(elements, callback) {
     var optionalSkipHasOwnPropertyCheck = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
-    var _iterator5 = _createForOfIteratorHelper(LeUtils.eachIterator(elements, optionalSkipHasOwnPropertyCheck)),
+    var _iterator5 = _createForOfIteratorHelper$1(LeUtils.eachIterator(elements, optionalSkipHasOwnPropertyCheck)),
       _step5;
     try {
       for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
@@ -1149,7 +1149,7 @@ var LeUtils = {
             case 1:
               return _context5.abrupt("return", _context5.sent);
             case 2:
-              _iterator6 = _createForOfIteratorHelper(LeUtils.eachIterator(elements, optionalSkipHasOwnPropertyCheck));
+              _iterator6 = _createForOfIteratorHelper$1(LeUtils.eachIterator(elements, optionalSkipHasOwnPropertyCheck));
               _context5.prev = 3;
               _iterator6.s();
             case 4:
@@ -1333,7 +1333,7 @@ var LeUtils = {
     var optionalSkipHasOwnPropertyCheck = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
     var keys = LeUtils.sortKeys(elements, comparator, optionalSkipHasOwnPropertyCheck);
     var result = [];
-    var _iterator7 = _createForOfIteratorHelper(keys),
+    var _iterator7 = _createForOfIteratorHelper$1(keys),
       _step7;
     try {
       for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
@@ -3425,6 +3425,144 @@ var LeUtils = {
   }()
 };
 
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function _classPrivateFieldInitSpec$2(e, t, a) { _checkPrivateRedeclaration$2(e, t), t.set(e, a); }
+function _checkPrivateRedeclaration$2(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
+function _classPrivateFieldGet$2(s, a) { return s.get(_assertClassBrand$2(s, a)); }
+function _classPrivateFieldSet$2(s, a, r) { return s.set(_assertClassBrand$2(s, a), r), r; }
+function _assertClassBrand$2(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
+var _events = /*#__PURE__*/new WeakMap();
+/**
+ * A simple event emitter class that allows you to register listeners for events, emit events, and remove listeners.
+ */
+var EventEmitter = /*#__PURE__*/function () {
+  /**
+   * Creates a new EventEmitter instance.
+   */
+  function EventEmitter() {
+    _classCallCheck(this, EventEmitter);
+    /** @type {Map<string, Set<Function>>} */
+    _classPrivateFieldInitSpec$2(this, _events, void 0);
+    _classPrivateFieldSet$2(_events, this, new Map());
+  }
+
+  /**
+   * Registers a listener for a specific event.
+   *
+   * @param {string} event - The name of the event to listen for.
+   * @param {Function} listener - The function to call when the event is emitted.
+   * @returns {{remove:(()=>void)}}
+   */
+  return _createClass(EventEmitter, [{
+    key: "on",
+    value: function on(event, listener) {
+      var _classPrivateFieldGet2,
+        _this = this;
+      if (!_classPrivateFieldGet$2(_events, this).has(event)) {
+        _classPrivateFieldGet$2(_events, this).set(event, new Set());
+      }
+      (_classPrivateFieldGet2 = _classPrivateFieldGet$2(_events, this).get(event)) === null || _classPrivateFieldGet2 === void 0 || _classPrivateFieldGet2.add(listener);
+      return {
+        remove: function remove() {
+          return _this.off(event, listener);
+        }
+      };
+    }
+
+    /**
+     * Registers a listener for a specific event, this listener will be called only once.
+     *
+     * @param {string} event - The name of the event to listen for.
+     * @param {Function} listener - The function to call when the event is emitted.
+     * @returns {{remove:()=>void}}
+     */
+  }, {
+    key: "once",
+    value: function once(event, listener) {
+      var _this2 = this;
+      var _wrapper = function wrapper() {
+        _this2.off(event, _wrapper);
+        listener.apply(void 0, arguments);
+      };
+      this.on(event, _wrapper);
+      return {
+        remove: function remove() {
+          return _this2.off(event, _wrapper);
+        }
+      };
+    }
+
+    /**
+     * Removes a listener for a specific event.
+     *
+     * @param {string} event - The name of the event to stop listening for.
+     * @param {Function} listener - The function to remove from the event listeners.
+     */
+  }, {
+    key: "off",
+    value: function off(event, listener) {
+      var listeners = _classPrivateFieldGet$2(_events, this).get(event);
+      if (listeners) {
+        listeners["delete"](listener);
+        if (listeners.size === 0) {
+          _classPrivateFieldGet$2(_events, this)["delete"](event);
+        }
+      }
+    }
+
+    /**
+     * Emits an event, calling all registered listeners with the provided arguments.
+     *
+     * @param {string} event - The name of the event to emit.
+     * @param {...*} args - The arguments to pass to the listeners.
+     */
+  }, {
+    key: "emit",
+    value: function emit(event) {
+      var listeners = _classPrivateFieldGet$2(_events, this).get(event);
+      if (listeners) {
+        var snapshot = _toConsumableArray(listeners);
+        for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+          args[_key - 1] = arguments[_key];
+        }
+        var _iterator = _createForOfIteratorHelper(snapshot),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var listener = _step.value;
+            try {
+              listener.apply(void 0, args);
+            } catch (err) {
+              console.error("Error in listener for \"".concat(event, "\":"), err);
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+    }
+
+    /**
+     * Clears all listeners for a specific event or all events if no event is specified.
+     *
+     * @param {string} [event] - The name of the event to clear listeners for. If not provided, all events will be cleared.
+     */
+  }, {
+    key: "clear",
+    value: function clear(event) {
+      if (event !== undefined) {
+        _classPrivateFieldGet$2(_events, this)["delete"](event);
+      } else {
+        _classPrivateFieldGet$2(_events, this).clear();
+      }
+    }
+  }]);
+}();
+
 function _classPrivateFieldInitSpec$1(e, t, a) { _checkPrivateRedeclaration$1(e, t), t.set(e, a); }
 function _checkPrivateRedeclaration$1(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
 function _classPrivateFieldSet$1(s, a, r) { return s.set(_assertClassBrand$1(s, a), r), r; }
@@ -3837,5 +3975,5 @@ var TreeSet = /*#__PURE__*/function () {
   }]);
 }();
 
-export { ARRAY, FLOAT, FLOAT_ANY, FLOAT_LAX, FLOAT_LAX_ANY, INT, INT_ANY, INT_LAX, INT_LAX_ANY, ISSET, IS_ARRAY, IS_OBJECT, LeUtils, LinkedList, OBJECT, STRING, STRING_ANY, SerializableMap, TreeSet };
+export { ARRAY, EventEmitter, FLOAT, FLOAT_ANY, FLOAT_LAX, FLOAT_LAX_ANY, INT, INT_ANY, INT_LAX, INT_LAX_ANY, ISSET, IS_ARRAY, IS_OBJECT, LeUtils, LinkedList, OBJECT, STRING, STRING_ANY, SerializableMap, TreeSet };
 //# sourceMappingURL=index.js.map