react-cheminfo 0.15.0 → 0.17.0

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;AA4B9E;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CAkLd"}

package/lib/parallel/ui/ParallelCoordinates.js

@@ -0,0 +1,114 @@
+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, parallelDropMarkStyle, parallelFigureStyle, } from "./parallelStyles.js";
+import { useParallelAxisDrag } from "./useParallelAxisDrag.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 { several = false, onAxisOrder } = 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, kept) {
+        if (ownedRanges === undefined) {
+            setOwnRanges((previous) => ({ ...previous, [axisId]: kept }));
+        }
+        report?.(axisId, kept);
+    }
+    const gesture = useParallelGesture({
+        layouts,
+        values,
+        count,
+        innerHeight,
+        included,
+        ranges,
+        several,
+        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 axisDrag = useParallelAxisDrag({ layouts, onAxisOrder });
+    const dropAt = axisDrag.active === null ? undefined : layouts[axisDrag.active.to];
+    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 }), dropAt === undefined ? null : (_jsx("line", { "data-parallel-drop": dropAt.id, x1: PARALLEL_MARGIN.left + dropAt.x, x2: PARALLEL_MARGIN.left + dropAt.x, y1: PARALLEL_MARGIN.top, y2: PARALLEL_MARGIN.top + innerHeight, style: parallelDropMarkStyle(ink.selection) }))] }), _jsx(ParallelLabels, { axes: axes, layouts: layouts, render: renderAxisLabel, drag: axisDrag }), 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,32 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { ParallelAxisLayout } from '../core/parallelAxes.ts';
+import type { ParallelAxis } from '../core/parallelTypes.ts';
+import type { ParallelAxisDrag } from './useParallelAxisDrag.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 gesture that moves an axis by its name.
+     * @default undefined — the axes are fixed
+     */
+    drag?: ParallelAxisDrag | 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;AAG7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,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;IACxE;;;OAGG;IACH,IAAI,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACrC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,YAAY,CAoCvE"}

package/lib/parallel/ui/ParallelLabels.js

@@ -0,0 +1,37 @@
+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, drag } = props;
+    const draggable = drag?.enabled ?? false;
+    const active = drag?.active ?? null;
+    return (_jsx("div", { className: "parallel-coordinates-labels", style: PARALLEL_LABELS_STYLE, children: layouts.map((layout, index) => {
+            const axis = axes[index];
+            const moving = active !== null && active.from === index;
+            return (_jsx("div", { className: "parallel-axis-label", "data-parallel-label": layout.id, style: parallelLabelStyle({
+                    left: PARALLEL_MARGIN.left + layout.x,
+                    draggable,
+                    dx: moving ? active.dx : null,
+                }), ...drag?.propsFor(index), ...(draggable
+                    ? {
+                        role: 'button',
+                        'aria-label': `${layout.label}: move this axis with the left and right arrow keys`,
+                    }
+                    : null), 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;AAqBhF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAA0B;IACvD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,EAAE,OAAO,IAAI,KAAK,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC;IAEpC,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,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC;YACxD,OAAO,CACL,cAEE,SAAS,EAAC,qBAAqB,yBACV,MAAM,CAAC,EAAE,EAC9B,KAAK,EAAE,kBAAkB,CAAC;oBACxB,IAAI,EAAE,eAAe,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC;oBACrC,SAAS;oBACT,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI;iBAC9B,CAAC,KACE,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KACrB,CAAC,SAAS;oBACZ,CAAC,CAAC;wBACE,IAAI,EAAE,QAAQ;wBACd,YAAY,EAAE,GAAG,MAAM,CAAC,KAAK,qDAAqD;qBACnF;oBACH,CAAC,CAAC,IAAI,CAAC,YAER,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;oBACzC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC;oBACrB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,IAlBnB,MAAM,CAAC,EAAE,CAmBV,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,29 @@
+/**
+ * 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 type { ParallelCommit, ParallelDraft } from './parallelGestureModel.ts';
+export { parallelAxisById, parallelAxisNear, parallelBandsOf, parallelCommitOf, parallelPointOf, } from './parallelGestureModel.ts';
+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 { ParallelAxisDrag, ParallelAxisDragOptions, ParallelAxisDragState, ParallelAxisHandleProps, } from './useParallelAxisDrag.ts';
+export { useParallelAxisDrag } from './useParallelAxisDrag.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,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,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,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,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,20 @@
+/**
+ * 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 { parallelAxisById, parallelAxisNear, parallelBandsOf, parallelCommitOf, parallelPointOf, } from "./parallelGestureModel.js";
+export { parallelColorOf, parallelFigureLabel, parallelHighlightsOf, parallelIsBrushed, parallelRowCount, } from "./parallelPlotModel.js";
+export { ParallelTooltip } from "./ParallelTooltip.js";
+export { useParallelCanvas } from "./useParallelCanvas.js";
+export { useParallelAxisDrag } from "./useParallelAxisDrag.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;AAGtD,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,2BAA2B,CAAC;AACnC,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;AAO3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAK/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,203 @@
+/**
+ * What a caller hands a `ParallelCoordinates`.
+ *
+ * The types the figure is *told* about — an axis, an interval, a colour ramp —
+ * live in `parallel/core`, because the same words describe the mask a table
+ * beside the figure filters on and the layout the painter reads. What is left
+ * here is what only a React component has: the render props, the inks a canvas
+ * cannot read off a stylesheet, and the controlled pairs.
+ */
+import type { ReactNode } from 'react';
+import type { ParallelAxis, ParallelColorBy, ParallelRange, ParallelRanges } from '../core/parallelTypes.ts';
+/** What the pointer is over, and where. */
+export interface ParallelHover {
+    /** The row, as an index into the axes' value arrays. */
+    index: number;
+    /** 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;
+}
+/** The colours a canvas is painted with, which cannot read a custom property. */
+export interface ParallelInk {
+    /**
+     * The rows a brush left out, drawn under the rest.
+     * @default a light grey the dense mass can only converge on
+     */
+    excluded?: string;
+    /**
+     * The rows nothing is colouring, when no quantity was given.
+     * @default the value of `--text-muted` on the figure
+     */
+    line?: string;
+    /**
+     * The row under the pointer.
+     * @default the value of `--text` on the figure
+     */
+    hover?: string;
+    /**
+     * The rows singled out elsewhere — picked in a table, pinned by the reader.
+     * @default the value of `--accent` on the figure
+     */
+    selection?: string;
+    /**
+     * The halo a singled-out line is drawn over, so it reads against the mass.
+     * @default the value of `--surface`, at 85%
+     */
+    halo?: string;
+    /**
+     * The axis lines, their ticks and their labels.
+     * @default the value of `--text-muted`
+     */
+    axis?: string;
+    /**
+     * How strongly a kept line is drawn. Turn it down for a dense library.
+     * @default 0.35
+     */
+    includedAlpha?: number;
+}
+/** What `ParallelCoordinates` needs. */
+export interface ParallelCoordinatesProps {
+    /** The axes, from left to right. Fewer than two draws no lines. */
+    axes: readonly ParallelAxis[];
+    /**
+     * How many rows to draw.
+     * @default the shortest axis's value count
+     */
+    count?: number;
+    /** Total width, in pixels, normally from `useContainerSize`. */
+    width: number;
+    /**
+     * Total height, axis names and tick labels included.
+     * @default 320
+     */
+    height?: number;
+    /**
+     * What each axis keeps, keyed by axis id: one interval, several, or `null`.
+     * Present, the caller owns the brushes — which is what lets a table beside
+     * the figure filter on the same ranges. The band being dragged stays inside
+     * the component either way, so a controlled parent is never asked to
+     * re-render sixty times a second.
+     * @default undefined — the figure keeps its own
+     */
+    ranges?: ParallelRanges;
+    /**
+     * The intervals in force before the reader touches anything.
+     * @default undefined — no axis is brushed
+     */
+    defaultRanges?: ParallelRanges;
+    /**
+     * Whether one axis may keep several intervals at once — the light molecules
+     * and the heavy ones, with nothing in between. A reader brushes a second
+     * interval by dragging on a bare part of an axis that already carries one,
+     * and takes one away by clicking it.
+     * @default false — a new brush replaces the one the axis carried
+     */
+    several?: boolean;
+    /**
+     * Called when a brush is released, with every interval that axis now keeps —
+     * empty when the reader cleared it, and never while a band is being dragged.
+     * @default undefined
+     */
+    onRangeChange?: (axisId: string, ranges: readonly ParallelRange[]) => void;
+    /**
+     * Called on every frame a band grows, for a caption saying what letting go
+     * would keep. Nothing else should be wired to it.
+     * @default undefined
+     */
+    onRangePreview?: (axisId: string, ranges: readonly ParallelRange[]) => void;
+    /**
+     * Which rows the brushes keep, one entry per row, a zero meaning excluded.
+     * Left out, it is worked out from the ranges with `parallelIncludedMask`,
+     * which is exported so a table beside the figure filters on the same answer
+     * rather than on a second definition of "kept".
+     * @default undefined — worked out from the ranges
+     */
+    included?: Uint8Array;
+    /**
+     * The row under the pointer, or `-1`. Present, the caller owns it, which is
+     * what lets a table hovered elsewhere light up its line here.
+     * @default undefined — the figure keeps its own
+     */
+    hovered?: number;
+    /**
+     * Called with the row under the pointer, or `-1`, whenever that changes.
+     * @default undefined
+     */
+    onHoverChange?: (index: number) => void;
+    /**
+     * The rows singled out elsewhere, drawn over the mass in the selection ink.
+     * A row that is also the hovered one is drawn once, in the hover ink.
+     * @default undefined — nothing is singled out
+     */
+    selected?: readonly number[];
+    /**
+     * Called when a line is clicked, with the row, or `-1` for empty ground.
+     * @default undefined — the lines are not clickable
+     */
+    onRowClick?: (index: number) => void;
+    /**
+     * The quantity the lines are coloured by.
+     * @default undefined — every line takes one ink
+     */
+    color?: ParallelColorBy;
+    /**
+     * The id of the axis the lines are coloured by, for the common case where it
+     * is one of the axes already drawn. Ignored when `color` is given.
+     * @default undefined
+     */
+    colorAxis?: string;
+    /**
+     * The canvas colours, merged over the ones read off the figure's own tokens.
+     * @default {}
+     */
+    ink?: ParallelInk;
+    /**
+     * The card shown over the row under the pointer. It is placed by the figure,
+     * flipped rather than clipped at either edge, so a caller writes only what
+     * it says.
+     * @default undefined — no card is shown
+     */
+    renderTooltip?: (hover: ParallelHover) => ReactNode;
+    /**
+     * How an axis is named. The default writes the label and its unit; a caller
+     * wraps it to hang a help tooltip off the name.
+     * @default the axis label, and its unit after it
+     */
+    renderAxisLabel?: (axis: ParallelAxis, index: number) => ReactNode;
+    /**
+     * Called with the axis ids in the order the reader dragged them into.
+     * Present, every axis name becomes a handle: drag it, or focus it and press
+     * the left and right arrow keys. Two columns only show their relationship
+     * when they stand next to each other, so this is how a reader asks a
+     * different question of the same figure.
+     * @default undefined — the axes stand in the order the caller gave them
+     */
+    onAxisOrder?: (ids: readonly string[]) => void;
+    /**
+     * What is shown in place of the figure when there is nothing to draw.
+     * @default undefined — an empty figure of the given height
+     */
+    empty?: ReactNode;
+    /**
+     * What floats over the figure — a legend, a colour scale key, a caption.
+     * @default undefined
+     */
+    overlay?: ReactNode;
+    /**
+     * What a screen reader is told the figure shows.
+     * @default a sentence naming the axes and the row count
+     */
+    label?: string;
+    /**
+     * A class for the figure's outermost element, for a site placing it.
+     * @default undefined
+     */
+    className?: string;
+    /**
+     * Value of the `data-testid` attribute of the wrapper.
+     * @default undefined
+     */
+    testId?: string;
+}
+//# sourceMappingURL=parallelCoordinatesProps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelCoordinatesProps.d.ts","sourceRoot":"","sources":["../../../src/parallel/ui/parallelCoordinatesProps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,cAAc,EACf,MAAM,0BAA0B,CAAC;AAElC,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,CAAC,EAAE,MAAM,CAAC;CACX;AAED,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB;;;OAGG;IACH,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;IAC3E;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,aAAa,EAAE,KAAK,IAAI,CAAC;IAC5E;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC;;;OAGG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,GAAG,CAAC,EAAE,WAAW,CAAC;IAElB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,SAAS,CAAC;IACpD;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IACnE;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/lib/parallel/ui/parallelCoordinatesProps.js

@@ -0,0 +1,11 @@
+/**
+ * What a caller hands a `ParallelCoordinates`.
+ *
+ * The types the figure is *told* about — an axis, an interval, a colour ramp —
+ * live in `parallel/core`, because the same words describe the mask a table
+ * beside the figure filters on and the layout the painter reads. What is left
+ * here is what only a React component has: the render props, the inks a canvas
+ * cannot read off a stylesheet, and the controlled pairs.
+ */
+export {};
+//# sourceMappingURL=parallelCoordinatesProps.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelCoordinatesProps.js","sourceRoot":"","sources":["../../../src/parallel/ui/parallelCoordinatesProps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}