@genome-spy/core 0.72.0 → 0.74.0

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

@@ -17,8 +17,16 @@ export function getFormat(params: import("../../spec/data.js").DataSource, urls?
     type?: "json";
     property?: string;
     parse?: import("../../spec/data.js").Parse | null;
+} | {
+    type: "bed";
+    parse?: import("../../spec/data.js").Parse | null;
+} | {
+    type: "bedpe";
+    columns?: string[];
+    parse?: import("../../spec/data.js").Parse | null;
 } | {
     type: string;
+    parse?: import("../../spec/data.js").Parse | null;
 };
 /**
  * @param {string} type
@@ -29,6 +37,10 @@ export function responseType(type: string): string;
  * @param {string | string[]} url
  */
 export function extractTypeFromUrl(url: string | string[]): string;
+/**
+ * @param {string} url
+ */
+export function hasGzipExtension(url: string): boolean;
 /**
  * @param {import("../../spec/data.js").DataFormat} dataFormat
  * @return {dataFormat is import("../../spec/data.js").CsvDataFormat}
@@ -50,6 +62,10 @@ export function isJsonDataFormat(dataFormat: import("../../spec/data.js").DataFo
  * @return {dataSource is import("../../spec/data.js").UrlData}
  */
 export function isUrlData(dataSource: import("../../spec/data.js").DataSource): dataSource is import("../../spec/data.js").UrlData;
+/**
+ * @param {string | undefined} type
+ */
+export function isAutoParseFormat(type: string | undefined): boolean;
 export function makeWrapper(d: any): ((x: import("../../spec/channel.js").Scalar) => {
     data: import("../../spec/channel.js").Scalar;
 }) | ((x: import("../flowNode.js").Datum) => import("../flowNode.js").Datum);

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":"AAGA;;;;;;;GAOG;AACH,kCAJW,OAAO,oBAAoB,EAAE,UAAU,SAEvC,MAAM,GAAG,MAAM,EAAE;;;;;;;;;;;;;EAoB3B;AAED;;;GAGG;AACH,mCAHW,MAAM,GACJ,MAAM,CAIlB;AAED;;GAEG;AACH,wCAFW,MAAM,GAAG,MAAM,EAAE,UAU3B;AAWD;;;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;AAxCM,+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;;;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

@@ -1,6 +1,9 @@
 import { formats } from "vega-loader";
 import { isInlineData } from "./inlineSource.js";
 
+const autoParseFormats = new Set(["csv", "tsv", "dsv"]);
+const compressionExtensions = new Set(["gz", "bgz", "bgzf"]);
+
 /**
  * Validates data source params, infers format if not specified explicitly,
  * returns a complete DataSource params object.
@@ -16,8 +19,10 @@ export function getFormat(params, urls = []) {
     const format = { ...params.format };
 
     format.type ??= isUrlData(params) && extractTypeFromUrl(urls);
-    // @ts-ignore TODO: Fix typing
-    format.parse ??= "auto";
+    if (format.parse === undefined && isAutoParseFormat(format.type)) {
+        // @ts-ignore TODO: Fix typing
+        format.parse = "auto";
+    }
 
     if (!format.type) {
         throw new Error(
@@ -46,8 +51,46 @@ export function extractTypeFromUrl(url) {
     }
 
     if (url) {
-        return url.match(/\.(csv|tsv|json)/)?.[1];
+        const path = stripUrlQueryAndHash(url).split("/").pop()?.toLowerCase();
+
+        if (!path) {
+            return;
+        }
+
+        const extensions = path.split(".");
+        while (
+            extensions.length > 1 &&
+            compressionExtensions.has(extensions.at(-1))
+        ) {
+            extensions.pop();
+        }
+
+        const extension = extensions.at(-1);
+        if (extension && formats(extension)) {
+            return extension;
+        }
+    }
+}
+
+/**
+ * @param {string} url
+ */
+export function hasGzipExtension(url) {
+    const path = stripUrlQueryAndHash(url).split("/").pop()?.toLowerCase();
+
+    if (!path) {
+        return false;
     }
+
+    const extension = path.split(".").at(-1);
+    return !!extension && compressionExtensions.has(extension);
+}
+
+/**
+ * @param {string} url
+ */
+function stripUrlQueryAndHash(url) {
+    return url.replace(/[?#].*$/, "");
 }
 
 export const makeWrapper = (/** @type {any} */ d) =>
@@ -91,3 +134,10 @@ export function isJsonDataFormat(dataFormat) {
 export function isUrlData(dataSource) {
     return "url" in dataSource;
 }
+
+/**
+ * @param {string | undefined} type
+ */
+export function isAutoParseFormat(type) {
+    return autoParseFormats.has(type);
+}

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"}

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

@@ -8,6 +8,7 @@ import {
     tickFormat,
     tickCount,
 } from "../../../scale/ticks.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisLazySource from "./singleAxisLazySource.js";
 
 /**
@@ -43,24 +44,24 @@ export default class AxisTickSource extends SingleAxisLazySource {
         // Force the ticks to be recalculated. This is needed because the async
         // initialization process and non-deterministic order of events.
         this.ticks = null;
-        this.onDomainChanged();
+        await this.onDomainChanged();
     }
 
-    onDomainChanged() {
-        // Note, although this function is async, it is not awaited. Data are updated
-        // synchronously to ensure that the new ticks are available before the next frame is drawn.
-
+    async onDomainChanged() {
         const scale = this.scaleResolution.getScale();
         const axisLength = this.scaleResolution.getAxisLength();
         const axisParams = this.params.axis;
 
         /**
-         * Make ticks more dense in small plots.
+         * Make ticks denser in small plots.
          * TODO: Make configurable
          *
-         * @param {number} length
+         * @type {(length: number) => number}
          */
-        const tickSpacing = (length) => 25 + 60 * smoothstep(100, 700, length);
+        const tickSpacing =
+            scale.type != "locus"
+                ? (length) => 30 + 55 * smoothstep(100, 700, length)
+                : () => 85;
 
         const requestedCount = isNumber(axisParams.tickCount)
             ? axisParams.tickCount
@@ -82,3 +83,13 @@ export default class AxisTickSource extends SingleAxisLazySource {
         }
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").AxisTicksData}
+ */
+function isAxisTickSource(params) {
+    return params?.type == "axisTicks";
+}
+
+registerBuiltInLazyDataSource(isAxisTickSource, AxisTickSource);

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

@@ -1 +1 @@
-{"version":3,"file":"bamSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bamSource.js"],"names":[],"mappings":"AAGA;IAeI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,OAAO,QACvC,OAAO,uBAAuB,EAAE,OAAO,EAmDjD;IAhED;;;;;;;;OAQG;IACH,gBAFU,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAEH;IAkB1B,gDAAgC;IAQhC,iCA4BE;;CAuCT;qCA5GoC,+BAA+B"}
+{"version":3,"file":"bamSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bamSource.js"],"names":[],"mappings":"AAIA;IAeI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,OAAO,QACvC,OAAO,uBAAuB,EAAE,OAAO,EAmDjD;IAhED;;;;;;;;OAQG;IACH,gBAFU,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAEH;IAkB1B,gDAAgC;IAQhC,iCA4BE;;CAuCT;qCA5GoC,+BAA+B"}

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

@@ -1,4 +1,5 @@
 import addBaseUrl from "../../../utils/addBaseUrl.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisWindowedSource from "./singleAxisWindowedSource.js";
 
 export default class BamSource extends SingleAxisWindowedSource {
@@ -108,3 +109,13 @@ export default class BamSource extends SingleAxisWindowedSource {
         }
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").BamData}
+ */
+function isBamSource(params) {
+    return params?.type == "bam";
+}
+
+registerBuiltInLazyDataSource(isBamSource, BamSource);

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

@@ -1 +1 @@
-{"version":3,"file":"bigBedSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bigBedSource.js"],"names":[],"mappings":"AAOA;IAUI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,UAAU,QAC1C,OAAO,uBAAuB,EAAE,OAAO,EAoCjD;IA/CD,0CAA0C;IAC1C,QADW,OAAO,WAAW,EAAE,OAAO,CAC/B;IAEP,yCAAyC;IACzC,KADW,OAAO,WAAW,EAAE,MAAM,CACjC;IAEJ,4GAA4G;IAC5G,WADW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC9F;IAmBN,mDAYC;;CAwFR;qCAjIoC,+BAA+B"}
+{"version":3,"file":"bigBedSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bigBedSource.js"],"names":[],"mappings":"AAQA;IAUI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,UAAU,QAC1C,OAAO,uBAAuB,EAAE,OAAO,EAoCjD;IA/CD,0CAA0C;IAC1C,QADW,OAAO,WAAW,EAAE,OAAO,CAC/B;IAEP,yCAAyC;IACzC,KADW,OAAO,WAAW,EAAE,MAAM,CACjC;IAEJ,4GAA4G;IAC5G,WADW,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAC9F;IAmBN,mDAYC;;CAwFR;qCAjIoC,+BAA+B"}

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

@@ -3,6 +3,7 @@ import {
     withoutExprRef,
 } from "../../../paramRuntime/paramUtils.js";
 import addBaseUrl from "../../../utils/addBaseUrl.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisWindowedSource from "./singleAxisWindowedSource.js";
 
 export default class BigBedSource extends SingleAxisWindowedSource {
@@ -87,7 +88,7 @@ export default class BigBedSource extends SingleAxisWindowedSource {
                             const fastParser = makeFastParser(this.parser);
                             this.parseLine = (chrom, f) =>
                                 fastParser(chrom, f.start, f.end, f.rest);
-                        } catch (e) {
+                        } catch {
                             this.parseLine = (chrom, f) =>
                                 this.parser.parseLine(
                                     `${chrom}\t${f.start}\t${f.end}\t${f.rest}`
@@ -299,6 +300,16 @@ function makeFastParser(bed) {
     return parseLine;
 }
 
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").BigBedData}
+ */
+function isBigBedSource(params) {
+    return params?.type == "bigbed";
+}
+
+registerBuiltInLazyDataSource(isBigBedSource, BigBedSource);
+
 /**
  * @param {T[]} arr
  * @param {number} size

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

@@ -1 +1 @@
-{"version":3,"file":"bigWigSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bigWigSource.js"],"names":[],"mappings":"AAOA;;GAEG;AACH;IAOI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,UAAU,QAC1C,OAAO,uBAAuB,EAAE,OAAO,EAoCjD;IArBG,mDAYC;IA+DL;;;;OAIG;IACH,wBAFW,MAAM,EAAE,iBAqBlB;IAED;;;OAGG;IAEH,uBAJW,MAAM,EAAE,kBACR,MAAM,iBA2BhB;;CACJ;qCAhKoC,+BAA+B"}
+{"version":3,"file":"bigWigSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/bigWigSource.js"],"names":[],"mappings":"AAQA;;GAEG;AACH;IAOI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,UAAU,QAC1C,OAAO,uBAAuB,EAAE,OAAO,EAoCjD;IArBG,mDAYC;IA+DL;;;;OAIG;IACH,wBAFW,MAAM,EAAE,iBAqBlB;IAED;;;OAGG;IAEH,uBAJW,MAAM,EAAE,kBACR,MAAM,iBA2BhB;;CACJ;qCAhKoC,+BAA+B"}

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

@@ -3,6 +3,7 @@ import {
     withoutExprRef,
 } from "../../../paramRuntime/paramUtils.js";
 import addBaseUrl from "../../../utils/addBaseUrl.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisWindowedSource from "./singleAxisWindowedSource.js";
 
 /**
@@ -165,6 +166,16 @@ export default class BigWigSource extends SingleAxisWindowedSource {
     }
 }
 
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").BigWigData}
+ */
+function isBigWigSource(params) {
+    return params?.type == "bigwig";
+}
+
+registerBuiltInLazyDataSource(isBigWigSource, BigWigSource);
+
 /**
  * @param {number[]} domain
  * @param {number} widthInPixels view width in pixels

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

@@ -1 +1 @@
-{"version":3,"file":"gff3Source.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/gff3Source.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;;;CAuBC;wBA5BuB,kBAAkB"}
+{"version":3,"file":"gff3Source.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/gff3Source.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;;;CAuBC;wBA5BuB,kBAAkB"}

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

@@ -1,3 +1,4 @@
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import TabixSource from "./tabixSource.js";
 
 /**
@@ -22,8 +23,18 @@ export default class Gff3Source extends TabixSource {
      * @param {string[]} lines
      */
     _parseFeatures(lines) {
-        const features = this.#gff?.parseArraySync(lines);
+        const features = this.#gff?.parseStringSync(lines.join("\n"));
 
         return features;
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").Gff3Data}
+ */
+function isGff3Source(params) {
+    return params?.type == "gff3";
+}
+
+registerBuiltInLazyDataSource(isGff3Source, Gff3Source);

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

@@ -1 +1 @@
-{"version":3,"file":"indexedFastaSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/indexedFastaSource.js"],"names":[],"mappings":"AAGA;IACI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,gBAAgB,QAChD,OAAO,uBAAuB,EAAE,OAAO,EAwCjD;IA1BG,yDAAgC;IAQhC,iCAiBE;IATM,iDAKE;CAwCjB;qCAhFoC,+BAA+B"}
+{"version":3,"file":"indexedFastaSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/indexedFastaSource.js"],"names":[],"mappings":"AAIA;IACI;;;OAGG;IACH,oBAHW,OAAO,uBAAuB,EAAE,gBAAgB,QAChD,OAAO,uBAAuB,EAAE,OAAO,EAwCjD;IA1BG,yDAAgC;IAQhC,iCAiBE;IATM,iDAKE;CAwCjB;qCAhFoC,+BAA+B"}

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

@@ -1,4 +1,5 @@
 import addBaseUrl from "../../../utils/addBaseUrl.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 import SingleAxisWindowedSource from "./singleAxisWindowedSource.js";
 
 export default class IndexedFastaSource extends SingleAxisWindowedSource {
@@ -80,3 +81,13 @@ export default class IndexedFastaSource extends SingleAxisWindowedSource {
         this.publishData([features.filter((f) => f !== undefined)]);
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").IndexedFastaData}
+ */
+function isIndexedFastaSource(params) {
+    return params?.type == "indexedFasta";
+}
+
+registerBuiltInLazyDataSource(isIndexedFastaSource, IndexedFastaSource);

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

@@ -0,0 +1,27 @@
+/**
+ * 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;
+/**
+ * Registers a built-in lazy data source.
+ *
+ * @template {import("../../../spec/data.js").LazyDataParams} P
+ * @param {LazySourceEntry<P>["guard"]} guard
+ * @param {LazySourceEntry<P>["Source"]} Source
+ */
+export function registerBuiltInLazyDataSource<P extends import("../../../spec/data.js").LazyDataParams>(guard: LazySourceEntry<P>["guard"], Source: LazySourceEntry<P>["Source"]): void;
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @param {import("../../../view/view.js").default} view
+ */
+export function createLazyDataSource(params: import("../../../spec/data.js").LazyDataParams, 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: any, view: import("../../../view/view.js").default) => import("../dataSource.js").default;
+};
+//# sourceMappingURL=lazyDataSourceRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lazyDataSourceRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/lazyDataSourceRegistry.js"],"names":[],"mappings":"AAcA;;;;;;;GAOG;AACH,uCAL8D,CAAC,SAAlD,OAAQ,uBAAuB,EAAE,cAAe,SAClD,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAC3B,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAC1B,MAAM,IAAI,CAYtB;AAED;;;;;;GAMG;AACH,8CAJ8D,CAAC,SAAlD,OAAQ,uBAAuB,EAAE,cAAe,SAClD,eAAe,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAC3B,eAAe,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,QAItC;AAED;;;GAGG;AACH,6CAHW,OAAO,uBAAuB,EAAE,cAAc,QAC9C,OAAO,uBAAuB,EAAE,OAAO,sCAiBjD;4BA/D6D,CAAC,SAAlD,OAAQ,uBAAuB,EAAE,cAAe,IAChD;IACR,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,uBAAuB,EAAE,cAAc,KAAK,MAAM,IAAI,CAAC,CAAC;IAC/E,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,uBAAuB,EAAE,OAAO,KAAK,OAAO,kBAAkB,EAAE,OAAO,CAAA;CAC/G"}

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

@@ -0,0 +1,65 @@
+/**
+ * @template {import("../../../spec/data.js").LazyDataParams} P
+ * @typedef {{
+ *   guard: (params: import("../../../spec/data.js").LazyDataParams) => params is P,
+ *   Source: new (params: any, view: import("../../../view/view.js").default) => import("../dataSource.js").default
+ * }} LazySourceEntry
+ */
+
+/** @type {LazySourceEntry<any>[]} */
+const customLazySources = [];
+
+/** @type {LazySourceEntry<any>[]} */
+const builtinLazySources = [];
+
+/**
+ * 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);
+        }
+    };
+}
+
+/**
+ * Registers a built-in lazy data source.
+ *
+ * @template {import("../../../spec/data.js").LazyDataParams} P
+ * @param {LazySourceEntry<P>["guard"]} guard
+ * @param {LazySourceEntry<P>["Source"]} Source
+ */
+export function registerBuiltInLazyDataSource(guard, Source) {
+    builtinLazySources.push({ guard, Source });
+}
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @param {import("../../../view/view.js").default} view
+ */
+export 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)
+    );
+}

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

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

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

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

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

@@ -0,0 +1,8 @@
+import "./axisTickSource.js";
+import "./axisGenomeSource.js";
+import "./indexedFastaSource.js";
+import "./bigWigSource.js";
+import "./bigBedSource.js";
+import "./bamSource.js";
+import "./gff3Source.js";
+import "./vcfSource.js";

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

@@ -1 +1 @@
-{"version":3,"file":"singleAxisLazySource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/singleAxisLazySource.js"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,wEAFgB,sBAAsB;IAelC;;;OAGG;IACH,kBAHW,OAAO,uBAAuB,EAAE,OAAO,WACvC,OAAO,0BAA0B,EAAE,wBAAwB,EA+CrE;IA7DD;;;OAGG;IACH,4CAAuC;IAEvC;;;OAGG;IACH,6BAHU,MAAM,EAAE,GAAG,SAAS,CAGZ;IAmBd,2EAA2E;IAC3E,SADW,OAAO,0BAA0B,EAAE,wBAAwB,CAChD;IAEtB,sEAA4D;IA+BhE;;;;OAIG;IACH,oEASC;IAED;;;;;;OAMG;IACH,wBAJW,MAAM,EAAE,iBACR,OAAO,yBAAyB,EAAE,gBAAgB,EAAE,QAK9D;IAED;;;;;OAKG;IACH,gCAGC;IAQD;;;;;;;;OAQG;IACH,8BAHW,OAAO,mBAAmB,EAAE,KAAK,EAAE,EAAE,QAe/C;IAED;;;OAGG;IACH,8BAHW,oBAAoB,GAClB,OAAO,CAenB;CACJ;mCAlKY,OAAO,CAAC,MAAM,CAAC,OAAO,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC,CAAC;qCAItF;IAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAA;CAAC;uBAPxD,kBAAkB"}
+{"version":3,"file":"singleAxisLazySource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/singleAxisLazySource.js"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;GAEG;AAEH;;;;;GAKG;AACH,wEAFgB,sBAAsB;IAelC;;;OAGG;IACH,kBAHW,OAAO,uBAAuB,EAAE,OAAO,WACvC,OAAO,0BAA0B,EAAE,wBAAwB,EA+CrE;IA7DD;;;OAGG;IACH,4CAAuC;IAEvC;;;OAGG;IACH,6BAHU,MAAM,EAAE,GAAG,SAAS,CAGZ;IAmBd,2EAA2E;IAC3E,SADW,OAAO,0BAA0B,EAAE,wBAAwB,CAChD;IAEtB,sEAA4D;IA+BhE;;;;OAIG;IACH,oEASC;IAED;;;;;;OAMG;IACH,wBAJW,MAAM,EAAE,iBACR,OAAO,yBAAyB,EAAE,gBAAgB,EAAE,QAK9D;IAED;;;;;OAKG;IACH,gCAGC;IAQD;;;;;;;;OAQG;IACH,8BAHW,OAAO,mBAAmB,EAAE,KAAK,EAAE,EAAE,QAe/C;IAED;;;OAGG;IACH,8BAHW,oBAAoB,GAClB,OAAO,CAenB;CACJ;mCAlKY,OAAO,CAAC,MAAM,CAAC,OAAO,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,EAAE,CAAC,CAAC;qCAItF;IAAC,oBAAoB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAA;CAAC;uBAPxD,kBAAkB"}

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

@@ -1,4 +1,3 @@
-import UnitView from "../../../view/unitView.js";
 import DataSource from "../dataSource.js";
 
 /**
@@ -53,7 +52,7 @@ export default class SingleAxisLazySource extends DataSource {
             const sentences = [
                 `The lazy data source cannot find a resolved scale for channel "${channel}".`,
             ];
-            if (!(this.view instanceof UnitView)) {
+            if (!isUnitViewLike(this.view)) {
                 sentences.push(
                     `Make sure the view has a "shared" scale resolution as it is not a unit view.`
                 );
@@ -165,3 +164,13 @@ export default class SingleAxisLazySource extends DataSource {
         return min >= loadedMin && max <= loadedMax;
     }
 }
+
+/**
+ * Unit views expose `getMarkType()`, while container and helper views do not.
+ *
+ * @param {import("../../../view/view.js").default} view
+ * @returns {view is import("../../../view/unitView.js").default}
+ */
+function isUnitViewLike(view) {
+    return typeof (/** @type {any} */ (view).getMarkType) == "function";
+}

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

@@ -1 +1 @@
-{"version":3,"file":"vcfSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/vcfSource.js"],"names":[],"mappings":"AAEA;;GAEG;AACH;;;CAgCC;wBArCuB,kBAAkB"}
+{"version":3,"file":"vcfSource.d.ts","sourceRoot":"","sources":["../../../../../src/data/sources/lazy/vcfSource.js"],"names":[],"mappings":"AAGA;;GAEG;AACH;;;CAgCC;wBAtCuB,kBAAkB"}

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

@@ -1,4 +1,5 @@
 import TabixSource from "./tabixSource.js";
+import { registerBuiltInLazyDataSource } from "./lazyDataSourceRegistry.js";
 
 /**
  * @extends {TabixSource<import("./vcfTypes.js").ParsedVariant>}
@@ -36,3 +37,13 @@ export default class VcfSource extends TabixSource {
         });
     }
 }
+
+/**
+ * @param {import("../../../spec/data.js").LazyDataParams} params
+ * @returns {params is import("../../../spec/data.js").VcfData}
+ */
+function isVcfSource(params) {
+    return params?.type == "vcf";
+}
+
+registerBuiltInLazyDataSource(isVcfSource, VcfSource);

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

@@ -3,6 +3,10 @@
  * @returns {data is import("../../spec/data.js").UrlData}
  */
 export function isUrlData(data: Partial<import("../../spec/data.js").Data>): data is import("../../spec/data.js").UrlData;
+/**
+ * Loads eager data from URLs and transparently decompresses gzip-compatible
+ * payloads before handing them to the registered format reader.
+ */
 export default class UrlSource extends DataSource {
     /**
      * @param {import("../../spec/data.js").UrlData} params

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

@@ -1 +1 @@
-{"version":3,"file":"urlSource.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/urlSource.js"],"names":[],"mappings":"AASA;;;GAGG;AACH,gCAHW,OAAO,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,GACxC,IAAI,IAAI,OAAO,oBAAoB,EAAE,OAAO,CAIxD;AAED;IACI;;;OAGG;IACH,oBAHW,OAAO,oBAAoB,EAAE,OAAO,QACpC,OAAO,oBAAoB,EAAE,OAAO,EAc9C;IATG,6CAMC;IAED,gBAAiC;;CA4GxC;uBA3IsB,iBAAiB"}
+{"version":3,"file":"urlSource.d.ts","sourceRoot":"","sources":["../../../../src/data/sources/urlSource.js"],"names":[],"mappings":"AAkJA;;;GAGG;AACH,gCAHW,OAAO,CAAC,OAAO,oBAAoB,EAAE,IAAI,CAAC,GACxC,IAAI,IAAI,OAAO,oBAAoB,EAAE,OAAO,CAIxD;AA5ID;;;GAGG;AACH;IACI;;;OAGG;IACH,oBAHW,OAAO,oBAAoB,EAAE,OAAO,QACpC,OAAO,oBAAoB,EAAE,OAAO,EAc9C;IATG,6CAMC;IAED,gBAAiC;;CAgHxC;uBA9IsB,iBAAiB"}