react-msaview 9.2.0 → 9.3.0

package/dist/scales.js

@@ -1,30 +1,165 @@
+import { colord } from 'colord';
 import { createPaletteMap } from './createPaletteMap.js';
 import { paletteNamed } from './ggplotPalettes.js';
+import { compareGroupKeys } from './groupKeys.js';
 /**
- * The scale a channel reads its field through. `values` are the field's values,
- * in any order and with repeats; the domain is their distinct values sorted, so
- * a value keeps its color when rows are re-ordered, collapsed or filtered.
+ * The colors a `range` lists, read the way jbrowse-components'
+ * `paletteFromSpec` reads a string: a palette name gives undefined here, and a
+ * comma-separated list of colors gives the list
+ */
+function rangeList(range) {
+    if (typeof range !== 'string') {
+        return range;
+    }
+    if (paletteNamed(range)) {
+        return undefined;
+    }
+    const colors = range.split(/,(?![^(]*\))/).map(c => c.trim());
+    return colors.every(c => colord(c).isValid()) ? colors : undefined;
+}
+function rangeColors(range, order) {
+    const list = rangeList(range);
+    return list
+        ? new Map(order.slice(0, list.length).map((value, i) => [value, list[i]]))
+        : new Map(Object.entries(createPaletteMap(order, paletteNamed(typeof range === 'string' ? range : undefined))));
+}
+/**
+ * The scale a channel reads its field through. `values` are the field's
+ * values, in any order and with repeats. The domain lists the values `domain`
+ * names first, then the rest in natural order, so a value keeps its color when
+ * rows are re-ordered, collapsed or filtered.
  *
- * `{map}` colors the values the producer named and leaves the rest uncolored.
- * `{palette}` takes the colors of a named palette, and a spec with neither
- * takes the ggplot palette of the domain's size. Every scale is categorical
- * today; a continuous one waits for a caller.
+ * A palette name, or no `range` at all, colors every value: past the end of
+ * the palette each takes an evenly spaced hue. A list of colors leaves the
+ * values past its end uncolored, so `{domain, range}` colors the values it
+ * names and no others.
  */
 export function resolveScale(spec, values) {
-    const domain = [...new Set(values)].sort((a, b) => a.localeCompare(b));
-    const { map, palette } = spec ?? {};
-    const colors = map ?? createPaletteMap(domain, paletteNamed(palette));
-    const present = new Set(domain);
-    const labels = map ? Object.keys(map).filter(v => present.has(v)) : domain;
+    const present = new Set(values);
+    const listed = new Set(spec?.domain);
+    const order = [
+        ...listed,
+        ...[...present].filter(v => !listed.has(v)).sort(compareGroupKeys),
+    ];
+    const colors = rangeColors(spec?.range, order);
     return {
         kind: 'categorical',
-        colorOf: (value) => colors[value],
-        // a categorical value is its own label, and the id a legend keys on
-        legend: labels.map(value => ({
-            id: value,
-            label: value,
-            color: colors[value],
-        })),
+        colorOf: (value) => colors.get(value),
+        legend: order
+            .filter(value => present.has(value) && colors.has(value))
+            .map(value => ({ id: value, label: value, color: colors.get(value) })),
+    };
+}
+/**
+ * The key records share a scale under: the table and the members as declared,
+ * with `title` standing in for the field. Two strips over one palette with no
+ * title read two fields and list two legends; naming one title gives them one
+ * scale and one legend.
+ */
+export function declarationKey({ spec, field, table, }) {
+    const { scale = 'categorical', domain, range, title = field } = spec;
+    return JSON.stringify([table, scale, domain, range, title]);
+}
+/**
+ * Resolves each declaration once over the union of its records' values, so a
+ * value two fields share takes one color in both
+ */
+export function resolveShared(uses) {
+    const groups = new Map();
+    for (const use of uses) {
+        const key = declarationKey(use);
+        groups.set(key, [...(groups.get(key) ?? []), use]);
+    }
+    return new Map([...groups].map(([key, group]) => {
+        const { spec, field } = group[0];
+        const resolved = resolveScale(spec, group.flatMap(u => u.values));
+        const shown = group[0].shown
+            ? new Set(group.flatMap(u => u.shown ?? []))
+            : undefined;
+        const scale = {
+            ...resolved,
+            key,
+            title: spec.title ?? field,
+            legend: shown
+                ? resolved.legend.filter(entry => shown.has(entry.id))
+                : resolved.legend,
+        };
+        return [key, scale];
+    }));
+}
+/**
+ * Lifts the earlier spelling onto the color object: `{palette: p}` reads as
+ * `{range: p}`, `{map: m}` as `{domain: keys(m), range: values(m)}`, and a
+ * strip's `legend` as `title`. A member written in the new spelling wins.
+ */
+export function readColor(record) {
+    const { scale, legend, ...rest } = record;
+    if (typeof scale !== 'object' && legend === undefined) {
+        return record;
+    }
+    const lifted = typeof scale !== 'object'
+        ? scale === undefined
+            ? {}
+            : { scale }
+        : scale.map
+            ? { domain: Object.keys(scale.map), range: Object.values(scale.map) }
+            : scale.palette === undefined
+                ? {}
+                : { range: scale.palette };
+    return {
+        ...(legend === undefined ? {} : { title: legend }),
+        ...lifted,
+        ...rest,
+    };
+}
+export function readEncoding(encoding) {
+    return readColor(encoding);
+}
+export function readRowPanel(panel) {
+    if (panel.kind === 'strip') {
+        return readColor(panel);
+    }
+    const color = panel.encoding?.color;
+    return (color
+        ? { ...panel, encoding: { ...panel.encoding, color: readColor(color) } }
+        : panel);
+}
+/**
+ * Lifts a column track's `colors` onto `encoding.color` and its `max` onto
+ * `scales.y.domainMax`
+ */
+export function readColumnTrack(track) {
+    const { max, colors, ...rest } = track;
+    if (max === undefined && colors === undefined) {
+        return track;
+    }
+    return {
+        ...(colors
+            ? {
+                encoding: {
+                    color: {
+                        domain: Object.keys(colors),
+                        range: Object.values(colors),
+                    },
+                },
+            }
+            : {}),
+        ...(max === undefined ? {} : { scales: { y: { domainMax: max } } }),
+        ...rest,
     };
 }
+/**
+ * The color a color object gives each value listed, for a reader that keys
+ * colors by value, such as the residue letters of a scheme or a text track
+ */
+export function colorTable(spec, values) {
+    return Object.fromEntries(resolveScale(spec, values).legend.map(e => [e.id, e.color]));
+}
+/**
+ * The letter-to-color table an object `colorScheme` gives, `{domain, range}`
+ * or the earlier `{map}`
+ */
+export function letterColors(scheme) {
+    return 'map' in scheme ? scheme.map : colorTable(scheme, scheme.domain ?? []);
+}
 //# sourceMappingURL=scales.js.map

package/dist/scales.js.map

@@ -1 +1 @@
-{"version":3,"file":"scales.js","sourceRoot":"","sources":["../src/scales.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAgBlD;;;;;;;;;GASG;AACH,MAAM,UAAU,YAAY,CAC1B,IAA2B,EAC3B,MAAwB;IAExB,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,IAAI,EAAE,CAAA;IACnC,MAAM,MAAM,GAAG,GAAG,IAAI,gBAAgB,CAAC,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;IACrE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;IAC1E,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;QACzC,oEAAoE;QACpE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3B,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK,CAAE;SACtB,CAAC,CAAC;KACJ,CAAA;AACH,CAAC"}
+{"version":3,"file":"scales.js","sourceRoot":"","sources":["../src/scales.ts"],"names":[],"mappings":"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"}

package/dist/svgTestUtil.d.ts

@@ -365,7 +365,7 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     showOnly: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
     turnedOffTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<boolean>>, [undefined]>;
     trackHeights: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<number>>, [undefined]>;
-    columnTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec>>, [undefined]>;
+    columnTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec>, import("./types.ts").ColumnTrackSpec, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
     residueMappings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ResidueMapping, import("./types.ts").ResidueMapping, import("./types.ts").ResidueMapping>>, [undefined]>;
     data: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IModelType<{
         tree: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
@@ -388,8 +388,8 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     selection: import("@jbrowse/mobx-state-tree").IType<import("./types.ts").MsaSelection | undefined, import("./types.ts").MsaSelection | undefined, import("./types.ts").MsaSelection | undefined>;
     region: import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Region | undefined, import("./types.ts").Region | undefined, import("./types.ts").Region | undefined>;
     clades: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Clade, import("./types.ts").Clade, import("./types.ts").Clade>>, [undefined]>;
-    encodings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Encoding, import("./types.ts").Encoding, import("./types.ts").Encoding>>, [undefined]>;
-    rowPanels: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec>>, [undefined]>;
+    encodings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Encoding, import("./types.ts").Encoding, import("./types.ts").Encoding>, import("./types.ts").Encoding | import("./scales.ts").LegacyEncoding, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
+    rowPanels: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec>, import("./scales.ts").LegacyRowPanel | import("./types.ts").RowPanelSpec, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
 }> & {
     queueOfDialogs: [import("@jbrowse/core/util").DialogComponentType, any][];
 } & {
@@ -713,10 +713,10 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     applyGFFText(gffText: string): void;
     doScrollX(deltaX: number): void;
     setScrollX(n: number): void;
-    setColumnTracks(tracks: import("./types.ts").ColumnTrackSpec[]): void;
+    setColumnTracks(tracks: (import("./types.ts").ColumnTrackSpec | import("./scales.ts").LegacyColumnTrack)[]): void;
     setRowData(rowData: import("./types.ts").RowDataInput): void;
-    setEncodings(encodings: import("./types.ts").Encoding[]): void;
-    setRowPanels(panels: import("./types.ts").RowPanelSpec[]): void;
+    setEncodings(encodings: (import("./types.ts").Encoding | import("./scales.ts").LegacyEncoding)[]): void;
+    setRowPanels(panels: (import("./types.ts").RowPanelSpec | import("./scales.ts").LegacyRowPanel)[]): void;
     setResidueMappings(mappings: import("./types.ts").ResidueMapping[]): void;
     toggleTrack(id: string): void;
     setTracksShown(ids: string[], shown: boolean): void;
@@ -775,9 +775,12 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
         rowData: Record<string, string> | undefined;
     };
     readonly resolvedEncodings: import("./types.ts").ResolvedEncoding[];
+    readonly resolvedScales: Map<string, import("./scales.ts").SharedScale>;
+    scaleOf(channel: import("./scales.ts").ColorChannel, table: import("./scales.ts").ScaleTable): import("./scales.ts").SharedScale;
     readonly rowPanelScales: ({
         header: string;
         legend: import("./types.ts").LegendEntry[];
+        legendKey?: string;
         legendTitle?: string;
         kind: 'strip';
         field: string;
@@ -785,6 +788,7 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     } | {
         header: string;
         legend: import("./types.ts").LegendEntry[];
+        legendKey?: string;
         legendTitle?: string;
         kind: 'features';
         x: 'column' | 'position';
@@ -1189,7 +1193,7 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     showOnly: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
     turnedOffTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<boolean>>, [undefined]>;
     trackHeights: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IMapType<import("@jbrowse/mobx-state-tree").ISimpleType<number>>, [undefined]>;
-    columnTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec>>, [undefined]>;
+    columnTracks: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec, import("./types.ts").ColumnTrackSpec>, import("./types.ts").ColumnTrackSpec, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
     residueMappings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").ResidueMapping, import("./types.ts").ResidueMapping, import("./types.ts").ResidueMapping>>, [undefined]>;
     data: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IModelType<{
         tree: import("@jbrowse/mobx-state-tree").IMaybe<import("@jbrowse/mobx-state-tree").ISimpleType<string>>;
@@ -1212,8 +1216,8 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     selection: import("@jbrowse/mobx-state-tree").IType<import("./types.ts").MsaSelection | undefined, import("./types.ts").MsaSelection | undefined, import("./types.ts").MsaSelection | undefined>;
     region: import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Region | undefined, import("./types.ts").Region | undefined, import("./types.ts").Region | undefined>;
     clades: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Clade, import("./types.ts").Clade, import("./types.ts").Clade>>, [undefined]>;
-    encodings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Encoding, import("./types.ts").Encoding, import("./types.ts").Encoding>>, [undefined]>;
-    rowPanels: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec>>, [undefined]>;
+    encodings: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").Encoding, import("./types.ts").Encoding, import("./types.ts").Encoding>, import("./types.ts").Encoding | import("./scales.ts").LegacyEncoding, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
+    rowPanels: import("@jbrowse/mobx-state-tree").IOptionalIType<import("@jbrowse/mobx-state-tree").IArrayType<import("@jbrowse/mobx-state-tree").ISnapshotProcessor<import("@jbrowse/mobx-state-tree").IType<import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec, import("./types.ts").RowPanelSpec>, import("./scales.ts").LegacyRowPanel | import("./types.ts").RowPanelSpec, import("@jbrowse/mobx-state-tree")._NotCustomized>>, [undefined]>;
 }, {
     queueOfDialogs: [import("@jbrowse/core/util").DialogComponentType, any][];
 } & {
@@ -1537,10 +1541,10 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     applyGFFText(gffText: string): void;
     doScrollX(deltaX: number): void;
     setScrollX(n: number): void;
-    setColumnTracks(tracks: import("./types.ts").ColumnTrackSpec[]): void;
+    setColumnTracks(tracks: (import("./types.ts").ColumnTrackSpec | import("./scales.ts").LegacyColumnTrack)[]): void;
     setRowData(rowData: import("./types.ts").RowDataInput): void;
-    setEncodings(encodings: import("./types.ts").Encoding[]): void;
-    setRowPanels(panels: import("./types.ts").RowPanelSpec[]): void;
+    setEncodings(encodings: (import("./types.ts").Encoding | import("./scales.ts").LegacyEncoding)[]): void;
+    setRowPanels(panels: (import("./types.ts").RowPanelSpec | import("./scales.ts").LegacyRowPanel)[]): void;
     setResidueMappings(mappings: import("./types.ts").ResidueMapping[]): void;
     toggleTrack(id: string): void;
     setTracksShown(ids: string[], shown: boolean): void;
@@ -1599,9 +1603,12 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
         rowData: Record<string, string> | undefined;
     };
     readonly resolvedEncodings: import("./types.ts").ResolvedEncoding[];
+    readonly resolvedScales: Map<string, import("./scales.ts").SharedScale>;
+    scaleOf(channel: import("./scales.ts").ColorChannel, table: import("./scales.ts").ScaleTable): import("./scales.ts").SharedScale;
     readonly rowPanelScales: ({
         header: string;
         legend: import("./types.ts").LegendEntry[];
+        legendKey?: string;
         legendTitle?: string;
         kind: 'strip';
         field: string;
@@ -1609,6 +1616,7 @@ export declare function createTestModel(snapshot: Omit<Snapshot, 'type'>, width?
     } | {
         header: string;
         legend: import("./types.ts").LegendEntry[];
+        legendKey?: string;
         legendTitle?: string;
         kind: 'features';
         x: 'column' | 'position';

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { ResolvedScale, ScaleSpec } from './scales.ts';
+import type { ColorChannel, ColorSpec, SharedScale } from './scales.ts';
 import type { Annotation } from 'msa-parsers';
 export interface Accession {
     accession: string;
@@ -13,11 +13,14 @@ export type TrackKind = 'text' | 'bar' | 'logo' | 'arc' | 'ruler' | 'reference';
  */
 export type ResidueEncoding = 'fill' | 'color';
 /**
- * The residue colors: a scheme name from the built-in table, or a scale's
- * `{map}` of letter to color, which leaves every letter it does not list
- * uncolored
+ * The residue colors: a scheme name from the built-in table, or a color object
+ * over residue letters, `{domain: ['K', 'R'], range: ['#1f77b4', '#1f77b4']}`,
+ * which leaves every letter it does not list uncolored
  */
-export type ColorScheme = string | Required<Pick<ScaleSpec, 'map'>>;
+export type ColorScheme = string | Pick<ColorSpec, 'domain' | 'range'> | {
+    /** @deprecated the earlier spelling of `{domain, range}` */
+    map: Record<string, string>;
+};
 export interface BasicTrackModel {
     id: string;
     name: string;
@@ -56,33 +59,33 @@ export interface ColumnTrackSpec {
     values?: number[];
     data?: string;
     arcs?: ArcSpec[];
-    max?: number;
     color?: string;
-    colors?: Record<string, string>;
+    encoding?: {
+        color?: ColorSpec;
+    };
+    scales?: {
+        y?: {
+            domainMax?: number;
+        };
+    };
     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.
+ * A strip panel: one cell per row, colored from a `rowData` field through the
+ * color object's members, 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. Strips declaring the same members and `title` share one scale
+ * and one legend.
  */
-export interface RowStripSpec {
+export interface RowStripSpec extends ColorChannel {
     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;
-    };
+    color?: ColorChannel;
     label?: string;
 }
 /**
@@ -120,7 +123,8 @@ interface ResolvedPanelBase {
     width: number;
     offsetX: number;
     legend: LegendEntry[];
-    /** the legend this panel's entries go under; absent means the domain key */
+    /** the scale this panel's entries list under; absent means the domain key */
+    legendKey?: string;
     legendTitle?: string;
 }
 /**
@@ -411,16 +415,14 @@ export type RowDataInput = Record<string, Record<string, string | number | boole
  */
 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
+ * A channel, the field feeding it, and the color object's members it reads
+ * that field through. See docs/layers.md
  */
-export interface Encoding {
+export interface Encoding extends ColorChannel {
     channel: EncodingChannel;
-    field: string;
-    scale?: ScaleSpec;
 }
 /** an Encoding with its scale resolved against the values in the table */
-export type ResolvedEncoding = Encoding & ResolvedScale;
+export type ResolvedEncoding = Encoding & SharedScale;
 /** a Highlight resolved to visible column indices and row indices */
 export interface ResolvedHighlight {
     startCol?: number;

package/dist/useDragScroll.d.ts

@@ -1,6 +1,7 @@
 /**
- * Tracks a mouse drag along a single axis and reports the scroll delta on each
- * animation frame. Shared by the horizontal Minimap and the VerticalScrollbar.
+ * Tracks a pointer drag along a single axis and reports the scroll delta on
+ * each animation frame. Shared by the horizontal Minimap, the VerticalScrollbar
+ * and the dividers.
  *
  * `onScroll` is invoked with the pixel delta since drag start and the scroll
  * offset captured when the drag began. Memoize it (useCallback) so the document
@@ -8,5 +9,5 @@
  */
 export declare function useDragScroll(axis: 'x' | 'y', onScroll: (delta: number, startScroll: number) => void): {
     dragging: boolean;
-    startDrag: (event: React.MouseEvent, startScroll: number) => void;
+    startDrag: (event: React.PointerEvent, startScroll: number) => void;
 };

package/dist/useDragScroll.js

@@ -1,7 +1,8 @@
 import { useEffect, useRef, useState } from 'react';
 /**
- * Tracks a mouse drag along a single axis and reports the scroll delta on each
- * animation frame. Shared by the horizontal Minimap and the VerticalScrollbar.
+ * Tracks a pointer drag along a single axis and reports the scroll delta on
+ * each animation frame. Shared by the horizontal Minimap, the VerticalScrollbar
+ * and the dividers.
  *
  * `onScroll` is invoked with the pixel delta since drag start and the scroll
  * offset captured when the drag began. Memoize it (useCallback) so the document
@@ -26,11 +27,13 @@ export function useDragScroll(axis, onScroll) {
             function onUp() {
                 setMouseDown(undefined);
             }
-            document.addEventListener('mousemove', onMove);
-            document.addEventListener('mouseup', onUp);
+            document.addEventListener('pointermove', onMove);
+            document.addEventListener('pointerup', onUp);
+            document.addEventListener('pointercancel', onUp);
             return () => {
-                document.removeEventListener('mousemove', onMove);
-                document.removeEventListener('mouseup', onUp);
+                document.removeEventListener('pointermove', onMove);
+                document.removeEventListener('pointerup', onUp);
+                document.removeEventListener('pointercancel', onUp);
             };
         }
     }, [axis, onScroll, mouseDown]);

package/dist/useDragScroll.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDragScroll.js","sourceRoot":"","sources":["../src/useDragScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,QAAsD;IAEtD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,EAGtC,CAAA;IAEJ,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;YACtD,SAAS,MAAM,CAAC,KAAiB;gBAC/B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBACvB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;oBACxB,qBAAqB,CAAC,GAAG,EAAE;wBACzB,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;wBAC3D,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,WAAW,CAAC,CAAA;wBAC3C,SAAS,CAAC,OAAO,GAAG,KAAK,CAAA;oBAC3B,CAAC,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YACD,SAAS,IAAI;gBACX,YAAY,CAAC,SAAS,CAAC,CAAA;YACzB,CAAC;YACD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;YAC9C,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAC1C,OAAO,GAAG,EAAE;gBACV,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;gBACjD,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;YAC/C,CAAC,CAAA;QACH,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;IAE/B,OAAO;QACL,QAAQ,EAAE,SAAS,KAAK,SAAS;QACjC,SAAS,EAAE,CAAC,KAAuB,EAAE,WAAmB,EAAE,EAAE;YAC1D,YAAY,CAAC;gBACX,MAAM,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACpD,WAAW;aACZ,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"useDragScroll.js","sourceRoot":"","sources":["../src/useDragScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEnD;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,QAAsD;IAEtD,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAC/B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,EAGtC,CAAA;IAEJ,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,SAAS,CAAA;YACtD,SAAS,MAAM,CAAC,KAAmB;gBACjC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;oBACvB,SAAS,CAAC,OAAO,GAAG,IAAI,CAAA;oBACxB,qBAAqB,CAAC,GAAG,EAAE;wBACzB,MAAM,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;wBAC3D,QAAQ,CAAC,MAAM,GAAG,WAAW,EAAE,WAAW,CAAC,CAAA;wBAC3C,SAAS,CAAC,OAAO,GAAG,KAAK,CAAA;oBAC3B,CAAC,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YACD,SAAS,IAAI;gBACX,YAAY,CAAC,SAAS,CAAC,CAAA;YACzB,CAAC;YACD,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;YAChD,QAAQ,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;YAC5C,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;YAChD,OAAO,GAAG,EAAE;gBACV,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;gBACnD,QAAQ,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAA;gBAC/C,QAAQ,CAAC,mBAAmB,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;YACrD,CAAC,CAAA;QACH,CAAC;IACH,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAA;IAE/B,OAAO;QACL,QAAQ,EAAE,SAAS,KAAK,SAAS;QACjC,SAAS,EAAE,CAAC,KAAyB,EAAE,WAAmB,EAAE,EAAE;YAC5D,YAAY,CAAC;gBACX,MAAM,EAAE,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACpD,WAAW;aACZ,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/useWheelScroll.d.ts

@@ -1,12 +1,30 @@
-export declare function useWheelScroll({ ref, onScrollX, onScrollY, onZoom, onZoomSettle, onWheelScroll, scrollZoom, }: {
+import type { MsaViewModel } from './model.ts';
+type Axes = 'x' | 'y' | 'xy';
+/**
+ * Whether a vertical wheel `delta` moves a view at `scrollY`. At the top or
+ * bottom, or when every row fits, the page scrolls instead, so an embedded
+ * viewer never traps the reader scrolling past it.
+ */
+export declare function canScrollY(model: MsaViewModel, delta: number): boolean;
+/**
+ * The CSS touch-action for a pannable area: the browser keeps a touch pan
+ * along every axis the view cannot scroll, and pinch zoom on the page where it
+ * supports that value.
+ */
+export declare function panTouchAction(model: MsaViewModel, axes: Axes): string;
+/**
+ * Wheel scrolling, wheel zoom and pointer-drag panning of `model` over `ref`,
+ * along `axes`. The returned `onPointerDown` starts a pan with a mouse, a pen
+ * or a finger; put `touchAction` on the same element.
+ */
+export declare function useWheelScroll({ ref, model, axes, zoom, onWheelScroll, }: {
     ref: React.RefObject<HTMLDivElement | null>;
-    onScrollX?: (delta: number) => void;
-    onScrollY?: (delta: number) => void;
-    onZoom?: (scaleFactor: number, offsetX: number, offsetY: number) => void;
-    onZoomSettle?: () => void;
+    model: MsaViewModel;
+    axes: Axes;
+    zoom?: boolean;
     onWheelScroll?: (event: WheelEvent) => void;
-    scrollZoom?: boolean;
 }): {
-    onMouseDown: (event: React.MouseEvent) => void;
-    onMouseUp: (event: React.MouseEvent) => void;
+    onPointerDown: (event: React.PointerEvent) => void;
+    touchAction: string;
 };
+export {};