@adaas/are-html 0.0.19 → 0.0.21

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 };