react-cheminfo 0.9.0 → 0.11.0

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"}

package/lib/projection/ui/ProjectionMapControls.js

@@ -0,0 +1,108 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { OverlayChip } from "../../overlay/ui/OverlayChip.js";
+import { OverlaySegmented } from "../../overlay/ui/OverlaySegmented.js";
+import { OverlaySelect } from "../../overlay/ui/OverlaySelect.js";
+import { OverlayToggle } from "../../overlay/ui/OverlayToggle.js";
+import { OverlayValueMenu } from "../../overlay/ui/OverlayValueMenu.js";
+import { ellipseChoices, ellipseKey, ellipseSize, } from "./projectionEllipse.js";
+import { projectionColourChoices, projectionOutlineChoices, } from "./projectionMapChoices.js";
+/**
+ * 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 function ProjectionMapControls(props) {
+    const { options, onChange, copy, groupLabel, hasGroups = false } = props;
+    const { readings = NO_READINGS, tier = 'full' } = props;
+    const { bar, help } = copy;
+    const uncoloured = !hasGroups || options.colorBy === 'none';
+    const settings = (_jsx(MapSettings, { options: options, onChange: onChange, copy: copy, groupLabel: groupLabel, hasGroups: hasGroups }));
+    const names = (_jsxs(_Fragment, { children: [_jsx(OverlayToggle, { label: bar.switches.showGroupLabels, help: help.showGroupLabels, icon: GROUP_LABELS_GLYPH, hideLabel: true, checked: options.showGroupLabels, disabled: uncoloured, onChange: (showGroupLabels) => onChange({ showGroupLabels }) }), _jsx(OverlayToggle, { label: bar.switches.showIds, help: help.showIds, icon: IDS_GLYPH, hideLabel: true, checked: options.showIds, onChange: (showIds) => onChange({ showIds }) })] }));
+    if (tier === 'chip' || tier === 'tiny') {
+        return (_jsxs(_Fragment, { children: [_jsx(OverlayChip, { label: bar.settings, settings: chipSettings(readings), disabled: !hasGroups, children: settings }), names] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsx(OverlayValueMenu, { label: help.colorBy.title, keyWord: bar.key.colorBy, showKey: tier === 'full', value: options.colorBy, swatches: swatchesOf(readings), disabled: !hasGroups, disabledReason: NO_GROUPS_REASON, options: projectionColourChoices(groupLabel, bar.uncoloured), onChange: (colorBy) => onChange({ colorBy }) }), _jsx(OverlayValueMenu, { label: help.ellipse.title, keyWord: bar.key.ellipse, showKey: tier === 'full', value: ellipseKey(options.ellipse), disabled: uncoloured, disabledReason: UNCOLOURED_REASON, options: projectionOutlineChoices(options, bar.noOutlines), onChange: (value) => onChange({ ellipse: ellipseSize(value) }) }), names] }));
+}
+/**
+ * What the chip reads out, which is every setting spelled in full.
+ * @param readings - What the settings currently read.
+ * @returns The chip's own settings.
+ */
+function chipSettings(readings) {
+    const settings = [];
+    for (const reading of readings) {
+        settings.push({
+            label: reading.label,
+            value: reading.value,
+            swatches: reading.swatches,
+        });
+    }
+    return settings;
+}
+/**
+ * The figure's own colours, from whichever setting decides them.
+ * @param readings - What the settings currently read.
+ * @returns The colours, or nothing where the map is uncoloured.
+ */
+function swatchesOf(readings) {
+    for (const reading of readings) {
+        const { swatches } = reading;
+        if (swatches !== undefined && swatches.length > 0)
+            return swatches;
+    }
+    return undefined;
+}
+/**
+ * The same settings with their captions, for the panel the chip opens.
+ *
+ * They are the full controls rather than a reduced set: a reader who has
+ * opened the chip has room for the words, and the sentence `95% of samples`
+ * is the one place the figure explains what its outlines actually cover.
+ * @param props - See {@link MapSettingsProps}.
+ * @returns The captioned controls.
+ */
+function MapSettings(props) {
+    const { options, onChange, copy, groupLabel, hasGroups } = props;
+    const { bar, help } = copy;
+    return (_jsxs(_Fragment, { children: [_jsx(OverlaySegmented, { label: help.colorBy.title, help: help.colorBy, value: options.colorBy, disabled: !hasGroups, options: projectionColourChoices(groupLabel, bar.uncoloured), onChange: (colorBy) => onChange({ colorBy }) }), _jsx(OverlaySelect, { label: help.ellipse.title, help: help.ellipse, value: ellipseKey(options.ellipse), disabled: !hasGroups || options.colorBy === 'none', options: ellipseChoices(options.ellipse), onChange: (value) => onChange({ ellipse: ellipseSize(value) }) })] }));
+}
+/** Why the two settings are dead, written as the thing the data is missing. */
+/**
+ * The two glyphs the switches ride as.
+ *
+ * A tag is what a group's name is — one word pinned to a crowd — and a number
+ * plate is the sample's own, which is exactly the difference the two switches
+ * make to the picture. Neither is left to be guessed at: the pointer is given
+ * the switch's name, and a narrow figure spells both out inside the chip.
+ */
+const GROUP_LABELS_GLYPH = 'tag';
+const IDS_GLYPH = 'id-number';
+const NO_GROUPS_REASON = 'These samples carry no groups to colour by.';
+const UNCOLOURED_REASON = 'Outlines follow the groups, so colour the map by them first.';
+/** No readings at all, which is what the panel behind the cog is handed. */
+const NO_READINGS = [];
+//# sourceMappingURL=ProjectionMapControls.js.map

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

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

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

@@ -0,0 +1,39 @@
+import type { ReactElement } from 'react';
+import type { OverlayLegendEntry } from '../../overlay/ui/OverlayLegend.tsx';
+import type { ProjectionMapCloud } from './projectionMapModel.ts';
+/** What {@link ProjectionMapLegend} needs. */
+export interface ProjectionMapLegendProps {
+    /** The one short sentence naming what the colour means here. */
+    title: string;
+    /** What each mark on the map means, in the order they are written. */
+    entries: readonly OverlayLegendEntry[];
+    /** Where every sample sits, in the embedding's own units. */
+    cloud: ProjectionMapCloud;
+    /** The range the horizontal axis covers. */
+    xDomain: readonly [number, number];
+    /** The range the vertical axis covers. */
+    yDomain: readonly [number, number];
+    /** Width of the whole figure, in pixels. */
+    width: number;
+    /** Its height. */
+    height: number;
+}
+/**
+ * The key, floating in the emptiest corner of the plot itself.
+ *
+ * It floats because an embedded figure cannot spend a block of somebody else's
+ * page on a card that says three words, and it is held inside the plot
+ * rectangle rather than inside the figure's own box because the strips outside
+ * that rectangle are where the axes are written: a key in the bottom left
+ * corner of the *figure* covers the vertical axis' labels and the name under
+ * the horizontal one, which is a worse trade than covering a few pixels of
+ * empty plot.
+ *
+ * Inside the plot every corner is honest, so the corner is chosen by counting
+ * the dots under each — a key in a fixed corner eventually sits on the one
+ * cluster the reader came for.
+ * @param props - See {@link ProjectionMapLegendProps}.
+ * @returns The key.
+ */
+export declare function ProjectionMapLegend(props: ProjectionMapLegendProps): ReactElement;
+//# sourceMappingURL=ProjectionMapLegend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapLegend.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapLegend.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAG7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAOlE,8CAA8C;AAC9C,MAAM,WAAW,wBAAwB;IACvC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,OAAO,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACvC,6DAA6D;IAC7D,KAAK,EAAE,kBAAkB,CAAC;IAC1B,4CAA4C;IAC5C,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,0CAA0C;IAC1C,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,wBAAwB,GAC9B,YAAY,CAoBd"}

package/lib/projection/ui/ProjectionMapLegend.js

@@ -0,0 +1,29 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { OverlayLegend } from "../../overlay/ui/OverlayLegend.js";
+import { projectionMapCorner } from "./projectionMapModel.js";
+import { PROJECTION_PLOT_AREA_STYLE, PROJECTION_PLOT_ROOM, } from "./projectionTabStyles.js";
+/**
+ * The key, floating in the emptiest corner of the plot itself.
+ *
+ * It floats because an embedded figure cannot spend a block of somebody else's
+ * page on a card that says three words, and it is held inside the plot
+ * rectangle rather than inside the figure's own box because the strips outside
+ * that rectangle are where the axes are written: a key in the bottom left
+ * corner of the *figure* covers the vertical axis' labels and the name under
+ * the horizontal one, which is a worse trade than covering a few pixels of
+ * empty plot.
+ *
+ * Inside the plot every corner is honest, so the corner is chosen by counting
+ * the dots under each — a key in a fixed corner eventually sits on the one
+ * cluster the reader came for.
+ * @param props - See {@link ProjectionMapLegendProps}.
+ * @returns The key.
+ */
+export function ProjectionMapLegend(props) {
+    const { title, entries, cloud, xDomain, yDomain, width, height } = props;
+    const plotWidth = width - PROJECTION_PLOT_ROOM.left - PROJECTION_PLOT_ROOM.right;
+    const plotHeight = height - PROJECTION_PLOT_ROOM.top - PROJECTION_PLOT_ROOM.bottom;
+    const corner = projectionMapCorner(cloud, xDomain, yDomain, Math.max(0, plotWidth), Math.max(0, plotHeight));
+    return (_jsx("div", { style: PROJECTION_PLOT_AREA_STYLE, children: _jsx(OverlayLegend, { placement: corner, title: title, entries: entries }) }));
+}
+//# sourceMappingURL=ProjectionMapLegend.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapLegend.js","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapLegend.tsx"],"names":[],"mappings":";AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAoC,CAAC;AAGnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAoBlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAA+B;IAE/B,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAEzE,MAAM,SAAS,GACb,KAAK,GAAG,oBAAoB,CAAC,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC;IACjE,MAAM,UAAU,GACd,MAAM,GAAG,oBAAoB,CAAC,GAAG,GAAG,oBAAoB,CAAC,MAAM,CAAC;IAClE,MAAM,MAAM,GAAG,mBAAmB,CAChC,KAAK,EACL,OAAO,EACP,OAAO,EACP,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,EACtB,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CACxB,CAAC;IAEF,OAAO,CACL,cAAK,KAAK,EAAE,0BAA0B,YACpC,KAAC,aAAa,IAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAI,GAChE,CACP,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,42 @@
+import type { ReactElement } from 'react';
+import type { ProjectionResult } from '../core/projectionResult.ts';
+import type { ProjectionMapControlsProps } from './ProjectionMapControls.tsx';
+/** What {@link ProjectionMapMore} needs beyond the map's own controls. */
+export interface ProjectionMapMoreProps extends ProjectionMapControlsProps {
+    /** The reduced space the controls apply to; its axes fill the two pickers. */
+    result: ProjectionResult;
+    /**
+     * How many samples are selected, which is what the two selection actions
+     * need before they can do anything.
+     * @default 0
+     */
+    selectedCount?: number;
+    /** Draws the frame around the selected samples. */
+    onZoomToSelection: () => void;
+    /** Puts the frame back around every sample. */
+    onResetView: () => void;
+    /** Empties the selection. */
+    onClearSelection: () => void;
+}
+/**
+ * What the map keeps behind the cog: the axes, the dot size, what a drag does,
+ * and the three buttons that act rather than change.
+ *
+ * Five settings is where a flat list stops being scannable, so they are filed
+ * under three headings — the two directions of the picture, the marks drawn in
+ * it, and the one gesture the reader makes over it — and the buttons leave the
+ * list entirely for the foot of the panel. A command sitting in a column of
+ * settings is read as one, and `Clear selection` read as a setting is a press
+ * nobody meant to make.
+ *
+ * The colour, the outlines and the two kinds of name are not here: they are on
+ * the bar itself, where a reader changes them while looking at the picture.
+ *
+ * The two selection actions are greyed rather than hidden while nothing is
+ * picked, so a reader learns that lassoing a crowd is worth doing before they
+ * have done it.
+ * @param props - See {@link ProjectionMapMoreProps}.
+ * @returns The panel behind the cog.
+ */
+export declare function ProjectionMapMore(props: ProjectionMapMoreProps): ReactElement;
+//# sourceMappingURL=ProjectionMapMore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapMore.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapMore.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAY1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAOpE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAE9E,0EAA0E;AAC1E,MAAM,WAAW,sBAAuB,SAAQ,0BAA0B;IACxE,8EAA8E;IAC9E,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,iBAAiB,EAAE,MAAM,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,YAAY,CAkF7E"}

package/lib/projection/ui/ProjectionMapMore.js

@@ -0,0 +1,74 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { chartAxisTitle } from "../../chart/core/chartLabels.js";
+import { OverlayAction } from "../../overlay/ui/OverlayAction.js";
+import { OverlayGroup } from "../../overlay/ui/OverlayGroup.js";
+import { OverlayNumber } from "../../overlay/ui/OverlayNumber.js";
+import { OverlayPanel } from "../../overlay/ui/OverlayPanel.js";
+import { OverlaySegmented } from "../../overlay/ui/OverlaySegmented.js";
+import { OverlaySelect } from "../../overlay/ui/OverlaySelect.js";
+import { OverlayToggle } from "../../overlay/ui/OverlayToggle.js";
+import { PROJECTION_PANEL_NAME, PROJECTION_PANEL_SECTION, } from "../core/projectionStrings.js";
+import { PROJECTION_TAB_DEFAULTS } from "../core/projectionTabDefaults.js";
+/**
+ * What the map keeps behind the cog: the axes, the dot size, what a drag does,
+ * and the three buttons that act rather than change.
+ *
+ * Five settings is where a flat list stops being scannable, so they are filed
+ * under three headings — the two directions of the picture, the marks drawn in
+ * it, and the one gesture the reader makes over it — and the buttons leave the
+ * list entirely for the foot of the panel. A command sitting in a column of
+ * settings is read as one, and `Clear selection` read as a setting is a press
+ * nobody meant to make.
+ *
+ * The colour, the outlines and the two kinds of name are not here: they are on
+ * the bar itself, where a reader changes them while looking at the picture.
+ *
+ * The two selection actions are greyed rather than hidden while nothing is
+ * picked, so a reader learns that lassoing a crowd is worth doing before they
+ * have done it.
+ * @param props - See {@link ProjectionMapMoreProps}.
+ * @returns The panel behind the cog.
+ */
+export function ProjectionMapMore(props) {
+    const { result, options, onChange, copy, hasGroups = false } = props;
+    const { selectedCount = 0, onZoomToSelection } = props;
+    const { onResetView, onClearSelection } = props;
+    const { action, help, tab } = copy;
+    const nothingPicked = selectedCount === 0;
+    const uncoloured = !hasGroups || options.colorBy === 'none';
+    return (_jsxs(OverlayPanel, { title: tab.map, onReset: () => onChange(PROJECTION_TAB_DEFAULTS.map), actions: _jsxs(_Fragment, { children: [_jsx(OverlayAction, { text: action.zoomToSelection, icon: "zoom-to-fit", disabled: nothingPicked, onClick: onZoomToSelection }), _jsx(OverlayAction, { text: action.resetView, icon: "reset", onClick: onResetView }), _jsx(OverlayAction, { text: action.clearSelection, icon: "cross", disabled: nothingPicked, onClick: onClearSelection })] }), children: [_jsxs(OverlayGroup, { label: PROJECTION_PANEL_SECTION.axes, divider: false, children: [_jsx(OverlaySelect, { label: PROJECTION_PANEL_NAME.xAxis, help: help.xAxis, value: String(options.xAxis), options: axisChoices(result, options.yAxis), onChange: (value) => onChange({ xAxis: Number(value) }) }), _jsx(OverlaySelect, { label: PROJECTION_PANEL_NAME.yAxis, help: help.yAxis, value: String(options.yAxis), options: axisChoices(result, options.xAxis), onChange: (value) => onChange({ yAxis: Number(value) }) })] }), _jsxs(OverlayGroup, { label: PROJECTION_PANEL_SECTION.drawing, children: [_jsx(OverlayNumber, { label: PROJECTION_PANEL_NAME.pointRadius, help: help.pointRadius, value: options.pointRadius, min: 1, max: 12, step: 0.5, digits: 1, unit: "px", onChange: (pointRadius) => onChange({ pointRadius }) }), _jsx(OverlayToggle, { label: PROJECTION_PANEL_NAME.showGroupMeans, help: help.showGroupMeans, checked: options.showGroupMeans, disabled: uncoloured, onChange: (showGroupMeans) => onChange({ showGroupMeans }) })] }), _jsx(OverlayGroup, { label: PROJECTION_PANEL_SECTION.selecting, children: _jsx(OverlaySegmented, { label: PROJECTION_PANEL_NAME.selectMode, help: help.selectMode, value: options.selectMode, options: SELECT_MODE_CHOICES, onChange: (selectMode) => onChange({ selectMode }) }) })] }));
+}
+const AXIS_TAKEN_NOTE = 'Already drawn on the other axis.';
+/**
+ * What a plain drag does. Three words rather than a sentence, because a
+ * segment has room for one word and the line over the plot says the rest while
+ * the drag is under way.
+ */
+const SELECT_MODE_CHOICES = [
+    { value: 'replace', label: 'Replace' },
+    { value: 'add', label: 'Add' },
+    { value: 'remove', label: 'Remove' },
+];
+/**
+ * The axes one picker offers, with the one already drawn kept but unreachable.
+ * @param result - The reduced space being drawn.
+ * @param taken - The axis the other picker is showing.
+ * @returns The choices, in the order the run produced them.
+ */
+function axisChoices(result, taken) {
+    const choices = [];
+    for (let index = 0; index < result.axes.length; index++) {
+        const axis = result.axes[index];
+        if (axis === undefined)
+            continue;
+        const drawn = index === taken;
+        choices.push({
+            value: String(index),
+            label: chartAxisTitle(axis.name, { share: axis.share }),
+            disabled: drawn,
+            title: drawn ? AXIS_TAKEN_NOTE : undefined,
+        });
+    }
+    return choices;
+}
+//# sourceMappingURL=ProjectionMapMore.js.map

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

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

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

@@ -0,0 +1,107 @@
+import type { ReactElement, ReactNode } from 'react';
+import type { ChartViewport } from '../../chart/core/chartViewport.ts';
+import type { ScatterPointOpen } from '../../scatter/ui/scatterPlotProps.ts';
+import type { SelectionChange } from '../../scatter/ui/useScatterSelection.ts';
+import type { ProjectionCopy } from '../core/projectionCopy.ts';
+import type { ProjectionOptions } from '../core/projectionOptions.ts';
+import type { ProjectionResult } from '../core/projectionResult.ts';
+import type { ResolvedProjectionGroups } from '../core/projectionSamples.ts';
+import type { SelectionReport } from './ProjectionMapCaption.tsx';
+import type { ProjectionMapChrome } from './projectionMapChrome.ts';
+/** What {@link ProjectionMapTab} needs. */
+export interface ProjectionMapTabProps {
+    /** What the run produced, whatever produced it. */
+    result: ProjectionResult;
+    /** The groups, resolved once by the viewer so every tab colours alike. */
+    groups: ResolvedProjectionGroups;
+    /** What the map is showing, already resolved against `result`. */
+    options: ProjectionOptions;
+    /** The words the map writes, already merged over the defaults. */
+    copy: ProjectionCopy;
+    /** The key's title and entries, built once with the bar's explanation. */
+    chrome: ProjectionMapChrome;
+    /**
+     * What each sample is called, in the score matrix's row order, for the map's
+     * "Sample ID" setting to write beside its dot.
+     * @default undefined — the setting has nothing to write and draws nothing
+     */
+    ids?: readonly string[];
+    /** Width of the figure, in pixels. */
+    width: number;
+    /** Height of the figure, in pixels. */
+    height: number;
+    /** The selected rows, as indices into the score matrix. */
+    selected: readonly number[];
+    /**
+     * The frame the map is drawn in, which is what a zoom leaves behind, or
+     * `null` to draw it around every sample.
+     * @default null
+     */
+    viewport?: ChartViewport | null;
+    /**
+     * Called with the frame a wheel or a double click asks for.
+     * @default undefined
+     */
+    onViewportChange?: (viewport: ChartViewport | null) => void;
+    /**
+     * Whether the wheel zooms the map, once the pointer has rested on it.
+     * @default false
+     */
+    wheelZoom?: boolean;
+    /**
+     * What the last gesture picked out, for the line over the plot.
+     * @default null — nothing has happened yet
+     */
+    report?: SelectionReport | null;
+    /**
+     * Called when a lasso is released, a dot is clicked, or the selection is
+     * emptied — never while a lasso is being drawn.
+     * @default undefined
+     */
+    onSelectionChange?: (change: SelectionChange) => void;
+    /**
+     * Called with the row under the pointer, or `-1`.
+     * @default undefined
+     */
+    onHoverChange?: (index: number) => void;
+    /**
+     * Called when the reader double-clicks a sample.
+     * @default undefined
+     */
+    onPointDoubleClick?: (point: ScatterPointOpen) => void;
+    /**
+     * The card that follows the pointer. The viewer builds it, because it has to
+     * say the same thing on every tab.
+     * @default undefined — no card is drawn
+     */
+    hoverCard?: ReactNode;
+    /**
+     * Whether a drag on a touch screen draws a lasso rather than scrolling.
+     * @default false
+     */
+    touchLasso?: boolean;
+    /**
+     * Value of the `data-testid` attribute of the figure.
+     * @default undefined
+     */
+    testId?: string;
+}
+/**
+ * The map: one dot per sample, an outline per group, and a key floating in the
+ * emptiest corner of the plot.
+ *
+ * Colour stands for the group and for nothing else, and a selected dot keeps
+ * its colour and gains a ring — recolouring it would trade the answer the
+ * reader came for against the question they have just asked. A sample the
+ * model was built from is drawn filled and one placed into the finished model
+ * afterwards is drawn hollow, because the second kind can land anywhere and
+ * its landing far out is the finding rather than a fault.
+ *
+ * Nothing stands under the picture. The tab is one figure and its key, so the
+ * height a page gives the viewer is spent on the data; what the map has to say
+ * in words is behind the question mark in the bar above it.
+ * @param props - See {@link ProjectionMapTabProps}.
+ * @returns The figure.
+ */
+export declare function ProjectionMapTab(props: ProjectionMapTabProps): ReactElement;
+//# sourceMappingURL=ProjectionMapTab.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectionMapTab.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/ProjectionMapTab.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAEV,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAE7E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAIlE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAUpE,2CAA2C;AAC3C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,wBAAwB,CAAC;IACjC,kEAAkE;IAClE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,kEAAkE;IAClE,IAAI,EAAE,cAAc,CAAC;IACrB,0EAA0E;IAC1E,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;;;OAIG;IACH,GAAG,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IACtD;;;OAGG;IACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACvD;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,YAAY,CAqF3E"}

package/lib/projection/ui/ProjectionMapTab.js

@@ -0,0 +1,43 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useMemo, useState } from 'react';
+import { ScatterPlot } from "../../scatter/ui/ScatterPlot.js";
+import { ProjectionMapCaption } from "./ProjectionMapCaption.js";
+import { ProjectionMapLegend } from "./ProjectionMapLegend.js";
+import { ProjectionSurface } from "./ProjectionSurface.js";
+import { MINIMUM_OUTLINE_POINTS, projectionAxisTitle, projectionMapCloud, projectionMapDomain, projectionMapMarkers, projectionScatterGroups, } from "./projectionMapModel.js";
+/**
+ * The map: one dot per sample, an outline per group, and a key floating in the
+ * emptiest corner of the plot.
+ *
+ * Colour stands for the group and for nothing else, and a selected dot keeps
+ * its colour and gains a ring — recolouring it would trade the answer the
+ * reader came for against the question they have just asked. A sample the
+ * model was built from is drawn filled and one placed into the finished model
+ * afterwards is drawn hollow, because the second kind can land anywhere and
+ * its landing far out is the finding rather than a fault.
+ *
+ * Nothing stands under the picture. The tab is one figure and its key, so the
+ * height a page gives the viewer is spent on the data; what the map has to say
+ * in words is behind the question mark in the bar above it.
+ * @param props - See {@link ProjectionMapTabProps}.
+ * @returns The figure.
+ */
+export function ProjectionMapTab(props) {
+    const { result, groups, options, copy, chrome, width, height } = props;
+    const { ids, selected, viewport = null, report = null } = props;
+    const { onSelectionChange, onHoverChange, hoverCard } = props;
+    const { onPointDoubleClick } = props;
+    const { onViewportChange, wheelZoom, touchLasso, testId } = props;
+    const { scores, fittedCount, markers } = result;
+    const { xAxis, yAxis, colorBy, showGroupMeans, pointRadius } = options;
+    const { showGroupLabels, showIds, selectMode, ellipse: outlines } = options;
+    const [drawing, setDrawing] = useState(false);
+    const cloud = useMemo(() => projectionMapCloud(scores, xAxis, yAxis), [scores, xAxis, yAxis]);
+    const xDomain = useMemo(() => projectionMapDomain(scores, xAxis), [scores, xAxis]);
+    const yDomain = useMemo(() => projectionMapDomain(scores, yAxis), [scores, yAxis]);
+    const colored = colorBy === 'group' && groups.entries.length > 0;
+    const ellipse = colored ? outlines : null;
+    return (_jsx(ScatterPlot, { x: cloud.x, y: cloud.y, width: width, height: height, xAxis: { domain: xDomain, label: projectionAxisTitle(result, xAxis) }, yAxis: { domain: yDomain, label: projectionAxisTitle(result, yAxis) }, groupOf: colored ? groups.groupOf : undefined, groups: colored ? projectionScatterGroups(groups) : undefined, ellipse: ellipse, ellipseMinimumPoints: MINIMUM_OUTLINE_POINTS, showGroupMeans: colored && showGroupMeans, showGroupLabels: colored && showGroupLabels, pointLabels: showIds ? ids : undefined, markers: projectionMapMarkers(markers ?? NO_MARKERS, groups, xAxis, yAxis), pointRadius: pointRadius, outlinedFrom: fittedCount, selected: selected, viewport: viewport, onViewportChange: onViewportChange, wheelZoom: wheelZoom, onSelectionChange: onSelectionChange, selectMode: selectMode, onHoverChange: onHoverChange, onPointDoubleClick: onPointDoubleClick, onLassoChange: setDrawing, touchLasso: touchLasso, testId: testId, overlay: _jsxs(ProjectionSurface, { children: [chrome.entries.length === 0 ? null : (_jsx(ProjectionMapLegend, { title: chrome.title, entries: chrome.entries, cloud: cloud, xDomain: viewport?.x ?? xDomain, yDomain: viewport?.y ?? yDomain, width: width, height: height })), _jsx(ProjectionMapCaption, { report: report, copy: copy, mode: selectMode, drawing: drawing }), hoverCard] }) }));
+}
+const NO_MARKERS = [];
+//# sourceMappingURL=ProjectionMapTab.js.map

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

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