react-cheminfo 0.9.0 → 0.11.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterLabels.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/scatterLabels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE5D,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,0CAA0C;IAC1C,CAAC,EAAE,MAAM,CAAC;IACV,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,SAAS,CAAC,EACzC,GAAG,GAAE,eAAoB,GACxB,iBAAiB,EAAE,CAerB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,GAAG,GAAE,eAAoB,GACxB,iBAAiB,EAAE,CAgCrB"}

package/lib/scatter/ui/scatterLabels.js

@@ -0,0 +1,101 @@
+/**
+ * Where the words written on a cloud of points go.
+ *
+ * A dot says where a sample landed and nothing about which sample it is, so a
+ * reader who has found an outlier has to hover it, and a reader looking at
+ * forty crowds has to keep walking back to the key. Both are answered by
+ * writing the name on the picture — and both are answered by a different name,
+ * which is why there are two functions here rather than one flag.
+ *
+ * The placing is arithmetic over pixels, so it sits beside the layer that
+ * draws it rather than inside it and can be checked without rendering
+ * anything.
+ */
+/**
+ * Every sample's own name, beside its own dot.
+ *
+ * A sample with no name is skipped rather than drawn empty, so a caller may
+ * name the twenty samples it cares about and leave the rest of the array
+ * `undefined` — which is how a crowded map stays readable while the outliers
+ * are still labelled.
+ * @param points - Where every point sits, in the frame's pixels.
+ * @param labels - What each point is called, in point order.
+ * @param ink - Which colour each label takes.
+ * @returns One label per named point that has somewhere to be drawn.
+ */
+export function scatterPointLabels(points, labels, ink = {}) {
+    const { groupOf, colors, fallbackColor = DEFAULT_LABEL_INK } = ink;
+    const placed = [];
+    const count = Math.min(points.x.length, points.y.length, labels.length);
+    for (let index = 0; index < count; index++) {
+        const text = labels[index];
+        if (text === undefined || text === '')
+            continue;
+        const x = points.x[index];
+        const y = points.y[index];
+        if (x === undefined || !Number.isFinite(x))
+            continue;
+        if (y === undefined || !Number.isFinite(y))
+            continue;
+        const group = groupOf?.[index] ?? -1;
+        placed.push({ x, y, text, color: colors?.[group] ?? fallbackColor });
+    }
+    return placed;
+}
+/**
+ * Each group's name, once, at the middle of the points in it.
+ *
+ * Once rather than on every dot: forty seizures over five hundred spectra
+ * would otherwise write forty names twelve times each, and a reader can read
+ * none of them. The average of the pixels is the same place as the average of
+ * the data on a linear axis and one pass fewer, and it is the same point the
+ * group-average cross is drawn at, so turning both on marks and names one
+ * spot rather than two.
+ * @param points - Where every point sits, in the frame's pixels.
+ * @param names - What each group is called, in group order.
+ * @param ink - Which colour each label takes; `groupOf` is what it reads.
+ * @returns One label per group that anything belongs to.
+ */
+export function scatterGroupLabels(points, names, ink = {}) {
+    const { groupOf, colors, fallbackColor = DEFAULT_LABEL_INK } = ink;
+    const placed = [];
+    if (groupOf === undefined)
+        return placed;
+    const sums = new Float64Array(names.length * 3);
+    const count = Math.min(points.x.length, points.y.length, groupOf.length);
+    for (let index = 0; index < count; index++) {
+        const group = groupOf[index];
+        if (group === undefined || group < 0 || group >= names.length)
+            continue;
+        const x = points.x[index];
+        const y = points.y[index];
+        if (x === undefined || !Number.isFinite(x))
+            continue;
+        if (y === undefined || !Number.isFinite(y))
+            continue;
+        sums[group * 3] = (sums[group * 3] ?? 0) + x;
+        sums[group * 3 + 1] = (sums[group * 3 + 1] ?? 0) + y;
+        sums[group * 3 + 2] = (sums[group * 3 + 2] ?? 0) + 1;
+    }
+    for (let group = 0; group < names.length; group++) {
+        const seen = sums[group * 3 + 2] ?? 0;
+        const text = names[group];
+        if (seen === 0 || text === undefined || text === '')
+            continue;
+        placed.push({
+            x: (sums[group * 3] ?? 0) / seen,
+            y: (sums[group * 3 + 1] ?? 0) / seen,
+            text,
+            color: colors?.[group] ?? fallbackColor,
+            weight: seen,
+        });
+    }
+    return placed;
+}
+/**
+ * What a label naming nothing in particular is written in. It is the muted ink
+ * rather than the faint one a dot in no group takes: a word has to be read,
+ * where a dot only has to be seen.
+ */
+const DEFAULT_LABEL_INK = 'var(--text-muted)';
+//# sourceMappingURL=scatterLabels.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * A point drawn over the cloud that is not a sample, and the glyph it takes.
+ *
+ * It is its own module because three unrelated things place such a point — a
+ * caller's cluster centre, a group's own average, a rule laid across the plot
+ * — and only the first of them is anything the layer knows about.
+ */
+import type { ReactElement } from 'react';
+import type { OverlayMarkShape } from '../../overlay/core/overlayMarks.ts';
+/** A point drawn over the cloud that is not a sample, already in pixels. */
+export interface ScatterPixelMark {
+    /** What it is called, which is what a hover card and an end-to-end test ask for. */
+    label: string;
+    /** Horizontal position, in the frame's pixels. */
+    x: number;
+    /** Vertical position, in the frame's pixels. */
+    y: number;
+    /** Its colour, normally the colour of the group it stands for. */
+    color: string;
+    /**
+     * The glyph it is drawn with, which is how a reader tells it from a sample.
+     * @default 'cross'
+     */
+    shape?: OverlayMarkShape;
+}
+/**
+ * One mark, drawn as the glyph its shape asks for.
+ *
+ * A rule laid across the cloud names no point, so the two rule shapes are
+ * drawn as the default cross.
+ * @param mark - What to draw, already in the frame's pixels.
+ * @param size - Side of the square the glyph is drawn in, in pixels.
+ * @param key - What React reconciles the glyph by.
+ * @returns The glyph.
+ */
+export declare function markGlyph(mark: ScatterPixelMark, size: number, key: string): ReactElement;
+//# sourceMappingURL=scatterMarkGlyph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMarkGlyph.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMarkGlyph.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAE3E,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,CAAC,EAAE,MAAM,CAAC;IACV,gDAAgD;IAChD,CAAC,EAAE,MAAM,CAAC;IACV,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,GACV,YAAY,CAgDd"}

package/lib/scatter/ui/scatterMarkGlyph.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * One mark, drawn as the glyph its shape asks for.
+ *
+ * A rule laid across the cloud names no point, so the two rule shapes are
+ * drawn as the default cross.
+ * @param mark - What to draw, already in the frame's pixels.
+ * @param size - Side of the square the glyph is drawn in, in pixels.
+ * @param key - What React reconciles the glyph by.
+ * @returns The glyph.
+ */
+export function markGlyph(mark, size, key) {
+    const { label, x, y, color, shape = 'cross' } = mark;
+    const half = size / 2;
+    const near = round(x - half);
+    const far = round(x + half);
+    const top = round(y - half);
+    const foot = round(y + half);
+    // `key` is passed on each element rather than spread: React reads a key
+    // out of JSX itself, and one arriving through a spread is dropped with a
+    // warning that only shows up once the page is running.
+    const shared = { 'data-mark': label };
+    if (shape === 'dot' || shape === 'ring') {
+        const filled = shape === 'dot';
+        return (_jsx("circle", { ...shared, cx: round(x), cy: round(y), r: half, fill: filled ? color : 'none', stroke: filled ? 'none' : color }, key));
+    }
+    if (shape === 'square') {
+        return (_jsx("rect", { ...shared, x: near, y: top, width: size, height: size, fill: color, stroke: "none" }, key));
+    }
+    return (_jsx("path", { ...shared, d: `M${near} ${top}L${far} ${foot}M${far} ${top}L${near} ${foot}`, fill: "none", stroke: color }, key));
+}
+const round = (value) => Math.round(value * 100) / 100;
+//# sourceMappingURL=scatterMarkGlyph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMarkGlyph.js","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMarkGlyph.tsx"],"names":[],"mappings":";AA6BA;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CACvB,IAAsB,EACtB,IAAY,EACZ,GAAW;IAEX,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,EAAE,GAAG,IAAI,CAAC;IACrD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC;IACtB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC7B,wEAAwE;IACxE,yEAAyE;IACzE,uDAAuD;IACvD,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACtC,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,KAAK,KAAK,KAAK,CAAC;QAC/B,OAAO,CACL,oBAEM,MAAM,EACV,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EACZ,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EACZ,CAAC,EAAE,IAAI,EACP,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAC7B,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAN1B,GAAG,CAOR,CACH,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,CACL,kBAEM,MAAM,EACV,CAAC,EAAE,IAAI,EACP,CAAC,EAAE,GAAG,EACN,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,IAAI,EACZ,IAAI,EAAE,KAAK,EACX,MAAM,EAAC,MAAM,IAPR,GAAG,CAQR,CACH,CAAC;IACJ,CAAC;IACD,OAAO,CACL,kBAEM,MAAM,EACV,CAAC,EAAE,IAAI,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,EAAE,EACjE,IAAI,EAAC,MAAM,EACX,MAAM,EAAE,KAAK,IAJR,GAAG,CAKR,CACH,CAAC;AACJ,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * The dots of one cell of a pair grid, and the surface that finds them again.
+ *
+ * They are not an element each. Six axes over five thousand samples is a
+ * hundred and eighty thousand marks, and a browser handed that many nodes
+ * stops answering the pointer long before it paints; one path of zero-length
+ * round-capped segments a colour is at most sixteen nodes a cell and draws the
+ * same discs. The scores are read where they stand for the same reason: a grid
+ * copying a column per cell allocates n² arrays to show n.
+ */
+import type { ReactElement } from 'react';
+import type { ChartFrameRender } from '../../chart/ui/ChartFrame.tsx';
+import type { ScatterMatrixGrid } from './ScatterMatrixDiagonal.tsx';
+/**
+ * Every dot of one cell, as one path per colour, plus the rectangle that turns
+ * a pointer position back into a row when the caller wants hovering.
+ * @param grid - Everything the grid worked out once and every cell reads.
+ * @param row - Which row the cell sits in, which is the axis up its side.
+ * @param column - Which column, which is the axis along its foot.
+ * @param frame - The rectangle and the two scales the cell was given.
+ * @returns The marks, in the order they stack.
+ */
+export declare function scatterMatrixDots(grid: ScatterMatrixGrid, row: number, column: number, frame: ChartFrameRender): ReactElement[];
+//# sourceMappingURL=scatterMatrixDots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMatrixDots.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMatrixDots.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAA+B,YAAY,EAAE,MAAM,OAAO,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,YAAY,EAAE,CA0ChB"}

package/lib/scatter/ui/scatterMatrixDots.js

@@ -0,0 +1,84 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Every dot of one cell, as one path per colour, plus the rectangle that turns
+ * a pointer position back into a row when the caller wants hovering.
+ * @param grid - Everything the grid worked out once and every cell reads.
+ * @param row - Which row the cell sits in, which is the axis up its side.
+ * @param column - Which column, which is the axis along its foot.
+ * @param frame - The rectangle and the two scales the cell was given.
+ * @returns The marks, in the order they stack.
+ */
+export function scatterMatrixDots(grid, row, column, frame) {
+    const { scores, colors, groupOf, mask, pointRadius, onHoverChange } = grid;
+    const { x, y, plot } = frame;
+    const inks = (colors?.length ?? 0) + 1;
+    const paths = new Array(inks * 2).fill('');
+    for (let index = 0; index < scores.rows; index++) {
+        const valueX = scores.get(index, column);
+        const valueY = scores.get(index, row);
+        if (!Number.isFinite(valueX) || !Number.isFinite(valueY))
+            continue;
+        const atX = Math.round((x.offset + valueX * x.factor) * 10) / 10;
+        const atY = Math.round((y.offset + valueY * y.factor) * 10) / 10;
+        const slot = inkOf(groupOf, index, inks - 1) * 2 + (mask?.[index] === 0 ? 1 : 0);
+        paths[slot] = `${paths[slot] ?? ''}M${atX} ${atY}h0`;
+    }
+    const marks = [];
+    for (let slot = 0; slot < paths.length; slot++) {
+        const data = paths[slot];
+        if (data === undefined || data === '')
+            continue;
+        const ink = colors?.[slot >> 1] ?? NO_GROUP_INK;
+        const style = dotStyle(ink, pointRadius, slot);
+        marks.push(_jsx("path", { d: data, style: style }, slot));
+    }
+    if (onHoverChange !== undefined) {
+        marks.push(_jsx("rect", { x: plot.left, y: plot.top, width: plot.width, height: plot.height, style: TRACKING_STYLE, onPointerMove: (event) => onHoverChange(nearestRow(event, grid, row, column, frame)), onPointerLeave: () => onHoverChange(-1) }, "tracking"));
+    }
+    return marks;
+}
+/** How far from a dot the pointer still counts as resting on it, in pixels. */
+const HOVER_REACH = 10;
+/** Opacity of a dot in the selection, of one outside it, and the ungrouped ink. */
+const POINT_OPACITY = 0.85;
+const FAINT_OPACITY = 0.16;
+const NO_GROUP_INK = 'var(--text-muted)';
+/** The rectangle that takes the pointer, over the dots and invisible. */
+const TRACKING_STYLE = {
+    fill: 'none',
+    pointerEvents: 'all',
+};
+function nearestRow(event, grid, row, column, frame) {
+    const { offsetX, offsetY } = event.nativeEvent;
+    const { scores } = grid;
+    const { x, y } = frame;
+    let best = -1;
+    let closest = HOVER_REACH * HOVER_REACH;
+    for (let index = 0; index < scores.rows; index++) {
+        const awayX = x.offset + scores.get(index, column) * x.factor - offsetX;
+        const awayY = y.offset + scores.get(index, row) * y.factor - offsetY;
+        const away = awayX * awayX + awayY * awayY;
+        if (away < closest) {
+            closest = away;
+            best = index;
+        }
+    }
+    return best;
+}
+function dotStyle(color, radius, slot) {
+    return {
+        fill: 'none',
+        stroke: color,
+        strokeWidth: radius * 2,
+        strokeLinecap: 'round',
+        strokeOpacity: (slot & 1) === 1 ? FAINT_OPACITY : POINT_OPACITY,
+    };
+}
+function inkOf(groupOf, row, groups) {
+    const raw = groupOf?.[row];
+    if (raw === undefined || !Number.isFinite(raw))
+        return groups;
+    const group = Math.trunc(raw);
+    return group < 0 || group >= groups ? groups : group;
+}
+//# sourceMappingURL=scatterMatrixDots.js.map

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

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

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

@@ -0,0 +1,93 @@
+/**
+ * How much room a pair grid gives each of its cells.
+ *
+ * The numbers are the grid's own rather than the chart family's: a figure
+ * standing alone can afford ten pixels of quiet around its plot, and a grid
+ * repeating that margin thirty-six times inside somebody else's page spends a
+ * fifth of its width on nothing. What a tick label and an axis title need is
+ * still taken from the chart, because that is a property of the type and not
+ * of the figure.
+ */
+/** Room a cell keeps around its plot before its outer edges ask for more. */
+export declare const SCATTER_MATRIX_MARGINS: {
+    readonly top: 4;
+    readonly right: 8;
+    readonly bottom: 4;
+    readonly left: 8;
+};
+/**
+ * Gap between two cells, which is what tells one plot from the next.
+ *
+ * The three numbers across a join — this and the two margins beside it — have
+ * to hold two tick labels facing each other, since the label on a plot's last
+ * tick is centred on its edge and reaches into the gap from both sides. Twenty
+ * two pixels is where `4` and `-1.5` stop reading as `4-1.5`.
+ */
+export declare const SCATTER_MATRIX_GAP = 6;
+/** Room the left column and the bottom row keep for their ticks and titles. */
+export declare const SCATTER_MATRIX_ROOM: {
+    readonly left: number;
+    readonly bottom: number;
+};
+/**
+ * The most axes a grid ever lays out, and the fewest it falls back to.
+ *
+ * Six is where the reading stops being worth the room: the sixth component of
+ * a real model usually carries a per cent of the differences, and thirty-six
+ * cells is already more than a reader compares in one sitting. It is a
+ * ceiling, not a target — {@link scatterMatrixAxesThatFit} drops axes until
+ * the cells are readable, so a narrow embed draws three of them.
+ */
+export declare const SCATTER_MATRIX_MOST_AXES = 6;
+/**
+ * The smallest plot the grid draws.
+ *
+ * Below it the dots merge and the ticks collide, so an axis is dropped
+ * instead: three components a reader can see beat six they cannot.
+ */
+export declare const SCATTER_MATRIX_SMALLEST_PLOT = 50;
+/**
+ * The narrowest cell that writes its share into its axis title.
+ *
+ * `PC 1 — 73.0 %` is about a hundred pixels of type, and an axis title is
+ * centred on a cell that may be seventy: three of them along the foot of a
+ * narrow grid run into one another and none of the three can be read. Under
+ * this the title is the component's name alone, which is the half a reader
+ * needs to know which cell they are looking at.
+ */
+export declare const SCATTER_MATRIX_SHARE_IN_TITLE = 110;
+/**
+ * The smallest plot a group outline is drawn in.
+ *
+ * An outline holding ninety-five per cent of its group covers most of the cell
+ * it is drawn in, so under about sixty-four pixels the boundary runs along the
+ * edges and the fill reads as a tinted cell rather than as a region — a blob
+ * that says where the group is not. The dots still say it, so the outline is
+ * simply left out.
+ */
+export declare const SCATTER_MATRIX_SMALLEST_OUTLINE = 64;
+/**
+ * How many axes fit in the width at a readable size.
+ * @param width - What the grid was given, in pixels.
+ * @param wanted - How many the caller asked for.
+ * @returns The count to lay out, never below two.
+ */
+export declare function scatterMatrixAxesThatFit(width: number, wanted: number): number;
+/**
+ * The side of every plot rectangle once the chrome has taken its share.
+ * @param width - What the grid was given, in pixels.
+ * @param count - How many axes are laid out.
+ * @returns The side, in pixels, which the caller floors at the smallest plot.
+ */
+export declare function scatterMatrixPlotSide(width: number, count: number): number;
+/**
+ * How many ticks a cell's axis aims for.
+ *
+ * Four labels on a ninety-pixel axis run into one another and the reader
+ * reads none of them; two ends and nothing else is enough to say which way the
+ * component grows, which is all a cell of a grid is asked.
+ * @param side - The side of the plot rectangle, in pixels.
+ * @returns The tick count to ask the axis for.
+ */
+export declare function scatterMatrixTickCount(side: number): number;
+//# sourceMappingURL=scatterMatrixLayout.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMatrixLayout.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMatrixLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB;;;;;CAKzB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB;;;CAGtB,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAG1C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD;;;;;;;;GAQG;AACH,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACb,MAAM,CAOR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/lib/scatter/ui/scatterMatrixLayout.js

@@ -0,0 +1,117 @@
+/**
+ * How much room a pair grid gives each of its cells.
+ *
+ * The numbers are the grid's own rather than the chart family's: a figure
+ * standing alone can afford ten pixels of quiet around its plot, and a grid
+ * repeating that margin thirty-six times inside somebody else's page spends a
+ * fifth of its width on nothing. What a tick label and an axis title need is
+ * still taken from the chart, because that is a property of the type and not
+ * of the figure.
+ */
+import { CHART_TICK_ROOM as TICKS, CHART_TITLE_ROOM as TITLES, } from "../../chart/ui/chartStyles.js";
+/** Room a cell keeps around its plot before its outer edges ask for more. */
+export const SCATTER_MATRIX_MARGINS = {
+    top: 4,
+    right: 8,
+    bottom: 4,
+    left: 8,
+};
+/**
+ * Gap between two cells, which is what tells one plot from the next.
+ *
+ * The three numbers across a join — this and the two margins beside it — have
+ * to hold two tick labels facing each other, since the label on a plot's last
+ * tick is centred on its edge and reaches into the gap from both sides. Twenty
+ * two pixels is where `4` and `-1.5` stop reading as `4-1.5`.
+ */
+export const SCATTER_MATRIX_GAP = 6;
+/** Room the left column and the bottom row keep for their ticks and titles. */
+export const SCATTER_MATRIX_ROOM = {
+    left: SCATTER_MATRIX_MARGINS.left + TICKS.left + TITLES.left,
+    bottom: SCATTER_MATRIX_MARGINS.bottom + TICKS.bottom + TITLES.bottom,
+};
+/**
+ * The most axes a grid ever lays out, and the fewest it falls back to.
+ *
+ * Six is where the reading stops being worth the room: the sixth component of
+ * a real model usually carries a per cent of the differences, and thirty-six
+ * cells is already more than a reader compares in one sitting. It is a
+ * ceiling, not a target — {@link scatterMatrixAxesThatFit} drops axes until
+ * the cells are readable, so a narrow embed draws three of them.
+ */
+export const SCATTER_MATRIX_MOST_AXES = 6;
+const SMALLEST_GRID = 2;
+/**
+ * The smallest plot the grid draws.
+ *
+ * Below it the dots merge and the ticks collide, so an axis is dropped
+ * instead: three components a reader can see beat six they cannot.
+ */
+export const SCATTER_MATRIX_SMALLEST_PLOT = 50;
+/**
+ * The narrowest cell that writes its share into its axis title.
+ *
+ * `PC 1 — 73.0 %` is about a hundred pixels of type, and an axis title is
+ * centred on a cell that may be seventy: three of them along the foot of a
+ * narrow grid run into one another and none of the three can be read. Under
+ * this the title is the component's name alone, which is the half a reader
+ * needs to know which cell they are looking at.
+ */
+export const SCATTER_MATRIX_SHARE_IN_TITLE = 110;
+/**
+ * The smallest plot a group outline is drawn in.
+ *
+ * An outline holding ninety-five per cent of its group covers most of the cell
+ * it is drawn in, so under about sixty-four pixels the boundary runs along the
+ * edges and the fill reads as a tinted cell rather than as a region — a blob
+ * that says where the group is not. The dots still say it, so the outline is
+ * simply left out.
+ */
+export const SCATTER_MATRIX_SMALLEST_OUTLINE = 64;
+/**
+ * How many axes fit in the width at a readable size.
+ * @param width - What the grid was given, in pixels.
+ * @param wanted - How many the caller asked for.
+ * @returns The count to lay out, never below two.
+ */
+export function scatterMatrixAxesThatFit(width, wanted) {
+    for (let count = wanted; count > SMALLEST_GRID; count--) {
+        if (scatterMatrixPlotSide(width, count) >= SCATTER_MATRIX_SMALLEST_PLOT) {
+            return count;
+        }
+    }
+    return Math.max(0, Math.min(wanted, SMALLEST_GRID));
+}
+/**
+ * The side of every plot rectangle once the chrome has taken its share.
+ * @param width - What the grid was given, in pixels.
+ * @param count - How many axes are laid out.
+ * @returns The side, in pixels, which the caller floors at the smallest plot.
+ */
+export function scatterMatrixPlotSide(width, count) {
+    if (count < 1)
+        return SCATTER_MATRIX_SMALLEST_PLOT;
+    const inner = SCATTER_MATRIX_MARGINS.left + SCATTER_MATRIX_GAP;
+    const chrome = SCATTER_MATRIX_ROOM.left +
+        (count - 1) * inner +
+        count * SCATTER_MATRIX_MARGINS.right;
+    return (Math.max(0, width) - chrome) / count;
+}
+/**
+ * How many ticks a cell's axis aims for.
+ *
+ * Four labels on a ninety-pixel axis run into one another and the reader
+ * reads none of them; two ends and nothing else is enough to say which way the
+ * component grows, which is all a cell of a grid is asked.
+ * @param side - The side of the plot rectangle, in pixels.
+ * @returns The tick count to ask the axis for.
+ */
+export function scatterMatrixTickCount(side) {
+    if (side < CROWDED_AXIS)
+        return 2;
+    return side < ROOMY_AXIS ? 3 : 4;
+}
+/** Where an axis stops holding three tick labels, and where it holds four. */
+const CROWDED_AXIS = 90;
+const ROOMY_AXIS = 150;
+//# sourceMappingURL=scatterMatrixLayout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMatrixLayout.js","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMatrixLayout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,eAAe,IAAI,KAAK,EACxB,gBAAgB,IAAI,MAAM,GAC3B,MAAM,+BAA+B,CAAC;AAEvC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACC,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,IAAI,EAAE,sBAAsB,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI;IAC5D,MAAM,EAAE,sBAAsB,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;CAC5D,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAC1C,MAAM,aAAa,GAAG,CAAC,CAAC;AAExB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAAG,CAAC;AAEjD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAa,EACb,MAAc;IAEd,KAAK,IAAI,KAAK,GAAG,MAAM,EAAE,KAAK,GAAG,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,IAAI,qBAAqB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,4BAA4B,EAAE,CAAC;YACxE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AACtD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,KAAa;IAChE,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,4BAA4B,CAAC;IACnD,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,GAAG,kBAAkB,CAAC;IAC/D,MAAM,MAAM,GACV,mBAAmB,CAAC,IAAI;QACxB,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK;QACnB,KAAK,GAAG,sBAAsB,CAAC,KAAK,CAAC;IACvC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK,CAAC;AAC/C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,IAAI,IAAI,GAAG,YAAY;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,8EAA8E;AAC9E,MAAM,YAAY,GAAG,EAAE,CAAC;AACxB,MAAM,UAAU,GAAG,GAAG,CAAC"}

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

@@ -0,0 +1,27 @@
+/**
+ * The group outlines of one cell of a pair grid.
+ *
+ * They are the same shapes the map draws, projected through the cell's own two
+ * scales rather than reused from the map's: an ellipse tilted by thirty
+ * degrees in the data is tilted by something else entirely on a plot whose two
+ * axes carry different numbers of pixels per unit, and a grid whose cells
+ * disagree with the map about where a group sits is worse than a grid with no
+ * outlines at all.
+ */
+import type { ReactElement } from 'react';
+import type { ChartFrameRender } from '../../chart/ui/ChartFrame.tsx';
+import type { ScatterMatrixGrid } from './ScatterMatrixDiagonal.tsx';
+/**
+ * One outline per group, for the pair of axes a cell stands for.
+ *
+ * The whole layer is one element so that its keys cannot collide with the
+ * marks drawn beside it, and so an end-to-end test finds the outlines of a
+ * cell the same way it finds those of the map.
+ * @param grid - Everything the grid worked out once, including the measured groups.
+ * @param row - Which row the cell sits in, which is the axis up its side.
+ * @param column - Which column, which is the axis along its foot.
+ * @param frame - The rectangle and the two scales the cell was given.
+ * @returns The layer, or `null` when the groups were never measured — no groups were named, or the cells came out too small for a readable outline.
+ */
+export declare function scatterMatrixOutlines(grid: ScatterMatrixGrid, row: number, column: number, frame: ChartFrameRender): ReactElement | null;
+//# sourceMappingURL=scatterMatrixOutlines.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMatrixOutlines.d.ts","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMatrixOutlines.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAIrE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,gBAAgB,GACtB,YAAY,GAAG,IAAI,CAgBrB"}

package/lib/scatter/ui/scatterMatrixOutlines.js

@@ -0,0 +1,34 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { scatterPairEllipse } from "./scatterGroupSpread.js";
+import { scatterOutlineShape } from "./scatterOutlineShape.js";
+/**
+ * One outline per group, for the pair of axes a cell stands for.
+ *
+ * The whole layer is one element so that its keys cannot collide with the
+ * marks drawn beside it, and so an end-to-end test finds the outlines of a
+ * cell the same way it finds those of the map.
+ * @param grid - Everything the grid worked out once, including the measured groups.
+ * @param row - Which row the cell sits in, which is the axis up its side.
+ * @param column - Which column, which is the axis along its foot.
+ * @param frame - The rectangle and the two scales the cell was given.
+ * @returns The layer, or `null` when the groups were never measured — no groups were named, or the cells came out too small for a readable outline.
+ */
+export function scatterMatrixOutlines(grid, row, column, frame) {
+    const { groupSpread, colors } = grid;
+    if (groupSpread === undefined || colors === undefined)
+        return null;
+    const outlines = [];
+    for (let group = 0; group < groupSpread.groups; group++) {
+        const color = colors[group];
+        if (color === undefined)
+            continue;
+        const measured = scatterPairEllipse(groupSpread, group, column, row);
+        if (measured === null)
+            continue;
+        outlines.push(scatterOutlineShape(group, measured, frame.x, frame.y, { color }));
+    }
+    if (outlines.length === 0)
+        return null;
+    return _jsx("g", { "data-layer": "ellipses", children: outlines });
+}
+//# sourceMappingURL=scatterMatrixOutlines.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scatterMatrixOutlines.js","sourceRoot":"","sources":["../../../src/scatter/ui/scatterMatrixOutlines.tsx"],"names":[],"mappings":";AAgBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA2B,CAAC;AAEhE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,GAAW,EACX,MAAc,EACd,KAAuB;IAEvB,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACrC,IAAI,WAAW,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAEnE,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACxD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACrE,IAAI,QAAQ,KAAK,IAAI;YAAE,SAAS;QAChC,QAAQ,CAAC,IAAI,CACX,mBAAmB,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAClE,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,0BAAc,UAAU,YAAE,QAAQ,GAAK,CAAC;AACjD,CAAC"}