@genome-spy/core 0.67.0 → 0.68.0

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

@@ -33,25 +33,20 @@ export default class UnitView extends View {
      * @param {Channel} channel
      */
     getDataAccessor(channel: import("../spec/channel.js").Channel): import("../types/encoder.js").Accessor<import("../spec/channel.js").Scalar>;
+    /**
+     * Returns data accessors configured for the `search` channel.
+     *
+     * @returns {import("vega-util").AccessorFn[]}
+     */
+    getSearchAccessors(): import("vega-util").AccessorFn[];
     /**
      * Returns a collector that is associated with this view.
      */
     getCollector(): import("../data/collector.js").default;
     /**
-     * Extracts the domain from the data.
-     *
-     * TODO: Optimize! Now this performs redundant work if multiple views share the same collector.
-     * Also, all relevant fields should be processed in one iteration: https://jsbench.me/y5kkqy52jo/1
-     * In fact, domain extraction could be a responsibility of the collector: As it handles data items,
-     * it extracts domains for all fields (and data types) that need extracted domains.
-     * Alternatively, extractor nodes could be added to the data flow, just like Vega does
-     * (with aggregate and extent).
-     *
-     * @param {Channel} channel
-     * @param {import("../spec/channel.js").Type} type
-     * @returns {DomainArray}
+     * Registers collector subscriptions that keep scale domains up to date.
      */
-    extractDataDomain(channel: import("../spec/channel.js").Channel, type: import("../spec/channel.js").Type): import("../utils/domainArray.js").DomainArray;
+    registerDomainSubscriptions(): void;
     getZoomLevel(): number;
     /**
      * @param {string} channel

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

@@ -1 +1 @@
-{"version":3,"file":"unitView.d.ts","sourceRoot":"","sources":["../../../src/view/unitView.js"],"names":[],"mappings":"AA6BA;;;;GAIG;AACH,wBAHU,MAAM,CAAC,OAAO,iBAAiB,EAAE,QAAQ,EAAE,cAAc,kBAAkB,EAAE,OAAO,CAAC,CAc7F;AAEF;IAeI;;;;;;;;OAQG;IACH,kBAPW,OAAO,iBAAiB,EAAE,QAAQ,WAClC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,YACN,OAAO,WAAW,EAAE,WAAW,EAyCzC;IApCG,yCAAgB;IAIZ,iDAAiD;IACjD,MADW,OAAO,kBAAkB,EAAE,OAAO,CACnB;IAoKlC,2DAIC;IAgBD;;;;;OAKG;IAEH,iEAyJC;IAUD;;;;;OAKG;IACH,4IAMC;IAkBD;;OAEG;IACH,uDAEC;IAED;;;;;;;;;;;;;OAaG;IACH,uEAHW,OAAO,oBAAoB,EAAE,IAAI,iDAqB3C;IAED,uBAQC;IAgBD;;;;OAIG;IACH,8BAJW,MAAM,+DAEJ,OAAO,iBAAiB,EAAE,kBAAkB,CAKxD;;CACJ;iBAvgBgB,WAAW"}
+{"version":3,"file":"unitView.d.ts","sourceRoot":"","sources":["../../../src/view/unitView.js"],"names":[],"mappings":"AA+BA;;;;GAIG;AACH,wBAHU,MAAM,CAAC,OAAO,iBAAiB,EAAE,QAAQ,EAAE,cAAc,kBAAkB,EAAE,OAAO,CAAC,CAc7F;AAEF;IAwBI;;;;;;;;OAQG;IACH,kBAPW,OAAO,iBAAiB,EAAE,QAAQ,WAClC,OAAO,yBAAyB,EAAE,OAAO,gBACzC,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,WAAW,EAAE,OAAO,QAC3B,MAAM,YACN,OAAO,WAAW,EAAE,WAAW,EAyCzC;IApCG,yCAAgB;IAIZ,iDAAiD;IACjD,MADW,OAAO,kBAAkB,EAAE,OAAO,CACnB;IAoKlC,2DAIC;IAoBD;;;;;OAKG;IAEH,iEAoJC;IAUD;;;;;OAKG;IACH,4IAMC;IAED;;;;OAIG;IACH,sBAFa,OAAO,WAAW,EAAE,UAAU,EAAE,CAS5C;IAkBD;;OAEG;IACH,uDAEC;IAED;;OAEG;IACH,oCA0EC;IAED,uBAQC;IAgBD;;;;OAIG;IACH,8BAJW,MAAM,+DAEJ,OAAO,iBAAiB,EAAE,kBAAkB,CAKxD;;CACJ;iBA5kBgB,WAAW"}

package/dist/src/view/unitView.js

@@ -14,7 +14,7 @@ import {
     isPrimaryPositionalChannel,
     isValueDefWithCondition,
 } from "../encoder/encoder.js";
-import createDomain from "../utils/domainArray.js";
+import { isScaleAccessor } from "../encoder/accessor.js";
 import AxisResolution from "../scales/axisResolution.js";
 import View from "./view.js";
 import {
@@ -24,8 +24,10 @@ import {
     isPointSelectionConfig,
     updateMultiPointSelection,
 } from "../selection/selection.js";
+import { getEncodingSearchFields } from "../encoder/metadataChannels.js";
 import { UNIQUE_ID_KEY } from "../data/transforms/identifier.js";
 import { createEventFilterFunction } from "../utils/expression.js";
+import { field } from "../utils/field.js";
 
 /**
  *
@@ -48,7 +50,6 @@ export const markTypes = {
 export default class UnitView extends View {
     /**
      * @typedef {import("../spec/channel.js").Channel} Channel
-     * @typedef {import("../utils/domainArray.js").DomainArray} DomainArray
      * @typedef {import("../spec/view.js").ResolutionTarget} ResolutionTarget
      * @typedef {((datum: import("../data/flowNode.js").Datum) => import("../spec/channel.js").Scalar) & { fieldDef: import("../spec/channel.js").FieldDef}} FieldAccessor
      *
@@ -60,6 +61,16 @@ export default class UnitView extends View {
      */
     #zoomLevelSetter;
 
+    /**
+     * @type {boolean}
+     */
+    #domainSubscriptionsRegistered = false;
+
+    /**
+     * @type {import("vega-util").AccessorFn[] | null}
+     */
+    #searchAccessors = null;
+
     /**
      *
      * @param {import("../spec/view.js").UnitSpec} spec
@@ -253,6 +264,10 @@ export default class UnitView extends View {
         const encoding = super.getEncoding();
         const supportedChannels = this.mark.getSupportedChannels();
         for (const channel of Object.keys(encoding)) {
+            if (channel === "key") {
+                continue;
+            }
+
             if (!supportedChannels.includes(channel)) {
                 delete encoding[channel];
             }
@@ -284,6 +299,10 @@ export default class UnitView extends View {
                 continue;
             }
 
+            if (Array.isArray(channelDef)) {
+                continue;
+            }
+
             /** @type {import("../spec/channel.js").ChannelDefWithScale} */
             let channelDefWithScale;
 
@@ -392,23 +411,14 @@ export default class UnitView extends View {
                     });
                 }
 
-                const dataDomainSource =
-                    this.getLayoutAncestors()
-                        // TODO: Should check until the resolved scale resolution
-                        .some(
-                            (view) => !view.options.contributesToScaleDomain
-                        ) ||
-                    (isChannelDefWithScale(channelDefWithScale) &&
-                        channelDefWithScale.contributesToScaleDomain === false)
-                        ? undefined
-                        : this.extractDataDomain.bind(this);
+                const contributesToDomain = !this.isDomainInert();
 
                 const resolution = view.resolutions[type][targetChannel];
                 const unregister = resolution.registerMember({
                     view: this,
                     channel,
                     channelDef: channelDefWithScale,
-                    dataDomainSource,
+                    contributesToDomain,
                 });
                 this.registerDisposer(() => {
                     // Unregister returns true when it removed the last member.
@@ -445,6 +455,20 @@ export default class UnitView extends View {
         return encoders[channel]?.dataAccessor;
     }
 
+    /**
+     * Returns data accessors configured for the `search` channel.
+     *
+     * @returns {import("vega-util").AccessorFn[]}
+     */
+    getSearchAccessors() {
+        if (!this.#searchAccessors) {
+            const fields = getEncodingSearchFields(this.getEncoding()) ?? [];
+            this.#searchAccessors = fields.map((fieldName) => field(fieldName));
+        }
+
+        return this.#searchAccessors;
+    }
+
     /**
      * Returns an accessor that returns a (composite) key for partitioning the data
      *
@@ -469,37 +493,82 @@ export default class UnitView extends View {
     }
 
     /**
-     * Extracts the domain from the data.
-     *
-     * TODO: Optimize! Now this performs redundant work if multiple views share the same collector.
-     * Also, all relevant fields should be processed in one iteration: https://jsbench.me/y5kkqy52jo/1
-     * In fact, domain extraction could be a responsibility of the collector: As it handles data items,
-     * it extracts domains for all fields (and data types) that need extracted domains.
-     * Alternatively, extractor nodes could be added to the data flow, just like Vega does
-     * (with aggregate and extent).
-     *
-     * @param {Channel} channel
-     * @param {import("../spec/channel.js").Type} type
-     * @returns {DomainArray}
+     * Registers collector subscriptions that keep scale domains up to date.
      */
-    extractDataDomain(channel, type) {
-        /** @type {DomainArray} */
-        let domain = createDomain(type);
-
-        (this.mark.encoders[channel]?.accessors ?? [])
-            .filter((a) => a.scaleChannel)
-            .forEach((accessor) => {
-                if (accessor.constant) {
-                    domain.extend(accessor({}));
-                } else {
-                    const collector = this.getCollector();
-                    if (collector?.completed) {
-                        collector.visitData((d) => domain.extend(accessor(d)));
-                    }
+    registerDomainSubscriptions() {
+        if (this.#domainSubscriptionsRegistered) {
+            return;
+        }
+
+        if (this.isDomainInert()) {
+            return;
+        }
+
+        const collector = this.getCollector();
+        if (!collector) {
+            return;
+        }
+
+        const encoders = this.mark.encoders;
+        if (!encoders) {
+            throw new Error("Encoders are not initialized!");
+        }
+
+        this.#domainSubscriptionsRegistered = true;
+
+        /** @type {Map<import("../scales/scaleResolution.js").default, Set<import("../types/encoder.js").ScaleAccessor>>} */
+        const accessorsByResolution = new Map();
+
+        for (const encoder of Object.values(encoders)) {
+            if (!encoder) {
+                continue;
+            }
+
+            const accessors = encoder.accessors ?? [];
+            if (accessors.length === 0) {
+                continue;
+            }
+
+            for (const accessor of accessors) {
+                if (!isScaleAccessor(accessor)) {
+                    continue;
+                }
+                if (accessor.channelDef.domainInert) {
+                    continue;
+                }
+                const resolution = this.getScaleResolution(
+                    accessor.scaleChannel
+                );
+                if (!resolution) {
+                    throw new Error(
+                        "Missing scale resolution for channel: " +
+                            accessor.scaleChannel
+                    );
                 }
-            });
 
-        return domain;
+                let accessorsForResolution =
+                    accessorsByResolution.get(resolution);
+                if (!accessorsForResolution) {
+                    accessorsForResolution = new Set();
+                    accessorsByResolution.set(
+                        resolution,
+                        accessorsForResolution
+                    );
+                }
+                accessorsForResolution.add(accessor);
+            }
+        }
+
+        for (const [resolution, accessors] of accessorsByResolution) {
+            if (accessors.size === 0) {
+                continue;
+            }
+            const unregister = resolution.registerCollectorSubscriptions(
+                collector,
+                accessors
+            );
+            this.registerDisposer(unregister);
+        }
     }
 
     getZoomLevel() {

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,12 @@ 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"}
      */
@@ -250,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
@@ -372,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":"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"}

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}
      */
@@ -122,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 = {
@@ -142,7 +145,6 @@ export default class View {
 
         this.options = {
             blockEncodingInheritance: false,
-            contributesToScaleDomain: true,
             ...options,
         };
 
@@ -184,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`.
@@ -265,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}"!`,
@@ -313,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
                 );
             }
@@ -325,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);
     }
@@ -348,6 +404,24 @@ 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"}
      */
@@ -568,6 +642,8 @@ export default class View {
             this.context.dataFlow.removeDataSource(handle.dataSource);
         }
 
+        this.context.dataFlow.loadingStatusRegistry.delete(this);
+
         this.flowHandle = undefined;
     }
 
@@ -609,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;
     }
 
     /**
@@ -832,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;
     }
 }