@adaas/are-html 0.0.21 → 0.0.23

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

@@ -115,7 +115,171 @@ function toDOMString(value) {
     return "";
   }
 }
+const STANDARD_HTML_TAGS = /* @__PURE__ */ new Set([
+  // root / sections
+  "html",
+  "body",
+  "header",
+  "footer",
+  "main",
+  "nav",
+  "section",
+  "article",
+  "aside",
+  "address",
+  "hgroup",
+  // headings
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  // grouping
+  "div",
+  "p",
+  "span",
+  "pre",
+  "blockquote",
+  "figure",
+  "figcaption",
+  "hr",
+  "br",
+  "wbr",
+  // lists
+  "ul",
+  "ol",
+  "li",
+  "dl",
+  "dt",
+  "dd",
+  "menu",
+  // text-level / phrasing
+  "a",
+  "b",
+  "i",
+  "u",
+  "s",
+  "em",
+  "strong",
+  "small",
+  "mark",
+  "abbr",
+  "cite",
+  "q",
+  "code",
+  "kbd",
+  "samp",
+  "var",
+  "sub",
+  "sup",
+  "time",
+  "data",
+  "dfn",
+  "bdi",
+  "bdo",
+  "ruby",
+  "rt",
+  "rp",
+  "del",
+  "ins",
+  // media / embedded (no special namespace handling needed)
+  "img",
+  "picture",
+  "source",
+  "figure",
+  "audio",
+  "video",
+  "track",
+  // tables
+  "table",
+  "caption",
+  "colgroup",
+  "col",
+  "thead",
+  "tbody",
+  "tfoot",
+  "tr",
+  "th",
+  "td",
+  // forms (display only — these still render fine from innerHTML)
+  "label",
+  "fieldset",
+  "legend",
+  "datalist",
+  "option",
+  "optgroup",
+  "output",
+  "progress",
+  "meter",
+  // interactive
+  "details",
+  "summary",
+  "dialog"
+]);
+function isStaticMarkup(inner) {
+  if (!inner) return false;
+  if (inner.indexOf("{{") !== -1) return false;
+  const n = inner.length;
+  let i = 0;
+  while (i < n) {
+    const lt = inner.indexOf("<", i);
+    if (lt === -1) break;
+    if (inner.startsWith("<!--", lt)) {
+      const end = inner.indexOf("-->", lt + 4);
+      if (end === -1) return false;
+      i = end + 3;
+      continue;
+    }
+    if (inner[lt + 1] === "/" || inner[lt + 1] === "!" || inner[lt + 1] === "?") {
+      const gt = inner.indexOf(">", lt);
+      if (gt === -1) return false;
+      i = gt + 1;
+      continue;
+    }
+    const nameMatch = /^<([a-zA-Z][a-zA-Z0-9-]*)/.exec(inner.slice(lt));
+    if (!nameMatch) {
+      i = lt + 1;
+      continue;
+    }
+    const tag = nameMatch[1].toLowerCase();
+    if (tag.indexOf("-") !== -1 || !STANDARD_HTML_TAGS.has(tag)) return false;
+    let j = lt + nameMatch[0].length;
+    let inSingle = false;
+    let inDouble = false;
+    let atNameBoundary = true;
+    let tagEnd = -1;
+    while (j < n) {
+      const ch = inner[j];
+      if (inDouble) {
+        if (ch === '"') inDouble = false;
+      } else if (inSingle) {
+        if (ch === "'") inSingle = false;
+      } else if (ch === '"') {
+        inDouble = true;
+        atNameBoundary = false;
+      } else if (ch === "'") {
+        inSingle = true;
+        atNameBoundary = false;
+      } else if (ch === ">") {
+        tagEnd = j;
+        break;
+      } else if (ch === " " || ch === "	" || ch === "\n" || ch === "\r" || ch === "/") {
+        atNameBoundary = true;
+      } else {
+        if (atNameBoundary && (ch === "$" || ch === ":" || ch === "@")) {
+          return false;
+        }
+        atNameBoundary = false;
+      }
+      j++;
+    }
+    if (tagEnd === -1) return false;
+    i = tagEnd + 1;
+  }
+  return true;
+}
 
-export { BOOLEAN_ATTRIBUTES, IDL_FORM_PROPERTIES, LISTENER_OPTION_MODIFIERS, SVG_ATTRIBUTE_NS, SVG_NAMESPACE, VOID_ELEMENTS, isBooleanAttribute, isIDLFormProperty, isVoidElement, normalizeClassValue, normalizeStyleValue, parseEventName, toDOMString };
+export { BOOLEAN_ATTRIBUTES, IDL_FORM_PROPERTIES, LISTENER_OPTION_MODIFIERS, STANDARD_HTML_TAGS, SVG_ATTRIBUTE_NS, SVG_NAMESPACE, VOID_ELEMENTS, isBooleanAttribute, isIDLFormProperty, isStaticMarkup, isVoidElement, normalizeClassValue, normalizeStyleValue, parseEventName, toDOMString };
 //# sourceMappingURL=AreHTML.constants.mjs.map
 //# sourceMappingURL=AreHTML.constants.mjs.map

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/engine/AreHTML.constants.ts"],"names":[],"mappings":"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","file":"AreHTML.constants.mjs","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// ── SVG ──────────────────────────────────────────────────────────────────────\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** XML namespace URI for SVG elements. */\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n/**\n * Maps namespace prefixes used in SVG/XML attributes to their canonical URIs.\n * Used by the interpreter when calling setAttributeNS / removeAttributeNS.\n */\nexport const SVG_ATTRIBUTE_NS: Record<string, string> = {\n    xlink: 'http://www.w3.org/1999/xlink',\n    xml: 'http://www.w3.org/XML/1998/namespace',\n    xmlns: 'http://www.w3.org/2000/xmlns/',\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ── HTML void elements ────────────────────────────────────────────────────────\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Void HTML elements that cannot have children and must not have a closing tag.\n * Per the HTML5 spec these are treated as self-closing even when written as\n * `<input>` (without the trailing slash `/>`).\n *\n * Reference: https://html.spec.whatwg.org/multipage/syntax.html#void-elements\n */\nexport const VOID_ELEMENTS = new Set<string>([\n    'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',\n    'link', 'meta', 'param', 'source', 'track', 'wbr',\n]);\n\nexport function isVoidElement(tagName: string): boolean {\n    return VOID_ELEMENTS.has(tagName.toLowerCase());\n}\n\n/**\n * Boolean HTML attributes whose presence (regardless of value) implies \"true\",\n * and whose absence implies \"false\". Setting these via `setAttribute(name, value)`\n * always renders the attribute, which is wrong for reactive bindings.\n *\n * Reference: https://html.spec.whatwg.org/multipage/indices.html#attributes-3\n */\nexport const BOOLEAN_ATTRIBUTES = new Set<string>([\n    'allowfullscreen',\n    'async',\n    'autofocus',\n    'autoplay',\n    'checked',\n    'controls',\n    'default',\n    'defer',\n    'disabled',\n    'formnovalidate',\n    'hidden',\n    'inert',\n    'ismap',\n    'itemscope',\n    'loop',\n    'multiple',\n    'muted',\n    'nomodule',\n    'novalidate',\n    'open',\n    'playsinline',\n    'readonly',\n    'required',\n    'reversed',\n    'selected',\n]);\n\nexport function isBooleanAttribute(name: string): boolean {\n    return BOOLEAN_ATTRIBUTES.has(name.toLowerCase());\n}\n\n/**\n * Form-control IDL properties that must be set as a JS property\n * (not just an attribute) so live user input is reflected.\n *\n * `<input value=\"foo\">` only sets the *default* value;\n * `input.value = \"foo\"` updates the live state.\n */\nexport const IDL_FORM_PROPERTIES: Record<string, Set<string>> = {\n    INPUT: new Set(['value', 'checked', 'indeterminate']),\n    TEXTAREA: new Set(['value']),\n    SELECT: new Set(['value']),\n    OPTION: new Set(['selected']),\n};\n\nexport function isIDLFormProperty(tagName: string, attrName: string): boolean {\n    const set = IDL_FORM_PROPERTIES[tagName.toUpperCase()];\n    return !!set && set.has(attrName);\n}\n\n/**\n * Normalize a `:class` binding value into a single space-separated string.\n * Supports the common shapes:\n *   - string                                       → \"a b\"\n *   - array<string | object | falsy>               → [\"a\", { b: true, c: cond }, null]\n *   - object<string, boolean>                      → { a: true, b: false }\n */\nexport function normalizeClassValue(value: any): string {\n    if (value === null || value === undefined || value === false) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number') return String(value);\n\n    if (Array.isArray(value)) {\n        return value.map(normalizeClassValue).filter(Boolean).join(' ');\n    }\n    if (typeof value === 'object') {\n        const parts: string[] = [];\n        for (const key of Object.keys(value)) {\n            if (value[key]) parts.push(key);\n        }\n        return parts.join(' ');\n    }\n    return '';\n}\n\n/**\n * Normalize a `:style` binding value into an inline-style string.\n * Supports:\n *   - string                                       → \"color: red; font-size: 12px\"\n *   - object<string, string|number>                → { color: 'red', fontSize: '12px' }\n *   - array<string | object>                       → ['color: red', { fontSize: '12px' }]\n */\nexport function normalizeStyleValue(value: any): string {\n    if (value === null || value === undefined || value === false) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number') return String(value);\n\n    if (Array.isArray(value)) {\n        return value.map(normalizeStyleValue).filter(Boolean).join('; ');\n    }\n    if (typeof value === 'object') {\n        const parts: string[] = [];\n        for (const key of Object.keys(value)) {\n            const v = value[key];\n            if (v === null || v === undefined || v === false) continue;\n            const kebab = key.replace(/[A-Z]/g, m => '-' + m.toLowerCase());\n            parts.push(`${kebab}: ${v}`);\n        }\n        return parts.join('; ');\n    }\n    return '';\n}\n\n/**\n * Parse a DOM event name with modifiers, e.g. \"click.stop.prevent\" or \"keydown.enter\".\n * Returns the bare event name plus the modifier set.\n */\nexport interface ParsedEventName {\n    event: string;\n    modifiers: Set<string>;\n}\n\nexport function parseEventName(raw: string): ParsedEventName {\n    const [event, ...modifiers] = raw.split('.');\n    return { event, modifiers: new Set(modifiers) };\n}\n\n/**\n * Known event-listener modifiers that map directly to addEventListener options.\n */\nexport const LISTENER_OPTION_MODIFIERS = new Set(['capture', 'once', 'passive']);\n\n/**\n * Coerce a value into a string for DOM consumption.\n * Avoids \"undefined\"/\"null\"/\"[object Object]\" leaks into the DOM.\n */\nexport function toDOMString(value: any): string {\n    if (value === null || value === undefined) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number' || typeof value === 'boolean') return String(value);\n    try {\n        return JSON.stringify(value);\n    } catch {\n        return '';\n    }\n}\n\n\n"]}
+{"version":3,"sources":["../../../src/engine/AreHTML.constants.ts"],"names":[],"mappings":"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","file":"AreHTML.constants.mjs","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// ── SVG ──────────────────────────────────────────────────────────────────────\n// ─────────────────────────────────────────────────────────────────────────────\n\n/** XML namespace URI for SVG elements. */\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n\n/**\n * Maps namespace prefixes used in SVG/XML attributes to their canonical URIs.\n * Used by the interpreter when calling setAttributeNS / removeAttributeNS.\n */\nexport const SVG_ATTRIBUTE_NS: Record<string, string> = {\n    xlink: 'http://www.w3.org/1999/xlink',\n    xml: 'http://www.w3.org/XML/1998/namespace',\n    xmlns: 'http://www.w3.org/2000/xmlns/',\n};\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ── HTML void elements ────────────────────────────────────────────────────────\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Void HTML elements that cannot have children and must not have a closing tag.\n * Per the HTML5 spec these are treated as self-closing even when written as\n * `<input>` (without the trailing slash `/>`).\n *\n * Reference: https://html.spec.whatwg.org/multipage/syntax.html#void-elements\n */\nexport const VOID_ELEMENTS = new Set<string>([\n    'area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input',\n    'link', 'meta', 'param', 'source', 'track', 'wbr',\n]);\n\nexport function isVoidElement(tagName: string): boolean {\n    return VOID_ELEMENTS.has(tagName.toLowerCase());\n}\n\n/**\n * Boolean HTML attributes whose presence (regardless of value) implies \"true\",\n * and whose absence implies \"false\". Setting these via `setAttribute(name, value)`\n * always renders the attribute, which is wrong for reactive bindings.\n *\n * Reference: https://html.spec.whatwg.org/multipage/indices.html#attributes-3\n */\nexport const BOOLEAN_ATTRIBUTES = new Set<string>([\n    'allowfullscreen',\n    'async',\n    'autofocus',\n    'autoplay',\n    'checked',\n    'controls',\n    'default',\n    'defer',\n    'disabled',\n    'formnovalidate',\n    'hidden',\n    'inert',\n    'ismap',\n    'itemscope',\n    'loop',\n    'multiple',\n    'muted',\n    'nomodule',\n    'novalidate',\n    'open',\n    'playsinline',\n    'readonly',\n    'required',\n    'reversed',\n    'selected',\n]);\n\nexport function isBooleanAttribute(name: string): boolean {\n    return BOOLEAN_ATTRIBUTES.has(name.toLowerCase());\n}\n\n/**\n * Form-control IDL properties that must be set as a JS property\n * (not just an attribute) so live user input is reflected.\n *\n * `<input value=\"foo\">` only sets the *default* value;\n * `input.value = \"foo\"` updates the live state.\n */\nexport const IDL_FORM_PROPERTIES: Record<string, Set<string>> = {\n    INPUT: new Set(['value', 'checked', 'indeterminate']),\n    TEXTAREA: new Set(['value']),\n    SELECT: new Set(['value']),\n    OPTION: new Set(['selected']),\n};\n\nexport function isIDLFormProperty(tagName: string, attrName: string): boolean {\n    const set = IDL_FORM_PROPERTIES[tagName.toUpperCase()];\n    return !!set && set.has(attrName);\n}\n\n/**\n * Normalize a `:class` binding value into a single space-separated string.\n * Supports the common shapes:\n *   - string                                       → \"a b\"\n *   - array<string | object | falsy>               → [\"a\", { b: true, c: cond }, null]\n *   - object<string, boolean>                      → { a: true, b: false }\n */\nexport function normalizeClassValue(value: any): string {\n    if (value === null || value === undefined || value === false) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number') return String(value);\n\n    if (Array.isArray(value)) {\n        return value.map(normalizeClassValue).filter(Boolean).join(' ');\n    }\n    if (typeof value === 'object') {\n        const parts: string[] = [];\n        for (const key of Object.keys(value)) {\n            if (value[key]) parts.push(key);\n        }\n        return parts.join(' ');\n    }\n    return '';\n}\n\n/**\n * Normalize a `:style` binding value into an inline-style string.\n * Supports:\n *   - string                                       → \"color: red; font-size: 12px\"\n *   - object<string, string|number>                → { color: 'red', fontSize: '12px' }\n *   - array<string | object>                       → ['color: red', { fontSize: '12px' }]\n */\nexport function normalizeStyleValue(value: any): string {\n    if (value === null || value === undefined || value === false) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number') return String(value);\n\n    if (Array.isArray(value)) {\n        return value.map(normalizeStyleValue).filter(Boolean).join('; ');\n    }\n    if (typeof value === 'object') {\n        const parts: string[] = [];\n        for (const key of Object.keys(value)) {\n            const v = value[key];\n            if (v === null || v === undefined || v === false) continue;\n            const kebab = key.replace(/[A-Z]/g, m => '-' + m.toLowerCase());\n            parts.push(`${kebab}: ${v}`);\n        }\n        return parts.join('; ');\n    }\n    return '';\n}\n\n/**\n * Parse a DOM event name with modifiers, e.g. \"click.stop.prevent\" or \"keydown.enter\".\n * Returns the bare event name plus the modifier set.\n */\nexport interface ParsedEventName {\n    event: string;\n    modifiers: Set<string>;\n}\n\nexport function parseEventName(raw: string): ParsedEventName {\n    const [event, ...modifiers] = raw.split('.');\n    return { event, modifiers: new Set(modifiers) };\n}\n\n/**\n * Known event-listener modifiers that map directly to addEventListener options.\n */\nexport const LISTENER_OPTION_MODIFIERS = new Set(['capture', 'once', 'passive']);\n\n/**\n * Coerce a value into a string for DOM consumption.\n * Avoids \"undefined\"/\"null\"/\"[object Object]\" leaks into the DOM.\n */\nexport function toDOMString(value: any): string {\n    if (value === null || value === undefined) return '';\n    if (typeof value === 'string') return value;\n    if (typeof value === 'number' || typeof value === 'boolean') return String(value);\n    try {\n        return JSON.stringify(value);\n    } catch {\n        return '';\n    }\n}\n\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ── Static-island detection ──────────────────────────────────────────────────\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Standard HTML element names that are safe to materialise wholesale via\n * `innerHTML` / a cached `<template>` clone.\n *\n * The set is intentionally an allow-list of plain HTML flow/phrasing/table/list\n * /form-display tags. Anything NOT in this set — custom elements, registered\n * ARE components (resolved by PascalCase tag), and SVG/MathML elements — is\n * excluded so those subtrees keep flowing through the normal per-node pipeline\n * (SVG needs createElementNS; components need their own lifecycle).\n */\nexport const STANDARD_HTML_TAGS = new Set<string>([\n    // root / sections\n    'html', 'body', 'header', 'footer', 'main', 'nav', 'section', 'article',\n    'aside', 'address', 'hgroup',\n    // headings\n    'h1', 'h2', 'h3', 'h4', 'h5', 'h6',\n    // grouping\n    'div', 'p', 'span', 'pre', 'blockquote', 'figure', 'figcaption',\n    'hr', 'br', 'wbr',\n    // lists\n    'ul', 'ol', 'li', 'dl', 'dt', 'dd', 'menu',\n    // text-level / phrasing\n    'a', 'b', 'i', 'u', 's', 'em', 'strong', 'small', 'mark', 'abbr', 'cite',\n    'q', 'code', 'kbd', 'samp', 'var', 'sub', 'sup', 'time', 'data', 'dfn',\n    'bdi', 'bdo', 'ruby', 'rt', 'rp', 'del', 'ins',\n    // media / embedded (no special namespace handling needed)\n    'img', 'picture', 'source', 'figure', 'audio', 'video', 'track',\n    // tables\n    'table', 'caption', 'colgroup', 'col', 'thead', 'tbody', 'tfoot',\n    'tr', 'th', 'td',\n    // forms (display only — these still render fine from innerHTML)\n    'label', 'fieldset', 'legend', 'datalist', 'option', 'optgroup', 'output',\n    'progress', 'meter',\n    // interactive\n    'details', 'summary', 'dialog',\n]);\n\n/**\n * Detects whether an inner-markup string is a fully *static island* — i.e. it\n * contains no ARE-reactive constructs and therefore can be rendered in one shot\n * (browser-parsed `innerHTML` / cached `<template>` clone) instead of being\n * exploded into one AreNode per element/text/interpolation.\n *\n * A subtree is static iff it contains:\n *   1. no `{{ }}` interpolations, and\n *   2. no dynamic attributes (`$`-directive / `:`-binding / `@`-event), and\n *   3. only standard HTML tags (no custom elements, ARE components or SVG).\n *\n * The scanner is quote-aware so a `:` / `@` / `$` inside an attribute *value*\n * (e.g. `href=\"http://…\"`, `style=\"color:red\"`) is never mistaken for a\n * dynamic-attribute prefix. The detector is deliberately conservative: any\n * ambiguity resolves to `false` (skip the optimisation, keep the safe path).\n *\n * NOTE: pure-text content (no tags at all) is also considered static — this is\n * what lets `&nbsp;`, `&amp;`, `&#160;` and friends decode correctly, since the\n * browser HTML parser handles entities that hand-built text nodes do not.\n */\nexport function isStaticMarkup(inner: string): boolean {\n    if (!inner) return false;\n    // 1. interpolations make the subtree dynamic\n    if (inner.indexOf('{{') !== -1) return false;\n\n    const n = inner.length;\n    let i = 0;\n\n    while (i < n) {\n        const lt = inner.indexOf('<', i);\n        if (lt === -1) break; // remaining content is plain text — safe\n\n        // HTML comment — inert, skip over it\n        if (inner.startsWith('<!--', lt)) {\n            const end = inner.indexOf('-->', lt + 4);\n            if (end === -1) return false; // malformed\n            i = end + 3;\n            continue;\n        }\n\n        // closing tag, doctype or processing instruction — skip to its '>'\n        if (inner[lt + 1] === '/' || inner[lt + 1] === '!' || inner[lt + 1] === '?') {\n            const gt = inner.indexOf('>', lt);\n            if (gt === -1) return false;\n            i = gt + 1;\n            continue;\n        }\n\n        // opening tag — extract the tag name\n        const nameMatch = /^<([a-zA-Z][a-zA-Z0-9-]*)/.exec(inner.slice(lt));\n        if (!nameMatch) { i = lt + 1; continue; }\n\n        const tag = nameMatch[1].toLowerCase();\n        // custom element / ARE component / non-standard (incl. SVG) → not static\n        if (tag.indexOf('-') !== -1 || !STANDARD_HTML_TAGS.has(tag)) return false;\n\n        // walk the opening tag (quote-aware) to find its closing '>' and inspect\n        // attribute-name boundaries for dynamic prefixes\n        let j = lt + nameMatch[0].length;\n        let inSingle = false;\n        let inDouble = false;\n        let atNameBoundary = true; // true right after whitespace / '/' inside a tag\n        let tagEnd = -1;\n\n        while (j < n) {\n            const ch = inner[j];\n\n            if (inDouble) {\n                if (ch === '\"') inDouble = false;\n            } else if (inSingle) {\n                if (ch === \"'\") inSingle = false;\n            } else if (ch === '\"') {\n                inDouble = true;\n                atNameBoundary = false;\n            } else if (ch === \"'\") {\n                inSingle = true;\n                atNameBoundary = false;\n            } else if (ch === '>') {\n                tagEnd = j;\n                break;\n            } else if (ch === ' ' || ch === '\\t' || ch === '\\n' || ch === '\\r' || ch === '/') {\n                atNameBoundary = true;\n            } else {\n                // a dynamic-attribute prefix only counts when it STARTS an\n                // attribute name (i.e. sits at a name boundary, outside quotes)\n                if (atNameBoundary && (ch === '$' || ch === ':' || ch === '@')) {\n                    return false;\n                }\n                atNameBoundary = false;\n            }\n            j++;\n        }\n\n        if (tagEnd === -1) return false; // unterminated tag — bail to safe path\n        i = tagEnd + 1;\n    }\n\n    return true;\n}\n\n\n"]}

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

@@ -44,8 +44,74 @@ declare class AreHTMLEngineContext extends AreContext {
      * The root container for the HTML engine, which can be either a Document or a ShadowRoot. This is where the engine will mount the generated DOM elements. The context uses this container to manage the relationship between AreNodes, instructions, and their corresponding DOM elements, allowing for efficient updates and cleanups as the application state changes.
      */
     protected _container: Document;
+    /**
+     * Parsed-fragment cache for static islands (see AddStaticHTMLInstruction).
+     *
+     * Keyed by `hostTag\u0000markup`, each entry holds a `DocumentFragment` whose
+     * children were parsed by the browser exactly once — in the *correct element
+     * context* (the host tag), so table fragments (`<tr>`, `<td>`, …) and other
+     * context-sensitive content parse correctly. Repeated static islands with
+     * identical markup (e.g. list rows, reused components) clone the pre-parsed
+     * fragment instead of re-parsing the HTML string on every mount — turning an
+     * O(parse) operation into an O(clone) one.
+     */
+    protected _staticFragmentCache: Map<string, DocumentFragment>;
+    /**
+     * Live-DOM attachments deferred while a mount pass is batching.
+     *
+     * A freshly-mounted subtree is built inside a *detached* root element, so
+     * every descendant `appendChild`/`insertBefore` happens off-document and
+     * triggers zero layout/paint invalidation. The single mutation that actually
+     * connects the built subtree to the live document is deferred and collected
+     * here, then flushed once when the batch closes — collapsing O(nodes) reflows
+     * into O(1) per mount root.
+     */
+    protected _pendingAttachments: Array<() => void>;
+    /**
+     * Depth of the currently open batching scopes. Re-entrant so that nested
+     * `beginBatch`/`endBatch` pairs flush exactly once, when the outermost scope
+     * closes.
+     */
+    protected _batchDepth: number;
     constructor(props: Partial<AreHTMLContextConstructor>);
     get container(): Document;
+    /**
+     * `true` while a synchronous mount pass is batching live-DOM attachments.
+     * Interpreter handlers consult this to decide whether to attach an element
+     * immediately or hand the attachment to {@link deferAttach}.
+     */
+    get isBatching(): boolean;
+    /**
+     * Opens a batching scope. Re-entrant: only the outermost matching
+     * {@link endBatch} flushes the deferred attachments, so a single mount pass
+     * connects its built subtree to the live DOM exactly once.
+     */
+    beginBatch(): void;
+    /**
+     * Registers a live-DOM attachment to run when the current batch flushes. If
+     * no batch is active the attachment runs immediately, preserving the original
+     * synchronous behaviour for updates that mount outside a batch.
+     *
+     * @param attach the DOM mutation that connects a built subtree to the document
+     */
+    deferAttach(attach: () => void): void;
+    /**
+     * Closes a batching scope. When the outermost scope closes, every deferred
+     * attachment runs in registration (document) order, connecting the built
+     * subtrees to the live DOM in a single pass.
+     */
+    endBatch(): void;
+    /**
+     * Returns a `DocumentFragment` containing the parsed form of `html`, parsed
+     * once in the context of `hostTag` (so context-sensitive content such as
+     * table rows/cells parses correctly) and cached thereafter. Callers should
+     * `cloneNode(true)` the returned fragment rather than mutating it, so the
+     * cache stays reusable.
+     *
+     * @param hostTag the tag name of the element the markup will be injected into
+     * @param html    verbatim static-island inner markup
+     */
+    getStaticFragment(hostTag: string, html: string): DocumentFragment;
     /**
      * Retrieves the DOM element associated with a given AreNode. This method looks up the node's ASEID in the nodeToHostElements map to find the corresponding DOM element. If the node is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific nodes in the AreNode tree, enabling dynamic updates and interactions based on the application state.
      *

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

@@ -44,8 +44,74 @@ declare class AreHTMLEngineContext extends AreContext {
      * The root container for the HTML engine, which can be either a Document or a ShadowRoot. This is where the engine will mount the generated DOM elements. The context uses this container to manage the relationship between AreNodes, instructions, and their corresponding DOM elements, allowing for efficient updates and cleanups as the application state changes.
      */
     protected _container: Document;
+    /**
+     * Parsed-fragment cache for static islands (see AddStaticHTMLInstruction).
+     *
+     * Keyed by `hostTag\u0000markup`, each entry holds a `DocumentFragment` whose
+     * children were parsed by the browser exactly once — in the *correct element
+     * context* (the host tag), so table fragments (`<tr>`, `<td>`, …) and other
+     * context-sensitive content parse correctly. Repeated static islands with
+     * identical markup (e.g. list rows, reused components) clone the pre-parsed
+     * fragment instead of re-parsing the HTML string on every mount — turning an
+     * O(parse) operation into an O(clone) one.
+     */
+    protected _staticFragmentCache: Map<string, DocumentFragment>;
+    /**
+     * Live-DOM attachments deferred while a mount pass is batching.
+     *
+     * A freshly-mounted subtree is built inside a *detached* root element, so
+     * every descendant `appendChild`/`insertBefore` happens off-document and
+     * triggers zero layout/paint invalidation. The single mutation that actually
+     * connects the built subtree to the live document is deferred and collected
+     * here, then flushed once when the batch closes — collapsing O(nodes) reflows
+     * into O(1) per mount root.
+     */
+    protected _pendingAttachments: Array<() => void>;
+    /**
+     * Depth of the currently open batching scopes. Re-entrant so that nested
+     * `beginBatch`/`endBatch` pairs flush exactly once, when the outermost scope
+     * closes.
+     */
+    protected _batchDepth: number;
     constructor(props: Partial<AreHTMLContextConstructor>);
     get container(): Document;
+    /**
+     * `true` while a synchronous mount pass is batching live-DOM attachments.
+     * Interpreter handlers consult this to decide whether to attach an element
+     * immediately or hand the attachment to {@link deferAttach}.
+     */
+    get isBatching(): boolean;
+    /**
+     * Opens a batching scope. Re-entrant: only the outermost matching
+     * {@link endBatch} flushes the deferred attachments, so a single mount pass
+     * connects its built subtree to the live DOM exactly once.
+     */
+    beginBatch(): void;
+    /**
+     * Registers a live-DOM attachment to run when the current batch flushes. If
+     * no batch is active the attachment runs immediately, preserving the original
+     * synchronous behaviour for updates that mount outside a batch.
+     *
+     * @param attach the DOM mutation that connects a built subtree to the document
+     */
+    deferAttach(attach: () => void): void;
+    /**
+     * Closes a batching scope. When the outermost scope closes, every deferred
+     * attachment runs in registration (document) order, connecting the built
+     * subtrees to the live DOM in a single pass.
+     */
+    endBatch(): void;
+    /**
+     * Returns a `DocumentFragment` containing the parsed form of `html`, parsed
+     * once in the context of `hostTag` (so context-sensitive content such as
+     * table rows/cells parses correctly) and cached thereafter. Callers should
+     * `cloneNode(true)` the returned fragment rather than mutating it, so the
+     * cache stays reusable.
+     *
+     * @param hostTag the tag name of the element the markup will be injected into
+     * @param html    verbatim static-island inner markup
+     */
+    getStaticFragment(hostTag: string, html: string): DocumentFragment;
     /**
      * Retrieves the DOM element associated with a given AreNode. This method looks up the node's ASEID in the nodeToHostElements map to find the corresponding DOM element. If the node is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific nodes in the AreNode tree, enabling dynamic updates and interactions based on the application state.
      *

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

@@ -52,11 +52,109 @@ exports.AreHTMLEngineContext = class AreHTMLEngineContext extends are.AreContext
        */
       elementListeners: /* @__PURE__ */ new WeakMap()
     };
+    /**
+     * Parsed-fragment cache for static islands (see AddStaticHTMLInstruction).
+     *
+     * Keyed by `hostTag\u0000markup`, each entry holds a `DocumentFragment` whose
+     * children were parsed by the browser exactly once — in the *correct element
+     * context* (the host tag), so table fragments (`<tr>`, `<td>`, …) and other
+     * context-sensitive content parse correctly. Repeated static islands with
+     * identical markup (e.g. list rows, reused components) clone the pre-parsed
+     * fragment instead of re-parsing the HTML string on every mount — turning an
+     * O(parse) operation into an O(clone) one.
+     */
+    this._staticFragmentCache = /* @__PURE__ */ new Map();
+    /**
+     * Live-DOM attachments deferred while a mount pass is batching.
+     *
+     * A freshly-mounted subtree is built inside a *detached* root element, so
+     * every descendant `appendChild`/`insertBefore` happens off-document and
+     * triggers zero layout/paint invalidation. The single mutation that actually
+     * connects the built subtree to the live document is deferred and collected
+     * here, then flushed once when the batch closes — collapsing O(nodes) reflows
+     * into O(1) per mount root.
+     */
+    this._pendingAttachments = [];
+    /**
+     * Depth of the currently open batching scopes. Re-entrant so that nested
+     * `beginBatch`/`endBatch` pairs flush exactly once, when the outermost scope
+     * closes.
+     */
+    this._batchDepth = 0;
     this._container = props.container;
   }
   get container() {
     return this._container;
   }
+  /**
+   * `true` while a synchronous mount pass is batching live-DOM attachments.
+   * Interpreter handlers consult this to decide whether to attach an element
+   * immediately or hand the attachment to {@link deferAttach}.
+   */
+  get isBatching() {
+    return this._batchDepth > 0;
+  }
+  /**
+   * Opens a batching scope. Re-entrant: only the outermost matching
+   * {@link endBatch} flushes the deferred attachments, so a single mount pass
+   * connects its built subtree to the live DOM exactly once.
+   */
+  beginBatch() {
+    this._batchDepth++;
+  }
+  /**
+   * Registers a live-DOM attachment to run when the current batch flushes. If
+   * no batch is active the attachment runs immediately, preserving the original
+   * synchronous behaviour for updates that mount outside a batch.
+   *
+   * @param attach the DOM mutation that connects a built subtree to the document
+   */
+  deferAttach(attach) {
+    if (this._batchDepth > 0) {
+      this._pendingAttachments.push(attach);
+    } else {
+      attach();
+    }
+  }
+  /**
+   * Closes a batching scope. When the outermost scope closes, every deferred
+   * attachment runs in registration (document) order, connecting the built
+   * subtrees to the live DOM in a single pass.
+   */
+  endBatch() {
+    if (this._batchDepth === 0) return;
+    this._batchDepth--;
+    if (this._batchDepth > 0) return;
+    const pending = this._pendingAttachments;
+    this._pendingAttachments = [];
+    for (let i = 0; i < pending.length; i++) {
+      pending[i]();
+    }
+  }
+  /**
+   * Returns a `DocumentFragment` containing the parsed form of `html`, parsed
+   * once in the context of `hostTag` (so context-sensitive content such as
+   * table rows/cells parses correctly) and cached thereafter. Callers should
+   * `cloneNode(true)` the returned fragment rather than mutating it, so the
+   * cache stays reusable.
+   *
+   * @param hostTag the tag name of the element the markup will be injected into
+   * @param html    verbatim static-island inner markup
+   */
+  getStaticFragment(hostTag, html) {
+    const key = `${hostTag}\0${html}`;
+    let fragment = this._staticFragmentCache.get(key);
+    if (!fragment) {
+      const container = this._container.createElement(hostTag);
+      container.innerHTML = html;
+      fragment = this._container.createDocumentFragment();
+      while (container.firstChild) {
+        fragment.appendChild(container.firstChild);
+      }
+      this._staticFragmentCache.set(key, fragment);
+    }
+    return fragment;
+  }
   getNodeElement(node) {
     if (typeof node === "string") {
       return this.index.nodeToHostElements.get(node);

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/engine/AreHTML.context.ts"],"names":["AreHTMLEngineContext","AreContext","AreDeclaration","A_Frame"],"mappings":";;;;;;;;;;;;;AASaA,4BAAA,GAAN,mCAAmCC,cAAA,CAAW;AAAA,EAgDjD,YAAY,KAAA,EAA2C;AACnD,IAAA,KAAA,CAAM,MAAM,SAAA,EAAW,IAAA,CAAK,SAAA,IAAa,KAAA,CAAM,UAAU,EAAE,CAAA;AAtC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAA,IAAA,CAAU,KAAA,GAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMd,kBAAA,sBAAwB,GAAA,EAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAM1C,eAAA,sBAAqB,GAAA,EAAuB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAM5C,oBAAA,sBAA0B,OAAA,EAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMhD,oBAAA,sBAA0B,GAAA,EAAkB;AAAA;AAAA;AAAA;AAAA,MAI5C,gBAAA,sBAAsB,OAAA;AAAoE,KAC9F;AAUI,IAAA,IAAA,CAAK,aAAa,KAAA,CAAM,SAAA;AAAA,EAC5B;AAAA,EAEA,IAAI,SAAA,GAAsB;AACtB,IAAA,OAAO,IAAA,CAAK,UAAA;AAAA,EAChB;AAAA,EAUA,eAAe,IAAA,EAA0C;AACrD,IAAA,IAAI,OAAO,SAAS,QAAA,EAAU;AAC1B,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,kBAAA,CAAmB,GAAA,CAAI,IAAI,CAAA;AAAA,IACjD,CAAA,MAAO;AACH,MAAA,OAAO,KAAK,KAAA,CAAM,kBAAA,CAAmB,IAAI,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA;AAAA,IAClE;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,qBAAA,CAAsB,aAA6B,OAAA,EAAqB;AACpE,IAAA,MAAM,OAAO,WAAA,CAAY,KAAA;AAEzB,IAAA,IAAA,CAAK,MAAM,oBAAA,CAAqB,GAAA,CAAI,YAAY,KAAA,CAAM,QAAA,IAAY,OAAO,CAAA;AACzE,IAAA,IAAA,CAAK,MAAM,oBAAA,CAAqB,GAAA,CAAI,SAAS,WAAA,CAAY,KAAA,CAAM,UAAU,CAAA;AAKzE,IAAA,IAAI,IAAA,IAAQ,uBAAuBC,kBAAA,EAAgB;AAC/C,MAAA,IAAA,CAAK,MAAM,kBAAA,CAAmB,GAAA,CAAI,KAAK,KAAA,CAAM,QAAA,IAAY,OAAO,CAAA;AAAA,IACpE;AAEA,IAAA,IAAI,YAAY,KAAA,EAAO;AACnB,MAAA,MAAM,UAAU,WAAA,CAAY,KAAA;AAC5B,MAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,eAAA,CAAgB,GAAA,CAAI,OAAO,CAAA,EAAG;AAC1C,QAAA,IAAA,CAAK,MAAM,eAAA,CAAgB,GAAA,CAAI,OAAA,kBAAS,IAAI,KAAK,CAAA;AAAA,MACrD;AACA,MAAA,IAAA,CAAK,MAAM,eAAA,CAAgB,GAAA,CAAI,OAAO,CAAA,CAAG,IAAI,OAAO,CAAA;AAAA,IACxD;AAAA,EACJ;AAAA,EASA,wBAAwB,WAAA,EAAwD;AAC5E,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACjC,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,oBAAA,CAAqB,GAAA,CAAI,WAAW,CAAA;AAAA,IAC1D,CAAA,MAAO;AACH,MAAA,OAAO,KAAK,KAAA,CAAM,oBAAA,CAAqB,IAAI,WAAA,CAAY,KAAA,CAAM,UAAU,CAAA;AAAA,IAC3E;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,yBAAyB,WAAA,EAAmC;AACxD,IAAA,MAAM,OAAA,GAAU,KAAK,KAAA,CAAM,oBAAA,CAAqB,IAAI,WAAA,CAAY,KAAA,CAAM,UAAU,CAAA;AAChF,IAAA,IAAI,OAAA,EAAS;AACT,MAAA,IAAA,CAAK,MAAM,oBAAA,CAAqB,MAAA,CAAO,WAAA,CAAY,KAAA,CAAM,UAAU,CAAA;AACnE,MAAA,IAAA,CAAK,KAAA,CAAM,oBAAA,CAAqB,MAAA,CAAO,OAAO,CAAA;AAE9C,MAAA,MAAM,OAAO,WAAA,CAAY,KAAA;AACzB,MAAA,IAAI,IAAA,IAAQ,uBAAuBA,kBAAA,EAAgB;AAC/C,QAAA,IAAA,CAAK,MAAM,kBAAA,CAAmB,MAAA,CAAO,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA;AAAA,MAC9D;AAEA,MAAA,IAAI,YAAY,KAAA,EAAO;AACnB,QAAA,MAAM,UAAU,WAAA,CAAY,KAAA;AAC5B,QAAA,MAAM,aAAA,GAAgB,IAAA,CAAK,KAAA,CAAM,eAAA,CAAgB,IAAI,OAAO,CAAA;AAC5D,QAAA,IAAI,aAAA,EAAe;AACf,UAAA,aAAA,CAAc,OAAO,OAAO,CAAA;AAC5B,UAAA,IAAI,aAAA,CAAc,SAAS,CAAA,EAAG;AAC1B,YAAA,IAAA,CAAK,KAAA,CAAM,eAAA,CAAgB,MAAA,CAAO,OAAO,CAAA;AAAA,UAC7C;AAAA,QACJ;AAAA,MACJ;AAAA,IACJ;AAAA,EACJ;AAAA,EASA,mBAAmB,WAAA,EAA6D;AAC5E,IAAA,IAAI,OAAO,gBAAgB,QAAA,EAAU;AACjC,MAAA,OAAO,IAAA,CAAK,KAAA,CAAM,eAAA,CAAgB,GAAA,CAAI,WAAW,CAAA;AAAA,IACrD,CAAA,MAAO;AACH,MAAA,OAAO,KAAK,KAAA,CAAM,eAAA,CAAgB,IAAI,WAAA,CAAY,KAAA,CAAM,UAAU,CAAA;AAAA,IACtE;AAAA,EACJ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAA,CAAY,OAAA,EAAe,SAAA,EAAmB,QAAA,EAAoD;AAC9F,IAAA,IAAI,CAAC,IAAA,CAAK,KAAA,CAAM,gBAAA,CAAiB,GAAA,CAAI,OAAO,CAAA,EAAG;AAC3C,MAAA,IAAA,CAAK,MAAM,gBAAA,CAAiB,GAAA,CAAI,OAAA,kBAAS,IAAI,KAAK,CAAA;AAAA,IACtD;AACA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,gBAAA,CAAiB,IAAI,OAAO,CAAA;AACvD,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA,EAAG;AACzB,MAAA,OAAA,CAAQ,GAAA,CAAI,SAAA,kBAAW,IAAI,GAAA,EAAK,CAAA;AAAA,IACpC;AACA,IAAA,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA,CAAG,GAAA,CAAI,QAAQ,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,WAAA,CAAY,SAAe,SAAA,EAAmE;AAC1F,IAAA,MAAM,GAAA,GAAM,KAAK,KAAA,CAAM,gBAAA,CAAiB,IAAI,OAAO,CAAA,EAAG,IAAI,SAAS,CAAA;AACnE,IAAA,IAAI,CAAC,GAAA,IAAO,GAAA,CAAI,IAAA,KAAS,GAAG,OAAO,MAAA;AAEnC,IAAA,OAAO,GAAA,CAAI,MAAA,EAAO,CAAE,IAAA,EAAK,CAAE,KAAA;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,YAAA,CAAa,SAAe,SAAA,EAAwE;AAChG,IAAA,OAAO,KAAK,KAAA,CAAM,gBAAA,CAAiB,IAAI,OAAO,CAAA,EAAG,IAAI,SAAS,CAAA;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,cAAA,CAAe,OAAA,EAAe,SAAA,EAAmB,QAAA,EAAqD;AAClG,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,KAAA,CAAM,gBAAA,CAAiB,IAAI,OAAO,CAAA;AACvD,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAI,QAAA,EAAU;AACV,MAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,GAAA,CAAI,SAAS,CAAA;AACjC,MAAA,IAAI,GAAA,EAAK;AACL,QAAA,GAAA,CAAI,OAAO,QAAQ,CAAA;AACnB,QAAA,IAAI,GAAA,CAAI,IAAA,KAAS,CAAA,EAAG,OAAA,CAAQ,OAAO,SAAS,CAAA;AAAA,MAChD;AAAA,IACJ,CAAA,MAAO;AACH,MAAA,OAAA,CAAQ,OAAO,SAAS,CAAA;AAAA,IAC5B;AAAA,EACJ;AACJ;AAzNaF,4BAAA,GAAN,eAAA,CAAA;AAAA,EAJNG,aAAQ,MAAA,CAAO;AAAA,IACZ,SAAA,EAAW,YAAA;AAAA,IACX,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYH,4BAAA,CAAA","file":"AreHTML.context.js","sourcesContent":["import { AreContext, AreDeclaration, AreInstruction, AreNode } from \"@adaas/are\";\nimport { AreHTMLContextConstructor } from \"./AreHTML.types\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Runtime index for the HTML rendering engine. Maps each AreNode and instruction ASEID to its corresponding DOM element so that apply and revert handlers on interpreter instructions can look up their DOM node in O(1). Tracks root-element mounts and maintains the group-level index used by structural directives.'\n})\nexport class AreHTMLEngineContext extends AreContext {\n\n    /**\n     * Index structure mapping:\n     * \n     *        Node                ->       Group ID        ->  Element\n     * -----------------------------------------------------------------------------------\n     *  | - Attribute             |   group: string       |   Node\n     *  | - Directive (e.g. for)  |                       |   Node\n     */\n\n    protected index = {\n        /**\n         * 1 AreNode = 1 Dom Node\n         * \n         * uses ASEID\n         */\n        nodeToHostElements: new Map<string, Node>(),\n        /**\n         * 1 Group Instruction = MANY Dom Nodes (e.g. for loop)\n         * \n         * uses ASEID\n         */\n        groupToElements: new Map<string, Set<Node>>(),\n        /**\n         * 1 Dom Node = 1 Instruction \n         * \n         * uses ASEID\n         */\n        elementToInstruction: new WeakMap<Node, string>(),\n        /**\n         * 1 Instruction = 1 Dom Node (for CreateElement instructions, for example)\n         * \n         * uses ASEID\n         */\n        instructionToElement: new Map<string, Node>(),\n        /**\n         * Event listeners attached to elements, used for proper cleanup when reverting instructions. Maps a DOM element to a map of event names and their corresponding listeners, allowing the engine to track which listeners are attached to which elements and remove them when necessary (e.g., when an instruction is reverted).\n         */\n        elementListeners: new WeakMap<Node, Map<string, Set<EventListenerOrEventListenerObject>>>()\n    }\n\n    /**\n     * The root container for the HTML engine, which can be either a Document or a ShadowRoot. This is where the engine will mount the generated DOM elements. The context uses this container to manage the relationship between AreNodes, instructions, and their corresponding DOM elements, allowing for efficient updates and cleanups as the application state changes.\n     */\n    protected _container: Document;\n\n\n    constructor(props: Partial<AreHTMLContextConstructor>) {\n        super(props.container?.body.innerHTML || props.source || '');\n        this._container = props.container!;\n    }\n\n    get container(): Document {\n        return this._container;\n    }\n\n\n    /**\n     * Retrieves the DOM element associated with a given AreNode. This method looks up the node's ASEID in the nodeToHostElements map to find the corresponding DOM element. If the node is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific nodes in the AreNode tree, enabling dynamic updates and interactions based on the application state.\n     * \n     * @param nodeASEID \n     */\n    getNodeElement(nodeASEID: string): Node | undefined\n    getNodeElement(node: AreNode): Node | undefined\n    getNodeElement(node: AreNode | string): Node | undefined {\n        if (typeof node === 'string') {\n            return this.index.nodeToHostElements.get(node);\n        } else {\n            return this.index.nodeToHostElements.get(node.aseid.toString());\n        }\n    }\n\n    /**\n     * Associates a DOM element with a given instruction and its owner node. This method updates the context's index to map the instruction's ASEID to the provided DOM element, and also maps the element back to the instruction's ASEID for reverse lookup. If the instruction has an owner node, it also maps the node's ASEID to the element. Additionally, if the instruction belongs to a group, it adds the element to the set of elements associated with that group. This indexing allows the engine to efficiently manage and update DOM elements based on instructions and their corresponding nodes, enabling dynamic rendering and interaction in response to application state changes.\n     * \n     * @param instruction \n     * @param element \n     */\n    setInstructionElement(instruction: AreInstruction, element: Node): void {\n        const node = instruction.owner;\n\n        this.index.instructionToElement.set(instruction.aseid.toString(), element);\n        this.index.elementToInstruction.set(element, instruction.aseid.toString());\n\n        // Only update the host-element pointer for declaration instructions.\n        // Mutations (attributes, styles, event listeners, …) produce auxiliary DOM\n        // that must never overwrite the owning node's primary element in the index.\n        if (node && instruction instanceof AreDeclaration) {\n            this.index.nodeToHostElements.set(node.aseid.toString(), element);\n        }\n\n        if (instruction.group) {\n            const groupId = instruction.group;\n            if (!this.index.groupToElements.has(groupId)) {\n                this.index.groupToElements.set(groupId, new Set());\n            }\n            this.index.groupToElements.get(groupId)!.add(element);\n        }\n    }\n\n    /**\n     * Retrieves the DOM element associated with a given instruction. This method looks up the instruction's ASEID in the instructionToElement map to find the corresponding DOM element. If the instruction is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific instructions, enabling dynamic updates and interactions based on the application state.\n     * \n     * @param instructionASEID \n     */\n    getElementByInstruction(instructionASEID: string): Node | undefined\n    getElementByInstruction(instruction: AreInstruction): Node | undefined\n    getElementByInstruction(instruction: AreInstruction | string): Node | undefined {\n        if (typeof instruction === 'string') {\n            return this.index.instructionToElement.get(instruction);\n        } else {\n            return this.index.instructionToElement.get(instruction.aseid.toString());\n        }\n    }\n\n\n    /**\n     * Removes the association between a given instruction and its corresponding DOM element. This method looks up the instruction's ASEID to find the associated DOM element, and if found, it deletes the mapping from both instructionToElement and elementToInstruction. If the instruction has an owner node, it also removes the mapping from nodeToHostElements. Additionally, if the instruction belongs to a group, it removes the element from the set of elements associated with that group, and if the group has no more elements, it deletes the group from the index. This cleanup is essential for maintaining an accurate and efficient mapping of instructions to DOM elements, especially when instructions are reverted or when nodes are removed from the DOM.\n     * \n     * @param instruction \n     */\n    removeInstructionElement(instruction: AreInstruction): void {\n        const element = this.index.instructionToElement.get(instruction.aseid.toString());\n        if (element) {\n            this.index.instructionToElement.delete(instruction.aseid.toString());\n            this.index.elementToInstruction.delete(element);\n\n            const node = instruction.owner;\n            if (node && instruction instanceof AreDeclaration) {\n                this.index.nodeToHostElements.delete(node.aseid.toString());\n            }\n\n            if (instruction.group) {\n                const groupId = instruction.group;\n                const groupElements = this.index.groupToElements.get(groupId);\n                if (groupElements) {\n                    groupElements.delete(element);\n                    if (groupElements.size === 0) {\n                        this.index.groupToElements.delete(groupId);\n                    }\n                }\n            }\n        }\n    }\n\n    /**\n     * Retrieves the set of DOM elements associated with a given group. This method looks up the group name or instruction's ASEID in the groupToElements map to find the corresponding set of DOM elements. If the group is not found, it returns undefined. This allows the engine to efficiently access and manipulate all DOM elements that belong to a specific group (e.g., all elements generated by a particular loop instruction), enabling dynamic updates and interactions based on the application state.\n     * \n     * @param groupName \n     */\n    getElementsByGroup(groupName: string): Set<Node> | undefined\n    getElementsByGroup(instruction: AreInstruction): Set<Node> | undefined\n    getElementsByGroup(instruction: AreInstruction | string): Set<Node> | undefined {\n        if (typeof instruction === 'string') {\n            return this.index.groupToElements.get(instruction);\n        } else {\n            return this.index.groupToElements.get(instruction.aseid.toString());\n        }\n    }\n\n    /**\n     * Adds an event listener to a specific DOM element and keeps track of it in the context's index for proper cleanup later. This method takes a DOM element, an event name, and a listener function or object, and stores this information in the elementListeners map. This allows the engine to efficiently manage event listeners attached to dynamically created elements, ensuring that they can be removed when the associated instructions are reverted or when nodes are removed from the DOM, preventing memory leaks and unintended behavior.\n     * \n     * @param element \n     * @param eventName \n     * @param listener \n     */\n    addListener(element: Node, eventName: string, listener: EventListenerOrEventListenerObject): void {\n        if (!this.index.elementListeners.has(element)) {\n            this.index.elementListeners.set(element, new Map());\n        }\n        const byEvent = this.index.elementListeners.get(element)!;\n        if (!byEvent.has(eventName)) {\n            byEvent.set(eventName, new Set());\n        }\n        byEvent.get(eventName)!.add(listener);\n    }\n    /**\n     * Retrieves the event listener associated with a specific DOM element and event name from the context's index. This method looks up the element in the elementListeners map and then retrieves the listener for the specified event name. If no listener is found for the given element and event, it returns undefined. This allows the engine to efficiently access and manage event listeners that have been attached to dynamically created elements, enabling proper cleanup when instructions are reverted or when nodes are removed from the DOM.\n     * \n     * @param element \n     * @param eventName \n     * @returns \n     */\n    getListener(element: Node, eventName: string): EventListenerOrEventListenerObject | undefined {\n        const set = this.index.elementListeners.get(element)?.get(eventName);\n        if (!set || set.size === 0) return undefined;\n        // Return the first listener for backwards compatibility.\n        return set.values().next().value;\n    }\n\n    /**\n     * Returns all listeners registered for a given element + event name.\n     */\n    getListeners(element: Node, eventName: string): Set<EventListenerOrEventListenerObject> | undefined {\n        return this.index.elementListeners.get(element)?.get(eventName);\n    }\n    /**\n     * Removes an event listener from a specific DOM element and updates the context's index accordingly. This method looks up the element in the elementListeners map and deletes the listener for the specified event name. This is typically called when an instruction is reverted or when a node is removed from the DOM, ensuring that any attached event listeners are properly cleaned up to prevent memory leaks and unintended behavior.\n     * \n     * @param element \n     * @param eventName \n     */\n    removeListener(element: Node, eventName: string, listener?: EventListenerOrEventListenerObject): void {\n        const byEvent = this.index.elementListeners.get(element);\n        if (!byEvent) return;\n        if (listener) {\n            const set = byEvent.get(eventName);\n            if (set) {\n                set.delete(listener);\n                if (set.size === 0) byEvent.delete(eventName);\n            }\n        } else {\n            byEvent.delete(eventName);\n        }\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/engine/AreHTML.context.ts"],"names":["AreHTMLEngineContext","AreContext","AreDeclaration","A_Frame"],"mappings":"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","file":"AreHTML.context.js","sourcesContent":["import { AreContext, AreDeclaration, AreInstruction, AreNode } from \"@adaas/are\";\nimport { AreHTMLContextConstructor } from \"./AreHTML.types\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Runtime index for the HTML rendering engine. Maps each AreNode and instruction ASEID to its corresponding DOM element so that apply and revert handlers on interpreter instructions can look up their DOM node in O(1). Tracks root-element mounts and maintains the group-level index used by structural directives.'\n})\nexport class AreHTMLEngineContext extends AreContext {\n\n    /**\n     * Index structure mapping:\n     * \n     *        Node                ->       Group ID        ->  Element\n     * -----------------------------------------------------------------------------------\n     *  | - Attribute             |   group: string       |   Node\n     *  | - Directive (e.g. for)  |                       |   Node\n     */\n\n    protected index = {\n        /**\n         * 1 AreNode = 1 Dom Node\n         * \n         * uses ASEID\n         */\n        nodeToHostElements: new Map<string, Node>(),\n        /**\n         * 1 Group Instruction = MANY Dom Nodes (e.g. for loop)\n         * \n         * uses ASEID\n         */\n        groupToElements: new Map<string, Set<Node>>(),\n        /**\n         * 1 Dom Node = 1 Instruction \n         * \n         * uses ASEID\n         */\n        elementToInstruction: new WeakMap<Node, string>(),\n        /**\n         * 1 Instruction = 1 Dom Node (for CreateElement instructions, for example)\n         * \n         * uses ASEID\n         */\n        instructionToElement: new Map<string, Node>(),\n        /**\n         * Event listeners attached to elements, used for proper cleanup when reverting instructions. Maps a DOM element to a map of event names and their corresponding listeners, allowing the engine to track which listeners are attached to which elements and remove them when necessary (e.g., when an instruction is reverted).\n         */\n        elementListeners: new WeakMap<Node, Map<string, Set<EventListenerOrEventListenerObject>>>()\n    }\n\n    /**\n     * The root container for the HTML engine, which can be either a Document or a ShadowRoot. This is where the engine will mount the generated DOM elements. The context uses this container to manage the relationship between AreNodes, instructions, and their corresponding DOM elements, allowing for efficient updates and cleanups as the application state changes.\n     */\n    protected _container: Document;\n\n    /**\n     * Parsed-fragment cache for static islands (see AddStaticHTMLInstruction).\n     *\n     * Keyed by `hostTag\\u0000markup`, each entry holds a `DocumentFragment` whose\n     * children were parsed by the browser exactly once — in the *correct element\n     * context* (the host tag), so table fragments (`<tr>`, `<td>`, …) and other\n     * context-sensitive content parse correctly. Repeated static islands with\n     * identical markup (e.g. list rows, reused components) clone the pre-parsed\n     * fragment instead of re-parsing the HTML string on every mount — turning an\n     * O(parse) operation into an O(clone) one.\n     */\n    protected _staticFragmentCache = new Map<string, DocumentFragment>();\n\n    /**\n     * Live-DOM attachments deferred while a mount pass is batching.\n     *\n     * A freshly-mounted subtree is built inside a *detached* root element, so\n     * every descendant `appendChild`/`insertBefore` happens off-document and\n     * triggers zero layout/paint invalidation. The single mutation that actually\n     * connects the built subtree to the live document is deferred and collected\n     * here, then flushed once when the batch closes — collapsing O(nodes) reflows\n     * into O(1) per mount root.\n     */\n    protected _pendingAttachments: Array<() => void> = [];\n\n    /**\n     * Depth of the currently open batching scopes. Re-entrant so that nested\n     * `beginBatch`/`endBatch` pairs flush exactly once, when the outermost scope\n     * closes.\n     */\n    protected _batchDepth = 0;\n\n\n    constructor(props: Partial<AreHTMLContextConstructor>) {\n        super(props.container?.body.innerHTML || props.source || '');\n        this._container = props.container!;\n    }\n\n    get container(): Document {\n        return this._container;\n    }\n\n    /**\n     * `true` while a synchronous mount pass is batching live-DOM attachments.\n     * Interpreter handlers consult this to decide whether to attach an element\n     * immediately or hand the attachment to {@link deferAttach}.\n     */\n    get isBatching(): boolean {\n        return this._batchDepth > 0;\n    }\n\n    /**\n     * Opens a batching scope. Re-entrant: only the outermost matching\n     * {@link endBatch} flushes the deferred attachments, so a single mount pass\n     * connects its built subtree to the live DOM exactly once.\n     */\n    beginBatch(): void {\n        this._batchDepth++;\n    }\n\n    /**\n     * Registers a live-DOM attachment to run when the current batch flushes. If\n     * no batch is active the attachment runs immediately, preserving the original\n     * synchronous behaviour for updates that mount outside a batch.\n     *\n     * @param attach the DOM mutation that connects a built subtree to the document\n     */\n    deferAttach(attach: () => void): void {\n        if (this._batchDepth > 0) {\n            this._pendingAttachments.push(attach);\n        } else {\n            attach();\n        }\n    }\n\n    /**\n     * Closes a batching scope. When the outermost scope closes, every deferred\n     * attachment runs in registration (document) order, connecting the built\n     * subtrees to the live DOM in a single pass.\n     */\n    endBatch(): void {\n        if (this._batchDepth === 0) return;\n        this._batchDepth--;\n        if (this._batchDepth > 0) return;\n\n        const pending = this._pendingAttachments;\n        this._pendingAttachments = [];\n        for (let i = 0; i < pending.length; i++) {\n            pending[i]();\n        }\n    }\n\n    /**\n     * Returns a `DocumentFragment` containing the parsed form of `html`, parsed\n     * once in the context of `hostTag` (so context-sensitive content such as\n     * table rows/cells parses correctly) and cached thereafter. Callers should\n     * `cloneNode(true)` the returned fragment rather than mutating it, so the\n     * cache stays reusable.\n     *\n     * @param hostTag the tag name of the element the markup will be injected into\n     * @param html    verbatim static-island inner markup\n     */\n    getStaticFragment(hostTag: string, html: string): DocumentFragment {\n        const key = `${hostTag}\\u0000${html}`;\n        let fragment = this._staticFragmentCache.get(key);\n        if (!fragment) {\n            // Parse in the correct element context: the fragment-parsing\n            // algorithm uses the container element's tag to choose the right\n            // insertion mode (e.g. `<tbody>` legitimately allows `<tr>`).\n            const container = this._container.createElement(hostTag);\n            container.innerHTML = html;\n\n            fragment = this._container.createDocumentFragment();\n            while (container.firstChild) {\n                fragment.appendChild(container.firstChild);\n            }\n\n            this._staticFragmentCache.set(key, fragment);\n        }\n        return fragment;\n    }\n\n\n    /**\n     * Retrieves the DOM element associated with a given AreNode. This method looks up the node's ASEID in the nodeToHostElements map to find the corresponding DOM element. If the node is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific nodes in the AreNode tree, enabling dynamic updates and interactions based on the application state.\n     * \n     * @param nodeASEID \n     */\n    getNodeElement(nodeASEID: string): Node | undefined\n    getNodeElement(node: AreNode): Node | undefined\n    getNodeElement(node: AreNode | string): Node | undefined {\n        if (typeof node === 'string') {\n            return this.index.nodeToHostElements.get(node);\n        } else {\n            return this.index.nodeToHostElements.get(node.aseid.toString());\n        }\n    }\n\n    /**\n     * Associates a DOM element with a given instruction and its owner node. This method updates the context's index to map the instruction's ASEID to the provided DOM element, and also maps the element back to the instruction's ASEID for reverse lookup. If the instruction has an owner node, it also maps the node's ASEID to the element. Additionally, if the instruction belongs to a group, it adds the element to the set of elements associated with that group. This indexing allows the engine to efficiently manage and update DOM elements based on instructions and their corresponding nodes, enabling dynamic rendering and interaction in response to application state changes.\n     * \n     * @param instruction \n     * @param element \n     */\n    setInstructionElement(instruction: AreInstruction, element: Node): void {\n        const node = instruction.owner;\n\n        this.index.instructionToElement.set(instruction.aseid.toString(), element);\n        this.index.elementToInstruction.set(element, instruction.aseid.toString());\n\n        // Only update the host-element pointer for declaration instructions.\n        // Mutations (attributes, styles, event listeners, …) produce auxiliary DOM\n        // that must never overwrite the owning node's primary element in the index.\n        if (node && instruction instanceof AreDeclaration) {\n            this.index.nodeToHostElements.set(node.aseid.toString(), element);\n        }\n\n        if (instruction.group) {\n            const groupId = instruction.group;\n            if (!this.index.groupToElements.has(groupId)) {\n                this.index.groupToElements.set(groupId, new Set());\n            }\n            this.index.groupToElements.get(groupId)!.add(element);\n        }\n    }\n\n    /**\n     * Retrieves the DOM element associated with a given instruction. This method looks up the instruction's ASEID in the instructionToElement map to find the corresponding DOM element. If the instruction is not found, it returns undefined. This allows the engine to efficiently access and manipulate the DOM elements that correspond to specific instructions, enabling dynamic updates and interactions based on the application state.\n     * \n     * @param instructionASEID \n     */\n    getElementByInstruction(instructionASEID: string): Node | undefined\n    getElementByInstruction(instruction: AreInstruction): Node | undefined\n    getElementByInstruction(instruction: AreInstruction | string): Node | undefined {\n        if (typeof instruction === 'string') {\n            return this.index.instructionToElement.get(instruction);\n        } else {\n            return this.index.instructionToElement.get(instruction.aseid.toString());\n        }\n    }\n\n\n    /**\n     * Removes the association between a given instruction and its corresponding DOM element. This method looks up the instruction's ASEID to find the associated DOM element, and if found, it deletes the mapping from both instructionToElement and elementToInstruction. If the instruction has an owner node, it also removes the mapping from nodeToHostElements. Additionally, if the instruction belongs to a group, it removes the element from the set of elements associated with that group, and if the group has no more elements, it deletes the group from the index. This cleanup is essential for maintaining an accurate and efficient mapping of instructions to DOM elements, especially when instructions are reverted or when nodes are removed from the DOM.\n     * \n     * @param instruction \n     */\n    removeInstructionElement(instruction: AreInstruction): void {\n        const element = this.index.instructionToElement.get(instruction.aseid.toString());\n        if (element) {\n            this.index.instructionToElement.delete(instruction.aseid.toString());\n            this.index.elementToInstruction.delete(element);\n\n            const node = instruction.owner;\n            if (node && instruction instanceof AreDeclaration) {\n                this.index.nodeToHostElements.delete(node.aseid.toString());\n            }\n\n            if (instruction.group) {\n                const groupId = instruction.group;\n                const groupElements = this.index.groupToElements.get(groupId);\n                if (groupElements) {\n                    groupElements.delete(element);\n                    if (groupElements.size === 0) {\n                        this.index.groupToElements.delete(groupId);\n                    }\n                }\n            }\n        }\n    }\n\n    /**\n     * Retrieves the set of DOM elements associated with a given group. This method looks up the group name or instruction's ASEID in the groupToElements map to find the corresponding set of DOM elements. If the group is not found, it returns undefined. This allows the engine to efficiently access and manipulate all DOM elements that belong to a specific group (e.g., all elements generated by a particular loop instruction), enabling dynamic updates and interactions based on the application state.\n     * \n     * @param groupName \n     */\n    getElementsByGroup(groupName: string): Set<Node> | undefined\n    getElementsByGroup(instruction: AreInstruction): Set<Node> | undefined\n    getElementsByGroup(instruction: AreInstruction | string): Set<Node> | undefined {\n        if (typeof instruction === 'string') {\n            return this.index.groupToElements.get(instruction);\n        } else {\n            return this.index.groupToElements.get(instruction.aseid.toString());\n        }\n    }\n\n    /**\n     * Adds an event listener to a specific DOM element and keeps track of it in the context's index for proper cleanup later. This method takes a DOM element, an event name, and a listener function or object, and stores this information in the elementListeners map. This allows the engine to efficiently manage event listeners attached to dynamically created elements, ensuring that they can be removed when the associated instructions are reverted or when nodes are removed from the DOM, preventing memory leaks and unintended behavior.\n     * \n     * @param element \n     * @param eventName \n     * @param listener \n     */\n    addListener(element: Node, eventName: string, listener: EventListenerOrEventListenerObject): void {\n        if (!this.index.elementListeners.has(element)) {\n            this.index.elementListeners.set(element, new Map());\n        }\n        const byEvent = this.index.elementListeners.get(element)!;\n        if (!byEvent.has(eventName)) {\n            byEvent.set(eventName, new Set());\n        }\n        byEvent.get(eventName)!.add(listener);\n    }\n    /**\n     * Retrieves the event listener associated with a specific DOM element and event name from the context's index. This method looks up the element in the elementListeners map and then retrieves the listener for the specified event name. If no listener is found for the given element and event, it returns undefined. This allows the engine to efficiently access and manage event listeners that have been attached to dynamically created elements, enabling proper cleanup when instructions are reverted or when nodes are removed from the DOM.\n     * \n     * @param element \n     * @param eventName \n     * @returns \n     */\n    getListener(element: Node, eventName: string): EventListenerOrEventListenerObject | undefined {\n        const set = this.index.elementListeners.get(element)?.get(eventName);\n        if (!set || set.size === 0) return undefined;\n        // Return the first listener for backwards compatibility.\n        return set.values().next().value;\n    }\n\n    /**\n     * Returns all listeners registered for a given element + event name.\n     */\n    getListeners(element: Node, eventName: string): Set<EventListenerOrEventListenerObject> | undefined {\n        return this.index.elementListeners.get(element)?.get(eventName);\n    }\n    /**\n     * Removes an event listener from a specific DOM element and updates the context's index accordingly. This method looks up the element in the elementListeners map and deletes the listener for the specified event name. This is typically called when an instruction is reverted or when a node is removed from the DOM, ensuring that any attached event listeners are properly cleaned up to prevent memory leaks and unintended behavior.\n     * \n     * @param element \n     * @param eventName \n     */\n    removeListener(element: Node, eventName: string, listener?: EventListenerOrEventListenerObject): void {\n        const byEvent = this.index.elementListeners.get(element);\n        if (!byEvent) return;\n        if (listener) {\n            const set = byEvent.get(eventName);\n            if (set) {\n                set.delete(listener);\n                if (set.size === 0) byEvent.delete(eventName);\n            }\n        } else {\n            byEvent.delete(eventName);\n        }\n    }\n}\n"]}