react-cheminfo 0.27.0 → 0.29.0

package/lib/chart/core/guidePlacement.js

@@ -0,0 +1,52 @@
+/**
+ * Where the guide for one value is drawn when that value is not on screen.
+ *
+ * A chart zoomed onto a single feature is the normal way of reading a spectrum
+ * — one isotopologue cluster two millimass units wide, one chromatographic peak
+ * four seconds wide — and most of what a panel beside it can point at then lies
+ * outside the window. Drawing nothing in that case answers the only question
+ * the guide exists for — where is it? — with silence, and the reader is left
+ * unable to tell a fragment the spectrum does not carry from one that is simply
+ * off to the left. So the guide is parked on the edge it went out of instead,
+ * dashed and carrying an arrow, which says both that it is elsewhere and which
+ * way.
+ *
+ * Nothing here reads the domain: the value is put through the scale, and the
+ * pixel that comes back is compared against the two pixel edges of the plot.
+ * That is what lets `left` and `right` mean what they say on an axis that runs
+ * backwards, as an infrared chart's wavenumbers do — they are the edges of the
+ * screen, not the ends of the window, and a descending axis parks a value below
+ * its window on the right, which is exactly where the reader must look for it.
+ */
+import { chartPixel, chartRoundPixel } from "./chartScale.js";
+/**
+ * Work out where the guide for a value goes.
+ *
+ * The test is made in pixels rather than against the domain, so the guide can
+ * never disagree with the axis it is drawn over: both are read off the same
+ * scale, and a rounding that puts a value a hundredth of a unit inside the
+ * window puts the guide a hundredth of a pixel inside the plot rather than
+ * parking it on an edge it is standing beside.
+ * @param value - The place on the horizontal axis being pointed at, in whatever
+ * that axis measures — an m/z, a retention time, a wavenumber.
+ * @param plot - The plotting area the guide is confined to.
+ * @param xScale - The horizontal axis as it is currently zoomed.
+ * The pixel is rounded for the markup, to the hundredth: that is under a tenth
+ * of a device pixel at any zoom a browser offers, and it keeps the last digits
+ * of a multiply-add out of the `d` a reader has to look at in a failing test.
+ * @returns Where to draw it, or `null` for a value no scale maps anywhere — an
+ * empty chart's degenerate axis, or a `NaN` out of an unparsed field.
+ */
+export function guidePlacement(value, plot, xScale) {
+    if (!Number.isFinite(value))
+        return null;
+    const pixel = chartPixel(xScale, value);
+    if (!Number.isFinite(pixel))
+        return null;
+    if (pixel < plot.left)
+        return { x: plot.left, direction: 'left' };
+    if (pixel > plot.right)
+        return { x: plot.right, direction: 'right' };
+    return { x: chartRoundPixel(pixel), direction: null };
+}
+//# sourceMappingURL=guidePlacement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guidePlacement.js","sourceRoot":"","sources":["../../../src/chart/core/guidePlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAa9D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAa,EACb,IAAc,EACd,MAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAClE,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;IACrE,OAAO,EAAE,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC"}

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

@@ -21,9 +21,36 @@ export { chartAxisTitle, chartShare } from './chartLabels.ts';
 export type { ChartColorRole } from './chartPalette.ts';
 export { CHART_SERIES_COLORS, chartSeriesColor } from './chartPalette.ts';
 export type { ChartScale } from './chartScale.ts';
-export { chartPixel, chartScale, chartValue } from './chartScale.ts';
+export { chartPixel, chartRoundPixel, chartScale, chartValue, } from './chartScale.ts';
 export type { ChartViewport } from './chartViewport.ts';
-export { CHART_SMALLEST_ZOOM, CHART_WHEEL_LARGEST, CHART_WHEEL_LINE, CHART_WHEEL_PAGE, CHART_WHEEL_SPEED, chartClampViewport, chartWheelFactor, chartZoomDomain, chartZoomViewport, } from './chartViewport.ts';
+export { CHART_SMALLEST_ZOOM, CHART_WHEEL_LINE, CHART_WHEEL_PAGE, CHART_WHEEL_SPEED, CHART_WHEEL_TRAVEL, chartClampViewport, chartWheelFactor, chartWheelTravel, chartZoomDomain, chartZoomViewport, } from './chartViewport.ts';
 export type { MatrixLike } from './matrix.ts';
 export { mappedMatrix, rowMatrix, stackedMatrix } from './matrix.ts';
+export { SCIENTIFIC_ABOVE, SCIENTIFIC_BELOW, axisLabeller, formatNumber, formatScientific, } from './axisLabels.ts';
+export { MAXIMUM_DRIFT_STEPS, layoutAnnotationBoxes } from './boxLayout.ts';
+export type { ChartDomain, DragMode, YAxisRules, ZoomDragMode, ZoomGestures, ZoomRules, } from './chartDomain.ts';
+export { DEFAULT_Y_AXIS_RULES, DEFAULT_ZOOM_GESTURES, sameChartDomain, } from './chartDomain.ts';
+export type { ChartLayer, ChartMargin, ChartSize, PlotRect, } from './chartGeometry.ts';
+export { CHART_LAYERS, MARGIN, MINIMUM_PLOT_SIDE, SHARED_AXIS_MARGIN, plotRect, } from './chartGeometry.ts';
+export { CHART_PANE_ATTRIBUTE } from './chartPane.ts';
+export { CHART_COLORS, CHART_FONT, LABEL_HALO, LABEL_QUIET, PEAK_LABEL, } from './chartTheme.ts';
+export type { GuidePlacement } from './guidePlacement.ts';
+export { guidePlacement } from './guidePlacement.ts';
+export { labelStackBaselines } from './labelStack.ts';
+export type { LegendBox, LegendBoxEntry, LegendBoxOptions, LegendRow, } from './legendBox.ts';
+export { CLOSE_COLUMN, MAXIMUM_CHARACTERS, PADDING, ROW_HEIGHT, SWATCH, hiddenLabel, legendBox, legendLabel, legendNames, } from './legendBox.ts';
+export type { SelectionRectangle } from './selectionGeometry.ts';
+export { selectionRectangle } from './selectionGeometry.ts';
+export { ALL_SPECTRUM_COLORS, EXTRA_SPECTRUM_COLORS, SPECTRUM_COLORS, nextSpectrumColor, } from './spectrumColor.ts';
+export { FOOT_FURNITURE, FOOT_MINIMUM, STACKED_MINIMUM, STACK_LIMIT, stackCapacity, stackShares, } from './stackCapacity.ts';
+export type { ChartPoint, PointerSurface, ScreenMatrix } from './svgPoint.ts';
+export { svgPointAt } from './svgPoint.ts';
+export type { AreaPathOptions } from './tracePath.ts';
+export { areaPath, profilePath, stickPath } from './tracePath.ts';
+export type { ReadoutPlacement } from './trackerReadout.ts';
+export { READOUT_GAP, READOUT_LINES, READOUT_WIDTH, readoutPlacement, } from './trackerReadout.ts';
+export type { ViewBox, ViewState, ZoomBounds } from './viewTransform.ts';
+export { INITIAL_VIEW, MAXIMUM_CONTENT_SCALE, MAXIMUM_ZOOM, MINIMUM_ZOOM, baseViewBox, clampZoom, magnificationOf, panBy, viewBoxAttribute, viewBoxOf, zoomAbout, zoomToAboutCentre, } from './viewTransform.ts';
+export type { DragBox, ZoomSelection } from './zoomDomain.ts';
+export { MINIMUM_DRAG, releasedBeyondBaseline, scaledYAxis, zoomSelection, zoomedDomain, } from './zoomDomain.ts';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,cAAc,EACd,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EACV,wBAAwB,EACxB,WAAW,EACX,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9D,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/core/index.ts"],"names":[],"mappings":"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"}

package/lib/chart/core/index.js

@@ -14,7 +14,24 @@ export { chartBinCounts } from "./chartBins.js";
 export { EMPTY_EXTENT, chartColumnExtent, chartMergeExtents, chartPadExtent, chartValuesExtent, } from "./chartExtent.js";
 export { chartAxisTitle, chartShare } from "./chartLabels.js";
 export { CHART_SERIES_COLORS, chartSeriesColor } from "./chartPalette.js";
-export { chartPixel, chartScale, chartValue } from "./chartScale.js";
-export { CHART_SMALLEST_ZOOM, CHART_WHEEL_LARGEST, CHART_WHEEL_LINE, CHART_WHEEL_PAGE, CHART_WHEEL_SPEED, chartClampViewport, chartWheelFactor, chartZoomDomain, chartZoomViewport, } from "./chartViewport.js";
+export { chartPixel, chartRoundPixel, chartScale, chartValue, } from "./chartScale.js";
+export { CHART_SMALLEST_ZOOM, CHART_WHEEL_LINE, CHART_WHEEL_PAGE, CHART_WHEEL_SPEED, CHART_WHEEL_TRAVEL, chartClampViewport, chartWheelFactor, chartWheelTravel, chartZoomDomain, chartZoomViewport, } from "./chartViewport.js";
 export { mappedMatrix, rowMatrix, stackedMatrix } from "./matrix.js";
+export { SCIENTIFIC_ABOVE, SCIENTIFIC_BELOW, axisLabeller, formatNumber, formatScientific, } from "./axisLabels.js";
+export { MAXIMUM_DRIFT_STEPS, layoutAnnotationBoxes } from "./boxLayout.js";
+export { DEFAULT_Y_AXIS_RULES, DEFAULT_ZOOM_GESTURES, sameChartDomain, } from "./chartDomain.js";
+export { CHART_LAYERS, MARGIN, MINIMUM_PLOT_SIDE, SHARED_AXIS_MARGIN, plotRect, } from "./chartGeometry.js";
+export { CHART_PANE_ATTRIBUTE } from "./chartPane.js";
+export { CHART_COLORS, CHART_FONT, LABEL_HALO, LABEL_QUIET, PEAK_LABEL, } from "./chartTheme.js";
+export { guidePlacement } from "./guidePlacement.js";
+export { labelStackBaselines } from "./labelStack.js";
+export { CLOSE_COLUMN, MAXIMUM_CHARACTERS, PADDING, ROW_HEIGHT, SWATCH, hiddenLabel, legendBox, legendLabel, legendNames, } from "./legendBox.js";
+export { selectionRectangle } from "./selectionGeometry.js";
+export { ALL_SPECTRUM_COLORS, EXTRA_SPECTRUM_COLORS, SPECTRUM_COLORS, nextSpectrumColor, } from "./spectrumColor.js";
+export { FOOT_FURNITURE, FOOT_MINIMUM, STACKED_MINIMUM, STACK_LIMIT, stackCapacity, stackShares, } from "./stackCapacity.js";
+export { svgPointAt } from "./svgPoint.js";
+export { areaPath, profilePath, stickPath } from "./tracePath.js";
+export { READOUT_GAP, READOUT_LINES, READOUT_WIDTH, readoutPlacement, } from "./trackerReadout.js";
+export { INITIAL_VIEW, MAXIMUM_CONTENT_SCALE, MAXIMUM_ZOOM, MINIMUM_ZOOM, baseViewBox, clampZoom, magnificationOf, panBy, viewBoxAttribute, viewBoxOf, zoomAbout, zoomToAboutCentre, } from "./viewTransform.js";
+export { MINIMUM_DRAG, releasedBeyondBaseline, scaledYAxis, zoomSelection, zoomedDomain, } from "./zoomDomain.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/chart/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMhD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/chart/core/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,27 @@
+/**
+ * Where each line of a stack of labels above a feature is written.
+ *
+ * The arithmetic only, and none of the wording: what a stack *says* is the one
+ * thing every viewer answers differently — a mass peak carries its intensity,
+ * its m/z and its charge, an infrared band carries its wavenumber and the group
+ * it is assigned to — while where the lines go is the same sum in both, and the
+ * same sum again for the reflected half of a mirrored chart.
+ */
+/**
+ * Where each line of a stack is written, in pixels down the SVG.
+ *
+ * A stack that would run off the top of the plot is **pushed back down** rather
+ * than clipped: the tallest peak of a spectrum is the one most worth naming, its
+ * tip is by construction near the top of the window, and a label cut in half by
+ * the plot edge names nothing. Sliding it down puts it over the feature instead,
+ * which is the one place a reader already knows to look.
+ * @param tip - Where the top of the feature is, in pixels down the SVG.
+ * @param lineCount - How many lines the stack has.
+ * @param bounds - `[top, bottom]` of the plot in pixels, which no line may pass.
+ * @param below - Whether the stack hangs under the feature, which is what the
+ *   mirrored half of a chart wants — above its sticks is the other spectrum.
+ *   Defaults to `false`.
+ * @returns The baseline of each line, in the order the lines were given.
+ */
+export declare function labelStackBaselines(tip: number, lineCount: number, bounds: readonly [number, number], below?: boolean): Float64Array;
+//# sourceMappingURL=labelStack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labelStack.d.ts","sourceRoot":"","sources":["../../../src/chart/core/labelStack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EACjC,KAAK,UAAQ,GACZ,YAAY,CA0Bd"}

package/lib/chart/core/labelStack.js

@@ -0,0 +1,62 @@
+/**
+ * Where each line of a stack of labels above a feature is written.
+ *
+ * The arithmetic only, and none of the wording: what a stack *says* is the one
+ * thing every viewer answers differently — a mass peak carries its intensity,
+ * its m/z and its charge, an infrared band carries its wavenumber and the group
+ * it is assigned to — while where the lines go is the same sum in both, and the
+ * same sum again for the reflected half of a mirrored chart.
+ */
+import { PEAK_LABEL } from "./chartTheme.js";
+/**
+ * Where each line of a stack is written, in pixels down the SVG.
+ *
+ * A stack that would run off the top of the plot is **pushed back down** rather
+ * than clipped: the tallest peak of a spectrum is the one most worth naming, its
+ * tip is by construction near the top of the window, and a label cut in half by
+ * the plot edge names nothing. Sliding it down puts it over the feature instead,
+ * which is the one place a reader already knows to look.
+ * @param tip - Where the top of the feature is, in pixels down the SVG.
+ * @param lineCount - How many lines the stack has.
+ * @param bounds - `[top, bottom]` of the plot in pixels, which no line may pass.
+ * @param below - Whether the stack hangs under the feature, which is what the
+ *   mirrored half of a chart wants — above its sticks is the other spectrum.
+ *   Defaults to `false`.
+ * @returns The baseline of each line, in the order the lines were given.
+ */
+export function labelStackBaselines(tip, lineCount, bounds, below = false) {
+    const count = Number.isFinite(lineCount)
+        ? Math.max(0, Math.floor(lineCount))
+        : 0;
+    const baselines = new Float64Array(count);
+    if (count === 0)
+        return baselines;
+    const { lineHeight, topPad } = PEAK_LABEL;
+    if (below) {
+        for (let line = 0; line < count; line++) {
+            baselines[line] = tip + topPad + (count - line) * lineHeight;
+        }
+        shift(baselines, Math.min(0, bounds[1] - baselines[0]));
+        return baselines;
+    }
+    for (let line = 0; line < count; line++) {
+        baselines[line] = tip - topPad - (count - 1 - line) * lineHeight;
+    }
+    // A baseline one line height below the top edge is what keeps the glyphs of
+    // the topmost line inside the plot rather than half over it.
+    shift(baselines, Math.max(0, bounds[0] + lineHeight - baselines[0]));
+    return baselines;
+}
+/**
+ * Move every baseline of a stack by the same amount.
+ * @param baselines - The baselines, written into.
+ * @param delta - How far down to move them; zero leaves them alone.
+ */
+function shift(baselines, delta) {
+    if (delta === 0)
+        return;
+    for (let line = 0; line < baselines.length; line++) {
+        baselines[line] = baselines[line] + delta;
+    }
+}
+//# sourceMappingURL=labelStack.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"labelStack.js","sourceRoot":"","sources":["../../../src/chart/core/labelStack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAW,EACX,SAAiB,EACjB,MAAiC,EACjC,KAAK,GAAG,KAAK;IAEb,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,SAAS,GAAG,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC;IAC1C,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YACxC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAI,SAAS,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC;QACpE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;QACxC,SAAS,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,UAAU,CAAC;IACnE,CAAC;IACD,4EAA4E;IAC5E,6DAA6D;IAC7D,KAAK,CACH,SAAS,EACT,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,UAAU,GAAI,SAAS,CAAC,CAAC,CAAY,CAAC,CAC/D,CAAC;IACF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,KAAK,CAAC,SAAuB,EAAE,KAAa;IACnD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACxB,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;QACnD,SAAS,CAAC,IAAI,CAAC,GAAI,SAAS,CAAC,IAAI,CAAY,GAAG,KAAK,CAAC;IACxD,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,152 @@
+/**
+ * Where a legend sits, and where every one of its rows sits inside it.
+ *
+ * A legend whose rows carry a control is drawn **twice, in two technologies**,
+ * and that is what this module exists for. The picture has to be SVG, because
+ * an export clones the chart's own `SVGSVGElement` and anything living beside
+ * it in a `<div>` is missing from every figure while looking perfectly right on
+ * screen; a close cross has to be HTML, because an SVG `×` would be cloned into
+ * that same figure as a dead glyph, and a `pointerdown` on the SVG root is read
+ * as a chart gesture rather than as a click on a row. Two renderings of one box
+ * are two chances to place a row differently, so the arithmetic has exactly one
+ * owner and neither of them does any of its own — a cross half a row off the
+ * name beside it is a cross that closes the wrong trace.
+ *
+ * Everything is measured from character counts rather than from the DOM. The
+ * box is worked out during render, where a `getComputedTextLength` would need a
+ * layout pass that has not happened yet, and the exported clone gets no layout
+ * at all — so a legend that measured itself would come out a different size in
+ * the figure than on screen. `CHARACTER_WIDTH` is a conservative average
+ * advance for the face at `FONT_SIZE`: a name that overruns it by a character
+ * is a smaller problem than a picture that disagrees with itself.
+ */
+import type { PlotRect } from './chartGeometry.ts';
+/** Where a legend sits, and where each of its rows sits inside it. */
+export interface LegendBox {
+    /** The box's left edge, in the plot's own pixels. */
+    left: number;
+    /** Its top edge. */
+    top: number;
+    /** How wide it is. */
+    width: number;
+    /** How tall it is. */
+    height: number;
+    /** The rows it draws, in order. */
+    rows: readonly LegendRow[];
+    /** How many entries were left out, counted on a final row. 0 when none were. */
+    hidden: number;
+}
+/** One row of a legend, placed. */
+export interface LegendRow {
+    /** Identity of the entry it draws. */
+    id: string;
+    /** The row's own top edge. */
+    top: number;
+    /** How tall it is. */
+    height: number;
+    /** The vertical middle of the row, which is what a swatch and a baseline sit on. */
+    middle: number;
+}
+/** What a legend has to know about an entry to give it room. */
+export interface LegendBoxEntry {
+    /** Identity, which is what the list is keyed on. */
+    id: string;
+    /** What it is called. */
+    name: string;
+    /**
+     * A 1-based number written before the name.
+     * @default undefined
+     */
+    index?: number;
+    /**
+     * A short remark written at the right of the row.
+     * @default undefined
+     */
+    note?: string;
+}
+/** How a legend is measured. */
+export interface LegendBoxOptions {
+    /**
+     * How many entries are named before the rest are counted instead.
+     * @default 8
+     */
+    limit?: number;
+    /**
+     * Whether a column is left at the right of each row for a control.
+     * @default false
+     */
+    closable?: boolean;
+}
+/**
+ * Measure the legend a set of entries asks for, and place its rows.
+ *
+ * Top right of the plot, because that is where a trace leaves room: a curve
+ * rises from the baseline and the tallest peak is rarely at the right-hand
+ * edge. Over the plot rather than in a gutter beside it, so that naming the
+ * traces never narrows the measurement they are drawn in.
+ *
+ * Past `limit` the remaining entries are counted rather than named — a legend
+ * taller than the plot hides the measurement it is explaining, which is the
+ * failure a scrollbar in a legend admits to. The count is a row of its own, so
+ * it is paid for in `height` while staying out of `rows`: nothing draws a
+ * swatch or a cross for it, and it names no entry to key on.
+ * @param entries - The traces to name, in the order they are drawn. Only the
+ * first `limit` of them get a row; the rest are counted.
+ * @param plot - The plot the legend is placed against.
+ * @param options - How many are named, and whether a control column is kept.
+ * @returns The box and its rows, in the plot's own pixels.
+ */
+export declare function legendBox(entries: readonly LegendBoxEntry[], plot: PlotRect, options?: LegendBoxOptions): LegendBox;
+/**
+ * What a row of the legend actually reads, index and all.
+ *
+ * The number goes in front of the name rather than beside it because the
+ * palette hands out six hues and a seventh trace legitimately repeats one, so
+ * the number is what tells two blue traces apart — and it has to be the first
+ * thing on the row for that to work while the eye is running down the column.
+ * Written here rather than at each drawing site so that whatever measured the
+ * row and whatever draws it agree on the string, to the character.
+ * @param entry - The entry the row names.
+ * @returns The text of the row, without its note.
+ */
+export declare function legendLabel(entry: LegendBoxEntry): string;
+/**
+ * What the final row reads when entries were left out.
+ * @param hidden - How many were not named.
+ * @returns The text of that row.
+ */
+export declare function hiddenLabel(hidden: number): string;
+/**
+ * The entries a legend actually draws a row for.
+ *
+ * Two rules in one answer, and three drawings depend on both of them agreeing:
+ * the SVG legend, the HTML row layer placed over it, and whatever else is
+ * written along the top of the same plot and has to keep clear of the box. A
+ * trace with no name is not given a row — an unnamed curve in a legend is a
+ * swatch and nothing else, which is worse than being left out — and below
+ * `minimumEntries` names no legend is drawn at all, since the axis title
+ * already says what a single curve is.
+ * @param entries - The traces, in the order they are drawn.
+ * @param minimumEntries - How few named traces are still worth a legend.
+ * @returns The entries that get a row, empty where none is drawn.
+ */
+export declare function legendNames<Entry extends LegendBoxEntry>(entries: readonly Entry[], minimumEntries?: number): Entry[];
+/** The line of colour that stands for the curve. */
+export declare const SWATCH = 14;
+/** Between the swatch and the name, and between the name and a note. */
+export declare const GAP = 5;
+/** Inside the box, on every side. */
+export declare const PADDING = 6;
+/** One row of the legend. */
+export declare const ROW_HEIGHT = 14;
+/** Between the box and the edge of the plot. */
+export declare const MARGIN = 6;
+/** The face the names are written at. */
+export declare const FONT_SIZE = 11;
+/** About how wide one character is at that size. */
+export declare const CHARACTER_WIDTH = 6.1;
+/** The longest name the box is widened for; past it a name simply overruns. */
+export declare const MAXIMUM_CHARACTERS = 28;
+/** The strip kept at the right of a row for a control, when one is asked for. */
+export declare const CLOSE_COLUMN = 12;
+//# sourceMappingURL=legendBox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"legendBox.d.ts","sourceRoot":"","sources":["../../../src/chart/core/legendBox.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD,sEAAsE;AACtE,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,SAAS,SAAS,EAAE,CAAC;IAC3B,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,mCAAmC;AACnC,MAAM,WAAW,SAAS;IACxB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,gCAAgC;AAChC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAsCX;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAIzD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,KAAK,SAAS,cAAc,EACtD,OAAO,EAAE,SAAS,KAAK,EAAE,EACzB,cAAc,SAAI,GACjB,KAAK,EAAE,CAGT;AAuCD,oDAAoD;AACpD,eAAO,MAAM,MAAM,KAAK,CAAC;AAEzB,wEAAwE;AACxE,eAAO,MAAM,GAAG,IAAI,CAAC;AAErB,qCAAqC;AACrC,eAAO,MAAM,OAAO,IAAI,CAAC;AAEzB,6BAA6B;AAC7B,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B,gDAAgD;AAChD,eAAO,MAAM,MAAM,IAAI,CAAC;AAExB,yCAAyC;AACzC,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,oDAAoD;AACpD,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,+EAA+E;AAC/E,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC,iFAAiF;AACjF,eAAO,MAAM,YAAY,KAAK,CAAC"}

package/lib/chart/core/legendBox.js

@@ -0,0 +1,169 @@
+/**
+ * Where a legend sits, and where every one of its rows sits inside it.
+ *
+ * A legend whose rows carry a control is drawn **twice, in two technologies**,
+ * and that is what this module exists for. The picture has to be SVG, because
+ * an export clones the chart's own `SVGSVGElement` and anything living beside
+ * it in a `<div>` is missing from every figure while looking perfectly right on
+ * screen; a close cross has to be HTML, because an SVG `×` would be cloned into
+ * that same figure as a dead glyph, and a `pointerdown` on the SVG root is read
+ * as a chart gesture rather than as a click on a row. Two renderings of one box
+ * are two chances to place a row differently, so the arithmetic has exactly one
+ * owner and neither of them does any of its own — a cross half a row off the
+ * name beside it is a cross that closes the wrong trace.
+ *
+ * Everything is measured from character counts rather than from the DOM. The
+ * box is worked out during render, where a `getComputedTextLength` would need a
+ * layout pass that has not happened yet, and the exported clone gets no layout
+ * at all — so a legend that measured itself would come out a different size in
+ * the figure than on screen. `CHARACTER_WIDTH` is a conservative average
+ * advance for the face at `FONT_SIZE`: a name that overruns it by a character
+ * is a smaller problem than a picture that disagrees with itself.
+ */
+/**
+ * Measure the legend a set of entries asks for, and place its rows.
+ *
+ * Top right of the plot, because that is where a trace leaves room: a curve
+ * rises from the baseline and the tallest peak is rarely at the right-hand
+ * edge. Over the plot rather than in a gutter beside it, so that naming the
+ * traces never narrows the measurement they are drawn in.
+ *
+ * Past `limit` the remaining entries are counted rather than named — a legend
+ * taller than the plot hides the measurement it is explaining, which is the
+ * failure a scrollbar in a legend admits to. The count is a row of its own, so
+ * it is paid for in `height` while staying out of `rows`: nothing draws a
+ * swatch or a cross for it, and it names no entry to key on.
+ * @param entries - The traces to name, in the order they are drawn. Only the
+ * first `limit` of them get a row; the rest are counted.
+ * @param plot - The plot the legend is placed against.
+ * @param options - How many are named, and whether a control column is kept.
+ * @returns The box and its rows, in the plot's own pixels.
+ */
+export function legendBox(entries, plot, options = {}) {
+    const { limit = 8, closable = false } = options;
+    // Never taller than the plot it is drawn over. A legend covers the
+    // measurement it explains, so one that overran its plot would hide the axis
+    // under it — and on a pane of a stack that axis is the only one the whole
+    // stack has. The surplus is counted on a last row exactly as `limit`'s is, so
+    // nothing goes missing; it is only no longer named.
+    const room = Math.max(1, Math.floor((plot.height - MARGIN * 2 - PADDING * 2) / ROW_HEIGHT));
+    const asked = Math.min(Math.max(0, limit), entries.length);
+    // A row is spent on the count whenever anything is left out, so the test is
+    // against `asked + 1` in that case — otherwise a legend of exactly `room`
+    // names would grow a counted row and overflow by one after all.
+    const overflows = asked < entries.length ? asked + 1 > room : asked > room;
+    const named = overflows ? Math.max(0, room - 1) : asked;
+    const shown = entries.slice(0, named);
+    const hidden = entries.length - shown.length;
+    const width = boxWidth(shown, hidden, closable);
+    const rowCount = shown.length + (hidden > 0 ? 1 : 0);
+    const height = rowCount * ROW_HEIGHT + PADDING * 2;
+    const left = plot.left + plot.width - width - MARGIN;
+    const top = plot.top + MARGIN;
+    const rows = [];
+    for (const [index, entry] of shown.entries()) {
+        const rowTop = top + PADDING + index * ROW_HEIGHT;
+        rows.push({
+            id: entry.id,
+            top: rowTop,
+            height: ROW_HEIGHT,
+            middle: rowTop + ROW_HEIGHT / 2,
+        });
+    }
+    return { left, top, width, height, rows, hidden };
+}
+/**
+ * What a row of the legend actually reads, index and all.
+ *
+ * The number goes in front of the name rather than beside it because the
+ * palette hands out six hues and a seventh trace legitimately repeats one, so
+ * the number is what tells two blue traces apart — and it has to be the first
+ * thing on the row for that to work while the eye is running down the column.
+ * Written here rather than at each drawing site so that whatever measured the
+ * row and whatever draws it agree on the string, to the character.
+ * @param entry - The entry the row names.
+ * @returns The text of the row, without its note.
+ */
+export function legendLabel(entry) {
+    return entry.index === undefined
+        ? entry.name
+        : `${entry.index}${INDEX_SEPARATOR}${entry.name}`;
+}
+/**
+ * What the final row reads when entries were left out.
+ * @param hidden - How many were not named.
+ * @returns The text of that row.
+ */
+export function hiddenLabel(hidden) {
+    return `+ ${hidden} more`;
+}
+/**
+ * The entries a legend actually draws a row for.
+ *
+ * Two rules in one answer, and three drawings depend on both of them agreeing:
+ * the SVG legend, the HTML row layer placed over it, and whatever else is
+ * written along the top of the same plot and has to keep clear of the box. A
+ * trace with no name is not given a row — an unnamed curve in a legend is a
+ * swatch and nothing else, which is worse than being left out — and below
+ * `minimumEntries` names no legend is drawn at all, since the axis title
+ * already says what a single curve is.
+ * @param entries - The traces, in the order they are drawn.
+ * @param minimumEntries - How few named traces are still worth a legend.
+ * @returns The entries that get a row, empty where none is drawn.
+ */
+export function legendNames(entries, minimumEntries = 2) {
+    const named = entries.filter((entry) => entry.name !== '');
+    return named.length < minimumEntries ? [] : named;
+}
+/**
+ * How wide the box has to be to hold the longest row it is drawing.
+ *
+ * The name column is sized on the longest label — the counted row included,
+ * since it is written in the same column — and clamped at
+ * `MAXIMUM_CHARACTERS`, past which a name simply overruns rather than dragging
+ * the box across the plot it is standing on. A note is a column of its own at
+ * the right, so a long note never pushes the names about, and the control
+ * column is a fixed strip because a cross is one glyph whatever the row says.
+ * @param entries - The rows being drawn.
+ * @param hidden - How many were left out, which the final row counts.
+ * @param closable - Whether a control column is kept at the right.
+ * @returns The width in pixels.
+ */
+function boxWidth(entries, hidden, closable) {
+    let longest = hidden > 0 ? hiddenLabel(hidden).length : 0;
+    let longestNote = 0;
+    for (const entry of entries) {
+        const label = legendLabel(entry).length;
+        if (label > longest)
+            longest = label;
+        const note = entry.note === undefined ? 0 : entry.note.length;
+        if (note > longestNote)
+            longestNote = note;
+    }
+    const text = Math.min(longest, MAXIMUM_CHARACTERS) * CHARACTER_WIDTH;
+    const note = longestNote === 0
+        ? 0
+        : GAP + Math.min(longestNote, MAXIMUM_CHARACTERS) * CHARACTER_WIDTH;
+    return (PADDING * 2 + SWATCH + GAP + text + note + (closable ? CLOSE_COLUMN : 0));
+}
+/** The line of colour that stands for the curve. */
+export const SWATCH = 14;
+/** Between the swatch and the name, and between the name and a note. */
+export const GAP = 5;
+/** Inside the box, on every side. */
+export const PADDING = 6;
+/** One row of the legend. */
+export const ROW_HEIGHT = 14;
+/** Between the box and the edge of the plot. */
+export const MARGIN = 6;
+/** The face the names are written at. */
+export const FONT_SIZE = 11;
+/** About how wide one character is at that size. */
+export const CHARACTER_WIDTH = 6.1;
+/** The longest name the box is widened for; past it a name simply overruns. */
+export const MAXIMUM_CHARACTERS = 28;
+/** The strip kept at the right of a row for a control, when one is asked for. */
+export const CLOSE_COLUMN = 12;
+/** Between the index and the name it numbers. */
+const INDEX_SEPARATOR = ' · ';
+//# sourceMappingURL=legendBox.js.map

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

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

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

@@ -0,0 +1,45 @@
+/**
+ * The rectangle a drag sweeps out, in the pixels it is drawn in.
+ *
+ * The preview and the release are two readings of one gesture, and they have to
+ * agree: a rectangle that promises a window the release then refuses teaches a
+ * user that the chart is unreliable, which is a far more expensive mistake than
+ * a preview that is a pixel out. So the same two tests decide both — the drag is
+ * pulled back inside the plot and measured against `MINIMUM_DRAG` here exactly
+ * as `zoomedDomain` does it, and the height comes from the answer
+ * `zoomSelection` already worked out rather than from a second one.
+ */
+import type { PlotRect } from './chartGeometry.ts';
+import type { ZoomSelection } from './zoomDomain.ts';
+/** A rectangle in the user units of the SVG. */
+export interface SelectionRectangle {
+    /** Its left edge. */
+    x: number;
+    /** Its top edge. */
+    y: number;
+    /** How wide it is. */
+    width: number;
+    /** How tall it is. */
+    height: number;
+}
+/**
+ * The rectangle to draw for a drag being made.
+ *
+ * A drag that takes the y axis with it is drawn at the height of the drag
+ * itself, and one that asks for the x axis alone spans the whole plot.
+ * That is the gesture announcing itself before the button is let go: the
+ * rectangle changing shape as the pointer crosses the baseline is the only
+ * warning a user gets that the release is about to move both axes, and it is one
+ * they can still act on.
+ *
+ * A drag too short to zoom draws nothing at all. Below `MINIMUM_DRAG` the
+ * release does nothing — most clicks made on a trackpad wobble by a pixel or two
+ * — and a rectangle flashing up on every click would say that something
+ * happened.
+ * @param selection - The drag being made, `null` when none is.
+ * @param plot - Where the plot sits inside the SVG, which the drag is confined
+ * to.
+ * @returns The rectangle, `null` when there is nothing to draw.
+ */
+export declare function selectionRectangle(selection: ZoomSelection | null, plot: PlotRect): SelectionRectangle | null;
+//# sourceMappingURL=selectionGeometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectionGeometry.d.ts","sourceRoot":"","sources":["../../../src/chart/core/selectionGeometry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGrD,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,oBAAoB;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,GAAG,IAAI,EAC/B,IAAI,EAAE,QAAQ,GACb,kBAAkB,GAAG,IAAI,CAe3B"}