@genome-spy/core 0.76.0 → 0.78.0

package/dist/src/paramRuntime/embedParamApi.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @typedef {import("../view/view.js").default} View
+ * @typedef {import("../spec/parameter.js").Parameter} Parameter
+ * @typedef {import("../types/embedApi.js").ParamApi} ParamApi
+ */
+/**
+ * Returns a parameter handle for an explicit parameter exposed by the embed API.
+ *
+ * Current limitations:
+ *
+ * - Parameters are addressed by name only. Independent same-name parameters
+ *   throw an ambiguity error.
+ * - Computed `expr` parameters are readable but cannot be written.
+ * - Point selection parameters are readable but cannot be written through this
+ *   API because valid values require GenomeSpy-generated datum ids.
+ * - Projected selections are not supported.
+ *
+ * @param {View} root
+ * @param {string} name
+ * @returns {ParamApi}
+ */
+export function resolveEmbedParam(root: View, name: string): ParamApi;
+export type View = import("../view/view.js").default;
+export type Parameter = import("../spec/parameter.js").Parameter;
+export type ParamApi = import("../types/embedApi.js").ParamApi;
+//# sourceMappingURL=embedParamApi.d.ts.map

package/dist/src/paramRuntime/embedParamApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedParamApi.d.ts","sourceRoot":"","sources":["../../../src/paramRuntime/embedParamApi.js"],"names":[],"mappings":"AAKA;;;;GAIG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,wCAJW,IAAI,QACJ,MAAM,GACJ,QAAQ,CA8DpB;mBAjFY,OAAO,iBAAiB,EAAE,OAAO;wBACjC,OAAO,sBAAsB,EAAE,SAAS;uBACxC,OAAO,sBAAsB,EAAE,QAAQ"}

package/dist/src/paramRuntime/embedParamApi.js

@@ -0,0 +1,133 @@
+import {
+    asSelectionConfig,
+    isPointSelectionConfig,
+} from "../selection/selection.js";
+
+/**
+ * @typedef {import("../view/view.js").default} View
+ * @typedef {import("../spec/parameter.js").Parameter} Parameter
+ * @typedef {import("../types/embedApi.js").ParamApi} ParamApi
+ */
+
+/**
+ * Returns a parameter handle for an explicit parameter exposed by the embed API.
+ *
+ * Current limitations:
+ *
+ * - Parameters are addressed by name only. Independent same-name parameters
+ *   throw an ambiguity error.
+ * - Computed `expr` parameters are readable but cannot be written.
+ * - Point selection parameters are readable but cannot be written through this
+ *   API because valid values require GenomeSpy-generated datum ids.
+ * - Projected selections are not supported.
+ *
+ * @param {View} root
+ * @param {string} name
+ * @returns {ParamApi}
+ */
+export function resolveEmbedParam(root, name) {
+    const matches = collectParamMatches(root, name);
+    if (!matches.length) {
+        throw new Error('Parameter "' + name + '" not found.');
+    }
+
+    const effectiveMatches = new Map();
+    for (const match of matches) {
+        const runtime = match.view.paramRuntime.findRuntimeForParam(name);
+        if (!runtime) {
+            throw new Error('Parameter "' + name + '" has no runtime value.');
+        }
+
+        effectiveMatches.set(runtime, {
+            runtime,
+            readOnly: hasExprParam(effectiveMatches.get(runtime), match),
+            pointSelection: hasPointSelectionParam(
+                effectiveMatches.get(runtime),
+                match
+            ),
+        });
+    }
+
+    if (effectiveMatches.size > 1) {
+        throw new Error('Parameter "' + name + '" is ambiguous.');
+    }
+
+    const { runtime, readOnly, pointSelection } = effectiveMatches
+        .values()
+        .next().value;
+
+    return {
+        getValue() {
+            return runtime.getValue(name);
+        },
+
+        setValue(value) {
+            if (readOnly) {
+                throw new Error(
+                    'Cannot set computed parameter "' + name + '".'
+                );
+            }
+            if (pointSelection) {
+                throw new Error(
+                    'Cannot set point selection parameter "' +
+                        name +
+                        '" through the embed API.'
+                );
+            }
+
+            runtime.setValue(name, value);
+            root.context.animator.requestRender();
+        },
+
+        subscribe(listener) {
+            return runtime.subscribe(name, () => {
+                listener(runtime.getValue(name));
+            });
+        },
+    };
+}
+
+/**
+ * @param {{ readOnly: boolean } | undefined} previous
+ * @param {{ param: Parameter }} match
+ * @returns {boolean}
+ */
+function hasExprParam(previous, match) {
+    return Boolean(previous?.readOnly || "expr" in match.param);
+}
+
+/**
+ * @param {{ pointSelection: boolean } | undefined} previous
+ * @param {{ param: Parameter }} match
+ * @returns {boolean}
+ */
+function hasPointSelectionParam(previous, match) {
+    if (previous?.pointSelection) {
+        return true;
+    }
+
+    const param = match.param;
+    return (
+        "select" in param &&
+        isPointSelectionConfig(asSelectionConfig(param.select))
+    );
+}
+
+/**
+ * @param {View} root
+ * @param {string} name
+ * @returns {{ view: View, param: Parameter }[]}
+ */
+function collectParamMatches(root, name) {
+    /** @type {{ view: View, param: Parameter }[]} */
+    const matches = [];
+
+    root.visit((view) => {
+        const param = view.paramRuntime.paramConfigs.get(name);
+        if (param) {
+            matches.push({ view, param });
+        }
+    });
+
+    return matches;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Resolves a configured domain value recursively.
+ *
+ * This supports top-level expression refs as well as arrays containing mixed
+ * constants and expression refs.
+ *
+ * @param {any} value
+ * @param {{ createExpression: (expr: string) => () => any }} paramRuntime
+ * @returns {any}
+ */
+export function resolveConfiguredDomainValue(value: any, paramRuntime: {
+    createExpression: (expr: string) => () => any;
+}): any;
+/**
+ * Collects all expression refs nested inside a configured domain value.
+ *
+ * @param {any} value
+ * @returns {import("../spec/parameter.js").ExprRef[]}
+ */
+export function collectConfiguredDomainExprRefs(value: any): import("../spec/parameter.js").ExprRef[];
+//# sourceMappingURL=domainExpressions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"domainExpressions.d.ts","sourceRoot":"","sources":["../../../src/scales/domainExpressions.js"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,oDAJW,GAAG,gBACH;IAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,CAAA;CAAE,GAC/C,GAAG,CAcf;AAED;;;;;GAKG;AACH,uDAHW,GAAG,GACD,OAAO,sBAAsB,EAAE,OAAO,EAAE,CAYpD"}

package/dist/src/scales/domainExpressions.js

@@ -0,0 +1,43 @@
+import { isExprRef } from "../paramRuntime/paramUtils.js";
+
+/**
+ * Resolves a configured domain value recursively.
+ *
+ * This supports top-level expression refs as well as arrays containing mixed
+ * constants and expression refs.
+ *
+ * @param {any} value
+ * @param {{ createExpression: (expr: string) => () => any }} paramRuntime
+ * @returns {any}
+ */
+export function resolveConfiguredDomainValue(value, paramRuntime) {
+    if (isExprRef(value)) {
+        return paramRuntime.createExpression(value.expr)();
+    }
+
+    if (Array.isArray(value)) {
+        return value.map((item) =>
+            resolveConfiguredDomainValue(item, paramRuntime)
+        );
+    }
+
+    return value;
+}
+
+/**
+ * Collects all expression refs nested inside a configured domain value.
+ *
+ * @param {any} value
+ * @returns {import("../spec/parameter.js").ExprRef[]}
+ */
+export function collectConfiguredDomainExprRefs(value) {
+    if (isExprRef(value)) {
+        return [value];
+    }
+
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => collectConfiguredDomainExprRefs(item));
+    }
+
+    return [];
+}

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

@@ -10,7 +10,9 @@ export function isSelectionDomainRef(domain: any): domain is SelectionDomainRef;
  * @typedef {import("../spec/scale.js").SelectionDomainRef} SelectionDomainRef
  * @typedef {import("../spec/parameter.js").ExprRef} ExprRef
  * @typedef {import("./scaleResolution.js").ScaleResolutionMember} ScaleResolutionMember
+ * @typedef {{ view: import("../view/view.js").default, channel: import("../spec/channel.js").ChannelWithScale, type: import("../spec/channel.js").Type, domain: import("../spec/scale.js").Scale["domain"] }} ConfiguredDomainSource
  * @typedef {() => Set<ScaleResolutionMember>} ScaleMembersGetter
+ * @typedef {() => ConfiguredDomainSource | undefined} ViewLevelConfiguredDomainGetter
  * @typedef {(interval: ScalarDomain | ComplexDomain) => number[]} FromComplexInterval
  * @typedef {(assembly: import("../spec/scale.js").Scale["assembly"] | undefined) => number[]} GetLocusExtent
  * @typedef {{
@@ -45,14 +47,16 @@ export default class DomainPlanner {
      * @param {ScaleMembersGetter} options.getActiveMembers Active shared-scale members used for configured domain planning.
      * @param {ScaleMembersGetter} [options.getAllMembers] All members, including inactive ones, used for conflict validation.
      * @param {ScaleMembersGetter} [options.getDataMembers] Members used for data-domain extraction; defaults to `getActiveMembers`.
+     * @param {ViewLevelConfiguredDomainGetter} [options.getViewLevelConfiguredDomain] View-level configured domain source.
      * @param {() => import("../spec/channel.js").Type} options.getType
      * @param {GetLocusExtent} options.getLocusExtent
      * @param {FromComplexInterval} options.fromComplexInterval
      */
-    constructor({ getActiveMembers, getAllMembers, getDataMembers, getType, getLocusExtent, fromComplexInterval, }: {
+    constructor({ getActiveMembers, getAllMembers, getDataMembers, getViewLevelConfiguredDomain, getType, getLocusExtent, fromComplexInterval, }: {
         getActiveMembers: ScaleMembersGetter;
         getAllMembers?: ScaleMembersGetter;
         getDataMembers?: ScaleMembersGetter;
+        getViewLevelConfiguredDomain?: ViewLevelConfiguredDomainGetter;
         getType: () => import("../spec/channel.js").Type;
         getLocusExtent: GetLocusExtent;
         fromComplexInterval: FromComplexInterval;
@@ -126,7 +130,14 @@ export type ScalarDomain = import("../spec/scale.js").ScalarDomain;
 export type SelectionDomainRef = import("../spec/scale.js").SelectionDomainRef;
 export type ExprRef = import("../spec/parameter.js").ExprRef;
 export type ScaleResolutionMember = import("./scaleResolution.js").ScaleResolutionMember;
+export type ConfiguredDomainSource = {
+    view: import("../view/view.js").default;
+    channel: import("../spec/channel.js").ChannelWithScale;
+    type: import("../spec/channel.js").Type;
+    domain: import("../spec/scale.js").Scale["domain"];
+};
 export type ScaleMembersGetter = () => Set<ScaleResolutionMember>;
+export type ViewLevelConfiguredDomainGetter = () => ConfiguredDomainSource | undefined;
 export type FromComplexInterval = (interval: ScalarDomain | ComplexDomain) => number[];
 export type GetLocusExtent = (assembly: import("../spec/scale.js").Scale["assembly"] | undefined) => number[];
 export type ConfiguredDomainResolutionState = {

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

@@ -1 +1 @@
-{"version":3,"file":"domainPlanner.d.ts","sourceRoot":"","sources":["../../../src/scales/domainPlanner.js"],"names":[],"mappings":"AAooBA;;;GAGG;AACH,6CAHW,GAAG,GACD,MAAM,IAAI,kBAAkB,CASxC;AAhnBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH;IAiCI;;;;;;;;OAQG;IACH,gHAPG;QAAoC,gBAAgB,EAA5C,kBAAkB;QACW,aAAa,GAA1C,kBAAkB;QACW,cAAc,GAA3C,kBAAkB;QAC+B,OAAO,EAAxD,MAAM,OAAO,oBAAoB,EAAE,IAAI;QACf,cAAc,EAAtC,cAAc;QACe,mBAAmB,EAAhD,mBAAmB;KAC7B,EAeA;IAED;;OAEG;IACH,6BAFa,GAAG,EAAE,CAIjB;IAED;;OAEG;IACH,8BAFW;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,WAI/C;IAED,wCAGC;IAED;;OAEG;IACH,2CAFa,uBAAuB,GAAG,SAAS,CAS/C;IAED;;;MAUC;IAED,mCAIC;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,kBACP,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAC1C,GAAG,EAAE,CAYjB;IAED;;;;;;;OAOG;IACH,iDALW,OAAO,kBACP,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,YAC5C;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,GAAG,EAAE,CAYjB;IAED;;;;;OAKG;IACH,8BAHW;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,WAAW,CA8BtB;IAED;;;;OAIG;IACH,iBAFY,WAAW,GAAG,SAAS,CAQlC;IAED;;;;;OAKG;IACH,4BALW,OAAO,qBAAqB,EAAE,SAAS,wBACvC,OAAO,mBACP,GAAG,EAAE,GACH,OAAO,CAgBnB;;CAkCJ;0BA7RY,OAAO,yBAAyB,EAAE,WAAW;4BAC7C,OAAO,kBAAkB,EAAE,aAAa;2BACxC,OAAO,kBAAkB,EAAE,YAAY;iCACvC,OAAO,kBAAkB,EAAE,kBAAkB;sBAC7C,OAAO,sBAAsB,EAAE,OAAO;oCACtC,OAAO,sBAAsB,EAAE,qBAAqB;iCACpD,MAAM,GAAG,CAAC,qBAAqB,CAAC;kCAChC,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,KAAK,MAAM,EAAE;6BACpD,CAAC,QAAQ,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,KAAK,MAAM,EAAE;8CAChF;IACR,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAClD,gBAAgB,EAAE,GAAG,CAAC;IACtB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;+CACS;IACR,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG;IACF,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,GAAG,GAAG,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC;CACd;sCACS;IACR,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,GAAG,GAAG,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC;CACd"}
+{"version":3,"file":"domainPlanner.d.ts","sourceRoot":"","sources":["../../../src/scales/domainPlanner.js"],"names":[],"mappings":"AAupBA;;;GAGG;AACH,6CAHW,GAAG,GACD,MAAM,IAAI,kBAAkB,CASxC;AAnoBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH;IAoCI;;;;;;;;;OASG;IACH,8IARG;QAAoC,gBAAgB,EAA5C,kBAAkB;QACW,aAAa,GAA1C,kBAAkB;QACW,cAAc,GAA3C,kBAAkB;QACwB,4BAA4B,GAAtE,+BAA+B;QACkB,OAAO,EAAxD,MAAM,OAAO,oBAAoB,EAAE,IAAI;QACf,cAAc,EAAtC,cAAc;QACe,mBAAmB,EAAhD,mBAAmB;KAC7B,EAiBA;IAED;;OAEG;IACH,6BAFa,GAAG,EAAE,CAIjB;IAED;;OAEG;IACH,8BAFW;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,WAI/C;IAED,wCAGC;IAED;;OAEG;IACH,2CAFa,uBAAuB,GAAG,SAAS,CAS/C;IAED;;;MAUC;IAED,mCAIC;IAED;;;;;;OAMG;IACH,qCAJW,OAAO,kBACP,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAC1C,GAAG,EAAE,CAYjB;IAED;;;;;;;OAOG;IACH,iDALW,OAAO,kBACP,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,YAC5C;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,GAAG,EAAE,CAYjB;IAED;;;;;OAKG;IACH,8BAHW;QAAE,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,WAAW,CA+BtB;IAED;;;;OAIG;IACH,iBAFY,WAAW,GAAG,SAAS,CAQlC;IAED;;;;;OAKG;IACH,4BALW,OAAO,qBAAqB,EAAE,SAAS,wBACvC,OAAO,mBACP,GAAG,EAAE,GACH,OAAO,CAgBnB;;CAkCJ;0BAtSY,OAAO,yBAAyB,EAAE,WAAW;4BAC7C,OAAO,kBAAkB,EAAE,aAAa;2BACxC,OAAO,kBAAkB,EAAE,YAAY;iCACvC,OAAO,kBAAkB,EAAE,kBAAkB;sBAC7C,OAAO,sBAAsB,EAAE,OAAO;oCACtC,OAAO,sBAAsB,EAAE,qBAAqB;qCACpD;IAAE,IAAI,EAAE,OAAO,iBAAiB,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,OAAO,oBAAoB,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAA;CAAE;iCAChM,MAAM,GAAG,CAAC,qBAAqB,CAAC;8CAChC,MAAM,sBAAsB,GAAG,SAAS;kCACxC,CAAC,QAAQ,EAAE,YAAY,GAAG,aAAa,KAAK,MAAM,EAAE;6BACpD,CAAC,QAAQ,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,KAAK,MAAM,EAAE;8CAChF;IACR,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,YAAY,EAAE,uBAAuB,GAAG,SAAS,CAAC;IAClD,gBAAgB,EAAE,GAAG,CAAC;IACtB,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;CAC3B;+CACS;IACR,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;CACrB,GAAG;IACF,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,GAAG,GAAG,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC;CACd;sCACS;IACR,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,GAAG,GAAG,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC;CACd"}

package/dist/src/scales/domainPlanner.js

@@ -11,7 +11,7 @@ import {
     resolveIntervalSelectionBinding,
 } from "./selectionDomainUtils.js";
 import createDomain from "../utils/domainArray.js";
-import { isExprRef } from "../paramRuntime/paramUtils.js";
+import { resolveConfiguredDomainValue } from "./domainExpressions.js";
 import { getAccessorDomainKey, isScaleAccessor } from "../encoder/accessor.js";
 import { getEncoderAccessors, getPrimaryChannel } from "../encoder/encoder.js";
 import {
@@ -36,7 +36,9 @@ import {
  * @typedef {import("../spec/scale.js").SelectionDomainRef} SelectionDomainRef
  * @typedef {import("../spec/parameter.js").ExprRef} ExprRef
  * @typedef {import("./scaleResolution.js").ScaleResolutionMember} ScaleResolutionMember
+ * @typedef {{ view: import("../view/view.js").default, channel: import("../spec/channel.js").ChannelWithScale, type: import("../spec/channel.js").Type, domain: import("../spec/scale.js").Scale["domain"] }} ConfiguredDomainSource
  * @typedef {() => Set<ScaleResolutionMember>} ScaleMembersGetter
+ * @typedef {() => ConfiguredDomainSource | undefined} ViewLevelConfiguredDomainGetter
  * @typedef {(interval: ScalarDomain | ComplexDomain) => number[]} FromComplexInterval
  * @typedef {(assembly: import("../spec/scale.js").Scale["assembly"] | undefined) => number[]} GetLocusExtent
  * @typedef {{
@@ -76,6 +78,9 @@ export default class DomainPlanner {
     /** @type {ScaleMembersGetter} */
     #getDataMembers;
 
+    /** @type {ViewLevelConfiguredDomainGetter | undefined} */
+    #getViewLevelConfiguredDomain;
+
     /** @type {() => import("../spec/channel.js").Type} */
     #getType;
 
@@ -104,6 +109,7 @@ export default class DomainPlanner {
      * @param {ScaleMembersGetter} options.getActiveMembers Active shared-scale members used for configured domain planning.
      * @param {ScaleMembersGetter} [options.getAllMembers] All members, including inactive ones, used for conflict validation.
      * @param {ScaleMembersGetter} [options.getDataMembers] Members used for data-domain extraction; defaults to `getActiveMembers`.
+     * @param {ViewLevelConfiguredDomainGetter} [options.getViewLevelConfiguredDomain] View-level configured domain source.
      * @param {() => import("../spec/channel.js").Type} options.getType
      * @param {GetLocusExtent} options.getLocusExtent
      * @param {FromComplexInterval} options.fromComplexInterval
@@ -112,6 +118,7 @@ export default class DomainPlanner {
         getActiveMembers,
         getAllMembers,
         getDataMembers,
+        getViewLevelConfiguredDomain,
         getType,
         getLocusExtent,
         fromComplexInterval,
@@ -119,6 +126,7 @@ export default class DomainPlanner {
         this.#getActiveMembers = getActiveMembers;
         this.#getAllMembers = getAllMembers ?? getActiveMembers;
         this.#getDataMembers = getDataMembers ?? getActiveMembers;
+        this.#getViewLevelConfiguredDomain = getViewLevelConfiguredDomain;
         this.#getType = getType;
         this.#getLocusExtent = getLocusExtent;
         this.#fromComplexInterval = fromComplexInterval;
@@ -232,6 +240,7 @@ export default class DomainPlanner {
 
         const configuredDomain = resolveConfiguredDomain(
             this.#getActiveMembers(),
+            this.#getViewLevelConfiguredDomain?.(),
             this.#fromComplexInterval,
             includeSelectionInitial
         );
@@ -319,6 +328,7 @@ export default class DomainPlanner {
 
 /**
  * @param {Set<ScaleResolutionMember>} members
+ * @param {ConfiguredDomainSource | undefined} viewLevelDomain
  * @param {(interval: ScalarDomain | ComplexDomain) => number[]} fromComplexInterval
  * @param {boolean} includeSelectionInitial
  * @returns {{
@@ -328,6 +338,7 @@ export default class DomainPlanner {
  */
 function resolveConfiguredDomain(
     members,
+    viewLevelDomain,
     fromComplexInterval,
     includeSelectionInitial
 ) {
@@ -344,41 +355,62 @@ function resolveConfiguredDomain(
         hasLiteralDomain: false,
     };
 
-    for (const member of domainMembers) {
-        const resolved = resolveConfiguredDomainMember(
-            member,
+    if (viewLevelDomain?.domain !== undefined) {
+        const resolved = resolveConfiguredDomainSource(
+            viewLevelDomain,
             fromComplexInterval,
             includeSelectionInitial
         );
+        mergeConfiguredDomainResolution(state, resolved);
+    }
 
-        if (resolved.kind === "selection") {
-            mergeSelectionConfiguredDomain(state, resolved);
-            continue;
-        }
+    for (const member of domainMembers) {
+        const resolved = resolveConfiguredDomainSource(
+            {
+                view: member.view,
+                channel: member.channel,
+                type: member.channelDef.type,
+                domain: member.channelDef.scale.domain,
+            },
+            fromComplexInterval,
+            includeSelectionInitial
+        );
 
-        mergeLiteralConfiguredDomain(state, resolved);
+        mergeConfiguredDomainResolution(state, resolved);
     }
 
     return finishConfiguredDomainResolution(state);
 }
 
 /**
- * @param {ScaleResolutionMember} member
+ * @param {ConfiguredDomainResolutionState} state
+ * @param {ConfiguredDomainMemberResolution} resolved
+ */
+function mergeConfiguredDomainResolution(state, resolved) {
+    if (resolved.kind === "selection") {
+        mergeSelectionConfiguredDomain(state, resolved);
+    } else {
+        mergeLiteralConfiguredDomain(state, resolved);
+    }
+}
+
+/**
+ * @param {ConfiguredDomainSource} source
  * @param {(interval: ScalarDomain | ComplexDomain) => number[]} fromComplexInterval
  * @param {boolean} includeSelectionInitial
  * @returns {ConfiguredDomainMemberResolution}
  */
-function resolveConfiguredDomainMember(
-    member,
+function resolveConfiguredDomainSource(
+    source,
     fromComplexInterval,
     includeSelectionInitial
 ) {
-    const domainDef = member.channelDef.scale.domain;
+    const domainDef = source.domain;
     if (isSelectionDomainRef(domainDef)) {
         return {
             kind: "selection",
             ...resolveSelectionDomain(
-                member,
+                source,
                 domainDef,
                 fromComplexInterval,
                 includeSelectionInitial
@@ -386,22 +418,11 @@ function resolveConfiguredDomainMember(
         };
     }
 
-    if (isExprRef(domainDef)) {
-        return {
-            kind: "literal",
-            domain: resolveConfiguredIntervalDomain(
-                member.channelDef.type,
-                member.view.paramRuntime.createExpression(domainDef.expr)(),
-                fromComplexInterval
-            ),
-        };
-    }
-
     return {
         kind: "literal",
         domain: resolveConfiguredIntervalDomain(
-            member.channelDef.type,
-            domainDef,
+            source.type,
+            resolveConfiguredDomainValue(domainDef, source.view?.paramRuntime),
             fromComplexInterval
         ),
     };
@@ -488,7 +509,7 @@ function finishConfiguredDomainResolution(state) {
 }
 
 /**
- * @param {ScaleResolutionMember} member
+ * @param {ConfiguredDomainSource} source
  * @param {SelectionDomainRef} domainRef
  * @param {(interval: ScalarDomain | ComplexDomain) => number[]} fromComplexInterval
  * @param {boolean} includeSelectionInitial
@@ -502,7 +523,7 @@ function finishConfiguredDomainResolution(state) {
  * }}
  */
 function resolveSelectionDomain(
-    member,
+    source,
     domainRef,
     fromComplexInterval,
     includeSelectionInitial
@@ -510,13 +531,13 @@ function resolveSelectionDomain(
     const paramName = domainRef.param;
 
     const resolvedChannel = resolveSelectionDomainChannel(
-        member.channel,
+        source.channel,
         domainRef,
         paramName
     );
 
     const binding = resolveIntervalSelectionBinding(
-        member.view,
+        source.view,
         paramName,
         resolvedChannel
     );
@@ -527,7 +548,7 @@ function resolveSelectionDomain(
         const initialDomain = includeSelectionInitial
             ? domainRef.initial
                 ? resolveConfiguredIntervalDomain(
-                      member.channelDef.type,
+                      source.type,
                       domainRef.initial,
                       fromComplexInterval
                   )
@@ -545,10 +566,7 @@ function resolveSelectionDomain(
 
     return {
         // Selection intervals already use internal scale-domain coordinates.
-        domain: createDomain(
-            member.channelDef.type,
-            fromComplexInterval(interval)
-        ),
+        domain: createDomain(source.type, fromComplexInterval(interval)),
         description,
         param: paramName,
         encoding: resolvedChannel,
@@ -565,6 +583,7 @@ function resolveSelectionDomain(
  */
 function resolveConfiguredIntervalDomain(type, interval, fromComplexInterval) {
     const numericDomain = fromComplexInterval(interval);
+    // TODO: support Vega-Lite-style `unionWith` domains.
     const internalDomain =
         type === LOCUS &&
         isChromosomalLocusInterval(interval) &&

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

@@ -17,6 +17,7 @@ export default class ScaleInstanceManager {
     get scale(): import("../types/encoder.js").VegaScale & {
         props: import("../spec/scale.js").Scale;
     };
+    resetScale(): void;
     /**
      * @param {import("../spec/scale.js").Scale["assembly"]} [assembly]
      * @returns {import("../genome/genome.js").default}

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;IAwFD,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,mBAGC;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;eArET,OAAO,kBAAkB,EAAE,KAAK;MA0FjE;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

@@ -53,6 +53,11 @@ export default class ScaleInstanceManager {
         return this.#scale;
     }
 
+    resetScale() {
+        this.dispose();
+        this.#scale = undefined;
+    }
+
     /**
      * @param {import("../spec/scale.js").Scale["assembly"]} [assembly]
      * @returns {import("../genome/genome.js").default}

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

@@ -4,6 +4,7 @@
  * @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
  */
 export default class ScaleInteractionController {
@@ -11,14 +12,16 @@ 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
      * @param {() => number[]} options.getGenomeExtent
      */
-    constructor({ getScale, getAnimator, getInitialDomainSnapshot, getResetDomain, fromComplexInterval, getGenomeExtent, }: {
+    constructor({ getScale, getAnimator, renderImmediately, getInitialDomainSnapshot, getResetDomain, fromComplexInterval, getGenomeExtent, }: {
         getScale: () => ScaleWithProps;
         getAnimator: () => import("../utils/animator.js").default;
+        renderImmediately: () => void;
         getInitialDomainSnapshot: () => number[];
         getResetDomain: () => number[];
         fromComplexInterval: (domain: ScalarDomain | ComplexDomain) => number[];
@@ -52,10 +55,10 @@ 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.
      */
-    zoomTo(domain: NumericDomain | ComplexDomain, duration?: boolean | number): Promise<void>;
+    zoomTo(domain: NumericDomain | ComplexDomain, options?: ZoomToOptions | boolean | number): Promise<void>;
     /**
      * Resets the current domain to the initial one
      *
@@ -73,6 +76,7 @@ export type ScalarDomain = import("../spec/scale.js").ScalarDomain;
 export type ComplexDomain = import("../spec/scale.js").ComplexDomain;
 export type ZoomParams = import("../spec/scale.js").ZoomParams;
 export type VegaScale = import("../types/encoder.js").VegaScale;
+export type ZoomToOptions = import("../types/scaleResolutionApi.js").ZoomToOptions;
 export type ScaleWithProps = VegaScale & {
     props: import("../spec/scale.js").Scale;
 };

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"scaleInteractionController.d.ts","sourceRoot":"","sources":["../../../src/scales/scaleInteractionController.js"],"names":[],"mappings":"AAuBA;;;;;;;;GAQG;AAEH;IAyBI;;;;;;;;;OASG;IACH,2IARG;QAAsC,QAAQ,EAAtC,MAAM,cAAc;QACkC,WAAW,EAAjE,MAAM,OAAO,sBAAsB,EAAE,OAAO;QACxB,iBAAiB,EAArC,MAAM,IAAI;QACc,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,EAiBA;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,YAC7B,aAAa,GAAG,OAAO,GAAG,MAAM,iBA0E1C;IASD;;;;OAIG;IACH,qBAcC;IAED;;OAEG;IACH,uBAOC;;CACJ;4BA9QY,OAAO,kBAAkB,EAAE,aAAa;2BACxC,OAAO,kBAAkB,EAAE,YAAY;4BACvC,OAAO,kBAAkB,EAAE,aAAa;yBACxC,OAAO,kBAAkB,EAAE,UAAU;wBACrC,OAAO,qBAAqB,EAAE,SAAS;4BACvC,OAAO,gCAAgC,EAAE,aAAa;6BACtD,SAAS,GAAG;IAAE,KAAK,EAAE,OAAO,kBAAkB,EAAE,KAAK,CAAA;CAAE"}