react-native-livechart 1.0.0 → 1.1.0

package/src/types.ts

@@ -203,6 +203,14 @@ export interface ScrubConfig {
   tooltipColor?: string;
   /** Tooltip pill border color. Omit to use theme `tooltipBorder`. */
   tooltipBorderColor?: string;
+  /**
+   * Press-and-hold delay in milliseconds before scrubbing activates — think of
+   * it as "press and hold to scrub." During the delay the pan is not captured,
+   * so a quick horizontal swipe falls through to a parent gesture (e.g. a
+   * navigator's swipe-back-to-previous-route). `0` = scrub immediately on drag.
+   * Default `0`.
+   */
+  panGestureDelay?: number;
 }
 
 /** Left-edge fade — soft erase so the chart blends into the left gutter (web liveline parity). */
@@ -392,10 +400,38 @@ export interface DegenShakePayload {
   direction: "up" | "down";
 }
 
-/** Live dot configuration for multi-series charts. */
-export interface MultiSeriesDotConfig {
-  /** Dot radius in pixels. Default `3.5`. */
+/** Contrasting outer ring drawn behind each series dot — the "haloed" look the
+ *  single-series live dot has, so dots stand out against the lines and one
+ *  another. */
+export interface DotRingConfig {
+  /** Ring color. Default: theme `badgeOuterBg` (a near-background halo). */
+  color?: string;
+  /** Ring thickness in pixels — how far the halo extends past the dot. Default `2.5`. */
+  width?: number;
+}
+
+/**
+ * Shared live-dot styling, used by both `LiveChart` (`dot`) and
+ * `LiveChartSeries` (`dot`, which extends this). A dot is a color-filled circle
+ * of `radius` with an optional contrasting outer `ring` (halo).
+ */
+export interface DotConfig {
+  /** Radius of the (color-filled) dot in pixels. Default `3.5`. */
   radius?: number;
+  /**
+   * Contrasting outer ring (halo) behind the dot, so it reads clearly against
+   * the line(s). `true` = defaults, `false` = a flat circle, or pass
+   * `DotRingConfig`. Default `true`.
+   */
+  ring?: boolean | DotRingConfig;
+  /** Show the dot. `false` hides it (line, badge, and labels still render). Default `true`. */
+  show?: boolean;
+  /** Dot fill color. Defaults to the chart line color (per series for multi-series). */
+  color?: string;
+}
+
+/** Live dot configuration for multi-series charts (extends the shared {@link DotConfig}). */
+export interface MultiSeriesDotConfig extends DotConfig {
   /** Pulsing ring animation on each series dot. `true` = defaults, or pass `PulseConfig`. Default `true`. */
   pulse?: boolean | PulseConfig;
   /** Horizontal dashed line at each series' live value. `true` = defaults, or pass `ValueLineConfig`. Default `false`. */
@@ -629,6 +665,8 @@ export interface LiveChartProps extends LiveChartCoreProps {
   momentum?: boolean | Momentum | MomentumConfig;
   /** Pulsing ring animation on the live dot. `true` = defaults, or pass `PulseConfig`. Default `true`. */
   pulse?: boolean | PulseConfig;
+  /** Live dot styling: `radius`, `ring` (halo), `show`, `color`. See {@link DotConfig}. */
+  dot?: DotConfig;
   /** Horizontal dashed line at the current live value. `true` = defaults, or pass `ValueLineConfig`. */
   valueLine?: boolean | ValueLineConfig;
   /** Render the live value as a large text overlay in the top-left. Default `false`. */