stream-charts 1.2.1 → 2.0.0

package/dist/app/charts/plots/OutlierPlot.js

@@ -0,0 +1,430 @@
+import { useCallback, useEffect, useRef } from 'react';
+import { useStreamingTimeAxes } from "./useStreamingTimeAxes";
+import { useHoveredSeries } from "../hooks/useHoveredSeries";
+import * as d3 from "d3";
+import { useChart } from "../hooks/useChart";
+import { useDataSource, useDataSourceRunning, useInitialData } from "../hooks/useDataSource";
+import { usePlotDimensions } from "../hooks/usePlotDimensions";
+import { clipToArea } from "./plot";
+import { seriesAt, canvasLocalPoint } from "./hitTesting";
+import { noop } from "../utils";
+import { extentWith, visibleExtent } from "../axes/autoScale";
+import { growAutoScaledYAxes, useAutoScaleRestart } from "./autoScaleYAxes";
+import { AxisType, checkAxisType, defaultLineStyle } from "../axes/axes";
+import { outlierAxisTimes, TimeWindowBehavior } from "../subscriptions/viewDrivers";
+import { FastShiftArray } from "fast-shift-array";
+/**
+ * Renders a streaming outlier plot. Each series consists of {@link OutlierDatum} points, where every
+ * datum carries an (x, y) value plus a set of (lower, upper) bounds — one per measure. The plot
+ * draws the central y-line for the series and a translucent band per measure, filled between
+ * the corresponding lower and upper bounds. The x-axis scrolls as new points arrive past the
+ * end of the visible window, in the same fashion as {@link ScatterPlot}.
+ *
+ * Internally, this no longer creates/updates SVG `<path>`/`<circle>` elements. Instead, it
+ * registers a single draw function with the chart's {@link CanvasContext} that redraws every
+ * series' bands, line, and markers from scratch each time the canvas repaints. Band hover uses
+ * `ctx.isPointInPath` against the band's actual filled path (captured each draw); outlier-marker
+ * hover uses the shared point-hit-testing in `hitTesting.ts`, same as {@link ScatterPlot}'s markers.
+ * When the data source is paused, hovering over a band shows the tooltip (when there's one); a
+ * y-axis with `autoScale` set grows to fit the data on screen (bands included).
+ * @param props The properties associated with the outlier plot
+ * @return `null` (the plot draws onto the chart's canvas)
+ * @template M The type of the measures (a tuple of numbers)
+ */
+export function OutlierPlot(props) {
+    var _a;
+    const { chartId, canvasContext, axes, seriesStyles, seriesFilter, mouse, } = useChart();
+    const { hoveredSeriesName } = useHoveredSeries();
+    const { mouseOverHandlerFor, mouseLeaveHandlerFor } = mouse;
+    const { initialData } = useInitialData();
+    const { xAxesState, yAxesState, updateAxisRanges = noop, axisRangeFor, } = axes;
+    const { plotDimensions, margin } = usePlotDimensions();
+    // the application-owned source of the data, and whether it's running (streaming)
+    const dataSource = useDataSource();
+    const running = useDataSourceRunning(dataSource);
+    const { axisAssignments = new Map(), interpolation = d3.curveLinear, panEnabled = false, zoomEnabled = false, zoomKeyModifiersRequired = true, timeWindowBehavior = TimeWindowBehavior.SCROLL, withCadenceOf, bandOpacity = 0.15, bandOpacityStep = 0.12, markerRadius, outlierMarkerColors, highlightAxesOnMouseOver = false, onZoomReset = noop, } = props;
+    // seriesRef is the single source of truth for what to render: the data source's own (live)
+    // series map, which grows as series first appear in the stream. the draw function iterates this
+    // directly (rather than a parallel dataRef array) so dynamically-arriving series get rendered.
+    const seriesRef = useRef((_a = dataSource === null || dataSource === void 0 ? void 0 : dataSource.series) !== null && _a !== void 0 ? _a : new Map(initialData.map(series => [series.name, series])));
+    // captured band fill-regions and outlier-marker geometry, in canvas coordinates, used for
+    // hit-testing mouse hover on `mousemove` (see the effect below that wires up the listener)
+    const bandsRef = useRef([]);
+    const outlierGeometryRef = useRef(new Map());
+    const outlierDatumsRef = useRef(new Map());
+    // what's currently hovered: a band (series + band index) or an outlier point (series + point
+    // index) -- mutually exclusive, so we know when to fire a "leave" before an "over"
+    const lastHoveredRef = useRef(undefined);
+    /**
+     * (Re-)registers this plot's draw function with the canvas context and requests a redraw.
+     * Replaces the old version, which directly mutated SVG `<path>`/`<circle>` elements bound via
+     * d3's enter/update/exit join. Canvas has no persistent elements to join against, so the draw
+     * function just redraws every band/line/marker from current data/scale state each time it's
+     * invoked.
+     *
+     * Pan/zoom behavior setup lives in a separate effect (see below), not here -- this function
+     * runs on every data tick (each `windowingTime` interval), and recreating/reattaching a
+     * `d3.drag()`/`d3.zoom()` behavior that often is pure overhead unrelated to drawing the new
+     * data.
+     * @param cc The canvas context to register the draw function with
+     */
+    const updatePlot = useCallback((cc) => {
+        const draw = (context) => {
+            const { context2D } = context;
+            context2D.save();
+            clipToArea(context, plotDimensions, { x: margin.left, y: margin.top });
+            context2D.translate(margin.left, margin.top);
+            const newBands = [];
+            const newOutlierGeometry = new Map();
+            const newOutlierDatums = new Map();
+            seriesRef.current.forEach(series => {
+                var _a, _b, _c;
+                const [xAxis, yAxis] = axesFor(series.name, axisAssignments, id => xAxesState.axisFor(id).getOrUndefined(), id => yAxesState.axisFor(id).getOrUndefined());
+                if (xAxis === undefined || yAxis === undefined)
+                    return;
+                const style = (_a = seriesStyles.get(series.name)) !== null && _a !== void 0 ? _a : defaultLineStyle();
+                const plotData = series.name.match(seriesFilter) ? series.data : FastShiftArray.empty();
+                const numBands = plotData.length > 0 ? plotData[0].bounds.length : 0;
+                // render the widest (highest-index) band first so the narrower, more-confident
+                // bands stack on top with darker opacity
+                for (let bandIndex = numBands - 1; bandIndex >= 0; bandIndex--) {
+                    const opacity = Math.min(1, bandOpacity + (numBands - 1 - bandIndex) * bandOpacityStep);
+                    const areaGen = d3.area()
+                        .x(d => xAxis.scale(d.datum.x) || 0)
+                        .y0(d => yAxis.scale(d.bounds[bandIndex].lower) || 0)
+                        .y1(d => yAxis.scale(d.bounds[bandIndex].upper) || 0)
+                        .curve(interpolation);
+                    const upperMeasure = series.measures[bandIndex];
+                    const lowerMeasure = bandIndex > 0 ? series.measures[bandIndex - 1] : undefined;
+                    const path = new Path2D((_b = areaGen(Array.from(plotData))) !== null && _b !== void 0 ? _b : "");
+                    context2D.fillStyle = style.color;
+                    context2D.globalAlpha = opacity;
+                    context2D.fill(path);
+                    context2D.globalAlpha = 1;
+                    // pushed in draw order (widest first, narrowest/topmost last); hit-testing
+                    // iterates this backwards so the topmost band wins, matching visual stacking
+                    newBands.push({ path, seriesName: series.name, bandIndex, upperMeasure, lowerMeasure, plotData });
+                }
+                // central line for the series y-value
+                const isHovered = hoveredSeriesName === series.name;
+                const stroke = isHovered ? style.highlightColor : style.color;
+                const strokeWidth = isHovered ? style.highlightWidth : style.lineWidth;
+                const lineGen = d3.line()
+                    .x(d => xAxis.scale(d.datum.x) || 0)
+                    .y(d => yAxis.scale(d.datum.y) || 0)
+                    .curve(interpolation);
+                context2D.strokeStyle = stroke;
+                context2D.lineWidth = strokeWidth;
+                context2D.stroke(new Path2D((_c = lineGen(Array.from(plotData))) !== null && _c !== void 0 ? _c : ""));
+                // for the markers, we split the data into two categories: regular and outlier
+                const { regular, outlier } = categorizePoints(plotData, outlierMarkerColors);
+                // point markers (one circle per datum) -- decorative only, no hover/tooltip
+                if (markerRadius != null && markerRadius >= 0 && !running) {
+                    context2D.fillStyle = stroke;
+                    regular.forEach(d => {
+                        const x = xAxis.scale(d.datum.x) || 0;
+                        const y = yAxis.scale(d.datum.y) || 0;
+                        context2D.beginPath();
+                        context2D.arc(x, y, markerRadius, 0, 2 * Math.PI);
+                        context2D.fill();
+                    });
+                }
+                // outlier markers -- these DO get hover/tooltip, so we record their screen
+                // positions (and the underlying datum, for the tooltip) for hit-testing
+                const outlierPoints = [];
+                outlier.forEach(o => {
+                    const x = xAxis.scale(o.datum.datum.x) || 0;
+                    const y = yAxis.scale(o.datum.datum.y) || 0;
+                    context2D.fillStyle = o.color;
+                    context2D.beginPath();
+                    context2D.arc(x, y, 4, 0, 2 * Math.PI);
+                    context2D.fill();
+                    outlierPoints.push([x + margin.left, y + margin.top]);
+                });
+                newOutlierGeometry.set(`${series.name}::outlier`, {
+                    points: outlierPoints,
+                    hitRadius: 6
+                });
+                newOutlierDatums.set(series.name, outlier);
+            });
+            bandsRef.current = newBands;
+            outlierGeometryRef.current = newOutlierGeometry;
+            outlierDatumsRef.current = newOutlierDatums;
+            context2D.restore();
+        };
+        /**
+         * Grows the auto-scaling y-axes (see `ContinuousAxis`'s `autoScale` prop) to fit the
+         * data that's on screen: for each shown series (those matching the filter), the values
+         * and the bands' lower and upper bounds of its points within the x-axis' current
+         * window, along with where their lines cross the window's edges (see `visibleExtent`).
+         * Since an axis only ever grows, only the visible data needs checking each frame.
+         * Registered to run before the axes draw (they're at z-index 0), so the axes and the
+         * series are drawn with the grown domain in the same frame.
+         */
+        const autoScaleYAxes = () => {
+            const extents = new Map();
+            seriesRef.current.forEach(series => {
+                if (!series.name.match(seriesFilter))
+                    return;
+                const [xAxis, yAxis] = axesFor(series.name, axisAssignments, id => xAxesState.axisFor(id).getOrUndefined(), id => yAxesState.axisFor(id).getOrUndefined());
+                if (xAxis === undefined || (yAxis === null || yAxis === void 0 ? void 0 : yAxis.autoScale) === undefined)
+                    return;
+                const [start, end] = xAxis.scale.domain();
+                // (the series' line and its bands' edges are always drawn as lines)
+                const seriesExtent = visibleExtent(series.data, [start, end], yAxis.scale, true, point => point.datum.x, point => [point.datum.y, ...point.bounds.flatMap(({ lower, upper }) => [lower, upper])]);
+                if (seriesExtent === undefined)
+                    return;
+                const extent = extents.get(yAxis.axisId);
+                extents.set(yAxis.axisId, extent === undefined ? seriesExtent : extentWith(extentWith(extent, seriesExtent[0]), seriesExtent[1]));
+            });
+            growAutoScaledYAxes(extents, { yAxes: yAxesState.axes, axisRangeFor, updateAxisRanges });
+        };
+        cc.register(`outlier-plot-autoscale-${chartId}`, autoScaleYAxes, -10);
+        cc.register(`outlier-plot-${chartId}`, draw, 10);
+        cc.requestRedraw();
+    }, 
+    // note: my WebStorm claims that bandOpacityStep is not a dependency, but it is and the
+    // linter flags is as missing when it is removed
+    [
+        chartId, plotDimensions, axisAssignments, xAxesState, yAxesState, seriesStyles, seriesFilter,
+        interpolation, bandOpacity, bandOpacityStep, markerRadius, outlierMarkerColors, hoveredSeriesName, running,
+        axisRangeFor, updateAxisRanges, margin.left, margin.top
+    ]);
+    // new data, new scale: restarts the auto-scaling y-axes when the data source is replaced
+    useAutoScaleRestart(dataSource, { yAxes: yAxesState.axes, axisRangeFor, updateAxisRanges });
+    // the time axes: their ranges, the view driver, panning and zooming, highlighting, and
+    // reporting the axes' intervals -- see `useStreamingTimeAxes`
+    useStreamingTimeAxes({
+        canvasContext,
+        dataSource,
+        running,
+        initialData,
+        timeOf: datum => datum.datum.x,
+        axisTimesFor: outlierAxisTimes(axisAssignments, xAxesState),
+        axisAssignments,
+        updatePlot,
+        onDataReset: () => {
+            var _a;
+            seriesRef.current = (_a = dataSource === null || dataSource === void 0 ? void 0 : dataSource.series) !== null && _a !== void 0 ? _a : new Map(initialData.map(series => [series.name, series]));
+        },
+        panEnabled,
+        zoomEnabled,
+        zoomKeyModifiersRequired,
+        onZoomReset,
+        withCadenceOf,
+        timeWindowBehavior,
+        highlightAxesOnMouseOver,
+    });
+    // wires up a single mousemove/mouseleave listener on the shared canvas to replace the old
+    // per-element SVG mouseover/mouseleave handlers on the band paths and outlier-marker circles.
+    // Bands are hit-tested via `ctx.isPointInPath` against their captured fill path (checked
+    // topmost/narrowest-first, matching visual stacking); outlier markers use the shared
+    // point-hit-testing in `hitTesting.ts`. Outlier markers are checked first since they're drawn
+    // on top of the bands.
+    useEffect(() => {
+        if (!canvasContext)
+            return;
+        const canvas = canvasContext.canvas;
+        const { context2D, dpr } = canvasContext;
+        const handleMove = (event) => {
+            var _a, _b, _c, _d;
+            const [x, y] = canvasLocalPoint(event, canvas);
+            // check outlier markers first (drawn on top of the bands)
+            const outlierHit = seriesAt(x, y, outlierGeometryRef.current);
+            // The band's `Path2D` is built from raw (pre-margin) local coordinates -- the same
+            // space `x - margin.left, y - margin.top` (the "local" point) is in -- but
+            // `ctx.isPointInPath` only reported correct hits once that local point was ALSO
+            // scaled by `dpr`. (An earlier version of this instead dropped the margin
+            // subtraction and scaled the raw canvas-relative point by `dpr` -- that's wrong:
+            // verified against the actual rendered band, rigorously, by isolating a single
+            // band layer's on-screen pixels via `getImageData` and testing candidate query
+            // points against the real `Path2D` object captured from a live hover. Dropping the
+            // margin subtraction was close enough to pass a single, less careful spot-check,
+            // but consistently mislocated the hit region by `margin.left`/`margin.top`, which
+            // is what produced "hover ~margin-worth of pixels to the side of the band" in
+            // practice.) The exact reason `dpr` needs to be reapplied here, on top of a
+            // transform that already includes it, isn't fully pinned down -- this is the
+            // empirically-verified formula, not a re-derivation from the Canvas 2D spec.
+            const localX = (x - margin.left) * dpr;
+            const localY = (y - margin.top) * dpr;
+            const current = outlierHit !== undefined ?
+                { kind: 'outlier', seriesName: outlierHit.name.replace(/::outlier$/, ''), index: outlierHit.index } :
+                findHoveredBand(bandsRef.current, context2D, localX, localY);
+            const previous = lastHoveredRef.current;
+            const sameAsBefore = previous !== undefined && current !== undefined &&
+                previous.kind === current.kind && previous.seriesName === current.seriesName &&
+                ((previous.kind === 'band' && current.kind === 'band' && previous.bandIndex === current.bandIndex) ||
+                    (previous.kind === 'outlier' && current.kind === 'outlier' && previous.index === current.index));
+            if (sameAsBefore)
+                return;
+            if (previous !== undefined) {
+                (_a = mouseLeaveHandlerFor(`tooltip-${chartId}`)) === null || _a === void 0 ? void 0 : _a(previous.seriesName);
+            }
+            if (current !== undefined) {
+                if (current.kind === 'band') {
+                    const band = bandsRef.current.find(b => b.seriesName === current.seriesName && b.bandIndex === current.bandIndex);
+                    if (band !== undefined && band.upperMeasure != null) {
+                        const pointsInBand = calcPointsInBand(band.plotData, band.bandIndex);
+                        (_b = mouseOverHandlerFor(`tooltip-${chartId}`)) === null || _b === void 0 ? void 0 : _b(current.seriesName, current.bandIndex, {
+                            series: band.plotData,
+                            metadata: {
+                                upperMeasure: band.upperMeasure,
+                                lowerMeasure: band.lowerMeasure,
+                                bandIndex: current.bandIndex,
+                                pointsInBand,
+                            }
+                        }, [x, y]);
+                    }
+                }
+                else {
+                    const series = seriesRef.current.get(current.seriesName);
+                    const outlierDatum = (_c = outlierDatumsRef.current.get(current.seriesName)) === null || _c === void 0 ? void 0 : _c[current.index];
+                    if (series !== undefined && outlierDatum !== undefined) {
+                        const plotData = series.name.match(seriesFilter) ? series.data : FastShiftArray.empty();
+                        const datum = outlierDatum.datum;
+                        const bandIndex = largestExceededBoundIndex(datum) + 1;
+                        const upperMeasure = bandIndex < series.measures.length ? series.measures[bandIndex] : undefined;
+                        const lowerMeasure = bandIndex > 0 ? series.measures[bandIndex - 1] : undefined;
+                        const pointsInBand = calcPointsInBand(plotData, bandIndex);
+                        (_d = mouseOverHandlerFor(`tooltip-${chartId}`)) === null || _d === void 0 ? void 0 : _d(current.seriesName, datum.datum.x, {
+                            series: series.data,
+                            metadata: { datum, upperMeasure, lowerMeasure, bandIndex, pointsInBand }
+                        }, [x, y]);
+                    }
+                }
+            }
+            lastHoveredRef.current = current;
+        };
+        const handleLeaveCanvas = () => {
+            var _a;
+            const previous = lastHoveredRef.current;
+            if (previous !== undefined) {
+                (_a = mouseLeaveHandlerFor(`tooltip-${chartId}`)) === null || _a === void 0 ? void 0 : _a(previous.seriesName);
+                lastHoveredRef.current = undefined;
+            }
+        };
+        canvas.addEventListener('mousemove', handleMove);
+        canvas.addEventListener('mouseleave', handleLeaveCanvas);
+        return () => {
+            canvas.removeEventListener('mousemove', handleMove);
+            canvas.removeEventListener('mouseleave', handleLeaveCanvas);
+        };
+    }, [canvasContext, chartId, margin, seriesFilter, mouseOverHandlerFor, mouseLeaveHandlerFor]);
+    // this plot needs a data source (see the `Chart`'s `dataSource` prop)
+    useEffect(() => {
+        if (dataSource === undefined) {
+            console.error("OutlierPlot requires a data source; set the enclosing Chart's `dataSource` prop");
+        }
+    }, [dataSource]);
+    // unregister this plot's draw function on unmount
+    useEffect(() => {
+        return () => {
+            if (canvasContext) {
+                canvasContext.unregister(`outlier-plot-autoscale-${chartId}`);
+                canvasContext.unregister(`outlier-plot-${chartId}`);
+            }
+        };
+    }, [canvasContext, chartId]);
+    return null;
+}
+/**
+ * Finds the topmost (narrowest, most-confident) band whose fill path contains `(localX, localY)`.
+ * `bands` is in draw order (widest first, narrowest/topmost last), so this iterates backwards to
+ * check the topmost band first, matching visual stacking.
+ * @param bands The bands' fill regions, as last drawn, in draw order
+ * @param context The canvas 2D context (for `isPointInPath`)
+ * @param localX The mouse's x-coordinate, in the coordinates `isPointInPath` tests against (see
+ * the caller for why that's the plot-area position scaled by the device-pixel ratio)
+ * @param localY The mouse's y-coordinate, in the same coordinates
+ * @return The hovered band's series and index, or `undefined` when the mouse isn't over a band
+ */
+function findHoveredBand(bands, context, localX, localY) {
+    for (let i = bands.length - 1; i >= 0; i--) {
+        const band = bands[i];
+        if (context.isPointInPath(band.path, localX, localY)) {
+            return { kind: 'band', seriesName: band.seriesName, bandIndex: band.bandIndex };
+        }
+    }
+    return undefined;
+}
+/**
+ * Returns the index of the largest bound the datum's y-value is outside of, or -1 if the value
+ * is inside every bound. Bounds are expected to be ordered from tightest (index 0) to widest
+ * (highest index), so the highest-index match identifies the most severe outlier tier.
+ * @param datum The datum
+ * @return The index of the largest bound the datum is outside of, or -1
+ */
+function largestExceededBoundIndex(datum) {
+    for (let i = datum.bounds.length - 1; i >= 0; i--) {
+        const { lower, upper } = datum.bounds[i];
+        if (datum.datum.y < lower || datum.datum.y > upper)
+            return i;
+    }
+    return -1;
+}
+/**
+ * Attempts to locate the x- and y-axes for the specified series. If the series has no axis
+ * assignment, then uses the default (first) x- and y-axes.
+ * @param seriesName Name of the series for which to retrieve the axis
+ * @param axisAssignments A map holding the series name and the associated x- and y-axes assigned
+ * to that series
+ * @param xAxisFor The function that accepts an axis ID and returns the corresponding x-axis
+ * @param yAxisFor The function that accepts an axis ID and returns the corresponding y-axis
+ * @return The x- and y-axes (`undefined` when not found)
+ * @throws Error when either axis isn't a continuous numeric axis
+ */
+function axesFor(seriesName, axisAssignments, xAxisFor, yAxisFor) {
+    const assigned = axisAssignments.get(seriesName);
+    const xAxisRaw = xAxisFor((assigned === null || assigned === void 0 ? void 0 : assigned.xAxis) || "");
+    const yAxisRaw = yAxisFor((assigned === null || assigned === void 0 ? void 0 : assigned.yAxis) || "");
+    checkAxisType("OutlierPlot", "x", xAxisRaw, AxisType.ContinuousNumeric);
+    checkAxisType("OutlierPlot", "y", yAxisRaw, AxisType.ContinuousNumeric);
+    const xAxis = xAxisRaw;
+    const yAxis = yAxisRaw;
+    return [xAxis, yAxis];
+}
+/**
+ * Calculate the number of points within a specific outlier band.
+ * @param plotData The array of outlier data points.
+ * @param bandIndex The index of the outlier band to calculate points for.
+ * @param [subtractLowerBandCount=true] Whether to subtract the count of points in the lower band. Defaults to true.
+ * @returns The number of points within the specified outlier band.
+ */
+function calcPointsInBand(plotData, bandIndex, subtractLowerBandCount = true) {
+    // function to count the points in a specific outlier band
+    const countPointsInBand = (bandIndex) => plotData
+        .filter(datum => {
+        if (bandIndex < datum.bounds.length) {
+            return datum.datum.y >= datum.bounds[bandIndex].lower && datum.datum.y <= datum.bounds[bandIndex].upper;
+        }
+        return true;
+    }).length;
+    const pointsInBand = countPointsInBand(bandIndex);
+    // we need to subtract the points in the lower band. recall that each band has ALL the points
+    // in the band's range, not what we may think of visually
+    if (bandIndex > 0 && subtractLowerBandCount) {
+        return pointsInBand - countPointsInBand(bandIndex - 1);
+    }
+    return pointsInBand;
+}
+/**
+ * Categorizes outlier data into regular and outlier points based on provided marker colors.
+ * @param data Array of outlier data to categorize
+ * @param outlierMarkerColors Array of colors to use for outlier markers
+ * @returns Object with regular and outlier data arrays
+ * @template M Type of the measure
+ */
+function categorizePoints(data, outlierMarkerColors = []) {
+    return data.reduce((accum, datum) => {
+        var _a;
+        const bandIndex = largestExceededBoundIndex(datum);
+        if (bandIndex < 0) {
+            accum.regular.push(datum);
+        }
+        else {
+            accum.outlier.push({ datum, color: (_a = outlierMarkerColors[bandIndex]) !== null && _a !== void 0 ? _a : "red" });
+        }
+        return accum;
+    }, { regular: [], outlier: [] });
+}
+//# sourceMappingURL=OutlierPlot.js.map

package/dist/app/charts/plots/OutlierPlot.js.map

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

package/dist/app/charts/plots/PoincarePlot.d.ts

@@ -1,6 +1,26 @@
 import * as d3 from "d3";
-import { CurveFactory } from "d3";
-export declare const NoCurveFactory: CurveFactory;
+/**
+ * A snapshot of the Poincaré plot's zoom/pan state, in a form that can be held outside the plot
+ * (e.g. in an application store) and handed back to a later instance of the plot (see the
+ * {@link Props.zoomState} and {@link Props.onZoomStateChange} props) -- so that zooming, navigating
+ * away, and navigating back doesn't reset the zoom.
+ */
+export interface PoincarePlotZoomState {
+    /**
+     * d3-zoom's cumulative scale factor (`transform.k`) at the time of the snapshot. It must be
+     * restored onto the new canvas along with the ranges: d3-zoom's `scaleExtent` (see
+     * {@link Props.zoomMaxScaleFactor}) limits `k`, so a remounted canvas starting back at `k = 1`
+     * would otherwise mis-measure how much further the user may zoom in or out.
+     */
+    k: number;
+    /**
+     * Maps each axis ID (x and y) to its current (zoomed, panned) domain
+     */
+    ranges: Record<string, [start: number, end: number]>;
+}
+/**
+ * The properties of the {@link PoincarePlot}
+ */
 export interface Props {
     /**
      * The line interpolation curve factory. See the d3 documentation for curves at
@@ -8,14 +28,38 @@ export interface Props {
      */
     interpolation?: d3.CurveFactory;
     /**
-     * When set to `true` plots the data points as well as the line.
+     * When set to `true` (the default) plots the data points as well as the line.
      */
     showPoints?: boolean;
     /**
-     * The number of milliseconds of data to hold in memory before dropping it. Defaults to
-     * infinity (i.e. no data is dropped)
+     * When `true`, the lines connecting the points change color along their length, one step per
+     * point: from `lineStartColor` at each series' first point to `lineEndColor` after
+     * `lineColorSteps` points, then back to `lineStartColor` over the next `lineColorSteps` points,
+     * and so on, sweeping the colors of the spectrum in between (the long way around the hue
+     * circle -- e.g. from blue, through cyan, green, and yellow, to red). A point keeps its color
+     * as old points are dropped (with an {@link IteratesDataSource}, which counts them), so that
+     * the path's direction, and its age, can be seen. The points are filled with the color of the
+     * line leaving them (except while hovered, when they're highlighted as usual). When `false`
+     * (the default), the lines and points are drawn in the series' own color.
+     */
+    colorizeLines?: boolean;
+    /**
+     * The number of points (steps) it takes the colorized lines' color to sweep from
+     * `lineStartColor` to `lineEndColor` (and as many to sweep back) -- the larger, the slower the
+     * color changes. Defaults to {@link DEFAULT_LINE_COLOR_STEPS} (1,000). Only used when
+     * `colorizeLines` is `true`.
+     */
+    lineColorSteps?: number;
+    /**
+     * The color the colorized lines' sweep starts at (each series' first point). Defaults to a blue
+     * ({@link DEFAULT_LINE_START_COLOR}). Only used when `colorizeLines` is `true`.
+     */
+    lineStartColor?: string;
+    /**
+     * The color the colorized lines' sweep ends at (after `lineColorSteps` points). Defaults to a red
+     * ({@link DEFAULT_LINE_END_COLOR}). Only used when `colorizeLines` is `true`.
      */
-    dropDataAfter?: number;
+    lineEndColor?: string;
     /**
      * Enables panning (default is false)
      */
@@ -42,6 +86,25 @@ export interface Props {
      * the larger this factor, the more the user can "zoom out". Default value is 1.0.
      */
     zoomMaxScaleFactor?: number;
+    /**
+     * An (optional) zoom/pan state to restore when this plot mounts -- commonly the last value
+     * reported through {@link onZoomStateChange} and held by the application (e.g. in a store) so
+     * that the zoom survives the plot being unmounted and remounted (e.g. navigating away and
+     * back). Only read once, when the plot's axes are first available.
+     */
+    zoomState?: PoincarePlotZoomState;
+    /**
+     * (Optional) callback that is handed the plot's zoom/pan state after each zoom event, at the
+     * end of each pan, and when the axes' bounds are changed from outside (which resets the zoom)
+     */
+    onZoomStateChange?: (zoomState: PoincarePlotZoomState) => void;
+    /**
+     * Called whenever this plot (re)creates its zoom behavior, handing the caller a `resetZoom`
+     * function that clears d3-zoom's own accumulated scale back to identity and restores every axis
+     * to its original (un-zoomed, un-panned) domain -- e.g. for a "Clear" action. Only meaningful
+     * (called) while `zoomEnabled` is true.
+     */
+    onZoomReset?: (resetZoom: () => void) => void;
     /**
      * When set, uses a cadence with the specified refresh period (in milliseconds). For plots
      * where the updates are slow (> 100 ms) using a cadence of 10 to 25 ms smooths out the
@@ -49,24 +112,38 @@ export interface Props {
      * then setting the cadence period too small will result in poor update performance. Generally
      * at high update speeds, the cadence is unnecessary. Finally, using cadence, sets the max time
      * to the current time.
+     *
+     * Note: the Poincaré plot accepts this, but doesn't (yet) use it -- its axes don't follow time.
      */
     withCadenceOf?: number;
+    /**
+     * When true, hovering over a point also highlights the (single, shared) x- and y-axes it is
+     * plotted against, in the series' own highlight color/width. Defaults to `false`.
+     */
+    highlightAxesOnMouseOver?: boolean;
 }
 /**
- * Renders a streaming Poincare (iterates) plot for the series in the initial data and those sourced by the
- * observable specified as a property in the {@link Chart}. This component uses the {@link useChart}
+ * Renders a streaming Poincare (iterates) plot for the series held by the {@link StreamingDataSource}
+ * handed to the {@link Chart} (its `dataSource` prop). This component uses the {@link useChart}
  * hook, and therefore must be a child of the {@link Chart} in order to be plugged in to the
  * chart ecosystem (axes, tracker, tooltip).
  *
- * @param props The properties associated with the scatter plot
+ * Internally, this no longer creates/updates SVG `<path>`/`<circle>`/`<text>` elements. Instead, it
+ * registers a single draw function with the chart's {@link CanvasContext} that redraws every
+ * series' line and points from scratch each time the canvas repaints. The old version's
+ * hover-a-point-and-annotate-its-neighbors behavior used direct `d3.select('#specific-id')` lookups
+ * into already-rendered SVG elements from a separate pass after the main render; since canvas has
+ * no persistent elements to reach back into, this is restructured so the single draw pass checks
+ * "is this point hovered, or a neighbor of the hovered point" and renders the highlight/label
+ * inline, driven by a `hoveredPointRef` updated on `mousemove`.
+ *
+ * @param props The properties associated with the Poincaré plot
+ * @return `null` (the plot draws onto the chart's canvas)
  * @example
  * ```typescript
- *  <ScatterPlot
+ *  <PoincarePlot
  *      interpolation={interpolation}
- *      axisAssignments={new Map([
- *          ['test2', assignAxes("x-axis-2", "y-axis-2")],
- *      ])}
- *      dropDataAfter={10000}
+ *      showPoints={true}
  *      panEnabled={true}
  *      zoomEnabled={true}
  *      zoomKeyModifiersRequired={true}
@@ -74,3 +151,4 @@ export interface Props {
  * ```
  */
 export declare function PoincarePlot(props: Props): null;
+//# sourceMappingURL=PoincarePlot.d.ts.map

package/dist/app/charts/plots/PoincarePlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoincarePlot.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/plots/PoincarePlot.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAqDzB;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IAClC;;;;;OAKG;IACH,CAAC,EAAE,MAAM,CAAA;IACT;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC,CAAA;CACvD;AAED;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,EAAE,CAAC,YAAY,CAAA;IAC/B;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,qBAAqB,KAAK,IAAI,CAAA;IAC9D;;;;;OAKG;IACH,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IAC7C;;;;;;;;;OASG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;CACrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAyvB/C"}