@genome-spy/core 0.73.0 → 0.74.0

package/dist/src/encoder/encoder.js

@@ -2,62 +2,155 @@ import {
     isIntervalSelection,
     makeSelectionTestExpression,
 } from "../selection/selection.js";
-import { createConditionalAccessors } from "./accessor.js";
+import { createAccessor } from "./accessor.js";
+import { makeConstantExprRef } from "../paramRuntime/paramUtils.js";
 
 /**
- * TODO: Complete this. Not tested yet.
- *
- * Creates a selection predicate that can be used in conditional encoding.
+ * Creates a host-side predicate for selection-driven conditional encoding.
+ * The selection test expression is compiled lazily when the predicate is
+ * first evaluated so encoder construction does not depend on eager selection
+ * materialization.
  *
  * @param {string} param
  * @param {import("../spec/channel.js").Encoding} encoding
  * @param {{ findValue: (param: string) => any, createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  * @param {boolean} empty
+ * @returns {import("../types/encoder.js").Predicate}
  */
-// eslint-disable-next-line no-unused-vars
-function createSelectionPredicate(param, encoding, paramRuntime, empty) {
-    const selection =
-        /** @type {import("../types/selectionTypes.js").Selection} */ (
+export function createSelectionPredicate(param, encoding, paramRuntime, empty) {
+    /**
+     * @typedef {import("../data/flowNode.js").Datum} Datum
+     * @typedef {import("../types/selectionTypes.js").Selection} Selection
+     * @typedef {import("../types/encoder.js").Predicate} Predicate
+     */
+
+    /** @type {import("../paramRuntime/types.js").ExprRefFunction | undefined} */
+    let compiled;
+
+    const fallback = makeConstantExprRef(false);
+
+    const ensureCompiled = () => {
+        if (compiled) {
+            return compiled;
+        }
+
+        const selection = /** @type {Selection | undefined} */ (
             paramRuntime.findValue(param)
         );
-    if (!selection) {
-        throw new Error(`No selection parameter found: ${param}`);
-    }
+        if (!selection) {
+            return fallback;
+        }
 
-    /** @type {Partial<Record<import("../spec/channel.js").PositionalChannel, import("../spec/channel.js").Field>>} */
-    const fields = {};
-    if (isIntervalSelection(selection)) {
-        const channels = Object.keys(selection.intervals);
-        for (const channel of channels) {
-            const channelDef = encoding[channel];
-            if (isFieldDef(channelDef)) {
-                fields[channel] = channelDef.field;
-                continue;
-            } else if ("condition" in channelDef) {
-                const condition = channelDef.condition;
-                if (isFieldDef(condition)) {
-                    fields[channel] = condition.field;
+        /** @type {Partial<Record<import("../spec/channel.js").PositionalChannel, import("../spec/channel.js").Field>>} */
+        const fields = {};
+        if (isIntervalSelection(selection)) {
+            const channels = Object.keys(selection.intervals);
+            for (const channel of channels) {
+                const channelDef = encoding[channel];
+                if (isFieldDef(channelDef)) {
+                    fields[channel] = channelDef.field;
                     continue;
+                } else if (channelDef && "condition" in channelDef) {
+                    const condition = channelDef.condition;
+                    if (isFieldDef(condition)) {
+                        fields[channel] = condition.field;
+                        continue;
+                    }
                 }
+                throw new Error(
+                    `Selection "${param}" has an interval for "${channel}" channel, but could not find a fieldDef: ${JSON.stringify(encoding[channel])}`
+                );
             }
-            throw new Error(
-                `Selection "${param}" has an interval for "${channel}" channel, but could not find a fieldDef: ${JSON.stringify(encoding[channel])}`
-            );
         }
-    }
 
-    const expr = makeSelectionTestExpression(
-        { type: "filter", param, fields, empty },
-        selection
+        const expr = makeSelectionTestExpression(
+            { type: "filter", param, fields, empty },
+            selection
+        );
+
+        compiled = paramRuntime.createExpression(expr);
+        return compiled;
+    };
+
+    /** @type {Predicate} */
+    const predicate = Object.assign(
+        /** @param {Datum} datum */ (datum) => ensureCompiled()(datum),
+        {
+            param,
+            empty: empty ?? true,
+        }
     );
 
-    return paramRuntime.createExpression(expr);
+    return predicate;
 }
 
 /**
- * Creates an object that contains encoders for every channel of a mark
+ * Creates ordered conditional branches for a channel definition. The last
+ * branch is always the fallback branch.
  *
- * TODO: This method should have a test. But how to mock Mark...
+ * @param {import("../spec/channel.js").Channel} channel
+ * @param {import("../spec/channel.js").ChannelDef} channelDef
+ * @param {import("../spec/channel.js").Encoding} encoding
+ * @param {{ createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction, findValue: (param: string) => any }} paramRuntime
+ * @returns {import("../types/encoder.js").EncodingBranch[]}
+ */
+export function createConditionalBranches(
+    channel,
+    channelDef,
+    encoding,
+    paramRuntime
+) {
+    const conditions =
+        isFieldOrDatumDefWithCondition(channelDef) ||
+        isValueDefWithCondition(channelDef)
+            ? Array.isArray(channelDef.condition)
+                ? channelDef.condition
+                : [channelDef.condition]
+            : [];
+
+    const branchChannelDefs = [...conditions, channelDef];
+
+    /** @type {import("../types/encoder.js").EncodingBranch[]} */
+    const branches = branchChannelDefs.map((branchChannelDef, index) => {
+        const condition = conditions[index];
+        const accessor = createAccessor(
+            channel,
+            branchChannelDef,
+            paramRuntime
+        );
+
+        /** @type {import("../types/encoder.js").Predicate} */
+        const predicate = condition?.param
+            ? createSelectionPredicate(
+                  condition.param,
+                  encoding,
+                  paramRuntime,
+                  condition.empty
+              )
+            : Object.assign(
+                  makeConstantExprRef(index === branchChannelDefs.length - 1),
+                  {
+                      empty: false,
+                  }
+              );
+
+        return {
+            accessor,
+            predicate,
+        };
+    });
+
+    if (branches.filter((branch) => !branch.accessor.constant).length > 1) {
+        throw new Error(
+            "Only one accessor can be non-constant. Channel: " + channel
+        );
+    }
+
+    return branches;
+}
+
+/**
+ * Creates encoders for direct mark-property channels in an encoding object.
  *
  * @param {import("../view/unitView.js").default} unitView
  * @param {import("../spec/channel.js").Encoding} encoding
@@ -91,9 +184,10 @@ export default function createEncoders(unitView, encoding) {
         const typedChannelDef =
             /** @type {import("../spec/channel.js").ChannelDef} */ (channelDef);
         encoders[typedChannel] = createSimpleOrConditionalEncoder(
-            createConditionalAccessors(
+            createConditionalBranches(
                 typedChannel,
                 typedChannelDef,
+                encoding,
                 unitView.paramRuntime
             ),
             scaleSource
@@ -116,23 +210,46 @@ export function isNonMarkPropertyChannel(channel) {
 }
 
 /**
- * @param {import("../types/encoder.js").Accessor[]} accessors
+ * @param {import("../types/encoder.js").Encoder} encoder
+ * @returns {import("../types/encoder.js").Accessor[]}
+ */
+export function getEncoderAccessors(encoder) {
+    return encoder.branches.map((branch) => branch.accessor);
+}
+
+/**
+ * @param {import("../types/encoder.js").Encoder} encoder
+ * @returns {import("../types/encoder.js").Accessor | undefined}
+ */
+export function getEncoderDataAccessor(encoder) {
+    return encoder.branches.find((branch) => !branch.accessor.constant)
+        ?.accessor;
+}
+
+/**
+ * Creates an encoder from ordered branches. The first matching branch wins.
+ *
+ * @param {import("../types/encoder.js").EncodingBranch[]} branches
  * @param {(channel: import("../spec/channel.js").ChannelWithScale) => import("../types/encoder.js").VegaScale} scaleSource
  * @returns {Encoder}
  */
-export function createSimpleOrConditionalEncoder(accessors, scaleSource) {
+export function createSimpleOrConditionalEncoder(branches, scaleSource) {
     /**
      * @typedef {import("../types/encoder.js").Encoder} Encoder
-     * @typedef {import("../types/encoder.js").Accessor} Accessor
      * @typedef {import("../data/flowNode.js").Datum} Datum
      */
-    if (accessors.length === 1) {
-        return createEncoder(accessors[0], scaleSource);
+    if (branches.length === 1) {
+        const encoder = createEncoder(branches[0].accessor, scaleSource);
+        return Object.assign(encoder, {
+            branches,
+        });
     }
 
-    const predicates = accessors.map((a) => a.predicate);
+    const predicates = branches.map((branch) => branch.predicate);
 
-    const encoders = accessors.map((a) => createEncoder(a, scaleSource));
+    const encoders = branches.map((branch) =>
+        createEncoder(branch.accessor, scaleSource)
+    );
 
     const encoder = Object.assign(
         (/** @type {Datum} */ datum) => {
@@ -144,12 +261,9 @@ export function createSimpleOrConditionalEncoder(accessors, scaleSource) {
         },
         {
             constant: false,
-            accessors: /** @type {Accessor[]} */ (
-                encoders.map((e) => e.accessors[0])
-            ),
-            dataAccessor: encoders.map((e) => e.dataAccessor).find((a) => a),
+            branches,
             scale: encoders.map((e) => e.scale).find((s) => s),
-            channelDef: accessors.at(-1).channelDef,
+            channelDef: branches.at(-1).accessor.channelDef,
         }
     );
 
@@ -157,6 +271,8 @@ export function createSimpleOrConditionalEncoder(accessors, scaleSource) {
 }
 
 /**
+ * Wraps a single accessor with optional scale application and encoder metadata.
+ *
  * @param {Accessor} accessor
  * @param {(channel: import("../spec/channel.js").ChannelWithScale) => import("../types/encoder.js").VegaScale} scaleSource
  * @returns {Encoder}
@@ -189,17 +305,18 @@ export function createEncoder(accessor, scaleSource) {
         {
             scale,
             constant: accessor.constant,
-            accessors: [accessor],
-            dataAccessor: accessor.constant ? undefined : accessor,
-            // TODO: Accessor already has the channelDef
+            branches: [
+                {
+                    accessor,
+                    predicate: makeConstantExprRef(true),
+                },
+            ],
             channelDef,
         }
     );
 }
 
 /**
- * TODO: Move to a more generic place
- *
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  * @returns {channelDef is import("../spec/channel.js").ValueDef}
  */
@@ -224,11 +341,13 @@ export function isDatumDef(channelDef) {
 }
 
 /**
+ * Returns true for direct channel definitions that participate in scale
+ * resolution. Conditional wrappers must be unwrapped by the caller first.
+ *
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  * @returns {channelDef is import("../spec/channel.js").ChannelDefWithScale}
  */
 export function isChannelDefWithScale(channelDef) {
-    // TODO: Not accurate, fix
     return (
         isFieldDef(channelDef) ||
         isDatumDef(channelDef) ||
@@ -257,11 +376,16 @@ export function findChannelDefWithScale(channelDef) {
  */
 export function getChannelDefWithScale(view, channel) {
     const channelDef = view.mark.encoding[channel];
-    if (!Array.isArray(channelDef) && isChannelDefWithScale(channelDef)) {
-        return channelDef;
+    if (!Array.isArray(channelDef)) {
+        const channelDefWithScale = findChannelDefWithScale(channelDef);
+        if (channelDefWithScale) {
+            return channelDefWithScale;
+        }
     } else {
         throw new Error("Not a channel def with scale!");
     }
+
+    throw new Error("Not a channel def with scale!");
 }
 
 /**

package/dist/src/fonts/bmFontManager.js

@@ -131,7 +131,7 @@ export default class BmFontManager {
 
             fontEntry.texture = await texturePromise;
             fontEntry.metrics = await metricsPromise;
-        } catch (error) {
+        } catch {
             console.warn(
                 `Cannot load font: "${key.family}". Using the embedded default font.`
             );

package/dist/src/full.d.ts

@@ -0,0 +1,2 @@
+export * from "./index.js";
+//# sourceMappingURL=full.d.ts.map

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

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

package/dist/src/full.js

@@ -0,0 +1,2 @@
+// Explicit alias for the default fat core entry point.
+export * from "./index.js";

package/dist/src/genome/genome.d.ts

@@ -18,6 +18,14 @@ export function isChromosomalLocus(value: any): value is ChromosomalLocus;
  * @return {value is ChromosomalLocus[]}
  */
 export function isChromosomalLocusInterval(value: any[]): value is ChromosomalLocus[];
+/**
+ * Returns true when the right bound is an explicit locus position rather than a
+ * chromosome shortcut such as `{ chrom: "chr2" }`.
+ *
+ * @param {any} value
+ * @returns {value is ChromosomalLocus[]}
+ */
+export function hasExplicitLocusUpperBound(value: any): value is ChromosomalLocus[];
 /**
  * @param {any} value
  * @returns {value is GenomeConfig}

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

@@ -1 +1 @@
-{"version":3,"file":"genome.d.ts","sourceRoot":"","sources":["../../../src/genome/genome.js"],"names":[],"mappings":"AA2XA;;;GAGG;AACH,gDAFW,MAAM;;;IAOhB;AAED;;;;GAIG;AACH,0CAHW,GAAG,GACF,KAAK,IAAI,gBAAgB,CAIpC;AAED;;;;GAIG;AACH,kDAHW,GAAG,EAAE,GACJ,KAAK,IAAI,gBAAgB,EAAE,CAItC;AAED;;;GAGG;AACH,sCAHW,GAAG,GACD,KAAK,IAAI,YAAY,CASjC;AAED;;;GAGG;AACH,yCAHW,GAAG,GACD,KAAK,IAAI,OAAO,mBAAmB,EAAE,eAAe,CAIhE;AAED;;;GAGG;AACH,4CAHW,GAAG,GACD,KAAK,IAAI,OAAO,mBAAmB,EAAE,kBAAkB,CAInE;AA5aD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;IACI;;OAEG;IACH,oBAFW,YAAY,EA6CtB;IA1CG;;;;;;;;MAA2C;IAc3C,oDAAoD;IACpD,aADW,CAAC,UAAU,GAAG,oBAAoB,CAAC,EAAE,CAC3B;IAErB,2CAA2C;IAC3C,0BADW,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CACE;IAEzC,sEAAsE;IACtE,mBADW,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,GAAG,oBAAoB,CAAC,CAChC;IAElC,uBAAuB;IACvB,cADW,MAAM,EAAE,CACG;IAEtB,kBAAkB;IAkBtB,mBAEC;IAED;;OAEG;IACH,cAFW,MAAM,iBAmBhB;IAED,wBAEC;IAED;;;OAGG;IACH,0BAFW,UAAU,EAAE,QA+CtB;IAED,sBAEC;IAED;;;;;OAKG;IACH,oBAHW,MAAM,GAAG,MAAM,OACf,MAAM,UAShB;IAED;;;OAGG;IACH,4BAFW,MAAM,qCAgBhB;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,gBAAgB,CAY5B;IAED;;;OAGG;IACH,oBAFW,MAAM,qCAIhB;IAED;;;;;;;;;;OAUG;IACH,yBAHW,MAAM,EAAE,GACN,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;OAGG;IACH,gCAHW,MAAM,EAAE,GACN,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAUhD;IAED;;;;;;OAMG;IACH,kCAFW,gBAAgB,EAAE,YAgB5B;IAED;;;;;OAKG;IACH,wCAHW,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAClC,0BAA0B,EAAE,CAiCxC;IAED;;;;OAIG;IACH,4DAFW,MAAM,EAAE,gCAOlB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,CAAC,MAAM,EAAE,MAAM,CAAC,CAgC5B;CACJ;2BAjXY,OAAO,mBAAmB,EAAE,YAAY;+BACxC,OAAO,mBAAmB,EAAE,gBAAgB;;UAG/C,MAAM;UACN,MAAM;;;;;;WAGN,MAAM;;;;YACN,MAAM;;;;qBACN,MAAM;;;;mBACN,MAAM;wBACN,MAAM,EAAE;;;;SACR,OAAO;;;WAGP,MAAM;cACN,MAAM;YACN,MAAM"}
+{"version":3,"file":"genome.d.ts","sourceRoot":"","sources":["../../../src/genome/genome.js"],"names":[],"mappings":"AA2XA;;;GAGG;AACH,gDAFW,MAAM;;;IAOhB;AAED;;;;GAIG;AACH,0CAHW,GAAG,GACF,KAAK,IAAI,gBAAgB,CAIpC;AAED;;;;GAIG;AACH,kDAHW,GAAG,EAAE,GACJ,KAAK,IAAI,gBAAgB,EAAE,CAItC;AAED;;;;;;GAMG;AACH,kDAHW,GAAG,GACD,KAAK,IAAI,gBAAgB,EAAE,CAOvC;AAED;;;GAGG;AACH,sCAHW,GAAG,GACD,KAAK,IAAI,YAAY,CASjC;AAED;;;GAGG;AACH,yCAHW,GAAG,GACD,KAAK,IAAI,OAAO,mBAAmB,EAAE,eAAe,CAIhE;AAED;;;GAGG;AACH,4CAHW,GAAG,GACD,KAAK,IAAI,OAAO,mBAAmB,EAAE,kBAAkB,CAInE;AA1bD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;IACI;;OAEG;IACH,oBAFW,YAAY,EA6CtB;IA1CG;;;;;;;;MAA2C;IAc3C,oDAAoD;IACpD,aADW,CAAC,UAAU,GAAG,oBAAoB,CAAC,EAAE,CAC3B;IAErB,2CAA2C;IAC3C,0BADW,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CACE;IAEzC,sEAAsE;IACtE,mBADW,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,GAAG,oBAAoB,CAAC,CAChC;IAElC,uBAAuB;IACvB,cADW,MAAM,EAAE,CACG;IAEtB,kBAAkB;IAkBtB,mBAEC;IAED;;OAEG;IACH,cAFW,MAAM,iBAoBhB;IAED,wBAEC;IAED;;;OAGG;IACH,0BAFW,UAAU,EAAE,QA8CtB;IAED,sBAEC;IAED;;;;;OAKG;IACH,oBAHW,MAAM,GAAG,MAAM,OACf,MAAM,UAShB;IAED;;;OAGG;IACH,4BAFW,MAAM,qCAgBhB;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,gBAAgB,CAY5B;IAED;;;OAGG;IACH,oBAFW,MAAM,qCAIhB;IAED;;;;;;;;;;OAUG;IACH,yBAHW,MAAM,EAAE,GACN,MAAM,CAIlB;IAED;;;;;;OAMG;IACH,2BAHW,MAAM,GACJ,MAAM,CAQlB;IAED;;;OAGG;IACH,gCAHW,MAAM,EAAE,GACN,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAUhD;IAED;;;;;;OAMG;IACH,kCAFW,gBAAgB,EAAE,YAgB5B;IAED;;;;;OAKG;IACH,wCAHW,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAClC,0BAA0B,EAAE,CAiCxC;IAED;;;;OAIG;IACH,4DAFW,MAAM,EAAE,gCAOlB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,CAAC,MAAM,EAAE,MAAM,CAAC,CAgC5B;CACJ;2BAjXY,OAAO,mBAAmB,EAAE,YAAY;+BACxC,OAAO,mBAAmB,EAAE,gBAAgB;;UAG/C,MAAM;UACN,MAAM;;;;;;WAGN,MAAM;;;;YACN,MAAM;;;;qBACN,MAAM;;;;mBACN,MAAM;wBACN,MAAM,EAAE;;;;SACR,OAAO;;;WAGP,MAAM;cACN,MAAM;YACN,MAAM"}

package/dist/src/genome/genome.js

@@ -97,7 +97,8 @@ export default class Genome {
             this.setChromSizes(parseChromSizes(await result.text()));
         } catch (e) {
             throw new Error(
-                `Could not load chrom sizes: ${this.config.url}. Reason: ${e.message}`
+                `Could not load chrom sizes: ${this.config.url}. Reason: ${e.message}`,
+                { cause: e }
             );
         }
     }
@@ -129,7 +130,6 @@ export default class Genome {
                 continuousInterval: [pos, pos + size],
                 index: i,
                 number: i + 1,
-                // eslint-disable-next-line no-bitwise
                 odd: !(i & 1),
             };
 
@@ -406,6 +406,20 @@ export function isChromosomalLocusInterval(value) {
     return value.every(isChromosomalLocus);
 }
 
+/**
+ * Returns true when the right bound is an explicit locus position rather than a
+ * chromosome shortcut such as `{ chrom: "chr2" }`.
+ *
+ * @param {any} value
+ * @returns {value is ChromosomalLocus[]}
+ */
+export function hasExplicitLocusUpperBound(value) {
+    return (
+        isChromosomalLocusInterval(value) &&
+        (value[1] ?? value[0]).pos !== undefined
+    );
+}
+
 /**
  * @param {any} value
  * @returns {value is GenomeConfig}

package/dist/src/genome/genomeStore.js

@@ -207,7 +207,7 @@ export default class GenomeStore {
     #tryCreateBuiltInGenome(name) {
         try {
             return new Genome({ name });
-        } catch (_error) {
+        } catch {
             return undefined;
         }
     }

package/dist/src/genome/rootGenomeConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rootGenomeConfig.d.ts","sourceRoot":"","sources":["../../../src/genome/rootGenomeConfig.js"],"names":[],"mappings":"AAEA;;;GAGG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AACH,oDAHW,UAAU,GACR,wBAAwB,CAkDpC;yBAlEY,OAAO,iBAAiB,EAAE,UAAU;oCACpC,OAAO,iBAAiB,EAAE,iBAAiB;;mBAK9C,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC;qBAClC,MAAM,GAAG,SAAS;wBAClB,MAAM,GAAG,SAAS"}
+{"version":3,"file":"rootGenomeConfig.d.ts","sourceRoot":"","sources":["../../../src/genome/rootGenomeConfig.js"],"names":[],"mappings":"AAEA;;;GAGG;AAEH;;;;;GAKG;AAEH;;;;;;GAMG;AACH,oDAHW,UAAU,GACR,wBAAwB,CAsDpC;yBAtEY,OAAO,iBAAiB,EAAE,UAAU;oCACpC,OAAO,iBAAiB,EAAE,iBAAiB;;mBAK9C,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC;qBAClC,MAAM,GAAG,SAAS;wBAClB,MAAM,GAAG,SAAS"}

package/dist/src/genome/rootGenomeConfig.js

@@ -34,8 +34,12 @@ export function resolveRootGenomeConfig(rootConfig) {
 
     if (rootConfig.genome) {
         const { name, ...config } = rootConfig.genome;
+        const hasDefinition = Object.keys(config).length > 0;
         return {
-            genomesByName: new Map([[name, config]]),
+            genomesByName:
+                !hasDefinition && isBuiltInAssembly(name)
+                    ? new Map()
+                    : new Map([[name, config]]),
             defaultAssembly: name,
             deprecationWarning: getLegacyGenomeWarning(),
         };
@@ -88,7 +92,7 @@ function isBuiltInAssembly(name) {
     try {
         getContigs(name);
         return true;
-    } catch (_error) {
+    } catch {
         return false;
     }
 }

package/dist/src/genome/scaleLocus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaleLocus.d.ts","sourceRoot":"","sources":["../../../src/genome/scaleLocus.js"],"names":[],"mappings":"AAMA,2EAsGC;;AASD;;;;GAIG;AACH,8CAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,SAC5F,MAAM,GACJ,MAAM,GAAG,OAAO,aAAa,EAAE,gBAAgB,CAK3D;AAED;;;;GAIG;AACH,gDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,WAC5F,MAAM,GAAG,OAAO,aAAa,EAAE,gBAAgB,GAC7C,MAAM,CAQlB;AAED;;;;GAIG;AACH,mDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,YAC5F,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,GAChF,MAAM,EAAE,CAQpB;AAED;;;;GAIG;AACH,iDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,YAC5F,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,GAChF,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,CAO9F;AAED;;;GAGG;AACH,+CAHW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAC1F,MAAM,EAAE,CAQpB"}
+{"version":3,"file":"scaleLocus.d.ts","sourceRoot":"","sources":["../../../src/genome/scaleLocus.js"],"names":[],"mappings":"AAQA,2EAuHC;;AASD;;;;GAIG;AACH,8CAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,SAC5F,MAAM,GACJ,MAAM,GAAG,OAAO,aAAa,EAAE,gBAAgB,CAK3D;AAED;;;;GAIG;AACH,gDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,WAC5F,MAAM,GAAG,OAAO,aAAa,EAAE,gBAAgB,GAC7C,MAAM,CAQlB;AAED;;;;GAIG;AACH,mDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,YAC5F,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,GAChF,MAAM,EAAE,CAQpB;AAED;;;;GAIG;AACH,iDAJW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,YAC5F,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,GAChF,OAAO,kBAAkB,EAAE,YAAY,GAAG,OAAO,kBAAkB,EAAE,aAAa,CAO9F;AAED;;;GAGG;AACH,+CAHW,OAAO,aAAa,EAAE,OAAO,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,OAAO,aAAa,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,GAC1F,MAAM,EAAE,CAQpB"}

package/dist/src/genome/scaleLocus.js

@@ -4,6 +4,8 @@ import { format as d3format } from "d3-format";
 import scaleIndex from "./scaleIndex.js";
 import { isChromosomalLocus, isChromosomalLocusInterval } from "./genome.js";
 
+const EXACT_LOCUS_LABEL_STEP_THRESHOLD = 1e6;
+
 export default function scaleLocus() {
     /** @type {import("./scaleLocus.js").ScaleLocus} */
     const scale = /** @type {any} */ (scaleIndex().numberingOffset(1));
@@ -27,14 +29,26 @@ export default function scaleLocus() {
         }
 
         const domain = scale.domain();
+        const domainSpan = domain[1] - domain[0];
         const numberingOffset = scale.numberingOffset();
 
-        const [minChrom, maxChrom] = [
-            Math.max(domain[0], 0),
-            Math.min(domain[1], genome.totalSize - 1),
-        ].map((x) => genome.toChromosome(x));
+        const minChrom = genome.toChromosome(Math.max(domain[0], 0));
+        const maxChrom = genome.toChromosome(
+            Math.min(domain[1], genome.totalSize - 1)
+        );
+
+        const requestedCount = Math.max(
+            1,
+            Math.min(count ?? 10, Math.ceil(domainSpan))
+        );
+
+        let step = tickStep(domain[0], domain[1], requestedCount);
+
+        if (step < EXACT_LOCUS_LABEL_STEP_THRESHOLD) {
+            step = tickStep(domain[0], domain[1], requestedCount * 0.65);
+        }
 
-        const step = Math.max(1, tickStep(domain[0], domain[1], count));
+        step = Math.max(1, step);
 
         const ticks = [];
 
@@ -75,12 +89,17 @@ export default function scaleLocus() {
         const step = tickStep(
             domain[0],
             domain[1],
-            Math.min(count, Math.ceil(domainSpan))
+            Math.max(1, Math.min(count ?? 10, Math.ceil(domainSpan)))
         );
         // Use higher display precision for smaller spans
         // TODO: max absolute value should be taken into account too. 2.00M vs 200M
-        const numberFormat = step < 1e6 ? d3format(",") : d3format(".3s");
+        const numberFormat =
+            step < EXACT_LOCUS_LABEL_STEP_THRESHOLD
+                ? d3format(",")
+                : d3format(".3s");
 
+        // Axis tick values live in the continuous whole-genome coordinate
+        // system, but labels should show chromosome-local one-based positions.
         /** @type {function(number):number} */
         const fixer = (x) => x - genome.toChromosome(x).continuousStart;
 

package/dist/src/genomeSpy/cursorManager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @typedef {{
+ *   owner: object,
+ *   raw: unknown,
+ *   evaluate: () => string | undefined,
+ *   watch: (registerDisposer: (dispose: () => void) => void, listener: () => void) => void,
+ * }} CursorSource
+ */
+/**
+ * @param {CursorView | undefined} target
+ * @param {{ mark?: CursorOwner } | undefined} hover
+ * @returns {CursorSource | undefined}
+ */
+export function resolveCursorSource(target: CursorView | undefined, hover: {
+    mark?: CursorOwner;
+} | undefined): CursorSource | undefined;
+/**
+ * Resolves and applies the active canvas cursor based on the current mark hover
+ * and interaction target path.
+ */
+/**
+ * @typedef {{
+ *   getCursorSpec?: () => unknown,
+ *   getCursor: () => string | undefined,
+ *   watchCursor?: (listener: () => void, registerDisposer: (dispose: () => void) => void) => void,
+ * }} CursorOwner
+ */
+/**
+ * @typedef {CursorOwner & {
+ *   getLayoutAncestors: () => CursorView[],
+ * }} CursorView
+ */
+export default class CursorManager {
+    /**
+     * @param {object} options
+     * @param {HTMLCanvasElement} options.canvas
+     */
+    constructor({ canvas }: {
+        canvas: HTMLCanvasElement;
+    });
+    /**
+     * @param {object} options
+     * @param {CursorView | undefined} options.target
+     * @param {{ mark?: CursorOwner } | undefined} options.hover
+     */
+    update({ target, hover }: {
+        target: CursorView | undefined;
+        hover: {
+            mark?: CursorOwner;
+        } | undefined;
+    }): void;
+    clear(): void;
+    #private;
+}
+export type CursorSource = {
+    owner: object;
+    raw: unknown;
+    evaluate: () => string | undefined;
+    watch: (registerDisposer: (dispose: () => void) => void, listener: () => void) => void;
+};
+export type CursorOwner = {
+    getCursorSpec?: () => unknown;
+    getCursor: () => string | undefined;
+    watchCursor?: (listener: () => void, registerDisposer: (dispose: () => void) => void) => void;
+};
+export type CursorView = CursorOwner & {
+    getLayoutAncestors: () => CursorView[];
+};
+//# sourceMappingURL=cursorManager.d.ts.map

package/dist/src/genomeSpy/cursorManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursorManager.d.ts","sourceRoot":"","sources":["../../../src/genomeSpy/cursorManager.js"],"names":[],"mappings":"AA+EA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,4CAJW,UAAU,GAAG,SAAS,SACtB;IAAE,IAAI,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,SAAS,GAChC,YAAY,GAAG,SAAS,CA2BpC;AAtHD;;;GAGG;AAEH;;;;;;GAMG;AAEH;;;;GAIG;AAEH;IAUI;;;OAGG;IACH,wBAFG;QAAmC,MAAM,EAAjC,iBAAiB;KAC3B,EAGA;IAED;;;;OAIG;IACH,0BAHG;QAAwC,MAAM,EAAtC,UAAU,GAAG,SAAS;QACsB,KAAK,EAAjD;YAAE,IAAI,CAAC,EAAE,WAAW,CAAA;SAAE,GAAG,SAAS;KAC5C,QAGA;IAED,cAEC;;CA6BJ;2BAGY;IACR,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,CAAC,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;CACxF;0BA/ES;IACR,aAAa,CAAC,EAAE,MAAM,OAAO,CAAC;IAC9B,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,IAAI,EAAE,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC;CAC/F;yBAIS,WAAW,GAAG;IACtB,kBAAkB,EAAE,MAAM,UAAU,EAAE,CAAC;CACxC"}