@genome-spy/core 0.73.0 → 0.75.0

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

@@ -0,0 +1,29 @@
+/**
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @returns {boolean}
+ */
+export function isIndexLikeDomainType(type: import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType): boolean;
+/**
+ * Converts a numeric user-facing inclusive interval into the internal half-open
+ * form used by index-like scales.
+ *
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+export function toInternalIndexLikeInterval(type: import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType, interval: number[]): number[];
+/**
+ * Converts an internal half-open interval into a user-facing inclusive form.
+ *
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+export function toExternalIndexLikeInterval(type: import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType, interval: number[]): number[];
+/**
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[] | undefined} interval
+ * @returns {number[] | undefined}
+ */
+export function toInternalIndexLikeDataDomain(type: import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType, interval: number[] | undefined): number[] | undefined;
+//# sourceMappingURL=indexLikeDomainUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexLikeDomainUtils.d.ts","sourceRoot":"","sources":["../../../src/scales/indexLikeDomainUtils.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,IAAI,GAAG,OAAO,kBAAkB,EAAE,SAAS,GACtE,OAAO,CAInB;AAED;;;;;;;GAOG;AACH,kDAJW,OAAO,oBAAoB,EAAE,IAAI,GAAG,OAAO,kBAAkB,EAAE,SAAS,YACxE,MAAM,EAAE,GACN,MAAM,EAAE,CAIpB;AAED;;;;;;GAMG;AACH,kDAJW,OAAO,oBAAoB,EAAE,IAAI,GAAG,OAAO,kBAAkB,EAAE,SAAS,YACxE,MAAM,EAAE,GACN,MAAM,EAAE,CAIpB;AAED;;;;GAIG;AACH,oDAJW,OAAO,oBAAoB,EAAE,IAAI,GAAG,OAAO,kBAAkB,EAAE,SAAS,YACxE,MAAM,EAAE,GAAG,SAAS,GAClB,MAAM,EAAE,GAAG,SAAS,CAMhC"}

package/dist/src/scales/indexLikeDomainUtils.js

@@ -0,0 +1,67 @@
+import { INDEX, LOCUS } from "./scaleResolutionConstants.js";
+
+/**
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @returns {boolean}
+ */
+export function isIndexLikeDomainType(type) {
+    return type === INDEX || type === LOCUS;
+}
+
+/**
+ * Converts a numeric user-facing inclusive interval into the internal half-open
+ * form used by index-like scales.
+ *
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+export function toInternalIndexLikeInterval(type, interval) {
+    return isIndexLikeDomainType(type) ? expandUpperBound(interval) : interval;
+}
+
+/**
+ * Converts an internal half-open interval into a user-facing inclusive form.
+ *
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+export function toExternalIndexLikeInterval(type, interval) {
+    return isIndexLikeDomainType(type) ? shrinkUpperBound(interval) : interval;
+}
+
+/**
+ * @param {import("../spec/channel.js").Type | import("../spec/scale.js").ScaleType} type
+ * @param {number[] | undefined} interval
+ * @returns {number[] | undefined}
+ */
+export function toInternalIndexLikeDataDomain(type, interval) {
+    return interval && isIndexLikeDomainType(type)
+        ? expandUpperBound(interval)
+        : interval;
+}
+
+/**
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+function expandUpperBound(interval) {
+    return [interval[0], interval[1] + getDirection(interval)];
+}
+
+/**
+ * @param {number[]} interval
+ * @returns {number[]}
+ */
+function shrinkUpperBound(interval) {
+    return [interval[0], interval[1] - getDirection(interval)];
+}
+
+/**
+ * @param {number[]} interval
+ * @returns {1 | -1}
+ */
+function getDirection(interval) {
+    return interval[1] >= interval[0] ? 1 : -1;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * Stable ordering for resolution members so merge behavior does not depend on
+ * registration order.
+ *
+ * @template {{ view: { getPathString(): string }, channel?: string }} T
+ * @param {Set<T> | Iterable<T>} members
+ * @returns {T[]}
+ */
+export function orderResolutionMembers<T extends {
+    view: {
+        getPathString(): string;
+    };
+    channel?: string;
+}>(members: Set<T> | Iterable<T>): T[];
+//# sourceMappingURL=resolutionMemberOrder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolutionMemberOrder.d.ts","sourceRoot":"","sources":["../../../src/scales/resolutionMemberOrder.js"],"names":[],"mappings":"AASA;;;;;;;GAOG;AACH,uCAJuE,CAAC,SAA3D;IAAG,IAAI,EAAE;QAAE,aAAa,IAAI,MAAM,CAAA;KAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAG,WAC3D,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,GAClB,CAAC,EAAE,CAMf"}

package/dist/src/scales/resolutionMemberOrder.js

@@ -0,0 +1,22 @@
+/**
+ * @param {{ view: { getPathString(): string }, channel?: string }} member
+ */
+function memberKey(member) {
+    const path = member.view.getPathString();
+    const channel = member.channel ?? "";
+    return path + "|" + channel;
+}
+
+/**
+ * Stable ordering for resolution members so merge behavior does not depend on
+ * registration order.
+ *
+ * @template {{ view: { getPathString(): string }, channel?: string }} T
+ * @param {Set<T> | Iterable<T>} members
+ * @returns {T[]}
+ */
+export function orderResolutionMembers(members) {
+    return Array.from(members).sort((a, b) =>
+        memberKey(a).localeCompare(memberKey(b))
+    );
+}

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

@@ -1 +1 @@
-{"version":3,"file":"scaleInstanceManager.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleInstanceManager.js"],"names":[],"mappings":"AAMA;IA0BI;;;;;;OAMG;IACH,iFALG;QAAkH,eAAe,EAAzH,MAAM;YAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,0BAA0B,EAAE,eAAe,CAAA;SAAE;QAC5E,aAAa,EAAjC,MAAM,IAAI;QACW,cAAc,GAAnC,MAAM,IAAI;QAC6D,cAAc,GAArF,MAAM,OAAO,0BAA0B,EAAE,OAAO,GAAG,SAAS;KAA0B,EAYhG;IAED;eA1CkC,OAAO,kBAAkB,EAAE,KAAK;MA4CjE;IAED;;;OAGG;IACH,0BAHW,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAC1C,OAAO,qBAAqB,EAAE,OAAO,CAajD;IAED;;;OAGG;IACH,mBAHW,OAAO,kBAAkB,EAAE,KAAK;eAhET,OAAO,kBAAkB,EAAE,KAAK;MAqFjE;IAcD;;OAEG;IACH,wBAFW,OAAO,kBAAkB,EAAE,KAAK,QAc1C;IAED;;;OAGG;IACH,4CAHW,MAAM,IAAI,GACR,IAAI,CAShB;IAmFD,gBAGC;;CACJ"}
+{"version":3,"file":"scaleInstanceManager.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleInstanceManager.js"],"names":[],"mappings":"AAMA;IA0BI;;;;;;OAMG;IACH,iFALG;QAAkH,eAAe,EAAzH,MAAM;YAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,0BAA0B,EAAE,eAAe,CAAA;SAAE;QAC5E,aAAa,EAAjC,MAAM,IAAI;QACW,cAAc,GAAnC,MAAM,IAAI;QAC6D,cAAc,GAArF,MAAM,OAAO,0BAA0B,EAAE,OAAO,GAAG,SAAS;KAA0B,EAYhG;IAED;eA1CkC,OAAO,kBAAkB,EAAE,KAAK;MA4CjE;IAED;;;OAGG;IACH,0BAHW,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAC1C,OAAO,qBAAqB,EAAE,OAAO,CAajD;IAED;;;OAGG;IACH,mBAHW,OAAO,kBAAkB,EAAE,KAAK;eAhET,OAAO,kBAAkB,EAAE,KAAK;MAqFjE;IAcD;;OAEG;IACH,wBAFW,OAAO,kBAAkB,EAAE,KAAK,QAc1C;IAED;;;OAGG;IACH,4CAHW,MAAM,IAAI,GACR,IAAI,CAShB;IAwFD,gBAGC;;CACJ"}

package/dist/src/scales/scaleInstanceManager.js

@@ -147,10 +147,12 @@ export default class ScaleInstanceManager {
         const {
             assembly: _assembly,
             domainIndexer: _domainIndexer,
+            __rangeExprScope: _rangeExprScope,
             ...rest
         } = propsAny;
         void _assembly;
         void _domainIndexer;
+        void _rangeExprScope;
         return rest;
     }
 
@@ -168,11 +170,14 @@ export default class ScaleInstanceManager {
         this.#rangeExprRefListeners.forEach((fn) => fn.invalidate());
         this.#rangeExprRefListeners.clear();
 
+        const rangeExprScope = /** @type {any} */ (props).__rangeExprScope;
+        const paramRuntime =
+            rangeExprScope?.paramRuntime ?? this.#getParamRuntime();
+
         const resolved = resolveRange({
             range: props.range,
             reverse: props.reverse,
-            createExpression: (expr) =>
-                this.#getParamRuntime().createExpression(expr),
+            createExpression: (expr) => paramRuntime.createExpression(expr),
             registerExpr: (fn) => this.#rangeExprRefListeners.add(fn),
         });
 

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

@@ -1 +1 @@
-{"version":3,"file":"scaleInteractionController.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleInteractionController.js"],"names":[],"mappings":"AAkBA;;;;;;;GAOG;AAEH;IAsBI;;;;;;;;OAQG;IACH,wHAPG;QAAsC,QAAQ,EAAtC,MAAM,cAAc;QACkC,WAAW,EAAjE,MAAM,OAAO,sBAAsB,EAAE,OAAO;QACpB,wBAAwB,EAAhD,MAAM,MAAM,EAAE;QACU,cAAc,EAAtC,MAAM,MAAM,EAAE;QAC8C,mBAAmB,EAA/E,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,KAAK,MAAM,EAAE;QAC1B,eAAe,EAAvC,MAAM,MAAM,EAAE;KACxB,EAeA;IAED,0BAUC;IAED,sBAEC;IAED,8BAGC;IAED;;;;OAIG;IACH,sCAJW,MAAM,EAAE,aACR,MAAM,EAAE,GACN,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAarD;IAED;;;;OAIG;IACH,oBAQC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,eACN,MAAM,OACN,MAAM,GACJ,OAAO,CA2BnB;IAED;;;;;;OAMG;IACH,eAJW,aAAa,GAAG,aAAa,aAC7B,OAAO,GAAG,MAAM,iBA+D1B;IASD;;;;OAIG;IACH,qBAcC;IAED;;OAEG;IACH,uBAOC;;CACJ;4BA5PY,OAAO,kBAAkB,EAAE,aAAa;2BACxC,OAAO,kBAAkB,EAAE,YAAY;4BACvC,OAAO,kBAAkB,EAAE,aAAa;yBACxC,OAAO,kBAAkB,EAAE,UAAU;wBACrC,OAAO,qBAAqB,EAAE,SAAS;6BACvC,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAA;CAAE"}
+{"version":3,"file":"scaleInteractionController.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleInteractionController.js"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AAEH;IAsBI;;;;;;;;OAQG;IACH,wHAPG;QAAsC,QAAQ,EAAtC,MAAM,cAAc;QACkC,WAAW,EAAjE,MAAM,OAAO,sBAAsB,EAAE,OAAO;QACpB,wBAAwB,EAAhD,MAAM,MAAM,EAAE;QACU,cAAc,EAAtC,MAAM,MAAM,EAAE;QAC8C,mBAAmB,EAA/E,CAAC,MAAM,EAAE,YAAY,GAAG,aAAa,KAAK,MAAM,EAAE;QAC1B,eAAe,EAAvC,MAAM,MAAM,EAAE;KACxB,EAeA;IAED,0BAUC;IAED,sBAEC;IAED,8BAGC;IAED;;;;OAIG;IACH,sCAJW,MAAM,EAAE,aACR,MAAM,EAAE,GACN,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAarD;IAED;;;;OAIG;IACH,oBAQC;IAED;;;;;;;OAOG;IACH,kBALW,MAAM,eACN,MAAM,OACN,MAAM,GACJ,OAAO,CA2BnB;IAED;;;;;;OAMG;IACH,eAJW,aAAa,GAAG,aAAa,aAC7B,OAAO,GAAG,MAAM,iBAkE1B;IASD;;;;OAIG;IACH,qBAcC;IAED;;OAEG;IACH,uBAOC;;CACJ;4BA/PY,OAAO,kBAAkB,EAAE,aAAa;2BACxC,OAAO,kBAAkB,EAAE,YAAY;4BACvC,OAAO,kBAAkB,EAAE,aAAa;yBACxC,OAAO,kBAAkB,EAAE,UAAU;wBACrC,OAAO,qBAAqB,EAAE,SAAS;6BACvC,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAA;CAAE"}

package/dist/src/scales/scaleInteractionController.js

@@ -15,6 +15,11 @@ import eerp from "../utils/eerp.js";
 import { shallowArrayEquals } from "../utils/arrayUtils.js";
 import { createCancelToken } from "../utils/transition.js";
 import { zoomDomainByScaleType } from "./zoomDomainUtils.js";
+import { toInternalIndexLikeInterval } from "./indexLikeDomainUtils.js";
+import {
+    hasExplicitLocusUpperBound,
+    isChromosomalLocusInterval,
+} from "../genome/genome.js";
 
 /**
  * @typedef {import("../spec/scale.js").NumericDomain} NumericDomain
@@ -177,13 +182,16 @@ export default class ScaleInteractionController {
             throw new Error("Not a zoomable scale!");
         }
 
-        const to = this.#fromComplexInterval(domain);
+        const scale = this.#getScale();
+        const to = normalizeInteractionInterval(
+            /** @type {import("../spec/scale.js").ScaleType} */ (scale.type),
+            domain,
+            this.#fromComplexInterval
+        );
 
         // TODO: Intersect the domain with zoom extent
 
         const animator = this.#getAnimator();
-
-        const scale = this.#getScale();
         const from = /** @type {number[]} */ (scale.domain());
 
         if (duration > 0 && from.length == 2) {
@@ -288,7 +296,11 @@ function resolveZoomExtent(
 ) {
     if (isZoomParams(zoom)) {
         if (isArray(zoom.extent)) {
-            return fromComplexInterval(zoom.extent);
+            return normalizeInteractionInterval(
+                scale.props.type,
+                zoom.extent,
+                fromComplexInterval
+            );
         }
     }
 
@@ -362,6 +374,33 @@ function applyZoomTransform(scale, domain, scaleFactor, scaleAnchor, pan) {
     );
 }
 
+/**
+ * Converts a user-facing interaction interval into the internal numeric domain
+ * representation used by index-like scales.
+ *
+ * @param {import("../spec/scale.js").ScaleType} type
+ * @param {ScalarDomain | ComplexDomain} interval
+ * @param {(domain: ScalarDomain | ComplexDomain) => number[]} fromComplexInterval
+ * @returns {number[]}
+ */
+function normalizeInteractionInterval(type, interval, fromComplexInterval) {
+    const numericInterval =
+        type === "locus"
+            ? fromComplexInterval(interval)
+            : /** @type {number[]} */ (interval);
+
+    // Whole-chromosome locus intervals already resolve to the intended extent.
+    if (
+        type === "locus" &&
+        isChromosomalLocusInterval(interval) &&
+        !hasExplicitLocusUpperBound(interval)
+    ) {
+        return numericInterval;
+    }
+
+    return toInternalIndexLikeInterval(type, numericInterval);
+}
+
 /**
  * @param {boolean | ZoomParams} zoom
  * @returns {zoom is ZoomParams}

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

@@ -7,15 +7,17 @@
  * @param {object} options
  * @param {Channel} options.channel
  * @param {import("../spec/channel.js").Type} options.dataType
- * @param {Set<ScaleResolutionMember>} options.members
+ * @param {ScaleResolutionMember[]} options.orderedMembers
  * @param {boolean} options.isExplicitDomain
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} options.configScopes
  * @returns {Scale}
  */
-export function resolveScalePropsBase({ channel, dataType, members, isExplicitDomain, }: {
+export function resolveScalePropsBase({ channel, dataType, orderedMembers, isExplicitDomain, configScopes, }: {
     channel: Channel;
     dataType: import("../spec/channel.js").Type;
-    members: Set<ScaleResolutionMember>;
+    orderedMembers: ScaleResolutionMember[];
     isExplicitDomain: boolean;
+    configScopes: import("../spec/config.js").GenomeSpyConfig[];
 }): Scale;
 export type Channel = import("../spec/channel.js").Channel;
 export type Scale = import("../spec/scale.js").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":"AAOA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,yFANG;IAAyB,OAAO,EAAxB,OAAO;IACoC,QAAQ,EAAnD,OAAO,oBAAoB,EAAE,IAAI;IACG,OAAO,EAA3C,GAAG,CAAC,qBAAqB,CAAC;IACT,gBAAgB,EAAjC,OAAO;CACf,GAAU,KAAK,CAiDjB;sBA5DY,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":"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"}

package/dist/src/scales/scalePropsResolver.js

@@ -1,7 +1,14 @@
 import { isDiscrete } from "vega-scale";
+import { isColorChannel } from "../encoder/encoder.js";
+import { isExprRef } from "../paramRuntime/paramUtils.js";
 
 import mergeObjects from "../utils/mergeObjects.js";
-import { getDefaultScaleProperties } from "../config/scaleDefaults.js";
+import {
+    getConfiguredScaleConfig,
+    getConfiguredScaleDefaults,
+    getConfiguredNamedRange,
+    isConfigRangeName,
+} from "../config/scaleConfig.js";
 import { applyLockedProperties, getDefaultScaleType } from "./scaleRules.js";
 import { INDEX, LOCUS } from "./scaleResolutionConstants.js";
 
@@ -15,17 +22,29 @@ import { INDEX, LOCUS } from "./scaleResolutionConstants.js";
  * @param {object} options
  * @param {Channel} options.channel
  * @param {import("../spec/channel.js").Type} options.dataType
- * @param {Set<ScaleResolutionMember>} options.members
+ * @param {ScaleResolutionMember[]} options.orderedMembers
  * @param {boolean} options.isExplicitDomain
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} options.configScopes
  * @returns {Scale}
  */
 export function resolveScalePropsBase({
     channel,
     dataType,
-    members,
+    orderedMembers,
     isExplicitDomain,
+    configScopes,
 }) {
-    const propArray = Array.from(members)
+    const memberList = orderedMembers;
+
+    const markTypes = memberList
+        .map((member) =>
+            typeof member.view.getMarkType == "function"
+                ? member.view.getMarkType()
+                : undefined
+        )
+        .filter((markType) => !!markType);
+
+    const propArray = memberList
         .map((member) => member.channelDef.scale)
         .filter((props) => props !== undefined);
 
@@ -36,14 +55,68 @@ export function resolveScalePropsBase({
     }
 
     const props = {
-        ...getDefaultScaleProperties(channel, dataType, isExplicitDomain),
+        ...getConfiguredScaleDefaults(configScopes, {
+            channel,
+            dataType,
+            isExplicitDomain,
+            markTypes: /** @type {import("../spec/mark.js").MarkType[]} */ (
+                markTypes
+            ),
+            hasDomainMid: mergedProps.domainMid !== undefined,
+        }),
         ...mergedProps,
     };
 
     if (!props.type) {
+        // TODO: When discrete positional scale inference is revisited, plumb
+        // mark-level context into getDefaultScaleType instead of deciding only
+        // from channel + data type. The `markTypes` collection above is the
+        // natural starting point for a Vega-Lite-like band-vs-point choice,
+        // including future rect-backed marks such as "bar".
         props.type = getDefaultScaleType(channel, dataType);
     }
 
+    if (typeof props.range == "string") {
+        if (!isConfigRangeName(props.range)) {
+            throw new Error(
+                'Unknown named scale range "' +
+                    props.range +
+                    '". Supported names: shape, size, angle, heatmap, ramp, diverging.'
+            );
+        }
+
+        const resolvedNamedRange = getConfiguredNamedRange(
+            configScopes,
+            props.range
+        );
+        if (resolvedNamedRange === undefined) {
+            throw new Error(
+                'Named scale range "' +
+                    props.range +
+                    '" is not configured in config.range.'
+            );
+        }
+
+        if (
+            isColorChannel(channel) &&
+            (typeof resolvedNamedRange == "string" ||
+                (resolvedNamedRange != null &&
+                    typeof resolvedNamedRange == "object" &&
+                    !Array.isArray(resolvedNamedRange)))
+        ) {
+            props.scheme =
+                /** @type {import("../spec/scale.js").Scale["scheme"]} */ (
+                    resolvedNamedRange
+                );
+            delete props.range;
+        } else {
+            props.range =
+                /** @type {import("../spec/scale.js").Scale["range"]} */ (
+                    resolvedNamedRange
+                );
+        }
+    }
+
     // Reverse discrete y axis
     if (
         channel == "y" &&
@@ -58,9 +131,36 @@ export function resolveScalePropsBase({
         // TODO: Props should be set more intelligently
     }
 
-    // By default, index and locus scales are zoomable, others are not
-    if (!("zoom" in props) && [INDEX, LOCUS].includes(props.type)) {
-        props.zoom = true;
+    if (props.domainTransition === undefined) {
+        const hasExprDrivenDomain = memberList.some((member) =>
+            isExprRef(member.channelDef.scale?.domain)
+        );
+        props.domainTransition = !hasExprDrivenDomain;
+    }
+
+    if (
+        Array.isArray(props.range) &&
+        props.range.some(isExprRef) &&
+        memberList.length > 0
+    ) {
+        const rangeOwner = memberList.find(
+            (member) => member.channelDef.scale?.range !== undefined
+        )?.view;
+        if (rangeOwner) {
+            /** @type {any} */
+            (props).__rangeExprScope = rangeOwner;
+        }
+    }
+
+    // By default, index and locus scales are zoomable, others are not.
+    // Config can override this baseline via scale.zoom.
+    if (!("zoom" in props)) {
+        const scaleConfig = getConfiguredScaleConfig(configScopes, dataType);
+        if (scaleConfig.zoom !== undefined) {
+            props.zoom = scaleConfig.zoom;
+        } else if ([INDEX, LOCUS].includes(props.type)) {
+            props.zoom = true;
+        }
     }
 
     applyLockedProperties(props, channel);

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

@@ -27,10 +27,21 @@
  * @implements {ScaleResolutionApi}
  */
 export default class ScaleResolution implements ScaleResolutionApi {
+    /**
+     * Executes a group of member registrations without refreshing derived
+     * membership state until the callback completes.
+     *
+     * @template T
+     * @param {Iterable<ScaleResolution>} resolutions
+     * @param {() => T} callback
+     * @returns {T}
+     */
+    static registerInBatch<T>(resolutions: Iterable<ScaleResolution>, callback: () => T): T;
     /**
      * @param {Channel} channel
+     * @param {import("../view/view.js").default} [hostView]
      */
-    constructor(channel: import("../spec/channel.js").Channel);
+    constructor(channel: import("../spec/channel.js").Channel, hostView?: import("../view/view.js").default);
     channel: import("../spec/channel.js").Channel;
     /** @type {import("../spec/channel.js").Type} Data type (quantitative, nominal, etc...) */
     type: import("../spec/channel.js").Type;
@@ -51,6 +62,7 @@ export default class ScaleResolution implements ScaleResolutionApi {
      * @param {ScaleResolutionListener} listener function
      */
     removeEventListener(type: import("../types/scaleResolutionApi.js").ScaleResolutionEventType, listener: import("../types/scaleResolutionApi.js").ScaleResolutionListener): void;
+    syncLinkedSelectionFromDomain(): void;
     /**
      * @param {ScaleResolutionMember} member
      * @returns {() => boolean}
@@ -63,6 +75,11 @@ export default class ScaleResolution implements ScaleResolutionApi {
      * @returns {() => void}
      */
     registerCollectorSubscriptions(collector: import("../data/collector.js").default, accessors: Iterable<import("../types/encoder.js").ScaleAccessor>): () => void;
+    /**
+     * Returns true if the domain has been defined explicitly, i.e. not extracted from the data.
+     */
+    isDomainDefinedExplicitly(): boolean;
+    isDomainInitialized(): boolean;
     /**
      * Returns locus assembly requirements without initializing the scale.
      *
@@ -79,6 +96,15 @@ export default class ScaleResolution implements ScaleResolutionApi {
         assembly: import("../spec/scale.js").Scale["assembly"] | undefined;
         needsDefaultAssembly: boolean;
     };
+    /**
+     * Returns the resolved scale type without instantiating the scale.
+     *
+     * Useful during view construction, before assembly preflight has loaded
+     * URL-backed locus genomes.
+     *
+     * @returns {import("../spec/scale.js").Scale["type"] | undefined}
+     */
+    getResolvedScaleType(): import("../spec/scale.js").Scale["type"] | undefined;
     /**
      * Reconfigures the scale: updates domain and other settings.
      *
@@ -128,6 +154,14 @@ export default class ScaleResolution implements ScaleResolutionApi {
      * @returns {NumericDomain | ComplexDomain}
      */
     getComplexDomain(): import("../spec/scale.js").NumericDomain | import("../spec/scale.js").ComplexDomain;
+    /**
+     * Returns metadata about a selection-linked domain, if present.
+     */
+    getLinkedSelectionDomainInfo(): {
+        param: string;
+        encoding: "x" | "y";
+        persist: boolean;
+    };
     /**
      * Return true if the scale is zoomable and the current domain differs from the initial domain.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"scaleResolution.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleResolution.js"],"names":[],"mappings":"AAgDA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAmDI;;OAEG;IACH,2DAkCC;IAjCG,8CAAsB;IACtB,0FAA0F;IAC1F,MADW,OAAO,oBAAoB,EAAE,IAAI,CAC5B;IAEhB,iEAAiE;IACjE,MADW,MAAM,CACI;IAoEzB,2BASC;IAwBD;;;;;;;OAOG;IACH,4KAEC;IAED;;;OAGG;IACH,+KAEC;IAkLD;;;OAGG;IACH,uBAHW,qBAAqB,GACnB,MAAM,OAAO,CAazB;IAED,gBAKC;IA4CD;;;;OAIG;IACH,0CAJW,OAAO,sBAAsB,EAAE,OAAO,aACtC,QAAQ,CAAC,OAAO,qBAAqB,EAAE,aAAa,CAAC,GACnD,MAAM,IAAI,CAkCtB;IA2CD;;;;;;;;;;;OAWG;IACH,0BALa;QACR,QAAQ,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC;QACnE,oBAAoB,EAAE,OAAO,CAAA;KAC9B,CAeH;IAmFD;;;;;OAKG;IACH,oBAYC;IAED;;;;;OAKG;IACH,0BAyBC;IA0HD;;OAEG;IACH;eApwBkC,OAAO,kBAAkB,EAAE,KAAK;MA2wBjE;IAED;;;;;;OAMG;IACH;eApxBkC,OAAO,kBAAkB,EAAE,KAAK;MAsxBjE;IAED;;;;OAIG;IACH;eA7xBkC,OAAO,kBAAkB,EAAE,KAAK;MAsyBjE;IAED,mBAEC;IAED;;;;OAIG;IACH,+DAEC;IAED;;OAEG;IACH,oBAFa,mFAA6B,CAMzC;IAED;;;;OAIG;IACH,oBAEC;IAED;;OAEG;IACH,sBAGC;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;kCA1+B+B,CAAC,SAApB,6CAAkB;;;;UAGrB,OAAO,qBAAqB,EAAE,OAAO;aACrC,CAAC;gBACD,OAAO,oBAAoB,EAAE,mBAAmB;yBAChD,OAAO;;sBAhCV,+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":"AAoDA;;;;;;;;GAQG;AACH;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAucI;;;;;;;;OAQG;IACH,uBALa,CAAC,eACH,QAAQ,CAAC,eAAe,CAAC,YACzB,MAAM,CAAC,GACL,CAAC,CAqBb;IA5ZD;;;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,sCA0CC;IA4MD;;;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;eA5gCkC,OAAO,kBAAkB,EAAE,KAAK;MAmhCjE;IAED;;;;;;OAMG;IACH;eA5hCkC,OAAO,kBAAkB,EAAE,KAAK;MAmiCjE;IAED;;;;OAIG;IACH;eA1iCkC,OAAO,kBAAkB,EAAE,KAAK;MAmjCjE;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;kCAjyC+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"}