@angelscmf/front 1.0.28 → 1.0.30

package/dist/AngelsFrontDOMLibrary.mjs

@@ -0,0 +1,378 @@
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/AngelsFrontAnimationLibrary.ts
+function aLibConcealElement(originalElement) {
+  return __async(this, null, function* () {
+    const innerElement = aLibRequireElement(originalElement);
+    const promise = new Promise((resolve) => {
+      if (innerElement.hidden) {
+        resolve();
+        return;
+      }
+      let timeout;
+      const animationHandler = () => {
+        clearTimeout(timeout);
+        innerElement.removeEventListener("animationend", animationHandler);
+        innerElement.hidden = true;
+        innerElement.classList.remove("a-out-animation");
+        resolve();
+      };
+      innerElement.classList.add("a-out-animation");
+      const animations = innerElement.getAnimations();
+      if (animations.length > 0) {
+        timeout = setTimeout(() => {
+          innerElement.removeEventListener("animationend", animationHandler);
+          innerElement.hidden = true;
+          innerElement.classList.remove("a-out-animation");
+          console.warn("Animation timeout");
+          resolve();
+        }, 5e3);
+        innerElement.addEventListener("animationend", animationHandler);
+      } else {
+        innerElement.hidden = true;
+        resolve();
+      }
+    });
+    return promise;
+  });
+}
+function aLibEngageElement(originalElement, switcher = void 0) {
+  return __async(this, null, function* () {
+    const innerElement = aLibRequireElement(originalElement);
+    if (switcher === void 0) {
+      switcher = innerElement.hidden;
+    }
+    if (switcher) {
+      return yield aLibRevealElement(innerElement);
+    } else {
+      return yield aLibConcealElement(innerElement);
+    }
+  });
+}
+function aLibRevealElement(originalElement) {
+  return __async(this, null, function* () {
+    const innerElement = aLibRequireElement(originalElement);
+    const promise = new Promise((resolve) => {
+      if (!innerElement.hidden) {
+        resolve();
+        return;
+      }
+      let timeout;
+      const animationHandler = () => {
+        clearTimeout(timeout);
+        innerElement.removeEventListener("animationend", animationHandler);
+        resolve();
+      };
+      innerElement.hidden = false;
+      const animations = innerElement.getAnimations();
+      if (animations.length > 0) {
+        timeout = setTimeout(() => {
+          innerElement.removeEventListener("animationend", animationHandler);
+          console.warn("Animation timeout");
+          resolve();
+        }, 5e3);
+        innerElement.addEventListener("animationend", animationHandler);
+      } else {
+        resolve();
+      }
+    });
+    return promise;
+  });
+}
+
+// src/AngelsFrontElement.ts
+var AngelsFrontElementClass = class {
+  constructor(element) {
+    this.originalElement = element;
+    return new Proxy(this, {
+      get(target, prop, receiver) {
+        if (prop in target) {
+          return Reflect.get(target, prop);
+        }
+        const valueOfProperty = Reflect.get(target.originalElement, prop);
+        if (typeof valueOfProperty === "function") {
+          return valueOfProperty.bind(target.originalElement);
+        }
+        return valueOfProperty;
+      },
+      set(target, prop, newValue, receiver) {
+        if (prop in target.originalElement) {
+          target.originalElement[prop] = newValue;
+        } else {
+          target[prop] = newValue;
+        }
+        return true;
+      }
+    });
+  }
+  aConcealElement() {
+    aLibConcealElement(this.originalElement);
+    return this;
+  }
+  aEngageElement(switcher = void 0) {
+    aLibEngageElement(this.originalElement, switcher);
+    return this;
+  }
+  aHideElement() {
+    this.originalElement.hidden = true;
+    return this;
+  }
+  aRevealElement() {
+    aLibRevealElement(this.originalElement);
+    return this;
+  }
+  aShowElement() {
+    this.originalElement.hidden = false;
+    return this;
+  }
+  aSetTextContent(content) {
+    const contentToSet = content.toString();
+    this.originalElement.textContent = contentToSet;
+    return this;
+  }
+  aTextContent() {
+    if (this.originalElement.textContent === null) {
+      return ``;
+    }
+    return this.originalElement.textContent;
+  }
+};
+
+// src/AngelsFrontMod.ts
+var AngelsFrontMod = class {
+  constructor() {
+    this.modWaitStartTimeout = 1e3;
+    this.modSubMods = new Array();
+  }
+  /**
+   * Starts AngelsFrontMod.
+   */
+  modStart() {
+    this.modInit();
+    this.modBind();
+    this.modLink();
+    this.modRun();
+    setTimeout(() => {
+      this.modWait();
+    }, this.modWaitStartTimeout);
+  }
+  /**
+   * Finishes AngelsFrontMod.
+   */
+  modFinish() {
+    this.modDeWait();
+    this.modDeRun();
+    this.modDeLink();
+    this.modDeBind();
+    this.modDeInit();
+  }
+  /**
+   * Inits AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modInit() {
+    this.modSubMods.forEach((mod) => mod.modInit());
+  }
+  /**
+   * Binds AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modBind() {
+    this.modSubMods.forEach((mod) => mod.modBind());
+  }
+  /**
+   * Links AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modLink() {
+    this.modSubMods.forEach((mod) => mod.modLink());
+  }
+  /**
+   * Runs AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modRun() {
+    this.modSubMods.forEach((mod) => mod.modRun());
+  }
+  /**
+   * Waits AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modWait() {
+    this.modSubMods.forEach((mod) => mod.modWait());
+  }
+  /**
+   * DeInits AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modDeInit() {
+    this.modSubMods.forEach((mod) => mod.modDeInit());
+  }
+  /**
+   * DeBinds AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modDeBind() {
+    this.modSubMods.forEach((mod) => mod.modDeBind());
+  }
+  /**
+   * DeLinks AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modDeLink() {
+    this.modSubMods.forEach((mod) => mod.modDeLink());
+  }
+  /**
+   * DeRuns AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modDeRun() {
+    this.modSubMods.forEach((mod) => mod.modDeRun());
+  }
+  /**
+   * DeWaits AngelsFrontMod and its sub-modules AngelsFrontMod.
+   */
+  modDeWait() {
+    this.modSubMods.forEach((mod) => mod.modDeWait());
+  }
+  modDestructor() {
+    this.modSubMods.forEach((mod) => mod.modDestructor());
+  }
+  modAddSubMod(mod) {
+    if (mod) {
+      this.modSubMods.push(mod);
+      mod.modInit();
+      return mod;
+    }
+    return null;
+  }
+  modRequireSubMod(mod) {
+    this.modSubMods.push(mod);
+    mod.modInit();
+    return mod;
+  }
+};
+
+// src/AngelsFrontWidgetClass.ts
+var AngelsFrontWidgetClass = class extends AngelsFrontMod {
+  constructor(element) {
+    super();
+    this.widElement = new AngelsFrontElementClass(element);
+    return new Proxy(this, {
+      get(target, prop, receiver) {
+        if (prop in target) {
+          const valueOfProperty2 = target[prop];
+          if (typeof valueOfProperty2 === "function") {
+            return Reflect.get(target, prop);
+          }
+          return valueOfProperty2;
+        }
+        const valueOfProperty = target.widElement[prop];
+        if (typeof valueOfProperty === "function") {
+          return valueOfProperty.bind(target.widElement);
+        }
+        return valueOfProperty;
+      },
+      set(target, prop, newValue, receiver) {
+        if (prop in target) {
+          target[prop] = newValue;
+        } else {
+          target.widElement[prop] = newValue;
+        }
+        return true;
+      }
+    });
+  }
+  widFindElement(selector) {
+    const findElement = this.widElement.querySelector(selector);
+    if (findElement) {
+      return aFindElement(findElement);
+    }
+    return null;
+  }
+  widFindElements(selector) {
+    return Array.from(this.widElement.querySelectorAll(selector)).map(aFindElement);
+  }
+  widRequireElement(selector) {
+    const element = this.widElement.querySelector(selector);
+    if (element) {
+      return aFindElement(element);
+    }
+    throw Error(`Element '${selector}' is not found.`);
+  }
+};
+
+// src/AngelsFrontDOMLibrary.ts
+function aLibCreateWidget(element) {
+  return new AngelsFrontWidgetClass(element);
+}
+function aLibFindElement(selector) {
+  let element;
+  if (typeof selector === "undefined") {
+    return null;
+  } else if (selector === null) {
+    return null;
+  } else if (typeof selector === "string") {
+    const findElement = document.querySelector(selector);
+    if (!findElement) {
+      return null;
+    }
+    element = findElement;
+  } else if (selector instanceof HTMLElement) {
+    element = selector;
+  } else if (selector instanceof Element) {
+    element = selector;
+  } else if (selector instanceof AngelsFrontElementClass) {
+    return selector;
+  } else {
+    element = selector;
+  }
+  return new AngelsFrontElementClass(element);
+}
+function aLibRequireElement(selector) {
+  const element = aLibFindElement(selector);
+  if (element) {
+    return element;
+  }
+  throw Error(`Element not found by '${selector}' selector.`);
+}
+function aLibHideElement(selector) {
+  const element = aLibRequireElement(selector);
+  element.hidden = true;
+  return element;
+}
+function aLibShowElement(selector) {
+  const element = aLibRequireElement(selector);
+  element.hidden = false;
+  return element;
+}
+function aLibToggleElement(originalElement, switcher = void 0) {
+  const innerElement = aLibRequireElement(originalElement);
+  if (switcher === void 0) {
+    switcher = !innerElement.hidden;
+  }
+  if (switcher) {
+    return aLibShowElement(innerElement);
+  } else {
+    return aLibHideElement(innerElement);
+  }
+}
+export {
+  aLibCreateWidget,
+  aLibFindElement,
+  aLibHideElement,
+  aLibRequireElement,
+  aLibShowElement,
+  aLibToggleElement
+};
+//# sourceMappingURL=AngelsFrontDOMLibrary.mjs.map

package/dist/AngelsFrontDOMLibrary.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/AngelsFrontAnimationLibrary.ts","../src/AngelsFrontElement.ts","../src/AngelsFrontMod.ts","../src/AngelsFrontWidgetClass.ts","../src/AngelsFrontDOMLibrary.ts"],"sourcesContent":["import { aLibRequireElement } from \"./AngelsFrontDOMLibrary\";\n\nexport async function aLibConcealElement(originalElement: AngelsSelectorType) {\n    const innerElement = aLibRequireElement(originalElement);\n    const promise = new Promise<void>((resolve) => {\n\n        if (innerElement.hidden) {\n            resolve();\n            return;\n        }\n\n        let timeout: NodeJS.Timeout | undefined;\n\n        const animationHandler = () => {\n            clearTimeout(timeout);\n            innerElement.removeEventListener('animationend', animationHandler);\n            innerElement.hidden = true;\n            innerElement.classList.remove('a-out-animation');\n            resolve();\n        }\n\n        innerElement.classList.add('a-out-animation');\n\n        const animations = innerElement.getAnimations();\n        if (animations.length > 0) {\n            timeout = setTimeout(() => {\n                innerElement.removeEventListener('animationend', animationHandler);\n                innerElement.hidden = true;\n                innerElement.classList.remove('a-out-animation');\n                console.warn('Animation timeout');\n                resolve();\n            }, 5000); // 5 seconds timeout\n            innerElement.addEventListener('animationend', animationHandler);\n        } else {\n            innerElement.hidden = true;\n            resolve();\n        }\n    });\n\n    return promise;\n}\n\nexport async function aLibEngageElement(originalElement: AngelsSelectorType, switcher: boolean | undefined = undefined) {\n    const innerElement = aLibRequireElement(originalElement);\n    if (switcher === undefined) {\n        switcher = innerElement.hidden;\n    }\n\n    if (switcher) {\n        return await aLibRevealElement(innerElement);\n    } else {\n        return await aLibConcealElement(innerElement);\n    }\n}\n\nexport async function aLibRevealElement(originalElement: AngelsSelectorType) {\n    const innerElement = aLibRequireElement(originalElement);\n    const promise = new Promise<void>((resolve) => {\n\n        if (!innerElement.hidden) {\n            resolve();\n            return;\n        }\n\n        let timeout: NodeJS.Timeout | undefined;\n\n        const animationHandler = () => {\n            clearTimeout(timeout);\n            innerElement.removeEventListener('animationend', animationHandler);\n            resolve();\n        }\n\n        innerElement.hidden = false;\n\n        const animations = innerElement.getAnimations();\n        if (animations.length > 0) {\n            timeout = setTimeout(() => {\n                innerElement.removeEventListener('animationend', animationHandler);\n                console.warn('Animation timeout');\n                resolve();\n            }, 5000); // 5 seconds timeout\n            innerElement.addEventListener('animationend', animationHandler);\n        } else {\n            resolve();\n        }\n    });\n\n    return promise;\n}\n","import { aLibConcealElement, aLibEngageElement, aLibRevealElement } from \"./AngelsFrontAnimationLibrary\";\n\nexport type AngelsFrontElement<THTMLElement extends HTMLElement = HTMLElement> = AngelsFrontElementClass<THTMLElement> & THTMLElement;\n\nexport default class AngelsFrontElementClass<THTMLElement extends HTMLElement = HTMLElement> {\n\n    public originalElement: THTMLElement;\n\n    constructor(element: THTMLElement) {\n\n        this.originalElement = element;\n\n        return new Proxy(this, {\n\n            get(target: any, prop: string | symbol, receiver: any) {\n                if (prop in target) {\n                    // @test AngelsFrontElementClass proxies methods to the original element\n                    return Reflect.get(target, prop);\n                }\n                // @test AngelsFrontElementClass uses methods of the main object\n                const valueOfProperty = Reflect.get(target.originalElement, prop);\n                if (typeof valueOfProperty === 'function') {\n                    return valueOfProperty.bind(target.originalElement);\n                }\n                return valueOfProperty;\n            },\n\n            set(target: any, prop: string | symbol, newValue: any, receiver: any) {\n                if (prop in target.originalElement) {\n                    // @test AngelsFrontElementClass sets properties on the original element\n                    target.originalElement[prop] = newValue;\n                } else {\n                    // @test AngelsFrontElementClass sets properties on the main object\n                    target[prop] = newValue;\n                }\n                return true;\n            }\n        }) as unknown as AngelsFrontElement<THTMLElement>;\n    }\n\n    aConcealElement(): this {\n\n        // @test aConcealElement() calls aLibConcealElement() with the original element\n        aLibConcealElement(this.originalElement);\n\n        // @test aConcealElement() returns this\n        return this;\n    }\n\n    aEngageElement(switcher: boolean | undefined = undefined): this {\n\n        // @test aEngageElement() calls aLibEngageElement() with the original element and the same switcher\n        aLibEngageElement(this.originalElement, switcher);\n\n        // @test aEngageElement() returns this\n        return this;\n    }\n\n    aHideElement(): this {\n\n        // @test aHideElement() sets the hidden property of the element to true\n        this.originalElement.hidden = true;\n\n        // @test aHideElement() returns this\n        return this;\n    }\n\n    aRevealElement(): this {\n\n        // @test aRevealElement() calls aLibRevealElement() with the original element\n        aLibRevealElement(this.originalElement);\n\n        // @test aRevealElement() returns this\n        return this;\n    }\n\n    aShowElement(): this {\n\n        // @test aShowElement() sets the hidden property of the element to false\n        this.originalElement.hidden = false;\n\n        // @test aShowElement() returns this\n        return this;\n    }\n\n    aSetTextContent(content: string): this {\n\n        // @test aSetTextContent() converts non-string content to string before setting\n        const contentToSet = content.toString();\n\n        // @test aSetTextContent() sets originalElement.textContent\n        this.originalElement.textContent = contentToSet;\n\n        // @test aSetTextContent() returns this for chaining\n        return this;\n    }\n\n    aTextContent(): string {\n        if (this.originalElement.textContent === null) {\n            // @test aTextContent() returns empty string if originalElement.textContent is null\n            return ``;\n        }\n\n        // @test aTextContent() returns textContent of originalElement\n        return this.originalElement.textContent;\n    }\n}\n","export default class AngelsFrontMod {\n\n    protected modSubMods: Array<AngelsFrontMod>;\n    public modWaitStartTimeout = 1000;\n\n    constructor() {\n        this.modSubMods = new Array;\n    }\n\n    /**\n     * Starts AngelsFrontMod.\n     */\n    modStart() {\n        this.modInit();\n        this.modBind();\n        this.modLink();\n        this.modRun();\n        setTimeout(() => {\n            this.modWait();\n        }, this.modWaitStartTimeout);\n    }\n\n    /**\n     * Finishes AngelsFrontMod.\n     */\n    modFinish() {\n        this.modDeWait();\n        this.modDeRun();\n        this.modDeLink();\n        this.modDeBind();\n        this.modDeInit();\n    }\n\n    /**\n     * Inits AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modInit() {\n        this.modSubMods.forEach(mod => mod.modInit());\n    }\n\n    /**\n     * Binds AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modBind() {\n        this.modSubMods.forEach(mod => mod.modBind());\n    }\n\n    /**\n     * Links AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modLink() {\n        this.modSubMods.forEach(mod => mod.modLink());\n    }\n\n    /**\n     * Runs AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modRun() {\n        this.modSubMods.forEach(mod => mod.modRun());\n    }\n\n    /**\n     * Waits AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modWait() {\n        this.modSubMods.forEach(mod => mod.modWait());\n    }\n\n    /**\n     * DeInits AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modDeInit() {\n        this.modSubMods.forEach(mod => mod.modDeInit());\n    }\n    /**\n     * DeBinds AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modDeBind() {\n        this.modSubMods.forEach(mod => mod.modDeBind());\n    }\n    /**\n     * DeLinks AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modDeLink() {\n        this.modSubMods.forEach(mod => mod.modDeLink());\n    }\n    /**\n     * DeRuns AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modDeRun() {\n        this.modSubMods.forEach(mod => mod.modDeRun());\n    }\n    /**\n     * DeWaits AngelsFrontMod and its sub-modules AngelsFrontMod.\n     */\n    modDeWait() {\n        this.modSubMods.forEach(mod => mod.modDeWait());\n    }\n\n    modDestructor() {\n        this.modSubMods.forEach(mod => mod.modDestructor());\n    }\n\n    modAddSubMod(mod: null): null;\n    modAddSubMod<TMod extends AngelsFrontMod>(mod: TMod): TMod;\n    modAddSubMod<TMod extends AngelsFrontMod>(mod: TMod | null): TMod | null {\n        if (mod) {\n            this.modSubMods.push(mod);\n            mod.modInit();\n            return mod;\n        }\n        return null;\n    }\n\n    modRequireSubMod<TMod extends AngelsFrontMod>(mod: TMod): TMod {\n        this.modSubMods.push(mod);\n        mod.modInit();\n        return mod;\n    }\n}","import AngelsFrontElementClass, { AngelsFrontElement } from \"./AngelsFrontElement\";\nimport AngelsFrontMod from \"./AngelsFrontMod\";\n\nexport type AngelsFrontWidget<THTMLElement extends HTMLElement = HTMLElement> = AngelsFrontWidgetClass<THTMLElement> & THTMLElement;\n\nexport default interface AngelsFrontWidgetClass<TWidgetHTMLElement extends HTMLElement = HTMLElement> extends HTMLElement { }\n\nexport default class AngelsFrontWidgetClass<TWidgetHTMLElement extends HTMLElement = HTMLElement> extends AngelsFrontMod {\n\n    readonly widElement: AngelsFrontElement<TWidgetHTMLElement>;\n\n    constructor(element: TWidgetHTMLElement) {\n        super();\n        this.widElement = new AngelsFrontElementClass(element) as AngelsFrontElement<TWidgetHTMLElement>;\n        return new Proxy(this, {\n            get(target: any, prop: string | symbol, receiver: any) {\n                if (prop in target) {\n                    const valueOfProperty = target[prop];\n                    if (typeof valueOfProperty === 'function') {\n                        return Reflect.get(target, prop);\n                    }\n                    return valueOfProperty;\n                }\n\n                const valueOfProperty = target.widElement[prop];\n                if (typeof valueOfProperty === 'function') {\n                    return valueOfProperty.bind(target.widElement);\n                }\n                return valueOfProperty;\n            },\n\n            set(target: any, prop: string | symbol, newValue: any, receiver: any) {\n                if (prop in target) {\n                    target[prop] = newValue;\n                } else {\n                    target.widElement[prop] = newValue;\n                }\n                return true;\n            }\n        }) as unknown as AngelsFrontWidget<TWidgetHTMLElement>;\n    }\n\n    widFindElement<THTMLElement extends HTMLElement = HTMLElement>(selector: string): AngelsFrontElement<THTMLElement> | null | null {\n        const findElement = this.widElement.querySelector(selector);\n        if (findElement) {\n            return aFindElement<THTMLElement>(findElement);\n        }\n        return null;\n    }\n\n    widFindElements<THTMLElement extends HTMLElement = HTMLElement>(selector: string): Array<AngelsFrontElement<THTMLElement>> {\n        return Array.from(this.widElement.querySelectorAll(selector))\n            .map(aFindElement);\n    }\n\n    widRequireElement<THTMLElement extends HTMLElement = HTMLElement>(selector: string): AngelsFrontElement<THTMLElement> {\n        const element = this.widElement.querySelector(selector);\n        if (element) {\n            return aFindElement<THTMLElement>(element);\n        }\n        throw Error(`Element '${selector}' is not found.`);\n    }\n}","import AngelsFrontElementClass, { AngelsFrontElement } from \"./AngelsFrontElement\";\nimport { AngelsFrontWidget } from \"./AngelsFrontWidgetClass\";\nimport AngelsFrontWidgetClass from \"./AngelsFrontWidgetClass\";\n\nexport function aLibCreateWidget<THTMLElement extends HTMLElement = HTMLElement>(element: THTMLElement): AngelsFrontWidget<THTMLElement> {\n    return (new AngelsFrontWidgetClass<THTMLElement>(element)) as AngelsFrontWidget<THTMLElement>;\n}\n\nexport function aLibFindElement<THTMLElement extends HTMLElement>(selector: AngelsSelectorType<THTMLElement>): AngelsFrontElement<THTMLElement> | null {\n\n    let element: THTMLElement;\n    if (typeof selector === 'undefined') {\n        return null;\n    } else if (selector === null) {\n        return null;\n    } else if (typeof selector === 'string') {\n        const findElement = document.querySelector<THTMLElement>(selector);\n        if (!findElement) {\n            return null;\n        }\n        element = findElement;\n    } else if (selector instanceof HTMLElement) {\n        element = selector as THTMLElement;\n    } else if (selector instanceof Element) {\n        element = selector as THTMLElement;\n    } else if (selector instanceof AngelsFrontElementClass) {\n        return selector as AngelsFrontElement<THTMLElement>;\n    } else {\n        element = selector;\n    }\n    return new AngelsFrontElementClass(element) as AngelsFrontElement<THTMLElement>;\n}\n\nexport function aLibRequireElement<THTMLElement extends HTMLElement>(selector: AngelsSelectorType): AngelsFrontElement<THTMLElement> {\n    const element = aLibFindElement<THTMLElement>(selector);\n    if (element) {\n        return element;\n    }\n    throw Error(`Element not found by '${selector}' selector.`);\n}\n\nexport function aLibHideElement<THTMLElement extends HTMLElement>(selector: AngelsSelectorType): AngelsFrontElement<THTMLElement> {\n    const element = aLibRequireElement<THTMLElement>(selector);\n    element.hidden = true;\n    return element;\n}\n\nexport function aLibShowElement<THTMLElement extends HTMLElement>(selector: AngelsSelectorType): AngelsFrontElement<THTMLElement> {\n    const element = aLibRequireElement<THTMLElement>(selector);\n    element.hidden = false;\n    return element;\n}\n\nexport function aLibToggleElement(originalElement: AngelsSelectorType, switcher: boolean | undefined = undefined) {\n    const innerElement = aLibRequireElement(originalElement);\n    if (switcher === undefined) {\n        switcher = !innerElement.hidden;\n    }\n    if (switcher) {\n        return aLibShowElement(innerElement);\n    } else {\n        return aLibHideElement(innerElement);\n    }\n}\n"],"mappings":"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","names":["valueOfProperty"]}

package/dist/AngelsFrontElement.d.mts

@@ -0,0 +1,14 @@
+type AngelsFrontElement<THTMLElement extends HTMLElement = HTMLElement> = AngelsFrontElementClass<THTMLElement> & THTMLElement;
+declare class AngelsFrontElementClass<THTMLElement extends HTMLElement = HTMLElement> {
+    originalElement: THTMLElement;
+    constructor(element: THTMLElement);
+    aConcealElement(): this;
+    aEngageElement(switcher?: boolean | undefined): this;
+    aHideElement(): this;
+    aRevealElement(): this;
+    aShowElement(): this;
+    aSetTextContent(content: string): this;
+    aTextContent(): string;
+}
+
+export { type AngelsFrontElement, AngelsFrontElementClass as default };

package/dist/AngelsFrontElement.d.ts

@@ -0,0 +1,14 @@
+type AngelsFrontElement<THTMLElement extends HTMLElement = HTMLElement> = AngelsFrontElementClass<THTMLElement> & THTMLElement;
+declare class AngelsFrontElementClass<THTMLElement extends HTMLElement = HTMLElement> {
+    originalElement: THTMLElement;
+    constructor(element: THTMLElement);
+    aConcealElement(): this;
+    aEngageElement(switcher?: boolean | undefined): this;
+    aHideElement(): this;
+    aRevealElement(): this;
+    aShowElement(): this;
+    aSetTextContent(content: string): this;
+    aTextContent(): string;
+}
+
+export { type AngelsFrontElement, AngelsFrontElementClass as default };

package/dist/{AngelsFrontAnimationLibrary.cjs → AngelsFrontElement.js}

@@ -37,44 +37,51 @@ var __async = (__this, __arguments, generator) => {
   });
 };
 
-// src/AngelsFrontAnimationLibrary.ts
-var AngelsFrontAnimationLibrary_exports = {};
-__export(AngelsFrontAnimationLibrary_exports, {
-  aLibHideElement: () => aLibHideElement,
-  aLibShowElement: () => aLibShowElement,
-  aLibToggleElement: () => aLibToggleElement
+// src/AngelsFrontElement.ts
+var AngelsFrontElement_exports = {};
+__export(AngelsFrontElement_exports, {
+  default: () => AngelsFrontElementClass
 });
-module.exports = __toCommonJS(AngelsFrontAnimationLibrary_exports);
+module.exports = __toCommonJS(AngelsFrontElement_exports);
 
 // src/AngelsFrontDOMLibrary.ts
-function aLibRequireElement(selector) {
+function aLibFindElement(selector) {
   let element;
   if (typeof selector === "undefined") {
-    throw Error(`Selector is undefined.`);
+    return null;
   } else if (selector === null) {
-    throw Error(`Selector is null.`);
+    return null;
   } else if (typeof selector === "string") {
     const findElement = document.querySelector(selector);
     if (!findElement) {
-      throw Error(`Element not found by '${selector}' selector.`);
+      return null;
     }
     element = findElement;
   } else if (selector instanceof HTMLElement) {
     element = selector;
   } else if (selector instanceof Element) {
     element = selector;
+  } else if (selector instanceof AngelsFrontElementClass) {
+    return selector;
   } else {
     element = selector;
   }
-  return element;
+  return new AngelsFrontElementClass(element);
+}
+function aLibRequireElement(selector) {
+  const element = aLibFindElement(selector);
+  if (element) {
+    return element;
+  }
+  throw Error(`Element not found by '${selector}' selector.`);
 }
 
 // src/AngelsFrontAnimationLibrary.ts
-function aLibShowElement(originalElement) {
+function aLibConcealElement(originalElement) {
   return __async(this, null, function* () {
     const innerElement = aLibRequireElement(originalElement);
     const promise = new Promise((resolve) => {
-      if (!innerElement.hidden) {
+      if (innerElement.hidden) {
         resolve();
         return;
       }
@@ -82,42 +89,47 @@ function aLibShowElement(originalElement) {
       const animationHandler = () => {
         clearTimeout(timeout);
         innerElement.removeEventListener("animationend", animationHandler);
+        innerElement.hidden = true;
+        innerElement.classList.remove("a-out-animation");
         resolve();
       };
-      innerElement.hidden = false;
+      innerElement.classList.add("a-out-animation");
       const animations = innerElement.getAnimations();
       if (animations.length > 0) {
         timeout = setTimeout(() => {
           innerElement.removeEventListener("animationend", animationHandler);
+          innerElement.hidden = true;
+          innerElement.classList.remove("a-out-animation");
           console.warn("Animation timeout");
           resolve();
         }, 5e3);
         innerElement.addEventListener("animationend", animationHandler);
       } else {
+        innerElement.hidden = true;
         resolve();
       }
     });
     return promise;
   });
 }
-function aLibToggleElement(originalElement, switcher = void 0) {
+function aLibEngageElement(originalElement, switcher = void 0) {
   return __async(this, null, function* () {
     const innerElement = aLibRequireElement(originalElement);
     if (switcher === void 0) {
-      switcher = !innerElement.hidden;
+      switcher = innerElement.hidden;
     }
     if (switcher) {
-      return yield aLibShowElement(innerElement);
+      return yield aLibRevealElement(innerElement);
     } else {
-      return yield aLibHideElement(innerElement);
+      return yield aLibConcealElement(innerElement);
     }
   });
 }
-function aLibHideElement(originalElement) {
+function aLibRevealElement(originalElement) {
   return __async(this, null, function* () {
     const innerElement = aLibRequireElement(originalElement);
     const promise = new Promise((resolve) => {
-      if (innerElement.hidden) {
+      if (!innerElement.hidden) {
         resolve();
         return;
       }
@@ -125,33 +137,80 @@ function aLibHideElement(originalElement) {
       const animationHandler = () => {
         clearTimeout(timeout);
         innerElement.removeEventListener("animationend", animationHandler);
-        innerElement.hidden = true;
-        innerElement.classList.remove("a-out-animation");
         resolve();
       };
-      innerElement.classList.add("a-out-animation");
+      innerElement.hidden = false;
       const animations = innerElement.getAnimations();
       if (animations.length > 0) {
         timeout = setTimeout(() => {
           innerElement.removeEventListener("animationend", animationHandler);
-          innerElement.hidden = true;
-          innerElement.classList.remove("a-out-animation");
           console.warn("Animation timeout");
           resolve();
         }, 5e3);
         innerElement.addEventListener("animationend", animationHandler);
       } else {
-        innerElement.hidden = true;
         resolve();
       }
     });
     return promise;
   });
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  aLibHideElement,
-  aLibShowElement,
-  aLibToggleElement
-});
-//# sourceMappingURL=AngelsFrontAnimationLibrary.cjs.map
+
+// src/AngelsFrontElement.ts
+var AngelsFrontElementClass = class {
+  constructor(element) {
+    this.originalElement = element;
+    return new Proxy(this, {
+      get(target, prop, receiver) {
+        if (prop in target) {
+          return Reflect.get(target, prop);
+        }
+        const valueOfProperty = Reflect.get(target.originalElement, prop);
+        if (typeof valueOfProperty === "function") {
+          return valueOfProperty.bind(target.originalElement);
+        }
+        return valueOfProperty;
+      },
+      set(target, prop, newValue, receiver) {
+        if (prop in target.originalElement) {
+          target.originalElement[prop] = newValue;
+        } else {
+          target[prop] = newValue;
+        }
+        return true;
+      }
+    });
+  }
+  aConcealElement() {
+    aLibConcealElement(this.originalElement);
+    return this;
+  }
+  aEngageElement(switcher = void 0) {
+    aLibEngageElement(this.originalElement, switcher);
+    return this;
+  }
+  aHideElement() {
+    this.originalElement.hidden = true;
+    return this;
+  }
+  aRevealElement() {
+    aLibRevealElement(this.originalElement);
+    return this;
+  }
+  aShowElement() {
+    this.originalElement.hidden = false;
+    return this;
+  }
+  aSetTextContent(content) {
+    const contentToSet = content.toString();
+    this.originalElement.textContent = contentToSet;
+    return this;
+  }
+  aTextContent() {
+    if (this.originalElement.textContent === null) {
+      return ``;
+    }
+    return this.originalElement.textContent;
+  }
+};
+//# sourceMappingURL=AngelsFrontElement.js.map