@adaas/are-html 0.0.2

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

@@ -0,0 +1,191 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+var aService = require('@adaas/a-utils/a-service');
+var are = require('@adaas/are');
+var interpreter = require('@adaas/are-html/interpreter');
+var AreHTML_context = require('./AreHTML.context');
+var AreInterpolation = require('@adaas/are-html/nodes/AreInterpolation');
+var AreText = require('@adaas/are-html/nodes/AreText');
+var AreComment = require('@adaas/are-html/nodes/AreComment');
+var AreComponent = require('@adaas/are-html/nodes/AreComponent');
+var tokenizer = require('@adaas/are-html/tokenizer');
+var AreRoot = require('@adaas/are-html/nodes/AreRoot');
+var lifecycle = require('@adaas/are-html/lifecycle');
+var transformer = require('@adaas/are-html/transformer');
+var AreHTML_compiler = require('./AreHTML.compiler');
+
+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.AreHTMLEngine = class AreHTMLEngine extends are.AreEngine {
+  get DefaultSyntax() {
+    return new are.AreSyntax({
+      trimWhitespace: true,
+      strictMode: true,
+      rules: [
+        // HTML comments
+        {
+          opening: "<!--",
+          closing: "-->",
+          component: AreComment.AreComment,
+          priority: 10,
+          nested: false,
+          extract: (raw) => ({ content: raw.slice(4, -3).trim() })
+        },
+        // interpolations
+        {
+          opening: "{{",
+          closing: "}}",
+          component: AreInterpolation.AreInterpolation,
+          priority: 9,
+          nested: false,
+          extract: (_, match) => ({ key: match.content })
+        },
+        // are-root — matched before generic elements, produces AreRootNode
+        {
+          matcher: this.rootElementMatcher.bind(this),
+          component: AreRoot.AreRootNode,
+          priority: 5
+        },
+        // generic HTML elements
+        {
+          matcher: this.htmlElementMatcher.bind(this),
+          component: AreComponent.AreComponentNode,
+          priority: 4
+        },
+        // plain text fallback
+        {
+          component: AreText.AreText,
+          priority: 0
+        }
+      ]
+    });
+  }
+  async init(scope) {
+    this.package(scope, {
+      context: new AreHTML_context.AreHTMLEngineContext({}),
+      syntax: this.DefaultSyntax,
+      compiler: AreHTML_compiler.AreHTMLCompiler,
+      interpreter: interpreter.AreHTMLInterpreter,
+      tokenizer: tokenizer.AreHTMLTokenizer,
+      lifecycle: lifecycle.AreHTMLLifecycle,
+      transformer: transformer.AreHTMLTransformer
+    });
+  }
+  rootElementMatcher(source, from, to, build) {
+    const rootTag = "are-root";
+    const tagStart = source.indexOf("<", from);
+    if (tagStart === -1 || tagStart >= to) return null;
+    const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/);
+    if (!tagNameMatch || tagNameMatch[1].toLowerCase() !== rootTag) return null;
+    return this.htmlElementMatcher(source, from, to, build);
+  }
+  htmlElementMatcher(source, from, to, build) {
+    let index = from;
+    while (index < to) {
+      const tagStart = source.indexOf("<", index);
+      if (tagStart === -1 || tagStart >= to) return null;
+      if (source.startsWith("<!--", tagStart)) {
+        index = tagStart + 1;
+        continue;
+      }
+      if (source[tagStart + 1] === "/") {
+        index = tagStart + 1;
+        continue;
+      }
+      if (source[tagStart + 1] === "!" || source[tagStart + 1] === "?") {
+        index = tagStart + 1;
+        continue;
+      }
+      const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/);
+      if (!tagNameMatch) {
+        index = tagStart + 1;
+        continue;
+      }
+      const tagName = tagNameMatch[1];
+      const openingTagEnd = exports.AreHTMLEngine.findTagClose(source, tagStart);
+      if (openingTagEnd === -1) return null;
+      const openingTagStr = source.slice(tagStart, openingTagEnd + 1);
+      const idMatch = openingTagStr.match(/\bid=["']([^"']*)["']/);
+      const id = idMatch ? idMatch[1] : void 0;
+      if (source[openingTagEnd - 1] === "/") {
+        const raw = source.slice(tagStart, openingTagEnd + 1);
+        const content2 = source.slice(tagStart + tagNameMatch[0].length, openingTagEnd - 1);
+        const match2 = build(raw, content2, tagStart, "/>");
+        match2.payload = { entity: tagName, selfClose: true, id };
+        return match2;
+      }
+      const closingTag = `</${tagName}>`;
+      let level = 0;
+      let searchIndex = openingTagEnd + 1;
+      let closingStart = -1;
+      while (searchIndex < to) {
+        const nextOpen = source.indexOf(`<${tagName}`, searchIndex);
+        const nextClose = source.indexOf(closingTag, searchIndex);
+        if (nextClose === -1) break;
+        if (nextOpen !== -1 && nextOpen < nextClose) {
+          const charAfter = source[nextOpen + tagName.length + 1];
+          if (charAfter === " " || charAfter === ">" || charAfter === "/") {
+            level++;
+            searchIndex = nextOpen + tagName.length + 1;
+            continue;
+          }
+        }
+        if (level === 0) {
+          closingStart = nextClose;
+          break;
+        }
+        level--;
+        searchIndex = nextClose + closingTag.length;
+      }
+      if (closingStart === -1) return null;
+      const fullTag = source.slice(tagStart, closingStart + closingTag.length);
+      const content = source.slice(openingTagEnd + 1, closingStart);
+      const match = build(fullTag, content, tagStart, closingTag);
+      match.payload = { entity: tagName, selfClose: false, id };
+      return match;
+    }
+    return null;
+  }
+  /**
+   * Find the index of the closing `>` of an opening tag, skipping over
+   * `>` characters that appear inside quoted attribute values.
+   */
+  static findTagClose(source, from) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = from; i < source.length; i++) {
+      const ch = source[i];
+      if (ch === '"' && !inSingle) inDouble = !inDouble;
+      else if (ch === "'" && !inDouble) inSingle = !inSingle;
+      else if (ch === ">" && !inSingle && !inDouble) return i;
+    }
+    return -1;
+  }
+};
+__decorateClass([
+  aConcept.A_Feature.Extend({
+    name: aService.A_ServiceFeatures.onBeforeLoad,
+    before: /.*/
+  }),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Scope))
+], exports.AreHTMLEngine.prototype, "init", 1);
+exports.AreHTMLEngine = __decorateClass([
+  aFrame.A_Frame.Component({
+    namespace: "A-ARE",
+    name: "AreHTMLEngine",
+    description: "HTML Rendering Engine for A-Concept Rendering Engine (ARE), responsible for processing and rendering HTML templates within the ARE framework."
+  })
+], exports.AreHTMLEngine);
+//# sourceMappingURL=AreHTML.engine.js.map
+//# sourceMappingURL=AreHTML.engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.engine.ts"],"names":["AreHTMLEngine","AreEngine","AreSyntax","AreComment","AreInterpolation","AreRootNode","AreComponentNode","AreText","AreHTMLEngineContext","AreHTMLCompiler","AreHTMLInterpreter","AreHTMLTokenizer","AreHTMLLifecycle","AreHTMLTransformer","content","match","A_Feature","A_ServiceFeatures","A_Scope","A_Frame"],"mappings":"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","file":"AreHTML.engine.js","sourcesContent":["import { A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ServiceFeatures } from \"@adaas/a-utils/a-service\";\nimport { AreEngine, AreSyntaxTokenMatch, AreSyntax } from \"@adaas/are\";\nimport { AreHTMLInterpreter } from \"@adaas/are-html/interpreter\";\nimport { AreHTMLEngineContext } from \"./AreHTML.context\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AreComment } from \"@adaas/are-html/nodes/AreComment\";\nimport { AreComponentNode } from \"@adaas/are-html/nodes/AreComponent\";\nimport { AreHTMLTokenizer } from \"@adaas/are-html/tokenizer\";\nimport { AreRootNode } from \"@adaas/are-html/nodes/AreRoot\";\nimport { AreHTMLLifecycle } from \"@adaas/are-html/lifecycle\";\nimport { AreHTMLTransformer } from \"@adaas/are-html/transformer\";\nimport { AreHTMLCompiler } from \"./AreHTML.compiler\";\n\n\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreHTMLEngine',\n    description: 'HTML Rendering Engine for A-Concept Rendering Engine (ARE), responsible for processing and rendering HTML templates within the ARE framework.'\n})\nexport class AreHTMLEngine extends AreEngine {\n\n\n\n    get DefaultSyntax() {\n        return new AreSyntax({\n            trimWhitespace: true,\n            strictMode: true,\n            rules: [\n                // HTML comments\n                {\n                    opening: '<!--',\n                    closing: '-->',\n                    component: AreComment,\n                    priority: 10,\n                    nested: false,\n                    extract: (raw) => ({ content: raw.slice(4, -3).trim() }),\n                },\n                // interpolations\n                {\n                    opening: '{{',\n                    closing: '}}',\n                    component: AreInterpolation,\n                    priority: 9,\n                    nested: false,\n                    extract: (_, match) => ({ key: match.content }),\n                },\n                // are-root — matched before generic elements, produces AreRootNode\n                {\n                    matcher: this.rootElementMatcher.bind(this),\n                    component: AreRootNode,\n                    priority: 5,\n                },\n                // generic HTML elements\n                {\n                    matcher: this.htmlElementMatcher.bind(this),\n                    component: AreComponentNode,\n                    priority: 4,\n                },\n                // plain text fallback\n                {\n                    component: AreText,\n                    priority: 0,\n                },\n            ],\n        })\n    }\n\n\n    /**\n     * Inject AreHTMLSyntax into the container scope before loading\n     * \n     * @param container \n     */\n    @A_Feature.Extend({\n        name: A_ServiceFeatures.onBeforeLoad,\n        before: /.*/\n    })\n    async init(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        this.package(scope, {\n            context: new AreHTMLEngineContext({}),\n            syntax: this.DefaultSyntax,\n            compiler: AreHTMLCompiler,\n            interpreter: AreHTMLInterpreter,\n            tokenizer: AreHTMLTokenizer,\n            lifecycle: AreHTMLLifecycle,\n            transformer: AreHTMLTransformer,\n        });\n    }\n\n\n    protected rootElementMatcher(\n        source: string,\n        from: number,\n        to: number,\n        build: (raw: string, content: string, position: number, closing: string) => AreSyntaxTokenMatch\n    ): AreSyntaxTokenMatch | null {\n\n        // const rootTag = this.config.rootTag\n        const rootTag = 'are-root';\n\n        const tagStart = source.indexOf('<', from)\n        if (tagStart === -1 || tagStart >= to) return null\n\n        // only match if the tag name is exactly the configured root tag\n        const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/)\n        if (!tagNameMatch || tagNameMatch[1].toLowerCase() !== rootTag) return null\n\n        // delegate the actual matching to the shared HTML element logic\n        return this.htmlElementMatcher(source, from, to, build)\n    }\n\n    protected htmlElementMatcher(\n        source: string,\n        from: number,\n        to: number,\n        build: (raw: string, content: string, position: number, closing: string) => AreSyntaxTokenMatch\n    ): AreSyntaxTokenMatch | null {\n        let index = from\n\n        while (index < to) {\n            const tagStart = source.indexOf('<', index)\n            if (tagStart === -1 || tagStart >= to) return null\n\n            // skip comments, closing tags, doctype, processing instructions\n            if (source.startsWith('<!--', tagStart)) { index = tagStart + 1; continue }\n            if (source[tagStart + 1] === '/') { index = tagStart + 1; continue }\n            if (source[tagStart + 1] === '!' || source[tagStart + 1] === '?') { index = tagStart + 1; continue }\n\n            const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/)\n            if (!tagNameMatch) { index = tagStart + 1; continue }\n\n            const tagName = tagNameMatch[1]\n            const openingTagEnd = AreHTMLEngine.findTagClose(source, tagStart)\n            if (openingTagEnd === -1) return null\n\n            // extract id attribute if present in the opening tag\n            const openingTagStr = source.slice(tagStart, openingTagEnd + 1)\n            const idMatch = openingTagStr.match(/\\bid=[\"']([^\"']*)[\"']/)\n            const id = idMatch ? idMatch[1] : undefined\n\n            // self-closing: <br/> or <input/>\n            if (source[openingTagEnd - 1] === '/') {\n                const raw = source.slice(tagStart, openingTagEnd + 1)\n                const content = source.slice(tagStart + tagNameMatch[0].length, openingTagEnd - 1)\n                const match = build(raw, content, tagStart, '/>')\n                match.payload = { entity: tagName, selfClose: true, id }\n                return match\n            }\n\n            // find matching closing tag respecting nesting\n            const closingTag = `</${tagName}>`\n            let level = 0\n            let searchIndex = openingTagEnd + 1\n            let closingStart = -1\n\n            while (searchIndex < to) {\n                const nextOpen = source.indexOf(`<${tagName}`, searchIndex)\n                const nextClose = source.indexOf(closingTag, searchIndex)\n                if (nextClose === -1) break\n\n                if (nextOpen !== -1 && nextOpen < nextClose) {\n                    const charAfter = source[nextOpen + tagName.length + 1]\n                    if (charAfter === ' ' || charAfter === '>' || charAfter === '/') {\n                        level++\n                        searchIndex = nextOpen + tagName.length + 1\n                        continue\n                    }\n                }\n\n                if (level === 0) { closingStart = nextClose; break }\n                level--\n                searchIndex = nextClose + closingTag.length\n            }\n\n            if (closingStart === -1) return null\n\n            const fullTag = source.slice(tagStart, closingStart + closingTag.length)\n            const content = source.slice(openingTagEnd + 1, closingStart)\n            const match = build(fullTag, content, tagStart, closingTag)\n            match.payload = { entity: tagName, selfClose: false, id }\n            return match\n        }\n        return null\n    }\n\n    /**\n     * Find the index of the closing `>` of an opening tag, skipping over\n     * `>` characters that appear inside quoted attribute values.\n     */\n    private static findTagClose(source: string, from: number): number {\n        let inSingle = false\n        let inDouble = false\n\n        for (let i = from; i < source.length; i++) {\n            const ch = source[i]\n            if (ch === '\"' && !inSingle) inDouble = !inDouble\n            else if (ch === \"'\" && !inDouble) inSingle = !inSingle\n            else if (ch === '>' && !inSingle && !inDouble) return i\n        }\n\n        return -1\n    }\n\n}"]}

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

@@ -0,0 +1,181 @@
+import { __decorateClass, __decorateParam } from '../chunk-EQQGB2QZ.mjs';
+import { A_Feature, A_Inject, A_Scope } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+import { A_ServiceFeatures } from '@adaas/a-utils/a-service';
+import { AreEngine, AreSyntax } from '@adaas/are';
+import { AreHTMLInterpreter } from '@adaas/are-html/interpreter';
+import { AreHTMLEngineContext } from './AreHTML.context';
+import { AreInterpolation } from '@adaas/are-html/nodes/AreInterpolation';
+import { AreText } from '@adaas/are-html/nodes/AreText';
+import { AreComment } from '@adaas/are-html/nodes/AreComment';
+import { AreComponentNode } from '@adaas/are-html/nodes/AreComponent';
+import { AreHTMLTokenizer } from '@adaas/are-html/tokenizer';
+import { AreRootNode } from '@adaas/are-html/nodes/AreRoot';
+import { AreHTMLLifecycle } from '@adaas/are-html/lifecycle';
+import { AreHTMLTransformer } from '@adaas/are-html/transformer';
+import { AreHTMLCompiler } from './AreHTML.compiler';
+
+let AreHTMLEngine = class extends AreEngine {
+  get DefaultSyntax() {
+    return new AreSyntax({
+      trimWhitespace: true,
+      strictMode: true,
+      rules: [
+        // HTML comments
+        {
+          opening: "<!--",
+          closing: "-->",
+          component: AreComment,
+          priority: 10,
+          nested: false,
+          extract: (raw) => ({ content: raw.slice(4, -3).trim() })
+        },
+        // interpolations
+        {
+          opening: "{{",
+          closing: "}}",
+          component: AreInterpolation,
+          priority: 9,
+          nested: false,
+          extract: (_, match) => ({ key: match.content })
+        },
+        // are-root — matched before generic elements, produces AreRootNode
+        {
+          matcher: this.rootElementMatcher.bind(this),
+          component: AreRootNode,
+          priority: 5
+        },
+        // generic HTML elements
+        {
+          matcher: this.htmlElementMatcher.bind(this),
+          component: AreComponentNode,
+          priority: 4
+        },
+        // plain text fallback
+        {
+          component: AreText,
+          priority: 0
+        }
+      ]
+    });
+  }
+  async init(scope) {
+    this.package(scope, {
+      context: new AreHTMLEngineContext({}),
+      syntax: this.DefaultSyntax,
+      compiler: AreHTMLCompiler,
+      interpreter: AreHTMLInterpreter,
+      tokenizer: AreHTMLTokenizer,
+      lifecycle: AreHTMLLifecycle,
+      transformer: AreHTMLTransformer
+    });
+  }
+  rootElementMatcher(source, from, to, build) {
+    const rootTag = "are-root";
+    const tagStart = source.indexOf("<", from);
+    if (tagStart === -1 || tagStart >= to) return null;
+    const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/);
+    if (!tagNameMatch || tagNameMatch[1].toLowerCase() !== rootTag) return null;
+    return this.htmlElementMatcher(source, from, to, build);
+  }
+  htmlElementMatcher(source, from, to, build) {
+    let index = from;
+    while (index < to) {
+      const tagStart = source.indexOf("<", index);
+      if (tagStart === -1 || tagStart >= to) return null;
+      if (source.startsWith("<!--", tagStart)) {
+        index = tagStart + 1;
+        continue;
+      }
+      if (source[tagStart + 1] === "/") {
+        index = tagStart + 1;
+        continue;
+      }
+      if (source[tagStart + 1] === "!" || source[tagStart + 1] === "?") {
+        index = tagStart + 1;
+        continue;
+      }
+      const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/);
+      if (!tagNameMatch) {
+        index = tagStart + 1;
+        continue;
+      }
+      const tagName = tagNameMatch[1];
+      const openingTagEnd = AreHTMLEngine.findTagClose(source, tagStart);
+      if (openingTagEnd === -1) return null;
+      const openingTagStr = source.slice(tagStart, openingTagEnd + 1);
+      const idMatch = openingTagStr.match(/\bid=["']([^"']*)["']/);
+      const id = idMatch ? idMatch[1] : void 0;
+      if (source[openingTagEnd - 1] === "/") {
+        const raw = source.slice(tagStart, openingTagEnd + 1);
+        const content2 = source.slice(tagStart + tagNameMatch[0].length, openingTagEnd - 1);
+        const match2 = build(raw, content2, tagStart, "/>");
+        match2.payload = { entity: tagName, selfClose: true, id };
+        return match2;
+      }
+      const closingTag = `</${tagName}>`;
+      let level = 0;
+      let searchIndex = openingTagEnd + 1;
+      let closingStart = -1;
+      while (searchIndex < to) {
+        const nextOpen = source.indexOf(`<${tagName}`, searchIndex);
+        const nextClose = source.indexOf(closingTag, searchIndex);
+        if (nextClose === -1) break;
+        if (nextOpen !== -1 && nextOpen < nextClose) {
+          const charAfter = source[nextOpen + tagName.length + 1];
+          if (charAfter === " " || charAfter === ">" || charAfter === "/") {
+            level++;
+            searchIndex = nextOpen + tagName.length + 1;
+            continue;
+          }
+        }
+        if (level === 0) {
+          closingStart = nextClose;
+          break;
+        }
+        level--;
+        searchIndex = nextClose + closingTag.length;
+      }
+      if (closingStart === -1) return null;
+      const fullTag = source.slice(tagStart, closingStart + closingTag.length);
+      const content = source.slice(openingTagEnd + 1, closingStart);
+      const match = build(fullTag, content, tagStart, closingTag);
+      match.payload = { entity: tagName, selfClose: false, id };
+      return match;
+    }
+    return null;
+  }
+  /**
+   * Find the index of the closing `>` of an opening tag, skipping over
+   * `>` characters that appear inside quoted attribute values.
+   */
+  static findTagClose(source, from) {
+    let inSingle = false;
+    let inDouble = false;
+    for (let i = from; i < source.length; i++) {
+      const ch = source[i];
+      if (ch === '"' && !inSingle) inDouble = !inDouble;
+      else if (ch === "'" && !inDouble) inSingle = !inSingle;
+      else if (ch === ">" && !inSingle && !inDouble) return i;
+    }
+    return -1;
+  }
+};
+__decorateClass([
+  A_Feature.Extend({
+    name: A_ServiceFeatures.onBeforeLoad,
+    before: /.*/
+  }),
+  __decorateParam(0, A_Inject(A_Scope))
+], AreHTMLEngine.prototype, "init", 1);
+AreHTMLEngine = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-ARE",
+    name: "AreHTMLEngine",
+    description: "HTML Rendering Engine for A-Concept Rendering Engine (ARE), responsible for processing and rendering HTML templates within the ARE framework."
+  })
+], AreHTMLEngine);
+
+export { AreHTMLEngine };
+//# sourceMappingURL=AreHTML.engine.mjs.map
+//# sourceMappingURL=AreHTML.engine.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/engine/AreHTML.engine.ts"],"names":["content","match"],"mappings":"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","file":"AreHTML.engine.mjs","sourcesContent":["import { A_Feature, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { A_ServiceFeatures } from \"@adaas/a-utils/a-service\";\nimport { AreEngine, AreSyntaxTokenMatch, AreSyntax } from \"@adaas/are\";\nimport { AreHTMLInterpreter } from \"@adaas/are-html/interpreter\";\nimport { AreHTMLEngineContext } from \"./AreHTML.context\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AreComment } from \"@adaas/are-html/nodes/AreComment\";\nimport { AreComponentNode } from \"@adaas/are-html/nodes/AreComponent\";\nimport { AreHTMLTokenizer } from \"@adaas/are-html/tokenizer\";\nimport { AreRootNode } from \"@adaas/are-html/nodes/AreRoot\";\nimport { AreHTMLLifecycle } from \"@adaas/are-html/lifecycle\";\nimport { AreHTMLTransformer } from \"@adaas/are-html/transformer\";\nimport { AreHTMLCompiler } from \"./AreHTML.compiler\";\n\n\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreHTMLEngine',\n    description: 'HTML Rendering Engine for A-Concept Rendering Engine (ARE), responsible for processing and rendering HTML templates within the ARE framework.'\n})\nexport class AreHTMLEngine extends AreEngine {\n\n\n\n    get DefaultSyntax() {\n        return new AreSyntax({\n            trimWhitespace: true,\n            strictMode: true,\n            rules: [\n                // HTML comments\n                {\n                    opening: '<!--',\n                    closing: '-->',\n                    component: AreComment,\n                    priority: 10,\n                    nested: false,\n                    extract: (raw) => ({ content: raw.slice(4, -3).trim() }),\n                },\n                // interpolations\n                {\n                    opening: '{{',\n                    closing: '}}',\n                    component: AreInterpolation,\n                    priority: 9,\n                    nested: false,\n                    extract: (_, match) => ({ key: match.content }),\n                },\n                // are-root — matched before generic elements, produces AreRootNode\n                {\n                    matcher: this.rootElementMatcher.bind(this),\n                    component: AreRootNode,\n                    priority: 5,\n                },\n                // generic HTML elements\n                {\n                    matcher: this.htmlElementMatcher.bind(this),\n                    component: AreComponentNode,\n                    priority: 4,\n                },\n                // plain text fallback\n                {\n                    component: AreText,\n                    priority: 0,\n                },\n            ],\n        })\n    }\n\n\n    /**\n     * Inject AreHTMLSyntax into the container scope before loading\n     * \n     * @param container \n     */\n    @A_Feature.Extend({\n        name: A_ServiceFeatures.onBeforeLoad,\n        before: /.*/\n    })\n    async init(\n        @A_Inject(A_Scope) scope: A_Scope,\n    ) {\n        this.package(scope, {\n            context: new AreHTMLEngineContext({}),\n            syntax: this.DefaultSyntax,\n            compiler: AreHTMLCompiler,\n            interpreter: AreHTMLInterpreter,\n            tokenizer: AreHTMLTokenizer,\n            lifecycle: AreHTMLLifecycle,\n            transformer: AreHTMLTransformer,\n        });\n    }\n\n\n    protected rootElementMatcher(\n        source: string,\n        from: number,\n        to: number,\n        build: (raw: string, content: string, position: number, closing: string) => AreSyntaxTokenMatch\n    ): AreSyntaxTokenMatch | null {\n\n        // const rootTag = this.config.rootTag\n        const rootTag = 'are-root';\n\n        const tagStart = source.indexOf('<', from)\n        if (tagStart === -1 || tagStart >= to) return null\n\n        // only match if the tag name is exactly the configured root tag\n        const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/)\n        if (!tagNameMatch || tagNameMatch[1].toLowerCase() !== rootTag) return null\n\n        // delegate the actual matching to the shared HTML element logic\n        return this.htmlElementMatcher(source, from, to, build)\n    }\n\n    protected htmlElementMatcher(\n        source: string,\n        from: number,\n        to: number,\n        build: (raw: string, content: string, position: number, closing: string) => AreSyntaxTokenMatch\n    ): AreSyntaxTokenMatch | null {\n        let index = from\n\n        while (index < to) {\n            const tagStart = source.indexOf('<', index)\n            if (tagStart === -1 || tagStart >= to) return null\n\n            // skip comments, closing tags, doctype, processing instructions\n            if (source.startsWith('<!--', tagStart)) { index = tagStart + 1; continue }\n            if (source[tagStart + 1] === '/') { index = tagStart + 1; continue }\n            if (source[tagStart + 1] === '!' || source[tagStart + 1] === '?') { index = tagStart + 1; continue }\n\n            const tagNameMatch = source.slice(tagStart).match(/^<([a-zA-Z][a-zA-Z0-9-]*)/)\n            if (!tagNameMatch) { index = tagStart + 1; continue }\n\n            const tagName = tagNameMatch[1]\n            const openingTagEnd = AreHTMLEngine.findTagClose(source, tagStart)\n            if (openingTagEnd === -1) return null\n\n            // extract id attribute if present in the opening tag\n            const openingTagStr = source.slice(tagStart, openingTagEnd + 1)\n            const idMatch = openingTagStr.match(/\\bid=[\"']([^\"']*)[\"']/)\n            const id = idMatch ? idMatch[1] : undefined\n\n            // self-closing: <br/> or <input/>\n            if (source[openingTagEnd - 1] === '/') {\n                const raw = source.slice(tagStart, openingTagEnd + 1)\n                const content = source.slice(tagStart + tagNameMatch[0].length, openingTagEnd - 1)\n                const match = build(raw, content, tagStart, '/>')\n                match.payload = { entity: tagName, selfClose: true, id }\n                return match\n            }\n\n            // find matching closing tag respecting nesting\n            const closingTag = `</${tagName}>`\n            let level = 0\n            let searchIndex = openingTagEnd + 1\n            let closingStart = -1\n\n            while (searchIndex < to) {\n                const nextOpen = source.indexOf(`<${tagName}`, searchIndex)\n                const nextClose = source.indexOf(closingTag, searchIndex)\n                if (nextClose === -1) break\n\n                if (nextOpen !== -1 && nextOpen < nextClose) {\n                    const charAfter = source[nextOpen + tagName.length + 1]\n                    if (charAfter === ' ' || charAfter === '>' || charAfter === '/') {\n                        level++\n                        searchIndex = nextOpen + tagName.length + 1\n                        continue\n                    }\n                }\n\n                if (level === 0) { closingStart = nextClose; break }\n                level--\n                searchIndex = nextClose + closingTag.length\n            }\n\n            if (closingStart === -1) return null\n\n            const fullTag = source.slice(tagStart, closingStart + closingTag.length)\n            const content = source.slice(openingTagEnd + 1, closingStart)\n            const match = build(fullTag, content, tagStart, closingTag)\n            match.payload = { entity: tagName, selfClose: false, id }\n            return match\n        }\n        return null\n    }\n\n    /**\n     * Find the index of the closing `>` of an opening tag, skipping over\n     * `>` characters that appear inside quoted attribute values.\n     */\n    private static findTagClose(source: string, from: number): number {\n        let inSingle = false\n        let inDouble = false\n\n        for (let i = from; i < source.length; i++) {\n            const ch = source[i]\n            if (ch === '\"' && !inSingle) inDouble = !inDouble\n            else if (ch === \"'\" && !inDouble) inSingle = !inSingle\n            else if (ch === '>' && !inSingle && !inDouble) return i\n        }\n\n        return -1\n    }\n\n}"]}

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

@@ -0,0 +1,28 @@
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { AreInterpreter, AreStore, AreSyntax } from '@adaas/are';
+import { AddAttributeInstruction } from '../instructions/AddAttribute.instruction.mjs';
+import { AddCommentInstruction } from '../instructions/AddComment.instruction.mjs';
+import { AddElementInstruction } from '../instructions/AddElement.instruction.mjs';
+import { AddListenerInstruction } from '../instructions/AddListener.instruction.mjs';
+import { AddTextInstruction } from '../instructions/AddText.instruction.mjs';
+import { AreDirectiveContext } from '../lib/AreDirective/AreDirective.context.mjs';
+import { AreHTMLEngineContext } from './AreHTML.context.mjs';
+import '../instructions/AreHTML.instructions.types.mjs';
+import '@adaas/a-concept';
+import '@adaas/a-utils/a-execution';
+import './AreHTML.types.mjs';
+
+declare class AreHTMLInterpreter extends AreInterpreter {
+    addElement(declaration: AddElementInstruction, context: AreHTMLEngineContext, logger?: A_Logger): void;
+    removeElement(declaration: AddElementInstruction, context: AreHTMLEngineContext): void;
+    addAttribute(mutation: AddAttributeInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeAttribute(mutation: AddAttributeInstruction, context: AreHTMLEngineContext): void;
+    addEventListener(mutation: AddListenerInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeEventListener(mutation: AddListenerInstruction, context: AreHTMLEngineContext): void;
+    addText(declaration: AddTextInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeText(declaration: AddTextInstruction, context: AreHTMLEngineContext): void;
+    addComment(declaration: AddCommentInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeComment(declaration: AddCommentInstruction, context: AreHTMLEngineContext): void;
+}
+
+export { AreHTMLInterpreter };

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

@@ -0,0 +1,28 @@
+import { A_Logger } from '@adaas/a-utils/a-logger';
+import { AreInterpreter, AreStore, AreSyntax } from '@adaas/are';
+import { AddAttributeInstruction } from '../instructions/AddAttribute.instruction.js';
+import { AddCommentInstruction } from '../instructions/AddComment.instruction.js';
+import { AddElementInstruction } from '../instructions/AddElement.instruction.js';
+import { AddListenerInstruction } from '../instructions/AddListener.instruction.js';
+import { AddTextInstruction } from '../instructions/AddText.instruction.js';
+import { AreDirectiveContext } from '../lib/AreDirective/AreDirective.context.js';
+import { AreHTMLEngineContext } from './AreHTML.context.js';
+import '../instructions/AreHTML.instructions.types.js';
+import '@adaas/a-concept';
+import '@adaas/a-utils/a-execution';
+import './AreHTML.types.js';
+
+declare class AreHTMLInterpreter extends AreInterpreter {
+    addElement(declaration: AddElementInstruction, context: AreHTMLEngineContext, logger?: A_Logger): void;
+    removeElement(declaration: AddElementInstruction, context: AreHTMLEngineContext): void;
+    addAttribute(mutation: AddAttributeInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeAttribute(mutation: AddAttributeInstruction, context: AreHTMLEngineContext): void;
+    addEventListener(mutation: AddListenerInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeEventListener(mutation: AddListenerInstruction, context: AreHTMLEngineContext): void;
+    addText(declaration: AddTextInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeText(declaration: AddTextInstruction, context: AreHTMLEngineContext): void;
+    addComment(declaration: AddCommentInstruction, context: AreHTMLEngineContext, store: AreStore, syntax: AreSyntax, directiveContext?: AreDirectiveContext, logger?: A_Logger): void;
+    removeComment(declaration: AddCommentInstruction, context: AreHTMLEngineContext): void;
+}
+
+export { AreHTMLInterpreter };