@genome-spy/core 0.66.1 → 0.68.0

package/dist/src/view/view.d.ts

@@ -27,9 +27,6 @@ export const VISIT_STOP: "VISIT_STOP";
  * @typedef {object} ViewOptions
  * @prop {boolean} [blockEncodingInheritance]
  *      Don't inherit encodings from parent. Default: false.
- * @prop {boolean} [contributesToScaleDomain]
- *      Whether ScaleResolution should include this view or its children in the
- *      domain. Default: true
  * @prop {boolean} [layersChildren]
  *      View's children are layered on top of each other and they have the same
  *      coordinates as their parent.
@@ -60,7 +57,6 @@ export default class View {
     context: import("../types/viewContext.js").default;
     layoutParent: import("./containerView.js").default;
     dataParent: View;
-    name: string;
     spec: import("../spec/view.js").ViewSpec;
     resolutions: {
         /**
@@ -79,11 +75,6 @@ export default class View {
          * Don't inherit encodings from parent. Default: false.
          */
         blockEncodingInheritance: boolean;
-        /**
-         * Whether ScaleResolution should include this view or its children in the
-         * domain. Default: true
-         */
-        contributesToScaleDomain: boolean;
         /**
          * View's children are layered on top of each other and they have the same
          * coordinates as their parent.
@@ -102,6 +93,20 @@ export default class View {
     needsAxes: Record<import("../spec/channel.js").PrimaryPositionalChannel, boolean>;
     /** @type {ParamMediator} */
     paramMediator: ParamMediator;
+    /**
+     * Effective view name. Equals the explicit name (`spec.name`) when provided,
+     * otherwise falls back to an auto-generated default name.
+     */
+    get name(): string;
+    /**
+     * The explicit name from the spec (`spec.name`), if any.
+     */
+    get explicitName(): string;
+    /**
+     * The auto-generated default name that was assigned by the parent/factory.
+     * Intended for debugging only.
+     */
+    get defaultName(): string;
     /**
      * Returns the coords of the view. If view has been faceted, returns the coords
      * of an arbitrary facet. If all or specific facet coords are needed, use `facetCoords`.
@@ -134,6 +139,7 @@ export default class View {
      * @returns {FlexDimensions}
      */
     getViewportSize(): FlexDimensions;
+    registerStepSizeInvalidation(): void;
     isConfiguredVisible(): boolean;
     isVisibleInSpec(): boolean;
     /**
@@ -146,6 +152,24 @@ export default class View {
      * @returns {boolean}
      */
     isVisible(): boolean;
+    /**
+     * Returns true if this view or any ancestor is marked as domain inert.
+     *
+     * @returns {boolean}
+     */
+    isDomainInert(): boolean;
+    /**
+     * @returns {"none" | "pending" | "ready"}
+     */
+    getDataInitializationState(): "none" | "pending" | "ready";
+    /**
+     * Internal hook for lazy dataflow initialization.
+     * Use only from flow initialization helpers to avoid inconsistent state.
+     *
+     * @param {"none" | "pending" | "ready"} state
+     */
+    _setDataInitializationState(state: "none" | "pending" | "ready"): void;
+    isDataInitialized(): boolean;
     /**
      * Returns the effective opacity of this view, e.g., view's opacity multiplied
      * by opacities of its ancestors.
@@ -238,6 +262,7 @@ export default class View {
      * pass. The order is depth first, pre order.
      */
     onBeforeRender(): void;
+    hasRendered(): boolean;
     render(context: import("./renderingContext/viewRenderingContext.js").default, coords: import("./layout/rectangle.js").default, options?: import("../types/rendering.js").RenderingOptions): void;
     /**
      * Returns the encodings specified in this view combined with the inherited
@@ -360,11 +385,6 @@ export type ViewOptions = {
      * Don't inherit encodings from parent. Default: false.
      */
     blockEncodingInheritance?: boolean;
-    /**
-     * Whether ScaleResolution should include this view or its children in the
-     * domain. Default: true
-     */
-    contributesToScaleDomain?: boolean;
     /**
      * View's children are layered on top of each other and they have the same
      * coordinates as their parent.

package/dist/src/view/view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/view/view.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../../src/view/view.js"],"names":[],"mappings":"AA2BA,oBAAoB;AACpB,yBAA0B,YAAY,CAAC;AACvC,0BAA0B;AAC1B,yBAA0B,YAAY,CAAC;AAKvC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH;IA6CI;;;;;;;;;OASG;IACH,kBARW,OAAO,iBAAiB,EAAE,QAAQ,WAClC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,YACN,WAAW,EAsErB;IApGD;;OAEG;IACH,iBAFU,CAAS,IAAM,EAAN,MAAM,KAAE,MAAM,CAEQ;IAYzC;;;;;OAKG;IACH,aAFU,GAAG,CAAC,GAAG,EAAE,OAAO,uBAAuB,EAAE,OAAO,CAAC,CAEX;IAiB5C,mDAAsB;IACtB,mDAAgC;IAChC,iBAA4B;IAE5B,yCAAgB;IAEhB;QACI;;;WAGG;eADO,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,gBAAgB,EAAE,OAAO,8BAA8B,EAAE,OAAO,CAAC,CAAC;QAGxH;;;WAGG;cADO,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,6BAA6B,EAAE,OAAO,CAAC,CAAC;MAGlI;IAID;;;;kCAvFE,OAAO;;;;;yBAEP,OAAO;MAwFR;IAED;;OAEG;IACH,YAFU,OAAO,uBAAuB,EAAE,UAAU,GAAG,SAAS,CAErC;IAE3B;;;;OAIG;IACH,WAFU,MAAM,CAAC,OAAO,oBAAoB,EAAE,wBAAwB,EAAE,OAAO,CAAC,CAEzC;IAEvC,4BAA4B;IAC5B,eADW,aAAa,CAGvB;IAuBL;;;OAGG;IACH,mBAEC;IAED;;OAEG;IACH,2BAEC;IAED;;;OAGG;IACH,0BAEC;IAED;;;;;OAKG;IACH,cAFa,OAAO,uBAAuB,EAAE,OAAO,CAInD;IAED,sBAIC;IAED;;;;OAIG;IACH,eAFa,OAAO,CAInB;IAED;;;;;OAKG;IACH,gBAFa,OAAO,CAMnB;IAED;;;;;OAKG;IACH,WAFa,cAAc,CAW1B;IAED;;OAEG;IACH,mBAFa,cAAc,CAkB1B;IAqED,qCAGC;IA2BD,+BAEC;IAED,2BAEC;IAED;;;;;;;;OAQG;IACH,aAFa,OAAO,CAMnB;IAED;;;;OAIG;IACH,iBAFa,OAAO,CAanB;IAED;;OAEG;IACH,8BAFa,MAAM,GAAG,SAAS,GAAG,OAAO,CAIxC;IAED;;;;;OAKG;IACH,mCAFW,MAAM,GAAG,SAAS,GAAG,OAAO,QAItC;IAED,6BAEC;IAED;;;;;;;OAOG;IACH,uBAFa,MAAM,CAMlB;IAED,wBAKC;IAkBD;;OAEG;IACH,6BAEC;IAED;;OAEG;IACH,2BAEC;IAED;;;;OAIG;IACH,yBAFW,gBAAgB,QAO1B;IAED;;;;OAIG;IACH,2BAHW,MAAM,WACN,CAAS,IAAgB,EAAhB,gBAAgB,KAAE,IAAI,QASzC;IAED;;;;;;;;OAQG;IACH,yCANW,OAAO,uBAAuB,EAAE,OAAO,SAEvC,OAAO,8BAA8B,EAAE,OAAO,aAC9C,OAAO,QAUjB;IAED;;;;;;;;;;OAUG;IACH,kCAJW,MAAM,YACN,wBAAwB,eACxB,OAAO,QAajB;IAED;;;;OAIG;IACH,qCAJW,MAAM,YACN,wBAAwB,eACxB,OAAO,QAajB;IAED;;;;;;;OAOG;IACH,eAJW,OAAO,GACL,WAAW,CAmBvB;IAED;;OAEG;IACH,yBAOC;IAED;;OAEG;IACH,gBAwBC;IAED;;OAEG;IACH,2BAFW,MAAM,IAAI,QAIpB;IAED;;OAEG;IACH,uBAOC;IAED;;OAEG;IACH,6BASC;IAED;;;OAGG;IACH,uBAIC;IAED,uBAEC;;IAyBD;;;;;;OAMG;IACH,eAFY,OAAO,oBAAoB,EAAE,QAAQ,CAuBhD;IAED;;;;OAIG;IACH,+BAJW,IAAI,GAEH,CAAS,IAAM,EAAN,MAAM,KAAE,GAAG,CAM/B;IAED;;;;;OAKG;IACH,6BAHW,IAAI,GACF,MAAM,EAAE,CASpB;IAED;;;;;;;;;;;;;;;OAeG;IACH,yBAFY,YAAY,CAIvB;IAED;;OAEG;IACH,4BAFW,OAAO,oBAAoB,EAAE,gBAAgB,kDAWvD;IAED;;OAEG;IACH,2BAFW,OAAO,oBAAoB,EAAE,iBAAiB,iDAWxD;IAED;;;;OAIG;IACH,iCAJW,OAAO,oBAAoB,EAAE,OAAO,GAAG,SAAS,kBAChD,OAAO,iBAAiB,EAAE,gBAAgB,GACxC,OAAO,iBAAiB,EAAE,kBAAkB,CAIxD;IAED;;;;OAIG;IACH,0CAJW,OAAO,oBAAoB,EAAE,OAAO,kBACpC,OAAO,iBAAiB,EAAE,gBAAgB,GACxC,OAAO,iBAAiB,EAAE,kBAAkB,CAQxD;IAED;;;;OAIG;IACH,8BAJW,OAAO,oBAAoB,EAAE,OAAO,kBACpC,OAAO,iBAAiB,EAAE,gBAAgB,GACxC,OAAO,iBAAiB,EAAE,kBAAkB,CAIxD;IAED;;OAEG;IACH,cAFa,MAAM,CAOlB;IAED;;OAEG;IACH,8BAEC;IAED,oBASC;IAED;;;;;;OAMG;IACH,iBAHa,CAAC,OAHH,GAAG,YACH,CAAS,IAAI,EAAJ,UAAI,KAAE,CAAC,GACd,CAAC,CAMb;IAED;;;;OAIG;IACH,8BAHW,MAAM,cACN,MAAM,GAAG,SAAS,GAAG,WAAW,QAiB1C;IAED,4BAIC;IAED;;;;;OAKG;IACH,iCAFW,OAAO,8BAA8B,EAAE,OAAO,QAIxD;;CACJ;AAoEM,iCAHI,GAAG,GACF,IAAI,IAAI,OAAO,iBAAiB,EAAE,IAAI,CAEF;0BAl8BnC,8BAAsB,IAAI;qCAG5B,IAAI,KACF,WAAW;sBAEX,eAAe,GAAG;IACvB,SAAS,CAAC,EAAE,CAAS,IAAI,EAAJ,IAAI,KAAE,IAAI,CAAC;IAChC,cAAc,CAAC,EAAE,CAAS,IAAI,EAAJ,IAAI,KAAE,IAAI,CAAC;IACrC,aAAa,CAAC,EAAE,CAAS,IAAI,EAAJ,IAAI,KAAE,IAAI,CAAA;CAAC;;;;;UAIlC,OAAO,iBAAiB,EAAE,kBAAkB;;;;cAC5C,GAAG;;gDAGF,OAAO,uBAAuB,EAAE,OAAO,SAEvC,OAAO,8BAA8B,EAAE,OAAO;;;;;+BAG/C,OAAO;;;;;qBAEP,OAAO;;0BA1CwB,oBAAoB;oBAbzC,qBAAqB;+BADlC,wBAAwB"}

package/dist/src/view/view.js

@@ -58,14 +58,14 @@ const defaultOpacityFunction = (parentOpacity) => parentOpacity;
  * @typedef {object} ViewOptions
  * @prop {boolean} [blockEncodingInheritance]
  *      Don't inherit encodings from parent. Default: false.
- * @prop {boolean} [contributesToScaleDomain]
- *      Whether ScaleResolution should include this view or its children in the
- *      domain. Default: true
  * @prop {boolean} [layersChildren]
  *      View's children are layered on top of each other and they have the same
  *      coordinates as their parent.
  */
 export default class View {
+    /** @type {string | undefined} */
+    #defaultName;
+
     /** @type {Record<string, (function(BroadcastMessage):void)[]>} */
     #broadcastHandlers = {};
 
@@ -81,6 +81,9 @@ export default class View {
     /** @type {(value: number) => void} */
     #heightSetter;
 
+    /** @type {boolean} */
+    #hasRendered = false;
+
     /**
      * @type {function(number):number}
      */
@@ -91,6 +94,11 @@ export default class View {
      */
     #disposers = [];
 
+    /**
+     * @type {"none" | "pending" | "ready"}
+     */
+    #dataInitializationState = "none";
+
     /**
      * Coords of the view for each facet, recorded during the last layout rendering pass.
      * Most views have only one facet, so the map is usually of size 1.
@@ -117,7 +125,7 @@ export default class View {
         this.context = context;
         this.layoutParent = layoutParent;
         this.dataParent = dataParent;
-        this.name = spec.name || name;
+        this.#defaultName = name;
         this.spec = spec;
 
         this.resolutions = {
@@ -137,7 +145,6 @@ export default class View {
 
         this.options = {
             blockEncodingInheritance: false,
-            contributesToScaleDomain: true,
             ...options,
         };
 
@@ -179,6 +186,29 @@ export default class View {
         }
     }
 
+    /**
+     * Effective view name. Equals the explicit name (`spec.name`) when provided,
+     * otherwise falls back to an auto-generated default name.
+     */
+    get name() {
+        return this.spec.name ?? this.#defaultName;
+    }
+
+    /**
+     * The explicit name from the spec (`spec.name`), if any.
+     */
+    get explicitName() {
+        return this.spec.name;
+    }
+
+    /**
+     * The auto-generated default name that was assigned by the parent/factory.
+     * Intended for debugging only.
+     */
+    get defaultName() {
+        return this.#defaultName;
+    }
+
     /**
      * Returns the coords of the view. If view has been faceted, returns the coords
      * of an arbitrary facet. If all or specific facet coords are needed, use `facetCoords`.
@@ -260,11 +290,12 @@ export default class View {
      */
     #getDimensionSize(dimension) {
         let value = this.spec[dimension];
+        const needsStepInvalidation = isStepSize(value);
 
         const viewport =
             dimension == "viewportWidth" || dimension == "viewportHeight";
 
-        if (isStepSize(value)) {
+        if (needsStepInvalidation) {
             if (viewport) {
                 throw new ViewError(
                     `Cannot use step-based size with "${dimension}"!`,
@@ -308,7 +339,7 @@ export default class View {
                 return { px: steps * stepSize, grow: 0 };
             } else {
                 throw new ViewError(
-                    "Cannot use 'step' size with missing scale!",
+                    `Cannot use step-based size with "${dimension}"!`,
                     this
                 );
             }
@@ -320,6 +351,36 @@ export default class View {
         }
     }
 
+    registerStepSizeInvalidation() {
+        this.#registerStepSizeInvalidationFor("width", "x");
+        this.#registerStepSizeInvalidationFor("height", "y");
+    }
+
+    /**
+     * @param {"width" | "height"} dimension
+     * @param {import("../spec/channel.js").PrimaryPositionalChannel} channel
+     */
+    #registerStepSizeInvalidationFor(dimension, channel) {
+        const value = this.spec[dimension];
+        if (!isStepSize(value)) {
+            return;
+        }
+
+        const resolution = this.getScaleResolution(channel);
+        if (!resolution) {
+            throw new ViewError(
+                "Cannot use 'step' size without a scale!",
+                this
+            );
+        }
+
+        const listener = () => this.invalidateSizeCache();
+        resolution.addEventListener("domain", listener);
+        this.registerDisposer(() =>
+            resolution.removeEventListener("domain", listener)
+        );
+    }
+
     isConfiguredVisible() {
         return this.context.isViewConfiguredVisible(this);
     }
@@ -343,6 +404,45 @@ export default class View {
         );
     }
 
+    /**
+     * Returns true if this view or any ancestor is marked as domain inert.
+     *
+     * @returns {boolean}
+     */
+    isDomainInert() {
+        if (this.spec.domainInert) {
+            return true;
+        }
+
+        const parent = this.dataParent;
+        if (!parent) {
+            return false;
+        }
+
+        return parent.isDomainInert();
+    }
+
+    /**
+     * @returns {"none" | "pending" | "ready"}
+     */
+    getDataInitializationState() {
+        return this.#dataInitializationState;
+    }
+
+    /**
+     * Internal hook for lazy dataflow initialization.
+     * Use only from flow initialization helpers to avoid inconsistent state.
+     *
+     * @param {"none" | "pending" | "ready"} state
+     */
+    _setDataInitializationState(state) {
+        this.#dataInitializationState = state;
+    }
+
+    isDataInitialized() {
+        return this.#dataInitializationState === "ready";
+    }
+
     /**
      * Returns the effective opacity of this view, e.g., view's opacity multiplied
      * by opacities of its ancestors.
@@ -542,6 +642,8 @@ export default class View {
             this.context.dataFlow.removeDataSource(handle.dataSource);
         }
 
+        this.context.dataFlow.loadingStatusRegistry.delete(this);
+
         this.flowHandle = undefined;
     }
 
@@ -583,7 +685,13 @@ export default class View {
      * pass. The order is depth first, pre order.
      */
     onBeforeRender() {
-        //
+        if (!this.#hasRendered) {
+            this.#hasRendered = true;
+        }
+    }
+
+    hasRendered() {
+        return this.#hasRendered;
     }
 
     /**
@@ -806,7 +914,9 @@ export default class View {
     }
 
     invalidateSizeCache() {
-        this._invalidateCacheByPrefix("size/", "ancestors");
+        // Clear both "size" and "size/*" cache keys.
+        invalidatePrefix(this, "size");
+        this._invalidateCacheByPrefix("size", "ancestors");
     }
 
     /**

package/dist/src/view/viewFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewFactory.d.ts","sourceRoot":"","sources":["../../../src/view/viewFactory.js"],"names":[],"mappings":"AA4RA;;;;GAIG;AACH,sEAFa,IAAI,sCAAY,CAI5B;AAED;;;;GAIG;AACH,uEAFa,IAAI,uCAAa,CAI7B;AAED;;;;GAIG;AACH,uEAFa,IAAI,uCAAa,CAS7B;AAED;;;;GAIG;AACH,kFAFa,IAAI,IAAI,OAAO,iBAAiB,EAAE,oBAAoB,CAQlE;AAED;;;;GAIG;AACH,mCAHW,MAAM,GACJ,IAAI,IAAI,OAAO,iBAAiB,EAAE,UAAU,CAIxD;AAED;;;;GAIG;AACH,yEAFa,IAAI,yCAAe,CAI/B;AAED;;;;GAIG;AACH,yEAFa,IAAI,IAAI,WAAW,CAI/B;AAED;;;;GAIG;AACH,wEAFa,IAAI,wCAAc,CAI9B;AAED;;;;GAIG;AACH,wEAFa,IAAI,8CAAc,CAS9B;AA5WD,6BAA8B,UAAU,CAAC;AAEzC;;;;GAIG;AAEH;;GAEG;AACH;IAiBI;;OAEG;IACH,sBAFW,kBAAkB,EAoC5B;IAjCG,2CAA2C;IAC3C,SADW,QAAQ,CAAC,kBAAkB,CAAC,CAKtC;IA8BL;;;OAGG;IACH,qEAlDiC,OAAO,yHAC2B,OAAO,oBAAoB,EAAE,OAAO,eAAe,OAAO,WAAW,EAAE,OAAO,gBAAgB,MAAM,KAAK,IAAI,QAmD/K;IAED;;;;;;OAMG;IACH,wHAJW,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,QAmBhB;IAED;;;;OAIG;IACH,sDAFa,IAAI,sCAAY,CAU5B;IAED;;;;;;;;;;OAUG;IACH,yBAPW,qCAAW,OAAO,iBAAiB,EAAE,UAAU,qEAE/C,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,cACN,CAAC,IAAI,oCAAU,KAAK,IAAI,iBAiFlC;;CACJ;;;;;kBA3Ma,OAAO;eACP,OAAO;;iBAjBJ,WAAW"}
+{"version":3,"file":"viewFactory.d.ts","sourceRoot":"","sources":["../../../src/view/viewFactory.js"],"names":[],"mappings":"AA+SA;;;;GAIG;AACH,sEAFa,IAAI,sCAAY,CAI5B;AAED;;;;GAIG;AACH,uEAFa,IAAI,uCAAa,CAI7B;AAED;;;;GAIG;AACH,uEAFa,IAAI,uCAAa,CAS7B;AAED;;;;GAIG;AACH,kFAFa,IAAI,IAAI,OAAO,iBAAiB,EAAE,oBAAoB,CAQlE;AAED;;;;GAIG;AACH,mCAHW,MAAM,GACJ,IAAI,IAAI,OAAO,iBAAiB,EAAE,UAAU,CAIxD;AAED;;;;GAIG;AACH,yEAFa,IAAI,yCAAe,CAI/B;AAED;;;;GAIG;AACH,yEAFa,IAAI,IAAI,WAAW,CAI/B;AAED;;;;GAIG;AACH,wEAFa,IAAI,wCAAc,CAI9B;AAED;;;;GAIG;AACH,wEAFa,IAAI,8CAAc,CAS9B;AA3XD,6BAA8B,UAAU,CAAC;AAEzC;;;;GAIG;AAEH;;GAEG;AACH;IAiBI;;OAEG;IACH,sBAFW,kBAAkB,EAoC5B;IAjCG,2CAA2C;IAC3C,SADW,QAAQ,CAAC,kBAAkB,CAAC,CAKtC;IA8BL;;;OAGG;IACH,qEAlDiC,OAAO,yHAC2B,OAAO,oBAAoB,EAAE,OAAO,eAAe,OAAO,WAAW,EAAE,OAAO,gBAAgB,MAAM,KAAK,IAAI,QAmD/K;IAED;;;;;;OAMG;IACH,wHAJW,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,QAmBhB;IAED;;;;OAIG;IACH,sDAFa,IAAI,sCAAY,CAU5B;IAED;;;;;;;;;;OAUG;IACH,yBAPW,qCAAW,OAAO,iBAAiB,EAAE,UAAU,qEAE/C,OAAO,oBAAoB,EAAE,OAAO,eACpC,OAAO,WAAW,EAAE,OAAO,gBAC3B,MAAM,cACN,CAAC,IAAI,oCAAU,KAAK,IAAI,iBAgGlC;;CACJ;;;;;kBA1Na,OAAO;eACP,OAAO;;iBArBJ,WAAW"}

package/dist/src/view/viewFactory.js

@@ -10,6 +10,10 @@ import ContainerView from "./containerView.js";
 import ViewError from "./viewError.js";
 import { isSelectionParameter } from "./paramMediator.js";
 import { asSelectionConfig } from "../selection/selection.js";
+import {
+    markViewAsNonAddressable,
+    registerImportInstance,
+} from "./viewSelectors.js";
 
 export const VIEW_ROOT_NAME = "viewRoot";
 
@@ -60,7 +64,7 @@ export class ViewFactory {
                         context,
                         layoutParent,
                         dataParent,
-                        spec.name ?? defaultName
+                        defaultName
                     )
                 );
 
@@ -148,6 +152,9 @@ export class ViewFactory {
     ) {
         /** @type {ViewSpec} */
         let viewSpec;
+        const importScopeName = isImportSpec(spec)
+            ? (spec.name ?? null)
+            : undefined;
 
         if (isImportSpec(spec)) {
             /** @type {ViewSpec} */
@@ -190,6 +197,7 @@ export class ViewFactory {
             );
 
         // Wrap a unit spec at root into a grid view to get axes, etc.
+        let isImplicitRoot = false;
         if (
             !dataParent &&
             this.options.wrapRoot &&
@@ -202,6 +210,7 @@ export class ViewFactory {
                 name: "implicitRoot",
                 vconcat: [viewSpec],
             };
+            isImplicitRoot = true;
         }
 
         const view = this.createView(
@@ -212,10 +221,20 @@ export class ViewFactory {
             defaultName
         );
 
+        if (importScopeName !== undefined) {
+            registerImportInstance(view, importScopeName);
+        }
+
+        if (isImplicitRoot) {
+            markViewAsNonAddressable(view);
+        }
+
         if (view instanceof ContainerView) {
             await view.initializeChildren();
         }
 
+        view.registerStepSizeInvalidation();
+
         return view;
     }
 }

package/dist/src/view/viewSelectors.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Marks a view as the root of an import scope.
+ *
+ * @param {import("./view.js").default} view
+ * @param {string | null} scopeName
+ */
+export function registerImportInstance(view: import("./view.js").default, scopeName: string | null): void;
+/**
+ * Returns import scope info for a view, if it is an import root.
+ *
+ * @param {import("./view.js").default} view
+ * @returns {ImportScopeInfo | undefined}
+ */
+export function getImportScopeInfo(view: import("./view.js").default): ImportScopeInfo | undefined;
+/**
+ * Marks a view as non-addressable for selector resolution.
+ *
+ * @param {import("./view.js").default} view
+ * @param {AddressableOptions} [options]
+ */
+export function markViewAsNonAddressable(view: import("./view.js").default, options?: AddressableOptions): void;
+/**
+ * Returns the import scope chain for a view, using named import instances.
+ *
+ * @param {import("./view.js").default} view
+ * @returns {string[]}
+ */
+export function getViewScopeChain(view: import("./view.js").default): string[];
+/**
+ * Returns a view selector for a view with an explicit name.
+ *
+ * @param {import("./view.js").default} view
+ * @returns {ViewSelector}
+ */
+export function getViewSelector(view: import("./view.js").default): ViewSelector;
+/**
+ * Returns a parameter selector for a parameter registered in a view.
+ *
+ * @param {import("./view.js").default} view
+ * @param {string} paramName
+ * @returns {ParamSelector}
+ */
+export function getParamSelector(view: import("./view.js").default, paramName: string): ParamSelector;
+/**
+ * Returns a stable key for a parameter selector.
+ *
+ * @param {ParamSelector} selector
+ * @returns {string}
+ */
+export function makeParamSelectorKey(selector: ParamSelector): string;
+/**
+ * Enumerates views that can be addressed by selectors.
+ *
+ * @param {import("./view.js").default} root
+ * @returns {import("./view.js").default[]}
+ */
+export function getAddressableViews(root: import("./view.js").default): import("./view.js").default[];
+/**
+ * Visits all addressable views in the hierarchy.
+ *
+ * @param {import("./view.js").default} root
+ * @param {import("./view.js").Visitor} visitor
+ */
+export function visitAddressableViews(root: import("./view.js").default, visitor: import("./view.js").Visitor): void;
+/**
+ * Resolves a view selector to a unique view within the matching scope.
+ *
+ * @param {import("./view.js").default} root
+ * @param {ViewSelector} selector
+ * @returns {import("./view.js").default | undefined}
+ */
+export function resolveViewSelector(root: import("./view.js").default, selector: ViewSelector): import("./view.js").default | undefined;
+/**
+ * Resolves a parameter selector to a unique bookmarkable parameter.
+ *
+ * @param {import("./view.js").default} root
+ * @param {ParamSelector} selector
+ * @returns {ResolvedParam | undefined}
+ */
+export function resolveParamSelector(root: import("./view.js").default, selector: ParamSelector): ResolvedParam | undefined;
+/**
+ * Visits bookmarkable parameters in the view hierarchy.
+ *
+ * @param {import("./view.js").default} root
+ * @param {(entry: BookmarkableParamEntry) => void} visitor
+ */
+export function visitBookmarkableParams(root: import("./view.js").default, visitor: (entry: BookmarkableParamEntry) => void): void;
+/**
+ * Returns bookmarkable parameters in the view hierarchy.
+ *
+ * @param {import("./view.js").default} root
+ * @returns {BookmarkableParamEntry[]}
+ */
+export function getBookmarkableParams(root: import("./view.js").default): BookmarkableParamEntry[];
+/**
+ * Validates naming and scoping constraints for addressable views and parameters.
+ *
+ * @param {import("./view.js").default} root
+ * @returns {SelectorValidationIssue[]}
+ */
+export function validateSelectorConstraints(root: import("./view.js").default): SelectorValidationIssue[];
+/**
+ * Selectors identify views and parameters in a way that stays stable when the
+ * same template/import is instantiated multiple times. They combine a chain of
+ * named import instances (scope) with an explicit view or parameter name so
+ * bookmarkable state and visibility toggles do not rely on globally-unique
+ * names or runtime-only nodes.
+ */
+/**
+ * @typedef {{ scope: string[], view: string }} ViewSelector
+ * @typedef {{ scope: string[], param: string }} ParamSelector
+ * @typedef {{ view: import("./view.js").default, param: import("../spec/parameter.js").Parameter, selector: ParamSelector }} BookmarkableParamEntry
+ * @typedef {{ message: string, scope: string[] }} SelectorValidationIssue
+ * @typedef {{ name: string | null }} ImportScopeInfo
+ * @typedef {"exclude" | "excludeSubtree"} AddressableOverride
+ * @typedef {{ skipSubtree?: boolean }} AddressableOptions
+ * @typedef {{ view: import("./view.js").default, param: import("../spec/parameter.js").Parameter }} ResolvedParam
+ */
+export const PARAM_SELECTOR_KEY_PREFIX: "p:";
+export type ViewSelector = {
+    scope: string[];
+    view: string;
+};
+export type ParamSelector = {
+    scope: string[];
+    param: string;
+};
+export type BookmarkableParamEntry = {
+    view: import("./view.js").default;
+    param: import("../spec/parameter.js").Parameter;
+    selector: ParamSelector;
+};
+export type SelectorValidationIssue = {
+    message: string;
+    scope: string[];
+};
+export type ImportScopeInfo = {
+    name: string | null;
+};
+export type AddressableOverride = "exclude" | "excludeSubtree";
+export type AddressableOptions = {
+    skipSubtree?: boolean;
+};
+export type ResolvedParam = {
+    view: import("./view.js").default;
+    param: import("../spec/parameter.js").Parameter;
+};
+//# sourceMappingURL=viewSelectors.d.ts.map

package/dist/src/view/viewSelectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewSelectors.d.ts","sourceRoot":"","sources":["../../../src/view/viewSelectors.js"],"names":[],"mappings":"AA8BA;;;;;GAKG;AACH,6CAHW,OAAO,WAAW,EAAE,OAAO,aAC3B,MAAM,GAAG,IAAI,QAQvB;AAED;;;;;GAKG;AACH,yCAHW,OAAO,WAAW,EAAE,OAAO,GACzB,eAAe,GAAG,SAAS,CAIvC;AAED;;;;;GAKG;AACH,+CAHW,OAAO,WAAW,EAAE,OAAO,YAC3B,kBAAkB,QAM5B;AAED;;;;;GAKG;AACH,wCAHW,OAAO,WAAW,EAAE,OAAO,GACzB,MAAM,EAAE,CAgBpB;AAED;;;;;GAKG;AACH,sCAHW,OAAO,WAAW,EAAE,OAAO,GACzB,YAAY,CAYxB;AAED;;;;;;GAMG;AACH,uCAJW,OAAO,WAAW,EAAE,OAAO,aAC3B,MAAM,GACJ,aAAa,CAazB;AAED;;;;;GAKG;AACH,+CAHW,aAAa,GACX,MAAM,CAQlB;AAED;;;;;GAKG;AACH,0CAHW,OAAO,WAAW,EAAE,OAAO,GACzB,OAAO,WAAW,EAAE,OAAO,EAAE,CAWzC;AAED;;;;;GAKG;AACH,4CAHW,OAAO,WAAW,EAAE,OAAO,WAC3B,OAAO,WAAW,EAAE,OAAO,QAerC;AAED;;;;;;GAMG;AACH,0CAJW,OAAO,WAAW,EAAE,OAAO,YAC3B,YAAY,GACV,OAAO,WAAW,EAAE,OAAO,GAAG,SAAS,CAmCnD;AAED;;;;;;GAMG;AACH,2CAJW,OAAO,WAAW,EAAE,OAAO,YAC3B,aAAa,GACX,aAAa,GAAG,SAAS,CAuCrC;AAED;;;;;GAKG;AACH,8CAHW,OAAO,WAAW,EAAE,OAAO,WAC3B,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,QAyBjD;AAED;;;;;GAKG;AACH,4CAHW,OAAO,WAAW,EAAE,OAAO,GACzB,sBAAsB,EAAE,CAOpC;AAED;;;;;GAKG;AACH,kDAHW,OAAO,WAAW,EAAE,OAAO,GACzB,uBAAuB,EAAE,CAcrC;AArUD;;;;;;GAMG;AAEH;;;;;;;;;GASG;AAEH,wCAAyC,IAAI,CAAC;2BAVjC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;4BACjC;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;qCAClC;IAAE,IAAI,EAAE,OAAO,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,sBAAsB,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAA;CAAE;sCAC/G;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE;8BACpC;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;kCACvB,SAAS,GAAG,gBAAgB;iCAC5B;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE;4BACzB;IAAE,IAAI,EAAE,OAAO,WAAW,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,sBAAsB,EAAE,SAAS,CAAA;CAAE"}