@genome-spy/core 0.73.0 → 0.74.0

package/dist/src/scales/selectionDomainUtils.js

@@ -1,4 +1,9 @@
-import { isIntervalSelection } from "../selection/selection.js";
+import { isSelectionParameter } from "../paramRuntime/paramUtils.js";
+import {
+    asSelectionConfig,
+    isIntervalSelection,
+    isIntervalSelectionConfig,
+} from "../selection/selection.js";
 
 /**
  * @param {{ findRuntimeForParam: (name: string) => any }} paramRuntime
@@ -34,6 +39,116 @@ export function requireIntervalSelection(selection, paramName) {
     return selection;
 }
 
+/**
+ * Resolves the runtime-backed interval selection binding used by a linked
+ * domain. Matching is based on the actual resolved runtime slot instead of
+ * parameter name alone, so scoped params with the same name remain distinct.
+ *
+ * @param {import("../view/view.js").default} view
+ * @param {string} paramName
+ * @param {"x" | "y"} encoding
+ */
+export function resolveIntervalSelectionBinding(view, paramName, encoding) {
+    const runtime = view.paramRuntime.findRuntimeForParam
+        ? requireParamRuntime(view.paramRuntime, paramName)
+        : view.paramRuntime;
+    const selection = requireIntervalSelection(
+        runtime.getValue
+            ? runtime.getValue(paramName)
+            : view.paramRuntime.findValue(paramName),
+        paramName
+    );
+
+    return {
+        runtime,
+        selection,
+    };
+}
+
+/**
+ * @param {import("../view/view.js").default} root
+ * @param {any} runtime
+ * @param {string} paramName
+ * @param {"x" | "y"} encoding
+ */
+export function findIntervalSelectionBindingOwners(root, runtime, paramName, encoding) {
+    /** @type {{ view: import("../view/view.js").default, param: import("../spec/parameter.js").SelectionParameter }[]} */
+    const owners = [];
+
+    root.visit((view) => {
+        const param = view.paramRuntime?.paramConfigs?.get(paramName);
+        if (!param || !isSelectionParameter(param)) {
+            return;
+        }
+
+        const select = asSelectionConfig(param.select);
+        if (
+            !isIntervalSelectionConfig(select) ||
+            !select.encodings?.includes(encoding)
+        ) {
+            return;
+        }
+
+        if (view.paramRuntime.findRuntimeForParam(paramName) === runtime) {
+            owners.push({ view, param });
+        }
+    });
+
+    return owners;
+}
+
+/**
+ * @param {import("../view/view.js").default} view
+ * @param {any} runtime
+ * @param {string} paramName
+ * @param {"x" | "y"} encoding
+ */
+export function hasIntervalSelectionBindingInScope(
+    view,
+    runtime,
+    paramName,
+    encoding
+) {
+    const seen = new Set();
+    const ancestorGroups = [
+        view.getLayoutAncestors?.(),
+        view.getDataAncestors?.(),
+        [view],
+    ];
+
+    for (const views of ancestorGroups) {
+        for (const candidateView of views ?? []) {
+            if (!candidateView || seen.has(candidateView)) {
+                continue;
+            }
+
+            seen.add(candidateView);
+
+            const param = candidateView.paramRuntime?.paramConfigs?.get(paramName);
+            if (!param || !isSelectionParameter(param)) {
+                continue;
+            }
+
+            const select = asSelectionConfig(param.select);
+            if (
+                !isIntervalSelectionConfig(select) ||
+                !select.encodings?.includes(encoding)
+            ) {
+                continue;
+            }
+
+            if (
+                candidateView.paramRuntime.findRuntimeForParam?.(paramName) ===
+                runtime
+            ) {
+                return true;
+            }
+        }
+    }
+
+    return false;
+}
+
 /**
  * @param {number[]} interval
  * @param {number[]} zoomExtent

package/dist/src/screenshotHarness.js

@@ -111,9 +111,7 @@ async function initializeHarness(url) {
             },
         };
 
-        setStatus(
-            `Ready (${logicalSize.width}x${logicalSize.height}, DPR 1)`
-        );
+        setStatus(`Ready (${logicalSize.width}x${logicalSize.height}, DPR 1)`);
     } catch (error) {
         setFailure(error instanceof Error ? error.message : String(error));
     }
@@ -144,7 +142,8 @@ async function waitForVisibleLazyData(api, timeoutMs) {
     } catch (error) {
         if (timedOut) {
             throw new Error(
-                `Timed out after ${timeoutMs} ms while waiting for visible lazy data.`
+                `Timed out after ${timeoutMs} ms while waiting for visible lazy data.`,
+                { cause: error }
             );
         }
 

package/dist/src/spec/axis.d.ts

@@ -1,4 +1,5 @@
 import { Align, Baseline, FontStyle, FontWeight } from "./font.js";
+import { ZIndexProps } from "./decoration.js";
 
 export interface GenomeAxis extends Axis {
     chromTicks?: boolean;
@@ -91,7 +92,13 @@ export interface GenomeAxis extends Axis {
 
 export type AxisOrient = "top" | "bottom" | "left" | "right";
 
-export interface Axis extends BaseAxis {
+export interface Axis extends BaseAxis, ZIndexProps {
+    /**
+     * Named style reference(s) resolved from `config.style`.
+     * If an array is provided, later styles override earlier ones.
+     */
+    style?: string | string[];
+
     /**
      * The orientation of the axis. One of `"top"`, `"bottom"`, `"left"` or `"right"`. The orientation can be used to further specialize the axis type (e.g., a y axis oriented for the right edge of the chart).
      *
@@ -131,68 +138,72 @@ export interface Axis extends BaseAxis {
      * Explicitly set the visible axis tick and label values.
      */
     values?: any[];
+
+    /**
+     * Z-order of the axis relative to the view content.
+     *
+     * Values greater than `0` render after the view marks. Values less than or
+     * equal to `0` render before the marks.
+     *
+     * __Default value:__ `0`, or `10` when the view content is clipped or
+     * scrollable.
+     */
+    zindex?: number;
 }
 
-export interface BaseAxis<
-    N = number,
-    B = boolean,
-    S = string,
-    C = string,
-    FW = string,
-    FS = string,
-> {
+export interface BaseAxis {
     /**
      * The minimum extent in pixels that axis ticks and labels should use. This determines a minimum offset value for axis titles.
      *
      * __Default value:__ `30` for y-axis; `undefined` for x-axis.
      */
-    minExtent?: N;
+    minExtent?: number;
 
     /**
      * The maximum extent in pixels that axis ticks and labels should use. This determines a maximum offset value for axis titles.
      *
      * __Default value:__ `undefined`.
      */
-    maxExtent?: N;
+    maxExtent?: number;
 
     // ---------- Title ----------
     /**
      * The padding, in pixels, between title and axis.
      */
-    titlePadding?: N;
+    titlePadding?: number;
 
     /**
      * Color of the title, can be in hex color code or regular color name.
      */
-    titleColor?: C;
+    titleColor?: string;
 
     /**
      * Font of the title. (e.g., `"Helvetica Neue"`).
      */
-    titleFont?: S;
+    titleFont?: string;
 
     /**
      * Font size of the title.
      *
      * @minimum 0
      */
-    titleFontSize?: N;
+    titleFontSize?: number;
 
     /**
      * Font style of the title.
      */
-    titleFontStyle?: FS;
+    titleFontStyle?: FontStyle;
 
     /**
      * Font weight of the title.
      * This can be either a string (e.g `"bold"`, `"normal"`) or a number (`100`, `200`, `300`, ..., `900` where `"normal"` = `400` and `"bold"` = `700`).
      */
-    titleFontWeight?: FW;
+    titleFontWeight?: FontWeight;
 
     /**
      * Opacity of the axis title.
      */
-    titleOpacity?: N;
+    titleOpacity?: number;
 
     // ---------- Domain ----------
     /**
@@ -224,14 +235,14 @@ export interface BaseAxis<
      *
      * __Default value:__ `"gray"`.
      */
-    domainColor?: C;
+    domainColor?: string;
 
     /**
      * Stroke width of axis domain line
      *
      * __Default value:__ `1`
      */
-    domainWidth?: N;
+    domainWidth?: number;
 
     // ---------- Ticks ----------
     /**
@@ -239,7 +250,7 @@ export interface BaseAxis<
      *
      * __Default value:__ `true`
      */
-    ticks?: B;
+    ticks?: boolean;
 
     /**
      * The stroke cap for the tick lines' ending style. One of `"butt"`, `"round"` or `"square"`.
@@ -253,7 +264,7 @@ export interface BaseAxis<
      *
      * __Default value:__ `"gray"`
      */
-    tickColor?: C;
+    tickColor?: string;
 
     /**
      * An array of alternating [stroke, space] lengths for dashed tick mark lines.
@@ -271,7 +282,7 @@ export interface BaseAxis<
      * __Default value:__ `5`
      * @minimum 0
      */
-    tickSize?: N;
+    tickSize?: number;
 
     /**
      * The width, in pixels, of ticks.
@@ -279,7 +290,7 @@ export interface BaseAxis<
      * __Default value:__ `1`
      * @minimum 0
      */
-    tickWidth?: N;
+    tickWidth?: number;
 
     // ---------- Labels ----------
     /**
@@ -313,36 +324,36 @@ export interface BaseAxis<
     /**
      * The color of the tick label, can be in hex color code or regular color name.
      */
-    labelColor?: C;
+    labelColor?: string;
 
     /**
      * The font of the tick label.
      */
-    labelFont?: S;
+    labelFont?: string;
 
     /**
      * The font size of the label, in pixels.
      *
      * @minimum 0
      */
-    labelFontSize?: N;
+    labelFontSize?: number;
 
     /**
      * Font style of the title.
      */
-    labelFontStyle?: FS;
+    labelFontStyle?: FontStyle;
 
     /**
      * Font weight of axis tick labels.
      */
-    labelFontWeight?: FW;
+    labelFontWeight?: FontWeight;
 
     /**
      * Maximum allowed pixel width of axis tick labels.
      *
      * __Default value:__ `180`
      */
-    labelLimit?: N;
+    labelLimit?: number;
 
     /**
      * The padding, in pixels, between axis and text labels.

package/dist/src/spec/channel.d.ts

@@ -268,15 +268,17 @@ export type FieldOrDatumDefWithCondition<
 /**
  * @minProperties 1
  */
-export type ValueDefWithCondition<V extends Value = Value> = Partial<
-    ValueDef<V | ExprRef>
-> & {
+export type ValueDefWithCondition<
+    V extends Value = Value,
+    T extends Type = Type,
+> = Partial<ValueDef<V | ExprRef>> & {
     /**
      * A field definition or one or more value definition(s) with a parameter predicate.
      */
     condition?:
-        | Conditional<FieldDef>
-        | Conditional<DatumDef>
+        | Conditional<MarkPropFieldDef<T>>
+        | Conditional<ScaleDatumDef>
+        | Conditional<MarkPropExprDef<T>>
         | Conditional<ValueDef<V | ExprRef>>
         | Conditional<ValueDef<V | ExprRef>>[];
 };
@@ -289,7 +291,7 @@ export type MarkPropFieldOrDatumOrExprDef<T extends Type = Type> =
 export type MarkPropDef<V extends Value, T extends Type = Type> =
     | FieldOrDatumDefWithCondition<MarkPropFieldDef<T>, V>
     | FieldOrDatumDefWithCondition<ScaleDatumDef, V>
-    | ValueDefWithCondition<V>;
+    | ValueDefWithCondition<V, T>;
 
 export type ColorDef = MarkPropDef<string | null>;
 
@@ -381,9 +383,13 @@ export type NumericMarkPropDef = MarkPropDef<number>;
 
 export type ShapeDef = MarkPropDef<string | null, TypeForShape>;
 
-export interface StringFieldDef extends FieldDefWithoutScale, FormatMixins {}
+export type StringFieldDef = FieldDef<Type> & FormatMixins;
 
-export type TextDef = StringFieldDef | StringDatumDef | ExprDef; // TODO: Conditions
+export type TextDef =
+    | StringFieldDef
+    | StringDatumDef
+    | ExprDef
+    | ValueDef<string>; // TODO: Conditions
 
 export type ChannelDef = Exclude<
     Encoding[keyof Encoding],
@@ -549,5 +555,5 @@ export interface Encoding {
     // TODO: proper type
     facetIndex?: FieldDefWithoutScale;
 
-    semanticScore?: FieldDefWithoutScale;
+    semanticScore?: FieldDefWithoutScale & Partial<TypeMixins<Type>>;
 }

package/dist/src/spec/config.d.ts

@@ -0,0 +1,264 @@
+import { Axis, GenomeAxis } from "./axis.js";
+import {
+    LinkProps,
+    MarkPropsBase,
+    PointProps,
+    RectProps,
+    RuleProps,
+    TickProps,
+    TextProps,
+} from "./mark.js";
+import { Scale, SchemeParams } from "./scale.js";
+import { Title } from "./title.js";
+import { ViewBackgroundProps } from "./decoration.js";
+
+export type BuiltInThemeName =
+    | "genomespy"
+    | "vegalite"
+    | "quartz"
+    | "dark"
+    | "fivethirtyeight"
+    | "urbaninstitute";
+
+export type ViewConfig = ViewBackgroundProps;
+
+export type MarkConfig = Partial<Omit<MarkPropsBase, "type">>;
+
+export type PointConfig = Partial<Omit<PointProps, "type">>;
+
+export type RectConfig = Partial<Omit<RectProps, "type">>;
+
+export type RuleConfig = Partial<Omit<RuleProps, "type">>;
+
+export type TickConfig = Partial<Omit<TickProps, "type">>;
+
+export type TextConfig = Partial<Omit<TextProps, "type">>;
+
+export type LinkConfig = Partial<Omit<LinkProps, "type">>;
+
+export type AxisConfig = Partial<Axis & GenomeAxis>;
+
+type ColorSchemeConfig = string | SchemeParams;
+
+export interface ScaleConfig extends Partial<Scale> {
+    /**
+     * Defaults for nominal scales.
+     */
+    nominal?: Partial<Scale>;
+
+    /**
+     * Defaults for ordinal scales.
+     */
+    ordinal?: Partial<Scale>;
+
+    /**
+     * Defaults for quantitative scales.
+     */
+    quantitative?: Partial<Scale>;
+
+    /**
+     * Defaults for GenomeSpy's `index` scales.
+     */
+    index?: Partial<Scale>;
+
+    /**
+     * Defaults for GenomeSpy's `locus` scales.
+     */
+    locus?: Partial<Scale>;
+
+    /**
+     * Default color scheme for nominal color scales.
+     */
+    nominalColorScheme?: ColorSchemeConfig;
+
+    /**
+     * Default color scheme for ordinal color scales.
+     */
+    ordinalColorScheme?: ColorSchemeConfig;
+
+    /**
+     * Default color scheme for quantitative color scales when no named range
+     * such as `"heatmap"` or `"ramp"` applies.
+     */
+    quantitativeColorScheme?: ColorSchemeConfig;
+}
+
+export interface RangeConfig {
+    /**
+     * Named range for `shape` channels.
+     */
+    shape?: string[];
+
+    /**
+     * Named range for `size` channels.
+     */
+    size?: number[];
+
+    /**
+     * Named range for `angle` channels.
+     */
+    angle?: number[];
+
+    /**
+     * Named range for quantitative rect-like color encodings such as heatmaps.
+     */
+    heatmap?: ColorSchemeConfig;
+
+    /**
+     * Named range for quantitative ramp color encodings.
+     */
+    ramp?: ColorSchemeConfig;
+
+    /**
+     * Named range for diverging color encodings.
+     */
+    diverging?: ColorSchemeConfig;
+}
+
+export type TitleConfig = Partial<Omit<Title, "text">>;
+
+type MergeProps<A, B> = {
+    [K in keyof A | keyof B]:
+        | (K extends keyof A ? A[K] : never)
+        | (K extends keyof B ? B[K] : never);
+};
+
+type CombinedStyleConfig = MergeProps<
+    MergeProps<
+        MergeProps<
+            MergeProps<
+                MergeProps<MergeProps<MarkConfig, PointConfig>, RectConfig>,
+                RuleConfig
+            >,
+            TickConfig
+        >,
+        TextConfig
+    >,
+    MergeProps<MergeProps<LinkConfig, AxisConfig>, TitleConfig>
+>;
+
+export type StyleConfig = Partial<CombinedStyleConfig>;
+
+export interface GenomeSpyConfig {
+    /**
+     * Defaults for view background styling, including fill, stroke, shadow,
+     * and z-order properties.
+     */
+    view?: ViewConfig;
+
+    /**
+     * Defaults shared by all mark types.
+     */
+    mark?: MarkConfig;
+
+    /**
+     * Defaults for point marks.
+     */
+    point?: PointConfig;
+
+    /**
+     * Defaults for rect marks.
+     */
+    rect?: RectConfig;
+
+    /**
+     * Defaults for rule marks.
+     */
+    rule?: RuleConfig;
+
+    /**
+     * Defaults for tick marks.
+     */
+    tick?: TickConfig;
+
+    /**
+     * Defaults for text marks.
+     */
+    text?: TextConfig;
+
+    /**
+     * Defaults for link marks.
+     */
+    link?: LinkConfig;
+
+    /**
+     * Defaults shared by all axes.
+     */
+    axis?: AxisConfig;
+
+    /**
+     * Defaults for x axes.
+     */
+    axisX?: AxisConfig;
+
+    /**
+     * Defaults for y axes.
+     */
+    axisY?: AxisConfig;
+
+    /**
+     * Defaults for top-oriented axes.
+     */
+    axisTop?: AxisConfig;
+
+    /**
+     * Defaults for bottom-oriented axes.
+     */
+    axisBottom?: AxisConfig;
+
+    /**
+     * Defaults for left-oriented axes.
+     */
+    axisLeft?: AxisConfig;
+
+    /**
+     * Defaults for right-oriented axes.
+     */
+    axisRight?: AxisConfig;
+
+    /**
+     * Defaults for axes that visualize nominal data.
+     */
+    axisNominal?: AxisConfig;
+
+    /**
+     * Defaults for axes that visualize ordinal data.
+     */
+    axisOrdinal?: AxisConfig;
+
+    /**
+     * Defaults for axes that visualize quantitative data.
+     */
+    axisQuantitative?: AxisConfig;
+
+    /**
+     * Defaults for axes that visualize GenomeSpy `index` scales.
+     */
+    axisIndex?: AxisConfig;
+
+    /**
+     * Defaults for axes that visualize GenomeSpy `locus` scales.
+     */
+    axisLocus?: AxisConfig;
+
+    /**
+     * Defaults for scale behavior and scale-type-specific buckets.
+     */
+    scale?: ScaleConfig;
+
+    /**
+     * Named reusable ranges for channels such as `shape`, `size`, and color.
+     */
+    range?: RangeConfig;
+
+    /**
+     * Defaults for view titles.
+     */
+    title?: TitleConfig;
+
+    /**
+     * Named reusable style buckets that marks, axes, titles, and views can
+     * reference through their `style` properties.
+     */
+    style?: Record<string, StyleConfig>;
+}

package/dist/src/spec/data.d.ts

@@ -250,6 +250,13 @@ export interface DebouncedData {
      */
     debounce?: number | ExprRef;
 
+    /**
+     * Debounce time for scale-domain driven data updates, in milliseconds.
+     *
+     * __Default value:__ `200`
+     */
+    debounceDomainChange?: number | ExprRef;
+
     /**
      * The debounce mode for data updates. If set to `"domain"`, domain change
      * events (panning and zooming) will be debounced. If set to `"window"`,