@apia/util 1.0.4 → 2.0.0

package/dist/dom/url.d.ts

@@ -0,0 +1,18 @@
+interface IParameter {
+    name: string;
+    value: unknown;
+    allowMultiple?: boolean;
+}
+declare class Url {
+    #private;
+    defaultAllowMultiple: boolean;
+    base: string;
+    constructor(baseUrl: string, defaultAllowMultiple?: boolean);
+    addParameter(name: string, value: unknown, allowMultiple?: boolean): void;
+    addParameters(parameters: IParameter[]): void;
+    getParameter(name: string): string | string[];
+    toString(): string;
+}
+
+export { type IParameter, Url };
+//# sourceMappingURL=url.d.ts.map

package/dist/dom/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/dom/url.js

@@ -0,0 +1,52 @@
+import arrayOrArray from '../array/arrayOrArray.js';
+
+var __accessCheck = (obj, member, msg) => {
+  if (!member.has(obj))
+    throw TypeError("Cannot " + msg);
+};
+var __privateGet = (obj, member, getter) => {
+  __accessCheck(obj, member, "read from private field");
+  return getter ? getter.call(obj) : member.get(obj);
+};
+var __privateAdd = (obj, member, value) => {
+  if (member.has(obj))
+    throw TypeError("Cannot add the same private member more than once");
+  member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+};
+var _parameters;
+class Url {
+  constructor(baseUrl, defaultAllowMultiple = true) {
+    this.defaultAllowMultiple = defaultAllowMultiple;
+    __privateAdd(this, _parameters, {});
+    const [base, query] = baseUrl.split("?");
+    this.base = base;
+    query?.split("&").forEach((current) => {
+      const [name, ...value] = current.split("=");
+      this.addParameter(name, value.join("="));
+    });
+  }
+  addParameter(name, value, allowMultiple) {
+    if (allowMultiple === void 0 && !this.defaultAllowMultiple || allowMultiple === false)
+      __privateGet(this, _parameters)[name] = String(value);
+    else
+      __privateGet(this, _parameters)[name] = __privateGet(this, _parameters)[name] ? [...arrayOrArray(__privateGet(this, _parameters)[name]), String(value)] : [String(value)];
+  }
+  addParameters(parameters) {
+    parameters.forEach(
+      (current) => this.addParameter(current.name, current.value, current.allowMultiple)
+    );
+  }
+  getParameter(name) {
+    return __privateGet(this, _parameters)[name];
+  }
+  toString() {
+    const parametersArray = Object.entries(__privateGet(this, _parameters));
+    return `${this.base}${parametersArray.length > 0 ? `?${parametersArray.map(
+      ([name, value]) => Array.isArray(value) ? value.map((current) => `${name}=${current}`).join("&") : `${name}=${String(value)}`
+    ).join("&")}` : ""}`;
+  }
+}
+_parameters = new WeakMap();
+
+export { Url };
+//# sourceMappingURL=url.js.map

package/dist/dom/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sources":["../../src/dom/url.ts"],"sourcesContent":["import { arrayOrArray } from '../array';\n\nexport interface IParameter {\n  name: string;\n  value: unknown;\n  allowMultiple?: boolean;\n}\n\nexport class Url {\n  base: string;\n\n  #parameters: Record<string, string | string[]> = {};\n\n  constructor(baseUrl: string, public defaultAllowMultiple = true) {\n    const [base, query] = baseUrl.split('?');\n    this.base = base;\n    query?.split('&').forEach((current) => {\n      const [name, ...value] = current.split('=');\n      this.addParameter(name, value.join('='));\n    });\n  }\n\n  addParameter(name: string, value: unknown, allowMultiple?: boolean) {\n    if (\n      (allowMultiple === undefined && !this.defaultAllowMultiple) ||\n      allowMultiple === false\n    )\n      this.#parameters[name] = String(value);\n    else\n      this.#parameters[name] = this.#parameters[name]\n        ? [...arrayOrArray(this.#parameters[name]), String(value)]\n        : [String(value)];\n  }\n\n  addParameters(parameters: IParameter[]) {\n    parameters.forEach((current) =>\n      this.addParameter(current.name, current.value, current.allowMultiple),\n    );\n  }\n\n  getParameter(name: string) {\n    return this.#parameters[name];\n  }\n\n  toString() {\n    const parametersArray = Object.entries(this.#parameters);\n\n    return `${this.base}${\n      parametersArray.length > 0\n        ? `?${parametersArray\n            .map(([name, value]) =>\n              Array.isArray(value)\n                ? value.map((current) => `${name}=${current}`).join('&')\n                : `${name}=${String(value)}`,\n            )\n            .join('&')}`\n        : ''\n    }`;\n  }\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,IAAA,WAAA,CAAA;AAQO,MAAM,GAAI,CAAA;AAAA,EAKf,WAAA,CAAY,OAAwB,EAAA,oBAAA,GAAuB,IAAM,EAAA;AAA7B,IAAA,IAAA,CAAA,oBAAA,GAAA,oBAAA,CAAA;AAFpC,IAAA,YAAA,CAAA,IAAA,EAAA,WAAA,EAAiD,EAAC,CAAA,CAAA;AAGhD,IAAA,MAAM,CAAC,IAAM,EAAA,KAAK,CAAI,GAAA,OAAA,CAAQ,MAAM,GAAG,CAAA,CAAA;AACvC,IAAA,IAAA,CAAK,IAAO,GAAA,IAAA,CAAA;AACZ,IAAA,KAAA,EAAO,KAAM,CAAA,GAAG,CAAE,CAAA,OAAA,CAAQ,CAAC,OAAY,KAAA;AACrC,MAAA,MAAM,CAAC,IAAM,EAAA,GAAG,KAAK,CAAI,GAAA,OAAA,CAAQ,MAAM,GAAG,CAAA,CAAA;AAC1C,MAAA,IAAA,CAAK,YAAa,CAAA,IAAA,EAAM,KAAM,CAAA,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AAAA,KACxC,CAAA,CAAA;AAAA,GACH;AAAA,EAEA,YAAA,CAAa,IAAc,EAAA,KAAA,EAAgB,aAAyB,EAAA;AAClE,IAAA,IACG,aAAkB,KAAA,KAAA,CAAA,IAAa,CAAC,IAAA,CAAK,wBACtC,aAAkB,KAAA,KAAA;AAElB,MAAA,YAAA,CAAA,IAAA,EAAK,WAAY,CAAA,CAAA,IAAI,CAAI,GAAA,MAAA,CAAO,KAAK,CAAA,CAAA;AAAA;AAErC,MAAK,YAAA,CAAA,IAAA,EAAA,WAAA,CAAA,CAAY,IAAI,CAAI,GAAA,YAAA,CAAA,IAAA,EAAK,aAAY,IAAI,CAAA,GAC1C,CAAC,GAAG,YAAa,CAAA,YAAA,CAAA,IAAA,EAAK,aAAY,IAAI,CAAC,GAAG,MAAO,CAAA,KAAK,CAAC,CACvD,GAAA,CAAC,MAAO,CAAA,KAAK,CAAC,CAAA,CAAA;AAAA,GACtB;AAAA,EAEA,cAAc,UAA0B,EAAA;AACtC,IAAW,UAAA,CAAA,OAAA;AAAA,MAAQ,CAAC,YAClB,IAAK,CAAA,YAAA,CAAa,QAAQ,IAAM,EAAA,OAAA,CAAQ,KAAO,EAAA,OAAA,CAAQ,aAAa,CAAA;AAAA,KACtE,CAAA;AAAA,GACF;AAAA,EAEA,aAAa,IAAc,EAAA;AACzB,IAAO,OAAA,YAAA,CAAA,IAAA,EAAK,aAAY,IAAI,CAAA,CAAA;AAAA,GAC9B;AAAA,EAEA,QAAW,GAAA;AACT,IAAA,MAAM,eAAkB,GAAA,MAAA,CAAO,OAAQ,CAAA,YAAA,CAAA,IAAA,EAAK,WAAW,CAAA,CAAA,CAAA;AAEvD,IAAO,OAAA,CAAA,EAAG,KAAK,IAAI,CAAA,EACjB,gBAAgB,MAAS,GAAA,CAAA,GACrB,IAAI,eACD,CAAA,GAAA;AAAA,MAAI,CAAC,CAAC,IAAA,EAAM,KAAK,CAAA,KAChB,KAAM,CAAA,OAAA,CAAQ,KAAK,CAAA,GACf,KAAM,CAAA,GAAA,CAAI,CAAC,OAAA,KAAY,CAAG,EAAA,IAAI,CAAI,CAAA,EAAA,OAAO,CAAE,CAAA,CAAA,CAAE,IAAK,CAAA,GAAG,CACrD,GAAA,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,MAAO,CAAA,KAAK,CAAC,CAAA,CAAA;AAAA,KAE7B,CAAA,IAAA,CAAK,GAAG,CAAC,KACZ,EACN,CAAA,CAAA,CAAA;AAAA,GACF;AACF,CAAA;AAhDE,WAAA,GAAA,IAAA,OAAA,EAAA;;;;"}

package/dist/dom/usePanAndZoom.d.ts

@@ -0,0 +1,14 @@
+import React__default from 'react';
+
+declare function usePanAndZoom<ContainerType extends HTMLElement = HTMLElement, ChildType extends HTMLElement | SVGElement = HTMLElement>(effectiveMargin?: {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}, blockZoom?: boolean): {
+    boxRef: React__default.RefObject<ContainerType>;
+    elementRef: React__default.RefObject<ChildType>;
+};
+
+export { usePanAndZoom };
+//# sourceMappingURL=usePanAndZoom.d.ts.map

package/dist/dom/usePanAndZoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanAndZoom.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/dom/usePanAndZoom.js

@@ -0,0 +1,111 @@
+import React__default, { useRef } from 'react';
+
+function usePanAndZoom(effectiveMargin = { left: 0, bottom: 0, right: 0, top: 0 }, blockZoom = true) {
+  const boxRef = useRef(null);
+  const elementRef = useRef(null);
+  const [isPanning, setIsPanning] = React__default.useState(false);
+  const [panningPosition, setPanningPosition] = React__default.useState({ x: 0, y: 0 });
+  React__default.useEffect(() => {
+    if (blockZoom)
+      return;
+    const container = boxRef.current;
+    const innerElement = elementRef.current;
+    const handlePanStart = (ev) => {
+      ev.preventDefault();
+      setIsPanning(true);
+      setPanningPosition({ x: ev.clientX, y: ev.clientY });
+    };
+    const handlePanEnd = (ev) => {
+      ev.preventDefault();
+      setIsPanning(false);
+    };
+    const handlePan = (ev) => {
+      if (!innerElement || !container) {
+        return;
+      }
+      if (isPanning) {
+        ev.preventDefault();
+        ev.stopPropagation();
+        const dx = ev.clientX - panningPosition.x;
+        const dy = ev.clientY - panningPosition.y;
+        container.scrollLeft -= dx;
+        container.scrollTop -= dy;
+        setPanningPosition({ x: ev.clientX, y: ev.clientY });
+      }
+    };
+    if (container) {
+      container.addEventListener("mousedown", handlePanStart);
+      container.addEventListener("mouseup", handlePanEnd);
+      container.addEventListener("mouseleave", handlePanEnd);
+      container.addEventListener("mousemove", handlePan);
+      return () => {
+        container.removeEventListener("mousedown", handlePanStart);
+        container.removeEventListener("mousemove", handlePan);
+        container.removeEventListener("mouseup", handlePanEnd);
+        container.removeEventListener("mouseleave", handlePanEnd);
+      };
+    }
+  }, [isPanning, panningPosition]);
+  React__default.useEffect(() => {
+    if (blockZoom)
+      return;
+    const container = boxRef.current;
+    const innerElement = elementRef.current;
+    let newScale = 1;
+    const handleZoom = (ev) => {
+      ev.preventDefault();
+      const newDelta = ev.deltaY;
+      const scaleIncrement = 0.1;
+      if (newDelta < 0) {
+        if (newScale + scaleIncrement >= 2) {
+          return;
+        }
+        newScale += scaleIncrement;
+      } else {
+        if (newScale - scaleIncrement <= 0.9) {
+          return;
+        }
+        newScale -= scaleIncrement;
+      }
+      if (!innerElement || !container) {
+        return;
+      }
+      const containerRect = container.getBoundingClientRect();
+      const cursorX = ev.clientX - containerRect.left - effectiveMargin.left;
+      const cursorY = ev.clientY - containerRect.top - effectiveMargin.top;
+      const cursorXFromCenter = cursorX - containerRect.width / 2;
+      const cursorYFromCenter = cursorY - containerRect.height / 2;
+      if (newScale <= 1) {
+        if (boxRef.current) {
+          boxRef.current.style.overflow = "hidden";
+        }
+      } else {
+        if (boxRef.current) {
+          boxRef.current.style.overflow = "hidden";
+        }
+      }
+      innerElement.style.transform = `scale(${newScale})`;
+      innerElement.style.transformOrigin = "0px 0px";
+      if (newDelta < 0) {
+        container.scrollLeft += cursorXFromCenter / (newScale * 2);
+        container.scrollTop += cursorYFromCenter / (newScale * 2);
+      } else {
+        container.scrollLeft -= cursorXFromCenter / (newScale * 2);
+        container.scrollTop -= cursorYFromCenter / (newScale * 2);
+      }
+    };
+    if (container) {
+      container.addEventListener("wheel", handleZoom);
+      return () => {
+        container.removeEventListener("wheel", handleZoom);
+      };
+    }
+  }, []);
+  return {
+    boxRef,
+    elementRef
+  };
+}
+
+export { usePanAndZoom };
+//# sourceMappingURL=usePanAndZoom.js.map

package/dist/dom/usePanAndZoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePanAndZoom.js","sources":["../../src/dom/usePanAndZoom.ts"],"sourcesContent":["import React, { useRef } from 'react';\n\nexport function usePanAndZoom<\n  ContainerType extends HTMLElement = HTMLElement,\n  ChildType extends HTMLElement | SVGElement = HTMLElement,\n>(\n  effectiveMargin: {\n    left: number;\n    top: number;\n    right: number;\n    bottom: number;\n  } = { left: 0, bottom: 0, right: 0, top: 0 },\n  blockZoom = true,\n) {\n  const boxRef = useRef<ContainerType>(null);\n  const elementRef = useRef<ChildType>(null);\n  const [isPanning, setIsPanning] = React.useState(false);\n  const [panningPosition, setPanningPosition] = React.useState({ x: 0, y: 0 });\n\n  React.useEffect(() => {\n    if (blockZoom) return;\n    const container = boxRef.current;\n    const innerElement = elementRef.current;\n    const handlePanStart = (ev: MouseEvent) => {\n      ev.preventDefault();\n      setIsPanning(true);\n      setPanningPosition({ x: ev.clientX, y: ev.clientY });\n    };\n    const handlePanEnd = (ev: MouseEvent) => {\n      ev.preventDefault();\n\n      setIsPanning(false);\n    };\n\n    const handlePan = (ev: MouseEvent) => {\n      if (!innerElement || !container) {\n        return;\n      }\n\n      if (isPanning) {\n        ev.preventDefault();\n        ev.stopPropagation();\n\n        const dx = ev.clientX - panningPosition.x;\n        const dy = ev.clientY - panningPosition.y;\n\n        container.scrollLeft -= dx;\n        container.scrollTop -= dy;\n\n        setPanningPosition({ x: ev.clientX, y: ev.clientY });\n      }\n    };\n\n    if (container) {\n      container.addEventListener('mousedown', handlePanStart);\n      container.addEventListener('mouseup', handlePanEnd);\n      container.addEventListener('mouseleave', handlePanEnd);\n      container.addEventListener('mousemove', handlePan);\n      return () => {\n        container.removeEventListener('mousedown', handlePanStart);\n        container.removeEventListener('mousemove', handlePan);\n        container.removeEventListener('mouseup', handlePanEnd);\n        container.removeEventListener('mouseleave', handlePanEnd);\n      };\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [isPanning, panningPosition]);\n\n  React.useEffect(() => {\n    if (blockZoom) return;\n\n    const container = boxRef.current;\n    const innerElement = elementRef.current;\n    let newScale = 1;\n    const handleZoom = (ev: WheelEvent) => {\n      ev.preventDefault();\n\n      const newDelta = ev.deltaY;\n      const scaleIncrement = 0.1;\n\n      if (newDelta < 0) {\n        if (newScale + scaleIncrement >= 2) {\n          return;\n        }\n        newScale += scaleIncrement;\n      } else {\n        if (newScale - scaleIncrement <= 0.9) {\n          return;\n        }\n        newScale -= scaleIncrement;\n      }\n      if (!innerElement || !container) {\n        return;\n      }\n      const containerRect = container.getBoundingClientRect();\n      const cursorX = ev.clientX - containerRect.left - effectiveMargin.left;\n      const cursorY = ev.clientY - containerRect.top - effectiveMargin.top;\n\n      const cursorXFromCenter = cursorX - containerRect.width / 2;\n      const cursorYFromCenter = cursorY - containerRect.height / 2;\n\n      if (newScale <= 1) {\n        if (boxRef.current) {\n          boxRef.current.style.overflow = 'hidden';\n        }\n      } else {\n        if (boxRef.current) {\n          boxRef.current.style.overflow = 'hidden';\n        }\n      }\n      innerElement.style.transform = `scale(${newScale})`;\n      innerElement.style.transformOrigin = '0px 0px';\n\n      if (newDelta < 0) {\n        container.scrollLeft += cursorXFromCenter / (newScale * 2);\n        container.scrollTop += cursorYFromCenter / (newScale * 2);\n      } else {\n        container.scrollLeft -= cursorXFromCenter / (newScale * 2);\n        container.scrollTop -= cursorYFromCenter / (newScale * 2);\n      }\n    };\n    if (container) {\n      container.addEventListener('wheel', handleZoom);\n      return () => {\n        container.removeEventListener('wheel', handleZoom);\n      };\n    }\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n  return {\n    boxRef,\n    elementRef,\n  };\n}\n"],"names":["React"],"mappings":"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"}

package/dist/encoding/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Toma una cadena de texto que puede tener caracteres de escape de HTML (por
+ * ejemplo á) y devuelve su correspondiente en texto plano.
+ */
+declare const decodeHTMLEntities: (str: string) => string | null;
+
+export { decodeHTMLEntities };
+//# sourceMappingURL=index.d.ts.map

package/dist/encoding/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/encoding/index.js

@@ -0,0 +1,12 @@
+const decodeHTMLEntities = (str) => {
+  const parser = new DOMParser();
+  const dom = parser.parseFromString(
+    "<!doctype html><body>" + str,
+    "text/html"
+  );
+  const decodedString = dom.body.textContent;
+  return decodedString;
+};
+
+export { decodeHTMLEntities };
+//# sourceMappingURL=index.js.map

package/dist/encoding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/encoding/index.ts"],"sourcesContent":["/**\n * Toma una cadena de texto que puede tener caracteres de escape de HTML (por\n * ejemplo &aacute;) y devuelve su correspondiente en texto plano.\n */\nexport const decodeHTMLEntities = (str: string) => {\n  const parser = new DOMParser();\n  const dom = parser.parseFromString(\n    '<!doctype html><body>' + str,\n    'text/html',\n  );\n  const decodedString = dom.body.textContent;\n  return decodedString;\n};\n"],"names":[],"mappings":"AAIa,MAAA,kBAAA,GAAqB,CAAC,GAAgB,KAAA;AACjD,EAAM,MAAA,MAAA,GAAS,IAAI,SAAU,EAAA,CAAA;AAC7B,EAAA,MAAM,MAAM,MAAO,CAAA,eAAA;AAAA,IACjB,uBAA0B,GAAA,GAAA;AAAA,IAC1B,WAAA;AAAA,GACF,CAAA;AACA,EAAM,MAAA,aAAA,GAAgB,IAAI,IAAK,CAAA,WAAA,CAAA;AAC/B,EAAO,OAAA,aAAA,CAAA;AACT;;;;"}

package/dist/events/BouncingEmitter.d.ts

@@ -0,0 +1,67 @@
+import { SetStateAction } from 'react';
+import { Map } from './types.js';
+import { StatefulEmitter } from './StatefulEmitter.js';
+
+type BouncingMap<Events extends Map> = {
+    [K in keyof Events]: number;
+};
+declare const NullObject: unique symbol;
+type ThrottlingMap<Events extends Map> = {
+    [K in keyof Events]: Events[K] | typeof NullObject;
+};
+type ThrottlingMarkers<Events extends Map> = {
+    [K in keyof Events]: boolean;
+};
+type DebounceOptions = Partial<{
+    timing: number;
+}>;
+type ThrottleOptions = Partial<{
+    emitOnStart?: boolean;
+    timing: number;
+}>;
+/**
+ * @public
+ *
+ * The BouncingEmitter class is an extension of EventEmitter which adds debouncing and throttling functionality.
+ *
+ * @typeParam — Events - An extension of Map where the key is the event name and the value is the type of data associated with that event.
+ */
+declare class BouncingEmitter<Events extends Map> extends StatefulEmitter<Events> {
+    protected bouncingTimeouts: BouncingMap<Events>;
+    protected defaultTiming: number;
+    /**
+     * Debounces a event emit with until there is no call to the emit methods by (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:
+     *
+     * E_E_E_E_E_E_E_E_E
+     *
+     * If timing is configured to 100ms, which is the default, the emission will occur as follows:
+     *
+     * _____________________E
+     */
+    debounce<K extends keyof Events>(event: K, data: Events[K], configuration?: DebounceOptions): void;
+    /**
+     * Throttles a event emit with the warranty that the data will be emitted at most every (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:
+     *
+     * E_E_E_E_E_E_E_E_E
+     *
+     * If timing is configured to 100ms, which is the default, the emission will occur as follows:
+     *
+     * ____E____E____E______E
+     *
+     * @param configuration.emitOnStart - Emits an event on the first call to throttle when no pending throttle is stored. **If emitOnStart is true and an only call to throttle is made, it will emit an only event.**
+     */
+    protected throttleData: ThrottlingMap<Events>;
+    protected throttleEmittedOnInit: ThrottlingMarkers<Events>;
+    throttle<K extends keyof Events>(event: K, data: Events[K], configuration?: ThrottleOptions): void;
+    /**
+     * This method is a mix between setState and debounce
+     */
+    setStateDebounced<K extends keyof Events>(event: K, data: SetStateAction<Events[K]>, configuration?: DebounceOptions): void;
+    /**
+     * This method is a mix between setState and throttle
+     */
+    setStateThrottled<K extends keyof Events>(event: K, data: SetStateAction<Events[K]>, configuration?: ThrottleOptions): void;
+}
+
+export { BouncingEmitter, type DebounceOptions, type ThrottleOptions };
+//# sourceMappingURL=BouncingEmitter.d.ts.map

package/dist/events/BouncingEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BouncingEmitter.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/events/BouncingEmitter.js

@@ -0,0 +1,72 @@
+import { StatefulEmitter, isSetter } from './StatefulEmitter.js';
+
+const NullObject = Symbol("NullObject");
+class BouncingEmitter extends StatefulEmitter {
+  constructor() {
+    super(...arguments);
+    this.bouncingTimeouts = {};
+    this.defaultTiming = 100;
+    /**
+     * Throttles a event emit with the warranty that the data will be emitted at most every (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:
+     *
+     * E_E_E_E_E_E_E_E_E
+     *
+     * If timing is configured to 100ms, which is the default, the emission will occur as follows:
+     *
+     * ____E____E____E______E
+     *
+     * @param configuration.emitOnStart - Emits an event on the first call to throttle when no pending throttle is stored. **If emitOnStart is true and an only call to throttle is made, it will emit an only event.**
+     */
+    this.throttleData = {};
+    this.throttleEmittedOnInit = {};
+  }
+  /**
+   * Debounces a event emit with until there is no call to the emit methods by (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:
+   *
+   * E_E_E_E_E_E_E_E_E
+   *
+   * If timing is configured to 100ms, which is the default, the emission will occur as follows:
+   *
+   * _____________________E
+   */
+  debounce(event, data, configuration) {
+    clearTimeout(this.bouncingTimeouts[event]);
+    this.bouncingTimeouts[event] = setTimeout(() => {
+      this.emit(event, data);
+    }, configuration?.timing ?? this.defaultTiming);
+  }
+  throttle(event, data, configuration) {
+    if (!this.throttleEmittedOnInit[event] && configuration?.emitOnStart) {
+      this.throttleEmittedOnInit[event] = true;
+      setTimeout(() => {
+        this.throttleEmittedOnInit[event] = false;
+      }, configuration?.timing ?? this.defaultTiming);
+      this.emit(event, data);
+    } else if (!configuration?.emitOnStart) {
+      if (this.throttleData[event] === NullObject || !(event in this.throttleData)) {
+        setTimeout(() => {
+          this.emit(event, this.throttleData[event]);
+          this.throttleData[event] = NullObject;
+        }, configuration?.timing ?? this.defaultTiming);
+      }
+      this.throttleData[event] = data;
+    }
+  }
+  /**
+   * This method is a mix between setState and debounce
+   */
+  setStateDebounced(event, data, configuration) {
+    const actualData = isSetter(data) ? data(this.getState(event)) : data;
+    this.debounce(event, actualData, configuration);
+  }
+  /**
+   * This method is a mix between setState and throttle
+   */
+  setStateThrottled(event, data, configuration) {
+    const actualData = isSetter(data) ? data(this.getState(event)) : data;
+    this.throttle(event, actualData, configuration);
+  }
+}
+
+export { BouncingEmitter };
+//# sourceMappingURL=BouncingEmitter.js.map

package/dist/events/BouncingEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BouncingEmitter.js","sources":["../../src/events/BouncingEmitter.ts"],"sourcesContent":["import { SetStateAction } from 'react';\r\nimport { Map } from './EventEmitter';\r\nimport { StatefulEmitter, isSetter } from './StatefulEmitter';\r\n\r\ntype BouncingMap<Events extends Map> = {\r\n  [K in keyof Events]: number;\r\n};\r\n\r\nconst NullObject = Symbol('NullObject');\r\n\r\ntype ThrottlingMap<Events extends Map> = {\r\n  [K in keyof Events]: Events[K] | typeof NullObject;\r\n};\r\n\r\ntype ThrottlingMarkers<Events extends Map> = {\r\n  [K in keyof Events]: boolean;\r\n};\r\n\r\nexport type DebounceOptions = Partial<{ timing: number }>;\r\n\r\nexport type ThrottleOptions = Partial<{\r\n  emitOnStart?: boolean;\r\n  timing: number;\r\n}>;\r\n\r\n/**\r\n * @public\r\n *\r\n * The BouncingEmitter class is an extension of EventEmitter which adds debouncing and throttling functionality.\r\n *\r\n * @typeParam — Events - An extension of Map where the key is the event name and the value is the type of data associated with that event.\r\n */\r\nexport class BouncingEmitter<\r\n  Events extends Map,\r\n> extends StatefulEmitter<Events> {\r\n  protected bouncingTimeouts = {} as BouncingMap<Events>;\r\n\r\n  protected defaultTiming = 100;\r\n\r\n  /**\r\n   * Debounces a event emit with until there is no call to the emit methods by (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:\r\n   *\r\n   * E_E_E_E_E_E_E_E_E\r\n   *\r\n   * If timing is configured to 100ms, which is the default, the emission will occur as follows:\r\n   *\r\n   * _____________________E\r\n   */\r\n  debounce<K extends keyof Events>(\r\n    event: K,\r\n    data: Events[K],\r\n    configuration?: DebounceOptions,\r\n  ) {\r\n    clearTimeout(this.bouncingTimeouts[event]);\r\n    this.bouncingTimeouts[event] = setTimeout(() => {\r\n      this.emit(event, data);\r\n    }, configuration?.timing ?? this.defaultTiming) as unknown as number;\r\n  }\r\n\r\n  /**\r\n   * Throttles a event emit with the warranty that the data will be emitted at most every (timing)ms. Take the following event throttling, where each E is a call to this method and each character represents 20ms:\r\n   *\r\n   * E_E_E_E_E_E_E_E_E\r\n   *\r\n   * If timing is configured to 100ms, which is the default, the emission will occur as follows:\r\n   *\r\n   * ____E____E____E______E\r\n   *\r\n   * @param configuration.emitOnStart - Emits an event on the first call to throttle when no pending throttle is stored. **If emitOnStart is true and an only call to throttle is made, it will emit an only event.**\r\n   */\r\n\r\n  protected throttleData = {} as ThrottlingMap<Events>;\r\n  protected throttleEmittedOnInit = {} as ThrottlingMarkers<Events>;\r\n  throttle<K extends keyof Events>(\r\n    event: K,\r\n    data: Events[K],\r\n    configuration?: ThrottleOptions,\r\n  ) {\r\n    if (!this.throttleEmittedOnInit[event] && configuration?.emitOnStart) {\r\n      this.throttleEmittedOnInit[event] = true;\r\n      setTimeout(() => {\r\n        this.throttleEmittedOnInit[event] = false;\r\n      }, configuration?.timing ?? this.defaultTiming);\r\n      this.emit(event, data);\r\n    } else if (!configuration?.emitOnStart) {\r\n      if (\r\n        this.throttleData[event] === NullObject ||\r\n        !(event in this.throttleData)\r\n      ) {\r\n        setTimeout(() => {\r\n          this.emit(event, this.throttleData[event] as Events[K]);\r\n          this.throttleData[event] = NullObject;\r\n        }, configuration?.timing ?? this.defaultTiming);\r\n      }\r\n      this.throttleData[event] = data;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * This method is a mix between setState and debounce\r\n   */\r\n  setStateDebounced<K extends keyof Events>(\r\n    event: K,\r\n    data: SetStateAction<Events[K]>,\r\n    configuration?: DebounceOptions,\r\n  ): void {\r\n    const actualData = isSetter(data) ? data(this.getState(event)) : data;\r\n\r\n    this.debounce(event, actualData, configuration);\r\n  }\r\n\r\n  /**\r\n   * This method is a mix between setState and throttle\r\n   */\r\n  setStateThrottled<K extends keyof Events>(\r\n    event: K,\r\n    data: SetStateAction<Events[K]>,\r\n    configuration?: ThrottleOptions,\r\n  ): void {\r\n    const actualData = isSetter(data) ? data(this.getState(event)) : data;\r\n\r\n    this.throttle(event, actualData, configuration);\r\n  }\r\n}\r\n"],"names":[],"mappings":"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"}

package/dist/events/EventEmitter.d.ts

@@ -0,0 +1,47 @@
+import { Map, Callbacks, Callback, UnSubscriber } from './types.js';
+
+/**
+ * @public
+ *
+ * The `EventEmitter` class is a generic utility for handling events. It allows subscribing to and emitting events.
+ * This class is generic and works with a `Map` where keys are event names and values are the types associated with those events.
+ *
+ * @typeParam  Events - An extension of `Map` where the key is the event name and the value is the type of data associated with that event.
+ */
+declare class EventEmitter<Events extends Map> {
+    protected callbacks: Record<'on' | 'once', Callbacks<Events>>;
+    protected enabled: boolean;
+    protected debugMode: boolean;
+    debug(enable?: boolean): void;
+    /**
+     * Emits an event with the given data. Any listeners subscribed to this event will be invoked with the passed data.
+     *
+     * @param event - The event name to emit.
+     * @param data - The data associated with the event. Its type is dependent on the event name.
+     */
+    emit<K extends keyof Events>(event: K, data: Events[K]): void;
+    /**
+     * Reflects the current emitter state. A disabled state indicates that the emitter wont call listeners until its functionality gets enabled again.
+     */
+    get isEnabled(): boolean;
+    off<K extends keyof Events>(event: K, cb: Callback<Events, K>): void;
+    /**
+     * Subscribes a callback function to an event. The callback is invoked each time the event is emitted.
+     *
+     * @param event - The event name to listen to.
+     * @param cb - The callback function to be invoked when the event is emitted.
+     * @returns A function to unsubscribe the event listener.
+     */
+    on<K extends keyof Events>(event: K, cb: Callback<Events, K>): UnSubscriber;
+    /**
+     * Subscribes a callback function to an event for a single occurrence. After the event is emitted once, the listener is automatically removed.
+     *
+     * @param event - The event name to listen to for a single occurrence.
+     * @param cb - The callback function to be invoked when the event is emitted.
+     * @returns A function to unsubscribe the event listener.
+     */
+    once<K extends keyof Events>(event: K, cb: Callback<Events, K>): UnSubscriber;
+}
+
+export { Callback, EventEmitter, Map, UnSubscriber };
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/events/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/events/EventEmitter.js

@@ -0,0 +1,75 @@
+class EventEmitter {
+  constructor() {
+    this.callbacks = {
+      on: {},
+      once: {}
+    };
+    this.enabled = true;
+    this.debugMode = false;
+  }
+  debug(enable = true) {
+    this.debugMode = enable;
+  }
+  /**
+   * Emits an event with the given data. Any listeners subscribed to this event will be invoked with the passed data.
+   *
+   * @param event - The event name to emit.
+   * @param data - The data associated with the event. Its type is dependent on the event name.
+   */
+  emit(event, data) {
+    this.callbacks.on[event]?.forEach((current) => current(data));
+    this.callbacks.once[event]?.forEach((current) => current(data));
+    this.callbacks.once[event] = [];
+  }
+  /**
+   * Reflects the current emitter state. A disabled state indicates that the emitter wont call listeners until its functionality gets enabled again.
+   */
+  get isEnabled() {
+    return this.enabled;
+  }
+  off(event, cb) {
+    this.callbacks.on[event] = this.callbacks.on[event]?.filter(
+      (c) => c !== cb
+    );
+    this.callbacks.once[event] = this.callbacks.once[event]?.filter(
+      (c) => c !== cb
+    );
+  }
+  /**
+   * Subscribes a callback function to an event. The callback is invoked each time the event is emitted.
+   *
+   * @param event - The event name to listen to.
+   * @param cb - The callback function to be invoked when the event is emitted.
+   * @returns A function to unsubscribe the event listener.
+   */
+  on(event, cb) {
+    if (!this.callbacks.on[event])
+      this.callbacks.on[event] = [];
+    this.callbacks.on[event].push(cb);
+    return () => {
+      this.callbacks.on[event] = this.callbacks.on[event].filter(
+        (c) => c !== cb
+      );
+    };
+  }
+  /**
+   * Subscribes a callback function to an event for a single occurrence. After the event is emitted once, the listener is automatically removed.
+   *
+   * @param event - The event name to listen to for a single occurrence.
+   * @param cb - The callback function to be invoked when the event is emitted.
+   * @returns A function to unsubscribe the event listener.
+   */
+  once(event, cb) {
+    if (!this.callbacks.once[event])
+      this.callbacks.once[event] = [];
+    this.callbacks.once[event].push(cb);
+    return () => {
+      this.callbacks.once[event] = this.callbacks.once[event].filter(
+        (c) => c !== cb
+      );
+    };
+  }
+}
+
+export { EventEmitter };
+//# sourceMappingURL=EventEmitter.js.map

package/dist/events/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sources":["../../src/events/EventEmitter.ts"],"sourcesContent":["import { Callback, Callbacks, Map, UnSubscriber } from './types';\n\nexport type { Callback, Map, UnSubscriber } from './types';\n\n/**\n * @public\n *\n * The `EventEmitter` class is a generic utility for handling events. It allows subscribing to and emitting events.\n * This class is generic and works with a `Map` where keys are event names and values are the types associated with those events.\n *\n * @typeParam  Events - An extension of `Map` where the key is the event name and the value is the type of data associated with that event.\n */\nexport class EventEmitter<Events extends Map> {\n  protected callbacks: Record<'on' | 'once', Callbacks<Events>> = {\n    on: {} as Callbacks<Events>,\n    once: {} as Callbacks<Events>,\n  };\n  protected enabled = true;\n\n  protected debugMode = false;\n  debug(enable = true) {\n    this.debugMode = enable;\n  }\n\n  /**\n   * Emits an event with the given data. Any listeners subscribed to this event will be invoked with the passed data.\n   *\n   * @param event - The event name to emit.\n   * @param data - The data associated with the event. Its type is dependent on the event name.\n   */\n  emit<K extends keyof Events>(event: K, data: Events[K]) {\n    this.callbacks.on[event]?.forEach((current) => current(data));\n\n    this.callbacks.once[event]?.forEach((current) => current(data));\n    this.callbacks.once[event] = [];\n  }\n\n  /**\n   * Reflects the current emitter state. A disabled state indicates that the emitter wont call listeners until its functionality gets enabled again.\n   */\n  get isEnabled() {\n    return this.enabled;\n  }\n\n  off<K extends keyof Events>(event: K, cb: Callback<Events, K>): void {\n    this.callbacks.on[event] = this.callbacks.on[event]?.filter(\n      (c) => c !== cb,\n    );\n    this.callbacks.once[event] = this.callbacks.once[event]?.filter(\n      (c) => c !== cb,\n    );\n  }\n\n  /**\n   * Subscribes a callback function to an event. The callback is invoked each time the event is emitted.\n   *\n   * @param event - The event name to listen to.\n   * @param cb - The callback function to be invoked when the event is emitted.\n   * @returns A function to unsubscribe the event listener.\n   */\n  on<K extends keyof Events>(event: K, cb: Callback<Events, K>): UnSubscriber {\n    if (!this.callbacks.on[event]) this.callbacks.on[event] = [];\n    this.callbacks.on[event].push(cb);\n\n    return () => {\n      this.callbacks.on[event] = this.callbacks.on[event].filter(\n        (c) => c !== cb,\n      );\n    };\n  }\n\n  /**\n   * Subscribes a callback function to an event for a single occurrence. After the event is emitted once, the listener is automatically removed.\n   *\n   * @param event - The event name to listen to for a single occurrence.\n   * @param cb - The callback function to be invoked when the event is emitted.\n   * @returns A function to unsubscribe the event listener.\n   */\n  once<K extends keyof Events>(\n    event: K,\n    cb: Callback<Events, K>,\n  ): UnSubscriber {\n    if (!this.callbacks.once[event]) this.callbacks.once[event] = [];\n    this.callbacks.once[event].push(cb);\n\n    return () => {\n      this.callbacks.once[event] = this.callbacks.once[event].filter(\n        (c) => c !== cb,\n      );\n    };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/events/StatefulEmitter.d.ts

@@ -0,0 +1,44 @@
+import { SetStateAction } from 'react';
+import { EventEmitter } from './EventEmitter.js';
+import { Map, Callback, UnSubscriber } from './types.js';
+
+type Setter<T> = (prevState: T) => T;
+declare function isSetter<T>(data: SetStateAction<T>): data is Setter<T>;
+/**
+ * @private
+ */
+type EmitterState<Events extends Map> = {
+    [K in keyof Events]: Events[K];
+};
+/**
+ * Extends EventEmitter to manage and emit events with state persistence.
+ * This class allows emitting and listening to typed events while also keeping
+ * a state that can be accessed synchronously for each event.
+ *
+ * @param initialState - If given will be passed to subscriptions
+ *
+ * @template Events - A mapping of event names to their associated data types.
+ * @extends EventEmitter<Events>
+ */
+declare class StatefulEmitter<Events extends Map> extends EventEmitter<Events> {
+    protected state: EmitterState<Events>;
+    constructor(initialState?: Partial<Events>);
+    emit<K extends keyof Events>(event: K, data: Events[K]): void;
+    on<K extends keyof Events>(event: K, cb: Callback<Events, K>): UnSubscriber;
+    once<K extends keyof Events>(event: K, cb: Callback<Events, K>): UnSubscriber;
+    /**
+     * Retrieves the stored state for a given event
+     */
+    getState<K extends keyof Events>(event: K): EmitterState<Events>[K];
+    /**
+     * Just an alias for emit, with the advantage that can be called with a callback as second parameter in which case behaves exactly as react's setState.
+     */
+    setState<K extends keyof Events>(event: K, data: SetStateAction<Events[K]>): void;
+    /**
+     * Allows to consume an event stream as a real time updated state
+     */
+    useState: <K extends keyof Events>(event: K) => EmitterState<Events>[K];
+}
+
+export { StatefulEmitter, isSetter };
+//# sourceMappingURL=StatefulEmitter.d.ts.map

package/dist/events/StatefulEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatefulEmitter.d.ts","sources":[],"sourcesContent":[],"names":[],"mappings":""}