@coinbase/cds-web 8.66.2 → 9.0.0-rc.1

package/dts/visualizations/chart/scrubber/Scrubber.d.ts

@@ -0,0 +1,390 @@
+import React from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import { type Transition } from 'framer-motion';
+import { type ReferenceLineBaseProps, type ReferenceLineLabelComponentProps } from '../line';
+import type { ChartTextChildren, ChartTextProps } from '../text';
+import { type ChartInset, type Series } from '../utils';
+import {
+  type ScrubberBeaconGroupBaseProps,
+  type ScrubberBeaconGroupProps,
+  type ScrubberBeaconGroupRef,
+} from './ScrubberBeaconGroup';
+import {
+  type ScrubberBeaconLabelGroupBaseProps,
+  type ScrubberBeaconLabelGroupProps,
+} from './ScrubberBeaconLabelGroup';
+export type ScrubberBeaconRef = {
+  /**
+   * Triggers a single pulse animation.
+   * Only works when the beacon is in idle state (not actively scrubbing).
+   */
+  pulse: () => void;
+};
+export type ScrubberBeaconBaseProps = {
+  /**
+   * Id of the series.
+   */
+  seriesId: Series['id'];
+  /**
+   * Color of the series.
+   */
+  color?: string;
+  /**
+   * X coordinate in data space.
+   * In vertical layout this is the scrubber index-axis value.
+   * In horizontal layout this is the series value.
+   */
+  dataX: number;
+  /**
+   * Y coordinate in data space.
+   * In vertical layout this is the series value.
+   * In horizontal layout this is the scrubber index-axis value.
+   */
+  dataY: number;
+  /**
+   * Whether the beacon is in idle state (not actively scrubbing).
+   */
+  isIdle?: boolean;
+  /**
+   * Pulse the beacon while it is at rest.
+   *
+   * @note Only has an effect when `isIdle` is `true`. Pulse animations work
+   * regardless of the chart's `animate` prop.
+   */
+  idlePulse?: boolean;
+  /**
+   * Whether position animations are enabled.
+   * @default to ChartContext's animate value
+   */
+  animate?: boolean;
+  /**
+   * Opacity of the beacon.
+   * @default 1
+   */
+  opacity?: number;
+  /**
+   * Stroke color of the beacon circle.
+   * @default 'var(--color-bg)'
+   */
+  stroke?: string;
+};
+export type ScrubberBeaconProps = SharedProps &
+  ScrubberBeaconBaseProps & {
+    /**
+     * Transition configuration for beacon animations.
+     */
+    transitions?: {
+      /**
+       * Transition for the initial enter/reveal animation.
+       * Set to `null` to disable.
+       */
+      enter?: Transition | null;
+      /**
+       * Transition for subsequent data update animations.
+       * Set to `null` to disable.
+       */
+      update?: Transition | null;
+      /**
+       * Transition used for the pulse animation.
+       * @default transition { duration: 1.6, ease: 'easeInOut' }
+       */
+      pulse?: Transition;
+      /**
+       * Delay, in seconds between pulse transitions
+       * when `idlePulse` is enabled.
+       * @default 0.4
+       */
+      pulseRepeatDelay?: number;
+    };
+    /**
+     * Custom className for styling.
+     */
+    className?: string;
+    /**
+     * Custom inline styles.
+     */
+    style?: React.CSSProperties;
+  };
+export type ScrubberBeaconComponent = React.FC<
+  ScrubberBeaconProps & {
+    ref?: React.Ref<ScrubberBeaconRef>;
+  }
+>;
+export type ScrubberBeaconLabelProps = Pick<Series, 'color'> &
+  Pick<
+    ChartTextProps,
+    | 'x'
+    | 'y'
+    | 'dx'
+    | 'horizontalAlignment'
+    | 'onDimensionsChange'
+    | 'opacity'
+    | 'font'
+    | 'className'
+    | 'style'
+  > & {
+    /**
+     * Label for the series.
+     */
+    label: ChartTextChildren;
+    /**
+     * Id of the series.
+     */
+    seriesId: Series['id'];
+    /**
+     * Transition configuration for position animations.
+     * When provided, the label component should animate its y position using this transition.
+     */
+    transition?: Transition;
+  };
+export type ScrubberBeaconLabelComponent = React.FC<ScrubberBeaconLabelProps>;
+export type ScrubberLabelProps = ReferenceLineLabelComponentProps;
+export type ScrubberLabelComponent = React.FC<ScrubberLabelProps>;
+export type ScrubberBaseProps = SharedProps &
+  Pick<ScrubberBeaconGroupBaseProps, 'idlePulse'> &
+  Pick<ReferenceLineBaseProps, 'LineComponent' | 'LabelComponent' | 'labelElevated'> &
+  Pick<ScrubberBeaconGroupProps, 'BeaconComponent'> &
+  Pick<ScrubberBeaconLabelGroupProps, 'BeaconLabelComponent'> & {
+    /**
+     * Array of series IDs to highlight when scrubbing with scrubber beacons.
+     * By default, all series will be highlighted.
+     */
+    seriesIds?: string[];
+    /**
+     * Hides the beacon labels while keeping the line label visible (if provided).
+     * @default true in horizontal layout, false in vertical layout.
+     * @note Beacon labels are always hidden in horizontal layout, and cannot be overridden.
+     */
+    hideBeaconLabels?: boolean;
+    /**
+     * Hides the scrubber line.
+     * @note This hides Scrubber's ReferenceLine including the label.
+     */
+    hideLine?: boolean;
+    /**
+     * Hides the overlay rect which obscures data beyond the scrubber position.
+     */
+    hideOverlay?: boolean;
+    /**
+     * Offset of the overlay rect relative to the drawing area.
+     * Useful for when scrubbing over lines, where the stroke width would cause part of the line to be visible.
+     * @default 2
+     */
+    overlayOffset?: number;
+    /**
+     * Minimum gap between beacon labels to prevent overlap.
+     * Measured in pixels.
+     */
+    beaconLabelMinGap?: ScrubberBeaconLabelGroupBaseProps['labelMinGap'];
+    /**
+     * Horizontal offset for beacon labels from their beacon position.
+     * Measured in pixels.
+     */
+    beaconLabelHorizontalOffset?: ScrubberBeaconLabelGroupBaseProps['labelHorizontalOffset'];
+    /**
+     * Preferred side for beacon labels.
+     * @note labels will switch to the opposite side if there's not enough space on the preferred side.
+     * @default 'right'
+     */
+    beaconLabelPreferredSide?: ScrubberBeaconLabelGroupBaseProps['labelPreferredSide'];
+    /**
+     * Label text displayed above the scrubber line.
+     * Can be a static string or a function that receives the current dataIndex.
+     */
+    label?:
+      | ReferenceLineBaseProps['label']
+      | ((dataIndex: number) => ReferenceLineBaseProps['label']);
+    /**
+     * Font style for the scrubber line label.
+     */
+    labelFont?: ChartTextProps['font'];
+    /**
+     * Bounds inset for the scrubber line label to prevent cutoff at chart edges.
+     * @default inset { top: 4, bottom: 20, left: 12, right: 12 } when labelElevated is true, otherwise none
+     */
+    labelBoundsInset?: number | ChartInset;
+    /**
+     * Font style for the beacon labels.
+     */
+    beaconLabelFont?: ChartTextProps['font'];
+    /**
+     * Stroke color for the scrubber line.
+     */
+    lineStroke?: ReferenceLineBaseProps['stroke'];
+    /**
+     * Stroke color of the scrubber beacon circle.
+     * @default 'var(--color-bg)'
+     */
+    beaconStroke?: string;
+  };
+export type ScrubberProps = ScrubberBaseProps & {
+  /**
+   * Transition configuration for the scrubber.
+   * Controls enter, update, and pulse animations for beacons and beacon labels.
+   */
+  transitions?: ScrubberBeaconProps['transitions'];
+  /**
+   * Transition configuration for the scrubber beacon.
+   * @deprecated Use `transitions` instead. This will be removed in a future major release.
+   * @deprecationExpectedRemoval v4
+   */
+  beaconTransitions?: ScrubberBeaconProps['transitions'];
+  /**
+   * Accessibility label for the scrubber. Can be a static string or a function that receives the current dataIndex.
+   * If not provided, label will be used if it resolves to a string.
+   */
+  accessibilityLabel?: string | ((dataIndex: number) => string);
+  /** Custom styles for individual elements of the Scrubber component */
+  styles?: {
+    /** Overlay element */
+    overlay?: React.CSSProperties;
+    /** Beacon circle element */
+    beacon?: React.CSSProperties;
+    /** Scrubber line element */
+    line?: React.CSSProperties;
+    /** Scrubber line label element */
+    label?: React.CSSProperties;
+    /** Beacon label element */
+    beaconLabel?: React.CSSProperties;
+  };
+  /** Custom class names for individual elements of the Scrubber component */
+  classNames?: {
+    /** Overlay element */
+    overlay?: string;
+    /** Beacon circle element */
+    beacon?: string;
+    /** Scrubber line element */
+    line?: string;
+    /** Scrubber line label element */
+    label?: string;
+    /** Beacon label element */
+    beaconLabel?: string;
+  };
+};
+export type ScrubberRef = ScrubberBeaconGroupRef;
+/**
+ * Unified component that manages all scrubber elements (beacons, line, labels).
+ */
+export declare const Scrubber: React.NamedExoticComponent<
+  SharedProps &
+    Pick<ScrubberBeaconGroupBaseProps, 'idlePulse'> &
+    Pick<ReferenceLineBaseProps, 'LabelComponent' | 'LineComponent' | 'labelElevated'> &
+    Pick<ScrubberBeaconGroupProps, 'BeaconComponent'> &
+    Pick<ScrubberBeaconLabelGroupProps, 'BeaconLabelComponent'> & {
+      /**
+       * Array of series IDs to highlight when scrubbing with scrubber beacons.
+       * By default, all series will be highlighted.
+       */
+      seriesIds?: string[];
+      /**
+       * Hides the beacon labels while keeping the line label visible (if provided).
+       * @default true in horizontal layout, false in vertical layout.
+       * @note Beacon labels are always hidden in horizontal layout, and cannot be overridden.
+       */
+      hideBeaconLabels?: boolean;
+      /**
+       * Hides the scrubber line.
+       * @note This hides Scrubber's ReferenceLine including the label.
+       */
+      hideLine?: boolean;
+      /**
+       * Hides the overlay rect which obscures data beyond the scrubber position.
+       */
+      hideOverlay?: boolean;
+      /**
+       * Offset of the overlay rect relative to the drawing area.
+       * Useful for when scrubbing over lines, where the stroke width would cause part of the line to be visible.
+       * @default 2
+       */
+      overlayOffset?: number;
+      /**
+       * Minimum gap between beacon labels to prevent overlap.
+       * Measured in pixels.
+       */
+      beaconLabelMinGap?: ScrubberBeaconLabelGroupBaseProps['labelMinGap'];
+      /**
+       * Horizontal offset for beacon labels from their beacon position.
+       * Measured in pixels.
+       */
+      beaconLabelHorizontalOffset?: ScrubberBeaconLabelGroupBaseProps['labelHorizontalOffset'];
+      /**
+       * Preferred side for beacon labels.
+       * @note labels will switch to the opposite side if there's not enough space on the preferred side.
+       * @default 'right'
+       */
+      beaconLabelPreferredSide?: ScrubberBeaconLabelGroupBaseProps['labelPreferredSide'];
+      /**
+       * Label text displayed above the scrubber line.
+       * Can be a static string or a function that receives the current dataIndex.
+       */
+      label?:
+        | ReferenceLineBaseProps['label']
+        | ((dataIndex: number) => ReferenceLineBaseProps['label']);
+      /**
+       * Font style for the scrubber line label.
+       */
+      labelFont?: ChartTextProps['font'];
+      /**
+       * Bounds inset for the scrubber line label to prevent cutoff at chart edges.
+       * @default inset { top: 4, bottom: 20, left: 12, right: 12 } when labelElevated is true, otherwise none
+       */
+      labelBoundsInset?: number | ChartInset;
+      /**
+       * Font style for the beacon labels.
+       */
+      beaconLabelFont?: ChartTextProps['font'];
+      /**
+       * Stroke color for the scrubber line.
+       */
+      lineStroke?: ReferenceLineBaseProps['stroke'];
+      /**
+       * Stroke color of the scrubber beacon circle.
+       * @default 'var(--color-bg)'
+       */
+      beaconStroke?: string;
+    } & {
+      /**
+       * Transition configuration for the scrubber.
+       * Controls enter, update, and pulse animations for beacons and beacon labels.
+       */
+      transitions?: ScrubberBeaconProps['transitions'];
+      /**
+       * Transition configuration for the scrubber beacon.
+       * @deprecated Use `transitions` instead. This will be removed in a future major release.
+       * @deprecationExpectedRemoval v4
+       */
+      beaconTransitions?: ScrubberBeaconProps['transitions'];
+      /**
+       * Accessibility label for the scrubber. Can be a static string or a function that receives the current dataIndex.
+       * If not provided, label will be used if it resolves to a string.
+       */
+      accessibilityLabel?: string | ((dataIndex: number) => string);
+      /** Custom styles for individual elements of the Scrubber component */
+      styles?: {
+        /** Overlay element */
+        overlay?: React.CSSProperties;
+        /** Beacon circle element */
+        beacon?: React.CSSProperties;
+        /** Scrubber line element */
+        line?: React.CSSProperties;
+        /** Scrubber line label element */
+        label?: React.CSSProperties;
+        /** Beacon label element */
+        beaconLabel?: React.CSSProperties;
+      };
+      /** Custom class names for individual elements of the Scrubber component */
+      classNames?: {
+        /** Overlay element */
+        overlay?: string;
+        /** Beacon circle element */
+        beacon?: string;
+        /** Scrubber line element */
+        line?: string;
+        /** Scrubber line label element */
+        label?: string;
+        /** Beacon label element */
+        beaconLabel?: string;
+      };
+    } & React.RefAttributes<ScrubberBeaconGroupRef>
+>;
+//# sourceMappingURL=Scrubber.d.ts.map

package/dts/visualizations/chart/scrubber/Scrubber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scrubber.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/scrubber/Scrubber.tsx"],"names":[],"mappings":"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"}

package/dts/visualizations/chart/scrubber/ScrubberBeaconGroup.d.ts

@@ -0,0 +1,78 @@
+import type { SharedProps } from '@coinbase/cds-common/types';
+import type { ScrubberBeaconComponent, ScrubberBeaconProps } from './Scrubber';
+export type ScrubberBeaconGroupRef = {
+  /**
+   * Triggers a pulse animation on all beacons.
+   */
+  pulse: () => void;
+};
+export type ScrubberBeaconGroupBaseProps = SharedProps & {
+  /**
+   * Array of series IDs to render beacons for.
+   */
+  seriesIds: string[];
+  /**
+   * Pulse the beacons while at rest.
+   */
+  idlePulse?: boolean;
+};
+export type ScrubberBeaconGroupProps = ScrubberBeaconGroupBaseProps & {
+  /**
+   * Transition configuration for beacon animations.
+   */
+  transitions?: ScrubberBeaconProps['transitions'];
+  /**
+   * Custom component for the scrubber beacon.
+   * @default DefaultScrubberBeacon
+   */
+  BeaconComponent?: ScrubberBeaconComponent;
+  /**
+   * Custom className for beacon styling.
+   */
+  className?: string;
+  /**
+   * Custom inline styles for beacons.
+   */
+  style?: React.CSSProperties;
+  /**
+   * Stroke color of the beacon circle.
+   * @default 'var(--color-bg)'
+   */
+  stroke?: string;
+};
+export declare const ScrubberBeaconGroup: import('react').NamedExoticComponent<
+  SharedProps & {
+    /**
+     * Array of series IDs to render beacons for.
+     */
+    seriesIds: string[];
+    /**
+     * Pulse the beacons while at rest.
+     */
+    idlePulse?: boolean;
+  } & {
+    /**
+     * Transition configuration for beacon animations.
+     */
+    transitions?: ScrubberBeaconProps['transitions'];
+    /**
+     * Custom component for the scrubber beacon.
+     * @default DefaultScrubberBeacon
+     */
+    BeaconComponent?: ScrubberBeaconComponent;
+    /**
+     * Custom className for beacon styling.
+     */
+    className?: string;
+    /**
+     * Custom inline styles for beacons.
+     */
+    style?: React.CSSProperties;
+    /**
+     * Stroke color of the beacon circle.
+     * @default 'var(--color-bg)'
+     */
+    stroke?: string;
+  } & import('react').RefAttributes<ScrubberBeaconGroupRef>
+>;
+//# sourceMappingURL=ScrubberBeaconGroup.d.ts.map

package/dts/visualizations/chart/scrubber/ScrubberBeaconGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberBeaconGroup.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/scrubber/ScrubberBeaconGroup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAY9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AA+HlG,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,WAAW,GAAG;IACvD;;OAEG;IACH,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,4BAA4B,GAAG;IACpE;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD;;;OAGG;IACH,eAAe,CAAC,EAAE,uBAAuB,CAAC;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,mBAAmB;IAnC9B;;OAEG;eACQ,MAAM,EAAE;IACnB;;OAEG;gBACS,OAAO;;IAInB;;OAEG;kBACW,mBAAmB,CAAC,aAAa,CAAC;IAChD;;;OAGG;sBACe,uBAAuB;IACzC;;OAEG;gBACS,MAAM;IAClB;;OAEG;YACK,KAAK,CAAC,aAAa;IAC3B;;;OAGG;aACM,MAAM;0DA+FhB,CAAC"}

package/dts/visualizations/chart/scrubber/ScrubberBeaconLabelGroup.d.ts

@@ -0,0 +1,56 @@
+import { type CSSProperties } from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import type { ChartTextProps } from '../text';
+import { type ScrubberLabelPosition } from '../utils/scrubber';
+import type {
+  ScrubberBeaconLabelComponent,
+  ScrubberBeaconLabelProps,
+  ScrubberBeaconProps,
+} from './Scrubber';
+export type ScrubberBeaconLabelGroupBaseProps = SharedProps & {
+  /**
+   * Labels to be displayed.
+   */
+  labels: Array<Pick<ScrubberBeaconLabelProps, 'seriesId' | 'label' | 'color'>>;
+  /**
+   * Minimum gap between labels in pixels.
+   * @default 4
+   */
+  labelMinGap?: number;
+  /**
+   * Horizontal offset of labels from the scrubber line in pixels.
+   * @default 16
+   */
+  labelHorizontalOffset?: number;
+  /**
+   * Font style for the beacon labels.
+   */
+  labelFont?: ChartTextProps['font'];
+  /**
+   * Preferred side for labels.
+   * @note labels will switch to the opposite side if there's not enough space on the preferred side.
+   * @default 'right'
+   */
+  labelPreferredSide?: ScrubberLabelPosition;
+};
+export type ScrubberBeaconLabelGroupProps = ScrubberBeaconLabelGroupBaseProps & {
+  /**
+   * Custom component to render as a scrubber beacon label.
+   * @default DefaultScrubberBeaconLabel
+   */
+  BeaconLabelComponent?: ScrubberBeaconLabelComponent;
+  /**
+   * Transition configuration for beacon label animations.
+   */
+  transitions?: ScrubberBeaconProps['transitions'];
+  /**
+   * Custom class name for each beacon label.
+   */
+  className?: string;
+  /**
+   * Custom inline styles for each beacon label.
+   */
+  style?: CSSProperties;
+};
+export declare const ScrubberBeaconLabelGroup: import('react').NamedExoticComponent<ScrubberBeaconLabelGroupProps>;
+//# sourceMappingURL=ScrubberBeaconLabelGroup.d.ts.map

package/dts/visualizations/chart/scrubber/ScrubberBeaconLabelGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberBeaconLabelGroup.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/scrubber/ScrubberBeaconLabelGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAwC,MAAM,OAAO,CAAC;AAEjF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,SAAS,CAAC;AAQjE,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,KAAK,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA+DpB,MAAM,MAAM,iCAAiC,GAAG,WAAW,GAAG;IAC5D;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAC9E;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,qBAAqB,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,iCAAiC,GAAG;IAC9E;;;OAGG;IACH,oBAAoB,CAAC,EAAE,4BAA4B,CAAC;IACpD;;OAEG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,wBAAwB,qEA0MpC,CAAC"}

package/dts/visualizations/chart/scrubber/ScrubberProvider.d.ts

@@ -0,0 +1,17 @@
+import React from 'react';
+import { type ScrubberContextValue } from '../utils';
+export type ScrubberProviderProps = Partial<
+  Pick<ScrubberContextValue, 'enableScrubbing' | 'onScrubberPositionChange'>
+> & {
+  children: React.ReactNode;
+  /**
+   * A reference to the root SVG element, where interaction event handlers will be attached.
+   */
+  svgRef: React.RefObject<SVGSVGElement | null> | null;
+};
+/**
+ * A component which encapsulates the ScrubberContext.
+ * It depends on a ChartContext in order to provide accurate mouse tracking.
+ */
+export declare const ScrubberProvider: React.FC<ScrubberProviderProps>;
+//# sourceMappingURL=ScrubberProvider.d.ts.map

package/dts/visualizations/chart/scrubber/ScrubberProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberProvider.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/scrubber/ScrubberProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoD,MAAM,OAAO,CAAC;AAGzE,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,GAAG,0BAA0B,CAAC,CAC3E,GAAG;IACF,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;OAEG;IACH,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;CACtD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAwR5D,CAAC"}

package/dts/visualizations/chart/scrubber/index.d.ts

@@ -0,0 +1,5 @@
+export * from './DefaultScrubberBeacon';
+export * from './DefaultScrubberBeaconLabel';
+export * from './DefaultScrubberLabel';
+export * from './Scrubber';
+//# sourceMappingURL=index.d.ts.map

package/dts/visualizations/chart/scrubber/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/scrubber/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC"}