react-native-livechart 4.20.0 → 4.21.0

package/dist/hooks/useLineGapPaths.d.ts

@@ -0,0 +1,10 @@
+import type { ResolvedCandleGapsConfig } from "../core/resolveConfig";
+import type { SingleEngineState } from "../core/useLiveChartEngine";
+import type { ChartPadding } from "../draw/line";
+/** Batched flat previous-value bridge paths for each semantic line-gap kind. */
+export declare function useLineGapPaths(engine: SingleEngineState, padding: ChartPadding, config: ResolvedCandleGapsConfig): {
+    readonly noTradesPath: import("react-native-reanimated").DerivedValue<import("@shopify/react-native-skia").SkPath>;
+    readonly unavailablePath: import("react-native-reanimated").DerivedValue<import("@shopify/react-native-skia").SkPath>;
+    readonly unknownPath: import("react-native-reanimated").DerivedValue<import("@shopify/react-native-skia").SkPath>;
+};
+//# sourceMappingURL=useLineGapPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLineGapPaths.d.ts","sourceRoot":"","sources":["../../src/hooks/useLineGapPaths.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAIjD,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,wBAAwB;;;;EAgEjC"}

package/dist/hooks/useReferenceLine.d.ts

@@ -70,9 +70,10 @@ export declare function computeReferenceBadgeRect(line: ReferenceLine, canvasWid
 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).
+ * three scalar/band `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). The series form is handled by
+ * `ReferenceLineSeriesOverlay`.
  */
 export declare function useReferenceLine(engine: ChartEngineLayout, padding: ChartPadding, line: ReferenceLine | undefined, formatValue: (v: number) => string, font: SkFont, 
 /**

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,EAEL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,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;AACT,oEAAoE;AACpE,YAAY,CAAC,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;AACxC,+EAA+E;AAC/E,gBAAgB,CAAC,EAAE,MAAM;AACzB,2EAA2E;AAC3E,UAAU,SAAI;AACd,mFAAmF;AACnF,SAAS,GAAE,MAAa,GACvB,WAAW,CAAC,mBAAmB,CAAC,CA6NlC"}
+{"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,EAEL,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,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;;;;;;GAMG;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;AACT,oEAAoE;AACpE,YAAY,CAAC,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC;AACxC,+EAA+E;AAC/E,gBAAgB,CAAC,EAAE,MAAM;AACzB,2EAA2E;AAC3E,UAAU,SAAI;AACd,mFAAmF;AACnF,SAAS,GAAE,MAAa,GACvB,WAAW,CAAC,mBAAmB,CAAC,CA6NlC"}

package/dist/hooks/useReferenceLineSeries.d.ts

@@ -0,0 +1,23 @@
+import { type SharedValue } from "react-native-reanimated";
+import type { ChartEngineLayout } from "../core/useLiveChartEngine";
+import type { ChartPadding } from "../draw/line";
+import type { LiveChartPoint } from "../types";
+export interface ReferenceLineSeriesGeometry {
+    /** Visible series polyline as `[x, y, …]` screen coordinates. */
+    screenPts: SharedValue<number[]>;
+    /** Whether any series segment crosses the visible plot. */
+    visible: SharedValue<boolean>;
+    /** Series value at the chart's current right edge. */
+    currentValue: SharedValue<number>;
+    /** Canvas Y coordinate of {@link currentValue}. */
+    currentY: SharedValue<number>;
+    /** Whether the current-value label belongs inside the visible plot. */
+    currentVisible: SharedValue<boolean>;
+}
+/**
+ * UI-thread geometry for a static historical reference-line series. Point
+ * buffers ping-pong so Reanimated observes a changed array reference each frame
+ * without allocating new intermediate arrays.
+ */
+export declare function useReferenceLineSeries(engine: ChartEngineLayout, padding: ChartPadding, points: LiveChartPoint[], extendToNow: boolean): ReferenceLineSeriesGeometry;
+//# sourceMappingURL=useReferenceLineSeries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useReferenceLineSeries.d.ts","sourceRoot":"","sources":["../../src/hooks/useReferenceLineSeries.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;AAQjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,2BAA2B;IAC1C,iEAAiE;IACjE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC,2DAA2D;IAC3D,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,sDAAsD;IACtD,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,mDAAmD;IACnD,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9B,uEAAuE;IACvE,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,cAAc,EAAE,EACxB,WAAW,EAAE,OAAO,GACnB,2BAA2B,CA+D7B"}

package/dist/hooks/useThreshold.d.ts

@@ -41,15 +41,15 @@ export interface ThresholdSeriesGeometry {
     samples: SharedValue<number[]>;
     /** Whether any of the polyline is on-screen (drives marker-line opacity). */
     visible: SharedValue<boolean>;
-    /** Threshold value at `now` (flat-extended past the last point) — the badge label. */
-    currentValue: SharedValue<number>;
-    /** Pixel-Y of `currentValue` — anchors the badge. */
-    currentLineY: SharedValue<number>;
-    /** Whether the badge should show: `currentLineY` on-plot AND, with
-     *  `extendToNow` off, "now" not past the series' last point. (`visible` can be
-     *  true for the polyline while the value-at-now sits outside the plot; the
-     *  badge must not draw into the gutters then.) */
-    currentVisible: SharedValue<boolean>;
+    /** Threshold value at the configured badge anchor: the visible window's
+     *  left edge (`"first"`) or its live/right edge (`"last"`). */
+    badgeValue: SharedValue<number>;
+    /** Pixel-Y of `badgeValue` — anchors the badge. */
+    badgeLineY: SharedValue<number>;
+    /** Whether the configured badge anchor is on-plot and belongs to a visible
+     *  part of the threshold. (`visible` can still be true when that one endpoint
+     *  is off-plot.) */
+    badgeVisible: SharedValue<boolean>;
     /** Pixel-X where the threshold ends: the last point's X with `extendToNow`
      *  off, else {@link THRESHOLD_NO_CLIP}. The shader paints its plain
      *  `restColor` right of it; the marker polyline stops there. */
@@ -59,14 +59,14 @@ export interface ThresholdSeriesGeometry {
  * Per-frame screen geometry for a **time-varying** threshold — a plain
  * `LiveChartPoint[]` `value` or a live `SharedValue<LiveChartPoint[]>` `series`
  * (which wins when both are given): the screen polyline (marker line +
- * fill-band bottom), the shader's pixel-Y `samples[]`, the current value/anchor
- * for the badge, and the `extendToNow` cutoff X. The array buffers ping-pong
- * (Reanimated only re-notifies subscribers when the returned reference
+ * fill-band bottom), the shader's pixel-Y `samples[]`, the configured endpoint
+ * value/anchor for the badge, and the `extendToNow` cutoff X. The array buffers
+ * ping-pong (Reanimated only re-notifies subscribers when the returned reference
  * changes). When the threshold is a constant `SharedValue<number>` every
  * worklet short-circuits cheaply and {@link useThreshold} drives the render
  * instead.
  */
-export declare function useThresholdSeries(engine: ChartEngineLayout, padding: ChartPadding, value: ThresholdValue, series?: SharedValue<LiveChartPoint[]> | null, extendToNow?: boolean): ThresholdSeriesGeometry;
+export declare function useThresholdSeries(engine: ChartEngineLayout, padding: ChartPadding, value: ThresholdValue, series?: SharedValue<LiveChartPoint[]> | null, extendToNow?: boolean, labelAnchor?: "first" | "last"): ThresholdSeriesGeometry;
 /**
  * Pack a series geometry + a color set into the {@link ThresholdSplitShader}'s
  * uniforms (one `SharedValue` per paint — stroke vs. the alpha-reduced fill band).

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

@@ -1 +1 @@
-{"version":3,"file":"useThreshold.d.ts","sourceRoot":"","sources":["../../src/hooks/useThreshold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEhE,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;AAYjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,CAAC;AAEpE,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,aAAM,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,oFAAoF;IACpF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,sFAAsF;IACtF,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACjD,2FAA2F;IAC3F,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,cAAc,GACpB,iBAAiB,CAgCnB;AAED,MAAM,WAAW,uBAAuB;IACtC;;iEAE6D;IAC7D,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC;;;8DAG0D;IAC1D,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,sFAAsF;IACtF,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,qDAAqD;IACrD,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC;;;sDAGkD;IAClD,cAAc,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACrC;;oEAEgE;IAChE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,cAAc,EACrB,MAAM,GAAE,WAAW,CAAC,cAAc,EAAE,CAAC,GAAG,IAAW,EACnD,WAAW,UAAO,GACjB,uBAAuB,CAoJzB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,WAAW,CAAC,QAAQ,CAAC,CAoBvB"}
+{"version":3,"file":"useThreshold.d.ts","sourceRoot":"","sources":["../../src/hooks/useThreshold.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAEhE,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;AAYjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,CAAC;AAEpE,oFAAoF;AACpF,eAAO,MAAM,iBAAiB,aAAM,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,oFAAoF;IACpF,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3B,oFAAoF;IACpF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B,sFAAsF;IACtF,WAAW,EAAE,WAAW,CAAC,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACjD,2FAA2F;IAC3F,cAAc,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,cAAc,GACpB,iBAAiB,CAgCnB;AAED,MAAM,WAAW,uBAAuB;IACtC;;iEAE6D;IAC7D,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACjC;;;8DAG0D;IAC1D,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/B,6EAA6E;IAC7E,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9B;mEAC+D;IAC/D,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,mDAAmD;IACnD,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC;;wBAEoB;IACpB,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACnC;;oEAEgE;IAChE,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACjC;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,cAAc,EACrB,MAAM,GAAE,WAAW,CAAC,cAAc,EAAE,CAAC,GAAG,IAAW,EACnD,WAAW,UAAO,EAClB,WAAW,GAAE,OAAO,GAAG,MAAe,GACrC,uBAAuB,CA4JzB;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,EAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,EACpB,SAAS,EAAE,MAAM,EAAE,EACnB,UAAU,EAAE,WAAW,CAAC,MAAM,CAAC,GAC9B,WAAW,CAAC,QAAQ,CAAC,CAoBvB"}

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, AxisAutoHideConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeStyleConfig, BadgeVariant, CandleMetrics, CandlePoint, CanvasMode, ChartInsets, ChartOverlayContext, ChartPlotRect, ChartScale, ChartSegment, DegenOptions, DegenShakePayload, DotGlowConfig, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartHandle, 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";
+export type { AreaDotsConfig, AxisAutoHideConfig, AxisLabelConfig, BadgeConfig, BadgeMetrics, BadgeStyleConfig, BadgeVariant, CandleGap, CandleGapBandStyle, CandleGapBridgeStyle, CandleGapKind, CandleGapLabelStyle, CandleGapStyle, CandleGapsConfig, CandleMetrics, CandlePoint, CanvasMode, ChartGap, ChartGapBandStyle, ChartGapBridgeStyle, ChartGapKind, ChartGapLabelStyle, ChartGapsConfig, ChartGapStyle, ChartInsets, ChartOverlayContext, ChartPlotRect, ChartScale, ChartSegment, DegenOptions, DegenShakePayload, DotGlowConfig, EmptyStateMetrics, FontConfig, FontWeight, GradientConfig, GridMetrics, GridStyleConfig, LeftEdgeFadeConfig, LegendConfig, LegendStyle, LineConfig, LiveChartCoreProps, LiveChartHandle, 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, ThresholdBadgeRenderProps, 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,kBAAkB,EAClB,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,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,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"}
+{"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,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,UAAU,EACV,kBAAkB,EAClB,eAAe,EACf,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,yBAAyB,EACzB,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/candleGaps.d.ts

@@ -0,0 +1,18 @@
+import type { CandleGap, CandleGapKind, CandlePoint } from "../types";
+/** Built-in, overridable copy for gap bands and scrub tooltips. */
+export declare function candleGapDefaultLabel(kind: CandleGapKind): string;
+/** Find the explicit half-open gap containing `time`. Input must be start-sorted. */
+export declare function pickCandleGapAtTime(gaps: CandleGap[], time: number): CandleGap | null;
+/** Latest real candle strictly before `time`, preferring a newer live candle. */
+export declare function previousCandleAtTime(candles: CandlePoint[], liveCandle: CandlePoint | null, time: number): CandlePoint | null;
+/** Previous observed close for a bridged gap; `null` when no anchor exists. */
+export declare function previousCandleCloseAtTime(candles: CandlePoint[], liveCandle: CandlePoint | null, time: number): number | null;
+/** Whether a real candle starts in the bucket beginning at `bucketTime`. */
+export declare function candleAtBucketTime(candles: CandlePoint[], liveCandle: CandlePoint | null, bucketTime: number, candleWidthSecs: number): CandlePoint | null;
+/**
+ * Bucket start under `time`, aligned to the nearest preceding real candle.
+ * Returns `null` for a partial edge bucket, a bucket with real OHLC, or a gap
+ * without a previous-close anchor.
+ */
+export declare function candleGapBucketStartAtTime(gap: CandleGap, time: number, candles: CandlePoint[], liveCandle: CandlePoint | null, candleWidthSecs: number): number | null;
+//# sourceMappingURL=candleGaps.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candleGaps.d.ts","sourceRoot":"","sources":["../../src/math/candleGaps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEtE,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAKjE;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,EAAE,MAAM,GACX,SAAS,GAAG,IAAI,CAYlB;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,IAAI,EAAE,MAAM,GACX,WAAW,GAAG,IAAI,CAkBpB;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAGf;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,GACtB,WAAW,GAAG,IAAI,CAkBpB;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,WAAW,EAAE,EACtB,UAAU,EAAE,WAAW,GAAG,IAAI,EAC9B,eAAe,EAAE,MAAM,GACtB,MAAM,GAAG,IAAI,CAmBf"}

package/dist/math/referenceLineSeries.d.ts

@@ -0,0 +1,12 @@
+import type { ChartPadding } from "../draw/line";
+import type { LiveChartPoint } from "../types";
+/**
+ * Project a historical reference-line series into screen-space `[x, y, …]`
+ * points for the visible time window. Window-edge values are interpolated so
+ * the path enters and leaves the plot cleanly. The series clamps to its first
+ * value on the left and, by default, to its last value at the live edge.
+ *
+ * Worklet-safe. When `out` is supplied it is cleared and reused.
+ */
+export declare function buildReferenceLineSeriesPoints(points: LiveChartPoint[], now: number, windowSecs: number, displayMin: number, displayMax: number, canvasWidth: number, canvasHeight: number, padding: ChartPadding, extendToNow: boolean, out?: number[]): number[];
+//# sourceMappingURL=referenceLineSeries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referenceLineSeries.d.ts","sourceRoot":"","sources":["../../src/math/referenceLineSeries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI/C;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,cAAc,EAAE,EACxB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,OAAO,EACpB,GAAG,CAAC,EAAE,MAAM,EAAE,GACb,MAAM,EAAE,CA0DV"}

package/dist/math/referenceLines.d.ts

@@ -1,15 +1,15 @@
 import type { FontWeight, ReferenceLine, ReferenceLineBadgeConfig } from "../types";
-/** Which of the three reference-line forms a `ReferenceLine` resolves to. */
-export type ReferenceLineForm = "line" | "value-band" | "time-band" | "none";
+/** Which of the four reference-line forms a `ReferenceLine` resolves to. */
+export type ReferenceLineForm = "line" | "series" | "value-band" | "time-band" | "none";
 /**
- * Classify a `ReferenceLine` into one of its three forms, applying the
- * documented precedence A (line) > B (value band) > C (time band).
+ * Classify a `ReferenceLine` into one of its four forms, applying the
+ * documented precedence A (line) > B (series) > C (value band) > D (time band).
  */
 export declare function referenceLineForm(rl: ReferenceLine): ReferenceLineForm;
 /**
  * Gather every Y value a set of reference lines should contribute to the
  * axis-range computation. Lines flagged `excludeFromRange` are skipped, as are
- * time bands (Form C) which constrain time, not value.
+ * time bands (Form D) which constrain time, not value.
  */
 export declare function collectReferenceValues(lines: ReferenceLine[]): number[];
 /**

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;;;;;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"}
+{"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,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,MAAM,CAAC;AAEX;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,iBAAiB,CAStE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAgCvE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,aAAa,EAAE,GAC9B,MAAM,EAAE,CAgBV;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/math/spline.d.ts

@@ -39,7 +39,11 @@ export type SplinePathSink = {
 export declare function drawSpline(path: SplinePathSink, pts: number[], scratch?: SplineScratch, 
 /** Straight polyline (`lineTo` per point) instead of the monotone cubic — an
  *  angular, hard-edged line. The caller has already `moveTo`'d point 0. */
-linear?: boolean): void;
+linear?: boolean, 
+/** First point index to draw (inclusive). The caller must moveTo this point. */
+startPoint?: number, 
+/** Last point index to draw (exclusive). Defaults to the full array. */
+endPoint?: number): void;
 /**
  * Value of the Fritsch–Carlson monotone cubic — the same curve {@link drawSpline}
  * renders — at `time`. Use this to anchor overlays (e.g. markers) exactly on the

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

@@ -1 +1 @@
-{"version":3,"file":"spline.d.ts","sourceRoot":"","sources":["../../src/math/spline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,EAAE,MAAM,EAAE,CAAC;CACb;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD;AAED;;;;;;;;;;;;;GAaG;AACH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,KACN,OAAO,CAAC;CACd,CAAC;AAEF,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,aAAa;AACvB;2EAC2E;AAC3E,MAAM,UAAQ,QAmEf;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAoEf"}
+{"version":3,"file":"spline.d.ts","sourceRoot":"","sources":["../../src/math/spline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,CAAC,EAAE,MAAM,EAAE,CAAC;IACZ,CAAC,EAAE,MAAM,EAAE,CAAC;CACb;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,aAAa,CAEjD;AAED;;;;;;;;;;;;;GAaG;AACH;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAC1C,OAAO,EAAE,CACP,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,KACN,OAAO,CAAC;CACd,CAAC;AAEF,wBAAgB,UAAU,CACxB,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,CAAC,EAAE,aAAa;AACvB;2EAC2E;AAC3E,MAAM,UAAQ;AACd,gFAAgF;AAChF,UAAU,SAAI;AACd,wEAAwE;AACxE,QAAQ,SAAkB,QAyE3B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,cAAc,EAAE,EACxB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,IAAI,CAoEf"}

package/dist/types.d.ts

@@ -32,11 +32,12 @@ export type CanvasMode = "transparent" | "opaque";
  */
 export type BadgeVariant = "default" | "minimal";
 /**
- * A reference line or band drawn into the chart. Three mutually-exclusive forms,
- * with precedence A > B > C when fields from more than one are present:
+ * A reference line or band drawn into the chart. Four mutually-exclusive forms,
+ * with precedence A > B > C > D when fields from more than one are present:
  * - **Form A** — horizontal line at `value`.
- * - **Form B** — horizontal band between `valueFrom` and `valueTo`.
- * - **Form C** — vertical time band between `from` and `to` (unix seconds).
+ * - **Form B** — time-varying line following `series`.
+ * - **Form C** — horizontal band between `valueFrom` and `valueTo`.
+ * - **Form D** — vertical time band between `from` and `to` (unix seconds).
  */
 export interface ReferenceLine {
     /**
@@ -46,13 +47,25 @@ export interface ReferenceLine {
     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`). */
+    /**
+     * Form B — a time-varying reference line. Points use unix-second timestamps
+     * and should be sorted oldest to newest. The first value extends to the left
+     * edge; the last value extends to the live edge unless {@link extendToNow} is
+     * `false`. Supported by line and candle charts.
+     */
+    series?: LiveChartPoint[];
+    /**
+     * Form B — extend the series' last value flat to the chart's live edge.
+     * Set `false` to stop at the last point. Default `true`.
+     */
+    extendToNow?: boolean;
+    /** Form C — horizontal band lower Y bound (paired with `valueTo`). */
     valueFrom?: number;
-    /** Form B — horizontal band upper Y bound (paired with `valueFrom`). */
+    /** Form C — horizontal band upper Y bound (paired with `valueFrom`). */
     valueTo?: number;
-    /** Form C — vertical time-band start, unix seconds (paired with `to`). */
+    /** Form D — vertical time-band start, unix seconds (paired with `to`). */
     from?: number;
-    /** Form C — vertical time-band end, unix seconds (paired with `from`). */
+    /** Form D — vertical time-band end, unix seconds (paired with `from`). */
     to?: number;
     /** Optional right-gutter label (e.g. `"Entry"`). */
     label?: string;
@@ -62,7 +75,7 @@ export interface ReferenceLine {
      * (top/bottom for value bands, left/right for time bands); omit for no border.
      */
     strokeWidth?: number;
-    /** Dash pattern as `[dashLength, gapLength]` in pixels (line stroke + band border). */
+    /** Dash pattern as `[dashLength, gapLength]` in pixels (line/series stroke + band border). */
     intervals?: [number, number];
     /**
      * Span the **full chart width** — edge to edge through the Y-axis gutter, not
@@ -70,13 +83,20 @@ export interface ReferenceLine {
      * value on the axis (like a price tag). Only the line/band extends; any
      * `label`/`badge` stays anchored inside the plot. For a Form-A line with a
      * `badge`, the full-width line replaces the dashed connector. No effect on a
-     * vertical time band. Default `false` (stops at the plot edge). Form A / B.
+     * vertical time band. Default `false` (stops at the plot edge). Form A / C.
      */
     fullWidth?: boolean;
     /** Line / band color override. Defaults to palette `refLine`. */
     color?: string;
+    /**
+     * Band fill color override. Defaults to {@link color}, then palette `refLine`.
+     * Form C / D only.
+     */
+    fillColor?: string;
     /** Fill opacity for a value / time band (0–1). Default `0.16`. */
     fillOpacity?: number;
+    /** Opacity for the line, series, or band border stroke (0–1). Default `1`. */
+    strokeOpacity?: number;
     /** Label text color. Defaults to `color`, then palette `refLabel`. */
     labelColor?: string;
     /**
@@ -85,7 +105,7 @@ export interface ReferenceLine {
      * (default `"left"`).
      */
     labelPosition?: "left" | "center" | "right";
-    /** Append the formatted `value` to the label (Form A only). Default `false`. */
+    /** Append the formatted value to the label (Form A/B). Default `false`. */
     showValue?: boolean;
     /**
      * Exclude this line's value(s) from the Y-axis range computation, so it may sit
@@ -500,6 +520,13 @@ export interface ThresholdLineConfig {
      * gutter like a legacy reference line (may overlap y-axis labels). Default `"left"`.
      */
     labelPosition?: "left" | "right";
+    /**
+     * Time-varying threshold series only: which visible endpoint supplies the
+     * label badge's Y position and optional value. `"first"` samples the
+     * threshold at the visible window's left edge; `"last"` uses the live/right
+     * edge. Independent of {@link labelPosition}. Default `"last"`.
+     */
+    labelAnchor?: "first" | "last";
     /** Line + label color. Defaults to palette `refLine` / `refLabel`. */
     color?: string;
     /** Dash pattern `[dashLength, gapLength]` in pixels. Default `[4, 4]`. */
@@ -512,6 +539,24 @@ export interface ThresholdLineConfig {
      *  mirroring `ReferenceLine.labelColor`. */
     labelColor?: string;
 }
+/**
+ * Context passed to {@link LiveChartProps.renderThresholdBadge}. The chart
+ * floats the returned React Native element over the canvas and pins it to the
+ * live threshold on the UI thread. Bind the SharedValues to animated content
+ * when its displayed value must update without React re-renders.
+ */
+export interface ThresholdBadgeRenderProps {
+    /** Resolved marker-line config for the badge being rendered. */
+    line: ThresholdLineConfig;
+    /** Live threshold value in Y-axis units. */
+    value: SharedValue<number>;
+    /** The threshold value formatted with the chart's `formatValue`. */
+    valueStr: SharedValue<string>;
+    /** Canvas Y pixel of the threshold (`NaN` when geometry is unavailable). */
+    y: SharedValue<number>;
+    /** Whether the threshold badge currently belongs inside the visible plot. */
+    visible: SharedValue<boolean>;
+}
 /** Object form of {@link ThresholdConfig.fill} — band tuning. */
 export interface ThresholdFillConfig {
     /** Band fill opacity (0–1), applied to the above/below colors. Multiplies an
@@ -1084,6 +1129,12 @@ export interface TooltipRenderProps {
      * worklet-safe formatter (e.g. the chart's `formatValue`).
      */
     candle: SharedValue<CandlePoint | null>;
+    /**
+     * Explicit line or candle gap under the crosshair (`null` outside a
+     * configured gap). A gap never fabricates {@link candle}; inspect this field
+     * for no-trade, unavailable, or unknown-data treatment.
+     */
+    gap: SharedValue<ChartGap | null>;
 }
 /** Inner plot rectangle in canvas pixels (a snapshot field of {@link ChartScale}). */
 export interface ChartPlotRect {
@@ -1657,6 +1708,8 @@ export interface ScrubPointCore {
 export interface ScrubPoint extends ScrubPointCore {
     /** In candle mode, the OHLC data of the candle under the crosshair. */
     candle?: CandlePoint;
+    /** Explicit chart gap under the crosshair, when a bridged gap supplies the value. */
+    gap?: ChartGap;
 }
 /** Scrub callback payload for multi-series charts. */
 export interface ScrubPointMulti extends ScrubPointCore {
@@ -1683,6 +1736,102 @@ export interface CandlePoint {
      */
     volume?: number;
 }
+/** Why a chart time range contains no observed market sample. */
+export type CandleGapKind = "no-trades" | "unavailable" | "unknown";
+/**
+ * Explicit metadata for a chart interval without an observed sample. The range
+ * is half-open (`[from, to)`) and uses Unix seconds, matching line points and
+ * {@link CandlePoint.time}. Gaps do not replace or mutate real data.
+ */
+export interface CandleGap {
+    /** Inclusive range start as a Unix timestamp in seconds. */
+    from: number;
+    /** Exclusive range end as a Unix timestamp in seconds. Must be greater than {@link from}. */
+    to: number;
+    /** Semantic reason the interval has no observation. */
+    kind: CandleGapKind;
+    /** Optional localized label, e.g. `"Exchange maintenance"`. */
+    label?: string;
+}
+/** Previous-value bridge styling for a chart gap. */
+export interface CandleGapBridgeStyle {
+    /** Mark color. Defaults to palette `refLine`. */
+    color?: string;
+    /** Mark opacity. Default `0.7` when enabled (`0.55` for unavailable gaps). */
+    opacity?: number;
+    /** Mark stroke width in pixels. Default `2`. */
+    strokeWidth?: number;
+    /** Mark cap style. Default `"round"`. */
+    strokeCap?: "butt" | "round" | "square";
+}
+/** Full-height time-band styling for a chart gap. */
+export interface CandleGapBandStyle {
+    /** Band fill color. Defaults to palette `refLine`. */
+    fillColor?: string;
+    /** Band fill opacity. Default `0.12` when enabled (`0.08` for unknown gaps). */
+    fillOpacity?: number;
+    /** Band-edge color. Defaults to palette `refLine`. */
+    borderColor?: string;
+    /** Band-edge opacity. Default `1`. */
+    borderOpacity?: number;
+    /**
+     * Band-edge width in pixels. `0` hides the border. Default `2` (`1` for
+     * unknown gaps).
+     */
+    borderWidth?: number;
+    /** Band-edge dash pattern. Default `[4, 4]`. */
+    intervals?: [number, number];
+}
+/** Label styling for a chart-gap time band. Text comes from {@link CandleGap.label}. */
+export interface CandleGapLabelStyle {
+    /** Label color. Defaults to palette `refLabel`. */
+    color?: string;
+    /** Label position inside the band. Default `"left"`. */
+    position?: "left" | "right";
+}
+/** Per-kind presentation overrides for {@link CandleGapsConfig}. */
+export interface CandleGapStyle {
+    /**
+     * Previous-close marks. `false` disables them; an object enables and styles
+     * them. Omission preserves the semantic default for the gap kind.
+     */
+    bridge?: false | CandleGapBridgeStyle;
+    /**
+     * Full-height time band. `false` disables it; an object enables and styles it.
+     * Omission preserves the semantic default for the gap kind.
+     */
+    band?: false | CandleGapBandStyle;
+    /**
+     * Band label. `false` hides it; an object enables and styles it. Omission
+     * preserves the semantic default for the gap kind.
+     */
+    label?: false | CandleGapLabelStyle;
+}
+/**
+ * Data and optional per-kind styling for explicit chart gaps. Gap metadata is
+ * low-frequency React data (like `referenceLines`); live market data remains in
+ * its SharedValue.
+ */
+export interface CandleGapsConfig {
+    /** Sorted, non-overlapping gap ranges. Invalid ranges are ignored. */
+    gaps: CandleGap[];
+    /** Presentation overrides keyed by semantic gap kind. */
+    styles?: Partial<Record<CandleGapKind, CandleGapStyle>>;
+}
+/** Semantic reason for a chart interval with no observed market sample. */
+export type ChartGapKind = CandleGapKind;
+/** Shared gap metadata used by both line and candlestick charts. */
+export type ChartGap = CandleGap;
+/** Previous-value bridge styling shared by line and candlestick gaps. */
+export type ChartGapBridgeStyle = CandleGapBridgeStyle;
+/** Full-height time-band styling shared by line and candlestick gaps. */
+export type ChartGapBandStyle = CandleGapBandStyle;
+/** Time-band label styling shared by line and candlestick gaps. */
+export type ChartGapLabelStyle = CandleGapLabelStyle;
+/** Per-kind gap presentation shared by line and candlestick charts. */
+export type ChartGapStyle = CandleGapStyle;
+/** Gap data and per-kind styles shared by line and candlestick charts. */
+export type ChartGapsConfig = CandleGapsConfig;
 /**
  * Spatial sizing & motion tokens — the geometry/timing analogue of
  * {@link LiveChartPalette}. Where `palette` controls *color*, `metrics` controls
@@ -2100,7 +2249,7 @@ export interface LiveChartCoreProps {
      * `render`). Default off.
      */
     bottomLabel?: boolean | AxisLabelConfig;
-    /** Reference lines / bands drawn into the chart. Supports all three `ReferenceLine` forms. */
+    /** Reference lines / bands drawn into the chart. Supports all four `ReferenceLine` forms. */
     referenceLines?: ReferenceLine[];
     /** Per-instance grid-line styling. Pass an object to override color / width / dash / opacity. */
     gridStyle?: GridStyleConfig;
@@ -2315,10 +2464,19 @@ export interface LiveChartProps extends LiveChartCoreProps {
     segments?: ChartSegment[];
     /**
      * Color the line above vs. below a live threshold value (break-even / average
-     * cost, VWAP, previous close, a peg). Always a `SharedValue` so the split tracks
-     * live on the UI thread. See {@link ThresholdConfig}.
+     * cost, VWAP, previous close, a peg). Supports a live scalar or a static/live
+     * time-varying series. See {@link ThresholdConfig}.
      */
     threshold?: ThresholdConfig;
+    /**
+     * Render the threshold line's badge as a custom **React Native** element
+     * instead of the built-in Skia pill. The chart measures and pins the element
+     * to the threshold's live Y position and configured `labelPosition` on the UI
+     * thread (see {@link ThresholdBadgeRenderProps}); the dashed marker line stays
+     * built in. Requires `threshold.line`. Return `null`/`undefined` to keep the
+     * built-in badge. Single-series line mode only.
+     */
+    renderThresholdBadge?: (ctx: ThresholdBadgeRenderProps) => ReactElement | null | undefined;
     /** Render the live value as a large text overlay in the top-left. Default `false`. */
     showValue?: boolean;
     /** Tint the `showValue` text by momentum (green up / red down). Default `false`. */
@@ -2331,6 +2489,22 @@ export interface LiveChartProps extends LiveChartCoreProps {
     candleWidth?: number;
     /** In-progress candle updated each tick. Must be a SharedValue for UI-thread reads. */
     liveCandle?: SharedValue<CandlePoint | null>;
+    /**
+     * Explicit candle-chart gaps. Pass a sorted array for semantic defaults, or a
+     * {@link CandleGapsConfig} to override per-kind styling. Missing timestamps
+     * are never inferred: `"no-trades"` draws neutral previous-close marks,
+     * `"unavailable"` adds a labeled time band, and `"unknown"` leaves price
+     * unfilled. Candle mode only. Default off.
+     */
+    candleGaps?: CandleGap[] | CandleGapsConfig;
+    /**
+     * Explicit line-chart gaps. Pass a sorted array for semantic defaults, or a
+     * {@link ChartGapsConfig} to override per-kind styling. The normal line and
+     * every area fill stop at the interval boundaries; bridge-enabled kinds draw
+     * a flat previous-value segment. Real samples inside a range take precedence
+     * over its metadata. Line mode only. Default off.
+     */
+    lineGaps?: ChartGap[] | ChartGapsConfig;
     /**
      * Live trade fills for optional on-chart markers. Read on the UI thread only —
      * pass a `SharedValue` and update from JS via `.value` (same pattern as `data` / `value`).