loom-browser 0.0.9 → 0.0.10

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

@@ -4,7 +4,7 @@
  * 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';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomLocusInput extends HTMLElement {
     private input;
     private unsubscribe;

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

@@ -1,7 +1,7 @@
 /**
  * <loom-navbar> — Horizontal navigation bar composing locus input, window size, and zoom controls.
  */
-import type { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomNavbar extends HTMLElement {
     private chromSelect;
     private locusInput;

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

@@ -1,7 +1,7 @@
 /**
  * <loom-window-size> — Read-only display of current viewport bp range.
  */
-import type { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomWindowSize extends HTMLElement {
     private label;
     private unsubscribe;

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

@@ -1,7 +1,7 @@
 /**
  * <loom-zoom-controls> — Zoom in/out buttons.
  */
-import type { GenomeBrowser } from '../../genomeBrowser';
+import type { GenomeBrowser } from '../../browser/dom/genomeBrowser';
 export declare class LoomZoomControls extends HTMLElement {
     private _browser;
     constructor();

package/dist/types/undoManager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Undo/redo manager for HeadlessGenomeBrowser.
+ *
+ * Maintains two stacks of tagged session snapshots. Each entry records the
+ * mutation type so consumers can filter (e.g., skip navigation-only entries).
+ *
+ * Decoupled from the browser — operates purely on SessionConfig objects.
+ */
+import type { SessionConfig } from './types';
+/** Category of mutation that produced an undo entry. */
+export type UndoEntryType = 'navigation' | 'track-add' | 'track-remove' | 'track-reorder' | 'track-config' | 'roi' | 'theme' | 'session-load';
+/** A single undo/redo stack entry. */
+export interface UndoEntry {
+    type: UndoEntryType;
+    session: SessionConfig;
+}
+export declare class UndoManager {
+    readonly maxHistory: number;
+    private undoStack;
+    private redoStack;
+    private _paused;
+    constructor(maxHistory?: number);
+    /** Whether snapshot calls are currently suppressed. */
+    get paused(): boolean;
+    /** Suppress snapshot calls (e.g., during loadSession restoration). */
+    pause(): void;
+    /** Resume snapshot calls. */
+    resume(): void;
+    /** Push the current state before a mutation. Clears the redo stack. */
+    snapshot(type: UndoEntryType, session: SessionConfig): void;
+    /**
+     * Undo: pop from undo stack, push currentSession to redo, return the entry to restore.
+     * Optionally skip entries matching a predicate (they are discarded).
+     */
+    undo(currentSession: SessionConfig, skip?: (e: UndoEntry) => boolean): UndoEntry | undefined;
+    /**
+     * Redo: pop from redo stack, push currentSession to undo, return the entry to restore.
+     * Optionally skip entries matching a predicate (they are discarded).
+     */
+    redo(currentSession: SessionConfig, skip?: (e: UndoEntry) => boolean): UndoEntry | undefined;
+    canUndo(skip?: (e: UndoEntry) => boolean): boolean;
+    canRedo(skip?: (e: UndoEntry) => boolean): boolean;
+    /** Number of entries in the undo stack. */
+    get undoSize(): number;
+    /** Number of entries in the redo stack. */
+    get redoSize(): number;
+    /** Clear all history. */
+    clear(): void;
+}

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

@@ -7,7 +7,7 @@
  * Runs inside a web worker or Node worker_threads context.
  * Layer 1 (Data + Layout): no DOM.
  */
-import type { DataSourceConfig, Locus } from '../types';
+import type { DataSourceConfig, DataSourceConfigMethod, Locus } from '../types';
 export declare class DataSourceRegistry {
     private readonly instances;
     private readonly inflightAborts;
@@ -27,7 +27,7 @@ export declare class DataSourceRegistry {
      * Call a setter method on a registered DataSource.
      * Used for serializable configuration updates (setCumulativeOffsets, setWindowFunction, etc.).
      */
-    configure(instanceId: string, method: string, args: unknown[]): void;
+    configure(instanceId: string, method: DataSourceConfigMethod, args: unknown[]): void;
     /** Destroy a DataSource instance and clean up. */
     destroy(instanceId: string): void;
 }

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

@@ -0,0 +1,16 @@
+/**
+ * Serialized error for cross-worker-boundary error propagation.
+ *
+ * Workers can't transfer Error objects via postMessage. This type carries
+ * the error message, name, and stack trace across the boundary so the
+ * receiving side can reconstruct a meaningful Error.
+ */
+export interface SerializedError {
+    message: string;
+    name: string;
+    stack?: string;
+}
+/** Extract serializable fields from an error. */
+export declare function serializeError(err: unknown): SerializedError;
+/** Reconstruct an Error from serialized fields (preserves name and stack). */
+export declare function deserializeError(se: SerializedError): Error;

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

@@ -0,0 +1,21 @@
+/**
+ * Timeout utility for worker task execution.
+ *
+ * Wraps a promise with a configurable timeout. If the promise doesn't settle
+ * within the timeout, it rejects with a TaskTimeoutError.
+ *
+ * Layer 1 (Data): no DOM, no canvas.
+ */
+/** Default timeout for worker tasks (30 seconds). */
+export declare const DEFAULT_TASK_TIMEOUT_MS = 30000;
+/** Error thrown when a worker task exceeds its timeout. */
+export declare class TaskTimeoutError extends Error {
+    constructor(taskName: string, ms: number);
+}
+/**
+ * Race a promise against a timeout. Returns the promise result if it settles
+ * first, or rejects with TaskTimeoutError if the timeout fires first.
+ *
+ * Pass `ms <= 0` to disable the timeout (returns the promise as-is).
+ */
+export declare function withTimeout<T>(promise: Promise<T>, ms: number, taskName: string): Promise<T>;

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

@@ -19,7 +19,7 @@
  */
 import type { WorkerProvider, WorkerTask, WorkerTaskResultMap } from '../workerProvider';
 import type { DataSourceWorkerProvider } from '../dataSourceWorkerProvider';
-import type { DataSourceConfig, Locus } from '../types';
+import type { DataSourceConfig, DataSourceConfigMethod, Locus } from '../types';
 export interface WebWorkerPoolOptions {
     /**
      * URL to the worker pool script.
@@ -37,10 +37,13 @@ export interface WebWorkerPoolOptions {
      * Number of workers in the pool. Default: 1.
      */
     poolSize?: number;
+    /** Task timeout in ms. Default: 30000. Set to 0 to disable. */
+    taskTimeoutMs?: number;
 }
 export declare class WebWorkerPool implements WorkerProvider, DataSourceWorkerProvider {
     private workers;
     private readyPromises;
+    private readonly taskTimeoutMs;
     private nextId;
     private nextWorker;
     private pending;
@@ -53,7 +56,7 @@ export declare class WebWorkerPool implements WorkerProvider, DataSourceWorkerPr
     execute<T extends WorkerTask>(task: T, transfer?: Transferable[]): Promise<WorkerTaskResultMap[T['task']]>;
     create(instanceId: string, config: DataSourceConfig): void;
     fetch<F>(instanceId: string, locus: Locus, bpPerPixel: number, signal: AbortSignal): Promise<F[]>;
-    configure(instanceId: string, method: string, ...args: unknown[]): void;
+    configure(instanceId: string, method: DataSourceConfigMethod, ...args: unknown[]): void;
     destroy(instanceId: string): void;
     dispose(): void;
     /**

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

@@ -33,12 +33,15 @@ export interface WebWorkerProviderOptions {
      * Default: 1.
      */
     poolSize?: number;
+    /** Task timeout in ms. Default: 30000. Set to 0 to disable. */
+    taskTimeoutMs?: number;
 }
 export declare class WebWorkerProvider implements WorkerProvider {
     private workers;
     private nextId;
     private nextWorker;
     private pending;
+    private readonly taskTimeoutMs;
     /**
      * @param optionsOrUrl - Options object with workerUrl and poolSize,
      *   or a URL string/URL for backward compatibility (single worker).

package/dist/types/workerDataSource.d.ts

@@ -10,11 +10,11 @@
  *
  * Layer 1 (Data + Layout): no DOM.
  */
-import type { DataSource, Locus } from './types';
+import type { DataSource, ConfigurableDataSource, Locus } from './types';
 import type { CumulativeOffsets } from './genome/chromSizes';
 import type { DataSourceWorkerProvider } from './dataSourceWorkerProvider';
 import type { WindowFunction } from './types';
-export declare class WorkerDataSource<F = unknown> implements DataSource<F> {
+export declare class WorkerDataSource<F = unknown> implements DataSource<F>, ConfigurableDataSource {
     private readonly provider;
     readonly instanceId: string;
     private resolver?;

package/dist/types/workerProvider.d.ts

@@ -11,7 +11,7 @@
  *   - WebWorkerProvider   — browser (Web Workers)
  *   - NodeWorkerProvider  — Node.js (worker_threads)
  */
-import type { AnnotationFeature, WigFeature, WindowFunction, TextFileFormat, DataSourceConfig, Locus } from './types';
+import type { AnnotationFeature, WigFeature, WindowFunction, TextFileFormat, DataSourceConfig, DataSourceConfigMethod, Locus } from './types';
 import type { FeatureHeader } from './formats/featureParser';
 import type { DataSourceWorkerProvider } from './dataSourceWorkerProvider';
 export interface PackTask {
@@ -75,7 +75,7 @@ export declare class MainThreadProvider implements WorkerProvider, DataSourceWor
     private dispatch;
     create(instanceId: string, config: DataSourceConfig): void;
     fetch<F>(instanceId: string, locus: Locus, bpPerPixel: number, signal: AbortSignal): Promise<F[]>;
-    configure(instanceId: string, method: string, ...args: unknown[]): void;
+    configure(instanceId: string, method: DataSourceConfigMethod, ...args: unknown[]): void;
     destroy(instanceId: string): void;
     dispose(): void;
 }

package/package.json

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