@genome-spy/core 0.73.0 → 0.74.0

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

@@ -6,17 +6,12 @@ import {
     FacetFieldDef,
     PrimaryPositionalChannel,
 } from "./channel.js";
-import {
-    FillAndStrokeProps,
-    MarkProps,
-    MarkType,
-    RectProps,
-    RuleProps,
-    ShadowProps,
-} from "./mark.js";
+import { MarkProps, MarkType, RuleProps } from "./mark.js";
 import { ExprRef } from "./parameter.js";
 import { Title } from "./title.js";
 import { Parameter } from "./parameter.js";
+import { GenomeSpyConfig } from "./config.js";
+import { ViewBackgroundProps, ZIndexProps } from "./decoration.js";
 
 export interface SizeDef {
     /**
@@ -84,22 +79,50 @@ export type Paddings = Partial<Record<Side, number>>;
 
 export type PaddingConfig = Paddings | number;
 
-interface CompleteViewBackground extends RectProps, FillAndStrokeProps {
-    // TODO: style?: string | string[];
+export interface ViewBackground extends ViewBackgroundProps {
+    /**
+     * Named style reference(s) resolved from `config.style`.
+     * If an array is provided, later styles override earlier ones.
+     *
+     * __Default value:__ `"cell"`
+     */
+    style?: string | string[];
 
-    // TODO: Move to FillAndStrokeProps or something
-    strokeWidth?: number;
-}
+    /**
+     * Z-order of the background fill 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`
+     */
+    zindex?: number;
 
-export type ViewBackground = Pick<
-    CompleteViewBackground,
-    "fill" | "fillOpacity" | "stroke" | "strokeWidth" | "strokeOpacity"
-> &
-    ShadowProps;
+    /**
+     * Z-order of the background stroke 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.
+     */
+    strokeZindex?: number;
+}
 
-export interface SeparatorProps extends Omit<RuleProps, "type"> {
+export interface SeparatorProps extends Omit<RuleProps, "type">, ZIndexProps {
     type?: "rule";
 
+    /**
+     * Z-order of the separator 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`
+     */
+    zindex?: number;
+
     /**
      * Whether separators extend into the plot margin (axes/padding) around
      * the grid.
@@ -118,6 +141,15 @@ export interface ViewSpecBase extends ResolveSpec {
      */
     name?: string;
 
+    /**
+     * Mouse cursor shown while the pointer is inside the view.
+     * The deepest matching cursor wins: mark cursor first, then the pointed
+     * view, then ancestor views outward toward the root.
+     *
+     * __Default value:__ browser default
+     */
+    cursor?: string | ExprRef;
+
     /**
      * Height of the view. If a number, it is interpreted as pixels.
      * Check [child sizing](https://genomespy.app/docs/grammar/composition/concat/#child-sizing)
@@ -172,6 +204,13 @@ export interface ViewSpecBase extends ResolveSpec {
      */
     params?: Parameter[];
 
+    /**
+     * Configures defaults for this view subtree.
+     *
+     * Properties in child views override properties inherited from ancestors.
+     */
+    config?: GenomeSpyConfig;
+
     /**
      * Specifies a [data source](https://genomespy.app/docs/grammar/data/).
      * If omitted, the data source is inherited from the parent view.
@@ -433,6 +472,15 @@ export interface ImportSpec {
      */
     visible?: boolean;
 
+    /**
+     * Configures defaults for the imported subtree at the import site.
+     *
+     * This config is merged before the imported spec's own root-level `config`,
+     * so imported specs can remain self-contained and override import-site
+     * defaults where needed.
+     */
+    config?: GenomeSpyConfig;
+
     /**
      * The method to import a specification.
      */

package/dist/src/styles/genome-spy.css

@@ -1,17 +1,17 @@
-:root {
-    --genome-spy-basic-spacing: 10px;
-    --genome-spy-font-family:
-        system-ui, "Segoe UI", Roboto, Helvetica, Arial, sans-serif,
-        "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
-}
+@scope {
+    :scope {
+        --genome-spy-basic-spacing: 10px;
+        --genome-spy-font-family:
+            system-ui, "Segoe UI", Roboto, Helvetica, Arial, sans-serif,
+            "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
 
-.genome-spy {
-    font-family: var(--genome-spy-font-family);
+        font-family: var(--genome-spy-font-family);
 
-    position: relative;
+        position: relative;
 
-    display: flex;
-    flex-direction: column;
+        display: flex;
+        flex-direction: column;
+    }
 
     .canvas-wrapper {
         position: relative;
@@ -190,6 +190,50 @@
         }
     }
 
+    .gs-input-binding {
+        display: grid;
+        grid-template-columns: max-content max-content;
+        column-gap: 1em;
+        row-gap: 0.3em;
+        justify-items: start;
+
+        > select,
+        > input:not([type="checkbox"]) {
+            width: 100%;
+        }
+
+        input[type="range"] + span {
+            display: inline-block;
+            margin-left: 0.3em;
+            min-width: 2.2em;
+            font-variant-numeric: tabular-nums;
+        }
+
+        input[type="range"],
+        input[type="radio"] {
+            vertical-align: text-bottom;
+        }
+
+        .radio-group {
+            display: flex;
+            align-items: center;
+        }
+
+        .description {
+            max-width: 26em;
+            grid-column: 1 / -1;
+            color: #777;
+            font-size: 90%;
+            margin-top: -0.5em;
+        }
+    }
+
+    .gs-input-bindings {
+        flex-basis: content;
+        font-size: 14px;
+        padding: var(--genome-spy-basic-spacing);
+    }
+
     .message-box {
         display: flex;
         align-items: center;
@@ -206,47 +250,3 @@
         }
     }
 }
-
-.gs-input-binding {
-    display: grid;
-    grid-template-columns: max-content max-content;
-    column-gap: 1em;
-    row-gap: 0.3em;
-    justify-items: start;
-
-    > select,
-    > input:not([type="checkbox"]) {
-        width: 100%;
-    }
-
-    input[type="range"] + span {
-        display: inline-block;
-        margin-left: 0.3em;
-        min-width: 2.2em;
-        font-variant-numeric: tabular-nums;
-    }
-
-    input[type="range"],
-    input[type="radio"] {
-        vertical-align: text-bottom;
-    }
-
-    .radio-group {
-        display: flex;
-        align-items: center;
-    }
-
-    .description {
-        max-width: 26em;
-        grid-column: 1 / -1;
-        color: #777;
-        font-size: 90%;
-        margin-top: -0.5em;
-    }
-}
-
-.gs-input-bindings {
-    flex-basis: content;
-    font-size: 14px;
-    padding: var(--genome-spy-basic-spacing);
-}

package/dist/src/styles/genome-spy.css.d.ts

@@ -1,3 +1,3 @@
 export default css;
-declare const css: "\n:root {\n--genome-spy-basic-spacing: 10px;\n--genome-spy-font-family: system-ui, \"Segoe UI\", Roboto, Helvetica, Arial,\nsans-serif, \"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\";\n}\n\n.genome-spy {\nfont-family: var(--genome-spy-font-family);\n\nposition: relative;\n\ndisplay: flex;\nflex-direction: column;\n\n.canvas-wrapper {\nposition: relative;\nflex-grow: 1;\noverflow: hidden;\n}\n\ncanvas {\ndisplay: block;\ntouch-action: none;\ntransform: scale(1, 1);\nopacity: 1;\ntransition:\ntransform 0.6s,\nopacity 0.6s;\n\n&:focus,\n&:focus-visible {\noutline: none;\n}\n}\n\n.loading {\n> canvas {\ntransform: scale(0.95, 0.95);\nopacity: 0;\n}\n}\n\n.loading-indicators {\nposition: absolute;\ninset: 0;\n\nuser-select: none;\npointer-events: none;\n\ndiv {\nposition: absolute;\ndisplay: flex;\nalign-items: center;\njustify-content: center;\n\n> div {\nfont-size: 11px;\ntransition: opacity 0.2s;\nbackground: white;\npadding: 2px 5px;\ndisplay: flex;\nborder-radius: 3px;\ngap: 0.5em;\nopacity: 0;\n\n&.loading {\nopacity: 0.5;\n}\n\n&.error {\nopacity: 0.8;\ncolor: firebrick;\n}\n\n> * {\ndisplay: block;\n}\n\nimg {\nwidth: 1.5em;\nheight: 1.5em;\n}\n}\n}\n}\n\n.tooltip {\nposition: absolute;\n\nmax-width: 450px;\noverflow: hidden;\n\n--background-color: #f6f6f6;\nbackground: var(--background-color);\npadding: var(--genome-spy-basic-spacing);\n\n--font-size: 12px;\nfont-size: var(--font-size);\n\nbox-shadow: 0px 3px 15px 0px rgba(0, 0, 0, 0.21);\n\n&:not(.sticky) {\npointer-events: none;\n}\n\ntransition:\noutline-color 0.3s ease-in-out,\nbox-shadow 0.3s ease-in-out;\n\noutline: 0px solid transparent;\n&.sticky {\noutline: 2px solid black;\nbox-shadow: 0px 3px 18px 0px rgba(0, 0, 0, 0.3);\n}\n\nz-index: 100;\n\n> :last-child {\nmargin-bottom: 0;\n}\n\n> .title {\npadding-bottom: calc(var(--genome-spy-basic-spacing) / 2);\nmargin-bottom: calc(var(--genome-spy-basic-spacing) / 2);\nborder-bottom: 1px dashed var(--background-color);\nborder-bottom: 1px dashed\ncolor-mix(in srgb, black 25%, var(--background-color));\n}\n\n.summary {\nfont-size: 12px;\n}\n\ntable {\n&:first-child {\nmargin-top: 0;\n}\n\nborder-collapse: collapse;\n\nth,\ntd {\npadding: 2px 0.4em;\nvertical-align: top;\nfont-size: var(--font-size);\n\n&:first-child {\npadding-left: 0;\n}\n}\n\nth {\ntext-align: left;\nfont-weight: bold;\n}\n}\n\n.color-legend {\ndisplay: inline-block;\nwidth: 0.8em;\nheight: 0.8em;\nmargin-left: 0.4em;\nbox-shadow: 0px 0px 3px 1px white;\n}\n\n.color-legend-unmapped {\nbackground-color: transparent;\nborder: 1px solid black;\nbox-sizing: border-box;\nbox-shadow: none;\n}\n\n.attributes {\n.hovered {\nbackground-color: #e0e0e0;\n}\n}\n\n.na {\ncolor: #aaa;\nfont-style: italic;\nfont-size: 80%;\n}\n}\n\n.gene-track-tooltip {\n.summary {\nfont-size: 90%;\n}\n}\n\n.message-box {\ndisplay: flex;\nalign-items: center;\njustify-content: center;\nposition: absolute;\ntop: 0;\nheight: 100%;\nwidth: 100%;\n\n> div {\nborder: 1px solid red;\npadding: 10px;\nbackground: #fff0f0;\n}\n}\n}\n\n.gs-input-binding {\ndisplay: grid;\ngrid-template-columns: max-content max-content;\ncolumn-gap: 1em;\nrow-gap: 0.3em;\njustify-items: start;\n\n> select,\n> input:not([type=\"checkbox\"]) {\nwidth: 100%;\n}\n\ninput[type=\"range\"] + span {\ndisplay: inline-block;\nmargin-left: 0.3em;\nmin-width: 2.2em;\nfont-variant-numeric: tabular-nums;\n}\n\ninput[type=\"range\"],\ninput[type=\"radio\"] {\nvertical-align: text-bottom;\n}\n\n.radio-group {\ndisplay: flex;\nalign-items: center;\n}\n\n.description {\nmax-width: 26em;\ngrid-column: 1 / -1;\ncolor: #777;\nfont-size: 90%;\nmargin-top: -0.5em;\n}\n}\n\n.gs-input-bindings {\nflex-basis: content;\nfont-size: 14px;\npadding: var(--genome-spy-basic-spacing);\n}\n";
+declare const css: "\n@scope {\n:scope {\n--genome-spy-basic-spacing: 10px;\n--genome-spy-font-family:\nsystem-ui, \"Segoe UI\", Roboto, Helvetica, Arial, sans-serif,\n\"Apple Color Emoji\", \"Segoe UI Emoji\", \"Segoe UI Symbol\";\n\nfont-family: var(--genome-spy-font-family);\n\nposition: relative;\n\ndisplay: flex;\nflex-direction: column;\n}\n\n.canvas-wrapper {\nposition: relative;\nflex-grow: 1;\noverflow: hidden;\n}\n\ncanvas {\ndisplay: block;\ntouch-action: none;\ntransform: scale(1, 1);\nopacity: 1;\ntransition:\ntransform 0.6s,\nopacity 0.6s;\n\n&:focus,\n&:focus-visible {\noutline: none;\n}\n}\n\n.loading {\n> canvas {\ntransform: scale(0.95, 0.95);\nopacity: 0;\n}\n}\n\n.loading-indicators {\nposition: absolute;\ninset: 0;\n\nuser-select: none;\npointer-events: none;\n\ndiv {\nposition: absolute;\ndisplay: flex;\nalign-items: center;\njustify-content: center;\n\n> div {\nfont-size: 11px;\ntransition: opacity 0.2s;\nbackground: white;\npadding: 2px 5px;\ndisplay: flex;\nborder-radius: 3px;\ngap: 0.5em;\nopacity: 0;\n\n&.loading {\nopacity: 0.5;\n}\n\n&.error {\nopacity: 0.8;\ncolor: firebrick;\n}\n\n> * {\ndisplay: block;\n}\n\nimg {\nwidth: 1.5em;\nheight: 1.5em;\n}\n}\n}\n}\n\n.tooltip {\nposition: absolute;\n\nmax-width: 450px;\noverflow: hidden;\n\n--background-color: #f6f6f6;\nbackground: var(--background-color);\npadding: var(--genome-spy-basic-spacing);\n\n--font-size: 12px;\nfont-size: var(--font-size);\n\nbox-shadow: 0px 3px 15px 0px rgba(0, 0, 0, 0.21);\n\n&:not(.sticky) {\npointer-events: none;\n}\n\ntransition:\noutline-color 0.3s ease-in-out,\nbox-shadow 0.3s ease-in-out;\n\noutline: 0px solid transparent;\n&.sticky {\noutline: 2px solid black;\nbox-shadow: 0px 3px 18px 0px rgba(0, 0, 0, 0.3);\n}\n\nz-index: 100;\n\n> :last-child {\nmargin-bottom: 0;\n}\n\n> .title {\npadding-bottom: calc(var(--genome-spy-basic-spacing) / 2);\nmargin-bottom: calc(var(--genome-spy-basic-spacing) / 2);\nborder-bottom: 1px dashed var(--background-color);\nborder-bottom: 1px dashed\ncolor-mix(in srgb, black 25%, var(--background-color));\n}\n\n.summary {\nfont-size: 12px;\n}\n\ntable {\n&:first-child {\nmargin-top: 0;\n}\n\nborder-collapse: collapse;\n\nth,\ntd {\npadding: 2px 0.4em;\nvertical-align: top;\nfont-size: var(--font-size);\n\n&:first-child {\npadding-left: 0;\n}\n}\n\nth {\ntext-align: left;\nfont-weight: bold;\n}\n}\n\n.color-legend {\ndisplay: inline-block;\nwidth: 0.8em;\nheight: 0.8em;\nmargin-left: 0.4em;\nbox-shadow: 0px 0px 3px 1px white;\n}\n\n.color-legend-unmapped {\nbackground-color: transparent;\nborder: 1px solid black;\nbox-sizing: border-box;\nbox-shadow: none;\n}\n\n.attributes {\n.hovered {\nbackground-color: #e0e0e0;\n}\n}\n\n.na {\ncolor: #aaa;\nfont-style: italic;\nfont-size: 80%;\n}\n}\n\n.gene-track-tooltip {\n.summary {\nfont-size: 90%;\n}\n}\n\n.gs-input-binding {\ndisplay: grid;\ngrid-template-columns: max-content max-content;\ncolumn-gap: 1em;\nrow-gap: 0.3em;\njustify-items: start;\n\n> select,\n> input:not([type=\"checkbox\"]) {\nwidth: 100%;\n}\n\ninput[type=\"range\"] + span {\ndisplay: inline-block;\nmargin-left: 0.3em;\nmin-width: 2.2em;\nfont-variant-numeric: tabular-nums;\n}\n\ninput[type=\"range\"],\ninput[type=\"radio\"] {\nvertical-align: text-bottom;\n}\n\n.radio-group {\ndisplay: flex;\nalign-items: center;\n}\n\n.description {\nmax-width: 26em;\ngrid-column: 1 / -1;\ncolor: #777;\nfont-size: 90%;\nmargin-top: -0.5em;\n}\n}\n\n.gs-input-bindings {\nflex-basis: content;\nfont-size: 14px;\npadding: var(--genome-spy-basic-spacing);\n}\n\n.message-box {\ndisplay: flex;\nalign-items: center;\njustify-content: center;\nposition: absolute;\ntop: 0;\nheight: 100%;\nwidth: 100%;\n\n> div {\nborder: 1px solid red;\npadding: 10px;\nbackground: #fff0f0;\n}\n}\n}\n";
 //# sourceMappingURL=genome-spy.css.d.ts.map

package/dist/src/styles/genome-spy.css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genome-spy.css.d.ts","sourceRoot":"","sources":["../../../src/styles/genome-spy.css.js"],"names":[],"mappings":";AAAA,osHA4PE"}
+{"version":3,"file":"genome-spy.css.d.ts","sourceRoot":"","sources":["../../../src/styles/genome-spy.css.js"],"names":[],"mappings":";AAAA,isHA6PE"}

package/dist/src/styles/genome-spy.css.js

@@ -1,17 +1,18 @@
 const css = `
-:root {
+@scope {
+:scope {
 --genome-spy-basic-spacing: 10px;
---genome-spy-font-family: system-ui, "Segoe UI", Roboto, Helvetica, Arial,
-sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
-}
+--genome-spy-font-family:
+system-ui, "Segoe UI", Roboto, Helvetica, Arial, sans-serif,
+"Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol";
 
-.genome-spy {
 font-family: var(--genome-spy-font-family);
 
 position: relative;
 
 display: flex;
 flex-direction: column;
+}
 
 .canvas-wrapper {
 position: relative;
@@ -190,23 +191,6 @@ font-size: 90%;
 }
 }
 
-.message-box {
-display: flex;
-align-items: center;
-justify-content: center;
-position: absolute;
-top: 0;
-height: 100%;
-width: 100%;
-
-> div {
-border: 1px solid red;
-padding: 10px;
-background: #fff0f0;
-}
-}
-}
-
 .gs-input-binding {
 display: grid;
 grid-template-columns: max-content max-content;
@@ -250,5 +234,22 @@ flex-basis: content;
 font-size: 14px;
 padding: var(--genome-spy-basic-spacing);
 }
+
+.message-box {
+display: flex;
+align-items: center;
+justify-content: center;
+position: absolute;
+top: 0;
+height: 100%;
+width: 100%;
+
+> div {
+border: 1px solid red;
+padding: 10px;
+background: #fff0f0;
+}
+}
+}
 `;
 export default css;

package/dist/src/testSetup.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=testSetup.d.ts.map

package/dist/src/testSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testSetup.d.ts","sourceRoot":"","sources":["../../src/testSetup.js"],"names":[],"mappings":""}

package/dist/src/testSetup.js

@@ -0,0 +1,5 @@
+import "./data/formats/parquet.js";
+import "./data/formats/bed.js";
+import "./data/formats/bedpe.js";
+import "./data/formats/fasta.js";
+import "./data/sources/lazy/registerBuiltInLazySources.js";

package/dist/src/tooltip/dataTooltipHandler.js

@@ -1,5 +1,6 @@
 import { html } from "lit";
 import { splitAccessPath } from "vega-util";
+import { getEncoderDataAccessor } from "../encoder/encoder.js";
 import formatObject from "../utils/formatObject.js";
 import { flattenDatumRows } from "./flattenDatumRows.js";
 import createTooltipContext from "./tooltipContext.js";
@@ -35,7 +36,9 @@ export default async function dataTooltipHandler(datum, mark, params, context) {
      */
     const legend = (key, value, datum) => {
         for (const [channel, encoder] of Object.entries(mark.encoders)) {
-            const fields = encoder?.dataAccessor?.fields;
+            const fields = encoder
+                ? getEncoderDataAccessor(encoder)?.fields
+                : undefined;
             if (
                 fields &&
                 fields.some(
@@ -88,7 +91,10 @@ export default async function dataTooltipHandler(datum, mark, params, context) {
     const genomicRows = tooltipContext.genomicRows ?? [];
     const hiddenRowKeys = new Set(tooltipContext.hiddenRowKeys ?? []);
 
-    const visibleRawRows = rawRows.filter((row) => !hiddenRowKeys.has(row.key));
+    const visibleRawRows = rawRows.filter(
+        (row) =>
+            !hiddenRowKeys.has(row.key) || legend(row.key, row.value, datum)
+    );
     const orderedRows = [...genomicRows, ...visibleRawRows];
     if (!orderedRows.length) {
         return;

package/dist/src/tooltip/tooltipContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tooltipContext.d.ts","sourceRoot":"","sources":["../../../src/tooltip/tooltipContext.js"],"names":[],"mappings":"AA2BA;;;;;;;GAOG;AACH,oDALW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QACnB,OAAO,kBAAkB,EAAE,OAAO,WAClC,OAAO,qBAAqB,EAAE,oBAAoB,GAChD,cAAc,CAgE1B;6BAhGY,OAAO,qBAAqB,EAAE,cAAc;wCAC5C,OAAO,qBAAqB,EAAE,yBAAyB;yBACvD,OAAO,qBAAqB,EAAE,UAAU"}
+{"version":3,"file":"tooltipContext.d.ts","sourceRoot":"","sources":["../../../src/tooltip/tooltipContext.js"],"names":[],"mappings":"AA4BA;;;;;;;GAOG;AACH,oDALW,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QACnB,OAAO,kBAAkB,EAAE,OAAO,WAClC,OAAO,qBAAqB,EAAE,oBAAoB,GAChD,cAAc,CAgE1B;6BAjGY,OAAO,qBAAqB,EAAE,cAAc;wCAC5C,OAAO,qBAAqB,EAAE,yBAAyB;yBACvD,OAAO,qBAAqB,EAAE,UAAU"}

package/dist/src/tooltip/tooltipContext.js

@@ -5,6 +5,7 @@
  */
 
 import { asArray } from "../utils/arrayUtils.js";
+import { getEncoderDataAccessor } from "../encoder/encoder.js";
 import { flattenDatumRows } from "./flattenDatumRows.js";
 
 /** @type {Record<"x" | "y", "x2" | "y2">} */
@@ -366,7 +367,7 @@ function readLocusCoordinate(mark, channel, datum) {
         return;
     }
 
-    const accessor = encoder.dataAccessor;
+    const accessor = getEncoderDataAccessor(encoder);
     if (!accessor) {
         return;
     }
@@ -535,7 +536,7 @@ function verifyLinearizationMapping(datum, linearizedField, mapping, mark) {
     let expected;
     try {
         expected = genome.toContinuous(chrom, numericPos - mapping.offset);
-    } catch (_error) {
+    } catch {
         return false;
     }
 

package/dist/src/types/embedApi.d.ts

@@ -1,6 +1,7 @@
 import { ScaleResolutionApi } from "./scaleResolutionApi.js";
 import { TooltipHandler } from "../tooltip/tooltipHandler.js";
 import { RootSpec } from "../spec/root.js";
+import { GenomeSpyConfig } from "../spec/config.js";
 
 /**
  * Embeds GenomeSpy into the DOM
@@ -41,6 +42,12 @@ export interface EmbedOptions {
      */
     powerPreference?: "default" | "high-performance" | "low-power";
 
+    /**
+     * Optional theme configuration object that is merged after the internal
+     * defaults and built-in theme, but before `spec.config`.
+     */
+    theme?: GenomeSpyConfig;
+
     /**
      * Optional hook for handling launch errors. Return true to suppress default UI.
      */

package/dist/src/types/encoder.d.ts

@@ -25,7 +25,6 @@ import { ScaleLocus } from "../genome/scaleLocus.js";
 import { ScaleIndex } from "../genome/scaleIndex.js";
 import { Scalar } from "../spec/channel.js";
 import { Datum } from "../data/flowNode.js";
-import { ExprRefFunction } from "../paramRuntime/types.js";
 
 export interface Accessor<T = Scalar> {
     (datum: Datum): T;
@@ -86,11 +85,6 @@ export interface Accessor<T = Scalar> {
      * Format: <type>|<domainKeyBase>
      */
     domainKey?: string;
-
-    /**
-     * This accessor should be used when the predicate is true
-     */
-    predicate: Predicate;
 }
 
 export interface ScaleAccessor<T = Scalar> extends Accessor<T> {
@@ -99,7 +93,9 @@ export interface ScaleAccessor<T = Scalar> extends Accessor<T> {
     domainKeyBase: string;
 }
 
-export interface Predicate extends ExprRefFunction {
+export interface Predicate {
+    (datum: Datum): boolean;
+
     /**
      * The parameter the predicate is based on
      */
@@ -113,6 +109,18 @@ export interface Predicate extends ExprRefFunction {
     empty?: boolean;
 }
 
+export interface EncodingBranch {
+    /**
+     * The accessor used by this branch.
+     */
+    accessor: Accessor;
+
+    /**
+     * Predicate controlling whether this branch is active.
+     */
+    predicate: Predicate;
+}
+
 /**
  * Wraps one or more accessors, uses an optional scale to encode the data.
  */
@@ -134,15 +142,9 @@ export interface Encoder {
     scale?: VegaScale;
 
     /**
-     * An accessor, or if the ChannelDef has conditions, all the accessors.
-     */
-    accessors: Accessor[];
-
-    /**
-     * The encoded channel may have a maximum of one accessor accessing the
-     * data fields. It's this one.
+     * Ordered branches of this encoder. The last branch is the fallback branch.
      */
-    dataAccessor?: Accessor;
+    branches: EncodingBranch[];
 
     /**
      * The ChannelDef that the encoder is based on

package/dist/src/types/scaleResolutionApi.d.ts

@@ -29,12 +29,32 @@ export interface ScaleResolutionApi {
      */
     getDomain(): any[];
 
+    /**
+     * Returns true if the domain has been provided explicitly in the spec.
+     */
+    isDomainDefinedExplicitly(): boolean;
+
+    /**
+     * Returns true when the scale domain has moved beyond the placeholder startup state.
+     */
+    isDomainInitialized(): boolean;
+
     /**
      * Returns the current, possible zoomed domain converted into complex objects
      * such as genomic coordinates.
      */
     getComplexDomain(): NumericDomain | ComplexDomain;
 
+    getLinkedSelectionDomainInfo():
+        | {
+              param: string;
+              encoding: "x" | "y";
+              persist: boolean;
+          }
+        | undefined;
+
+    isZoomed(): boolean;
+
     isZoomable(): boolean;
 
     zoomTo(

package/dist/src/types/viewContext.d.ts

@@ -18,6 +18,10 @@ export interface Hover {
 
 export type DataLoadingStatus = "loading" | "complete" | "error";
 
+export interface CreateViewOptions {
+    layoutSizeParams?: "own" | "inherit";
+}
+
 /**
  * ViewContext provides essential data and interfaces to View classes.
  */
@@ -37,6 +41,18 @@ export default interface ViewContext {
 
     getCurrentHover: () => Hover;
 
+    /**
+     * Internal interaction hook: suspends hover recomputation during active
+     * drag interactions.
+     */
+    suspendHoverTracking: () => void;
+
+    /**
+     * Internal interaction hook: resumes hover recomputation after an active
+     * drag interaction.
+     */
+    resumeHoverTracking: (event?: MouseEvent) => void;
+
     /**
      * Adds a keyboard event listener to the document. Cleanup is performed automatically
      * when GenomeSpy is finalized.
@@ -82,6 +98,11 @@ export default interface ViewContext {
 
     isViewSpec: (spec: any) => boolean;
 
+    /**
+     * Returns the base config scope used for root-level resolution.
+     */
+    getBaseConfig: () => GenomeSpyConfig;
+
     /**
      *
      * @param spec
@@ -100,6 +121,7 @@ export default interface ViewContext {
          * Validates whether the imported spec is acceptable for the importer.
          * The function should throw an Error if the view is not acceptable.
          */
-        validator?: (spec: ViewSpec) => void
+        validator?: (spec: ViewSpec) => void,
+        options?: CreateViewOptions
     ) => Promise<View>;
 }

package/dist/src/utils/expression.d.ts

@@ -12,9 +12,9 @@
 export default function createFunction(expr: string, globalObject?: {}): ExpressionFunction;
 /**
  * @param {string} expr
- * @returns {(event: UIEvent) => boolean}
+ * @returns {(event: UIEvent | import("./interactionEvent.js").WheelLikeEvent) => boolean}
  */
-export function createEventFilterFunction(expr: string): (event: UIEvent) => boolean;
+export function createEventFilterFunction(expr: string): (event: UIEvent | import("./interactionEvent.js").WheelLikeEvent) => boolean;
 export type ExpressionProps = {
     fields: string[];
     globals: string[];

package/dist/src/utils/expression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/utils/expression.js"],"names":[],"mappings":"AAuEA;;;;;;;;;;GAUG;AACH,6CAHW,MAAM,sBACJ,kBAAkB,CAgC9B;AAQD;;;GAGG;AACH,gDAHW,MAAM,GACJ,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CA2BvC;;YA5EU,MAAM,EAAE;aACR,MAAM,EAAE;UACR,MAAM;;iCAEH,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,qBAAqB,EAAE,KAAK,KAAK,GAAG,CAAC,GAAG,eAAe"}
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/utils/expression.js"],"names":[],"mappings":"AA4HA;;;;;;;;;;GAUG;AACH,6CAHW,MAAM,sBACJ,kBAAkB,CAiC9B;AAQD;;;GAGG;AACH,gDAHW,MAAM,GACJ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,uBAAuB,EAAE,cAAc,KAAK,OAAO,CA4BxF;;YA9EU,MAAM,EAAE;aACR,MAAM,EAAE;UACR,MAAM;;iCAEH,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,qBAAqB,EAAE,KAAK,KAAK,GAAG,CAAC,GAAG,eAAe"}