@wexample/js-helpers 0.0.2 → 0.0.6

package/README.md

@@ -1,6 +1,8 @@
-# js_helpers
+# @wexample/js-helpers
 
-Version: 0.0.2
+Version: 0.0.6
+
+Modern, type-safe helper utilities for Wexample projects.
 
 ## Table of Contents
 
@@ -111,7 +113,7 @@ Free to use in both personal and commercial projects.
 
 ## Integration in the Suite
 
-This package is part of the **Wexample Suite** — a collection of high-quality Python packages designed to work seamlessly together.
+This package is part of the Wexample Suite — a collection of high-quality, modular tools designed to work seamlessly together across multiple languages and environments.
 
 ### Related Packages
 
@@ -125,10 +127,6 @@ This package is part of the Wexample suite and is compatible with other suite pa
 
 Refer to each package's documentation for specific version compatibility requirements.
 
-## Dependencies
-
-
-
 # About us
 
 [Wexample](https://wexample.com) stands as a cornerstone of the digital ecosystem — a collective of seasoned engineers, researchers, and creators driven by a relentless pursuit of technological excellence. More than a media platform, it has grown into a vibrant community where innovation meets craftsmanship, and where every line of code reflects a commitment to clarity, durability, and shared intelligence.

package/dist/Common/AsyncConstructor.cjs

@@ -0,0 +1,49 @@
+'use strict';
+
+// src/Helper/Function.ts
+function functionIsType(value) {
+  return typeof value === "function";
+}
+
+// src/Common/AsyncConstructor.ts
+var AsyncConstructor = class {
+  constructor() {
+    this._isReady = false;
+    this._readyArgs = null;
+    this.readyCallbacks = [];
+  }
+  get isReady() {
+    return this._isReady;
+  }
+  defer(fn) {
+    if (typeof queueMicrotask === "function") queueMicrotask(fn);
+    else setTimeout(fn, 0);
+  }
+  ready(cb) {
+    if (this._isReady) {
+      const args = this._readyArgs ?? [];
+      this.defer(() => void cb.apply(this, args));
+      return;
+    }
+    this.readyCallbacks.push(cb);
+  }
+  async readyComplete(...args) {
+    if (this._isReady) return;
+    this._isReady = true;
+    this._readyArgs = args;
+    const callbacks = this.readyCallbacks.splice(0);
+    for (const cb of callbacks) {
+      if (!functionIsType(cb)) {
+        throw new TypeError("Ready callback must be a function.");
+      }
+      await cb.apply(this, args);
+    }
+  }
+  seal() {
+    Object.seal(this);
+  }
+};
+
+module.exports = AsyncConstructor;
+//# sourceMappingURL=AsyncConstructor.cjs.map
+//# sourceMappingURL=AsyncConstructor.cjs.map

package/dist/Common/AsyncConstructor.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Function.ts","../../src/Common/AsyncConstructor.ts"],"names":[],"mappings":";;;AAAO,SAAS,eACd,KAAA,EACgC;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,UAAA;AAC1B;;;ACAA,IAA8B,mBAA9B,MAAoF;AAAA,EAApF,WAAA,GAAA;AACE,IAAA,IAAA,CAAQ,QAAA,GAAW,KAAA;AACnB,IAAA,IAAA,CAAQ,UAAA,GAA2B,IAAA;AACnC,IAAA,IAAA,CAAiB,iBAA4C,EAAC;AAAA,EAAA;AAAA,EAE9D,IAAI,OAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEU,MAAM,EAAA,EAAsB;AACpC,IAAA,IAAI,OAAO,cAAA,KAAmB,UAAA,EAAY,cAAA,CAAe,EAAE,CAAA;AAAA,SACtD,UAAA,CAAW,IAAI,CAAC,CAAA;AAAA,EACvB;AAAA,EAEA,MAAM,EAAA,EAA8B;AAClC,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,IAAe,EAAC;AAClC,MAAA,IAAA,CAAK,MAAM,MAAM,KAAK,GAAG,KAAA,CAAM,IAAA,EAAM,IAAI,CAAC,CAAA;AAC1C,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,cAAA,CAAe,KAAK,EAAE,CAAA;AAAA,EAC7B;AAAA,EAEA,MAAgB,iBAAiB,IAAA,EAA4B;AAC3D,IAAA,IAAI,KAAK,QAAA,EAAU;AAEnB,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAChB,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAElB,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,cAAA,CAAe,MAAA,CAAO,CAAC,CAAA;AAE9C,IAAA,KAAA,MAAW,MAAM,SAAA,EAAW;AAC1B,MAAA,IAAI,CAAC,cAAA,CAAe,EAAE,CAAA,EAAG;AACvB,QAAA,MAAM,IAAI,UAAU,oCAAoC,CAAA;AAAA,MAC1D;AACA,MAAA,MAAM,EAAA,CAAG,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA;AAAA,IAC3B;AAAA,EACF;AAAA,EAEU,IAAA,GAAa;AACrB,IAAA,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,EAClB;AACF","file":"AsyncConstructor.cjs","sourcesContent":["export function functionIsType<TArgs extends unknown[] = unknown[], R = unknown>(\n  value: unknown\n): value is (...args: TArgs) => R {\n  return typeof value === 'function';\n}\n","import { functionIsType } from '../Helper/Function';\n\ntype AnyFn<TThis, TArgs extends unknown[]> = (this: TThis, ...args: TArgs) => void | Promise<void>;\n\nexport default abstract class AsyncConstructor<TArgs extends unknown[] = unknown[]> {\n  private _isReady = false;\n  private _readyArgs: TArgs | null = null;\n  private readonly readyCallbacks: Array<AnyFn<this, TArgs>> = [];\n\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  protected defer(fn: () => void): void {\n    if (typeof queueMicrotask === 'function') queueMicrotask(fn);\n    else setTimeout(fn, 0);\n  }\n\n  ready(cb: AnyFn<this, TArgs>): void {\n    if (this._isReady) {\n      const args = this._readyArgs ?? ([] as unknown as TArgs);\n      this.defer(() => void cb.apply(this, args));\n      return;\n    }\n    this.readyCallbacks.push(cb);\n  }\n\n  protected async readyComplete(...args: TArgs): Promise<void> {\n    if (this._isReady) return;\n\n    this._isReady = true;\n    this._readyArgs = args;\n\n    const callbacks = this.readyCallbacks.splice(0);\n\n    for (const cb of callbacks) {\n      if (!functionIsType(cb)) {\n        throw new TypeError('Ready callback must be a function.');\n      }\n      await cb.apply(this, args);\n    }\n  }\n\n  protected seal(): void {\n    Object.seal(this);\n  }\n}\n"]}

package/dist/Common/AsyncConstructor.d.cts

@@ -0,0 +1,13 @@
+type AnyFn<TThis, TArgs extends unknown[]> = (this: TThis, ...args: TArgs) => void | Promise<void>;
+declare abstract class AsyncConstructor<TArgs extends unknown[] = unknown[]> {
+    private _isReady;
+    private _readyArgs;
+    private readonly readyCallbacks;
+    get isReady(): boolean;
+    protected defer(fn: () => void): void;
+    ready(cb: AnyFn<this, TArgs>): void;
+    protected readyComplete(...args: TArgs): Promise<void>;
+    protected seal(): void;
+}
+
+export { AsyncConstructor as default };

package/dist/Common/AsyncConstructor.d.ts

@@ -0,0 +1,13 @@
+type AnyFn<TThis, TArgs extends unknown[]> = (this: TThis, ...args: TArgs) => void | Promise<void>;
+declare abstract class AsyncConstructor<TArgs extends unknown[] = unknown[]> {
+    private _isReady;
+    private _readyArgs;
+    private readonly readyCallbacks;
+    get isReady(): boolean;
+    protected defer(fn: () => void): void;
+    ready(cb: AnyFn<this, TArgs>): void;
+    protected readyComplete(...args: TArgs): Promise<void>;
+    protected seal(): void;
+}
+
+export { AsyncConstructor as default };

package/dist/Common/AsyncConstructor.js

@@ -0,0 +1,47 @@
+// src/Helper/Function.ts
+function functionIsType(value) {
+  return typeof value === "function";
+}
+
+// src/Common/AsyncConstructor.ts
+var AsyncConstructor = class {
+  constructor() {
+    this._isReady = false;
+    this._readyArgs = null;
+    this.readyCallbacks = [];
+  }
+  get isReady() {
+    return this._isReady;
+  }
+  defer(fn) {
+    if (typeof queueMicrotask === "function") queueMicrotask(fn);
+    else setTimeout(fn, 0);
+  }
+  ready(cb) {
+    if (this._isReady) {
+      const args = this._readyArgs ?? [];
+      this.defer(() => void cb.apply(this, args));
+      return;
+    }
+    this.readyCallbacks.push(cb);
+  }
+  async readyComplete(...args) {
+    if (this._isReady) return;
+    this._isReady = true;
+    this._readyArgs = args;
+    const callbacks = this.readyCallbacks.splice(0);
+    for (const cb of callbacks) {
+      if (!functionIsType(cb)) {
+        throw new TypeError("Ready callback must be a function.");
+      }
+      await cb.apply(this, args);
+    }
+  }
+  seal() {
+    Object.seal(this);
+  }
+};
+
+export { AsyncConstructor as default };
+//# sourceMappingURL=AsyncConstructor.js.map
+//# sourceMappingURL=AsyncConstructor.js.map

package/dist/Common/AsyncConstructor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Function.ts","../../src/Common/AsyncConstructor.ts"],"names":[],"mappings":";AAAO,SAAS,eACd,KAAA,EACgC;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,UAAA;AAC1B;;;ACAA,IAA8B,mBAA9B,MAAoF;AAAA,EAApF,WAAA,GAAA;AACE,IAAA,IAAA,CAAQ,QAAA,GAAW,KAAA;AACnB,IAAA,IAAA,CAAQ,UAAA,GAA2B,IAAA;AACnC,IAAA,IAAA,CAAiB,iBAA4C,EAAC;AAAA,EAAA;AAAA,EAE9D,IAAI,OAAA,GAAmB;AACrB,IAAA,OAAO,IAAA,CAAK,QAAA;AAAA,EACd;AAAA,EAEU,MAAM,EAAA,EAAsB;AACpC,IAAA,IAAI,OAAO,cAAA,KAAmB,UAAA,EAAY,cAAA,CAAe,EAAE,CAAA;AAAA,SACtD,UAAA,CAAW,IAAI,CAAC,CAAA;AAAA,EACvB;AAAA,EAEA,MAAM,EAAA,EAA8B;AAClC,IAAA,IAAI,KAAK,QAAA,EAAU;AACjB,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,UAAA,IAAe,EAAC;AAClC,MAAA,IAAA,CAAK,MAAM,MAAM,KAAK,GAAG,KAAA,CAAM,IAAA,EAAM,IAAI,CAAC,CAAA;AAC1C,MAAA;AAAA,IACF;AACA,IAAA,IAAA,CAAK,cAAA,CAAe,KAAK,EAAE,CAAA;AAAA,EAC7B;AAAA,EAEA,MAAgB,iBAAiB,IAAA,EAA4B;AAC3D,IAAA,IAAI,KAAK,QAAA,EAAU;AAEnB,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAChB,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAElB,IAAA,MAAM,SAAA,GAAY,IAAA,CAAK,cAAA,CAAe,MAAA,CAAO,CAAC,CAAA;AAE9C,IAAA,KAAA,MAAW,MAAM,SAAA,EAAW;AAC1B,MAAA,IAAI,CAAC,cAAA,CAAe,EAAE,CAAA,EAAG;AACvB,QAAA,MAAM,IAAI,UAAU,oCAAoC,CAAA;AAAA,MAC1D;AACA,MAAA,MAAM,EAAA,CAAG,KAAA,CAAM,IAAA,EAAM,IAAI,CAAA;AAAA,IAC3B;AAAA,EACF;AAAA,EAEU,IAAA,GAAa;AACrB,IAAA,MAAA,CAAO,KAAK,IAAI,CAAA;AAAA,EAClB;AACF","file":"AsyncConstructor.js","sourcesContent":["export function functionIsType<TArgs extends unknown[] = unknown[], R = unknown>(\n  value: unknown\n): value is (...args: TArgs) => R {\n  return typeof value === 'function';\n}\n","import { functionIsType } from '../Helper/Function';\n\ntype AnyFn<TThis, TArgs extends unknown[]> = (this: TThis, ...args: TArgs) => void | Promise<void>;\n\nexport default abstract class AsyncConstructor<TArgs extends unknown[] = unknown[]> {\n  private _isReady = false;\n  private _readyArgs: TArgs | null = null;\n  private readonly readyCallbacks: Array<AnyFn<this, TArgs>> = [];\n\n  get isReady(): boolean {\n    return this._isReady;\n  }\n\n  protected defer(fn: () => void): void {\n    if (typeof queueMicrotask === 'function') queueMicrotask(fn);\n    else setTimeout(fn, 0);\n  }\n\n  ready(cb: AnyFn<this, TArgs>): void {\n    if (this._isReady) {\n      const args = this._readyArgs ?? ([] as unknown as TArgs);\n      this.defer(() => void cb.apply(this, args));\n      return;\n    }\n    this.readyCallbacks.push(cb);\n  }\n\n  protected async readyComplete(...args: TArgs): Promise<void> {\n    if (this._isReady) return;\n\n    this._isReady = true;\n    this._readyArgs = args;\n\n    const callbacks = this.readyCallbacks.splice(0);\n\n    for (const cb of callbacks) {\n      if (!functionIsType(cb)) {\n        throw new TypeError('Ready callback must be a function.');\n      }\n      await cb.apply(this, args);\n    }\n  }\n\n  protected seal(): void {\n    Object.seal(this);\n  }\n}\n"]}

package/dist/Helper/Array.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+// src/Helper/Array.ts
+function arrayDeleteItem(haystack, needle) {
+  return arrayDeleteByIndex(haystack, haystack.indexOf(needle));
+}
+function arrayDeleteByIndex(haystack, index) {
+  if (index !== -1) {
+    haystack.splice(index, 1);
+  }
+  return haystack;
+}
+function arrayFromArguments(args) {
+  return Array.prototype.slice.call(args);
+}
+function arrayShallowCopy(array) {
+  return array.slice(0);
+}
+function arrayUnique(array) {
+  return array.filter((value, index) => array.indexOf(value) === index);
+}
+function arrayFindByIndex(array, position) {
+  return array[position >= 0 ? position : array.length + position];
+}
+
+exports.arrayDeleteByIndex = arrayDeleteByIndex;
+exports.arrayDeleteItem = arrayDeleteItem;
+exports.arrayFindByIndex = arrayFindByIndex;
+exports.arrayFromArguments = arrayFromArguments;
+exports.arrayShallowCopy = arrayShallowCopy;
+exports.arrayUnique = arrayUnique;
+//# sourceMappingURL=Array.cjs.map
+//# sourceMappingURL=Array.cjs.map

package/dist/Helper/Array.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Array.ts"],"names":[],"mappings":";;;AAAO,SAAS,eAAA,CAAmB,UAAe,MAAA,EAAgB;AAChE,EAAA,OAAO,kBAAA,CAAmB,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAC,CAAA;AAC9D;AAEO,SAAS,kBAAA,CAAsB,UAAe,KAAA,EAAoB;AACvE,EAAA,IAAI,UAAU,EAAA,EAAI;AAChB,IAAA,QAAA,CAAS,MAAA,CAAO,OAAO,CAAC,CAAA;AAAA,EAC1B;AAEA,EAAA,OAAO,QAAA;AACT;AAKO,SAAS,mBAAsB,IAAA,EAAyB;AAC7D,EAAA,OAAO,KAAA,CAAM,SAAA,CAAU,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA;AACxC;AAEO,SAAS,iBAAoB,KAAA,EAAiB;AACnD,EAAA,OAAO,KAAA,CAAM,MAAM,CAAC,CAAA;AACtB;AAEO,SAAS,YAAe,KAAA,EAAiB;AAC9C,EAAA,OAAO,KAAA,CAAM,OAAO,CAAC,KAAA,EAAO,UAAU,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,KAAM,KAAK,CAAA;AACtE;AAEO,SAAS,gBAAA,CAAoB,OAAY,QAAA,EAAiC;AAC/E,EAAA,OAAO,MAAM,QAAA,IAAY,CAAA,GAAI,QAAA,GAAW,KAAA,CAAM,SAAS,QAAQ,CAAA;AACjE","file":"Array.cjs","sourcesContent":["export function arrayDeleteItem<T>(haystack: T[], needle: T): T[] {\n  return arrayDeleteByIndex(haystack, haystack.indexOf(needle));\n}\n\nexport function arrayDeleteByIndex<T>(haystack: T[], index: number): T[] {\n  if (index !== -1) {\n    haystack.splice(index, 1);\n  }\n\n  return haystack;\n}\n\n/**\n * Functions \"arguments\" object may be transformed to real array for extra manipulations.\n */\nexport function arrayFromArguments<T>(args: ArrayLike<T>): T[] {\n  return Array.prototype.slice.call(args);\n}\n\nexport function arrayShallowCopy<T>(array: T[]): T[] {\n  return array.slice(0);\n}\n\nexport function arrayUnique<T>(array: T[]): T[] {\n  return array.filter((value, index) => array.indexOf(value) === index);\n}\n\nexport function arrayFindByIndex<T>(array: T[], position: number): T | undefined {\n  return array[position >= 0 ? position : array.length + position];\n}\n"]}

package/dist/Helper/Array.d.cts

@@ -0,0 +1,11 @@
+declare function arrayDeleteItem<T>(haystack: T[], needle: T): T[];
+declare function arrayDeleteByIndex<T>(haystack: T[], index: number): T[];
+/**
+ * Functions "arguments" object may be transformed to real array for extra manipulations.
+ */
+declare function arrayFromArguments<T>(args: ArrayLike<T>): T[];
+declare function arrayShallowCopy<T>(array: T[]): T[];
+declare function arrayUnique<T>(array: T[]): T[];
+declare function arrayFindByIndex<T>(array: T[], position: number): T | undefined;
+
+export { arrayDeleteByIndex, arrayDeleteItem, arrayFindByIndex, arrayFromArguments, arrayShallowCopy, arrayUnique };

package/dist/Helper/Array.d.ts

@@ -0,0 +1,11 @@
+declare function arrayDeleteItem<T>(haystack: T[], needle: T): T[];
+declare function arrayDeleteByIndex<T>(haystack: T[], index: number): T[];
+/**
+ * Functions "arguments" object may be transformed to real array for extra manipulations.
+ */
+declare function arrayFromArguments<T>(args: ArrayLike<T>): T[];
+declare function arrayShallowCopy<T>(array: T[]): T[];
+declare function arrayUnique<T>(array: T[]): T[];
+declare function arrayFindByIndex<T>(array: T[], position: number): T | undefined;
+
+export { arrayDeleteByIndex, arrayDeleteItem, arrayFindByIndex, arrayFromArguments, arrayShallowCopy, arrayUnique };

package/dist/Helper/Array.js

@@ -0,0 +1,26 @@
+// src/Helper/Array.ts
+function arrayDeleteItem(haystack, needle) {
+  return arrayDeleteByIndex(haystack, haystack.indexOf(needle));
+}
+function arrayDeleteByIndex(haystack, index) {
+  if (index !== -1) {
+    haystack.splice(index, 1);
+  }
+  return haystack;
+}
+function arrayFromArguments(args) {
+  return Array.prototype.slice.call(args);
+}
+function arrayShallowCopy(array) {
+  return array.slice(0);
+}
+function arrayUnique(array) {
+  return array.filter((value, index) => array.indexOf(value) === index);
+}
+function arrayFindByIndex(array, position) {
+  return array[position >= 0 ? position : array.length + position];
+}
+
+export { arrayDeleteByIndex, arrayDeleteItem, arrayFindByIndex, arrayFromArguments, arrayShallowCopy, arrayUnique };
+//# sourceMappingURL=Array.js.map
+//# sourceMappingURL=Array.js.map

package/dist/Helper/Array.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Array.ts"],"names":[],"mappings":";AAAO,SAAS,eAAA,CAAmB,UAAe,MAAA,EAAgB;AAChE,EAAA,OAAO,kBAAA,CAAmB,QAAA,EAAU,QAAA,CAAS,OAAA,CAAQ,MAAM,CAAC,CAAA;AAC9D;AAEO,SAAS,kBAAA,CAAsB,UAAe,KAAA,EAAoB;AACvE,EAAA,IAAI,UAAU,EAAA,EAAI;AAChB,IAAA,QAAA,CAAS,MAAA,CAAO,OAAO,CAAC,CAAA;AAAA,EAC1B;AAEA,EAAA,OAAO,QAAA;AACT;AAKO,SAAS,mBAAsB,IAAA,EAAyB;AAC7D,EAAA,OAAO,KAAA,CAAM,SAAA,CAAU,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA;AACxC;AAEO,SAAS,iBAAoB,KAAA,EAAiB;AACnD,EAAA,OAAO,KAAA,CAAM,MAAM,CAAC,CAAA;AACtB;AAEO,SAAS,YAAe,KAAA,EAAiB;AAC9C,EAAA,OAAO,KAAA,CAAM,OAAO,CAAC,KAAA,EAAO,UAAU,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,KAAM,KAAK,CAAA;AACtE;AAEO,SAAS,gBAAA,CAAoB,OAAY,QAAA,EAAiC;AAC/E,EAAA,OAAO,MAAM,QAAA,IAAY,CAAA,GAAI,QAAA,GAAW,KAAA,CAAM,SAAS,QAAQ,CAAA;AACjE","file":"Array.js","sourcesContent":["export function arrayDeleteItem<T>(haystack: T[], needle: T): T[] {\n  return arrayDeleteByIndex(haystack, haystack.indexOf(needle));\n}\n\nexport function arrayDeleteByIndex<T>(haystack: T[], index: number): T[] {\n  if (index !== -1) {\n    haystack.splice(index, 1);\n  }\n\n  return haystack;\n}\n\n/**\n * Functions \"arguments\" object may be transformed to real array for extra manipulations.\n */\nexport function arrayFromArguments<T>(args: ArrayLike<T>): T[] {\n  return Array.prototype.slice.call(args);\n}\n\nexport function arrayShallowCopy<T>(array: T[]): T[] {\n  return array.slice(0);\n}\n\nexport function arrayUnique<T>(array: T[]): T[] {\n  return array.filter((value, index) => array.indexOf(value) === index);\n}\n\nexport function arrayFindByIndex<T>(array: T[], position: number): T | undefined {\n  return array[position >= 0 ? position : array.length + position];\n}\n"]}

package/dist/Helper/Bytes.cjs

@@ -0,0 +1,17 @@
+'use strict';
+
+// src/Helper/Bytes.ts
+function bytesFormatBytes(bytes, decimals = 2) {
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;
+}
+
+exports.bytesFormatBytes = bytesFormatBytes;
+//# sourceMappingURL=Bytes.cjs.map
+//# sourceMappingURL=Bytes.cjs.map

package/dist/Helper/Bytes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Bytes.ts"],"names":[],"mappings":";;;AAAO,SAAS,gBAAA,CAAiB,KAAA,EAAe,QAAA,GAAW,CAAA,EAAW;AACpE,EAAA,IAAI,UAAU,CAAA,EAAG;AACf,IAAA,OAAO,SAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAA,GAAI,IAAA;AACV,EAAA,MAAM,EAAA,GAAK,QAAA,GAAW,CAAA,GAAI,CAAA,GAAI,QAAA;AAC9B,EAAA,MAAM,KAAA,GAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAI,CAAA;AAClE,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAElD,EAAA,OAAO,CAAA,EAAG,UAAA,CAAA,CAAY,KAAA,GAAQ,CAAA,IAAK,CAAA,EAAG,OAAA,CAAQ,EAAE,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAChE","file":"Bytes.cjs","sourcesContent":["export function bytesFormatBytes(bytes: number, decimals = 2): string {\n  if (bytes === 0) {\n    return '0 Bytes';\n  }\n\n  const k = 1024;\n  const dm = decimals < 0 ? 0 : decimals;\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;\n}\n"]}

package/dist/Helper/Bytes.d.cts

@@ -0,0 +1,3 @@
+declare function bytesFormatBytes(bytes: number, decimals?: number): string;
+
+export { bytesFormatBytes };

package/dist/Helper/Bytes.d.ts

@@ -0,0 +1,3 @@
+declare function bytesFormatBytes(bytes: number, decimals?: number): string;
+
+export { bytesFormatBytes };

package/dist/Helper/Bytes.js

@@ -0,0 +1,15 @@
+// src/Helper/Bytes.ts
+function bytesFormatBytes(bytes, decimals = 2) {
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
+  const k = 1024;
+  const dm = decimals < 0 ? 0 : decimals;
+  const sizes = ["B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;
+}
+
+export { bytesFormatBytes };
+//# sourceMappingURL=Bytes.js.map
+//# sourceMappingURL=Bytes.js.map

package/dist/Helper/Bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Bytes.ts"],"names":[],"mappings":";AAAO,SAAS,gBAAA,CAAiB,KAAA,EAAe,QAAA,GAAW,CAAA,EAAW;AACpE,EAAA,IAAI,UAAU,CAAA,EAAG;AACf,IAAA,OAAO,SAAA;AAAA,EACT;AAEA,EAAA,MAAM,CAAA,GAAI,IAAA;AACV,EAAA,MAAM,EAAA,GAAK,QAAA,GAAW,CAAA,GAAI,CAAA,GAAI,QAAA;AAC9B,EAAA,MAAM,KAAA,GAAQ,CAAC,GAAA,EAAK,IAAA,EAAM,IAAA,EAAM,MAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAA,EAAM,IAAI,CAAA;AAClE,EAAA,MAAM,CAAA,GAAI,IAAA,CAAK,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,KAAK,CAAA,GAAI,IAAA,CAAK,GAAA,CAAI,CAAC,CAAC,CAAA;AAElD,EAAA,OAAO,CAAA,EAAG,UAAA,CAAA,CAAY,KAAA,GAAQ,CAAA,IAAK,CAAA,EAAG,OAAA,CAAQ,EAAE,CAAC,CAAC,CAAA,CAAA,EAAI,KAAA,CAAM,CAAC,CAAC,CAAA,CAAA;AAChE","file":"Bytes.js","sourcesContent":["export function bytesFormatBytes(bytes: number, decimals = 2): string {\n  if (bytes === 0) {\n    return '0 Bytes';\n  }\n\n  const k = 1024;\n  const dm = decimals < 0 ? 0 : decimals;\n  const sizes = ['B', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / k ** i).toFixed(dm))} ${sizes[i]}`;\n}\n"]}

package/dist/Helper/Dom.cjs

@@ -0,0 +1,83 @@
+'use strict';
+
+// src/Helper/Dom.ts
+var DOM_ATTRIBUTE = {
+  HREF: "href",
+  ID: "id",
+  REL: "rel",
+  SRC: "src"
+};
+var DOM_ATTRIBUTE_VALUE = {
+  STYLESHEET: "stylesheet"
+};
+var DOM_INSERT_POSITION = {
+  BEFORE_END: "beforeend"
+};
+var DOM_TAG_NAME = {
+  A: "a",
+  DIV: "div",
+  LINK: "link",
+  SCRIPT: "script"
+};
+function domAppendInnerHtml(el, html) {
+  el.insertAdjacentHTML(DOM_INSERT_POSITION.BEFORE_END, html);
+}
+function domFindPreviousNode(el) {
+  let current = el;
+  do {
+    current = current?.previousSibling ?? null;
+  } while (current && current.nodeType === Node.TEXT_NODE);
+  return current;
+}
+function domFindScrollParent(element, includeHidden = false) {
+  const style = getComputedStyle(element);
+  const overflowRegex = includeHidden ? /(auto|scroll|hidden)/ : /(auto|scroll)/;
+  const excludeStaticParent = style.position === "absolute";
+  if (style.position === "fixed") {
+    return document.body;
+  }
+  let parent = element.parentElement;
+  while (parent) {
+    const parentStyle = getComputedStyle(parent);
+    if ((!excludeStaticParent || parentStyle.position !== "static") && overflowRegex.test(parentStyle.overflow + parentStyle.overflowY + parentStyle.overflowX)) {
+      return parent;
+    }
+    parent = parent.parentElement;
+  }
+  return document.body;
+}
+function domToggleMainOverlay(visible = null) {
+  const overlay = document.getElementById("main-overlay");
+  if (!overlay) return;
+  const classList = overlay.classList;
+  const shouldShow = visible !== null ? visible : !classList.contains("visible");
+  classList[shouldShow ? "add" : "remove"]("visible");
+}
+function domCreateHtmlDocumentFromHtml(html) {
+  const root = document.createElement("html");
+  root.innerHTML = html;
+  return root;
+}
+function domRemoveAllClasses(el, classesToRemove) {
+  for (const className of classesToRemove) {
+    el.classList.remove(className);
+  }
+}
+function domReplaceByOneClass(el, newState, classesToRemove) {
+  domRemoveAllClasses(el, classesToRemove);
+  el.classList.add(newState);
+}
+
+exports.DOM_ATTRIBUTE = DOM_ATTRIBUTE;
+exports.DOM_ATTRIBUTE_VALUE = DOM_ATTRIBUTE_VALUE;
+exports.DOM_INSERT_POSITION = DOM_INSERT_POSITION;
+exports.DOM_TAG_NAME = DOM_TAG_NAME;
+exports.domAppendInnerHtml = domAppendInnerHtml;
+exports.domCreateHtmlDocumentFromHtml = domCreateHtmlDocumentFromHtml;
+exports.domFindPreviousNode = domFindPreviousNode;
+exports.domFindScrollParent = domFindScrollParent;
+exports.domRemoveAllClasses = domRemoveAllClasses;
+exports.domReplaceByOneClass = domReplaceByOneClass;
+exports.domToggleMainOverlay = domToggleMainOverlay;
+//# sourceMappingURL=Dom.cjs.map
+//# sourceMappingURL=Dom.cjs.map

package/dist/Helper/Dom.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Dom.ts"],"names":[],"mappings":";;;AAAO,IAAM,aAAA,GAAgB;AAAA,EAC3B,IAAA,EAAM,MAAA;AAAA,EACN,EAAA,EAAI,IAAA;AAAA,EACJ,GAAA,EAAK,KAAA;AAAA,EACL,GAAA,EAAK;AACP;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,UAAA,EAAY;AACd;AAEO,IAAM,mBAAA,GAAsB;AAAA,EACjC,UAAA,EAAY;AACd;AAEO,IAAM,YAAA,GAAe;AAAA,EAC1B,CAAA,EAAG,GAAA;AAAA,EACH,GAAA,EAAK,KAAA;AAAA,EACL,IAAA,EAAM,MAAA;AAAA,EACN,MAAA,EAAQ;AACV;AAEO,SAAS,kBAAA,CAAmB,IAAiB,IAAA,EAAoB;AACtE,EAAA,EAAA,CAAG,kBAAA,CAAmB,mBAAA,CAAoB,UAAA,EAAY,IAAI,CAAA;AAC5D;AAEO,SAAS,oBAAoB,EAAA,EAAqC;AACvE,EAAA,IAAI,OAAA,GAA4B,EAAA;AAEhC,EAAA,GAAG;AACD,IAAA,OAAA,GAAU,SAAS,eAAA,IAAmB,IAAA;AAAA,EACxC,CAAA,QAAS,OAAA,IAAW,OAAA,CAAQ,QAAA,KAAa,IAAA,CAAK,SAAA;AAE9C,EAAA,OAAO,OAAA;AACT;AAOO,SAAS,mBAAA,CAAoB,OAAA,EAAsB,aAAA,GAAgB,KAAA,EAAoB;AAC5F,EAAA,MAAM,KAAA,GAAQ,iBAAiB,OAAO,CAAA;AACtC,EAAA,MAAM,aAAA,GAAgB,gBAAgB,sBAAA,GAAyB,eAAA;AAC/D,EAAA,MAAM,mBAAA,GAAsB,MAAM,QAAA,KAAa,UAAA;AAE/C,EAAA,IAAI,KAAA,CAAM,aAAa,OAAA,EAAS;AAC9B,IAAA,OAAO,QAAA,CAAS,IAAA;AAAA,EAClB;AAEA,EAAA,IAAI,SAA6B,OAAA,CAAQ,aAAA;AACzC,EAAA,OAAO,MAAA,EAAQ;AACb,IAAA,MAAM,WAAA,GAAc,iBAAiB,MAAM,CAAA;AAE3C,IAAA,IAAA,CACG,CAAC,mBAAA,IAAuB,WAAA,CAAY,QAAA,KAAa,QAAA,KAClD,aAAA,CAAc,IAAA,CAAK,WAAA,CAAY,QAAA,GAAW,WAAA,CAAY,SAAA,GAAY,WAAA,CAAY,SAAS,CAAA,EACvF;AACA,MAAA,OAAO,MAAA;AAAA,IACT;AAEA,IAAA,MAAA,GAAS,MAAA,CAAO,aAAA;AAAA,EAClB;AAEA,EAAA,OAAO,QAAA,CAAS,IAAA;AAClB;AAEO,SAAS,oBAAA,CAAqB,UAA0B,IAAA,EAAY;AACzE,EAAA,MAAM,OAAA,GAAU,QAAA,CAAS,cAAA,CAAe,cAAc,CAAA;AACtD,EAAA,IAAI,CAAC,OAAA,EAAS;AAEd,EAAA,MAAM,YAAY,OAAA,CAAQ,SAAA;AAC1B,EAAA,MAAM,aAAa,OAAA,KAAY,IAAA,GAAO,UAAU,CAAC,SAAA,CAAU,SAAS,SAAS,CAAA;AAE7E,EAAA,SAAA,CAAU,UAAA,GAAa,KAAA,GAAQ,QAAQ,CAAA,CAAE,SAAS,CAAA;AACpD;AAEO,SAAS,8BAA8B,IAAA,EAA+B;AAC3E,EAAA,MAAM,IAAA,GAAO,QAAA,CAAS,aAAA,CAAc,MAAM,CAAA;AAC1C,EAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,mBAAA,CAAoB,IAAiB,eAAA,EAAyC;AAC5F,EAAA,KAAA,MAAW,aAAa,eAAA,EAAiB;AACvC,IAAA,EAAA,CAAG,SAAA,CAAU,OAAO,SAAS,CAAA;AAAA,EAC/B;AACF;AAEO,SAAS,oBAAA,CACd,EAAA,EACA,QAAA,EACA,eAAA,EACM;AACN,EAAA,mBAAA,CAAoB,IAAI,eAAe,CAAA;AACvC,EAAA,EAAA,CAAG,SAAA,CAAU,IAAI,QAAQ,CAAA;AAC3B","file":"Dom.cjs","sourcesContent":["export const DOM_ATTRIBUTE = {\n  HREF: 'href',\n  ID: 'id',\n  REL: 'rel',\n  SRC: 'src',\n} as const;\n\nexport const DOM_ATTRIBUTE_VALUE = {\n  STYLESHEET: 'stylesheet',\n} as const;\n\nexport const DOM_INSERT_POSITION = {\n  BEFORE_END: 'beforeend' as InsertPosition,\n} as const;\n\nexport const DOM_TAG_NAME = {\n  A: 'a',\n  DIV: 'div',\n  LINK: 'link',\n  SCRIPT: 'script',\n} as const;\n\nexport function domAppendInnerHtml(el: HTMLElement, html: string): void {\n  el.insertAdjacentHTML(DOM_INSERT_POSITION.BEFORE_END, html);\n}\n\nexport function domFindPreviousNode(el: HTMLElement): HTMLElement | null {\n  let current: ChildNode | null = el;\n\n  do {\n    current = current?.previousSibling ?? null;\n  } while (current && current.nodeType === Node.TEXT_NODE);\n\n  return current as HTMLElement | null;\n}\n\n/**\n * Return first scrollable parent.\n *\n * @see https://stackoverflow.com/a/42543908/2057976\n */\nexport function domFindScrollParent(element: HTMLElement, includeHidden = false): HTMLElement {\n  const style = getComputedStyle(element);\n  const overflowRegex = includeHidden ? /(auto|scroll|hidden)/ : /(auto|scroll)/;\n  const excludeStaticParent = style.position === 'absolute';\n\n  if (style.position === 'fixed') {\n    return document.body;\n  }\n\n  let parent: HTMLElement | null = element.parentElement;\n  while (parent) {\n    const parentStyle = getComputedStyle(parent);\n\n    if (\n      (!excludeStaticParent || parentStyle.position !== 'static') &&\n      overflowRegex.test(parentStyle.overflow + parentStyle.overflowY + parentStyle.overflowX)\n    ) {\n      return parent;\n    }\n\n    parent = parent.parentElement;\n  }\n\n  return document.body;\n}\n\nexport function domToggleMainOverlay(visible: boolean | null = null): void {\n  const overlay = document.getElementById('main-overlay');\n  if (!overlay) return;\n\n  const classList = overlay.classList;\n  const shouldShow = visible !== null ? visible : !classList.contains('visible');\n\n  classList[shouldShow ? 'add' : 'remove']('visible');\n}\n\nexport function domCreateHtmlDocumentFromHtml(html: string): HTMLHtmlElement {\n  const root = document.createElement('html');\n  root.innerHTML = html;\n  return root;\n}\n\nexport function domRemoveAllClasses(el: HTMLElement, classesToRemove: Iterable<string>): void {\n  for (const className of classesToRemove) {\n    el.classList.remove(className);\n  }\n}\n\nexport function domReplaceByOneClass(\n  el: HTMLElement,\n  newState: string,\n  classesToRemove: Iterable<string>\n): void {\n  domRemoveAllClasses(el, classesToRemove);\n  el.classList.add(newState);\n}\n"]}

package/dist/Helper/Dom.d.cts

@@ -0,0 +1,32 @@
+declare const DOM_ATTRIBUTE: {
+    readonly HREF: "href";
+    readonly ID: "id";
+    readonly REL: "rel";
+    readonly SRC: "src";
+};
+declare const DOM_ATTRIBUTE_VALUE: {
+    readonly STYLESHEET: "stylesheet";
+};
+declare const DOM_INSERT_POSITION: {
+    readonly BEFORE_END: InsertPosition;
+};
+declare const DOM_TAG_NAME: {
+    readonly A: "a";
+    readonly DIV: "div";
+    readonly LINK: "link";
+    readonly SCRIPT: "script";
+};
+declare function domAppendInnerHtml(el: HTMLElement, html: string): void;
+declare function domFindPreviousNode(el: HTMLElement): HTMLElement | null;
+/**
+ * Return first scrollable parent.
+ *
+ * @see https://stackoverflow.com/a/42543908/2057976
+ */
+declare function domFindScrollParent(element: HTMLElement, includeHidden?: boolean): HTMLElement;
+declare function domToggleMainOverlay(visible?: boolean | null): void;
+declare function domCreateHtmlDocumentFromHtml(html: string): HTMLHtmlElement;
+declare function domRemoveAllClasses(el: HTMLElement, classesToRemove: Iterable<string>): void;
+declare function domReplaceByOneClass(el: HTMLElement, newState: string, classesToRemove: Iterable<string>): void;
+
+export { DOM_ATTRIBUTE, DOM_ATTRIBUTE_VALUE, DOM_INSERT_POSITION, DOM_TAG_NAME, domAppendInnerHtml, domCreateHtmlDocumentFromHtml, domFindPreviousNode, domFindScrollParent, domRemoveAllClasses, domReplaceByOneClass, domToggleMainOverlay };

package/dist/Helper/Dom.d.ts

@@ -0,0 +1,32 @@
+declare const DOM_ATTRIBUTE: {
+    readonly HREF: "href";
+    readonly ID: "id";
+    readonly REL: "rel";
+    readonly SRC: "src";
+};
+declare const DOM_ATTRIBUTE_VALUE: {
+    readonly STYLESHEET: "stylesheet";
+};
+declare const DOM_INSERT_POSITION: {
+    readonly BEFORE_END: InsertPosition;
+};
+declare const DOM_TAG_NAME: {
+    readonly A: "a";
+    readonly DIV: "div";
+    readonly LINK: "link";
+    readonly SCRIPT: "script";
+};
+declare function domAppendInnerHtml(el: HTMLElement, html: string): void;
+declare function domFindPreviousNode(el: HTMLElement): HTMLElement | null;
+/**
+ * Return first scrollable parent.
+ *
+ * @see https://stackoverflow.com/a/42543908/2057976
+ */
+declare function domFindScrollParent(element: HTMLElement, includeHidden?: boolean): HTMLElement;
+declare function domToggleMainOverlay(visible?: boolean | null): void;
+declare function domCreateHtmlDocumentFromHtml(html: string): HTMLHtmlElement;
+declare function domRemoveAllClasses(el: HTMLElement, classesToRemove: Iterable<string>): void;
+declare function domReplaceByOneClass(el: HTMLElement, newState: string, classesToRemove: Iterable<string>): void;
+
+export { DOM_ATTRIBUTE, DOM_ATTRIBUTE_VALUE, DOM_INSERT_POSITION, DOM_TAG_NAME, domAppendInnerHtml, domCreateHtmlDocumentFromHtml, domFindPreviousNode, domFindScrollParent, domRemoveAllClasses, domReplaceByOneClass, domToggleMainOverlay };

package/dist/Helper/Dom.js

@@ -0,0 +1,71 @@
+// src/Helper/Dom.ts
+var DOM_ATTRIBUTE = {
+  HREF: "href",
+  ID: "id",
+  REL: "rel",
+  SRC: "src"
+};
+var DOM_ATTRIBUTE_VALUE = {
+  STYLESHEET: "stylesheet"
+};
+var DOM_INSERT_POSITION = {
+  BEFORE_END: "beforeend"
+};
+var DOM_TAG_NAME = {
+  A: "a",
+  DIV: "div",
+  LINK: "link",
+  SCRIPT: "script"
+};
+function domAppendInnerHtml(el, html) {
+  el.insertAdjacentHTML(DOM_INSERT_POSITION.BEFORE_END, html);
+}
+function domFindPreviousNode(el) {
+  let current = el;
+  do {
+    current = current?.previousSibling ?? null;
+  } while (current && current.nodeType === Node.TEXT_NODE);
+  return current;
+}
+function domFindScrollParent(element, includeHidden = false) {
+  const style = getComputedStyle(element);
+  const overflowRegex = includeHidden ? /(auto|scroll|hidden)/ : /(auto|scroll)/;
+  const excludeStaticParent = style.position === "absolute";
+  if (style.position === "fixed") {
+    return document.body;
+  }
+  let parent = element.parentElement;
+  while (parent) {
+    const parentStyle = getComputedStyle(parent);
+    if ((!excludeStaticParent || parentStyle.position !== "static") && overflowRegex.test(parentStyle.overflow + parentStyle.overflowY + parentStyle.overflowX)) {
+      return parent;
+    }
+    parent = parent.parentElement;
+  }
+  return document.body;
+}
+function domToggleMainOverlay(visible = null) {
+  const overlay = document.getElementById("main-overlay");
+  if (!overlay) return;
+  const classList = overlay.classList;
+  const shouldShow = visible !== null ? visible : !classList.contains("visible");
+  classList[shouldShow ? "add" : "remove"]("visible");
+}
+function domCreateHtmlDocumentFromHtml(html) {
+  const root = document.createElement("html");
+  root.innerHTML = html;
+  return root;
+}
+function domRemoveAllClasses(el, classesToRemove) {
+  for (const className of classesToRemove) {
+    el.classList.remove(className);
+  }
+}
+function domReplaceByOneClass(el, newState, classesToRemove) {
+  domRemoveAllClasses(el, classesToRemove);
+  el.classList.add(newState);
+}
+
+export { DOM_ATTRIBUTE, DOM_ATTRIBUTE_VALUE, DOM_INSERT_POSITION, DOM_TAG_NAME, domAppendInnerHtml, domCreateHtmlDocumentFromHtml, domFindPreviousNode, domFindScrollParent, domRemoveAllClasses, domReplaceByOneClass, domToggleMainOverlay };
+//# sourceMappingURL=Dom.js.map
+//# sourceMappingURL=Dom.js.map

package/dist/Helper/Dom.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Dom.ts"],"names":[],"mappings":"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","file":"Dom.js","sourcesContent":["export const DOM_ATTRIBUTE = {\n  HREF: 'href',\n  ID: 'id',\n  REL: 'rel',\n  SRC: 'src',\n} as const;\n\nexport const DOM_ATTRIBUTE_VALUE = {\n  STYLESHEET: 'stylesheet',\n} as const;\n\nexport const DOM_INSERT_POSITION = {\n  BEFORE_END: 'beforeend' as InsertPosition,\n} as const;\n\nexport const DOM_TAG_NAME = {\n  A: 'a',\n  DIV: 'div',\n  LINK: 'link',\n  SCRIPT: 'script',\n} as const;\n\nexport function domAppendInnerHtml(el: HTMLElement, html: string): void {\n  el.insertAdjacentHTML(DOM_INSERT_POSITION.BEFORE_END, html);\n}\n\nexport function domFindPreviousNode(el: HTMLElement): HTMLElement | null {\n  let current: ChildNode | null = el;\n\n  do {\n    current = current?.previousSibling ?? null;\n  } while (current && current.nodeType === Node.TEXT_NODE);\n\n  return current as HTMLElement | null;\n}\n\n/**\n * Return first scrollable parent.\n *\n * @see https://stackoverflow.com/a/42543908/2057976\n */\nexport function domFindScrollParent(element: HTMLElement, includeHidden = false): HTMLElement {\n  const style = getComputedStyle(element);\n  const overflowRegex = includeHidden ? /(auto|scroll|hidden)/ : /(auto|scroll)/;\n  const excludeStaticParent = style.position === 'absolute';\n\n  if (style.position === 'fixed') {\n    return document.body;\n  }\n\n  let parent: HTMLElement | null = element.parentElement;\n  while (parent) {\n    const parentStyle = getComputedStyle(parent);\n\n    if (\n      (!excludeStaticParent || parentStyle.position !== 'static') &&\n      overflowRegex.test(parentStyle.overflow + parentStyle.overflowY + parentStyle.overflowX)\n    ) {\n      return parent;\n    }\n\n    parent = parent.parentElement;\n  }\n\n  return document.body;\n}\n\nexport function domToggleMainOverlay(visible: boolean | null = null): void {\n  const overlay = document.getElementById('main-overlay');\n  if (!overlay) return;\n\n  const classList = overlay.classList;\n  const shouldShow = visible !== null ? visible : !classList.contains('visible');\n\n  classList[shouldShow ? 'add' : 'remove']('visible');\n}\n\nexport function domCreateHtmlDocumentFromHtml(html: string): HTMLHtmlElement {\n  const root = document.createElement('html');\n  root.innerHTML = html;\n  return root;\n}\n\nexport function domRemoveAllClasses(el: HTMLElement, classesToRemove: Iterable<string>): void {\n  for (const className of classesToRemove) {\n    el.classList.remove(className);\n  }\n}\n\nexport function domReplaceByOneClass(\n  el: HTMLElement,\n  newState: string,\n  classesToRemove: Iterable<string>\n): void {\n  domRemoveAllClasses(el, classesToRemove);\n  el.classList.add(newState);\n}\n"]}

package/dist/Helper/Event.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+// src/Helper/Event.ts
+var EVENT = {
+  CLICK: "click",
+  DBLCLICK: "dblclick",
+  CONTEXTMENU: "contextmenu",
+  KEYDOWN: "keydown",
+  KEYUP: "keyup",
+  KEYPRESS: "keypress",
+  INPUT: "input",
+  CHANGE: "change",
+  FOCUS: "focus",
+  BLUR: "blur",
+  SUBMIT: "submit",
+  RESET: "reset",
+  MOUSEUP: "mouseup",
+  MOUSEDOWN: "mousedown",
+  MOUSEMOVE: "mousemove",
+  MOUSEENTER: "mouseenter",
+  MOUSELEAVE: "mouseleave",
+  WHEEL: "wheel",
+  SCROLL: "scroll",
+  RESIZE: "resize",
+  TOUCHSTART: "touchstart",
+  TOUCHMOVE: "touchmove",
+  TOUCHEND: "touchend",
+  POINTERDOWN: "pointerdown",
+  POINTERMOVE: "pointermove",
+  POINTERUP: "pointerup"
+};
+
+exports.EVENT = EVENT;
+//# sourceMappingURL=Event.cjs.map
+//# sourceMappingURL=Event.cjs.map

package/dist/Helper/Event.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/Helper/Event.ts"],"names":[],"mappings":";;;AAAO,IAAM,KAAA,GAAQ;AAAA,EACnB,KAAA,EAAO,OAAA;AAAA,EACP,QAAA,EAAU,UAAA;AAAA,EACV,WAAA,EAAa,aAAA;AAAA,EACb,OAAA,EAAS,SAAA;AAAA,EACT,KAAA,EAAO,OAAA;AAAA,EACP,QAAA,EAAU,UAAA;AAAA,EACV,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,IAAA,EAAM,MAAA;AAAA,EACN,MAAA,EAAQ,QAAA;AAAA,EACR,KAAA,EAAO,OAAA;AAAA,EACP,OAAA,EAAS,SAAA;AAAA,EACT,SAAA,EAAW,WAAA;AAAA,EACX,SAAA,EAAW,WAAA;AAAA,EACX,UAAA,EAAY,YAAA;AAAA,EACZ,UAAA,EAAY,YAAA;AAAA,EACZ,KAAA,EAAO,OAAA;AAAA,EACP,MAAA,EAAQ,QAAA;AAAA,EACR,MAAA,EAAQ,QAAA;AAAA,EACR,UAAA,EAAY,YAAA;AAAA,EACZ,SAAA,EAAW,WAAA;AAAA,EACX,QAAA,EAAU,UAAA;AAAA,EACV,WAAA,EAAa,aAAA;AAAA,EACb,WAAA,EAAa,aAAA;AAAA,EACb,SAAA,EAAW;AACb","file":"Event.cjs","sourcesContent":["export const EVENT = {\n  CLICK: 'click',\n  DBLCLICK: 'dblclick',\n  CONTEXTMENU: 'contextmenu',\n  KEYDOWN: 'keydown',\n  KEYUP: 'keyup',\n  KEYPRESS: 'keypress',\n  INPUT: 'input',\n  CHANGE: 'change',\n  FOCUS: 'focus',\n  BLUR: 'blur',\n  SUBMIT: 'submit',\n  RESET: 'reset',\n  MOUSEUP: 'mouseup',\n  MOUSEDOWN: 'mousedown',\n  MOUSEMOVE: 'mousemove',\n  MOUSEENTER: 'mouseenter',\n  MOUSELEAVE: 'mouseleave',\n  WHEEL: 'wheel',\n  SCROLL: 'scroll',\n  RESIZE: 'resize',\n  TOUCHSTART: 'touchstart',\n  TOUCHMOVE: 'touchmove',\n  TOUCHEND: 'touchend',\n  POINTERDOWN: 'pointerdown',\n  POINTERMOVE: 'pointermove',\n  POINTERUP: 'pointerup',\n} as const;\n\nexport type EventName = (typeof EVENT)[keyof typeof EVENT];\n"]}

package/dist/Helper/Event.d.cts

@@ -0,0 +1,31 @@
+declare const EVENT: {
+    readonly CLICK: "click";
+    readonly DBLCLICK: "dblclick";
+    readonly CONTEXTMENU: "contextmenu";
+    readonly KEYDOWN: "keydown";
+    readonly KEYUP: "keyup";
+    readonly KEYPRESS: "keypress";
+    readonly INPUT: "input";
+    readonly CHANGE: "change";
+    readonly FOCUS: "focus";
+    readonly BLUR: "blur";
+    readonly SUBMIT: "submit";
+    readonly RESET: "reset";
+    readonly MOUSEUP: "mouseup";
+    readonly MOUSEDOWN: "mousedown";
+    readonly MOUSEMOVE: "mousemove";
+    readonly MOUSEENTER: "mouseenter";
+    readonly MOUSELEAVE: "mouseleave";
+    readonly WHEEL: "wheel";
+    readonly SCROLL: "scroll";
+    readonly RESIZE: "resize";
+    readonly TOUCHSTART: "touchstart";
+    readonly TOUCHMOVE: "touchmove";
+    readonly TOUCHEND: "touchend";
+    readonly POINTERDOWN: "pointerdown";
+    readonly POINTERMOVE: "pointermove";
+    readonly POINTERUP: "pointerup";
+};
+type EventName = (typeof EVENT)[keyof typeof EVENT];
+
+export { EVENT, type EventName };