react-native-livechart 4.11.0 → 4.12.0

package/dist/hooks/useChartPaths.d.ts

@@ -1,7 +1,10 @@
 import { type SkPath } from "@shopify/react-native-skia";
 import { type SharedValue } from "react-native-reanimated";
-import type { SingleEngineState } from "../core/useLiveChartEngine";
+import type { ChartEngineEdge, ChartEngineScroll, SingleEngineState } from "../core/useLiveChartEngine";
 import { type ChartPadding } from "../draw/line";
+/** Selects the synthetic right-edge line tip without coupling chart geometry
+ * to badge or live-indicator presentation options. */
+export declare function resolveLineTipValue(displayValue: number, edgeValue: number, viewEnd: number | null): number;
 /**
  * Builds the `linePath` / `fillPath` with `Skia.PathBuilder`s reused across
  * frames (one per curve, held in a SharedValue) and finalized with `detach()` —
@@ -13,19 +16,12 @@ import { type ChartPadding } from "../draw/line";
  * `flatPts` derived value changes reference each frame and re-runs linePath /
  * fillPath.
  */
-export declare function useChartPaths(engine: SingleEngineState, padding: ChartPadding, morphT?: SharedValue<number>, 
+export declare function useChartPaths(engine: SingleEngineState & ChartEngineScroll & ChartEngineEdge, padding: ChartPadding, morphT?: SharedValue<number>, 
 /** When set, also build `thresholdFillPath` — the band between the line and this
  *  pixel-Y, closed at the threshold instead of the chart baseline. */
 thresholdY?: SharedValue<number>, 
 /** Draw the line/fill as a straight polyline instead of the monotone cubic. */
 linear?: boolean, 
-/**
- * Value at the visible window's right edge (engine `edgeValue`). With
- * `followViewEdge`, the line's right-edge tip uses this instead of the live
- * `displayValue` — so while time-scrolled the line ends at the last visible
- * price rather than dropping to the (off-screen) live value.
- */
-edgeValue?: SharedValue<number>, followViewEdge?: boolean, 
 /** Loading squiggle wave amplitude (px) for the reveal morph. Default 14. */
 squiggleAmplitude?: number, 
 /** Loading squiggle wave speed multiplier for the reveal morph. Default 1. */

package/dist/hooks/useChartPaths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useChartPaths.d.ts","sourceRoot":"","sources":["../../src/hooks/useChartPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAMlE;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AAC5B;sEACsE;AACtE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AAChC,+EAA+E;AAC/E,MAAM,UAAQ;AACd;;;;;GAKG;AACH,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,cAAc,UAAQ;AACtB,6EAA6E;AAC7E,iBAAiB,SAAK;AACtB,8EAA8E;AAC9E,aAAa,SAAI;AACjB;;;yDAGyD;AACzD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;EAsKzC"}
+{"version":3,"file":"useChartPaths.d.ts","sourceRoot":"","sources":["../../src/hooks/useChartPaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAMlE;sDACsD;AACtD,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,MAAM,CAGR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,eAAe,EAC/D,OAAO,EAAE,YAAY,EACrB,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AAC5B;sEACsE;AACtE,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;AAChC,+EAA+E;AAC/E,MAAM,UAAQ;AACd,6EAA6E;AAC7E,iBAAiB,SAAK;AACtB,8EAA8E;AAC9E,aAAa,SAAI;AACjB;;;yDAGyD;AACzD,gBAAgB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC;;;;EAyKzC"}

package/dist/hooks/useCrosshair.d.ts

@@ -45,5 +45,11 @@ tooltipMargin?: number,
  * scrubbing (and a vertical drag falls through to the parent). `0` = no
  * exclusion (the default; scrub covers the whole plot).
  */
-scrubBottomExclude?: number): CrosshairState;
+scrubBottomExclude?: number, 
+/**
+ * True while the time-scroll pan owns the touch. The hold-to-scrub pan refuses
+ * to activate while set, so a drag that already started scrolling can never
+ * mature into a scrub (see `delayedPanGuard.shouldStartDelayedPan`).
+ */
+scrollActive?: SharedValue<boolean>): CrosshairState;
 //# sourceMappingURL=useCrosshair.d.ts.map

package/dist/hooks/useCrosshair.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCrosshair.d.ts","sourceRoot":"","sources":["../../src/hooks/useCrosshair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAgBL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAmD3B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,CAAC;AAEzB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,EAC5C,UAAU,CAAC,EAAE,mBAAmB;AAChC,2EAA2E;AAC3E,eAAe,SAAI,EACnB,cAAc,CAAC,EAAE,MAAM,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,IAAI;AACzB,+EAA+E;AAC/E,WAAW,CAAC,EAAE,yBAAyB,GAAG,IAAI,EAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;AACjD,iEAAiE;AACjE,YAAY,GAAE,YAAqC;AACnD;;;;;GAKG;AACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO;AAC/C,gFAAgF;AAChF,gBAAgB,GAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAgB;AAC9D,mEAAmE;AACnE,gBAAgB,UAAO;AACvB,kEAAkE;AAClE,eAAe,UAAO;AACtB,kFAAkF;AAClF,aAAa,SAAI;AACjB;;;;;GAKG;AACH,kBAAkB,SAAI,GACrB,cAAc,CA2kBhB"}
+{"version":3,"file":"useCrosshair.d.ts","sourceRoot":"","sources":["../../src/hooks/useCrosshair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAgBL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAoD3B,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvE,YAAY,EAAE,UAAU,EAAE,CAAC;AAEzB,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EACzB,4BAA4B,EAC5B,sBAAsB,EACtB,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE7B,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,OAAO,CAAC,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,WAAW,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,EAC5C,UAAU,CAAC,EAAE,mBAAmB;AAChC,2EAA2E;AAC3E,eAAe,SAAI,EACnB,cAAc,CAAC,EAAE,MAAM,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,IAAI;AACzB,+EAA+E;AAC/E,WAAW,CAAC,EAAE,yBAAyB,GAAG,IAAI,EAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI;AACjD,iEAAiE;AACjE,YAAY,GAAE,YAAqC;AACnD;;;;;GAKG;AACH,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO;AAC/C,gFAAgF;AAChF,gBAAgB,GAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAgB;AAC9D,mEAAmE;AACnE,gBAAgB,UAAO;AACvB,kEAAkE;AAClE,eAAe,UAAO;AACtB,kFAAkF;AAClF,aAAa,SAAI;AACjB;;;;;GAKG;AACH,kBAAkB,SAAI;AACtB;;;;GAIG;AACH,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,GAClC,cAAc,CAynBhB"}

package/dist/hooks/useCrosshairSeries.d.ts

@@ -1,12 +1,31 @@
+import type { SkFont } from "@shopify/react-native-skia";
+import { type DerivedValue, type SharedValue } from "react-native-reanimated";
+import type { ResolvedPerSeriesTooltipConfig } from "../core/resolveConfig";
 import type { MultiEngineState } from "../core/useLiveChartEngine";
 import { type ChartPadding } from "../draw/line";
 import type { ScrubPointMulti } from "../types";
 import { type CrosshairState } from "./crosshairShared";
 /**
- * LiveChartSeries crosshair + scrub. No tooltip — data is delivered via
- * `onScrub` worklet callback on the UI thread.
+ * LiveChartSeries crosshair + scrub. The optional per-series tooltip is
+ * calculated on the UI thread alongside the callback payload.
  */
+interface CrosshairSeriesTooltipOptions {
+    config: ResolvedPerSeriesTooltipConfig;
+    formatValue: (value: number) => string;
+    formatTime: (time: number) => string;
+    font: SkFont;
+    colors: string[];
+    /** Current-time anchor used to clamp the live bucket's range end. */
+    maxTime: SharedValue<number> | DerivedValue<number>;
+}
 export declare function useCrosshairSeries(engine: MultiEngineState, padding: ChartPadding, enabled: boolean, onScrub?: (point: ScrubPointMulti | null) => void, 
 /** Press-and-hold delay (ms) before scrubbing activates. 0 = immediate. */
-panGestureDelay?: number, onGestureStart?: () => void, onGestureEnd?: () => void): CrosshairState;
+panGestureDelay?: number, onGestureStart?: () => void, onGestureEnd?: () => void, 
+/**
+ * True while the time-scroll pan owns the touch. The hold-to-scrub pan refuses
+ * to activate while set, so a drag that already started scrolling can never
+ * mature into a scrub (see `delayedPanGuard.shouldStartDelayedPan`).
+ */
+scrollActive?: SharedValue<boolean>, tooltip?: CrosshairSeriesTooltipOptions): CrosshairState;
+export {};
 //# sourceMappingURL=useCrosshairSeries.d.ts.map

package/dist/hooks/useCrosshairSeries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCrosshairSeries.d.ts","sourceRoot":"","sources":["../../src/hooks/useCrosshairSeries.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAKhD,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAS3B;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI;AACjD,2EAA2E;AAC3E,eAAe,SAAI,EACnB,cAAc,CAAC,EAAE,MAAM,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,IAAI,GACxB,cAAc,CA8MhB"}
+{"version":3,"file":"useCrosshairSeries.d.ts","sourceRoot":"","sources":["../../src/hooks/useCrosshairSeries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEzD,OAAO,EAIL,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAMhD,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAU3B;;;GAGG;AACH,UAAU,6BAA6B;IACrC,MAAM,EAAE,8BAA8B,CAAC;IACvC,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;CACrD;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,KAAK,IAAI;AACjD,2EAA2E;AAC3E,eAAe,SAAI,EACnB,cAAc,CAAC,EAAE,MAAM,IAAI,EAC3B,YAAY,CAAC,EAAE,MAAM,IAAI;AACzB;;;;GAIG;AACH,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EACnC,OAAO,CAAC,EAAE,6BAA6B,GACtC,cAAc,CA+QhB"}

package/dist/hooks/useMomentum.d.ts

@@ -11,6 +11,6 @@ import type { Momentum, MomentumConfig } from "../types";
 export declare function resolveMomentumProp(prop: boolean | Momentum | MomentumConfig, data: readonly {
     time: number;
     value: number;
-}[]): Momentum;
+}[], endTime?: number): Momentum;
 export declare function useMomentum(engine: SingleEngineState, momentumProp?: boolean | Momentum | MomentumConfig): SharedValue<Momentum>;
 //# sourceMappingURL=useMomentum.d.ts.map

package/dist/hooks/useMomentum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMomentum.d.ts","sourceRoot":"","sources":["../../src/hooks/useMomentum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,cAAc,EACzC,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,GAC/C,QAAQ,CAYV;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,YAAY,GAAE,OAAO,GAAG,QAAQ,GAAG,cAAqB,GACvD,WAAW,CAAC,QAAQ,CAAC,CAIvB"}
+{"version":3,"file":"useMomentum.d.ts","sourceRoot":"","sources":["../../src/hooks/useMomentum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,cAAc,EACzC,IAAI,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,EAChD,OAAO,CAAC,EAAE,MAAM,GACf,QAAQ,CAkBV;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,iBAAiB,EACzB,YAAY,GAAE,OAAO,GAAG,QAAQ,GAAG,cAAqB,GACvD,WAAW,CAAC,QAAQ,CAAC,CAIvB"}

package/dist/hooks/usePanScroll.d.ts

@@ -43,6 +43,20 @@ export interface UsePanScrollOptions {
      * a stray scrub doesn't linger behind the pan.
      */
     onScrollStart?: () => void;
+    /**
+     * Set true for as long as this gesture owns the touch, cleared on finalize.
+     * The hold-to-scrub pan reads it and refuses to activate mid-scroll — RNGH's
+     * `Gesture.Race` declares no relation between the two pans, so this latch is
+     * the only thing stopping the scrub's long-press timer from firing while the
+     * chart is already being dragged. See `delayedPanGuard.shouldStartDelayedPan`.
+     */
+    scrollActive?: SharedValue<boolean>;
+    /**
+     * True while the scrub crosshair owns the touch. Scrolling is inert while set,
+     * so an engaged scrub locks the chart in place and the finger only moves the
+     * price indicator. Cleared when the finger lifts (the scrub pan's finalize).
+     */
+    scrubActive?: SharedValue<boolean>;
 }
 /**
  * Smallest valid right-edge time: keeps the window's left edge
@@ -78,5 +92,5 @@ export declare function axisBandTop(canvasHeight: number, padBottom: number): nu
  * edge; `null` means "follow live". Dragging (or flinging) back to the live edge
  * resumes following.
  */
-export declare function usePanScroll({ engine, padding, minTime, enabled, mode, onScrollStart, }: UsePanScrollOptions): ReturnType<typeof Gesture.Pan>;
+export declare function usePanScroll({ engine, padding, minTime, enabled, mode, onScrollStart, scrollActive, scrubActive, }: UsePanScrollOptions): ReturnType<typeof Gesture.Pan>;
 //# sourceMappingURL=usePanScroll.d.ts.map

package/dist/hooks/usePanScroll.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usePanScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/usePanScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAMnC,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,UAAU,CAAC;AAE9D,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,iDAAiD;IACjD,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B;IAC1B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAMf;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,IAAoB,EACpB,aAAa,GACd,EAAE,mBAAmB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAoHtD"}
+{"version":3,"file":"usePanScroll.d.ts","sourceRoot":"","sources":["../../src/hooks/usePanScroll.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,sFAAsF;AACtF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAMnC,6CAA6C;AAC7C,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG,UAAU,CAAC;AAE9D,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,iDAAiD;IACjD,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B;IAC1B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,6DAA6D;IAC7D,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,oFAAoF;IACpF,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,oBAAoB,CAAC;IAC5B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACpC;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,GACT,MAAM,GAAG,IAAI,CAMf;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,IAAoB,EACpB,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,EAAE,mBAAmB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CA6ItD"}

package/dist/index.d.ts

@@ -15,5 +15,5 @@ export { MONO_FONT_FAMILY } from "./lib/monoFontFamily";
 export { useDegen } from "./hooks/useDegen";
 export { useTradeStream } from "./hooks/useTradeStream";
 export { usePriceY, useTimeX } from "./hooks/useChartOverlayContext";
-export type { AreaDotsConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeStyleConfig, BadgeVariant, CandleMetrics, CandlePoint, CanvasMode, ChartInsets, ChartOverlayContext, ChartPlotRect, ChartScale, ChartSegment, DegenOptions, DegenShakePayload, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartMetrics, LiveChartMetricsOverride, LiveChartPalette, LiveChartPoint, LiveChartProps, LiveChartSeriesProps, LoadingConfig, Marker, MarkerClusterConfig, MarkerGroupBadge, MarkerKind, MarkerPressEvent, MarkerRenderContext, MarkerSide, Momentum, MomentumConfig, MotionMetrics, MultiSeriesDotConfig, PulseConfig, ReferenceLine, ReferenceLineBadgeConfig, ReferenceLineGroupingConfig, ReferenceLineRenderProps, ReturnToLiveConfig, ScrubActionConfig, ScrubActionPoint, ScrubConfig, ScrubPoint, ScrubPointCore, ScrubPointMulti, ScrubSeriesValue, SelectionDotConfig, SelectionDotProps, SelectionDotRingConfig, SeriesConfig, ThemeMode, ThresholdConfig, ThresholdLineConfig, TooltipRenderProps, TradeEvent, TransitionConfig, ValueLineConfig, VisibleRange, VolumeConfig, XAxisConfig, YAxisConfig, ZoomConfig, } from "./types";
+export type { AreaDotsConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeStyleConfig, BadgeVariant, CandleMetrics, CandlePoint, CanvasMode, ChartInsets, ChartOverlayContext, ChartPlotRect, ChartScale, ChartSegment, DegenOptions, DegenShakePayload, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartMetrics, LiveChartMetricsOverride, LiveChartPalette, LiveChartPoint, LiveChartProps, LiveChartSeriesProps, LoadingConfig, Marker, MarkerClusterConfig, MarkerGroupBadge, MarkerKind, MarkerPressEvent, MarkerRenderContext, MarkerSide, Momentum, MomentumConfig, MotionMetrics, MultiSeriesDotConfig, PerSeriesTooltipConfig, PulseConfig, ReferenceLine, ReferenceLineBadgeConfig, ReferenceLineGroupingConfig, ReferenceLineRenderProps, ReturnToLiveConfig, ScrubActionConfig, ScrubActionPoint, ScrubConfig, ScrubPoint, ScrubPointCore, ScrubPointMulti, ScrubSeriesValue, SelectionDotConfig, SelectionDotProps, SelectionDotRingConfig, SeriesConfig, ThemeMode, ThresholdConfig, ThresholdLineConfig, TooltipRenderProps, TradeEvent, TransitionConfig, ValueLineConfig, VisibleRange, VolumeConfig, XAxisConfig, YAxisConfig, ZoomConfig, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAIjF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAIrE,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAEvE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC;AAC3D,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAIjF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIxD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAIrE,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,WAAW,EACX,UAAU,EACV,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,MAAM,EACN,mBAAmB,EACnB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,SAAS,EACT,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/math/lerp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lerp.d.ts","sourceRoot":"","sources":["../../src/math/lerp.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,IAAI,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,SAAqB,GACtB,MAAM,CAIR"}
+{"version":3,"file":"lerp.d.ts","sourceRoot":"","sources":["../../src/math/lerp.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,IAAI,CAClB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,EAAE,SAAqB,GACtB,MAAM,CAWR"}

package/dist/math/momentum.d.ts

@@ -4,5 +4,5 @@ import type { LiveChartPoint, Momentum } from "../types";
  * Uses the full lookback window for threshold calculation
  * but only the last 5 points for active velocity.
  */
-export declare function detectMomentum(points: LiveChartPoint[], lookback?: number, threshold?: number): Momentum;
+export declare function detectMomentum(points: LiveChartPoint[], lookback?: number, threshold?: number, endTime?: number): Momentum;
 //# sourceMappingURL=momentum.d.ts.map

package/dist/math/momentum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"momentum.d.ts","sourceRoot":"","sources":["../../src/math/momentum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EAAE,EACxB,QAAQ,SAAK,EACb,SAAS,SAAO,GACf,QAAQ,CA0BV"}
+{"version":3,"file":"momentum.d.ts","sourceRoot":"","sources":["../../src/math/momentum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,cAAc,EAAE,EACxB,QAAQ,SAAK,EACb,SAAS,SAAO,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,QAAQ,CA0CV"}

package/dist/math/referenceLines.d.ts

@@ -12,6 +12,13 @@ export declare function referenceLineForm(rl: ReferenceLine): ReferenceLineForm;
  * time bands (Form C) which constrain time, not value.
  */
 export declare function collectReferenceValues(lines: ReferenceLine[]): number[];
+/**
+ * Stable React keys for an ordered reference-line list. A caller-supplied `id`
+ * keeps the key stable across reordering; the visual config is a deterministic
+ * fallback for legacy lines. Equal fallback signatures receive a suffix so they
+ * remain distinct siblings.
+ */
+export declare function referenceLineReactKeys(lines: readonly ReferenceLine[]): string[];
 /**
  * Fully-resolved badge **style/shape** + anchor — the resolved counterpart of
  * {@link BadgeStyleConfig} (`position` / `icon` / `showText` plus the style knobs).

package/dist/math/referenceLines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"referenceLines.d.ts","sourceRoot":"","sources":["../../src/math/referenceLines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAElB,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,iBAAiB,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAgBvE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;yDACyD;AACzD,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACzE,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;yDACyD;AACzD,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;AA+BtE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,2BAA2B,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,aAAa,GAChB,sBAAsB,GAAG,IAAI,CAmB/B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,IAAI,GAAG,OAAO,GAAG,OAAO,CAK1B"}
+{"version":3,"file":"referenceLines.d.ts","sourceRoot":"","sources":["../../src/math/referenceLines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAElB,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,iBAAiB,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAgBvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,MAAM,EAAE,CAUV;AAoBD;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,wDAAwD;IACxD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,UAAU,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;yDACyD;AACzD,MAAM,WAAW,sBAAuB,SAAQ,2BAA2B;IACzE,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;yDACyD;AACzD,MAAM,MAAM,2BAA2B,GAAG,2BAA2B,CAAC;AA+BtE;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,CAAC,EAAE,wBAAwB,GAC/B,2BAA2B,CAE7B;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,aAAa,GAChB,sBAAsB,GAAG,IAAI,CAmB/B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,IAAI,GAAG,OAAO,GAAG,OAAO,CAK1B"}

package/dist/types.d.ts

@@ -39,6 +39,11 @@ export type BadgeVariant = "default" | "minimal";
  * - **Form C** — vertical time band between `from` and `to` (unix seconds).
  */
 export interface ReferenceLine {
+    /**
+     * Stable identifier for this line. Supply a unique value when `referenceLines`
+     * may be reordered so the chart preserves the line's rendered identity.
+     */
+    id?: string;
     /** Form A — the Y-axis value where the horizontal line is drawn. */
     value?: number;
     /** Form B — horizontal band lower Y bound (paired with `valueTo`). */
@@ -225,14 +230,16 @@ export interface ReferenceLineBadgeConfig extends BadgeStyleConfig {
 }
 /**
  * Context passed to a custom {@link LiveChartProps.renderReferenceLine} or
- * {@link LiveChartSeriesProps.renderReferenceLine}. The chart floats the element
- * you return over the canvas and pins it to the line's value on
- * the UI thread (vertically centered on the line, horizontally at the badge /
- * label position) — so it tracks the rescaling axis and any drag smoothly without
- * JS re-renders, just like {@link TooltipRenderProps}. Replaces the built-in pill
- * badge / gutter label for that line; return `null`/`undefined` to keep the
- * built-in. Bind the SharedValues to animated text (e.g. an animated `TextInput`)
- * for the value to update on the UI thread too.
+ * {@link LiveChartProps.renderOffAxisReferenceLine} (and their
+ * `LiveChartSeries` counterparts). The chart floats the element you return over
+ * the canvas and pins it to the line's value on the UI thread (vertically centered
+ * on the line, horizontally at the badge / label position) — so it tracks the
+ * rescaling axis and any drag smoothly without JS re-renders, just like
+ * {@link TooltipRenderProps}. `renderReferenceLine` replaces the built-in pill /
+ * gutter label in every state; `renderOffAxisReferenceLine` replaces it only while
+ * the value is pinned above or below the visible plot. Bind the SharedValues to
+ * animated text (e.g. an animated `TextInput`) for the value to update on the UI
+ * thread too.
  */
 export interface ReferenceLineRenderProps {
     /** The reference line being rendered. */
@@ -547,7 +554,9 @@ export interface BadgeConfig extends BadgeStyleConfig {
      * When the chart is scrolled back (see `timeScroll`), move the live-price
      * indicators — the badge, the value line, and the live dot — to the price at
      * the visible window's right edge instead of the live price, so they track the
-     * last visible price as you pan. Default `false`.
+     * last visible price as you pan. The badge's momentum color is derived at that
+     * same historical edge, so incoming live ticks do not recolor it. Default
+     * `false`.
      *
      * @experimental
      */
@@ -666,10 +675,98 @@ export interface XAxisConfig {
     /** Minimum pixel gap between time labels. Default `60`. */
     minGap?: number;
 }
+/**
+ * Morfi-style on-canvas tooltip for {@link LiveChartSeries}: a time-range pill
+ * above the guide plus one value pill at every visible series intersection.
+ *
+ * Enable it with `scrub={{ seriesTooltip: true }}` or pass this object to style
+ * and format the readout. It is ignored by the single-series {@link LiveChart}.
+ */
+export interface PerSeriesTooltipConfig {
+    /**
+     * Keep the value pills pinned to the visible series endpoints while idle.
+     * The guide and time pill remain hidden until a scrub starts. Default `false`.
+     */
+    alwaysShow?: boolean;
+    /**
+     * Bucket width used by the time-range pill, in seconds. Omit to infer it from
+     * the latest positive interval in the first visible series.
+     */
+    bucketSeconds?: number;
+    /**
+     * Format a value pill. The second argument identifies the series so one chart
+     * can dispatch to different unit formatters. Defaults to the chart's
+     * `formatValue`.
+     *
+     * Runs on the UI thread and must be worklet-safe.
+     */
+    formatSeriesValue?: (value: number, seriesId: string) => string;
+    /**
+     * Format the time pill from the bucket's start/end unix seconds. The end is
+     * clamped to the chart's current-time anchor, so the live bucket never claims
+     * to end in the future. Defaults to two chart `formatTime` labels joined by
+     * an en dash.
+     *
+     * Runs on the UI thread and must be worklet-safe.
+     */
+    formatTimeRange?: (from: number, to: number) => string;
+    /** Truncate labels longer than this many characters with `…`. Default `14`. */
+    maxLabelChars?: number;
+    /** Guide color. Omit to use `scrub.crosshairLineColor`, then the theme. */
+    guideColor?: string;
+    /** Guide stroke width in px. Default `1`. */
+    guideWidth?: number;
+    /**
+     * Guide dash pattern. `true` uses `[3, 3]`; an array supplies explicit Skia
+     * dash intervals; `false` draws a solid guide. Default `[3, 3]`.
+     */
+    guideDashPattern?: boolean | number[];
+    /** Time-pill background. Omit to use `scrub.tooltipBackground`, then the theme. */
+    timePillBackground?: string;
+    /** Time-pill text color. Omit to use `scrub.tooltipColor`, then the theme. */
+    timePillColor?: string;
+    /** Time-pill border color. Omit to use `scrub.tooltipBorderColor`, then the theme. */
+    timePillBorderColor?: string;
+    /** Time-pill corner radius in px. Default `6`. */
+    timePillRadius?: number;
+    /** Time-pill horizontal padding in px. Default `8`. */
+    timePillPaddingX?: number;
+    /** Time-pill vertical padding in px. Default `4`. */
+    timePillPaddingY?: number;
+    /** Series-pill background. Omit to use `scrub.tooltipBackground`, then the theme. */
+    seriesPillBackground?: string;
+    /** Series label color. Omit to use the theme tooltip text. */
+    seriesPillLabelColor?: string;
+    /** Formatted series value color. Omit to use `seriesPillLabelColor`. */
+    seriesPillValueColor?: string;
+    /** Series-pill border color. Omit to use `scrub.tooltipBorderColor`, then the theme. */
+    seriesPillBorderColor?: string;
+    /** Series-pill corner radius in px. Default `6`. */
+    seriesPillRadius?: number;
+    /** Series-pill horizontal padding in px. Default `8`. */
+    seriesPillPaddingX?: number;
+    /** Series-pill vertical padding in px. Default `4`. */
+    seriesPillPaddingY?: number;
+    /** Diameter of the series-colour dot inside each pill, in px. Default `8`. */
+    seriesPillDotSize?: number;
+    /** Gap between the colour dot and label, in px. Default `6`. */
+    seriesPillDotGap?: number;
+    /** Gap between the label and formatted value, in px. Default `6`. */
+    seriesPillLabelValueGap?: number;
+    /** Diameter of the dot drawn at each line/guide intersection. Default `8`. */
+    intersectionDotSize?: number;
+}
 /** Crosshair scrub configuration. */
 export interface ScrubConfig {
     /** Show the value/time tooltip pill while scrubbing. Default `true`. */
     tooltip?: boolean;
+    /**
+     * Opt into the Morfi-style per-series pill tooltip on `LiveChartSeries`.
+     * `true` uses defaults; an object enables and configures it; `false`/omitted
+     * preserves the existing guide-only multi-series scrub. Ignored by
+     * single-series `LiveChart`. Default `false`.
+     */
+    seriesTooltip?: boolean | PerSeriesTooltipConfig;
     /**
      * Opacity of the chart content to the *right* of the crosshair (the "future")
      * while scrubbing — `0` fully fades it out, `1` disables the dim. Implemented
@@ -908,7 +1005,8 @@ export interface ChartScale {
 }
 /**
  * The price↔pixel / time↔pixel bridge handed to a custom
- * {@link LiveChartProps.renderOverlay}.
+ * {@link LiveChartProps.renderOverlay} or
+ * {@link LiveChartSeriesProps.renderOverlay}.
  *
  * **Easiest path — the `usePriceY` / `useTimeX` hooks.** They project a price / time
  * to a `SharedValue<number>` that tracks the live axis for you; just read it in
@@ -1526,6 +1624,15 @@ export interface TimeScrollConfig {
      * if set, otherwise `500`.
      */
     scrubHoldMs?: number;
+    /**
+     * Hide the live badge, dot, and dashed value line while scrolled back through
+     * history. Default `true`: all three mark the LIVE price, which is off-screen
+     * once the window is frozen behind the live edge, so they'd point at a price
+     * that isn't in view. Set `false` to keep them visible while scrolled back.
+     * Ignored when `badge.followViewEdge` is on — there the group tracks the
+     * visible edge price, which IS in view.
+     */
+    hideLiveOnScrollBack?: boolean;
 }
 /**
  * Tunes the "return to live" glide — the eased animation that carries the window
@@ -1905,8 +2012,9 @@ export interface LiveChartCoreProps {
      *
      * Defaults differ per chart: `LiveChart` shows it (`true`); `LiveChartSeries`
      * hides it (`false`) — with multiple lines the dot can only track the leading
-     * series, so the crosshair + per-series tooltips mark the scrub point instead.
-     * Pass `true` / a config to opt a multi-series chart in.
+     * series. The crosshair — and, when enabled, the per-series tooltip's own
+     * intersection dots — mark the scrub point instead. Pass `true` / a config to
+     * opt a multi-series chart in.
      */
     selectionDot?: boolean | SelectionDotConfig;
     /** Called once when the user starts scrubbing/panning the chart. */
@@ -2053,17 +2161,32 @@ export interface LiveChartProps extends LiveChartCoreProps {
      * pins it to the line's value on the UI thread (see {@link ReferenceLineRenderProps}),
      * so it tracks the rescaling axis and any drag without JS re-renders. Called per
      * Form-A line; return `null`/`undefined` to keep that line's built-in tag. Works
-     * with `badge: false` too (replace the plain gutter label). Single-series only.
+     * with `badge: false` too (replace the plain gutter label). For a left- or
+     * right-pinned `badge`, the chart retains the dashed connector and measures the
+     * custom tag so the connector starts at its outer edge. Single-series only.
      */
     renderReferenceLine?: (ctx: ReferenceLineRenderProps) => ReactElement | null | undefined;
+    /**
+     * Render only a Form-A line's **off-axis** tag as a custom React Native element.
+     * The chart keeps the standard Skia tag / gutter label while the value is in
+     * range, then switches to this element when it pins above or below the plot.
+     * With a left- or right-pinned `badge` (or legacy `offAxisBadge`), its dashed
+     * connector stays native and begins after the measured custom tag. Return
+     * `null`/`undefined` to opt a line out based on its static `line` / `index`;
+     * use the `edge` SharedValue inside the returned element to animate a caret.
+     * `renderReferenceLine` takes precedence if both callbacks handle one line.
+     * Single-series only.
+     */
+    renderOffAxisReferenceLine?: (ctx: ReferenceLineRenderProps) => ReactElement | null | undefined;
     /**
      * Collapse Form-A reference lines whose handles sit near the same value into a
      * single count handle (e.g. a stack of working orders at adjacent prices reads
      * as one "×3" tag). `true` = defaults, `false`/omitted = off, or pass a
      * {@link ReferenceLineGroupingConfig} to tune the proximity radius. Lines a
-     * {@link LiveChartProps.renderReferenceLine} owns are excluded (their custom tag
-     * draws itself), so the count reflects only collapsed built-in tags. Single-series
-     * only. Default off.
+     * {@link LiveChartProps.renderReferenceLine} or
+     * {@link LiveChartProps.renderOffAxisReferenceLine} owns are excluded (their
+     * custom tag draws itself), so the count reflects only collapsed built-in tags.
+     * Single-series only. Default off.
      */
     referenceLineGrouping?: boolean | ReferenceLineGroupingConfig;
     /**
@@ -2084,16 +2207,35 @@ export interface LiveChartProps extends LiveChartCoreProps {
 export interface LiveChartSeriesProps extends LiveChartCoreProps {
     /** Array of series definitions. Must be a SharedValue for UI-thread reads. */
     series: SharedValue<SeriesConfig[]>;
+    /**
+     * Render a custom overlay floated over the canvas, handed the live
+     * price↔pixel / time↔pixel {@link ChartOverlayContext}. Use its `scale` snapshot
+     * and mapping worklets to position React Native UI against this chart's resolved
+     * plot bounds (including any axis or explicit inset). The tree mounts full-bleed
+     * with `pointerEvents="box-none"`; return `null`/`undefined` for no overlay.
+     */
+    renderOverlay?: (ctx: ChartOverlayContext) => ReactElement | null | undefined;
     /**
      * Render a Form-A reference line's tag as a custom **React Native** element
      * instead of the built-in Skia pill / gutter label. The chart pins the returned
      * element to the line's live Y position on the UI thread (see
      * {@link ReferenceLineRenderProps}), including off-axis edge pinning. Return
      * `null`/`undefined` to keep that line's built-in tag. The line stroke always
-     * remains visible, and `badge.position` / `labelPosition` controls the custom
-     * tag's left, center, or right anchor.
+     * remains visible; a left- or right-pinned badge also keeps its dashed connector,
+     * starting after the measured custom tag. `badge.position` / `labelPosition`
+     * controls the custom tag's left, center, or right anchor.
      */
     renderReferenceLine?: (ctx: ReferenceLineRenderProps) => ReactElement | null | undefined;
+    /**
+     * Render only a Form-A line's **off-axis** tag as a custom React Native element.
+     * The normal in-range Skia tag / gutter label stays visible, while an edge-pinned
+     * custom tag replaces it above or below the plot. A left- or right-pinned
+     * `badge` (or legacy `offAxisBadge`) retains its native dashed connector, measured
+     * against the custom tag. Return `null`/`undefined` to opt a static `line` /
+     * `index` out; use the `edge` SharedValue inside the returned element to animate
+     * its caret. `renderReferenceLine` takes precedence for the same line.
+     */
+    renderOffAxisReferenceLine?: (ctx: ReferenceLineRenderProps) => ReactElement | null | undefined;
     /** Called when a series toggle chip is tapped. */
     onSeriesToggle?: (id: string, visible: boolean) => void;
     /**