@genome-spy/core 0.76.0 → 0.78.0

package/dist/src/scales/scaleInteractionController.js

@@ -27,6 +27,7 @@ import {
  * @typedef {import("../spec/scale.js").ComplexDomain} ComplexDomain
  * @typedef {import("../spec/scale.js").ZoomParams} ZoomParams
  * @typedef {import("../types/encoder.js").VegaScale} VegaScale
+ * @typedef {import("../types/scaleResolutionApi.js").ZoomToOptions} ZoomToOptions
  * @typedef {VegaScale & { props: import("../spec/scale.js").Scale }} ScaleWithProps
  */
 
@@ -37,6 +38,9 @@ export default class ScaleInteractionController {
     /** @type {() => import("../utils/animator.js").default} */
     #getAnimator;
 
+    /** @type {() => void} */
+    #renderImmediately;
+
     /** @type {() => number[]} */
     #getInitialDomainSnapshot;
 
@@ -56,6 +60,7 @@ export default class ScaleInteractionController {
      * @param {object} options
      * @param {() => ScaleWithProps} options.getScale
      * @param {() => import("../utils/animator.js").default} options.getAnimator
+     * @param {() => void} options.renderImmediately
      * @param {() => number[]} options.getInitialDomainSnapshot
      * @param {() => number[]} options.getResetDomain
      * @param {(domain: ScalarDomain | ComplexDomain) => number[]} options.fromComplexInterval
@@ -64,6 +69,7 @@ export default class ScaleInteractionController {
     constructor({
         getScale,
         getAnimator,
+        renderImmediately,
         getInitialDomainSnapshot,
         getResetDomain,
         fromComplexInterval,
@@ -71,6 +77,7 @@ export default class ScaleInteractionController {
     }) {
         this.#getScale = getScale;
         this.#getAnimator = getAnimator;
+        this.#renderImmediately = renderImmediately;
         this.#getInitialDomainSnapshot = getInitialDomainSnapshot;
         this.#getResetDomain = getResetDomain;
         this.#fromComplexInterval = fromComplexInterval;
@@ -170,13 +177,11 @@ export default class ScaleInteractionController {
      * Immediately zooms to the given interval.
      *
      * @param {NumericDomain | ComplexDomain} domain
-     * @param {boolean | number} [duration] an approximate duration for transition.
-     *      Zero duration zooms immediately. Boolean `true` indicates a default duration.
+     * @param {ZoomToOptions | boolean | number} [options] Zoom options.
+     *      Passing the duration directly as a boolean or number is deprecated.
      */
-    async zoomTo(domain, duration = false) {
-        if (isBoolean(duration)) {
-            duration = duration ? 700 : 0;
-        }
+    async zoomTo(domain, options = false) {
+        const { duration, renderImmediately } = normalizeZoomToOptions(options);
 
         if (!this.isZoomingSupported()) {
             throw new Error("Not a zoomable scale!");
@@ -195,6 +200,12 @@ export default class ScaleInteractionController {
         const from = /** @type {number[]} */ (scale.domain());
 
         if (duration > 0 && from.length == 2) {
+            if (renderImmediately) {
+                throw new Error(
+                    "renderImmediately is not supported for animated zooms."
+                );
+            }
+
             // Spans
             const fw = from[1] - from[0];
             const tw = to[1] - to[0];
@@ -234,7 +245,11 @@ export default class ScaleInteractionController {
         } else {
             this.#cancelZoomTransition();
             scale.domain(to);
-            animator?.requestRender();
+            if (renderImmediately) {
+                this.#renderImmediately();
+            } else {
+                animator?.requestRender();
+            }
         }
     }
 
@@ -279,6 +294,39 @@ export default class ScaleInteractionController {
     }
 }
 
+/**
+ * @param {ZoomToOptions | boolean | number | undefined} options
+ * @returns {{ duration: number, renderImmediately: boolean }}
+ */
+function normalizeZoomToOptions(options) {
+    if (options === undefined) {
+        return {
+            duration: 0,
+            renderImmediately: false,
+        };
+    }
+
+    if (isBoolean(options)) {
+        return {
+            duration: options ? 700 : 0,
+            renderImmediately: false,
+        };
+    }
+
+    if (typeof options === "number") {
+        return {
+            duration: options,
+            renderImmediately: false,
+        };
+    }
+
+    const duration = options.duration ?? 0;
+    return {
+        duration: isBoolean(duration) ? (duration ? 700 : 0) : duration,
+        renderImmediately: options.renderImmediately === true,
+    };
+}
+
 /**
  * @param {ScaleWithProps} scale
  * @param {ZoomParams | boolean | undefined} zoom

package/dist/src/scales/scalePropsResolver.d.ts

@@ -8,14 +8,19 @@
  * @param {Channel} options.channel
  * @param {import("../spec/channel.js").Type} options.dataType
  * @param {ScaleResolutionMember[]} options.orderedMembers
+ * @param {{ view: import("../view/view.js").default, config: Scale } | undefined} [options.viewLevelScaleConfig]
  * @param {boolean} options.isExplicitDomain
  * @param {import("../spec/config.js").GenomeSpyConfig[]} options.configScopes
  * @returns {Scale}
  */
-export function resolveScalePropsBase({ channel, dataType, orderedMembers, isExplicitDomain, configScopes, }: {
+export function resolveScalePropsBase({ channel, dataType, orderedMembers, viewLevelScaleConfig, isExplicitDomain, configScopes, }: {
     channel: Channel;
     dataType: import("../spec/channel.js").Type;
     orderedMembers: ScaleResolutionMember[];
+    viewLevelScaleConfig?: {
+        view: import("../view/view.js").default;
+        config: Scale;
+    } | undefined;
     isExplicitDomain: boolean;
     configScopes: import("../spec/config.js").GenomeSpyConfig[];
 }): Scale;

package/dist/src/scales/scalePropsResolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scalePropsResolver.d.ts","sourceRoot":"","sources":["../../../src/scales/scalePropsResolver.js"],"names":[],"mappings":"AAcA;;;;GAIG;AAEH;;;;;;;;GAQG;AACH,8GAPG;IAAyB,OAAO,EAAxB,OAAO;IACoC,QAAQ,EAAnD,OAAO,oBAAoB,EAAE,IAAI;IACA,cAAc,EAA/C,qBAAqB,EAAE;IACN,gBAAgB,EAAjC,OAAO;IACgD,YAAY,EAAnE,OAAO,mBAAmB,EAAE,eAAe,EAAE;CACrD,GAAU,KAAK,CA6IjB;sBAzJY,OAAO,oBAAoB,EAAE,OAAO;oBACpC,OAAO,kBAAkB,EAAE,KAAK;oCAChC,OAAO,sBAAsB,EAAE,qBAAqB"}
+{"version":3,"file":"scalePropsResolver.d.ts","sourceRoot":"","sources":["../../../src/scales/scalePropsResolver.js"],"names":[],"mappings":"AAmBA;;;;GAIG;AAEH;;;;;;;;;GASG;AACH,oIARG;IAAyB,OAAO,EAAxB,OAAO;IACoC,QAAQ,EAAnD,OAAO,oBAAoB,EAAE,IAAI;IACA,cAAc,EAA/C,qBAAqB,EAAE;IAC0D,oBAAoB,GAArG;QAAE,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG,SAAS;IACrD,gBAAgB,EAAjC,OAAO;IACgD,YAAY,EAAnE,OAAO,mBAAmB,EAAE,eAAe,EAAE;CACrD,GAAU,KAAK,CAgKjB;sBA7KY,OAAO,oBAAoB,EAAE,OAAO;oBACpC,OAAO,kBAAkB,EAAE,KAAK;oCAChC,OAAO,sBAAsB,EAAE,qBAAqB"}

package/dist/src/scales/scalePropsResolver.js

@@ -9,7 +9,12 @@ import {
     getConfiguredNamedRange,
     isConfigRangeName,
 } from "../config/scaleConfig.js";
-import { applyLockedProperties, getDefaultScaleType } from "./scaleRules.js";
+import { collectConfiguredDomainExprRefs } from "./domainExpressions.js";
+import {
+    applyLockedProperties,
+    getDefaultScaleType,
+    validateScaleTypeCompatibility,
+} from "./scaleRules.js";
 import { INDEX, LOCUS } from "./scaleResolutionConstants.js";
 
 /**
@@ -23,6 +28,7 @@ import { INDEX, LOCUS } from "./scaleResolutionConstants.js";
  * @param {Channel} options.channel
  * @param {import("../spec/channel.js").Type} options.dataType
  * @param {ScaleResolutionMember[]} options.orderedMembers
+ * @param {{ view: import("../view/view.js").default, config: Scale } | undefined} [options.viewLevelScaleConfig]
  * @param {boolean} options.isExplicitDomain
  * @param {import("../spec/config.js").GenomeSpyConfig[]} options.configScopes
  * @returns {Scale}
@@ -31,6 +37,7 @@ export function resolveScalePropsBase({
     channel,
     dataType,
     orderedMembers,
+    viewLevelScaleConfig,
     isExplicitDomain,
     configScopes,
 }) {
@@ -44,9 +51,11 @@ export function resolveScalePropsBase({
         )
         .filter((markType) => !!markType);
 
-    const propArray = memberList
-        .map((member) => member.channelDef.scale)
-        .filter((props) => props !== undefined);
+    const propArray = viewLevelScaleConfig
+        ? [viewLevelScaleConfig.config]
+        : memberList
+              .map((member) => member.channelDef.scale)
+              .filter((props) => props !== undefined);
 
     // TODO: Disabled scale: https://vega.github.io/vega-lite/docs/scale.html#disable
     const mergedProps = mergeObjects(propArray, "scale", ["domain"]);
@@ -76,6 +85,13 @@ export function resolveScalePropsBase({
         props.type = getDefaultScaleType(channel, dataType);
     }
 
+    validateScaleTypeCompatibility(
+        channel,
+        dataType,
+        viewLevelScaleConfig ? props.type : undefined,
+        `View-level scales.${channel}.type`
+    );
+
     if (typeof props.range == "string") {
         if (!isConfigRangeName(props.range)) {
             throw new Error(
@@ -132,9 +148,15 @@ export function resolveScalePropsBase({
     }
 
     if (props.domainTransition === undefined) {
-        const hasExprDrivenDomain = memberList.some((member) =>
-            isExprRef(member.channelDef.scale?.domain)
-        );
+        const hasExprDrivenDomain =
+            memberList.some(
+                (member) =>
+                    collectConfiguredDomainExprRefs(
+                        member.channelDef.scale?.domain
+                    ).length > 0
+            ) ||
+            collectConfiguredDomainExprRefs(viewLevelScaleConfig?.config.domain)
+                .length > 0;
         props.domainTransition = !hasExprDrivenDomain;
     }
 
@@ -143,9 +165,12 @@ export function resolveScalePropsBase({
         props.range.some(isExprRef) &&
         memberList.length > 0
     ) {
-        const rangeOwner = memberList.find(
-            (member) => member.channelDef.scale?.range !== undefined
-        )?.view;
+        const rangeOwner =
+            viewLevelScaleConfig?.config.range !== undefined
+                ? viewLevelScaleConfig.view
+                : memberList.find(
+                      (member) => member.channelDef.scale?.range !== undefined
+                  )?.view;
         if (rangeOwner) {
             /** @type {any} */
             (props).__rangeExprScope = rangeOwner;

package/dist/src/scales/scaleResolution.d.ts

@@ -68,6 +68,22 @@ export default class ScaleResolution implements ScaleResolutionApi {
      * @returns {() => boolean}
      */
     registerMember(member: ScaleResolutionMember): () => boolean;
+    /**
+     * @param {import("../view/view.js").default} view
+     * @param {import("../spec/scale.js").Scale} config
+     */
+    attachViewLevelScaleConfig(view: import("../view/view.js").default, config: import("../spec/scale.js").Scale): void;
+    /**
+     * @param {import("../view/view.js").default} view
+     */
+    clearViewLevelScaleConfig(view: import("../view/view.js").default): void;
+    /**
+     * @returns {{ view: import("../view/view.js").default, config: import("../spec/scale.js").Scale } | undefined}
+     */
+    getViewLevelScaleConfig(): {
+        view: import("../view/view.js").default;
+        config: import("../spec/scale.js").Scale;
+    } | undefined;
     dispose(): void;
     /**
      * @param {import("../data/collector.js").default} collector
@@ -185,10 +201,10 @@ export default class ScaleResolution implements ScaleResolutionApi {
      * Immediately zooms to the given interval.
      *
      * @param {NumericDomain | ComplexDomain} domain
-     * @param {boolean | number} [duration] an approximate duration for transition.
-     *      Zero duration zooms immediately. Boolean `true` indicates a default duration.
+     * @param {import("../types/scaleResolutionApi.js").ZoomToOptions | boolean | number} [options]
+     *      Zoom options. Passing the duration directly as a boolean or number is deprecated.
      */
-    zoomTo(domain: import("../spec/scale.js").NumericDomain | import("../spec/scale.js").ComplexDomain, duration?: boolean | number): Promise<void>;
+    zoomTo(domain: import("../spec/scale.js").NumericDomain | import("../spec/scale.js").ComplexDomain, options?: import("../types/scaleResolutionApi.js").ZoomToOptions | boolean | number): Promise<void>;
     /**
      * Resets the current domain to the initial one
      *

package/dist/src/scales/scaleResolution.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaleResolution.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleResolution.js"],"names":[],"mappings":"AAoDA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH;IA6cI;;;;;;;;OAQG;IACH,uBALa,CAAC,eACH,QAAQ,CAAC,eAAe,CAAC,YACzB,MAAM,CAAC,GACL,CAAC,CAqBb;IAlaD;;;OAGG;IACH,sEAFW,OAAO,iBAAiB,EAAE,OAAO,EAsC3C;IAnCG,8CAAsB;IACtB,0FAA0F;IAC1F,MADW,OAAO,oBAAoB,EAAE,IAAI,CAC5B;IAEhB,iEAAiE;IACjE,MADW,MAAM,CACI;IA0EzB,2BASC;IAwBD;;;;;;;OAOG;IACH,4KAEC;IAED;;;OAGG;IACH,+KAEC;IAiCD,sCA6CC;IA+MD;;;OAGG;IACH,uBAHW,qBAAqB,GACnB,MAAM,OAAO,CAazB;IAED,gBAMC;IAoFD;;;;OAIG;IACH,0CAJW,OAAO,sBAAsB,EAAE,OAAO,aACtC,QAAQ,CAAC,OAAO,qBAAqB,EAAE,aAAa,CAAC,GACnD,MAAM,IAAI,CAkCtB;IAED;;OAEG;IACH,qCAEC;IAED,+BAiBC;IAuED;;;;;;;;;;;OAWG;IACH,0BALa;QACR,QAAQ,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;QACnE,oBAAoB,EAAE,OAAO,CAAA;KAC9B,CAeH;IAED;;;;;;;OAOG;IACH,wBAFa,OAAO,kBAAkB,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAShE;IAgGD;;;;;OAKG;IACH,oBAYC;IAED;;;;;OAKG;IACH,0BA0BC;IAoID;;OAEG;IACH;eAlhCkC,OAAO,kBAAkB,EAAE,KAAK;MAyhCjE;IAED;;;;;;OAMG;IACH;eAliCkC,OAAO,kBAAkB,EAAE,KAAK;MAyiCjE;IAED;;;;OAIG;IACH;eAhjCkC,OAAO,kBAAkB,EAAE,KAAK;MAyjCjE;IAED,mBASC;IAED;;;;OAIG;IACH,+DAEC;IAED;;OAEG;IACH,oBAFa,mFAA6B,CASzC;IAED;;OAEG;IACH;;;;MAqBC;IAED;;;;OAIG;IACH,oBAEC;IAED;;OAEG;IACH,sBASC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,eACN,MAAM,OACN,MAAM,GACJ,OAAO,CAInB;IAED;;;;;;OAMG;IACH,eAJW,mFAA6B,aAC7B,OAAO,GAAG,MAAM,iBAK1B;IAED;;;;OAIG;IACH,qBAEC;IAED;;;;;OAKG;IACH,uBAEC;IAED;;;;;;;OAOG;IACH,wBAoBC;IAED;;;;;OAKG;IACH,uBAFW,MAAM,yDAUhB;IAED;;OAEG;IACH,iBAFW,MAAM,yDAIhB;IAED;;;OAGG;IACH,qBAHW,MAAM,+CAAmB,GACvB,MAAM,CAIlB;IAED;;;OAGG;IACH,8BAHW,kFAA4B,GAC1B,MAAM,EAAE,CAOpB;;CACJ;kCAvyC+B,CAAC,SAApB,6CAAkB;;;;UAGrB,OAAO,qBAAqB,EAAE,OAAO;aACrC,CAAC;gBACD,OAAO,oBAAoB,EAAE,mBAAmB;yBAChD,OAAO;;sBApCV,+BAA+B;sBAA/B,+BAA+B;wBAA/B,+BAA+B;wBAA/B,+BAA+B;6BAA/B,+BAA+B"}
+{"version":3,"file":"scaleResolution.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleResolution.js"],"names":[],"mappings":"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"}

package/dist/src/scales/scaleResolution.js

@@ -15,6 +15,7 @@ import ScaleInstanceManager from "./scaleInstanceManager.js";
 import { resolveScalePropsBase } from "./scalePropsResolver.js";
 import DomainPlanner from "./domainPlanner.js";
 import ScaleInteractionController from "./scaleInteractionController.js";
+import { validateScaleTypeCompatibility } from "./scaleRules.js";
 import {
     INDEX,
     LOCUS,
@@ -24,11 +25,8 @@ import {
 } from "./scaleResolutionConstants.js";
 
 import { getAccessorDomainKey } from "../encoder/accessor.js";
-import {
-    isPrimaryPositionalChannel,
-    isSecondaryChannel,
-} from "../encoder/encoder.js";
-import { isExprRef } from "../paramRuntime/paramUtils.js";
+import { isSecondaryChannel } from "../encoder/encoder.js";
+import { collectConfiguredDomainExprRefs } from "./domainExpressions.js";
 import { NominalDomain } from "../utils/domainArray.js";
 import { shallowArrayEquals } from "../utils/arrayUtils.js";
 import createIndexer from "../utils/indexer.js";
@@ -143,6 +141,11 @@ export default class ScaleResolution {
     /** @type {import("../view/view.js").default | undefined} */
     #hostView;
 
+    /**
+     * @type {{ view: import("../view/view.js").default, config: import("../spec/scale.js").Scale } | undefined}
+     */
+    #viewLevelScaleConfig;
+
     #resolvingScaleProps = 0;
 
     #memberRegistrationBatchDepth = 0;
@@ -168,6 +171,8 @@ export default class ScaleResolution {
             getAllMembers: () => this.#members,
             getDataMembers: () =>
                 this.#getActiveMembers(this.#dataDomainMembers),
+            getViewLevelConfiguredDomain: () =>
+                this.#getViewLevelConfiguredDomain(),
             getType: () => this.type,
             getLocusExtent: (assembly) => this.#getLocusExtent(assembly),
             fromComplexInterval: this.fromComplexInterval.bind(this),
@@ -183,6 +188,7 @@ export default class ScaleResolution {
         this.#interactionController = new ScaleInteractionController({
             getScale: () => this.getScale(),
             getAnimator: () => this.#viewContext.animator,
+            renderImmediately: () => this.#viewContext.renderImmediately(),
             getInitialDomainSnapshot: () =>
                 this.#domainAggregator.initialDomainSnapshot,
             getResetDomain: () => this.#getConfiguredOrDefaultDomain(),
@@ -399,6 +405,10 @@ export default class ScaleResolution {
      * @returns {boolean}
      */
     #hasConfiguredDomain() {
+        if (this.#viewLevelScaleConfig?.config.domain !== undefined) {
+            return true;
+        }
+
         for (const member of this.#members) {
             if (
                 member.contributesToDomain &&
@@ -451,6 +461,8 @@ export default class ScaleResolution {
         const member = normalizeMember(newMember);
         const { channel, channelDef } = member;
 
+        this.#assertCanRegisterMember(member);
+
         // A convenience hack for cases where the new member should adapt
         // the scale type to the existing one. For example: SelectionRect
         // TODO: Add test
@@ -480,15 +492,12 @@ export default class ScaleResolution {
             explicitScaleType ??
             (type === INDEX || type === LOCUS ? type : undefined);
 
-        if (
-            effectiveScaleType &&
-            [INDEX, LOCUS].includes(effectiveScaleType) &&
-            !isPrimaryPositionalChannel(this.channel)
-        ) {
-            throw new Error(
-                `Index and locus scales are only supported on positional channels (x/y). Channel "${this.channel}" resolves to scale type "${effectiveScaleType}".`
-            );
-        }
+        validateScaleTypeCompatibility(
+            this.channel,
+            type,
+            effectiveScaleType,
+            `encoding.${channel}.scale.type`
+        );
 
         if (name) {
             if (this.name !== undefined && name != this.name) {
@@ -586,6 +595,100 @@ export default class ScaleResolution {
         };
     }
 
+    /**
+     * @param {import("../view/view.js").default} view
+     * @param {import("../spec/scale.js").Scale} config
+     */
+    attachViewLevelScaleConfig(view, config) {
+        if (
+            this.#viewLevelScaleConfig &&
+            this.#viewLevelScaleConfig.view !== view
+        ) {
+            throw new Error(
+                `Multiple view-level scale configs target the same ${this.channel} scale resolution.`
+            );
+        }
+
+        for (const member of this.#members) {
+            this.#assertMemberHasNoScaleConfig(member);
+        }
+
+        this.#viewLevelScaleConfig = { view, config };
+        this.#invalidateMergedScaleProps();
+        this.#invalidateConfiguredDomain();
+        this.#refreshSelectionDomainParamSubscriptions();
+        this.#refreshConfiguredDomainExprSubscriptions();
+        if (this.#scaleManager.scale) {
+            this.#scaleManager.resetScale();
+            this.initializeScale();
+        }
+    }
+
+    /**
+     * @param {import("../view/view.js").default} view
+     */
+    clearViewLevelScaleConfig(view) {
+        if (this.#viewLevelScaleConfig?.view === view) {
+            this.#viewLevelScaleConfig = undefined;
+            this.#invalidateMergedScaleProps();
+            this.#invalidateConfiguredDomain();
+            this.#refreshSelectionDomainParamSubscriptions();
+            this.#refreshConfiguredDomainExprSubscriptions();
+            if (this.#scaleManager.scale) {
+                this.#scaleManager.resetScale();
+                this.initializeScale();
+            }
+        }
+    }
+
+    /**
+     * @returns {{ view: import("../view/view.js").default, config: import("../spec/scale.js").Scale } | undefined}
+     */
+    getViewLevelScaleConfig() {
+        return this.#viewLevelScaleConfig;
+    }
+
+    #getViewLevelConfiguredDomain() {
+        const viewLevelScaleConfig = this.#viewLevelScaleConfig;
+        if (!viewLevelScaleConfig) {
+            return undefined;
+        }
+
+        return {
+            view: viewLevelScaleConfig.view,
+            channel:
+                /** @type {import("../spec/channel.js").ChannelWithScale} */ (
+                    this.channel
+                ),
+            type: this.type,
+            domain: viewLevelScaleConfig.config.domain,
+        };
+    }
+
+    /**
+     * @param {ScaleResolutionMember} member
+     */
+    #assertCanRegisterMember(member) {
+        if (!this.#viewLevelScaleConfig) {
+            return;
+        }
+
+        this.#assertMemberHasNoScaleConfig(member);
+    }
+
+    /**
+     * @param {ScaleResolutionMember} member
+     */
+    #assertMemberHasNoScaleConfig(member) {
+        if (member.channelDef.scale === undefined) {
+            return;
+        }
+
+        throw new Error(
+            `Cannot mix view-level scales.${this.channel} with encoding.${member.channel}.scale in the same scale resolution.`
+        );
+    }
+
     dispose() {
         this.#clearSelectionDomainParamSubscriptions();
         this.#clearConfiguredDomainExprSubscriptions();
@@ -657,11 +760,28 @@ export default class ScaleResolution {
                 continue;
             }
             const domain = member.channelDef.scale?.domain;
-            if (!isExprRef(domain)) {
+            const exprRefs = collectConfiguredDomainExprRefs(domain);
+            if (exprRefs.length === 0) {
                 continue;
             }
 
-            const expr = member.view.paramRuntime.createExpression(domain.expr);
+            for (const exprRef of exprRefs) {
+                const expr = member.view.paramRuntime.createExpression(
+                    exprRef.expr
+                );
+                const unsubscribe = expr.subscribe(listener);
+                this.#configuredDomainExprUnsubscribers.push(unsubscribe);
+            }
+        }
+
+        const viewLevelDomain = this.#viewLevelScaleConfig?.config.domain;
+        const viewLevelExprRefs =
+            collectConfiguredDomainExprRefs(viewLevelDomain);
+        for (const exprRef of viewLevelExprRefs) {
+            const expr =
+                this.#viewLevelScaleConfig.view.paramRuntime.createExpression(
+                    exprRef.expr
+                );
             const unsubscribe = expr.subscribe(listener);
             this.#configuredDomainExprUnsubscribers.push(unsubscribe);
         }
@@ -753,6 +873,7 @@ export default class ScaleResolution {
                 channel: this.channel,
                 dataType: this.type,
                 orderedMembers: this.#getOrderedMembers(),
+                viewLevelScaleConfig: this.#viewLevelScaleConfig,
                 isExplicitDomain: this.isDomainDefinedExplicitly(),
                 configScopes: this.#resolutionView.getConfigScopes(),
             });
@@ -1273,11 +1394,11 @@ export default class ScaleResolution {
      * Immediately zooms to the given interval.
      *
      * @param {NumericDomain | ComplexDomain} domain
-     * @param {boolean | number} [duration] an approximate duration for transition.
-     *      Zero duration zooms immediately. Boolean `true` indicates a default duration.
+     * @param {import("../types/scaleResolutionApi.js").ZoomToOptions | boolean | number} [options]
+     *      Zoom options. Passing the duration directly as a boolean or number is deprecated.
      */
-    async zoomTo(domain, duration = false) {
-        return this.#interactionController.zoomTo(domain, duration);
+    async zoomTo(domain, options = false) {
+        return this.#interactionController.zoomTo(domain, options);
     }
 
     /**

package/dist/src/scales/scaleRules.d.ts

@@ -7,6 +7,16 @@
  * @returns {import("../spec/scale.js").ScaleType}
  */
 export function getDefaultScaleType(channel: Channel, dataType: import("../spec/channel.js").Type): import("../spec/scale.js").ScaleType;
+/**
+ * Validates explicit scale type choices against the resolved data type and
+ * channel constraints.
+ *
+ * @param {Channel} channel
+ * @param {import("../spec/channel.js").Type} dataType
+ * @param {import("../spec/scale.js").ScaleType | undefined} scaleType
+ * @param {string} source
+ */
+export function validateScaleTypeCompatibility(channel: Channel, dataType: import("../spec/channel.js").Type, scaleType: import("../spec/scale.js").ScaleType | undefined, source: string): void;
 /**
  * @param {import("../spec/scale.js").Scale} props
  * @param {Channel} channel

package/dist/src/scales/scaleRules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaleRules.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleRules.js"],"names":[],"mappings":"AAcA;;GAEG;AAEH;;;;GAIG;AACH,6CAJW,OAAO,YACP,OAAO,oBAAoB,EAAE,IAAI,GAC/B,OAAO,kBAAkB,EAAE,SAAS,CA2EhD;AAED;;;GAGG;AACH,6CAHW,OAAO,kBAAkB,EAAE,KAAK,WAChC,OAAO,QAgBjB;sBArGY,OAAO,oBAAoB,EAAE,OAAO"}
+{"version":3,"file":"scaleRules.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleRules.js"],"names":[],"mappings":"AAcA;;GAEG;AAEH;;;;GAIG;AACH,6CAJW,OAAO,YACP,OAAO,oBAAoB,EAAE,IAAI,GAC/B,OAAO,kBAAkB,EAAE,SAAS,CA0EhD;AAED;;;;;;;;GAQG;AACH,wDALW,OAAO,YACP,OAAO,oBAAoB,EAAE,IAAI,aACjC,OAAO,kBAAkB,EAAE,SAAS,GAAG,SAAS,UAChD,MAAM,QA6BhB;AAED;;;GAGG;AACH,6CAHW,OAAO,kBAAkB,EAAE,KAAK,WAChC,OAAO,QAgBjB;sBA1IY,OAAO,oBAAoB,EAAE,OAAO"}

package/dist/src/scales/scaleRules.js

@@ -37,7 +37,6 @@ export function getDefaultScaleType(channel, dataType) {
         if (isPrimaryPositionalChannel(channel)) {
             return dataType;
         } else {
-            // TODO: Also explicitly set scales should be validated
             throw new Error(
                 channel +
                     " does not support " +
@@ -96,6 +95,44 @@ export function getDefaultScaleType(channel, dataType) {
     return type;
 }
 
+/**
+ * Validates explicit scale type choices against the resolved data type and
+ * channel constraints.
+ *
+ * @param {Channel} channel
+ * @param {import("../spec/channel.js").Type} dataType
+ * @param {import("../spec/scale.js").ScaleType | undefined} scaleType
+ * @param {string} source
+ */
+export function validateScaleTypeCompatibility(
+    channel,
+    dataType,
+    scaleType,
+    source
+) {
+    if (!scaleType) {
+        return;
+    }
+
+    if (
+        [INDEX, LOCUS].includes(scaleType) &&
+        !isPrimaryPositionalChannel(channel)
+    ) {
+        throw new Error(
+            `Index and locus scales are only supported on positional channels (x/y). Channel "${channel}" resolves to scale type "${scaleType}".`
+        );
+    }
+
+    if (
+        ([INDEX, LOCUS].includes(dataType) && scaleType !== dataType) ||
+        (scaleType === LOCUS && scaleType !== dataType)
+    ) {
+        throw new Error(
+            `${source} "${scaleType}" is incompatible with "${dataType}" data.`
+        );
+    }
+}
+
 /**
  * @param {import("../spec/scale.js").Scale} props
  * @param {Channel} channel

package/dist/src/scales/viewLevelScaleConfig.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @typedef {import("../spec/channel.js").ChannelWithScale} ChannelWithScale
+ * @typedef {import("../spec/scale.js").Scale} Scale
+ * @typedef {import("../view/view.js").default} View
+ * @typedef {import("./scaleResolution.js").default} ScaleResolution
+ *
+ * @typedef {object} ViewLevelScaleConfigMapping
+ * @prop {View} view
+ * @prop {ChannelWithScale} channel
+ * @prop {Scale} config
+ * @prop {ScaleResolution | undefined} resolution
+ */
+/**
+ * Maps view-level scale configs to the unique scale resolution visible from
+ * each configured subtree. Configs with no matching resolution stay pending.
+ *
+ * @param {View} root
+ * @returns {ViewLevelScaleConfigMapping[]}
+ */
+export function mapViewLevelScaleConfigs(root: View): ViewLevelScaleConfigMapping[];
+/**
+ * Maps view-level scale configs and attaches non-pending configs to their
+ * target resolutions.
+ *
+ * @param {View} root
+ * @returns {ViewLevelScaleConfigMapping[]}
+ */
+export function attachViewLevelScaleConfigs(root: View): ViewLevelScaleConfigMapping[];
+/**
+ * Clears view-level scale configs owned by views in the subtree.
+ *
+ * @param {View} root
+ */
+export function clearViewLevelScaleConfigs(root: View): void;
+export type ChannelWithScale = import("../spec/channel.js").ChannelWithScale;
+export type Scale = import("../spec/scale.js").Scale;
+export type View = import("../view/view.js").default;
+export type ScaleResolution = import("./scaleResolution.js").default;
+export type ViewLevelScaleConfigMapping = {
+    view: View;
+    channel: ChannelWithScale;
+    config: Scale;
+    resolution: ScaleResolution | undefined;
+};
+//# sourceMappingURL=viewLevelScaleConfig.d.ts.map

package/dist/src/scales/viewLevelScaleConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewLevelScaleConfig.d.ts","sourceRoot":"","sources":["../../../src/scales/viewLevelScaleConfig.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;GAMG;AACH,+CAHW,IAAI,GACF,2BAA2B,EAAE,CAwBzC;AAED;;;;;;GAMG;AACH,kDAHW,IAAI,GACF,2BAA2B,EAAE,CAczC;AAED;;;;GAIG;AACH,iDAFW,IAAI,QAYd;+BA/EY,OAAO,oBAAoB,EAAE,gBAAgB;oBAC7C,OAAO,kBAAkB,EAAE,KAAK;mBAChC,OAAO,iBAAiB,EAAE,OAAO;8BACjC,OAAO,sBAAsB,EAAE,OAAO;;UAGzC,IAAI;aACJ,gBAAgB;YAChB,KAAK;gBACL,eAAe,GAAG,SAAS"}