stream-charts 1.2.1 → 2.0.0

package/dist/app/charts/tooltips/useTooltipStyle.js

@@ -0,0 +1,14 @@
+import { createContext, useContext } from "react";
+import { defaultTooltipStyle } from "./tooltipUtils";
+/**
+ * The style of the enclosing {@link Tooltip} (its `style`, over the default tooltip style)
+ */
+export const TooltipStyleContext = createContext(defaultTooltipStyle);
+/**
+ * @return The style of the enclosing {@link Tooltip}: its `style` property over the default tooltip
+ * style (or just the default style, outside a tooltip)
+ */
+export function useTooltipStyle() {
+    return useContext(TooltipStyleContext);
+}
+//# sourceMappingURL=useTooltipStyle.js.map

package/dist/app/charts/tooltips/useTooltipStyle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTooltipStyle.js","sourceRoot":"","sources":["../../../../src/app/charts/tooltips/useTooltipStyle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAE,UAAU,EAAC,MAAM,OAAO,CAAC;AAChD,OAAO,EAAC,mBAAmB,EAAoB,MAAM,gBAAgB,CAAC;AAEtE;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAe,mBAAmB,CAAC,CAAA;AAEnF;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,UAAU,CAAC,mBAAmB,CAAC,CAAA;AAC1C,CAAC"}

package/dist/app/charts/trackers/Tracker.d.ts

@@ -1,27 +1,43 @@
-import { TrackerLabelFont, TrackerStyle } from "./trackerUtils";
+import { type TrackerLabelFont, TrackerLabelLocation, type TrackerStyle } from "./trackerUtils";
 import { AxisLocation } from "../axes/axes";
+/**
+ * What the tracker reports for an axis: the axis' value at the mouse, and where the axis is
+ */
 export interface TrackerAxisInfo {
+    /** the axis' value at the mouse (for a y-axis too, despite the name) */
     x: number;
+    /** the location of the axis */
     axisLocation: AxisLocation;
 }
 export type TrackerAxisUpdate = Map<string, TrackerAxisInfo>;
-export declare enum TrackerLabelLocation {
-    Nowhere = 0,
-    ByAxis = 1
-}
+/**
+ * The properties of the {@link Tracker}
+ */
 export interface Props {
+    /** whether the tracker is shown */
     visible: boolean;
+    /**
+     * the axes the tracker reports the values of: top or bottom for a vertical line that tracks
+     * the x-axes (the default), left or right for a horizontal line that tracks the y-axes
+     */
     trackerAxis?: AxisLocation;
+    /** where the tracker's labels are shown (by the axes, the default, or nowhere) */
     labelLocation?: TrackerLabelLocation;
+    /** formats an axis' value for its label (defaults to a whole number, with thousands separators) */
     labelFormatter?: (value: number) => string;
+    /** the style of the tracker's line */
     style?: Partial<TrackerStyle>;
+    /** the font of the tracker's labels */
     font?: Partial<TrackerLabelFont>;
+    /** called with each (non-empty) axis' value at the mouse, as the mouse moves over the plot */
     onTrackerUpdate?: (update: TrackerAxisUpdate) => void;
 }
 /**
  * A tracker line that displays or reports the x or y coordinates at the mouse location. The tracker
- * handles single axes and dual axes.
+ * handles single axes and dual axes. Internally, this registers a draw function with the chart's
+ * canvas context (see `trackerUtils.ts`) rather than creating/updating SVG elements.
  * @param props The tracker control properties
  * @return null component
  */
 export declare function Tracker(props: Props): null;
+//# sourceMappingURL=Tracker.d.ts.map

package/dist/app/charts/trackers/Tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Tracker.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/trackers/Tracker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAIH,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,KAAK,YAAY,EACpB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAC,YAAY,EAA4C,MAAM,cAAc,CAAC;AAGrF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,wEAAwE;IACxE,CAAC,EAAE,MAAM,CAAA;IACT,+BAA+B;IAC/B,YAAY,EAAE,YAAY,CAAA;CAC7B;AAGD,MAAM,MAAM,iBAAiB,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,YAAY,CAAA;IAC1B,kFAAkF;IAClF,aAAa,CAAC,EAAE,oBAAoB,CAAA;IACpC,mGAAmG;IACnG,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC1C,sCAAsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACjC,8FAA8F;IAC9F,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAA;CACxD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAwG1C"}

package/dist/app/charts/trackers/Tracker.js

@@ -1,59 +1,73 @@
 import { noop } from "../utils";
 import { useChart } from "../hooks/useChart";
-import { defaultTrackerLabelFont, defaultTrackerStyle, removeTrackerControl, trackerControlInstance } from "./trackerUtils";
+import { defaultTrackerLabelFont, defaultTrackerStyle, trackerControlInstance, TrackerLabelLocation } from "./trackerUtils";
 import * as d3 from "d3";
 import { useEffect, useMemo, useRef } from "react";
 import { AxisLocation } from "../axes/axes";
 import { usePlotDimensions } from "../hooks/usePlotDimensions";
-export var TrackerLabelLocation;
-(function (TrackerLabelLocation) {
-    TrackerLabelLocation[TrackerLabelLocation["Nowhere"] = 0] = "Nowhere";
-    TrackerLabelLocation[TrackerLabelLocation["ByAxis"] = 1] = "ByAxis";
-})(TrackerLabelLocation || (TrackerLabelLocation = {}));
 /**
  * A tracker line that displays or reports the x or y coordinates at the mouse location. The tracker
- * handles single axes and dual axes.
+ * handles single axes and dual axes. Internally, this registers a draw function with the chart's
+ * canvas context (see `trackerUtils.ts`) rather than creating/updating SVG elements.
  * @param props The tracker control properties
  * @return null component
  */
 export function Tracker(props) {
     const { visible, trackerAxis = AxisLocation.Bottom, labelLocation = TrackerLabelLocation.ByAxis, labelFormatter, style, font, onTrackerUpdate = noop } = props;
-    const { chartId, container, axes, backgroundColor } = useChart();
+    const { chartId, canvasContext, axes, backgroundColor } = useChart();
     const { xAxesState, yAxesState } = axes;
     const axisState = (trackerAxis === AxisLocation.Bottom || trackerAxis === AxisLocation.Top) ?
         xAxesState :
         yAxesState;
     const { plotDimensions, margin } = usePlotDimensions();
-    const trackerStyle = useMemo(() => (Object.assign(Object.assign({}, defaultTrackerStyle), style)), [style]);
-    const trackerFont = useMemo(() => (Object.assign(Object.assign({}, defaultTrackerLabelFont), font)), [font]);
-    const trackerRef = useRef(undefined);
+    const trackerStyle = useMemo(() => ({ ...defaultTrackerStyle, ...style }), [style]);
+    const trackerFont = useMemo(() => ({ ...defaultTrackerLabelFont, ...font }), [font]);
+    // holds the cleanup function returned by `trackerControlInstance`, replacing the old
+    // `TrackerSelection` ref
+    const trackerCleanupRef = useRef(undefined);
     const axisRef = useRef(new Map());
     useEffect(() => {
         const axes = new Map();
         axisState.axes.forEach((axis, id) => axes.set(id, axis));
         axisRef.current = axes;
     }, [axisState]);
-    // when the container, tracker-control function, or visibility change, then we need to update the
-    // tracker control
+    // when the canvas context, tracker-control function, or visibility change, then we need to
+    // update the tracker control
     useEffect(() => {
-        if (container) {
-            const svg = d3.select(container);
-            if (visible && container) {
-                const trackerLabels = new Map(Array.from(axisRef.current.values()).map(axis => {
+        if (canvasContext) {
+            if (visible) {
+                // if a tracker was already registered (e.g., from a prior render with
+                // different props), tear it down before registering the new one
+                if (trackerCleanupRef.current !== undefined) {
+                    trackerCleanupRef.current();
+                    trackerCleanupRef.current = undefined;
+                }
+                const trackerLabels = new Map(Array.from(axisRef.current.values())
+                    .filter(axis => !axis.isEmpty)
+                    .map(axis => {
                     const formatter = labelFormatter !== null && labelFormatter !== void 0 ? labelFormatter : ((value) => labelLocation === TrackerLabelLocation.Nowhere ?
                         "" :
                         `${d3.format(",.0f")(value)}`);
                     return [axis, formatter];
                 }));
-                trackerRef.current = trackerControlInstance(chartId, container, svg, plotDimensions, margin, trackerStyle, trackerFont, trackerLabels, labelLocation, onTrackerUpdate, trackerAxis, backgroundColor);
+                trackerCleanupRef.current = trackerControlInstance(canvasContext, chartId, plotDimensions, margin, trackerStyle, trackerFont, trackerLabels, labelLocation, onTrackerUpdate, trackerAxis, backgroundColor);
             }
             // if the tracker was defined and is now no longer defined (i.e., props changed, then remove the tracker)
-            else if (!visible && trackerRef.current !== undefined) {
-                removeTrackerControl(svg, trackerAxis);
-                trackerRef.current = undefined;
+            else if (!visible && trackerCleanupRef.current !== undefined) {
+                trackerCleanupRef.current();
+                trackerCleanupRef.current = undefined;
             }
         }
-    }, [backgroundColor, chartId, container, labelFormatter, labelLocation, margin, onTrackerUpdate, plotDimensions, trackerAxis, trackerFont, trackerStyle, visible]);
+    }, [backgroundColor, chartId, canvasContext, labelFormatter, labelLocation, margin, onTrackerUpdate, plotDimensions, trackerAxis, trackerFont, trackerStyle, visible]);
+    // unregister the tracker when this component unmounts
+    useEffect(() => {
+        return () => {
+            if (trackerCleanupRef.current !== undefined) {
+                trackerCleanupRef.current();
+                trackerCleanupRef.current = undefined;
+            }
+        };
+    }, []);
     return null;
 }
 //# sourceMappingURL=Tracker.js.map

package/dist/app/charts/trackers/Tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"Tracker.js","sourceRoot":"","sources":["../../../../src/app/charts/trackers/Tracker.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Tracker.js","sourceRoot":"","sources":["../../../../src/app/charts/trackers/Tracker.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,EAEtB,oBAAoB,EAEvB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAC,MAAM,OAAO,CAAC;AACjD,OAAO,EAAC,YAAY,EAA4C,MAAM,cAAc,CAAC;AACrF,OAAO,EAAC,iBAAiB,EAAC,MAAM,4BAA4B,CAAC;AAsC7D;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,KAAY;IAChC,MAAM,EACF,OAAO,EACP,WAAW,GAAG,YAAY,CAAC,MAAM,EACjC,aAAa,GAAG,oBAAoB,CAAC,MAAM,EAC3C,cAAc,EACd,KAAK,EACL,IAAI,EACJ,eAAe,GAAG,IAAI,EACzB,GAAG,KAAK,CAAA;IACT,MAAM,EACF,OAAO,EACP,aAAa,EACb,IAAI,EACJ,eAAe,EAClB,GAAG,QAAQ,EAAE,CAAA;IAEd,MAAM,EAAC,UAAU,EAAE,UAAU,EAAC,GAAG,IAAI,CAAA;IACrC,MAAM,SAAS,GAAG,CAAC,WAAW,KAAK,YAAY,CAAC,MAAM,IAAI,WAAW,KAAK,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC;QACzF,UAAU,CAAC,CAAC;QACZ,UAAU,CAAA;IAEd,MAAM,EAAC,cAAc,EAAE,MAAM,EAAC,GAAG,iBAAiB,EAAE,CAAA;IAEpD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAC,GAAG,mBAAmB,EAAE,GAAG,KAAK,EAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IACjF,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,EAAC,GAAG,uBAAuB,EAAE,GAAG,IAAI,EAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;IAClF,qFAAqF;IACrF,yBAAyB;IACzB,MAAM,iBAAiB,GAAG,MAAM,CAA2B,SAAS,CAAC,CAAA;IAErE,MAAM,OAAO,GAAG,MAAM,CAAqC,IAAI,GAAG,EAAE,CAAC,CAAA;IACrE,SAAS,CACL,GAAG,EAAE;QACD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAiC,CAAA;QACrD,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAc,EAAE,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAA6B,CAAC,CAAC,CAAA;QACnG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAA;IAC1B,CAAC,EACD,CAAC,SAAS,CAAC,CACd,CAAA;IAED,2FAA2F;IAC3F,6BAA6B;IAC7B,SAAS,CACL,GAAG,EAAE;QACD,IAAI,aAAa,EAAE,CAAC;YAChB,IAAI,OAAO,EAAE,CAAC;gBACV,sEAAsE;gBACtE,gEAAgE;gBAChE,IAAI,iBAAiB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1C,iBAAiB,CAAC,OAAO,EAAE,CAAA;oBAC3B,iBAAiB,CAAC,OAAO,GAAG,SAAS,CAAA;gBACzC,CAAC;gBAED,MAAM,aAAa,GAAG,IAAI,GAAG,CACzB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;qBAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;qBAC7B,GAAG,CAAC,IAAI,CAAC,EAAE;oBACR,MAAM,SAAS,GAAG,cAAc,aAAd,cAAc,cAAd,cAAc,GAC5B,CAAC,CAAC,KAAa,EAAE,EAAE,CAAC,aAAa,KAAK,oBAAoB,CAAC,OAAO,CAAC,CAAC;wBAChE,EAAE,CAAC,CAAC;wBACJ,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,CAChC,CAAA;oBACL,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;gBAC5B,CAAC,CAAC,CACT,CAAA;gBAED,iBAAiB,CAAC,OAAO,GAAG,sBAAsB,CAC9C,aAAa,EACb,OAAO,EACP,cAAc,EACd,MAAM,EACN,YAAY,EACZ,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,eAAe,CAClB,CAAA;YACL,CAAC;YACD,yGAAyG;iBACpG,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC3D,iBAAiB,CAAC,OAAO,EAAE,CAAA;gBAC3B,iBAAiB,CAAC,OAAO,GAAG,SAAS,CAAA;YACzC,CAAC;QACL,CAAC;IACL,CAAC,EACD,CAAC,eAAe,EAAE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC,CACrK,CAAA;IAED,sDAAsD;IACtD,SAAS,CACL,GAAG,EAAE;QACD,OAAO,GAAG,EAAE;YACR,IAAI,iBAAiB,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1C,iBAAiB,CAAC,OAAO,EAAE,CAAA;gBAC3B,iBAAiB,CAAC,OAAO,GAAG,SAAS,CAAA;YACzC,CAAC;QACL,CAAC,CAAA;IACL,CAAC,EACD,EAAE,CACL,CAAA;IAED,OAAO,IAAI,CAAA;AACf,CAAC"}

package/dist/app/charts/trackers/trackerUtils.d.ts

@@ -1,42 +1,64 @@
-import { SvgSelection, TrackerSelection } from "../d3types";
-import { Dimensions, Margin } from "../styling/margins";
-import { AxisLocation, ContinuousNumericAxis } from "../axes/axes";
-import { TrackerAxisUpdate, TrackerLabelLocation } from "./Tracker";
+import type { CanvasContext } from "../d3types";
+import { type Dimensions, type Margin } from "../styling/margins";
+import { AxisLocation, type ContinuousNumericAxis } from "../axes/axes";
+import { type TrackerAxisUpdate } from "./Tracker";
+/**
+ * The font of the tracker's labels
+ */
 export interface TrackerLabelFont {
     size: number;
     color: string;
     family: string;
     weight: number;
 }
+/**
+ * The default font of the tracker's labels
+ */
 export declare const defaultTrackerLabelFont: TrackerLabelFont;
+/**
+ * The style of the tracker's line (and whether it's shown)
+ */
 export interface TrackerStyle {
     visible: boolean;
     color: string;
     lineWidth: number;
 }
+/**
+ * The default tracker style (hidden)
+ */
 export declare const defaultTrackerStyle: TrackerStyle;
 /**
- * Creates or returns the existing SVG elements for displaying a tracker line that is either
- * vertical (for x-axes) or horizontal (for y-axes).
+ * The location of the tracker label
+ * Note: replaces enums to support `erasableSyntaxOnly`
+ *  TS1294: This syntax is not allowed when 'erasableSyntaxOnly' is enabled.
+ */
+export declare const TrackerLabelLocation: {
+    readonly Nowhere: "Nowhere";
+    readonly ByAxis: "ByAxis";
+};
+export type TrackerLabelLocation = (typeof TrackerLabelLocation)[keyof typeof TrackerLabelLocation];
+/**
+ * Registers a tracker (a line that follows the mouse, with optional per-axis labels) with the
+ * canvas context. Replaces the old `trackerControlInstance`, which created SVG `<line>`/`<text>`/
+ * `<rect>` elements and updated them via a namespaced `mousemove` handler on the `<svg>`. The
+ * canvas version instead registers a draw function that reads the mouse's last-known position
+ * (tracked via its own `mousemove` listener on the canvas) and paints the tracker fresh every
+ * redraw.
+ * @param cc The canvas context to register the tracker's draw function with
  * @param chartId The ID of the chart
- * @param container The SVG container
- * @param svg The SVG selection
  * @param plotDimensions The dimensions of the plot
  * @param margin The margins around the plot
  * @param style The tracker style
  * @param labelFont The font used for the axis labels
- * @param label A function that returns the tracker label string for a given x-value
- * @param labelStyle The location style for the tracker (i.e. on the axes, next to the mouse, none shown)
+ * @param label A map associating each axis with the function that formats the tracker's label for that axis' value
+ * @param labelStyle Where the tracker's labels are shown (by the axes, or nowhere)
  * @param onTrackerUpdate A callback function that accepts the current tracker's axis information
  * @param [axisLocation = AxisLocation.Bottom] The optional location of the axis for which the tracker is to
  * be shown. Default is bottom.
  * @param backgroundColor The background color of the tracker label
- * @return The tracker selection
- */
-export declare function trackerControlInstance(chartId: number, container: SVGSVGElement, svg: SvgSelection, plotDimensions: Dimensions, margin: Margin, style: TrackerStyle, labelFont: TrackerLabelFont, label: Map<ContinuousNumericAxis, (x: number) => string>, labelStyle: TrackerLabelLocation, onTrackerUpdate: (update: TrackerAxisUpdate) => void, axisLocation: AxisLocation | undefined, backgroundColor: string): TrackerSelection;
-/**
- * Removes the tracker control from the chart
- * @param svg The svg selection holding the tracker control
- * @param axisLocation The location of the axis for which the tracker is to be removed.
+ * @return A cleanup function that unregisters the tracker's draw function and removes its
+ * `mousemove` listener. Call this when the tracker becomes invisible or unmounts (replaces the
+ * old `removeTrackerControl`).
  */
-export declare function removeTrackerControl(svg: SvgSelection, axisLocation: AxisLocation): void;
+export declare function trackerControlInstance(cc: CanvasContext, chartId: number, plotDimensions: Dimensions, margin: Margin, style: TrackerStyle, labelFont: TrackerLabelFont, label: Map<ContinuousNumericAxis, (x: number) => string>, labelStyle: TrackerLabelLocation, onTrackerUpdate: (update: TrackerAxisUpdate) => void, axisLocation: AxisLocation | undefined, backgroundColor: string): () => void;
+//# sourceMappingURL=trackerUtils.d.ts.map

package/dist/app/charts/trackers/trackerUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackerUtils.d.ts","sourceRoot":"","sources":["../../../../src/app/charts/trackers/trackerUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAa,MAAM,YAAY,CAAC;AAC1D,OAAO,EAA0B,KAAK,UAAU,EAAE,KAAK,MAAM,EAAC,MAAM,oBAAoB,CAAC;AAGzF,OAAO,EAAC,YAAY,EAAE,KAAK,qBAAqB,EAAC,MAAM,cAAc,CAAC;AACtE,OAAO,EAAuB,KAAK,iBAAiB,EAAC,MAAM,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,gBAKrC,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAIjC,CAAA;AAID;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;CAGvB,CAAA;AACV,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAA;AAQnG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CAClC,EAAE,EAAE,aAAa,EACjB,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,UAAU,EAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,YAAY,EACnB,SAAS,EAAE,gBAAgB,EAC3B,KAAK,EAAE,GAAG,CAAC,qBAAqB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,EACxD,UAAU,EAAE,oBAAoB,EAChC,eAAe,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,EACpD,YAAY,EAAE,YAAY,YAAsB,EAChD,eAAe,EAAE,MAAM,GACxB,MAAM,IAAI,CAUZ"}