react-cheminfo 0.28.0 → 0.29.0

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

@@ -24,7 +24,10 @@ export interface ChartScale {
  * @param rangeMax - The pixel `domainMax` maps to.
  * @returns The mapping. A zero-width or non-finite domain gives a `factor` of
  * zero, which pins every value to the middle of the range so that a constant
- * column still draws instead of vanishing.
+ * column still draws instead of vanishing. A range that is not a range — a
+ * plot measured before it was laid out — gives an `offset` of `NaN` instead,
+ * because there is no pixel a value could honestly be put at, and every mark
+ * already declines to draw what does not map.
  */
 export declare function chartScale(domainMin: number, domainMax: number, rangeMin: number, rangeMax: number): ChartScale;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"chartScale.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartScale.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,CASZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAK,GAAG,MAAM,CAE1E"}
+{"version":3,"file":"chartScale.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartScale.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,CASZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAInE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAK,GAAG,MAAM,CAE1E"}

package/lib/chart/core/chartScale.js

@@ -11,14 +11,18 @@ import { roundTo } from "../../format/core/roundTo.js";
  * @param rangeMax - The pixel `domainMax` maps to.
  * @returns The mapping. A zero-width or non-finite domain gives a `factor` of
  * zero, which pins every value to the middle of the range so that a constant
- * column still draws instead of vanishing.
+ * column still draws instead of vanishing. A range that is not a range — a
+ * plot measured before it was laid out — gives an `offset` of `NaN` instead,
+ * because there is no pixel a value could honestly be put at, and every mark
+ * already declines to draw what does not map.
  */
 export function chartScale(domainMin, domainMax, rangeMin, rangeMax) {
     const span = domainMax - domainMin;
     const reach = rangeMax - rangeMin;
-    if (span === 0 || !Number.isFinite(span) || !Number.isFinite(reach)) {
-        const middle = (rangeMin + rangeMax) / 2;
-        return { offset: Number.isFinite(middle) ? middle : 0, factor: 0 };
+    if (!Number.isFinite(reach))
+        return { offset: Number.NaN, factor: 0 };
+    if (span === 0 || !Number.isFinite(span)) {
+        return { offset: (rangeMin + rangeMax) / 2, factor: 0 };
     }
     const factor = reach / span;
     return { offset: rangeMin - domainMin * factor, factor };

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

@@ -1 +1 @@
-{"version":3,"file":"chartScale.js","sourceRoot":"","sources":["../../../src/chart/core/chartScale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAiBvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,SAAiB,EACjB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAa;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAa;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACpD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,WAAkB,CAAC;IAChE,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}
+{"version":3,"file":"chartScale.js","sourceRoot":"","sources":["../../../src/chart/core/chartScale.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAiBvD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,SAAiB,EACjB,QAAgB,EAChB,QAAgB;IAEhB,MAAM,IAAI,GAAG,SAAS,GAAG,SAAS,CAAC;IACnC,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACtE,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzC,OAAO,EAAE,MAAM,EAAE,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAa;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiB,EAAE,KAAa;IACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IACpD,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa,EAAE,WAAkB,CAAC;IAChE,OAAO,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,156 @@
+/**
+ * Every colour and every measurement the chart is drawn with.
+ *
+ * Each colour is a custom property with a literal fallback baked in, and is
+ * applied through the `style` prop rather than through the matching SVG
+ * attribute — `fill="var(--spectrum-axis, #64748b)"` is not a colour any browser
+ * resolves, because `var()` is a CSS value and a presentation attribute is not
+ * parsed as one. `style={{ fill: CHART_COLORS.axis }}` is.
+ *
+ * One set of tokens for every viewer built on this package, rather than one per
+ * viewer: a page showing a mass spectrum beside an infrared one is showing two
+ * charts that have to look like the same instrument, and two token families
+ * would let them drift apart at the first theme change.
+ *
+ * The fallbacks are what make the package usable on its own: a host that sets
+ * none of these tokens still gets a chart that reads correctly, and a host with
+ * a dark theme or a house palette overrides whichever it cares about by setting
+ * the properties on any ancestor. Nothing here is a prop, because a colour
+ * threaded through props is a colour that ends up hard-coded in one component
+ * that forgot to accept it.
+ */
+/** The colours of everything the chart draws that is not a spectrum. */
+export declare const CHART_COLORS: {
+    /** The two axis lines and their ticks. */
+    readonly axis: "var(--spectrum-axis, #64748b)";
+    /** The numbers along both axes. */
+    readonly tick: "var(--spectrum-tick, #475569)";
+    /** The axis titles, whatever the viewer calls its two axes. */
+    readonly title: "var(--spectrum-title, #334155)";
+    /** The rules across the plot, behind the data. */
+    readonly grid: "var(--spectrum-grid, #e2e8f0)";
+    /** The rule at zero, which a mirrored pair is reflected in. */
+    readonly zeroRule: "var(--spectrum-zero-rule, #cbd5e1)";
+    /** A mark on a feature an annotation explained. */
+    readonly annotation: "var(--spectrum-annotation, #2563eb)";
+    /**
+     * A mark where an annotation nothing answered would fall, drawn dashed. Grey
+     * rather than red: a fragment the spectrum does not carry is an answer, and
+     * colouring it as a failure would say the opposite.
+     */
+    readonly annotationUnmatched: "var(--spectrum-annotation-unmatched, #cbd5e1)";
+    /**
+     * A mark on a place the measurement drawn below was cut from — the peaks a
+     * survey scan was fragmented at.
+     *
+     * Its own token rather than the annotation blue, because the two are claims
+     * of different kinds laid over the same peaks: an annotation says *this is
+     * what I think that peak is*, and a precursor mark says *this is what the
+     * instrument did with it*. A spectrum can carry both at once, and a reader
+     * has to be able to tell one row of marks from the other.
+     */
+    readonly precursor: "var(--spectrum-precursor, #7c3aed)";
+    /** The line from a label back down to the peak it belongs to. */
+    readonly leader: "var(--spectrum-leader, #94a3b8)";
+    /** The fill of a label box, opaque enough to read over a dense trace. */
+    readonly labelBackground: "var(--spectrum-label-background, rgba(255, 255, 255, 0.88))";
+    /** Its border. */
+    readonly labelBorder: "var(--spectrum-label-border, #cbd5e1)";
+    /** The text inside it. */
+    readonly labelText: "var(--spectrum-label-text, #1e293b)";
+    /**
+     * The paper a label written straight onto the plot is set on, laid behind its
+     * glyphs rather than in a box around them — the colour of the chart itself,
+     * which is why a host with a dark theme has to override it along with the rest.
+     */
+    readonly labelHalo: "var(--spectrum-label-halo, #ffffff)";
+    /** Whatever the pointer has come to rest on, wherever it was hovered. */
+    readonly highlight: "var(--spectrum-highlight, #f97316)";
+    /** The rectangle a drag is sweeping out. */
+    readonly selection: "var(--spectrum-selection, rgba(37, 99, 235, 0.12))";
+    /** Its edge. */
+    readonly selectionBorder: "var(--spectrum-selection-border, #2563eb)";
+    /** The crosshair following the pointer. */
+    readonly tracker: "var(--spectrum-tracker, #94a3b8)";
+    /** What it reads out. */
+    readonly trackerText: "var(--spectrum-tracker-text, #0f172a)";
+};
+/**
+ * The type sizes, in pixels.
+ *
+ * Small and fixed rather than inherited: the chart is a drawing, and a host
+ * whose base font is 18px would push its tick labels into one another. The
+ * family is deliberately not set here, so the chart still looks like the
+ * application it is embedded in.
+ */
+export declare const CHART_FONT: {
+    /** The numbers along both axes. */
+    readonly tick: 10;
+    /** The axis titles. */
+    readonly title: 12;
+    /** The labels pinned above the peaks. */
+    readonly label: 11;
+    /** The readout the crosshair carries. */
+    readonly readout: 11;
+};
+/**
+ * The geometry of a label pinned above a feature.
+ *
+ * A label is two lines often enough — an m/z over a formula, a wavenumber over
+ * the group it is assigned to — that the spacing has to be a constant both the
+ * drawing and the declutter sweep agree on, or the boxes are spaced for one
+ * height and drawn at another.
+ */
+export declare const PEAK_LABEL: {
+    /** The baseline-to-baseline distance between two stacked lines. */
+    readonly lineHeight: 11;
+    /** The clear space between the top of a stick and its first line. */
+    readonly topPad: 10;
+    /**
+     * How far the mark on a named peak reaches from the tip of its stick.
+     *
+     * It reaches *away* from the stack, down into the peak, because the clear
+     * space above the tip is where the numbers are written and the mark is there
+     * to say which peak they are about. Short on purpose: what is drawn is the
+     * **top of the centroid stick**, enough to put a picked peak exactly on the
+     * profile it was picked from — a rule carried all the way to the baseline is
+     * the centroid trace itself, which is the other thing the row toggles.
+     */
+    readonly topMark: 10;
+    /**
+     * Half the width a label claims while the pointer is on it, which is what the
+     * declutter sweep keeps its neighbours out of.
+     */
+    readonly hoverHalfWidth: 26;
+};
+/**
+ * The halo a label written straight onto the plot carries.
+ *
+ * A number over a peak is written over whatever the plot has there — a grid
+ * line, a dense trace, the crosshair following the pointer, the tail of the
+ * label beside it — and a glyph crossed by a line is a glyph read twice before
+ * it is read at all. So the glyphs are stroked in the colour of the paper and
+ * that stroke is painted *first*, which clears a hairline of chart from around
+ * every letter without a box, a border or a fill hiding the data underneath.
+ *
+ * `paintOrder` is the whole of it and is easy to leave out: the default order
+ * paints the stroke over the fill, so the same three properties without it draw
+ * every label in white on white.
+ */
+export declare const LABEL_HALO: {
+    readonly paintOrder: "stroke";
+    readonly stroke: "var(--spectrum-label-halo, #ffffff)";
+    readonly strokeWidth: 3;
+    readonly strokeLinejoin: "round";
+};
+/**
+ * How far the supporting line of a label is let back towards the paper.
+ *
+ * A label is rarely one thing: a mass peak carries what it is *and* how tall it
+ * stood, and the crosshair reads a place on both axes at once. Written in one
+ * ink they are read together, which means the line somebody wants has to be
+ * found among the ones they do not. Six tenths is enough to grade them apart at
+ * eleven pixels and not so far as to make the quiet line look disabled.
+ */
+export declare const LABEL_QUIET = 0.6;
+//# sourceMappingURL=chartTheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chartTheme.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wEAAwE;AACxE,eAAO,MAAM,YAAY;IACvB,0CAA0C;;IAE1C,mCAAmC;;IAEnC,+DAA+D;;IAE/D,kDAAkD;;IAElD,+DAA+D;;IAE/D,mDAAmD;;IAEnD;;;;OAIG;;IAEH;;;;;;;;;OASG;;IAEH,iEAAiE;;IAEjE,yEAAyE;;IAGzE,kBAAkB;;IAElB,0BAA0B;;IAE1B;;;;OAIG;;IAEH,yEAAyE;;IAEzE,4CAA4C;;IAE5C,gBAAgB;;IAEhB,2CAA2C;;IAE3C,yBAAyB;;CAEjB,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAEnC,uBAAuB;;IAEvB,yCAAyC;;IAEzC,yCAAyC;;CAEjC,CAAC;AAEX;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IACrB,mEAAmE;;IAEnE,qEAAqE;;IAErE;;;;;;;;;OASG;;IAEH;;;OAGG;;CAEK,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU;;;;;CAKb,CAAC;AAEX;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,MAAM,CAAC"}

package/lib/chart/core/chartTheme.js

@@ -0,0 +1,156 @@
+/**
+ * Every colour and every measurement the chart is drawn with.
+ *
+ * Each colour is a custom property with a literal fallback baked in, and is
+ * applied through the `style` prop rather than through the matching SVG
+ * attribute — `fill="var(--spectrum-axis, #64748b)"` is not a colour any browser
+ * resolves, because `var()` is a CSS value and a presentation attribute is not
+ * parsed as one. `style={{ fill: CHART_COLORS.axis }}` is.
+ *
+ * One set of tokens for every viewer built on this package, rather than one per
+ * viewer: a page showing a mass spectrum beside an infrared one is showing two
+ * charts that have to look like the same instrument, and two token families
+ * would let them drift apart at the first theme change.
+ *
+ * The fallbacks are what make the package usable on its own: a host that sets
+ * none of these tokens still gets a chart that reads correctly, and a host with
+ * a dark theme or a house palette overrides whichever it cares about by setting
+ * the properties on any ancestor. Nothing here is a prop, because a colour
+ * threaded through props is a colour that ends up hard-coded in one component
+ * that forgot to accept it.
+ */
+/** The colours of everything the chart draws that is not a spectrum. */
+export const CHART_COLORS = {
+    /** The two axis lines and their ticks. */
+    axis: 'var(--spectrum-axis, #64748b)',
+    /** The numbers along both axes. */
+    tick: 'var(--spectrum-tick, #475569)',
+    /** The axis titles, whatever the viewer calls its two axes. */
+    title: 'var(--spectrum-title, #334155)',
+    /** The rules across the plot, behind the data. */
+    grid: 'var(--spectrum-grid, #e2e8f0)',
+    /** The rule at zero, which a mirrored pair is reflected in. */
+    zeroRule: 'var(--spectrum-zero-rule, #cbd5e1)',
+    /** A mark on a feature an annotation explained. */
+    annotation: 'var(--spectrum-annotation, #2563eb)',
+    /**
+     * A mark where an annotation nothing answered would fall, drawn dashed. Grey
+     * rather than red: a fragment the spectrum does not carry is an answer, and
+     * colouring it as a failure would say the opposite.
+     */
+    annotationUnmatched: 'var(--spectrum-annotation-unmatched, #cbd5e1)',
+    /**
+     * A mark on a place the measurement drawn below was cut from — the peaks a
+     * survey scan was fragmented at.
+     *
+     * Its own token rather than the annotation blue, because the two are claims
+     * of different kinds laid over the same peaks: an annotation says *this is
+     * what I think that peak is*, and a precursor mark says *this is what the
+     * instrument did with it*. A spectrum can carry both at once, and a reader
+     * has to be able to tell one row of marks from the other.
+     */
+    precursor: 'var(--spectrum-precursor, #7c3aed)',
+    /** The line from a label back down to the peak it belongs to. */
+    leader: 'var(--spectrum-leader, #94a3b8)',
+    /** The fill of a label box, opaque enough to read over a dense trace. */
+    labelBackground: 'var(--spectrum-label-background, rgba(255, 255, 255, 0.88))',
+    /** Its border. */
+    labelBorder: 'var(--spectrum-label-border, #cbd5e1)',
+    /** The text inside it. */
+    labelText: 'var(--spectrum-label-text, #1e293b)',
+    /**
+     * The paper a label written straight onto the plot is set on, laid behind its
+     * glyphs rather than in a box around them — the colour of the chart itself,
+     * which is why a host with a dark theme has to override it along with the rest.
+     */
+    labelHalo: 'var(--spectrum-label-halo, #ffffff)',
+    /** Whatever the pointer has come to rest on, wherever it was hovered. */
+    highlight: 'var(--spectrum-highlight, #f97316)',
+    /** The rectangle a drag is sweeping out. */
+    selection: 'var(--spectrum-selection, rgba(37, 99, 235, 0.12))',
+    /** Its edge. */
+    selectionBorder: 'var(--spectrum-selection-border, #2563eb)',
+    /** The crosshair following the pointer. */
+    tracker: 'var(--spectrum-tracker, #94a3b8)',
+    /** What it reads out. */
+    trackerText: 'var(--spectrum-tracker-text, #0f172a)',
+};
+/**
+ * The type sizes, in pixels.
+ *
+ * Small and fixed rather than inherited: the chart is a drawing, and a host
+ * whose base font is 18px would push its tick labels into one another. The
+ * family is deliberately not set here, so the chart still looks like the
+ * application it is embedded in.
+ */
+export const CHART_FONT = {
+    /** The numbers along both axes. */
+    tick: 10,
+    /** The axis titles. */
+    title: 12,
+    /** The labels pinned above the peaks. */
+    label: 11,
+    /** The readout the crosshair carries. */
+    readout: 11,
+};
+/**
+ * The geometry of a label pinned above a feature.
+ *
+ * A label is two lines often enough — an m/z over a formula, a wavenumber over
+ * the group it is assigned to — that the spacing has to be a constant both the
+ * drawing and the declutter sweep agree on, or the boxes are spaced for one
+ * height and drawn at another.
+ */
+export const PEAK_LABEL = {
+    /** The baseline-to-baseline distance between two stacked lines. */
+    lineHeight: 11,
+    /** The clear space between the top of a stick and its first line. */
+    topPad: 10,
+    /**
+     * How far the mark on a named peak reaches from the tip of its stick.
+     *
+     * It reaches *away* from the stack, down into the peak, because the clear
+     * space above the tip is where the numbers are written and the mark is there
+     * to say which peak they are about. Short on purpose: what is drawn is the
+     * **top of the centroid stick**, enough to put a picked peak exactly on the
+     * profile it was picked from — a rule carried all the way to the baseline is
+     * the centroid trace itself, which is the other thing the row toggles.
+     */
+    topMark: 10,
+    /**
+     * Half the width a label claims while the pointer is on it, which is what the
+     * declutter sweep keeps its neighbours out of.
+     */
+    hoverHalfWidth: 26,
+};
+/**
+ * The halo a label written straight onto the plot carries.
+ *
+ * A number over a peak is written over whatever the plot has there — a grid
+ * line, a dense trace, the crosshair following the pointer, the tail of the
+ * label beside it — and a glyph crossed by a line is a glyph read twice before
+ * it is read at all. So the glyphs are stroked in the colour of the paper and
+ * that stroke is painted *first*, which clears a hairline of chart from around
+ * every letter without a box, a border or a fill hiding the data underneath.
+ *
+ * `paintOrder` is the whole of it and is easy to leave out: the default order
+ * paints the stroke over the fill, so the same three properties without it draw
+ * every label in white on white.
+ */
+export const LABEL_HALO = {
+    paintOrder: 'stroke',
+    stroke: CHART_COLORS.labelHalo,
+    strokeWidth: 3,
+    strokeLinejoin: 'round',
+};
+/**
+ * How far the supporting line of a label is let back towards the paper.
+ *
+ * A label is rarely one thing: a mass peak carries what it is *and* how tall it
+ * stood, and the crosshair reads a place on both axes at once. Written in one
+ * ink they are read together, which means the line somebody wants has to be
+ * found among the ones they do not. Six tenths is enough to grade them apart at
+ * eleven pixels and not so far as to make the quiet line look disabled.
+ */
+export const LABEL_QUIET = 0.6;
+//# sourceMappingURL=chartTheme.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chartTheme.js","sourceRoot":"","sources":["../../../src/chart/core/chartTheme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,+BAA+B;IACrC,mCAAmC;IACnC,IAAI,EAAE,+BAA+B;IACrC,+DAA+D;IAC/D,KAAK,EAAE,gCAAgC;IACvC,kDAAkD;IAClD,IAAI,EAAE,+BAA+B;IACrC,+DAA+D;IAC/D,QAAQ,EAAE,oCAAoC;IAC9C,mDAAmD;IACnD,UAAU,EAAE,qCAAqC;IACjD;;;;OAIG;IACH,mBAAmB,EAAE,+CAA+C;IACpE;;;;;;;;;OASG;IACH,SAAS,EAAE,oCAAoC;IAC/C,iEAAiE;IACjE,MAAM,EAAE,iCAAiC;IACzC,yEAAyE;IACzE,eAAe,EACb,6DAA6D;IAC/D,kBAAkB;IAClB,WAAW,EAAE,uCAAuC;IACpD,0BAA0B;IAC1B,SAAS,EAAE,qCAAqC;IAChD;;;;OAIG;IACH,SAAS,EAAE,qCAAqC;IAChD,yEAAyE;IACzE,SAAS,EAAE,oCAAoC;IAC/C,4CAA4C;IAC5C,SAAS,EAAE,oDAAoD;IAC/D,gBAAgB;IAChB,eAAe,EAAE,2CAA2C;IAC5D,2CAA2C;IAC3C,OAAO,EAAE,kCAAkC;IAC3C,yBAAyB;IACzB,WAAW,EAAE,uCAAuC;CAC5C,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mCAAmC;IACnC,IAAI,EAAE,EAAE;IACR,uBAAuB;IACvB,KAAK,EAAE,EAAE;IACT,yCAAyC;IACzC,KAAK,EAAE,EAAE;IACT,yCAAyC;IACzC,OAAO,EAAE,EAAE;CACH,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,mEAAmE;IACnE,UAAU,EAAE,EAAE;IACd,qEAAqE;IACrE,MAAM,EAAE,EAAE;IACV;;;;;;;;;OASG;IACH,OAAO,EAAE,EAAE;IACX;;;OAGG;IACH,cAAc,EAAE,EAAE;CACV,CAAC;AAEX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,UAAU,EAAE,QAAQ;IACpB,MAAM,EAAE,YAAY,CAAC,SAAS;IAC9B,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,OAAO;CACf,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC"}

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

@@ -27,8 +27,20 @@ export declare const CHART_WHEEL_SPEED = 0.0015;
 export declare const CHART_WHEEL_LINE = 16;
 /** Pixels it is worth where the browser reports pages. */
 export declare const CHART_WHEEL_PAGE = 400;
-/** The most one wheel event may zoom by, so a stray burst cannot jump. */
-export declare const CHART_WHEEL_LARGEST = 4;
+/**
+ * The most travel one wheel event is read as, in pixels.
+ *
+ * A trackpad flick arrives as a handful of events carrying several hundred
+ * pixels each, and an inertial one keeps arriving after the fingers have left
+ * the glass. Uncapped, a single flick takes an axis through several orders of
+ * magnitude and the data is gone; capped, the gesture stays fast and is always
+ * recoverable by flicking the other way.
+ *
+ * The cap is written in travel rather than as a largest factor because travel
+ * is what the browser reports and what varies between them — so a chart that
+ * zooms at its own pace is held to the same burst as every other.
+ */
+export declare const CHART_WHEEL_TRAVEL = 240;
 /**
  * The viewport a zoom about one point leaves behind.
  *
@@ -76,13 +88,28 @@ export declare function chartZoomDomain(full: readonly [number, number], current
  * The travel is normalised first, because the same notch of the same wheel
  * arrives as pixels in one browser and as lines in another, and a zoom that
  * moves three times as fast in Firefox is a fault the reader blames on the
- * figure. One event is capped: a trackpad flick can deliver a whole page of
- * travel at once, and landing four hundred times out is not recoverable by
- * feel.
+ * figure. Then it is capped at {@link CHART_WHEEL_TRAVEL}, so one burst can
+ * only ever be worth one flick.
+ *
+ * The factor is `exp(pixels x rate)`, so the gesture is multiplicative: two
+ * notches in and two notches out land back where they started, whichever way
+ * round they were made, and a zoom deep into one small feature comes back out
+ * at the pace it went in.
  * @param delta - The event's `deltaY`; positive scrolls away and zooms out.
  * @param mode - Its `deltaMode`: 0 pixels, 1 lines, 2 pages. Defaults to `0`.
  * @param speed - Share zoomed per pixel of travel. Defaults to {@link CHART_WHEEL_SPEED}.
  * @returns The factor to hand {@link chartZoomViewport}; `1` for an event that says nothing.
  */
 export declare function chartWheelFactor(delta: number, mode?: number, speed?: number): number;
+/**
+ * The travel one wheel event carries, in pixels, capped.
+ *
+ * Separate from the factor because a gesture that is not a zoom — a wheel that
+ * scales a value axis about its baseline — needs the same normalisation and
+ * the same cap while computing something else entirely.
+ * @param delta - The event's `deltaY`.
+ * @param mode - Its `deltaMode`: 0 pixels, 1 lines, 2 pages. Defaults to `0`.
+ * @returns The travel, `0` for an event that says nothing.
+ */
+export declare function chartWheelTravel(delta: number, mode?: number): number;
 //# sourceMappingURL=chartViewport.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chartViewport.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartViewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAMtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,aAAa,GACpB,aAAa,GAAG,IAAI,CAQtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB3B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,KAAK,SAAoB,GACxB,MAAM,CAUR"}
+{"version":3,"file":"chartViewport.d.ts","sourceRoot":"","sources":["../../../src/chart/core/chartViewport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,gFAAgF;AAChF,MAAM,WAAW,aAAa;IAC5B,kDAAkD;IAClD,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,qCAAqC;IACrC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAEzC,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,SAAS,CAAC;AAExC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GACb,aAAa,GAAG,IAAI,CAMtB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,aAAa,GACpB,aAAa,GAAG,IAAI,CAQtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAgB3B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,IAAI,SAAI,EACR,KAAK,SAAoB,GACxB,MAAM,CAKR;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,SAAI,GAAG,MAAM,CAIhE"}

package/lib/chart/core/chartViewport.js

@@ -20,8 +20,20 @@ export const CHART_WHEEL_SPEED = 0.0015;
 export const CHART_WHEEL_LINE = 16;
 /** Pixels it is worth where the browser reports pages. */
 export const CHART_WHEEL_PAGE = 400;
-/** The most one wheel event may zoom by, so a stray burst cannot jump. */
-export const CHART_WHEEL_LARGEST = 4;
+/**
+ * The most travel one wheel event is read as, in pixels.
+ *
+ * A trackpad flick arrives as a handful of events carrying several hundred
+ * pixels each, and an inertial one keeps arriving after the fingers have left
+ * the glass. Uncapped, a single flick takes an axis through several orders of
+ * magnitude and the data is gone; capped, the gesture stays fast and is always
+ * recoverable by flicking the other way.
+ *
+ * The cap is written in travel rather than as a largest factor because travel
+ * is what the browser reports and what varies between them — so a chart that
+ * zooms at its own pace is held to the same burst as every other.
+ */
+export const CHART_WHEEL_TRAVEL = 240;
 /**
  * The viewport a zoom about one point leaves behind.
  *
@@ -91,23 +103,40 @@ export function chartZoomDomain(full, current, anchor, factor) {
  * The travel is normalised first, because the same notch of the same wheel
  * arrives as pixels in one browser and as lines in another, and a zoom that
  * moves three times as fast in Firefox is a fault the reader blames on the
- * figure. One event is capped: a trackpad flick can deliver a whole page of
- * travel at once, and landing four hundred times out is not recoverable by
- * feel.
+ * figure. Then it is capped at {@link CHART_WHEEL_TRAVEL}, so one burst can
+ * only ever be worth one flick.
+ *
+ * The factor is `exp(pixels x rate)`, so the gesture is multiplicative: two
+ * notches in and two notches out land back where they started, whichever way
+ * round they were made, and a zoom deep into one small feature comes back out
+ * at the pace it went in.
  * @param delta - The event's `deltaY`; positive scrolls away and zooms out.
  * @param mode - Its `deltaMode`: 0 pixels, 1 lines, 2 pages. Defaults to `0`.
  * @param speed - Share zoomed per pixel of travel. Defaults to {@link CHART_WHEEL_SPEED}.
  * @returns The factor to hand {@link chartZoomViewport}; `1` for an event that says nothing.
  */
 export function chartWheelFactor(delta, mode = 0, speed = CHART_WHEEL_SPEED) {
-    if (!Number.isFinite(delta) || delta === 0)
+    const travel = chartWheelTravel(delta, mode);
+    if (travel === 0)
         return 1;
-    const pixels = delta * wheelPixels(mode);
     const rate = Number.isFinite(speed) && speed > 0 ? speed : CHART_WHEEL_SPEED;
-    const factor = Math.exp(pixels * rate);
-    if (!Number.isFinite(factor))
-        return delta > 0 ? CHART_WHEEL_LARGEST : 1;
-    return Math.min(CHART_WHEEL_LARGEST, Math.max(1 / CHART_WHEEL_LARGEST, factor));
+    return Math.exp(travel * rate);
+}
+/**
+ * The travel one wheel event carries, in pixels, capped.
+ *
+ * Separate from the factor because a gesture that is not a zoom — a wheel that
+ * scales a value axis about its baseline — needs the same normalisation and
+ * the same cap while computing something else entirely.
+ * @param delta - The event's `deltaY`.
+ * @param mode - Its `deltaMode`: 0 pixels, 1 lines, 2 pages. Defaults to `0`.
+ * @returns The travel, `0` for an event that says nothing.
+ */
+export function chartWheelTravel(delta, mode = 0) {
+    if (!Number.isFinite(delta) || delta === 0)
+        return 0;
+    const pixels = delta * wheelPixels(mode);
+    return Math.min(CHART_WHEEL_TRAVEL, Math.max(-CHART_WHEEL_TRAVEL, pixels));
 }
 function wheelPixels(mode) {
     if (mode === 1)

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

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

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

@@ -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 type { PlotRect } from './chartGeometry.ts';
+import type { ChartScale } from './chartScale.ts';
+/** Where a guide ended up, and whether that is where its value actually is. */
+export interface GuidePlacement {
+    /** Where the guide is drawn, in pixels. */
+    x: number;
+    /**
+     * Which side of the window the value lies on, `null` when it is inside it and
+     * the guide is therefore standing on the value itself.
+     */
+    direction: 'left' | 'right' | null;
+}
+/**
+ * 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 declare function guidePlacement(value: number, plot: PlotRect, xScale: ChartScale): GuidePlacement | null;
+//# sourceMappingURL=guidePlacement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guidePlacement.d.ts","sourceRoot":"","sources":["../../../src/chart/core/guidePlacement.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGlD,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,CAAC,EAAE,MAAM,CAAC;IACV;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,UAAU,GACjB,cAAc,GAAG,IAAI,CAOvB"}