@genome-spy/core 0.73.0 → 0.75.0

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

@@ -1,24 +1,32 @@
 /**
- * @typedef { object } ExpressionProps
- * @prop { string[] } fields
- * @prop { string[] } globals
- * @prop { string } code
- *
- * @typedef { ((datum?: import("../data/flowNode.js").Datum) => any) & ExpressionProps } ExpressionFunction
- *
  * @param {string} expr
+ * @param {Record<string, any>} globalObject
+ * @param {ExpressionCompileContext} context
+ *
  * @returns {ExpressionFunction}
  */
-export default function createFunction(expr: string, globalObject?: {}): ExpressionFunction;
+export default function createFunction(expr: string, globalObject?: Record<string, any>, context?: ExpressionCompileContext): 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[];
     code: string;
+    scaleDependencies?: import("../paramRuntime/types.js").ParamRef<any>[];
 };
 export type ExpressionFunction = ((datum?: import("../data/flowNode.js").Datum) => any) & ExpressionProps;
+export type ExpressionCompileContext = {
+    resolveScaleResolution?: (channel: string) => import("../scales/scaleResolution.js").default | undefined;
+};
+export type ScaleHelperCompileContext = ExpressionCompileContext & {
+    globalvar: string;
+    globalObject: Record<string, any>;
+    getScaleHelper: (kind: "scale" | "invert" | "domain" | "range", channel: string, resolution: import("../scales/scaleResolution.js").default) => {
+        codeName: string;
+        dependency: import("../paramRuntime/types.js").ParamRef<any>;
+    };
+};
 //# sourceMappingURL=expression.d.ts.map

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":"AAkVA;;;;;;GAMG;AACH,6CANW,MAAM,iBACN,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,YACnB,wBAAwB,GAEtB,kBAAkB,CAuG9B;AAQD;;;GAGG;AACH,gDAHW,MAAM,GACJ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,uBAAuB,EAAE,cAAc,KAAK,OAAO,CA4BxF;;YAjVU,MAAM,EAAE;aACR,MAAM,EAAE;UACR,MAAM;wBACN,OAAO,0BAA0B,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;;iCAE/C,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,qBAAqB,EAAE,KAAK,KAAK,GAAG,CAAC,GAAG,eAAe;;6BAG5E,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,8BAA8B,EAAE,OAAO,GAAG,SAAS;;wCAE5E,wBAAwB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClC,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,8BAA8B,EAAE,OAAO,KAAK;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,0BAA0B,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;CACnO"}