react-cheminfo 0.14.0 → 0.16.0

package/lib/parallel/core/parallelPaint.js

@@ -0,0 +1,160 @@
+/**
+ * The lines, painted into a canvas.
+ *
+ * The first canvas figure in the family, and for one reason: ten thousand
+ * polylines of a dozen points each is a hundred and twenty thousand SVG
+ * coordinates the browser would keep as elements. Everything a reader points
+ * at, brushes or reads is still SVG or HTML over the top, so only the mass of
+ * lines is pixels — which is also why saving the figure keeps the axes and
+ * loses the lines, and why a site that needs a downloadable figure should say
+ * so before choosing this one.
+ */
+import { PARALLEL_MARGIN, parallelPixelAt } from "./parallelAxes.js";
+/** How strongly one kept line is drawn, so that the mass reads as a density. */
+export const PARALLEL_INCLUDED_ALPHA = 0.35;
+/** How wide a singled-out line's halo is, in pixels. */
+const HALO_WIDTH = 5;
+/** How wide a singled-out line itself is. */
+const HIGHLIGHT_WIDTH = 2;
+/** How large the dot at each of its axis crossings is. */
+const HIGHLIGHT_DOT_RADIUS = 3;
+const FULL_TURN = 2 * Math.PI;
+/**
+ * Resize a canvas to the device pixel grid and move its origin to the drawing
+ * area, which also clears whatever it held.
+ * @param canvas - The canvas, or `null` before it is mounted.
+ * @param width - Width of the figure, in CSS pixels.
+ * @param height - Its height, in CSS pixels.
+ * @returns The context, or `null` when there is nothing to draw on.
+ */
+export function preparePlotCanvas(canvas, width, height) {
+    if (canvas === null)
+        return null;
+    const context = canvas.getContext('2d');
+    if (context === null)
+        return null;
+    const pixelRatio = Math.max(globalThis.devicePixelRatio || 1, 1);
+    // Assigning the backing store is what clears it; there is no second clear.
+    canvas.width = Math.round(width * pixelRatio);
+    canvas.height = Math.round(height * pixelRatio);
+    context.resetTransform();
+    context.scale(pixelRatio, pixelRatio);
+    context.translate(PARALLEL_MARGIN.left, PARALLEL_MARGIN.top);
+    return context;
+}
+/**
+ * Draw one line per row: the ones a brush left out first, underneath, then the
+ * kept ones over them.
+ *
+ * The excluded rows are one single path stroked once, in a light grey rather
+ * than a translucent black: overlapping segments of one stroked path
+ * accumulate alpha, so a translucent black saturates to black wherever the
+ * library is dense, while a light grey is a colour the pile can only converge
+ * on.
+ * @param context - A context already scaled and moved to the drawing area by {@link preparePlotCanvas}.
+ * @param paint - See {@link ParallelPaint}.
+ */
+export function paintParallelLines(context, paint) {
+    const { layouts, values, count, line, excluded, includedAlpha } = paint;
+    if (layouts.length < 2)
+        return;
+    const included = paint.included ?? null;
+    const steps = paint.steps ?? null;
+    const palette = paint.palette ?? [];
+    context.lineWidth = 1;
+    if (included !== null) {
+        context.strokeStyle = excluded;
+        context.beginPath();
+        for (let row = 0; row < count; row++) {
+            if (included[row] !== 0)
+                continue;
+            traceParallelRow(context, row, layouts, values);
+        }
+        context.stroke();
+    }
+    context.globalAlpha = includedAlpha ?? PARALLEL_INCLUDED_ALPHA;
+    context.strokeStyle = line;
+    let previousStep = -1;
+    for (let row = 0; row < count; row++) {
+        if (included !== null && included[row] === 0)
+            continue;
+        if (steps !== null) {
+            const step = steps[row];
+            if (step !== previousStep) {
+                const color = palette[step];
+                if (color !== undefined)
+                    context.strokeStyle = color;
+                previousStep = step;
+            }
+        }
+        context.beginPath();
+        traceParallelRow(context, row, layouts, values);
+        context.stroke();
+    }
+    context.globalAlpha = 1;
+}
+/**
+ * Draw a few singled-out rows over the mass, each over a halo and dotted at
+ * every axis crossing.
+ * @param context - A context already scaled and moved to the drawing area.
+ * @param paint - See {@link ParallelHighlightPaint}.
+ */
+export function paintParallelHighlights(context, paint) {
+    const { highlights, layouts, values, halo } = paint;
+    if (layouts.length < 2)
+        return;
+    context.lineJoin = 'round';
+    context.lineCap = 'round';
+    for (const { row, color } of highlights) {
+        context.beginPath();
+        traceParallelRow(context, row, layouts, values);
+        context.strokeStyle = halo;
+        context.lineWidth = HALO_WIDTH;
+        context.stroke();
+        context.strokeStyle = color;
+        context.lineWidth = HIGHLIGHT_WIDTH;
+        context.stroke();
+        context.fillStyle = color;
+        for (let index = 0; index < layouts.length; index++) {
+            const layout = layouts[index];
+            const column = values[index];
+            if (layout === undefined || column === undefined)
+                continue;
+            const y = parallelPixelAt(layout.pixels, column[row]);
+            if (!Number.isFinite(y))
+                continue;
+            context.beginPath();
+            context.arc(layout.x, y, HIGHLIGHT_DOT_RADIUS, 0, FULL_TURN);
+            context.fill();
+        }
+    }
+}
+/**
+ * Add one row's line to the path being built.
+ * @param context - A context already scaled and moved to the drawing area.
+ * @param row - The row to trace.
+ * @param layouts - The axes, from left to right.
+ * @param values - Each axis's column, in the same order.
+ */
+export function traceParallelRow(context, row, layouts, values) {
+    let started = false;
+    for (let index = 0; index < layouts.length; index++) {
+        const layout = layouts[index];
+        const column = values[index];
+        if (layout === undefined || column === undefined)
+            continue;
+        const y = parallelPixelAt(layout.pixels, column[row]);
+        // A row whose value on this axis is not known yet has no point to draw:
+        // the line skips that axis rather than collapsing onto one of its ends.
+        if (!Number.isFinite(y))
+            continue;
+        if (started) {
+            context.lineTo(layout.x, y);
+        }
+        else {
+            context.moveTo(layout.x, y);
+            started = true;
+        }
+    }
+}
+//# sourceMappingURL=parallelPaint.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * The colour each line is drawn in, as a step into a sampled ramp.
+ *
+ * A canvas reassigns `strokeStyle` once per line, and a thousand different
+ * colours is a thousand style writes. Quantising the ramp to 121 steps and
+ * keeping the rows in the order they came means the style is written about
+ * 121 times for the whole figure — while no reader can tell a hundred-and-
+ * twenty-first of a ramp apart from its neighbour.
+ */
+import type { ColorScale } from '../../color/core/interpolate.ts';
+import type { ParallelColorBy } from './parallelTypes.ts';
+/** How many steps the ramp is quantised into; there is one more colour than steps. */
+export declare const PARALLEL_PALETTE_STEPS = 120;
+/**
+ * The ramp, sampled into the steps a line's colour is looked up by.
+ * @param scale - The ramp, as the registry hands it over or as a plain list of colours. Defaults to viridis.
+ * @returns `PARALLEL_PALETTE_STEPS + 1` colours, from the low end to the high end.
+ */
+export declare function parallelPalette(scale?: ColorScale | readonly string[]): readonly string[];
+/**
+ * Which step of the ramp each row takes.
+ *
+ * Worked out once per data change rather than per repaint, and held as bytes:
+ * a library of ten thousand rows costs ten kilobytes and the painter's inner
+ * loop reads an integer instead of placing a value on a ramp.
+ * @param color - The quantity the lines are coloured by.
+ * @param count - How many rows there are.
+ * @returns One step per row, from `0` to {@link PARALLEL_PALETTE_STEPS}.
+ */
+export declare function parallelColorSteps(color: ParallelColorBy, count: number): Uint8Array;
+//# sourceMappingURL=parallelPalette.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelPalette.d.ts","sourceRoot":"","sources":["../../../src/parallel/core/parallelPalette.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAOlE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,CAAC,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,GACrC,SAAS,MAAM,EAAE,CAEnB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,eAAe,EACtB,KAAK,EAAE,MAAM,GACZ,UAAU,CAkBZ"}

package/lib/parallel/core/parallelPalette.js

@@ -0,0 +1,68 @@
+/**
+ * The colour each line is drawn in, as a step into a sampled ramp.
+ *
+ * A canvas reassigns `strokeStyle` once per line, and a thousand different
+ * colours is a thousand style writes. Quantising the ramp to 121 steps and
+ * keeping the rows in the order they came means the style is written about
+ * 121 times for the whole figure — while no reader can tell a hundred-and-
+ * twenty-first of a ramp apart from its neighbour.
+ */
+import { evenScale, sampleScale } from "../../color/core/interpolate.js";
+import { positionInRange } from "../../color/core/scale.js";
+import { resolveColorScale } from "../../color/core/scaleText.js";
+import { DEFAULT_COLOR_SCALE_ID } from "../../color/core/scales.js";
+import { parallelExtent } from "./parallelExtent.js";
+/** How many steps the ramp is quantised into; there is one more colour than steps. */
+export const PARALLEL_PALETTE_STEPS = 120;
+/**
+ * The ramp, sampled into the steps a line's colour is looked up by.
+ * @param scale - The ramp, as the registry hands it over or as a plain list of colours. Defaults to viridis.
+ * @returns `PARALLEL_PALETTE_STEPS + 1` colours, from the low end to the high end.
+ */
+export function parallelPalette(scale) {
+    return sampleScale(resolveRamp(scale), PARALLEL_PALETTE_STEPS + 1);
+}
+/**
+ * Which step of the ramp each row takes.
+ *
+ * Worked out once per data change rather than per repaint, and held as bytes:
+ * a library of ten thousand rows costs ten kilobytes and the painter's inner
+ * loop reads an integer instead of placing a value on a ramp.
+ * @param color - The quantity the lines are coloured by.
+ * @param count - How many rows there are.
+ * @returns One step per row, from `0` to {@link PARALLEL_PALETTE_STEPS}.
+ */
+export function parallelColorSteps(color, count) {
+    const steps = new Uint8Array(count);
+    const extent = parallelExtent(color.values, count);
+    const min = color.min ?? extent.min;
+    const max = color.max ?? extent.max;
+    const logarithmic = color.logarithmic ?? false;
+    const span = max - min;
+    const rows = Math.min(count, color.values.length);
+    for (let row = 0; row < rows; row++) {
+        const value = color.values[row];
+        steps[row] = logarithmic
+            ? Math.round(positionInRange(value, min, max, { logarithmic: true }) *
+                PARALLEL_PALETTE_STEPS)
+            : colorStep(value, min, span);
+    }
+    return steps;
+}
+function resolveRamp(scale) {
+    if (scale === undefined) {
+        return resolveColorScale(DEFAULT_COLOR_SCALE_ID).scale;
+    }
+    return 'stops' in scale ? scale : evenScale(scale);
+}
+function colorStep(value, min, span) {
+    if (span <= 0)
+        return 0;
+    const ratio = (value - min) / span;
+    if (Number.isNaN(ratio) || ratio < 0)
+        return 0;
+    if (ratio > 1)
+        return PARALLEL_PALETTE_STEPS;
+    return Math.round(ratio * PARALLEL_PALETTE_STEPS);
+}
+//# sourceMappingURL=parallelPalette.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelPalette.js","sourceRoot":"","sources":["../../../src/parallel/core/parallelPalette.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,sFAAsF;AACtF,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAsC;IAEtC,OAAO,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,sBAAsB,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsB,EACtB,KAAa;IAEb,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACnD,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC;IACpC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC;IAC/C,MAAM,IAAI,GAAG,GAAG,GAAG,GAAG,CAAC;IACvB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClD,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAW,CAAC;QAC1C,KAAK,CAAC,GAAG,CAAC,GAAG,WAAW;YACtB,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gBACrD,sBAAsB,CACzB;YACH,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAsC;IACzD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,KAAK,CAAC;IACzD,CAAC;IACD,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,KAAa,EAAE,GAAW,EAAE,IAAY;IACzD,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,CAAC,CAAC;IACxB,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,sBAAsB,CAAC,CAAC;AACpD,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * How one axis is graduated.
+ *
+ * Five evenly spaced marks across the raw extent, not `chartAxisScale`'s nice
+ * ones: nicing moves the ends of the axis, and a figure whose whole job is to
+ * compare rows against each other must end exactly where the data does. A
+ * caller who wants round numbers asks for them with `nice`, per axis.
+ */
+import type { ParallelAxis, ParallelTick } from './parallelTypes.ts';
+/** How many graduations an axis carries when the caller asks for no number. */
+export declare const PARALLEL_TICK_COUNT = 5;
+/** An axis's ends and the graduations written along it. */
+export interface ParallelGraduation {
+    /** The two ends of the axis, low first, after any nicing. */
+    domain: readonly [number, number];
+    /** The graduations, from the bottom of the axis to the top. */
+    ticks: readonly ParallelTick[];
+}
+/**
+ * The graduations of one axis, and the ends they are spread between.
+ *
+ * Three ways, in order: the caller's own list wins outright — a coded quantity
+ * reading `none`, `low`, `high` is nobody else's to invent; `nice` hands the
+ * axis to `chartAxisScale`, which rounds both ends outward to whole steps; and
+ * otherwise the extent is divided evenly and a mark whose label repeats the
+ * one below it is dropped, so an axis of whole numbers from 0 to 2 reads
+ * `0 1 2` rather than writing `1` twice.
+ * @param axis - The axis, for its formatting and how many marks it wants.
+ * @param min - The value at the bottom of the axis.
+ * @param max - The value at its top.
+ * @returns The ends and the graduations. See {@link ParallelGraduation}.
+ */
+export declare function parallelTicks(axis: ParallelAxis, min: number, max: number): ParallelGraduation;
+//# sourceMappingURL=parallelTicks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parallelTicks.d.ts","sourceRoot":"","sources":["../../../src/parallel/core/parallelTicks.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAQrC,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,6DAA6D;IAC7D,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,+DAA+D;IAC/D,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;CAChC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,kBAAkB,CAWpB"}

package/lib/parallel/core/parallelTicks.js

@@ -0,0 +1,116 @@
+/**
+ * How one axis is graduated.
+ *
+ * Five evenly spaced marks across the raw extent, not `chartAxisScale`'s nice
+ * ones: nicing moves the ends of the axis, and a figure whose whole job is to
+ * compare rows against each other must end exactly where the data does. A
+ * caller who wants round numbers asks for them with `nice`, per axis.
+ */
+import { chartAxisScale, chartTickDecimals, } from "../../chart/core/chartAxisScale.js";
+import { formatDecimal } from "../../format/core/numbers.js";
+import { roundTo } from "../../format/core/roundTo.js";
+/** How many graduations an axis carries when the caller asks for no number. */
+export const PARALLEL_TICK_COUNT = 5;
+/** The most decimals a graduation is ever written with. */
+const MOST_TICK_DECIMALS = 6;
+/** How far a label may sit from its own value: a tenth of the spacing. */
+const LABEL_TOLERANCE = 10;
+/**
+ * The graduations of one axis, and the ends they are spread between.
+ *
+ * Three ways, in order: the caller's own list wins outright — a coded quantity
+ * reading `none`, `low`, `high` is nobody else's to invent; `nice` hands the
+ * axis to `chartAxisScale`, which rounds both ends outward to whole steps; and
+ * otherwise the extent is divided evenly and a mark whose label repeats the
+ * one below it is dropped, so an axis of whole numbers from 0 to 2 reads
+ * `0 1 2` rather than writing `1` twice.
+ * @param axis - The axis, for its formatting and how many marks it wants.
+ * @param min - The value at the bottom of the axis.
+ * @param max - The value at its top.
+ * @returns The ends and the graduations. See {@link ParallelGraduation}.
+ */
+export function parallelTicks(axis, min, max) {
+    const domain = [min, max];
+    if (axis.ticks !== undefined)
+        return { domain, ticks: axis.ticks };
+    const wanted = Math.max(2, Math.trunc(axis.tickCount ?? PARALLEL_TICK_COUNT));
+    if (axis.nice === true && axis.scale !== 'log') {
+        return nicedGraduation(axis, min, max, wanted);
+    }
+    const values = evenValues(min, max, wanted, axis.scale === 'log');
+    return { domain, ticks: labelled(values, axis.format) };
+}
+function nicedGraduation(axis, min, max, wanted) {
+    const scale = chartAxisScale(min, max, { count: wanted, nice: true });
+    const ticks = [];
+    for (let index = 0; index < scale.values.length; index++) {
+        const value = scale.values[index];
+        const label = axis.format === undefined
+            ? (scale.labels[index] ?? formatDecimal(value, scale.decimals))
+            : axis.format(value);
+        if (ticks.at(-1)?.label === label)
+            continue;
+        ticks.push({ value, label });
+    }
+    return { domain: scale.domain, ticks };
+}
+function evenValues(min, max, wanted, logarithmic) {
+    const values = [];
+    const low = logarithmic ? Math.log10(Math.max(min, smallestStep(max))) : min;
+    const high = logarithmic ? Math.log10(Math.max(max, smallestStep(max))) : max;
+    const span = high - low;
+    for (let index = 0; index < wanted; index++) {
+        const placed = low + (span * index) / (wanted - 1);
+        values.push(logarithmic ? 10 ** placed : placed);
+    }
+    return values;
+}
+function labelled(values, format) {
+    const decimals = format === undefined ? tickDecimals(values) : 0;
+    const ticks = [];
+    for (const value of values) {
+        const label = format === undefined ? formatDecimal(value, decimals) : format(value);
+        if (ticks.at(-1)?.label === label)
+            continue;
+        ticks.push({ value, label });
+    }
+    return ticks;
+}
+/**
+ * As many decimals as the spacing needs, and one more whenever rounding would
+ * move a mark by more than a tenth of that spacing — which is what keeps an
+ * axis from 12.3 to 157 reading `12 48 85 121 157` while one from −1.5 to 2.5
+ * still reads `−1.5 −0.5 0.5 1.5 2.5` rather than rounding both away.
+ * @param values - The graduations, in the axis's own units.
+ * @returns How many decimals each of their labels carries.
+ */
+function tickDecimals(values) {
+    const step = smallestGap(values);
+    const tolerance = step / LABEL_TOLERANCE;
+    let decimals = chartTickDecimals(step);
+    while (decimals < MOST_TICK_DECIMALS &&
+        !faithful(values, decimals, tolerance)) {
+        decimals++;
+    }
+    return decimals;
+}
+function faithful(values, decimals, tolerance) {
+    for (const value of values) {
+        if (Math.abs(value - roundTo(value, decimals)) > tolerance)
+            return false;
+    }
+    return true;
+}
+function smallestGap(values) {
+    let smallest = Number.POSITIVE_INFINITY;
+    for (let index = 1; index < values.length; index++) {
+        const gap = Math.abs(values[index] - values[index - 1]);
+        if (gap > 0 && gap < smallest)
+            smallest = gap;
+    }
+    return Number.isFinite(smallest) ? smallest : 1;
+}
+function smallestStep(max) {
+    return max > 0 ? max * 1e-12 : 1;
+}
+//# sourceMappingURL=parallelTicks.js.map

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

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

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

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

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

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

package/lib/parallel/core/parallelTypes.js

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

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

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

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

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

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

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