loom-browser 0.0.13 → 0.0.14

package/dist/loom.js

@@ -3557,14 +3557,14 @@
     // ─── Internal helpers ─────────────────────────────────────────────────────────
     // Cache BigWig instances by URL to reuse parsed headers and trees.
     // Auth-aware readers share the cache key (URL) — the fetchImpl is bound at creation.
-    const readerCache$4 = new Map();
+    const readerCache$5 = new Map();
     function getGmodReader(url, fetchImpl) {
         const resolvedUrl = normalizeGoogleURL(url);
-        let reader = readerCache$4.get(resolvedUrl);
+        let reader = readerCache$5.get(resolvedUrl);
         if (!reader) {
             const fileOpts = fetchImpl ? { fetch: fetchImpl } : undefined;
             reader = new BigWig({ filehandle: new RemoteFile(resolvedUrl, fileOpts) });
-            readerCache$4.set(resolvedUrl, reader);
+            readerCache$5.set(resolvedUrl, reader);
         }
         return reader;
     }
@@ -3685,7 +3685,7 @@
             // Evict the cached reader so the next fetch gets a fresh one.
             // @gmod/bbi caches the header promise; an aborted parse poisons it permanently.
             if (err instanceof Error && (err.name === 'AbortError' || ((_b = err.message) === null || _b === void 0 ? void 0 : _b.includes('aborted')))) {
-                readerCache$4.delete(url);
+                readerCache$5.delete(url);
             }
             throw err;
         }
@@ -3701,7 +3701,7 @@
     }
     /** Clear the BigWig reader cache (useful for testing or memory management). */
     function clearBigWigCache() {
-        readerCache$4.clear();
+        readerCache$5.clear();
     }
 
     /**
@@ -5046,12 +5046,12 @@
      * Layer 1 (Data + Layout): no DOM, no canvas.
      */
     // Cache readers by URL to reuse parsed headers, dictionaries, and indexes
-    const readerCache$3 = new Map();
-    function getReader$3(url, fetchImpl) {
-        let reader = readerCache$3.get(url);
+    const readerCache$4 = new Map();
+    function getReader$4(url, fetchImpl) {
+        let reader = readerCache$4.get(url);
         if (!reader) {
             reader = new GtxReader(url, fetchImpl);
-            readerCache$3.set(url, reader);
+            readerCache$4.set(url, reader);
         }
         return reader;
     }
@@ -5060,7 +5060,7 @@
      */
     async function fetchGtxFeatures(url, experimentId, locus, options = {}) {
         var _a;
-        const reader = getReader$3(url, options.fetchImpl);
+        const reader = getReader$4(url, options.fetchImpl);
         await reader.init(options.signal);
         const expIdx = reader.resolveExperimentIndex(experimentId);
         if (expIdx === undefined) {
@@ -5074,7 +5074,7 @@
      * Returns features with per-chromosome coordinates (caller transforms to genome-wide).
      */
     async function fetchGtxWGFeatures(url, experimentId, chromNames, bpPerPixel, options = {}) {
-        const reader = getReader$3(url, options.fetchImpl);
+        const reader = getReader$4(url, options.fetchImpl);
         await reader.init(options.signal);
         const expIdx = reader.resolveExperimentIndex(experimentId);
         if (expIdx === undefined) {
@@ -5103,7 +5103,7 @@
      */
     async function fetchGtxMultiFeatures(url, experimentIds, locus, options = {}) {
         var _a;
-        const reader = getReader$3(url, options.fetchImpl);
+        const reader = getReader$4(url, options.fetchImpl);
         await reader.init(options.signal);
         const idToIdx = new Map();
         const indexes = [];
@@ -5125,10 +5125,10 @@
     }
     /** Clear the GTX reader cache (useful for testing or memory management). */
     function clearGtxCache() {
-        for (const reader of readerCache$3.values()) {
+        for (const reader of readerCache$4.values()) {
             reader.dispose();
         }
-        readerCache$3.clear();
+        readerCache$4.clear();
         clearCoordinators();
     }
 
@@ -5150,12 +5150,12 @@
      * Layer 1 (Data + Layout): no DOM, no canvas.
      */
     // Cache readers by URL (shared with gtx/index.ts reader cache)
-    const readerCache$2 = new Map();
-    function getReader$2(url, fetchImpl) {
-        let reader = readerCache$2.get(url);
+    const readerCache$3 = new Map();
+    function getReader$3(url, fetchImpl) {
+        let reader = readerCache$3.get(url);
         if (!reader) {
             reader = new GtxReader(url, fetchImpl);
-            readerCache$2.set(url, reader);
+            readerCache$3.set(url, reader);
         }
         return reader;
     }
@@ -5165,7 +5165,7 @@
             this.experimentId = experimentId;
             this._windowFunction = windowFunction;
             this.fetchImpl = fetchImpl;
-            this.reader = getReader$2(url, fetchImpl);
+            this.reader = getReader$3(url, fetchImpl);
         }
         get windowFunction() { return this._windowFunction; }
         /** Update the window function for future fetches. */
@@ -15399,6 +15399,12 @@
     }
     /** BigWig/BigBed format set — these use BWSource in igv.js. */
     const bbFormats = new Set(['bigwig', 'bw', 'bigbed', 'bb', 'biginteract', 'biggenepred', 'bignarrowpeak']);
+    /** BigBed-specific formats (annotation data, not quantitative). */
+    const bigBedFormats = new Set(['bigbed', 'bb', 'biginteract', 'biggenepred', 'bignarrowpeak']);
+    /** Check if a format string represents a BigBed (annotation) format vs BigWig (quantitative). */
+    function isBigBedFormat(format) {
+        return bigBedFormats.has(format.toLowerCase());
+    }
     /**
      * Check if a URL is likely tabix-indexed.
      *
@@ -22081,15 +22087,15 @@
      */
     // ─── Internal helpers ─────────────────────────────────────────────────────────
     // Cache TwoBitFile instances by URL to reuse parsed headers and indices.
-    const readerCache$1 = new Map();
+    const readerCache$2 = new Map();
     // Parallel filehandle cache for direct batched reads (bypasses @gmod/twobit).
     const filehandleCache = new Map();
-    function getReader$1(url, fetchImpl) {
-        let reader = readerCache$1.get(url);
+    function getReader$2(url, fetchImpl) {
+        let reader = readerCache$2.get(url);
         if (!reader) {
             const filehandle = getFilehandle(url, fetchImpl);
             reader = new TwoBitFile({ filehandle });
-            readerCache$1.set(url, reader);
+            readerCache$2.set(url, reader);
         }
         return reader;
     }
@@ -22153,7 +22159,7 @@
      * instead of 100K+.
      */
     async function fetchChromSizesBatched(url, fetchImpl) {
-        const reader = getReader$1(url, fetchImpl);
+        const reader = getReader$2(url, fetchImpl);
         const fh = getFilehandle(url, fetchImpl);
         // Step 1: get the index (name → file offset). Cached after first call.
         const index = await reader.getIndex();
@@ -22221,14 +22227,14 @@
     function createTwoBitSequenceProvider(url, fetchImpl) {
         return async (locus) => {
             var _a;
-            const reader = getReader$1(url, fetchImpl);
+            const reader = getReader$2(url, fetchImpl);
             try {
                 const sequence = await reader.getSequence(locus.chr, locus.start, locus.end);
                 return sequence !== null && sequence !== void 0 ? sequence : '';
             }
             catch (err) {
                 if (err instanceof Error && (err.name === 'AbortError' || ((_a = err.message) === null || _a === void 0 ? void 0 : _a.includes('aborted')))) {
-                    readerCache$1.delete(url);
+                    readerCache$2.delete(url);
                     filehandleCache.delete(url);
                 }
                 throw err;
@@ -22256,12 +22262,12 @@
      * individual sequence records.
      */
     async function fetchTwoBitSequenceNames(url, fetchImpl) {
-        const reader = getReader$1(url, fetchImpl);
+        const reader = getReader$2(url, fetchImpl);
         return reader.getSequenceNames();
     }
     /** Clear the TwoBit reader cache (useful for testing or memory management). */
     function clearTwoBitCache() {
-        readerCache$1.clear();
+        readerCache$2.clear();
         filehandleCache.clear();
     }
 
@@ -22465,10 +22471,10 @@
      */
     // ─── Internal helpers ─────────────────────────────────────────────────────────
     // Cache reader instances by URL to reuse parsed indices.
-    const readerCache = new Map();
-    function getReader(fastaURL, indexURL, compressedIndexURL, fetchImpl) {
+    const readerCache$1 = new Map();
+    function getReader$1(fastaURL, indexURL, compressedIndexURL, fetchImpl) {
         const cacheKey = fastaURL;
-        let reader = readerCache.get(cacheKey);
+        let reader = readerCache$1.get(cacheKey);
         if (!reader) {
             const fileOpts = fetchImpl ? { fetch: fetchImpl } : undefined;
             if (compressedIndexURL) {
@@ -22484,7 +22490,7 @@
                     fai: new RemoteFile(indexURL, fileOpts),
                 });
             }
-            readerCache.set(cacheKey, reader);
+            readerCache$1.set(cacheKey, reader);
         }
         return reader;
     }
@@ -22504,14 +22510,14 @@
         const faiURL = indexURL !== null && indexURL !== void 0 ? indexURL : fastaURL + '.fai';
         return async (locus, signal) => {
             var _a;
-            const reader = getReader(fastaURL, faiURL, compressedIndexURL, fetchImpl);
+            const reader = getReader$1(fastaURL, faiURL, compressedIndexURL, fetchImpl);
             try {
                 const sequence = await reader.getSequence(locus.chr, locus.start, locus.end, { signal });
                 return sequence !== null && sequence !== void 0 ? sequence : '';
             }
             catch (err) {
                 if (err instanceof Error && (err.name === 'AbortError' || ((_a = err.message) === null || _a === void 0 ? void 0 : _a.includes('aborted')))) {
-                    readerCache.delete(fastaURL);
+                    readerCache$1.delete(fastaURL);
                 }
                 throw err;
             }
@@ -22525,7 +22531,7 @@
      */
     async function fetchFastaChromSizes(fastaURL, indexURL, fetchImpl) {
         const faiURL = indexURL !== null && indexURL !== void 0 ? indexURL : fastaURL + '.fai';
-        const reader = getReader(fastaURL, faiURL, undefined, fetchImpl);
+        const reader = getReader$1(fastaURL, faiURL, undefined, fetchImpl);
         return reader.getSequenceSizes();
     }
     /**
@@ -22533,12 +22539,12 @@
      */
     async function fetchFastaSequenceNames(fastaURL, indexURL, fetchImpl) {
         const faiURL = indexURL !== null && indexURL !== void 0 ? indexURL : fastaURL + '.fai';
-        const reader = getReader(fastaURL, faiURL, undefined, fetchImpl);
+        const reader = getReader$1(fastaURL, faiURL, undefined, fetchImpl);
         return reader.getSequenceNames();
     }
     /** Clear the FASTA reader cache (useful for testing or memory management). */
     function clearFastaCache() {
-        readerCache.clear();
+        readerCache$1.clear();
     }
 
     /**
@@ -23062,7 +23068,7 @@
      * Layer 1 (Data): no DOM, no canvas.
      */
     /** Known data source config types. */
-    const KNOWN_DS_TYPES = new Set(['bigwig', 'gtx', 'ucsc', 'text', 'memory']);
+    const KNOWN_DS_TYPES = new Set(['bigwig', 'bigbed', 'gtx', 'ucsc', 'text', 'memory']);
     /** Check whether a data source config type is one of the known concrete types. */
     function isKnownDataSourceType(type) {
         return KNOWN_DS_TYPES.has(type);
@@ -23096,7 +23102,16 @@
             auth.headers = config.headers;
         if (config.withCredentials)
             auth.withCredentials = config.withCredentials;
-        // BigWig / BigBed binary formats
+        // BigBed binary formats (annotation data)
+        if (format && isBigBedFormat(format)) {
+            log.warn(`Unknown data source type "${type}", inferred "bigbed" from URL: ${url}`);
+            return {
+                type: 'bigbed',
+                url,
+                ...auth,
+            };
+        }
+        // BigWig / other binary formats (quantitative data)
         if (format && (format === 'bigwig' || format === 'bw' || isBinaryFormat(format))) {
             log.warn(`Unknown data source type "${type}", inferred "bigwig" from URL: ${url}`);
             return {
@@ -23534,6 +23549,106 @@
         }
     }
 
+    /**
+     * BigBed data source — fetches BED features from BigBed binary files.
+     *
+     * Uses @gmod/bbi's BigBed class for binary parsing and range queries.
+     * Returns BedFeature[] suitable for annotation track rendering.
+     *
+     * Mirrors igv.js BWSource behavior for bigbed format:
+     * - Features are decoded from BED rest fields via decodeBed()
+     * - No zoom-level summarization (unlike BigWig)
+     * - Feature density estimation from header dataCount
+     *
+     * Layer 1 (Data + Layout): no DOM.
+     */
+    // Cache BigBed instances by URL to reuse parsed headers and index trees.
+    const readerCache = new Map();
+    function getReader(url, fetchImpl) {
+        const resolvedUrl = normalizeGoogleURL(url);
+        let reader = readerCache.get(resolvedUrl);
+        if (!reader) {
+            const fileOpts = fetchImpl ? { fetch: fetchImpl } : undefined;
+            reader = new BigBed({ filehandle: new RemoteFile(resolvedUrl, fileOpts) });
+            readerCache.set(resolvedUrl, reader);
+        }
+        return reader;
+    }
+    class BigBedDataSource {
+        constructor(url, fetchImpl) {
+            this.url = url;
+            this.fetchImpl = fetchImpl;
+            this.bb = getReader(url, fetchImpl);
+        }
+        /** Set a chromosome name resolver for alias resolution (e.g., "1" → "chr1"). */
+        setChromNameResolver(resolver) {
+            this._resolveChromName = resolver;
+        }
+        async fetch(locus, _bpPerPixel, signal) {
+            var _a;
+            const chr = this._resolveChromName
+                ? this._resolveChromName(locus.chr)
+                : locus.chr;
+            try {
+                const rawFeatures = await this.bb.getFeatures(chr, locus.start, locus.end, { signal });
+                const result = [];
+                for (const f of rawFeatures) {
+                    const parsed = parseBigBedFeature(chr, f.start, f.end, f.rest);
+                    if (parsed)
+                        result.push(parsed);
+                }
+                return result;
+            }
+            catch (err) {
+                // Evict poisoned reader on abort (same pattern as BigWig)
+                if (err instanceof Error && (err.name === 'AbortError' || ((_a = err.message) === null || _a === void 0 ? void 0 : _a.includes('aborted')))) {
+                    readerCache.delete(normalizeGoogleURL(this.url));
+                }
+                throw err;
+            }
+        }
+        /**
+         * Search for a feature by name via BigBed extra index.
+         * Returns matching features, or empty array if not found or not indexed.
+         */
+        async search(name) {
+            const header = await this.bb.getHeader();
+            const results = await this.bb.searchExtraIndex(name);
+            if (results.length === 0)
+                return [];
+            const refsByNumber = header.refsByNumber;
+            const features = [];
+            for (const r of results) {
+                const chromId = r.chromId;
+                if (chromId == null || !(refsByNumber === null || refsByNumber === void 0 ? void 0 : refsByNumber[chromId]))
+                    continue;
+                const chr = refsByNumber[chromId].name;
+                const parsed = parseBigBedFeature(chr, r.start, r.end, r.rest);
+                if (parsed)
+                    features.push(parsed);
+            }
+            return features;
+        }
+        dispose() {
+            readerCache.delete(normalizeGoogleURL(this.url));
+        }
+    }
+    /**
+     * Parse a BigBed feature's rest field into a BedFeature.
+     * Reconstructs BED tokens from chr/start/end + tab-delimited rest, then uses decodeBed().
+     */
+    function parseBigBedFeature(chr, start, end, rest) {
+        const tokens = [chr, String(start), String(end)];
+        if (rest) {
+            tokens.push(...rest.split('\t'));
+        }
+        return decodeBed(tokens);
+    }
+    /** Clear the BigBed reader cache (useful for testing or memory management). */
+    function clearBigBedCache() {
+        readerCache.clear();
+    }
+
     /**
      * DataSource backed by an in-memory feature array.
      *
@@ -26678,6 +26793,8 @@
         switch (config.type) {
             case 'bigwig':
                 return new BigWigDataSource(config.url, config.windowFunction);
+            case 'bigbed':
+                return new BigBedDataSource(config.url);
             case 'gtx':
                 return new GtxDataSource(config.url, config.experimentId, config.windowFunction);
             case 'ucsc':
@@ -26959,6 +27076,11 @@
     registerTypeAlias('genepred', 'annotation');
     registerTypeAlias('genepredext', 'annotation');
     registerTypeAlias('refflat', 'annotation');
+    // BigBed format → annotation track type aliases
+    registerTypeAlias('bigbed', 'annotation');
+    registerTypeAlias('bedtype', 'annotation');
+    registerTypeAlias('biggenepred', 'annotation');
+    registerTypeAlias('bignarrowpeak', 'annotation');
     // Merged/overlay aliases
     registerTypeAlias('overlay', 'merged');
     // Interaction format aliases
@@ -27049,6 +27171,10 @@
         'gtf': 'annotation',
         'narrowpeak': 'annotation',
         'broadpeak': 'annotation',
+        'bigbed': 'annotation',
+        'biggenepred': 'annotation',
+        'bignarrowpeak': 'annotation',
+        'biginteract': 'interact',
         'sequence': 'sequence',
         'interact': 'interact',
         'bedpe': 'interact',
@@ -27166,23 +27292,35 @@
         return result;
     }
     function convertIgvAnnotationTrack(igvTrack) {
+        var _a, _b;
         const result = { type: 'annotation' };
         if (igvTrack.name)
             result.name = igvTrack.name;
         if (igvTrack.order != null)
             result.order = igvTrack.order;
-        // Data source — gene tracks in igv.js can come from URLs (text files) or UCSC
+        // Data source — gene tracks in igv.js can come from BigBed, text files, or UCSC
         if (igvTrack.url) {
-            const ds = {
-                type: 'text',
-                url: igvTrack.url,
-                ...extractAuthFromIgv(igvTrack),
-            };
-            if (igvTrack.indexURL)
-                ds.indexURL = igvTrack.indexURL;
-            if (igvTrack.format)
-                ds.format = igvTrack.format;
-            result.dataSource = ds;
+            const format = (_b = (_a = igvTrack.format) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
+            if (isBigBedFormat(format) || /\.bb$/i.test(igvTrack.url) || /\.bigbed$/i.test(igvTrack.url)) {
+                const ds = {
+                    type: 'bigbed',
+                    url: igvTrack.url,
+                    ...extractAuthFromIgv(igvTrack),
+                };
+                result.dataSource = ds;
+            }
+            else {
+                const ds = {
+                    type: 'text',
+                    url: igvTrack.url,
+                    ...extractAuthFromIgv(igvTrack),
+                };
+                if (igvTrack.indexURL)
+                    ds.indexURL = igvTrack.indexURL;
+                if (igvTrack.format)
+                    ds.format = igvTrack.format;
+                result.dataSource = ds;
+            }
         }
         // Config overrides
         const config = {};
@@ -27278,13 +27416,23 @@
         return igv;
     }
     function convertToIgvAnnotationTrack(track) {
-        var _a;
+        var _a, _b;
         const igv = { type: 'annotation' };
         if (track.name)
             igv.name = track.name;
         if (track.order != null)
             igv.order = track.order;
         if (((_a = track.dataSource) === null || _a === void 0 ? void 0 : _a.type) === 'text') {
+            igv.url = track.dataSource.url;
+            if (track.dataSource.format)
+                igv.format = track.dataSource.format;
+            if (track.dataSource.indexURL)
+                igv.indexURL = track.dataSource.indexURL;
+            Object.assign(igv, extractAuthForIgv(track.dataSource));
+        }
+        else if (((_b = track.dataSource) === null || _b === void 0 ? void 0 : _b.type) === 'bigbed') {
+            igv.url = track.dataSource.url;
+            igv.format = 'bigbed';
             Object.assign(igv, extractAuthForIgv(track.dataSource));
         }
         if (track.config) {
@@ -28833,6 +28981,9 @@
             if (ds instanceof BigWigDataSource || ds instanceof GtxDataSource) {
                 ds.setChromNameResolver(alias => ctx.genome.getChromosomeName(alias));
             }
+            else if (ds instanceof BigBedDataSource) {
+                ds.setChromNameResolver(alias => ctx.genome.getChromosomeName(alias));
+            }
             else if (ds instanceof TextFeatureSource) {
                 ds.setChromNameResolver(alias => ctx.genome.getChromosomeName(alias));
                 if (ctx.cumulativeOffsets) {
@@ -29020,6 +29171,30 @@
             searchableFields: options === null || options === void 0 ? void 0 : options.searchableFields,
         };
     }
+    function createBigBedTrack(ctx, url, options) {
+        var _a;
+        const { canvas } = ctx.canvasProvider.createCanvas(0, 0);
+        const track = new AnnotationTrackCanvas(canvas, {
+            locus: ctx.locus,
+            features: [],
+            config: options === null || options === void 0 ? void 0 : options.config,
+            theme: ctx.theme,
+            canvasProvider: ctx.canvasProvider,
+            name: options === null || options === void 0 ? void 0 : options.name,
+        });
+        const dataSourceConfig = { type: 'bigbed', url, ...options === null || options === void 0 ? void 0 : options.auth };
+        const fetchImpl = resolveTrackFetchImpl(ctx, options);
+        const { dataSource } = getOrCreateDataSource(dataSourceConfig, () => new BigBedDataSource(url, fetchImpl), ctx);
+        return {
+            track,
+            dataSource,
+            dataSourceConfig,
+            maxTrackHeight: options === null || options === void 0 ? void 0 : options.maxTrackHeight,
+            metadata: options === null || options === void 0 ? void 0 : options.metadata,
+            searchable: (_a = options === null || options === void 0 ? void 0 : options.searchable) !== null && _a !== void 0 ? _a : true,
+            searchableFields: options === null || options === void 0 ? void 0 : options.searchableFields,
+        };
+    }
     function createInteractionTrack(ctx, url, options) {
         var _a;
         const { canvas } = ctx.canvasProvider.createCanvas(0, 0);
@@ -29369,10 +29544,10 @@
         }
         // ─── Track lifecycle ─────────────────────────────────────────────────────
         /** Add a track with an optional data source for automatic data management. */
-        addTrack(track, dataSource, dataSourceConfig, maxTrackHeight, order) {
+        addTrack(track, dataSource, dataSourceConfig, maxTrackHeight, order, id) {
             var _a;
             this._snapshotForUndo('track-add');
-            const id = generateTrackId(track.type);
+            id !== null && id !== void 0 ? id : (id = generateTrackId(track.type));
             const mt = {
                 id,
                 track,
@@ -30251,11 +30426,9 @@
                     if (!this.dataSourceWorkerProvider && dataSource) {
                         wireDataSource(dataSource, ctx);
                     }
-                    this.addTrack(created.track, dataSource !== null && dataSource !== void 0 ? dataSource : undefined, (_a = created.dataSourceConfig) !== null && _a !== void 0 ? _a : undefined, undefined, (_b = created.order) !== null && _b !== void 0 ? _b : undefined);
+                    this.addTrack(created.track, dataSource !== null && dataSource !== void 0 ? dataSource : undefined, (_a = created.dataSourceConfig) !== null && _a !== void 0 ? _a : undefined, undefined, (_b = created.order) !== null && _b !== void 0 ? _b : undefined, trackConfig.id);
                     // Restore bookkeeping fields for round-trip serialization
                     const mt = this.findMT(created.track);
-                    if (trackConfig.id)
-                        mt.id = trackConfig.id;
                     if (created.name)
                         mt.name = created.name;
                     if (trackConfig.metadata)
@@ -30341,10 +30514,8 @@
                     wireDataSource(dataSource, ctx);
                 }
             }
-            this.addTrack(created.track, dataSource !== null && dataSource !== void 0 ? dataSource : undefined, dataSourceConfig !== null && dataSourceConfig !== void 0 ? dataSourceConfig : undefined, undefined, (_a = created.order) !== null && _a !== void 0 ? _a : undefined);
+            this.addTrack(created.track, dataSource !== null && dataSource !== void 0 ? dataSource : undefined, dataSourceConfig !== null && dataSourceConfig !== void 0 ? dataSourceConfig : undefined, undefined, (_a = created.order) !== null && _a !== void 0 ? _a : undefined, trackConfig.id);
             const mt = this.findMT(created.track);
-            if (trackConfig.id)
-                mt.id = trackConfig.id;
             if (created.name)
                 mt.name = created.name;
             if (trackConfig.metadata)
@@ -30403,6 +30574,10 @@
         addBedTrack(url, options) {
             return this.registerFactory(createBedTrack(this.factoryContext(), url, options));
         }
+        /** Add a BigBed annotation track from a URL. */
+        addBigBedTrack(url, options) {
+            return this.registerFactory(createBigBedTrack(this.factoryContext(), url, options));
+        }
         /** Add an interaction (arc/BEDPE) track from a URL. */
         addInteractionTrack(url, options) {
             return this.registerFactory(createInteractionTrack(this.factoryContext(), url, options));
@@ -35882,8 +36057,12 @@ tr.border-top td {
             const windowFunction = (_d = config.windowFunction) !== null && _d !== void 0 ? _d : 'mean';
             dataSource = new GtxDataSource(config.url, (_e = config.experimentId) !== null && _e !== void 0 ? _e : '', windowFunction);
         }
+        else if (isBigBedFormat(format)) {
+            // BigBed → BigBedDataSource (annotation features)
+            dataSource = new BigBedDataSource(config.url);
+        }
         else if (isBinaryFormat(format)) {
-            // BigWig/BigBed → BigWigDataSource
+            // BigWig → BigWigDataSource (quantitative features)
             const windowFunction = (_f = config.windowFunction) !== null && _f !== void 0 ? _f : 'mean';
             dataSource = new BigWigDataSource(config.url, windowFunction);
         }
@@ -35906,6 +36085,7 @@ tr.border-top td {
     exports.BaseCompositeTrack = BaseCompositeTrack;
     exports.BaseTrackCanvas = BaseTrackCanvas;
     exports.BigBedAnnotationSource = BigBedAnnotationSource;
+    exports.BigBedDataSource = BigBedDataSource;
     exports.BigWigDataSource = BigWigDataSource;
     exports.BigWigReader = BigWigReader;
     exports.BrowserEvent = BrowserEvent;