stream-charts 1.2.0 → 2.0.0

package/dist/app/charts/datasources/iteratesDataSource.js

@@ -0,0 +1,87 @@
+import { emptySeries } from "../series/baseSeries";
+import { BaseStreamingDataSource } from "./StreamingDataSource";
+/**
+ * Calculates the current time for a chunk of iterate chart data: the max over the series of the
+ * time of each series' last new point (or 0 when there are no new points). Shared by the data
+ * source (for dropping old data) and the Poincaré plot's view driver (for reporting the current
+ * time), so both agree on what "now" is.
+ * @param data The iterate chart data
+ * @return The current time
+ */
+export function iteratesCurrentTime(data) {
+    return Array.from(data.newPoints.values()).reduce((maxTime, points) => {
+        const seriesMaxTime = points.length > 0 ? points[points.length - 1].time : 0;
+        return seriesMaxTime > maxTime ? seriesMaxTime : maxTime;
+    }, 0);
+}
+/**
+ * A data source for iterate charts (e.g. the Poincaré plot)
+ */
+export class IteratesDataSource extends BaseStreamingDataSource {
+    /**
+     * Creates a iterates data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options) {
+        var _a;
+        super(options.initialData, options.generator);
+        // the number of points dropped from each series so far (see `droppedCountFor`)
+        this.droppedCounts = new Map();
+        this.dropDataAfter = (_a = options.dropDataAfter) !== null && _a !== void 0 ? _a : Infinity;
+        this.onUpdateData = options.onUpdateData;
+    }
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter) {
+        this.dropDataAfter = dropDataAfter;
+    }
+    /**
+     * @return The latest time (the `time` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    /**
+     * The number of points dropped (as too old) from the front of the specified series so far --
+     * so that a point's overall sequence number in its series is this plus its index in the
+     * series' data, even as old points are dropped (e.g. for colorizing the lines by point, see
+     * the `PoincarePlot`'s `lineColorSteps`)
+     * @param seriesName The name of the series
+     * @return The number of points dropped from the series (0 for an unknown series)
+     */
+    droppedCountFor(seriesName) {
+        var _a;
+        return (_a = this.droppedCounts.get(seriesName)) !== null && _a !== void 0 ? _a : 0;
+    }
+    latestTime() {
+        return this.seriesList().reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.time).getOrElse(tMax)), -Infinity);
+    }
+    /**
+     * Adds each series' new points to it, and drops the points that are older than
+     * `dropDataAfter` relative to the chunk's current time (see `iteratesCurrentTime`),
+     * counting them (see {@link droppedCountFor}). New points for a series that isn't in the
+     * source are ignored. Calls `onUpdateData` with each
+     * series' new points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    ingest(data) {
+        const currentTime = iteratesCurrentTime(data);
+        data.newPoints.forEach((newData, seriesName) => {
+            // note: as in the original subscription code, data for a series that isn't already in
+            // the source is accepted but not kept
+            const series = this.seriesMap.get(seriesName) || emptySeries(seriesName);
+            if (this.onUpdateData)
+                this.onUpdateData(seriesName, newData);
+            series.data.push(...newData);
+            // drop data that is older than the max time-window -- guarded on series.data.length
+            let dropped = 0;
+            while (series.data.length > 0 && currentTime - series.data[0].time > this.dropDataAfter) {
+                series.data.shift();
+                dropped++;
+            }
+            if (dropped > 0)
+                this.droppedCounts.set(seriesName, this.droppedCountFor(seriesName) + dropped);
+        });
+    }
+}
+//# sourceMappingURL=iteratesDataSource.js.map

package/dist/app/charts/datasources/iteratesDataSource.js.map

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

package/dist/app/charts/datasources/ordinalDataSource.d.ts

@@ -0,0 +1,75 @@
+import type { BaseSeries } from "../series/baseSeries";
+import { type OrdinalDatum } from "../series/ordinalSeries";
+import { type OrdinalChartData, type OrdinalStats, type OrdinalValueStats } from "../observables/ordinals";
+import { BaseStreamingDataSource, type DataGenerator } from "./StreamingDataSource";
+export interface WindowedOrdinalStats extends OrdinalStats {
+    /**
+     * A map associating each series to stats about that series (e.g. map(series_name -> stats))
+     */
+    windowedValueStatsForSeries: Map<string, OrdinalValueStats>;
+}
+/**
+ * Calculates the ordinal stats for each of the ordinal series (generally, initial data) and
+ * returns a {@link WindowedOrdinalStats} object
+ * @param series The array of ordinal series
+ * @return A {@link WindowedOrdinalStats} object with the stats for each of the series
+ */
+export declare function initialOrdinalStats(series: Array<BaseSeries<OrdinalDatum>>): WindowedOrdinalStats;
+export interface OrdinalDataSourceOptions {
+    /**
+     * The initial series, owned (and mutated in place) by the source from here on
+     */
+    initialData: Array<BaseSeries<OrdinalDatum>>;
+    /**
+     * Creates the observable of chart data each time the source starts
+     */
+    generator: DataGenerator<OrdinalChartData, BaseSeries<OrdinalDatum>>;
+    /**
+     * Data older than this (ms), relative to the chart-wide current time, is dropped (and removed
+     * from the windowed stats) as new data arrives. Defaults to `Infinity` (never drop).
+     */
+    dropDataAfter?: number;
+    /**
+     * Called with each series' new data as it arrives
+     */
+    onUpdateData?: (seriesName: string, data: Array<OrdinalDatum>) => void;
+}
+/**
+ * A data source for ordinal charts (e.g. the bar plot). Besides the series, it keeps the lifetime
+ * stats (from the chart data) and the windowed stats (over the data currently held) for each
+ * series, so they keep accumulating while no plot is mounted.
+ */
+export declare class OrdinalDataSource extends BaseStreamingDataSource<OrdinalChartData, OrdinalDatum, BaseSeries<OrdinalDatum>> {
+    /**
+     * The lifetime and windowed stats, updated in place as data arrives
+     */
+    readonly stats: WindowedOrdinalStats;
+    private dropDataAfter;
+    private readonly onUpdateData;
+    /**
+     * Creates a ordinal data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options: OrdinalDataSourceOptions);
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter: number): void;
+    /**
+     * @return The latest time (the `time` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime(): number;
+    /**
+     * Adds each series' new points to it, copies the chunk's lifetime stats, updates the series'
+     * windowed stats for the new points, and then drops the points that are older than
+     * `dropDataAfter` relative to the chart-wide current time (the time of the latest datum over
+     * all series), removing them from the windowed stats too. New points for a series that isn't
+     * in the source are ignored (bar charts have a fixed set of categories). Calls `onUpdateData`
+     * with each series' new points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    protected ingest(data: OrdinalChartData): void;
+}
+//# sourceMappingURL=ordinalDataSource.d.ts.map

package/dist/app/charts/datasources/ordinalDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinalDataSource.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/datasources/ordinalDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAwB,KAAK,YAAY,EAAC,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAOH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,uBAAuB,EAAE,KAAK,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAElF,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACtD;;OAEG;IACH,2BAA2B,EAAE,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC9D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,GAAG,oBAAoB,CAMjG;AA8CD,MAAM,WAAW,wBAAwB;IACrC;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAA;IAC5C;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC,gBAAgB,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAA;IACpE;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,KAAK,IAAI,CAAA;CACzE;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,uBAAuB,CAAC,gBAAgB,EAAE,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACpH;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IAEpC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuE;IAEpG;;;OAGG;gBACS,OAAO,EAAE,wBAAwB;IAO7C;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACH,UAAU,IAAI,MAAM;IAOpB;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;CAkDjD"}

package/dist/app/charts/datasources/ordinalDataSource.js

@@ -0,0 +1,135 @@
+import { emptySeries } from "../series/baseSeries";
+import { calculateOrdinalStats } from "../series/ordinalSeries";
+import { copyOrdinalDatumExtremum, copyOrdinalValueStats, copyValueStatsForSeries, defaultOrdinalValueStats, initialMaxValueDatum, initialMinValueDatum } from "../observables/ordinals";
+import { BaseStreamingDataSource } from "./StreamingDataSource";
+/**
+ * Calculates the ordinal stats for each of the ordinal series (generally, initial data) and
+ * returns a {@link WindowedOrdinalStats} object
+ * @param series The array of ordinal series
+ * @return A {@link WindowedOrdinalStats} object with the stats for each of the series
+ */
+export function initialOrdinalStats(series) {
+    const ordinalStats = calculateOrdinalStats(series);
+    return {
+        ...ordinalStats,
+        windowedValueStatsForSeries: copyValueStatsForSeries(ordinalStats.valueStatsForSeries)
+    };
+}
+/**
+ * First of two functions to calculate the current ordinal stats for the current time window. This
+ * function updates the windowed stats for the new data.
+ * @param newData The new data for that series
+ * @param windowedStats The current windowed ordinal value stats
+ * @return The windowed ordinal value stats updated for the new data
+ */
+function updatedWindowedValueStatsForNewData(newData, windowedStats) {
+    const updatedStats = copyOrdinalValueStats(windowedStats);
+    updatedStats.count += newData.length;
+    const newSum = newData.reduce((total, datum) => total + datum.value, 0);
+    updatedStats.sum += newSum;
+    updatedStats.sumSquared += newSum * newSum;
+    updatedStats.mean = (updatedStats.count > 0) ? updatedStats.sum / updatedStats.count : NaN;
+    updatedStats.min = newData.reduce((min, datum) => datum.value < min.value ? datum : min, updatedStats.min);
+    updatedStats.max = newData.reduce((max, datum) => datum.value > max.value ? datum : max, updatedStats.max);
+    return updatedStats;
+}
+/**
+ * Second of two functions to calculate the current ordinal stats for the current time window. This
+ * function updates the windowed stats for the dropped data (the min and max are recalculated from
+ * the data that's left)
+ * @param droppedData An array of datum that was dropped from the time window
+ * @param windowedStats The current windowed ordinal value stats
+ * @param series An array of series holding all the current data in the time-window
+ * @return The windowed ordinal value stats updated for the dropped data
+ */
+function updateWindowedValueStatsForDroppedData(droppedData, windowedStats, series) {
+    const updatedStats = copyOrdinalValueStats(windowedStats);
+    updatedStats.count -= droppedData.length;
+    const droppedSum = droppedData.reduce((total, datum) => total + datum.value, 0);
+    updatedStats.sum -= droppedSum;
+    updatedStats.sumSquared -= droppedSum * droppedSum;
+    updatedStats.mean = (updatedStats.count > 0) ? updatedStats.sum / updatedStats.count : NaN;
+    updatedStats.min = series.data.reduce((min, datum) => datum.value < min.value ? datum : min, initialMinValueDatum());
+    updatedStats.max = series.data.reduce((max, datum) => datum.value > max.value ? datum : max, initialMaxValueDatum());
+    return updatedStats;
+}
+/**
+ * A data source for ordinal charts (e.g. the bar plot). Besides the series, it keeps the lifetime
+ * stats (from the chart data) and the windowed stats (over the data currently held) for each
+ * series, so they keep accumulating while no plot is mounted.
+ */
+export class OrdinalDataSource extends BaseStreamingDataSource {
+    /**
+     * Creates a ordinal data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options) {
+        var _a;
+        super(options.initialData, options.generator);
+        this.stats = initialOrdinalStats(options.initialData);
+        this.dropDataAfter = (_a = options.dropDataAfter) !== null && _a !== void 0 ? _a : Infinity;
+        this.onUpdateData = options.onUpdateData;
+    }
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter) {
+        this.dropDataAfter = dropDataAfter;
+    }
+    /**
+     * @return The latest time (the `time` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime() {
+        return this.seriesList().reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.time).getOrElse(tMax)), -Infinity);
+    }
+    /**
+     * Adds each series' new points to it, copies the chunk's lifetime stats, updates the series'
+     * windowed stats for the new points, and then drops the points that are older than
+     * `dropDataAfter` relative to the chart-wide current time (the time of the latest datum over
+     * all series), removing them from the windowed stats too. New points for a series that isn't
+     * in the source are ignored (bar charts have a fixed set of categories). Calls `onUpdateData`
+     * with each series' new points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    ingest(data) {
+        // the chart-wide current time (the time of the latest datum over all series). When it
+        // isn't a number, the drop comparison below is simply false, so nothing is dropped.
+        const currentTime = data.stats.maxDatum.time.time;
+        data.newPoints.forEach((newData, name) => {
+            // note: as in the original subscription code, data for a series that isn't already in
+            // the source is accepted but not kept (bar charts have a fixed set of categories)
+            const series = this.seriesMap.get(name) || emptySeries(name);
+            if (this.onUpdateData)
+                this.onUpdateData(name, newData);
+            series.data.push(...newData);
+            // grab the (lifetime) stats
+            this.stats.minDatum = copyOrdinalDatumExtremum(data.stats.minDatum);
+            this.stats.maxDatum = copyOrdinalDatumExtremum(data.stats.maxDatum);
+            this.stats.valueStatsForSeries = copyValueStatsForSeries(data.stats.valueStatsForSeries);
+            // set up for the windowed-stats
+            const lifetimeValueStats = data.stats.valueStatsForSeries.get(name) || defaultOrdinalValueStats();
+            if (!this.stats.windowedValueStatsForSeries.has(name)) {
+                this.stats.windowedValueStatsForSeries.set(name, copyOrdinalValueStats(lifetimeValueStats));
+            }
+            // update the windowed-stats for the new points (the dropped points are dealt with below)
+            const windowedValueStats = updatedWindowedValueStatsForNewData(newData, this.stats.windowedValueStatsForSeries.get(name));
+            this.stats.windowedValueStatsForSeries.set(name, windowedValueStats);
+            // drop data older than the max time-window, holding on to the dropped ones -- guarded
+            // on series.data.length, since the current time is the max across ALL series, so a
+            // single lagging series could otherwise be shifted down to empty
+            const droppedData = [];
+            while (series.data.length > 0 && currentTime - series.data[0].time > this.dropDataAfter) {
+                const dropped = series.data.shift();
+                if (dropped !== undefined)
+                    droppedData.push(dropped);
+            }
+            // remove the dropped data from the windowed stats
+            if (droppedData.length > 0) {
+                this.stats.windowedValueStatsForSeries.set(name, updateWindowedValueStatsForDroppedData(droppedData, windowedValueStats, series));
+            }
+        });
+    }
+}
+//# sourceMappingURL=ordinalDataSource.js.map

package/dist/app/charts/datasources/ordinalDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ordinalDataSource.js","sourceRoot":"","sources":["../../../../src/app/charts/datasources/ordinalDataSource.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAC,qBAAqB,EAAoB,MAAM,yBAAyB,CAAC;AACjF,OAAO,EACH,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EAIvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAC,uBAAuB,EAAqB,MAAM,uBAAuB,CAAC;AASlF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuC;IACvE,MAAM,YAAY,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAClD,OAAO;QACH,GAAG,YAAY;QACf,2BAA2B,EAAE,uBAAuB,CAAC,YAAY,CAAC,mBAAmB,CAAC;KACzF,CAAA;AACL,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mCAAmC,CAAC,OAA4B,EAAE,aAAgC;IACvG,MAAM,YAAY,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAA;IACzD,YAAY,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAA;IACpC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IACvE,YAAY,CAAC,GAAG,IAAI,MAAM,CAAA;IAC1B,YAAY,CAAC,UAAU,IAAI,MAAM,GAAG,MAAM,CAAA;IAC1C,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;IAC1F,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,CAAA;IAC1G,YAAY,CAAC,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,CAAA;IAC1G,OAAO,YAAY,CAAA;AACvB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,sCAAsC,CAC3C,WAAgC,EAChC,aAAgC,EAChC,MAAgC;IAEhC,MAAM,YAAY,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAA;IACzD,YAAY,CAAC,KAAK,IAAI,WAAW,CAAC,MAAM,CAAA;IACxC,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAC/E,YAAY,CAAC,GAAG,IAAI,UAAU,CAAA;IAC9B,YAAY,CAAC,UAAU,IAAI,UAAU,GAAG,UAAU,CAAA;IAClD,YAAY,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAA;IAC1F,YAAY,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAA;IACpH,YAAY,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,oBAAoB,EAAE,CAAC,CAAA;IACpH,OAAO,YAAY,CAAA;AACvB,CAAC;AAsBD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,uBAAiF;IASpH;;;OAGG;IACH,YAAY,OAAiC;;QACzC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;QACrD,IAAI,CAAC,aAAa,GAAG,MAAA,OAAO,CAAC,aAAa,mCAAI,QAAQ,CAAA;QACtD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,aAAqB;QAClC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACtC,CAAC;IAED;;;OAGG;IACH,UAAU;QACN,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAC3B,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,IAAI,CAAC,CAAC,EACxF,CAAC,QAAQ,CACZ,CAAA;IACL,CAAC;IAED;;;;;;;;OAQG;IACO,MAAM,CAAC,IAAsB;QACnC,sFAAsF;QACtF,oFAAoF;QACpF,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAA;QAEjD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YACrC,sFAAsF;YACtF,kFAAkF;YAClF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAe,IAAI,CAAC,CAAA;YAE1E,IAAI,IAAI,CAAC,YAAY;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAEvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;YAE5B,4BAA4B;YAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACnE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;YACnE,IAAI,CAAC,KAAK,CAAC,mBAAmB,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;YAExF,gCAAgC;YAChC,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,wBAAwB,EAAE,CAAA;YACjG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC,CAAA;YAC/F,CAAC;YAED,yFAAyF;YACzF,MAAM,kBAAkB,GAAG,mCAAmC,CAC1D,OAAO,EACP,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,CAAE,CACpD,CAAA;YACD,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,GAAG,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;YAEpE,sFAAsF;YACtF,mFAAmF;YACnF,iEAAiE;YACjE,MAAM,WAAW,GAAwB,EAAE,CAAA;YAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;gBACtF,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;gBACnC,IAAI,OAAO,KAAK,SAAS;oBAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACxD,CAAC;YAED,kDAAkD;YAClD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,GAAG,CACtC,IAAI,EACJ,sCAAsC,CAAC,WAAW,EAAE,kBAAkB,EAAE,MAAM,CAAC,CAClF,CAAA;YACL,CAAC;QACL,CAAC,CAAC,CAAA;IACN,CAAC;CACJ"}

package/dist/app/charts/datasources/outlierDataSource.d.ts

@@ -0,0 +1,53 @@
+import type { OutlierChartData } from "../observables/outliers";
+import type { OutlierDatum, OutlierSeries } from "../series/outlierSeries";
+import { BaseStreamingDataSource, type DataGenerator } from "./StreamingDataSource";
+export interface OutlierDataSourceOptions<M extends readonly number[]> {
+    /**
+     * The initial series, owned (and mutated in place) by the source from here on
+     */
+    initialData: Array<OutlierSeries<M>>;
+    /**
+     * Creates the observable of chart data each time the source starts
+     */
+    generator: DataGenerator<OutlierChartData<M>, OutlierSeries<M>>;
+    /**
+     * Data older than this (ms), relative to the newest datum in the same chunk of new data, is
+     * dropped as new data arrives. Defaults to `Infinity` (never drop).
+     */
+    dropDataAfter?: number;
+    /**
+     * Called with each series' new data as it arrives
+     */
+    onUpdateData?: (seriesName: string, data: Array<OutlierDatum<M>>) => void;
+}
+/**
+ * A data source for outlier charts. Unlike time-series charts, series that aren't in the initial
+ * data are added as they first appear in the stream.
+ */
+export declare class OutlierDataSource<M extends readonly number[]> extends BaseStreamingDataSource<OutlierChartData<M>, OutlierDatum<M>, OutlierSeries<M>> {
+    private dropDataAfter;
+    private readonly onUpdateData;
+    /**
+     * Creates a outlier data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options: OutlierDataSourceOptions<M>);
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter: number): void;
+    /**
+     * @return The latest time (the `datum.x` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime(): number;
+    /**
+     * Adds each series' new points to it (adding the series itself the first time it appears),
+     * and drops the points that are older than `dropDataAfter` relative to the newest of the
+     * series' new points. Calls `onUpdateData` with each series' new points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    protected ingest(data: OutlierChartData<M>): void;
+}
+//# sourceMappingURL=outlierDataSource.d.ts.map

package/dist/app/charts/datasources/outlierDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlierDataSource.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/datasources/outlierDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,EAAC,YAAY,EAAE,aAAa,EAAC,MAAM,yBAAyB,CAAC;AAEzE,OAAO,EAAC,uBAAuB,EAAE,KAAK,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAElF,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE;IACjE;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IACpC;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/D;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CAC5E;AAED;;;GAGG;AACH,qBAAa,iBAAiB,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,CACtD,SAAQ,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAEvF,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0E;IAEvG;;;OAGG;gBACS,OAAO,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAMhD;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACH,UAAU,IAAI,MAAM;IAOpB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;CAmBpD"}

package/dist/app/charts/datasources/outlierDataSource.js

@@ -0,0 +1,57 @@
+import { emptySeries } from "../series/baseSeries";
+import { BaseStreamingDataSource } from "./StreamingDataSource";
+/**
+ * A data source for outlier charts. Unlike time-series charts, series that aren't in the initial
+ * data are added as they first appear in the stream.
+ */
+export class OutlierDataSource extends BaseStreamingDataSource {
+    /**
+     * Creates a outlier data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options) {
+        var _a;
+        super(options.initialData, options.generator);
+        this.dropDataAfter = (_a = options.dropDataAfter) !== null && _a !== void 0 ? _a : Infinity;
+        this.onUpdateData = options.onUpdateData;
+    }
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter) {
+        this.dropDataAfter = dropDataAfter;
+    }
+    /**
+     * @return The latest time (the `datum.x` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime() {
+        return this.seriesList().reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.datum.x).getOrElse(tMax)), -Infinity);
+    }
+    /**
+     * Adds each series' new points to it (adding the series itself the first time it appears),
+     * and drops the points that are older than `dropDataAfter` relative to the newest of the
+     * series' new points. Calls `onUpdateData` with each series' new points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    ingest(data) {
+        data.newPoints.forEach((newData, name) => {
+            // register a series the first time it shows up in the stream
+            const series = this.seriesMap.get(name) || emptySeries(name);
+            if (!this.seriesMap.has(name))
+                this.seriesMap.set(name, series);
+            if (this.onUpdateData)
+                this.onUpdateData(name, newData);
+            series.data.push(...newData);
+            // drop data older than the max time-window, relative to this chunk's newest datum
+            const currentTime = Math.max(...newData.map(datum => datum.datum.x), -Infinity);
+            if (Number.isFinite(currentTime)) {
+                while (series.data.length > 0 && currentTime - series.data[0].datum.x > this.dropDataAfter) {
+                    series.data.shift();
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=outlierDataSource.js.map

package/dist/app/charts/datasources/outlierDataSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlierDataSource.js","sourceRoot":"","sources":["../../../../src/app/charts/datasources/outlierDataSource.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,WAAW,EAAC,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAC,uBAAuB,EAAqB,MAAM,uBAAuB,CAAC;AAsBlF;;;GAGG;AACH,MAAM,OAAO,iBACT,SAAQ,uBAA+E;IAKvF;;;OAGG;IACH,YAAY,OAAoC;;QAC5C,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;QAC7C,IAAI,CAAC,aAAa,GAAG,MAAA,OAAO,CAAC,aAAa,mCAAI,QAAQ,CAAA;QACtD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAA;IAC5C,CAAC;IAED;;;OAGG;IACH,gBAAgB,CAAC,aAAqB;QAClC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAA;IACtC,CAAC;IAED;;;OAGG;IACH,UAAU;QACN,OAAO,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM,CAC3B,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,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAC3F,CAAC,QAAQ,CACZ,CAAA;IACL,CAAC;IAED;;;;;OAKG;IACO,MAAM,CAAC,IAAyB;QACtC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE;YACrC,6DAA6D;YAC7D,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAkB,IAAI,CAAqB,CAAA;YACjG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAE/D,IAAI,IAAI,CAAC,YAAY;gBAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YAEvD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAA;YAE5B,kFAAkF;YAClF,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAA;YAC/E,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;oBACzF,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;gBACvB,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAA;IACN,CAAC;CACJ"}

package/dist/app/charts/datasources/timeSeriesDataSource.d.ts

@@ -0,0 +1,77 @@
+import type { Datum, TimeSeries } from "../series/timeSeries";
+import type { TimeSeriesChartData } from "../series/timeSeriesChartData";
+import { BaseStreamingDataSource, type DataGenerator } from "./StreamingDataSource";
+/**
+ * Maps a series name to the "time group" whose clock governs it. Series in the same group share
+ * one current time (the max time over all of them), which is what `dropDataAfter` is measured
+ * against. Plots group series by their x-axis, so this is typically
+ * `name => axisAssignments.get(name)?.xAxis ?? defaultXAxisId`.
+ */
+export type TimeGroupFor = (seriesName: string) => string;
+/**
+ * Calculates the current time for each time group present in the chart data: the max over the
+ * group's series of each series' own max time (falling back to the chart-wide max time). Shared
+ * by the data source (for dropping old data) and the plots' view drivers (for advancing each
+ * x-axis), so both agree on what "now" is for each axis.
+ * @param data The chart data
+ * @param timeGroupFor Maps each series to its time group
+ * @return A map(group -> current_time)
+ */
+export declare function currentTimesByGroup(data: TimeSeriesChartData, timeGroupFor: TimeGroupFor): Map<string, number>;
+export interface TimeSeriesDataSourceOptions {
+    /**
+     * The initial series, owned (and mutated in place) by the source from here on
+     */
+    initialData: Array<TimeSeries>;
+    /**
+     * Creates the observable of chart data each time the source starts
+     */
+    generator: DataGenerator<TimeSeriesChartData, TimeSeries>;
+    /**
+     * Data older than this (ms), relative to its time group's current time, is dropped as new
+     * data arrives. Defaults to `Infinity` (never drop).
+     */
+    dropDataAfter?: number;
+    /**
+     * Assigns each series to a time group (see {@link TimeGroupFor}). Defaults to one group for
+     * all series.
+     */
+    timeGroupFor?: TimeGroupFor;
+    /**
+     * Called with each series' new data as it arrives
+     */
+    onUpdateData?: (seriesName: string, data: Array<Datum>) => void;
+}
+/**
+ * A data source for time-series charts (e.g. the scatter and raster plots)
+ */
+export declare class TimeSeriesDataSource extends BaseStreamingDataSource<TimeSeriesChartData, Datum, TimeSeries> {
+    private dropDataAfter;
+    private readonly timeGroupFor;
+    private readonly onUpdateData;
+    /**
+     * Creates a time-series data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options: TimeSeriesDataSourceOptions);
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter: number): void;
+    /**
+     * @return The latest time (the `x` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime(): number;
+    /**
+     * Adds each series' new points to it, and drops the points that are older than
+     * `dropDataAfter` relative to the current time of the series' time group (see
+     * `currentTimesByGroup`). New points for a series that isn't in the source are ignored
+     * (time-series charts have a fixed set of series). Calls `onUpdateData` with each series' new
+     * points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    protected ingest(data: TimeSeriesChartData): void;
+}
+//# sourceMappingURL=timeSeriesDataSource.d.ts.map

package/dist/app/charts/datasources/timeSeriesDataSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeSeriesDataSource.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/datasources/timeSeriesDataSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,KAAK,EAAE,UAAU,EAAC,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,+BAA+B,CAAC;AAEvE,OAAO,EAAC,uBAAuB,EAAE,KAAK,aAAa,EAAC,MAAM,uBAAuB,CAAC;AAElF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAA;AAOzD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,EAAE,YAAY,EAAE,YAAY,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9G;AAED,MAAM,WAAW,2BAA2B;IACxC;;OAEG;IACH,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;IAC9B;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAA;IACzD;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;CAClE;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,uBAAuB,CAAC,mBAAmB,EAAE,KAAK,EAAE,UAAU,CAAC;IACrG,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAc;IAC3C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgE;IAE7F;;;OAGG;gBACS,OAAO,EAAE,2BAA2B;IAOhD;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAI7C;;;OAGG;IACH,UAAU,IAAI,MAAM;IAOpB;;;;;;;OAOG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;CAwBpD"}

package/dist/app/charts/datasources/timeSeriesDataSource.js

@@ -0,0 +1,85 @@
+import { emptySeries } from "../series/baseSeries";
+import { BaseStreamingDataSource } from "./StreamingDataSource";
+/**
+ * The default time grouping: one group, holding all the series
+ */
+const SINGLE_TIME_GROUP = () => "";
+/**
+ * Calculates the current time for each time group present in the chart data: the max over the
+ * group's series of each series' own max time (falling back to the chart-wide max time). Shared
+ * by the data source (for dropping old data) and the plots' view drivers (for advancing each
+ * x-axis), so both agree on what "now" is for each axis.
+ * @param data The chart data
+ * @param timeGroupFor Maps each series to its time group
+ * @return A map(group -> current_time)
+ */
+export function currentTimesByGroup(data, timeGroupFor) {
+    const times = new Map();
+    data.seriesNames.forEach(name => {
+        var _a;
+        const group = timeGroupFor(name);
+        const seriesTime = data.maxTimes.get(name) || data.maxTime;
+        times.set(group, Math.max((_a = times.get(group)) !== null && _a !== void 0 ? _a : -Infinity, seriesTime));
+    });
+    return times;
+}
+/**
+ * A data source for time-series charts (e.g. the scatter and raster plots)
+ */
+export class TimeSeriesDataSource extends BaseStreamingDataSource {
+    /**
+     * Creates a time-series data source (stopped: call {@link start} to start it)
+     * @param options The initial data, the generator, and the data-retention settings
+     */
+    constructor(options) {
+        var _a, _b;
+        super(options.initialData, options.generator);
+        this.dropDataAfter = (_a = options.dropDataAfter) !== null && _a !== void 0 ? _a : Infinity;
+        this.timeGroupFor = (_b = options.timeGroupFor) !== null && _b !== void 0 ? _b : SINGLE_TIME_GROUP;
+        this.onUpdateData = options.onUpdateData;
+    }
+    /**
+     * Changes how long data is kept; takes effect as the next data arrives
+     * @param dropDataAfter Data older than this (ms) is dropped
+     */
+    setDropDataAfter(dropDataAfter) {
+        this.dropDataAfter = dropDataAfter;
+    }
+    /**
+     * @return The latest time (the `x` of the last datum) over all the series, or
+     * `-Infinity` when there is no data
+     */
+    latestTime() {
+        return this.seriesList().reduce((tMax, series) => Math.max(tMax, series.last().map(datum => datum.x).getOrElse(tMax)), -Infinity);
+    }
+    /**
+     * Adds each series' new points to it, and drops the points that are older than
+     * `dropDataAfter` relative to the current time of the series' time group (see
+     * `currentTimesByGroup`). New points for a series that isn't in the source are ignored
+     * (time-series charts have a fixed set of series). Calls `onUpdateData` with each series' new
+     * points.
+     * @param data The chunk of chart data emitted by the generator
+     */
+    ingest(data) {
+        const groupTimes = currentTimesByGroup(data, this.timeGroupFor);
+        // add each new point to its corresponding series, the new points is a
+        // map(series_name -> new_point[])
+        data.newPoints.forEach((newData, name) => {
+            // note: as in the original subscription code, data for a series that isn't already in
+            // the source is accepted but not kept (time-series charts have a fixed set of series)
+            const series = this.seriesMap.get(name) || emptySeries(name);
+            if (this.onUpdateData)
+                this.onUpdateData(name, newData);
+            series.data.push(...newData);
+            // drop data that is older than the max time-window -- guarded on series.data.length so
+            // a sibling series in the same time group advancing the group's time past every point
+            // this series holds (e.g. this series stalls/updates slower) can't shift it down to
+            // empty and then throw on series.data[0].x
+            const currentTime = groupTimes.get(this.timeGroupFor(name)) || data.maxTime;
+            while (series.data.length > 0 && currentTime - series.data[0].x > this.dropDataAfter) {
+                series.data.shift();
+            }
+        });
+    }
+}
+//# sourceMappingURL=timeSeriesDataSource.js.map

package/dist/app/charts/datasources/timeSeriesDataSource.js.map

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