react-native-livechart 3.11.0 → 4.0.0

package/dist/hooks/useChartOverlayContext.d.ts

@@ -0,0 +1,45 @@
+import { type SharedValue } from "react-native-reanimated";
+import type { ChartEngineLayout } from "../core/useLiveChartEngine";
+import type { ChartPadding } from "../draw/line";
+import type { ChartOverlayContext } from "../types";
+/**
+ * Builds the {@link ChartOverlayContext} handed to a custom
+ * {@link LiveChartProps.renderOverlay}: a single per-frame {@link ChartScale}
+ * SharedValue plus the pure price↔pixel / time↔pixel mapping worklets.
+ *
+ * The `scale` derived value reads the engine SharedValues (range, window, "now")
+ * and the padding each frame, so a consumer's `useAnimatedStyle` becomes reactive
+ * just by reading `scale.get()` — that read subscribes it to per-frame updates
+ * (Reanimated only observes SharedValues found directly in a worklet's closure,
+ * not those hidden behind a function call). The mappings stay pure, taking the
+ * snapshot as an argument.
+ */
+export declare function useChartOverlayContext(engine: ChartEngineLayout, padding: ChartPadding): ChartOverlayContext;
+/**
+ * Reactive Y for a price: projects `price` to its canvas Y pixel and returns it as
+ * a `SharedValue<number>` that tracks the live axis on the UI thread. The
+ * **recommended** way to place something at a price in a {@link LiveChartProps.renderOverlay}
+ * — read the returned value in your `useAnimatedStyle` like any SharedValue; the
+ * subscription to the chart's scale is handled here, so it can't be forgotten.
+ *
+ * ```tsx
+ * function PriceLevel({ ctx, price }) {
+ *   const y = usePriceY(ctx, price);
+ *   const style = useAnimatedStyle(() => ({ transform: [{ translateY: y.get() }] }));
+ *   return <Animated.View style={style} />;
+ * }
+ * ```
+ *
+ * It's a hook, so call it once per level (render one component per price). For
+ * one-off math off the render path (e.g. a gesture handler), use the pure
+ * {@link ChartOverlayContext.priceToY} with `ctx.scale.get()` instead.
+ */
+export declare function usePriceY(ctx: ChartOverlayContext, price: number): SharedValue<number>;
+/**
+ * Reactive X for a timestamp — the time↔pixel sibling of {@link usePriceY}.
+ * Projects `time` (unix seconds) to its canvas X pixel as a `SharedValue<number>`
+ * that tracks the scrolling window on the UI thread. Read it in your
+ * `useAnimatedStyle`; call once per element.
+ */
+export declare function useTimeX(ctx: ChartOverlayContext, time: number): SharedValue<number>;
+//# sourceMappingURL=useChartOverlayContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useChartOverlayContext.d.ts","sourceRoot":"","sources":["../../src/hooks/useChartOverlayContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAc,MAAM,UAAU,CAAC;AAGhE;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,GACpB,mBAAmB,CA0BrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CACvB,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,MAAM,GACZ,WAAW,CAAC,MAAM,CAAC,CAKrB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,mBAAmB,EACxB,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,MAAM,CAAC,CAGrB"}

package/dist/hooks/useChartPaths.d.ts

@@ -18,7 +18,14 @@ export declare function useChartPaths(engine: SingleEngineState, padding: ChartP
  *  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): {
+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): {
     readonly linePath: import("react-native-reanimated").DerivedValue<SkPath>;
     readonly fillPath: import("react-native-reanimated").DerivedValue<SkPath>;
     readonly thresholdFillPath: import("react-native-reanimated").DerivedValue<SkPath>;

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;AAKlE;;;;;;;;;;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;;;;EA0Gf"}
+{"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;AAKlE;;;;;;;;;;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;;;;EA+GvB"}

package/dist/hooks/useCrosshair.d.ts

@@ -32,11 +32,18 @@ badgeMetrics?: BadgeMetrics,
  */
 deferTapHit?: (x: number, y: number) => boolean, 
 /** Where the tooltip pill sits relative to the scrub line. Default `"side"`. */
-tooltipPlacement?: "side" | "top" | "bottom", 
+tooltipPlacement?: "side" | "top" | "bottom" | "point", 
 /** Render the value row in the default tooltip. Default `true`. */
 tooltipShowValue?: boolean, 
 /** Render the time row in the default tooltip. Default `true`. */
 tooltipShowTime?: boolean, 
 /** Gap (px) between the tooltip and the plot edge it's pinned to. Default `8`. */
-tooltipMargin?: number): CrosshairState;
+tooltipMargin?: number, 
+/**
+ * Height (px) of a bottom band to exclude from scrub recognition — the
+ * axis-drag "grab the time ruler" strip, so a drag there scrolls instead of
+ * scrubbing (and a vertical drag falls through to the parent). `0` = no
+ * exclusion (the default; scrub covers the whole plot).
+ */
+scrubBottomExclude?: number): 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;AAGzD,OAAO,EAIL,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,EAaL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AA4C3B,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,QAAiB;AACpD,mEAAmE;AACnE,gBAAgB,UAAO;AACvB,kEAAkE;AAClE,eAAe,UAAO;AACtB,kFAAkF;AAClF,aAAa,SAAI,GAChB,cAAc,CAmgBhB"}
+{"version":3,"file":"useCrosshair.d.ts","sourceRoot":"","sources":["../../src/hooks/useCrosshair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAGzD,OAAO,EAIL,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,EAaL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AA4C3B,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,CAuhBhB"}

package/dist/hooks/useLiveDot.d.ts

@@ -1,11 +1,16 @@
+import { type SharedValue } from "react-native-reanimated";
 import type { SingleEngineState } from "../core/useLiveChartEngine";
 import type { ChartPadding } from "../draw/line";
 /**
  * Derive the live dot position (right edge of the chart, mapped to current value).
  * Returns `{ dotX, dotY }` as shared values. Coordinates are set to `-100`
  * (off-screen sentinel) when canvas dimensions are unavailable.
+ *
+ * With `followViewEdge` + `edgeValue`, the dot (and the value line that shares
+ * `dotY`) tracks the visible window's right-edge price while scrolled back, so it
+ * stays aligned with a `followViewEdge` badge instead of marking the live value.
  */
-export declare function useLiveDot(engine: SingleEngineState, padding: ChartPadding): {
+export declare function useLiveDot(engine: SingleEngineState, padding: ChartPadding, edgeValue?: SharedValue<number>, followViewEdge?: boolean): {
     readonly dotX: import("react-native-reanimated").DerivedValue<number>;
     readonly dotY: import("react-native-reanimated").DerivedValue<number>;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"useLiveDot.d.ts","sourceRoot":"","sources":["../../src/hooks/useLiveDot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,EAAE,YAAY;;;EAqB1E"}
+{"version":3,"file":"useLiveDot.d.ts","sourceRoot":"","sources":["../../src/hooks/useLiveDot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,SAAS,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,EAC/B,cAAc,UAAQ;;;EAwBvB"}

package/dist/hooks/useMarkers.d.ts

@@ -3,14 +3,22 @@ import { type SharedValue } from "react-native-reanimated";
 import type { ChartEngineLayout } from "../core/useLiveChartEngine";
 import type { ChartPadding } from "../draw/line";
 import { type ProjectedMarker } from "../math/markers";
-import type { LiveChartPoint, Marker, MarkerHoverEvent, SeriesConfig } from "../types";
+import { type ResolvedMarkerCluster } from "../math/markerCluster";
+import type { LiveChartPoint, Marker, MarkerPressEvent, SeriesConfig } from "../types";
 /**
  * Projects markers to screen positions each frame and builds a tap gesture that
- * hit-tests against them, firing `onMarkerHover` (or `null` on a miss).
+ * hit-tests against them, firing `onMarkerPress` (or `null` on a miss). Applies
+ * the {@link clusterMarkers} collision pass each frame so hit-testing matches the
+ * drawn (stacked / collapsed) positions.
  */
-export declare function useMarkers(engine: ChartEngineLayout, padding: ChartPadding, markers: SharedValue<Marker[]>, active: boolean, hitRadius: number, onMarkerHover?: (event: MarkerHoverEvent | null) => void, seriesSV?: SharedValue<SeriesConfig[]>, lineData?: SharedValue<LiveChartPoint[]>, 
+export declare function useMarkers(engine: ChartEngineLayout, padding: ChartPadding, markers: SharedValue<Marker[]>, active: boolean, hitRadius: number, onMarkerPress?: (event: MarkerPressEvent | null) => void, seriesSV?: SharedValue<SeriesConfig[]>, lineData?: SharedValue<LiveChartPoint[]>, 
 /** Static charts run no loops: register without starting. Default `true`. */
-autostart?: boolean): {
+autostart?: boolean, 
+/** Single-series line is drawn linear (`line.curve === "linear"`) — anchor
+ *  `lineData` markers on the straight chord rather than the spline. */
+lineLinear?: boolean, 
+/** Collision config; default `"anchored"` (no stacking). */
+cluster?: ResolvedMarkerCluster): {
     projected: SharedValue<ProjectedMarker[]>;
     tapGesture: ReturnType<typeof Gesture.Tap>;
     /** Worklet hit-test: true when (x, y) lands on a projected marker. */

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

@@ -1 +1 @@
-{"version":3,"file":"useMarkers.d.ts","sourceRoot":"","sources":["../../src/hooks/useMarkers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,KAAK,EACV,cAAc,EACd,MAAM,EACN,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,EACxD,QAAQ,CAAC,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC,EACtC,QAAQ,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,CAAC;AACxC,6EAA6E;AAC7E,SAAS,UAAO,GACf;IACD,SAAS,EAAE,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1C,UAAU,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CA0EA"}
+{"version":3,"file":"useMarkers.d.ts","sourceRoot":"","sources":["../../src/hooks/useMarkers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EACV,cAAc,EACd,MAAM,EACN,gBAAgB,EAChB,YAAY,EACb,MAAM,UAAU,CAAC;AASlB;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,EAAE,OAAO,EACf,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,KAAK,IAAI,EACxD,QAAQ,CAAC,EAAE,WAAW,CAAC,YAAY,EAAE,CAAC,EACtC,QAAQ,CAAC,EAAE,WAAW,CAAC,cAAc,EAAE,CAAC;AACxC,6EAA6E;AAC7E,SAAS,UAAO;AAChB;uEACuE;AACvE,UAAU,UAAQ;AAClB,4DAA4D;AAC5D,OAAO,GAAE,qBAAwC,GAChD;IACD,SAAS,EAAE,WAAW,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1C,UAAU,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,sEAAsE;IACtE,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAuFA"}

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

@@ -1 +1 @@
-{"version":3,"file":"useMultiSeriesLinePaths.d.ts","sourceRoot":"","sources":["../../src/hooks/useMultiSeriesLinePaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,WAAW,CAAC,MAAM,EAAE,CAAC,CAmDvB"}
+{"version":3,"file":"useMultiSeriesLinePaths.d.ts","sourceRoot":"","sources":["../../src/hooks/useMultiSeriesLinePaths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAIlE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,YAAY,GACpB,WAAW,CAAC,MAAM,EAAE,CAAC,CAoDvB"}

package/dist/hooks/usePanScroll.d.ts

@@ -0,0 +1,82 @@
+import { Gesture } from "react-native-gesture-handler";
+import { type SharedValue } from "react-native-reanimated";
+import type { ChartPadding } from "../draw/line";
+/** Minimum height (px) of the bottom "grab the time ruler" band in axis-drag mode. */
+export declare const AXIS_GRAB_MIN_PX = 44;
+/** Which gesture activates a time-scroll. */
+export type PanScrollGestureMode = "holdToScrub" | "axisDrag";
+/** Engine SharedValues the pan-scroll gesture reads/writes (subset of the engine state). */
+export interface PanScrollEngineRefs {
+    /** Absolute right-edge time to freeze at, or `null` to follow the live edge. */
+    viewEnd: SharedValue<number | null>;
+    /** Right-edge time the engine would use if following live (advances each frame). */
+    liveEdge: SharedValue<number>;
+    /** Animating visible window width in seconds. */
+    displayWindow: SharedValue<number>;
+    /** Canvas width in px. */
+    canvasWidth: SharedValue<number>;
+    /** Canvas height in px (for the axis-drag band hit-test). */
+    canvasHeight: SharedValue<number>;
+}
+export interface UsePanScrollOptions {
+    engine: PanScrollEngineRefs;
+    padding: ChartPadding;
+    /**
+     * Earliest selectable time (unix seconds) — typically the first data point /
+     * candle. Clamps how far back the window can pan. When there's no scrollable
+     * history this should equal (or exceed) the live edge so panning is a no-op.
+     */
+    minTime: SharedValue<number>;
+    /** Master switch. When false the gesture is disabled and the chart follows live. */
+    enabled: boolean;
+    /**
+     * Activation model:
+     *  - `"holdToScrub"` (default): a one-finger drag anywhere scrolls; scrub moves
+     *    to press-and-hold (Rainbow-style). The caller must give the scrub gesture
+     *    a long-press delay so a quick drag falls through to this one.
+     *  - `"axisDrag"`: a one-finger drag starting in the bottom X-axis band ("grab
+     *    the time ruler"); one-finger plot scrub untouched.
+     */
+    mode?: PanScrollGestureMode;
+    /**
+     * Worklet fired when a scroll drag activates — e.g. to clear the crosshair so
+     * a stray scrub doesn't linger behind the pan.
+     */
+    onScrollStart?: () => void;
+}
+/**
+ * Smallest valid right-edge time: keeps the window's left edge
+ * (`rightEdge - window`) from passing `minTime`, and never exceeds the live edge
+ * so the `[lo, liveEdge]` clamp range stays valid when history is short.
+ */
+export declare function panLowerBound(minTime: number, windowSecs: number, liveEdge: number): number;
+/**
+ * Next right-edge time after dragging `changeX` px (drag right ⇒ reveal earlier
+ * time ⇒ smaller right edge), clamped to `[lo, liveEdge]`. Returns `null` once
+ * the drag reaches the live edge — the signal to resume following.
+ */
+export declare function nextViewEnd(cur: number, changeX: number, chartW: number, windowSecs: number, liveEdge: number, lo: number): number | null;
+/** Pan velocity (px/s) → time-seconds/s for `withDecay` (drag right ⇒ earlier). */
+export declare function flingVelocity(velocityX: number, chartW: number, windowSecs: number): number;
+/**
+ * Top y (px) of the axis-drag grab band — a touch at or below this row starts a
+ * scroll. The band is the bottom padding (where the time labels sit), widened to
+ * a comfortable touch target.
+ */
+export declare function axisBandTop(canvasHeight: number, padBottom: number): number;
+/**
+ * Horizontal pan that scrolls the chart back through time. Pick the activation
+ * with `mode`:
+ *  - `"holdToScrub"` — a one-finger drag anywhere (activates on horizontal
+ *    travel; vertical falls through). Scrub must be press-and-hold so a quick
+ *    drag races past it (compose with `Gesture.Race`).
+ *  - `"axisDrag"` — a one-finger drag starting in the bottom X-axis band, gated
+ *    via `manualActivation` (compose with `Gesture.Exclusive`, this gesture
+ *    first: outside the band it fails instantly so scrub runs).
+ *
+ * Writes `engine.viewEnd`: a number freezes the window at that absolute right
+ * 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>;
+//# sourceMappingURL=usePanScroll.d.ts.map

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

@@ -0,0 +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"}

package/dist/hooks/usePinchZoom.d.ts

@@ -0,0 +1,74 @@
+import { Gesture } from "react-native-gesture-handler";
+import { type SharedValue } from "react-native-reanimated";
+import type { ChartPadding } from "../draw/line";
+/** Engine SharedValues the pinch-zoom gesture reads/writes. */
+export interface PinchZoomEngineRefs {
+    /** Visible-window width override in seconds, or `null` to follow `timeWindow`. */
+    viewWindow: SharedValue<number | null>;
+    /** Absolute right-edge time, or `null` to follow the live edge (shared with pan). */
+    viewEnd: SharedValue<number | null>;
+    /** Right-edge time the engine would use if following live (advances each frame). */
+    liveEdge: SharedValue<number>;
+    /**
+     * Animating visible window width in seconds. Written directly during a pinch so
+     * the displayed window tracks the fingers 1:1 (the frame-loop lerp toward
+     * `timeWindow` would otherwise lag a fast pinch and the focal anchor would drift).
+     */
+    displayWindow: SharedValue<number>;
+    /** Canvas width in px. */
+    canvasWidth: SharedValue<number>;
+}
+export interface UsePinchZoomOptions {
+    engine: PinchZoomEngineRefs;
+    padding: ChartPadding;
+    /**
+     * Earliest selectable time (unix seconds) — typically the first data point /
+     * candle. Caps how far the (now wider) window can pan back when zooming out.
+     */
+    minTime: SharedValue<number>;
+    /** The configured `timeWindow` prop (seconds) — the anchor for the zoom bounds. */
+    timeWindow: number;
+    /** Master switch. When false the gesture is disabled. */
+    enabled: boolean;
+    /** Tightest window (max zoom-in), seconds. Default `timeWindow / 8`. */
+    minTimeWindow?: number;
+    /** Widest window (max zoom-out), seconds. Default: the full data span, ≥ `timeWindow`. */
+    maxTimeWindow?: number;
+    /** Worklet fired when a pinch activates — e.g. to clear a lingering crosshair. */
+    onZoomStart?: () => void;
+}
+/** Clamp a window width to `[minWin, maxWin]`. */
+export declare function clampWindow(win: number, minWin: number, maxWin: number): number;
+/**
+ * Resolve the zoom bounds for a gesture. `maxWin` defaults to the data span but
+ * never goes below the configured window (so you can always zoom back out to the
+ * starting view); `minWin` defaults to an 8× zoom-in of the configured window.
+ * Guards against an inverted range (min ≤ max).
+ */
+export declare function zoomWindowBounds(configWindow: number, span: number, minCfg: number | undefined, maxCfg: number | undefined): [number, number];
+/**
+ * Absolute time under a pixel x, given the visible window. Inverse of the chart's
+ * time→x projection: `x = chartLeft + (t - winStart)/window * chartW`.
+ */
+export declare function focalTime(focalX: number, chartLeft: number, chartW: number, winStart: number, windowSecs: number): number;
+/**
+ * The new right-edge time that keeps `focalT` pinned under `focalX` after the
+ * window width changes to `newWindow` — i.e. zoom around the focal point. Derived
+ * from the projection above by solving for the right edge (`winStart + window`):
+ * the right edge sits `(fraction of the window to the right of the focal)` past
+ * `focalT`.
+ */
+export declare function zoomViewEnd(focalT: number, focalX: number, chartLeft: number, chartW: number, newWindow: number): number;
+/**
+ * Pinch-to-zoom the visible time window, anchored at the focal point between the
+ * two fingers (the time under your fingers stays put). Writes `engine.viewWindow`
+ * (the window width) and `engine.viewEnd` (the right edge, so the focal anchor
+ * holds) — the symmetric counterpart of {@link usePanScroll}, which only moves the
+ * right edge. Pinch is two-finger, so it composes with the one-finger pan/scrub
+ * via `Gesture.Simultaneous`.
+ *
+ * Reaching the live edge resumes following (`viewEnd → null`); the zoom level
+ * (`viewWindow`) is independent of scroll position and persists.
+ */
+export declare function usePinchZoom({ engine, padding, minTime, timeWindow, enabled, minTimeWindow, maxTimeWindow, onZoomStart, }: UsePinchZoomOptions): ReturnType<typeof Gesture.Pinch>;
+//# sourceMappingURL=usePinchZoom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usePinchZoom.d.ts","sourceRoot":"","sources":["../../src/hooks/usePinchZoom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAGjD,+DAA+D;AAC/D,MAAM,WAAW,mBAAmB;IAClC,kFAAkF;IAClF,UAAU,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACvC,qFAAqF;IACrF,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACpC,oFAAoF;IACpF,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;OAIG;IACH,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,0BAA0B;IAC1B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB;;;OAGG;IACH,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED,kDAAkD;AAClD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,MAAM,CAKR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,CAAC,MAAM,EAAE,MAAM,CAAC,CAMlB;AAED;;;GAGG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,CAGR;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,OAAO,EACP,UAAU,EACV,OAAO,EACP,aAAa,EACb,aAAa,EACb,WAAW,GACZ,EAAE,mBAAmB,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC,CAuDxD"}

package/dist/hooks/useReferenceDrag.d.ts

@@ -0,0 +1,24 @@
+import { Gesture } from "react-native-gesture-handler";
+import { type SharedValue } from "react-native-reanimated";
+import type { ChartEngineLayout } from "../core/useLiveChartEngine";
+import type { ChartPadding } from "../draw/line";
+import type { ReferenceLine } from "../types";
+/**
+ * Builds the per-line **drag** gesture for draggable Form-A reference lines: grab a
+ * line near its value-Y and drag vertically to set a new value, with optional
+ * `snap` + `bounds` clamp. Mirrors the order-ticket reticle in {@link useCrosshair}
+ * (value↔Y via `computeValueAtY` / `computeScrubDotY`, frozen value re-projected
+ * each frame) but per line, writing into the shared `dragValues` array the layout
+ * and overlays read.
+ *
+ * The pan uses `manualActivation`: it grabs only when a touch starts within
+ * {@link GRAB_SLOP} of a draggable line **and** the motion is vertical — a
+ * horizontal drag (scrub) or a touch off every line fails fast so the chart's other
+ * gestures run (compose this ahead of them via `Gesture.Exclusive`).
+ *
+ * Also fires the per-line drag callbacks: `onChange` (de-duped during drag),
+ * `onCommit` (on release), and `onDragIn` / `onDragOut` (value crossing the visible
+ * range or a `bounds`, from a drag or the axis rescaling — edge-detected each frame).
+ */
+export declare function useReferenceDrag(engine: ChartEngineLayout, padding: ChartPadding, lines: ReferenceLine[], dragValues: SharedValue<number[]>, dragActive: SharedValue<boolean[]>, enabled: boolean): ReturnType<typeof Gesture.Pan>;
+//# sourceMappingURL=useReferenceDrag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceDrag.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceDrag.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAgB9C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,aAAa,EAAE,EACtB,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EACjC,UAAU,EAAE,WAAW,CAAC,OAAO,EAAE,CAAC,EAClC,OAAO,EAAE,OAAO,GACf,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAoMhC"}

package/dist/hooks/useReferenceLine.d.ts

@@ -10,10 +10,20 @@ export interface ReferenceLineLayout {
     y: number;
     /** Band bottom-edge y (value/time band); equals `y` for a plain line. */
     yBottom: number;
-    /** Left x extent. */
+    /** Left x extent of the plot (badge / label / connector anchor). */
     x1: number;
-    /** Right x extent. */
+    /** Right x extent of the plot (badge / label / connector anchor). */
     x2: number;
+    /**
+     * Left x of the **drawn** line / band. Equals {@link x1} normally, or `0`
+     * (canvas edge) when the line is full-width. Decoupled from {@link x1} so the
+     * line can run through the gutter while the badge/label stays in the plot.
+     */
+    lineX1: number;
+    /** Right x of the drawn line / band: {@link x2} normally, or the canvas width when full-width. */
+    lineX2: number;
+    /** Stroke the plain horizontal line (true for a plain Form-A line, or a full-width badged line). */
+    drawLine: boolean;
     /** Resolved label text (with appended value when `showValue`); "" when hidden. */
     label: string;
     labelX: number;
@@ -54,12 +64,21 @@ export interface ReferenceBadgeRect {
  * {@link useReferenceLine}, so the hit-target tracks the rendered pill exactly.
  * Pure worklet — used by {@link useReferenceLinePress} for tap hit-testing.
  */
-export declare function computeReferenceBadgeRect(line: ReferenceLine, canvasWidth: number, canvasHeight: number, padding: ChartPadding, dMin: number, dMax: number, font: SkFont, formatValue: (value: number) => string): ReferenceBadgeRect | null;
+export declare function computeReferenceBadgeRect(line: ReferenceLine, canvasWidth: number, canvasHeight: number, padding: ChartPadding, dMin: number, dMax: number, font: SkFont, formatValue: (value: number) => string, 
+/** Live value override (e.g. a dragged value), defaulting to `line.value`. */
+valueOverride?: number): ReferenceBadgeRect | null;
 /**
  * Derives screen-space layout for a single reference line or band. Supports all
  * three `ReferenceLine` forms (horizontal line, horizontal value band, vertical
  * time band) plus the pill badge for a Form-A value (in-range tag + off-screen
  * chevron pin).
  */
-export declare function useReferenceLine(engine: ChartEngineLayout, padding: ChartPadding, line: ReferenceLine | undefined, formatValue: (v: number) => string, font: SkFont): SharedValue<ReferenceLineLayout>;
+export declare function useReferenceLine(engine: ChartEngineLayout, padding: ChartPadding, line: ReferenceLine | undefined, formatValue: (v: number) => string, font: SkFont, 
+/**
+ * Per-line live value overrides (e.g. dragged values), index-aligned with the
+ * chart's `referenceLines`. When provided and the slot at {@link index} holds a
+ * number, the Form-A line tracks that value instead of the static `line.value`,
+ * so a drag updates the rendered line/badge on the UI thread. Omit for static lines.
+ */
+dragValues?: SharedValue<number[]>, index?: number): SharedValue<ReferenceLineLayout>;
 //# sourceMappingURL=useReferenceLine.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useReferenceLine.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AA8ID,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GACrC,kBAAkB,GAAG,IAAI,CAwC3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,IAAI,EAAE,MAAM,GACX,WAAW,CAAC,mBAAmB,CAAC,CA2LlC"}
+{"version":3,"file":"useReferenceLine.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceLine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAOjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,CAAC,EAAE,MAAM,CAAC;IACV,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC;IACf,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,QAAQ,EAAE,OAAO,CAAC;IAClB,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAC;IACjB,uEAAuE;IACvE,SAAS,EAAE,OAAO,CAAC;IACnB,+EAA+E;IAC/E,KAAK,EAAE,OAAO,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAoJD,sFAAsF;AACtF,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,aAAa,EACnB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM;AACtC,8EAA8E;AAC9E,aAAa,CAAC,EAAE,MAAM,GACrB,kBAAkB,GAAG,IAAI,CAwC3B;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,IAAI,EAAE,MAAM;AACZ;;;;;GAKG;AACH,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAClC,KAAK,SAAI,GACR,WAAW,CAAC,mBAAmB,CAAC,CAgNlC"}

package/dist/hooks/useReferenceLinePress.d.ts

@@ -1,5 +1,6 @@
 import type { SkFont } from "@shopify/react-native-skia";
 import { Gesture } from "react-native-gesture-handler";
+import { type SharedValue } from "react-native-reanimated";
 import type { ChartEngineLayout } from "../core/useLiveChartEngine";
 import type { ChartPadding } from "../draw/line";
 import type { ReferenceLine } from "../types";
@@ -16,7 +17,10 @@ import type { ReferenceLine } from "../types";
  */
 export declare function useReferenceLinePress(engine: ChartEngineLayout, padding: ChartPadding, lines: ReferenceLine[], font: SkFont, formatValue: (v: number) => string, active: boolean, 
 /** Touch-target inflation around each pill, in px. */
-hitSlop: number, onPress?: (line: ReferenceLine, index: number) => void): {
+hitSlop: number, onPress?: (line: ReferenceLine, index: number) => void, 
+/** Per-line live value overrides (dragged values) so a draggable line's hit-rect
+ *  tracks the drag, index-aligned with `lines`. */
+dragValues?: SharedValue<number[]>): {
     tapGesture: ReturnType<typeof Gesture.Tap>;
     hitTest: (x: number, y: number) => boolean;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"useReferenceLinePress.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceLinePress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AAIvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,MAAM,EAAE,OAAO;AACf,sDAAsD;AACtD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACrD;IACD,UAAU,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAqDA"}
+{"version":3,"file":"useReferenceLinePress.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceLinePress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,8BAA8B,CAAC;AACvD,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAO9C;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,aAAa,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,EAClC,MAAM,EAAE,OAAO;AACf,sDAAsD;AACtD,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI;AACtD;mDACmD;AACnD,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,GACjC;IACD,UAAU,EAAE,UAAU,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3C,OAAO,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAgEA"}

package/dist/hooks/useVisibleRange.d.ts

@@ -0,0 +1,39 @@
+import { type SharedValue } from "react-native-reanimated";
+import type { VisibleRange } from "../types";
+export type { VisibleRange };
+/** Engine SharedValues the visible-range reaction reads. */
+export interface VisibleRangeEngineRefs {
+    timestamp: SharedValue<number>;
+    displayWindow: SharedValue<number>;
+    viewEnd: SharedValue<number | null>;
+}
+export interface UseVisibleRangeOptions {
+    engine: VisibleRangeEngineRefs;
+    /** Earliest retained time (unix seconds) — used for the `onReachStart` trigger. */
+    minTime: SharedValue<number>;
+    /** Fires (throttled to ~1 Hz) when the visible window's edges change. */
+    onVisibleRangeChange?: (range: VisibleRange) => void;
+    /**
+     * Fires once when the window's left edge comes within one window-width of the
+     * earliest retained data — the cue to lazily page in older history. Re-arms
+     * after the edge moves back out.
+     */
+    onReachStart?: () => void;
+}
+/**
+ * Throttle key for a visible range: integer seconds of each edge plus the
+ * near-start flag. The reaction emits only when this changes, so a live chart
+ * (whose right edge slides every frame) notifies at most ~once per second rather
+ * than per frame, and `onReachStart` edge-triggers off the trailing flag.
+ */
+export declare function rangeSignature(startSec: number, endSec: number, near: boolean): string;
+/** Whether the window's left edge is within `threshold` seconds of the oldest data. */
+export declare function isNearStart(winStart: number, minTime: number, threshold: number): boolean;
+/**
+ * Bridges the UI-thread visible window to JS paging callbacks. A reaction watches
+ * the window edges and `scheduleOnRN`s `onVisibleRangeChange` (throttled) and
+ * `onReachStart` (edge-triggered near the oldest data). Inert when both callbacks
+ * are absent. Used by both `LiveChart` and `LiveChartSeries`.
+ */
+export declare function useVisibleRange({ engine, minTime, onVisibleRangeChange, onReachStart, }: UseVisibleRangeOptions): void;
+//# sourceMappingURL=useVisibleRange.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useVisibleRange.d.ts","sourceRoot":"","sources":["../../src/hooks/useVisibleRange.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7C,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B,4DAA4D;AAC5D,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,WAAW,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,mFAAmF;IACnF,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;IACrD;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,GACZ,MAAM,CAGR;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,OAAO,CAGT;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,EAC9B,MAAM,EACN,OAAO,EACP,oBAAoB,EACpB,YAAY,GACb,EAAE,sBAAsB,GAAG,IAAI,CAkD/B"}

package/dist/index.d.ts

@@ -14,5 +14,6 @@ export { formatTime, formatValue } from "./lib/format";
 export { MONO_FONT_FAMILY } from "./lib/monoFontFamily";
 export { useDegen } from "./hooks/useDegen";
 export { useTradeStream } from "./hooks/useTradeStream";
-export type { AreaDotsConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeVariant, CandleMetrics, CandlePoint, ChartInsets, ChartSegment, DegenOptions, DegenShakePayload, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartMetrics, LiveChartMetricsOverride, LiveChartPalette, LiveChartPoint, LiveChartProps, LiveChartSeriesProps, Marker, MarkerHoverEvent, MarkerKind, Momentum, MomentumConfig, MotionMetrics, MultiSeriesDotConfig, PulseConfig, ReferenceLine, ReferenceLineBadgeConfig, ScrubActionConfig, ScrubActionPoint, ScrubConfig, ScrubPoint, ScrubPointCore, ScrubPointMulti, ScrubSeriesValue, SelectionDotConfig, SelectionDotProps, SelectionDotRingConfig, SeriesConfig, ThemeMode, ThresholdConfig, ThresholdLineConfig, TooltipRenderProps, TradeEvent, ValueLineConfig, XAxisConfig, YAxisConfig, } from "./types";
+export { usePriceY, useTimeX } from "./hooks/useChartOverlayContext";
+export type { AreaDotsConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeStyleConfig, BadgeVariant, CandleMetrics, CandlePoint, ChartInsets, ChartOverlayContext, ChartPlotRect, ChartScale, ChartSegment, DegenOptions, DegenShakePayload, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartMetrics, LiveChartMetricsOverride, LiveChartPalette, LiveChartPoint, LiveChartProps, LiveChartSeriesProps, Marker, MarkerClusterConfig, MarkerKind, MarkerPressEvent, MarkerRenderContext, MarkerSide, Momentum, MomentumConfig, MotionMetrics, MultiSeriesDotConfig, PulseConfig, ReferenceLine, ReferenceLineBadgeConfig, ReferenceLineGroupingConfig, ReferenceLineRenderProps, ScrubActionConfig, ScrubActionPoint, ScrubConfig, ScrubPoint, ScrubPointCore, ScrubPointMulti, ScrubSeriesValue, SelectionDotConfig, SelectionDotProps, SelectionDotRingConfig, SeriesConfig, ThemeMode, ThresholdConfig, ThresholdLineConfig, TooltipRenderProps, TradeEvent, 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,YAAY,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,WAAW,EACX,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,MAAM,EACN,gBAAgB,EAChB,UAAU,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,wBAAwB,EACxB,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,eAAe,EACf,WAAW,EACX,WAAW,GACZ,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,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,MAAM,EACN,mBAAmB,EACnB,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,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,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,WAAW,EACX,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/math/markerCluster.d.ts

@@ -0,0 +1,47 @@
+import type { Marker } from "../types";
+import type { ProjectedMarker } from "./markers";
+/**
+ * Resolved {@link LiveChartProps.markerCluster} config (see `resolveMarkerCluster`).
+ */
+export interface ResolvedMarkerCluster {
+    /** `"anchored"` = no collision handling (glyphs overlap). `"stacked"` = fan +
+     *  collapse co-located markers. */
+    mode: "anchored" | "stacked";
+    /** Fraction (0–1) that adjacent co-located glyphs overlap when fanned. The fan
+     *  step is `glyphHeight * (1 - overlap)`; `glyphHeight` is a slightly generous
+     *  primitive estimate, so the *visible* overlap runs a touch lower. */
+    overlap: number;
+    /** Extra px between a sided glyph and its anchor. */
+    gap: number;
+    /** Collapse a co-located run to a single count badge once it exceeds this many. */
+    maxBeforeGroup: number;
+}
+export interface ClusterMarkersOpts {
+    config: ResolvedMarkerCluster;
+}
+/**
+ * Estimated vertical (≈ horizontal) footprint of a marker glyph in px. Derived
+ * from primitives only (no font metrics / atlas), so the hit-test hook and the
+ * overlays compute identical offsets from identical inputs — keeping the drawn
+ * and hit-tested positions in sync. Not pixel-exact with the atlas cell; the
+ * generous default `markerHitRadius` absorbs the small difference.
+ */
+export declare function glyphHeight(m: Marker): number;
+/**
+ * Collision pass over projected markers, mutating `proj` in place.
+ *
+ * `"anchored"` mode only applies each marker's {@link Marker.side} offset (a lone
+ * glyph sitting above/below its anchor); it does no bucketing, so charts that
+ * don't use `side` are untouched. `"stacked"` mode additionally buckets
+ * co-located markers (same side, overlapping x/y) and fans or collapses them.
+ *
+ * Runs every frame on the UI thread, so grouping is zoom/scroll-reactive. Reads
+ * the *raw* projected positions from `projectMarkers` and overwrites them.
+ */
+export declare function clusterMarkers(markers: Marker[], proj: ProjectedMarker[], opts: ClusterMarkersOpts): void;
+/**
+ * Markers belonging to the collapsed cluster whose representative is `repIndex`
+ * (ordered by time). Call after {@link clusterMarkers} has populated `proj`.
+ */
+export declare function clusterMembers(markers: Marker[], proj: ProjectedMarker[], repIndex: number): Marker[];
+//# sourceMappingURL=markerCluster.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"markerCluster.d.ts","sourceRoot":"","sources":["../../src/math/markerCluster.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,UAAU,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;uCACmC;IACnC,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B;;2EAEuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,mFAAmF;IACnF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAKD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AA4FD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,eAAe,EAAE,EACvB,IAAI,EAAE,kBAAkB,GACvB,IAAI,CAiDN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,eAAe,EAAE,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,CAQV"}

package/dist/math/markers.d.ts

@@ -4,6 +4,16 @@ export interface ProjectedMarker {
     x: number;
     y: number;
     visible: boolean;
+    /** Collapsed cluster member that the representative stands in for — not drawn,
+     *  not hit-tested. Set by the cluster pass; `false` outside `markerCluster`. */
+    hidden: boolean;
+    /** This marker is the representative (count badge) of a collapsed cluster. */
+    isGrouped: boolean;
+    /** Size of the collapsed cluster this marker represents (`0` when not grouped). */
+    groupCount: number;
+    /** Index of the cluster's representative marker for collapsed members (and the
+     *  representative itself), else `-1`. Used to gather members on tap. */
+    groupRep: number;
 }
 export interface ProjectMarkersOpts {
     canvasWidth: number;
@@ -20,6 +30,11 @@ export interface ProjectMarkersOpts {
     series?: SeriesConfig[];
     /** Single-series line data; anchors markers that omit `value` (and `seriesId`). */
     lineData?: LiveChartPoint[];
+    /** When the single-series line is drawn with `line.curve === "linear"`, anchor
+     *  `lineData` markers on the straight chord (linear interpolation) instead of the
+     *  monotone spline so the glyph sits exactly on the rendered line. Multi-series
+     *  markers read their curve per-series from {@link SeriesConfig.curve}. */
+    lineLinear?: boolean;
 }
 /**
  * Project markers to screen positions, mutating `out` in place (reused buffer).