react-cheminfo 0.9.0 → 0.11.0

package/lib/projection/ui/projectionMapView.js

@@ -0,0 +1,116 @@
+/**
+ * What the map is showing that is not an option: the frame it is drawn in, the
+ * sentence reporting the last gesture, and the words its key and its question
+ * mark are built from.
+ *
+ * All of it lives above the tab rather than inside it because the bar spanning
+ * the figure is the viewer's, not the map's: "Zoom to selection" is pressed in
+ * the bar and changes the frame the map draws, and "Clear selection" has to
+ * report itself in exactly the words a released lasso does.
+ */
+import { useCallback, useMemo, useState } from 'react';
+import { chartClampViewport } from "../../chart/core/chartViewport.js";
+import { DEFAULT_ORBIT_CAMERA } from "../../scatter3d/core/orbitCamera.js";
+import { projectionMapChrome, projectionSelectionSentence, } from "./projectionMapChrome.js";
+import { MINIMUM_OUTLINE_POINTS, projectionMapDomain, projectionMapViewport, } from "./projectionMapModel.js";
+import { MINIMUM_SHELL_POINTS } from "./projectionSpaceModel.js";
+/**
+ * The map's frame, its last report, and the words around it.
+ * @param input - See {@link ProjectionMapViewInput}.
+ * @returns See {@link ProjectionMapView}.
+ */
+export function useProjectionMapView(input) {
+    const { result, copy, groups, options, selected, onSettle } = input;
+    const { scores, fittedCount, markers } = result;
+    const { colorBy, ellipse, showGroupMeans, xAxis, yAxis } = options;
+    const [zoom, setZoom] = useState(null);
+    const [report, setReport] = useState(null);
+    const [camera, setCamera] = useState(DEFAULT_ORBIT_CAMERA);
+    const [cloudZoom, setCloudZoom] = useState(1);
+    // A frame belongs to the pair of axes it was drawn on. Carrying it onto
+    // another pair would show the reader a corner of a picture they never
+    // framed, so changing the axes shows the whole of the new one instead.
+    const viewport = zoom !== null && zoom.xAxis === xAxis && zoom.yAxis === yAxis
+        ? zoom.viewport
+        : null;
+    const setViewport = useCallback((next) => {
+        setZoom(next === null ? null : { xAxis, yAxis, viewport: next });
+    }, [xAxis, yAxis]);
+    const zoomToSelection = useCallback(() => {
+        if (selected.length === 0)
+            return;
+        setViewport(chartClampViewport({
+            x: projectionMapDomain(scores, xAxis),
+            y: projectionMapDomain(scores, yAxis),
+        }, projectionMapViewport(scores, xAxis, yAxis, selected)));
+    }, [scores, selected, setViewport, xAxis, yAxis]);
+    const resetView = useCallback(() => {
+        setViewport(null);
+    }, [setViewport]);
+    const resetSpaceView = useCallback(() => {
+        setCamera(DEFAULT_ORBIT_CAMERA);
+        setCloudZoom(1);
+    }, []);
+    const colored = colorBy === 'group' && groups.entries.length > 0;
+    const chrome = useMemo(() => projectionMapChrome({
+        copy,
+        groups,
+        colored,
+        ellipse: colored ? ellipse : null,
+        minimumPoints: MINIMUM_OUTLINE_POINTS,
+        showGroupMeans,
+        markers: markers ?? NO_MARKERS,
+        fittedCount: fittedCount ?? scores.rows,
+        total: scores.rows,
+    }), [
+        copy,
+        groups,
+        colored,
+        ellipse,
+        showGroupMeans,
+        markers,
+        fittedCount,
+        scores,
+    ]);
+    const spaceChrome = useMemo(() => projectionMapChrome({
+        copy,
+        groups,
+        colored,
+        ellipse: colored ? ellipse : null,
+        minimumPoints: MINIMUM_SHELL_POINTS,
+        showGroupMeans: false,
+        markers: NO_MARKERS,
+        fittedCount: fittedCount ?? scores.rows,
+        total: scores.rows,
+        figure: 'space',
+    }), [copy, groups, colored, ellipse, fittedCount, scores]);
+    const settle = useCallback((change) => {
+        setReport((previous) => ({
+            text: projectionSelectionSentence(copy, change.indices.length, scores.rows),
+            at: (previous?.at ?? 0) + 1,
+        }));
+        onSettle(change);
+    }, [copy, onSettle, scores]);
+    const clearSelection = useCallback(() => {
+        settle({ indices: NO_SELECTION, mode: 'replace', source: 'clear' });
+    }, [settle]);
+    return {
+        chrome,
+        spaceChrome,
+        viewport,
+        setViewport,
+        camera,
+        setCamera,
+        zoom: cloudZoom,
+        setZoom: setCloudZoom,
+        resetSpaceView,
+        report,
+        settle,
+        zoomToSelection,
+        resetView,
+        clearSelection,
+    };
+}
+const NO_SELECTION = [];
+const NO_MARKERS = [];
+//# sourceMappingURL=projectionMapView.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * How many components the pair grid may be asked to lay out.
+ *
+ * The bar and the panel behind the cog both offer the count, and a ceiling
+ * worked out twice is a ceiling that ends up different in the two places — so
+ * the reader would find the same stepper dead on one and live on the other.
+ * It sits apart from both of them because it is arithmetic rather than a
+ * control, and a module that exports a component exports nothing else.
+ */
+/** How few and how many components the grid may be asked to lay out. */
+export interface ProjectionPairsCeiling {
+    /** The fewest, which is the smallest grid worth drawing. */
+    min: number;
+    /** The most, once the run and the width have both had their say. */
+    max: number;
+}
+/**
+ * The range the grid's count is held inside.
+ *
+ * Three things cap it at once: six, which is where thirty-six cells stop being
+ * worth the room; what the run produced; and what the width can draw at a
+ * readable size. Pressing past any of them is dead rather than silently
+ * ignored, so the number in the bar is the number on the screen.
+ * @param axisCount - How many components the run produced.
+ * @param width - Width of the figure, in pixels; `0` before it is measured.
+ * @returns See {@link ProjectionPairsCeiling}.
+ */
+export declare function projectionPairsCeiling(axisCount: number, width: number): ProjectionPairsCeiling;
+//# sourceMappingURL=projectionPairsCeiling.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionPairsCeiling.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/projectionPairsCeiling.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wEAAwE;AACxE,MAAM,WAAW,sBAAsB;IACrC,4DAA4D;IAC5D,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,sBAAsB,CAIxB"}

package/lib/projection/ui/projectionPairsCeiling.js

@@ -0,0 +1,29 @@
+/**
+ * How many components the pair grid may be asked to lay out.
+ *
+ * The bar and the panel behind the cog both offer the count, and a ceiling
+ * worked out twice is a ceiling that ends up different in the two places — so
+ * the reader would find the same stepper dead on one and live on the other.
+ * It sits apart from both of them because it is arithmetic rather than a
+ * control, and a module that exports a component exports nothing else.
+ */
+import { SCATTER_MATRIX_MOST_AXES, scatterMatrixAxesThatFit, } from "../../scatter/ui/scatterMatrixLayout.js";
+/**
+ * The range the grid's count is held inside.
+ *
+ * Three things cap it at once: six, which is where thirty-six cells stop being
+ * worth the room; what the run produced; and what the width can draw at a
+ * readable size. Pressing past any of them is dead rather than silently
+ * ignored, so the number in the bar is the number on the screen.
+ * @param axisCount - How many components the run produced.
+ * @param width - Width of the figure, in pixels; `0` before it is measured.
+ * @returns See {@link ProjectionPairsCeiling}.
+ */
+export function projectionPairsCeiling(axisCount, width) {
+    const wanted = Math.min(SCATTER_MATRIX_MOST_AXES, Math.max(0, axisCount));
+    const fits = width > 0 ? scatterMatrixAxesThatFit(width, wanted) : wanted;
+    return { min: SMALLEST_GRID, max: Math.max(SMALLEST_GRID, fits) };
+}
+/** The fewest components a grid is worth drawing for. */
+const SMALLEST_GRID = 2;
+//# sourceMappingURL=projectionPairsCeiling.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionPairsCeiling.js","sourceRoot":"","sources":["../../../src/projection/ui/projectionPairsCeiling.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EACL,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,yCAAyC,CAAC;AAUjD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,KAAa;IAEb,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,wBAAwB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;IAC1E,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC1E,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC;AAED,yDAAyD;AACzD,MAAM,aAAa,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,51 @@
+/**
+ * What a viewer says about its selection, and the translation between the two
+ * ways of naming a row.
+ *
+ * A plot works in row numbers because that is what it drew, and a caller works
+ * in names because that is what its own table holds. Keeping the translation
+ * here, in one direction each way, is what lets the boundary between them be a
+ * documented promise rather than a habit each tab has to remember.
+ */
+import type { ScatterSelectionMode } from '../../scatter/core/scatterSelection.ts';
+/** What a gesture did to a projection viewer's selection. */
+export interface ProjectionSelection {
+    /** The selected rows, by name, in the score matrix's row order. */
+    ids: readonly string[];
+    /** The same rows as indices into the score matrix. */
+    indices: readonly number[];
+    /** Whether the gesture replaced the previous selection, added to it, or cut from it. */
+    mode: ScatterSelectionMode;
+    /** Which gesture produced it. */
+    source: 'lasso' | 'point' | 'keyboard' | 'group' | 'clear' | 'all';
+}
+/**
+ * Where each name sits in the score matrix.
+ *
+ * The first row wins a repeated name. A duplicate id then costs the reader one
+ * unselectable row, which is a great deal better than silently moving their
+ * selection to whichever sample happened to be named the same thing last.
+ * @param ids - The row names, in the score matrix's row order.
+ * @returns The row each name stands for.
+ */
+export declare function indexProjectionIds(ids: readonly string[]): ReadonlyMap<string, number>;
+/**
+ * The rows a list of names stands for, ready for a plot to draw.
+ *
+ * A name nothing answers to is dropped rather than reported as a missing row:
+ * a caller restoring a selection saved before its data was filtered should get
+ * back the samples that are still there, not an error about the ones that are
+ * not.
+ * @param names - The names, or nothing at all.
+ * @param rowOfId - From {@link indexProjectionIds}.
+ * @returns The rows, in the order the names were given.
+ */
+export declare function projectionRowsOf(names: readonly string[] | undefined, rowOfId: ReadonlyMap<string, number>): readonly number[];
+/**
+ * The names a list of rows stands for, ready to hand back to a caller.
+ * @param rows - The rows, as indices into the score matrix.
+ * @param ids - The row names.
+ * @returns The names, in the order the rows were given.
+ */
+export declare function projectionNamesOf(rows: readonly number[], ids: readonly string[]): readonly string[];
+//# sourceMappingURL=projectionSelection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionSelection.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/projectionSelection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAEnF,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,GAAG,EAAE,SAAS,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,wFAAwF;IACxF,IAAI,EAAE,oBAAoB,CAAC;IAC3B,iCAAiC;IACjC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;CACpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAO7B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACpC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACnC,SAAS,MAAM,EAAE,CAQnB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,GAAG,EAAE,SAAS,MAAM,EAAE,GACrB,SAAS,MAAM,EAAE,CAOnB"}

package/lib/projection/ui/projectionSelection.js

@@ -0,0 +1,66 @@
+/**
+ * What a viewer says about its selection, and the translation between the two
+ * ways of naming a row.
+ *
+ * A plot works in row numbers because that is what it drew, and a caller works
+ * in names because that is what its own table holds. Keeping the translation
+ * here, in one direction each way, is what lets the boundary between them be a
+ * documented promise rather than a habit each tab has to remember.
+ */
+/**
+ * Where each name sits in the score matrix.
+ *
+ * The first row wins a repeated name. A duplicate id then costs the reader one
+ * unselectable row, which is a great deal better than silently moving their
+ * selection to whichever sample happened to be named the same thing last.
+ * @param ids - The row names, in the score matrix's row order.
+ * @returns The row each name stands for.
+ */
+export function indexProjectionIds(ids) {
+    const rows = new Map();
+    for (let index = 0; index < ids.length; index++) {
+        const id = ids[index];
+        if (id !== undefined && !rows.has(id))
+            rows.set(id, index);
+    }
+    return rows;
+}
+/**
+ * The rows a list of names stands for, ready for a plot to draw.
+ *
+ * A name nothing answers to is dropped rather than reported as a missing row:
+ * a caller restoring a selection saved before its data was filtered should get
+ * back the samples that are still there, not an error about the ones that are
+ * not.
+ * @param names - The names, or nothing at all.
+ * @param rowOfId - From {@link indexProjectionIds}.
+ * @returns The rows, in the order the names were given.
+ */
+export function projectionRowsOf(names, rowOfId) {
+    if (names === undefined)
+        return EMPTY_SELECTION;
+    const rows = [];
+    for (const name of names) {
+        const row = rowOfId.get(name);
+        if (row !== undefined)
+            rows.push(row);
+    }
+    return rows;
+}
+/**
+ * The names a list of rows stands for, ready to hand back to a caller.
+ * @param rows - The rows, as indices into the score matrix.
+ * @param ids - The row names.
+ * @returns The names, in the order the rows were given.
+ */
+export function projectionNamesOf(rows, ids) {
+    const names = [];
+    for (const row of rows) {
+        const name = ids[row];
+        if (name !== undefined)
+            names.push(name);
+    }
+    return names;
+}
+const EMPTY_SELECTION = [];
+//# sourceMappingURL=projectionSelection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionSelection.js","sourceRoot":"","sources":["../../../src/projection/ui/projectionSelection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,GAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QACtB,IAAI,EAAE,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAoC,EACpC,OAAoC;IAEpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,eAAe,CAAC;IAChD,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,IAAuB,EACvB,GAAsB;IAEtB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,eAAe,GAAsB,EAAE,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * The one number the cloud sets differently from the map.
+ */
+/**
+ * How many samples a group needs before it is given a shell.
+ *
+ * One more than the map asks for, and for the same reason the map asks for
+ * three: a shape fitted to the fewest points that can define it describes those
+ * points and not the group they came from. Three samples lie on a plane
+ * however they are arranged, so three is the number at which a shell is
+ * arithmetic rather than a finding.
+ */
+export declare const MINIMUM_SHELL_POINTS = 4;
+//# sourceMappingURL=projectionSpaceModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionSpaceModel.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/projectionSpaceModel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/lib/projection/ui/projectionSpaceModel.js

@@ -0,0 +1,14 @@
+/**
+ * The one number the cloud sets differently from the map.
+ */
+/**
+ * How many samples a group needs before it is given a shell.
+ *
+ * One more than the map asks for, and for the same reason the map asks for
+ * three: a shape fitted to the fewest points that can define it describes those
+ * points and not the group they came from. Three samples lie on a plane
+ * however they are arranged, so three is the number at which a shell is
+ * arithmetic rather than a finding.
+ */
+export const MINIMUM_SHELL_POINTS = 4;
+//# sourceMappingURL=projectionSpaceModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionSpaceModel.js","sourceRoot":"","sources":["../../../src/projection/ui/projectionSpaceModel.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * What each tab answers when the reader presses the question mark.
+ *
+ * The viewer is meant to be embedded in somebody else's page, so the paragraph
+ * that used to stand under every figure now waits behind one glyph in the bar:
+ * a reader who wants it opens it, and everybody else pays no vertical space
+ * for it. Not one word of it was dropped in the move — the sentences are the
+ * reason a reader who has never met a component can read the figure at all —
+ * so they are built here, where what a tab claims about its own numbers can be
+ * checked without rendering a chart.
+ */
+import type { ExplainedShares } from '../core/explainedShares.ts';
+import type { LoadingProfiles } from '../core/loadingProfiles.ts';
+import type { ProjectionCopy } from '../core/projectionCopy.ts';
+/**
+ * What the pair grid says about itself.
+ * @param copy - The words the viewer writes.
+ * @param groupLabel - What the set of groups is called.
+ * @param colored - Whether colour stands for the group at all; uncoloured, the
+ * sentence naming the colour would name something the grid is not drawing.
+ * @returns The paragraph.
+ */
+export declare function projectionPairsInfo(copy: ProjectionCopy, groupLabel: string, colored: boolean): string;
+/**
+ * What the "what differs" panels say about themselves.
+ *
+ * Both sentences are needed and neither stands in for the other: the first
+ * says what a panel draws, which changes with the view, and the second says
+ * what its colours mean, which is the only place the grey line is named.
+ * @param profiles - The panels as they were built, or `null` when the run
+ * reported no weights and there is nothing to explain.
+ * @param copy - The words the viewer writes.
+ * @param sample - What the one selected sample is called.
+ * @returns The paragraph.
+ */
+export declare function projectionVariablesInfo(profiles: LoadingProfiles | null, copy: ProjectionCopy, sample: string): string;
+/**
+ * What the shares figure says about itself, including its own arithmetic.
+ *
+ * The computed sentence sits between the two written ones because it is the
+ * answer the reader came for — how many components they have to keep — while
+ * the sentences around it say what a bar is and what its colour means.
+ * @param shares - The bars, already worked out.
+ * @param copy - The words the viewer writes.
+ * @returns The paragraph.
+ */
+export declare function projectionSharesInfo(shares: ExplainedShares | null, copy: ProjectionCopy): string;
+/**
+ * What the shares tab says about its own numbers, in two sentences at most.
+ *
+ * The second is left out when the reader asked for no target, and when the
+ * first component already reaches it: "the first 1 components together" is
+ * both ungrammatical and a restatement of the sentence before it.
+ * @param shares - The bars.
+ * @param copy - The words the viewer writes.
+ * @returns The sentence.
+ */
+export declare function projectionSharesSentence(shares: ExplainedShares, copy: ProjectionCopy): string;
+//# sourceMappingURL=projectionTabInfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionTabInfo.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/projectionTabInfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKhE;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,OAAO,GACf,MAAM,CAIR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,eAAe,GAAG,IAAI,EAChC,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,GACb,MAAM,CAIR;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,IAAI,EAAE,cAAc,GACnB,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,cAAc,GACnB,MAAM,CAkBR"}

package/lib/projection/ui/projectionTabInfo.js

@@ -0,0 +1,108 @@
+/**
+ * What each tab answers when the reader presses the question mark.
+ *
+ * The viewer is meant to be embedded in somebody else's page, so the paragraph
+ * that used to stand under every figure now waits behind one glyph in the bar:
+ * a reader who wants it opens it, and everybody else pays no vertical space
+ * for it. Not one word of it was dropped in the move — the sentences are the
+ * reason a reader who has never met a component can read the figure at all —
+ * so they are built here, where what a tab claims about its own numbers can be
+ * checked without rendering a chart.
+ */
+import { chartShare } from "../../chart/core/chartLabels.js";
+import { fillCopy } from "../core/projectionCopy.js";
+import { legendTitle, variablesCaption } from "./projectionVariablesWords.js";
+/**
+ * What the pair grid says about itself.
+ * @param copy - The words the viewer writes.
+ * @param groupLabel - What the set of groups is called.
+ * @param colored - Whether colour stands for the group at all; uncoloured, the
+ * sentence naming the colour would name something the grid is not drawing.
+ * @returns The paragraph.
+ */
+export function projectionPairsInfo(copy, groupLabel, colored) {
+    if (!colored)
+        return copy.intro.pairs;
+    const key = fillCopy(copy.legend.pairs, { groups: groupLabel });
+    return `${copy.intro.pairs} ${key}`;
+}
+/**
+ * What the "what differs" panels say about themselves.
+ *
+ * Both sentences are needed and neither stands in for the other: the first
+ * says what a panel draws, which changes with the view, and the second says
+ * what its colours mean, which is the only place the grey line is named.
+ * @param profiles - The panels as they were built, or `null` when the run
+ * reported no weights and there is nothing to explain.
+ * @param copy - The words the viewer writes.
+ * @param sample - What the one selected sample is called.
+ * @returns The paragraph.
+ */
+export function projectionVariablesInfo(profiles, copy, sample) {
+    if (profiles === null)
+        return '';
+    const caption = variablesCaption(profiles, copy);
+    return `${caption} ${legendTitle(profiles, copy, sample)}`;
+}
+/**
+ * What the shares figure says about itself, including its own arithmetic.
+ *
+ * The computed sentence sits between the two written ones because it is the
+ * answer the reader came for — how many components they have to keep — while
+ * the sentences around it say what a bar is and what its colour means.
+ * @param shares - The bars, already worked out.
+ * @param copy - The words the viewer writes.
+ * @returns The paragraph.
+ */
+export function projectionSharesInfo(shares, copy) {
+    if (shares === null)
+        return copy.intro.shares;
+    const counted = projectionSharesSentence(shares, copy);
+    const parts = [copy.intro.shares, counted, copy.legend.shares];
+    return parts.filter((part) => part !== '').join(' ');
+}
+/**
+ * What the shares tab says about its own numbers, in two sentences at most.
+ *
+ * The second is left out when the reader asked for no target, and when the
+ * first component already reaches it: "the first 1 components together" is
+ * both ungrammatical and a restatement of the sentence before it.
+ * @param shares - The bars.
+ * @param copy - The words the viewer writes.
+ * @returns The sentence.
+ */
+export function projectionSharesSentence(shares, copy) {
+    const { components, target, reachesTargetAt } = shares;
+    const first = components[0];
+    if (first === undefined)
+        return '';
+    const opening = fillCopy(copy.sentence.sharesFirst, {
+        percent: writeShare(first.share),
+    });
+    if (target === 0 || reachesTargetAt === 1)
+        return opening;
+    if (reachesTargetAt !== null) {
+        return `${opening} ${fillCopy(copy.sentence.sharesTarget, {
+            count: String(reachesTargetAt),
+            percent: writeShare(components[reachesTargetAt - 1]?.cumulative ?? 0),
+        })}`;
+    }
+    return `${opening} ${fillCopy(copy.sentence.sharesNoTarget, {
+        count: String(components.length),
+        percent: writeShare(components.at(-1)?.cumulative ?? 0),
+    })}`;
+}
+/**
+ * A share written as a percentage, at the precision every other figure of the
+ * family writes it at.
+ *
+ * The bars beside this sentence are named `PC1 — 73.0 %`, so a sentence saying
+ * 72.96% would put the same quantity on screen twice in two shapes and leave
+ * the reader deciding whether they are one number or two.
+ * @param share - The share, between 0 and 1.
+ * @returns It, written out.
+ */
+function writeShare(share) {
+    return `${chartShare(share)}%`;
+}
+//# sourceMappingURL=projectionTabInfo.js.map

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

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

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

@@ -0,0 +1,49 @@
+/**
+ * The two figures a tab and the settings bar both have to know about.
+ *
+ * The panels of "what differs" and the bars of "how much each explains" are
+ * each read twice: once by the figure that draws them, and once by the
+ * question mark in the bar, which says in words what the picture says in
+ * marks. Building them here means the pair cannot disagree, and that a
+ * paragraph quoting `95.8%` is quoting the number the bars were drawn from
+ * rather than a second calculation of it.
+ */
+import type { ExplainedShares } from '../core/explainedShares.ts';
+import type { LoadingProfiles } from '../core/loadingProfiles.ts';
+import type { ProjectionOptions } from '../core/projectionOptions.ts';
+import type { ProjectionResult } from '../core/projectionResult.ts';
+import type { ProjectionSamples } from '../core/projectionSamples.ts';
+/** What {@link useProjectionModels} needs. */
+export interface ProjectionModelsInput {
+    /** What the run produced, whatever produced it. */
+    result: ProjectionResult;
+    /** Who the rows are, for naming the sample a panel rebuilds. */
+    samples: ProjectionSamples;
+    /** Every option, already made safe against the result. */
+    options: ProjectionOptions;
+    /** The selected rows, as indices into the score matrix. */
+    selected: readonly number[];
+}
+/** The figures the tabs and the bar share. */
+export interface ProjectionModels {
+    /**
+     * The "what differs" panels, or `null` when the run reported no weights and
+     * the tab is not offered at all.
+     */
+    profiles: LoadingProfiles | null;
+    /** The "how much each explains" bars. */
+    shares: ExplainedShares;
+    /**
+     * What the one selected sample is called, which is the only row a panel ever
+     * names. With none or several selected it is the row number, so the sentence
+     * about it still reads.
+     */
+    sampleName: string;
+}
+/**
+ * Build both, once per change.
+ * @param input - See {@link ProjectionModelsInput}.
+ * @returns See {@link ProjectionModels}.
+ */
+export declare function useProjectionModels(input: ProjectionModelsInput): ProjectionModels;
+//# sourceMappingURL=projectionTabModels.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projectionTabModels.d.ts","sourceRoot":"","sources":["../../../src/projection/ui/projectionTabModels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,8CAA8C;AAC9C,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,MAAM,EAAE,gBAAgB,CAAC;IACzB,gEAAgE;IAChE,OAAO,EAAE,iBAAiB,CAAC;IAC3B,0DAA0D;IAC1D,OAAO,EAAE,iBAAiB,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,yCAAyC;IACzC,MAAM,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,qBAAqB,GAC3B,gBAAgB,CA+BlB"}

package/lib/projection/ui/projectionTabModels.js

@@ -0,0 +1,59 @@
+/**
+ * The two figures a tab and the settings bar both have to know about.
+ *
+ * The panels of "what differs" and the bars of "how much each explains" are
+ * each read twice: once by the figure that draws them, and once by the
+ * question mark in the bar, which says in words what the picture says in
+ * marks. Building them here means the pair cannot disagree, and that a
+ * paragraph quoting `95.8%` is quoting the number the bars were drawn from
+ * rather than a second calculation of it.
+ */
+import { useMemo } from 'react';
+import { explainedShares } from "../core/explainedShares.js";
+import { loadingProfiles } from "../core/loadingProfiles.js";
+/**
+ * Build both, once per change.
+ * @param input - See {@link ProjectionModelsInput}.
+ * @returns See {@link ProjectionModels}.
+ */
+export function useProjectionModels(input) {
+    const { result, samples, options, selected } = input;
+    const { loadings, axes, scores } = result;
+    const one = selected.length === 1 ? (selected[0] ?? -1) : -1;
+    const profiles = useMemo(() => {
+        if (loadings === undefined)
+            return null;
+        return loadingProfiles({
+            loadings,
+            axes,
+            view: options.variablesView,
+            count: options.variablesCount,
+            spread: options.spread,
+            sharedScale: options.sharedScale,
+            order: options.variableOrder,
+            sampleScores: one < 0 ? undefined : rowScores(scores, one, options.variablesCount),
+        });
+    }, [loadings, axes, scores, options, one]);
+    const shares = useMemo(() => explainedShares(axes, { target: options.shareTarget }), [axes, options.shareTarget]);
+    return {
+        profiles,
+        shares,
+        sampleName: samples.ids[one] ?? `Row ${one + 1}`,
+    };
+}
+/**
+ * One row of the score matrix, read where it stands.
+ * @param scores - Where every sample landed.
+ * @param row - Which row.
+ * @param count - How many components the panels draw.
+ * @returns That sample's scores.
+ */
+function rowScores(scores, row, count) {
+    const wanted = Math.max(0, Math.min(count, scores.columns));
+    const values = new Array(wanted);
+    for (let column = 0; column < wanted; column++) {
+        values[column] = scores.get(row, column);
+    }
+    return values;
+}
+//# sourceMappingURL=projectionTabModels.js.map