react-cheminfo 0.9.0 → 0.10.0

package/lib/scatter/ui/ScatterMatrixDiagonal.d.ts

@@ -0,0 +1,78 @@
+import type { ReactElement } from 'react';
+import type { ChartBins } from '../../chart/core/chartBins.ts';
+import type { ChartExtent } from '../../chart/core/chartExtent.ts';
+import type { MatrixLike } from '../../chart/core/matrix.ts';
+import type { ChartFrameRender } from '../../chart/ui/ChartFrame.tsx';
+import type { ScatterGroupSpread } from './scatterGroupSpread.ts';
+import type { ScatterMatrixAxis } from './scatterMatrixProps.ts';
+/**
+ * What the grid works out once and every one of its cells reads.
+ *
+ * It lives here rather than beside the grid's own props only because that file
+ * has no room left for it, and this is the leaf of the three.
+ */
+export interface ScatterMatrixGrid {
+    /** The coordinates, read where they stand. */
+    scores: MatrixLike;
+    /** The axes, indexed by row and by column alike. */
+    axes: readonly ScatterMatrixAxis[];
+    /** How many axes are laid out, after any reduction for width. */
+    shown: number;
+    /** Side of every plot rectangle, in pixels — the same in every cell. */
+    side: number;
+    /** Room the left column and the bottom row keep for their ticks and titles. */
+    room: {
+        left: number;
+        bottom: number;
+    };
+    /** One range per axis, so a column reads across and a row reads down. */
+    extents: readonly ChartExtent[];
+    /** One counted distribution per axis, for the diagonal. */
+    spread: readonly ChartBins[];
+    /**
+     * Every group measured over every laid-out axis, for the outlines, or
+     * nothing when none are drawn: no groups were named, or the cells came out
+     * too small to hold a readable outline.
+     */
+    groupSpread: ScatterGroupSpread | undefined;
+    /** One colour per group, or nothing when no group was named. */
+    colors: readonly string[] | undefined;
+    /** Which group each row belongs to, or nothing when they are one crowd. */
+    groupOf: ArrayLike<number> | undefined;
+    /** One entry per row; a zero draws that row faint. */
+    mask: Uint8Array | undefined;
+    /** Radius of a dot, in pixels. */
+    pointRadius: number;
+    /** What a cell hands its pair of axes to when it is clicked. */
+    onSelectPair: ((xAxis: number, yAxis: number) => void) | undefined;
+    /** What a cell hands the row under the pointer to. */
+    onHoverChange: ((index: number) => void) | undefined;
+}
+/** What one diagonal cell of a `ScatterMatrix` draws. */
+export interface ScatterMatrixDiagonalProps {
+    /** Everything the grid worked out once, including the counted spread. */
+    grid: ScatterMatrixGrid;
+    /** Which axis the cell stands on, both across and up. */
+    axis: number;
+    /** The rectangle and the two scales the cell was given. */
+    frame: ChartFrameRender;
+}
+/**
+ * The axis' own distribution, split by group and stacked.
+ *
+ * This is the cell a pair grid normally spends on the line `y = x`. That line
+ * is the same in every grid ever drawn, so it says nothing about the data at
+ * all, and a reader who has not been told otherwise takes a rising diagonal
+ * for a correlation — the opposite of what orthogonal axes mean. A
+ * distribution answers the question the reader actually brought: does this
+ * component pull my groups apart on its own, or only in company? Two humps
+ * that barely touch say yes; one hump says no, whatever the scatters around it
+ * look like.
+ *
+ * The bars are counted over the same edges as the column's shared domain, so a
+ * peak here sits directly above the dots it is made of.
+ * @param props - See {@link ScatterMatrixDiagonalProps}.
+ * @returns The distribution.
+ */
+export declare function ScatterMatrixDiagonal(props: ScatterMatrixDiagonalProps): ReactElement;
+//# sourceMappingURL=ScatterMatrixDiagonal.d.ts.map

package/lib/scatter/ui/ScatterMatrixDiagonal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterMatrixDiagonal.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/ScatterMatrixDiagonal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACnC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,yEAAyE;IACzE,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,2DAA2D;IAC3D,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IAC7B;;;;OAIG;IACH,WAAW,EAAE,kBAAkB,GAAG,SAAS,CAAC;IAC5C,gEAAgE;IAChE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACtC,2EAA2E;IAC3E,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACvC,sDAAsD;IACtD,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IACnE,sDAAsD;IACtD,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD;AAED,yDAAyD;AACzD,MAAM,WAAW,0BAA0B;IACzC,yEAAyE;IACzE,IAAI,EAAE,iBAAiB,CAAC;IACxB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CA6Bd"}

package/lib/scatter/ui/ScatterMatrixDiagonal.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * The axis' own distribution, split by group and stacked.
+ *
+ * This is the cell a pair grid normally spends on the line `y = x`. That line
+ * is the same in every grid ever drawn, so it says nothing about the data at
+ * all, and a reader who has not been told otherwise takes a rising diagonal
+ * for a correlation — the opposite of what orthogonal axes mean. A
+ * distribution answers the question the reader actually brought: does this
+ * component pull my groups apart on its own, or only in company? Two humps
+ * that barely touch say yes; one hump says no, whatever the scatters around it
+ * look like.
+ *
+ * The bars are counted over the same edges as the column's shared domain, so a
+ * peak here sits directly above the dots it is made of.
+ * @param props - See {@link ScatterMatrixDiagonalProps}.
+ * @returns The distribution.
+ */
+export function ScatterMatrixDiagonal(props) {
+    const { grid, axis, frame } = props;
+    const named = grid.axes[axis];
+    const share = named?.share;
+    return (_jsxs("g", { children: [bars(props), _jsx("text", { x: frame.plot.left + CORNER_INSET, y: frame.plot.top + CORNER_BASELINE, style: NAME_STYLE, children: named?.name ?? '' }), share === undefined ||
+                !Number.isFinite(share) ||
+                frame.plot.width < BOTH_CAPTIONS ? null : (_jsx("text", { x: frame.plot.right - CORNER_INSET, y: frame.plot.top + CORNER_BASELINE, textAnchor: "end", style: SHARE_STYLE, children: `${(share * 100).toFixed(1)} %` }))] }));
+}
+/** The ink the counts take when no group was named. */
+const NO_GROUP_INK = 'var(--text-muted)';
+/** How solid a band is: readable, and still honest where two overlap. */
+const BAND_OPACITY = 0.55;
+/** How far the corner captions sit inside the plot, and how far down. */
+const CORNER_INSET = 6;
+const CORNER_BASELINE = 13;
+/**
+ * The narrowest cell that holds the name and the share at once. Below it the
+ * share is dropped rather than run into the name, because which component the
+ * cell is comes first: a reader can find the share along the foot of the grid.
+ */
+const BOTH_CAPTIONS = 82;
+/** The axis' name, in the corner a reader looks at first. */
+const NAME_STYLE = {
+    fill: 'var(--text)',
+    fontSize: 10,
+    fontWeight: 600,
+    userSelect: 'none',
+};
+/** Its share, kept quieter than the name it qualifies. */
+const SHARE_STYLE = {
+    fill: 'var(--text-muted)',
+    fontSize: 10,
+    fontVariantNumeric: 'tabular-nums',
+    userSelect: 'none',
+};
+function bars(props) {
+    const { grid, axis, frame } = props;
+    const { x, y } = frame;
+    const counted = grid.spread[axis];
+    const marks = [];
+    if (counted === undefined)
+        return marks;
+    for (let bin = 0; bin < counted.bins; bin++) {
+        const from = counted.edges[bin];
+        const to = counted.edges[bin + 1];
+        if (from === undefined || to === undefined)
+            continue;
+        const left = x.offset + from * x.factor;
+        const width = Math.max(1, x.offset + to * x.factor - left);
+        let base = 0;
+        for (let series = 0; series < counted.series; series++) {
+            const count = counted.counts[series * counted.bins + bin] ?? 0;
+            if (count === 0)
+                continue;
+            const top = y.offset + (base + count) * y.factor;
+            marks.push(_jsx("rect", { x: left, y: top, width: width, height: Math.max(0, y.offset + base * y.factor - top), style: bandStyle(grid.colors?.[series] ?? NO_GROUP_INK) }, `${series}-${bin}`));
+            base += count;
+        }
+    }
+    return marks;
+}
+function bandStyle(color) {
+    return { fill: color, fillOpacity: BAND_OPACITY };
+}
+//# sourceMappingURL=ScatterMatrixDiagonal.js.map

package/lib/scatter/ui/ScatterMatrixDiagonal.js.map

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

package/lib/scatter/ui/ScatterPlot.d.ts

@@ -0,0 +1,17 @@
+import type { ReactElement } from 'react';
+import type { ScatterPlotProps } from './scatterPlotProps.ts';
+export type { ScatterGroup, ScatterMarker, ScatterPlotProps, } from './scatterPlotProps.ts';
+/**
+ * A cloud of points with a lasso, group outlines and a hover card.
+ *
+ * It knows nothing about what produced the coordinates, so the same component
+ * draws a scores map, a k-means result and a UMAP embedding. The point layer
+ * carries no event handlers at all — one transparent rectangle takes every
+ * gesture and the hit tests run over a coordinate array — which is what keeps
+ * two thousand dots inside a frame and what would let a canvas replace the
+ * layer without touching anything else.
+ * @param props - See {@link ScatterPlotProps}.
+ * @returns The plot.
+ */
+export declare function ScatterPlot(props: ScatterPlotProps): ReactElement;
+//# sourceMappingURL=ScatterPlot.d.ts.map

package/lib/scatter/ui/ScatterPlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterPlot.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/ScatterPlot.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAsB1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAI9D,YAAY,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,YAAY,CA6LjE"}

package/lib/scatter/ui/ScatterPlot.js

@@ -0,0 +1,91 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useLayoutEffect, useMemo, useRef } from 'react';
+import { ChartFrame } from "../../chart/ui/ChartFrame.js";
+import { ScatterEllipseLayer } from "./ScatterEllipseLayer.js";
+import { ScatterLabelLayer } from "./ScatterLabelLayer.js";
+import { ScatterMarkLayer } from "./ScatterMarkLayer.js";
+import { ScatterPointLayer } from "./ScatterPointLayer.js";
+import { SCATTER_GROUP_LABEL_SIZE, SCATTER_LABEL_SIZE, } from "./scatterLabelBoxes.js";
+import { placeScatterLabels } from "./scatterLabelPlacement.js";
+import { scatterGroupLabels, scatterPointLabels } from "./scatterLabels.js";
+import { LASSO_STYLE, SCATTER_HOVER_SLACK, scatterGroupInk, scatterPixelMarks, scatterPlotLabel, } from "./scatterPlotModel.js";
+import { useScatterFrame } from "./useScatterFrame.js";
+import { useScatterInteraction } from "./useScatterInteraction.js";
+/**
+ * A cloud of points with a lasso, group outlines and a hover card.
+ *
+ * It knows nothing about what produced the coordinates, so the same component
+ * draws a scores map, a k-means result and a UMAP embedding. The point layer
+ * carries no event handlers at all — one transparent rectangle takes every
+ * gesture and the hit tests run over a coordinate array — which is what keeps
+ * two thousand dots inside a frame and what would let a canvas replace the
+ * layer without touching anything else.
+ * @param props - See {@link ScatterPlotProps}.
+ * @returns The plot.
+ */
+export function ScatterPlot(props) {
+    const { x, y, width, height, xAxis, yAxis, groupOf, groups, mutedGroups, ellipse = null, ellipseMinimumPoints, ellipseFillOpacity, showGroupMeans, markers, pointRadius = 3.5, outlinedFrom, pointLabels, showGroupLabels = false, selected, defaultSelected, onSelectionChange, selectMode, onHoverChange, onPinChange, onLassoChange, touchLasso, viewport, onViewportChange, wheelZoom, wheelZoomDelay, overlay, label, testId, } = props;
+    const frame = useScatterFrame({
+        x,
+        y,
+        width,
+        height,
+        xAxis,
+        yAxis,
+        viewport,
+        onViewportChange,
+        wheelZoom,
+        wheelZoomDelay,
+    });
+    const { points, rect, toX, toY, inside, ref: surface, reset } = frame;
+    const ink = useMemo(() => scatterGroupInk(groups, mutedGroups), [groups, mutedGroups]);
+    const named = useMemo(() => pointLabels === undefined
+        ? undefined
+        : placeScatterLabels(scatterPointLabels(points, pointLabels, {
+            groupOf,
+            colors: ink.colors,
+        }), {
+            fontSize: SCATTER_LABEL_SIZE,
+            radius: pointRadius,
+            bounds: rect,
+        }), [points, pointLabels, groupOf, ink.colors, pointRadius, rect]);
+    const crowds = useMemo(() => showGroupLabels && groups !== undefined
+        ? placeScatterLabels(scatterGroupLabels(points, groups.map((group) => group.label), {
+            groupOf,
+            colors: ink.colors,
+        }), {
+            fontSize: SCATTER_GROUP_LABEL_SIZE,
+            bold: true,
+            centered: true,
+            radius: pointRadius,
+            bounds: rect,
+        })
+        : undefined, [points, showGroupLabels, groups, groupOf, ink.colors, pointRadius, rect]);
+    const interaction = useScatterInteraction({
+        points,
+        originX: rect.x,
+        originY: rect.y,
+        selected,
+        defaultSelected,
+        onSelectionChange,
+        selectMode,
+        touchLasso,
+        included: inside,
+        hoverRadius: pointRadius + SCATTER_HOVER_SLACK,
+        onHoverChange,
+        onPinChange,
+    });
+    // Held in a ref so an inline arrow, which is how every caller writes it, does
+    // not put the callback in the effect's dependencies and report a drag that
+    // never changed on every render.
+    const report = useRef(onLassoChange);
+    useLayoutEffect(() => {
+        report.current = onLassoChange;
+    });
+    const drawing = interaction.lasso.drawing;
+    useEffect(() => {
+        report.current?.(drawing);
+    }, [drawing]);
+    return (_jsx(ChartFrame, { width: width, height: height, x: frame.xAxis, y: frame.yAxis, busy: drawing, overlay: overlay, testId: testId, label: label ?? scatterPlotLabel(xAxis, yAxis, points.x.length), children: () => (_jsxs(_Fragment, { children: [ellipse === null || groupOf === undefined ? null : (_jsx(ScatterEllipseLayer, { x: x, y: y, groupOf: groupOf, colors: ink.colors, opacities: ink.opacities, scaleX: toX, scaleY: toY, size: ellipse, minimumPoints: ellipseMinimumPoints, fillOpacity: ellipseFillOpacity })), _jsx(ScatterPointLayer, { points: points, groupOf: groupOf, colors: ink.colors, opacities: ink.opacities, radius: pointRadius, outlinedFrom: outlinedFrom }), _jsx(ScatterMarkLayer, { points: points, selected: interaction.selection.mask, hovered: interaction.hover.hovered, focused: interaction.keyboard.cursor, radius: pointRadius, groupOf: groupOf, colors: ink.colors, showGroupMeans: showGroupMeans, marks: scatterPixelMarks(markers, toX, toY) }), named === undefined ? null : (_jsx(ScatterLabelLayer, { labels: named, radius: pointRadius })), crowds === undefined ? null : (_jsx(ScatterLabelLayer, { labels: crowds, radius: pointRadius, strong: true })), interaction.lasso.pathData === '' ? null : (_jsx("path", { d: interaction.lasso.pathData, ...LASSO_STYLE })), _jsx("rect", { ...rect, ref: surface, fill: "transparent", tabIndex: 0, onKeyDown: interaction.keyboard.onKeyDown, onDoubleClick: reset, ...interaction.surface })] })) }));
+}
+//# sourceMappingURL=ScatterPlot.js.map

package/lib/scatter/ui/ScatterPlot.js.map

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

package/lib/scatter/ui/ScatterPointLayer.d.ts

@@ -0,0 +1,67 @@
+import type { ReactElement } from 'react';
+import type { ScreenPoints } from '../core/screenPoints.ts';
+/** What {@link ScatterPointLayer} draws. */
+export interface ScatterPointLayerProps {
+    /**
+     * Where every point already sits, in the frame's pixels. The layer never
+     * sees a data value, which is what lets a zoom, a resize and a change of
+     * axis all arrive here as the same thing.
+     */
+    points: ScreenPoints;
+    /**
+     * Which group each point belongs to, as an index into `colors`. An entry of
+     * `-1`, or one outside the range, is a point in no group.
+     * @default undefined — every point is one crowd
+     */
+    groupOf?: ArrayLike<number>;
+    /**
+     * The colour of each group, in the order the groups were given.
+     * @default undefined — every point takes `fallbackColor`
+     */
+    colors?: readonly string[];
+    /**
+     * How strongly each group is drawn, in the same order. This is what a
+     * legend entry switching a group off actually changes — the dots stay where
+     * they are, so the reader can still see the shape they are hiding.
+     * @default undefined — every group is drawn at full strength
+     */
+    opacities?: readonly number[];
+    /**
+     * Colour of a point belonging to no group. It has to be the one ink on the
+     * plot that names nothing, or a reader counts it as one more group.
+     * @default 'var(--text-faint)'
+     */
+    fallbackColor?: string;
+    /**
+     * Radius of a dot, in pixels.
+     * @default 3.5
+     */
+    radius?: number;
+    /**
+     * The index from which points are drawn as outlines rather than filled.
+     *
+     * It is how a sample the model was built from is told from one placed into
+     * it afterwards: the first kind helped choose where the axes point and is
+     * bound to sit somewhere reasonable, while the second can land anywhere.
+     * Points before it are filled, points from it on are hollow.
+     * @default undefined — every point is filled
+     */
+    outlinedFrom?: number;
+}
+/**
+ * Every sample as one dot, and nothing else.
+ *
+ * It carries no event handler, no closure per point and no state: the gestures
+ * all land on one transparent rectangle above it and are answered from a
+ * coordinate array. That is what keeps two thousand dots inside a frame, and
+ * it is the whole reason this layer could be swapped for a canvas one day
+ * without a single other file changing.
+ *
+ * A hollow dot is the same dot at the same radius with its colour moved from
+ * the fill to the stroke, so the two read as one kind of thing seen at two
+ * levels of confidence rather than as two unrelated marks.
+ * @param props - See {@link ScatterPointLayerProps}.
+ * @returns The cloud.
+ */
+export declare const ScatterPointLayer: import("react").MemoExoticComponent<(props: ScatterPointLayerProps) => ReactElement>;
+//# sourceMappingURL=ScatterPointLayer.d.ts.map

package/lib/scatter/ui/ScatterPointLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterPointLayer.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/ScatterPointLayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,MAAM,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,8CACrB,sBAAsB,KAC5B,YAAY,CAyCb,CAAC"}

package/lib/scatter/ui/ScatterPointLayer.js

@@ -0,0 +1,87 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { memo } from 'react';
+/**
+ * Every sample as one dot, and nothing else.
+ *
+ * It carries no event handler, no closure per point and no state: the gestures
+ * all land on one transparent rectangle above it and are answered from a
+ * coordinate array. That is what keeps two thousand dots inside a frame, and
+ * it is the whole reason this layer could be swapped for a canvas one day
+ * without a single other file changing.
+ *
+ * A hollow dot is the same dot at the same radius with its colour moved from
+ * the fill to the stroke, so the two read as one kind of thing seen at two
+ * levels of confidence rather than as two unrelated marks.
+ * @param props - See {@link ScatterPointLayerProps}.
+ * @returns The cloud.
+ */
+export const ScatterPointLayer = memo(function ScatterPointLayer(props) {
+    const { points, groupOf, colors, opacities, fallbackColor = 'var(--text-faint)', radius = 3.5, outlinedFrom, } = props;
+    const xs = points.x;
+    const ys = points.y;
+    const count = Math.min(xs.length, ys.length);
+    const hollowFrom = outlineStart(outlinedFrom, count);
+    const ink = groupInk(colors, opacities, fallbackColor);
+    const dots = [];
+    for (let index = 0; index < count; index++) {
+        const x = xs[index];
+        const y = ys[index];
+        if (x === undefined || y === undefined)
+            break;
+        if (!Number.isFinite(x) || !Number.isFinite(y))
+            continue;
+        const slot = (groupOf?.[index] ?? -1) + 1;
+        const color = ink.colors[slot] ?? fallbackColor;
+        const hollow = index >= hollowFrom;
+        dots.push(_jsx("circle", { cx: round(x), cy: round(y), r: radius, fill: hollow ? 'none' : color, stroke: hollow ? color : undefined, strokeWidth: hollow ? OUTLINE_WIDTH : undefined, opacity: ink.opacities[slot] }, index));
+    }
+    return _jsx("g", { "data-layer": "points", children: dots });
+});
+/**
+ * Where the hollow dots begin.
+ * @param outlinedFrom - The index the caller asked for, if any.
+ * @param count - How many points there are.
+ * @returns The first index drawn as an outline; `count` when none is.
+ */
+function outlineStart(outlinedFrom, count) {
+    if (outlinedFrom === undefined || !Number.isFinite(outlinedFrom)) {
+        return count;
+    }
+    return Math.max(0, Math.floor(outlinedFrom));
+}
+/**
+ * A dot's ink, worked out once per group instead of once per point.
+ *
+ * Both arrays are offset by one, so a point in no group — which arrives as
+ * `-1` — reads its fallback through the same indexed read as every other
+ * point, and a group index past the end simply reads past the end. An opacity
+ * of one is stored as `undefined` because that is the value the attribute is
+ * then left out with.
+ * @param colors - The colour of each group, in group order.
+ * @param opacities - How strongly each group is drawn, in the same order.
+ * @param fallbackColor - Colour of a point belonging to no group.
+ * @returns The colour and the written opacity of every group, from slot 1.
+ */
+function groupInk(colors, opacities, fallbackColor) {
+    const groups = colors?.length ?? 0;
+    const inks = [fallbackColor];
+    const alphas = [undefined];
+    for (let group = 0; group < groups; group++) {
+        inks.push(colors?.[group] ?? fallbackColor);
+        const alpha = opacities?.[group] ?? 1;
+        alphas.push(alpha === 1 ? undefined : alpha);
+    }
+    return { colors: inks, opacities: alphas };
+}
+/**
+ * Heavy enough that a ring of it beside a filled dot of the same radius reads
+ * as the same colour. A hairline would read as a paler group instead, which is
+ * exactly the wrong thing to say about a projected sample.
+ */
+const OUTLINE_WIDTH = 1.5;
+/*
+ * Two decimals, which is under a tenth of a device pixel at any zoom a browser
+ * offers and keeps the markup short enough to read in a failing test.
+ */
+const round = (value) => Math.round(value * 100) / 100;
+//# sourceMappingURL=ScatterPointLayer.js.map

package/lib/scatter/ui/ScatterPointLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScatterPointLayer.js","sourceRoot":"","sources":["../../../src/scatter/ui/ScatterPointLayer.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAqD7B;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,iBAAiB,CAC9D,KAA6B;IAE7B,MAAM,EACJ,MAAM,EACN,OAAO,EACP,MAAM,EACN,SAAS,EACT,aAAa,GAAG,mBAAmB,EACnC,MAAM,GAAG,GAAG,EACZ,YAAY,GACb,GAAG,KAAK,CAAC;IAEV,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,YAAY,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAEvD,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACpB,MAAM,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,SAAS;YAAE,MAAM;QAC9C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,SAAS;QACzD,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;QAChD,MAAM,MAAM,GAAG,KAAK,IAAI,UAAU,CAAC;QACnC,IAAI,CAAC,IAAI,CACP,iBAEE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EACZ,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EACZ,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAC7B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,EAClC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,EAC/C,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAPvB,KAAK,CAQV,CACH,CAAC;IACJ,CAAC;IAED,OAAO,0BAAc,QAAQ,YAAE,IAAI,GAAK,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEH;;;;;GAKG;AACH,SAAS,YAAY,CAAC,YAAgC,EAAE,KAAa;IACnE,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAS,QAAQ,CACf,MAAqC,EACrC,SAAwC,EACxC,aAAqB;IAErB,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,CAAC,CAAC;IACnC,MAAM,IAAI,GAAa,CAAC,aAAa,CAAC,CAAC;IACvC,MAAM,MAAM,GAA8B,CAAC,SAAS,CAAC,CAAC;IACtD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B;;;GAGG;AACH,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * A scatter plot the reader can interrogate: a lasso to select a crowd, a card
+ * on the point under the pointer, an outline per group, and the grid of every
+ * pair of axes.
+ *
+ * Nothing here knows what produced the coordinates. The same plot draws a
+ * principal component map, a UMAP embedding and a k-means run with its
+ * centroids, which is why it is its own domain rather than part of the viewer
+ * that happens to use it first.
+ */
+export type { ScatterEllipseLayerProps } from './ScatterEllipseLayer.tsx';
+export { ScatterEllipseLayer } from './ScatterEllipseLayer.tsx';
+export type { ScatterLabelLayerProps } from './ScatterLabelLayer.tsx';
+export { ScatterLabelLayer } from './ScatterLabelLayer.tsx';
+export type { ScatterMarkLayerProps, ScatterPixelMark, } from './ScatterMarkLayer.tsx';
+export { ScatterMarkLayer } from './ScatterMarkLayer.tsx';
+export { ScatterMatrix } from './ScatterMatrix.tsx';
+export type { ScatterMatrixCellProps } from './ScatterMatrixCell.tsx';
+export { ScatterMatrixCell } from './ScatterMatrixCell.tsx';
+export type { ScatterMatrixDiagonalProps, ScatterMatrixGrid, } from './ScatterMatrixDiagonal.tsx';
+export { ScatterMatrixDiagonal } from './ScatterMatrixDiagonal.tsx';
+export type { ScatterGroup, ScatterMarker, ScatterPlotProps, } from './ScatterPlot.tsx';
+export { ScatterPlot } from './ScatterPlot.tsx';
+export type { ScatterPointLayerProps } from './ScatterPointLayer.tsx';
+export { ScatterPointLayer } from './ScatterPointLayer.tsx';
+export type { FrameSlot, GestureModifiers, LassoGesture, LassoGestureOptions, ScatterSurfaceProps, } from './lassoGesture.ts';
+export { DEFAULT_LASSO_MIN_DISTANCE, MINIMUM_RING_VERTICES, capturePointer, dropFrame, modifierMode, scheduleFrame, surfacePosition, } from './lassoGesture.ts';
+export type { ScatterGroupSpread, ScatterGroupSpreadOptions, } from './scatterGroupSpread.ts';
+export type { LabelBox } from './scatterLabelBoxes.ts';
+export { LabelBoxField, SCATTER_GROUP_LABEL_SIZE, SCATTER_LABEL_SIZE, labelBoxHeight, labelBoxWidth, labelBoxesOverlap, } from './scatterLabelBoxes.ts';
+export type { ScatterLabelInk, ScatterPixelLabel } from './scatterLabels.ts';
+export { scatterGroupLabels, scatterPointLabels } from './scatterLabels.ts';
+export type { PlacedScatterLabel, ScatterLabelPlacementOptions, } from './scatterLabelPlacement.ts';
+export { placeScatterLabels } from './scatterLabelPlacement.ts';
+export { scatterGroupSpread, scatterPairEllipse, } from './scatterGroupSpread.ts';
+export { scatterMatrixDots } from './scatterMatrixDots.tsx';
+export { SCATTER_MATRIX_GAP, SCATTER_MATRIX_MARGINS, SCATTER_MATRIX_MOST_AXES, SCATTER_MATRIX_ROOM, SCATTER_MATRIX_SMALLEST_OUTLINE, SCATTER_MATRIX_SMALLEST_PLOT, scatterMatrixAxesThatFit, scatterMatrixPlotSide, scatterMatrixTickCount, } from './scatterMatrixLayout.ts';
+export { scatterMatrixOutlines } from './scatterMatrixOutlines.tsx';
+export type { ScatterMatrixAxis, ScatterMatrixProps, } from './scatterMatrixProps.ts';
+export type { ScatterOutlineInk } from './scatterOutlineShape.tsx';
+export { SCATTER_OUTLINE_FILL_OPACITY, scatterOutlineShape, } from './scatterOutlineShape.tsx';
+export { useLassoGesture } from './useLassoGesture.ts';
+export type { HoverAnchor, PointHoverApi, PointHoverOptions, } from './usePointHover.ts';
+export { DEFAULT_HOVER_RADIUS, usePointHover } from './usePointHover.ts';
+export type { ScatterFrame, ScatterFrameOptions } from './useScatterFrame.ts';
+export { useScatterFrame } from './useScatterFrame.ts';
+export type { ScatterInteractionApi, ScatterInteractionOptions, } from './useScatterInteraction.ts';
+export { useScatterInteraction } from './useScatterInteraction.ts';
+export type { ScatterKeyboardApi, ScatterKeyboardOptions, } from './useScatterKeyboard.ts';
+export { useScatterKeyboard } from './useScatterKeyboard.ts';
+export type { ScatterSelectionApi, ScatterSelectionOptions, SelectionChange, } from './useScatterSelection.ts';
+export { useScatterSelection } from './useScatterSelection.ts';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/scatter/ui/index.js

@@ -0,0 +1,34 @@
+/**
+ * A scatter plot the reader can interrogate: a lasso to select a crowd, a card
+ * on the point under the pointer, an outline per group, and the grid of every
+ * pair of axes.
+ *
+ * Nothing here knows what produced the coordinates. The same plot draws a
+ * principal component map, a UMAP embedding and a k-means run with its
+ * centroids, which is why it is its own domain rather than part of the viewer
+ * that happens to use it first.
+ */
+export { ScatterEllipseLayer } from "./ScatterEllipseLayer.js";
+export { ScatterLabelLayer } from "./ScatterLabelLayer.js";
+export { ScatterMarkLayer } from "./ScatterMarkLayer.js";
+export { ScatterMatrix } from "./ScatterMatrix.js";
+export { ScatterMatrixCell } from "./ScatterMatrixCell.js";
+export { ScatterMatrixDiagonal } from "./ScatterMatrixDiagonal.js";
+export { ScatterPlot } from "./ScatterPlot.js";
+export { ScatterPointLayer } from "./ScatterPointLayer.js";
+export { DEFAULT_LASSO_MIN_DISTANCE, MINIMUM_RING_VERTICES, capturePointer, dropFrame, modifierMode, scheduleFrame, surfacePosition, } from "./lassoGesture.js";
+export { LabelBoxField, SCATTER_GROUP_LABEL_SIZE, SCATTER_LABEL_SIZE, labelBoxHeight, labelBoxWidth, labelBoxesOverlap, } from "./scatterLabelBoxes.js";
+export { scatterGroupLabels, scatterPointLabels } from "./scatterLabels.js";
+export { placeScatterLabels } from "./scatterLabelPlacement.js";
+export { scatterGroupSpread, scatterPairEllipse, } from "./scatterGroupSpread.js";
+export { scatterMatrixDots } from "./scatterMatrixDots.js";
+export { SCATTER_MATRIX_GAP, SCATTER_MATRIX_MARGINS, SCATTER_MATRIX_MOST_AXES, SCATTER_MATRIX_ROOM, SCATTER_MATRIX_SMALLEST_OUTLINE, SCATTER_MATRIX_SMALLEST_PLOT, scatterMatrixAxesThatFit, scatterMatrixPlotSide, scatterMatrixTickCount, } from "./scatterMatrixLayout.js";
+export { scatterMatrixOutlines } from "./scatterMatrixOutlines.js";
+export { SCATTER_OUTLINE_FILL_OPACITY, scatterOutlineShape, } from "./scatterOutlineShape.js";
+export { useLassoGesture } from "./useLassoGesture.js";
+export { DEFAULT_HOVER_RADIUS, usePointHover } from "./usePointHover.js";
+export { useScatterFrame } from "./useScatterFrame.js";
+export { useScatterInteraction } from "./useScatterInteraction.js";
+export { useScatterKeyboard } from "./useScatterKeyboard.js";
+export { useScatterSelection } from "./useScatterSelection.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scatter/ui/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAEhE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAK5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAqB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAK5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA6B,CAAC;AAMpE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAQ5D,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,SAAS,EACT,YAAY,EACZ,aAAa,EACb,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAM3B,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAK5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAyB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,wBAAwB,EACxB,mBAAmB,EACnB,+BAA+B,EAC/B,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA6B,CAAC;AAMpE,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,GACpB,MAAM,0BAA2B,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAMvD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEzE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAKvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAKnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}