stream-charts 1.2.0 → 2.0.0

package/dist/app/charts/series/timeSeries.d.ts

@@ -1,10 +1,11 @@
-import { BaseSeries } from "./baseSeries";
+import { type BaseSeries } from "./baseSeries";
 /**
- * An immutable datum object that holds the spike (time, value) representing a neuron spike
+ * An immutable datum object that holds an (x, y) value -- for a time series, a (time, value) pair
+ * (e.g. a neuron spike, or a weight)
  */
 export interface Datum {
-    readonly time: number;
-    readonly value: number;
+    readonly x: number;
+    readonly y: number;
 }
 /**
  * Creates a datum from a (time, value) pair
@@ -13,18 +14,21 @@ export interface Datum {
  * @return A {@link Datum} instance with the specified (time, value)
  */
 export declare const datumOf: (time: number, value: number) => Datum;
+/**
+ * @return An empty datum (its x and y are `NaN`)
+ */
 export declare const emptyDatum: () => Datum;
+/**
+ * A series of (time, value) data (e.g. for the scatter and raster plots)
+ */
 export type TimeSeries = BaseSeries<Datum>;
 /**
  * Creates a series from the name and the optional array of (x, y) pairs (tuples)
  * @param name The name of the series
  * @param data The optional array of (x, y) pairs (tuples)
- * @return A `Series` for object that can be used by the `RasterChart`
+ * @return A {@link TimeSeries} that can be used by, e.g., the `ScatterPlot` and the `RasterPlot`
  * @see seriesFrom
  * @see emptySeries
  */
 export declare const timeSeriesFromTuples: (name: string, data?: Array<[number, number]>) => TimeSeries;
-export interface PixelDatum extends Datum {
-    x: number;
-    y: number;
-}
+//# sourceMappingURL=timeSeries.d.ts.map

package/dist/app/charts/series/timeSeries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeries.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,UAAU,EAAa,MAAM,cAAc,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,KAAK;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,KAAG,KAA8B,CAAA;AAEpF;;GAEG;AACH,eAAO,MAAM,UAAU,QAAO,KAA2B,CAAA;AAEzD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;AAG1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,EAAE,OAAM,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,KAAG,UAC/B,CAAA"}

package/dist/app/charts/series/timeSeries.js

@@ -5,13 +5,16 @@ import { seriesFrom } from "./baseSeries";
  * @param value The value
  * @return A {@link Datum} instance with the specified (time, value)
  */
-export const datumOf = (time, value) => ({ time, value });
-export const emptyDatum = () => ({ time: NaN, value: NaN });
+export const datumOf = (time, value) => ({ x: time, y: value });
+/**
+ * @return An empty datum (its x and y are `NaN`)
+ */
+export const emptyDatum = () => ({ x: NaN, y: NaN });
 /**
  * Creates a series from the name and the optional array of (x, y) pairs (tuples)
  * @param name The name of the series
  * @param data The optional array of (x, y) pairs (tuples)
- * @return A `Series` for object that can be used by the `RasterChart`
+ * @return A {@link TimeSeries} that can be used by, e.g., the `ScatterPlot` and the `RasterPlot`
  * @see seriesFrom
  * @see emptySeries
  */

package/dist/app/charts/series/timeSeries.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeSeries.js","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,UAAU,EAAC,MAAM,cAAc,CAAC;AAUpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,KAAa,EAAS,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,KAAK,EAAC,CAAC,CAAA;AAE9E,MAAM,CAAC,MAAM,UAAU,GAAG,GAAU,EAAE,CAAC,CAAC,EAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAC,CAAC,CAAA;AAKhE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAgC,EAAE,EAAc,EAAE,CACjG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"timeSeries.js","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,UAAU,EAAC,MAAM,cAAc,CAAC;AAWzD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,KAAa,EAAS,EAAE,CAAC,CAAC,EAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAC,CAAC,CAAA;AAEpF;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAU,EAAE,CAAC,CAAC,EAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAC,CAAC,CAAA;AAQzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,IAAY,EAAE,OAAgC,EAAE,EAAc,EAAE,CACjG,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/app/charts/series/timeSeriesChartData.d.ts

@@ -1,7 +1,8 @@
-import { Datum, TimeSeries } from "./timeSeries";
-import { ChartData } from "../observables/ChartData";
+import type { Datum, TimeSeries } from "./timeSeries";
+import { type ChartData } from "../observables/ChartData";
 /**
- * The spike-chart data produced by the rxjs observable that is pushed to a streaming chart
+ * The time-series chart data produced by the rxjs observable that is pushed to a streaming chart
+ * (e.g. the scatter and raster charts): each chunk's new points, and the latest times
  */
 export interface TimeSeriesChartData extends ChartData {
     /**
@@ -23,15 +24,22 @@ export interface TimeSeriesChartData extends ChartData {
     currentTime?: number;
 }
 /**
- * Creates an empty chart data object with all the values set to 0
- * @param {Array<string>} series The list of series names (identifiers) to update
- * @return {TimeSeriesChartData} An empty chart data object
+ * Creates a chart data object for the specified series whose times are all 0, and whose new
+ * points are a single (0, 0) point for each series
+ * @param series The list of series names (identifiers) to update
+ * @return The chart data object
  */
 export declare function emptyTimeSeriesChartData(series: Array<string>): TimeSeriesChartData;
 /**
- * Creates an empty chart data object with all the values set to 0
- * @param seriesList The list of series names (identifiers) to update
+ * Creates the chart data object to start a stream from, for the specified series: its new points
+ * are each series' last datum (or (0, 0), for an empty series), each series' max time is the
+ * time of its last datum (or 0), and the max time is the latest of those (or `-Infinity`, when
+ * there are no series)
+ * @param seriesList The series
  * @param [currentTime=0] The current time
- * @return An empty chart data object
+ * @param [compactingSize=DEFAULT_COMPACTING_SIZE] The number of shifts each new-points array
+ * accumulates before it's compacted
+ * @return The chart data object
  */
-export declare function initialTimeSeriesChartData(seriesList: Array<TimeSeries>, currentTime?: number): TimeSeriesChartData;
+export declare function initialTimeSeriesChartData(seriesList: Array<TimeSeries>, currentTime?: number, compactingSize?: number): TimeSeriesChartData;
+//# sourceMappingURL=timeSeriesChartData.d.ts.map

package/dist/app/charts/series/timeSeriesChartData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeriesChartData.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeriesChartData.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAE,UAAU,EAAC,MAAM,cAAc,CAAC;AACpD,OAAO,EAAC,KAAK,SAAS,EAAmB,MAAM,0BAA0B,CAAC;AAI1E;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,SAAS;IAClD;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IAEf;;OAEG;IACH,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE7B;;;OAGG;IACH,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;IAEpC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACvB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,mBAAmB,CAQnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACtC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,EAC7B,WAAW,GAAE,MAAU,EACvB,cAAc,GAAE,MAAgC,GACjD,mBAAmB,CAkBrB"}

package/dist/app/charts/series/timeSeriesChartData.js

@@ -1,30 +1,44 @@
 import { defaultChartData } from "../observables/ChartData";
+import { FastShiftArray } from "fast-shift-array";
+import { DEFAULT_COMPACTING_SIZE } from "./baseSeries";
 /**
- * Creates an empty chart data object with all the values set to 0
- * @param {Array<string>} series The list of series names (identifiers) to update
- * @return {TimeSeriesChartData} An empty chart data object
+ * Creates a chart data object for the specified series whose times are all 0, and whose new
+ * points are a single (0, 0) point for each series
+ * @param series The list of series names (identifiers) to update
+ * @return The chart data object
  */
 export function emptyTimeSeriesChartData(series) {
-    return Object.assign(Object.assign({}, defaultChartData()), { maxTime: 0, maxTimes: new Map(series.map(name => [name, 0])), newPoints: new Map(series.map(name => [name, [{ time: 0, value: 0 }]])) });
+    return {
+        ...defaultChartData(),
+        seriesNames: new Set(series),
+        maxTime: 0,
+        maxTimes: new Map(series.map(name => [name, 0])),
+        newPoints: new Map(series.map(name => [name, [{ x: 0, y: 0 }]]))
+    };
 }
 /**
- * Creates an empty chart data object with all the values set to 0
- * @param seriesList The list of series names (identifiers) to update
+ * Creates the chart data object to start a stream from, for the specified series: its new points
+ * are each series' last datum (or (0, 0), for an empty series), each series' max time is the
+ * time of its last datum (or 0), and the max time is the latest of those (or `-Infinity`, when
+ * there are no series)
+ * @param seriesList The series
  * @param [currentTime=0] The current time
- * @return An empty chart data object
+ * @param [compactingSize=DEFAULT_COMPACTING_SIZE] The number of shifts each new-points array
+ * accumulates before it's compacted
+ * @return The chart data object
  */
-export function initialTimeSeriesChartData(seriesList, currentTime = 0) {
-    const maxTime = seriesList.reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.time).getOrElse(-Infinity)), -Infinity);
+export function initialTimeSeriesChartData(seriesList, currentTime = 0, compactingSize = DEFAULT_COMPACTING_SIZE) {
+    const maxTime = seriesList.reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.x).getOrElse(-Infinity)), -Infinity);
     return {
         seriesNames: new Set(seriesList.map(series => series.name)),
         maxTime,
-        maxTimes: new Map(seriesList.map(series => [series.name, series.last().map(datum => datum.time).getOrElse(0)])),
+        maxTimes: new Map(seriesList.map(series => [series.name, series.last().map(datum => datum.x).getOrElse(0)])),
         newPoints: new Map(seriesList.map(series => [
             series.name,
-            [{
-                    time: series.last().map(datum => datum.time).getOrElse(0),
-                    value: series.last().map(datum => datum.value).getOrElse(0)
-                }]
+            FastShiftArray.fromArray([{
+                    x: series.last().map(datum => datum.x).getOrElse(0),
+                    y: series.last().map(datum => datum.y).getOrElse(0)
+                }], true, compactingSize)
         ])),
         currentTime: currentTime
     };

package/dist/app/charts/series/timeSeriesChartData.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeSeriesChartData.js","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeriesChartData.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AA4BrE;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC1D,uCACO,gBAAgB,EAAE,KACrB,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAChD,SAAS,EAAE,IAAI,GAAG,CAAuB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC,IAC9F;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAA6B,EAAE,cAAsB,CAAC;IAC7F,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7F,CAAC,QAAQ,CACZ,CAAA;IACD,OAAO;QACH,WAAW,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO;QACP,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/G,SAAS,EAAE,IAAI,GAAG,CAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI;YACX,CAAC;oBACG,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;oBACzD,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;iBAC9D,CAAC;SACL,CAAC,CAAC;QACH,WAAW,EAAE,WAAW;KAC3B,CAAA;AACL,CAAC"}
+{"version":3,"file":"timeSeriesChartData.js","sourceRoot":"","sources":["../../../../src/app/charts/series/timeSeriesChartData.ts"],"names":[],"mappings":"AACA,OAAO,EAAiB,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1E,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAC,uBAAuB,EAAC,MAAM,cAAc,CAAC;AA6BrD;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAqB;IAC1D,OAAO;QACH,GAAG,gBAAgB,EAAE;QACrB,WAAW,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC;QAC5B,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,SAAS,EAAE,IAAI,GAAG,CAAuB,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,EAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAC,CAAC,CAAC,CAAC,CAAC;KACvF,CAAA;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,0BAA0B,CACtC,UAA6B,EAC7B,cAAsB,CAAC,EACvB,iBAAyB,uBAAuB;IAEhD,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC7B,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC1F,CAAC,QAAQ,CACZ,CAAA;IACD,OAAO;QACH,WAAW,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3D,OAAO;QACP,QAAQ,EAAE,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5G,SAAS,EAAE,IAAI,GAAG,CAAuB,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI;YACX,cAAc,CAAC,SAAS,CAAC,CAAC;oBACtB,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;oBACnD,CAAC,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;iBACtD,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC;SAC5B,CAAC,CAAC;QACH,WAAW,EAAE,WAAW;KAC3B,CAAA;AACL,CAAC"}

package/dist/app/charts/styling/barPlotStyle.d.ts

@@ -1,5 +1,8 @@
-import { SeriesStyle } from "../axes/axes";
-import { SvgFillStyle, SvgStrokeStyle } from "./svgStyle";
+import type { SeriesStyle } from "../axes/axes";
+import type { SvgFillStyle, SvgStrokeStyle } from "./svgStyle";
+/**
+ * The style of a bar series: the style of each of its bars and lines
+ */
 export interface BarSeriesStyle extends SeriesStyle {
     /**
      * The bar style for the lifetime min/max range bar. The style is for the width, fill,
@@ -24,18 +27,59 @@ export interface BarSeriesStyle extends SeriesStyle {
      */
     windowedMeanValueLine: LineStyle;
 }
+/**
+ * The style of a bar: its width (as a fraction of the category's width), its fill, and its stroke
+ */
 export interface BarStyle {
     widthFraction: number;
     fill: SvgFillStyle;
     stroke: SvgStrokeStyle;
 }
+/**
+ * The style of a line: normally, and when highlighted
+ */
 export interface LineStyle {
     regular: SvgStrokeStyle;
     highlight: SvgStrokeStyle;
 }
+/**
+ * The default style for the lifetime min/max bar: 65% of the category's width, a translucent fill,
+ * and a thin stroke
+ * @param [color="#008aad"] The bar's fill and stroke color
+ * @return The bar style
+ */
 export declare function defaultMinMaxBarStyle(color?: string): BarStyle;
+/**
+ * The default style for the windowed min/max bar: 25% of the category's width (narrower than the
+ * lifetime bar, so both can be seen), filled with a slightly darker color, and no stroke
+ * @param [color="#008aad"] The color to darken for the bar's fill (used as-is when it can't be parsed)
+ * @return The bar style
+ */
 export declare function defaultWindowedMinMaxBarStyle(color?: string): BarStyle;
+/**
+ * The default style for the current-value line: 3 pixels wide (5 when highlighted)
+ * @param [color="#008aad"] The line's color
+ * @return The line style
+ */
 export declare function defaultValueLineStyle(color?: string): LineStyle;
+/**
+ * The default style for the (lifetime) mean-value line: 1 pixel wide (3 when highlighted)
+ * @param [color="#008aad"] The line's color
+ * @return The line style
+ */
 export declare function defaultMeanValueLineStyle(color?: string): LineStyle;
+/**
+ * The default style for the windowed mean-value line: 1 pixel wide (3 when highlighted), and red
+ * by default to set it apart from the other lines
+ * @param [color="#ad0000"] The line's color
+ * @return The line style
+ */
 export declare function defaultWindowedMeanValueLineStyle(color?: string): LineStyle;
+/**
+ * The default style for a bar series: all the bars and lines in the specified color (see the
+ * default styles above), except for the windowed min/max bar's darker fill
+ * @param [color="#008aad"] The series' color
+ * @return The bar series style
+ */
 export declare function defaultBarSeriesStyle(color?: string): BarSeriesStyle;
+//# sourceMappingURL=barPlotStyle.d.ts.map

package/dist/app/charts/styling/barPlotStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"barPlotStyle.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/styling/barPlotStyle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,YAAY,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,WAAW;IAC/C;;;OAGG;IACH,SAAS,EAAE,QAAQ,CAAA;IACnB;;;OAGG;IACH,iBAAiB,EAAE,QAAQ,CAAA;IAC3B;;OAEG;IACH,SAAS,EAAE,SAAS,CAAA;IACpB;;OAEG;IACH,aAAa,EAAE,SAAS,CAAA;IACxB;;OAEG;IACH,qBAAqB,EAAE,SAAS,CAAA;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,aAAa,EAAE,MAAM,CAAA;IACrB,IAAI,EAAE,YAAY,CAAA;IAClB,MAAM,EAAE,cAAc,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACtB,OAAO,EAAE,cAAc,CAAA;IACvB,SAAS,EAAE,cAAc,CAAA;CAC5B;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAkB,GAAG,QAAQ,CAazE;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,GAAE,MAAkB,GAAG,QAAQ,CAajF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAkB,GAAG,SAAS,CAa1E;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,GAAE,MAAkB,GAAG,SAAS,CAa9E;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,KAAK,GAAE,MAAkB,GAAG,SAAS,CAatF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,GAAE,MAAkB,GAAG,cAAc,CAU/E"}

package/dist/app/charts/styling/barPlotStyle.js

@@ -1,4 +1,10 @@
 import * as d3 from "d3";
+/**
+ * The default style for the lifetime min/max bar: 65% of the category's width, a translucent fill,
+ * and a thin stroke
+ * @param [color="#008aad"] The bar's fill and stroke color
+ * @return The bar style
+ */
 export function defaultMinMaxBarStyle(color = "#008aad") {
     return {
         widthFraction: 0.65,
@@ -13,6 +19,12 @@ export function defaultMinMaxBarStyle(color = "#008aad") {
         }
     };
 }
+/**
+ * The default style for the windowed min/max bar: 25% of the category's width (narrower than the
+ * lifetime bar, so both can be seen), filled with a slightly darker color, and no stroke
+ * @param [color="#008aad"] The color to darken for the bar's fill (used as-is when it can't be parsed)
+ * @return The bar style
+ */
 export function defaultWindowedMinMaxBarStyle(color = "#008aad") {
     var _a, _b, _c, _d;
     return {
@@ -28,6 +40,11 @@ export function defaultWindowedMinMaxBarStyle(color = "#008aad") {
         }
     };
 }
+/**
+ * The default style for the current-value line: 3 pixels wide (5 when highlighted)
+ * @param [color="#008aad"] The line's color
+ * @return The line style
+ */
 export function defaultValueLineStyle(color = "#008aad") {
     return {
         regular: {
@@ -42,6 +59,11 @@ export function defaultValueLineStyle(color = "#008aad") {
         }
     };
 }
+/**
+ * The default style for the (lifetime) mean-value line: 1 pixel wide (3 when highlighted)
+ * @param [color="#008aad"] The line's color
+ * @return The line style
+ */
 export function defaultMeanValueLineStyle(color = "#008aad") {
     return {
         regular: {
@@ -56,20 +78,32 @@ export function defaultMeanValueLineStyle(color = "#008aad") {
         }
     };
 }
-export function defaultWindowedMeanValueLineStyle(color = "#008aad") {
+/**
+ * The default style for the windowed mean-value line: 1 pixel wide (3 when highlighted), and red
+ * by default to set it apart from the other lines
+ * @param [color="#ad0000"] The line's color
+ * @return The line style
+ */
+export function defaultWindowedMeanValueLineStyle(color = "#ad0000") {
     return {
         regular: {
-            color: 'red',
+            color: color,
             opacity: 0.6,
             width: 1
         },
         highlight: {
-            color: 'red',
+            color: color,
             opacity: 1,
             width: 3
         }
     };
 }
+/**
+ * The default style for a bar series: all the bars and lines in the specified color (see the
+ * default styles above), except for the windowed min/max bar's darker fill
+ * @param [color="#008aad"] The series' color
+ * @return The bar series style
+ */
 export function defaultBarSeriesStyle(color = "#008aad") {
     return {
         color,

package/dist/app/charts/styling/barPlotStyle.js.map

@@ -1 +1 @@
-{"version":3,"file":"barPlotStyle.js","sourceRoot":"","sources":["../../../../src/app/charts/styling/barPlotStyle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAsCzB,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK;YACL,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,GAAG;YACZ,KAAK;SACR;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB,SAAS;;IACnE,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;YACvD,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;SAC1D;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAgB,SAAS;IAC/D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,QAAgB,SAAS;IACvE,OAAO;QACH,OAAO,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,KAAK;QACL,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,iBAAiB,EAAE,6BAA6B,CAAC,KAAK,CAAC;QACvD,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,aAAa,EAAE,yBAAyB,CAAC,KAAK,CAAC;QAC/C,qBAAqB,EAAE,iCAAiC,CAAC,KAAK,CAAC;KAClE,CAAA;AACL,CAAC"}
+{"version":3,"file":"barPlotStyle.js","sourceRoot":"","sources":["../../../../src/app/charts/styling/barPlotStyle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AA+CzB;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK;YACL,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,GAAG;YACZ,KAAK;SACR;KACJ,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAgB,SAAS;;IACnE,OAAO;QACH,aAAa,EAAE,IAAI;QACnB,IAAI,EAAE;YACF,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;YACvD,OAAO,EAAE,GAAG;SACf;QACD,MAAM,EAAE;YACJ,KAAK,EAAE,CAAC;YACR,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,MAAA,MAAA,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,0CAAE,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,mCAAI,KAAK;SAC1D;KACJ,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,SAAS;IAC/D,OAAO;QACH,OAAO,EAAE;YACL,KAAK;YACL,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK;YACL,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,QAAgB,SAAS;IACvE,OAAO;QACH,OAAO,EAAE;YACL,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,GAAG;YACZ,KAAK,EAAE,CAAC;SACX;QACD,SAAS,EAAE;YACP,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,CAAC;YACV,KAAK,EAAE,CAAC;SACX;KACJ,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB,SAAS;IAC3D,OAAO;QACH,KAAK;QACL,cAAc,EAAE,KAAK;QACrB,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,iBAAiB,EAAE,6BAA6B,CAAC,KAAK,CAAC;QACvD,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC;QACvC,aAAa,EAAE,yBAAyB,CAAC,KAAK,CAAC;QAC/C,qBAAqB,EAAE,iCAAiC,CAAC,KAAK,CAAC;KAClE,CAAA;AACL,CAAC"}

package/dist/app/charts/styling/canvasStyle.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The style of a stroke (a line, or a shape's outline)
+ */
+export interface CanvasStrokeStyle {
+    readonly color: string;
+    readonly width: number;
+    readonly opacity: number;
+}
+/**
+ * Applies a stroke style to the canvas context. Call this immediately before `ctx.stroke()` --
+ * unlike the old SVG version, the effect is not persistent.
+ * @param context The canvas 2D context to apply the style to
+ * @param style The (partial) stroke style to apply; unset fields are left untouched on `ctx`
+ * @return `ctx`, for chaining
+ */
+export declare function applyStrokeStyle(context: CanvasRenderingContext2D, style: Partial<CanvasStrokeStyle>): CanvasRenderingContext2D;
+/**
+ * The style of a (shape's) fill
+ */
+export interface CanvasFillStyle {
+    readonly color: string;
+    readonly opacity: number;
+}
+/**
+ * Applies a fill style to the canvas context. Call this immediately before `ctx.fill()`/
+ * `ctx.fillText()`/`ctx.fillRect()` -- unlike the old SVG version, the effect is not persistent.
+ * @param context The canvas 2D context to apply the style to
+ * @param style The (partial) fill style to apply; unset fields are left untouched on `ctx`
+ * @return `ctx`, for chaining
+ */
+export declare function applyFillStyle(context: CanvasRenderingContext2D, style: Partial<CanvasFillStyle>): CanvasRenderingContext2D;
+/**
+ * Bakes an opacity into a color string by resolving it to `rgba(...)`. Needed because canvas has
+ * a single `globalAlpha` shared between stroke and fill (see the module-level note above); when a
+ * shape needs independent stroke and fill opacity, use this to bake opacity into the color passed
+ * to `applyStrokeStyle`/`applyFillStyle` instead of setting `opacity` on both.
+ *
+ * Uses `d3.color(...)` (already the project's convention for this elsewhere -- see `Legend.tsx`,
+ * `barPlotStyle.ts`) rather than the previous approach of assigning `color` to a single
+ * module-level, lazily-created `<canvas>` context's `fillStyle` and reading back the browser's
+ * normalized value: assigning an unparseable CSS string to `fillStyle` is a silent no-op per the
+ * Canvas 2D spec, so an invalid `color` would have silently resolved to whatever the *previous,
+ * unrelated* `withAlpha` call (from any chart/tooltip/legend on the page, since the context was a
+ * single shared singleton) happened to leave `fillStyle` at -- order-dependent and effectively
+ * nondeterministic. `d3.color` instead returns `null` for unparseable input, so an invalid color
+ * falls through to the same "fall back to the original string" behavior this always had for the
+ * "no canvas 2d support" case, deterministically, with no shared state at all.
+ * @param color Any valid CSS color string (named, hex, rgb, rgba, hsl, etc)
+ * @param opacity The opacity to bake in, from 0 (transparent) to 1 (opaque)
+ * @return An `rgba(...)` string equivalent to `color` at the given `opacity`
+ */
+export declare function withAlpha(color: string, opacity: number): string;
+//# sourceMappingURL=canvasStyle.d.ts.map

package/dist/app/charts/styling/canvasStyle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasStyle.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/styling/canvasStyle.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,wBAAwB,CAK/H;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,wBAAwB,CAI3H;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAQhE"}

package/dist/app/charts/styling/canvasStyle.js

@@ -0,0 +1,71 @@
+// Canvas equivalents of the stroke/fill helpers that used to live in svgStyle.ts. The old versions
+// mutated a *persistent* SVG element's CSS style (`selection.style('stroke', ...)`), so it stuck
+// around until changed again. Canvas has no persistent elements -- `ctx.strokeStyle`/`ctx.fillStyle`
+// /`ctx.lineWidth` are transient 2D-context state that only affects the *next* stroke()/fill() call,
+// so these must be (re-)applied immediately before every draw, every frame.
+//
+// IMPORTANT DIFFERENCE FROM SVG: canvas has a single `ctx.globalAlpha` shared between stroke and
+// fill, unlike SVG's independent `stroke-opacity`/`fill-opacity`. If a shape needs different
+// stroke and fill opacity in the same draw call, bake the opacity into the color string with
+// `withAlpha(...)` instead of relying on `globalAlpha` for one of them.
+import * as d3 from "d3";
+/**
+ * Applies a stroke style to the canvas context. Call this immediately before `ctx.stroke()` --
+ * unlike the old SVG version, the effect is not persistent.
+ * @param context The canvas 2D context to apply the style to
+ * @param style The (partial) stroke style to apply; unset fields are left untouched on `ctx`
+ * @return `ctx`, for chaining
+ */
+export function applyStrokeStyle(context, style) {
+    if (style.color !== undefined)
+        context.strokeStyle = style.color;
+    if (style.width !== undefined)
+        context.lineWidth = style.width;
+    if (style.opacity !== undefined)
+        context.globalAlpha = style.opacity;
+    return context;
+}
+/**
+ * Applies a fill style to the canvas context. Call this immediately before `ctx.fill()`/
+ * `ctx.fillText()`/`ctx.fillRect()` -- unlike the old SVG version, the effect is not persistent.
+ * @param context The canvas 2D context to apply the style to
+ * @param style The (partial) fill style to apply; unset fields are left untouched on `ctx`
+ * @return `ctx`, for chaining
+ */
+export function applyFillStyle(context, style) {
+    if (style.color !== undefined)
+        context.fillStyle = style.color;
+    if (style.opacity !== undefined)
+        context.globalAlpha = style.opacity;
+    return context;
+}
+/**
+ * Bakes an opacity into a color string by resolving it to `rgba(...)`. Needed because canvas has
+ * a single `globalAlpha` shared between stroke and fill (see the module-level note above); when a
+ * shape needs independent stroke and fill opacity, use this to bake opacity into the color passed
+ * to `applyStrokeStyle`/`applyFillStyle` instead of setting `opacity` on both.
+ *
+ * Uses `d3.color(...)` (already the project's convention for this elsewhere -- see `Legend.tsx`,
+ * `barPlotStyle.ts`) rather than the previous approach of assigning `color` to a single
+ * module-level, lazily-created `<canvas>` context's `fillStyle` and reading back the browser's
+ * normalized value: assigning an unparseable CSS string to `fillStyle` is a silent no-op per the
+ * Canvas 2D spec, so an invalid `color` would have silently resolved to whatever the *previous,
+ * unrelated* `withAlpha` call (from any chart/tooltip/legend on the page, since the context was a
+ * single shared singleton) happened to leave `fillStyle` at -- order-dependent and effectively
+ * nondeterministic. `d3.color` instead returns `null` for unparseable input, so an invalid color
+ * falls through to the same "fall back to the original string" behavior this always had for the
+ * "no canvas 2d support" case, deterministically, with no shared state at all.
+ * @param color Any valid CSS color string (named, hex, rgb, rgba, hsl, etc)
+ * @param opacity The opacity to bake in, from 0 (transparent) to 1 (opaque)
+ * @return An `rgba(...)` string equivalent to `color` at the given `opacity`
+ */
+export function withAlpha(color, opacity) {
+    const parsed = d3.color(color);
+    if (parsed === null) {
+        // unparseable color string; nothing sensible to bake an opacity into
+        return color;
+    }
+    const { r, g, b } = parsed.rgb();
+    return `rgba(${r}, ${g}, ${b}, ${opacity})`;
+}
+//# sourceMappingURL=canvasStyle.js.map

package/dist/app/charts/styling/canvasStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasStyle.js","sourceRoot":"","sources":["../../../../src/app/charts/styling/canvasStyle.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,iGAAiG;AACjG,qGAAqG;AACrG,qGAAqG;AACrG,4EAA4E;AAC5E,EAAE;AACF,iGAAiG;AACjG,6FAA6F;AAC7F,6FAA6F;AAC7F,wEAAwE;AAExE,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AAWxB;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAiC,EAAE,KAAiC;IACjG,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,KAAK,CAAA;IAChE,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAA;IAC9D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAA;IACpE,OAAO,OAAO,CAAA;AAClB,CAAC;AAUD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAiC,EAAE,KAA+B;IAC7F,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAA;IAC9D,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC,OAAO,CAAA;IACpE,OAAO,OAAO,CAAA;AAClB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,OAAe;IACpD,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAC9B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,qEAAqE;QACrE,OAAO,KAAK,CAAA;IAChB,CAAC;IACD,MAAM,EAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAC,GAAG,MAAM,CAAC,GAAG,EAAE,CAAA;IAC9B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,OAAO,GAAG,CAAA;AAC/C,CAAC"}

package/dist/app/charts/styling/margins.d.ts

@@ -7,14 +7,20 @@ export interface Margin {
     bottom: number;
     left: number;
 }
+/**
+ * @return Margins of 0 on every side
+ */
 export declare function noMargins(): Margin;
+/**
+ * A width and height (in pixels)
+ */
 export interface Dimensions {
     readonly width: number;
     readonly height: number;
 }
 /**
- * Given the dimensions of the plot (width, height) based on the container's width and height,
- * and the plot's margins. Calculates the dimensions of the actual plot by subtracting the margins.
+ * Calculates the dimensions of the actual plot from the container's width and height, and the
+ * plot's margins, by subtracting the margins (never less than 0).
  * @param containerWidth The overall width of the container (plot and margins)
  * @param containerHeight The overall height of the container (plot and margins)
  * @param plotMargins The margins around the plot (top, bottom, left, right)
@@ -32,5 +38,18 @@ export declare function plotDimensionsFrom(containerWidth: number, containerHeig
  * @see plotDimensionsFrom
  */
 export declare function containerDimensionsFrom(plotDimensions: Dimensions, plotMargin: Margin): Dimensions;
+/**
+ * Whether two dimensions have the same width and height
+ * @param dimension1 The first dimensions
+ * @param dimension2 The second dimensions
+ * @return `true` when the widths and heights are equal; `false` otherwise
+ */
 export declare function dimensionsEqual(dimension1: Dimensions, dimension2: Dimensions): boolean;
+/**
+ * Whether two dimensions differ in width or height (the negation of {@link dimensionsEqual})
+ * @param dimension1 The first dimensions
+ * @param dimension2 The second dimensions
+ * @return `true` when the widths or heights differ; `false` otherwise
+ */
 export declare function dimensionsNotEqual(dimension1: Dimensions, dimension2: Dimensions): boolean;
+//# sourceMappingURL=margins.d.ts.map

package/dist/app/charts/styling/margins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"margins.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/styling/margins.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CAWnH;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,UAAU,CAKlG;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,WAE7E;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,WAEhF"}

package/dist/app/charts/styling/margins.js

@@ -1,9 +1,12 @@
+/**
+ * @return Margins of 0 on every side
+ */
 export function noMargins() {
     return { top: 0, bottom: 0, left: 0, right: 0 };
 }
 /**
- * Given the dimensions of the plot (width, height) based on the container's width and height,
- * and the plot's margins. Calculates the dimensions of the actual plot by subtracting the margins.
+ * Calculates the dimensions of the actual plot from the container's width and height, and the
+ * plot's margins, by subtracting the margins (never less than 0).
  * @param containerWidth The overall width of the container (plot and margins)
  * @param containerHeight The overall height of the container (plot and margins)
  * @param plotMargins The margins around the plot (top, bottom, left, right)
@@ -12,9 +15,15 @@ export function noMargins() {
  * @see containerDimensionsFrom
  */
 export function plotDimensionsFrom(containerWidth, containerHeight, plotMargins) {
+    // floor at zero -- margins larger than the container would otherwise produce negative
+    // width/height, which propagates into D3 scale ranges, tracker/tooltip clamping math, and
+    // canvas draw coordinates as silent garbage. Mirrors the same Math.max(0, ...) convention
+    // already used defensively at some (but not all) points of use, e.g. plot.ts's
+    // resizeCanvasTo/clipToArea -- clamping here makes Dimensions a non-negative invariant for
+    // every downstream consumer instead of relying on each one to remember to clamp itself.
     return {
-        width: containerWidth - plotMargins.left - plotMargins.right,
-        height: containerHeight - plotMargins.top - plotMargins.bottom
+        width: Math.max(0, containerWidth - plotMargins.left - plotMargins.right),
+        height: Math.max(0, containerHeight - plotMargins.top - plotMargins.bottom)
     };
 }
 /**
@@ -31,9 +40,21 @@ export function containerDimensionsFrom(plotDimensions, plotMargin) {
         height: plotDimensions.height + plotMargin.top + plotMargin.bottom
     };
 }
+/**
+ * Whether two dimensions have the same width and height
+ * @param dimension1 The first dimensions
+ * @param dimension2 The second dimensions
+ * @return `true` when the widths and heights are equal; `false` otherwise
+ */
 export function dimensionsEqual(dimension1, dimension2) {
     return dimension1.height === dimension2.height && dimension1.width === dimension2.width;
 }
+/**
+ * Whether two dimensions differ in width or height (the negation of {@link dimensionsEqual})
+ * @param dimension1 The first dimensions
+ * @param dimension2 The second dimensions
+ * @return `true` when the widths or heights differ; `false` otherwise
+ */
 export function dimensionsNotEqual(dimension1, dimension2) {
     return !dimensionsEqual(dimension1, dimension2);
 }

package/dist/app/charts/styling/margins.js.map

@@ -1 +1 @@
-{"version":3,"file":"margins.js","sourceRoot":"","sources":["../../../../src/app/charts/styling/margins.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,SAAS;IACrB,OAAO,EAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAA;AACjD,CAAC;AAOD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAAsB,EAAE,eAAuB,EAAE,WAAmB;IACnG,OAAO;QACH,KAAK,EAAE,cAAc,GAAG,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK;QAC5D,MAAM,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,MAAM;KACjE,CAAA;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAA0B,EAAE,UAAkB;IAClF,OAAO;QACH,KAAK,EAAE,cAAc,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK;QAChE,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM;KACrE,CAAA;AACL,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAsB,EAAE,UAAsB;IAC1E,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,CAAA;AAC3F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAAsB,EAAE,UAAsB;IAC7E,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AACnD,CAAC"}
+{"version":3,"file":"margins.js","sourceRoot":"","sources":["../../../../src/app/charts/styling/margins.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,MAAM,UAAU,SAAS;IACrB,OAAO,EAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAC,CAAA;AACjD,CAAC;AAUD;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,cAAsB,EAAE,eAAuB,EAAE,WAAmB;IACnG,sFAAsF;IACtF,0FAA0F;IAC1F,0FAA0F;IAC1F,+EAA+E;IAC/E,2FAA2F;IAC3F,wFAAwF;IACxF,OAAO;QACH,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,cAAc,GAAG,WAAW,CAAC,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC;QACzE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,GAAG,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC;KAC9E,CAAA;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,cAA0B,EAAE,UAAkB;IAClF,OAAO;QACH,KAAK,EAAE,cAAc,CAAC,KAAK,GAAG,UAAU,CAAC,IAAI,GAAG,UAAU,CAAC,KAAK;QAChE,MAAM,EAAE,cAAc,CAAC,MAAM,GAAG,UAAU,CAAC,GAAG,GAAG,UAAU,CAAC,MAAM;KACrE,CAAA;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAsB,EAAE,UAAsB;IAC1E,OAAO,UAAU,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,KAAK,KAAK,UAAU,CAAC,KAAK,CAAA;AAC3F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAsB,EAAE,UAAsB;IAC7E,OAAO,CAAC,eAAe,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AACnD,CAAC"}