react-cheminfo 0.8.0 → 0.10.0

package/lib/chart/core/chartBand.d.ts

@@ -0,0 +1,47 @@
+/** Evenly spaced slots for a categorical axis, held as four numbers. */
+export interface ChartBand {
+    /** The pixel the first slot starts at. */
+    readonly offset: number;
+    /** Pixels from one slot's start to the next. */
+    readonly step: number;
+    /** How wide a bar may be drawn: `step` less the gap. */
+    readonly bandWidth: number;
+    /** How many slots there are. */
+    readonly count: number;
+}
+/** How a band scale spaces its slots. */
+export interface ChartBandOptions {
+    /**
+     * Share of a slot left empty between neighbours, held between 0 and 0.9.
+     * @default 0.2
+     */
+    padding?: number;
+}
+/**
+ * `count` slots laid across `rangeMin`..`rangeMax`.
+ * @param count - How many categories the axis carries.
+ * @param rangeMin - The pixel the axis starts at.
+ * @param rangeMax - The pixel it ends at.
+ * @param options - See {@link ChartBandOptions}.
+ * @returns The scale. A count of zero gives a `step` of zero, which every
+ * reader below treats as an empty axis rather than dividing by it.
+ */
+export declare function chartBand(count: number, rangeMin: number, rangeMax: number, options?: ChartBandOptions): ChartBand;
+/**
+ * The middle of one slot, which is where a point, a bar and a tick all sit.
+ * @param band - The scale.
+ * @param index - Which slot, from 0.
+ * @returns The pixel.
+ */
+export declare function chartBandCenter(band: ChartBand, index: number): number;
+/**
+ * Which slot a pixel is nearest.
+ *
+ * This is the whole of the tracking hit test on a categorical axis: no search,
+ * no allocation, one division.
+ * @param band - The scale.
+ * @param pixel - The pointer's position along the axis.
+ * @returns An index held inside `0..count - 1`, or `-1` when the axis is empty.
+ */
+export declare function chartBandIndexAt(band: ChartBand, pixel: number): number;
+//# sourceMappingURL=chartBand.d.ts.map

package/lib/chart/core/chartBand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartBand.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartBand.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,yCAAyC;AACzC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAkBX;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvE"}

package/lib/chart/core/chartBand.js

@@ -0,0 +1,55 @@
+const DEFAULT_PADDING = 0.2;
+const MAXIMUM_PADDING = 0.9;
+/**
+ * `count` slots laid across `rangeMin`..`rangeMax`.
+ * @param count - How many categories the axis carries.
+ * @param rangeMin - The pixel the axis starts at.
+ * @param rangeMax - The pixel it ends at.
+ * @param options - See {@link ChartBandOptions}.
+ * @returns The scale. A count of zero gives a `step` of zero, which every
+ * reader below treats as an empty axis rather than dividing by it.
+ */
+export function chartBand(count, rangeMin, rangeMax, options = {}) {
+    const { padding = DEFAULT_PADDING } = options;
+    const slots = Number.isFinite(count) ? Math.max(0, Math.floor(count)) : 0;
+    const start = Number.isFinite(rangeMin) ? rangeMin : 0;
+    const reach = Number.isFinite(rangeMax) ? rangeMax - start : 0;
+    if (slots === 0 || reach === 0) {
+        return { offset: start, step: 0, bandWidth: 0, count: slots };
+    }
+    const step = reach / slots;
+    const gap = Number.isFinite(padding)
+        ? Math.min(MAXIMUM_PADDING, Math.max(0, padding))
+        : DEFAULT_PADDING;
+    return {
+        offset: start,
+        step,
+        bandWidth: Math.abs(step) * (1 - gap),
+        count: slots,
+    };
+}
+/**
+ * The middle of one slot, which is where a point, a bar and a tick all sit.
+ * @param band - The scale.
+ * @param index - Which slot, from 0.
+ * @returns The pixel.
+ */
+export function chartBandCenter(band, index) {
+    return band.offset + band.step * (index + 0.5);
+}
+/**
+ * Which slot a pixel is nearest.
+ *
+ * This is the whole of the tracking hit test on a categorical axis: no search,
+ * no allocation, one division.
+ * @param band - The scale.
+ * @param pixel - The pointer's position along the axis.
+ * @returns An index held inside `0..count - 1`, or `-1` when the axis is empty.
+ */
+export function chartBandIndexAt(band, pixel) {
+    if (band.count <= 0 || band.step === 0 || !Number.isFinite(pixel))
+        return -1;
+    const slot = Math.floor((pixel - band.offset) / band.step);
+    return Math.min(band.count - 1, Math.max(0, slot));
+}
+//# sourceMappingURL=chartBand.js.map

package/lib/chart/core/chartBand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartBand.js","sourceRoot":"","sources":["../../../src/chart/core/chartBand.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,GAAG,CAAC;AAC5B,MAAM,eAAe,GAAG,GAAG,CAAC;AAuB5B;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS,CACvB,KAAa,EACb,QAAgB,EAChB,QAAgB,EAChB,UAA4B,EAAE;IAE9B,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,GAAG,KAAK,CAAC;IAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;QAClC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC,CAAC,eAAe,CAAC;IACpB,OAAO;QACL,MAAM,EAAE,KAAK;QACb,IAAI;QACJ,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QACrC,KAAK,EAAE,KAAK;KACb,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAe,EAAE,KAAa;IAC5D,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAe,EAAE,KAAa;IAC7D,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/lib/chart/core/chartBins.d.ts

@@ -0,0 +1,32 @@
+import type { ChartExtent } from './chartExtent.ts';
+import type { MatrixLike } from './matrix.ts';
+/** Counts over one shared set of bin edges, optionally split by series. */
+export interface ChartBins {
+    /** `bins + 1` edges, ascending. */
+    edges: Float64Array;
+    /** `series * bins` counts, laid out one series after another. */
+    counts: Uint32Array;
+    /** How many series the counts hold; `1` when nothing was split. */
+    series: number;
+    /** How many bins each series has. */
+    bins: number;
+    /** The largest count in any one bin of any one series, for scaling the draw. */
+    peak: number;
+}
+/**
+ * How one column is spread, split by group over one shared set of edges.
+ *
+ * `xHistogram` from `ml-spectra-processing` is the published helper for a
+ * single series, but it accumulates every value into one series and takes a
+ * flat array where we hold a matrix column; hence this one, which reads the
+ * matrix in place in a single pass.
+ * @param matrix - The matrix to read.
+ * @param column - Which column to bin.
+ * @param range - The edges' two ends, normally the column's shared axis domain.
+ * @param bins - How many bins to cut it into, at least one.
+ * @param groups - One group index per row, or `null` for a single series.
+ * @param series - How many groups there are; ignored when `groups` is `null`.
+ * @returns The counts. A row whose value is not finite, is outside `range`, or carries a group outside `0..series - 1` is left out rather than clamped into an end bin, because a clamped outlier reads as a real peak at the edge.
+ */
+export declare function chartBinCounts(matrix: MatrixLike, column: number, range: ChartExtent, bins: number, groups: ArrayLike<number> | null, series: number): ChartBins;
+//# sourceMappingURL=chartBins.d.ts.map

package/lib/chart/core/chartBins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartBins.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartBins.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,KAAK,EAAE,YAAY,CAAC;IACpB,iEAAiE;IACjE,MAAM,EAAE,WAAW,CAAC;IACpB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAChC,MAAM,EAAE,MAAM,GACb,SAAS,CAsCX"}

package/lib/chart/core/chartBins.js

@@ -0,0 +1,64 @@
+/**
+ * How one column is spread, split by group over one shared set of edges.
+ *
+ * `xHistogram` from `ml-spectra-processing` is the published helper for a
+ * single series, but it accumulates every value into one series and takes a
+ * flat array where we hold a matrix column; hence this one, which reads the
+ * matrix in place in a single pass.
+ * @param matrix - The matrix to read.
+ * @param column - Which column to bin.
+ * @param range - The edges' two ends, normally the column's shared axis domain.
+ * @param bins - How many bins to cut it into, at least one.
+ * @param groups - One group index per row, or `null` for a single series.
+ * @param series - How many groups there are; ignored when `groups` is `null`.
+ * @returns The counts. A row whose value is not finite, is outside `range`, or carries a group outside `0..series - 1` is left out rather than clamped into an end bin, because a clamped outlier reads as a real peak at the edge.
+ */
+export function chartBinCounts(matrix, column, range, bins, groups, series) {
+    const binCount = wholeAtLeastOne(bins);
+    const seriesCount = groups === null ? 1 : wholeAtLeastOne(series);
+    const min = Number.isFinite(range.min) ? range.min : 0;
+    const max = Number.isFinite(range.max) && range.max > min ? range.max : min + 1;
+    const span = max - min;
+    const edges = new Float64Array(binCount + 1);
+    for (let index = 0; index < binCount; index++) {
+        edges[index] = min + (span * index) / binCount;
+    }
+    edges[binCount] = max;
+    const counts = new Uint32Array(seriesCount * binCount);
+    for (let row = 0; row < matrix.rows; row++) {
+        const value = matrix.get(row, column);
+        if (!Number.isFinite(value) || value < min || value > max)
+            continue;
+        const group = groupOf(groups, row, seriesCount);
+        if (group < 0)
+            continue;
+        // The value that is exactly `max` sits on the closing edge, which belongs
+        // to the last bin rather than to a bin past the end of the axis.
+        const bin = Math.min(binCount - 1, Math.floor(((value - min) / span) * binCount));
+        const slot = group * binCount + bin;
+        counts[slot] = (counts[slot] ?? 0) + 1;
+    }
+    let peak = 0;
+    for (const count of counts) {
+        if (count > peak)
+            peak = count;
+    }
+    return { edges, counts, series: seriesCount, bins: binCount, peak };
+}
+function wholeAtLeastOne(count) {
+    if (!Number.isFinite(count))
+        return 1;
+    return Math.max(1, Math.floor(count));
+}
+function groupOf(groups, row, seriesCount) {
+    if (groups === null)
+        return 0;
+    const raw = groups[row];
+    if (raw === undefined || !Number.isFinite(raw))
+        return -1;
+    const group = Math.trunc(raw);
+    if (group < 0 || group >= seriesCount)
+        return -1;
+    return group;
+}
+//# sourceMappingURL=chartBins.js.map

package/lib/chart/core/chartBins.js.map

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

package/lib/chart/core/chartExtent.d.ts

@@ -0,0 +1,105 @@
+import type { MatrixLike } from './matrix.ts';
+/** The two ends of a range. */
+export interface ChartExtent {
+    /** The smallest value. */
+    min: number;
+    /** The largest. */
+    max: number;
+}
+/** How far into a run of numbers to read, and what to widen. */
+export interface ChartValuesExtentOptions {
+    /**
+     * How many values to read, for a series longer than the slots it is drawn
+     * in.
+     * @default every value
+     */
+    limit?: number;
+    /**
+     * A range to widen rather than start afresh, so several runs can be covered
+     * without an array of ranges being built to merge.
+     * @default undefined — the range starts empty
+     */
+    into?: ChartExtent;
+}
+/** How a column's range is read and widened. */
+export interface ChartColumnExtentOptions {
+    /**
+     * Share of the span added at each end, so points do not touch the frame.
+     * @default 0.05
+     */
+    padding?: number;
+    /**
+     * Whether to stretch the range to include zero, which a bar chart must and a
+     * scatter need not.
+     * @default false
+     */
+    includeZero?: boolean;
+    /**
+     * Whether to make the range symmetric about zero, so the origin sits in the
+     * middle — what a scores or a loadings axis usually wants.
+     * @default false
+     */
+    symmetric?: boolean;
+    /**
+     * Which rows to read, for a range over one group only.
+     * @default undefined — every row is read
+     */
+    indices?: ArrayLike<number>;
+}
+/**
+ * The range of one column of a matrix.
+ *
+ * The matrix is read in place through `get`: no column is copied out, and a
+ * value that is not finite is skipped rather than poisoning the range with a
+ * `NaN`.
+ *
+ * The padding goes on before the stretch to zero, so a bar chart's baseline
+ * lands on zero exactly rather than a twentieth of a span below it, where the
+ * bars would float clear of the line they are measured from.
+ * @param matrix - The matrix to read.
+ * @param column - Which column.
+ * @param options - See {@link ChartColumnExtentOptions}.
+ * @returns The range, widened as asked. A column with no finite value at all gives `{ min: 0, max: 1 }`, which draws an honest empty axis.
+ */
+export declare function chartColumnExtent(matrix: MatrixLike, column: number, options?: ChartColumnExtentOptions): ChartExtent;
+/**
+ * A range widened by a share of its span.
+ * @param extent - The range.
+ * @param padding - Share added at each end. Defaults to `0.05`.
+ * @returns The widened range, its two ends in order. A zero-width one is opened by 5% of its own value, or to -1..1 when that value is zero, because an axis whose ends are the same number has nowhere to put a tick.
+ */
+export declare function chartPadExtent(extent: ChartExtent, padding?: number): ChartExtent;
+/**
+ * The range covering several — the shared scale a row or a column of a pair
+ * grid draws against.
+ * @param extents - The ranges to cover.
+ * @returns The covering range, or `{ min: 0, max: 1 }` when none was given.
+ */
+export declare function chartMergeExtents(extents: readonly ChartExtent[]): ChartExtent;
+/**
+ * A range covering nothing, which every scan starts from.
+ *
+ * `min` above `max` is what says it is empty, and it is deliberate: a range
+ * that started at zero would report a run of nothing as a run of zeroes, and
+ * an axis would be drawn around a value the data never held.
+ */
+export declare const EMPTY_EXTENT: ChartExtent;
+/**
+ * The range of a run of numbers, skipping anything that is not finite.
+ *
+ * The one scan every chart starts from, and the reason it is here rather than
+ * written out per chart: a copy that forgets the finiteness guard poisons a
+ * whole axis with one `NaN`, and a copy that forgets `limit` reads a series
+ * past the slots it is drawn in.
+ *
+ * `ml-spectra-processing`'s `xMinMaxValues` answers the same question, but
+ * this package draws in a browser and does not depend on it; a shared six-line
+ * scan is cheaper than the package for the one thing needed from it.
+ * @param values - The numbers to read, in place — nothing is copied.
+ * @param options - See {@link ChartValuesExtentOptions}.
+ * @returns The range. A run with no finite value at all gives an empty range —
+ * `min` above `max` — which `chartPadExtent` and the callers here read as
+ * nothing to draw rather than as a range around zero.
+ */
+export declare function chartValuesExtent(values: ArrayLike<number>, options?: ChartValuesExtentOptions): ChartExtent;
+//# sourceMappingURL=chartExtent.d.ts.map

package/lib/chart/core/chartExtent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartExtent.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartExtent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,0BAA0B;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,mBAAmB;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,gEAAgE;AAChE,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CAC7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,UAAU,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACrC,WAAW,CAmBb;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,MAAwB,GAChC,WAAW,CAeb;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,WAAW,CASb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,EAAE,WAG1B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,EACzB,OAAO,GAAE,wBAA6B,GACrC,WAAW,CAWb"}

package/lib/chart/core/chartExtent.js

@@ -0,0 +1,134 @@
+/**
+ * The range of one column of a matrix.
+ *
+ * The matrix is read in place through `get`: no column is copied out, and a
+ * value that is not finite is skipped rather than poisoning the range with a
+ * `NaN`.
+ *
+ * The padding goes on before the stretch to zero, so a bar chart's baseline
+ * lands on zero exactly rather than a twentieth of a span below it, where the
+ * bars would float clear of the line they are measured from.
+ * @param matrix - The matrix to read.
+ * @param column - Which column.
+ * @param options - See {@link ChartColumnExtentOptions}.
+ * @returns The range, widened as asked. A column with no finite value at all gives `{ min: 0, max: 1 }`, which draws an honest empty axis.
+ */
+export function chartColumnExtent(matrix, column, options = {}) {
+    const { padding = DEFAULT_PADDING, includeZero = false, symmetric = false, indices, } = options;
+    const seen = readColumn(matrix, column, indices);
+    if (seen === null)
+        return { min: 0, max: 1 };
+    const padded = chartPadExtent(seen, padding);
+    const grounded = includeZero
+        ? { min: Math.min(padded.min, 0), max: Math.max(padded.max, 0) }
+        : padded;
+    if (!symmetric)
+        return grounded;
+    const reach = Math.max(Math.abs(grounded.min), Math.abs(grounded.max));
+    return { min: -reach, max: reach };
+}
+/**
+ * A range widened by a share of its span.
+ * @param extent - The range.
+ * @param padding - Share added at each end. Defaults to `0.05`.
+ * @returns The widened range, its two ends in order. A zero-width one is opened by 5% of its own value, or to -1..1 when that value is zero, because an axis whose ends are the same number has nowhere to put a tick.
+ */
+export function chartPadExtent(extent, padding = DEFAULT_PADDING) {
+    const { min, max } = extent;
+    if (!Number.isFinite(min) || !Number.isFinite(max))
+        return { min: 0, max: 1 };
+    const low = Math.min(min, max);
+    const high = Math.max(min, max);
+    const span = high - low;
+    if (span === 0) {
+        const opening = low === 0 ? 1 : Math.abs(low) * DEFAULT_PADDING;
+        return { min: low - opening, max: high + opening };
+    }
+    const share = Number.isFinite(padding) && padding > 0 ? padding : 0;
+    const room = span * share;
+    return { min: low - room, max: high + room };
+}
+/**
+ * The range covering several — the shared scale a row or a column of a pair
+ * grid draws against.
+ * @param extents - The ranges to cover.
+ * @returns The covering range, or `{ min: 0, max: 1 }` when none was given.
+ */
+export function chartMergeExtents(extents) {
+    let min = Number.POSITIVE_INFINITY;
+    let max = Number.NEGATIVE_INFINITY;
+    for (const extent of extents) {
+        if (Number.isFinite(extent.min) && extent.min < min)
+            min = extent.min;
+        if (Number.isFinite(extent.max) && extent.max > max)
+            max = extent.max;
+    }
+    if (min > max)
+        return { min: 0, max: 1 };
+    return { min, max };
+}
+/**
+ * A range covering nothing, which every scan starts from.
+ *
+ * `min` above `max` is what says it is empty, and it is deliberate: a range
+ * that started at zero would report a run of nothing as a run of zeroes, and
+ * an axis would be drawn around a value the data never held.
+ */
+export const EMPTY_EXTENT = {
+    min: Number.POSITIVE_INFINITY,
+    max: Number.NEGATIVE_INFINITY,
+};
+/**
+ * The range of a run of numbers, skipping anything that is not finite.
+ *
+ * The one scan every chart starts from, and the reason it is here rather than
+ * written out per chart: a copy that forgets the finiteness guard poisons a
+ * whole axis with one `NaN`, and a copy that forgets `limit` reads a series
+ * past the slots it is drawn in.
+ *
+ * `ml-spectra-processing`'s `xMinMaxValues` answers the same question, but
+ * this package draws in a browser and does not depend on it; a shared six-line
+ * scan is cheaper than the package for the one thing needed from it.
+ * @param values - The numbers to read, in place — nothing is copied.
+ * @param options - See {@link ChartValuesExtentOptions}.
+ * @returns The range. A run with no finite value at all gives an empty range —
+ * `min` above `max` — which `chartPadExtent` and the callers here read as
+ * nothing to draw rather than as a range around zero.
+ */
+export function chartValuesExtent(values, options = {}) {
+    const { limit = values.length, into = EMPTY_EXTENT } = options;
+    let { min, max } = into;
+    const count = Math.min(limit, values.length);
+    for (let index = 0; index < count; index++) {
+        const value = values[index];
+        if (value === undefined || !Number.isFinite(value))
+            continue;
+        if (value < min)
+            min = value;
+        if (value > max)
+            max = value;
+    }
+    return { min, max };
+}
+const DEFAULT_PADDING = 0.05;
+function readColumn(matrix, column, indices) {
+    let min = Number.POSITIVE_INFINITY;
+    let max = Number.NEGATIVE_INFINITY;
+    const count = indices === undefined ? matrix.rows : indices.length;
+    for (let step = 0; step < count; step++) {
+        const row = indices === undefined ? step : indices[step];
+        if (row === undefined)
+            continue;
+        const value = matrix.get(row, column);
+        if (!Number.isFinite(value))
+            continue;
+        if (value < min)
+            min = value;
+        if (value > max)
+            max = value;
+    }
+    if (min > max)
+        return null;
+    return { min, max };
+}
+//# sourceMappingURL=chartExtent.js.map

package/lib/chart/core/chartExtent.js.map

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

package/lib/chart/core/chartLabels.d.ts

@@ -0,0 +1,49 @@
+/** How an axis title is written. */
+export interface ChartAxisTitleOptions {
+    /**
+     * The share of the differences the axis accounts for, between 0 and 1 — a
+     * fraction, never a percentage. Left out for a method that publishes no such
+     * number, and then nothing is written after the name.
+     * @default undefined
+     */
+    share?: number;
+    /**
+     * Decimals in the percentage.
+     *
+     * One, because the share is a reading aid rather than a measurement: it is
+     * there so a reader can see that the seventh component carries 0.3 % and is
+     * not worth plotting. A second decimal claims a precision the decomposition
+     * does not have once the data has been resampled and scaled, and costs two
+     * more characters in a picker whose lines are already long.
+     * @default 1
+     */
+    digits?: number;
+}
+/**
+ * An axis title: `PC1 — 74.2 %`, or a bare `UMAP1` when the method publishes
+ * no share.
+ *
+ * The em dash is the package's own pattern for a name followed by a gloss —
+ * `RGB — mix the channels`, `MAX — Largest value` — so a component reads the
+ * same way here as everything else the reader has already met. Kept out of the
+ * frame so the frame draws whatever string it is handed, and so every method
+ * builds its titles the same way.
+ * @param name - What the axis is called, e.g. `PC1`.
+ * @param options - See {@link ChartAxisTitleOptions}.
+ * @returns The title.
+ */
+export declare function chartAxisTitle(name: string, options?: ChartAxisTitleOptions): string;
+/**
+ * A share written as a percentage, with no unit after it: `74.2`.
+ *
+ * Every figure that quotes a share goes through here, so an axis title and the
+ * sentence under the same chart cannot disagree about how precise the number
+ * is. A reader who meets `PC1 — 73.0 %` beside "accounts for 72.96%" has to
+ * work out whether those are two quantities or one, and they are one.
+ * @param share - The share, between 0 and 1 — a fraction, never a percentage.
+ * @param digits - Decimals in the result, defaulting to the one decimal every
+ * figure of the family writes.
+ * @returns The percentage, written out.
+ */
+export declare function chartShare(share: number, digits?: number): string;
+//# sourceMappingURL=chartLabels.d.ts.map

package/lib/chart/core/chartLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartLabels.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartLabels.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;OASG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAIR;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,SAAiB,GAAG,MAAM,CAGzE"}

package/lib/chart/core/chartLabels.js

@@ -0,0 +1,44 @@
+/**
+ * An axis title: `PC1 — 74.2 %`, or a bare `UMAP1` when the method publishes
+ * no share.
+ *
+ * The em dash is the package's own pattern for a name followed by a gloss —
+ * `RGB — mix the channels`, `MAX — Largest value` — so a component reads the
+ * same way here as everything else the reader has already met. Kept out of the
+ * frame so the frame draws whatever string it is handed, and so every method
+ * builds its titles the same way.
+ * @param name - What the axis is called, e.g. `PC1`.
+ * @param options - See {@link ChartAxisTitleOptions}.
+ * @returns The title.
+ */
+export function chartAxisTitle(name, options = {}) {
+    const { share, digits = DEFAULT_DIGITS } = options;
+    if (share === undefined || !Number.isFinite(share))
+        return name;
+    return `${name} — ${chartShare(share, digits)} %`;
+}
+/**
+ * A share written as a percentage, with no unit after it: `74.2`.
+ *
+ * Every figure that quotes a share goes through here, so an axis title and the
+ * sentence under the same chart cannot disagree about how precise the number
+ * is. A reader who meets `PC1 — 73.0 %` beside "accounts for 72.96%" has to
+ * work out whether those are two quantities or one, and they are one.
+ * @param share - The share, between 0 and 1 — a fraction, never a percentage.
+ * @param digits - Decimals in the result, defaulting to the one decimal every
+ * figure of the family writes.
+ * @returns The percentage, written out.
+ */
+export function chartShare(share, digits = DEFAULT_DIGITS) {
+    if (!Number.isFinite(share))
+        return '';
+    return (share * 100).toFixed(readableDigits(digits));
+}
+const DEFAULT_DIGITS = 1;
+const MOST_DIGITS = 20;
+function readableDigits(digits) {
+    if (!Number.isFinite(digits))
+        return DEFAULT_DIGITS;
+    return Math.min(MOST_DIGITS, Math.max(0, Math.floor(digits)));
+}
+//# sourceMappingURL=chartLabels.js.map

package/lib/chart/core/chartLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartLabels.js","sourceRoot":"","sources":["../../../src/chart/core/chartLabels.ts"],"names":[],"mappings":"AAsBA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,UAAiC,EAAE;IAEnC,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChE,OAAO,GAAG,IAAI,MAAM,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC;AACpD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,MAAM,GAAG,cAAc;IAC/D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,OAAO,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,WAAW,GAAG,EAAE,CAAC;AAEvB,SAAS,cAAc,CAAC,MAAc;IACpC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,cAAc,CAAC;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/lib/chart/core/chartPalette.d.ts

@@ -0,0 +1,33 @@
+/**
+ * What a colour is standing for, which decides where in the palette it is
+ * read from.
+ *
+ * - `group` — a species, a batch, a cluster: something a sample belongs to.
+ * - `component` — an axis of the embedding: PC 1, PC 2.
+ *
+ * The two roles read the palette in different orders, so that the first four
+ * groups and the first four components never share a hue. That is what stops a
+ * reader who learnt "blue is setosa" on one tab from reading "blue is PC 1"
+ * on the next as though it meant the same thing.
+ */
+export type ChartColorRole = 'group' | 'component';
+/**
+ * Eight hues that stay apart under deuteranopia, protanopia and tritanopia,
+ * and that keep their order when a figure is printed in grey.
+ *
+ * Okabe and Ito's set with black dropped and yellow held back to seventh,
+ * because yellow disappears as a one-and-a-half pixel line on a white ground;
+ * the eighth is a neutral dark, for the series past the ones anybody reads.
+ */
+export declare const CHART_SERIES_COLORS: readonly string[];
+/**
+ * The colour of the nth series of a role, cycling once the palette runs out.
+ *
+ * A caller appending a series must never repeat a colour already on the chart,
+ * so pass the count of series already drawn rather than a stable identifier.
+ * @param index - Which series, from 0. A negative or non-finite index gives the first colour.
+ * @param role - What the colour stands for. Defaults to `'group'`.
+ * @returns The colour, as a six-digit hex string.
+ */
+export declare function chartSeriesColor(index: number, role?: ChartColorRole): string;
+//# sourceMappingURL=chartPalette.d.ts.map

package/lib/chart/core/chartPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartPalette.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartPalette.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,WAAW,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAShD,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,cAAwB,GAC7B,MAAM,CAKR"}