loom-browser 0.0.9 → 0.0.10

package/dist/types/tracks/ruler/config.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Ruler track render configuration.
+ *
+ * Controls rendering of the coordinate ruler track.
+ *
+ * Layer 2 (Track Canvases): no DOM.
+ */
+/** Configuration for ruler track rendering. */
+export interface RulerRenderConfig {
+    /** Total height in CSS pixels. Default: 40. */
+    height: number;
+    /** Font for tick labels. Default: 'bold 10px sans-serif'. */
+    font: string;
+    /** Tick line color. Default: 'rgb(150, 150, 150)'. */
+    tickColor: string;
+    /** Label text color. Default: 'rgb(0, 0, 0)'. */
+    labelColor: string;
+    /** Baseline (bottom rule) color. Default: 'rgb(150, 150, 150)'. */
+    baselineColor: string;
+    /** Background color. Default: 'white'. */
+    background: string;
+}
+/** Returns sensible defaults for ruler rendering. */
+export declare function defaultRulerRenderConfig(): RulerRenderConfig;

package/dist/types/tracks/sequence/config.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Sequence track render configuration.
+ *
+ * Controls rendering of DNA sequence tracks with optional 3-frame translation.
+ *
+ * Layer 2 (Track Canvases): no DOM.
+ */
+/** Sequence type for the sequence track. */
+export type SequenceType = 'dna' | 'rna' | 'prot';
+/** Configuration controlling how sequence features are rendered. */
+export interface SequenceRenderConfig {
+    /** Sequence type (affects coloring). Default: 'dna'. */
+    sequenceType: SequenceType;
+    /** Show reverse complement. Default: false. */
+    reversed: boolean;
+    /** Show three-frame amino acid translation. Default: false. */
+    frameTranslate: boolean;
+    /** Override color for all bases. When set, ignores nucleotide color map. */
+    color?: string;
+    /** Background color. Default: '#ffffff'. */
+    background: string;
+    /** Nucleotide color mapping (A, C, G, T, N). Used when sequenceType is 'dna'. */
+    nucleotideColors: Record<string, string>;
+    /** Default color for RNA/protein bases. Default: 'rgb(0, 0, 150)'. */
+    nonDnaColor: string;
+    /** Track height without translation frames. Default: 25. */
+    defaultHeight: number;
+    /** Track height with translation frames. Default: 115. */
+    translatedHeight: number;
+    /** Height of the sequence row. Default: 15. */
+    sequenceHeight: number;
+    /** Height of each translation frame row. Default: 25. */
+    frameHeight: number;
+    /** Border/padding between elements. Default: 5. */
+    frameBorder: number;
+    /** Alternating background color 1 for translation frames. Default: 'rgb(160,160,160)'. */
+    frameColor1: string;
+    /** Alternating background color 2 for translation frames. Default: 'rgb(224,224,224)'. */
+    frameColor2: string;
+    /** Stop codon highlight color. Default: 'rgb(255, 0, 0)'. */
+    stopCodonColor: string;
+    /** Start codon (M) highlight color. Default: 'rgb(0, 153, 0)'. */
+    startCodonColor: string;
+    /** Use fillText instead of strokeText for base and amino acid labels. Default: false (strokeText, matching igv.js). */
+    useFillText: boolean;
+    /** Color for amino acid labels in translation frames. Default: '#000000'. */
+    frameLabelColor: string;
+    /** Color for amino acid labels on start/stop codon backgrounds. Default: same as frameLabelColor. */
+    codonLabelColor?: string;
+    /** Font for amino acid labels in translation frames. Default: 'bold 10px sans-serif'. */
+    frameFont: string;
+    /** Border radius for start/stop codon highlights (roundRect). 0 = sharp rectangles. Default: 0. */
+    codonBorderRadius: number;
+}
+/** Returns sensible defaults for sequence rendering. */
+export declare function defaultSequenceRenderConfig(): SequenceRenderConfig;

package/dist/types/tracks/sequence/sequenceTrackCanvas.d.ts

@@ -28,11 +28,14 @@ export interface SequenceTrackCanvasOptions {
     config?: Partial<SequenceRenderConfig>;
     theme?: Partial<RenderTheme>;
     canvasProvider?: CanvasProvider;
+    /** bpPerPixel threshold above which sequence data is not loaded. Default: 10. */
+    bppSequenceThreshold?: number;
 }
 export declare class SequenceTrackCanvas extends BaseTrackCanvas<SequenceRenderConfig> {
     readonly type = "sequence";
     private _sequence;
     private _theme;
+    private _bppThreshold;
     constructor(canvas: HTMLCanvasElement, options: SequenceTrackCanvasOptions);
     /**
      * Whether the current viewport is zoomed in enough to fetch/render sequence.

package/dist/types/tracks/wig/config.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Wig track render configuration.
+ *
+ * Controls rendering of quantitative signal tracks (BigWig, GTX).
+ *
+ * Layer 2 (Track Canvases): no DOM.
+ */
+import type { WindowFunction } from '../../types';
+/** Graph type for wig track rendering. */
+export type WigGraphType = 'bar' | 'line' | 'points' | 'dynseq';
+/** A horizontal guide line drawn at a specific data value. */
+export interface WigGuideLine {
+    /** The data value at which to draw the line. */
+    y: number;
+    /** Line color. */
+    color: string;
+    /** Whether to draw a dashed line. */
+    dotted: boolean;
+}
+/** Color value for wig features: a static CSS color string or a function mapping value → color. */
+export type WigColorValue = string | ((value: number) => string);
+/** Configuration controlling how wig features are rendered. */
+export interface WigRenderConfig {
+    /** Track height in CSS pixels. Default: 50. */
+    height: number;
+    /** Graph rendering style. Default: 'bar'. */
+    graphType: WigGraphType;
+    /** Data aggregation when zoomed out. Default: 'mean'. */
+    windowFunction: WindowFunction;
+    /** Y-axis data range. Features are scaled to this range. */
+    dataRange: {
+        min: number;
+        max: number;
+    };
+    /** Whether to auto-compute dataRange from features. Default: true. */
+    autoscale: boolean;
+    /** Fill/stroke color for positive values. String or (value) => color function. Default: 'rgb(150, 150, 150)'. */
+    color: WigColorValue;
+    /** Fill/stroke color for negative values. String or (value) => color function. Uses `color` when undefined. */
+    altColor?: WigColorValue;
+    /** Alpha transparency for feature colors (0–1). Applied on top of resolved color. Default: undefined (fully opaque). */
+    alpha?: number;
+    /** Flip the y-axis (values grow downward). Default: false. */
+    flipAxis: boolean;
+    /** Use logarithmic scale for the y-axis. Default: false. */
+    logScale: boolean;
+    /** Color for the zero-line baseline. Default: 'lightGray'. */
+    baselineColor: string;
+    /** Color for out-of-range value indicators. Default: 'rgb(255, 32, 255)'. */
+    overflowColor: string;
+    /** Point diameter in pixels (for 'points' graphType). Default: 3. */
+    pointSize: number;
+    /** Background color. Default: '#ffffff'. */
+    background: string;
+    /** Optional horizontal guide lines. */
+    guideLines?: WigGuideLine[];
+    /** Nucleotide colors for dynseq rendering. Keys: A, C, G, T, N. */
+    nucleotideColors?: Record<string, string>;
+    /** Multiply all feature values by this factor before rendering. Default: undefined (no scaling). */
+    scaleFactor?: number;
+    /**
+     * Normalization factor applied to all feature values (e.g. reads-per-million from TDF).
+     * When set, all values are multiplied by this factor before scaleFactor is applied.
+     * Typically provided by the data source rather than set manually.
+     */
+    normalizationFactor?: number;
+    /** Whether to draw min/max data range labels on the track. Default: true. */
+    showDataRange: boolean;
+    /** Color for data range label text. Default: palette.foreground. */
+    labelColor: string;
+    /** Font for data range labels. Default: 'bold 9px sans-serif'. */
+    labelFont: string;
+    /** Track name to display as an overlay label (igv.js style, top-left). */
+    trackName?: string;
+}
+/** Returns sensible defaults for wig rendering. */
+export declare function defaultWigRenderConfig(): WigRenderConfig;

package/dist/types/types/igvCompat.d.ts

@@ -0,0 +1,36 @@
+/**
+ * IGV.js compatibility types.
+ *
+ * Minimal type definitions for igv.js session import/export.
+ * Used only by session serialization — not part of the core Loom type system.
+ */
+/** Minimal igv.js session shape — just enough to parse/produce sessions. */
+export interface IgvSessionObject {
+    version?: string;
+    reference?: IgvReferenceConfig;
+    genome?: string;
+    locus?: string | string[];
+    tracks?: IgvTrackConfig[];
+}
+export interface IgvReferenceConfig {
+    id?: string;
+    fastaURL?: string;
+    indexURL?: string;
+}
+export interface IgvTrackConfig {
+    type?: string;
+    format?: string;
+    url?: string;
+    indexURL?: string;
+    name?: string;
+    color?: string;
+    altColor?: string;
+    height?: number;
+    min?: number;
+    max?: number;
+    autoscale?: boolean;
+    displayMode?: string;
+    order?: number;
+    visibilityWindow?: number;
+    windowFunction?: string;
+}

package/dist/types/types.d.ts

@@ -1,4 +1,15 @@
 import type { ChromSizes, CumulativeOffsets } from './genome/chromSizes';
+export type { DisplayMode, AnnotationRenderConfig } from './tracks/annotation/config';
+export { defaultAnnotationRenderConfig } from './tracks/annotation/config';
+export type { RulerRenderConfig } from './tracks/ruler/config';
+export { defaultRulerRenderConfig } from './tracks/ruler/config';
+export type { WigGraphType, WigGuideLine, WigColorValue, WigRenderConfig } from './tracks/wig/config';
+export { defaultWigRenderConfig } from './tracks/wig/config';
+export type { SequenceType, SequenceRenderConfig } from './tracks/sequence/config';
+export { defaultSequenceRenderConfig } from './tracks/sequence/config';
+export type { ArcOrientation, ArcDisplayMode, InteractionRenderConfig } from './tracks/interaction/config';
+export { defaultInteractionRenderConfig } from './tracks/interaction/config';
+export type { DataSourceConfig, BigWigDataSourceConfig, GtxDataSourceConfig, UCSCDataSourceConfig, TextDataSourceConfig, MemoryDataSourceConfig, } from './dataSources/config';
 /** Genomic locus — a chromosome region. */
 export interface Locus {
     chr: string;
@@ -78,6 +89,16 @@ export interface Track {
     setError(error: Error | null): void;
     /** Apply a new render theme and re-render. Replaces all theme-derived config values. */
     setTheme(theme: import('./themes/renderTheme').RenderTheme): void;
+    /**
+     * Callback invoked just before config changes (e.g. setConfig()).
+     * The browser registers this to snapshot state for undo (capturing pre-mutation state).
+     */
+    onBeforeConfigChange?: (() => void) | undefined;
+    /**
+     * Callback invoked after config changes (e.g. setConfig()).
+     * The browser registers this to emit TrackConfigChanged.
+     */
+    onConfigChanged?: (() => void) | undefined;
     /**
      * Hit-test at canvas-relative pixel coordinates.
      * Returns features at that point with pre-formatted popup data.
@@ -127,6 +148,12 @@ export interface Track {
     renderToContext?(ctx: CanvasRenderingContext2D, width: number, height: number): void;
     visibilityWindow?: number;
 }
+/** Track that supports zoom-level awareness (shows "zoom in" notice when zoomed out). */
+export interface ZoomAwareTrack extends Track {
+    setZoomedOut(zoomed: boolean): void;
+}
+/** Type guard for tracks that implement setZoomedOut(). */
+export declare function isZoomAware(track: Track): track is ZoomAwareTrack;
 /** A single exon within a gene feature. */
 export interface Exon {
     start: number;
@@ -169,58 +196,6 @@ export interface AnnotationFeature {
     /** Assigned by pack() — the row this feature is placed in. */
     row?: number;
 }
-/** Display mode for gene features. */
-export type DisplayMode = 'COLLAPSED' | 'SQUISHED' | 'EXPANDED';
-/** Configuration controlling how annotation features (gene, BED, GFF, peaks) are rendered. */
-export interface AnnotationRenderConfig {
-    displayMode: DisplayMode;
-    featureHeight: number;
-    margin: number;
-    /** Row height in EXPANDED mode (featureHeight + label space + padding). */
-    expandedRowHeight: number;
-    /** Row height in SQUISHED mode. */
-    squishedRowHeight: number;
-    /** Pixel spacing between strand-direction arrows. */
-    arrowSpacing: number;
-    /** Default fill color for CDS exons. */
-    color: string;
-    /** Color for features on the opposite strand (if desired). */
-    altColor?: string;
-    /** Which feature property to use as the label. */
-    labelField: string;
-    /** CSS font string for labels, e.g. "10px sans-serif". */
-    font: string;
-    /** Whether to draw labels. */
-    drawLabels: boolean;
-    /** Label display mode — "SLANT" rotates labels 45°. */
-    labelDisplayMode?: 'SLANT';
-    /** UTR fill color. Defaults to main color. */
-    utrColor?: string;
-    /** Alt UTR color (for - strand when altColor is set). */
-    altUtrColor?: string;
-    /** Exon stroke outline color. No outline when undefined. */
-    borderColor?: string;
-    /** Exon outline width. Default: 0 (no outline). */
-    borderWidth?: number;
-    /** Rounded corner radius for exon rects. Default: 0 (square). */
-    borderRadius?: number;
-    /** Intron line color. Defaults to main color. */
-    intronColor?: string;
-    /** Intron line width. Default: 1. */
-    intronLineWidth?: number;
-    /** Dash pattern for intron lines, e.g. [3, 3]. Default: [] (solid). */
-    intronDash?: number[];
-    /** Strand arrow color on intron lines. Defaults to current stroke color. */
-    arrowColor?: string;
-    /** Strand arrow color inside exons. Default: 'white'. */
-    arrowInExonColor?: string;
-    /** Label text color. Defaults to feature color. */
-    labelColor?: string;
-    /** Background color behind labels. When set, fills behind labels instead of clearing to transparent. */
-    labelBackground?: string;
-    /** Separate CSS font string for labels. Defaults to `font`. */
-    labelFont?: string;
-}
 /** Rendering context — describes the viewport being drawn into. */
 export interface RenderContext {
     /** Total pixel width of the canvas. */
@@ -232,23 +207,6 @@ export interface RenderContext {
     /** Visible viewport width (may be less than pixelWidth for overscanning). */
     viewportWidth: number;
 }
-/** Returns sensible defaults for annotation feature rendering. */
-export declare function defaultAnnotationRenderConfig(): AnnotationRenderConfig;
-/** Configuration for ruler track rendering. */
-export interface RulerRenderConfig {
-    /** Total height in CSS pixels. Default: 40. */
-    height: number;
-    /** Font for tick labels. Default: 'bold 10px sans-serif'. */
-    font: string;
-    /** Tick line color. Default: 'rgb(150, 150, 150)'. */
-    tickColor: string;
-    /** Label text color. Default: 'rgb(0, 0, 0)'. */
-    labelColor: string;
-    /** Baseline (bottom rule) color. Default: 'rgb(150, 150, 150)'. */
-    baselineColor: string;
-    /** Background color. Default: 'white'. */
-    background: string;
-}
 /** A single wig data point: a chromosome region with a numeric value. */
 export interface WigFeature {
     chr: string;
@@ -260,8 +218,6 @@ export interface WigFeature {
     /** DNA sequence for this region (populated for dynseq rendering). */
     sequence?: string;
 }
-/** Graph type for wig track rendering. */
-export type WigGraphType = 'bar' | 'line' | 'points' | 'dynseq';
 /** A function that fetches DNA sequence for a genomic region. */
 export type SequenceProvider = (locus: Locus, signal?: AbortSignal) => Promise<string>;
 /**
@@ -348,122 +304,6 @@ export interface GenomeConfig {
 }
 /** Aggregation function for resolution-aware data summarization. */
 export type WindowFunction = 'mean' | 'min' | 'max' | 'none';
-/** A horizontal guide line drawn at a specific data value. */
-export interface WigGuideLine {
-    /** The data value at which to draw the line. */
-    y: number;
-    /** Line color. */
-    color: string;
-    /** Whether to draw a dashed line. */
-    dotted: boolean;
-}
-/** Color value for wig features: a static CSS color string or a function mapping value → color. */
-export type WigColorValue = string | ((value: number) => string);
-/** Configuration controlling how wig features are rendered. */
-export interface WigRenderConfig {
-    /** Track height in CSS pixels. Default: 50. */
-    height: number;
-    /** Graph rendering style. Default: 'bar'. */
-    graphType: WigGraphType;
-    /** Data aggregation when zoomed out. Default: 'mean'. */
-    windowFunction: WindowFunction;
-    /** Y-axis data range. Features are scaled to this range. */
-    dataRange: {
-        min: number;
-        max: number;
-    };
-    /** Whether to auto-compute dataRange from features. Default: true. */
-    autoscale: boolean;
-    /** Fill/stroke color for positive values. String or (value) => color function. Default: 'rgb(150, 150, 150)'. */
-    color: WigColorValue;
-    /** Fill/stroke color for negative values. String or (value) => color function. Uses `color` when undefined. */
-    altColor?: WigColorValue;
-    /** Alpha transparency for feature colors (0–1). Applied on top of resolved color. Default: undefined (fully opaque). */
-    alpha?: number;
-    /** Flip the y-axis (values grow downward). Default: false. */
-    flipAxis: boolean;
-    /** Use logarithmic scale for the y-axis. Default: false. */
-    logScale: boolean;
-    /** Color for the zero-line baseline. Default: 'lightGray'. */
-    baselineColor: string;
-    /** Color for out-of-range value indicators. Default: 'rgb(255, 32, 255)'. */
-    overflowColor: string;
-    /** Point diameter in pixels (for 'points' graphType). Default: 3. */
-    pointSize: number;
-    /** Background color. Default: '#ffffff'. */
-    background: string;
-    /** Optional horizontal guide lines. */
-    guideLines?: WigGuideLine[];
-    /** Nucleotide colors for dynseq rendering. Keys: A, C, G, T, N. */
-    nucleotideColors?: Record<string, string>;
-    /** Multiply all feature values by this factor before rendering. Default: undefined (no scaling). */
-    scaleFactor?: number;
-    /**
-     * Normalization factor applied to all feature values (e.g. reads-per-million from TDF).
-     * When set, all values are multiplied by this factor before scaleFactor is applied.
-     * Typically provided by the data source rather than set manually.
-     */
-    normalizationFactor?: number;
-    /** Whether to draw min/max data range labels on the track. Default: true. */
-    showDataRange: boolean;
-    /** Color for data range label text. Default: palette.foreground. */
-    labelColor: string;
-    /** Font for data range labels. Default: 'bold 9px sans-serif'. */
-    labelFont: string;
-    /** Track name to display as an overlay label (igv.js style, top-left). */
-    trackName?: string;
-}
-/** Sequence type for the sequence track. */
-export type SequenceType = 'dna' | 'rna' | 'prot';
-/** Configuration controlling how sequence features are rendered. */
-export interface SequenceRenderConfig {
-    /** Sequence type (affects coloring). Default: 'dna'. */
-    sequenceType: SequenceType;
-    /** Show reverse complement. Default: false. */
-    reversed: boolean;
-    /** Show three-frame amino acid translation. Default: false. */
-    frameTranslate: boolean;
-    /** Override color for all bases. When set, ignores nucleotide color map. */
-    color?: string;
-    /** Background color. Default: '#ffffff'. */
-    background: string;
-    /** Nucleotide color mapping (A, C, G, T, N). Used when sequenceType is 'dna'. */
-    nucleotideColors: Record<string, string>;
-    /** Default color for RNA/protein bases. Default: 'rgb(0, 0, 150)'. */
-    nonDnaColor: string;
-    /** Track height without translation frames. Default: 25. */
-    defaultHeight: number;
-    /** Track height with translation frames. Default: 115. */
-    translatedHeight: number;
-    /** Height of the sequence row. Default: 15. */
-    sequenceHeight: number;
-    /** Height of each translation frame row. Default: 25. */
-    frameHeight: number;
-    /** Border/padding between elements. Default: 5. */
-    frameBorder: number;
-    /** Alternating background color 1 for translation frames. Default: 'rgb(160,160,160)'. */
-    frameColor1: string;
-    /** Alternating background color 2 for translation frames. Default: 'rgb(224,224,224)'. */
-    frameColor2: string;
-    /** Stop codon highlight color. Default: 'rgb(255, 0, 0)'. */
-    stopCodonColor: string;
-    /** Start codon (M) highlight color. Default: 'rgb(0, 153, 0)'. */
-    startCodonColor: string;
-    /** Use fillText instead of strokeText for base and amino acid labels. Default: false (strokeText, matching igv.js). */
-    useFillText: boolean;
-    /** Color for amino acid labels in translation frames. Default: '#000000'. */
-    frameLabelColor: string;
-    /** Color for amino acid labels on start/stop codon backgrounds. Default: same as frameLabelColor. */
-    codonLabelColor?: string;
-    /** Font for amino acid labels in translation frames. Default: 'bold 10px sans-serif'. */
-    frameFont: string;
-    /** Border radius for start/stop codon highlights (roundRect). 0 = sharp rectangles. Default: 0. */
-    codonBorderRadius: number;
-}
-/** Returns sensible defaults for sequence rendering. */
-export declare function defaultSequenceRenderConfig(): SequenceRenderConfig;
-/** Returns sensible defaults for wig rendering. */
-export declare function defaultWigRenderConfig(): WigRenderConfig;
 /** An interaction feature representing a pairwise genomic contact (Hi-C, ChIA-PET, etc.). */
 export interface InteractionFeature {
     /** Bounding chromosome (same as chr1 for intra-chr; set per-copy for inter-chr). */
@@ -496,39 +336,6 @@ export interface InteractionFeature {
     /** True if this is a duplicated copy of an inter-chr feature (for the other chromosome). */
     dup?: boolean;
 }
-/** Arc orientation: arcs open upward or downward. */
-export type ArcOrientation = 'UP' | 'DOWN';
-/** Display mode for interaction arcs. */
-export type ArcDisplayMode = 'nested' | 'proportional';
-/** Configuration controlling how interaction features are rendered as arcs. */
-export interface InteractionRenderConfig {
-    /** Track height in CSS pixels. Default: 250. */
-    height: number;
-    /** Arc direction. Default: 'UP'. */
-    arcOrientation: ArcOrientation;
-    /** Display mode. Default: 'nested'. */
-    displayMode: ArcDisplayMode;
-    /** Show small rectangles at feature endpoints. Default: true. */
-    showBlocks: boolean;
-    /** Height of endpoint rectangles in pixels. Default: 3. */
-    blockHeight: number;
-    /** Arc stroke width in pixels. Default: 1. */
-    thickness: number;
-    /** Default arc color. Default: 'rgb(180,25,137)'. */
-    color: string;
-    /** Fill alpha for arcs. Default: 0.02. */
-    alpha: number;
-    /** Use log scale for proportional arc heights. Default: true. */
-    logScale: boolean;
-    /** Background color. Default: '#ffffff'. */
-    background: string;
-    /** Font for inter-chromosome labels. Default: '8px sans-serif'. */
-    font: string;
-    /** Whether to use score-based shading. Default: false. */
-    useScore: boolean;
-}
-/** Returns sensible defaults for interaction rendering. */
-export declare function defaultInteractionRenderConfig(): InteractionRenderConfig;
 /** A single item in a feature popup (key-value pair). */
 export interface PopupDataItem {
     name: string;
@@ -652,7 +459,22 @@ export interface DataSource<F = unknown> {
      * @param signal - AbortSignal for cancellation of stale requests
      */
     fetch(locus: Locus, bpPerPixel: number, signal: AbortSignal): Promise<F[]>;
+    /** Optional cleanup — release file handles, caches, or other resources. */
+    dispose?(): void;
 }
+/**
+ * Optional configuration methods that DataSource implementations may support.
+ *
+ * Used by `configureDataSource()` to safely dispatch setter calls by name.
+ * Implementations should declare `implements ConfigurableDataSource` to opt in.
+ */
+export interface ConfigurableDataSource {
+    setCumulativeOffsets?(offsets: CumulativeOffsets): void;
+    setChromNameResolver?(resolver: (chr: string) => string): void;
+    setWindowFunction?(wf: WindowFunction): void;
+}
+/** Known setter method names on ConfigurableDataSource. */
+export type DataSourceConfigMethod = keyof ConfigurableDataSource;
 /** Cached features for a track, stored and managed by GenomeBrowser. */
 export interface FeatureCacheEntry<F = unknown> {
     locus: Locus;
@@ -663,8 +485,6 @@ export interface FeatureCacheEntry<F = unknown> {
 export interface DataDrivenTrack<F = unknown> extends Track {
     setFeatures(features: F[]): void;
 }
-/** Returns sensible defaults for ruler rendering. */
-export declare function defaultRulerRenderConfig(): RulerRenderConfig;
 /** Base for all track feature summaries. */
 interface FeatureSummaryBase {
     /** Number of features in the current view. */
@@ -695,6 +515,12 @@ export interface InteractionFeatureSummary extends FeatureSummaryBase {
 }
 /** Union of all track feature summaries. */
 export type TrackFeatureSummary = WigFeatureSummary | AnnotationFeatureSummary | InteractionFeatureSummary;
+import type { AnnotationRenderConfig } from './tracks/annotation/config';
+import type { RulerRenderConfig } from './tracks/ruler/config';
+import type { WigRenderConfig } from './tracks/wig/config';
+import type { SequenceRenderConfig } from './tracks/sequence/config';
+import type { InteractionRenderConfig } from './tracks/interaction/config';
+import type { DataSourceConfig } from './dataSources/config';
 /** First-party session config — fully typed, JSON-serializable browser state. */
 export interface SessionConfig {
     version: string;
@@ -753,37 +579,6 @@ export type RulerSessionOverrides = Partial<RulerRenderConfig>;
 export type SequenceSessionOverrides = Partial<SequenceRenderConfig>;
 /** Serializable subset of InteractionRenderConfig (all fields are already serializable). */
 export type InteractionSessionOverrides = Partial<InteractionRenderConfig>;
-/** Discriminated union for data source reconstruction. */
-export type DataSourceConfig = BigWigDataSourceConfig | GtxDataSourceConfig | UCSCDataSourceConfig | TextDataSourceConfig | MemoryDataSourceConfig;
-export interface BigWigDataSourceConfig {
-    type: 'bigwig';
-    url: string;
-    windowFunction?: WindowFunction;
-}
-export interface GtxDataSourceConfig {
-    type: 'gtx';
-    url: string;
-    experimentId: string;
-    windowFunction?: WindowFunction;
-}
-export interface UCSCDataSourceConfig {
-    type: 'ucsc';
-    genome?: string;
-    track?: string;
-}
-export interface TextDataSourceConfig {
-    type: 'text';
-    url: string;
-    /** Explicit format override. When absent, inferred from URL. */
-    format?: TextFileFormat;
-    /** Index URL override. Defaults to url + '.tbi'. */
-    indexURL?: string;
-    /** Whether the file is indexed (tabix). When absent, auto-detected from indexURL presence. */
-    indexed?: boolean;
-}
-export interface MemoryDataSourceConfig {
-    type: 'memory';
-}
 /** Strand value for genomic features. */
 export type Strand = '+' | '-' | '.';
 /** Known text genomic file formats supported by the format detection system. */
@@ -875,34 +670,3 @@ export interface GFFFeature {
 }
 /** Union of all feature types produced by text format decoders. */
 export type TextFeature = BedFeature | PeakFeature | BedGraphFeature | GFFFeature;
-/** Minimal igv.js session shape — just enough to parse/produce sessions. */
-export interface IgvSessionObject {
-    version?: string;
-    reference?: IgvReferenceConfig;
-    genome?: string;
-    locus?: string | string[];
-    tracks?: IgvTrackConfig[];
-}
-export interface IgvReferenceConfig {
-    id?: string;
-    fastaURL?: string;
-    indexURL?: string;
-}
-export interface IgvTrackConfig {
-    type?: string;
-    format?: string;
-    url?: string;
-    indexURL?: string;
-    name?: string;
-    color?: string;
-    altColor?: string;
-    height?: number;
-    min?: number;
-    max?: number;
-    autoscale?: boolean;
-    displayMode?: string;
-    order?: number;
-    visibilityWindow?: number;
-    windowFunction?: string;
-}
-export {};

package/dist/types/ui/components/LoomBrowserShell.d.ts

@@ -12,8 +12,8 @@
  * Or use the createShell() helper:
  *   const shell = createShell(container, { locus, theme: 'modern' })
  */
-import { GenomeBrowser } from '../../genomeBrowser';
-import type { GenomeBrowserOptions, BrowserEvents } from '../../genomeBrowser';
+import { GenomeBrowser } from '../../browser/dom/genomeBrowser';
+import type { GenomeBrowserOptions, BrowserEvents } from '../../browser/dom/genomeBrowser';
 import type { Locus, Track } from '../../types';
 import type { ShellTheme } from '../themes';
 export declare class LoomBrowserShell extends HTMLElement {

package/dist/types/ui/components/LoomChromosomeSelect.d.ts

@@ -4,7 +4,7 @@
  * Lists main chromosomes (chr1-22, X, Y, M) plus "All" for whole genome view.
  * Updates automatically when the browser locus changes.
  */
-import type { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomChromosomeSelect extends HTMLElement {
     private select;
     private unsubscribe;

package/dist/types/ui/components/LoomContextMenu.d.ts

@@ -17,6 +17,7 @@ export declare class LoomContextMenu extends HTMLElement {
     private menuDiv;
     constructor();
     connectedCallback(): void;
+    disconnectedCallback(): void;
     /** Populate the menu from typed ContextMenuItem data. */
     setItems(items: ContextMenuItem[]): void;
     private buildItems;

package/dist/types/ui/components/LoomExportControls.d.ts

@@ -4,7 +4,7 @@
  * Adds "Save SVG" and "Save PNG" buttons to the shell navbar.
  * Calls GenomeBrowser.saveSVGtoFile() and savePNGtoFile() respectively.
  */
-import type { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomExportControls extends HTMLElement {
     private _browser;
     constructor();