@coinbase/cds-mobile-visualization 3.4.0-beta.2 → 3.4.0-beta.21

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultScrubberBeaconLabel.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/DefaultScrubberBeaconLabel.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAK3D,MAAM,MAAM,+BAA+B,GAAG,wBAAwB,GACpE,IAAI,CACF,cAAc,EACd,YAAY,GAAG,UAAU,GAAG,cAAc,GAAG,MAAM,GAAG,mBAAmB,GAAG,OAAO,GAAG,SAAS,CAChG,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,0BAA0B,uEAkCtC,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { ScrubberLabelProps } from './Scrubber';
+export type DefaultScrubberLabelProps = ScrubberLabelProps;
+/**
+ * DefaultScrubberLabel is the default label component for the scrubber line.
+ * It will automatically add padding around the label when elevated to fit within chart bounds to prevent shadow from being cutoff.
+ * It will also center the label vertically with the top available area.
+ */
+export declare const DefaultScrubberLabel: import('react').NamedExoticComponent<
+  import('..').ReferenceLineLabelComponentProps
+>;
+//# sourceMappingURL=DefaultScrubberLabel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultScrubberLabel.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/DefaultScrubberLabel.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,qFAahC,CAAC"}

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

@@ -1,25 +1,139 @@
 import React from 'react';
-import type { SharedProps } from '@coinbase/cds-common/types';
-import { type ReferenceLineProps } from '../line';
-import { type ScrubberBeaconProps, type ScrubberBeaconRef } from './ScrubberBeacon';
-/**
- * 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 AnimatedProp, type SkParagraph } from '@shopify/react-native-skia';
+import { type ReferenceLineBaseProps, type ReferenceLineLabelComponentProps } from '../line';
+import type { ChartTextChildren, ChartTextProps } from '../text';
+import { type ChartInset, type Series } from '../utils';
+import type { Transition } from '../utils/transition';
+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 beacon.
+   */
+  color?: AnimatedProp<string>;
+  /**
+   * X coordinate in data space.
+   */
+  dataX: AnimatedProp<number>;
+  /**
+   * Y coordinate in data space.
+   */
+  dataY: AnimatedProp<number>;
+  /**
+   * Whether the beacon is in idle state (not actively scrubbing).
+   */
+  isIdle: AnimatedProp<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?: AnimatedProp<number>;
+  /**
+   * Stroke color of the beacon circle.
+   * @default theme.color.bg
+   */
+  stroke?: string;
+};
+export type ScrubberBeaconProps = 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 { type: 'timing', duration: 1600, easing: Easing.bezier(0.0, 0.0, 0.0, 1.0) }
+     */
+    pulse?: Transition;
+    /**
+     * Delay, in milliseconds between pulse transitions
+     * when `idlePulse` is enabled.
+     * @default 400
+     */
+    pulseRepeatDelay?: number;
+  };
+};
+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'];
+  };
+export type ScrubberBeaconLabelComponent = React.FC<ScrubberBeaconLabelProps>;
+export type ScrubberLabelProps = ReferenceLineLabelComponentProps;
+export type ScrubberLabelComponent = React.FC<ScrubberLabelProps>;
+export type ScrubberBaseProps = 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;
     /**
@@ -28,48 +142,88 @@ export type ScrubberProps = SharedProps &
      * @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?: ReferenceLineProps['label'] | ((dataIndex: number) => ReferenceLineProps['label']);
+    label?: string | SkParagraph | ((dataIndex: number) => string | SkParagraph);
     /**
-     * Props passed to the scrubber line's label.
+     * Font style for the scrubber line label.
      */
-    labelProps?: ReferenceLineProps['labelProps'];
+    labelFont?: ChartTextProps['font'];
     /**
-     * Stroke color for the scrubber line.
+     * Bounds inset for the scrubber line label to prevent cutoff at chart edges.
+     * @default { top: 4, bottom: 20, left: 12, right: 12 } when labelElevated is true, otherwise none
      */
-    lineStroke?: ReferenceLineProps['stroke'];
+    labelBoundsInset?: number | ChartInset;
     /**
-     * Custom component for the scrubber beacon.
+     * Font style for the beacon labels.
      */
-    BeaconComponent?: React.ComponentType<ScrubberBeaconProps>;
+    beaconLabelFont?: ChartTextProps['font'];
     /**
-     * Custom component for the scrubber line.
+     * Stroke color for the scrubber line.
      */
-    LineComponent?: React.ComponentType<ReferenceLineProps>;
+    lineStroke?: ReferenceLineBaseProps['stroke'];
+    /**
+     * Stroke color of the scrubber beacon circle.
+     * @default theme.color.bg
+     */
+    beaconStroke?: string;
   };
-export type ScrubberRef = ScrubberBeaconRef;
+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'];
+};
+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;
         /**
@@ -78,27 +232,61 @@ 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?: string | SkParagraph | ((dataIndex: number) => string | SkParagraph);
+        /**
+         * Font style for the scrubber line label.
+         */
+        labelFont?: ChartTextProps['font'];
+        /**
+         * Bounds inset for the scrubber line label to prevent cutoff at chart edges.
+         * @default { 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'];
+        /**
+         * Stroke color of the scrubber beacon circle.
+         * @default theme.color.bg
+         */
+        beaconStroke?: string;
+      } & {
         /**
-         * Custom component for the scrubber beacon.
+         * Transition configuration for the scrubber.
+         * Controls enter, update, and pulse animations for beacons and beacon labels.
          */
-        BeaconComponent?: React.ComponentType<ScrubberBeaconProps>;
+        transitions?: ScrubberBeaconProps['transitions'];
         /**
-         * Custom component for the scrubber line.
+         * Transition configuration for the scrubber beacon.
+         * @deprecated Use `transitions` instead.
          */
-        LineComponent?: React.ComponentType<ReferenceLineProps>;
-      } & React.RefAttributes<ScrubberBeaconRef>
+        beaconTransitions?: ScrubberBeaconProps['transitions'];
+      } & 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":"AAAA,OAAO,KAQN,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D,OAAO,EAAiB,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAGjE,OAAO,EAAkB,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAIpG;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,WAAW,GACrC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,GAAG;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3F;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAE9C;;OAEG;IACH,UAAU,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAE1C;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;IAE3D;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC,CAAC;CACzD,CAAC;AAEJ,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,QAAQ;IAxDjB;;;;OAIG;gBACS,MAAM,EAAE;IAEpB;;OAEG;eACQ,OAAO;IAElB;;OAEG;kBACW,OAAO;IAErB;;;;OAIG;oBACa,MAAM;IAEtB;;OAEG;YACK,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE1F;;OAEG;iBACU,kBAAkB,CAAC,YAAY,CAAC;IAE7C;;OAEG;iBACU,kBAAkB,CAAC,QAAQ,CAAC;IAEzC;;OAEG;sBACe,KAAK,CAAC,aAAa,CAAC,mBAAmB,CAAC;IAE1D;;OAEG;oBACa,KAAK,CAAC,aAAa,CAAC,kBAAkB,CAAC;4CAmM1D,CAAC"}
+{"version":3,"file":"Scrubber.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/Scrubber.tsx"],"names":[],"mappings":"AAAA,OAAO,KAON,MAAM,OAAO,CAAC;AAQf,OAAO,EAAE,KAAK,YAAY,EAAe,KAAK,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9F,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,gCAAgC,EACtC,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EACL,KAAK,UAAU,EAIf,KAAK,MAAM,EAEZ,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKtD,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC5B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,6BAA6B,EACnC,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACvB;;OAEG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,KAAK,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC5B;;OAEG;IACH,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GAAG;IAC1D;;OAEG;IACH,WAAW,CAAC,EAAE;QACZ;;;WAGG;QACH,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC1B;;;WAGG;QACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC3B;;;WAGG;QACH,KAAK,CAAC,EAAE,UAAU,CAAC;QACnB;;;;WAIG;QACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,KAAK,CAAC,EAAE,CAC5C,mBAAmB,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,CAC7D,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,GAC1D,IAAI,CACF,cAAc,EACd,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,qBAAqB,GAAG,oBAAoB,GAAG,SAAS,GAAG,MAAM,CACrF,GAAG;IACF;;OAEG;IACH,KAAK,EAAE,iBAAiB,CAAC;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AACJ,MAAM,MAAM,4BAA4B,GAAG,KAAK,CAAC,EAAE,CAAC,wBAAwB,CAAC,CAAC;AAE9E,MAAM,MAAM,kBAAkB,GAAG,gCAAgC,CAAC;AAClE,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,4BAA4B,EAAE,WAAW,CAAC,GAC7E,IAAI,CAAC,sBAAsB,EAAE,eAAe,GAAG,gBAAgB,GAAG,eAAe,CAAC,GAClF,IAAI,CAAC,wBAAwB,EAAE,iBAAiB,CAAC,GACjD,IAAI,CAAC,6BAA6B,EAAE,sBAAsB,CAAC,GAAG;IAC5D;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,iCAAiC,CAAC,aAAa,CAAC,CAAC;IACrE;;;OAGG;IACH,2BAA2B,CAAC,EAAE,iCAAiC,CAAC,uBAAuB,CAAC,CAAC;IACzF;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,iCAAiC,CAAC,oBAAoB,CAAC,CAAC;IACnF;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,WAAW,CAAC,CAAC;IAC7E;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACvC;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IACzC;;OAEG;IACH,UAAU,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG;IAC9C;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;IACjD;;;OAGG;IACH,iBAAiB,CAAC,EAAE,mBAAmB,CAAC,aAAa,CAAC,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,QAAQ;IAvFjB;;;OAGG;gBACS,MAAM,EAAE;IACpB;;OAEG;uBACgB,OAAO;IAC1B;;;OAGG;eACQ,OAAO;IAClB;;OAEG;kBACW,OAAO;IACrB;;;;OAIG;oBACa,MAAM;IACtB;;;OAGG;wBACiB,iCAAiC,CAAC,aAAa,CAAC;IACpE;;;OAGG;kCAC2B,iCAAiC,CAAC,uBAAuB,CAAC;IACxF;;;;OAIG;+BACwB,iCAAiC,CAAC,oBAAoB,CAAC;IAClF;;;OAGG;YACK,MAAM,GAAG,WAAW,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,WAAW,CAAC;IAC5E;;OAEG;gBACS,cAAc,CAAC,MAAM,CAAC;IAClC;;;OAGG;uBACgB,MAAM,GAAG,UAAU;IACtC;;OAEG;sBACe,cAAc,CAAC,MAAM,CAAC;IACxC;;OAEG;iBACU,sBAAsB,CAAC,QAAQ,CAAC;IAC7C;;;OAGG;mBACY,MAAM;;IAIvB;;;OAGG;kBACW,mBAAmB,CAAC,aAAa,CAAC;IAChD;;;OAGG;wBACiB,mBAAmB,CAAC,aAAa,CAAC;iDA6MvD,CAAC"}

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

@@ -0,0 +1,54 @@
+import type { ScrubberBeaconComponent, ScrubberBeaconProps } from './Scrubber';
+export type ScrubberBeaconGroupRef = {
+  /**
+   * Triggers a pulse animation on all beacons.
+   */
+  pulse: () => void;
+};
+export type ScrubberBeaconGroupBaseProps = {
+  /**
+   * 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;
+  /**
+   * Stroke color of the beacon circle.
+   * @default theme.color.bg
+   */
+  stroke?: string;
+};
+export declare const ScrubberBeaconGroup: import('react').MemoExoticComponent<
+  import('react').ForwardRefExoticComponent<
+    ScrubberBeaconGroupBaseProps & {
+      /**
+       * Transition configuration for beacon animations.
+       */
+      transitions?: ScrubberBeaconProps['transitions'];
+      /**
+       * Custom component for the scrubber beacon.
+       * @default DefaultScrubberBeacon
+       */
+      BeaconComponent?: ScrubberBeaconComponent;
+      /**
+       * Stroke color of the beacon circle.
+       * @default theme.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":"AAWA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAqB,MAAM,YAAY,CAAC;AAmHlG,MAAM,MAAM,sBAAsB,GAAG;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC;;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;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,mBAAmB;IAhB9B;;OAEG;kBACW,mBAAmB,CAAC,aAAa,CAAC;IAChD;;;OAGG;sBACe,uBAAuB;IACzC;;;OAGG;aACM,MAAM;2DAyEhB,CAAC"}

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

@@ -0,0 +1,46 @@
+import type { ChartTextProps } from '../text';
+import { type ScrubberLabelPosition } from '../utils/scrubber';
+import type {
+  ScrubberBeaconLabelComponent,
+  ScrubberBeaconLabelProps,
+  ScrubberBeaconProps,
+} from './Scrubber';
+export type ScrubberBeaconLabelGroupBaseProps = {
+  /**
+   * 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":"AAMA,OAAO,KAAK,EAAqB,cAAc,EAAE,MAAM,SAAS,CAAC;AAEjE,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAC;AAS3B,OAAO,KAAK,EACV,4BAA4B,EAC5B,wBAAwB,EACxB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AA4EpB,MAAM,MAAM,iCAAiC,GAAG;IAC9C;;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,qEAoMpC,CAAC"}

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

@@ -1,13 +1,16 @@
 import React from 'react';
 import { type ScrubberContextValue } from '../utils';
-export type ScrubberProviderProps = Partial<
-  Pick<ScrubberContextValue, 'enableScrubbing' | 'onScrubberPositionChange'>
-> & {
+export type ScrubberProviderProps = Partial<Pick<ScrubberContextValue, 'enableScrubbing'>> & {
   children: React.ReactNode;
   /**
    * Allows continuous gestures on the chart to continue outside the bounds of the chart element.
    */
   allowOverflowGestures?: boolean;
+  /**
+   * Callback fired when the scrubber position changes.
+   * Receives the dataIndex of the scrubber or undefined when not scrubbing.
+   */
+  onScrubberPositionChange?: (index: number | undefined) => void;
 };
 /**
  * A component which encapsulates the ScrubberContext.

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

@@ -1 +1 @@
-{"version":3,"file":"ScrubberProvider.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/ScrubberProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAO9D,OAAO,EAAuC,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAE1F,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,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAkK5D,CAAC"}
+{"version":3,"file":"ScrubberProvider.d.ts","sourceRoot":"","sources":["../../../src/chart/scrubber/ScrubberProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+B,MAAM,OAAO,CAAC;AAOpD,OAAO,EAA4C,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAG/F,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC,GAAG;IAC3F,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;OAEG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC;;;OAGG;IACH,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAsJ5D,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"}