stream-charts 1.2.1 → 2.0.0

package/dist/app/charts/filters/regexFilter.d.ts

@@ -1,9 +1,36 @@
-import { Result } from "result-fn";
+import { type Result } from "result-fn";
 /**
- * Wraps the creation of the regex in a try/catch and returns the regex, wrapped in an option,
+ * Checks whether a regex is reasonably safe from catastrophic (exponential-time) backtracking --
+ * e.g. `/(a+)+$/`, the classic case that freezes on a long non-matching input. Every plot
+ * component tests a compiled `seriesFilter` regex against every series name on every redraw
+ * frame (not just once), so an unvetted pattern from a free-text filter field can hang the whole
+ * render loop, not just one call. Delegates to the `safe-regex` package, which walks the regex's
+ * actual parsed structure (via `regexp-tree`) rather than pattern-matching its source string, so
+ * it catches more than a hand-rolled "look for nested quantifiers" check would.
+ * @param pattern The regex (or its string source) to check
+ * @return `true` if the pattern is reasonably safe to run against arbitrary input; `false` if it
+ * risks catastrophic backtracking
+ */
+export declare function isSafeRegex(pattern: RegExp | string): boolean;
+/**
+ * Wraps the creation of the regex in a try/catch and returns the regex, wrapped in a `Result`,
  * when it is valid. This can be used, for example, in a text field where the user types a regex.
+ * Also rejects a pattern that compiles fine but risks catastrophic backtracking (see
+ * {@link isSafeRegex}) -- a syntax error and an exponential-time pattern are both "can't use this"
+ * outcomes from the caller's point of view, so both are reported the same way.
  * @param regexString The string representation of the regex
- * @return The regular expression (`RegExp`) wrapped in an option. If the regexp
- * is invalid, then the option is none.
+ * @return The regular expression (`RegExp`) wrapped in a successful `Result`. If the regex is
+ * invalid, or is unsafe, then a failed `Result` holding a message that says why.
  */
 export declare function regexFilter(regexString: string): Result<RegExp, string>;
+/**
+ * Builds a regex that matches `text` literally, for callers (e.g. a series-name filter input)
+ * who want to search for plain text without regex metacharacters (`.`, `*`, `+`, `(`, etc.) in it
+ * being given unintended regex semantics. Escapes those metacharacters before handing the result
+ * to {@link regexFilter}, so it shares the same `Result`-wrapped, never-throws contract.
+ * @param text The literal text to match
+ * @return The regular expression (`RegExp`) matching `text` literally, wrapped in a `Result` (see
+ * {@link regexFilter})
+ */
+export declare function literalFilter(text: string): Result<RegExp, string>;
+//# sourceMappingURL=regexFilter.d.ts.map

package/dist/app/charts/filters/regexFilter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regexFilter.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/filters/regexFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,MAAM,EAAgB,MAAM,WAAW,CAAC;AAGpE;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAE7D;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAcvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAElE"}

package/dist/app/charts/filters/regexFilter.js

@@ -1,18 +1,52 @@
 import { failureResult, successResult } from "result-fn";
+import safeRegex from "safe-regex";
 /**
- * Wraps the creation of the regex in a try/catch and returns the regex, wrapped in an option,
+ * Checks whether a regex is reasonably safe from catastrophic (exponential-time) backtracking --
+ * e.g. `/(a+)+$/`, the classic case that freezes on a long non-matching input. Every plot
+ * component tests a compiled `seriesFilter` regex against every series name on every redraw
+ * frame (not just once), so an unvetted pattern from a free-text filter field can hang the whole
+ * render loop, not just one call. Delegates to the `safe-regex` package, which walks the regex's
+ * actual parsed structure (via `regexp-tree`) rather than pattern-matching its source string, so
+ * it catches more than a hand-rolled "look for nested quantifiers" check would.
+ * @param pattern The regex (or its string source) to check
+ * @return `true` if the pattern is reasonably safe to run against arbitrary input; `false` if it
+ * risks catastrophic backtracking
+ */
+export function isSafeRegex(pattern) {
+    return safeRegex(pattern);
+}
+/**
+ * Wraps the creation of the regex in a try/catch and returns the regex, wrapped in a `Result`,
  * when it is valid. This can be used, for example, in a text field where the user types a regex.
+ * Also rejects a pattern that compiles fine but risks catastrophic backtracking (see
+ * {@link isSafeRegex}) -- a syntax error and an exponential-time pattern are both "can't use this"
+ * outcomes from the caller's point of view, so both are reported the same way.
  * @param regexString The string representation of the regex
- * @return The regular expression (`RegExp`) wrapped in an option. If the regexp
- * is invalid, then the option is none.
+ * @return The regular expression (`RegExp`) wrapped in a successful `Result`. If the regex is
+ * invalid, or is unsafe, then a failed `Result` holding a message that says why.
  */
 export function regexFilter(regexString) {
     try {
         const regex = new RegExp(regexString);
+        if (!isSafeRegex(regex)) {
+            return failureResult(`Refusing to use a regex that risks catastrophic backtracking; regex_expression: ${regexString}`);
+        }
         return successResult(regex);
     }
     catch (error) {
-        return failureResult(`Unable to compile the regex expression; regex_expression: ${regexString}`);
+        return failureResult(`Unable to compile the regex expression; regex_expression: ${regexString}; error: ${error}`);
     }
 }
+/**
+ * Builds a regex that matches `text` literally, for callers (e.g. a series-name filter input)
+ * who want to search for plain text without regex metacharacters (`.`, `*`, `+`, `(`, etc.) in it
+ * being given unintended regex semantics. Escapes those metacharacters before handing the result
+ * to {@link regexFilter}, so it shares the same `Result`-wrapped, never-throws contract.
+ * @param text The literal text to match
+ * @return The regular expression (`RegExp`) matching `text` literally, wrapped in a `Result` (see
+ * {@link regexFilter})
+ */
+export function literalFilter(text) {
+    return regexFilter(text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+}
 //# sourceMappingURL=regexFilter.js.map

package/dist/app/charts/filters/regexFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"regexFilter.js","sourceRoot":"","sources":["../../../../src/app/charts/filters/regexFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAU,aAAa,EAAC,MAAM,WAAW,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC3C,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAA;QACrC,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QACZ,OAAO,aAAa,CAAC,6DAA6D,WAAW,EAAE,CAAC,CAAA;IACpG,CAAC;AACL,CAAC"}
+{"version":3,"file":"regexFilter.js","sourceRoot":"","sources":["../../../../src/app/charts/filters/regexFilter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAe,aAAa,EAAC,MAAM,WAAW,CAAC;AACpE,OAAO,SAAS,MAAM,YAAY,CAAC;AAEnC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,OAAwB;IAChD,OAAO,SAAS,CAAC,OAAO,CAAC,CAAA;AAC7B,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC3C,IAAI,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,WAAW,CAAC,CAAA;QACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,aAAa,CAChB,mFAAmF,WAAW,EAAE,CACnG,CAAA;QACL,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IAAC,OAAM,KAAK,EAAE,CAAC;QACZ,OAAO,aAAa,CAChB,6DAA6D,WAAW,YAAY,KAAK,EAAE,CAC9F,CAAA;IACL,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACtC,OAAO,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAA;AACnE,CAAC"}

package/dist/app/charts/hooks/AxesProvider.d.ts

@@ -0,0 +1,21 @@
+import { AxisInterval } from "../axes/AxisInterval";
+import { type JSX } from "react";
+import { BaseAxisRange } from "../axes/BaseAxisRange";
+import type { BaseAxis } from "../axes/axes";
+export type Props = {
+    /**
+     * Callback when axes bounds change.
+     * @param ranges The ranges (start, end) for each axis in the plot
+     */
+    onUpdateAxesInterval?: (ranges: Map<string, AxisInterval>) => void;
+    children: JSX.Element | Array<JSX.Element>;
+};
+/**
+ * The React context provider for the {@link UseAxesValues}
+ * @param props The properties
+ * @return The children wrapped in this provider
+ * @template AR The type of the axis range (e.g. {@link ContinuousAxisRange} or {@link OrdinalAxisRange})
+ * @template A The axis type
+ */
+export default function AxesProvider<AR extends BaseAxisRange, A extends BaseAxis>(props: Props): JSX.Element;
+//# sourceMappingURL=AxesProvider.d.ts.map

package/dist/app/charts/hooks/AxesProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AxesProvider.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/hooks/AxesProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAC,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAC,KAAK,GAAG,EAAyC,MAAM,OAAO,CAAC;AACvE,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,cAAc,CAAC;AAQ3C,MAAM,MAAM,KAAK,GAAG;IAChB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAA;IAElE,QAAQ,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAC7C,CAAA;AACD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAiR5G"}

package/dist/app/charts/hooks/AxesProvider.js

@@ -0,0 +1,213 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useMemo, useRef, useState } from "react";
+import { usePlotDimensions } from "./usePlotDimensions";
+import { AxesState } from "../axes/AxesState";
+import { Optional } from "result-fn";
+import { AxesContext } from "./useAxes";
+/**
+ * The React context provider for the {@link UseAxesValues}
+ * @param props The properties
+ * @return The children wrapped in this provider
+ * @template AR The type of the axis range (e.g. {@link ContinuousAxisRange} or {@link OrdinalAxisRange})
+ * @template A The axis type
+ */
+export default function AxesProvider(props) {
+    const { onUpdateAxesInterval, children } = props;
+    const plotDimensions = usePlotDimensions();
+    const [xAxesState, setXAxesState] = useState(AxesState.empty());
+    const [yAxesState, setYAxesState] = useState(AxesState.empty());
+    const axisAssignmentsRef = useRef(new Map());
+    const axesBoundsUpdateHandlersRef = useRef(new Map());
+    const axesRangeRef = useRef(new Map());
+    /**
+     * Retrieves the x-axis and y-axis assignments for the specified series. If the series does not
+     * have an assignment, then we assume it is using the default x- and y-axes.
+     * @param seriesName The name of the series for which to retrieve the axes assignments
+     * @return An {@link AxesAssignment} for the specified axes.
+     */
+    const axisAssignmentsFor = useCallback((seriesName) => axisAssignmentsRef.current.get(seriesName) || {
+        xAxis: xAxesState.axisDefaultId().getOrElse(""),
+        yAxis: yAxesState.axisDefaultId().getOrElse("")
+    }, [xAxesState, yAxesState]);
+    /**
+     * Called when the domain/range is updated on one or more of the chart's axes (generally x-axes). Stores
+     * the updated ranges, and in turn, dispatches the update to all the registered domain/range update
+     * handlers (e.g. the axes, which redraw themselves with their new domain).
+     * @param updates A map holding the axis ID to the updated axis time-range (i.e., map(axis_id, axis_time_range))
+     */
+    const updateAxisRanges = useCallback((updates) => {
+        // update the current time-ranges reference
+        updates.forEach((range, id) => {
+            axesRangeRef.current.set(id, range);
+        });
+        // dispatch the updates to all the registered handlers
+        axesBoundsUpdateHandlersRef.current
+            .forEach((handler) => handler(updates, plotDimensions.plotDimensions));
+    }, [plotDimensions.plotDimensions]);
+    /**
+     * Sets the axis ranges specified in the input map (without dispatching them to the update handlers)
+     * @param ranges The ranges to set
+     */
+    const setAxesRanges = useCallback((ranges) => {
+        ranges.forEach((range, id) => {
+            axesRangeRef.current.set(id, range);
+        });
+    }, []);
+    /**
+     * Sets the axis range for the specified axis ID (without dispatching it to the update handlers)
+     * @param axisId The axis ID
+     * @param range The range to set
+     */
+    const setAxisRangeFor = useCallback((axisId, range) => {
+        axesRangeRef.current.set(axisId, range);
+    }, []);
+    /**
+     * Sets the axis bounds (the current range) for the specified axis ID. Note that this does not
+     * change the original axis interval, doesn't dispatch the change to the update handlers, and
+     * does nothing when the axis has no range yet.
+     * @param axisId The axis ID
+     * @param interval The interval
+     */
+    const setAxisIntervalFor = useCallback((axisId, interval) => {
+        Optional.ofNullable(axesRangeRef.current.get(axisId))
+            .map(range => range.update(interval.start, interval.end))
+            .ifPresent(updatedRange => axesRangeRef.current.set(axisId, updatedRange));
+    }, []);
+    /**
+     * Sets the original axis interval for the axis range (does nothing when the axis has no range yet)
+     * @param axisId The axis ID
+     * @param interval The interval to which to set the origin interval
+     */
+    const setOriginalAxisIntervalFor = useCallback((axisId, interval) => {
+        Optional.ofNullable(axesRangeRef.current.get(axisId))
+            .map(range => range.updateOriginal(interval.start, interval.end))
+            .ifPresent(updatedRange => axesRangeRef.current.set(axisId, updatedRange));
+    }, []);
+    /**
+     * Re-applies the specified axis' stored range: dispatches it, unchanged, to the update handlers
+     * (so that the axis redraws with it). Note that this does *not* restore the axis' original
+     * range. Does nothing when the axis has no range.
+     * @param axisId The ID of the axis
+     */
+    const resetAxisIntervalFor = useCallback((axisId) => {
+        Optional
+            .ofNullable(axesRangeRef.current.get(axisId))
+            .map(range => new Map([[axisId, range]]))
+            .ifPresent(updates => updateAxisRanges(updates));
+    }, [updateAxisRanges]);
+    /**
+     * Sets the ranges of the axes in the specified map, and dispatches them to the update handlers
+     * (the same as {@link updateAxisRanges}). Axes that aren't in the map are left as they are, so
+     * the default (empty) map changes nothing.
+     * @param [axesRanges=new Map()] An optional map holds bounds for specified axes. The map
+     * associates an axis ID with the new bounds.
+     */
+    const resetAxesRanges = useCallback((axesRanges = new Map()) => {
+        updateAxisRanges(axesRanges);
+    }, [updateAxisRanges]);
+    /**
+     * Adds a handler to deal with updates to the bounds of the axes
+     * @param handlerId the unique ID of the handler
+     * @param handler The handler function that accepts a map of updates and a plot dimension
+     * @return A map with all the handlers
+     * @throws Error when a handler with the same ID is already registered
+     */
+    const addAxesRangesUpdateHandler = useCallback((handlerId, handler) => {
+        if (axesBoundsUpdateHandlersRef.current.has(handlerId)) {
+            throw new Error(`Handler with ID already exists, please remove it before adding it; ` +
+                `handler_id: ${handlerId}; ` +
+                `existing_handler_ids: [${Array.from(axesBoundsUpdateHandlersRef.current.keys()).join(", ")}]`);
+        }
+        return axesBoundsUpdateHandlersRef.current.set(handlerId, handler);
+    }, []);
+    /**
+     * Removes the axis-update handler with the specified ID
+     * @param handlerId The ID of the handler to remove
+     * @return `true` when the handler was registered (and has been removed); `false` otherwise
+     */
+    const removeAxesRangesUpdateHandler = useCallback((handlerId) => axesBoundsUpdateHandlersRef.current.delete(handlerId), []);
+    /**
+     * Adds an x-axis to the x-axes state (a new state object, so dependents re-render)
+     * @param axis The axis to add
+     * @param id The ID of the axis to add
+     * @param [range] The initial axis range (when given, it's stored as the axis' range)
+     */
+    const addXAxis = useCallback((axis, id, range) => {
+        setXAxesState(xAxesState.addAxis(axis, id));
+        if (range !== undefined) {
+            axesRangeRef.current.set(id, range);
+        }
+    }, [xAxesState]);
+    /**
+     * Adds a y-axis to the y-axes state (a new state object, so dependents re-render)
+     * @param axis The axis to add
+     * @param id The ID of the axis to add
+     * @param [range] The initial axis range (when given, it's stored as the axis' range)
+     */
+    const addYAxis = useCallback((axis, id, range) => {
+        setYAxesState(yAxesState.addAxis(axis, id));
+        if (range !== undefined) {
+            axesRangeRef.current.set(id, range);
+        }
+    }, [yAxesState]);
+    /**
+     * Sets the axes assigned to each series (replacing any earlier assignments)
+     * @param assignments The assignment of the series to their axes
+     */
+    const setAxisAssignments = useCallback((assignments) => {
+        axisAssignmentsRef.current = assignments;
+    }, []);
+    /**
+     * @return A copy of the map of the axes' current ranges, by axis ID
+     */
+    const axesRanges = useCallback(() => new Map(axesRangeRef.current), []);
+    /**
+     * Retrieves the current axis range for the specified axis ID
+     * @param axisId The ID of the axis
+     * @return The axis' range, or an empty `Optional` when the axis has no range
+     */
+    const axisRangeFor = useCallback((axisId) => Optional.ofNullable(axesRangeRef.current.get(axisId)), []);
+    // the context's `value` prop is typed as `unknown` (see `AxesContext` in `useAxes.tsx`), so
+    // the object literal needs its own explicit type here to give the handler functions below
+    // their parameter types -- otherwise they'd fall back to implicit `any`.
+    //
+    // Memoized so consumers relying on this context value's identity (e.g. a `useMemo`/effect
+    // keyed on it) don't re-run on essentially every render of anything above this provider --
+    // previously a fresh object literal every render, with every method inside it also a fresh
+    // closure. This is the same class of bug already documented/worked around in ScatterPlot.tsx/
+    // RasterPlot.tsx/OutlierPlot.tsx (their own comments on `axesRanges` never being memoized
+    // here) -- those workarounds (refs populated imperatively instead of `useMemo([axesRanges])`)
+    // are left in place; they're redundant once this is memoized, but harmless, and removing them
+    // isn't part of this change.
+    const value = useMemo(() => ({
+        xAxesState,
+        yAxesState,
+        addXAxis,
+        addYAxis,
+        setAxisAssignments,
+        axisAssignmentsFor,
+        updateAxisRanges,
+        axesRanges,
+        axisRangeFor,
+        setAxesRanges,
+        setAxisRangeFor,
+        setAxisIntervalFor,
+        setOriginalAxisIntervalFor,
+        resetAxesRanges,
+        resetAxisIntervalFor,
+        onUpdateAxesInterval,
+        addAxesRangesUpdateHandler,
+        removeAxesRangesUpdateHandler,
+    }), [
+        xAxesState, yAxesState,
+        addXAxis, addYAxis,
+        setAxisAssignments, axisAssignmentsFor,
+        updateAxisRanges, axesRanges, axisRangeFor,
+        setAxesRanges, setAxisRangeFor, setAxisIntervalFor, setOriginalAxisIntervalFor,
+        resetAxesRanges, resetAxisIntervalFor,
+        onUpdateAxesInterval,
+        addAxesRangesUpdateHandler, removeAxesRangesUpdateHandler,
+    ]);
+    return _jsx(AxesContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=AxesProvider.js.map

package/dist/app/charts/hooks/AxesProvider.js.map

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

package/dist/app/charts/hooks/CanvasSurfaceProvider.d.ts

@@ -0,0 +1,25 @@
+import { type JSX } from "react";
+import { type SvgStyle } from "../styling/svgStyle";
+export type Props = {
+    chartId: number;
+    color: string;
+    backgroundColor: string;
+    svgStyle?: Partial<SvgStyle>;
+    children: JSX.Element | Array<JSX.Element>;
+};
+/**
+ * Creates and sizes the chart's `<canvas>` element, and provides the resulting canvas element and
+ * drawing context (via {@link useCanvasSurface}) to descendants -- most notably {@link ChartProvider}.
+ *
+ * Must be rendered as a descendant of {@link PlotDimensionsProvider}. The canvas's size is derived
+ * entirely from {@link usePlotDimensions}'s `plotDimensions`/`margin` -- the single source of truth
+ * for the chart's dimensions -- rather than from static width/height props. This matters because
+ * `usePlotDimensions` also exposes `updateDimensions(...)`, an escape hatch for updating
+ * dimensions independent of any prop (e.g. from a `ResizeObserver`-driven descendant); sourcing
+ * the canvas's size from the same place those updates land keeps the canvas from ever drifting out
+ * of sync with what the axes/plots believe the plot dimensions to be.
+ * @param props The properties
+ * @return The children, wrapped in the canvas-surface context provider
+ */
+export default function CanvasSurfaceProvider(props: Props): JSX.Element;
+//# sourceMappingURL=CanvasSurfaceProvider.d.ts.map

package/dist/app/charts/hooks/CanvasSurfaceProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasSurfaceProvider.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/hooks/CanvasSurfaceProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,GAAG,EAAoD,MAAM,OAAO,CAAC;AAKlF,OAAO,EAAkB,KAAK,QAAQ,EAAC,MAAM,qBAAqB,CAAC;AAInE,MAAM,MAAM,KAAK,GAAG;IAChB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,eAAe,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC5B,QAAQ,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,OAAO,UAAU,qBAAqB,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAqFvE"}

package/dist/app/charts/hooks/CanvasSurfaceProvider.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { usePlotDimensions } from "./usePlotDimensions";
+import { createCanvasContext, resizeCanvasTo } from "../plots/plot";
+import { CanvasSurfaceContext } from "./useCanvasSurface";
+import { initialSvgStyle } from "../styling/svgStyle";
+const defaultBackground = '#202020';
+/**
+ * Creates and sizes the chart's `<canvas>` element, and provides the resulting canvas element and
+ * drawing context (via {@link useCanvasSurface}) to descendants -- most notably {@link ChartProvider}.
+ *
+ * Must be rendered as a descendant of {@link PlotDimensionsProvider}. The canvas's size is derived
+ * entirely from {@link usePlotDimensions}'s `plotDimensions`/`margin` -- the single source of truth
+ * for the chart's dimensions -- rather than from static width/height props. This matters because
+ * `usePlotDimensions` also exposes `updateDimensions(...)`, an escape hatch for updating
+ * dimensions independent of any prop (e.g. from a `ResizeObserver`-driven descendant); sourcing
+ * the canvas's size from the same place those updates land keeps the canvas from ever drifting out
+ * of sync with what the axes/plots believe the plot dimensions to be.
+ * @param props The properties
+ * @return The children, wrapped in the canvas-surface context provider
+ */
+export default function CanvasSurfaceProvider(props) {
+    const { chartId, color, backgroundColor, children } = props;
+    // the container (canvas) size is the plot area plus its margins -- i.e. the inverse of what
+    // plotDimensionsFrom(width, height, margin) computes -- reconstructed from usePlotDimensions'
+    // state rather than from props, so this stays correct even when dimensions are updated via
+    // updateDimensions(...) rather than a containerDimensions prop change.
+    const { plotDimensions, margin } = usePlotDimensions();
+    const width = plotDimensions.width + margin.left + margin.right;
+    const height = plotDimensions.height + margin.top + margin.bottom;
+    const svgStyle = useMemo(() => ({ ...initialSvgStyle, ...props.svgStyle }), [props.svgStyle]);
+    const [canvas, setCanvas] = useState(null);
+    const [canvasContext, setCanvasContext] = useState(null);
+    // captures the dimensions active at the exact moment this component first renders
+    const initialDimensionsRef = useRef({ width, height });
+    // a plain ref latch, not `canvasContext` state, guards the one-time canvas-context creation
+    // below
+    const hasCreatedCanvasContext = useRef(false);
+    // keep the canvas's backing store in sync with the plot dimensions, however they change
+    // (prop-driven container resize, or a direct updateDimensions(...) call)
+    useEffect(() => {
+        if (canvasContext) {
+            resizeCanvasTo(canvasContext, { width, height });
+            canvasContext.requestRedraw();
+        }
+    }, [canvasContext, width, height]);
+    const setCanvasCallback = useCallback(
+    /**
+     * Callback for setting the canvas element and updating its CSS style.
+     * @param canvasElement - The canvas element, or null if not available (e.g. unmounting).
+     */
+    (canvasElement) => {
+        if (canvasElement) {
+            setCanvas(canvasElement);
+            // create the canvas context (and do its initial sizing) exactly once, the moment
+            // the canvas element first attaches.
+            if (!hasCreatedCanvasContext.current) {
+                hasCreatedCanvasContext.current = true;
+                const cc = createCanvasContext(chartId, canvasElement, color);
+                resizeCanvasTo(cc, initialDimensionsRef.current);
+                setCanvasContext(cc);
+            }
+            // apply the style/background/color from the defaults and any style object passed
+            // in as properties, one property at a time, rather than overwriting the whole
+            // `style` attribute
+            Object.getOwnPropertyNames(svgStyle)
+                .filter(name => name !== 'width' && name !== 'height')
+                .forEach(name => canvasElement.style.setProperty(name, String(svgStyle[name])));
+            canvasElement.style.backgroundColor = backgroundColor !== defaultBackground ? backgroundColor : '';
+            canvasElement.style.color = color;
+        }
+    }, [backgroundColor, chartId, color, svgStyle]);
+    const value = useMemo(() => ({ canvas, canvasContext }), [canvas, canvasContext]);
+    return (_jsxs(CanvasSurfaceContext.Provider, { value: value, children: [_jsx("div", { style: { position: 'relative', width, height }, children: _jsx("canvas", { ref: setCanvasCallback }) }), children] }));
+}
+//# sourceMappingURL=CanvasSurfaceProvider.js.map

package/dist/app/charts/hooks/CanvasSurfaceProvider.js.map

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

package/dist/app/charts/hooks/ChartProvider.d.ts

@@ -0,0 +1,40 @@
+import type { BaseAxis, SeriesStyle } from "../axes/axes";
+import { BaseAxisRange } from "../axes/BaseAxisRange";
+import { type JSX } from "react";
+/**
+ * The properties for the {@link ChartProvider}
+ * @template S The type of the series style
+ */
+export interface Props<S extends SeriesStyle> {
+    /**
+     * The unique ID for the chart
+     */
+    chartId: number;
+    /**
+     * Base color
+     */
+    color: string;
+    /**
+     * The base/default background color
+     */
+    backgroundColor: string;
+    /**
+     * A `map(series_name -> series_line_style)` holding the style for each series
+     */
+    seriesStyles?: Map<string, S>;
+    /**
+     * An optional regular expression used against the series names to determine which series to show in the chart
+     */
+    seriesFilter?: RegExp;
+    children: JSX.Element | Array<JSX.Element>;
+}
+/**
+ * The React context provider for the {@link UseChartValues}
+ * @param props The properties
+ * @return The children wrapped in this provider
+ * @template S The type of the series style
+ * @template AR The type of the axis range
+ * @template A The type of the axis
+ */
+export default function ChartProvider<S extends SeriesStyle, AR extends BaseAxisRange, A extends BaseAxis>(props: Props<S>): JSX.Element;
+//# sourceMappingURL=ChartProvider.d.ts.map

package/dist/app/charts/hooks/ChartProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartProvider.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/hooks/ChartProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,QAAQ,EAAE,WAAW,EAAC,MAAM,cAAc,CAAC;AACxD,OAAO,EAAC,aAAa,EAAC,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAC,KAAK,GAAG,EAAU,MAAM,OAAO,CAAC;AAYxC;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,SAAS,WAAW;IACxC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,eAAe,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC7B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB,QAAQ,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAC7C;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,EAAE,SAAS,aAAa,EAAE,CAAC,SAAS,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,CA2BvI"}

package/dist/app/charts/hooks/ChartProvider.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo } from "react";
+import { defaultUseChartValues } from "./defaultUseChartValues";
+import { useAxes } from "./useAxes";
+import { useMouse } from "./useMouse";
+import { useTooltip } from "./useTooltip";
+import { useCanvasSurface } from "./useCanvasSurface";
+import { ChartContext } from "./useChart";
+// the defaults (constants, so that their identity doesn't change from one render to the next)
+const DEFAULT_SERIES_FILTER = defaultUseChartValues().seriesFilter;
+const NO_SERIES_STYLES = new Map();
+/**
+ * The React context provider for the {@link UseChartValues}
+ * @param props The properties
+ * @return The children wrapped in this provider
+ * @template S The type of the series style
+ * @template AR The type of the axis range
+ * @template A The type of the axis
+ */
+export default function ChartProvider(props) {
+    const { chartId, color, backgroundColor, seriesFilter = DEFAULT_SERIES_FILTER, seriesStyles = NO_SERIES_STYLES, } = props;
+    // canvas/canvasContext come from CanvasSurfaceProvider (a shared ancestor -- see Chart.tsx),
+    // which sizes the canvas from usePlotDimensions() rather than from props, so this always
+    // reflects the same dimensions the axes/plots are using.
+    const { canvas, canvasContext } = useCanvasSurface();
+    const axes = useAxes();
+    const mouse = useMouse();
+    const tooltip = useTooltip();
+    // (memoized, so that the chart's components only re-render when something in it changes)
+    const value = useMemo(() => ({ chartId, color, backgroundColor, seriesStyles, seriesFilter, canvasContext, canvas, axes, mouse, tooltip }), [chartId, color, backgroundColor, seriesStyles, seriesFilter, canvasContext, canvas, axes, mouse, tooltip]);
+    return _jsx(ChartContext.Provider, { value: value, children: props.children });
+}
+//# sourceMappingURL=ChartProvider.js.map

package/dist/app/charts/hooks/ChartProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartProvider.js","sourceRoot":"","sources":["../../../../src/app/charts/hooks/ChartProvider.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAW,OAAO,EAAC,MAAM,OAAO,CAAC;AACxC,OAAO,EAAC,qBAAqB,EAAC,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAC;AAClC,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AACpC,OAAO,EAAC,UAAU,EAAC,MAAM,cAAc,CAAC;AACxC,OAAO,EAAC,gBAAgB,EAAC,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAC,YAAY,EAAC,MAAM,YAAY,CAAC;AAExC,8FAA8F;AAC9F,MAAM,qBAAqB,GAAG,qBAAqB,EAAE,CAAC,YAAY,CAAA;AAClE,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAuB,CAAA;AA+BvD;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAsE,KAAe;IACtH,MAAM,EACF,OAAO,EACP,KAAK,EACL,eAAe,EACf,YAAY,GAAG,qBAAqB,EACpC,YAAY,GAAG,gBAAkC,GACpD,GAAG,KAAK,CAAA;IAET,6FAA6F;IAC7F,yFAAyF;IACzF,yDAAyD;IACzD,MAAM,EAAC,MAAM,EAAE,aAAa,EAAC,GAAG,gBAAgB,EAAE,CAAA;IAElD,MAAM,IAAI,GAAG,OAAO,EAAS,CAAA;IAC7B,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAA;IACxB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAE5B,yFAAyF;IACzF,MAAM,KAAK,GAAG,OAAO,CACjB,GAAG,EAAE,CAAC,CAAC,EAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAC,CAAC,EAClH,CAAC,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAC7G,CAAA;IAED,OAAO,KAAC,YAAY,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YACrC,KAAK,CAAC,QAAQ,GACK,CAAA;AAC5B,CAAC"}

package/dist/app/charts/hooks/InteractionProvider.d.ts

@@ -0,0 +1,23 @@
+import { type JSX } from "react";
+type Props = {
+    children: JSX.Element | Array<JSX.Element>;
+};
+/**
+ * Provides the chart's interactions: the mouse-over and mouse-leave handlers (see {@link useMouse}),
+ * the tooltip's content provider and visibility (see {@link useTooltip}), and the hovered series
+ * (see {@link useHoveredSeries}).
+ *
+ * The plots hit-test the mouse, and call the mouse handlers: a mouse-over sets the hovered series,
+ * and then calls every registered mouse-over handler (e.g. the tooltip's); a mouse-leave clears the
+ * hovered series, and calls every registered mouse-leave handler.
+ *
+ * The handler registries live in refs, so the mouse and tooltip values never change identity (the
+ * tooltip's changes only with its visibility), and registering a handler never re-renders anything.
+ * @param props The children
+ * @return The children, wrapped in the interaction contexts
+ * @template D The type of the data object for the series
+ * @template TM The type of the metadata object for the series
+ */
+export default function InteractionProvider<D, TM>(props: Props): JSX.Element;
+export {};
+//# sourceMappingURL=InteractionProvider.d.ts.map

package/dist/app/charts/hooks/InteractionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionProvider.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/hooks/InteractionProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,GAAG,EAA4B,MAAM,OAAO,CAAC;AAK1D,KAAK,KAAK,GAAG;IACT,QAAQ,EAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;CAC7C,CAAA;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CA8D5E"}