@adaas/are-html 0.0.11 → 0.0.13

package/dist/node/{AreBinding.attribute-C6JasbJL.d.ts → AreBinding.attribute-Bm5LlOyE.d.ts}

@@ -98,6 +98,13 @@ declare class AreHTMLNode extends AreNode {
      * The styles defined for the node, which can include inline styles or styles defined in a separate stylesheet that are applied to the node. These styles can be used to control the visual appearance of the node and can be defined using standard CSS syntax.
      */
     get styles(): AreStyle;
+    /**
+     * Registers or updates the component-scoped CSS string for this node.
+     * Called by the @Are.Styles-decorated method on the associated component.
+     * A new AreStyle fragment is registered in scope on first call; subsequent
+     * calls update the existing fragment in-place.
+     */
+    setStyles(css: string): void;
 }
 
 declare class AreHTMLAttribute extends AreAttribute {

package/dist/node/{AreBinding.attribute-C6qrxN8K.d.mts → AreBinding.attribute-doUvtOjc.d.mts}

@@ -98,6 +98,13 @@ declare class AreHTMLNode extends AreNode {
      * The styles defined for the node, which can include inline styles or styles defined in a separate stylesheet that are applied to the node. These styles can be used to control the visual appearance of the node and can be defined using standard CSS syntax.
      */
     get styles(): AreStyle;
+    /**
+     * Registers or updates the component-scoped CSS string for this node.
+     * Called by the @Are.Styles-decorated method on the associated component.
+     * A new AreStyle fragment is registered in scope on first call; subsequent
+     * calls update the existing fragment in-place.
+     */
+    setStyles(css: string): void;
 }
 
 declare class AreHTMLAttribute extends AreAttribute {

package/dist/node/attributes/AreBinding.attribute.d.mts

@@ -1,4 +1,4 @@
-export { A as AreBindingAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+export { A as AreBindingAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.mjs';

package/dist/node/attributes/AreBinding.attribute.d.ts

@@ -1,4 +1,4 @@
-export { A as AreBindingAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+export { A as AreBindingAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.js';

package/dist/node/attributes/AreDirective.attribute.d.mts

@@ -1,4 +1,4 @@
-export { b as AreDirectiveAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+export { b as AreDirectiveAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.mjs';

package/dist/node/attributes/AreDirective.attribute.d.ts

@@ -1,4 +1,4 @@
-export { b as AreDirectiveAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+export { b as AreDirectiveAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.js';

package/dist/node/attributes/AreEvent.attribute.d.mts

@@ -1,4 +1,4 @@
-export { c as AreEventAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+export { c as AreEventAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.mjs';

package/dist/node/attributes/AreEvent.attribute.d.ts

@@ -1,4 +1,4 @@
-export { c as AreEventAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+export { c as AreEventAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.js';

package/dist/node/attributes/AreStatic.attribute.d.mts

@@ -1,4 +1,4 @@
-export { f as AreStaticAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+export { f as AreStaticAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.mjs';

package/dist/node/attributes/AreStatic.attribute.d.ts

@@ -1,4 +1,4 @@
-export { f as AreStaticAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+export { f as AreStaticAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import '@adaas/are';
 import '@adaas/a-concept';
 import '../lib/AreStyle/AreStyle.context.js';

package/dist/node/directives/AreDirectiveFor.directive.d.mts

@@ -1,6 +1,6 @@
 import { A_Scope } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
-import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import { AreStore, AreScene } from '@adaas/are';
 import '../lib/AreStyle/AreStyle.context.mjs';
 

package/dist/node/directives/AreDirectiveFor.directive.d.ts

@@ -1,6 +1,6 @@
 import { A_Scope } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
-import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import { AreStore, AreScene } from '@adaas/are';
 import '../lib/AreStyle/AreStyle.context.js';
 

package/dist/node/directives/AreDirectiveFor.directive.js

@@ -175,7 +175,17 @@ exports.AreDirectiveFor = class AreDirectiveFor extends AreDirective_component.A
         if (arg.startsWith("'") && arg.endsWith("'")) return arg.slice(1, -1);
         if (arg.startsWith('"') && arg.endsWith('"')) return arg.slice(1, -1);
         if (!isNaN(Number(arg))) return Number(arg);
-        return store.get(arg);
+        const stripped = arg.replace(/\?$/, "");
+        if (stripped.includes(".")) {
+          const parts = stripped.split(".").map((p) => p.replace(/\?$/, ""));
+          let val = store.get(parts[0]);
+          for (let j = 1; j < parts.length; j++) {
+            if (val == null) return void 0;
+            val = val[parts[j]];
+          }
+          return val ?? void 0;
+        }
+        return store.get(stripped);
       });
       result = fn(...resolvedArgs);
     } else if (arrayExpr.includes(".")) {

package/dist/node/directives/AreDirectiveFor.directive.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/directives/AreDirectiveFor.directive.ts"],"names":["AreDirectiveFor","AreDirective","AddCommentInstruction","AreDirectiveContext","AreCompilerError","A_Caller","A_Scope","AreStore","AreScene","A_Logger","A_Frame"],"mappings":"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","file":"AreDirectiveFor.directive.js","sourcesContent":["import { A_Caller, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreCompilerError, AreScene, AreStore } from \"@adaas/are\";\nimport { AreDirective } from \"@adaas/are-html/directive/AreDirective.component\";\nimport { AddCommentInstruction } from \"@adaas/are-html/instructions/AddComment.instruction\";\nimport { AreHTMLNode } from \"@adaas/are-html/node\";\nimport { AreDirectiveContext } from \"@adaas/are-html/directive/AreDirective.context\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\ntype AreForExpression = {\n    key: string;\n    index: string | undefined;\n    arrayExpr: string;\n    /** Optional `track <expr>` clause, e.g. `track row.id` */\n    trackExpr: string | undefined;\n};\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Built-in $for directive. Iterates over an array expression resolved from the store and renders a cloned template fragment per item, managing per-item subscopes and comment-node anchors. Supports keyed diffing via an optional track clause to minimise DOM mutations on collection updates.'\n})\n@AreDirective.Priority(1)\nexport class AreDirectiveFor extends AreDirective {\n\n\n    @AreDirective.Transform\n    transform(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger: A_Logger,\n        ...args: any[]\n    ) {\n\n        logger.debug(`[Transform] directive $FOR for <${attribute.owner.aseid.toString()}>`)\n\n        const node = attribute.owner;\n\n        /**\n         * Transfer the original node's scope (with all registered attributes and children)\n         * to the template clone, and give the owner node a fresh empty scope.\n         * This mirrors the $if directive's approach, making the owner a lightweight\n         * group container whose sole visible presence is a comment placeholder.\n         */\n        const forTemplate = node.cloneWithScope();\n\n        /**\n         * Remove the $for attribute from the template so iterative clones do not\n         * re-trigger this directive during their own transform phase.\n         * Re-register it on the owner so the reactive compile/update pipeline keeps working.\n         */\n        const forAttr = forTemplate.attributes.find(d => d.name === attribute.name);\n\n        if (forAttr) {\n            forTemplate.scope.deregister(forAttr);\n            node.scope.register(forAttr);\n        }\n\n        /**\n         * Re-initialize the owner node with its fresh scope so it becomes a valid\n         * group container that will own the generated item nodes as children.\n         */\n        node.init();\n\n        /**\n         * Store the template for use in compile and update.\n         */\n        attribute.template = forTemplate;\n\n\n        /**\n         * Parse the $for expression and evaluate the source array.\n         */\n        const { key, index, arrayExpr } = this.parseExpression(attribute.content);\n        const array = this.resolveArray(store, arrayExpr, attribute.content);\n\n        attribute.value = array;\n\n        /**\n         * For each item in the array, spawn a clone of the template with the\n         * item's store values pre-set and its scene activated.\n         *\n         * The children are added to the owner node before the main compiler's\n         * children iteration loop runs, so the main cycle will compile them —\n         * no explicit child.compile() call is needed here.\n         */\n        for (let i = 0; i < array.length; i++) {\n            this.spawnItemNode(attribute.template!, attribute.owner, key, index, array[i], i);\n        }\n    }\n\n\n    @AreDirective.Compile\n    compile(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Replace the group node's default host declaration with a comment placeholder\n         * so the owner element itself does not render as a DOM element — the item nodes\n         * render as its children instead.\n         */\n        const hostInstruction = scene.host!;\n        const commentIdentifier = ` --- for: ${attribute.template!.id} --- `;\n        const declaration = new AddCommentInstruction({ content: commentIdentifier });\n\n        scene.setHost(declaration);\n        scene.planBefore(declaration, hostInstruction);\n        scene.unPlan(hostInstruction);\n    }\n\n\n    @AreDirective.Update\n    update(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Re-evaluate the source array.\n         */\n        const { key, index, arrayExpr, trackExpr } = this.parseExpression(attribute.content);\n        const newArray = this.resolveArray(store, arrayExpr, attribute.content);\n\n        const owner = attribute.owner;\n        const currentChildren = [...owner.children] as AreHTMLNode[];\n\n        attribute.value = newArray;\n\n        const computeKey = this.makeKeyFn(key, index, trackExpr);\n\n        // ── 1. Index existing children by stable key ────────────────────────\n        const childByKey = new Map<any, AreHTMLNode>();\n        const remaining = new Set<AreHTMLNode>();\n\n        for (let i = 0; i < currentChildren.length; i++) {\n            const child = currentChildren[i];\n            const ctx = child.scope.resolveFlat(AreDirectiveContext);\n            const k = ctx ? computeKey(ctx.scope[key], ctx.scope[index || 'index']) : Symbol('orphan');\n            childByKey.set(k, child);\n            remaining.add(child);\n        }\n\n        // ── 2. Walk desired list; reuse existing or spawn new ───────────────\n        const desired: AreHTMLNode[] = [];\n        const newOnes: AreHTMLNode[] = [];\n\n        for (let i = 0; i < newArray.length; i++) {\n            const item = newArray[i];\n            const k = computeKey(item, i);\n            const existing = childByKey.get(k);\n\n            if (existing) {\n                remaining.delete(existing);\n\n                let directiveContext = existing.scope.resolveFlat(AreDirectiveContext);\n                if (!directiveContext) {\n                    directiveContext = new AreDirectiveContext(existing.aseid);\n                    existing.scope.register(directiveContext);\n                }\n                directiveContext.scope = {\n                    ...directiveContext.scope,\n                    [key]: item,\n                    [index || 'index']: i,\n                };\n                desired.push(existing);\n            } else {\n                const itemNode = this.spawnItemNode(attribute.template!, owner, key, index, item, i);\n                desired.push(itemNode);\n                newOnes.push(itemNode);\n            }\n        }\n\n        // ── 3. Unmount + detach removed children ─────────────────────────────\n        for (const child of remaining) {\n            child.unmount();\n            owner.removeChild(child);\n        }\n\n        // ── 4. Mount only the new ones (kept children stay where they are). ─\n        for (const child of newOnes) {\n            child.transform();\n            child.compile();\n            child.mount();\n        }\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Helpers ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Build a key-function that derives a stable identity from each item.\n     * If the user provided a `track <expr>` clause, evaluate it as a path on\n     * the item; otherwise fall back to the item identity (reference equality).\n     */\n    private makeKeyFn(key: string, index: string | undefined, trackExpr: string | undefined): (item: any, i: number) => any {\n        if (!trackExpr) {\n            return (item, i) => item ?? i;\n        }\n\n        // Strip any leading `key.` so users can write `track row.id`.\n        const path = trackExpr.startsWith(key + '.') ? trackExpr.slice(key.length + 1) : trackExpr;\n\n        return (item, i) => {\n            if (item == null) return i;\n            if (path === key || path === '$index') return path === '$index' ? i : item;\n\n            // dotted path lookup\n            const parts = path.split('.');\n            let v: any = item;\n            for (const p of parts) {\n                if (v == null) return i;\n                v = v[p];\n            }\n            return v ?? i;\n        };\n    }\n\n    /**\n     * Parses the $for expression string into its constituent parts.\n     *\n     * Supported formats:\n     *   item in items\n     *   item, index in items\n     *   (item, index) in items\n     *   item in filter(items)\n     *   item, index in filter(items, 'active')\n     *   item in items track item.id\n     *   (item, i) in items track item.id\n     */\n    private parseExpression(content: string): AreForExpression {\n        // Strip optional `track <expr>` suffix first.\n        let trackExpr: string | undefined;\n        const trackIdx = content.search(/\\s+track\\s+/);\n        let body = content;\n        if (trackIdx !== -1) {\n            const m = content.slice(trackIdx).match(/\\s+track\\s+(.+)$/);\n            if (m) {\n                trackExpr = m[1].trim();\n                body = content.slice(0, trackIdx).trim();\n            }\n        }\n\n        const inIndex = body.lastIndexOf(' in ');\n        const keyAndIndex = body.slice(0, inIndex).trim().replace(/^\\(|\\)$/g, '');\n        const arrayExpr = body.slice(inIndex + 4).trim();\n        const keyParts = keyAndIndex.split(',').map(p => p.trim());\n\n        return {\n            key: keyParts[0],\n            index: keyParts[1] || undefined,\n            arrayExpr,\n            trackExpr,\n        };\n    }\n\n    /**\n     * Resolves the array expression against the store.\n     * Supports both plain key lookups and function-call expressions:\n     *   items          → store.get('items')\n     *   filter(items)  → store.get('filter')(store.get('items'))\n     */\n    private resolveArray(store: AreStore, arrayExpr: string, fullContent: string): any[] {\n        let result: any;\n        const callMatch = arrayExpr.match(/^([^(]+)\\((.+)\\)$/);\n\n        if (callMatch) {\n            const fnName = callMatch[1].trim();\n            const fn = store.get(fnName as any);\n\n            if (typeof fn !== 'function')\n                throw new AreCompilerError({\n                    title: 'Invalid \"for\" Directive Function',\n                    description: `The expression \"${fnName}\" in the \"for\" directive does not resolve to a function in the store. Received: ${typeof fn}`,\n                });\n\n            const rawArgs = callMatch[2].split(',').map(a => a.trim());\n            const resolvedArgs = rawArgs.map(arg => {\n                if (arg.startsWith(\"'\") && arg.endsWith(\"'\")) return arg.slice(1, -1);\n                if (arg.startsWith('\"') && arg.endsWith('\"')) return arg.slice(1, -1);\n                if (!isNaN(Number(arg))) return Number(arg);\n                return store.get(arg as any);\n            });\n\n            result = (fn as Function)(...resolvedArgs);\n        } else if (arrayExpr.includes('.')) {\n            // dotted-path lookup: e.g. \"list.items\" or \"record?.keywords\"\n            // Strip optional-chaining `?` suffix from each segment so that\n            // `record?.keywords` resolves the same as `record.keywords`.\n            const parts = arrayExpr.split('.').map(p => p.replace(/\\?$/, ''));\n            result = store.get(parts[0] as any);\n            for (let i = 1; i < parts.length; i++) {\n                if (result == null) break;\n                result = result[parts[i]];\n            }\n        } else {\n            result = store.get(arrayExpr.replace(/\\?$/, '') as any);\n        }\n\n        // null / undefined from optional-chaining expressions (e.g. `record?.keywords`)\n        // means the source object is not yet loaded — treat as empty array so the\n        // directive initialises gracefully and fills in when the store updates.\n        if (result == null) return [];\n\n        if (!Array.isArray(result))\n            throw new AreCompilerError({\n                title: 'Invalid \"for\" Directive Value',\n                description: `The \"for\" directive expects an array but got ${typeof result}. Expression: \"${fullContent}\". Received: ${JSON.stringify(result)}`,\n            });\n\n        return result;\n    }\n\n    /**\n     * Creates a single item node from the template, registers it as a child of\n     * the owner, initialises it, injects item-scoped store values, and activates\n     * its scene so the mount/compile cycle will include it.\n     *\n     * NOTE: This method does NOT call compile() or mount() — the caller is\n     * responsible for doing so when the main lifecycle cycle won't cover it\n     * (i.e. during update, but not during the initial compile phase).\n     */\n    private spawnItemNode(\n        template: AreHTMLNode,\n        owner: AreHTMLNode,\n        key: string,\n        index: string | undefined,\n        item: any,\n        i: number,\n    ): AreHTMLNode {\n        const itemNode = template.clone() as AreHTMLNode;\n\n        owner.addChild(itemNode);\n\n        const queue = [itemNode];\n\n        while (queue.length > 0) {\n            const current = queue.shift()!\n\n            current.init();\n\n            queue.push(...current.children as AreHTMLNode[]);\n        }\n\n        /**\n         * Resolve or create a directive context for the item node. This is needed to hold the item-specific store values (e.g. the \"item\" and \"index\" in a \"for\" loop) that the template's bindings will reference during compile and update. The context is shared among all clones of the same template, but that's fine because each clone gets its own scope values assigned here.\n         */\n        let directiveContext = itemNode.scope.resolveFlat(AreDirectiveContext);\n\n        if (!directiveContext) {\n            directiveContext = new AreDirectiveContext(itemNode.aseid);\n            itemNode.scope.register(directiveContext);\n        }\n\n        directiveContext.scope = {\n            ...directiveContext.scope,\n            [key]: item,\n            [index || 'index']: i,\n        }\n\n        itemNode.scene.activate();\n\n        return itemNode;\n    }\n}"]}
+{"version":3,"sources":["../../../src/directives/AreDirectiveFor.directive.ts"],"names":["AreDirectiveFor","AreDirective","AddCommentInstruction","AreDirectiveContext","AreCompilerError","A_Caller","A_Scope","AreStore","AreScene","A_Logger","A_Frame"],"mappings":"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","file":"AreDirectiveFor.directive.js","sourcesContent":["import { A_Caller, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreCompilerError, AreScene, AreStore } from \"@adaas/are\";\nimport { AreDirective } from \"@adaas/are-html/directive/AreDirective.component\";\nimport { AddCommentInstruction } from \"@adaas/are-html/instructions/AddComment.instruction\";\nimport { AreHTMLNode } from \"@adaas/are-html/node\";\nimport { AreDirectiveContext } from \"@adaas/are-html/directive/AreDirective.context\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\ntype AreForExpression = {\n    key: string;\n    index: string | undefined;\n    arrayExpr: string;\n    /** Optional `track <expr>` clause, e.g. `track row.id` */\n    trackExpr: string | undefined;\n};\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Built-in $for directive. Iterates over an array expression resolved from the store and renders a cloned template fragment per item, managing per-item subscopes and comment-node anchors. Supports keyed diffing via an optional track clause to minimise DOM mutations on collection updates.'\n})\n@AreDirective.Priority(1)\nexport class AreDirectiveFor extends AreDirective {\n\n\n    @AreDirective.Transform\n    transform(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger: A_Logger,\n        ...args: any[]\n    ) {\n\n        logger.debug(`[Transform] directive $FOR for <${attribute.owner.aseid.toString()}>`)\n\n        const node = attribute.owner;\n\n        /**\n         * Transfer the original node's scope (with all registered attributes and children)\n         * to the template clone, and give the owner node a fresh empty scope.\n         * This mirrors the $if directive's approach, making the owner a lightweight\n         * group container whose sole visible presence is a comment placeholder.\n         */\n        const forTemplate = node.cloneWithScope();\n\n        /**\n         * Remove the $for attribute from the template so iterative clones do not\n         * re-trigger this directive during their own transform phase.\n         * Re-register it on the owner so the reactive compile/update pipeline keeps working.\n         */\n        const forAttr = forTemplate.attributes.find(d => d.name === attribute.name);\n\n        if (forAttr) {\n            forTemplate.scope.deregister(forAttr);\n            node.scope.register(forAttr);\n        }\n\n        /**\n         * Re-initialize the owner node with its fresh scope so it becomes a valid\n         * group container that will own the generated item nodes as children.\n         */\n        node.init();\n\n        /**\n         * Store the template for use in compile and update.\n         */\n        attribute.template = forTemplate;\n\n\n        /**\n         * Parse the $for expression and evaluate the source array.\n         */\n        const { key, index, arrayExpr } = this.parseExpression(attribute.content);\n        const array = this.resolveArray(store, arrayExpr, attribute.content);\n\n        attribute.value = array;\n\n        /**\n         * For each item in the array, spawn a clone of the template with the\n         * item's store values pre-set and its scene activated.\n         *\n         * The children are added to the owner node before the main compiler's\n         * children iteration loop runs, so the main cycle will compile them —\n         * no explicit child.compile() call is needed here.\n         */\n        for (let i = 0; i < array.length; i++) {\n            this.spawnItemNode(attribute.template!, attribute.owner, key, index, array[i], i);\n        }\n    }\n\n\n    @AreDirective.Compile\n    compile(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Replace the group node's default host declaration with a comment placeholder\n         * so the owner element itself does not render as a DOM element — the item nodes\n         * render as its children instead.\n         */\n        const hostInstruction = scene.host!;\n        const commentIdentifier = ` --- for: ${attribute.template!.id} --- `;\n        const declaration = new AddCommentInstruction({ content: commentIdentifier });\n\n        scene.setHost(declaration);\n        scene.planBefore(declaration, hostInstruction);\n        scene.unPlan(hostInstruction);\n    }\n\n\n    @AreDirective.Update\n    update(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Re-evaluate the source array.\n         */\n        const { key, index, arrayExpr, trackExpr } = this.parseExpression(attribute.content);\n        const newArray = this.resolveArray(store, arrayExpr, attribute.content);\n\n        const owner = attribute.owner;\n        const currentChildren = [...owner.children] as AreHTMLNode[];\n\n        attribute.value = newArray;\n\n        const computeKey = this.makeKeyFn(key, index, trackExpr);\n\n        // ── 1. Index existing children by stable key ────────────────────────\n        const childByKey = new Map<any, AreHTMLNode>();\n        const remaining = new Set<AreHTMLNode>();\n\n        for (let i = 0; i < currentChildren.length; i++) {\n            const child = currentChildren[i];\n            const ctx = child.scope.resolveFlat(AreDirectiveContext);\n            const k = ctx ? computeKey(ctx.scope[key], ctx.scope[index || 'index']) : Symbol('orphan');\n            childByKey.set(k, child);\n            remaining.add(child);\n        }\n\n        // ── 2. Walk desired list; reuse existing or spawn new ───────────────\n        const desired: AreHTMLNode[] = [];\n        const newOnes: AreHTMLNode[] = [];\n\n        for (let i = 0; i < newArray.length; i++) {\n            const item = newArray[i];\n            const k = computeKey(item, i);\n            const existing = childByKey.get(k);\n\n            if (existing) {\n                remaining.delete(existing);\n\n                let directiveContext = existing.scope.resolveFlat(AreDirectiveContext);\n                if (!directiveContext) {\n                    directiveContext = new AreDirectiveContext(existing.aseid);\n                    existing.scope.register(directiveContext);\n                }\n                directiveContext.scope = {\n                    ...directiveContext.scope,\n                    [key]: item,\n                    [index || 'index']: i,\n                };\n                desired.push(existing);\n            } else {\n                const itemNode = this.spawnItemNode(attribute.template!, owner, key, index, item, i);\n                desired.push(itemNode);\n                newOnes.push(itemNode);\n            }\n        }\n\n        // ── 3. Unmount + detach removed children ─────────────────────────────\n        for (const child of remaining) {\n            child.unmount();\n            owner.removeChild(child);\n        }\n\n        // ── 4. Mount only the new ones (kept children stay where they are). ─\n        for (const child of newOnes) {\n            child.transform();\n            child.compile();\n            child.mount();\n        }\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Helpers ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Build a key-function that derives a stable identity from each item.\n     * If the user provided a `track <expr>` clause, evaluate it as a path on\n     * the item; otherwise fall back to the item identity (reference equality).\n     */\n    private makeKeyFn(key: string, index: string | undefined, trackExpr: string | undefined): (item: any, i: number) => any {\n        if (!trackExpr) {\n            return (item, i) => item ?? i;\n        }\n\n        // Strip any leading `key.` so users can write `track row.id`.\n        const path = trackExpr.startsWith(key + '.') ? trackExpr.slice(key.length + 1) : trackExpr;\n\n        return (item, i) => {\n            if (item == null) return i;\n            if (path === key || path === '$index') return path === '$index' ? i : item;\n\n            // dotted path lookup\n            const parts = path.split('.');\n            let v: any = item;\n            for (const p of parts) {\n                if (v == null) return i;\n                v = v[p];\n            }\n            return v ?? i;\n        };\n    }\n\n    /**\n     * Parses the $for expression string into its constituent parts.\n     *\n     * Supported formats:\n     *   item in items\n     *   item, index in items\n     *   (item, index) in items\n     *   item in filter(items)\n     *   item, index in filter(items, 'active')\n     *   item in items track item.id\n     *   (item, i) in items track item.id\n     */\n    private parseExpression(content: string): AreForExpression {\n        // Strip optional `track <expr>` suffix first.\n        let trackExpr: string | undefined;\n        const trackIdx = content.search(/\\s+track\\s+/);\n        let body = content;\n        if (trackIdx !== -1) {\n            const m = content.slice(trackIdx).match(/\\s+track\\s+(.+)$/);\n            if (m) {\n                trackExpr = m[1].trim();\n                body = content.slice(0, trackIdx).trim();\n            }\n        }\n\n        const inIndex = body.lastIndexOf(' in ');\n        const keyAndIndex = body.slice(0, inIndex).trim().replace(/^\\(|\\)$/g, '');\n        const arrayExpr = body.slice(inIndex + 4).trim();\n        const keyParts = keyAndIndex.split(',').map(p => p.trim());\n\n        return {\n            key: keyParts[0],\n            index: keyParts[1] || undefined,\n            arrayExpr,\n            trackExpr,\n        };\n    }\n\n    /**\n     * Resolves the array expression against the store.\n     * Supports both plain key lookups and function-call expressions:\n     *   items          → store.get('items')\n     *   filter(items)  → store.get('filter')(store.get('items'))\n     */\n    private resolveArray(store: AreStore, arrayExpr: string, fullContent: string): any[] {\n        let result: any;\n        const callMatch = arrayExpr.match(/^([^(]+)\\((.+)\\)$/);\n\n        if (callMatch) {\n            const fnName = callMatch[1].trim();\n            const fn = store.get(fnName as any);\n\n            if (typeof fn !== 'function')\n                throw new AreCompilerError({\n                    title: 'Invalid \"for\" Directive Function',\n                    description: `The expression \"${fnName}\" in the \"for\" directive does not resolve to a function in the store. Received: ${typeof fn}`,\n                });\n\n            const rawArgs = callMatch[2].split(',').map(a => a.trim());\n            const resolvedArgs = rawArgs.map(arg => {\n                if (arg.startsWith(\"'\") && arg.endsWith(\"'\")) return arg.slice(1, -1);\n                if (arg.startsWith('\"') && arg.endsWith('\"')) return arg.slice(1, -1);\n                if (!isNaN(Number(arg))) return Number(arg);\n                // Dotted-path / optional-chain: e.g. `record?.embedding` or `record.data`\n                const stripped = arg.replace(/\\?$/, '');\n                if (stripped.includes('.')) {\n                    const parts = stripped.split('.').map(p => p.replace(/\\?$/, ''));\n                    let val: any = store.get(parts[0] as any);\n                    for (let j = 1; j < parts.length; j++) {\n                        if (val == null) return undefined;\n                        val = val[parts[j]];\n                    }\n                    return val ?? undefined;\n                }\n                return store.get(stripped as any);\n            });\n\n            result = (fn as Function)(...resolvedArgs);\n        } else if (arrayExpr.includes('.')) {\n            // dotted-path lookup: e.g. \"list.items\" or \"record?.keywords\"\n            // Strip optional-chaining `?` suffix from each segment so that\n            // `record?.keywords` resolves the same as `record.keywords`.\n            const parts = arrayExpr.split('.').map(p => p.replace(/\\?$/, ''));\n            result = store.get(parts[0] as any);\n            for (let i = 1; i < parts.length; i++) {\n                if (result == null) break;\n                result = result[parts[i]];\n            }\n        } else {\n            result = store.get(arrayExpr.replace(/\\?$/, '') as any);\n        }\n\n        // null / undefined from optional-chaining expressions (e.g. `record?.keywords`)\n        // means the source object is not yet loaded — treat as empty array so the\n        // directive initialises gracefully and fills in when the store updates.\n        if (result == null) return [];\n\n        if (!Array.isArray(result))\n            throw new AreCompilerError({\n                title: 'Invalid \"for\" Directive Value',\n                description: `The \"for\" directive expects an array but got ${typeof result}. Expression: \"${fullContent}\". Received: ${JSON.stringify(result)}`,\n            });\n\n        return result;\n    }\n\n    /**\n     * Creates a single item node from the template, registers it as a child of\n     * the owner, initialises it, injects item-scoped store values, and activates\n     * its scene so the mount/compile cycle will include it.\n     *\n     * NOTE: This method does NOT call compile() or mount() — the caller is\n     * responsible for doing so when the main lifecycle cycle won't cover it\n     * (i.e. during update, but not during the initial compile phase).\n     */\n    private spawnItemNode(\n        template: AreHTMLNode,\n        owner: AreHTMLNode,\n        key: string,\n        index: string | undefined,\n        item: any,\n        i: number,\n    ): AreHTMLNode {\n        const itemNode = template.clone() as AreHTMLNode;\n\n        owner.addChild(itemNode);\n\n        const queue = [itemNode];\n\n        while (queue.length > 0) {\n            const current = queue.shift()!\n\n            current.init();\n\n            queue.push(...current.children as AreHTMLNode[]);\n        }\n\n        /**\n         * Resolve or create a directive context for the item node. This is needed to hold the item-specific store values (e.g. the \"item\" and \"index\" in a \"for\" loop) that the template's bindings will reference during compile and update. The context is shared among all clones of the same template, but that's fine because each clone gets its own scope values assigned here.\n         */\n        let directiveContext = itemNode.scope.resolveFlat(AreDirectiveContext);\n\n        if (!directiveContext) {\n            directiveContext = new AreDirectiveContext(itemNode.aseid);\n            itemNode.scope.register(directiveContext);\n        }\n\n        directiveContext.scope = {\n            ...directiveContext.scope,\n            [key]: item,\n            [index || 'index']: i,\n        }\n\n        itemNode.scene.activate();\n\n        return itemNode;\n    }\n}"]}

package/dist/node/directives/AreDirectiveFor.directive.mjs

@@ -163,7 +163,17 @@ let AreDirectiveFor = class extends AreDirective {
         if (arg.startsWith("'") && arg.endsWith("'")) return arg.slice(1, -1);
         if (arg.startsWith('"') && arg.endsWith('"')) return arg.slice(1, -1);
         if (!isNaN(Number(arg))) return Number(arg);
-        return store.get(arg);
+        const stripped = arg.replace(/\?$/, "");
+        if (stripped.includes(".")) {
+          const parts = stripped.split(".").map((p) => p.replace(/\?$/, ""));
+          let val = store.get(parts[0]);
+          for (let j = 1; j < parts.length; j++) {
+            if (val == null) return void 0;
+            val = val[parts[j]];
+          }
+          return val ?? void 0;
+        }
+        return store.get(stripped);
       });
       result = fn(...resolvedArgs);
     } else if (arrayExpr.includes(".")) {

package/dist/node/directives/AreDirectiveFor.directive.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/directives/AreDirectiveFor.directive.ts"],"names":[],"mappings":"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","file":"AreDirectiveFor.directive.mjs","sourcesContent":["import { A_Caller, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreCompilerError, AreScene, AreStore } from \"@adaas/are\";\nimport { AreDirective } from \"@adaas/are-html/directive/AreDirective.component\";\nimport { AddCommentInstruction } from \"@adaas/are-html/instructions/AddComment.instruction\";\nimport { AreHTMLNode } from \"@adaas/are-html/node\";\nimport { AreDirectiveContext } from \"@adaas/are-html/directive/AreDirective.context\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\ntype AreForExpression = {\n    key: string;\n    index: string | undefined;\n    arrayExpr: string;\n    /** Optional `track <expr>` clause, e.g. `track row.id` */\n    trackExpr: string | undefined;\n};\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Built-in $for directive. Iterates over an array expression resolved from the store and renders a cloned template fragment per item, managing per-item subscopes and comment-node anchors. Supports keyed diffing via an optional track clause to minimise DOM mutations on collection updates.'\n})\n@AreDirective.Priority(1)\nexport class AreDirectiveFor extends AreDirective {\n\n\n    @AreDirective.Transform\n    transform(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger: A_Logger,\n        ...args: any[]\n    ) {\n\n        logger.debug(`[Transform] directive $FOR for <${attribute.owner.aseid.toString()}>`)\n\n        const node = attribute.owner;\n\n        /**\n         * Transfer the original node's scope (with all registered attributes and children)\n         * to the template clone, and give the owner node a fresh empty scope.\n         * This mirrors the $if directive's approach, making the owner a lightweight\n         * group container whose sole visible presence is a comment placeholder.\n         */\n        const forTemplate = node.cloneWithScope();\n\n        /**\n         * Remove the $for attribute from the template so iterative clones do not\n         * re-trigger this directive during their own transform phase.\n         * Re-register it on the owner so the reactive compile/update pipeline keeps working.\n         */\n        const forAttr = forTemplate.attributes.find(d => d.name === attribute.name);\n\n        if (forAttr) {\n            forTemplate.scope.deregister(forAttr);\n            node.scope.register(forAttr);\n        }\n\n        /**\n         * Re-initialize the owner node with its fresh scope so it becomes a valid\n         * group container that will own the generated item nodes as children.\n         */\n        node.init();\n\n        /**\n         * Store the template for use in compile and update.\n         */\n        attribute.template = forTemplate;\n\n\n        /**\n         * Parse the $for expression and evaluate the source array.\n         */\n        const { key, index, arrayExpr } = this.parseExpression(attribute.content);\n        const array = this.resolveArray(store, arrayExpr, attribute.content);\n\n        attribute.value = array;\n\n        /**\n         * For each item in the array, spawn a clone of the template with the\n         * item's store values pre-set and its scene activated.\n         *\n         * The children are added to the owner node before the main compiler's\n         * children iteration loop runs, so the main cycle will compile them —\n         * no explicit child.compile() call is needed here.\n         */\n        for (let i = 0; i < array.length; i++) {\n            this.spawnItemNode(attribute.template!, attribute.owner, key, index, array[i], i);\n        }\n    }\n\n\n    @AreDirective.Compile\n    compile(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Replace the group node's default host declaration with a comment placeholder\n         * so the owner element itself does not render as a DOM element — the item nodes\n         * render as its children instead.\n         */\n        const hostInstruction = scene.host!;\n        const commentIdentifier = ` --- for: ${attribute.template!.id} --- `;\n        const declaration = new AddCommentInstruction({ content: commentIdentifier });\n\n        scene.setHost(declaration);\n        scene.planBefore(declaration, hostInstruction);\n        scene.unPlan(hostInstruction);\n    }\n\n\n    @AreDirective.Update\n    update(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Re-evaluate the source array.\n         */\n        const { key, index, arrayExpr, trackExpr } = this.parseExpression(attribute.content);\n        const newArray = this.resolveArray(store, arrayExpr, attribute.content);\n\n        const owner = attribute.owner;\n        const currentChildren = [...owner.children] as AreHTMLNode[];\n\n        attribute.value = newArray;\n\n        const computeKey = this.makeKeyFn(key, index, trackExpr);\n\n        // ── 1. Index existing children by stable key ────────────────────────\n        const childByKey = new Map<any, AreHTMLNode>();\n        const remaining = new Set<AreHTMLNode>();\n\n        for (let i = 0; i < currentChildren.length; i++) {\n            const child = currentChildren[i];\n            const ctx = child.scope.resolveFlat(AreDirectiveContext);\n            const k = ctx ? computeKey(ctx.scope[key], ctx.scope[index || 'index']) : Symbol('orphan');\n            childByKey.set(k, child);\n            remaining.add(child);\n        }\n\n        // ── 2. Walk desired list; reuse existing or spawn new ───────────────\n        const desired: AreHTMLNode[] = [];\n        const newOnes: AreHTMLNode[] = [];\n\n        for (let i = 0; i < newArray.length; i++) {\n            const item = newArray[i];\n            const k = computeKey(item, i);\n            const existing = childByKey.get(k);\n\n            if (existing) {\n                remaining.delete(existing);\n\n                let directiveContext = existing.scope.resolveFlat(AreDirectiveContext);\n                if (!directiveContext) {\n                    directiveContext = new AreDirectiveContext(existing.aseid);\n                    existing.scope.register(directiveContext);\n                }\n                directiveContext.scope = {\n                    ...directiveContext.scope,\n                    [key]: item,\n                    [index || 'index']: i,\n                };\n                desired.push(existing);\n            } else {\n                const itemNode = this.spawnItemNode(attribute.template!, owner, key, index, item, i);\n                desired.push(itemNode);\n                newOnes.push(itemNode);\n            }\n        }\n\n        // ── 3. Unmount + detach removed children ─────────────────────────────\n        for (const child of remaining) {\n            child.unmount();\n            owner.removeChild(child);\n        }\n\n        // ── 4. Mount only the new ones (kept children stay where they are). ─\n        for (const child of newOnes) {\n            child.transform();\n            child.compile();\n            child.mount();\n        }\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Helpers ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Build a key-function that derives a stable identity from each item.\n     * If the user provided a `track <expr>` clause, evaluate it as a path on\n     * the item; otherwise fall back to the item identity (reference equality).\n     */\n    private makeKeyFn(key: string, index: string | undefined, trackExpr: string | undefined): (item: any, i: number) => any {\n        if (!trackExpr) {\n            return (item, i) => item ?? i;\n        }\n\n        // Strip any leading `key.` so users can write `track row.id`.\n        const path = trackExpr.startsWith(key + '.') ? trackExpr.slice(key.length + 1) : trackExpr;\n\n        return (item, i) => {\n            if (item == null) return i;\n            if (path === key || path === '$index') return path === '$index' ? i : item;\n\n            // dotted path lookup\n            const parts = path.split('.');\n            let v: any = item;\n            for (const p of parts) {\n                if (v == null) return i;\n                v = v[p];\n            }\n            return v ?? i;\n        };\n    }\n\n    /**\n     * Parses the $for expression string into its constituent parts.\n     *\n     * Supported formats:\n     *   item in items\n     *   item, index in items\n     *   (item, index) in items\n     *   item in filter(items)\n     *   item, index in filter(items, 'active')\n     *   item in items track item.id\n     *   (item, i) in items track item.id\n     */\n    private parseExpression(content: string): AreForExpression {\n        // Strip optional `track <expr>` suffix first.\n        let trackExpr: string | undefined;\n        const trackIdx = content.search(/\\s+track\\s+/);\n        let body = content;\n        if (trackIdx !== -1) {\n            const m = content.slice(trackIdx).match(/\\s+track\\s+(.+)$/);\n            if (m) {\n                trackExpr = m[1].trim();\n                body = content.slice(0, trackIdx).trim();\n            }\n        }\n\n        const inIndex = body.lastIndexOf(' in ');\n        const keyAndIndex = body.slice(0, inIndex).trim().replace(/^\\(|\\)$/g, '');\n        const arrayExpr = body.slice(inIndex + 4).trim();\n        const keyParts = keyAndIndex.split(',').map(p => p.trim());\n\n        return {\n            key: keyParts[0],\n            index: keyParts[1] || undefined,\n            arrayExpr,\n            trackExpr,\n        };\n    }\n\n    /**\n     * Resolves the array expression against the store.\n     * Supports both plain key lookups and function-call expressions:\n     *   items          → store.get('items')\n     *   filter(items)  → store.get('filter')(store.get('items'))\n     */\n    private resolveArray(store: AreStore, arrayExpr: string, fullContent: string): any[] {\n        let result: any;\n        const callMatch = arrayExpr.match(/^([^(]+)\\((.+)\\)$/);\n\n        if (callMatch) {\n            const fnName = callMatch[1].trim();\n            const fn = store.get(fnName as any);\n\n            if (typeof fn !== 'function')\n                throw new AreCompilerError({\n                    title: 'Invalid \"for\" Directive Function',\n                    description: `The expression \"${fnName}\" in the \"for\" directive does not resolve to a function in the store. Received: ${typeof fn}`,\n                });\n\n            const rawArgs = callMatch[2].split(',').map(a => a.trim());\n            const resolvedArgs = rawArgs.map(arg => {\n                if (arg.startsWith(\"'\") && arg.endsWith(\"'\")) return arg.slice(1, -1);\n                if (arg.startsWith('\"') && arg.endsWith('\"')) return arg.slice(1, -1);\n                if (!isNaN(Number(arg))) return Number(arg);\n                return store.get(arg as any);\n            });\n\n            result = (fn as Function)(...resolvedArgs);\n        } else if (arrayExpr.includes('.')) {\n            // dotted-path lookup: e.g. \"list.items\" or \"record?.keywords\"\n            // Strip optional-chaining `?` suffix from each segment so that\n            // `record?.keywords` resolves the same as `record.keywords`.\n            const parts = arrayExpr.split('.').map(p => p.replace(/\\?$/, ''));\n            result = store.get(parts[0] as any);\n            for (let i = 1; i < parts.length; i++) {\n                if (result == null) break;\n                result = result[parts[i]];\n            }\n        } else {\n            result = store.get(arrayExpr.replace(/\\?$/, '') as any);\n        }\n\n        // null / undefined from optional-chaining expressions (e.g. `record?.keywords`)\n        // means the source object is not yet loaded — treat as empty array so the\n        // directive initialises gracefully and fills in when the store updates.\n        if (result == null) return [];\n\n        if (!Array.isArray(result))\n            throw new AreCompilerError({\n                title: 'Invalid \"for\" Directive Value',\n                description: `The \"for\" directive expects an array but got ${typeof result}. Expression: \"${fullContent}\". Received: ${JSON.stringify(result)}`,\n            });\n\n        return result;\n    }\n\n    /**\n     * Creates a single item node from the template, registers it as a child of\n     * the owner, initialises it, injects item-scoped store values, and activates\n     * its scene so the mount/compile cycle will include it.\n     *\n     * NOTE: This method does NOT call compile() or mount() — the caller is\n     * responsible for doing so when the main lifecycle cycle won't cover it\n     * (i.e. during update, but not during the initial compile phase).\n     */\n    private spawnItemNode(\n        template: AreHTMLNode,\n        owner: AreHTMLNode,\n        key: string,\n        index: string | undefined,\n        item: any,\n        i: number,\n    ): AreHTMLNode {\n        const itemNode = template.clone() as AreHTMLNode;\n\n        owner.addChild(itemNode);\n\n        const queue = [itemNode];\n\n        while (queue.length > 0) {\n            const current = queue.shift()!\n\n            current.init();\n\n            queue.push(...current.children as AreHTMLNode[]);\n        }\n\n        /**\n         * Resolve or create a directive context for the item node. This is needed to hold the item-specific store values (e.g. the \"item\" and \"index\" in a \"for\" loop) that the template's bindings will reference during compile and update. The context is shared among all clones of the same template, but that's fine because each clone gets its own scope values assigned here.\n         */\n        let directiveContext = itemNode.scope.resolveFlat(AreDirectiveContext);\n\n        if (!directiveContext) {\n            directiveContext = new AreDirectiveContext(itemNode.aseid);\n            itemNode.scope.register(directiveContext);\n        }\n\n        directiveContext.scope = {\n            ...directiveContext.scope,\n            [key]: item,\n            [index || 'index']: i,\n        }\n\n        itemNode.scene.activate();\n\n        return itemNode;\n    }\n}"]}
+{"version":3,"sources":["../../../src/directives/AreDirectiveFor.directive.ts"],"names":[],"mappings":"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","file":"AreDirectiveFor.directive.mjs","sourcesContent":["import { A_Caller, A_Inject, A_Scope } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreCompilerError, AreScene, AreStore } from \"@adaas/are\";\nimport { AreDirective } from \"@adaas/are-html/directive/AreDirective.component\";\nimport { AddCommentInstruction } from \"@adaas/are-html/instructions/AddComment.instruction\";\nimport { AreHTMLNode } from \"@adaas/are-html/node\";\nimport { AreDirectiveContext } from \"@adaas/are-html/directive/AreDirective.context\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\n\n\ntype AreForExpression = {\n    key: string;\n    index: string | undefined;\n    arrayExpr: string;\n    /** Optional `track <expr>` clause, e.g. `track row.id` */\n    trackExpr: string | undefined;\n};\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Built-in $for directive. Iterates over an array expression resolved from the store and renders a cloned template fragment per item, managing per-item subscopes and comment-node anchors. Supports keyed diffing via an optional track clause to minimise DOM mutations on collection updates.'\n})\n@AreDirective.Priority(1)\nexport class AreDirectiveFor extends AreDirective {\n\n\n    @AreDirective.Transform\n    transform(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(A_Scope) scope: A_Scope,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger: A_Logger,\n        ...args: any[]\n    ) {\n\n        logger.debug(`[Transform] directive $FOR for <${attribute.owner.aseid.toString()}>`)\n\n        const node = attribute.owner;\n\n        /**\n         * Transfer the original node's scope (with all registered attributes and children)\n         * to the template clone, and give the owner node a fresh empty scope.\n         * This mirrors the $if directive's approach, making the owner a lightweight\n         * group container whose sole visible presence is a comment placeholder.\n         */\n        const forTemplate = node.cloneWithScope();\n\n        /**\n         * Remove the $for attribute from the template so iterative clones do not\n         * re-trigger this directive during their own transform phase.\n         * Re-register it on the owner so the reactive compile/update pipeline keeps working.\n         */\n        const forAttr = forTemplate.attributes.find(d => d.name === attribute.name);\n\n        if (forAttr) {\n            forTemplate.scope.deregister(forAttr);\n            node.scope.register(forAttr);\n        }\n\n        /**\n         * Re-initialize the owner node with its fresh scope so it becomes a valid\n         * group container that will own the generated item nodes as children.\n         */\n        node.init();\n\n        /**\n         * Store the template for use in compile and update.\n         */\n        attribute.template = forTemplate;\n\n\n        /**\n         * Parse the $for expression and evaluate the source array.\n         */\n        const { key, index, arrayExpr } = this.parseExpression(attribute.content);\n        const array = this.resolveArray(store, arrayExpr, attribute.content);\n\n        attribute.value = array;\n\n        /**\n         * For each item in the array, spawn a clone of the template with the\n         * item's store values pre-set and its scene activated.\n         *\n         * The children are added to the owner node before the main compiler's\n         * children iteration loop runs, so the main cycle will compile them —\n         * no explicit child.compile() call is needed here.\n         */\n        for (let i = 0; i < array.length; i++) {\n            this.spawnItemNode(attribute.template!, attribute.owner, key, index, array[i], i);\n        }\n    }\n\n\n    @AreDirective.Compile\n    compile(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Replace the group node's default host declaration with a comment placeholder\n         * so the owner element itself does not render as a DOM element — the item nodes\n         * render as its children instead.\n         */\n        const hostInstruction = scene.host!;\n        const commentIdentifier = ` --- for: ${attribute.template!.id} --- `;\n        const declaration = new AddCommentInstruction({ content: commentIdentifier });\n\n        scene.setHost(declaration);\n        scene.planBefore(declaration, hostInstruction);\n        scene.unPlan(hostInstruction);\n    }\n\n\n    @AreDirective.Update\n    update(\n        @A_Inject(A_Caller) attribute: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ): void {\n        /**\n         * Re-evaluate the source array.\n         */\n        const { key, index, arrayExpr, trackExpr } = this.parseExpression(attribute.content);\n        const newArray = this.resolveArray(store, arrayExpr, attribute.content);\n\n        const owner = attribute.owner;\n        const currentChildren = [...owner.children] as AreHTMLNode[];\n\n        attribute.value = newArray;\n\n        const computeKey = this.makeKeyFn(key, index, trackExpr);\n\n        // ── 1. Index existing children by stable key ────────────────────────\n        const childByKey = new Map<any, AreHTMLNode>();\n        const remaining = new Set<AreHTMLNode>();\n\n        for (let i = 0; i < currentChildren.length; i++) {\n            const child = currentChildren[i];\n            const ctx = child.scope.resolveFlat(AreDirectiveContext);\n            const k = ctx ? computeKey(ctx.scope[key], ctx.scope[index || 'index']) : Symbol('orphan');\n            childByKey.set(k, child);\n            remaining.add(child);\n        }\n\n        // ── 2. Walk desired list; reuse existing or spawn new ───────────────\n        const desired: AreHTMLNode[] = [];\n        const newOnes: AreHTMLNode[] = [];\n\n        for (let i = 0; i < newArray.length; i++) {\n            const item = newArray[i];\n            const k = computeKey(item, i);\n            const existing = childByKey.get(k);\n\n            if (existing) {\n                remaining.delete(existing);\n\n                let directiveContext = existing.scope.resolveFlat(AreDirectiveContext);\n                if (!directiveContext) {\n                    directiveContext = new AreDirectiveContext(existing.aseid);\n                    existing.scope.register(directiveContext);\n                }\n                directiveContext.scope = {\n                    ...directiveContext.scope,\n                    [key]: item,\n                    [index || 'index']: i,\n                };\n                desired.push(existing);\n            } else {\n                const itemNode = this.spawnItemNode(attribute.template!, owner, key, index, item, i);\n                desired.push(itemNode);\n                newOnes.push(itemNode);\n            }\n        }\n\n        // ── 3. Unmount + detach removed children ─────────────────────────────\n        for (const child of remaining) {\n            child.unmount();\n            owner.removeChild(child);\n        }\n\n        // ── 4. Mount only the new ones (kept children stay where they are). ─\n        for (const child of newOnes) {\n            child.transform();\n            child.compile();\n            child.mount();\n        }\n    }\n\n\n    // ─────────────────────────────────────────────────────────────────────────────\n    // ── Helpers ──────────────────────────────────────────────────────────────────\n    // ─────────────────────────────────────────────────────────────────────────────\n\n    /**\n     * Build a key-function that derives a stable identity from each item.\n     * If the user provided a `track <expr>` clause, evaluate it as a path on\n     * the item; otherwise fall back to the item identity (reference equality).\n     */\n    private makeKeyFn(key: string, index: string | undefined, trackExpr: string | undefined): (item: any, i: number) => any {\n        if (!trackExpr) {\n            return (item, i) => item ?? i;\n        }\n\n        // Strip any leading `key.` so users can write `track row.id`.\n        const path = trackExpr.startsWith(key + '.') ? trackExpr.slice(key.length + 1) : trackExpr;\n\n        return (item, i) => {\n            if (item == null) return i;\n            if (path === key || path === '$index') return path === '$index' ? i : item;\n\n            // dotted path lookup\n            const parts = path.split('.');\n            let v: any = item;\n            for (const p of parts) {\n                if (v == null) return i;\n                v = v[p];\n            }\n            return v ?? i;\n        };\n    }\n\n    /**\n     * Parses the $for expression string into its constituent parts.\n     *\n     * Supported formats:\n     *   item in items\n     *   item, index in items\n     *   (item, index) in items\n     *   item in filter(items)\n     *   item, index in filter(items, 'active')\n     *   item in items track item.id\n     *   (item, i) in items track item.id\n     */\n    private parseExpression(content: string): AreForExpression {\n        // Strip optional `track <expr>` suffix first.\n        let trackExpr: string | undefined;\n        const trackIdx = content.search(/\\s+track\\s+/);\n        let body = content;\n        if (trackIdx !== -1) {\n            const m = content.slice(trackIdx).match(/\\s+track\\s+(.+)$/);\n            if (m) {\n                trackExpr = m[1].trim();\n                body = content.slice(0, trackIdx).trim();\n            }\n        }\n\n        const inIndex = body.lastIndexOf(' in ');\n        const keyAndIndex = body.slice(0, inIndex).trim().replace(/^\\(|\\)$/g, '');\n        const arrayExpr = body.slice(inIndex + 4).trim();\n        const keyParts = keyAndIndex.split(',').map(p => p.trim());\n\n        return {\n            key: keyParts[0],\n            index: keyParts[1] || undefined,\n            arrayExpr,\n            trackExpr,\n        };\n    }\n\n    /**\n     * Resolves the array expression against the store.\n     * Supports both plain key lookups and function-call expressions:\n     *   items          → store.get('items')\n     *   filter(items)  → store.get('filter')(store.get('items'))\n     */\n    private resolveArray(store: AreStore, arrayExpr: string, fullContent: string): any[] {\n        let result: any;\n        const callMatch = arrayExpr.match(/^([^(]+)\\((.+)\\)$/);\n\n        if (callMatch) {\n            const fnName = callMatch[1].trim();\n            const fn = store.get(fnName as any);\n\n            if (typeof fn !== 'function')\n                throw new AreCompilerError({\n                    title: 'Invalid \"for\" Directive Function',\n                    description: `The expression \"${fnName}\" in the \"for\" directive does not resolve to a function in the store. Received: ${typeof fn}`,\n                });\n\n            const rawArgs = callMatch[2].split(',').map(a => a.trim());\n            const resolvedArgs = rawArgs.map(arg => {\n                if (arg.startsWith(\"'\") && arg.endsWith(\"'\")) return arg.slice(1, -1);\n                if (arg.startsWith('\"') && arg.endsWith('\"')) return arg.slice(1, -1);\n                if (!isNaN(Number(arg))) return Number(arg);\n                // Dotted-path / optional-chain: e.g. `record?.embedding` or `record.data`\n                const stripped = arg.replace(/\\?$/, '');\n                if (stripped.includes('.')) {\n                    const parts = stripped.split('.').map(p => p.replace(/\\?$/, ''));\n                    let val: any = store.get(parts[0] as any);\n                    for (let j = 1; j < parts.length; j++) {\n                        if (val == null) return undefined;\n                        val = val[parts[j]];\n                    }\n                    return val ?? undefined;\n                }\n                return store.get(stripped as any);\n            });\n\n            result = (fn as Function)(...resolvedArgs);\n        } else if (arrayExpr.includes('.')) {\n            // dotted-path lookup: e.g. \"list.items\" or \"record?.keywords\"\n            // Strip optional-chaining `?` suffix from each segment so that\n            // `record?.keywords` resolves the same as `record.keywords`.\n            const parts = arrayExpr.split('.').map(p => p.replace(/\\?$/, ''));\n            result = store.get(parts[0] as any);\n            for (let i = 1; i < parts.length; i++) {\n                if (result == null) break;\n                result = result[parts[i]];\n            }\n        } else {\n            result = store.get(arrayExpr.replace(/\\?$/, '') as any);\n        }\n\n        // null / undefined from optional-chaining expressions (e.g. `record?.keywords`)\n        // means the source object is not yet loaded — treat as empty array so the\n        // directive initialises gracefully and fills in when the store updates.\n        if (result == null) return [];\n\n        if (!Array.isArray(result))\n            throw new AreCompilerError({\n                title: 'Invalid \"for\" Directive Value',\n                description: `The \"for\" directive expects an array but got ${typeof result}. Expression: \"${fullContent}\". Received: ${JSON.stringify(result)}`,\n            });\n\n        return result;\n    }\n\n    /**\n     * Creates a single item node from the template, registers it as a child of\n     * the owner, initialises it, injects item-scoped store values, and activates\n     * its scene so the mount/compile cycle will include it.\n     *\n     * NOTE: This method does NOT call compile() or mount() — the caller is\n     * responsible for doing so when the main lifecycle cycle won't cover it\n     * (i.e. during update, but not during the initial compile phase).\n     */\n    private spawnItemNode(\n        template: AreHTMLNode,\n        owner: AreHTMLNode,\n        key: string,\n        index: string | undefined,\n        item: any,\n        i: number,\n    ): AreHTMLNode {\n        const itemNode = template.clone() as AreHTMLNode;\n\n        owner.addChild(itemNode);\n\n        const queue = [itemNode];\n\n        while (queue.length > 0) {\n            const current = queue.shift()!\n\n            current.init();\n\n            queue.push(...current.children as AreHTMLNode[]);\n        }\n\n        /**\n         * Resolve or create a directive context for the item node. This is needed to hold the item-specific store values (e.g. the \"item\" and \"index\" in a \"for\" loop) that the template's bindings will reference during compile and update. The context is shared among all clones of the same template, but that's fine because each clone gets its own scope values assigned here.\n         */\n        let directiveContext = itemNode.scope.resolveFlat(AreDirectiveContext);\n\n        if (!directiveContext) {\n            directiveContext = new AreDirectiveContext(itemNode.aseid);\n            itemNode.scope.register(directiveContext);\n        }\n\n        directiveContext.scope = {\n            ...directiveContext.scope,\n            [key]: item,\n            [index || 'index']: i,\n        }\n\n        itemNode.scene.activate();\n\n        return itemNode;\n    }\n}"]}

package/dist/node/directives/AreDirectiveIf.directive.d.mts

@@ -1,6 +1,6 @@
 import { A_Scope } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
-import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import { AreStore, AreScene, AreSyntax } from '@adaas/are';
 import { AreDirectiveContext } from '../lib/AreDirective/AreDirective.context.mjs';
 import '../lib/AreStyle/AreStyle.context.mjs';

package/dist/node/directives/AreDirectiveIf.directive.d.ts

@@ -1,6 +1,6 @@
 import { A_Scope } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
-import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+import { a as AreDirective, b as AreDirectiveAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import { AreStore, AreScene, AreSyntax } from '@adaas/are';
 import { AreDirectiveContext } from '../lib/AreDirective/AreDirective.context.js';
 import '../lib/AreStyle/AreStyle.context.js';

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

@@ -1,12 +1,19 @@
 import { A_Feature } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
 import { AreCompiler, AreScene, AreStore, AreSyntax } from '@adaas/are';
-import { f as AreStaticAttribute, b as AreDirectiveAttribute, c as AreEventAttribute, A as AreBindingAttribute } from '../AreBinding.attribute-C6qrxN8K.mjs';
+import { e as AreHTMLNode, f as AreStaticAttribute, b as AreDirectiveAttribute, c as AreEventAttribute, A as AreBindingAttribute } from '../AreBinding.attribute-doUvtOjc.mjs';
 import { AreInterpolation } from '../nodes/AreInterpolation.mjs';
 import { AreText } from '../nodes/AreText.mjs';
 import '../lib/AreStyle/AreStyle.context.mjs';
 
 declare class AreHTMLCompiler extends AreCompiler {
+    /**
+     * Extends the base compile for all AreHTMLNode instances (elements, components, root nodes).
+     * After the standard element/attribute/children instructions are emitted, checks whether
+     * the node has a registered AreStyle and plans an AddStyleInstruction so the interpreter
+     * can inject the CSS into the document head during mount.
+     */
+    compileHTMLNode(node: AreHTMLNode, scene: AreScene, logger?: A_Logger, ...args: any[]): void;
     /**
      * Default compile method for interpolations, which can be overridden by specific implementations if needed.
      *

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

@@ -1,12 +1,19 @@
 import { A_Feature } from '@adaas/a-concept';
 import { A_Logger } from '@adaas/a-utils/a-logger';
 import { AreCompiler, AreScene, AreStore, AreSyntax } from '@adaas/are';
-import { f as AreStaticAttribute, b as AreDirectiveAttribute, c as AreEventAttribute, A as AreBindingAttribute } from '../AreBinding.attribute-C6JasbJL.js';
+import { e as AreHTMLNode, f as AreStaticAttribute, b as AreDirectiveAttribute, c as AreEventAttribute, A as AreBindingAttribute } from '../AreBinding.attribute-Bm5LlOyE.js';
 import { AreInterpolation } from '../nodes/AreInterpolation.js';
 import { AreText } from '../nodes/AreText.js';
 import '../lib/AreStyle/AreStyle.context.js';
 
 declare class AreHTMLCompiler extends AreCompiler {
+    /**
+     * Extends the base compile for all AreHTMLNode instances (elements, components, root nodes).
+     * After the standard element/attribute/children instructions are emitted, checks whether
+     * the node has a registered AreStyle and plans an AddStyleInstruction so the interpreter
+     * can inject the CSS into the document head during mount.
+     */
+    compileHTMLNode(node: AreHTMLNode, scene: AreScene, logger?: A_Logger, ...args: any[]): void;
     /**
      * Default compile method for interpolations, which can be overridden by specific implementations if needed.
      *

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

@@ -14,6 +14,8 @@ var AreText = require('@adaas/are-html/nodes/AreText');
 var AddAttribute_instruction = require('@adaas/are-html/instructions/AddAttribute.instruction');
 var AddText_instruction = require('@adaas/are-html/instructions/AddText.instruction');
 var AddListener_instruction = require('@adaas/are-html/instructions/AddListener.instruction');
+var AddStyle_instruction = require('@adaas/are-html/instructions/AddStyle.instruction');
+var node = require('@adaas/are-html/node');
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -27,6 +29,15 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 exports.AreHTMLCompiler = class AreHTMLCompiler extends are.AreCompiler {
+  compileHTMLNode(node, scene, logger, ...args) {
+    super.compile(node, scene, logger, ...args);
+    if (node.styles?.styles) {
+      const host = scene.host;
+      if (host) {
+        scene.plan(new AddStyle_instruction.AddStyleInstruction(host, { styles: node.styles.styles }));
+      }
+    }
+  }
   compileInterpolation(interpolation, scene, store, logger, ...args) {
     scene.plan(new AddText_instruction.AddTextInstruction({ content: interpolation.content, evaluate: true }));
   }
@@ -139,6 +150,12 @@ exports.AreHTMLCompiler = class AreHTMLCompiler extends are.AreCompiler {
     scene.plan(instruction);
   }
 };
+__decorateClass([
+  are.AreCompiler.Compile(node.AreHTMLNode),
+  __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
+  __decorateParam(1, aConcept.A_Inject(are.AreScene)),
+  __decorateParam(2, aConcept.A_Inject(aLogger.A_Logger))
+], exports.AreHTMLCompiler.prototype, "compileHTMLNode", 1);
 __decorateClass([
   are.AreCompiler.Compile(AreInterpolation.AreInterpolation),
   __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/engine/AreHTML.compiler.ts"],"names":["AreHTMLCompiler","AreCompiler","AddTextInstruction","AreCompilerError","AddAttributeInstruction","AreDirectiveFeatures","A_FormatterHelper","AddListenerInstruction","AreInterpolation","A_Caller","AreScene","AreStore","A_Logger","AreText","AreStaticAttribute","AreDirectiveAttribute","A_Feature","AreEventAttribute","AreBindingAttribute","AreSyntax","A_Frame"],"mappings":"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","file":"AreHTML.compiler.js","sourcesContent":["import { A_Caller, A_Dependency, A_Feature, A_FormatterHelper, A_Inject } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\nimport { AreCompiler, AreScene, AreCompilerError, AreStore, AreSyntax } from \"@adaas/are\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreStaticAttribute } from \"@adaas/are-html/attributes/AreStatic.attribute\";\nimport { AreDirectiveFeatures } from \"@adaas/are-html/directive/AreDirective.constants\";\nimport { AreEventAttribute } from \"@adaas/are-html/attributes/AreEvent.attribute\";\nimport { AreBindingAttribute } from \"@adaas/are-html/attributes/AreBinding.attribute\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AddAttributeInstruction} from \"@adaas/are-html/instructions/AddAttribute.instruction\";\nimport { AddTextInstruction} from \"@adaas/are-html/instructions/AddText.instruction\";\nimport { AddListenerInstruction} from \"@adaas/are-html/instructions/AddListener.instruction\";\n\n\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'HTML-specific compiler for A-Concept Rendering Engine (ARE) components, extending the base AreCompiler to handle HTML templates, styles, and rendering logic tailored for web environments.'\n})\nexport class AreHTMLCompiler extends AreCompiler {\n\n    // compile(\n    //     @A_Inject(A_Caller) node: AreHTMLNode,\n    //     @A_Inject(AreScene) scene: AreScene,\n    //     ...args: any[]\n    // ): void {\n    //     super.compile(node, scene, ...args);\n    // }\n\n    // -----------------------------------------------------------------------------------------\n    // -------------------------Are-Interpolation Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n    /**\n     * Default compile method for interpolations, which can be overridden by specific implementations if needed.\n     * \n     * @param interpolation \n     * @param scope \n     * @param scene \n     * @param store \n     * @param feature \n     */\n    @AreCompiler.Compile(AreInterpolation)\n    compileInterpolation(\n        @A_Inject(A_Caller) interpolation: AreInterpolation,\n        @A_Inject(AreScene) scene: AreScene,\n\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        // if (scene.host)\n        //     console.log('Scene Host: ', scene.host);\n\n        // let content = '';\n\n        // logger?.debug('green', `AreHTMLCompiler: compile interpolation <${interpolation.aseid.toString()}> with key: \"${interpolation.content}\"`, store.get(interpolation.content));\n\n        // try {\n        //     content = AreCommonHelper.evaluate(interpolation.content, store);\n\n        // } catch (error) {\n        //     content = ''\n        // }\n\n        scene.plan(new AddTextInstruction({ content: interpolation.content, evaluate: true }));\n    }\n\n    // -----------------------------------------------------------------------------------------\n    // ------------------------------Are-Text Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n    @AreCompiler.Compile(AreText)\n    compileText(\n        @A_Inject(A_Caller) text: AreText,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        logger?.debug('cyan', `AreHTMLCompiler: compile text node <${text.aseid.toString()}> with content: \"${text.content}\"`);\n        if (scene.host)\n            scene.unPlan(scene.host);\n\n        scene.plan(new AddTextInstruction({ content: text.content }));\n\n    }\n\n    // -----------------------------------------------------------------------------------------\n    // -------------------------Are-Attribute Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n\n    @AreCompiler.Compile(AreStaticAttribute)\n    compileStaticAttribute(\n        @A_Inject(A_Caller) attribute: AreStaticAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ) {\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n\n        const content = attribute.content;\n\n        /**\n         * If the attribute value contains {{ }} interpolations, transform them into\n         * a JS string-concatenation expression so the interpreter can evaluate them.\n         * e.g. \"color:{{expr}}\" → '\"color:\"+(expr)+\"\"'\n         */\n        if (content.includes('{{')) {\n            const transformed = '\"' + content.replace(/\\{\\{([^}]+)\\}\\}/g, '\"+($1)+\"') + '\"';\n            scene.plan(new AddAttributeInstruction(scene.host, {\n                name: attribute.name,\n                content: transformed,\n                evaluate: true,\n            }));\n            return;\n        }\n\n        /**\n         * Default case: regular static attribute rendered as-is.\n         */\n        scene.plan(new AddAttributeInstruction(scene.host, {\n            name: attribute.name,\n            content: attribute.content\n        }));\n    }\n\n    @AreCompiler.Compile(AreDirectiveAttribute)\n    compileDirectiveAttribute(\n        @A_Inject(A_Caller) directive: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(A_Feature) feature: A_Feature,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        store.watch(directive);\n\n        /**\n         * 3. If the attribute is a directive, then we should find a component that is responsible for\n         *    the directive compiling logic, and call it. \n         *    In case component is not found we just want to log a warning, \n         *    since the directive may be handled by some parent component or simply is a mistake in the template.\n         */\n        if (directive.component) {\n            feature.chain(directive.component, AreDirectiveFeatures.Compile, directive.owner.scope);\n        } else {\n            logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named \"AreDirective${A_FormatterHelper.toPascalCase(directive.name)}\" to handle this directive.`);\n        }\n\n        store.unwatch(directive);\n    }\n\n\n    @AreCompiler.Compile(AreEventAttribute)\n    compileEventAttribute(\n        @A_Inject(A_Caller) attribute: AreEventAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ) {\n\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n        /**\n         * 2. In case the attribute is an event listener, then \n         *    we should simply add a callback handler that will be used to proxy an event \n         *    into the ComponentNode component.  \n         *[!] In this case AreAttribute is AreEventAttribute that has prepared callback function to be used \n         *    in the event listener. It is important to store callback function once \n         *    to prevent duplicated functions in case of multiple compilations during development.\n         */\n        scene.plan(new AddListenerInstruction(scene.host, {\n            name: attribute.name,\n            handler: attribute.content\n        }));\n    }\n\n\n    @AreCompiler.Compile(AreBindingAttribute)\n    compileBindingAttribute(\n        @A_Inject(A_Caller) attribute: AreBindingAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Dependency.Parent()\n        @A_Inject(AreStore) parentStore: AreStore,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        ...args: any[]\n    ) {\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n\n\n        const node = attribute.owner;\n        const props = node.component?.props;\n\n        // Component prop names are typically declared in camelCase, while template\n        // markup uses kebab-case. Try both forms when matching.\n        let propName: string | undefined;\n        if (props) {\n            if (props[attribute.name]) {\n                propName = attribute.name;\n            } else {\n                const camel = A_FormatterHelper.toCamelCase(attribute.name);\n                if (props[camel]) propName = camel;\n            }\n        }\n\n        /**\n         * 1. Component prop binding — evaluate against the parent store and\n         *    keep the child store reactive to upstream changes.\n         */\n        if (propName && props) {\n            const propDefinition = props[propName];\n\n            const coerce = (raw: any): any => {\n                let value = raw;\n                if (propDefinition.type) {\n                    switch (propDefinition.type) {\n                        case 'string': value = value === undefined || value === null ? '' : String(value); break;\n                        case 'number': value = Number(value); break;\n                        case 'boolean': value = Boolean(value); break;\n                    }\n                }\n                return value;\n            };\n\n            // The watcher entity below is registered against parentStore so that\n            // updates to the bound expression in the parent flow into the child store.\n            const watcher = {\n                update: () => {\n                    try {\n                        parentStore.watch(watcher);\n                        const next = coerce(syntax.evaluate(attribute.content, parentStore));\n                        parentStore.unwatch(watcher);\n                        store.set(propName!, next);\n                    } catch (e) {\n                        parentStore.unwatch(watcher);\n                    }\n                }\n            };\n\n            // Initial read with watch active so dependencies are recorded.\n            parentStore.watch(watcher);\n            const initial = coerce(syntax.evaluate(attribute.content, parentStore));\n            parentStore.unwatch(watcher);\n\n            store.set(propName, initial);\n            return;\n        }\n\n        /**\n         * 2. Default attribute binding — evaluated reactively against the local store.\n         */\n        const instruction = new AddAttributeInstruction(scene.host, {\n            name: attribute.name,\n            content: attribute.content,\n            evaluate: true\n        })\n\n        scene.plan(instruction);\n    }\n\n\n}"]}
+{"version":3,"sources":["../../../src/engine/AreHTML.compiler.ts"],"names":["AreHTMLCompiler","AreCompiler","AddStyleInstruction","AddTextInstruction","AreCompilerError","AddAttributeInstruction","AreDirectiveFeatures","A_FormatterHelper","AddListenerInstruction","AreHTMLNode","A_Caller","AreScene","A_Logger","AreInterpolation","AreStore","AreText","AreStaticAttribute","AreDirectiveAttribute","A_Feature","AreEventAttribute","AreBindingAttribute","AreSyntax","A_Frame"],"mappings":"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","file":"AreHTML.compiler.js","sourcesContent":["import { A_Caller, A_Dependency, A_Feature, A_FormatterHelper, A_Inject } from \"@adaas/a-concept\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\nimport { AreCompiler, AreScene, AreCompilerError, AreStore, AreSyntax } from \"@adaas/are\";\nimport { AreDirectiveAttribute } from \"@adaas/are-html/attributes/AreDirective.attribute\";\nimport { AreStaticAttribute } from \"@adaas/are-html/attributes/AreStatic.attribute\";\nimport { AreDirectiveFeatures } from \"@adaas/are-html/directive/AreDirective.constants\";\nimport { AreEventAttribute } from \"@adaas/are-html/attributes/AreEvent.attribute\";\nimport { AreBindingAttribute } from \"@adaas/are-html/attributes/AreBinding.attribute\";\nimport { AreInterpolation } from \"@adaas/are-html/nodes/AreInterpolation\";\nimport { AreText } from \"@adaas/are-html/nodes/AreText\";\nimport { AddAttributeInstruction} from \"@adaas/are-html/instructions/AddAttribute.instruction\";\nimport { AddTextInstruction} from \"@adaas/are-html/instructions/AddText.instruction\";\nimport { AddListenerInstruction} from \"@adaas/are-html/instructions/AddListener.instruction\";\nimport { AddStyleInstruction } from \"@adaas/are-html/instructions/AddStyle.instruction\";\nimport { AreHTMLNode } from \"@adaas/are-html/node\";\n\n\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'HTML-specific compiler for A-Concept Rendering Engine (ARE) components, extending the base AreCompiler to handle HTML templates, styles, and rendering logic tailored for web environments.'\n})\nexport class AreHTMLCompiler extends AreCompiler {\n\n    /**\n     * Extends the base compile for all AreHTMLNode instances (elements, components, root nodes).\n     * After the standard element/attribute/children instructions are emitted, checks whether\n     * the node has a registered AreStyle and plans an AddStyleInstruction so the interpreter\n     * can inject the CSS into the document head during mount.\n     */\n    @AreCompiler.Compile(AreHTMLNode)\n    compileHTMLNode(\n        @A_Inject(A_Caller) node: AreHTMLNode,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ): void {\n        super.compile(node, scene, logger, ...args);\n\n        if (node.styles?.styles) {\n            const host = scene.host;\n            if (host) {\n                scene.plan(new AddStyleInstruction(host, { styles: node.styles.styles }));\n            }\n        }\n    }\n\n    // -----------------------------------------------------------------------------------------\n    // -------------------------Are-Interpolation Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n    /**\n     * Default compile method for interpolations, which can be overridden by specific implementations if needed.\n     * \n     * @param interpolation \n     * @param scope \n     * @param scene \n     * @param store \n     * @param feature \n     */\n    @AreCompiler.Compile(AreInterpolation)\n    compileInterpolation(\n        @A_Inject(A_Caller) interpolation: AreInterpolation,\n        @A_Inject(AreScene) scene: AreScene,\n\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        // if (scene.host)\n        //     console.log('Scene Host: ', scene.host);\n\n        // let content = '';\n\n        // logger?.debug('green', `AreHTMLCompiler: compile interpolation <${interpolation.aseid.toString()}> with key: \"${interpolation.content}\"`, store.get(interpolation.content));\n\n        // try {\n        //     content = AreCommonHelper.evaluate(interpolation.content, store);\n\n        // } catch (error) {\n        //     content = ''\n        // }\n\n        scene.plan(new AddTextInstruction({ content: interpolation.content, evaluate: true }));\n    }\n\n    // -----------------------------------------------------------------------------------------\n    // ------------------------------Are-Text Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n    @AreCompiler.Compile(AreText)\n    compileText(\n        @A_Inject(A_Caller) text: AreText,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        logger?.debug('cyan', `AreHTMLCompiler: compile text node <${text.aseid.toString()}> with content: \"${text.content}\"`);\n        if (scene.host)\n            scene.unPlan(scene.host);\n\n        scene.plan(new AddTextInstruction({ content: text.content }));\n\n    }\n\n    // -----------------------------------------------------------------------------------------\n    // -------------------------Are-Attribute Compile Section-----------------------------------\n    // -----------------------------------------------------------------------------------------\n\n    @AreCompiler.Compile(AreStaticAttribute)\n    compileStaticAttribute(\n        @A_Inject(A_Caller) attribute: AreStaticAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ) {\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n\n        const content = attribute.content;\n\n        /**\n         * If the attribute value contains {{ }} interpolations, transform them into\n         * a JS string-concatenation expression so the interpreter can evaluate them.\n         * e.g. \"color:{{expr}}\" → '\"color:\"+(expr)+\"\"'\n         */\n        if (content.includes('{{')) {\n            const transformed = '\"' + content.replace(/\\{\\{([^}]+)\\}\\}/g, '\"+($1)+\"') + '\"';\n            scene.plan(new AddAttributeInstruction(scene.host, {\n                name: attribute.name,\n                content: transformed,\n                evaluate: true,\n            }));\n            return;\n        }\n\n        /**\n         * Default case: regular static attribute rendered as-is.\n         */\n        scene.plan(new AddAttributeInstruction(scene.host, {\n            name: attribute.name,\n            content: attribute.content\n        }));\n    }\n\n    @AreCompiler.Compile(AreDirectiveAttribute)\n    compileDirectiveAttribute(\n        @A_Inject(A_Caller) directive: AreDirectiveAttribute,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(A_Feature) feature: A_Feature,\n        @A_Inject(A_Logger) logger?: A_Logger,\n        ...args: any[]\n    ) {\n        store.watch(directive);\n\n        /**\n         * 3. If the attribute is a directive, then we should find a component that is responsible for\n         *    the directive compiling logic, and call it. \n         *    In case component is not found we just want to log a warning, \n         *    since the directive may be handled by some parent component or simply is a mistake in the template.\n         */\n        if (directive.component) {\n            feature.chain(directive.component, AreDirectiveFeatures.Compile, directive.owner.scope);\n        } else {\n            logger?.warning(`Directive handler component not found for directive: ${directive.name}. Make sure to create a component named \"AreDirective${A_FormatterHelper.toPascalCase(directive.name)}\" to handle this directive.`);\n        }\n\n        store.unwatch(directive);\n    }\n\n\n    @AreCompiler.Compile(AreEventAttribute)\n    compileEventAttribute(\n        @A_Inject(A_Caller) attribute: AreEventAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        ...args: any[]\n    ) {\n\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n        /**\n         * 2. In case the attribute is an event listener, then \n         *    we should simply add a callback handler that will be used to proxy an event \n         *    into the ComponentNode component.  \n         *[!] In this case AreAttribute is AreEventAttribute that has prepared callback function to be used \n         *    in the event listener. It is important to store callback function once \n         *    to prevent duplicated functions in case of multiple compilations during development.\n         */\n        scene.plan(new AddListenerInstruction(scene.host, {\n            name: attribute.name,\n            handler: attribute.content\n        }));\n    }\n\n\n    @AreCompiler.Compile(AreBindingAttribute)\n    compileBindingAttribute(\n        @A_Inject(A_Caller) attribute: AreBindingAttribute,\n        @A_Inject(AreScene) scene: AreScene,\n        @A_Dependency.Parent()\n        @A_Inject(AreStore) parentStore: AreStore,\n        @A_Inject(AreStore) store: AreStore,\n        @A_Inject(AreSyntax) syntax: AreSyntax,\n        ...args: any[]\n    ) {\n        if (!scene.host)\n            throw new AreCompilerError({\n                title: 'Scene Host Not Found',\n                description: `No host found for the scene with id: ${scene.id}. Please ensure that the scene is properly initialized and has a host before compiling binding attributes.`\n            });\n\n\n        const node = attribute.owner;\n        const props = node.component?.props;\n\n        // Component prop names are typically declared in camelCase, while template\n        // markup uses kebab-case. Try both forms when matching.\n        let propName: string | undefined;\n        if (props) {\n            if (props[attribute.name]) {\n                propName = attribute.name;\n            } else {\n                const camel = A_FormatterHelper.toCamelCase(attribute.name);\n                if (props[camel]) propName = camel;\n            }\n        }\n\n        /**\n         * 1. Component prop binding — evaluate against the parent store and\n         *    keep the child store reactive to upstream changes.\n         */\n        if (propName && props) {\n            const propDefinition = props[propName];\n\n            const coerce = (raw: any): any => {\n                let value = raw;\n                if (propDefinition.type) {\n                    switch (propDefinition.type) {\n                        case 'string': value = value === undefined || value === null ? '' : String(value); break;\n                        case 'number': value = Number(value); break;\n                        case 'boolean': value = Boolean(value); break;\n                    }\n                }\n                return value;\n            };\n\n            // The watcher entity below is registered against parentStore so that\n            // updates to the bound expression in the parent flow into the child store.\n            const watcher = {\n                update: () => {\n                    try {\n                        parentStore.watch(watcher);\n                        const next = coerce(syntax.evaluate(attribute.content, parentStore));\n                        parentStore.unwatch(watcher);\n                        store.set(propName!, next);\n                    } catch (e) {\n                        parentStore.unwatch(watcher);\n                    }\n                }\n            };\n\n            // Initial read with watch active so dependencies are recorded.\n            parentStore.watch(watcher);\n            const initial = coerce(syntax.evaluate(attribute.content, parentStore));\n            parentStore.unwatch(watcher);\n\n            store.set(propName, initial);\n            return;\n        }\n\n        /**\n         * 2. Default attribute binding — evaluated reactively against the local store.\n         */\n        const instruction = new AddAttributeInstruction(scene.host, {\n            name: attribute.name,\n            content: attribute.content,\n            evaluate: true\n        })\n\n        scene.plan(instruction);\n    }\n\n\n}"]}