@coinbase/cds-web-visualization 3.4.0-beta.2 → 3.4.0-beta.20

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

@@ -1,27 +1,154 @@
 import React from 'react';
 import type { SharedProps } from '@coinbase/cds-common/types';
-import { type ReferenceLineProps } from '../line';
-import { type ScrubberBeaconProps, type ScrubberBeaconRef } from './ScrubberBeacon';
-import { type ScrubberBeaconLabelProps } from './ScrubberBeaconLabel';
-export type ScrubberRef = ScrubberBeaconRef;
-/**
- * Configuration for scrubber functionality across chart components.
- * Provides consistent API with smart defaults and component customization.
- */
-export type ScrubberProps = SharedProps &
-  Pick<ScrubberBeaconProps, 'idlePulse'> & {
+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.
+   */
+  dataX: number;
+  /**
+   * Y coordinate in data space.
+   */
+  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'
+  > & {
+    /**
+     * 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'> & {
     /**
-     * An array of series IDs that will receive visual emphasis as the user scrubs through the chart.
-     * Use this prop to restrict the scrubbing visual behavior to specific series.
-     * By default, all series will be highlighted by the Scrubber.
+     * Array of series IDs to highlight when scrubbing with scrubber beacons.
+     * By default, all series will be highlighted.
      */
     seriesIds?: string[];
     /**
-     * Hides the scrubber line
+     * Hides the beacon labels while keeping the line label visible (if provided).
+     */
+    hideBeaconLabels?: boolean;
+    /**
+     * Hides the scrubber line.
+     * @note This hides Scrubber's ReferenceLine including the label.
      */
     hideLine?: boolean;
     /**
-     * Whether to hide the overlay rect which obscures future data.
+     * Hides the overlay rect which obscures data beyond the scrubber position.
      */
     hideOverlay?: boolean;
     /**
@@ -31,68 +158,117 @@ export type ScrubberProps = SharedProps &
      */
     overlayOffset?: number;
     /**
-     * Label text displayed above the scrubber line.
+     * Minimum gap between beacon labels to prevent overlap.
+     * Measured in pixels.
      */
-    label?: ReferenceLineProps['label'] | ((dataIndex: number) => ReferenceLineProps['label']);
+    beaconLabelMinGap?: ScrubberBeaconLabelGroupBaseProps['labelMinGap'];
     /**
-     * Props passed to the scrubber line's label.
+     * Horizontal offset for beacon labels from their beacon position.
+     * Measured in pixels.
      */
-    labelProps?: ReferenceLineProps['labelProps'];
+    beaconLabelHorizontalOffset?: ScrubberBeaconLabelGroupBaseProps['labelHorizontalOffset'];
     /**
-     * Stroke color for the scrubber line.
+     * 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'
      */
-    lineStroke?: ReferenceLineProps['stroke'];
+    beaconLabelPreferredSide?: ScrubberBeaconLabelGroupBaseProps['labelPreferredSide'];
     /**
-     * Custom styles for scrubber elements.
+     * Label text displayed above the scrubber line.
+     * Can be a static string or a function that receives the current dataIndex.
      */
-    styles?: {
-      overlay?: React.CSSProperties;
-      beacon?: React.CSSProperties;
-      line?: React.CSSProperties;
-      beaconLabel?: React.CSSProperties;
-    };
+    label?:
+      | ReferenceLineBaseProps['label']
+      | ((dataIndex: number) => ReferenceLineBaseProps['label']);
     /**
-     * Custom class names for scrubber elements.
+     * Font style for the scrubber line label.
      */
-    classNames?: {
-      overlay?: string;
-      beacon?: string;
-      line?: string;
-      beaconLabel?: string;
-    };
+    labelFont?: ChartTextProps['font'];
     /**
-     * Custom component for the scrubber beacon.
+     * 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
      */
-    BeaconComponent?: React.ComponentType<ScrubberBeaconProps>;
+    labelBoundsInset?: number | ChartInset;
     /**
-     * Custom component for the scrubber beacon label.
+     * Font style for the beacon labels.
+     */
+    beaconLabelFont?: ChartTextProps['font'];
+    /**
+     * Stroke color for the scrubber line.
      */
-    BeaconLabelComponent?: React.ComponentType<ScrubberBeaconLabelProps>;
+    lineStroke?: ReferenceLineBaseProps['stroke'];
     /**
-     * Custom component for the scrubber line.
+     * Stroke color of the scrubber beacon circle.
+     * @default 'var(--color-bg)'
      */
-    LineComponent?: React.ComponentType<ReferenceLineProps>;
+    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.
+   */
+  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;
+    /** 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;
+    /** Beacon label element */
+    beaconLabel?: string;
+  };
+};
+export type ScrubberRef = ScrubberBeaconGroupRef;
 /**
- * Unified component that manages all scrubber elements (beacons, line, labels)
- * with intelligent collision detection and consistent positioning.
+ * Unified component that manages all scrubber elements (beacons, line, labels).
  */
 export declare const Scrubber: React.MemoExoticComponent<
   React.ForwardRefExoticComponent<
     SharedProps &
-      Pick<ScrubberBeaconProps, 'idlePulse'> & {
+      Pick<ScrubberBeaconGroupBaseProps, 'idlePulse'> &
+      Pick<ReferenceLineBaseProps, 'LabelComponent' | 'LineComponent' | 'labelElevated'> &
+      Pick<ScrubberBeaconGroupProps, 'BeaconComponent'> &
+      Pick<ScrubberBeaconLabelGroupProps, 'BeaconLabelComponent'> & {
         /**
-         * An array of series IDs that will receive visual emphasis as the user scrubs through the chart.
-         * Use this prop to restrict the scrubbing visual behavior to specific series.
-         * By default, all series will be highlighted by the Scrubber.
+         * Array of series IDs to highlight when scrubbing with scrubber beacons.
+         * By default, all series will be highlighted.
          */
         seriesIds?: string[];
         /**
-         * Hides the scrubber line
+         * Hides the beacon labels while keeping the line label visible (if provided).
+         */
+        hideBeaconLabels?: boolean;
+        /**
+         * Hides the scrubber line.
+         * @note This hides Scrubber's ReferenceLine including the label.
          */
         hideLine?: boolean;
         /**
-         * Whether to hide the overlay rect which obscures future data.
+         * Hides the overlay rect which obscures data beyond the scrubber position.
          */
         hideOverlay?: boolean;
         /**
@@ -101,49 +277,90 @@ export declare const Scrubber: React.MemoExoticComponent<
          * @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
          */
-        label?: ReferenceLineProps['label'] | ((dataIndex: number) => ReferenceLineProps['label']);
+        labelBoundsInset?: number | ChartInset;
         /**
-         * Props passed to the scrubber line's label.
+         * Font style for the beacon labels.
          */
-        labelProps?: ReferenceLineProps['labelProps'];
+        beaconLabelFont?: ChartTextProps['font'];
         /**
          * Stroke color for the scrubber line.
          */
-        lineStroke?: ReferenceLineProps['stroke'];
+        lineStroke?: ReferenceLineBaseProps['stroke'];
         /**
-         * Custom styles for scrubber elements.
+         * 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.
+         */
+        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;
+          /** Beacon label element */
           beaconLabel?: React.CSSProperties;
         };
-        /**
-         * Custom class names for scrubber elements.
-         */
+        /** 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;
+          /** Beacon label element */
           beaconLabel?: string;
         };
-        /**
-         * Custom component for the scrubber beacon.
-         */
-        BeaconComponent?: React.ComponentType<ScrubberBeaconProps>;
-        /**
-         * Custom component for the scrubber beacon label.
-         */
-        BeaconLabelComponent?: React.ComponentType<ScrubberBeaconLabelProps>;
-        /**
-         * Custom component for the scrubber line.
-         */
-        LineComponent?: React.ComponentType<ReferenceLineProps>;
-      } & React.RefAttributes<ScrubberBeaconRef>
+      } & React.RefAttributes<ScrubberBeaconGroupRef>
   >
 >;
 //# sourceMappingURL=Scrubber.d.ts.map

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

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

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

@@ -0,0 +1,80 @@
+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').MemoExoticComponent<
+  import('react').ForwardRefExoticComponent<
+    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/chart/scrubber/ScrubberBeaconGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberBeaconGroup.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/ScrubberBeaconGroup.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAW9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AAyGlG,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;2DAyFhB,CAAC"}

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

@@ -0,0 +1,47 @@
+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'];
+};
+export declare const ScrubberBeaconLabelGroup: import('react').NamedExoticComponent<ScrubberBeaconLabelGroupProps>;
+//# sourceMappingURL=ScrubberBeaconLabelGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberBeaconLabelGroup.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/ScrubberBeaconLabelGroup.tsx"],"names":[],"mappings":"AAEA,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;AAyDpB,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;CAClD,CAAC;AAEF,eAAO,MAAM,wBAAwB,qEAsMpC,CAAC"}

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

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

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

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