@adaas/are-html 0.0.2

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

@@ -0,0 +1,330 @@
+import { __decorateClass, __decorateParam } from '../chunk-EQQGB2QZ.mjs';
+import { A_Inject, A_Caller } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { AreInterpreter, AreInstructionDefaultNames, AreStore, AreSyntax, AreInterpreterError, AreEvent } from '@adaas/are';
+import { AreHTMLInstructions } from '@adaas/are-html/instructions/AreHTML.instructions.constants';
+import { AreDirectiveContext } from '@adaas/are-html/directive/AreDirective.context';
+import { AreHTMLEngineContext } from './AreHTML.context';
+
+let AreHTMLInterpreter = class extends 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 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 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 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 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 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 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 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([
+  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."
+  }),
+  AreInterpreter.Apply(AreInstructionDefaultNames.Default),
+  AreInterpreter.Apply(AreHTMLInstructions.AddElement),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(2, A_Inject(A_Logger))
+], AreHTMLInterpreter.prototype, "addElement", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Remove an HTML element that was created by a CreateElement declaration. Cleans up the DOM and the context index."
+  }),
+  AreInterpreter.Revert(AreInstructionDefaultNames.Default),
+  AreInterpreter.Revert(AreHTMLInstructions.AddElement),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext))
+], AreHTMLInterpreter.prototype, "removeElement", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Add an attribute to an HTML element based on the provided mutation instruction."
+  }),
+  AreInterpreter.Apply(AreHTMLInstructions.AddAttribute),
+  AreInterpreter.Update(AreHTMLInstructions.AddAttribute),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(2, A_Inject(AreStore)),
+  __decorateParam(3, A_Inject(AreSyntax)),
+  __decorateParam(4, A_Inject(AreDirectiveContext)),
+  __decorateParam(5, A_Inject(A_Logger))
+], AreHTMLInterpreter.prototype, "addAttribute", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Remove an attribute from an HTML element based on the provided mutation instruction."
+  }),
+  AreInterpreter.Revert(AreHTMLInstructions.AddAttribute),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext))
+], AreHTMLInterpreter.prototype, "removeAttribute", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Add an event listener to an HTML element based on the provided mutation instruction."
+  }),
+  AreInterpreter.Apply(AreHTMLInstructions.AddListener),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(2, A_Inject(AreStore)),
+  __decorateParam(3, A_Inject(AreSyntax)),
+  __decorateParam(4, A_Inject(AreDirectiveContext)),
+  __decorateParam(5, A_Inject(A_Logger))
+], AreHTMLInterpreter.prototype, "addEventListener", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Remove an event listener from an HTML element based on the provided mutation instruction."
+  }),
+  AreInterpreter.Revert(AreHTMLInstructions.AddListener),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext))
+], AreHTMLInterpreter.prototype, "removeEventListener", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Add text content to an HTML element based on the provided declaration instruction."
+  }),
+  AreInterpreter.Apply(AreHTMLInstructions.AddText),
+  AreInterpreter.Update(AreHTMLInstructions.AddText),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(2, A_Inject(AreStore)),
+  __decorateParam(3, A_Inject(AreSyntax)),
+  __decorateParam(4, A_Inject(AreDirectiveContext)),
+  __decorateParam(5, A_Inject(A_Logger))
+], AreHTMLInterpreter.prototype, "addText", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Remove text content from an HTML element based on the provided declaration instruction."
+  }),
+  AreInterpreter.Revert(AreHTMLInstructions.AddText),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext))
+], AreHTMLInterpreter.prototype, "removeText", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Add a comment node to the DOM based on the provided declaration instruction."
+  }),
+  AreInterpreter.Apply(AreHTMLInstructions.AddComment),
+  AreInterpreter.Update(AreHTMLInstructions.AddComment),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(2, A_Inject(AreStore)),
+  __decorateParam(3, A_Inject(AreSyntax)),
+  __decorateParam(4, A_Inject(AreDirectiveContext)),
+  __decorateParam(5, A_Inject(A_Logger))
+], AreHTMLInterpreter.prototype, "addComment", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Remove a comment node from the DOM based on the provided declaration instruction."
+  }),
+  AreInterpreter.Revert(AreHTMLInstructions.AddComment),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(AreHTMLEngineContext))
+], AreHTMLInterpreter.prototype, "removeComment", 1);
+AreHTMLInterpreter = __decorateClass([
+  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."
+  })
+], AreHTMLInterpreter);
+
+export { AreHTMLInterpreter };
+//# sourceMappingURL=AreHTML.interpreter.mjs.map
+//# sourceMappingURL=AreHTML.interpreter.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.interpreter.ts"],"names":[],"mappings":"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","file":"AreHTML.interpreter.mjs","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}"]}

package/dist/node/engine/AreHTML.lifecycle.d.mts

@@ -0,0 +1,17 @@
+import { A_Scope, A_Feature } from '@adaas/a-concept';
+import { AreLifecycle, AreSignalsContext } from '@adaas/are';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { e as AreHTMLNode, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+import { AreHTMLEngineContext } from './AreHTML.context.mjs';
+import '../lib/AreStyle/AreStyle.context.mjs';
+import './AreHTML.types.mjs';
+
+declare class AreHTMLLifecycle extends AreLifecycle {
+    initComponent(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    initRoot(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, signalsContext?: AreSignalsContext, logger?: A_Logger, ...args: any[]): void;
+    initText(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    initInterpolation(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    updateDirectiveAttribute(directive: AreDirectiveAttribute, scope: A_Scope, feature: A_Feature, logger?: A_Logger, ...args: any[]): void;
+}
+
+export { AreHTMLLifecycle };

package/dist/node/engine/AreHTML.lifecycle.d.ts

@@ -0,0 +1,17 @@
+import { A_Scope, A_Feature } from '@adaas/a-concept';
+import { AreLifecycle, AreSignalsContext } from '@adaas/are';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { e as AreHTMLNode, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+import { AreHTMLEngineContext } from './AreHTML.context.js';
+import '../lib/AreStyle/AreStyle.context.js';
+import './AreHTML.types.js';
+
+declare class AreHTMLLifecycle extends AreLifecycle {
+    initComponent(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    initRoot(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, signalsContext?: AreSignalsContext, logger?: A_Logger, ...args: any[]): void;
+    initText(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    initInterpolation(node: AreHTMLNode, scope: A_Scope, context: AreHTMLEngineContext, logger?: A_Logger, ...args: any[]): void;
+    updateDirectiveAttribute(directive: AreDirectiveAttribute, scope: A_Scope, feature: A_Feature, logger?: A_Logger, ...args: any[]): void;
+}
+
+export { AreHTMLLifecycle };

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

@@ -0,0 +1,91 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var are = require('@adaas/are');
+var aLogger = require('@adaas/a-utils/a-logger');
+var AreComponent = require('@adaas/are-html/nodes/AreComponent');
+var AreRoot = require('@adaas/are-html/nodes/AreRoot');
+var AreInterpolation = require('@adaas/are-html/nodes/AreInterpolation');
+var AreText = require('@adaas/are-html/nodes/AreText');
+var AreDirective_attribute = require('@adaas/are-html/attributes/AreDirective.attribute');
+var AreDirective_constants = require('@adaas/are-html/directive/AreDirective.constants');
+var AreHTML_context = require('./AreHTML.context');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = __getOwnPropDesc(target, key) ;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(target, key, result) ) || result;
+  if (result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+class AreHTMLLifecycle extends are.AreLifecycle {
+  initComponent(node, scope, context, logger, ...args) {
+    super.init(node, scope, context, logger, ...args);
+  }
+  initRoot(node, scope, context, signalsContext, logger, ...args) {
+    signalsContext?.subscribe(node);
+    super.init(node, scope, context, logger, ...args);
+  }
+  initText(node, scope, context, logger, ...args) {
+    const scene = new are.AreScene(node.aseid);
+    scope.register(scene);
+  }
+  initInterpolation(node, scope, context, logger, ...args) {
+    const scene = new are.AreScene(node.aseid);
+    scope.register(scene);
+  }
+  updateDirectiveAttribute(directive, scope, feature, logger, ...args) {
+    if (directive.component) {
+      feature.chain(directive.component, AreDirective_constants.AreDirectiveFeatures.Update, directive.owner.scope);
+    } else {
+      logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named "AreDirective${aConcept.A_FormatterHelper.toPascalCase(directive.name)}" to handle this directive.`);
+    }
+  }
+}
+__decorateClass([
+  are.AreLifecycle.Init(AreComponent.AreComponentNode),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Scope)),
+  __decorateParam(2, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(3, aConcept.A_Inject(aLogger.A_Logger))
+], AreHTMLLifecycle.prototype, "initComponent");
+__decorateClass([
+  are.AreLifecycle.Init(AreRoot.AreRootNode),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Scope)),
+  __decorateParam(2, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(3, aConcept.A_Inject(are.AreSignalsContext)),
+  __decorateParam(4, aConcept.A_Inject(aLogger.A_Logger))
+], AreHTMLLifecycle.prototype, "initRoot");
+__decorateClass([
+  are.AreLifecycle.Init(AreText.AreText),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Scope)),
+  __decorateParam(2, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(3, aConcept.A_Inject(aLogger.A_Logger))
+], AreHTMLLifecycle.prototype, "initText");
+__decorateClass([
+  are.AreLifecycle.Init(AreInterpolation.AreInterpolation),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Scope)),
+  __decorateParam(2, aConcept.A_Inject(AreHTML_context.AreHTMLEngineContext)),
+  __decorateParam(3, aConcept.A_Inject(aLogger.A_Logger))
+], AreHTMLLifecycle.prototype, "initInterpolation");
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    name: are.AreAttributeFeatures.Update,
+    scope: [AreDirective_attribute.AreDirectiveAttribute]
+  }),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(aConcept.A_Scope)),
+  __decorateParam(2, aConcept.A_Inject(aConcept.A_Feature)),
+  __decorateParam(3, aConcept.A_Inject(aLogger.A_Logger))
+], AreHTMLLifecycle.prototype, "updateDirectiveAttribute");
+
+exports.AreHTMLLifecycle = AreHTMLLifecycle;
+//# sourceMappingURL=AreHTML.lifecycle.js.map
+//# sourceMappingURL=AreHTML.lifecycle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.lifecycle.ts"],"names":["AreLifecycle","AreScene","AreDirectiveFeatures","A_FormatterHelper","AreComponentNode","A_Caller","A_Scope","AreHTMLEngineContext","A_Logger","AreRootNode","AreSignalsContext","AreText","AreInterpolation","A_Feature","AreAttributeFeatures","AreDirectiveAttribute"],"mappings":"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","file":"AreHTML.lifecycle.js","sourcesContent":["import { A_Caller, A_Feature, A_FormatterHelper, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { AreLifecycle, AreScene, AreAttributeFeatures, AreSignalsContext } from \"@adaas/are\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreComponentNode } from \"@adaas/are-html/nodes/AreComponent\";\nimport { AreRootNode } from \"@adaas/are-html/nodes/AreRoot\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreDirectiveFeatures } from \"@adaas/are-html/directive/AreDirective.constants\";\nimport { AreHTMLEngineContext } from \"./AreHTML.context\";\nimport { AreHTMLNode } from \"../lib/AreHTMLNode/AreHTMLNode\";\n\n\nexport class AreHTMLLifecycle extends AreLifecycle {\n\n    @AreLifecycle.Init(AreComponentNode)\n    initComponent(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        super.init(node, scope, context, logger, ...args);\n    }\n\n\n    @AreLifecycle.Init(AreRootNode)\n    initRoot(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        signalsContext?.subscribe(node);\n        super.init(node, scope, context, logger, ...args);\n    }\n\n\n    @AreLifecycle.Init(AreText)\n    initText(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        const scene = new AreScene(node.aseid);\n\n        scope.register(scene);\n    }\n\n\n    @AreLifecycle.Init(AreInterpolation)\n    initInterpolation(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        const scene = new AreScene(node.aseid);\n\n        scope.register(scene);\n    }\n\n\n\n\n    @A_Feature.Extend({\n        name: AreAttributeFeatures.Update,\n        scope: [AreDirectiveAttribute],\n    })\n    updateDirectiveAttribute(\n        @A_Inject(A_Caller) directive: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Feature) feature: A_Feature,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        /**\n         * 3. If the attribute is a directive, then we should find a component that is responsible for\n         *    the directive compiling logic, and call it. \n         *    In case component is not found we just want to log a warning, \n         *    since the directive may be handled by some parent component or simply is a mistake in the template.\n         */\n        if (directive.component) {\n            feature.chain(directive.component, AreDirectiveFeatures.Update, directive.owner.scope);\n        } else {\n            logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named \"AreDirective${A_FormatterHelper.toPascalCase(directive.name)}\" to handle this directive.`);\n        }\n    }\n\n}"]}

package/dist/node/engine/AreHTML.lifecycle.mjs

@@ -0,0 +1,79 @@
+import { __decorateClass, __decorateParam } from '../chunk-EQQGB2QZ.mjs';
+import { A_Inject, A_Caller, A_Scope, A_Feature, A_FormatterHelper } from '@adaas/a-concept';
+import { AreLifecycle, AreSignalsContext, AreAttributeFeatures, AreScene } from '@adaas/are';
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { AreComponentNode } from '@adaas/are-html/nodes/AreComponent';
+import { AreRootNode } from '@adaas/are-html/nodes/AreRoot';
+import { AreInterpolation } from '@adaas/are-html/nodes/AreInterpolation';
+import { AreText } from '@adaas/are-html/nodes/AreText';
+import { AreDirectiveAttribute } from '@adaas/are-html/attributes/AreDirective.attribute';
+import { AreDirectiveFeatures } from '@adaas/are-html/directive/AreDirective.constants';
+import { AreHTMLEngineContext } from './AreHTML.context';
+
+class AreHTMLLifecycle extends AreLifecycle {
+  initComponent(node, scope, context, logger, ...args) {
+    super.init(node, scope, context, logger, ...args);
+  }
+  initRoot(node, scope, context, signalsContext, logger, ...args) {
+    signalsContext?.subscribe(node);
+    super.init(node, scope, context, logger, ...args);
+  }
+  initText(node, scope, context, logger, ...args) {
+    const scene = new AreScene(node.aseid);
+    scope.register(scene);
+  }
+  initInterpolation(node, scope, context, logger, ...args) {
+    const scene = new AreScene(node.aseid);
+    scope.register(scene);
+  }
+  updateDirectiveAttribute(directive, scope, feature, logger, ...args) {
+    if (directive.component) {
+      feature.chain(directive.component, AreDirectiveFeatures.Update, directive.owner.scope);
+    } else {
+      logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named "AreDirective${A_FormatterHelper.toPascalCase(directive.name)}" to handle this directive.`);
+    }
+  }
+}
+__decorateClass([
+  AreLifecycle.Init(AreComponentNode),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(3, A_Inject(A_Logger))
+], AreHTMLLifecycle.prototype, "initComponent", 1);
+__decorateClass([
+  AreLifecycle.Init(AreRootNode),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(3, A_Inject(AreSignalsContext)),
+  __decorateParam(4, A_Inject(A_Logger))
+], AreHTMLLifecycle.prototype, "initRoot", 1);
+__decorateClass([
+  AreLifecycle.Init(AreText),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(3, A_Inject(A_Logger))
+], AreHTMLLifecycle.prototype, "initText", 1);
+__decorateClass([
+  AreLifecycle.Init(AreInterpolation),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Inject(AreHTMLEngineContext)),
+  __decorateParam(3, A_Inject(A_Logger))
+], AreHTMLLifecycle.prototype, "initInterpolation", 1);
+__decorateClass([
+  A_Feature.Extend({
+    name: AreAttributeFeatures.Update,
+    scope: [AreDirectiveAttribute]
+  }),
+  __decorateParam(0, A_Inject(A_Caller)),
+  __decorateParam(1, A_Inject(A_Scope)),
+  __decorateParam(2, A_Inject(A_Feature)),
+  __decorateParam(3, A_Inject(A_Logger))
+], AreHTMLLifecycle.prototype, "updateDirectiveAttribute", 1);
+
+export { AreHTMLLifecycle };
+//# sourceMappingURL=AreHTML.lifecycle.mjs.map
+//# sourceMappingURL=AreHTML.lifecycle.mjs.map

package/dist/node/engine/AreHTML.lifecycle.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.lifecycle.ts"],"names":[],"mappings":"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","file":"AreHTML.lifecycle.mjs","sourcesContent":["import { A_Caller, A_Feature, A_FormatterHelper, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { AreLifecycle, AreScene, AreAttributeFeatures, AreSignalsContext } from \"@adaas/are\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreComponentNode } from \"@adaas/are-html/nodes/AreComponent\";\nimport { AreRootNode } from \"@adaas/are-html/nodes/AreRoot\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreDirectiveFeatures } from \"@adaas/are-html/directive/AreDirective.constants\";\nimport { AreHTMLEngineContext } from \"./AreHTML.context\";\nimport { AreHTMLNode } from \"../lib/AreHTMLNode/AreHTMLNode\";\n\n\nexport class AreHTMLLifecycle extends AreLifecycle {\n\n    @AreLifecycle.Init(AreComponentNode)\n    initComponent(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        super.init(node, scope, context, logger, ...args);\n    }\n\n\n    @AreLifecycle.Init(AreRootNode)\n    initRoot(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        signalsContext?.subscribe(node);\n        super.init(node, scope, context, logger, ...args);\n    }\n\n\n    @AreLifecycle.Init(AreText)\n    initText(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        const scene = new AreScene(node.aseid);\n\n        scope.register(scene);\n    }\n\n\n    @AreLifecycle.Init(AreInterpolation)\n    initInterpolation(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreHTMLEngineContext) context: AreHTMLEngineContext,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        const scene = new AreScene(node.aseid);\n\n        scope.register(scene);\n    }\n\n\n\n\n    @A_Feature.Extend({\n        name: AreAttributeFeatures.Update,\n        scope: [AreDirectiveAttribute],\n    })\n    updateDirectiveAttribute(\n        @A_Inject(A_Caller) directive: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(A_Feature) feature: A_Feature,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        /**\n         * 3. If the attribute is a directive, then we should find a component that is responsible for\n         *    the directive compiling logic, and call it. \n         *    In case component is not found we just want to log a warning, \n         *    since the directive may be handled by some parent component or simply is a mistake in the template.\n         */\n        if (directive.component) {\n            feature.chain(directive.component, AreDirectiveFeatures.Update, directive.owner.scope);\n        } else {\n            logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named \"AreDirective${A_FormatterHelper.toPascalCase(directive.name)}\" to handle this directive.`);\n        }\n    }\n\n}"]}