loom-browser 0.0.1

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

@@ -0,0 +1,52 @@
+/**
+ * <igv-browser> — Top-level shell combining navbar + GenomeBrowser.
+ *
+ * Usage:
+ *   const shell = document.createElement('igv-browser')
+ *   shell.setAttribute('theme', 'modern')
+ *   container.appendChild(shell)
+ *   shell.initialize({ locus: { chr: 'chr17', start: 7668000, end: 7688000 } })
+ *   shell.addTrack(rulerTrack)
+ *   shell.addTrack(geneTrack)
+ *
+ * Or use the createShell() helper:
+ *   const shell = createShell(container, { locus, theme: 'modern' })
+ */
+import { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowserOptions, BrowserEvents } from '../../genomeBrowser';
+import type { Locus, Track } from '../../types';
+import type { ShellTheme } from '../themes';
+export declare class IgvBrowserShell extends HTMLElement {
+    private navbar;
+    private trackContainer;
+    private themeStyle;
+    private _browser;
+    static get observedAttributes(): string[];
+    constructor();
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+    private applyTheme;
+    connectedCallback(): void;
+    /** Initialize the GenomeBrowser inside this shell. */
+    initialize(options: GenomeBrowserOptions): GenomeBrowser;
+    /** Get the underlying GenomeBrowser instance. */
+    get browser(): GenomeBrowser | null;
+    /** Proxy: add a track to the browser. */
+    addTrack(track: Track): void;
+    /** Proxy: remove a track from the browser. */
+    removeTrack(track: Track): void;
+    /** Proxy: set the locus. */
+    setLocus(locus: Locus): void;
+    /** Proxy: subscribe to browser events. */
+    on<K extends keyof BrowserEvents>(event: K, handler: (data: BrowserEvents[K]) => void): (() => void) | undefined;
+    disconnectedCallback(): void;
+}
+/** Options for createShell(). */
+export interface CreateShellOptions extends GenomeBrowserOptions {
+    /** UI shell theme (CSS chrome). Separate from GenomeBrowserOptions.theme (render palette). */
+    shellTheme?: ShellTheme;
+}
+/**
+ * Convenience function to create an <igv-browser> shell and initialize it.
+ * Returns the shell element (with .browser for the underlying GenomeBrowser).
+ */
+export declare function createShell(container: HTMLElement, options: CreateShellOptions): IgvBrowserShell;

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

@@ -0,0 +1,18 @@
+/**
+ * <igv-chromosome-select> — Chromosome dropdown for quick navigation.
+ *
+ * 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';
+export declare class IgvChromosomeSelect extends HTMLElement {
+    private select;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private populate;
+    private updateSelection;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * <igv-export-controls> — SVG/PNG export buttons.
+ *
+ * Adds "Save SVG" and "Save PNG" buttons to the shell navbar.
+ * Calls GenomeBrowser.saveSVGtoFile() and savePNGtoFile() respectively.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class IgvExportControls extends HTMLElement {
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,18 @@
+/**
+ * <igv-locus-input> — Locus search/display input.
+ *
+ * Shows the current locus as a formatted string. User can type a new locus
+ * and press Enter to navigate. Updates automatically on locuschange events.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class IgvLocusInput extends HTMLElement {
+    private input;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private updateDisplay;
+    private doSearch;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * <igv-navbar> — Horizontal navigation bar composing locus input, window size, and zoom controls.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class IgvNavbar extends HTMLElement {
+    private chromSelect;
+    private locusInput;
+    private zoomControls;
+    private windowSize;
+    private exportControls;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * <igv-window-size> — Read-only display of current viewport bp range.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class IgvWindowSize extends HTMLElement {
+    private label;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private update;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * <igv-zoom-controls> — Zoom in/out buttons.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class IgvZoomControls extends HTMLElement {
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,52 @@
+/**
+ * <loom-browser> — Top-level shell combining navbar + GenomeBrowser.
+ *
+ * Usage:
+ *   const shell = document.createElement('loom-browser')
+ *   shell.setAttribute('theme', 'modern')
+ *   container.appendChild(shell)
+ *   shell.initialize({ locus: { chr: 'chr17', start: 7668000, end: 7688000 } })
+ *   shell.addTrack(rulerTrack)
+ *   shell.addTrack(geneTrack)
+ *
+ * Or use the createShell() helper:
+ *   const shell = createShell(container, { locus, theme: 'modern' })
+ */
+import { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowserOptions, BrowserEvents } from '../../genomeBrowser';
+import type { Locus, Track } from '../../types';
+import type { ShellTheme } from '../themes';
+export declare class LoomBrowserShell extends HTMLElement {
+    private navbar;
+    private trackContainer;
+    private themeStyle;
+    private _browser;
+    static get observedAttributes(): string[];
+    constructor();
+    attributeChangedCallback(name: string, _oldValue: string | null, newValue: string | null): void;
+    private applyTheme;
+    connectedCallback(): void;
+    /** Initialize the GenomeBrowser inside this shell. */
+    initialize(options: GenomeBrowserOptions): GenomeBrowser;
+    /** Get the underlying GenomeBrowser instance. */
+    get browser(): GenomeBrowser | null;
+    /** Proxy: add a track to the browser. */
+    addTrack(track: Track): void;
+    /** Proxy: remove a track from the browser. */
+    removeTrack(track: Track): void;
+    /** Proxy: set the locus. */
+    setLocus(locus: Locus): void;
+    /** Proxy: subscribe to browser events. */
+    on<K extends keyof BrowserEvents>(event: K, handler: (data: BrowserEvents[K]) => void): (() => void) | undefined;
+    disconnectedCallback(): void;
+}
+/** Options for createShell(). */
+export interface CreateShellOptions extends GenomeBrowserOptions {
+    /** UI shell theme (CSS chrome). Separate from GenomeBrowserOptions.theme (render palette). */
+    shellTheme?: ShellTheme;
+}
+/**
+ * Convenience function to create an <loom-browser> shell and initialize it.
+ * Returns the shell element (with .browser for the underlying GenomeBrowser).
+ */
+export declare function createShell(container: HTMLElement, options: CreateShellOptions): LoomBrowserShell;

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

@@ -0,0 +1,18 @@
+/**
+ * <loom-chromosome-select> — Chromosome dropdown for quick navigation.
+ *
+ * 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';
+export declare class LoomChromosomeSelect extends HTMLElement {
+    private select;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private populate;
+    private updateSelection;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,39 @@
+/**
+ * <loom-context-menu> — Right-click context menu Web Component.
+ *
+ * Renders ContextMenuItem[] as a styled menu with action items, checkboxes,
+ * separators, and one level of submenu nesting.
+ *
+ * Also exports DefaultContextMenuProvider which wraps this component and
+ * implements the ContextMenuProvider interface.
+ *
+ * Customizable via CSS custom properties:
+ *   --loom-menu-bg, --loom-menu-border, --loom-menu-radius, --loom-menu-shadow,
+ *   --loom-menu-font, --loom-menu-color, --loom-menu-hover, --loom-menu-divider
+ */
+import type { ContextMenuItem } from '../../types';
+import type { ContextMenuProvider } from '../../contextMenuProvider';
+export declare class LoomContextMenu extends HTMLElement {
+    private menuDiv;
+    constructor();
+    connectedCallback(): void;
+    /** Populate the menu from typed ContextMenuItem data. */
+    setItems(items: ContextMenuItem[]): void;
+    private buildItems;
+    /** Position and show the menu, clamping to container bounds. */
+    showAt(x: number, y: number): void;
+    hide(): void;
+}
+/**
+ * Default ContextMenuProvider using the <loom-context-menu> Web Component.
+ * Lazily creates the element on first show() call (same pattern as DefaultPopupProvider).
+ */
+export declare class DefaultContextMenuProvider implements ContextMenuProvider {
+    private element;
+    show(items: ContextMenuItem[], position: {
+        x: number;
+        y: number;
+    }, container: HTMLElement): void;
+    hide(): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,13 @@
+/**
+ * <loom-export-controls> — SVG/PNG export buttons.
+ *
+ * Adds "Save SVG" and "Save PNG" buttons to the shell navbar.
+ * Calls GenomeBrowser.saveSVGtoFile() and savePNGtoFile() respectively.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class LoomExportControls extends HTMLElement {
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,27 @@
+/**
+ * <loom-input-dialog> — Simple modal input dialog Web Component.
+ *
+ * Shows a label, text input, and OK/Cancel buttons. Returns the entered
+ * value via a Promise. Used by the context menu's "Set track height" action.
+ *
+ * Customizable via CSS custom properties:
+ *   --loom-dialog-bg, --loom-dialog-border, --loom-dialog-shadow,
+ *   --loom-dialog-font, --loom-dialog-color, --loom-dialog-radius,
+ *   --loom-dialog-btn-bg, --loom-dialog-btn-color
+ */
+export declare class LoomInputDialog extends HTMLElement {
+    private labelEl;
+    private inputEl;
+    private okBtn;
+    private cancelBtn;
+    private resolve;
+    constructor();
+    connectedCallback(): void;
+    /**
+     * Show the dialog and return a Promise that resolves with the input value
+     * (on OK/Enter) or null (on Cancel/Escape).
+     */
+    prompt(label: string, currentValue: string | number): Promise<string | null>;
+    private confirm;
+    private cancel;
+}

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

@@ -0,0 +1,18 @@
+/**
+ * <loom-locus-input> — Locus search/display input.
+ *
+ * Shows the current locus as a formatted string. User can type a new locus
+ * and press Enter to navigate. Updates automatically on locuschange events.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class LoomLocusInput extends HTMLElement {
+    private input;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private updateDisplay;
+    private doSearch;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,15 @@
+/**
+ * <loom-navbar> — Horizontal navigation bar composing locus input, window size, and zoom controls.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class LoomNavbar extends HTMLElement {
+    private chromSelect;
+    private locusInput;
+    private zoomControls;
+    private windowSize;
+    private exportControls;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,32 @@
+/**
+ * <loom-popup> — Feature popup / tooltip Web Component.
+ *
+ * Renders PopupDataItem[] as a name/value table. Positioned as a floating
+ * element near the pointer, clamped to stay within the viewport.
+ *
+ * Also exports DefaultPopupProvider which wraps this component and
+ * implements the PopupProvider interface.
+ */
+import type { PopupDataItem } from '../../types';
+import type { PopupProvider } from '../../popupProvider';
+export declare class LoomPopup extends HTMLElement {
+    constructor();
+    /** Populate popup with data items and show it. */
+    setData(data: PopupDataItem[]): void;
+    /** Position relative to a parent container and show. */
+    showAt(x: number, y: number): void;
+    hide(): void;
+}
+/**
+ * Default PopupProvider implementation using the <loom-popup> Web Component.
+ * Creates and manages a single popup element within the browser container.
+ */
+export declare class DefaultPopupProvider implements PopupProvider {
+    private element;
+    show(data: PopupDataItem[], position: {
+        x: number;
+        y: number;
+    }, container: HTMLElement): void;
+    hide(): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,14 @@
+/**
+ * <loom-window-size> — Read-only display of current viewport bp range.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class LoomWindowSize extends HTMLElement {
+    private label;
+    private unsubscribe;
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+    private update;
+    disconnectedCallback(): void;
+}

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

@@ -0,0 +1,10 @@
+/**
+ * <loom-zoom-controls> — Zoom in/out buttons.
+ */
+import type { GenomeBrowser } from '../../genomeBrowser';
+export declare class LoomZoomControls extends HTMLElement {
+    private _browser;
+    constructor();
+    set browser(b: GenomeBrowser | null);
+    get browser(): GenomeBrowser | null;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * UI Shell — Web components for interacting with the headless GenomeBrowser.
+ *
+ * Importing this module auto-registers all custom elements:
+ *   <loom-browser>, <loom-navbar>, <loom-chromosome-select>, <loom-locus-input>, <loom-zoom-controls>, <loom-window-size>, <loom-export-controls>
+ */
+export { EventEmitter } from '../events';
+export { parseLocus, formatLocus, formatBpLength } from '../locusUtils';
+export { classicThemeCSS, modernThemeCSS, getThemeCSS } from './themes';
+export type { ShellTheme } from './themes';
+export { LoomChromosomeSelect } from './components/LoomChromosomeSelect';
+export { LoomLocusInput } from './components/LoomLocusInput';
+export { LoomZoomControls } from './components/LoomZoomControls';
+export { LoomWindowSize } from './components/LoomWindowSize';
+export { LoomExportControls } from './components/LoomExportControls';
+export { LoomNavbar } from './components/LoomNavbar';
+export { LoomBrowserShell, createShell } from './components/LoomBrowserShell';
+export type { CreateShellOptions } from './components/LoomBrowserShell';
+export { LoomPopup, DefaultPopupProvider } from './components/LoomPopup';
+export { LoomContextMenu, DefaultContextMenuProvider } from './components/LoomContextMenu';
+export { LoomInputDialog } from './components/LoomInputDialog';

package/dist/types/ui/themes.d.ts

@@ -0,0 +1,14 @@
+/**
+ * CSS custom property themes for UI shell web components.
+ *
+ * Themes are injected as <style> blocks into Shadow DOM roots.
+ * Components reference CSS custom properties (--loom-*) for all visual styling.
+ */
+export type ShellTheme = 'classic' | 'modern' | 'dark';
+/** Classic theme — matches igv.js navbar look. */
+export declare const classicThemeCSS = "\n:host {\n    --loom-navbar-bg: #f3f3f3;\n    --loom-navbar-height: 32px;\n    --loom-navbar-padding: 0 8px;\n    --loom-font: 12px Arial, sans-serif;\n    --loom-font-small: 11px Arial, sans-serif;\n    --loom-text-color: #333;\n    --loom-text-muted: #737373;\n    --loom-border: 1px solid #ccc;\n    --loom-border-radius: 4px;\n    --loom-button-bg: white;\n    --loom-button-hover: #e8e8e8;\n    --loom-button-border: 1px solid #b0b0b0;\n    --loom-button-size: 24px;\n    --loom-input-bg: white;\n    --loom-input-border: 1px solid #b0b0b0;\n    --loom-input-focus-border: 1px solid #4A90D9;\n    --loom-input-width: 220px;\n    --loom-input-height: 22px;\n    --loom-accent: #4A90D9;\n    --loom-icon-color: #555;\n    --loom-icon-size: 14px;\n    --loom-gap: 8px;\n}\n";
+/** Modern theme — softer colors, rounded corners, taller navbar. */
+export declare const modernThemeCSS = "\n:host {\n    --loom-navbar-bg: #fafbfc;\n    --loom-navbar-height: 40px;\n    --loom-navbar-padding: 0 12px;\n    --loom-font: 13px Inter, system-ui, -apple-system, sans-serif;\n    --loom-font-small: 11px Inter, system-ui, -apple-system, sans-serif;\n    --loom-text-color: #1a1a1a;\n    --loom-text-muted: #6b7280;\n    --loom-border: 1px solid rgba(0, 0, 0, 0.08);\n    --loom-border-radius: 8px;\n    --loom-button-bg: white;\n    --loom-button-hover: #f0f4ff;\n    --loom-button-border: 1px solid rgba(0, 0, 0, 0.1);\n    --loom-button-size: 28px;\n    --loom-input-bg: white;\n    --loom-input-border: 1px solid rgba(0, 0, 0, 0.12);\n    --loom-input-focus-border: 1px solid #4A90D9;\n    --loom-input-width: 260px;\n    --loom-input-height: 28px;\n    --loom-accent: #4A90D9;\n    --loom-icon-color: #6b7280;\n    --loom-icon-size: 16px;\n    --loom-gap: 10px;\n}\n";
+/** Dark theme — dark backgrounds, light text, high contrast. */
+export declare const darkThemeCSS = "\n:host {\n    --loom-shell-bg: #16162a;\n    --loom-navbar-bg: #1a1a2e;\n    --loom-navbar-height: 36px;\n    --loom-navbar-padding: 0 10px;\n    --loom-font: 12px Arial, sans-serif;\n    --loom-font-small: 11px Arial, sans-serif;\n    --loom-text-color: #e0e0e0;\n    --loom-text-muted: #888;\n    --loom-border: 1px solid #333;\n    --loom-border-radius: 4px;\n    --loom-button-bg: #2a2a3e;\n    --loom-button-hover: #3a3a50;\n    --loom-button-border: 1px solid #444;\n    --loom-button-size: 24px;\n    --loom-input-bg: #2a2a3e;\n    --loom-input-border: 1px solid #444;\n    --loom-input-focus-border: 1px solid #6a9fd9;\n    --loom-input-width: 220px;\n    --loom-input-height: 22px;\n    --loom-accent: #6a9fd9;\n    --loom-icon-color: #b0b0b0;\n    --loom-icon-size: 14px;\n    --loom-gap: 8px;\n}\n";
+export declare function getThemeCSS(theme: ShellTheme): string;

package/dist/types/wigRenderer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Standalone wig track renderer.
+ *
+ * Adapted from js/feature/wigTrack.ts draw() method with no `this` context —
+ * all configuration is passed as explicit parameters.
+ *
+ * Supports four graph types: bar, line, points, and dynseq.
+ */
+import type { WigFeature, WigRenderConfig, RenderContext } from './types';
+/**
+ * Render wig features onto a canvas context.
+ *
+ * The canvas should be sized and cleared before calling this.
+ */
+export declare function renderWigTrack(ctx: CanvasRenderingContext2D, features: WigFeature[], config: WigRenderConfig, rc: RenderContext): void;

package/dist/types/wigSummary.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Resolution-aware data summarization for wig tracks.
+ *
+ * When zoomed out, many data points map to the same pixel. This module bins
+ * features and applies a window function (mean, min, max) to produce one
+ * summary value per pixel-width bin.
+ *
+ * Ported from js/feature/wigSummary.ts with strict types, no `any`.
+ */
+import type { WigFeature, WindowFunction } from './types';
+/**
+ * Summarize wig features by binning into pixel-width windows and applying
+ * a window function.
+ *
+ * Features must be sorted by position. Wig features cannot overlap.
+ *
+ * @param features - sorted array of wig features
+ * @param startBP - start position in base pairs (left edge of viewport)
+ * @param bpPerPixel - base pairs per pixel (bin size)
+ * @param windowFunction - aggregation function: mean, min, max, or none
+ * @returns summarized features (one per pixel-bin)
+ */
+export declare function summarizeWigData(features: WigFeature[], startBP: number, bpPerPixel: number, windowFunction?: WindowFunction): WigFeature[];
+/**
+ * Compute the min/max data range from a set of wig features.
+ * Useful for autoscaling.
+ */
+export declare function computeWigDataRange(features: WigFeature[]): {
+    min: number;
+    max: number;
+};

package/dist/types/wigThemes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Preset render themes for wig tracks.
+ *
+ * Each theme is a Partial<WigRenderConfig> that can be spread over defaults.
+ * Usage: { ...defaultWigRenderConfig(), ...modernWigTheme }
+ */
+import type { WigRenderConfig } from './types';
+/** Modern theme — blue bars with subtle styling. */
+export declare const modernWigTheme: Partial<WigRenderConfig>;
+/** Dark theme — bright teal on dark background. */
+export declare const darkWigTheme: Partial<WigRenderConfig>;
+/** Warm red theme — for coverage or signal intensity. */
+export declare const warmWigTheme: Partial<WigRenderConfig>;
+/** Line graph variant — modern blue line. */
+export declare const lineWigTheme: Partial<WigRenderConfig>;

package/dist/types/wigTrackCanvas.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Canvas manager for rendering wig (wiggle) tracks.
+ *
+ * Extends BaseTrackCanvas — canvas lifecycle is handled by the base class.
+ * This class implements wig-specific logic: data summarization, autoscale,
+ * and dynseq-aware rendering.
+ *
+ * For dynseq mode, features should arrive with `.sequence` already attached
+ * (e.g. via DynseqDataSource). This matches the igv.js pattern where sequence
+ * is fetched during getFeatures(), not during rendering.
+ *
+ * Usage:
+ *   const canvas = document.createElement('canvas')
+ *   const track = new WigTrackCanvas(canvas, { locus, features })
+ *   track.attachTo(containerDiv)
+ */
+import type { WigFeature, WigRenderConfig, Locus, RenderContext, WigTrackSessionConfig } from './types';
+import type { CanvasProvider } from './canvasProvider';
+import type { RenderTheme } from './renderTheme';
+import { BaseTrackCanvas } from './baseTrackCanvas';
+export interface WigTrackCanvasOptions {
+    locus: Locus;
+    features: WigFeature[];
+    /** Per-track config overrides. Applied after theme-derived defaults. */
+    config?: Partial<WigRenderConfig>;
+    /** Unified render theme. Palette drives default colors/fonts. */
+    theme?: Partial<RenderTheme>;
+    /** Fixed pixel height. If not set, uses config.height (default 50). */
+    height?: number;
+    /** Background color. Overrides palette.background if set. */
+    background?: string;
+    /** Canvas provider for environment abstraction. Default: DOMCanvasProvider. */
+    canvasProvider?: CanvasProvider;
+}
+export declare class WigTrackCanvas extends BaseTrackCanvas<WigRenderConfig> {
+    private features;
+    private fixedHeight;
+    readonly type = "wig";
+    constructor(canvas: HTMLCanvasElement, options: WigTrackCanvasOptions);
+    /** Update features and re-render. Recomputes autoscale if enabled. */
+    setFeatures(features: WigFeature[]): void;
+    protected computeHeight(_width: number): number;
+    protected getBackground(): string;
+    protected doRender(ctx: CanvasRenderingContext2D, _width: number, height: number, rc: RenderContext): void;
+    serializeConfig(theme: RenderTheme): WigTrackSessionConfig;
+}

package/dist/types/worker/decodeWig.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Standalone WIG data decode functions.
+ *
+ * Extracted from BigWigReader's private methods so they can be used both
+ * on the main thread (by BigWigReader) and in worker threads (by taskHandler).
+ *
+ * Key difference from the instance methods: chromosome ID → name resolution
+ * uses a pre-built Map instead of the async ChromTree.getNameForId() lookup.
+ */
+import type { WigFeature, WindowFunction } from '../types';
+/**
+ * Decode WIG data from a binary block (full resolution).
+ * Three WIG formats: BedGraph (type 1), Variable step (type 2), Fixed step (type 3).
+ */
+export declare function decodeWigData(data: Uint8Array, littleEndian: boolean, chrIdx1: number, bpStart: number, chrIdx2: number, bpEnd: number, chromNames: Map<number, string>): WigFeature[];
+/**
+ * Decode zoom-level summary data.
+ * Each record: chromId, chromStart, chromEnd, validCount, minVal, maxVal, sumData, sumSquares.
+ */
+export declare function decodeZoomData(data: Uint8Array, littleEndian: boolean, chrIdx1: number, bpStart: number, chrIdx2: number, bpEnd: number, windowFunction: WindowFunction, chromNames: Map<number, string>): WigFeature[];

package/dist/types/worker/nodeWorkerProvider.d.ts

@@ -0,0 +1,28 @@
+/**
+ * NodeWorkerProvider — Node.js worker_threads implementation of WorkerProvider.
+ *
+ * Same RPC pattern as WebWorkerProvider but uses Node.js worker_threads API.
+ * All worker_threads references use dynamic import() to avoid requiring
+ * @types/node in browser-targeted builds.
+ *
+ * Usage:
+ *   import { NodeWorkerProvider } from './worker/nodeWorkerProvider'
+ *   const provider = new NodeWorkerProvider(new URL('./nodeWorkerScript.js', import.meta.url))
+ *   const browser = new HeadlessGenomeBrowser({ ..., workerProvider: provider })
+ *   // ...
+ *   provider.dispose()
+ */
+import type { WorkerProvider, WorkerTask, WorkerTaskResultMap } from '../workerProvider';
+export declare class NodeWorkerProvider implements WorkerProvider {
+    private worker;
+    private nextId;
+    private pending;
+    private initPromise;
+    /**
+     * @param workerPath - Path or URL to the Node.js worker script.
+     */
+    constructor(workerPath: string | URL);
+    private init;
+    execute<T extends WorkerTask>(task: T, transfer?: Transferable[]): Promise<WorkerTaskResultMap[T['task']]>;
+    dispose(): void;
+}

package/dist/types/worker/taskHandler.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Pure task dispatcher for worker threads.
+ *
+ * Maps WorkerTask → result using existing pure functions. No DOM, no
+ * environment-specific APIs. Imported by both the Web Worker script
+ * and the Node.js worker_threads script.
+ */
+import type { WorkerTask, WorkerTaskResultMap } from '../workerProvider';
+/**
+ * Handle a worker task and return the result.
+ *
+ * Each task is dispatched to the appropriate pure function. The return
+ * value must be structured-clone-safe (or Transferable for ArrayBuffers).
+ */
+export declare function handleTask(task: WorkerTask): Promise<WorkerTaskResultMap[WorkerTask['task']]>;