@genome-spy/core 0.73.0 → 0.75.0

package/dist/src/config/titleConfig.js

@@ -0,0 +1,42 @@
+import { mergeConfigScopes } from "./mergeConfig.js";
+import { normalizeStyle } from "./styleUtils.js";
+
+/**
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} scopes
+ * @returns {import("../spec/config.js").TitleConfig}
+ */
+export function getConfiguredTitleConfig(scopes) {
+    return /** @type {import("../spec/config.js").TitleConfig} */ (
+        mergeConfigScopes(
+            scopes.map(
+                (scope) =>
+                    /** @type {Record<string, any> | undefined} */ (scope.title)
+            )
+        )
+    );
+}
+
+/**
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} scopes
+ * @param {string | string[]} [styleName]
+ * @returns {import("../spec/config.js").StyleConfig}
+ */
+export function getConfiguredStyleConfig(scopes, styleName) {
+    const styles = normalizeStyle(styleName);
+    if (styles.length == 0) {
+        return {};
+    }
+
+    return /** @type {import("../spec/config.js").StyleConfig} */ (
+        mergeConfigScopes(
+            scopes.flatMap((scope) =>
+                styles.map(
+                    (name) =>
+                        /** @type {Record<string, any> | undefined} */ (
+                            scope.style?.[name]
+                        )
+                )
+            )
+        )
+    );
+}

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

@@ -0,0 +1,7 @@
+/**
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} scopes
+ * @param {import("../spec/view.js").ViewBackground} [explicitViewBackground]
+ * @returns {import("../spec/view.js").ViewBackground}
+ */
+export function getConfiguredViewBackground(scopes: import("../spec/config.js").GenomeSpyConfig[], explicitViewBackground?: import("../spec/view.js").ViewBackground): import("../spec/view.js").ViewBackground;
+//# sourceMappingURL=viewConfig.d.ts.map

package/dist/src/config/viewConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewConfig.d.ts","sourceRoot":"","sources":["../../../src/config/viewConfig.js"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,oDAJW,OAAO,mBAAmB,EAAE,eAAe,EAAE,2BAC7C,OAAO,iBAAiB,EAAE,cAAc,GACtC,OAAO,iBAAiB,EAAE,cAAc,CAsBpD"}

package/dist/src/config/viewConfig.js

@@ -0,0 +1,29 @@
+import { mergeConfigScopes } from "./mergeConfig.js";
+import { normalizeStyle } from "./styleUtils.js";
+
+/**
+ * @param {import("../spec/config.js").GenomeSpyConfig[]} scopes
+ * @param {import("../spec/view.js").ViewBackground} [explicitViewBackground]
+ * @returns {import("../spec/view.js").ViewBackground}
+ */
+export function getConfiguredViewBackground(scopes, explicitViewBackground) {
+    // Mirrors Vega-Lite behavior: view backgrounds use the implicit "cell"
+    // style, and explicit view.style entries augment it.
+    const styles = ["cell", ...normalizeStyle(explicitViewBackground?.style)];
+
+    return /** @type {import("../spec/view.js").ViewBackground} */ (
+        mergeConfigScopes(
+            scopes
+                .flatMap((scope) => [
+                    /** @type {Record<string, any> | undefined} */ (scope.view),
+                    ...styles.map(
+                        (styleName) =>
+                            /** @type {Record<string, any> | undefined} */ (
+                                scope.style?.[styleName]
+                            )
+                    ),
+                ])
+                .concat([explicitViewBackground])
+        )
+    );
+}

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

@@ -1,3 +1,13 @@
+/**
+ * Walks upstream from a flow node and collects scale channels whose current
+ * domain affects the produced data. Downstream encodings on these channels
+ * must not re-register as domain contributors or they will invalidate the
+ * domain that they themselves depend on.
+ *
+ * @param {FlowNode | undefined} node
+ * @returns {Set<import("../spec/channel.js").ChannelWithScale>}
+ */
+export function collectDomainSensitiveScaleChannels(node: FlowNode | undefined): Set<import("../spec/channel.js").ChannelWithScale>;
 /**
  * @param {import("../types/flowBatch.js").FlowBatch} flowBatch
  * @returns {flowBatch is import("../types/flowBatch.js").FileBatch}
@@ -24,7 +34,9 @@ export const BEHAVIOR_MODIFIES: number;
  */
 export const BEHAVIOR_COLLECTS: number;
 /**
- * @typedef {{paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default}} ParamRuntimeProvider
+ * @typedef {object} ParamRuntimeProvider
+ * @prop {import("../paramRuntime/viewParamRuntime.js").default} [paramRuntime]
+ * @prop {import("../types/viewContext.js").default} [context]
  */
 /**
  * This is heavily inspired by Vega's and Vega-Lite's data flow system.
@@ -49,6 +61,14 @@ export default class FlowNode {
      */
     paramRuntimeProvider: ParamRuntimeProvider;
     get behavior(): number;
+    /**
+     * Scale channels whose current domain affects this node's output.
+     * Downstream views must not feed these channels back into shared-domain
+     * resolution or domain-dependent flows can invalidate themselves.
+     *
+     * @returns {import("../spec/channel.js").ChannelWithScale[]}
+     */
+    get domainSensitiveScaleChannels(): import("../spec/channel.js").ChannelWithScale[];
     /**
      * A human-readable label for the node. Used for debugging and logging.
      *
@@ -173,6 +193,7 @@ export default class FlowNode {
 }
 export type ParamRuntimeProvider = {
     paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default;
+    context?: import("../types/viewContext.js").default;
 };
 /**
  * This is heavily inspired by Vega's and Vega-Lite's data flow system.

package/dist/src/data/flowNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flowNode.d.ts","sourceRoot":"","sources":["../../../src/data/flowNode.js"],"names":[],"mappings":"AA8YA;;;GAGG;AACH,uCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,SAAS,CAIlE;AAED;;;GAGG;AACH,wCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,UAAU,CAInE;AA1ZD;;;GAGG;AACH,qCAAsC;AAEtC;;;GAGG;AACH,uCAAwC;AAExC;;;GAGG;AACH,uCAAwC;AAExC;;GAEG;AAEH;;;;;GAKG;AACH;IAoCI;;OAEG;IACH,mCAFW,oBAAoB,EAa9B;IAjDD;;QAEI,oBAAoB;eAAT,KAAK;MAElB;IAWF;;;;OAIG;IACH,sBAFU,oBAAoB,CAEF;IAE5B,uBAEC;IAED;;;;OAIG;IACH,aAFa,MAAM,CAIlB;IAQG,yBAAyB;IACzB,UADW,QAAQ,EAAE,CACH;IAElB,uBAAuB;IACvB,QADW,QAAQ,CACI;IAEvB,2CAA2C;IAC3C,mBAAsB;IAG1B,wBAEC;IAED;;;OAGG;IACH,cASC;IAED;;;;;;OAMG;IACH,mBAEC;IAED;;;OAGG;IACH,uBAMC;IA2QD;;;OAGG;IACH,4BAHW,KAAK,QAKf;IAxPD;;;OAGG;IACH,kBAFW,QAAQ,QAIlB;IAED;;;OAGG;IACH,gBAFW,QAAQ,QAUlB;IAED;;OAEG;IACH,YAFW,QAAQ,QAQlB;IAED;;OAEG;IACH,6BAFW,QAAQ,QAMlB;IAED;;OAEG;IACH,0BAFW,QAAQ,QAalB;IAED;;;OAGG;IACH,mBAFW,QAAQ,QAWlB;IAED;;OAEG;IACH,eAiBC;IAED,kBAEC;IAED,uBAEC;IAED,sBAEC;IAED;;;;OAIG;IACH,eAFW,CAAC,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAA;KAAC,QAchF;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,MAAM,CAWlB;IAED;;;OAGG;IACH,cAFW,KAAK,QAKf;IAED,iBAMC;IAED;;;;OAIG;IACH,2BAFW,MAAM,IAAI,QAQpB;IAED;;OAEG;IACH,gBAWC;IAED;;OAEG;IACH,uBAOC;IAED;;;;OAIG;IACH,sBAFW,OAAO,uBAAuB,EAAE,SAAS,QAMnD;IAED;;;OAGG;IACH,8BAHa,OAAO,qCAAqC,EAAE,OAAO,CAcjE;IAED;;;;OAIG;IACH,8BAQC;;CASJ;mCAvXY;IAAC,YAAY,CAAC,EAAE,OAAO,qCAAqC,EAAE,OAAO,CAAA;CAAC;;;;oBAMtE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;mBACnB,KAAK,EAAE"}
+{"version":3,"file":"flowNode.d.ts","sourceRoot":"","sources":["../../../src/data/flowNode.js"],"names":[],"mappings":"AA2ZA;;;;;;;;GAQG;AACH,0DAHW,QAAQ,GAAG,SAAS,GAClB,GAAG,CAAC,OAAO,oBAAoB,EAAE,gBAAgB,CAAC,CAc9D;AAED;;;GAGG;AACH,uCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,SAAS,CAIlE;AAED;;;GAGG;AACH,wCAHW,OAAO,uBAAuB,EAAE,SAAS,GACvC,SAAS,IAAI,OAAO,uBAAuB,EAAE,UAAU,CAInE;AA9bD;;;GAGG;AACH,qCAAsC;AAEtC;;;GAGG;AACH,uCAAwC;AAExC;;;GAGG;AACH,uCAAwC;AAExC;;;;GAIG;AAEH;;;;;GAKG;AACH;IA+CI;;OAEG;IACH,mCAFW,oBAAoB,EAa9B;IA5DD;;QAEI,oBAAoB;eAAT,KAAK;MAElB;IAWF;;;;OAIG;IACH,sBAFU,oBAAoB,CAEF;IAE5B,uBAEC;IAED;;;;;;OAMG;IACH,oCAFa,OAAO,oBAAoB,EAAE,gBAAgB,EAAE,CAI3D;IAED;;;;OAIG;IACH,aAFa,MAAM,CAIlB;IAQG,yBAAyB;IACzB,UADW,QAAQ,EAAE,CACH;IAElB,uBAAuB;IACvB,QADW,QAAQ,CACI;IAEvB,2CAA2C;IAC3C,mBAAsB;IAG1B,wBAEC;IAED;;;OAGG;IACH,cASC;IAED;;;;;;OAMG;IACH,mBAEC;IAED;;;OAGG;IACH,uBAMC;IA2QD;;;OAGG;IACH,4BAHW,KAAK,QAKf;IAxPD;;;OAGG;IACH,kBAFW,QAAQ,QAIlB;IAED;;;OAGG;IACH,gBAFW,QAAQ,QAUlB;IAED;;OAEG;IACH,YAFW,QAAQ,QAQlB;IAED;;OAEG;IACH,6BAFW,QAAQ,QAMlB;IAED;;OAEG;IACH,0BAFW,QAAQ,QAalB;IAED;;;OAGG;IACH,mBAFW,QAAQ,QAWlB;IAED;;OAEG;IACH,eAiBC;IAED,kBAEC;IAED,uBAEC;IAED,sBAEC;IAED;;;;OAIG;IACH,eAFW,CAAC,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAC,GAAG;QAAE,aAAa,CAAC,EAAE,CAAS,IAAQ,EAAR,QAAQ,KAAE,IAAI,CAAA;KAAC,QAchF;IAED;;;OAGG;IACH,wBAHW,MAAM,GACJ,MAAM,CAWlB;IAED;;;OAGG;IACH,cAFW,KAAK,QAKf;IAED,iBAMC;IAED;;;;OAIG;IACH,2BAFW,MAAM,IAAI,QAQpB;IAED;;OAEG;IACH,gBAWC;IAED;;OAEG;IACH,uBAOC;IAED;;;;OAIG;IACH,sBAFW,OAAO,uBAAuB,EAAE,SAAS,QAMnD;IAED;;;OAGG;IACH,8BAHa,OAAO,qCAAqC,EAAE,OAAO,CAcjE;IAED;;;;OAIG;IACH,8BAQC;;CASJ;;mBAnYS,OAAO,qCAAqC,EAAE,OAAO;cACrD,OAAO,yBAAyB,EAAE,OAAO;;;;;oBAMtC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;;;;mBACnB,KAAK,EAAE"}

package/dist/src/data/flowNode.js

@@ -19,7 +19,9 @@ export const BEHAVIOR_MODIFIES = 1 << 1;
 export const BEHAVIOR_COLLECTS = 1 << 2;
 
 /**
- * @typedef {{paramRuntime?: import("../paramRuntime/viewParamRuntime.js").default}} ParamRuntimeProvider
+ * @typedef {object} ParamRuntimeProvider
+ * @prop {import("../paramRuntime/viewParamRuntime.js").default} [paramRuntime]
+ * @prop {import("../types/viewContext.js").default} [context]
  */
 
 /**
@@ -55,6 +57,17 @@ export default class FlowNode {
         return 0;
     }
 
+    /**
+     * Scale channels whose current domain affects this node's output.
+     * Downstream views must not feed these channels back into shared-domain
+     * resolution or domain-dependent flows can invalidate themselves.
+     *
+     * @returns {import("../spec/channel.js").ChannelWithScale[]}
+     */
+    get domainSensitiveScaleChannels() {
+        return [];
+    }
+
     /**
      * A human-readable label for the node. Used for debugging and logging.
      *
@@ -396,6 +409,29 @@ export default class FlowNode {
     }
 }
 
+/**
+ * Walks upstream from a flow node and collects scale channels whose current
+ * domain affects the produced data. Downstream encodings on these channels
+ * must not re-register as domain contributors or they will invalidate the
+ * domain that they themselves depend on.
+ *
+ * @param {FlowNode | undefined} node
+ * @returns {Set<import("../spec/channel.js").ChannelWithScale>}
+ */
+export function collectDomainSensitiveScaleChannels(node) {
+    /** @type {Set<import("../spec/channel.js").ChannelWithScale>} */
+    const channels = new Set();
+
+    while (node) {
+        for (const channel of node.domainSensitiveScaleChannels) {
+            channels.add(channel);
+        }
+        node = node.parent;
+    }
+
+    return channels;
+}
+
 /**
  * @param {import("../types/flowBatch.js").FlowBatch} flowBatch
  * @returns {flowBatch is import("../types/flowBatch.js").FileBatch}

package/dist/src/data/formats/bed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bed.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/bed.js"],"names":[],"mappings":"AAWA;;;;;GAKG;AACH,kCAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAqC1C"}
+{"version":3,"file":"bed.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/bed.js"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,kCAHW,MAAM,GACJ,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,CAsC1C"}

package/dist/src/data/formats/bed.js

@@ -1,3 +1,5 @@
+import { formats as vegaFormats } from "vega-loader";
+
 const blankLinePattern = /^\s*$/;
 const controlLinePattern = /^\s*(?:browser\b|track\b|#)/;
 
@@ -44,10 +46,13 @@ export default async function bed(data) {
             throw new Error(
                 `Cannot parse BED line ${i + 1}: ${
                     /** @type {Error} */ (error).message
-                }`
+                }`,
+                { cause: error }
             );
         }
     }
 
     return rows;
 }
+
+vegaFormats("bed", bed);

package/dist/src/data/formats/bedpe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bedpe.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/bedpe.js"],"names":[],"mappings":"AA+EA;;;GAGG;AACH,oCAHW,MAAM,WACN;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,yBA8EhC"}
+{"version":3,"file":"bedpe.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/bedpe.js"],"names":[],"mappings":"AAiFA;;;GAGG;AACH,oCAHW,MAAM,WACN;IAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,yBA8EhC"}

package/dist/src/data/formats/bedpe.js

@@ -1,3 +1,5 @@
+import { formats as vegaFormats } from "vega-loader";
+
 const blankLinePattern = /^\s*$/;
 const controlLinePattern = /^\s*(?:browser\b|track\b|#)/;
 
@@ -158,3 +160,5 @@ export default function bedpe(data, format = {}) {
 
     return rows;
 }
+
+vegaFormats("bedpe", bedpe);

package/dist/src/data/formats/fasta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fasta.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/fasta.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,oCAJW,MAAM,WACN,GAAG,GACD,aAAa,EAAE,CAsB3B;;;;;gBA3BS,MAAM;cACN,MAAM"}
+{"version":3,"file":"fasta.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/fasta.js"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,oCAJW,MAAM,WACN,GAAG,GACD,aAAa,EAAE,CAsB3B;;;;;gBA3BS,MAAM;cACN,MAAM"}

package/dist/src/data/formats/fasta.js

@@ -1,3 +1,5 @@
+import { formats as vegaFormats } from "vega-loader";
+
 /**
  * A bare-bones FASTA-parser
  *
@@ -30,3 +32,5 @@ export default function fasta(data, options) {
 
     return sequences;
 }
+
+vegaFormats("fasta", fasta);

package/dist/src/data/formats/parquet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parquet.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/parquet.js"],"names":[],"mappings":"AAYA;;;;;GAKG;AACH,+BAJW,WAAW,GAAC,UAAU,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,EAAE,CAAC,CAWzC"}
+{"version":3,"file":"parquet.d.ts","sourceRoot":"","sources":["../../../../src/data/formats/parquet.js"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,+BAJW,WAAW,GAAC,UAAU,GACpB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAC,GAAG,CAAC,EAAE,CAAC,CAWzC"}

package/dist/src/data/formats/parquet.js

@@ -1,3 +1,5 @@
+import { formats as vegaFormats } from "vega-loader";
+
 /*
  * Adapted from: https://github.com/vega/vega-loader-parquet/blob/main/src/index.js
  */
@@ -27,3 +29,5 @@ export default async function parquet(data) {
 }
 
 parquet.responseType = "arrayBuffer";
+
+vegaFormats("parquet", parquet);

package/dist/src/data/sources/dataSourceFactory.d.ts

@@ -1,19 +1,8 @@
-/**
- * Registers a lazy data source for a custom type.
- *
- * @template {import("../../spec/data.js").LazyDataParams} P
- * @param {LazySourceEntry<P>["guard"]} guard
- * @param {LazySourceEntry<P>["Source"]} Source
- * @returns {() => void}
- */
-export function registerLazyDataSource<P extends import("../../spec/data.js").LazyDataParams>(guard: LazySourceEntry<P>["guard"], Source: LazySourceEntry<P>["Source"]): () => void;
 /**
  * @param {Partial<import("../../spec/data.js").Data>} params
  * @param {import("../../view/view.js").default} view
  */
 export default function createDataSource(params: Partial<import("../../spec/data.js").Data>, view: import("../../view/view.js").default): import("./dataSource.js").default;
-export type LazySourceEntry<P extends import("../../spec/data.js").LazyDataParams> = {
-    guard: (params: import("../../spec/data.js").LazyDataParams) => params is P;
-    Source: new (params: P, view: import("../../view/view.js").default) => import("./dataSource.js").default;
-};
+export { registerLazyDataSource };
+import { registerLazyDataSource } from "./lazy/lazyDataSourceRegistry.js";
 //# sourceMappingURL=dataSourceFactory.d.ts.map

package/dist/src/data/sources/dataSourceFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataSourceFactory.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/dataSourceFactory.js"],"names":[],"mappings":"AAuBA;;;;;;;GAOG;AACH,uCAL2D,CAAC,SAA/C,OAAQ,oBAAoB,EAAE,cAAe,SAC/C,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAC3B,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAC1B,MAAM,IAAI,CAYtB;AAED;;;GAGG;AACH,iDAHW,OAAO,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,QAC1C,OAAO,oBAAoB,EAAE,OAAO,qCAgB9C;4BAhD0D,CAAC,SAA/C,OAAQ,oBAAoB,EAAE,cAAe,IAC7C;IACR,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,oBAAoB,EAAE,cAAc,KAAK,MAAM,IAAI,CAAC,CAAC;IAC5E,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,oBAAoB,EAAE,OAAO,KAAK,OAAO,iBAAiB,EAAE,OAAO,CAAA;CACzG"}
+{"version":3,"file":"dataSourceFactory.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/dataSourceFactory.js"],"names":[],"mappings":"AAQA;;;GAGG;AACH,iDAHW,OAAO,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,QAC1C,OAAO,oBAAoB,EAAE,OAAO,qCAgB9C;;uCApBM,kCAAkC"}

package/dist/src/data/sources/dataSourceFactory.js

@@ -1,45 +1,10 @@
 import InlineSource, { isInlineData } from "./inlineSource.js";
 import UrlSource, { isUrlData } from "./urlSource.js";
 import SequenceSource, { isSequenceGenerator } from "./sequenceSource.js";
-import AxisTickSource from "./lazy/axisTickSource.js";
-import AxisGenomeSource from "./lazy/axisGenomeSource.js";
-import IndexedFastaSource from "./lazy/indexedFastaSource.js";
-import BigWigSource from "./lazy/bigWigSource.js";
-import BigBedSource from "./lazy/bigBedSource.js";
-import BamSource from "./lazy/bamSource.js";
-import Gff3Source from "./lazy/gff3Source.js";
-import VcfSource from "./lazy/vcfSource.js";
-
-/**
- * @template {import("../../spec/data.js").LazyDataParams} P
- * @typedef {{
- *   guard: (params: import("../../spec/data.js").LazyDataParams) => params is P,
- *   Source: new (params: P, view: import("../../view/view.js").default) => import("./dataSource.js").default
- * }} LazySourceEntry
- */
-
-/** @type {LazySourceEntry<any>[]} */
-const customLazySources = [];
-
-/**
- * Registers a lazy data source for a custom type.
- *
- * @template {import("../../spec/data.js").LazyDataParams} P
- * @param {LazySourceEntry<P>["guard"]} guard
- * @param {LazySourceEntry<P>["Source"]} Source
- * @returns {() => void}
- */
-export function registerLazyDataSource(guard, Source) {
-    /** @type {LazySourceEntry<any>} */
-    const entry = { guard, Source };
-    customLazySources.push(entry);
-    return () => {
-        const index = customLazySources.indexOf(entry);
-        if (index >= 0) {
-            customLazySources.splice(index, 1);
-        }
-    };
-}
+import {
+    createLazyDataSource,
+    registerLazyDataSource,
+} from "./lazy/lazyDataSourceRegistry.js";
 
 /**
  * @param {Partial<import("../../spec/data.js").Data>} params
@@ -70,105 +35,4 @@ function isLazyData(params) {
     return "lazy" in params;
 }
 
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").AxisTicksData}
- */
-function isAxisTickSource(params) {
-    return params?.type == "axisTicks";
-}
-
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").AxisGenomeData}
- */
-function isAxisGenomeSource(params) {
-    return params?.type == "axisGenome";
-}
-
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").IndexedFastaData}
- */
-function isIndexedFastaSource(params) {
-    return params?.type == "indexedFasta";
-}
-
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").BigWigData}
- */
-function isBigWigSource(params) {
-    return params?.type == "bigwig";
-}
-
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").BigBedData}
- */
-function isBigBedSource(params) {
-    return params?.type == "bigbed";
-}
-
-/**
- *
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").BamData}
- */
-function isBamSource(params) {
-    return params?.type == "bam";
-}
-
-/**
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").Gff3Data}
- */
-function isGff3Source(params) {
-    return params?.type == "gff3";
-}
-
-/**
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @returns {params is import("../../spec/data.js").VcfData}
- */
-function isVcfSource(params) {
-    return params?.type == "vcf";
-}
-
-/** @type {LazySourceEntry<any>[]} */
-const builtinLazySources = [
-    { guard: isAxisTickSource, Source: AxisTickSource },
-    { guard: isAxisGenomeSource, Source: AxisGenomeSource },
-    { guard: isIndexedFastaSource, Source: IndexedFastaSource },
-    { guard: isBigWigSource, Source: BigWigSource },
-    { guard: isBigBedSource, Source: BigBedSource },
-    { guard: isBamSource, Source: BamSource },
-    { guard: isGff3Source, Source: Gff3Source },
-    { guard: isVcfSource, Source: VcfSource },
-];
-
-/**
- * @param {import("../../spec/data.js").LazyDataParams} params
- * @param {import("../../view/view.js").default} view
- */
-function createLazyDataSource(params, view) {
-    for (const entry of customLazySources) {
-        if (entry.guard(params)) {
-            return new entry.Source(/** @type {any} */ (params), view);
-        }
-    }
-    for (const entry of builtinLazySources) {
-        if (entry.guard(params)) {
-            return new entry.Source(/** @type {any} */ (params), view);
-        }
-    }
-
-    throw new Error(
-        "Cannot figure out the data source type: " + JSON.stringify(params)
-    );
-}
+export { registerLazyDataSource };

package/dist/src/data/sources/dataUtils.d.ts

@@ -8,10 +8,12 @@
  */
 export function getFormat(params: import("../../spec/data.js").DataSource, urls?: string | string[]): {
     type?: "csv" | "tsv";
+    columns?: string[];
     parse?: import("../../spec/data.js").Parse | null;
 } | {
     type?: "dsv";
     delimiter: string;
+    columns?: string[];
     parse?: import("../../spec/data.js").Parse | null;
 } | {
     type?: "json";
@@ -28,6 +30,29 @@ export function getFormat(params: import("../../spec/data.js").DataSource, urls?
     type: string;
     parse?: import("../../spec/data.js").Parse | null;
 };
+/**
+ * Vega's DSV readers support synthetic header rows via `format.header`.
+ * GenomeSpy exposes the user-facing option as `format.columns`.
+ *
+ * @param {import("../../spec/data.js").DataFormat} format
+ */
+export function toVegaLoaderFormat(format: import("../../spec/data.js").DataFormat): {
+    type?: "csv" | "tsv";
+    columns?: string[];
+    parse?: import("../../spec/data.js").Parse | null;
+} | {
+    type?: "dsv";
+    delimiter: string;
+    columns?: string[];
+    parse?: import("../../spec/data.js").Parse | null;
+} | {
+    type?: "json";
+    property?: string;
+    parse?: import("../../spec/data.js").Parse | null;
+} | {
+    type: string;
+    parse?: import("../../spec/data.js").Parse | null;
+};
 /**
  * @param {string} type
  * @returns {string}

package/dist/src/data/sources/dataUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataUtils.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/dataUtils.js"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,kCAJW,OAAO,oBAAoB,EAAE,UAAU,SAEvC,MAAM,GAAG,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;EAsB3B;AAED;;;GAGG;AACH,mCAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;GAEG;AACH,wCAFW,MAAM,GAAG,MAAM,EAAE,UA2B3B;AAED;;GAEG;AACH,sCAFW,MAAM,WAWhB;AAkBD;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,aAAa,CAInE;AAED;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,aAAa,CAInE;AAED;;;GAGG;AACH,6CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,cAAc,CAIpE;AAED;;;;GAIG;AACH,sCAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,OAAO,CAI7D;AAED;;GAEG;AACH,wCAFW,MAAM,GAAG,SAAS,WAI5B;AA/CM,+BAAgC,GAAG,QAI3B,OAAO,uBAAuB,EAAE,MAAM;;UAGtB,OAAO,gBAAgB,EAAE,KAAK,qCANR"}
+{"version":3,"file":"dataUtils.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/dataUtils.js"],"names":[],"mappings":"AAMA;;;;;;;GAOG;AACH,kCAJW,OAAO,oBAAoB,EAAE,UAAU,SAEvC,MAAM,GAAG,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;EAsB3B;AAED;;;;;GAKG;AACH,2CAFW,OAAO,oBAAoB,EAAE,UAAU;;;;;;;;;;;;;;;;EAiBjD;AAED;;;GAGG;AACH,mCAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;GAEG;AACH,wCAFW,MAAM,GAAG,MAAM,EAAE,UA2B3B;AAED;;GAEG;AACH,sCAFW,MAAM,WAWhB;AAkBD;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,aAAa,CAInE;AAED;;;GAGG;AACH,4CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,aAAa,CAInE;AAED;;;GAGG;AACH,6CAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,cAAc,CAIpE;AAED;;;;GAIG;AACH,sCAHW,OAAO,oBAAoB,EAAE,UAAU,GACtC,UAAU,IAAI,OAAO,oBAAoB,EAAE,OAAO,CAI7D;AAED;;GAEG;AACH,wCAFW,MAAM,GAAG,SAAS,WAI5B;AA/CM,+BAAgC,GAAG,QAI3B,OAAO,uBAAuB,EAAE,MAAM;;UAGtB,OAAO,gBAAgB,EAAE,KAAK,qCANR"}

package/dist/src/data/sources/dataUtils.js

@@ -34,6 +34,29 @@ export function getFormat(params, urls = []) {
     return format;
 }
 
+/**
+ * Vega's DSV readers support synthetic header rows via `format.header`.
+ * GenomeSpy exposes the user-facing option as `format.columns`.
+ *
+ * @param {import("../../spec/data.js").DataFormat} format
+ */
+export function toVegaLoaderFormat(format) {
+    const readFormat = { ...format };
+
+    if (
+        (isCsvDataFormat(readFormat) || isDsvDataFormat(readFormat)) &&
+        readFormat.columns &&
+        !("header" in readFormat)
+    ) {
+        // @ts-ignore Vega loader supports `header`, but the public data format
+        // type intentionally exposes the GenomeSpy-level `columns` property
+        // instead.
+        readFormat.header = readFormat.columns;
+    }
+
+    return readFormat;
+}
+
 /**
  * @param {string} type
  * @returns {string}

package/dist/src/data/sources/inlineSource.js

@@ -1,5 +1,5 @@
 import { read } from "vega-loader";
-import { getFormat, makeWrapper } from "./dataUtils.js";
+import { getFormat, makeWrapper, toVegaLoaderFormat } from "./dataUtils.js";
 import DataSource from "./dataSource.js";
 
 /**
@@ -79,7 +79,7 @@ export default class InlineSource extends DataSource {
             data = [values];
         } else if (typeof values == "string") {
             // It's a string that needs to be parsed
-            data = read(values, getFormat(this.params));
+            data = read(values, toVegaLoaderFormat(getFormat(this.params)));
         } else {
             throw new Error(
                 '"values" in data configuration is not an array, object, or a string!'

package/dist/src/data/sources/lazy/axisGenomeSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axisGenomeSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/axisGenomeSource.js"],"names":[],"mappings":"AAEA;;;GAGG;AACH;IACI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,cAAc,QAC9C,OAAO,uBAAuB,EAAE,OAAO,EAIjD;CASJ;iCAtBgC,2BAA2B"}
+{"version":3,"file":"axisGenomeSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/axisGenomeSource.js"],"names":[],"mappings":"AAGA;;;GAGG;AACH;IACI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,cAAc,QAC9C,OAAO,uBAAuB,EAAE,OAAO,EAIjD;CASJ;iCAtBgC,2BAA2B"}

package/dist/src/data/sources/lazy/axisGenomeSource.js

@@ -1,3 +1,4 @@
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisLazySource from "./singleAxisLazySource.js";
 
 /**
@@ -21,3 +22,13 @@ export default class AxisGenomeSource extends SingleAxisLazySource {
         this.publishData([this.genome.chromosomes]);
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").AxisGenomeData}
+ */
+function isAxisGenomeSource(params) {
+    return params?.type == "axisGenome";
+}
+
+registerBuiltInLazyDataSource(isAxisGenomeSource, AxisGenomeSource);

package/dist/src/data/sources/lazy/axisTickSource.d.ts

@@ -12,7 +12,7 @@ export default class AxisTickSource extends SingleAxisLazySource {
      */
     ticks: import("../../../spec/channel.js").Scalar[];
     params: import("../../../spec/data.js").AxisTicksData;
-    onDomainChanged(): void;
+    onDomainChanged(): Promise<void>;
 }
 import SingleAxisLazySource from "./singleAxisLazySource.js";
 //# sourceMappingURL=axisTickSource.d.ts.map

package/dist/src/data/sources/lazy/axisTickSource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"axisTickSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/axisTickSource.js"],"names":[],"mappings":"AAYA;;GAEG;AACH;IAMI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,aAAa,QAC7C,OAAO,uBAAuB,EAAE,OAAO,EAYjD;IAnBD;;OAEG;IACH,OAFU,OAAO,0BAA0B,EAAE,MAAM,EAAE,CAE1C;IAeP,sDAAoB;IAcxB,wBAkCC;CACJ;iCAzEgC,2BAA2B"}
+{"version":3,"file":"axisTickSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/axisTickSource.js"],"names":[],"mappings":"AAaA;;GAEG;AACH;IAMI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,aAAa,QAC7C,OAAO,uBAAuB,EAAE,OAAO,EAYjD;IAnBD;;OAEG;IACH,OAFU,OAAO,0BAA0B,EAAE,MAAM,EAAE,CAE1C;IAeP,sDAAoB;IAcxB,iCAkCC;CACJ;iCAzEgC,2BAA2B"}