@genome-spy/core 0.77.0 → 0.79.0

package/dist/src/paramRuntime/viewParamRuntime.js

@@ -17,6 +17,23 @@ export {
     withoutExprRef,
 } from "./paramUtils.js";
 
+/**
+ * @typedef {object} ViewParamRuntimeDebugState
+ * @prop {string} scopeId
+ * @prop {boolean} disposed
+ * @prop {ViewParamDebugState[]} params
+ */
+
+/**
+ * @typedef {object} ViewParamDebugState
+ * @prop {string} name
+ * @prop {"auto" | "base" | "derived" | "selection" | "push"} kind
+ * @prop {any} value
+ * @prop {boolean} writable
+ * @prop {boolean} configured
+ * @prop {import("../spec/parameter.js").Parameter | undefined} config
+ */
+
 /**
  * A class that manages parameters and expressions.
  * Supports nesting and scoped parameters through a shared runtime graph.
@@ -352,6 +369,32 @@ export default class ViewParamRuntime {
         }
     }
 
+    /**
+     * @returns {ViewParamRuntimeDebugState}
+     */
+    getDebugState() {
+        /** @type {ViewParamDebugState[]} */
+        const params = [];
+
+        for (const [name, ref] of this.#localRefs) {
+            const config = this.#paramConfigs.get(name);
+            params.push({
+                name,
+                kind: getParamKind(config),
+                value: ref.get(),
+                writable: this.#allocatedSetters.has(name),
+                configured: Boolean(config),
+                config: config ? structuredClone(config) : undefined,
+            });
+        }
+
+        return {
+            scopeId: this.#scopeId,
+            disposed: this.#disposed,
+            params,
+        };
+    }
+
     // Setter lifecycle is scope-owned: setters are dropped when the runtime scope
     // is disposed. A standalone deallocation API is intentionally not exposed.
 
@@ -487,3 +530,23 @@ export default class ViewParamRuntime {
         return false;
     }
 }
+
+/**
+ * @param {import("../spec/parameter.js").Parameter | undefined} config
+ * @returns {"auto" | "base" | "derived" | "selection" | "push"}
+ */
+function getParamKind(config) {
+    if (!config) {
+        return "auto";
+    }
+
+    if (config.push === "outer") {
+        return "push";
+    } else if ("select" in config) {
+        return "selection";
+    } else if ("expr" in config) {
+        return "derived";
+    } else {
+        return "base";
+    }
+}

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

@@ -23,8 +23,43 @@ export default class AxisResolution {
      * @returns {boolean}
      */
     removeMember(member: AxisResolutionMember): boolean;
+    /**
+     * @returns {boolean} True when at least one non-chrome axis-contributing view is visible.
+     */
+    hasVisibleNonChromeMember(): boolean;
+    getDebugState(): {
+        kind: string;
+        channel: import("../spec/channel.js").PrimaryPositionalChannel;
+        hostView: any;
+        scaleResolution: any;
+        title: string;
+        axisProps: import("../spec/axis.js").GenomeAxis;
+        hasVisibleNonChromeMember: boolean;
+        members: {
+            view: import("../view/unitView.js").default<import("../spec/view.js").UnitSpec>;
+            channel: import("../spec/channel.js").PositionalChannel;
+            channelDef: import("../spec/channel.js").ChannelDefWithScale;
+        }[];
+        viewLevelAxisConfig: {
+            view: import("../view/view.js").default<import("../spec/view.js").ViewSpec>;
+            config: Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis>;
+        };
+    };
     getAxisProps(): import("../spec/axis.js").GenomeAxis;
     getTitle(): string;
+    /**
+     * @param {import("../view/view.js").default} view
+     * @param {Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis>} config
+     */
+    attachViewLevelAxisConfig(view: import("../view/view.js").default, config: Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis>): void;
+    /**
+     * @param {import("../view/view.js").default} view
+     */
+    clearViewLevelAxisConfig(view: import("../view/view.js").default): void;
+    getViewLevelAxisConfig(): {
+        view: import("../view/view.js").default;
+        config: Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis>;
+    };
     #private;
 }
 export type AxisResolutionMember<T extends import("../spec/channel.js").PositionalChannel = import("../spec/channel.js").PositionalChannel> = {

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

@@ -1 +1 @@
-{"version":3,"file":"axisResolution.d.ts","sourceRoot":"","sources":["../../../src/scales/axisResolution.js"],"names":[],"mappings":"AAeA;;;;;;;GAOG;AACH;IASI;;OAEG;IACH,qBAFW,OAAO,oBAAoB,EAAE,wBAAwB,EAI/D;IADG,+DAAsB;IAG1B,2BAGC;IAiCD;;;OAGG;IACH,uBAHW,oBAAoB,GAClB,MAAM,OAAO,CAQzB;IAED;;;OAGG;IACH,qBAHW,oBAAoB,GAClB,OAAO,CAQnB;IAED,qDA0BC;IAED,mBAmEC;;CACJ;iCAnL6D,CAAC,SAAlD,OAAQ,oBAAoB,EAAE,iBAAkB;UAGnD,OAAO,qBAAqB,EAAE,OAAO;aACrC,CAAC;gBACD,OAAO,oBAAoB,EAAE,mBAAmB"}
+{"version":3,"file":"axisResolution.d.ts","sourceRoot":"","sources":["../../../src/scales/axisResolution.js"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH;IAYI;;OAEG;IACH,qBAFW,OAAO,oBAAoB,EAAE,wBAAwB,EAI/D;IADG,+DAAsB;IAG1B,2BAGC;IAiCD;;;OAGG;IACH,uBAHW,oBAAoB,GAClB,MAAM,OAAO,CASzB;IAED;;;OAGG;IACH,qBAHW,oBAAoB,GAClB,OAAO,CAQnB;IAED;;OAEG;IACH,6BAFa,OAAO,CAanB;IAED;;;;;;;;;;;;;;;;;MAwBC;IAED,qDA0BC;IAED,mBAuEC;IAED;;;OAGG;IACH,gCAHW,OAAO,iBAAiB,EAAE,OAAO,UACjC,OAAO,CAAC,OAAO,iBAAiB,EAAE,IAAI,GAAG,OAAO,iBAAiB,EAAE,UAAU,CAAC,QAuBxF;IAED;;OAEG;IACH,+BAFW,OAAO,iBAAiB,EAAE,OAAO,QAO3C;IAED;cA3PmB,OAAO,iBAAiB,EAAE,OAAO;gBAAU,OAAO,CAAC,OAAO,iBAAiB,EAAE,IAAI,GAAG,OAAO,iBAAiB,EAAE,UAAU,CAAC;MA6P3I;;CAiBJ;iCA9R6D,CAAC,SAAlD,OAAQ,oBAAoB,EAAE,iBAAkB;UAGnD,OAAO,qBAAqB,EAAE,OAAO;aACrC,CAAC;gBACD,OAAO,oBAAoB,EAAE,mBAAmB"}

package/dist/src/scales/axisResolution.js

@@ -11,6 +11,7 @@ import coalesce from "../utils/coalesce.js";
 
 import mergeObjects from "../utils/mergeObjects.js";
 import { getCachedOrCall, invalidate } from "../utils/propertyCacher.js";
+import { isChromeView } from "../view/viewSelectors.js";
 import { orderResolutionMembers } from "./resolutionMemberOrder.js";
 
 /**
@@ -30,6 +31,9 @@ export default class AxisResolution {
     /** @type {Set<AxisResolutionMember>} The involved views */
     #members = new Set();
 
+    /** @type {{ view: import("../view/view.js").default, config: Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis> } | undefined} */
+    #viewLevelAxisConfig;
+
     /**
      * @param {import("../spec/channel.js").PrimaryPositionalChannel} channel
      */
@@ -78,6 +82,7 @@ export default class AxisResolution {
      * @returns {() => boolean}
      */
     registerMember(member) {
+        this.#assertNoMixing(member);
         this.#addMember(member);
         return () => {
             const removed = this.removeMember(member);
@@ -97,15 +102,57 @@ export default class AxisResolution {
         return removed;
     }
 
+    /**
+     * @returns {boolean} True when at least one non-chrome axis-contributing view is visible.
+     */
+    hasVisibleNonChromeMember() {
+        for (const member of this.#members) {
+            if (
+                member.view.isVisible() &&
+                !member.view.getLayoutAncestors().some(isChromeView)
+            ) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    getDebugState() {
+        return {
+            kind: "axis",
+            channel: this.channel,
+            hostView:
+                this.scaleResolution?.getDebugState().hostView ??
+                this.#viewLevelAxisConfig?.view ??
+                this.#members.values().next().value?.view,
+            scaleResolution: this.scaleResolution,
+            title: this.getTitle(),
+            axisProps: this.getAxisProps(),
+            hasVisibleNonChromeMember: this.hasVisibleNonChromeMember(),
+            members: orderResolutionMembers(this.#members).map((member) => ({
+                view: member.view,
+                channel: member.channel,
+                channelDef: structuredClone(member.channelDef),
+            })),
+            viewLevelAxisConfig: this.#viewLevelAxisConfig
+                ? {
+                      view: this.#viewLevelAxisConfig.view,
+                      config: structuredClone(this.#viewLevelAxisConfig.config),
+                  }
+                : undefined,
+        };
+    }
+
     getAxisProps() {
         return getCachedOrCall(this, "axisProps", () => {
-            const propArray = orderResolutionMembers(this.#members).map(
-                (member) => {
-                    const channelDef =
-                        member.view.mark.encoding[member.channel];
-                    return "axis" in channelDef && channelDef.axis;
-                }
-            );
+            const propArray = this.#viewLevelAxisConfig
+                ? [this.#viewLevelAxisConfig.config]
+                : orderResolutionMembers(this.#members).map((member) => {
+                      const channelDef =
+                          member.view.mark.encoding[member.channel];
+                      return "axis" in channelDef && channelDef.axis;
+                  });
 
             if (
                 propArray.length > 0 &&
@@ -126,6 +173,10 @@ export default class AxisResolution {
     }
 
     getTitle() {
+        if (this.#viewLevelAxisConfig?.config.title !== undefined) {
+            return this.#viewLevelAxisConfig.config.title;
+        }
+
         /** @param {AxisResolutionMember} member} */
         const computeTitle = (member) => {
             const channelDef = getChannelDefWithScale(
@@ -193,4 +244,61 @@ export default class AxisResolution {
 
         return uniqueTitles.size ? [...uniqueTitles].join(", ") : null;
     }
+
+    /**
+     * @param {import("../view/view.js").default} view
+     * @param {Partial<import("../spec/axis.js").Axis & import("../spec/axis.js").GenomeAxis>} config
+     */
+    attachViewLevelAxisConfig(view, config) {
+        if (
+            this.#viewLevelAxisConfig &&
+            this.#viewLevelAxisConfig.view !== view
+        ) {
+            throw new Error(
+                `Multiple view-level axis configs target the same ${this.channel} axis resolution.`
+            );
+        }
+
+        for (const member of this.#members) {
+            const channelDef = member.view.mark.encoding[member.channel];
+            if ("axis" in channelDef && channelDef.axis !== undefined) {
+                throw new Error(
+                    `Cannot mix view-level axes.${this.channel} with encoding.${member.channel}.axis in the same axis resolution.`
+                );
+            }
+        }
+
+        this.#viewLevelAxisConfig = { view, config };
+        invalidate(this, "axisProps");
+    }
+
+    /**
+     * @param {import("../view/view.js").default} view
+     */
+    clearViewLevelAxisConfig(view) {
+        if (this.#viewLevelAxisConfig?.view === view) {
+            this.#viewLevelAxisConfig = undefined;
+            invalidate(this, "axisProps");
+        }
+    }
+
+    getViewLevelAxisConfig() {
+        return this.#viewLevelAxisConfig;
+    }
+
+    /**
+     * @param {AxisResolutionMember} member
+     */
+    #assertNoMixing(member) {
+        if (!this.#viewLevelAxisConfig) {
+            return;
+        }
+
+        const channelDef = member.view.mark.encoding[member.channel];
+        if ("axis" in channelDef && channelDef.axis !== undefined) {
+            throw new Error(
+                `Cannot mix view-level axes.${this.channel} with encoding.${member.channel}.axis in the same axis resolution.`
+            );
+        }
+    }
 }

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":"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"}

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) &&