@adaas/are-html 0.0.20 → 0.0.22

package/dist/node/helpers/AreScheduler.helper.d.ts

@@ -0,0 +1,39 @@
+/**
+ * AreSchedulerHelper
+ *
+ * Cooperative time-slicing primitives shared by the chunked (async) render
+ * paths — the initial whole-page mount walk and the `$for` directive. Both need
+ * the SAME two capabilities:
+ *   1. a high-resolution clock to measure how long the current chunk has run, and
+ *   2. a zero-delay macrotask scheduler to yield to the browser between chunks
+ *      so it can paint and process input before resuming work.
+ *
+ * Keeping these in one helper avoids duplicating the `MessageChannel` plumbing
+ * across directives/lifecycle and gives a single place to tune the strategy.
+ */
+declare class AreSchedulerHelper {
+    /**
+     * Lazily-created `MessageChannel` used to post zero-delay macrotasks.
+     * Created on first use so non-DOM environments (tests / SSR) that never
+     * schedule a chunk pay nothing.
+     */
+    private static _channel?;
+    /** FIFO queue of callbacks waiting for their posted macrotask to fire. */
+    private static readonly _queue;
+    /**
+     * High-resolution wall-clock time in milliseconds. Uses `performance.now()`
+     * when available (monotonic, sub-millisecond), falling back to `Date.now()`.
+     */
+    static now(): number;
+    /**
+     * Schedule `fn` to run on the next macrotask.
+     *
+     * `MessageChannel` yields a true macrotask without the ~4ms clamp that nested
+     * `setTimeout(0)` calls incur, so the browser can paint between chunks with
+     * minimal scheduling overhead. Falls back to `setTimeout` in non-DOM
+     * environments (e.g. tests / SSR).
+     */
+    static scheduleMacrotask(fn: () => void): void;
+}
+
+export { AreSchedulerHelper };

package/dist/node/helpers/AreScheduler.helper.js

@@ -0,0 +1,40 @@
+'use strict';
+
+class AreSchedulerHelper {
+  /**
+   * High-resolution wall-clock time in milliseconds. Uses `performance.now()`
+   * when available (monotonic, sub-millisecond), falling back to `Date.now()`.
+   */
+  static now() {
+    return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+  }
+  /**
+   * Schedule `fn` to run on the next macrotask.
+   *
+   * `MessageChannel` yields a true macrotask without the ~4ms clamp that nested
+   * `setTimeout(0)` calls incur, so the browser can paint between chunks with
+   * minimal scheduling overhead. Falls back to `setTimeout` in non-DOM
+   * environments (e.g. tests / SSR).
+   */
+  static scheduleMacrotask(fn) {
+    if (typeof MessageChannel === "undefined") {
+      setTimeout(fn, 0);
+      return;
+    }
+    if (!this._channel) {
+      this._channel = new MessageChannel();
+      this._channel.port1.onmessage = () => {
+        const next = this._queue.shift();
+        if (next) next();
+      };
+    }
+    this._queue.push(fn);
+    this._channel.port2.postMessage(null);
+  }
+}
+/** FIFO queue of callbacks waiting for their posted macrotask to fire. */
+AreSchedulerHelper._queue = [];
+
+exports.AreSchedulerHelper = AreSchedulerHelper;
+//# sourceMappingURL=AreScheduler.helper.js.map
+//# sourceMappingURL=AreScheduler.helper.js.map

package/dist/node/helpers/AreScheduler.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/helpers/AreScheduler.helper.ts"],"names":[],"mappings":";;AAaO,MAAM,kBAAA,CAAmB;AAAA;AAAA;AAAA;AAAA;AAAA,EAgB5B,OAAO,GAAA,GAAc;AACjB,IAAA,OAAQ,OAAO,WAAA,KAAgB,WAAA,IAAe,OAAO,WAAA,CAAY,GAAA,KAAQ,UAAA,GACnE,WAAA,CAAY,GAAA,EAAI,GAChB,IAAA,CAAK,GAAA,EAAI;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,kBAAkB,EAAA,EAAsB;AAC3C,IAAA,IAAI,OAAO,mBAAmB,WAAA,EAAa;AACvC,MAAA,UAAA,CAAW,IAAI,CAAC,CAAA;AAChB,MAAA;AAAA,IACJ;AAEA,IAAA,IAAI,CAAC,KAAK,QAAA,EAAU;AAChB,MAAA,IAAA,CAAK,QAAA,GAAW,IAAI,cAAA,EAAe;AACnC,MAAA,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,SAAA,GAAY,MAAM;AAClC,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,KAAA,EAAM;AAC/B,QAAA,IAAI,MAAM,IAAA,EAAK;AAAA,MACnB,CAAA;AAAA,IACJ;AAEA,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,EAAE,CAAA;AACnB,IAAA,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,WAAA,CAAY,IAAI,CAAA;AAAA,EACxC;AACJ;AAAA;AA/Ca,kBAAA,CAUe,SAA4B,EAAC","file":"AreScheduler.helper.js","sourcesContent":["/**\n * AreSchedulerHelper\n *\n * Cooperative time-slicing primitives shared by the chunked (async) render\n * paths — the initial whole-page mount walk and the `$for` directive. Both need\n * the SAME two capabilities:\n *   1. a high-resolution clock to measure how long the current chunk has run, and\n *   2. a zero-delay macrotask scheduler to yield to the browser between chunks\n *      so it can paint and process input before resuming work.\n *\n * Keeping these in one helper avoids duplicating the `MessageChannel` plumbing\n * across directives/lifecycle and gives a single place to tune the strategy.\n */\nexport class AreSchedulerHelper {\n\n    /**\n     * Lazily-created `MessageChannel` used to post zero-delay macrotasks.\n     * Created on first use so non-DOM environments (tests / SSR) that never\n     * schedule a chunk pay nothing.\n     */\n    private static _channel?: MessageChannel;\n\n    /** FIFO queue of callbacks waiting for their posted macrotask to fire. */\n    private static readonly _queue: Array<() => void> = [];\n\n    /**\n     * High-resolution wall-clock time in milliseconds. Uses `performance.now()`\n     * when available (monotonic, sub-millisecond), falling back to `Date.now()`.\n     */\n    static now(): number {\n        return (typeof performance !== 'undefined' && typeof performance.now === 'function')\n            ? performance.now()\n            : Date.now();\n    }\n\n    /**\n     * Schedule `fn` to run on the next macrotask.\n     *\n     * `MessageChannel` yields a true macrotask without the ~4ms clamp that nested\n     * `setTimeout(0)` calls incur, so the browser can paint between chunks with\n     * minimal scheduling overhead. Falls back to `setTimeout` in non-DOM\n     * environments (e.g. tests / SSR).\n     */\n    static scheduleMacrotask(fn: () => void): void {\n        if (typeof MessageChannel === 'undefined') {\n            setTimeout(fn, 0);\n            return;\n        }\n\n        if (!this._channel) {\n            this._channel = new MessageChannel();\n            this._channel.port1.onmessage = () => {\n                const next = this._queue.shift();\n                if (next) next();\n            };\n        }\n\n        this._queue.push(fn);\n        this._channel.port2.postMessage(null);\n    }\n}\n"]}

package/dist/node/helpers/AreScheduler.helper.mjs

@@ -0,0 +1,40 @@
+import '../chunk-EQQGB2QZ.mjs';
+
+class AreSchedulerHelper {
+  /**
+   * High-resolution wall-clock time in milliseconds. Uses `performance.now()`
+   * when available (monotonic, sub-millisecond), falling back to `Date.now()`.
+   */
+  static now() {
+    return typeof performance !== "undefined" && typeof performance.now === "function" ? performance.now() : Date.now();
+  }
+  /**
+   * Schedule `fn` to run on the next macrotask.
+   *
+   * `MessageChannel` yields a true macrotask without the ~4ms clamp that nested
+   * `setTimeout(0)` calls incur, so the browser can paint between chunks with
+   * minimal scheduling overhead. Falls back to `setTimeout` in non-DOM
+   * environments (e.g. tests / SSR).
+   */
+  static scheduleMacrotask(fn) {
+    if (typeof MessageChannel === "undefined") {
+      setTimeout(fn, 0);
+      return;
+    }
+    if (!this._channel) {
+      this._channel = new MessageChannel();
+      this._channel.port1.onmessage = () => {
+        const next = this._queue.shift();
+        if (next) next();
+      };
+    }
+    this._queue.push(fn);
+    this._channel.port2.postMessage(null);
+  }
+}
+/** FIFO queue of callbacks waiting for their posted macrotask to fire. */
+AreSchedulerHelper._queue = [];
+
+export { AreSchedulerHelper };
+//# sourceMappingURL=AreScheduler.helper.mjs.map
+//# sourceMappingURL=AreScheduler.helper.mjs.map

package/dist/node/helpers/AreScheduler.helper.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/helpers/AreScheduler.helper.ts"],"names":[],"mappings":";;AAaO,MAAM,kBAAA,CAAmB;AAAA;AAAA;AAAA;AAAA;AAAA,EAgB5B,OAAO,GAAA,GAAc;AACjB,IAAA,OAAQ,OAAO,WAAA,KAAgB,WAAA,IAAe,OAAO,WAAA,CAAY,GAAA,KAAQ,UAAA,GACnE,WAAA,CAAY,GAAA,EAAI,GAChB,IAAA,CAAK,GAAA,EAAI;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,kBAAkB,EAAA,EAAsB;AAC3C,IAAA,IAAI,OAAO,mBAAmB,WAAA,EAAa;AACvC,MAAA,UAAA,CAAW,IAAI,CAAC,CAAA;AAChB,MAAA;AAAA,IACJ;AAEA,IAAA,IAAI,CAAC,KAAK,QAAA,EAAU;AAChB,MAAA,IAAA,CAAK,QAAA,GAAW,IAAI,cAAA,EAAe;AACnC,MAAA,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,SAAA,GAAY,MAAM;AAClC,QAAA,MAAM,IAAA,GAAO,IAAA,CAAK,MAAA,CAAO,KAAA,EAAM;AAC/B,QAAA,IAAI,MAAM,IAAA,EAAK;AAAA,MACnB,CAAA;AAAA,IACJ;AAEA,IAAA,IAAA,CAAK,MAAA,CAAO,KAAK,EAAE,CAAA;AACnB,IAAA,IAAA,CAAK,QAAA,CAAS,KAAA,CAAM,WAAA,CAAY,IAAI,CAAA;AAAA,EACxC;AACJ;AAAA;AA/Ca,kBAAA,CAUe,SAA4B,EAAC","file":"AreScheduler.helper.mjs","sourcesContent":["/**\n * AreSchedulerHelper\n *\n * Cooperative time-slicing primitives shared by the chunked (async) render\n * paths — the initial whole-page mount walk and the `$for` directive. Both need\n * the SAME two capabilities:\n *   1. a high-resolution clock to measure how long the current chunk has run, and\n *   2. a zero-delay macrotask scheduler to yield to the browser between chunks\n *      so it can paint and process input before resuming work.\n *\n * Keeping these in one helper avoids duplicating the `MessageChannel` plumbing\n * across directives/lifecycle and gives a single place to tune the strategy.\n */\nexport class AreSchedulerHelper {\n\n    /**\n     * Lazily-created `MessageChannel` used to post zero-delay macrotasks.\n     * Created on first use so non-DOM environments (tests / SSR) that never\n     * schedule a chunk pay nothing.\n     */\n    private static _channel?: MessageChannel;\n\n    /** FIFO queue of callbacks waiting for their posted macrotask to fire. */\n    private static readonly _queue: Array<() => void> = [];\n\n    /**\n     * High-resolution wall-clock time in milliseconds. Uses `performance.now()`\n     * when available (monotonic, sub-millisecond), falling back to `Date.now()`.\n     */\n    static now(): number {\n        return (typeof performance !== 'undefined' && typeof performance.now === 'function')\n            ? performance.now()\n            : Date.now();\n    }\n\n    /**\n     * Schedule `fn` to run on the next macrotask.\n     *\n     * `MessageChannel` yields a true macrotask without the ~4ms clamp that nested\n     * `setTimeout(0)` calls incur, so the browser can paint between chunks with\n     * minimal scheduling overhead. Falls back to `setTimeout` in non-DOM\n     * environments (e.g. tests / SSR).\n     */\n    static scheduleMacrotask(fn: () => void): void {\n        if (typeof MessageChannel === 'undefined') {\n            setTimeout(fn, 0);\n            return;\n        }\n\n        if (!this._channel) {\n            this._channel = new MessageChannel();\n            this._channel.port1.onmessage = () => {\n                const next = this._queue.shift();\n                if (next) next();\n            };\n        }\n\n        this._queue.push(fn);\n        this._channel.port2.postMessage(null);\n    }\n}\n"]}

package/dist/node/index.d.mts

@@ -1,14 +1,16 @@
 export { A as AreBindingAttribute, a as AreDirective, b as AreDirectiveAttribute, c as AreEventAttribute, d as AreHTMLAttribute, e as AreHTMLNode, f as AreStaticAttribute } from './AreBinding.attribute-doUvtOjc.mjs';
 export { AreDirectiveFor } from './directives/AreDirectiveFor.directive.mjs';
 export { AreDirectiveIf } from './directives/AreDirectiveIf.directive.mjs';
+export { AreDirectiveShow } from './directives/AreDirectiveShow.directive.mjs';
 export { AddAttributeInstruction } from './instructions/AddAttribute.instruction.mjs';
 export { AddElementInstruction } from './instructions/AddElement.instruction.mjs';
 export { AddInterpolationInstruction } from './instructions/AddInterpolation.instruction.mjs';
 export { AddListenerInstruction } from './instructions/AddListener.instruction.mjs';
 export { AddStyleInstruction } from './instructions/AddStyle.instruction.mjs';
 export { AddTextInstruction } from './instructions/AddText.instruction.mjs';
+export { HideElementInstruction } from './instructions/HideElement.instruction.mjs';
 export { AreHTMLInstructions } from './instructions/AreHTML.instructions.constants.mjs';
-export { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload } from './instructions/AreHTML.instructions.types.mjs';
+export { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload, AreHtmlHideInstructionPayload } from './instructions/AreHTML.instructions.types.mjs';
 export { AreComment } from './nodes/AreComment.mjs';
 export { AreComponentNode } from './nodes/AreComponent.mjs';
 export { AreInterpolation } from './nodes/AreInterpolation.mjs';
@@ -29,6 +31,7 @@ export { AreDirectiveContext } from './lib/AreDirective/AreDirective.context.mjs
 export { AreDirectiveMeta } from './lib/AreDirective/AreDirective.meta.mjs';
 export { AreDirectiveOrderDecoratorParameters } from './lib/AreDirective/AreDirective.types.mjs';
 export { AreRoot } from './lib/AreRoot/AreRoot.component.mjs';
+export { AreRootCache, AreRootCacheEntry } from './lib/AreRoot/AreRootCache.context.mjs';
 export { AreStyle } from './lib/AreStyle/AreStyle.context.mjs';
 export { AreRouteWatcher } from './lib/AreRouteWatcher/AreRouteWatcher.component.mjs';
 import '@adaas/are';

package/dist/node/index.d.ts

@@ -1,14 +1,16 @@
 export { A as AreBindingAttribute, a as AreDirective, b as AreDirectiveAttribute, c as AreEventAttribute, d as AreHTMLAttribute, e as AreHTMLNode, f as AreStaticAttribute } from './AreBinding.attribute-Bm5LlOyE.js';
 export { AreDirectiveFor } from './directives/AreDirectiveFor.directive.js';
 export { AreDirectiveIf } from './directives/AreDirectiveIf.directive.js';
+export { AreDirectiveShow } from './directives/AreDirectiveShow.directive.js';
 export { AddAttributeInstruction } from './instructions/AddAttribute.instruction.js';
 export { AddElementInstruction } from './instructions/AddElement.instruction.js';
 export { AddInterpolationInstruction } from './instructions/AddInterpolation.instruction.js';
 export { AddListenerInstruction } from './instructions/AddListener.instruction.js';
 export { AddStyleInstruction } from './instructions/AddStyle.instruction.js';
 export { AddTextInstruction } from './instructions/AddText.instruction.js';
+export { HideElementInstruction } from './instructions/HideElement.instruction.js';
 export { AreHTMLInstructions } from './instructions/AreHTML.instructions.constants.js';
-export { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload } from './instructions/AreHTML.instructions.types.js';
+export { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload, AreHtmlHideInstructionPayload } from './instructions/AreHTML.instructions.types.js';
 export { AreComment } from './nodes/AreComment.js';
 export { AreComponentNode } from './nodes/AreComponent.js';
 export { AreInterpolation } from './nodes/AreInterpolation.js';
@@ -29,6 +31,7 @@ export { AreDirectiveContext } from './lib/AreDirective/AreDirective.context.js'
 export { AreDirectiveMeta } from './lib/AreDirective/AreDirective.meta.js';
 export { AreDirectiveOrderDecoratorParameters } from './lib/AreDirective/AreDirective.types.js';
 export { AreRoot } from './lib/AreRoot/AreRoot.component.js';
+export { AreRootCache, AreRootCacheEntry } from './lib/AreRoot/AreRootCache.context.js';
 export { AreStyle } from './lib/AreStyle/AreStyle.context.js';
 export { AreRouteWatcher } from './lib/AreRouteWatcher/AreRouteWatcher.component.js';
 import '@adaas/are';

package/dist/node/index.js

@@ -7,12 +7,14 @@ var AreStatic_attribute = require('./attributes/AreStatic.attribute');
 var AreComponent_directive = require('./directives/AreComponent.directive');
 var AreDirectiveFor_directive = require('./directives/AreDirectiveFor.directive');
 var AreDirectiveIf_directive = require('./directives/AreDirectiveIf.directive');
+var AreDirectiveShow_directive = require('./directives/AreDirectiveShow.directive');
 var AddAttribute_instruction = require('./instructions/AddAttribute.instruction');
 var AddElement_instruction = require('./instructions/AddElement.instruction');
 var AddInterpolation_instruction = require('./instructions/AddInterpolation.instruction');
 var AddListener_instruction = require('./instructions/AddListener.instruction');
 var AddStyle_instruction = require('./instructions/AddStyle.instruction');
 var AddText_instruction = require('./instructions/AddText.instruction');
+var HideElement_instruction = require('./instructions/HideElement.instruction');
 var AreHTML_instructions_constants = require('./instructions/AreHTML.instructions.constants');
 var AreHTML_instructions_types = require('./instructions/AreHTML.instructions.types');
 var AreComment = require('./nodes/AreComment');
@@ -38,6 +40,7 @@ var AreDirective_context = require('./lib/AreDirective/AreDirective.context');
 var AreDirective_meta = require('./lib/AreDirective/AreDirective.meta');
 var AreDirective_types = require('./lib/AreDirective/AreDirective.types');
 var AreRoot_component = require('./lib/AreRoot/AreRoot.component');
+var AreRootCache_context = require('./lib/AreRoot/AreRootCache.context');
 var AreStyle_context = require('./lib/AreStyle/AreStyle.context');
 var AreStyle_types = require('./lib/AreStyle/AreStyle.types');
 var AreRouteWatcher_component = require('./lib/AreRouteWatcher/AreRouteWatcher.component');
@@ -86,6 +89,12 @@ Object.keys(AreDirectiveIf_directive).forEach(function (k) {
 		get: function () { return AreDirectiveIf_directive[k]; }
 	});
 });
+Object.keys(AreDirectiveShow_directive).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return AreDirectiveShow_directive[k]; }
+	});
+});
 Object.keys(AddAttribute_instruction).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
@@ -122,6 +131,12 @@ Object.keys(AddText_instruction).forEach(function (k) {
 		get: function () { return AddText_instruction[k]; }
 	});
 });
+Object.keys(HideElement_instruction).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return HideElement_instruction[k]; }
+	});
+});
 Object.keys(AreHTML_instructions_constants).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,
@@ -272,6 +287,12 @@ Object.keys(AreRoot_component).forEach(function (k) {
 		get: function () { return AreRoot_component[k]; }
 	});
 });
+Object.keys(AreRootCache_context).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return AreRootCache_context[k]; }
+	});
+});
 Object.keys(AreStyle_context).forEach(function (k) {
 	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
 		enumerable: true,

package/dist/node/index.mjs

@@ -5,12 +5,14 @@ export * from './attributes/AreStatic.attribute';
 export * from './directives/AreComponent.directive';
 export * from './directives/AreDirectiveFor.directive';
 export * from './directives/AreDirectiveIf.directive';
+export * from './directives/AreDirectiveShow.directive';
 export * from './instructions/AddAttribute.instruction';
 export * from './instructions/AddElement.instruction';
 export * from './instructions/AddInterpolation.instruction';
 export * from './instructions/AddListener.instruction';
 export * from './instructions/AddStyle.instruction';
 export * from './instructions/AddText.instruction';
+export * from './instructions/HideElement.instruction';
 export * from './instructions/AreHTML.instructions.constants';
 export * from './instructions/AreHTML.instructions.types';
 export * from './nodes/AreComment';
@@ -36,6 +38,7 @@ export * from './lib/AreDirective/AreDirective.context';
 export * from './lib/AreDirective/AreDirective.meta';
 export * from './lib/AreDirective/AreDirective.types';
 export * from './lib/AreRoot/AreRoot.component';
+export * from './lib/AreRoot/AreRootCache.context';
 export * from './lib/AreStyle/AreStyle.context';
 export * from './lib/AreStyle/AreStyle.types';
 export * from './lib/AreRouteWatcher/AreRouteWatcher.component';

package/dist/node/instructions/AreHTML.instructions.constants.d.mts

@@ -6,6 +6,7 @@ declare const AreHTMLInstructions: {
     readonly AddListener: "_AreHTML_AddListener";
     readonly AddInterpolation: "_AreHTML_AddInterpolation";
     readonly AddComment: "_AreHTML_AddComment";
+    readonly HideElement: "_AreHTML_HideElement";
 };
 
 export { AreHTMLInstructions };

package/dist/node/instructions/AreHTML.instructions.constants.d.ts

@@ -6,6 +6,7 @@ declare const AreHTMLInstructions: {
     readonly AddListener: "_AreHTML_AddListener";
     readonly AddInterpolation: "_AreHTML_AddInterpolation";
     readonly AddComment: "_AreHTML_AddComment";
+    readonly HideElement: "_AreHTML_HideElement";
 };
 
 export { AreHTMLInstructions };

package/dist/node/instructions/AreHTML.instructions.constants.js

@@ -7,7 +7,8 @@ const AreHTMLInstructions = {
   AddStyle: "_AreHTML_AddStyle",
   AddListener: "_AreHTML_AddListener",
   AddInterpolation: "_AreHTML_AddInterpolation",
-  AddComment: "_AreHTML_AddComment"
+  AddComment: "_AreHTML_AddComment",
+  HideElement: "_AreHTML_HideElement"
 };
 
 exports.AreHTMLInstructions = AreHTMLInstructions;

package/dist/node/instructions/AreHTML.instructions.constants.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/instructions/AreHTML.instructions.constants.ts"],"names":[],"mappings":";;AAEO,MAAM,mBAAA,GAAsB;AAAA,EAC/B,UAAA,EAAY,qBAAA;AAAA,EACZ,OAAA,EAAS,kBAAA;AAAA,EACT,YAAA,EAAc,uBAAA;AAAA,EACd,QAAA,EAAU,mBAAA;AAAA,EACV,WAAA,EAAa,sBAAA;AAAA,EACb,gBAAA,EAAkB,2BAAA;AAAA,EAClB,UAAA,EAAY;AAChB","file":"AreHTML.instructions.constants.js","sourcesContent":["\n\nexport const AreHTMLInstructions = {\n    AddElement: '_AreHTML_AddElement',\n    AddText: '_AreHTML_AddText',\n    AddAttribute: '_AreHTML_AddAttribute',\n    AddStyle: '_AreHTML_AddStyle',\n    AddListener: '_AreHTML_AddListener',\n    AddInterpolation: '_AreHTML_AddInterpolation',\n    AddComment: '_AreHTML_AddComment',\n} as const"]}
+{"version":3,"sources":["../../../src/instructions/AreHTML.instructions.constants.ts"],"names":[],"mappings":";;AAEO,MAAM,mBAAA,GAAsB;AAAA,EAC/B,UAAA,EAAY,qBAAA;AAAA,EACZ,OAAA,EAAS,kBAAA;AAAA,EACT,YAAA,EAAc,uBAAA;AAAA,EACd,QAAA,EAAU,mBAAA;AAAA,EACV,WAAA,EAAa,sBAAA;AAAA,EACb,gBAAA,EAAkB,2BAAA;AAAA,EAClB,UAAA,EAAY,qBAAA;AAAA,EACZ,WAAA,EAAa;AACjB","file":"AreHTML.instructions.constants.js","sourcesContent":["\n\nexport const AreHTMLInstructions = {\n    AddElement: '_AreHTML_AddElement',\n    AddText: '_AreHTML_AddText',\n    AddAttribute: '_AreHTML_AddAttribute',\n    AddStyle: '_AreHTML_AddStyle',\n    AddListener: '_AreHTML_AddListener',\n    AddInterpolation: '_AreHTML_AddInterpolation',\n    AddComment: '_AreHTML_AddComment',\n    HideElement: '_AreHTML_HideElement',\n} as const"]}

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

@@ -7,7 +7,8 @@ const AreHTMLInstructions = {
   AddStyle: "_AreHTML_AddStyle",
   AddListener: "_AreHTML_AddListener",
   AddInterpolation: "_AreHTML_AddInterpolation",
-  AddComment: "_AreHTML_AddComment"
+  AddComment: "_AreHTML_AddComment",
+  HideElement: "_AreHTML_HideElement"
 };
 
 export { AreHTMLInstructions };

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/instructions/AreHTML.instructions.constants.ts"],"names":[],"mappings":";;AAEO,MAAM,mBAAA,GAAsB;AAAA,EAC/B,UAAA,EAAY,qBAAA;AAAA,EACZ,OAAA,EAAS,kBAAA;AAAA,EACT,YAAA,EAAc,uBAAA;AAAA,EACd,QAAA,EAAU,mBAAA;AAAA,EACV,WAAA,EAAa,sBAAA;AAAA,EACb,gBAAA,EAAkB,2BAAA;AAAA,EAClB,UAAA,EAAY;AAChB","file":"AreHTML.instructions.constants.mjs","sourcesContent":["\n\nexport const AreHTMLInstructions = {\n    AddElement: '_AreHTML_AddElement',\n    AddText: '_AreHTML_AddText',\n    AddAttribute: '_AreHTML_AddAttribute',\n    AddStyle: '_AreHTML_AddStyle',\n    AddListener: '_AreHTML_AddListener',\n    AddInterpolation: '_AreHTML_AddInterpolation',\n    AddComment: '_AreHTML_AddComment',\n} as const"]}
+{"version":3,"sources":["../../../src/instructions/AreHTML.instructions.constants.ts"],"names":[],"mappings":";;AAEO,MAAM,mBAAA,GAAsB;AAAA,EAC/B,UAAA,EAAY,qBAAA;AAAA,EACZ,OAAA,EAAS,kBAAA;AAAA,EACT,YAAA,EAAc,uBAAA;AAAA,EACd,QAAA,EAAU,mBAAA;AAAA,EACV,WAAA,EAAa,sBAAA;AAAA,EACb,gBAAA,EAAkB,2BAAA;AAAA,EAClB,UAAA,EAAY,qBAAA;AAAA,EACZ,WAAA,EAAa;AACjB","file":"AreHTML.instructions.constants.mjs","sourcesContent":["\n\nexport const AreHTMLInstructions = {\n    AddElement: '_AreHTML_AddElement',\n    AddText: '_AreHTML_AddText',\n    AddAttribute: '_AreHTML_AddAttribute',\n    AddStyle: '_AreHTML_AddStyle',\n    AddListener: '_AreHTML_AddListener',\n    AddInterpolation: '_AreHTML_AddInterpolation',\n    AddComment: '_AreHTML_AddComment',\n    HideElement: '_AreHTML_HideElement',\n} as const"]}

package/dist/node/instructions/AreHTML.instructions.types.d.mts

@@ -28,6 +28,14 @@ type AreHtmlAddStyleInstructionPayload = {
     /** Full CSS string to inject as a <style> block scoped to the component. Applied to the document head and reverted on unmount. */
     styles: string;
 };
+type AreHtmlHideInstructionPayload = {
+    /**
+     * Optional explicit display value to restore when the element becomes
+     * visible again. When omitted, the interpreter caches and restores the
+     * element's own prior inline `display` value (Vue `v-show` semantics).
+     */
+    display?: string;
+};
 type AreHtmlAddListenerInstructionPayload = {
     /** DOM event name (e.g. "click", "input", "submit") */
     name: string;
@@ -41,4 +49,4 @@ type AreHtmlAddInterpolationInstructionPayload = {
     content: (...args: any[]) => string;
 };
 
-export type { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload };
+export type { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload, AreHtmlHideInstructionPayload };

package/dist/node/instructions/AreHTML.instructions.types.d.ts

@@ -28,6 +28,14 @@ type AreHtmlAddStyleInstructionPayload = {
     /** Full CSS string to inject as a <style> block scoped to the component. Applied to the document head and reverted on unmount. */
     styles: string;
 };
+type AreHtmlHideInstructionPayload = {
+    /**
+     * Optional explicit display value to restore when the element becomes
+     * visible again. When omitted, the interpreter caches and restores the
+     * element's own prior inline `display` value (Vue `v-show` semantics).
+     */
+    display?: string;
+};
 type AreHtmlAddListenerInstructionPayload = {
     /** DOM event name (e.g. "click", "input", "submit") */
     name: string;
@@ -41,4 +49,4 @@ type AreHtmlAddInterpolationInstructionPayload = {
     content: (...args: any[]) => string;
 };
 
-export type { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload };
+export type { AreHtmlAddAttributeInstructionPayload, AreHtmlAddCommentInstructionPayload, AreHtmlAddElementInstructionPayload, AreHtmlAddInterpolationInstructionPayload, AreHtmlAddListenerInstructionPayload, AreHtmlAddStyleInstructionPayload, AreHtmlAddTextInstructionPayload, AreHtmlHideInstructionPayload };

package/dist/node/instructions/HideElement.instruction.d.mts

@@ -0,0 +1,13 @@
+import { AreMutation, AreDeclaration, AreInstructionSerialized } from '@adaas/are';
+import { AreHtmlHideInstructionPayload } from './AreHTML.instructions.types.mjs';
+
+declare class HideElementInstruction extends AreMutation<AreHtmlHideInstructionPayload> {
+    /**
+     * Caches the element's inline `display` value captured at apply time so it
+     * can be restored verbatim on revert (mirrors Vue `v-show`).
+     */
+    cache?: string;
+    constructor(parent: AreDeclaration, props: AreHtmlHideInstructionPayload | AreInstructionSerialized<AreHtmlHideInstructionPayload>);
+}
+
+export { HideElementInstruction };

package/dist/node/instructions/HideElement.instruction.d.ts

@@ -0,0 +1,13 @@
+import { AreMutation, AreDeclaration, AreInstructionSerialized } from '@adaas/are';
+import { AreHtmlHideInstructionPayload } from './AreHTML.instructions.types.js';
+
+declare class HideElementInstruction extends AreMutation<AreHtmlHideInstructionPayload> {
+    /**
+     * Caches the element's inline `display` value captured at apply time so it
+     * can be restored verbatim on revert (mirrors Vue `v-show`).
+     */
+    cache?: string;
+    constructor(parent: AreDeclaration, props: AreHtmlHideInstructionPayload | AreInstructionSerialized<AreHtmlHideInstructionPayload>);
+}
+
+export { HideElementInstruction };

package/dist/node/instructions/HideElement.instruction.js

@@ -0,0 +1,31 @@
+'use strict';
+
+var core = require('@adaas/a-frame/core');
+var are = require('@adaas/are');
+var AreHTML_instructions_constants = require('./AreHTML.instructions.constants');
+
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+exports.HideElementInstruction = class HideElementInstruction extends are.AreMutation {
+  constructor(parent, props) {
+    if ("aseid" in props) {
+      super(props);
+    } else {
+      super(AreHTML_instructions_constants.AreHTMLInstructions.HideElement, parent, props);
+    }
+  }
+};
+exports.HideElementInstruction = __decorateClass([
+  core.A_Frame.Define({
+    namespace: "a-are-html",
+    description: 'Toggles the visibility of an existing element by setting its inline display to "none" on apply and restoring the previous inline display on revert. Used by the $show directive to hide/show an element without unmounting it, preserving its subtree, listeners and scene state.'
+  })
+], exports.HideElementInstruction);
+//# sourceMappingURL=HideElement.instruction.js.map
+//# sourceMappingURL=HideElement.instruction.js.map

package/dist/node/instructions/HideElement.instruction.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/instructions/HideElement.instruction.ts"],"names":["HideElementInstruction","AreMutation","AreHTMLInstructions","A_Frame"],"mappings":";;;;;;;;;;;;;;AAUaA,8BAAA,GAAN,qCAAqCC,eAAA,CAA2C;AAAA,EAQnF,WAAA,CACI,QACA,KAAA,EACF;AACE,IAAA,IAAI,WAAW,KAAA,EAAO;AAClB,MAAA,KAAA,CAAM,KAAgE,CAAA;AAAA,IAC1E,CAAA,MAAO;AACH,MAAA,KAAA,CAAMC,kDAAA,CAAoB,WAAA,EAAa,MAAA,EAAQ,KAAK,CAAA;AAAA,IACxD;AAAA,EACJ;AACJ;AAlBaF,8BAAA,GAAN,eAAA,CAAA;AAAA,EAJNG,aAAQ,MAAA,CAAO;AAAA,IACZ,SAAA,EAAW,YAAA;AAAA,IACX,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACYH,8BAAA,CAAA","file":"HideElement.instruction.js","sourcesContent":["import { A_Frame } from \"@adaas/a-frame/core\"\nimport { AreDeclaration, AreMutation, AreInstructionSerialized } from \"@adaas/are\";\nimport { AreHtmlHideInstructionPayload } from \"./AreHTML.instructions.types\";\nimport { AreHTMLInstructions } from \"./AreHTML.instructions.constants\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Toggles the visibility of an existing element by setting its inline display to \"none\" on apply and restoring the previous inline display on revert. Used by the $show directive to hide/show an element without unmounting it, preserving its subtree, listeners and scene state.'\n})\nexport class HideElementInstruction extends AreMutation<AreHtmlHideInstructionPayload> {\n\n    /**\n     * Caches the element's inline `display` value captured at apply time so it\n     * can be restored verbatim on revert (mirrors Vue `v-show`).\n     */\n    cache?: string;\n\n    constructor(\n        parent: AreDeclaration,\n        props: AreHtmlHideInstructionPayload | AreInstructionSerialized<AreHtmlHideInstructionPayload>\n    ) {\n        if ('aseid' in props) {\n            super(props as AreInstructionSerialized<AreHtmlHideInstructionPayload>);\n        } else {\n            super(AreHTMLInstructions.HideElement, parent, props);\n        }\n    }\n}\n"]}

package/dist/node/instructions/HideElement.instruction.mjs

@@ -0,0 +1,24 @@
+import { __decorateClass } from '../chunk-EQQGB2QZ.mjs';
+import { A_Frame } from '@adaas/a-frame/core';
+import { AreMutation } from '@adaas/are';
+import { AreHTMLInstructions } from './AreHTML.instructions.constants';
+
+let HideElementInstruction = class extends AreMutation {
+  constructor(parent, props) {
+    if ("aseid" in props) {
+      super(props);
+    } else {
+      super(AreHTMLInstructions.HideElement, parent, props);
+    }
+  }
+};
+HideElementInstruction = __decorateClass([
+  A_Frame.Define({
+    namespace: "a-are-html",
+    description: 'Toggles the visibility of an existing element by setting its inline display to "none" on apply and restoring the previous inline display on revert. Used by the $show directive to hide/show an element without unmounting it, preserving its subtree, listeners and scene state.'
+  })
+], HideElementInstruction);
+
+export { HideElementInstruction };
+//# sourceMappingURL=HideElement.instruction.mjs.map
+//# sourceMappingURL=HideElement.instruction.mjs.map

package/dist/node/instructions/HideElement.instruction.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/instructions/HideElement.instruction.ts"],"names":[],"mappings":";;;;;AAUO,IAAM,sBAAA,GAAN,cAAqC,WAAA,CAA2C;AAAA,EAQnF,WAAA,CACI,QACA,KAAA,EACF;AACE,IAAA,IAAI,WAAW,KAAA,EAAO;AAClB,MAAA,KAAA,CAAM,KAAgE,CAAA;AAAA,IAC1E,CAAA,MAAO;AACH,MAAA,KAAA,CAAM,mBAAA,CAAoB,WAAA,EAAa,MAAA,EAAQ,KAAK,CAAA;AAAA,IACxD;AAAA,EACJ;AACJ;AAlBa,sBAAA,GAAN,eAAA,CAAA;AAAA,EAJN,QAAQ,MAAA,CAAO;AAAA,IACZ,SAAA,EAAW,YAAA;AAAA,IACX,WAAA,EAAa;AAAA,GAChB;AAAA,CAAA,EACY,sBAAA,CAAA","file":"HideElement.instruction.mjs","sourcesContent":["import { A_Frame } from \"@adaas/a-frame/core\"\nimport { AreDeclaration, AreMutation, AreInstructionSerialized } from \"@adaas/are\";\nimport { AreHtmlHideInstructionPayload } from \"./AreHTML.instructions.types\";\nimport { AreHTMLInstructions } from \"./AreHTML.instructions.constants\";\n\n\n@A_Frame.Define({\n    namespace: 'a-are-html',\n    description: 'Toggles the visibility of an existing element by setting its inline display to \"none\" on apply and restoring the previous inline display on revert. Used by the $show directive to hide/show an element without unmounting it, preserving its subtree, listeners and scene state.'\n})\nexport class HideElementInstruction extends AreMutation<AreHtmlHideInstructionPayload> {\n\n    /**\n     * Caches the element's inline `display` value captured at apply time so it\n     * can be restored verbatim on revert (mirrors Vue `v-show`).\n     */\n    cache?: string;\n\n    constructor(\n        parent: AreDeclaration,\n        props: AreHtmlHideInstructionPayload | AreInstructionSerialized<AreHtmlHideInstructionPayload>\n    ) {\n        if ('aseid' in props) {\n            super(props as AreInstructionSerialized<AreHtmlHideInstructionPayload>);\n        } else {\n            super(AreHTMLInstructions.HideElement, parent, props);\n        }\n    }\n}\n"]}

package/dist/node/lib/AreRoot/AreRoot.component.d.mts

@@ -1,10 +1,64 @@
+import { A_TYPES__Ctor } from '@adaas/a-concept';
 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, AreNode, AreSignalsContext } from '@adaas/are';
+import { AreRootCache, AreRootCacheEntry } from './AreRootCache.context.mjs';
 
 declare class AreRoot extends Are {
-    template(root: AreNode, logger: A_Logger, signalsContext?: AreSignalsContext): Promise<void>;
-    onSignal(root: AreNode, vector: A_SignalVector, logger: A_Logger, signalsContext?: AreSignalsContext): Promise<void>;
+    template(root: AreNode, logger: A_Logger, signalsContext?: AreSignalsContext, signalState?: A_SignalState): Promise<void>;
+    onSignal(root: AreNode, vector: A_SignalVector, logger: A_Logger, signalsContext?: AreSignalsContext, cache?: AreRootCache): Promise<void>;
+    /**
+     * 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.
+     */
+    protected matchComponent(rootId: string, vector: A_SignalVector | undefined, signalsContext?: AreSignalsContext): A_TYPES__Ctor<Are> | undefined;
+    /**
+     * 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).
+     */
+    protected buildInitialVector(signalState?: A_SignalState): A_SignalVector;
+    /**
+     * 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.
+     */
+    protected stashChild(root: AreNode, child: AreNode, signalsContext: AreSignalsContext | undefined, cache: AreRootCache | undefined): void;
+    /**
+     * 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.
+     */
+    protected restoreChild(root: AreNode, entry: AreRootCacheEntry, signalsContext: AreSignalsContext | undefined): void;
+    /**
+     * 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.
+     */
+    protected collectSubscribers(node: AreNode, signalsContext: AreSignalsContext): AreNode[];
 }
 
 export { AreRoot };

package/dist/node/lib/AreRoot/AreRoot.component.d.ts

@@ -1,10 +1,64 @@
+import { A_TYPES__Ctor } from '@adaas/a-concept';
 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, AreNode, AreSignalsContext } from '@adaas/are';
+import { AreRootCache, AreRootCacheEntry } from './AreRootCache.context.js';
 
 declare class AreRoot extends Are {
-    template(root: AreNode, logger: A_Logger, signalsContext?: AreSignalsContext): Promise<void>;
-    onSignal(root: AreNode, vector: A_SignalVector, logger: A_Logger, signalsContext?: AreSignalsContext): Promise<void>;
+    template(root: AreNode, logger: A_Logger, signalsContext?: AreSignalsContext, signalState?: A_SignalState): Promise<void>;
+    onSignal(root: AreNode, vector: A_SignalVector, logger: A_Logger, signalsContext?: AreSignalsContext, cache?: AreRootCache): Promise<void>;
+    /**
+     * 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.
+     */
+    protected matchComponent(rootId: string, vector: A_SignalVector | undefined, signalsContext?: AreSignalsContext): A_TYPES__Ctor<Are> | undefined;
+    /**
+     * 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).
+     */
+    protected buildInitialVector(signalState?: A_SignalState): A_SignalVector;
+    /**
+     * 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.
+     */
+    protected stashChild(root: AreNode, child: AreNode, signalsContext: AreSignalsContext | undefined, cache: AreRootCache | undefined): void;
+    /**
+     * 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.
+     */
+    protected restoreChild(root: AreNode, entry: AreRootCacheEntry, signalsContext: AreSignalsContext | undefined): void;
+    /**
+     * 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.
+     */
+    protected collectSubscribers(node: AreNode, signalsContext: AreSignalsContext): AreNode[];
 }
 
 export { AreRoot };