react-msaview 6.5.0 → 8.0.0

package/dist/types.d.ts

@@ -1,16 +1,25 @@
+import type { ResolvedScale, ScaleSpec } from './scales.ts';
 import type { Annotation } from 'msa-parsers';
 export interface Accession {
     accession: string;
     name: string;
     description: string;
 }
-export type TrackKind = 'text' | 'bar' | 'logo';
+export type TrackKind = 'text' | 'bar' | 'logo' | 'arc' | 'ruler';
+/**
+ * Which channel the color scheme paints. `fill` colors the cell a residue sits
+ * in, `color` colors the letter itself, the same distinction a grammar of
+ * graphics draws between a shape's interior and its own ink.
+ */
+export type ResidueEncoding = 'fill' | 'color';
 export interface BasicTrackModel {
     id: string;
     name: string;
     associatedRowName?: string;
     height: number;
     kind: TrackKind;
+    heightKey?: string;
+    defaultOff?: boolean;
 }
 export interface TextTrackModel extends BasicTrackModel {
     customColorScheme?: Record<string, string>;
@@ -19,22 +28,200 @@ export interface TextTrackModel extends BasicTrackModel {
 export interface BarTrackModel extends BasicTrackModel {
     barColor?: string;
 }
+export interface Arc {
+    start: number;
+    end: number;
+    color?: string;
+}
+export interface ArcTrackModel extends BasicTrackModel {
+    arcs?: Arc[];
+    arcColor?: string;
+}
 export interface BasicTrack {
     ReactComponent: React.FC<any>;
-    model: TextTrackModel & BarTrackModel;
+    model: TextTrackModel & BarTrackModel & ArcTrackModel;
+}
+export interface ArcSpec {
+    start: number;
+    end: number;
+    color?: string;
 }
 export interface ColumnTrackSpec {
     id: string;
     name: string;
-    kind: 'bar' | 'text';
+    kind: 'bar' | 'text' | 'arc';
     values?: number[];
     data?: string;
+    arcs?: ArcSpec[];
     max?: number;
     color?: string;
     colors?: Record<string, string>;
     row?: string;
     height?: number;
 }
+/**
+ * A strip panel: one cell per row, colored from a `rowData` field through
+ * `scale`, which is ggtree's `gheatmap`. `width` is in pixels and defaults to
+ * the row height, and `header` labels the column and defaults to the field.
+ * `legend` titles the strip's legend and defaults to the field, and strips
+ * naming one title share one legend.
+ */
+export interface RowStripSpec {
+    kind: 'strip';
+    field: string;
+    scale?: ScaleSpec;
+    width?: number;
+    header?: string;
+    legend?: string;
+}
+/** the channels a `features` panel reads off the feature table */
+export interface FeatureEncodingSpec {
+    color?: {
+        field: string;
+        scale?: ScaleSpec;
+    };
+    label?: string;
+}
+/**
+ * Shifts each row so that the first feature named `on` starts at zero, which
+ * is gggenes' `make_alignment_dummies`. Only `x: "position"` reads it.
+ */
+export interface AlignTransform {
+    type: 'align';
+    on: string;
+}
+/**
+ * A features panel: the GFF's spans per row, as arrows where they carry a
+ * strand. `x: "column"` draws them in the alignment's columns, and
+ * `x: "position"` in each row's own residue positions on one linear scale, so
+ * a genome with no alignment has an x.
+ */
+export interface RowFeaturesSpec {
+    kind: 'features';
+    x: 'column' | 'position';
+    width?: number;
+    header?: string;
+    encoding?: FeatureEncodingSpec;
+    transform?: AlignTransform[];
+}
+/**
+ * A panel left of the alignment on the row scale, the counterpart of
+ * ColumnTrackSpec on the column scale. See docs/layers.md
+ */
+export type RowPanelSpec = RowStripSpec | RowFeaturesSpec;
+interface ResolvedPanelBase {
+    id: string;
+    header: string;
+    width: number;
+    offsetX: number;
+    legend: LegendEntry[];
+    /** the legend this panel's entries go under; absent means the domain key */
+    legendTitle?: string;
+}
+/**
+ * A strip with its scale resolved: the color each row takes, keyed by row
+ * name, and the pixel column the panel draws in.
+ */
+export interface ResolvedStripPanel extends ResolvedPanelBase {
+    kind: 'strip';
+    field: string;
+    colors: Map<string, string>;
+}
+/** one feature of a features panel, at its pixel span inside the panel */
+export interface RowPanelSpan {
+    annotation: Annotation;
+    xStart: number;
+    xEnd: number;
+    lane: number;
+    laneCount: number;
+}
+/**
+ * A features panel with its x mapping and its scale resolved: the spans per
+ * row name in panel pixels, the fill and outline of each feature, and the
+ * label its `label` channel draws. `field` is the field its color scale reads,
+ * which its legend is titled by.
+ */
+export interface ResolvedFeaturePanel extends ResolvedPanelBase {
+    kind: 'features';
+    x: 'column' | 'position';
+    field?: string;
+    spans: Map<string, RowPanelSpan[]>;
+    colors: Map<Annotation, {
+        fill: string;
+        stroke: string;
+    }>;
+    labels?: Map<Annotation, string>;
+}
+export type ResolvedRowPanel = ResolvedStripPanel | ResolvedFeaturePanel;
+export interface ResidueSegment {
+    rowStart: number;
+    rowEnd: number;
+    structStart: number;
+    structEnd: number;
+}
+export interface MappedStructure {
+    id: string;
+    kind?: 'experimental' | 'predicted';
+    asymId?: string;
+    url?: string;
+}
+/**
+ * The structure residue for each residue of a row, computed outside the viewer
+ * (SIFTS, an AlphaFold model, a curator). Sequence equality misplaces tagged
+ * constructs, truncations and subsequence rows; see docs/layers.md.
+ *
+ * Positions are 1-based and inclusive on both sides, as GFF and `highlights`
+ * are. Structure positions are `label_seq_id`, the index into the entity's
+ * SEQRES; author numbering carries insertion codes and is not used.
+ *
+ * `unobserved` is in structure positions: present in SEQRES with no
+ * coordinates, as distinct from a residue the structure lacks.
+ */
+export interface ResidueMapping {
+    row: string;
+    accession?: string;
+    structure: MappedStructure;
+    segments: ResidueSegment[];
+    unobserved?: [number, number][];
+    /**
+     * ungapped length of the row this was computed against. When set, the viewer
+     * ignores the mapping if the loaded row's length differs, as it does after a
+     * re-alignment, revision or swapped sequence.
+     */
+    rowLength?: number;
+    generated?: {
+        by?: string;
+        date?: string;
+        sourceSha256?: string;
+    };
+}
+export interface ResidueMappingProblem {
+    row: string;
+    structureId: string;
+    /**
+     * `mapping` ignores the whole mapping, because the problem concerns its row.
+     * `segment` ignores only that segment and keeps the rest.
+     */
+    scope: 'mapping' | 'segment';
+    reason: string;
+}
+export interface StructureResidue {
+    structure: MappedStructure;
+    position: number;
+    observed: boolean;
+}
+export interface RowResidue {
+    rowName: string;
+    seqPos: number;
+}
+/**
+ * One loaded document that the snapshot omits, and its size. `what` uses the
+ * import form's names for the documents.
+ */
+export interface UnshareableData {
+    what: 'alignment' | 'tree' | 'annotations' | 'row metadata' | 'data tracks';
+    bytes: number;
+}
 export type { Annotation };
 export type TidyDomainAnnotation = Annotation;
 export interface DomainBand {
@@ -42,6 +229,27 @@ export interface DomainBand {
     startCol: number;
     endCol: number;
     stackIndex: number;
+    lane: number;
+    laneCount: number;
+}
+/**
+ * One swatch of a categorical color key. `id` is the value the scale read, and
+ * `label` is the text drawn beside the swatch.
+ */
+export interface LegendEntry {
+    id: string;
+    label: string;
+    color: string;
+}
+/**
+ * A categorical color key, drawn by the on-screen overlay and reserved as a
+ * column in the SVG export. `title` names the legend where the viewer draws
+ * more than one.
+ */
+export interface Legend {
+    id: string;
+    title: string;
+    entries: LegendEntry[];
 }
 /**
  * A persistent, labeled highlight. Coordinates are 1-based and inclusive, as
@@ -56,6 +264,90 @@ export interface Highlight {
     label?: string;
     color?: string;
 }
+/**
+ * What the viewer draws over a clade. `highlight` fills the rows behind it,
+ * across the tree and the alignment. `bracket` draws a bar and the clade's
+ * `label` in the gutter right of the tip labels. `collapse` and `focus` seed
+ * the collapsed list and the subtree in focus at load.
+ */
+export type CladeMark = 'highlight' | 'bracket' | 'collapse' | 'focus';
+/**
+ * A clade of the tree and the mark drawn over it. `mrca` names tips whose most
+ * recent common ancestor is the clade; `range` names the first and last tip of
+ * a run in display order, in either order. `tips` is the leaf count the
+ * producer measured, and a clade that resolves to a different count is dropped.
+ * `label` names the clade beside a bracket, and a highlight carrying one draws
+ * the label without the bar. See docs/layers.md
+ */
+export interface Clade {
+    mrca?: string[];
+    range?: [string, string];
+    tips: number;
+    mark: CladeMark;
+    color?: string;
+    label?: string;
+}
+/**
+ * A Clade resolved to the rows it covers, with its fill color settled. `color`
+ * is the highlight fill; `markColor` is the producer's own color for a bracket
+ * bar and its label, unset where the theme's text color stands. `nodeId` is the
+ * node an `mrca` resolved to, which `collapse` and `focus` seed themselves
+ * with, and a `range` record has none.
+ */
+export interface ResolvedClade {
+    rows: [number, number];
+    mark: CladeMark;
+    color: string;
+    markColor?: string;
+    label?: string;
+    nodeId?: string;
+}
+/**
+ * A span in Highlight coordinates: 1-based inclusive residues of `row`, or
+ * columns of the file without it
+ */
+export interface Region {
+    row?: string;
+    start: number;
+    end: number;
+}
+/**
+ * A cell of the alignment in the host's coordinates, 1-based like Highlight:
+ * `column` counts every column of the file, hidden gappy ones included, and
+ * `residue` counts the row's own letters, absent on a gap. A pointer over a
+ * track has a column and no row.
+ */
+export interface Cell {
+    column: number;
+    row?: string;
+    residue?: number;
+    letter?: string;
+}
+/** the alignment columns on screen, 1-based and inclusive */
+export interface Viewport {
+    startColumn: number;
+    endColumn: number;
+}
+/**
+ * A channel of a mark the viewer always draws. `tipLabel` colors each tip label
+ * in the tree, `rowTint` washes the row across the tree gutter and the
+ * alignment, and `branch` colors a tree edge whose tips all share one value;
+ * all three read a field of `rowData`. `featureFill` colors each span of the
+ * annotation overlay and `featureLabel` names the field drawn inside a span,
+ * both from a field of the feature table.
+ */
+export type EncodingChannel = 'tipLabel' | 'rowTint' | 'branch' | 'featureFill' | 'featureLabel';
+/**
+ * A channel, the field feeding it, and the scale it reads that field through.
+ * See docs/layers.md
+ */
+export interface Encoding {
+    channel: EncodingChannel;
+    field: string;
+    scale?: ScaleSpec;
+}
+/** an Encoding with its scale resolved against the values in the table */
+export type ResolvedEncoding = Encoding & ResolvedScale;
 /** a Highlight resolved to visible column indices and row indices */
 export interface ResolvedHighlight {
     startCol?: number;

package/dist/umd.d.ts

@@ -1,6 +1,8 @@
 import * as React from 'react';
 export { destroy } from '@jbrowse/mobx-state-tree';
 export { default as MSAView } from './components/Loading.tsx';
+export { mount } from './mount.tsx';
+export { defineMsaElement } from './element.ts';
 export { type MsaViewModel, default as MSAModelF } from './model.ts';
 export * from 'react-dom/client';
 export { React };

package/dist/umd.js

@@ -1,8 +1,10 @@
 import * as React from 'react';
-// a host that swaps models (the R htmlwidget on re-render) has to destroy the
-// old one, or the disposers its autoruns registered never run
+// a page that builds models with MSAModelF destroys each one it replaces, so
+// the disposers its autoruns registered run
 export { destroy } from '@jbrowse/mobx-state-tree';
 export { default as MSAView } from './components/Loading.js';
+export { mount } from './mount.js';
+export { defineMsaElement } from './element.js';
 export { default as MSAModelF } from './model.js';
 export * from 'react-dom/client';
 export { React };

package/dist/umd.js.map

@@ -1 +1 @@
-{"version":3,"file":"umd.js","sourceRoot":"","sources":["../src/umd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,8EAA8E;AAC9E,8DAA8D;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAA0B,CAAA;AAC7D,OAAO,EAAqB,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpE,cAAc,kBAAkB,CAAA;AAEhC,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"umd.js","sourceRoot":"","sources":["../src/umd.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,6EAA6E;AAC7E,4CAA4C;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA;AAClD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,yBAA0B,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAa,CAAA;AACnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,EAAqB,OAAO,IAAI,SAAS,EAAE,MAAM,YAAY,CAAA;AAEpE,cAAc,kBAAkB,CAAA;AAEhC,OAAO,EAAE,KAAK,EAAE,CAAA"}

package/dist/useCanvasAutorun.d.ts

@@ -1,17 +1,12 @@
 import type React from 'react';
 /**
  * Wires a canvas ref to a mobx autorun: grabs the 2d context once the canvas
- * mounts and re-runs `draw` whenever any observable it reads changes. Collapses
- * the getContext/null-guard/autorun-dispose boilerplate repeated by every canvas
- * block host.
+ * mounts and re-runs `draw` whenever any observable it reads changes.
  *
- * `width`/`height` are the canvas *backing store* size the caller renders onto
- * the element (logical size times the high-res scale factor), and they are load
- * bearing rather than informational. Assigning either resets the canvas bitmap,
- * and React assigns them on every commit where they changed -- which lands
- * *after* the mobx reaction that already redrew at the old size. Without a redraw
- * on the far side of that commit the canvas is left blank: it is what blanked the
- * tree on a tree-area resize and the consensus tracks on a vertical zoom.
+ * `width`/`height` are the canvas backing store size (logical size times the
+ * high-res scale factor). Assigning either clears the bitmap, and React assigns
+ * them after the mobx reaction has drawn at the old size, so the effect redraws
+ * when they change.
  *
  * `deps` covers everything else the effect should re-subscribe on, matching a
  * normal useEffect dep array.

package/dist/useCanvasAutorun.js

@@ -2,17 +2,12 @@ import { useEffect, useRef } from 'react';
 import { autorun } from 'mobx';
 /**
  * Wires a canvas ref to a mobx autorun: grabs the 2d context once the canvas
- * mounts and re-runs `draw` whenever any observable it reads changes. Collapses
- * the getContext/null-guard/autorun-dispose boilerplate repeated by every canvas
- * block host.
+ * mounts and re-runs `draw` whenever any observable it reads changes.
  *
- * `width`/`height` are the canvas *backing store* size the caller renders onto
- * the element (logical size times the high-res scale factor), and they are load
- * bearing rather than informational. Assigning either resets the canvas bitmap,
- * and React assigns them on every commit where they changed -- which lands
- * *after* the mobx reaction that already redrew at the old size. Without a redraw
- * on the far side of that commit the canvas is left blank: it is what blanked the
- * tree on a tree-area resize and the consensus tracks on a vertical zoom.
+ * `width`/`height` are the canvas backing store size (logical size times the
+ * high-res scale factor). Assigning either clears the bitmap, and React assigns
+ * them after the mobx reaction has drawn at the old size, so the effect redraws
+ * when they change.
  *
  * `deps` covers everything else the effect should re-subscribe on, matching a
  * normal useEffect dep array.

package/dist/useCanvasAutorun.js.map

@@ -1 +1 @@
-{"version":3,"file":"useCanvasAutorun.js","sourceRoot":"","sources":["../src/useCanvasAutorun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAI9B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,GAML;IACC,MAAM,GAAG,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAA;IAC3C,8EAA8E;IAC9E,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO,GAAG;YACR,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBACX,IAAI,CAAC,GAAG,CAAC,CAAA;YACX,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAA;QACb,uDAAuD;IACzD,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5B,OAAO,GAAG,CAAA;AACZ,CAAC"}
+{"version":3,"file":"useCanvasAutorun.js","sourceRoot":"","sources":["../src/useCanvasAutorun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAI9B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,IAAI,EACJ,KAAK,EACL,MAAM,EACN,IAAI,GAML;IACC,MAAM,GAAG,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAA;IAC3C,8EAA8E;IAC9E,0EAA0E;IAC1E,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAA;QACzC,OAAO,GAAG;YACR,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBACX,IAAI,CAAC,GAAG,CAAC,CAAA;YACX,CAAC,CAAC;YACJ,CAAC,CAAC,SAAS,CAAA;QACb,uDAAuD;IACzD,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5B,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/useMsaSvgFigure.d.ts

@@ -0,0 +1,20 @@
+import type { MsaViewModel } from './model.ts';
+import type { Theme } from '@mui/material';
+export interface MsaSvgFigure {
+    /** the SVG document for what is on screen, once the first draw finishes */
+    svg?: string;
+    error?: unknown;
+}
+/**
+ * The viewer's SVG export of its viewport, as markup for the page to insert.
+ * It redraws after the view settles: `delay` ms after the last scroll, zoom,
+ * resize or change to the snapshot. A draw a later one overtakes is dropped.
+ *
+ * The figure's row names and letters are SVG text, so the browser's find
+ * locates them, a reader can select them, and print stylesheets apply.
+ */
+export declare function useMsaSvgFigure(model: MsaViewModel, { theme, includeTracks, delay, }?: {
+    theme?: Theme;
+    includeTracks?: boolean;
+    delay?: number;
+}): MsaSvgFigure;

package/dist/useMsaSvgFigure.js

@@ -0,0 +1,46 @@
+import { useEffect, useState } from 'react';
+import { createJBrowseTheme } from '@jbrowse/core/ui/theme';
+import { getSnapshot } from '@jbrowse/mobx-state-tree';
+import { compareStructural, reaction } from 'mobx';
+import { renderToSvg } from './renderToSvg.js';
+/**
+ * The viewer's SVG export of its viewport, as markup for the page to insert.
+ * It redraws after the view settles: `delay` ms after the last scroll, zoom,
+ * resize or change to the snapshot. A draw a later one overtakes is dropped.
+ *
+ * The figure's row names and letters are SVG text, so the browser's find
+ * locates them, a reader can select them, and print stylesheets apply.
+ */
+export function useMsaSvgFigure(model, { theme, includeTracks = false, delay = 300, } = {}) {
+    const [figure, setFigure] = useState({});
+    useEffect(() => {
+        let latest = 0;
+        const dispose = reaction(() => model.viewInitialized && model.dataInitialized
+            ? [getSnapshot(model), model.width, model.height]
+            : undefined, key => {
+            if (!key) {
+                return;
+            }
+            const draw = ++latest;
+            renderToSvg(model, {
+                theme: theme ?? createJBrowseTheme(),
+                exportType: 'viewport',
+                includeTracks,
+            }).then(svg => {
+                if (draw === latest) {
+                    setFigure({ svg });
+                }
+            }, (error) => {
+                if (draw === latest) {
+                    setFigure({ error });
+                }
+            });
+        }, { delay, fireImmediately: true, equals: compareStructural });
+        return () => {
+            latest = -1;
+            dispose();
+        };
+    }, [model, theme, includeTracks, delay]);
+    return figure;
+}
+//# sourceMappingURL=useMsaSvgFigure.js.map

package/dist/useMsaSvgFigure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMsaSvgFigure.js","sourceRoot":"","sources":["../src/useMsaSvgFigure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAA;AAW/C;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAmB,EACnB,EACE,KAAK,EACL,aAAa,GAAG,KAAK,EACrB,KAAK,GAAG,GAAG,GACZ,GAA+D,EAAE;IAElE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAe,EAAE,CAAC,CAAA;IACtD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,GAAG,CAAC,CAAA;QACd,MAAM,OAAO,GAAG,QAAQ,CACtB,GAAG,EAAE,CACH,KAAK,CAAC,eAAe,IAAI,KAAK,CAAC,eAAe;YAC5C,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;YACjD,CAAC,CAAC,SAAS,EACf,GAAG,CAAC,EAAE;YACJ,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,EAAE,MAAM,CAAA;YACrB,WAAW,CAAC,KAAK,EAAE;gBACjB,KAAK,EAAE,KAAK,IAAI,kBAAkB,EAAE;gBACpC,UAAU,EAAE,UAAU;gBACtB,aAAa;aACd,CAAC,CAAC,IAAI,CACL,GAAG,CAAC,EAAE;gBACJ,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;oBACpB,SAAS,CAAC,EAAE,GAAG,EAAE,CAAC,CAAA;gBACpB,CAAC;YACH,CAAC,EACD,CAAC,KAAc,EAAE,EAAE;gBACjB,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;oBACpB,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;gBACtB,CAAC;YACH,CAAC,CACF,CAAA;QACH,CAAC,EACD,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAC5D,CAAA;QACD,OAAO,GAAG,EAAE;YACV,MAAM,GAAG,CAAC,CAAC,CAAA;YACX,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,CAAA;IACxC,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/util.d.ts

@@ -1,11 +1,18 @@
 import type { Theme } from '@mui/material';
 export declare function adjustColorForContrast(color: string, bg: string): string;
+export declare function withAlpha(color: string, alpha: number): string;
+export declare function outlineColor(fill: string): string;
 export declare function transform<T>(obj: Record<string, T>, cb: (arg0: [string, T]) => [string, T]): {
     [k: string]: T;
 };
-export declare function colorContrast(colorScheme: Record<string, string>, theme: Theme): {
-    [k: string]: string;
-};
+/**
+ * Readable letter color over a given cell color, memoized per theme.
+ *
+ * Keyed by cell color, since a dynamic scheme has no letter->color table; this
+ * covers static schemes and a track's own `colors` too. An uncolored cell gets
+ * the theme's text color, which stays readable in the dark theme.
+ */
+export declare function contrastTextFn(theme: Theme): (color: string | undefined) => string;
 export declare function dropBlanks<T>(blanks: number[], arr: T[]): T[];
 export declare function skipBlanks(blanks: number[], str: string): string;
 export declare function computeRowInsertions(blanks: number[], seq: string): {
@@ -16,4 +23,3 @@ export declare function len(a: {
     end: number;
     start: number;
 }): number;
-export declare function isBlank(s?: string): s is "-" | ".";

package/dist/util.js

@@ -23,14 +23,46 @@ export function adjustColorForContrast(color, bg) {
     contrastAdjustCache.set(cacheKey, result);
     return result;
 }
+// a wash over the alignment or the tree: a color carrying its own alpha draws
+// at that alpha, and one with none takes `alpha` so the marks under it stay
+// readable
+export function withAlpha(color, alpha) {
+    const parsed = colord(color);
+    return parsed.alpha() === 1 ? parsed.alpha(alpha).toRgbString() : color;
+}
+export function outlineColor(fill) {
+    return colord(fill).darken(0.1).toHex();
+}
 export function transform(obj, cb) {
     return Object.fromEntries(Object.entries(obj).map(cb));
 }
-export function colorContrast(colorScheme, theme) {
-    return transform(colorScheme, ([letter, color]) => [
-        letter,
-        theme.palette.getContrastText(colord(color).toHex()),
-    ]);
+const contrastTextCaches = new WeakMap();
+/**
+ * Readable letter color over a given cell color, memoized per theme.
+ *
+ * Keyed by cell color, since a dynamic scheme has no letter->color table; this
+ * covers static schemes and a track's own `colors` too. An uncolored cell gets
+ * the theme's text color, which stays readable in the dark theme.
+ */
+export function contrastTextFn(theme) {
+    let cache = contrastTextCaches.get(theme);
+    if (!cache) {
+        cache = new Map();
+        contrastTextCaches.set(theme, cache);
+    }
+    const fallback = theme.palette.text.primary;
+    return (color) => {
+        if (!color) {
+            return fallback;
+        }
+        const hit = cache.get(color);
+        if (hit !== undefined) {
+            return hit;
+        }
+        const out = theme.palette.getContrastText(colord(color).toHex());
+        cache.set(color, out);
+        return out;
+    };
 }
 export function dropBlanks(blanks, arr) {
     if (blanks.length === 0) {
@@ -95,9 +127,4 @@ export function computeRowInsertions(blanks, seq) {
 export function len(a) {
     return a.end - a.start;
 }
-// https://sonnhammer.sbc.su.se/Stockholm.html
-// gaps can be a . or - in stockholm
-export function isBlank(s) {
-    return s === '-' || s === '.';
-}
 //# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const version = "6.5.0";
+export declare const version = "8.0.0";

package/dist/version.js

@@ -1,2 +1,2 @@
-export const version = '6.5.0';
+export const version = '8.0.0';
 //# sourceMappingURL=version.js.map

package/dist/wuss.d.ts

@@ -0,0 +1,14 @@
+export interface BasePair {
+    /** 0-based column */
+    start: number;
+    /** 0-based column */
+    end: number;
+    /** the pair crosses a helix rather than nesting inside one */
+    pseudoknot: boolean;
+}
+/**
+ * The base pairs a WUSS string encodes, as 0-based column indexes. Unmatched
+ * brackets are dropped rather than throwing: a hand-edited or truncated
+ * alignment should still draw the helices it does close.
+ */
+export declare function parseWuss(ss: string): BasePair[];