@genome-spy/core 0.67.0 → 0.69.0

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

@@ -1,10 +1,12 @@
 /**
  * @param {import("../spec/channel.js").Channel} channel
  * @param {import("../spec/channel.js").ChannelDef | import("../spec/channel.js").Conditional<import("../spec/channel.js").ChannelDef>} channelDef
- * @param {import("../view/paramMediator.js").default} paramMediator
+ * @param {{ createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  * @returns {import("../types/encoder.js").Accessor}
  */
-export function createAccessor(channel: import("../spec/channel.js").Channel, channelDef: import("../spec/channel.js").ChannelDef | import("../spec/channel.js").Conditional<import("../spec/channel.js").ChannelDef>, paramMediator: import("../view/paramMediator.js").default): import("../types/encoder.js").Accessor;
+export function createAccessor(channel: import("../spec/channel.js").Channel, channelDef: import("../spec/channel.js").ChannelDef | import("../spec/channel.js").Conditional<import("../spec/channel.js").ChannelDef>, paramRuntime: {
+    createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction;
+}): import("../types/encoder.js").Accessor;
 /**
  * Returns an array of acessors and their predicates. A returned array with
  * a single element indicates that no conditions are present.
@@ -12,7 +14,52 @@ export function createAccessor(channel: import("../spec/channel.js").Channel, ch
  *
  * @param {import("../spec/channel.js").Channel} channel
  * @param {import("../spec/channel.js").ChannelDef} channelDef
- * @param {import("../view/paramMediator.js").default} paramMediator
+ * @param {{ createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  */
-export function createConditionalAccessors(channel: import("../spec/channel.js").Channel, channelDef: import("../spec/channel.js").ChannelDef, paramMediator: import("../view/paramMediator.js").default): import("../types/encoder.js").Accessor<import("../spec/channel.js").Scalar>[];
+export function createConditionalAccessors(channel: import("../spec/channel.js").Channel, channelDef: import("../spec/channel.js").ChannelDef, paramRuntime: {
+    createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction;
+}): import("../types/encoder.js").Accessor<import("../spec/channel.js").Scalar>[];
+/**
+ * @param {import("../types/encoder.js").Accessor} accessor
+ * @returns {accessor is import("../types/encoder.js").ScaleAccessor}
+ */
+export function isScaleAccessor(accessor: import("../types/encoder.js").Accessor): accessor is import("../types/encoder.js").ScaleAccessor;
+/**
+ * Builds domain key strings in the format:
+ * - domainKeyBase: <scaleChannel>|<kind>|<value>
+ * - domainKey: <type>|<domainKeyBase>
+ *
+ * @param {object} options
+ * @param {import("../spec/channel.js").ChannelWithScale} options.scaleChannel
+ * @param {DomainKeySource} options.source
+ * @param {import("../spec/channel.js").Type} [options.type]
+ * @returns {{ domainKeyBase: string, domainKey?: string }}
+ */
+export function buildDomainKey({ scaleChannel, source, type }: {
+    scaleChannel: import("../spec/channel.js").ChannelWithScale;
+    source: DomainKeySource;
+    type?: import("../spec/channel.js").Type;
+}): {
+    domainKeyBase: string;
+    domainKey?: string;
+};
+/**
+ * @param {import("../types/encoder.js").ScaleAccessor} accessor
+ * @param {import("../spec/channel.js").Type} type
+ * @returns {string}
+ */
+export function getAccessorDomainKey(accessor: import("../types/encoder.js").ScaleAccessor, type: import("../spec/channel.js").Type): string;
+export type DomainKeySource = {
+    kind: "field";
+    value: string;
+} | {
+    kind: "expr";
+    value: string;
+} | {
+    kind: "datum";
+    value: import("../spec/channel.js").Scalar | import("../spec/parameter.js").ExprRef;
+} | {
+    kind: "value";
+    value: import("../spec/channel.js").Scalar | import("../spec/parameter.js").ExprRef;
+};
 //# sourceMappingURL=accessor.d.ts.map

package/dist/src/encoder/accessor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../../src/encoder/accessor.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,wCALW,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,oBAAoB,EAAE,UAAU,GAAG,OAAO,oBAAoB,EAAE,WAAW,CAAC,OAAO,oBAAoB,EAAE,UAAU,CAAC,iBAC3H,OAAO,0BAA0B,EAAE,OAAO,GACxC,OAAO,qBAAqB,EAAE,QAAQ,CA+FlD;AAED;;;;;;;;GAQG;AACH,oDAJW,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,oBAAoB,EAAE,UAAU,iBACvC,OAAO,0BAA0B,EAAE,OAAO,iFAgCpD"}
+{"version":3,"file":"accessor.d.ts","sourceRoot":"","sources":["../../../src/encoder/accessor.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,wCALW,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,oBAAoB,EAAE,UAAU,GAAG,OAAO,oBAAoB,EAAE,WAAW,CAAC,OAAO,oBAAoB,EAAE,UAAU,CAAC,gBAC3H;IAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,0BAA0B,EAAE,eAAe,CAAA;CAAE,GACxF,OAAO,qBAAqB,EAAE,QAAQ,CAmHlD;AAED;;;;;;;;GAQG;AACH,oDAJW,OAAO,oBAAoB,EAAE,OAAO,cACpC,OAAO,oBAAoB,EAAE,UAAU,gBACvC;IAAE,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,0BAA0B,EAAE,eAAe,CAAA;CAAE,iFAgCpG;AAED;;;GAGG;AACH,0CAHW,OAAO,qBAAqB,EAAE,QAAQ,GACpC,QAAQ,IAAI,OAAO,qBAAqB,EAAE,aAAa,CAInE;AA6DD;;;;;;;;;;GAUG;AACH,+DALG;IAA+D,YAAY,EAAnE,OAAO,oBAAoB,EAAE,gBAAgB;IACpB,MAAM,EAA/B,eAAe;IAC6B,IAAI,GAAhD,OAAO,oBAAoB,EAAE,IAAI;CACzC,GAAU;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAYzD;AAED;;;;GAIG;AACH,+CAJW,OAAO,qBAAqB,EAAE,aAAa,QAC3C,OAAO,oBAAoB,EAAE,IAAI,GAC/B,MAAM,CAgBlB;8BApGY;IACN,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACjB,GAAG;IACA,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACjB,GAAG;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,oBAAoB,EAAE,MAAM,GAAG,OAAO,sBAAsB,EAAE,OAAO,CAAC;CACvF,GAAG;IACA,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,oBAAoB,EAAE,MAAM,GAAG,OAAO,sBAAsB,EAAE,OAAO,CAAC;CACvF"}

package/dist/src/encoder/accessor.js

@@ -9,15 +9,15 @@ import {
     isValueDefWithCondition,
 } from "./encoder.js";
 import { field } from "../utils/field.js";
-import { isExprRef, makeConstantExprRef } from "../view/paramMediator.js";
+import { isExprRef, makeConstantExprRef } from "../paramRuntime/paramUtils.js";
 
 /**
  * @param {import("../spec/channel.js").Channel} channel
  * @param {import("../spec/channel.js").ChannelDef | import("../spec/channel.js").Conditional<import("../spec/channel.js").ChannelDef>} channelDef
- * @param {import("../view/paramMediator.js").default} paramMediator
+ * @param {{ createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  * @returns {import("../types/encoder.js").Accessor}
  */
-export function createAccessor(channel, channelDef, paramMediator) {
+export function createAccessor(channel, channelDef, paramRuntime) {
     /**
      * @typedef {import("../data/flowNode.js").Datum} Datum
      * @typedef {import("../spec/channel.js").Scalar} Scalar
@@ -38,6 +38,7 @@ export function createAccessor(channel, channelDef, paramMediator) {
         a.constant = a.fields.length === 0;
         a.channelDef = channelDef;
         a.channel = channel;
+        a.sourceKey = buildAccessorSourceKey(channelDef);
 
         a.scaleChannel =
             ((isChannelDefWithScale(channelDef) &&
@@ -45,10 +46,17 @@ export function createAccessor(channel, channelDef, paramMediator) {
                 (isChannelWithScale(channel) && channel)) ||
             undefined;
 
+        if (a.scaleChannel !== undefined) {
+            a.domainKeyBase = buildDomainKey({
+                scaleChannel: a.scaleChannel,
+                source: getDomainKeySource(channelDef),
+            }).domainKeyBase;
+        }
+
         if ("param" in channelDef) {
             // TODO: Figure out how to fix it. Interval selection depends on FIELDS!
             /*
-            a.predicate = paramMediator.createExpression(
+            a.predicate = paramRuntime.createExpression(
                 makeSelectionTestExpression(channelDef)
             );
             a.predicate.param = channelDef.param;
@@ -62,6 +70,18 @@ export function createAccessor(channel, channelDef, paramMediator) {
             a.predicate.empty = false;
         }
 
+        a.equals = (other) => {
+            if (!other) {
+                return false;
+            } else {
+                return (
+                    a === other ||
+                    (a.sourceKey !== undefined &&
+                        a.sourceKey === other.sourceKey)
+                );
+            }
+        };
+
         a.asNumberAccessor = () =>
             /** @type {import("../types/encoder.js").Accessor<number>} */ (a);
 
@@ -75,7 +95,7 @@ export function createAccessor(channel, channelDef, paramMediator) {
     function potentialExprRefToAccessor(potentialExprRef) {
         if (isExprRef(potentialExprRef)) {
             const a = asAccessor(
-                paramMediator.createExpression(potentialExprRef.expr)
+                paramRuntime.createExpression(potentialExprRef.expr)
             );
             if (a.fields.length > 0) {
                 throw new Error(
@@ -98,7 +118,7 @@ export function createAccessor(channel, channelDef, paramMediator) {
         }
     } else if (isExprDef(channelDef)) {
         // TODO: If parameters change, the data should be re-evaluated
-        return asAccessor(paramMediator.createExpression(channelDef.expr));
+        return asAccessor(paramRuntime.createExpression(channelDef.expr));
     } else if (isDatumDef(channelDef)) {
         return potentialExprRefToAccessor(channelDef.datum);
     } else if (isValueDef(channelDef)) {
@@ -119,9 +139,9 @@ export function createAccessor(channel, channelDef, paramMediator) {
  *
  * @param {import("../spec/channel.js").Channel} channel
  * @param {import("../spec/channel.js").ChannelDef} channelDef
- * @param {import("../view/paramMediator.js").default} paramMediator
+ * @param {{ createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  */
-export function createConditionalAccessors(channel, channelDef, paramMediator) {
+export function createConditionalAccessors(channel, channelDef, paramRuntime) {
     /** @type {import("../types/encoder.js").Accessor[]} */
     const conditionalAccessors = [];
 
@@ -136,13 +156,13 @@ export function createConditionalAccessors(channel, channelDef, paramMediator) {
 
         for (const condition of conditions) {
             conditionalAccessors.push(
-                createAccessor(channel, condition, paramMediator)
+                createAccessor(channel, condition, paramRuntime)
             );
         }
     }
 
     conditionalAccessors.push(
-        createAccessor(channel, channelDef, paramMediator)
+        createAccessor(channel, channelDef, paramRuntime)
     );
 
     if (conditionalAccessors.filter((a) => !a.constant).length > 1) {
@@ -152,3 +172,147 @@ export function createConditionalAccessors(channel, channelDef, paramMediator) {
     }
     return conditionalAccessors;
 }
+
+/**
+ * @param {import("../types/encoder.js").Accessor} accessor
+ * @returns {accessor is import("../types/encoder.js").ScaleAccessor}
+ */
+export function isScaleAccessor(accessor) {
+    return accessor.scaleChannel !== undefined;
+}
+
+/**
+ * @typedef {{
+ *     kind: "field",
+ *     value: string,
+ * } | {
+ *     kind: "expr",
+ *     value: string,
+ * } | {
+ *     kind: "datum",
+ *     value: import("../spec/channel.js").Scalar | import("../spec/parameter.js").ExprRef,
+ * } | {
+ *     kind: "value",
+ *     value: import("../spec/channel.js").Scalar | import("../spec/parameter.js").ExprRef,
+ * }} DomainKeySource
+ */
+
+/**
+ * @param {import("../spec/channel.js").ChannelDef} channelDef
+ * @returns {DomainKeySource}
+ */
+function getDomainKeySource(channelDef) {
+    if (isFieldDef(channelDef)) {
+        return { kind: "field", value: channelDef.field };
+    }
+
+    if (isExprDef(channelDef)) {
+        return { kind: "expr", value: channelDef.expr };
+    }
+
+    if (isDatumDef(channelDef)) {
+        return { kind: "datum", value: channelDef.datum };
+    }
+
+    if (isValueDef(channelDef)) {
+        return { kind: "value", value: channelDef.value };
+    }
+
+    throw new Error(
+        "Cannot derive a domain key from channel definition: " +
+            JSON.stringify(channelDef)
+    );
+}
+
+/**
+ * Builds a key for accessor equality. This is a structural heuristic based on
+ * the data source definition and ignores channel, predicate, and scale.
+ *
+ * @param {import("../spec/channel.js").ChannelDef} channelDef
+ * @returns {string}
+ */
+function buildAccessorSourceKey(channelDef) {
+    const source = getDomainKeySource(channelDef);
+    if (source.kind === "datum" || source.kind === "value") {
+        return "constant|" + stringifyDomainValue(source.value);
+    }
+
+    return source.kind + "|" + stringifyDomainSource(source);
+}
+
+/**
+ * Builds domain key strings in the format:
+ * - domainKeyBase: <scaleChannel>|<kind>|<value>
+ * - domainKey: <type>|<domainKeyBase>
+ *
+ * @param {object} options
+ * @param {import("../spec/channel.js").ChannelWithScale} options.scaleChannel
+ * @param {DomainKeySource} options.source
+ * @param {import("../spec/channel.js").Type} [options.type]
+ * @returns {{ domainKeyBase: string, domainKey?: string }}
+ */
+export function buildDomainKey({ scaleChannel, source, type }) {
+    if (!scaleChannel) {
+        throw new Error("Cannot build a domain key without a scale channel.");
+    }
+
+    const domainKeyBase =
+        scaleChannel + "|" + source.kind + "|" + stringifyDomainSource(source);
+    const domainKey = type ? type + "|" + domainKeyBase : undefined;
+
+    return { domainKeyBase, domainKey };
+}
+
+/**
+ * @param {import("../types/encoder.js").ScaleAccessor} accessor
+ * @param {import("../spec/channel.js").Type} type
+ * @returns {string}
+ */
+export function getAccessorDomainKey(accessor, type) {
+    const { domainKey, domainKeyBase } = buildDomainKey({
+        scaleChannel: accessor.scaleChannel,
+        source: getDomainKeySource(accessor.channelDef),
+        type,
+    });
+    if (!domainKey) {
+        throw new Error(
+            "Cannot finalize a domain key without a resolved type."
+        );
+    }
+    accessor.domainKeyBase = domainKeyBase;
+    accessor.domainKey = domainKey;
+    return domainKey;
+}
+
+/**
+ * @param {DomainKeySource} source
+ * @returns {string}
+ */
+function stringifyDomainSource(source) {
+    switch (source.kind) {
+        case "field":
+        case "expr":
+            return source.value;
+        case "datum":
+        case "value":
+            return stringifyDomainValue(source.value);
+        default:
+            throw new Error("Unknown domain key source.");
+    }
+}
+
+/**
+ * @param {import("../spec/channel.js").Scalar | import("../spec/parameter.js").ExprRef} value
+ * @returns {string}
+ */
+function stringifyDomainValue(value) {
+    if (isExprRef(value)) {
+        return "expr:" + value.expr;
+    }
+
+    if (value === undefined) {
+        return "undefined";
+    }
+
+    return JSON.stringify(value);
+}

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

@@ -8,6 +8,15 @@
  * @returns {Partial<Record<Channel, Encoder>>}
  */
 export default function createEncoders(unitView: import("../view/unitView.js").default, encoding: import("../spec/channel.js").Encoding): Partial<Record<import("../spec/channel.js").Channel, import("../types/encoder.js").Encoder>>;
+/**
+ * Channels that are present in encoding but are not direct mark properties.
+ * Keep this centralized so metadata channels (for example tooltip) can reuse
+ * the same handling path.
+ *
+ * @param {import("../spec/channel.js").Channel} channel
+ * @returns {boolean}
+ */
+export function isNonMarkPropertyChannel(channel: import("../spec/channel.js").Channel): boolean;
 /**
  * @param {import("../types/encoder.js").Accessor[]} accessors
  * @param {(channel: import("../spec/channel.js").ChannelWithScale) => import("../types/encoder.js").VegaScale} scaleSource
@@ -45,12 +54,12 @@ export function isChannelDefWithScale(channelDef: import("../spec/channel.js").C
 /**
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  */
-export function findChannelDefWithScale(channelDef: import("../spec/channel.js").ChannelDef): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").FieldDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").DatumDef<import("../spec/parameter.js").ExprRef | import("../spec/channel.js").Scalar> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").ValueDefBase<string | import("../spec/parameter.js").ExprRef> & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").ValueDefBase<number | import("../spec/parameter.js").ExprRef> & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>);
+export function findChannelDefWithScale(channelDef: import("../spec/channel.js").ChannelDef): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").FieldDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").DomainContributionMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").DatumDef<import("../spec/parameter.js").ExprRef | import("../spec/channel.js").Scalar> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").DomainContributionMixins) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").ValueDefBase<string | import("../spec/parameter.js").ExprRef> & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").DomainContributionMixins) | (import("../spec/channel.js").ParameterPredicate & import("../spec/channel.js").ValueDefBase<number | import("../spec/parameter.js").ExprRef> & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").DomainContributionMixins);
 /**
  * @param {import("../view/unitView.js").default} view
  * @param {import("../spec/channel.js").Channel} channel
  */
-export function getChannelDefWithScale(view: import("../view/unitView.js").default, channel: import("../spec/channel.js").Channel): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").TypeForShape>, string> | (import("../spec/channel.js").FieldDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").XIndexDef) | (import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").DatumDef<import("../spec/parameter.js").ExprRef | import("../spec/channel.js").Scalar> & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").XIndexDef) | (import("../spec/channel.js").ChromPosDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").TypeMixins<"locus"> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").XIndexDef);
+export function getChannelDefWithScale(view: import("../view/unitView.js").default, channel: import("../spec/channel.js").Channel): import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, string> | import("../spec/channel.js").PositionFieldDef | import("../spec/channel.js").PositionDatumDef | import("../spec/channel.js").ChromPosDef | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").Type>, number> | import("../spec/channel.js").FieldOrDatumDefWithCondition<import("../spec/channel.js").MarkPropFieldDef<import("../spec/channel.js").TypeForShape>, string> | (import("../spec/channel.js").FieldDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").DomainContributionMixins & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").XIndexDef) | (import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").DatumDef<import("../spec/parameter.js").ExprRef | import("../spec/channel.js").Scalar> & import("../spec/channel.js").DomainContributionMixins & import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type> & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").XIndexDef) | (import("../spec/channel.js").ChromPosDefBase & import("../spec/channel.js").TitleMixins & import("../spec/channel.js").PositionMixins & import("../spec/channel.js").DomainContributionMixins & import("../spec/channel.js").TypeMixins<"locus"> & import("../spec/channel.js").ScaleMixins & import("../spec/channel.js").XIndexDef);
 /**
  * @param {import("../spec/channel.js").ChannelDef} channelDef
  * @returns {channelDef is import("../spec/channel.js").TypeMixins<import("../spec/channel.js").Type>}

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

@@ -1 +1 @@
-{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/encoder/encoder.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"encoder.d.ts","sourceRoot":"","sources":["../../../src/encoder/encoder.js"],"names":[],"mappings":"AAwDA;;;;;;;;GAQG;AACH,iDAJW,OAAO,qBAAqB,EAAE,OAAO,YACrC,OAAO,oBAAoB,EAAE,QAAQ,GACnC,OAAO,CAAC,MAAM,6EAAkB,CAAC,CAwC7C;AAED;;;;;;;GAOG;AACH,kDAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,OAAO,CAInB;AAED;;;;GAIG;AACH,4DAJW,OAAO,qBAAqB,EAAE,QAAQ,EAAE,eACxC,CAAC,OAAO,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,KAAK,OAAO,qBAAqB,EAAE,SAAS,yCAqC7G;AAED;;;;GAIG;AACH,kIAHW,CAAC,OAAO,EAAE,OAAO,oBAAoB,EAAE,gBAAgB,KAAK,OAAO,qBAAqB,EAAE,SAAS,yCAqC7G;AAED;;;;;GAKG;AACH,uCAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,QAAQ,CAI/D;AAED;;;GAGG;AACH,uCAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,YAAY,CAInE;AAED;;;GAGG;AACH,uCAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,QAAQ,CAI/D;AAED;;;GAGG;AACH,kDAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,mBAAmB,CAU1E;AAED;;GAEG;AACH,oDAFW,OAAO,oBAAoB,EAAE,UAAU,qyDAWjD;AAED;;;GAGG;AACH,6CAHW,OAAO,qBAAqB,EAAE,OAAO,WACrC,OAAO,oBAAoB,EAAE,OAAO,8nDAS9C;AAED;;;GAGG;AACH,iDAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,UAAU,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,CAIpG;AAED;;;GAGG;AACH,0CAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,WAAW,CAIlE;AAED;;;GAGG;AACH,sCAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,OAAO,CAI9D;AAED;;;GAGG;AACH,2DAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,4BAA4B,CAOnF;AAED;;;GAGG;AACH,oDAHW,OAAO,oBAAoB,EAAE,UAAU,GACrC,UAAU,IAAI,OAAO,oBAAoB,EAAE,qBAAqB,CAI5E;AAoBD;;;GAGG;AACH,oDAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,OAAO,IAAI,OAAO,oBAAoB,EAAE,wBAAwB,CAK5E;AAED;;;GAGG;AACH,6CAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,OAAO,IAAI,OAAO,oBAAoB,EAAE,iBAAiB,CAKrE;AAqBD;;;GAGG;AACH,4CAFW,MAAM,WAIhB;AAED;;;;GAIG;AACH,oDAFW,OAAO,oBAAoB,EAAE,OAAO,2DAS9C;AAED;;;;;GAKG;AACH,2CAFW,OAAO,oBAAoB,EAAE,OAAO,wCAI9C;AAED;;;;GAIG;AACH,kDAFW,OAAO,oBAAoB,EAAE,OAAO,0CAM9C;AAED;;GAEG;AACH,wCAFW,OAAO,oBAAoB,EAAE,OAAO,WAI9C;AAED;;;;GAIG;AACH,2CAFW,OAAO,oBAAoB,EAAE,OAAO,WAI9C;AAED;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,OAAO,IAAI,OAAO,oBAAoB,EAAE,gBAAgB,CAsBpE;AAED;;;;;GAKG;AACH,0CAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,GAAG,EAAE,CAsBjB;AAED;;;GAGG;AACH,gDAHW,OAAO,oBAAoB,EAAE,OAAO,GAClC,CAAS,IAAG,EAAH,GAAG,KAAE,MAAM,CAmBhC;AA7LD;;GAEG;AACH,wCAFU,OAAO,oBAAoB,EAAE,wBAAwB,EAAE,CAEb;AAEpD;;GAEG;AACH,0CAFU,OAAO,oBAAoB,EAAE,0BAA0B,EAAE,CAEX;AAExD;;GAEG;AACH,iCAFU,OAAO,oBAAoB,EAAE,iBAAiB,EAAE,CAKxD;AAoBF;;;;GAIG;AACH,gCAFU,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,OAAO,EAAE,OAAO,oBAAoB,EAAE,0BAA0B,CAAC,CAAC,CAKtH;AAEF;;;;GAIG;AACH,8BAFU,OAAO,CAAC,MAAM,CAAC,OAAO,oBAAoB,EAAE,OAAO,EAAE,OAAO,oBAAoB,EAAE,OAAO,CAAC,CAAC,CAInG"}

package/dist/src/encoder/encoder.js

@@ -11,14 +11,14 @@ import { createConditionalAccessors } from "./accessor.js";
  *
  * @param {string} param
  * @param {import("../spec/channel.js").Encoding} encoding
- * @param {import("../view/paramMediator.js").default} paramMediator
+ * @param {{ findValue: (param: string) => any, createExpression: (expr: string) => import("../paramRuntime/types.js").ExprRefFunction }} paramRuntime
  * @param {boolean} empty
  */
 // eslint-disable-next-line no-unused-vars
-function createSelectionPredicate(param, encoding, paramMediator, empty) {
+function createSelectionPredicate(param, encoding, paramRuntime, empty) {
     const selection =
         /** @type {import("../types/selectionTypes.js").Selection} */ (
-            paramMediator.findValue(param)
+            paramRuntime.findValue(param)
         );
     if (!selection) {
         throw new Error(`No selection parameter found: ${param}`);
@@ -51,7 +51,7 @@ function createSelectionPredicate(param, encoding, paramMediator, empty) {
         selection
     );
 
-    return paramMediator.createExpression(expr);
+    return paramRuntime.createExpression(expr);
 }
 
 /**
@@ -82,11 +82,19 @@ export default function createEncoders(unitView, encoding) {
             continue;
         }
 
-        encoders[channel] = createSimpleOrConditionalEncoder(
+        /** @type {Channel} */
+        const typedChannel = /** @type {Channel} */ (channel);
+        if (isNonMarkPropertyChannel(typedChannel)) {
+            continue;
+        }
+
+        const typedChannelDef =
+            /** @type {import("../spec/channel.js").ChannelDef} */ (channelDef);
+        encoders[typedChannel] = createSimpleOrConditionalEncoder(
             createConditionalAccessors(
-                channel,
-                channelDef,
-                unitView.paramMediator
+                typedChannel,
+                typedChannelDef,
+                unitView.paramRuntime
             ),
             scaleSource
         );
@@ -95,6 +103,18 @@ export default function createEncoders(unitView, encoding) {
     return encoders;
 }
 
+/**
+ * Channels that are present in encoding but are not direct mark properties.
+ * Keep this centralized so metadata channels (for example tooltip) can reuse
+ * the same handling path.
+ *
+ * @param {import("../spec/channel.js").Channel} channel
+ * @returns {boolean}
+ */
+export function isNonMarkPropertyChannel(channel) {
+    return channel === "key" || channel === "search";
+}
+
 /**
  * @param {import("../types/encoder.js").Accessor[]} accessors
  * @param {(channel: import("../spec/channel.js").ChannelWithScale) => import("../types/encoder.js").VegaScale} scaleSource
@@ -237,7 +257,7 @@ export function findChannelDefWithScale(channelDef) {
  */
 export function getChannelDefWithScale(view, channel) {
     const channelDef = view.mark.encoding[channel];
-    if (isChannelDefWithScale(channelDef)) {
+    if (!Array.isArray(channelDef) && isChannelDefWithScale(channelDef)) {
         return channelDef;
     } else {
         throw new Error("Not a channel def with scale!");

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

@@ -0,0 +1,15 @@
+/**
+ * Returns key fields used for point selections, if configured.
+ *
+ * @param {import("../spec/channel.js").Encoding} encoding
+ * @returns {string[] | undefined}
+ */
+export function getEncodingKeyFields(encoding: import("../spec/channel.js").Encoding): string[] | undefined;
+/**
+ * Returns search fields configured in encoding.search, if any.
+ *
+ * @param {import("../spec/channel.js").Encoding} encoding
+ * @returns {string[] | undefined}
+ */
+export function getEncodingSearchFields(encoding: import("../spec/channel.js").Encoding): string[] | undefined;
+//# sourceMappingURL=metadataChannels.d.ts.map

package/dist/src/encoder/metadataChannels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataChannels.d.ts","sourceRoot":"","sources":["../../../src/encoder/metadataChannels.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,+CAHW,OAAO,oBAAoB,EAAE,QAAQ,GACnC,MAAM,EAAE,GAAG,SAAS,CAIhC;AAED;;;;;GAKG;AACH,kDAHW,OAAO,oBAAoB,EAAE,QAAQ,GACnC,MAAM,EAAE,GAAG,SAAS,CAIhC"}

package/dist/src/encoder/metadataChannels.js

@@ -0,0 +1,65 @@
+/**
+ * Returns key fields used for point selections, if configured.
+ *
+ * @param {import("../spec/channel.js").Encoding} encoding
+ * @returns {string[] | undefined}
+ */
+export function getEncodingKeyFields(encoding) {
+    return getNormalizedFieldsFromChannel(encoding?.key, "key");
+}
+
+/**
+ * Returns search fields configured in encoding.search, if any.
+ *
+ * @param {import("../spec/channel.js").Encoding} encoding
+ * @returns {string[] | undefined}
+ */
+export function getEncodingSearchFields(encoding) {
+    return getNormalizedFieldsFromChannel(encoding?.search, "search");
+}
+
+/**
+ * @param {import("../spec/channel.js").FieldDefWithoutScale | import("../spec/channel.js").FieldDefWithoutScale[] | undefined} channelDef
+ * @param {"key" | "search"} channelName
+ * @returns {string[] | undefined}
+ */
+function getNormalizedFieldsFromChannel(channelDef, channelName) {
+    if (!channelDef) {
+        return;
+    }
+
+    const definitions = Array.isArray(channelDef) ? channelDef : [channelDef];
+    if (definitions.length === 0) {
+        throw new Error(
+            "The " + channelName + " channel array must not be empty."
+        );
+    }
+
+    /** @type {string[]} */
+    const fields = [];
+    for (const definition of definitions) {
+        if (
+            !definition ||
+            typeof definition !== "object" ||
+            !("field" in definition)
+        ) {
+            throw new Error(
+                "The " +
+                    channelName +
+                    " channel must be a field definition or an array of field definitions."
+            );
+        }
+
+        const fieldName = definition.field;
+        if (typeof fieldName !== "string") {
+            throw new Error(
+                "The " +
+                    channelName +
+                    " channel field definition must include a string field name."
+            );
+        }
+        fields.push(fieldName);
+    }
+
+    return fields;
+}

package/dist/src/encoder/metadataChannels.test.d.ts

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

package/dist/src/encoder/metadataChannels.test.d.ts.map

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

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

@@ -124,6 +124,14 @@ export default class Genome {
      * @returns {string}
      */
     formatInterval(interval: number[]): string;
+    /**
+     * Returns a UCSC Genome Browser -style string presentation of a single
+     * position.
+     *
+     * @param {number} continuousPos
+     * @returns {string}
+     */
+    formatLocus(continuousPos: number): string;
     /**
      * @param {number[]} interval
      * @returns {[ChromosomalLocus, ChromosomalLocus]}

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

@@ -1 +1 @@
-{"version":3,"file":"genome.d.ts","sourceRoot":"","sources":["../../../src/genome/genome.js"],"names":[],"mappings":"AAwWA;;;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;AAzZD;;;;;;;;;;;;;;;;;;;;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,QA2CtB;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;;;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;2BA9VY,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":"AAuXA;;;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;AAxaD;;;;;;;;;;;;;;;;;;;;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,QA2CtB;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;2BA7WY,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

@@ -1,7 +1,7 @@
 import { bisect } from "d3-array";
 import { tsvParseRows } from "d3-dsv";
 import { isObject } from "vega-util";
-import { formatRange } from "./locusFormat.js";
+import { formatLocus as formatLocusLabel, formatRange } from "./locusFormat.js";
 import { getContigs } from "./genomes.js";
 import { concatUrl } from "../utils/url.js";
 
@@ -232,6 +232,21 @@ export default class Genome {
         return formatRange(...this.toChromosomalInterval(interval));
     }
 
+    /**
+     * Returns a UCSC Genome Browser -style string presentation of a single
+     * position.
+     *
+     * @param {number} continuousPos
+     * @returns {string}
+     */
+    formatLocus(continuousPos) {
+        const locus = this.toChromosomal(continuousPos);
+        if (!locus) {
+            return undefined;
+        }
+        return formatLocusLabel(locus);
+    }
+
     /**
      * @param {number[]} interval
      * @returns {[ChromosomalLocus, ChromosomalLocus]}

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,2EAyFC;;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":"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"}