@adaas/are-html 0.0.2

package/dist/node/engine/AreHTML.interpreter.js

@@ -0,0 +1,340 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+var aLogger = require('@adaas/a-utils/a-logger');
+var are = require('@adaas/are');
+var AreHTML_instructions_constants = require('@adaas/are-html/instructions/AreHTML.instructions.constants');
+var AreDirective_context = require('@adaas/are-html/directive/AreDirective.context');
+var AreHTML_context = require('./AreHTML.context');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+exports.AreHTMLInterpreter = class AreHTMLInterpreter extends are.AreInterpreter {
+  addElement(declaration, context, logger) {
+    try {
+      const node = declaration.owner;
+      let currentNode = node;
+      let parent = node.parent;
+      while (parent) {
+        if (context.getNodeElement(parent)) {
+          break;
+        }
+        currentNode = parent;
+        parent = parent.parent;
+      }
+      const tag = node.tag;
+      if (parent) {
+        const mountPoint = context.getNodeElement(parent);
+        if (!mountPoint) {
+          throw new are.AreInterpreterError({
+            title: "Mount Point Not Found",
+            description: `Could not find a mount point for the node with id "${node.id}". Ensure that the parent node is rendered before its children, or that a valid root element with the corresponding id exists in the DOM.`
+          });
+        }
+        const element = context.container.createElement(tag);
+        if (mountPoint.nodeType === Node.ELEMENT_NODE) {
+          mountPoint.appendChild(element);
+        } else {
+          mountPoint.parentNode?.insertBefore(element, mountPoint);
+        }
+        context.setInstructionElement(declaration, element);
+      } else {
+        const mountPoint = context.container.getElementById(node.id);
+        if (!mountPoint) {
+          throw new are.AreInterpreterError({
+            title: "Mount Point Not Found",
+            description: `Could not find a mount point for the node with id "${node.id}". Ensure that the parent node is rendered before its children, or that a valid root element with the corresponding id exists in the DOM.`
+          });
+        }
+        const element = context.container.createElement(tag);
+        element.setAttribute("data-aseid", node.aseid.toString());
+        mountPoint.parentNode?.replaceChild(element, mountPoint);
+        context.setInstructionElement(declaration, element);
+      }
+      logger?.debug("green", `Element ${node.aseid.toString()} added to Context:`);
+    } catch (error) {
+      logger?.error(error);
+      throw error;
+    }
+  }
+  removeElement(declaration, context) {
+    const element = context.getElementByInstruction(declaration);
+    if (element && element.parentNode) {
+      element.parentNode.removeChild(element);
+    }
+    context.removeInstructionElement(declaration);
+  }
+  addAttribute(mutation, context, store, syntax, directiveContext, logger) {
+    const element = context.getElementByInstruction(mutation.parent);
+    if (!element) {
+      throw new are.AreInterpreterError({
+        title: "Element Not Found",
+        description: `Could not find a DOM element associated with the instruction ASEID "${mutation.parent}". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`
+      });
+    }
+    const { name, content, evaluate } = mutation.payload;
+    const value = evaluate ? syntax.evaluate(content, store, {
+      ...directiveContext?.scope || {}
+    }) : content;
+    if (mutation.cache === void 0) {
+      const existingValue = element.getAttribute(name);
+      const result = existingValue ? `${existingValue} ${value}` : value;
+      element.setAttribute(name, result);
+      mutation.cache = value;
+    } else {
+      const existingValue = element.getAttribute(name);
+      const existingParts = existingValue ? existingValue.split(/\s+/).filter(Boolean) : [];
+      const oldParts = new Set(mutation.cache.split(/\s+/).filter(Boolean));
+      const newParts = value ? value.split(/\s+/).filter(Boolean) : [];
+      const result = [...existingParts.filter((part) => !oldParts.has(part)), ...newParts].join(" ");
+      element.setAttribute(name, result);
+      mutation.cache = value;
+    }
+  }
+  removeAttribute(mutation, context) {
+    try {
+      const element = context.getElementByInstruction(mutation.parent);
+      if (!element) return;
+      const { name } = mutation.payload;
+      if (name && element.nodeType === Node.ELEMENT_NODE) {
+        element?.removeAttribute(name);
+      }
+    } catch (error) {
+      console.log("Error removing attribute:", error);
+    }
+  }
+  addEventListener(mutation, context, store, syntax, directiveContext, logger) {
+    const element = context.getElementByInstruction(mutation.parent);
+    if (!element) {
+      throw new are.AreInterpreterError({
+        title: "Element Not Found",
+        description: `Could not find a DOM element associated with the instruction ASEID "${mutation.parent}". Ensure that the parent instruction is properly rendered and associated with a DOM element before adding event listeners.`
+      });
+    }
+    const handlers = syntax.extractEmitHandlers(mutation.payload.handler);
+    const handlerScope = {};
+    for (const handler of handlers) {
+      const handlerFn = (...args) => {
+        const event = new are.AreEvent(handler);
+        event.set("args", args);
+        event.set("element", element);
+        event.set("instruction", mutation);
+        mutation.owner.emit(event);
+      };
+      handlerScope[`$${handler}`] = handlerFn;
+    }
+    const callback = (e) => {
+      context.startPerformance("Click");
+      const result = syntax.evaluate(mutation.payload.handler, store, {
+        ...handlerScope,
+        ...directiveContext?.scope || {}
+      });
+      if (typeof result === "function") result(e);
+    };
+    if (callback) {
+      element.addEventListener(mutation.payload.name, callback);
+      context.addListener(element, mutation.payload.name, callback);
+    }
+  }
+  removeEventListener(mutation, context) {
+    const element = context.getElementByInstruction(mutation.parent);
+    if (!element) return;
+    const { name } = mutation.payload;
+    const listener = context.getListener(element, name);
+    if (listener) {
+      element.removeEventListener(name, listener);
+      context.removeListener(element, name);
+    }
+  }
+  addText(declaration, context, store, syntax, directiveContext, logger) {
+    const node = declaration.owner.parent;
+    const { content, evaluate } = declaration.payload;
+    const value = evaluate ? syntax.evaluate(content, store, {
+      ...directiveContext?.scope || {}
+    }) : content;
+    if (!node) {
+      const textNode = context.container.createTextNode(value);
+      context.container.body.appendChild(textNode);
+      context.setInstructionElement(declaration, textNode);
+    } else {
+      const element = context.getNodeElement(node);
+      if (!element) {
+        throw new are.AreInterpreterError({
+          title: "Element Not Found",
+          description: `Could not find a DOM element associated with the instruction ASEID "${declaration.owner.parent.aseid}". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`
+        });
+      }
+      const existingNode = context.getElementByInstruction(declaration);
+      if (existingNode) {
+        existingNode.textContent = value;
+      } else {
+        const textNode = context.container.createTextNode(value);
+        element.appendChild(textNode);
+        context.setInstructionElement(declaration, textNode);
+      }
+    }
+    logger?.debug("green", `Text ${node?.aseid.toString()} added to Context:`);
+  }
+  removeText(declaration, context) {
+    const element = context.getElementByInstruction(declaration);
+    if (!element) return;
+    element.parentNode?.removeChild(element);
+    context.removeInstructionElement(declaration);
+  }
+  addComment(declaration, context, store, syntax, directiveContext, logger) {
+    const node = declaration.owner.parent;
+    const { content, evaluate } = declaration.payload;
+    const value = evaluate ? syntax.evaluate(content, store, {
+      ...directiveContext?.scope || {}
+    }) : content;
+    if (!node) {
+      const commentNode = context.container.createComment(value);
+      context.container.body.appendChild(commentNode);
+      context.setInstructionElement(declaration, commentNode);
+    } else {
+      const element = context.getNodeElement(node);
+      if (!element) {
+        throw new are.AreInterpreterError({
+          title: "Element Not Found",
+          description: `Could not find a DOM element associated with the instruction ASEID "${declaration.owner.parent.aseid}". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`
+        });
+      }
+      const existingNode = context.getElementByInstruction(declaration);
+      if (existingNode) {
+        existingNode.textContent = value;
+      } else {
+        const commentNode = context.container.createComment(value);
+        element.appendChild(commentNode);
+        context.setInstructionElement(declaration, commentNode);
+      }
+    }
+    logger?.debug("green", `Comment ${node?.aseid.toString()} added to Context:`);
+  }
+  removeComment(declaration, context) {
+    const element = context.getElementByInstruction(declaration);
+    if (!element) return;
+    element.parentNode?.removeChild(element);
+    context.removeInstructionElement(declaration);
+  }
+};
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Create an HTML element based on the provided declaration instruction. Handles both root-level mounting and child element creation based on the structural parent hierarchy."
+  }),
+  are.AreInterpreter.Apply(are.AreInstructionDefaultNames.Default),
+  are.AreInterpreter.Apply(AreHTML_instructions_constants.AreHTMLInstructions.AddElement),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(2, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLInterpreter.prototype, "addElement", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Remove an HTML element that was created by a CreateElement declaration. Cleans up the DOM and the context index."
+  }),
+  are.AreInterpreter.Revert(are.AreInstructionDefaultNames.Default),
+  are.AreInterpreter.Revert(AreHTML_instructions_constants.AreHTMLInstructions.AddElement),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext))
+], exports.AreHTMLInterpreter.prototype, "removeElement", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Add an attribute to an HTML element based on the provided mutation instruction."
+  }),
+  are.AreInterpreter.Apply(AreHTML_instructions_constants.AreHTMLInstructions.AddAttribute),
+  are.AreInterpreter.Update(AreHTML_instructions_constants.AreHTMLInstructions.AddAttribute),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(2, aConcept.A_Inject(are.AreStore)),
+  __decorateParam(3, aConcept.A_Inject(are.AreSyntax)),
+  __decorateParam(4, aConcept.A_Inject(AreDirective_context.AreDirectiveContext)),
+  __decorateParam(5, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLInterpreter.prototype, "addAttribute", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Remove an attribute from an HTML element based on the provided mutation instruction."
+  }),
+  are.AreInterpreter.Revert(AreHTML_instructions_constants.AreHTMLInstructions.AddAttribute),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext))
+], exports.AreHTMLInterpreter.prototype, "removeAttribute", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Add an event listener to an HTML element based on the provided mutation instruction."
+  }),
+  are.AreInterpreter.Apply(AreHTML_instructions_constants.AreHTMLInstructions.AddListener),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(2, aConcept.A_Inject(are.AreStore)),
+  __decorateParam(3, aConcept.A_Inject(are.AreSyntax)),
+  __decorateParam(4, aConcept.A_Inject(AreDirective_context.AreDirectiveContext)),
+  __decorateParam(5, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLInterpreter.prototype, "addEventListener", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Remove an event listener from an HTML element based on the provided mutation instruction."
+  }),
+  are.AreInterpreter.Revert(AreHTML_instructions_constants.AreHTMLInstructions.AddListener),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext))
+], exports.AreHTMLInterpreter.prototype, "removeEventListener", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Add text content to an HTML element based on the provided declaration instruction."
+  }),
+  are.AreInterpreter.Apply(AreHTML_instructions_constants.AreHTMLInstructions.AddText),
+  are.AreInterpreter.Update(AreHTML_instructions_constants.AreHTMLInstructions.AddText),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(2, aConcept.A_Inject(are.AreStore)),
+  __decorateParam(3, aConcept.A_Inject(are.AreSyntax)),
+  __decorateParam(4, aConcept.A_Inject(AreDirective_context.AreDirectiveContext)),
+  __decorateParam(5, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLInterpreter.prototype, "addText", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Remove text content from an HTML element based on the provided declaration instruction."
+  }),
+  are.AreInterpreter.Revert(AreHTML_instructions_constants.AreHTMLInstructions.AddText),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext))
+], exports.AreHTMLInterpreter.prototype, "removeText", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Add a comment node to the DOM based on the provided declaration instruction."
+  }),
+  are.AreInterpreter.Apply(AreHTML_instructions_constants.AreHTMLInstructions.AddComment),
+  are.AreInterpreter.Update(AreHTML_instructions_constants.AreHTMLInstructions.AddComment),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(2, aConcept.A_Inject(are.AreStore)),
+  __decorateParam(3, aConcept.A_Inject(are.AreSyntax)),
+  __decorateParam(4, aConcept.A_Inject(AreDirective_context.AreDirectiveContext)),
+  __decorateParam(5, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLInterpreter.prototype, "addComment", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Remove a comment node from the DOM based on the provided declaration instruction."
+  }),
+  are.AreInterpreter.Revert(AreHTML_instructions_constants.AreHTMLInstructions.AddComment),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext))
+], exports.AreHTMLInterpreter.prototype, "removeComment", 1);
+exports.AreHTMLInterpreter = __decorateClass([
+  aFrame.A_Frame.Component({
+    namespace: "A-ARE",
+    name: "AreHTMLInterpreter",
+    description: "AreHTMLInterpreter is a component that serves as a host for rendering AreNodes into HTML. It provides the necessary context and environment for AreNodes to be rendered and interact with the DOM."
+  })
+], exports.AreHTMLInterpreter);
+//# sourceMappingURL=AreHTML.interpreter.js.map
+//# sourceMappingURL=AreHTML.interpreter.js.map

package/dist/node/engine/AreHTML.interpreter.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.interpreter.ts"],"names":["AreHTMLInterpreter","AreInterpreter","AreInterpreterError","AreEvent","A_Frame","AreInstructionDefaultNames","AreHTMLInstructions","A_Caller","AreHTMLEngineContext","A_Logger","AreStore","AreSyntax","AreDirectiveContext"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA0BaA,0BAAA,GAAN,iCAAiCC,kBAAA,CAAe;AAAA,EASnD,UAAA,CACwB,WAAA,EACY,OAAA,EACZ,MAAA,EACtB;AACE,IAAA,IAAI;AACA,MAAA,MAAM,OAAO,WAAA,CAAY,KAAA;AAEzB,MAAA,IAAI,WAAA,GAAuC,IAAA;AAC3C,MAAA,IAAI,SAAkC,IAAA,CAAK,MAAA;AAE3C,MAAA,OAAO,MAAA,EAAQ;AACX,QAAA,IAAI,OAAA,CAAQ,cAAA,CAAe,MAAM,CAAA,EAAG;AAChC,UAAA;AAAA,QACJ;AACA,QAAA,WAAA,GAAc,MAAA;AACd,QAAA,MAAA,GAAS,MAAA,CAAO,MAAA;AAAA,MACpB;AAIA,MAAA,MAAM,MAAM,IAAA,CAAK,GAAA;AAEjB,MAAA,IAAI,MAAA,EAAQ;AAER,QAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,cAAA,CAAe,MAAM,CAAA;AAEhD,QAAA,IAAI,CAAC,UAAA,EAAY;AACb,UAAA,MAAM,IAAIC,uBAAA,CAAoB;AAAA,YAC1B,KAAA,EAAO,uBAAA;AAAA,YACP,WAAA,EAAa,CAAA,mDAAA,EAAsD,IAAA,CAAK,EAAE,CAAA,yIAAA;AAAA,WAC7E,CAAA;AAAA,QACL;AAEA,QAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,SAAA,CAAU,aAAA,CAAc,GAAG,CAAA;AAEnD,QAAA,IAAI,UAAA,CAAW,QAAA,KAAa,IAAA,CAAK,YAAA,EAAc;AAE3C,UAAA,UAAA,CAAW,YAAY,OAAO,CAAA;AAAA,QAClC,CAAA,MAAO;AAGH,UAAA,UAAA,CAAW,UAAA,EAAY,YAAA,CAAa,OAAA,EAAS,UAAU,CAAA;AAAA,QAC3D;AAEA,QAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,OAAO,CAAA;AAAA,MAEtD,CAAA,MAAO;AACH,QAAA,MAAM,UAAA,GAAa,OAAA,CAAQ,SAAA,CAAU,cAAA,CAAe,KAAK,EAAE,CAAA;AAC3D,QAAA,IAAI,CAAC,UAAA,EAAY;AACb,UAAA,MAAM,IAAIA,uBAAA,CAAoB;AAAA,YAC1B,KAAA,EAAO,uBAAA;AAAA,YACP,WAAA,EAAa,CAAA,mDAAA,EAAsD,IAAA,CAAK,EAAE,CAAA,yIAAA;AAAA,WAC7E,CAAA;AAAA,QACL;AAEA,QAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,SAAA,CAAU,aAAA,CAAc,GAAG,CAAA;AAEnD,QAAA,OAAA,CAAQ,YAAA,CAAa,YAAA,EAAc,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA;AAExD,QAAA,UAAA,CAAW,UAAA,EAAY,YAAA,CAAa,OAAA,EAAS,UAAU,CAAA;AAEvD,QAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,OAAO,CAAA;AAAA,MACtD;AAIA,MAAA,MAAA,EAAQ,MAAM,OAAA,EAAS,CAAA,QAAA,EAAW,KAAK,KAAA,CAAM,QAAA,EAAU,CAAA,kBAAA,CAAoB,CAAA;AAAA,IAE/E,SAAS,KAAA,EAAO;AACZ,MAAA,MAAA,EAAQ,MAAM,KAAK,CAAA;AACnB,MAAA,MAAM,KAAA;AAAA,IACV;AAAA,EACJ;AAAA,EAQA,aAAA,CACwB,aACY,OAAA,EAClC;AACE,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,WAAW,CAAA;AAE3D,IAAA,IAAI,OAAA,IAAW,QAAQ,UAAA,EAAY;AAC/B,MAAA,OAAA,CAAQ,UAAA,CAAW,YAAY,OAAO,CAAA;AAAA,IAC1C;AAEA,IAAA,OAAA,CAAQ,yBAAyB,WAAW,CAAA;AAAA,EAChD;AAAA,EAWA,aACwB,QAAA,EACY,OAAA,EACZ,KAAA,EACC,MAAA,EACU,kBAEX,MAAA,EAChB;AACJ,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,QAAA,CAAS,MAAO,CAAA;AAGhE,IAAA,IAAI,CAAC,OAAA,EAAS;AACV,MAAA,MAAM,IAAIA,uBAAA,CAAoB;AAAA,QAC1B,KAAA,EAAO,mBAAA;AAAA,QACP,WAAA,EAAa,CAAA,oEAAA,EAAuE,QAAA,CAAS,MAAM,CAAA,iIAAA;AAAA,OACtG,CAAA;AAAA,IACL;AACA,IAAA,MAAM,EAAE,IAAA,EAAM,OAAA,EAAS,QAAA,KAAa,QAAA,CAAS,OAAA;AAE7C,IAAA,MAAM,KAAA,GAAQ,QAAA,GAAW,MAAA,CAAO,QAAA,CAAS,SAAS,KAAA,EAAO;AAAA,MACrD,GAAI,gBAAA,EAAkB,KAAA,IAAS;AAAC,KACnC,CAAA,GAAI,OAAA;AAML,IAAA,IAAI,QAAA,CAAS,UAAU,MAAA,EAAW;AAE9B,MAAA,MAAM,aAAA,GAAiB,OAAA,CAAwB,YAAA,CAAa,IAAI,CAAA;AAEhE,MAAA,MAAM,SAAU,aAAA,GAAgB,CAAA,EAAG,aAAa,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,KAAA;AAE9D,MAAC,OAAA,CAAwB,YAAA,CAAa,IAAA,EAAM,MAAM,CAAA;AAElD,MAAA,QAAA,CAAS,KAAA,GAAQ,KAAA;AAAA,IAErB,CAAA,MAAO;AAEH,MAAA,MAAM,aAAA,GAAiB,OAAA,CAAwB,YAAA,CAAa,IAAI,CAAA;AAEhE,MAAA,MAAM,aAAA,GAAgB,gBAAgB,aAAA,CAAc,KAAA,CAAM,KAAK,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,GAAI,EAAC;AACpF,MAAA,MAAM,QAAA,GAAW,IAAI,GAAA,CAAK,QAAA,CAAS,KAAA,CAAiB,MAAM,KAAK,CAAA,CAAE,MAAA,CAAO,OAAO,CAAC,CAAA;AAChF,MAAA,MAAM,QAAA,GAAW,QAAQ,KAAA,CAAM,KAAA,CAAM,KAAK,CAAA,CAAE,MAAA,CAAO,OAAO,CAAA,GAAI,EAAC;AAE/D,MAAA,MAAM,SAAS,CAAC,GAAG,aAAA,CAAc,MAAA,CAAO,UAAQ,CAAC,QAAA,CAAS,GAAA,CAAI,IAAI,CAAC,CAAA,EAAG,GAAG,QAAQ,CAAA,CAAE,KAAK,GAAG,CAAA;AAE3F,MAAC,OAAA,CAAwB,YAAA,CAAa,IAAA,EAAM,MAAM,CAAA;AAElD,MAAA,QAAA,CAAS,KAAA,GAAQ,KAAA;AAAA,IACrB;AAAA,EAGJ;AAAA,EAMA,eAAA,CACwB,UACY,OAAA,EAC5B;AACJ,IAAA,IAAI;AACA,MAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,QAAA,CAAS,MAAO,CAAA;AAEhE,MAAA,IAAI,CAAC,OAAA,EAAS;AAEd,MAAA,MAAM,EAAE,IAAA,EAAK,GAAI,QAAA,CAAS,OAAA;AAE1B,MAAA,IAAI,IAAA,IAAQ,OAAA,CAAQ,QAAA,KAAa,IAAA,CAAK,YAAA,EAAc;AAChD,QAAC,OAAA,EAAyB,gBAAgB,IAAI,CAAA;AAAA,MAClD;AAAA,IACJ,SAAS,KAAA,EAAO;AACZ,MAAA,OAAA,CAAQ,GAAA,CAAI,6BAA6B,KAAK,CAAA;AAAA,IAClD;AAAA,EAEJ;AAAA,EAWA,iBACwB,QAAA,EACY,OAAA,EACZ,KAAA,EACC,MAAA,EACU,kBACX,MAAA,EACtB;AAEE,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,QAAA,CAAS,MAAM,CAAA;AAE/D,IAAA,IAAI,CAAC,OAAA,EAAS;AACV,MAAA,MAAM,IAAIA,uBAAA,CAAoB;AAAA,QAC1B,KAAA,EAAO,mBAAA;AAAA,QACP,WAAA,EAAa,CAAA,oEAAA,EAAuE,QAAA,CAAS,MAAM,CAAA,2HAAA;AAAA,OACtG,CAAA;AAAA,IACL;AAeA,IAAA,MAAM,QAAA,GAAW,MAAA,CAAO,mBAAA,CAAoB,QAAA,CAAS,QAAQ,OAAO,CAAA;AACpE,IAAA,MAAM,eAAe,EAAC;AAEtB,IAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC5B,MAAA,MAAM,SAAA,GAAY,IAAI,IAAA,KAAgB;AAClC,QAAA,MAAM,KAAA,GAAQ,IAAIC,YAAA,CAAS,OAAO,CAAA;AAElC,QAAA,KAAA,CAAM,GAAA,CAAI,QAAQ,IAAI,CAAA;AACtB,QAAA,KAAA,CAAM,GAAA,CAAI,WAAW,OAAO,CAAA;AAC5B,QAAA,KAAA,CAAM,GAAA,CAAI,eAAe,QAAQ,CAAA;AAEjC,QAAA,QAAA,CAAS,KAAA,CAAM,KAAK,KAAK,CAAA;AAAA,MAC7B,CAAA;AAEA,MAAA,YAAA,CAAa,CAAA,CAAA,EAAI,OAAO,CAAA,CAAE,CAAA,GAAI,SAAA;AAAA,IAClC;AAEA,IAAA,MAAM,QAAA,GAAW,CAAC,CAAA,KAAa;AAC3B,MAAA,OAAA,CAAQ,iBAAiB,OAAO,CAAA;AAEhC,MAAA,MAAM,SAAS,MAAA,CAAO,QAAA,CAAS,QAAA,CAAS,OAAA,CAAQ,SAAS,KAAA,EAAO;AAAA,QAC5D,GAAG,YAAA;AAAA,QACH,GAAI,gBAAA,EAAkB,KAAA,IAAS;AAAC,OACnC,CAAA;AACD,MAAA,IAAI,OAAO,MAAA,KAAW,UAAA,EAAY,MAAA,CAAO,CAAC,CAAA;AAAA,IAC9C,CAAA;AAGA,IAAA,IAAI,QAAA,EAAU;AACV,MAAA,OAAA,CAAQ,gBAAA,CAAiB,QAAA,CAAS,OAAA,CAAQ,IAAA,EAAM,QAAQ,CAAA;AACxD,MAAA,OAAA,CAAQ,WAAA,CAAY,OAAA,EAAS,QAAA,CAAS,OAAA,CAAQ,MAAM,QAAQ,CAAA;AAAA,IAChE;AAAA,EACJ;AAAA,EAOA,mBAAA,CACwB,UACY,OAAA,EAClC;AACE,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,QAAA,CAAS,MAAM,CAAA;AAE/D,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,MAAM,EAAE,IAAA,EAAK,GAAI,QAAA,CAAS,OAAA;AAE1B,IAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,WAAA,CAAY,OAAA,EAAS,IAAI,CAAA;AAElD,IAAA,IAAI,QAAA,EAAU;AACV,MAAA,OAAA,CAAQ,mBAAA,CAAoB,MAAM,QAAQ,CAAA;AAC1C,MAAA,OAAA,CAAQ,cAAA,CAAe,SAAS,IAAI,CAAA;AAAA,IACxC;AAAA,EACJ;AAAA,EAYA,QACwB,WAAA,EACY,OAAA,EACZ,KAAA,EACC,MAAA,EACU,kBAEX,MAAA,EACtB;AACE,IAAA,MAAM,IAAA,GAAO,YAAY,KAAA,CAAM,MAAA;AAC/B,IAAA,MAAM,EAAE,OAAA,EAAS,QAAA,EAAS,GAAI,WAAA,CAAY,OAAA;AAE1C,IAAA,MAAM,KAAA,GAAQ,QAAA,GAAW,MAAA,CAAO,QAAA,CAAS,SAAS,KAAA,EAAO;AAAA,MACrD,GAAI,gBAAA,EAAkB,KAAA,IAAS;AAAC,KACnC,CAAA,GAAI,OAAA;AAGL,IAAA,IAAI,CAAC,IAAA,EAAM;AACP,MAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,SAAA,CAAU,cAAA,CAAe,KAAK,CAAA;AACvD,MAAA,OAAA,CAAQ,SAAA,CAAU,IAAA,CAAK,WAAA,CAAY,QAAQ,CAAA;AAC3C,MAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,QAAQ,CAAA;AAAA,IAEvD,CAAA,MAAO;AACH,MAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,cAAA,CAAe,IAAI,CAAA;AAE3C,MAAA,IAAI,CAAC,OAAA,EAAS;AACV,QAAA,MAAM,IAAID,uBAAA,CAAoB;AAAA,UAC1B,KAAA,EAAO,mBAAA;AAAA,UACP,WAAA,EAAa,CAAA,oEAAA,EAAuE,WAAA,CAAY,KAAA,CAAM,OAAO,KAAK,CAAA,iIAAA;AAAA,SACrH,CAAA;AAAA,MAEL;AAEA,MAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,uBAAA,CAAwB,WAAW,CAAA;AAEhE,MAAA,IAAI,YAAA,EAAc;AACd,QAAA,YAAA,CAAa,WAAA,GAAc,KAAA;AAAA,MAC/B,CAAA,MAAO;AACH,QAAA,MAAM,QAAA,GAAW,OAAA,CAAQ,SAAA,CAAU,cAAA,CAAe,KAAK,CAAA;AACvD,QAAA,OAAA,CAAQ,YAAY,QAAQ,CAAA;AAE5B,QAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,QAAQ,CAAA;AAAA,MACvD;AAAA,IACJ;AAIA,IAAA,MAAA,EAAQ,MAAM,OAAA,EAAS,CAAA,KAAA,EAAQ,MAAM,KAAA,CAAM,QAAA,EAAU,CAAA,kBAAA,CAAoB,CAAA;AAAA,EAE7E;AAAA,EAOA,UAAA,CACwB,aACY,OAAA,EAClC;AACE,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,WAAW,CAAA;AAE3D,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,OAAA,CAAQ,UAAA,EAAY,YAAY,OAAO,CAAA;AACvC,IAAA,OAAA,CAAQ,yBAAyB,WAAW,CAAA;AAAA,EAChD;AAAA,EASA,WACwB,WAAA,EACY,OAAA,EACZ,KAAA,EACC,MAAA,EACU,kBAEX,MAAA,EACtB;AACE,IAAA,MAAM,IAAA,GAAO,YAAY,KAAA,CAAM,MAAA;AAC/B,IAAA,MAAM,EAAE,OAAA,EAAS,QAAA,EAAS,GAAI,WAAA,CAAY,OAAA;AAE1C,IAAA,MAAM,KAAA,GAAQ,QAAA,GAAW,MAAA,CAAO,QAAA,CAAS,SAAS,KAAA,EAAO;AAAA,MACrD,GAAI,gBAAA,EAAkB,KAAA,IAAS;AAAC,KACnC,CAAA,GAAI,OAAA;AAGL,IAAA,IAAI,CAAC,IAAA,EAAM;AACP,MAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,SAAA,CAAU,aAAA,CAAc,KAAK,CAAA;AACzD,MAAA,OAAA,CAAQ,SAAA,CAAU,IAAA,CAAK,WAAA,CAAY,WAAW,CAAA;AAC9C,MAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,WAAW,CAAA;AAAA,IAE1D,CAAA,MAAO;AACH,MAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,cAAA,CAAe,IAAI,CAAA;AAE3C,MAAA,IAAI,CAAC,OAAA,EAAS;AACV,QAAA,MAAM,IAAIA,uBAAA,CAAoB;AAAA,UAC1B,KAAA,EAAO,mBAAA;AAAA,UACP,WAAA,EAAa,CAAA,oEAAA,EAAuE,WAAA,CAAY,KAAA,CAAM,OAAO,KAAK,CAAA,iIAAA;AAAA,SACrH,CAAA;AAAA,MACL;AAEA,MAAA,MAAM,YAAA,GAAe,OAAA,CAAQ,uBAAA,CAAwB,WAAW,CAAA;AAEhE,MAAA,IAAI,YAAA,EAAc;AACd,QAAA,YAAA,CAAa,WAAA,GAAc,KAAA;AAAA,MAC/B,CAAA,MAAO;AACH,QAAA,MAAM,WAAA,GAAc,OAAA,CAAQ,SAAA,CAAU,aAAA,CAAc,KAAK,CAAA;AACzD,QAAA,OAAA,CAAQ,YAAY,WAAW,CAAA;AAE/B,QAAA,OAAA,CAAQ,qBAAA,CAAsB,aAAa,WAAW,CAAA;AAAA,MAC1D;AAAA,IACJ;AAIA,IAAA,MAAA,EAAQ,MAAM,OAAA,EAAS,CAAA,QAAA,EAAW,MAAM,KAAA,CAAM,QAAA,EAAU,CAAA,kBAAA,CAAoB,CAAA;AAAA,EAChF;AAAA,EAOA,aAAA,CACwB,aACY,OAAA,EAClC;AACE,IAAA,MAAM,OAAA,GAAU,OAAA,CAAQ,uBAAA,CAAwB,WAAW,CAAA;AAE3D,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,OAAA,CAAQ,UAAA,EAAY,YAAY,OAAO,CAAA;AACvC,IAAA,OAAA,CAAQ,yBAAyB,WAAW,CAAA;AAAA,EAChD;AACJ;AA9aI,eAAA,CAAA;AAAA,EALCE,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,KAAA,CAAMI,8BAAA,CAA2B,OAAO,CAAA;AAAA,EACvDJ,kBAAA,CAAe,KAAA,CAAMK,kDAAA,CAAoB,UAAU,CAAA;AAAA,EAE/C,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA,CAAA;AAAA,EAC7B,qCAASC,gBAAQ,CAAA;AAAA,CAAA,EAZbT,0BAAA,CAST,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA;AAiFA,eAAA,CAAA;AAAA,EALCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,MAAA,CAAOI,8BAAA,CAA2B,OAAO,CAAA;AAAA,EACxDJ,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,UAAU,CAAA;AAAA,EAEhD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA;AAAA,CAAA,EA5FzBR,0BAAA,CA0FT,SAAA,EAAA,eAAA,EAAA,CAAA,CAAA;AAsBA,eAAA,CAAA;AAAA,EALCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,KAAA,CAAMK,kDAAA,CAAoB,YAAY,CAAA;AAAA,EACrDL,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,YAAY,CAAA;AAAA,EAElD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA,CAAA;AAAA,EAC7B,qCAASE,YAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,aAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,wCAAmB,CAAA,CAAA;AAAA,EAE5B,qCAASH,gBAAQ,CAAA;AAAA,CAAA,EAvHbT,0BAAA,CAgHT,SAAA,EAAA,cAAA,EAAA,CAAA,CAAA;AA4DA,eAAA,CAAA;AAAA,EAJCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,YAAY,CAAA;AAAA,EAElD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA;AAAA,CAAA,EA9KzBR,0BAAA,CA4KT,SAAA,EAAA,iBAAA,EAAA,CAAA,CAAA;AA6BA,eAAA,CAAA;AAAA,EAJCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,KAAA,CAAMK,kDAAA,CAAoB,WAAW,CAAA;AAAA,EAEhD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA,CAAA;AAAA,EAC7B,qCAASE,YAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,aAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,wCAAmB,CAAA,CAAA;AAAA,EAC5B,qCAASH,gBAAQ,CAAA;AAAA,CAAA,EA/MbT,0BAAA,CAyMT,SAAA,EAAA,kBAAA,EAAA,CAAA,CAAA;AAsEA,eAAA,CAAA;AAAA,EAJCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,WAAW,CAAA;AAAA,EAEjD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA;AAAA,CAAA,EAjRzBR,0BAAA,CA+QT,SAAA,EAAA,qBAAA,EAAA,CAAA,CAAA;AA4BA,eAAA,CAAA;AAAA,EALCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,KAAA,CAAMK,kDAAA,CAAoB,OAAO,CAAA;AAAA,EAChDL,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,OAAO,CAAA;AAAA,EAE7C,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA,CAAA;AAAA,EAC7B,qCAASE,YAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,aAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,wCAAmB,CAAA,CAAA;AAAA,EAE5B,qCAASH,gBAAQ,CAAA;AAAA,CAAA,EAlTbT,0BAAA,CA2ST,SAAA,EAAA,SAAA,EAAA,CAAA,CAAA;AAwDA,eAAA,CAAA;AAAA,EAJCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,OAAO,CAAA;AAAA,EAE7C,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA;AAAA,CAAA,EArWzBR,0BAAA,CAmWT,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA;AAmBA,eAAA,CAAA;AAAA,EALCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,KAAA,CAAMK,kDAAA,CAAoB,UAAU,CAAA;AAAA,EACnDL,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,UAAU,CAAA;AAAA,EAEhD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA,CAAA;AAAA,EAC7B,qCAASE,YAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,aAAS,CAAA,CAAA;AAAA,EAClB,qCAASC,wCAAmB,CAAA,CAAA;AAAA,EAE5B,qCAASH,gBAAQ,CAAA;AAAA,CAAA,EA7XbT,0BAAA,CAsXT,SAAA,EAAA,YAAA,EAAA,CAAA,CAAA;AAsDA,eAAA,CAAA;AAAA,EAJCI,eAAQ,MAAA,CAAO;AAAA,IACZ,WAAA,EAAa;AAAA,GAChB,CAAA;AAAA,EACAH,kBAAA,CAAe,MAAA,CAAOK,kDAAA,CAAoB,UAAU,CAAA;AAAA,EAEhD,qCAASC,iBAAQ,CAAA,CAAA;AAAA,EACjB,qCAASC,oCAAoB,CAAA;AAAA,CAAA,EA9azBR,0BAAA,CA4aT,SAAA,EAAA,eAAA,EAAA,CAAA,CAAA;AA5aSA,0BAAA,GAAN,eAAA,CAAA;AAAA,EALNI,eAAQ,SAAA,CAAU;AAAA,IACf,SAAA,EAAW,OAAA;AAAA,IACX,IAAA,EAAM,oBAAA;AAAA,IACN,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYJ,0BAAA,CAAA","file":"AreHTML.interpreter.js","sourcesContent":["import { A_Caller, A_Inject } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport {\n    AreSyntax, AreStore,\n    AreEvent,\n    AreInstructionDefaultNames,\n    AreInterpreterError,\n    AreInterpreter\n} from \"@adaas/are\";\nimport { AreHTMLInstructions } from \"@adaas/are-html/instructions/AreHTML.instructions.constants\";\nimport { AddAttributeInstruction } from \"@adaas/are-html/instructions/AddAttribute.instruction\";\nimport { AddCommentInstruction } from \"@adaas/are-html/instructions/AddComment.instruction\";\nimport { AddElementInstruction } from \"@adaas/are-html/instructions/AddElement.instruction\";\nimport { AddListenerInstruction } from \"@adaas/are-html/instructions/AddListener.instruction\";\nimport { AddTextInstruction } from \"@adaas/are-html/instructions/AddText.instruction\";\nimport { AreDirectiveContext } from \"@adaas/are-html/directive/AreDirective.context\";\nimport { AreHTMLNode } from \"../lib/AreHTMLNode/AreHTMLNode\";\nimport { AreHTMLEngineContext } from \"./AreHTML.context\";\n\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreHTMLInterpreter',\n    description: 'AreHTMLInterpreter is a component that serves as a host for rendering AreNodes into HTML. It provides the necessary context and environment for AreNodes to be rendered and interact with the DOM.'\n})\nexport class AreHTMLInterpreter extends AreInterpreter {\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── CreateElement — Apply / Revert ───────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n    @A_Frame.Method({\n        description: 'Create an HTML element based on the provided declaration instruction. Handles both root-level mounting and child element creation based on the structural parent hierarchy.'\n    })\n    @AreInterpreter.Apply(AreInstructionDefaultNames.Default)\n    @AreInterpreter.Apply(AreHTMLInstructions.AddElement)\n    addElement(\n        @A_Inject(A_Caller) declaration: AddElementInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n    ) {\n        try {\n            const node = declaration.owner as AreHTMLNode;\n\n            let currentNode: AreHTMLNode | undefined = node;\n            let parent: AreHTMLNode | undefined = node.parent as AreHTMLNode | undefined;\n\n            while (parent) {\n                if (context.getNodeElement(parent)) {\n                    break;\n                }\n                currentNode = parent;\n                parent = parent.parent as AreHTMLNode | undefined;\n            }\n\n\n            // Determine the element tag — components render as a wrapper div\n            const tag = node.tag;\n\n            if (parent) {\n\n                const mountPoint = context.getNodeElement(parent)\n\n                if (!mountPoint) {\n                    throw new AreInterpreterError({\n                        title: 'Mount Point Not Found',\n                        description: `Could not find a mount point for the node with id \"${node.id}\". Ensure that the parent node is rendered before its children, or that a valid root element with the corresponding id exists in the DOM.`\n                    });\n                }\n\n                const element = context.container.createElement(tag);\n\n                if (mountPoint.nodeType === Node.ELEMENT_NODE) {\n                    // parent is a real element — just append\n                    mountPoint.appendChild(element);\n                } else {\n                    // parent is an anchor (comment/text node) — insert before it\n                    // so content always appears before the anchor marker\n                    mountPoint.parentNode?.insertBefore(element, mountPoint);\n                }\n\n                context.setInstructionElement(declaration, element);\n\n            } else {\n                const mountPoint = context.container.getElementById(node.id);\n                if (!mountPoint) {\n                    throw new AreInterpreterError({\n                        title: 'Mount Point Not Found',\n                        description: `Could not find a mount point for the node with id \"${node.id}\". Ensure that the parent node is rendered before its children, or that a valid root element with the corresponding id exists in the DOM.`\n                    });\n                }\n\n                const element = context.container.createElement(tag);\n\n                element.setAttribute('data-aseid', node.aseid.toString());\n\n                mountPoint.parentNode?.replaceChild(element, mountPoint);\n\n                context.setInstructionElement(declaration, element);\n            }\n\n            // Register the element in the context index\n\n            logger?.debug('green', `Element ${node.aseid.toString()} added to Context:`);\n\n        } catch (error) {\n            logger?.error(error);\n            throw error;\n        }\n    }\n\n\n    @A_Frame.Method({\n        description: 'Remove an HTML element that was created by a CreateElement declaration. Cleans up the DOM and the context index.'\n    })\n    @AreInterpreter.Revert(AreInstructionDefaultNames.Default)\n    @AreInterpreter.Revert(AreHTMLInstructions.AddElement)\n    removeElement(\n        @A_Inject(A_Caller) declaration: AddElementInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n    ) {\n        const element = context.getElementByInstruction(declaration);\n\n        if (element && element.parentNode) {\n            element.parentNode.removeChild(element);\n        }\n\n        context.removeInstructionElement(declaration);\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── AddAttribute — Apply / Revert ────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n    @A_Frame.Method({\n        description: 'Add an attribute to an HTML element based on the provided mutation instruction.'\n    })\n    @AreInterpreter.Apply(AreHTMLInstructions.AddAttribute)\n    @AreInterpreter.Update(AreHTMLInstructions.AddAttribute)\n    addAttribute(\n        @A_Inject(A_Caller) mutation: AddAttributeInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        @A_Inject(AreDirectiveContext) directiveContext?: AreDirectiveContext,\n\n        @A_Inject(A_Logger) logger?: A_Logger,\n    ): void {\n        const element = context.getElementByInstruction(mutation.parent!);\n\n\n        if (!element) {\n            throw new AreInterpreterError({\n                title: 'Element Not Found',\n                description: `Could not find a DOM element associated with the instruction ASEID \"${mutation.parent}\". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`\n            });\n        }\n        const { name, content, evaluate } = mutation.payload;\n\n        const value = evaluate ? syntax.evaluate(content, store, {\n            ...(directiveContext?.scope || {})\n        }) : content;\n\n\n        /**\n         * First time\n         */\n        if (mutation.cache === undefined) {\n\n            const existingValue = (element as HTMLElement).getAttribute(name);\n\n            const result = (existingValue ? `${existingValue} ${value}` : value);\n\n            (element as HTMLElement).setAttribute(name, result);\n\n            mutation.cache = value;\n\n        } else {\n\n            const existingValue = (element as HTMLElement).getAttribute(name);\n\n            const existingParts = existingValue ? existingValue.split(/\\s+/).filter(Boolean) : [];\n            const oldParts = new Set((mutation.cache as string).split(/\\s+/).filter(Boolean));\n            const newParts = value ? value.split(/\\s+/).filter(Boolean) : [];\n\n            const result = [...existingParts.filter(part => !oldParts.has(part)), ...newParts].join(' ');\n\n            (element as HTMLElement).setAttribute(name, result);\n\n            mutation.cache = value;\n        }\n\n\n    }\n\n    @A_Frame.Method({\n        description: 'Remove an attribute from an HTML element based on the provided mutation instruction.'\n    })\n    @AreInterpreter.Revert(AreHTMLInstructions.AddAttribute)\n    removeAttribute(\n        @A_Inject(A_Caller) mutation: AddAttributeInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n    ): void {\n        try {\n            const element = context.getElementByInstruction(mutation.parent!);\n\n            if (!element) return;\n\n            const { name } = mutation.payload;\n\n            if (name && element.nodeType === Node.ELEMENT_NODE) {\n                (element as HTMLElement)?.removeAttribute(name);\n            }\n        } catch (error) {\n            console.log('Error removing attribute:', error);\n        }\n\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── addEventListener — Apply / Revert ────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    @A_Frame.Method({\n        description: 'Add an event listener to an HTML element based on the provided mutation instruction.'\n    })\n    @AreInterpreter.Apply(AreHTMLInstructions.AddListener)\n    addEventListener(\n        @A_Inject(A_Caller) mutation: AddListenerInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        @A_Inject(AreDirectiveContext) directiveContext?: AreDirectiveContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n    ) {\n\n        const element = context.getElementByInstruction(mutation.parent);\n\n        if (!element) {\n            throw new AreInterpreterError({\n                title: 'Element Not Found',\n                description: `Could not find a DOM element associated with the instruction ASEID \"${mutation.parent}\". Ensure that the parent instruction is properly rendered and associated with a DOM element before adding event listeners.`\n            });\n        }\n\n        /**\n         * e.g. @click=\"handleClick\" \n         * \n         * e.g. @click=\"handleClick($event, element)\"\n         * \n         * e.g. @click=\"(e)=> user.name ?  handleClick(e) : null\" (with conditional logic)\n         * \n         * e.g. @click=\"(e)=> isValid(user.name) ?  handleClick(e) : null\" (with conditional logic)\n         * \n         * e.g. @click=\"(e)=> isValid(user.name) ?  handleClick(e, format(user.name)) : null\" (with conditional logic)\n         */\n\n\n        const handlers = syntax.extractEmitHandlers(mutation.payload.handler);\n        const handlerScope = {}\n\n        for (const handler of handlers) {\n            const handlerFn = (...args: any[]) => {\n                const event = new AreEvent(handler)\n\n                event.set('args', args);\n                event.set('element', element);\n                event.set('instruction', mutation);\n\n                mutation.owner.emit(event);\n            }\n\n            handlerScope[`$${handler}`] = handlerFn;\n        }\n\n        const callback = (e: Event) => {\n            context.startPerformance('Click')\n\n            const result = syntax.evaluate(mutation.payload.handler, store, {\n                ...handlerScope,\n                ...(directiveContext?.scope || {})\n            });\n            if (typeof result === 'function') result(e);\n        };\n\n\n        if (callback) {\n            element.addEventListener(mutation.payload.name, callback);\n            context.addListener(element, mutation.payload.name, callback);\n        }\n    }\n\n\n    @A_Frame.Method({\n        description: 'Remove an event listener from an HTML element based on the provided mutation instruction.'\n    })\n    @AreInterpreter.Revert(AreHTMLInstructions.AddListener)\n    removeEventListener(\n        @A_Inject(A_Caller) mutation: AddListenerInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n    ) {\n        const element = context.getElementByInstruction(mutation.parent);\n\n        if (!element) return;\n\n        const { name } = mutation.payload;\n\n        const listener = context.getListener(element, name);\n\n        if (listener) {\n            element.removeEventListener(name, listener);\n            context.removeListener(element, name);\n        }\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── AddText — Apply / Revert ─────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    @A_Frame.Method({\n        description: 'Add text content to an HTML element based on the provided declaration instruction.'\n    })\n    @AreInterpreter.Apply(AreHTMLInstructions.AddText)\n    @AreInterpreter.Update(AreHTMLInstructions.AddText)\n    addText(\n        @A_Inject(A_Caller) declaration: AddTextInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        @A_Inject(AreDirectiveContext) directiveContext?: AreDirectiveContext,\n\n        @A_Inject(A_Logger) logger?: A_Logger,\n    ) {\n        const node = declaration.owner.parent;\n        const { content, evaluate } = declaration.payload;\n\n        const value = evaluate ? syntax.evaluate(content, store, {\n            ...(directiveContext?.scope || {})\n        }) : content;\n\n\n        if (!node) {\n            const textNode = context.container.createTextNode(value);\n            context.container.body.appendChild(textNode);\n            context.setInstructionElement(declaration, textNode);\n\n        } else {\n            const element = context.getNodeElement(node);\n\n            if (!element) {\n                throw new AreInterpreterError({\n                    title: 'Element Not Found',\n                    description: `Could not find a DOM element associated with the instruction ASEID \"${declaration.owner.parent.aseid}\". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`\n                });\n\n            }\n\n            const existingNode = context.getElementByInstruction(declaration);\n\n            if (existingNode) {\n                existingNode.textContent = value;\n            } else {\n                const textNode = context.container.createTextNode(value);\n                element.appendChild(textNode);\n\n                context.setInstructionElement(declaration, textNode);\n            }\n        }\n\n\n\n        logger?.debug('green', `Text ${node?.aseid.toString()} added to Context:`);\n\n    }\n\n\n    @A_Frame.Method({\n        description: 'Remove text content from an HTML element based on the provided declaration instruction.'\n    })\n    @AreInterpreter.Revert(AreHTMLInstructions.AddText)\n    removeText(\n        @A_Inject(A_Caller) declaration: AddTextInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n    ) {\n        const element = context.getElementByInstruction(declaration);\n\n        if (!element) return;\n\n        element.parentNode?.removeChild(element);\n        context.removeInstructionElement(declaration);\n    }\n\n\n\n    @A_Frame.Method({\n        description: 'Add a comment node to the DOM based on the provided declaration instruction.'\n    })\n    @AreInterpreter.Apply(AreHTMLInstructions.AddComment)\n    @AreInterpreter.Update(AreHTMLInstructions.AddComment)\n    addComment(\n        @A_Inject(A_Caller) declaration: AddCommentInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        @A_Inject(AreDirectiveContext) directiveContext?: AreDirectiveContext,\n\n        @A_Inject(A_Logger) logger?: A_Logger,\n    ) {\n        const node = declaration.owner.parent;\n        const { content, evaluate } = declaration.payload;\n\n        const value = evaluate ? syntax.evaluate(content, store, {\n            ...(directiveContext?.scope || {})\n        }) : content;\n\n\n        if (!node) {\n            const commentNode = context.container.createComment(value);\n            context.container.body.appendChild(commentNode);\n            context.setInstructionElement(declaration, commentNode);\n\n        } else {\n            const element = context.getNodeElement(node);\n\n            if (!element) {\n                throw new AreInterpreterError({\n                    title: 'Element Not Found',\n                    description: `Could not find a DOM element associated with the instruction ASEID \"${declaration.owner.parent.aseid}\". Ensure that the parent instruction is properly rendered and associated with a DOM element before applying attribute mutations.`\n                });\n            }\n\n            const existingNode = context.getElementByInstruction(declaration);\n\n            if (existingNode) {\n                existingNode.textContent = value;\n            } else {\n                const commentNode = context.container.createComment(value);\n                element.appendChild(commentNode);\n\n                context.setInstructionElement(declaration, commentNode);\n            }\n        }\n\n\n\n        logger?.debug('green', `Comment ${node?.aseid.toString()} added to Context:`);\n    }\n\n\n    @A_Frame.Method({\n        description: 'Remove a comment node from the DOM based on the provided declaration instruction.'\n    })\n    @AreInterpreter.Revert(AreHTMLInstructions.AddComment)\n    removeComment(\n        @A_Inject(A_Caller) declaration: AddCommentInstruction,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n    ) {\n        const element = context.getElementByInstruction(declaration);\n\n        if (!element) return;\n\n        element.parentNode?.removeChild(element);\n        context.removeInstructionElement(declaration);\n    }\n}"]}