loom-browser 0.0.7 → 0.0.8

package/dist/types/headlessGenomeBrowser.d.ts

@@ -269,6 +269,8 @@ export declare class HeadlessGenomeBrowser {
     private inflightFetches;
     /** Timer for debouncing data loads during rapid zoom/pan. */
     private loadDebounceTimer;
+    /** Set to true by dispose() to suppress post-dispose promise handlers. */
+    private _disposed;
     /** When true, sortTracks() is a no-op. Used for batch track additions (e.g. loadSession). */
     private _deferSort;
     /** Canvas provider for environment abstraction. Available for convenience API / future use. */
@@ -420,6 +422,8 @@ export declare class HeadlessGenomeBrowser {
     removeROI(roiId: string): boolean;
     /** Update an ROI by ID. Returns the updated ROI, or undefined if not found. */
     updateROI(roiId: string, changes: Partial<Omit<ROI, 'id'>>): ROI | undefined;
+    /** Remove a specific ROI set by instance. Returns true if found and removed. */
+    removeROISet(set: ROISet): boolean;
     /** Remove all ROI sets. */
     clearROIs(): void;
     /** Get all ROIs across all sets (flattened). */

package/dist/types/react/LoomBrowser.d.ts

@@ -81,6 +81,7 @@ export interface LoomBrowserHandle {
     reloadData(): void;
     addROI(roi: ROI, setName?: string): ROI;
     addROISet(config: ROISetConfig): ROISet;
+    removeROISet(set: ROISet): boolean;
     removeROI(roiId: string): boolean;
     updateROI(roiId: string, changes: Partial<Omit<ROI, 'id'>>): ROI | undefined;
     clearROIs(): void;

package/dist/types/react/ROISet.d.ts

@@ -0,0 +1,14 @@
+import type { ROI } from '../types';
+export interface ROISetProps {
+    /** ROI features to display. The set is recreated when this array changes. */
+    rois: ROI[];
+    /** Name for the ROI set. Default: 'Declarative'. */
+    name?: string;
+    /** Default color for ROIs in this set (individual ROI colors take precedence). */
+    color?: string;
+}
+/**
+ * Declarative ROI set component. Renders nothing — manages ROIs on the
+ * GenomeBrowser via context. Add/remove `<ROISet>` children to control ROIs.
+ */
+export declare function DeclarativeROISet({ rois, name, color }: ROISetProps): null;

package/dist/types/react/hooks/index.d.ts

@@ -1,3 +1,4 @@
 export { useGenomeBrowser } from './useGenomeBrowser';
 export { useBrowserEvent } from './useBrowserEvent';
 export { useLocus } from './useLocus';
+export type { TrackClickEvent, TrackEventHandlers } from './useTrackManager';

package/dist/types/react/hooks/useTrackManager.d.ts

@@ -1,5 +1,16 @@
 import type { Track } from '../../types';
 import type { GenomeBrowser } from '../../genomeBrowser';
+/** Per-track click event with typed features. */
+export interface TrackClickEvent<F> {
+    features: F[];
+    genomicLocation: number;
+    x: number;
+    y: number;
+}
+export interface TrackEventHandlers<F> {
+    onClick?: (event: TrackClickEvent<F>) => void;
+    onContextMenu?: (event: TrackClickEvent<F>) => void;
+}
 /**
  * Internal hook that manages track add/remove/update lifecycle.
  *
@@ -7,5 +18,6 @@ import type { GenomeBrowser } from '../../genomeBrowser';
  * @param recreationDeps  When these change, the track is removed and re-added (new data source).
  * @param updateTrack  Called when only updateDeps change (in-place config update).
  * @param updateDeps  When these change (but recreationDeps don't), updateTrack is called.
+ * @param eventHandlers  Optional typed click/context-menu handlers scoped to this track.
  */
-export declare function useTrackManager<T extends Track>(addTrack: (browser: GenomeBrowser) => T, recreationDeps: unknown[], updateTrack?: (track: T, browser: GenomeBrowser) => void, updateDeps?: unknown[]): T | null;
+export declare function useTrackManager<T extends Track, F = unknown>(addTrack: (browser: GenomeBrowser) => T, recreationDeps: unknown[], updateTrack?: (track: T, browser: GenomeBrowser) => void, updateDeps?: unknown[], eventHandlers?: TrackEventHandlers<F>): T | null;

package/dist/types/react/index.d.ts

@@ -1,8 +1,11 @@
 export { LoomBrowser } from './LoomBrowser';
 export type { LoomBrowserProps, LoomBrowserHandle } from './LoomBrowser';
 export { useGenomeBrowser, useBrowserEvent, useLocus } from './hooks';
+export type { TrackClickEvent } from './hooks';
 export { RulerTrack, WigTrack, GeneTrack, BedTrack, SequenceTrack, InteractionTrack, GtxTrack, } from './tracks';
 export type { RulerTrackProps, WigTrackProps, GeneTrackProps, BedTrackProps, SequenceTrackProps, InteractionTrackProps, GtxTrackProps, } from './tracks';
+export { DeclarativeROISet as ROISet } from './ROISet';
+export type { ROISetProps } from './ROISet';
 export { ChromosomeSelect, LocusInput, ZoomControls, WindowSize, ExportControls, Navbar, } from './ui';
 export type { ChromosomeSelectProps, LocusInputProps, ZoomControlsProps, WindowSizeProps, ExportControlsProps, NavbarProps, } from './ui';
 export { GenomeBrowserContext } from './GenomeBrowserContext';

package/dist/types/react/tracks/BedTrack.d.ts

@@ -1,11 +1,13 @@
 import type { AnnotationFeature, AnnotationRenderConfig, TextFileFormat } from '../../types';
+import type { TrackClickEvent } from '../hooks/useTrackManager';
+type BedFeature = AnnotationFeature & {
+    chr: string;
+};
 export interface BedTrackProps {
     /** URL to a BED/peak file. Mutually exclusive with `features`. */
     url?: string;
     /** In-memory annotation features. Mutually exclusive with `url`. Features must include `chr`. */
-    features?: (AnnotationFeature & {
-        chr: string;
-    })[];
+    features?: BedFeature[];
     config?: Partial<AnnotationRenderConfig>;
     height?: number;
     background?: string;
@@ -15,5 +17,12 @@ export interface BedTrackProps {
     maxTrackHeight?: number;
     name?: string;
     metadata?: Record<string, string>;
+    /** Compute per-feature color. Applied to in-memory features before rendering. */
+    colorBy?: (feature: BedFeature) => string;
+    /** Called when this track is clicked. Features are typed as BedFeature. */
+    onClick?: (event: TrackClickEvent<BedFeature>) => void;
+    /** Called when this track is right-clicked. */
+    onContextMenu?: (event: TrackClickEvent<BedFeature>) => void;
 }
-export declare function BedTrack({ url, features, config, height, background, format, indexURL, indexed, maxTrackHeight, name, metadata }: BedTrackProps): null;
+export declare function BedTrack({ url, features, config, height, background, format, indexURL, indexed, maxTrackHeight, name, metadata, colorBy, onClick, onContextMenu }: BedTrackProps): null;
+export {};

package/dist/types/react/tracks/GeneTrack.d.ts

@@ -1,4 +1,5 @@
-import type { AnnotationRenderConfig } from '../../types';
+import type { AnnotationFeature, AnnotationRenderConfig } from '../../types';
+import type { TrackClickEvent } from '../hooks/useTrackManager';
 export interface GeneTrackProps {
     config?: Partial<AnnotationRenderConfig>;
     height?: number;
@@ -10,5 +11,9 @@ export interface GeneTrackProps {
     maxTrackHeight?: number;
     name?: string;
     metadata?: Record<string, string>;
+    /** Called when this track is clicked. Features are typed as AnnotationFeature. */
+    onClick?: (event: TrackClickEvent<AnnotationFeature>) => void;
+    /** Called when this track is right-clicked. */
+    onContextMenu?: (event: TrackClickEvent<AnnotationFeature>) => void;
 }
-export declare function GeneTrack({ config, height, background, genome, track, maxTrackHeight, name, metadata }: GeneTrackProps): null;
+export declare function GeneTrack({ config, height, background, genome, track, maxTrackHeight, name, metadata, onClick, onContextMenu }: GeneTrackProps): null;

package/dist/types/react/tracks/GtxTrack.d.ts

@@ -1,4 +1,5 @@
-import type { WigRenderConfig, WindowFunction } from '../../types';
+import type { WigFeature, WigRenderConfig, WindowFunction } from '../../types';
+import type { TrackClickEvent } from '../hooks/useTrackManager';
 export interface GtxTrackProps {
     url: string;
     experimentId: string;
@@ -9,5 +10,9 @@ export interface GtxTrackProps {
     maxTrackHeight?: number;
     name?: string;
     metadata?: Record<string, string>;
+    /** Called when this track is clicked. Features are typed as WigFeature. */
+    onClick?: (event: TrackClickEvent<WigFeature>) => void;
+    /** Called when this track is right-clicked. */
+    onContextMenu?: (event: TrackClickEvent<WigFeature>) => void;
 }
-export declare function GtxTrack({ url, experimentId, config, height, background, windowFunction, maxTrackHeight, name, metadata }: GtxTrackProps): null;
+export declare function GtxTrack({ url, experimentId, config, height, background, windowFunction, maxTrackHeight, name, metadata, onClick, onContextMenu }: GtxTrackProps): null;

package/dist/types/react/tracks/InteractionTrack.d.ts

@@ -1,4 +1,5 @@
 import type { InteractionRenderConfig, TextFileFormat } from '../../types';
+import type { TrackClickEvent } from '../hooks/useTrackManager';
 export interface InteractionTrackProps {
     url: string;
     config?: Partial<InteractionRenderConfig>;
@@ -8,5 +9,9 @@ export interface InteractionTrackProps {
     indexed?: boolean;
     name?: string;
     metadata?: Record<string, string>;
+    /** Called when this track is clicked. */
+    onClick?: (event: TrackClickEvent<unknown>) => void;
+    /** Called when this track is right-clicked. */
+    onContextMenu?: (event: TrackClickEvent<unknown>) => void;
 }
-export declare function InteractionTrack({ url, config, background, format, indexURL, indexed, name, metadata }: InteractionTrackProps): null;
+export declare function InteractionTrack({ url, config, background, format, indexURL, indexed, name, metadata, onClick, onContextMenu }: InteractionTrackProps): null;

package/dist/types/react/tracks/WigTrack.d.ts

@@ -1,4 +1,5 @@
 import type { WigFeature, WigRenderConfig, WindowFunction } from '../../types';
+import type { TrackClickEvent } from '../hooks/useTrackManager';
 export interface WigTrackProps {
     /** URL to a BigWig file. Mutually exclusive with `features`. */
     url?: string;
@@ -11,5 +12,9 @@ export interface WigTrackProps {
     maxTrackHeight?: number;
     name?: string;
     metadata?: Record<string, string>;
+    /** Called when this track is clicked. Features are typed as WigFeature. */
+    onClick?: (event: TrackClickEvent<WigFeature>) => void;
+    /** Called when this track is right-clicked. */
+    onContextMenu?: (event: TrackClickEvent<WigFeature>) => void;
 }
-export declare function WigTrack({ url, features, config, height, background, windowFunction, maxTrackHeight, name, metadata }: WigTrackProps): null;
+export declare function WigTrack({ url, features, config, height, background, windowFunction, maxTrackHeight, name, metadata, onClick, onContextMenu }: WigTrackProps): null;

package/dist/types/tracks/annotation/annotationTrackCanvas.d.ts

@@ -51,6 +51,7 @@ export declare class AnnotationTrackCanvas extends BaseTrackCanvas<AnnotationRen
     setFeatures(features: AnnotationFeature[]): void;
     protected computeHeight(_width: number): number;
     protected getBackground(): string;
+    protected renderLabelOverlay(ctx: CanvasRenderingContext2D, _width: number, height: number): void;
     protected doRender(ctx: CanvasRenderingContext2D, _width: number, _height: number, rc: RenderContext): void;
     getAxisInfo(): AxisInfo | undefined;
     getContextMenuItems(_x: number, _y: number): ContextMenuItem[];

package/dist/types/tracks/baseTrackCanvas.d.ts

@@ -93,6 +93,12 @@ export declare abstract class BaseTrackCanvas<TConfig> implements Track {
      * Mirrors igv.js TrackViewport.createZoomInNotice (js/trackViewport.ts).
      */
     protected renderZoomInNotice(ctx: CanvasRenderingContext2D, width: number, height: number): void;
+    /**
+     * Render the track name label overlay. Called after error/zoom-in notices
+     * so labels remain visible even when the track can't render data.
+     * No-op by default — subclasses with name labels should override.
+     */
+    protected renderLabelOverlay(_ctx: CanvasRenderingContext2D, _width: number, _height: number): void;
     /**
      * Render this track onto an arbitrary context (e.g. Canvas2SVG for SVG export).
      * Skips DPR scaling and canvas-element lifecycle — draws directly at the given

package/dist/types/tracks/interaction/interactionTrackCanvas.d.ts

@@ -37,6 +37,7 @@ export declare class InteractionTrackCanvas extends BaseTrackCanvas<InteractionR
     setFeatures(features: InteractionFeature[]): void;
     protected computeHeight(_width: number): number;
     protected getBackground(): string;
+    protected renderLabelOverlay(ctx: CanvasRenderingContext2D, _width: number, height: number): void;
     protected doRender(ctx: CanvasRenderingContext2D, _width: number, _height: number, rc: RenderContext): void;
     /** Hit-test: find features at canvas-relative pixel coordinates. */
     hitTest(x: number, y: number): HitTestResult<InteractionFeature>[];

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

@@ -71,6 +71,7 @@ export declare class WigTrackCanvas extends BaseTrackCanvas<WigRenderConfig> {
     private augmentWithSequence;
     protected computeHeight(_width: number): number;
     protected getBackground(): string;
+    protected renderLabelOverlay(ctx: CanvasRenderingContext2D, _width: number, height: number): void;
     protected doRender(ctx: CanvasRenderingContext2D, _width: number, height: number, rc: RenderContext): void;
     getAxisInfo(): AxisInfo | undefined;
     getContextMenuItems(_x: number, _y: number): ContextMenuItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "loom-browser",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "main": "dist/loom.esm.js",
   "module": "dist/loom.esm.js",
   "types": "dist/types/index.d.ts",