react-cheminfo 0.9.0 → 0.10.0

package/lib/projection/core/variableAxis.js

@@ -0,0 +1,84 @@
+/**
+ * How many measurements an axis carries.
+ * @param axis - The axis.
+ * @returns The count.
+ */
+export function variableCount(axis) {
+    return axis.kind === 'named' ? axis.names.length : axis.values.length;
+}
+/**
+ * Where each measurement sits, for an axis that is a number line.
+ * @param axis - The axis.
+ * @returns The positions, or `null` for a named axis, which has none.
+ */
+export function variablePositions(axis) {
+    return axis.kind === 'named' ? null : axis.values;
+}
+/**
+ * What one measurement is called, written out.
+ * @param axis - The axis.
+ * @param index - Which measurement, from 0.
+ * @param decimals - Decimals the value is rounded to, from `variableDecimals`,
+ * for a label written under a tick.
+ * @default undefined — the number is written as it was handed in, which is
+ * what a readout naming one slot wants
+ * @returns The name, or the value with its unit — `1650 cm⁻¹`. An index
+ * outside the axis gives an empty string.
+ */
+export function variableLabel(axis, index, decimals) {
+    if (!Number.isInteger(index) || index < 0)
+        return '';
+    if (axis.kind === 'named')
+        return axis.names[index] ?? '';
+    const value = axis.values[index];
+    if (value === undefined)
+        return '';
+    // Asked for in full, a number is written as it was handed in: rounding a
+    // wavenumber to a tidier one would name a slot the reader cannot find in
+    // their own file.
+    const written = decimals === undefined ? String(value) : String(rounded(value, decimals));
+    const unit = axis.unit ?? '';
+    return unit === '' ? written : `${written} ${unit}`;
+}
+/**
+ * How many decimals the axis writes its own values with.
+ *
+ * About a hundred steps across the span the axis covers, which is finer than
+ * the dozen-odd ticks a chart labels and coarse enough to drop what a
+ * resampling left behind: a spectrum landed on its own grid carries values
+ * like 878.9834, where every digit past the second says something about the
+ * grid rather than about the measurement, so a tick reads `879 cm⁻¹`. A named
+ * axis has no values to write and gets none.
+ * @param axis - The axis.
+ * @returns The decimals, from 0 to 6.
+ */
+export function variableDecimals(axis) {
+    if (axis.kind === 'named')
+        return 0;
+    let min = Number.POSITIVE_INFINITY;
+    let max = Number.NEGATIVE_INFINITY;
+    for (const value of axis.values) {
+        if (!Number.isFinite(value))
+            continue;
+        if (value < min)
+            min = value;
+        if (value > max)
+            max = value;
+    }
+    const span = max - min;
+    if (!Number.isFinite(span) || span <= 0)
+        return MOST_DECIMALS;
+    const decimals = AXIS_DIGITS - Math.ceil(Math.log10(span));
+    return Math.min(MOST_DECIMALS, Math.max(0, decimals));
+}
+function rounded(value, decimals) {
+    if (!Number.isFinite(value))
+        return value;
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+/** Digits kept above the decimal point when the axis writes a value. */
+const AXIS_DIGITS = 2;
+/** Decimals an axis is never written past, however narrow its span. */
+const MOST_DECIMALS = 6;
+//# sourceMappingURL=variableAxis.js.map

package/lib/projection/core/variableAxis.js.map

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

package/lib/projection/core/variablesView.d.ts

@@ -0,0 +1,33 @@
+import type { ProjectionVariablesView } from './projectionOptions.ts';
+import type { ProjectionLoadings } from './projectionResult.ts';
+/**
+ * The view that can actually be drawn from what the result carries.
+ *
+ * Three of the four views need something beyond the weights, and a result is
+ * free not to publish it: `effect` walks from the average sample along the
+ * component, so it needs both the average and the spread; `rescaled` undoes a
+ * scaling, so it needs the scaling; `sample` rebuilds one sample from the
+ * components, so it needs the average and a sample to rebuild. What is missing
+ * falls back to `weights`, which every result can fill.
+ *
+ * It is one function because it is one question, asked twice — once by the
+ * settings bar deciding which views to offer, and once by the panels deciding
+ * what to draw. Two answers is not a tidiness problem: a bar that offers a
+ * view the panels refuse leaves a reader picking `sample` and watching the
+ * weights redraw, with nothing anywhere saying why.
+ *
+ * `sampleScores` is what tells the two callers apart, and leaving it out is a
+ * third answer rather than a shorthand for none. The bar cannot know what is
+ * selected — a selection is not part of a result — so it omits the argument
+ * and asks only whether the *result* could support the view at all. The panels
+ * always know, so they pass what is selected, and an empty array is a real
+ * answer: nothing to rebuild, so nothing to draw.
+ * @param view - The view that was asked for.
+ * @param loadings - What loads onto each axis, or nothing when the result
+ * published none.
+ * @param sampleScores - The selected sample's scores; empty for a selection of
+ * nothing, omitted by a caller that cannot see the selection.
+ * @returns The view to draw, which is the one asked for or `weights`.
+ */
+export declare function drawableVariablesView(view: ProjectionVariablesView, loadings: ProjectionLoadings | undefined, sampleScores?: readonly number[]): ProjectionVariablesView;
+//# sourceMappingURL=variablesView.d.ts.map

package/lib/projection/core/variablesView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variablesView.d.ts","sourceRoot":"","sources":["../../../src/projection/core/variablesView.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,uBAAuB,EAC7B,QAAQ,EAAE,kBAAkB,GAAG,SAAS,EACxC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAC/B,uBAAuB,CAgBzB"}

package/lib/projection/core/variablesView.js

@@ -0,0 +1,49 @@
+/**
+ * The view that can actually be drawn from what the result carries.
+ *
+ * Three of the four views need something beyond the weights, and a result is
+ * free not to publish it: `effect` walks from the average sample along the
+ * component, so it needs both the average and the spread; `rescaled` undoes a
+ * scaling, so it needs the scaling; `sample` rebuilds one sample from the
+ * components, so it needs the average and a sample to rebuild. What is missing
+ * falls back to `weights`, which every result can fill.
+ *
+ * It is one function because it is one question, asked twice — once by the
+ * settings bar deciding which views to offer, and once by the panels deciding
+ * what to draw. Two answers is not a tidiness problem: a bar that offers a
+ * view the panels refuse leaves a reader picking `sample` and watching the
+ * weights redraw, with nothing anywhere saying why.
+ *
+ * `sampleScores` is what tells the two callers apart, and leaving it out is a
+ * third answer rather than a shorthand for none. The bar cannot know what is
+ * selected — a selection is not part of a result — so it omits the argument
+ * and asks only whether the *result* could support the view at all. The panels
+ * always know, so they pass what is selected, and an empty array is a real
+ * answer: nothing to rebuild, so nothing to draw.
+ * @param view - The view that was asked for.
+ * @param loadings - What loads onto each axis, or nothing when the result
+ * published none.
+ * @param sampleScores - The selected sample's scores; empty for a selection of
+ * nothing, omitted by a caller that cannot see the selection.
+ * @returns The view to draw, which is the one asked for or `weights`.
+ */
+export function drawableVariablesView(view, loadings, sampleScores) {
+    if (loadings === undefined || view === 'weights')
+        return 'weights';
+    if (view === 'rescaled') {
+        return loadings.scales === undefined ? 'weights' : 'rescaled';
+    }
+    if (view === 'effect') {
+        const walkable = loadings.mean !== undefined && loadings.spread !== undefined;
+        return walkable ? 'effect' : 'weights';
+    }
+    // `sample` is rebuilt from the average and the sample's own scores. It never
+    // reads the spread, which is what walking to the ends of a component needs
+    // and this does not do.
+    if (loadings.mean === undefined)
+        return 'weights';
+    if (sampleScores === undefined)
+        return 'sample';
+    return sampleScores.length > 0 ? 'sample' : 'weights';
+}
+//# sourceMappingURL=variablesView.js.map

package/lib/projection/core/variablesView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variablesView.js","sourceRoot":"","sources":["../../../src/projection/core/variablesView.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAA6B,EAC7B,QAAwC,EACxC,YAAgC;IAEhC,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACnE,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,MAAM,QAAQ,GACZ,QAAQ,CAAC,IAAI,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC;QAC/D,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzC,CAAC;IACD,6EAA6E;IAC7E,2EAA2E;IAC3E,wBAAwB;IACxB,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAChD,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC"}

package/lib/projection/ui/PcaViewer.d.ts

@@ -0,0 +1,31 @@
+import type { ReactElement } from 'react';
+import type { PcaLike } from '../core/pcaLike.ts';
+import type { PcaResultOptions } from '../core/pcaResult.ts';
+import type { ProjectionViewerProps } from './projectionViewerProps.ts';
+/** What {@link PcaViewer} needs on top of what every projection viewer takes. */
+export interface PcaViewerProps extends Omit<ProjectionViewerProps, 'result'>, Omit<PcaResultOptions, 'method'> {
+    /**
+     * The fitted model. It is described structurally, so `ml-pca`'s `PCA`
+     * satisfies it as it is and this package never imports `ml-pca`.
+     */
+    pca: PcaLike;
+}
+/**
+ * A fitted principal component analysis, shown as a map a reader can
+ * interrogate.
+ *
+ * It is {@link ProjectionViewer} with one call in front of it: everything the
+ * four tabs draw is built by `pcaResult` into the same record a k-means or a
+ * UMAP run fills in by hand, and no tab, no layer and no callback below this
+ * line knows what a principal component is.
+ *
+ * `projected` is the reason to reach for this rather than call `pcaResult`
+ * first: samples handed to it took no part in choosing where the axes point,
+ * so the map draws them hollow and says so, and a reader can see at a glance
+ * which points the model has already accounted for and which it is being asked
+ * about.
+ * @param props - See {@link PcaViewerProps}.
+ * @returns The viewer.
+ */
+export declare function PcaViewer(props: PcaViewerProps): ReactElement;
+//# sourceMappingURL=PcaViewer.d.ts.map

package/lib/projection/ui/PcaViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PcaViewer.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/PcaViewer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAG1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE,iFAAiF;AACjF,MAAM,WAAW,cACf,SACE,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,EACrC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC;IAClC;;;OAGG;IACH,GAAG,EAAE,OAAO,CAAC;CACd;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,CAwC7D"}

package/lib/projection/ui/PcaViewer.js

@@ -0,0 +1,46 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { pcaResult } from "../core/pcaResult.js";
+import { ProjectionViewer } from "./ProjectionViewer.js";
+/**
+ * A fitted principal component analysis, shown as a map a reader can
+ * interrogate.
+ *
+ * It is {@link ProjectionViewer} with one call in front of it: everything the
+ * four tabs draw is built by `pcaResult` into the same record a k-means or a
+ * UMAP run fills in by hand, and no tab, no layer and no callback below this
+ * line knows what a principal component is.
+ *
+ * `projected` is the reason to reach for this rather than call `pcaResult`
+ * first: samples handed to it took no part in choosing where the axes point,
+ * so the map draws them hollow and says so, and a reader can see at a glance
+ * which points the model has already accounted for and which it is being asked
+ * about.
+ * @param props - See {@link PcaViewerProps}.
+ * @returns The viewer.
+ */
+export function PcaViewer(props) {
+    const { pca, rows, projected, variables, scores, scaled, count, valueLabel, signConvention, ...viewer } = props;
+    const result = useMemo(() => pcaResult(pca, {
+        rows,
+        projected,
+        variables,
+        scores,
+        scaled,
+        count,
+        valueLabel,
+        signConvention,
+    }), [
+        count,
+        pca,
+        projected,
+        rows,
+        scaled,
+        scores,
+        signConvention,
+        valueLabel,
+        variables,
+    ]);
+    return _jsx(ProjectionViewer, { ...viewer, result: result });
+}
+//# sourceMappingURL=PcaViewer.js.map

package/lib/projection/ui/PcaViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PcaViewer.js","sourceRoot":"","sources":["../../../src/projection/ui/PcaViewer.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAIhC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAwB,CAAC;AAe1D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,EACJ,GAAG,EACH,IAAI,EACJ,SAAS,EACT,SAAS,EACT,MAAM,EACN,MAAM,EACN,KAAK,EACL,UAAU,EACV,cAAc,EACd,GAAG,MAAM,EACV,GAAG,KAAK,CAAC;IAEV,MAAM,MAAM,GAAG,OAAO,CACpB,GAAG,EAAE,CACH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI;QACJ,SAAS;QACT,SAAS;QACT,MAAM;QACN,MAAM;QACN,KAAK;QACL,UAAU;QACV,cAAc;KACf,CAAC,EACJ;QACE,KAAK;QACL,GAAG;QACH,SAAS;QACT,IAAI;QACJ,MAAM;QACN,MAAM;QACN,cAAc;QACd,UAAU;QACV,SAAS;KACV,CACF,CAAC;IAEF,OAAO,KAAC,gBAAgB,OAAK,MAAM,EAAE,MAAM,EAAE,MAAM,GAAI,CAAC;AAC1D,CAAC"}

package/lib/projection/ui/ProjectionBar.d.ts

@@ -0,0 +1,55 @@
+import type { ReactElement } from 'react';
+import type { ProjectionCopy } from '../core/projectionCopy.ts';
+import type { ProjectionResult } from '../core/projectionResult.ts';
+import type { ProjectionMapView } from './projectionMapView.ts';
+import type { ProjectionModels } from './projectionTabModels.ts';
+import type { ProjectionStateApi } from './useProjectionState.ts';
+/** What {@link ProjectionBar} needs. */
+export interface ProjectionBarProps {
+    /** The tab, the options and the selection every tab shares. */
+    state: ProjectionStateApi;
+    /** What the run produced, whatever produced it. */
+    result: ProjectionResult;
+    /** The words the viewer writes, already merged over the defaults. */
+    copy: ProjectionCopy;
+    /** The two figures the bar explains and a tab draws. */
+    models: ProjectionModels;
+    /** The map's frame and the three buttons that change it. */
+    map: ProjectionMapView;
+    /** Stem of the `id` every pill carries, for the panel to name its tab with. */
+    baseId: string;
+    /** The `id` of the panel the pills drive, which is also what is saved. */
+    panelId: string;
+    /** What a figure saved from the bar is called, without its extension. */
+    fileName: string;
+    /** Width of the viewer, in pixels, which decides how much it writes. */
+    width: number;
+}
+/**
+ * One bar across the top of the figure: the views at the start, the settings
+ * of the view showing at the end, and the question mark between them.
+ *
+ * It belongs to the viewer rather than to any tab because it is the
+ * component's own chrome — a reader moves between four figures with it, and
+ * four bars, three of them hidden, would be four places for that row to sit a
+ * pixel differently.
+ *
+ * It stays one row at every width, because a bar that wrapped would change the
+ * figure's height as the host page resized. What a narrowing figure costs the
+ * reader is words rather than controls: the key word in front of each setting
+ * goes first, then the long form of the view names, then the boxes around the
+ * settings, which gather into one chip still reading `Species · 95%`. Only on
+ * the narrowest figures does anything leave the row at all, and it is the
+ * question mark — whose paragraph is then written at the head of the panel the
+ * cog opens, so nothing is lost, only moved.
+ *
+ * The one thing on the bar that acts on the figure rather than describing it
+ * is the save glyph, which is why it rides beside the question mark rather than
+ * among the settings: it is offered on every view, because every view draws a
+ * figure somebody may want to keep, and it saves whatever the box below the bar
+ * is currently holding — one map, or the sixteen charts of a pair grid.
+ * @param props - See {@link ProjectionBarProps}.
+ * @returns The bar.
+ */
+export declare function ProjectionBar(props: ProjectionBarProps): ReactElement;
+//# sourceMappingURL=ProjectionBar.d.ts.map

package/lib/projection/ui/ProjectionBar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionBar.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionBar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,OAAO,CAAC;AASrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAkBpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAElE,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,KAAK,EAAE,kBAAkB,CAAC;IAC1B,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,CAAC;IACzB,qEAAqE;IACrE,IAAI,EAAE,cAAc,CAAC;IACrB,wDAAwD;IACxD,MAAM,EAAE,gBAAgB,CAAC;IACzB,4DAA4D;IAC5D,GAAG,EAAE,iBAAiB,CAAC;IACvB,+EAA+E;IAC/E,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,YAAY,CA2FrE"}

package/lib/projection/ui/ProjectionBar.js

@@ -0,0 +1,112 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo } from 'react';
+import { FigureDownload } from "../../download/ui/FigureDownload.js";
+import { overlayMetrics } from "../../overlay/core/overlayMetrics.js";
+import { OverlayBar } from "../../overlay/ui/OverlayBar.js";
+import { OverlayInfo } from "../../overlay/ui/OverlayInfo.js";
+import { useCoarsePointer } from "../../overlay/ui/overlaySurface.js";
+import { ProjectionSurface } from "./ProjectionSurface.js";
+import { ProjectionTabStrip } from "./ProjectionTabStrip.js";
+import { projectionBarEndRoom, projectionBarGlyphs, projectionBarTier, } from "./projectionBarModel.js";
+import { projectionBarReadings } from "./projectionBarReadings.js";
+import { projectionBarSlots } from "./projectionBarSlots.js";
+import { PROJECTION_CAPTION_TEXT_STYLE, projectionBarEndStyle, projectionBarRowStyle, projectionFoldedCaptionStyle, } from "./projectionBarStyles.js";
+/**
+ * One bar across the top of the figure: the views at the start, the settings
+ * of the view showing at the end, and the question mark between them.
+ *
+ * It belongs to the viewer rather than to any tab because it is the
+ * component's own chrome — a reader moves between four figures with it, and
+ * four bars, three of them hidden, would be four places for that row to sit a
+ * pixel differently.
+ *
+ * It stays one row at every width, because a bar that wrapped would change the
+ * figure's height as the host page resized. What a narrowing figure costs the
+ * reader is words rather than controls: the key word in front of each setting
+ * goes first, then the long form of the view names, then the boxes around the
+ * settings, which gather into one chip still reading `Species · 95%`. Only on
+ * the narrowest figures does anything leave the row at all, and it is the
+ * question mark — whose paragraph is then written at the head of the panel the
+ * cog opens, so nothing is lost, only moved.
+ *
+ * The one thing on the bar that acts on the figure rather than describing it
+ * is the save glyph, which is why it rides beside the question mark rather than
+ * among the settings: it is offered on every view, because every view draws a
+ * figure somebody may want to keep, and it saves whatever the box below the bar
+ * is currently holding — one map, or the sixteen charts of a pair grid.
+ * @param props - See {@link ProjectionBarProps}.
+ * @returns The bar.
+ */
+export function ProjectionBar(props) {
+    const { state, result, copy, models, map, baseId, panelId } = props;
+    const { fileName, width } = props;
+    const { tab, tabs, options, groups, selected, setOptions, setTab } = state;
+    // Read here rather than off the surface below, because the row the bar is
+    // laid into is the surface's own parent: it has to know how tall a control
+    // will be before there is a surface to ask.
+    const pointer = useCoarsePointer() ? 'coarse' : 'fine';
+    const metrics = overlayMetrics('compact', pointer);
+    const strip = tabs.length > 1;
+    const labels = useMemo(() => (strip ? tabNames(tabs, copy.tab) : NO_LABELS), [strip, tabs, copy]);
+    const shortLabels = useMemo(() => (strip ? tabNames(tabs, copy.shortTab) : NO_LABELS), [strip, tabs, copy]);
+    const readings = projectionBarReadings({ tab, copy, options, groups });
+    const room = {
+        tabLabels: labels,
+        shortTabLabels: shortLabels,
+        readings,
+        glyphs: projectionBarGlyphs(tab),
+    };
+    const tier = projectionBarTier(width, room, metrics);
+    const strippable = Math.max(metrics.buttonSize, width - projectionBarEndRoom(room, metrics, tier));
+    const slots = projectionBarSlots({
+        tab,
+        result,
+        copy,
+        models,
+        map,
+        options,
+        groups,
+        selected,
+        width,
+        readings,
+        tier,
+        onChange: setOptions,
+    });
+    const folded = tier === 'tiny' && slots.info !== '';
+    return (_jsx(ProjectionSurface, { width: width, children: _jsx("div", { style: projectionBarRowStyle(metrics), children: _jsx(OverlayBar, { placement: "stretch", label: copy.action.options, collapsed: false, morePadded: false, end: _jsx("div", { style: projectionBarEndStyle(metrics), children: slots.end }), more: folded ? withCaption(slots.info, slots.more, metrics) : slots.more, tools: _jsx(FigureDownload, { targetId: panelId, fileName: `${fileName}-${tab}`, label: copy.action.download }), info: folded || slots.info === '' ? undefined : (_jsx(OverlayInfo, { children: slots.info })), children: strip ? (_jsx(ProjectionTabStrip, { tabs: tabs, tab: tab, onTabChange: setTab, labels: copy.tab, shortLabels: copy.shortTab, tier: tier, maxWidth: strippable, baseId: baseId, panelId: panelId })) : null }) }) }));
+}
+/**
+ * What each tab showing is called, in one of the two lengths.
+ * @param tabs - The tabs the result can fill, in reading order.
+ * @param names - What each tab is called at that length.
+ * @returns The names, in the same order.
+ */
+function tabNames(tabs, names) {
+    const labels = [];
+    for (const tab of tabs)
+        labels.push(names[tab]);
+    return labels;
+}
+/**
+ * The figure's explanation at the head of the panel the cog opens.
+ *
+ * On the narrowest figures the question mark is the one glyph that leaves the
+ * row, because the settings and the second tier both have to stay reachable —
+ * so its paragraph is written here instead. A reader short of room is exactly
+ * the reader who has not been told what they are looking at, which is why it
+ * is moved rather than dropped.
+ *
+ * It is a band above the panel rather than a row inside it: the panel's rows
+ * are settings the reader changes, and a paragraph filed among them is one
+ * more thing to scan past on the way to the switch they came for.
+ * @param caption - The paragraph the question mark used to open.
+ * @param more - The panel the cog already held.
+ * @param metrics - The measurements the chrome is drawn from.
+ * @returns The panel's contents.
+ */
+function withCaption(caption, more, metrics) {
+    return (_jsxs(_Fragment, { children: [_jsx("div", { style: projectionFoldedCaptionStyle(metrics), children: _jsx("p", { style: PROJECTION_CAPTION_TEXT_STYLE, children: caption }) }), more] }));
+}
+/** No pills at all, which is what one tab gets. */
+const NO_LABELS = [];
+//# sourceMappingURL=ProjectionBar.js.map

package/lib/projection/ui/ProjectionBar.js.map

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

package/lib/projection/ui/ProjectionMapCaption.d.ts

@@ -0,0 +1,46 @@
+import type { ReactElement } from 'react';
+import type { ScatterSelectionMode } from '../../scatter/core/scatterSelection.ts';
+import type { ProjectionCopy } from '../core/projectionCopy.ts';
+/** What a gesture just picked out, and when. */
+export interface SelectionReport {
+    /** The sentence to show, already written out. */
+    text: string;
+    /** A number that rises with every gesture, so two identical reports are still two reports. */
+    at: number;
+}
+/** What {@link ProjectionMapCaption} needs. */
+export interface ProjectionMapCaptionProps {
+    /** What the last gesture picked out, or `null` before there was one. */
+    report: SelectionReport | null;
+    /** The words the map writes, already merged over the defaults. */
+    copy: ProjectionCopy;
+    /** What a plain drag does, which is what a drag under way is promised to do. */
+    mode: ScatterSelectionMode;
+    /**
+     * Whether a lasso is being drawn right now.
+     * @default false
+     */
+    drawing?: boolean;
+}
+/**
+ * The one sentence on this figure that is not behind the question mark.
+ *
+ * Everything the map has to say about itself standing still — what a dot is,
+ * what an outline holds — waits behind the `?` in the bar, because an embedded
+ * figure cannot spend three lines of somebody else's page on a paragraph most
+ * readers will not read twice. This sentence is the exception, and it is a
+ * different kind of thing: it says what is happening *now*, and a reader half
+ * way through a lasso cannot open a popover to find out whether letting go
+ * will replace what they had already picked or add to it.
+ *
+ * So it appears only while a gesture is under way, and for a few seconds after
+ * one, and it takes no room at all in between. That is also what lets it sit
+ * across the strip the horizontal axis is titled in: a standing caption there
+ * would cost the reader the axis name for good, while this one hands it back
+ * on its own a moment later, and during a drag the reader is watching the loop
+ * rather than the axis.
+ * @param props - See {@link ProjectionMapCaptionProps}.
+ * @returns The line, or nothing at all when nothing is happening.
+ */
+export declare function ProjectionMapCaption(props: ProjectionMapCaptionProps): ReactElement | null;
+//# sourceMappingURL=ProjectionMapCaption.d.ts.map

package/lib/projection/ui/ProjectionMapCaption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapCaption.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapCaption.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAI1C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AACnF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,8FAA8F;IAC9F,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,+CAA+C;AAC/C,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,IAAI,EAAE,cAAc,CAAC;IACrB,gFAAgF;IAChF,IAAI,EAAE,oBAAoB,CAAC;IAC3B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,yBAAyB,GAC/B,YAAY,GAAG,IAAI,CA0BrB"}

package/lib/projection/ui/ProjectionMapCaption.js

@@ -0,0 +1,54 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from 'react';
+import { OverlayCaption } from "../../overlay/ui/OverlayCaption.js";
+/**
+ * The one sentence on this figure that is not behind the question mark.
+ *
+ * Everything the map has to say about itself standing still — what a dot is,
+ * what an outline holds — waits behind the `?` in the bar, because an embedded
+ * figure cannot spend three lines of somebody else's page on a paragraph most
+ * readers will not read twice. This sentence is the exception, and it is a
+ * different kind of thing: it says what is happening *now*, and a reader half
+ * way through a lasso cannot open a popover to find out whether letting go
+ * will replace what they had already picked or add to it.
+ *
+ * So it appears only while a gesture is under way, and for a few seconds after
+ * one, and it takes no room at all in between. That is also what lets it sit
+ * across the strip the horizontal axis is titled in: a standing caption there
+ * would cost the reader the axis name for good, while this one hands it back
+ * on its own a moment later, and during a drag the reader is watching the loop
+ * rather than the axis.
+ * @param props - See {@link ProjectionMapCaptionProps}.
+ * @returns The line, or nothing at all when nothing is happening.
+ */
+export function ProjectionMapCaption(props) {
+    const { report, copy, mode, drawing = false } = props;
+    const [faded, setFaded] = useState(0);
+    useEffect(() => {
+        if (report === null)
+            return undefined;
+        const { at } = report;
+        const timer = setTimeout(() => setFaded(at), ANNOUNCEMENT_MS);
+        return () => clearTimeout(timer);
+    }, [report]);
+    if (drawing) {
+        return (_jsx(OverlayCaption, { tone: "strong", live: true, children: copy.sentence[LASSO_SENTENCES[mode]] }));
+    }
+    if (report !== null && faded !== report.at) {
+        return (_jsx(OverlayCaption, { tone: "strong", live: true, children: report.text }));
+    }
+    return null;
+}
+/** Which sentence describes a drag under way, per mode. */
+const LASSO_SENTENCES = {
+    replace: 'lassoReplace',
+    add: 'lassoAdd',
+    remove: 'lassoRemove',
+};
+/**
+ * How long a report holds the line. Long enough to read a short sentence
+ * twice, short enough that a reader who has moved on is not still being told
+ * what they did.
+ */
+const ANNOUNCEMENT_MS = 4000;
+//# sourceMappingURL=ProjectionMapCaption.js.map

package/lib/projection/ui/ProjectionMapCaption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapCaption.js","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapCaption.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAqC,CAAC;AA2BrE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAgC;IAEhC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,KAAK,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAEtC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QACtC,MAAM,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC;QACtB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,eAAe,CAAC,CAAC;QAC9D,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CACL,KAAC,cAAc,IAAC,IAAI,EAAC,QAAQ,EAAC,IAAI,kBAC/B,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,GACtB,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;QAC3C,OAAO,CACL,KAAC,cAAc,IAAC,IAAI,EAAC,QAAQ,EAAC,IAAI,kBAC/B,MAAM,CAAC,IAAI,GACG,CAClB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAC3D,MAAM,eAAe,GAAG;IACtB,OAAO,EAAE,cAAc;IACvB,GAAG,EAAE,UAAU;IACf,MAAM,EAAE,aAAa;CAItB,CAAC;AAEF;;;;GAIG;AACH,MAAM,eAAe,GAAG,IAAI,CAAC"}

package/lib/projection/ui/ProjectionMapControls.d.ts

@@ -0,0 +1,67 @@
+import type { ReactElement } from 'react';
+import type { OverlayTier } from '../../overlay/core/overlayTiers.ts';
+import type { ProjectionCopy } from '../core/projectionCopy.ts';
+import type { ProjectionOptions } from '../core/projectionOptions.ts';
+import type { ProjectionReading } from './projectionBarReadings.ts';
+/** What the map's controls are drawn from, wherever in the bar they sit. */
+export interface ProjectionMapControlsProps {
+    /** What the map is showing, already resolved against the result. */
+    options: ProjectionOptions;
+    /** Called with only the options that changed, for the viewer to merge. */
+    onChange: (patch: Partial<ProjectionOptions>) => void;
+    /** The words the bar writes, already merged over the defaults. */
+    copy: ProjectionCopy;
+    /** What the set of groups is called, which is what `Colour by` offers. */
+    groupLabel: string;
+    /**
+     * Whether the samples carry groups at all. Without them the colour and the
+     * outlines stand for nothing, so their controls are greyed rather than
+     * removed: a reader who cannot find a control assumes the figure has none.
+     * @default false
+     */
+    hasGroups?: boolean;
+    /**
+     * What the two settings currently read, with the figure's own colours. They
+     * are built once for the bar and handed down rather than spelled again here,
+     * so the chip can never write a value the fold was not measured against.
+     * @default [] — nothing is written, which is what the panel behind the cog
+     * wants
+     */
+    readings?: readonly ProjectionReading[];
+    /**
+     * How much of itself the bar is writing.
+     * @default 'full'
+     */
+    tier?: OverlayTier;
+}
+/**
+ * The map settings a reader changes while looking at the picture.
+ *
+ * They are the ones a reader who has never met a component still has an
+ * opinion about — what the colour means, whether the groups are ringed, and
+ * whether the picture writes the names — while the axes, the dot size and the
+ * gestures belong to somebody who already knows what they are looking for and
+ * wait behind the cog.
+ *
+ * The two names are switches rather than menus because they are the settings a
+ * reader throws and unthrows while reading rather than choosing once: a map of
+ * forty groups needs its crowds named, and a reader who has just found an
+ * outlier wants its name for as long as it takes to write it down.
+ *
+ * The first two are written as their values rather than as captions beside
+ * boxes: the name of a setting is read once, on the first visit, and its value
+ * is read every time the figure is looked at, so the bar says `Species` and
+ * `95%` and leaves `Colour by` and `Group outlines` to the pointer and the
+ * menu. Once the figure is too narrow to carry both, they gather into one chip
+ * that still reads them — a cog there would tell the reader nothing about how
+ * the picture in front of them is drawn.
+ *
+ * The two switches never gather. A switch has no value to write, so it is
+ * already as small as it can be drawn, and it stays a glyph on the bar at every
+ * width — beside the question mark and the cog, which are the same shape for
+ * the same reason.
+ * @param props - See {@link ProjectionMapControlsProps}.
+ * @returns The controls.
+ */
+export declare function ProjectionMapControls(props: ProjectionMapControlsProps): ReactElement;
+//# sourceMappingURL=ProjectionMapControls.d.ts.map

package/lib/projection/ui/ProjectionMapControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapControls.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapControls.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAOtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAWpE,4EAA4E;AAC5E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACtD,kEAAkE;IAClE,IAAI,EAAE,cAAc,CAAC;IACrB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACxC;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,0BAA0B,GAChC,YAAY,CA+Ed"}