react-cheminfo 0.15.0 → 0.16.0

package/lib/parallel/core/parallelTypes.d.ts

@@ -0,0 +1,129 @@
+/**
+ * What a parallel-coordinates figure is asked to draw: one axis per column,
+ * the intervals the reader brushed on them, and the quantity the lines are
+ * coloured by.
+ *
+ * The figure itself is index-based — every axis hands over its column as an
+ * `ArrayLike<number>` read in place — so a repaint costs an indexed read per
+ * value rather than a call. {@link parallelAxisOf} is the one place a row type
+ * is named, and it is run once per data change rather than once per repaint.
+ */
+import type { ColorScale } from '../../color/core/interpolate.ts';
+/** How a value is placed along an axis. */
+export type ParallelAxisScale = 'linear' | 'log';
+/** One labelled graduation a caller writes itself. */
+export interface ParallelTick {
+    /** Where it sits, in the axis's own units. */
+    value: number;
+    /** What is written beside it. */
+    label: string;
+}
+/** One vertical axis of a parallel-coordinates figure, and the column it draws. */
+export interface ParallelAxis {
+    /**
+     * A stable key, which is how a brushed range is reported and how a caller
+     * names the axis the colour is read from. Never an index: axes are added and
+     * reordered, and a range keyed on a position outlives the axis it belonged
+     * to.
+     */
+    id: string;
+    /** What it is called, written over the axis. */
+    label: string;
+    /**
+     * Every row's value, in the figure's row order. Read in place — nothing is
+     * copied — so a `Float64Array` is the cheapest thing to pass.
+     */
+    values: ArrayLike<number>;
+    /**
+     * The two ends of the axis, low first. Left out, they are the column's own
+     * smallest and largest finite value, and a column with no spread at all is
+     * opened by half a unit on each side so that it still draws.
+     * @default undefined — the column's own range
+     */
+    domain?: readonly [number, number];
+    /**
+     * How values are placed between the ends. `log` needs a domain whose low end
+     * is above zero; a value at or below zero is pinned to the low end.
+     * @default 'linear'
+     */
+    scale?: ParallelAxisScale;
+    /**
+     * How a tick is written. Left out, the ticks carry as many decimals as the
+     * spacing needs.
+     * @default undefined
+     */
+    format?: (value: number) => string;
+    /**
+     * The graduations, written out by the caller — what a coded quantity needs,
+     * where `0`, `1`, `2` should read `none`, `low`, `high`.
+     * @default undefined — the figure graduates the axis itself
+     */
+    ticks?: readonly ParallelTick[];
+    /**
+     * Roughly how many graduations to aim for, when the figure picks them.
+     * @default 5
+     */
+    tickCount?: number;
+    /**
+     * Whether the ends are rounded outward to whole tick steps. Off, so the axis
+     * ends exactly on the data — a reader comparing two molecules on a drug
+     * score must see the best one touch the top of its axis, not float below a
+     * round number nothing reached.
+     * @default false
+     */
+    nice?: boolean;
+    /**
+     * The unit written after the axis name, e.g. `g/mol`.
+     * @default '' — nothing is written
+     */
+    unit?: string;
+}
+/** An interval kept on one axis, in that axis's own units, low first. */
+export type ParallelRange = readonly [number, number];
+/** Which rows a set of brushes keeps, keyed by axis id. */
+export type ParallelRanges = Readonly<Record<string, ParallelRange | null>>;
+/** How the lines are coloured. */
+export interface ParallelColorBy {
+    /** The quantity read for each row, in the figure's row order. */
+    values: ArrayLike<number>;
+    /**
+     * The value at the low end of the ramp.
+     * @default the smallest finite value
+     */
+    min?: number;
+    /**
+     * The value at its high end.
+     * @default the largest finite value
+     */
+    max?: number;
+    /**
+     * The ramp, as the registry hands it over or as a plain list of colours.
+     * @default viridis — `resolveColorScale(DEFAULT_COLOR_SCALE_ID).scale`
+     */
+    scale?: ColorScale | readonly string[];
+    /**
+     * Whether the quantity is read on a base-10 logarithmic ramp.
+     * @default false
+     */
+    logarithmic?: boolean;
+}
+/** An axis described by the field to read off each row, rather than by its column. */
+export type ParallelAxisSource<Row> = Omit<ParallelAxis, 'values'> & {
+    /**
+     * The value this axis reads off one row. Called once per row per data
+     * change, never per repaint.
+     */
+    readonly value: (row: Row) => number;
+};
+/**
+ * One axis built by reading a field off each row.
+ *
+ * The one place a row type is named: the figure itself reads numbers out of a
+ * typed array, so a repaint costs an indexed read rather than a call per
+ * value. Call it inside a `useMemo` keyed on the rows.
+ * @param rows - The rows, in the order the figure will index them.
+ * @param axis - The axis, with the field to read instead of its values.
+ * @returns The axis, with its values filled in.
+ */
+export declare function parallelAxisOf<Row>(rows: readonly Row[], axis: ParallelAxisSource<Row>): ParallelAxis;
+//# sourceMappingURL=parallelTypes.d.ts.map

package/lib/parallel/core/parallelTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallelTypes.d.ts","sourceRoot":"","sources":["../../../src/parallel/core/parallelTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEjD,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B;;;;;OAKG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACnC;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yEAAyE;AACzE,MAAM,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC,CAAC,CAAC;AAE5E,kCAAkC;AAClC,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC1B;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,CAAC;IACvC;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,MAAM,kBAAkB,CAAC,GAAG,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,GAAG;IACnE;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC;CACtC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAChC,IAAI,EAAE,SAAS,GAAG,EAAE,EACpB,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAC5B,YAAY,CAOd"}

package/lib/parallel/core/parallelTypes.js

@@ -0,0 +1,29 @@
+/**
+ * What a parallel-coordinates figure is asked to draw: one axis per column,
+ * the intervals the reader brushed on them, and the quantity the lines are
+ * coloured by.
+ *
+ * The figure itself is index-based — every axis hands over its column as an
+ * `ArrayLike<number>` read in place — so a repaint costs an indexed read per
+ * value rather than a call. {@link parallelAxisOf} is the one place a row type
+ * is named, and it is run once per data change rather than once per repaint.
+ */
+/**
+ * One axis built by reading a field off each row.
+ *
+ * The one place a row type is named: the figure itself reads numbers out of a
+ * typed array, so a repaint costs an indexed read rather than a call per
+ * value. Call it inside a `useMemo` keyed on the rows.
+ * @param rows - The rows, in the order the figure will index them.
+ * @param axis - The axis, with the field to read instead of its values.
+ * @returns The axis, with its values filled in.
+ */
+export function parallelAxisOf(rows, axis) {
+    const { value, ...rest } = axis;
+    const values = new Float64Array(rows.length);
+    for (let row = 0; row < rows.length; row++) {
+        values[row] = value(rows[row]);
+    }
+    return { ...rest, values };
+}
+//# sourceMappingURL=parallelTypes.js.map

package/lib/parallel/core/parallelTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallelTypes.js","sourceRoot":"","sources":["../../../src/parallel/core/parallelTypes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqHH;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAoB,EACpB,IAA6B;IAE7B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAQ,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/lib/parallel/ui/ParallelAxesLayer.d.ts

@@ -0,0 +1,28 @@
+import type { ReactElement } from 'react';
+import type { ParallelAxisLayout } from '../core/parallelAxes.ts';
+import type { ParallelBand } from '../core/parallelBrush.ts';
+/** What {@link ParallelAxesLayer} draws. */
+export interface ParallelAxesLayerProps {
+    /** The axes, from left to right, already placed and graduated. */
+    layouts: readonly ParallelAxisLayout[];
+    /** Height of the drawing area, in pixels. */
+    innerHeight: number;
+    /** The band each axis carries right now, the one being dragged included. */
+    bands: ReadonlyMap<string, ParallelBand>;
+    /** The ink the axes, their ticks and their labels are drawn in. */
+    axisInk: string;
+    /** The ink a band is filled and outlined in. */
+    bandInk: string;
+}
+/**
+ * The axes, their graduations and the intervals brushed on them.
+ *
+ * Every axis carries a `data-parallel-brush` rectangle over the strip a press
+ * on it reaches, which nothing points at: one surface over the whole figure
+ * takes every event, so the rectangle exists to be found — by a test driving
+ * a drag, and by a reader's eye, which is the same thing.
+ * @param props - See {@link ParallelAxesLayerProps}.
+ * @returns The axes.
+ */
+export declare function ParallelAxesLayer(props: ParallelAxesLayerProps): ReactElement;
+//# sourceMappingURL=ParallelAxesLayer.d.ts.map

package/lib/parallel/ui/ParallelAxesLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelAxesLayer.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelAxesLayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAY7D,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAmD7E"}

package/lib/parallel/ui/ParallelAxesLayer.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { PARALLEL_MARGIN, parallelValueToY } from "../core/parallelAxes.js";
+import { PARALLEL_BRUSH_HALF_WIDTH } from "../core/parallelBrush.js";
+import { PARALLEL_HANDLE_HEIGHT, PARALLEL_TICK_LABEL_INSET, PARALLEL_TICK_LABEL_STYLE, PARALLEL_TICK_LENGTH, parallelBandStyle, parallelHandleStyle, } from "./parallelStyles.js";
+/**
+ * The axes, their graduations and the intervals brushed on them.
+ *
+ * Every axis carries a `data-parallel-brush` rectangle over the strip a press
+ * on it reaches, which nothing points at: one surface over the whole figure
+ * takes every event, so the rectangle exists to be found — by a test driving
+ * a drag, and by a reader's eye, which is the same thing.
+ * @param props - See {@link ParallelAxesLayerProps}.
+ * @returns The axes.
+ */
+export function ParallelAxesLayer(props) {
+    const { layouts, innerHeight, bands, axisInk, bandInk } = props;
+    const stroke = { stroke: axisInk };
+    return (_jsx("g", { transform: `translate(${PARALLEL_MARGIN.left},${PARALLEL_MARGIN.top})`, style: { fill: axisInk }, textAnchor: "middle", children: layouts.map((layout) => {
+            const band = bands.get(layout.id) ?? null;
+            return (_jsxs("g", { className: "parallel-axis", "data-parallel-axis": layout.id, transform: `translate(${layout.x},0)`, children: [_jsx("line", { y2: innerHeight, style: stroke }), layout.ticks.map((tick) => (_jsxs("g", { transform: `translate(0,${parallelValueToY(tick.value, layout)})`, children: [_jsx("line", { x1: -PARALLEL_TICK_LENGTH, style: stroke }), _jsx("text", { x: -PARALLEL_TICK_LABEL_INSET, dy: "0.32em", textAnchor: "end", style: PARALLEL_TICK_LABEL_STYLE, children: tick.label })] }, tick.value))), _jsx("rect", { "data-parallel-brush": layout.id, x: -PARALLEL_BRUSH_HALF_WIDTH, y: 0, width: PARALLEL_BRUSH_HALF_WIDTH * 2, height: Math.max(0, innerHeight), fill: "transparent", pointerEvents: "none" }), band === null ? null : _jsx(BrushBand, { band: band, ink: bandInk })] }, layout.id));
+        }) }));
+}
+function BrushBand(props) {
+    const { band, ink } = props;
+    const height = Math.max(0, band.bottom - band.top);
+    const width = PARALLEL_BRUSH_HALF_WIDTH * 2;
+    return (_jsxs("g", { className: "parallel-axis-band", pointerEvents: "none", children: [_jsx("rect", { x: -PARALLEL_BRUSH_HALF_WIDTH, y: band.top, width: width, height: height, style: parallelBandStyle(ink) }), _jsx("rect", { x: -PARALLEL_BRUSH_HALF_WIDTH, y: band.top - PARALLEL_HANDLE_HEIGHT / 2, width: width, height: PARALLEL_HANDLE_HEIGHT, style: parallelHandleStyle(ink) }), _jsx("rect", { x: -PARALLEL_BRUSH_HALF_WIDTH, y: band.bottom - PARALLEL_HANDLE_HEIGHT / 2, width: width, height: PARALLEL_HANDLE_HEIGHT, style: parallelHandleStyle(ink) })] }));
+}
+//# sourceMappingURL=ParallelAxesLayer.js.map

package/lib/parallel/ui/ParallelAxesLayer.js.map

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

package/lib/parallel/ui/ParallelCoordinates.d.ts

@@ -0,0 +1,21 @@
+import type { ReactElement } from 'react';
+import type { ParallelCoordinatesProps } from './parallelCoordinatesProps.ts';
+/**
+ * One vertical axis per column, one line per row, and a brush on every axis.
+ *
+ * It is told nothing about what the rows are: a library of molecules, a set of
+ * runs and a table of measurements all arrive as one `ArrayLike<number>` per
+ * axis, read in place. The lines are painted into a canvas because ten
+ * thousand of them are not ten thousand elements; everything the reader points
+ * at, brushes or reads is SVG and HTML over the top.
+ *
+ * The brush reports on release, never while the band is being dragged, so a
+ * table filtering on the same intervals re-renders once per gesture. What it
+ * keeps is `parallelIncludedMask`, which that table should filter with — two
+ * definitions of "kept" is how a figure and the list under it come to disagree.
+ * @param props - See {@link ParallelCoordinatesProps}.
+ * @returns The figure, or what the caller asked to show in its place when
+ * there is nothing to draw.
+ */
+export declare function ParallelCoordinates(props: ParallelCoordinatesProps): ReactElement;
+//# sourceMappingURL=ParallelCoordinates.d.ts.map

package/lib/parallel/ui/ParallelCoordinates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelCoordinates.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelCoordinates.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAoB1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AA0B9E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CAiKd"}

package/lib/parallel/ui/ParallelCoordinates.js

@@ -0,0 +1,109 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useMemo, useState } from 'react';
+import { OverlayLayer } from "../../overlay/ui/OverlayLayer.js";
+import { joinClassNames } from "../../shared/ui/joinClassNames.js";
+import { PARALLEL_MARGIN, parallelAxisLayouts } from "../core/parallelAxes.js";
+import { parallelIncludedMask } from "../core/parallelFilter.js";
+import { parallelColorSteps, parallelPalette, } from "../core/parallelPalette.js";
+import { ParallelAxesLayer } from "./ParallelAxesLayer.js";
+import { ParallelLabels } from "./ParallelLabels.js";
+import { ParallelTooltip } from "./ParallelTooltip.js";
+import { useParallelInk } from "./parallelInk.js";
+import { parallelColorOf, parallelFigureLabel, parallelHighlightsOf, parallelIsBrushed, parallelRowCount, } from "./parallelPlotModel.js";
+import { PARALLEL_SVG_STYLE, parallelCanvasStyle, parallelFigureStyle, } from "./parallelStyles.js";
+import { useParallelCanvas } from "./useParallelCanvas.js";
+import { useParallelGesture } from "./useParallelGesture.js";
+/** Height the figure takes when the caller names none. */
+const DEFAULT_HEIGHT = 320;
+/** The smallest drawing area the figure will lay out, in pixels. */
+const SMALLEST_SIDE = 10;
+/** No axis is brushed, shared so an uncontrolled figure never rebuilds it. */
+const NO_RANGES = Object.freeze({});
+/**
+ * One vertical axis per column, one line per row, and a brush on every axis.
+ *
+ * It is told nothing about what the rows are: a library of molecules, a set of
+ * runs and a table of measurements all arrive as one `ArrayLike<number>` per
+ * axis, read in place. The lines are painted into a canvas because ten
+ * thousand of them are not ten thousand elements; everything the reader points
+ * at, brushes or reads is SVG and HTML over the top.
+ *
+ * The brush reports on release, never while the band is being dragged, so a
+ * table filtering on the same intervals re-renders once per gesture. What it
+ * keeps is `parallelIncludedMask`, which that table should filter with — two
+ * definitions of "kept" is how a figure and the list under it come to disagree.
+ * @param props - See {@link ParallelCoordinatesProps}.
+ * @returns The figure, or what the caller asked to show in its place when
+ * there is nothing to draw.
+ */
+export function ParallelCoordinates(props) {
+    const { axes, width, height = DEFAULT_HEIGHT, empty, overlay } = props;
+    const { selected, renderTooltip, renderAxisLabel } = props;
+    const { className, testId, ink: inkProp, label: given } = props;
+    const { ranges: ownedRanges, defaultRanges, included: givenMask } = props;
+    const { color: givenColor, colorAxis, onRangeChange: report } = props;
+    const { onRangePreview, hovered, onHoverChange, onRowClick } = props;
+    const count = parallelRowCount(axes, props.count);
+    const innerWidth = Math.max(width - PARALLEL_MARGIN.left - PARALLEL_MARGIN.right, SMALLEST_SIDE);
+    const innerHeight = Math.max(height - PARALLEL_MARGIN.top - PARALLEL_MARGIN.bottom, SMALLEST_SIDE);
+    const [ownRanges, setOwnRanges] = useState(defaultRanges ?? NO_RANGES);
+    const ranges = ownedRanges ?? ownRanges;
+    const layouts = useMemo(() => parallelAxisLayouts(axes, count, innerWidth, innerHeight), [axes, count, innerWidth, innerHeight]);
+    const values = useMemo(() => columnsOf(axes), [axes]);
+    const { ink, ref: figure } = useParallelInk(inkProp);
+    const color = useMemo(() => parallelColorOf(givenColor, colorAxis, axes), [givenColor, colorAxis, axes]);
+    const steps = useMemo(() => (color === undefined ? null : parallelColorSteps(color, count)), [color, count]);
+    const palette = useMemo(() => (color === undefined ? [] : parallelPalette(color.scale)), [color]);
+    const included = useMemo(() => {
+        if (givenMask !== undefined)
+            return givenMask;
+        if (!parallelIsBrushed(axes, ranges))
+            return null;
+        return parallelIncludedMask(axes, ranges, count);
+    }, [givenMask, axes, ranges, count]);
+    function commitRange(axisId, range) {
+        if (ownedRanges === undefined) {
+            setOwnRanges((previous) => ({ ...previous, [axisId]: range }));
+        }
+        report?.(axisId, range);
+    }
+    const gesture = useParallelGesture({
+        layouts,
+        values,
+        count,
+        innerHeight,
+        included,
+        ranges,
+        onRangeChange: commitRange,
+        onRangePreview,
+        hovered,
+        onHoverChange,
+        onRowClick,
+    });
+    const highlights = useMemo(() => parallelHighlightsOf(selected, gesture.hovered, ink.selection, ink.hover), [selected, gesture.hovered, ink.selection, ink.hover]);
+    const { lines: lineCanvas, marks: markCanvas } = useParallelCanvas({
+        width,
+        height,
+        layouts,
+        values,
+        count,
+        included,
+        steps,
+        palette,
+        highlights,
+        ink,
+    });
+    const label = given ?? parallelFigureLabel(axes, count);
+    const canvasStyle = parallelCanvasStyle(height);
+    const hover = gesture.pointer === null || gesture.hovered < 0
+        ? null
+        : { index: gesture.hovered, ...gesture.pointer };
+    return (_jsxs("div", { ref: figure, className: joinClassNames('parallel-coordinates', className), style: parallelFigureStyle(height), "data-testid": testId, children: [count === 0 || layouts.length === 0 ? (empty) : (_jsxs(_Fragment, { children: [_jsx("canvas", { ref: lineCanvas, className: "parallel-coordinates-canvas", style: canvasStyle }), _jsx("canvas", { ref: markCanvas, className: "parallel-coordinates-canvas", style: canvasStyle }), _jsxs("svg", { width: Math.max(0, width), height: Math.max(0, height), style: PARALLEL_SVG_STYLE, role: "img", "aria-label": label, children: [_jsx(ParallelAxesLayer, { layouts: layouts, innerHeight: innerHeight, bands: gesture.bands, axisInk: ink.axis, bandInk: ink.selection }), _jsx("rect", { x: 0, y: 0, width: Math.max(0, width), height: Math.max(0, height), fill: "transparent", onClick: gesture.onClick, ...gesture.surface })] }), _jsx(ParallelLabels, { axes: axes, layouts: layouts, render: renderAxisLabel }), hover === null || renderTooltip === undefined ? null : (_jsx(ParallelTooltip, { x: hover.x, y: hover.y, boxWidth: width, boxHeight: height, children: renderTooltip(hover) }))] })), overlay === undefined ? null : (_jsx(OverlayLayer, { width: width, busy: gesture.brushing, children: overlay }))] }));
+}
+function columnsOf(axes) {
+    const columns = [];
+    for (const axis of axes)
+        columns.push(axis.values);
+    return columns;
+}
+//# sourceMappingURL=ParallelCoordinates.js.map

package/lib/parallel/ui/ParallelCoordinates.js.map

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

package/lib/parallel/ui/ParallelLabels.d.ts

@@ -0,0 +1,26 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { ParallelAxisLayout } from '../core/parallelAxes.ts';
+import type { ParallelAxis } from '../core/parallelTypes.ts';
+/** What {@link ParallelLabels} writes. */
+export interface ParallelLabelsProps {
+    /** The axes as the caller described them, for a caller's own renderer. */
+    axes: readonly ParallelAxis[];
+    /** The same axes, placed, so each name sits over its own axis. */
+    layouts: readonly ParallelAxisLayout[];
+    /**
+     * How a name is written. Left out, it is the label and the unit after it.
+     * @default undefined
+     */
+    render?: ((axis: ParallelAxis, index: number) => ReactNode) | undefined;
+}
+/**
+ * The axis names, as HTML over the figure.
+ *
+ * HTML rather than SVG text so that a name can carry a tooltip explaining what
+ * the axis measures. The layer lets every pointer event through and only the
+ * names themselves take it back, so a brush started under a name still starts.
+ * @param props - See {@link ParallelLabelsProps}.
+ * @returns The names.
+ */
+export declare function ParallelLabels(props: ParallelLabelsProps): ReactElement;
+//# sourceMappingURL=ParallelLabels.d.ts.map

package/lib/parallel/ui/ParallelLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelLabels.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelLabels.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D,0CAA0C;AAC1C,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B,kEAAkE;IAClE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC,GAAG,SAAS,CAAC;CACzE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAqBvE"}

package/lib/parallel/ui/ParallelLabels.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { PARALLEL_MARGIN } from "../core/parallelAxes.js";
+import { PARALLEL_LABELS_STYLE, parallelLabelStyle } from "./parallelStyles.js";
+/**
+ * The axis names, as HTML over the figure.
+ *
+ * HTML rather than SVG text so that a name can carry a tooltip explaining what
+ * the axis measures. The layer lets every pointer event through and only the
+ * names themselves take it back, so a brush started under a name still starts.
+ * @param props - See {@link ParallelLabelsProps}.
+ * @returns The names.
+ */
+export function ParallelLabels(props) {
+    const { axes, layouts, render } = props;
+    return (_jsx("div", { className: "parallel-coordinates-labels", style: PARALLEL_LABELS_STYLE, children: layouts.map((layout, index) => {
+            const axis = axes[index];
+            return (_jsx("div", { className: "parallel-axis-label", style: parallelLabelStyle(PARALLEL_MARGIN.left + layout.x), children: axis !== undefined && render !== undefined
+                    ? render(axis, index)
+                    : defaultLabel(layout) }, layout.id));
+        }) }));
+}
+function defaultLabel(layout) {
+    return layout.unit === '' ? layout.label : `${layout.label} (${layout.unit})`;
+}
+//# sourceMappingURL=ParallelLabels.js.map

package/lib/parallel/ui/ParallelLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelLabels.js","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelLabels.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAehF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAExC,OAAO,CACL,cAAK,SAAS,EAAC,6BAA6B,EAAC,KAAK,EAAE,qBAAqB,YACtE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,OAAO,CACL,cAEE,SAAS,EAAC,qBAAqB,EAC/B,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,YAEzD,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;oBACzC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;oBACrB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IANnB,MAAM,CAAC,EAAE,CAOV,CACP,CAAC;QACJ,CAAC,CAAC,GACE,CACP,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B;IAC9C,OAAO,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC;AAChF,CAAC"}

package/lib/parallel/ui/ParallelTooltip.d.ts

@@ -0,0 +1,26 @@
+import type { ReactElement, ReactNode } from 'react';
+/** What {@link ParallelTooltip} shows, and where. */
+export interface ParallelTooltipProps {
+    /** Where the pointer is, in pixels from the figure's left edge. */
+    x: number;
+    /** Where it is, in pixels from its top edge. */
+    y: number;
+    /** Width of the figure, so the card is flipped rather than clipped. */
+    boxWidth: number;
+    /** Its height. */
+    boxHeight: number;
+    /** What the card says, written by the caller. */
+    children: ReactNode;
+}
+/**
+ * The card over the row under the pointer.
+ *
+ * It measures itself and flips rather than being clipped, because a card that
+ * runs off the bottom right of a figure is exactly where a reader points last
+ * — and it never takes the pointer, so moving towards it never dismisses it by
+ * moving off the line underneath.
+ * @param props - See {@link ParallelTooltipProps}.
+ * @returns The card.
+ */
+export declare function ParallelTooltip(props: ParallelTooltipProps): ReactElement;
+//# sourceMappingURL=ParallelTooltip.d.ts.map

package/lib/parallel/ui/ParallelTooltip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelTooltip.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelTooltip.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQrD,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACnC,mEAAmE;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,CAAC,EAAE,MAAM,CAAC;IACV,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,YAAY,CAsBzE"}

package/lib/parallel/ui/ParallelTooltip.js

@@ -0,0 +1,30 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useRef } from 'react';
+import { useContainerSize } from "../../hooks/ui/useContainerSize.js";
+import { placeOverlayCard } from "../../overlay/core/placeOverlayCard.js";
+import { parallelTooltipStyle } from "./parallelStyles.js";
+/**
+ * The card over the row under the pointer.
+ *
+ * It measures itself and flips rather than being clipped, because a card that
+ * runs off the bottom right of a figure is exactly where a reader points last
+ * — and it never takes the pointer, so moving towards it never dismisses it by
+ * moving off the line underneath.
+ * @param props - See {@link ParallelTooltipProps}.
+ * @returns The card.
+ */
+export function ParallelTooltip(props) {
+    const { x, y, boxWidth, boxHeight, children } = props;
+    const card = useRef(null);
+    const size = useContainerSize(card);
+    const placed = placeOverlayCard({
+        pointerX: x,
+        pointerY: y,
+        cardWidth: size.width,
+        cardHeight: size.height,
+        boxWidth,
+        boxHeight,
+    });
+    return (_jsx("div", { ref: card, className: "parallel-coordinates-tooltip", style: parallelTooltipStyle(placed.left, placed.top), children: children }));
+}
+//# sourceMappingURL=ParallelTooltip.js.map

package/lib/parallel/ui/ParallelTooltip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelTooltip.js","sourceRoot":"","sources":["../../../src/parallel/ui/ParallelTooltip.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAgB3D;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAAC,KAA2B;IACzD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,CAAiB,IAAI,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,gBAAgB,CAAC;QAC9B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,IAAI,CAAC,KAAK;QACrB,UAAU,EAAE,IAAI,CAAC,MAAM;QACvB,QAAQ;QACR,SAAS;KACV,CAAC,CAAC;IAEH,OAAO,CACL,cACE,GAAG,EAAE,IAAI,EACT,SAAS,EAAC,8BAA8B,EACxC,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,YAEnD,QAAQ,GACL,CACP,CAAC;AACJ,CAAC"}

package/lib/parallel/ui/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * A parallel-coordinates figure the reader can interrogate: brush any axis to
+ * keep an interval of it, rest on a line for what is known about that row, and
+ * colour every line by whichever column answers the question being asked.
+ *
+ * Nothing here knows what the rows are. The same figure draws a library of
+ * molecules, a set of experimental runs and a table of measurements, which is
+ * why it is its own domain rather than part of the first viewer to want one.
+ */
+export { ParallelAxesLayer } from './ParallelAxesLayer.tsx';
+export type { ParallelAxesLayerProps } from './ParallelAxesLayer.tsx';
+export { ParallelCoordinates } from './ParallelCoordinates.tsx';
+export type { ParallelCoordinatesProps, ParallelHover, ParallelInk, } from './parallelCoordinatesProps.ts';
+export type { ParallelInkBinding, ParallelInkValues, ParallelTokenInk, } from './parallelInk.ts';
+export { parallelInkFrom, readParallelInk, readParallelTokens, useParallelInk, } from './parallelInk.ts';
+export { ParallelLabels } from './ParallelLabels.tsx';
+export type { ParallelLabelsProps } from './ParallelLabels.tsx';
+export { parallelColorOf, parallelFigureLabel, parallelHighlightsOf, parallelIsBrushed, parallelRowCount, } from './parallelPlotModel.ts';
+export { ParallelTooltip } from './ParallelTooltip.tsx';
+export type { ParallelTooltipProps } from './ParallelTooltip.tsx';
+export type { ParallelCanvasOptions, ParallelCanvases, } from './useParallelCanvas.ts';
+export { useParallelCanvas } from './useParallelCanvas.ts';
+export type { ParallelGesture, ParallelGestureOptions, } from './useParallelGesture.ts';
+export { useParallelGesture } from './useParallelGesture.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/parallel/ui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,YAAY,EACV,wBAAwB,EACxB,aAAa,EACb,WAAW,GACZ,MAAM,+BAA+B,CAAC;AACvC,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EACV,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,YAAY,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

package/lib/parallel/ui/index.js

@@ -0,0 +1,18 @@
+/**
+ * A parallel-coordinates figure the reader can interrogate: brush any axis to
+ * keep an interval of it, rest on a line for what is known about that row, and
+ * colour every line by whichever column answers the question being asked.
+ *
+ * Nothing here knows what the rows are. The same figure draws a library of
+ * molecules, a set of experimental runs and a table of measurements, which is
+ * why it is its own domain rather than part of the first viewer to want one.
+ */
+export { ParallelAxesLayer } from "./ParallelAxesLayer.js";
+export { ParallelCoordinates } from "./ParallelCoordinates.js";
+export { parallelInkFrom, readParallelInk, readParallelTokens, useParallelInk, } from "./parallelInk.js";
+export { ParallelLabels } from "./ParallelLabels.js";
+export { parallelColorOf, parallelFigureLabel, parallelHighlightsOf, parallelIsBrushed, parallelRowCount, } from "./parallelPlotModel.js";
+export { ParallelTooltip } from "./ParallelTooltip.js";
+export { useParallelCanvas } from "./useParallelCanvas.js";
+export { useParallelGesture } from "./useParallelGesture.js";
+//# sourceMappingURL=index.js.map

package/lib/parallel/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parallel/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAE5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAWhE,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAsB,CAAC;AAEtD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAuB,CAAC;AAMxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAK3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}