react-cheminfo 0.9.0 → 0.10.0

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

@@ -0,0 +1,103 @@
+import type { ScatterSelectionMode } from '../core/scatterSelection.ts';
+import type { ScreenPoints } from '../core/screenPoints.ts';
+import type { LassoGesture, ScatterSurfaceProps } from './lassoGesture.ts';
+import type { PointHoverApi } from './usePointHover.ts';
+import type { ScatterKeyboardApi } from './useScatterKeyboard.ts';
+import type { ScatterSelectionApi, SelectionChange } from './useScatterSelection.ts';
+/** What {@link useScatterInteraction} needs. */
+export interface ScatterInteractionOptions {
+    /** Where every point sits on screen; how many there are is read from it. */
+    points: ScreenPoints;
+    /**
+     * Where the plot's left edge is, so a gesture lands in the same space the
+     * points were measured in.
+     * @default 0
+     */
+    originX?: number;
+    /**
+     * Where its top edge is.
+     * @default 0
+     */
+    originY?: number;
+    /**
+     * The selected rows when the caller owns them.
+     * @default undefined — the hook keeps them
+     */
+    selected?: readonly number[];
+    /**
+     * The rows selected before the reader touches anything.
+     * @default undefined
+     */
+    defaultSelected?: readonly number[];
+    /**
+     * Called once per settled gesture, never during a drag.
+     * @default undefined
+     */
+    onSelectionChange?: (change: SelectionChange) => void;
+    /**
+     * What a gesture with no modifier held does to the selection.
+     * @default 'replace'
+     */
+    selectMode?: ScatterSelectionMode;
+    /**
+     * Whether a drag draws a lasso at all. The hover card works either way.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Whether a finger draws one rather than scrolling the page.
+     * @default false
+     */
+    touchLasso?: boolean;
+    /**
+     * How near the pointer a point must be to be hovered or clicked, in pixels.
+     * @default 12
+     */
+    hoverRadius?: number;
+    /**
+     * One entry per point, a zero meaning it cannot be hovered or clicked.
+     * @default undefined — every point can be
+     */
+    included?: Uint8Array;
+    /**
+     * Called with the row under the pointer, or `-1`.
+     * @default undefined
+     */
+    onHoverChange?: (index: number) => void;
+    /**
+     * Called with the row whose card is pinned, or `-1`.
+     * @default undefined
+     */
+    onPinChange?: (index: number) => void;
+}
+/** Everything a scatter needs to be touched, in five pieces. */
+export interface ScatterInteractionApi {
+    /** Spread onto the transparent rectangle over the plot. */
+    surface: ScatterSurfaceProps;
+    /** What is picked, including what a half-drawn lasso would pick. */
+    selection: ScatterSelectionApi;
+    /** The point a card is about, and where to put it. */
+    hover: PointHoverApi;
+    /** The roving cursor, whose `onKeyDown` goes on the focusable wrapper. */
+    keyboard: ScatterKeyboardApi;
+    /** The outline being drawn, for the plot to stroke. */
+    lasso: LassoGesture;
+}
+/**
+ * Every way a reader touches a scatter, wired together.
+ *
+ * The four hooks underneath are separately usable and separately tested; this
+ * is the one a plot calls, and it holds the decisions that only make sense
+ * between them — that a click on empty ground clears rather than selecting
+ * nothing, that hovering stops while a lasso is drawn, and that `Escape`
+ * abandons the drag and lets the card go.
+ *
+ * The buffer the polygon test writes into is kept across frames: a drag runs
+ * that test once a frame over every point, and a fresh mask per frame is an
+ * allocation the collector answers for during the one interaction where a
+ * dropped frame shows as a kink in the line being drawn.
+ * @param options - See {@link ScatterInteractionOptions}.
+ * @returns The interaction. See {@link ScatterInteractionApi}.
+ */
+export declare function useScatterInteraction(options: ScatterInteractionOptions): ScatterInteractionApi;
+//# sourceMappingURL=useScatterInteraction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScatterInteraction.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/useScatterInteraction.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAG5D,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,KAAK,EACV,mBAAmB,EACnB,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAGlC,gDAAgD;AAChD,MAAM,WAAW,yBAAyB;IACxC,4EAA4E;IAC5E,MAAM,EAAE,YAAY,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;OAGG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,OAAO,EAAE,mBAAmB,CAAC;IAC7B,oEAAoE;IACpE,SAAS,EAAE,mBAAmB,CAAC;IAC/B,sDAAsD;IACtD,KAAK,EAAE,aAAa,CAAC;IACrB,0EAA0E;IAC1E,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,uDAAuD;IACvD,KAAK,EAAE,YAAY,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,yBAAyB,GACjC,qBAAqB,CAqHvB"}

package/lib/scatter/ui/useScatterInteraction.js

@@ -0,0 +1,93 @@
+import { useCallback, useRef } from 'react';
+import { pointsInPolygon } from "../core/polygon.js";
+import { nearestPointIndex } from "../core/screenPoints.js";
+import { useLassoGesture } from "./useLassoGesture.js";
+import { DEFAULT_HOVER_RADIUS, usePointHover } from "./usePointHover.js";
+import { useScatterKeyboard } from "./useScatterKeyboard.js";
+import { useScatterSelection } from "./useScatterSelection.js";
+/**
+ * Every way a reader touches a scatter, wired together.
+ *
+ * The four hooks underneath are separately usable and separately tested; this
+ * is the one a plot calls, and it holds the decisions that only make sense
+ * between them — that a click on empty ground clears rather than selecting
+ * nothing, that hovering stops while a lasso is drawn, and that `Escape`
+ * abandons the drag and lets the card go.
+ *
+ * The buffer the polygon test writes into is kept across frames: a drag runs
+ * that test once a frame over every point, and a fresh mask per frame is an
+ * allocation the collector answers for during the one interaction where a
+ * dropped frame shows as a kink in the line being drawn.
+ * @param options - See {@link ScatterInteractionOptions}.
+ * @returns The interaction. See {@link ScatterInteractionApi}.
+ */
+export function useScatterInteraction(options) {
+    const { points, originX = 0, originY = 0, selected, defaultSelected, onSelectionChange, selectMode = 'replace', enabled = true, touchLasso = false, hoverRadius, included, onHoverChange, onPinChange, } = options;
+    const radius = hoverRadius ?? DEFAULT_HOVER_RADIUS;
+    const count = Math.min(points.x.length, points.y.length);
+    const hitsRef = useRef(null);
+    const selection = useScatterSelection({
+        count,
+        selected,
+        defaultSelected,
+        onSelectionChange,
+    });
+    const hover = usePointHover({
+        points,
+        radius,
+        included,
+        onHoverChange,
+        onPinChange,
+    });
+    const { clear, preview, select, selectMask } = selection;
+    const { leave, moveTo, pin, unpin } = hover;
+    const caught = useCallback((path) => {
+        const hits = pointsInPolygon(points, path.xs, path.ys, path.length, hitsRef.current ?? undefined);
+        hitsRef.current = hits;
+        return hits;
+    }, [points]);
+    const onDraw = useCallback((path, mode) => {
+        preview(path === null ? null : caught(path), mode);
+    }, [caught, preview]);
+    const onComplete = useCallback((path, mode) => {
+        selectMask(caught(path), mode, 'lasso');
+    }, [caught, selectMask]);
+    const onClick = useCallback((x, y, mode) => {
+        const index = nearestPointIndex(points, x, y, radius, included);
+        if (index === -1) {
+            unpin();
+            if (mode === 'replace')
+                clear();
+            return;
+        }
+        select([index], mode, 'point');
+        pin(index);
+    }, [clear, included, pin, points, radius, select, unpin]);
+    const onMove = useCallback((x, y, drawing) => {
+        if (!drawing)
+            moveTo(x, y);
+    }, [moveTo]);
+    const lasso = useLassoGesture({
+        enabled,
+        touch: touchLasso,
+        originX,
+        originY,
+        mode: selectMode,
+        onDraw,
+        onComplete,
+        onClick,
+        onMove,
+        onLeave: leave,
+    });
+    const onCommit = useCallback((index, mode) => {
+        select([index], mode, 'keyboard');
+        pin(index);
+    }, [pin, select]);
+    const onCancel = useCallback(() => {
+        lasso.cancel();
+        unpin();
+    }, [lasso, unpin]);
+    const keyboard = useScatterKeyboard({ count, onCommit, onCancel });
+    return { surface: lasso.surface, selection, hover, keyboard, lasso };
+}
+//# sourceMappingURL=useScatterInteraction.js.map

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

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

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

@@ -0,0 +1,60 @@
+import type { KeyboardEvent as ReactKeyboardEvent } from 'react';
+import type { ScatterSelectionMode } from '../core/scatterSelection.ts';
+/** What {@link useScatterKeyboard} needs. */
+export interface ScatterKeyboardOptions {
+    /** How many points the cloud holds. */
+    count: number;
+    /**
+     * Whether the keys are read. Off, the plot still takes the focus but every
+     * key falls through to the page.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * How many points `PageUp` and `PageDown` move by.
+     * @default 10
+     */
+    pageStep?: number;
+    /**
+     * Called whenever the cursor lands somewhere new, including `-1`.
+     * @default undefined
+     */
+    onCursorChange?: (index: number) => void;
+    /**
+     * Called when the reader commits the cursor with `Enter` or the space bar,
+     * with the mode the held modifiers ask for.
+     * @default undefined
+     */
+    onCommit?: (index: number, mode: ScatterSelectionMode) => void;
+    /**
+     * Called on `Escape` — what a half-drawn lasso and a pinned card listen for.
+     * @default undefined
+     */
+    onCancel?: () => void;
+}
+/** A roving cursor over the points, for a reader with no pointer. */
+export interface ScatterKeyboardApi {
+    /** The point the cursor is on, or `-1` before any key. */
+    cursor: number;
+    /** Move it from outside, so a click and the cursor agree on where they are. */
+    setCursor: (index: number) => void;
+    /** Put on the focusable element around the plot. */
+    onKeyDown: (event: ReactKeyboardEvent<Element>) => void;
+}
+/**
+ * Reaching every point of a scatter without a pointer.
+ *
+ * The same roving cursor the periodic table and every list in this family use,
+ * over the same `handleListNavigationKey`, so the arrows, the page keys and
+ * `Home` and `End` behave identically wherever a reader meets them. Without
+ * it a lasso is the only way to pick anything, and a lasso needs a hand.
+ *
+ * The cursor is not the selection. It says where the reader is; `Enter` or the
+ * space bar is what settles it, with Shift and Alt meaning what they mean
+ * during a drag — otherwise arrowing across a cloud would replace the
+ * selection on every step and the reader could never build one up.
+ * @param options - See {@link ScatterKeyboardOptions}.
+ * @returns The cursor. See {@link ScatterKeyboardApi}.
+ */
+export declare function useScatterKeyboard(options: ScatterKeyboardOptions): ScatterKeyboardApi;
+//# sourceMappingURL=useScatterKeyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScatterKeyboard.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/useScatterKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAIjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAIxE,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC/D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,SAAS,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC;CACzD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB,CAmDpB"}

package/lib/scatter/ui/useScatterKeyboard.js

@@ -0,0 +1,56 @@
+import { useCallback, useRef, useState } from 'react';
+import { handleListNavigationKey } from "../../hooks/ui/listNavigation.js";
+import { modifierMode } from "./lassoGesture.js";
+/**
+ * Reaching every point of a scatter without a pointer.
+ *
+ * The same roving cursor the periodic table and every list in this family use,
+ * over the same `handleListNavigationKey`, so the arrows, the page keys and
+ * `Home` and `End` behave identically wherever a reader meets them. Without
+ * it a lasso is the only way to pick anything, and a lasso needs a hand.
+ *
+ * The cursor is not the selection. It says where the reader is; `Enter` or the
+ * space bar is what settles it, with Shift and Alt meaning what they mean
+ * during a drag — otherwise arrowing across a cloud would replace the
+ * selection on every step and the reader could never build one up.
+ * @param options - See {@link ScatterKeyboardOptions}.
+ * @returns The cursor. See {@link ScatterKeyboardApi}.
+ */
+export function useScatterKeyboard(options) {
+    const { count, enabled = true, pageStep, onCursorChange, onCommit, onCancel, } = options;
+    const [cursor, setCursorState] = useState(-1);
+    const cursorRef = useRef(-1);
+    const setCursor = useCallback((index) => {
+        const next = Number.isInteger(index) && index >= 0 && index < count ? index : -1;
+        if (next === cursorRef.current)
+            return;
+        cursorRef.current = next;
+        setCursorState(next);
+        onCursorChange?.(next);
+    }, [count, onCursorChange]);
+    const onKeyDown = useCallback((event) => {
+        if (!enabled || count <= 0)
+            return;
+        if (event.key === 'Escape') {
+            event.preventDefault();
+            onCancel?.();
+            return;
+        }
+        if (event.key === 'Enter' || event.key === ' ') {
+            const index = cursorRef.current;
+            if (index === -1)
+                return;
+            event.preventDefault();
+            onCommit?.(index, modifierMode(event, 'replace'));
+            return;
+        }
+        handleListNavigationKey(event, {
+            length: count,
+            selectedIndex: cursorRef.current,
+            pageStep,
+            onSelect: setCursor,
+        });
+    }, [count, enabled, onCancel, onCommit, pageStep, setCursor]);
+    return { cursor, setCursor, onKeyDown };
+}
+//# sourceMappingURL=useScatterKeyboard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScatterKeyboard.js","sourceRoot":"","sources":["../../../src/scatter/ui/useScatterKeyboard.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA6CjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA+B;IAE/B,MAAM,EACJ,KAAK,EACL,OAAO,GAAG,IAAI,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,GAAG,OAAO,CAAC;IAEZ,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7B,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,KAAa,EAAE,EAAE;QAChB,MAAM,IAAI,GACR,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,IAAI,IAAI,KAAK,SAAS,CAAC,OAAO;YAAE,OAAO;QACvC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QACzB,cAAc,CAAC,IAAI,CAAC,CAAC;QACrB,cAAc,EAAE,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,EACD,CAAC,KAAK,EAAE,cAAc,CAAC,CACxB,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,KAAkC,EAAE,EAAE;QACrC,IAAI,CAAC,OAAO,IAAI,KAAK,IAAI,CAAC;YAAE,OAAO;QACnC,IAAI,KAAK,CAAC,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC3B,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,QAAQ,EAAE,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,KAAK,OAAO,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;YAC/C,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC;YAChC,IAAI,KAAK,KAAK,CAAC,CAAC;gBAAE,OAAO;YACzB,KAAK,CAAC,cAAc,EAAE,CAAC;YACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,uBAAuB,CAAC,KAAK,EAAE;YAC7B,MAAM,EAAE,KAAK;YACb,aAAa,EAAE,SAAS,CAAC,OAAO;YAChC,QAAQ;YACR,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC,EACD,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC,CAC1D,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,78 @@
+import type { ScatterSelectionMode } from '../core/scatterSelection.ts';
+/** What a gesture did to a scatter's selection. */
+export interface SelectionChange {
+    /** The selected rows, ascending, as indices into the arrays the caller passed. */
+    indices: readonly number[];
+    /** Whether the gesture replaced the previous selection, added to it, or cut from it. */
+    mode: ScatterSelectionMode;
+    /** Which gesture produced it. */
+    source: 'lasso' | 'point' | 'keyboard' | 'clear' | 'all';
+}
+/** What {@link useScatterSelection} needs. */
+export interface ScatterSelectionOptions {
+    /** How many points the cloud holds. */
+    count: number;
+    /**
+     * The selected rows when the caller owns them. Present, it wins over
+     * anything the reader has done here — see {@link useScatterSelection} for
+     * what that means for a caller that stops passing it.
+     * @default undefined — the hook keeps the selection itself
+     */
+    selected?: readonly number[];
+    /**
+     * The rows selected before the reader touches anything, for the uncontrolled
+     * case. It is read once; changing it later moves nothing.
+     * @default undefined — nothing is selected
+     */
+    defaultSelected?: readonly number[];
+    /**
+     * Called once per settled gesture, never while a lasso is being drawn.
+     * @default undefined
+     */
+    onSelectionChange?: (change: SelectionChange) => void;
+}
+/** A scatter's selection, and the four ways a gesture changes it. */
+export interface ScatterSelectionApi {
+    /**
+     * One entry per point, `1` for selected. It includes whatever a lasso is
+     * currently previewing, so the dots under a half-drawn ring already look
+     * picked.
+     */
+    mask: Uint8Array;
+    /** The same, as ascending indices. */
+    indices: number[];
+    /** How many points that is, without walking the list again. */
+    selectedCount: number;
+    /** Whether a lasso is showing what it would do rather than having done it. */
+    previewing: boolean;
+    /** Settle a new selection from a list of rows. */
+    select: (rows: Iterable<number>, mode?: ScatterSelectionMode, source?: SelectionChange['source']) => void;
+    /** Settle one from a mask, which is the shape a lasso hands back. */
+    selectMask: (hits: Uint8Array, mode?: ScatterSelectionMode, source?: SelectionChange['source']) => void;
+    /** Show what a gesture would do without settling it; `null` clears it. */
+    preview: (hits: Uint8Array | null, mode?: ScatterSelectionMode) => void;
+    /** Empty the selection. */
+    clear: () => void;
+    /** Select every point. */
+    selectAll: () => void;
+}
+/**
+ * The set of points a scatter has picked out, controlled or not.
+ *
+ * A caller may own the selection and pass it back through `selected`, or leave
+ * it here and only listen. Both work through one hook, and the controlled
+ * value wins on every render: a parent that answers a change by passing
+ * something else — a filter that keeps only the rows still on screen — sees
+ * what it asked for and not what the gesture asked for. The hook keeps its own
+ * copy up to date all the same, so a caller that stops passing `selected`
+ * carries on from where the reader left off rather than from nothing.
+ *
+ * A preview is deliberately not a change. What a half-drawn lasso would catch
+ * is merged in for the render and never reported, which is what lets a
+ * controlled parent stay out of a drag it would otherwise be re-rendered by
+ * sixty times a second.
+ * @param options - See {@link ScatterSelectionOptions}.
+ * @returns The selection. See {@link ScatterSelectionApi}.
+ */
+export declare function useScatterSelection(options: ScatterSelectionOptions): ScatterSelectionApi;
+//# sourceMappingURL=useScatterSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScatterSelection.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/useScatterSelection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOxE,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,wFAAwF;IACxF,IAAI,EAAE,oBAAoB,CAAC;IAC3B,iCAAiC;IACjC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,KAAK,CAAC;CAC1D;AAED,8CAA8C;AAC9C,MAAM,WAAW,uBAAuB;IACtC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B;;;;OAIG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;CACvD;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC;IACjB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,UAAU,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,MAAM,EAAE,CACN,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,EACtB,IAAI,CAAC,EAAE,oBAAoB,EAC3B,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,KAC/B,IAAI,CAAC;IACV,qEAAqE;IACrE,UAAU,EAAE,CACV,IAAI,EAAE,UAAU,EAChB,IAAI,CAAC,EAAE,oBAAoB,EAC3B,MAAM,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,KAC/B,IAAI,CAAC;IACV,0EAA0E;IAC1E,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACxE,2BAA2B;IAC3B,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,uBAAuB,GAC/B,mBAAmB,CAgFrB"}

package/lib/scatter/ui/useScatterSelection.js

@@ -0,0 +1,72 @@
+import { useCallback, useMemo, useState } from 'react';
+import { mergeScatterSelection, scatterSelectedIndices, scatterSelectionMask, } from "../core/scatterSelection.js";
+/**
+ * The set of points a scatter has picked out, controlled or not.
+ *
+ * A caller may own the selection and pass it back through `selected`, or leave
+ * it here and only listen. Both work through one hook, and the controlled
+ * value wins on every render: a parent that answers a change by passing
+ * something else — a filter that keeps only the rows still on screen — sees
+ * what it asked for and not what the gesture asked for. The hook keeps its own
+ * copy up to date all the same, so a caller that stops passing `selected`
+ * carries on from where the reader left off rather than from nothing.
+ *
+ * A preview is deliberately not a change. What a half-drawn lasso would catch
+ * is merged in for the render and never reported, which is what lets a
+ * controlled parent stay out of a drag it would otherwise be re-rendered by
+ * sixty times a second.
+ * @param options - See {@link ScatterSelectionOptions}.
+ * @returns The selection. See {@link ScatterSelectionApi}.
+ */
+export function useScatterSelection(options) {
+    const { count, selected, defaultSelected, onSelectionChange } = options;
+    const [own, setOwn] = useState(defaultSelected ?? EMPTY);
+    const [draft, setDraft] = useState(null);
+    const committed = selected ?? own;
+    const mask = useMemo(() => {
+        const base = scatterSelectionMask(committed, count);
+        if (draft === null)
+            return base;
+        return mergeScatterSelection(base, draft.hits, draft.mode, base);
+    }, [committed, count, draft]);
+    const indices = useMemo(() => scatterSelectedIndices(mask), [mask]);
+    const commit = useCallback((rows, mode, source) => {
+        setDraft(null);
+        setOwn(rows);
+        onSelectionChange?.({ indices: rows, mode, source });
+    }, [onSelectionChange]);
+    const selectMask = useCallback((hits, mode = 'replace', source = 'lasso') => {
+        const base = scatterSelectionMask(committed, count);
+        const merged = mergeScatterSelection(base, hits, mode, base);
+        commit(scatterSelectedIndices(merged), mode, source);
+    }, [commit, committed, count]);
+    const select = useCallback((rows, mode = 'replace', source = 'point') => {
+        selectMask(scatterSelectionMask(rows, count), mode, source);
+    }, [count, selectMask]);
+    const preview = useCallback((hits, mode = 'replace') => {
+        setDraft(hits === null ? null : { hits, mode });
+    }, []);
+    const clear = useCallback(() => {
+        commit([], 'replace', 'clear');
+    }, [commit]);
+    const selectAll = useCallback(() => {
+        const rows = new Array(Math.max(0, count));
+        for (let index = 0; index < rows.length; index++)
+            rows[index] = index;
+        commit(rows, 'replace', 'all');
+    }, [commit, count]);
+    return {
+        mask,
+        indices,
+        selectedCount: indices.length,
+        previewing: draft !== null,
+        select,
+        selectMask,
+        preview,
+        clear,
+        selectAll,
+    };
+}
+/** Shared, so an uncontrolled scatter with nothing picked allocates nothing. */
+const EMPTY = [];
+//# sourceMappingURL=useScatterSelection.js.map

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

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

package/lib/share/core/query.d.ts

@@ -12,10 +12,16 @@ export type QueryEntry = readonly [key: string, value: string];
  */
 export declare function parseQuery(search: string): QueryEntry[];
 /**
- * Write pairs back into a query string, keeping the two characters a reader
- * of these links cares about legible: a comma stays a comma rather than
- * `%2C`, and a plus stays a plus rather than `%2B`. Both parse back
- * identically through {@link parseQuery}.
+ * Write pairs back into a query string, keeping the comma legible — `hide=a,b`
+ * rather than `hide=a%2Cb` — because a teacher has to read these links, and a
+ * comma has only one reading.
+ *
+ * A plus is written `%2B`, even though {@link parseQuery} would read a literal
+ * one back. We are liberal in what we accept and strict in what we write: a
+ * bare `+` in a query string is read as a space by `URLSearchParams`,
+ * `query-string` and every server-side parser, so `ionizations=H+` comes back
+ * as `H ` and `smiles=CC[N+](C)(C)C` as a different molecule — silently,
+ * anywhere the link is read by something other than {@link parseQuery}.
  * @param entries - The pairs to write, in the order they should appear.
  * @returns The query string, without its leading `?`.
  */

package/lib/share/core/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAYvD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7B"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAYvD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAMrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,UAAU,EAAE,GAC7B,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAM7B"}

package/lib/share/core/query.js

@@ -24,10 +24,16 @@ export function parseQuery(search) {
     return entries;
 }
 /**
- * Write pairs back into a query string, keeping the two characters a reader
- * of these links cares about legible: a comma stays a comma rather than
- * `%2C`, and a plus stays a plus rather than `%2B`. Both parse back
- * identically through {@link parseQuery}.
+ * Write pairs back into a query string, keeping the comma legible — `hide=a,b`
+ * rather than `hide=a%2Cb` — because a teacher has to read these links, and a
+ * comma has only one reading.
+ *
+ * A plus is written `%2B`, even though {@link parseQuery} would read a literal
+ * one back. We are liberal in what we accept and strict in what we write: a
+ * bare `+` in a query string is read as a space by `URLSearchParams`,
+ * `query-string` and every server-side parser, so `ionizations=H+` comes back
+ * as `H ` and `smiles=CC[N+](C)(C)C` as a different molecule — silently,
+ * anywhere the link is read by something other than {@link parseQuery}.
  * @param entries - The pairs to write, in the order they should appear.
  * @returns The query string, without its leading `?`.
  */
@@ -61,8 +67,6 @@ function decodeComponent(value) {
     }
 }
 function encodeComponent(value) {
-    return encodeURIComponent(value)
-        .replaceAll('%2C', ',')
-        .replaceAll('%2B', '+');
+    return encodeURIComponent(value).replaceAll('%2C', ',');
 }
 //# sourceMappingURL=query.js.map

package/lib/share/core/query.js.map

@@ -1 +1 @@
-{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,OAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,kBAAkB,CAAC,KAAK,CAAC;SAC7B,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC;SACtB,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../../src/share/core/query.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/D,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,IAAI,IAAI,KAAK,EAAE;QAAE,OAAO,OAAO,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QAC3B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CACzB,OAA8B;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC1D,CAAC"}

package/lib/spectra/core/axisEntries.d.ts

@@ -0,0 +1,50 @@
+export declare const AXIS_ENTRIES: {
+    readonly xFunction: {
+        readonly label: "Apply a formula to x";
+        readonly group: "x-axis";
+        readonly summary: "Rewrites every x through an expression, read the same way as the y one.";
+        readonly fields: readonly [import("./filterFields.ts").FilterField];
+        readonly caution: "Every range below is then read in the new units — including the resampling range, which runs last unless you resample first.";
+    };
+    readonly fromTo: {
+        readonly label: "Crop";
+        readonly group: "x-axis";
+        readonly summary: "Keeps one stretch of the spectrum and drops the rest.";
+        readonly fields: readonly [...import("./filterFields.ts").FilterField[], import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField];
+        readonly caution: "Give x values or point numbers, not both: a point number silently wins over an x value.";
+    };
+    readonly filterX: {
+        readonly label: "Keep or drop x zones";
+        readonly group: "x-axis";
+        readonly summary: "Keeps the points falling in the zones named, without resampling anything.";
+        readonly fields: readonly import("./filterFields.ts").FilterField[];
+    };
+    readonly equallySpaced: {
+        readonly label: "Resample on a regular grid";
+        readonly group: "x-axis";
+        readonly summary: "Interpolates onto evenly spaced x values.";
+        readonly fields: readonly import("./filterFields.ts").FilterField[];
+        readonly caution: "The settings above already resample once, so this resamples twice; whichever of the two runs last sets the point count.";
+    };
+    readonly calibrateX: {
+        readonly label: "Calibrate x on a peak";
+        readonly group: "x-axis";
+        readonly summary: "Finds the strongest peaks in a stretch and shifts the whole axis so their mean lands on the value asked for.";
+        readonly fields: readonly [...import("./filterFields.ts").FilterField[], import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField, import("./filterFields.ts").FilterField];
+        readonly caution: "When fewer peaks are found than asked for, the spectrum is returned untouched and nothing says so.";
+    };
+    readonly ensureGrowing: {
+        readonly label: "Make x strictly increasing";
+        readonly group: "utility";
+        readonly summary: "Drops the points that repeat or go backwards, which resampling and cropping both assume never happens.";
+        readonly fields: readonly [];
+    };
+    readonly reverseIfNeeded: {
+        readonly label: "Reverse a descending x";
+        readonly group: "utility";
+        readonly summary: "Turns a descending axis the right way round.";
+        readonly fields: readonly [];
+        readonly caution: "The chain already does this before every step, so adding it here changes nothing.";
+    };
+};
+//# sourceMappingURL=axisEntries.d.ts.map

package/lib/spectra/core/axisEntries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axisEntries.d.ts","sourceRoot":"","sources":["../../../src/spectra/core/axisEntries.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG8B,CAAC"}