@adaas/are-html 0.0.20 → 0.0.22

package/dist/node/lib/AreRoot/AreRoot.component.js

@@ -6,6 +6,7 @@ var aLogger = require('@adaas/a-utils/a-logger');
 var aSignal = require('@adaas/a-utils/a-signal');
 var are = require('@adaas/are');
 var AreRoute_signal = require('@adaas/are-html/signals/AreRoute.signal');
+var AreRootCache_context = require('./AreRootCache.context');
 
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -19,7 +20,7 @@ var __decorateClass = (decorators, target, key, kind) => {
 };
 var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 exports.AreRoot = class AreRoot extends are.Are {
-  async template(root, logger, signalsContext) {
+  async template(root, logger, signalsContext, signalState) {
     const rootId = root.id;
     if (signalsContext && !signalsContext.hasRoot(rootId)) {
       if (!root.content?.trim()) {
@@ -31,26 +32,9 @@ exports.AreRoot = class AreRoot extends are.Are {
       }
       return;
     }
-    const currentRoute = AreRoute_signal.AreRoute.default();
-    let componentName;
-    if (currentRoute) {
-      const initialVector = new aSignal.A_SignalVector([currentRoute]);
-      let renderTarget = signalsContext?.findComponentByVector(rootId, initialVector);
-      if (!renderTarget) {
-        const signalsMeta = aConcept.A_Context.meta(are.AreSignals);
-        const pool = signalsContext?.getComponentById(rootId);
-        const metaTarget = signalsMeta?.findComponentByVector(
-          initialVector,
-          pool?.length ? pool : void 0
-        );
-        if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
-          renderTarget = metaTarget;
-        }
-      }
-      if (renderTarget?.name) {
-        componentName = aConcept.A_FormatterHelper.toKebabCase(renderTarget.name);
-      }
-    }
+    const initialVector = this.buildInitialVector(signalState);
+    const renderTarget = this.matchComponent(rootId, initialVector, signalsContext);
+    let componentName = renderTarget?.name ? aConcept.A_FormatterHelper.toKebabCase(renderTarget.name) : void 0;
     if (!componentName) {
       if (root.content?.trim()) {
         return;
@@ -72,32 +56,17 @@ exports.AreRoot = class AreRoot extends are.Are {
     }
     root.setContent(`<${componentName}></${componentName}>`);
   }
-  async onSignal(root, vector, logger, signalsContext) {
+  async onSignal(root, vector, logger, signalsContext, cache) {
     const rootId = root.id;
     if (signalsContext && !signalsContext.hasRoot(rootId)) {
       return;
     }
-    let renderTarget = signalsContext?.findComponentByVector(rootId, vector);
-    if (!renderTarget) {
-      const signalsMeta = aConcept.A_Context.meta(are.AreSignals);
-      const pool = signalsContext?.getComponentById(rootId);
-      const metaTarget = signalsMeta?.findComponentByVector(
-        vector,
-        pool?.length ? pool : void 0
-      );
-      if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
-        renderTarget = metaTarget;
-      }
-    }
+    const renderTarget = this.matchComponent(rootId, vector, signalsContext);
     const def = signalsContext?.getDefault(rootId);
     const componentName = renderTarget?.name ? aConcept.A_FormatterHelper.toKebabCase(renderTarget.name) : def?.name ? aConcept.A_FormatterHelper.toKebabCase(def.name) : void 0;
     if (!componentName) {
-      for (let i = 0; i < root.children.length; i++) {
-        const child = root.children[i];
-        signalsContext?.unsubscribe(child);
-        child.unmount();
-        child.destroy();
-        root.removeChild(child);
+      for (const child of [...root.children]) {
+        this.stashChild(root, child, signalsContext, cache);
       }
       root.setContent("");
       return;
@@ -106,13 +75,14 @@ exports.AreRoot = class AreRoot extends are.Are {
     if (currentChild?.type === componentName) {
       return;
     }
+    for (const child of [...root.children]) {
+      this.stashChild(root, child, signalsContext, cache);
+    }
     root.setContent(`<${componentName}></${componentName}>`);
-    for (let i = 0; i < root.children.length; i++) {
-      const child = root.children[i];
-      signalsContext?.unsubscribe(child);
-      child.unmount();
-      child.destroy();
-      root.removeChild(child);
+    const cached = cache?.take(root.id, componentName);
+    if (cached) {
+      this.restoreChild(root, cached, signalsContext);
+      return;
     }
     root.tokenize();
     for (let i = 0; i < root.children.length; i++) {
@@ -124,22 +94,141 @@ exports.AreRoot = class AreRoot extends are.Are {
       }
       child.transform();
       child.compile();
-      child.mount();
+      await child.mount();
+    }
+  }
+  /**
+   * Resolves the component a vector should render for the given root, mirroring
+   * the priority used everywhere in the routing system:
+   *   1. Root-specific conditions registered on AreSignalsContext.
+   *   2. The global AreSignalsMeta map, restricted to this outlet's pool.
+   *
+   * Passing the pool *into* the meta lookup is critical: without it, the first
+   * globally matching component wins and may belong to a different outlet
+   * (e.g. AisRequirementsPanel for the meta-outlet matching
+   * AisEditorCursorScope) — the pool check would then reject it and the outlet
+   * would fall back to its default, hiding a valid in-pool match (e.g.
+   * AisDiagramTab matching AisSetPrimaryDisplay).
+   *
+   * Returns `undefined` when nothing matches — callers decide whether to use a
+   * configured default, body content, or clear the outlet.
+   */
+  matchComponent(rootId, vector, signalsContext) {
+    if (!vector) return void 0;
+    let renderTarget = signalsContext?.findComponentByVector(rootId, vector);
+    if (!renderTarget) {
+      const signalsMeta = aConcept.A_Context.meta(are.AreSignals);
+      const pool = signalsContext?.getComponentById(rootId);
+      const metaTarget = signalsMeta?.findComponentByVector(
+        vector,
+        pool?.length ? pool : void 0,
+        rootId
+      );
+      if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
+        renderTarget = metaTarget;
+      }
+    }
+    return renderTarget;
+  }
+  /**
+   * Builds the vector used for the INITIAL render. It is seeded from the
+   * accumulated signal state (every signal dispatched on the bus so far) so a
+   * freshly-mounted outlet reflects the live application state immediately,
+   * not just on the next signal tick. The current URL route is appended when
+   * no AreRoute is already present in the state, so route-driven outlets still
+   * resolve on the very first paint (before AreRouteWatcher has dispatched).
+   */
+  buildInitialVector(signalState) {
+    const signals = [];
+    if (signalState) {
+      for (const signal of signalState.toVector()) {
+        if (signal) signals.push(signal);
+      }
+    }
+    if (!signals.some((signal) => signal instanceof AreRoute_signal.AreRoute)) {
+      try {
+        const currentRoute = AreRoute_signal.AreRoute.default();
+        if (currentRoute) signals.push(currentRoute);
+      } catch {
+      }
+    }
+    return new aSignal.A_SignalVector(signals);
+  }
+  /**
+   * Detach a displayed child subtree from the outlet and stash it in the cache
+   * for fast re-injection later. The subtree is unmounted (its scene plan is
+   * preserved) and deregistered from the root scope, but NOT destroyed. The
+   * nodes that were subscribed to the signal bus are unsubscribed while cached
+   * so the detached DOM never reacts to signals, and recorded so they can be
+   * re-subscribed verbatim on restore.
+   *
+   * When no cache is available, or the LRU evicts an entry, the affected
+   * subtree is fully destroyed.
+   */
+  stashChild(root, child, signalsContext, cache) {
+    const tag = child.type;
+    child.unmount();
+    const subscribers = signalsContext ? this.collectSubscribers(child, signalsContext) : [];
+    for (const node of subscribers) {
+      signalsContext?.unsubscribe(node);
+    }
+    root.removeChild(child);
+    if (!cache) {
+      void child.destroy();
+      return;
+    }
+    const evicted = cache.put(root.id, tag, { node: child, subscribers });
+    for (const entry of evicted) {
+      void entry.node.destroy();
+    }
+  }
+  /**
+   * Re-attach a cached subtree to the outlet and re-mount it from its preserved
+   * scene plan, re-subscribing exactly the nodes that were subscribed before it
+   * was cached.
+   */
+  restoreChild(root, entry, signalsContext) {
+    const child = entry.node;
+    root.addChild(child);
+    for (const node of entry.subscribers) {
+      signalsContext?.subscribe(node);
+    }
+    child.mount();
+  }
+  /**
+   * Walk a subtree and collect the nodes currently registered as signal
+   * subscribers. Mirrors the subscription performed at init time in
+   * AreHTMLLifecycle (component nodes and root nodes) without depending on the
+   * concrete node classes — it simply intersects the subtree with the live
+   * subscriber registry.
+   */
+  collectSubscribers(node, signalsContext) {
+    const result = [];
+    const queue = [node];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      if (signalsContext.subscribers.has(current)) {
+        result.push(current);
+      }
+      queue.push(...current.children);
     }
+    return result;
   }
 };
 __decorateClass([
   are.Are.Template,
   __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
   __decorateParam(1, aConcept.A_Inject(aLogger.A_Logger)),
-  __decorateParam(2, aConcept.A_Inject(are.AreSignalsContext))
+  __decorateParam(2, aConcept.A_Inject(are.AreSignalsContext)),
+  __decorateParam(3, aConcept.A_Inject(aSignal.A_SignalState))
 ], exports.AreRoot.prototype, "template", 1);
 __decorateClass([
   are.Are.Signal,
   __decorateParam(0, aConcept.A_Inject(aConcept.A_Caller)),
   __decorateParam(1, aConcept.A_Inject(aSignal.A_SignalVector)),
   __decorateParam(2, aConcept.A_Inject(aLogger.A_Logger)),
-  __decorateParam(3, aConcept.A_Inject(are.AreSignalsContext))
+  __decorateParam(3, aConcept.A_Inject(are.AreSignalsContext)),
+  __decorateParam(4, aConcept.A_Inject(AreRootCache_context.AreRootCache))
 ], exports.AreRoot.prototype, "onSignal", 1);
 exports.AreRoot = __decorateClass([
   core.A_Frame.Define({

package/dist/node/lib/AreRoot/AreRoot.component.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/AreRoot/AreRoot.component.ts"],"names":["AreRoot","Are","AreRoute","A_SignalVector","A_Context","AreSignals","A_FormatterHelper","A_Caller","A_Logger","AreSignalsContext","A_Frame"],"mappings":"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","file":"AreRoot.component.js","sourcesContent":["import { A_Caller, A_Context, A_FormatterHelper, A_Inject, } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_SignalVector } from \"@adaas/a-utils/a-signal\";\nimport { Are, AreNode, AreSignals, AreSignalsMeta, AreSignalsContext } from \"@adaas/are\";\nimport { AreRoute } from \"@adaas/are-html/signals/AreRoute.signal\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'The AreRoot component serves as the foundational entry point for the A-Concept Rendering Engine (ARE). It is responsible for initializing the rendering process, managing the root node of the component tree, and handling signal-based rendering logic. The AreRoot component processes incoming signals to determine which child components to render, allowing for dynamic and responsive UI updates based on application state and user interactions.'\n})\nexport class AreRoot extends Are {\n\n    @Are.Template\n    async template(\n        @A_Inject(A_Caller) root: AreNode,\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n    ) {\n\n        const rootId = root.id;\n\n        // No routing config for this root — but still honour body content or\n        // a 'default' attribute if one is present on the markup.\n        if (signalsContext && !signalsContext.hasRoot(rootId)) {\n            if (!root.content?.trim()) {\n                // Fallback: legacy default= attribute\n                const defaultMatch = root.markup?.match(/\\bdefault=[\"']([^\"']*)[\"']/);\n                const defaultComponent = defaultMatch?.[1];\n                if (defaultComponent) {\n                    root.setContent(`<${defaultComponent}></${defaultComponent}>`);\n                }\n            }\n            // Body content (or none) — tokenizer picks it up without intervention\n            return;\n        }\n\n        const currentRoute = AreRoute.default();\n\n        let componentName: string | undefined;\n\n        if (currentRoute) {\n            const initialVector = new A_SignalVector([currentRoute]);\n\n            // 1. Lookup via AreSignalsContext (per root-id conditions)\n            let renderTarget = signalsContext?.findComponentByVector(rootId, initialVector);\n\n            // 2. Fall back to global AreSignalsMeta, pool-filtered.\n            // IMPORTANT: pass the pool *into* the lookup so it can skip over\n            // out-of-pool matches (e.g. a meta-outlet component whose condition\n            // also matches the same vector) and find the highest-priority match\n            // that this outlet can actually render. Filtering only after the\n            // fact would mask valid in-pool matches and surface the outlet's\n            // default instead.\n            if (!renderTarget) {\n                const signalsMeta = A_Context.meta<AreSignalsMeta>(AreSignals);\n                const pool = signalsContext?.getComponentById(rootId);\n                const metaTarget = signalsMeta?.findComponentByVector(\n                    initialVector,\n                    pool?.length ? pool : undefined,\n                );\n                if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {\n                    renderTarget = metaTarget;\n                }\n            }\n\n            if (renderTarget?.name) {\n                componentName = A_FormatterHelper.toKebabCase(renderTarget.name);\n            }\n        }\n\n        // 3. Fall back to body content (the nodes already placed inside the\n        //    <are-root> tag act as the default).  No setContent() call needed —\n        //    the tokenizer will process root.content as-is.\n        if (!componentName) {\n            if (root.content?.trim()) {\n                return;\n            }\n        }\n        // 3.5. Fall back to AreSignalsContext default component for this root.\n        if (!componentName) {\n            const defaultComp = signalsContext?.getDefault(rootId);\n            if (defaultComp?.name) {\n                componentName = A_FormatterHelper.toKebabCase(defaultComp.name);\n            }\n        }\n        // 4. Last resort: legacy default= attribute on the markup.\n        if (!componentName) {\n            const defaultMatch = root.markup?.match(/\\bdefault=[\"']([^\"']*)[\"']/);\n            componentName = defaultMatch?.[1];\n        }\n\n        if (!componentName) {\n            logger.warning('AreRoot: No component found for initial render. Provide body content, a route condition, or a \"default\" attribute.');\n            return;\n        }\n\n        root.setContent(`<${componentName}></${componentName}>`);\n    }\n\n\n    @Are.Signal\n    async onSignal(\n        @A_Inject(A_Caller) root: AreNode,\n        @A_Inject(A_SignalVector) vector: A_SignalVector,\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n    ) {\n        const rootId = root.id;\n\n        // No routing config for this root — signals do not affect its content\n        if (signalsContext && !signalsContext.hasRoot(rootId)) {\n            return;\n        }\n\n        // 1. Try root-specific lookup via AreSignalsContext (keyed by the are-root's id attribute)\n        let renderTarget = signalsContext?.findComponentByVector(rootId, vector);\n\n        // 2. Fall back to global AreSignalsMeta lookup, restricted to this\n        //    outlet's pool. Passing the pool *into* the lookup is critical:\n        //    without it, the first globally matching component wins and may\n        //    belong to a different outlet (e.g. AisRequirementsPanel for the\n        //    meta-outlet matching AisEditorCursorScope) — the pool check then\n        //    rejects it and the outlet falls back to default, hiding a valid\n        //    in-pool match (e.g. AisDiagramTab matching AisSetPrimaryDisplay).\n        if (!renderTarget) {\n            const signalsMeta = A_Context.meta<AreSignalsMeta>(AreSignals);\n            const pool = signalsContext?.getComponentById(rootId);\n            const metaTarget = signalsMeta?.findComponentByVector(\n                vector,\n                pool?.length ? pool : undefined,\n            );\n            if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {\n                renderTarget = metaTarget;\n            }\n        }\n\n        const def = signalsContext?.getDefault(rootId);\n        const componentName = renderTarget?.name\n            ? A_FormatterHelper.toKebabCase(renderTarget.name)\n            : def?.name\n                ? A_FormatterHelper.toKebabCase(def.name)\n                : undefined;\n\n        // No matching condition for this signal vector and no default — clear the outlet.\n        if (!componentName) {\n            for (let i = 0; i < root.children.length; i++) {\n                const child = root.children[i];\n                signalsContext?.unsubscribe(child);\n                child.unmount();\n                child.destroy();\n                root.removeChild(child);\n            }\n            root.setContent('');\n            return;\n        }\n\n        // Guard: if the outlet already shows the same component, do nothing.\n        // Prevents infinite remount loops when a non-routing signal carries a\n        // stale routing signal in the accumulated A_SignalState vector.\n        // node.type is the kebab-case tag name — the most direct and reliable\n        // identifier (no constructor-name resolution, no proxy wrapping issues).\n        const currentChild = root.children[0] as AreNode | undefined;\n        if (currentChild?.type === componentName) {\n            return;\n        }\n\n        root.setContent(`<${componentName}></${componentName}>`);\n\n        // Unsubscribe old children BEFORE destroying them.\n        // Without this, AreSignals.handleSignalVector keeps iterating stale\n        // (scope-less) nodes on every subsequent signal and throws an error.\n        for (let i = 0; i < root.children.length; i++) {\n            const child = root.children[i];\n            signalsContext?.unsubscribe(child);\n            child.unmount();\n            child.destroy();\n            root.removeChild(child);\n        }\n\n\n        root.tokenize();\n\n        for (let i = 0; i < root.children.length; i++) {\n            const child = root.children[i];\n            child.init();\n\n            const res = child.load();\n            if (res instanceof Promise) {\n                await res;\n            }\n            child.transform();\n\n            child.compile();\n            child.mount();\n        }\n    }\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/AreRoot/AreRoot.component.ts"],"names":["AreRoot","Are","A_FormatterHelper","A_Context","AreSignals","AreRoute","A_SignalVector","A_Caller","A_Logger","AreSignalsContext","A_SignalState","AreRootCache","A_Frame"],"mappings":"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","file":"AreRoot.component.js","sourcesContent":["import { A_Caller, A_Context, A_FormatterHelper, A_Inject, A_TYPES__Ctor } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame/core\";\nimport { A_Logger } from \"@adaas/a-utils/a-logger\";\nimport { A_Signal, A_SignalState, A_SignalVector } from \"@adaas/a-utils/a-signal\";\nimport { Are, AreNode, AreSignals, AreSignalsMeta, AreSignalsContext } from \"@adaas/are\";\nimport { AreRoute } from \"@adaas/are-html/signals/AreRoute.signal\";\nimport { AreRootCache, AreRootCacheEntry } from \"./AreRootCache.context\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'The AreRoot component serves as the foundational entry point for the A-Concept Rendering Engine (ARE). It is responsible for initializing the rendering process, managing the root node of the component tree, and handling signal-based rendering logic. The AreRoot component processes incoming signals to determine which child components to render, allowing for dynamic and responsive UI updates based on application state and user interactions.'\n})\nexport class AreRoot extends Are {\n\n    @Are.Template\n    async template(\n        @A_Inject(A_Caller) root: AreNode,\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n        @A_Inject(A_SignalState) signalState?: A_SignalState,\n    ) {\n\n        const rootId = root.id;\n\n        // No routing config for this root — but still honour body content or\n        // a 'default' attribute if one is present on the markup.\n        if (signalsContext && !signalsContext.hasRoot(rootId)) {\n            if (!root.content?.trim()) {\n                // Fallback: legacy default= attribute\n                const defaultMatch = root.markup?.match(/\\bdefault=[\"']([^\"']*)[\"']/);\n                const defaultComponent = defaultMatch?.[1];\n                if (defaultComponent) {\n                    root.setContent(`<${defaultComponent}></${defaultComponent}>`);\n                }\n            }\n            // Body content (or none) — tokenizer picks it up without intervention\n            return;\n        }\n\n        // Select from the ACCUMULATED signal state (every signal dispatched so\n        // far), not just the current URL route. Outlets keyed on domain signals\n        // (e.g. a primary-display selector) must reflect the live vector the\n        // moment they mount — even when they mount AFTER the routing signal was\n        // dispatched (a nested outlet inside a just-rendered parent). Using the\n        // same vector + lookup as onSignal keeps initial render and subsequent\n        // updates consistent.\n        const initialVector = this.buildInitialVector(signalState);\n        const renderTarget = this.matchComponent(rootId, initialVector, signalsContext);\n\n        let componentName: string | undefined = renderTarget?.name\n            ? A_FormatterHelper.toKebabCase(renderTarget.name)\n            : undefined;\n\n        // 3. Fall back to body content (the nodes already placed inside the\n        //    <are-root> tag act as the default).  No setContent() call needed —\n        //    the tokenizer will process root.content as-is.\n        if (!componentName) {\n            if (root.content?.trim()) {\n                return;\n            }\n        }\n        // 3.5. Fall back to AreSignalsContext default component for this root.\n        if (!componentName) {\n            const defaultComp = signalsContext?.getDefault(rootId);\n            if (defaultComp?.name) {\n                componentName = A_FormatterHelper.toKebabCase(defaultComp.name);\n            }\n        }\n        // 4. Last resort: legacy default= attribute on the markup.\n        if (!componentName) {\n            const defaultMatch = root.markup?.match(/\\bdefault=[\"']([^\"']*)[\"']/);\n            componentName = defaultMatch?.[1];\n        }\n\n        if (!componentName) {\n            logger.warning('AreRoot: No component found for initial render. Provide body content, a route condition, or a \"default\" attribute.');\n            return;\n        }\n\n        root.setContent(`<${componentName}></${componentName}>`);\n    }\n\n\n    @Are.Signal\n    async onSignal(\n        @A_Inject(A_Caller) root: AreNode,\n        @A_Inject(A_SignalVector) vector: A_SignalVector,\n        @A_Inject(A_Logger) logger: A_Logger,\n        @A_Inject(AreSignalsContext) signalsContext?: AreSignalsContext,\n        @A_Inject(AreRootCache) cache?: AreRootCache,\n    ) {\n        const rootId = root.id;\n\n        // No routing config for this root — signals do not affect its content\n        if (signalsContext && !signalsContext.hasRoot(rootId)) {\n            return;\n        }\n\n        // Resolve the target component for the incoming vector using the SAME\n        // lookup the initial template render uses (root-id conditions first,\n        // then the global pool-filtered meta map).\n        const renderTarget = this.matchComponent(rootId, vector, signalsContext);\n\n        const def = signalsContext?.getDefault(rootId);\n        const componentName = renderTarget?.name\n            ? A_FormatterHelper.toKebabCase(renderTarget.name)\n            : def?.name\n                ? A_FormatterHelper.toKebabCase(def.name)\n                : undefined;\n\n        // No matching condition for this signal vector and no default — clear the outlet.\n        if (!componentName) {\n            for (const child of [...root.children]) {\n                this.stashChild(root, child, signalsContext, cache);\n            }\n            root.setContent('');\n            return;\n        }\n\n        // Guard: if the outlet already shows the same component, do nothing.\n        // Prevents infinite remount loops when a non-routing signal carries a\n        // stale routing signal in the accumulated A_SignalState vector.\n        // node.type is the kebab-case tag name — the most direct and reliable\n        // identifier (no constructor-name resolution, no proxy wrapping issues).\n        const currentChild = root.children[0] as AreNode | undefined;\n        if (currentChild?.type === componentName) {\n            return;\n        }\n\n        // Stash the currently displayed children so routing back to them can be\n        // re-injected instantly from the cache (they are unmounted + detached but\n        // NOT destroyed). Falls back to full teardown when no cache is available.\n        for (const child of [...root.children]) {\n            this.stashChild(root, child, signalsContext, cache);\n        }\n\n        root.setContent(`<${componentName}></${componentName}>`);\n\n        // Fast path: a previously rendered subtree for this component is cached —\n        // re-attach it and re-mount from the preserved scene plan, skipping the\n        // expensive tokenize/init/load/transform/compile pipeline.\n        const cached = cache?.take(root.id, componentName);\n        if (cached) {\n            this.restoreChild(root, cached, signalsContext);\n            return;\n        }\n\n        // Slow path: build the component subtree from scratch.\n        root.tokenize();\n\n        for (let i = 0; i < root.children.length; i++) {\n            const child = root.children[i];\n            child.init();\n\n            const res = child.load();\n            if (res instanceof Promise) {\n                await res;\n            }\n            child.transform();\n\n            child.compile();\n            // The HTML engine time-slices large initial mounts; await so a heavy\n            // routed component renders in yielding chunks instead of freezing the\n            // main thread on first entry. Small subtrees resolve synchronously.\n            await child.mount();\n        }\n    }\n\n    /**\n     * Resolves the component a vector should render for the given root, mirroring\n     * the priority used everywhere in the routing system:\n     *   1. Root-specific conditions registered on AreSignalsContext.\n     *   2. The global AreSignalsMeta map, restricted to this outlet's pool.\n     *\n     * Passing the pool *into* the meta lookup is critical: without it, the first\n     * globally matching component wins and may belong to a different outlet\n     * (e.g. AisRequirementsPanel for the meta-outlet matching\n     * AisEditorCursorScope) — the pool check would then reject it and the outlet\n     * would fall back to its default, hiding a valid in-pool match (e.g.\n     * AisDiagramTab matching AisSetPrimaryDisplay).\n     *\n     * Returns `undefined` when nothing matches — callers decide whether to use a\n     * configured default, body content, or clear the outlet.\n     */\n    protected matchComponent(\n        rootId: string,\n        vector: A_SignalVector | undefined,\n        signalsContext?: AreSignalsContext,\n    ): A_TYPES__Ctor<Are> | undefined {\n        if (!vector) return undefined;\n\n        // 1. Root-specific conditions.\n        let renderTarget = signalsContext?.findComponentByVector(rootId, vector);\n\n        // 2. Global pool-filtered meta map.\n        if (!renderTarget) {\n            const signalsMeta = A_Context.meta<AreSignalsMeta>(AreSignals);\n            const pool = signalsContext?.getComponentById(rootId);\n            const metaTarget = signalsMeta?.findComponentByVector(\n                vector,\n                pool?.length ? pool : undefined,\n                rootId,\n            );\n            if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {\n                renderTarget = metaTarget;\n            }\n        }\n\n        return renderTarget as A_TYPES__Ctor<Are> | undefined;\n    }\n\n    /**\n     * Builds the vector used for the INITIAL render. It is seeded from the\n     * accumulated signal state (every signal dispatched on the bus so far) so a\n     * freshly-mounted outlet reflects the live application state immediately,\n     * not just on the next signal tick. The current URL route is appended when\n     * no AreRoute is already present in the state, so route-driven outlets still\n     * resolve on the very first paint (before AreRouteWatcher has dispatched).\n     */\n    protected buildInitialVector(signalState?: A_SignalState): A_SignalVector {\n        const signals: A_Signal[] = [];\n\n        if (signalState) {\n            for (const signal of signalState.toVector()) {\n                if (signal) signals.push(signal);\n            }\n        }\n\n        if (!signals.some(signal => signal instanceof AreRoute)) {\n            try {\n                const currentRoute = AreRoute.default();\n                if (currentRoute) signals.push(currentRoute);\n            } catch {\n                // Non-browser environment (no document) — route is simply absent.\n            }\n        }\n\n        return new A_SignalVector(signals);\n    }\n\n    /**\n     * Detach a displayed child subtree from the outlet and stash it in the cache\n     * for fast re-injection later. The subtree is unmounted (its scene plan is\n     * preserved) and deregistered from the root scope, but NOT destroyed. The\n     * nodes that were subscribed to the signal bus are unsubscribed while cached\n     * so the detached DOM never reacts to signals, and recorded so they can be\n     * re-subscribed verbatim on restore.\n     *\n     * When no cache is available, or the LRU evicts an entry, the affected\n     * subtree is fully destroyed.\n     */\n    protected stashChild(\n        root: AreNode,\n        child: AreNode,\n        signalsContext: AreSignalsContext | undefined,\n        cache: AreRootCache | undefined,\n    ): void {\n        const tag = child.type;\n\n        child.unmount();\n\n        // Collect exactly the nodes that are currently subscribed within this\n        // subtree, then unsubscribe them. Without this, AreSignals keeps\n        // delivering vectors to a detached subtree that would update reverted\n        // DOM (unmount does not deactivate the scene).\n        const subscribers = signalsContext\n            ? this.collectSubscribers(child, signalsContext)\n            : [];\n        for (const node of subscribers) {\n            signalsContext?.unsubscribe(node);\n        }\n\n        // Deregister from the root scope (the \"deregister node from parent\").\n        root.removeChild(child);\n\n        if (!cache) {\n            void child.destroy();\n            return;\n        }\n\n        const evicted = cache.put(root.id, tag, { node: child, subscribers });\n        for (const entry of evicted) {\n            // Evicted entries are already unmounted + unsubscribed + detached.\n            void entry.node.destroy();\n        }\n    }\n\n    /**\n     * Re-attach a cached subtree to the outlet and re-mount it from its preserved\n     * scene plan, re-subscribing exactly the nodes that were subscribed before it\n     * was cached.\n     */\n    protected restoreChild(\n        root: AreNode,\n        entry: AreRootCacheEntry,\n        signalsContext: AreSignalsContext | undefined,\n    ): void {\n        const child = entry.node;\n\n        root.addChild(child);\n\n        for (const node of entry.subscribers) {\n            signalsContext?.subscribe(node);\n        }\n\n        child.mount();\n    }\n\n    /**\n     * Walk a subtree and collect the nodes currently registered as signal\n     * subscribers. Mirrors the subscription performed at init time in\n     * AreHTMLLifecycle (component nodes and root nodes) without depending on the\n     * concrete node classes — it simply intersects the subtree with the live\n     * subscriber registry.\n     */\n    protected collectSubscribers(\n        node: AreNode,\n        signalsContext: AreSignalsContext,\n    ): AreNode[] {\n        const result: AreNode[] = [];\n        const queue: AreNode[] = [node];\n        while (queue.length > 0) {\n            const current = queue.shift()!;\n            if (signalsContext.subscribers.has(current)) {\n                result.push(current);\n            }\n            queue.push(...current.children);\n        }\n        return result;\n    }\n}\n"]}

package/dist/node/lib/AreRoot/AreRoot.component.mjs

@@ -1,13 +1,14 @@
 import { __decorateClass, __decorateParam } from '../../chunk-EQQGB2QZ.mjs';
-import { A_Inject, A_Caller, A_Context, A_FormatterHelper } from '@adaas/a-concept';
+import { A_Inject, A_Caller, A_FormatterHelper, A_Context } from '@adaas/a-concept';
 import { A_Frame } from '@adaas/a-frame/core';
 import { A_Logger } from '@adaas/a-utils/a-logger';
-import { A_SignalVector } from '@adaas/a-utils/a-signal';
+import { A_SignalState, A_SignalVector } from '@adaas/a-utils/a-signal';
 import { Are, AreSignalsContext, AreSignals } from '@adaas/are';
 import { AreRoute } from '@adaas/are-html/signals/AreRoute.signal';
+import { AreRootCache } from './AreRootCache.context';
 
 let AreRoot = class extends Are {
-  async template(root, logger, signalsContext) {
+  async template(root, logger, signalsContext, signalState) {
     const rootId = root.id;
     if (signalsContext && !signalsContext.hasRoot(rootId)) {
       if (!root.content?.trim()) {
@@ -19,26 +20,9 @@ let AreRoot = class extends Are {
       }
       return;
     }
-    const currentRoute = AreRoute.default();
-    let componentName;
-    if (currentRoute) {
-      const initialVector = new A_SignalVector([currentRoute]);
-      let renderTarget = signalsContext?.findComponentByVector(rootId, initialVector);
-      if (!renderTarget) {
-        const signalsMeta = A_Context.meta(AreSignals);
-        const pool = signalsContext?.getComponentById(rootId);
-        const metaTarget = signalsMeta?.findComponentByVector(
-          initialVector,
-          pool?.length ? pool : void 0
-        );
-        if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
-          renderTarget = metaTarget;
-        }
-      }
-      if (renderTarget?.name) {
-        componentName = A_FormatterHelper.toKebabCase(renderTarget.name);
-      }
-    }
+    const initialVector = this.buildInitialVector(signalState);
+    const renderTarget = this.matchComponent(rootId, initialVector, signalsContext);
+    let componentName = renderTarget?.name ? A_FormatterHelper.toKebabCase(renderTarget.name) : void 0;
     if (!componentName) {
       if (root.content?.trim()) {
         return;
@@ -60,32 +44,17 @@ let AreRoot = class extends Are {
     }
     root.setContent(`<${componentName}></${componentName}>`);
   }
-  async onSignal(root, vector, logger, signalsContext) {
+  async onSignal(root, vector, logger, signalsContext, cache) {
     const rootId = root.id;
     if (signalsContext && !signalsContext.hasRoot(rootId)) {
       return;
     }
-    let renderTarget = signalsContext?.findComponentByVector(rootId, vector);
-    if (!renderTarget) {
-      const signalsMeta = A_Context.meta(AreSignals);
-      const pool = signalsContext?.getComponentById(rootId);
-      const metaTarget = signalsMeta?.findComponentByVector(
-        vector,
-        pool?.length ? pool : void 0
-      );
-      if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
-        renderTarget = metaTarget;
-      }
-    }
+    const renderTarget = this.matchComponent(rootId, vector, signalsContext);
     const def = signalsContext?.getDefault(rootId);
     const componentName = renderTarget?.name ? A_FormatterHelper.toKebabCase(renderTarget.name) : def?.name ? A_FormatterHelper.toKebabCase(def.name) : void 0;
     if (!componentName) {
-      for (let i = 0; i < root.children.length; i++) {
-        const child = root.children[i];
-        signalsContext?.unsubscribe(child);
-        child.unmount();
-        child.destroy();
-        root.removeChild(child);
+      for (const child of [...root.children]) {
+        this.stashChild(root, child, signalsContext, cache);
       }
       root.setContent("");
       return;
@@ -94,13 +63,14 @@ let AreRoot = class extends Are {
     if (currentChild?.type === componentName) {
       return;
     }
+    for (const child of [...root.children]) {
+      this.stashChild(root, child, signalsContext, cache);
+    }
     root.setContent(`<${componentName}></${componentName}>`);
-    for (let i = 0; i < root.children.length; i++) {
-      const child = root.children[i];
-      signalsContext?.unsubscribe(child);
-      child.unmount();
-      child.destroy();
-      root.removeChild(child);
+    const cached = cache?.take(root.id, componentName);
+    if (cached) {
+      this.restoreChild(root, cached, signalsContext);
+      return;
     }
     root.tokenize();
     for (let i = 0; i < root.children.length; i++) {
@@ -112,22 +82,141 @@ let AreRoot = class extends Are {
       }
       child.transform();
       child.compile();
-      child.mount();
+      await child.mount();
+    }
+  }
+  /**
+   * Resolves the component a vector should render for the given root, mirroring
+   * the priority used everywhere in the routing system:
+   *   1. Root-specific conditions registered on AreSignalsContext.
+   *   2. The global AreSignalsMeta map, restricted to this outlet's pool.
+   *
+   * Passing the pool *into* the meta lookup is critical: without it, the first
+   * globally matching component wins and may belong to a different outlet
+   * (e.g. AisRequirementsPanel for the meta-outlet matching
+   * AisEditorCursorScope) — the pool check would then reject it and the outlet
+   * would fall back to its default, hiding a valid in-pool match (e.g.
+   * AisDiagramTab matching AisSetPrimaryDisplay).
+   *
+   * Returns `undefined` when nothing matches — callers decide whether to use a
+   * configured default, body content, or clear the outlet.
+   */
+  matchComponent(rootId, vector, signalsContext) {
+    if (!vector) return void 0;
+    let renderTarget = signalsContext?.findComponentByVector(rootId, vector);
+    if (!renderTarget) {
+      const signalsMeta = A_Context.meta(AreSignals);
+      const pool = signalsContext?.getComponentById(rootId);
+      const metaTarget = signalsMeta?.findComponentByVector(
+        vector,
+        pool?.length ? pool : void 0,
+        rootId
+      );
+      if (metaTarget && (!pool?.length || pool.includes(metaTarget))) {
+        renderTarget = metaTarget;
+      }
+    }
+    return renderTarget;
+  }
+  /**
+   * Builds the vector used for the INITIAL render. It is seeded from the
+   * accumulated signal state (every signal dispatched on the bus so far) so a
+   * freshly-mounted outlet reflects the live application state immediately,
+   * not just on the next signal tick. The current URL route is appended when
+   * no AreRoute is already present in the state, so route-driven outlets still
+   * resolve on the very first paint (before AreRouteWatcher has dispatched).
+   */
+  buildInitialVector(signalState) {
+    const signals = [];
+    if (signalState) {
+      for (const signal of signalState.toVector()) {
+        if (signal) signals.push(signal);
+      }
+    }
+    if (!signals.some((signal) => signal instanceof AreRoute)) {
+      try {
+        const currentRoute = AreRoute.default();
+        if (currentRoute) signals.push(currentRoute);
+      } catch {
+      }
+    }
+    return new A_SignalVector(signals);
+  }
+  /**
+   * Detach a displayed child subtree from the outlet and stash it in the cache
+   * for fast re-injection later. The subtree is unmounted (its scene plan is
+   * preserved) and deregistered from the root scope, but NOT destroyed. The
+   * nodes that were subscribed to the signal bus are unsubscribed while cached
+   * so the detached DOM never reacts to signals, and recorded so they can be
+   * re-subscribed verbatim on restore.
+   *
+   * When no cache is available, or the LRU evicts an entry, the affected
+   * subtree is fully destroyed.
+   */
+  stashChild(root, child, signalsContext, cache) {
+    const tag = child.type;
+    child.unmount();
+    const subscribers = signalsContext ? this.collectSubscribers(child, signalsContext) : [];
+    for (const node of subscribers) {
+      signalsContext?.unsubscribe(node);
+    }
+    root.removeChild(child);
+    if (!cache) {
+      void child.destroy();
+      return;
+    }
+    const evicted = cache.put(root.id, tag, { node: child, subscribers });
+    for (const entry of evicted) {
+      void entry.node.destroy();
+    }
+  }
+  /**
+   * Re-attach a cached subtree to the outlet and re-mount it from its preserved
+   * scene plan, re-subscribing exactly the nodes that were subscribed before it
+   * was cached.
+   */
+  restoreChild(root, entry, signalsContext) {
+    const child = entry.node;
+    root.addChild(child);
+    for (const node of entry.subscribers) {
+      signalsContext?.subscribe(node);
+    }
+    child.mount();
+  }
+  /**
+   * Walk a subtree and collect the nodes currently registered as signal
+   * subscribers. Mirrors the subscription performed at init time in
+   * AreHTMLLifecycle (component nodes and root nodes) without depending on the
+   * concrete node classes — it simply intersects the subtree with the live
+   * subscriber registry.
+   */
+  collectSubscribers(node, signalsContext) {
+    const result = [];
+    const queue = [node];
+    while (queue.length > 0) {
+      const current = queue.shift();
+      if (signalsContext.subscribers.has(current)) {
+        result.push(current);
+      }
+      queue.push(...current.children);
     }
+    return result;
   }
 };
 __decorateClass([
   Are.Template,
   __decorateParam(0, A_Inject(A_Caller)),
   __decorateParam(1, A_Inject(A_Logger)),
-  __decorateParam(2, A_Inject(AreSignalsContext))
+  __decorateParam(2, A_Inject(AreSignalsContext)),
+  __decorateParam(3, A_Inject(A_SignalState))
 ], AreRoot.prototype, "template", 1);
 __decorateClass([
   Are.Signal,
   __decorateParam(0, A_Inject(A_Caller)),
   __decorateParam(1, A_Inject(A_SignalVector)),
   __decorateParam(2, A_Inject(A_Logger)),
-  __decorateParam(3, A_Inject(AreSignalsContext))
+  __decorateParam(3, A_Inject(AreSignalsContext)),
+  __decorateParam(4, A_Inject(AreRootCache))
 ], AreRoot.prototype, "onSignal", 1);
 AreRoot = __decorateClass([
   A_Frame.Define({