react-native-livechart 3.12.0 → 4.0.0

package/dist/math/referenceDrag.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Pure, worklet-safe helpers for dragging a Form-A reference line along the
+ * Y-axis. Kept free of hooks / SharedValues so they unit-test without Reanimated
+ * (the gesture wiring lives in {@link useReferenceDrag}).
+ */
+/** Clamp a value to an optional `[min, max]` bound (order-independent). No-op when
+ *  `bounds` is omitted. */
+export declare function clampToBounds(value: number, bounds?: [number, number]): number;
+/**
+ * Index of the draggable line whose handle-Y is nearest the touch `y`, within
+ * `slop` px — or `-1` when none is in reach. `handleYs` is index-aligned with the
+ * chart's `referenceLines`; entries `< 0` (not draggable / off-screen / not laid
+ * out) are skipped. Ties favor the later (topmost-drawn) line.
+ */
+export declare function nearestDraggableIndex(handleYs: number[], y: number, slop: number): number;
+/**
+ * Whether a line's value sits **outside** its watched interval — the trigger for
+ * `onDragOut` / `onDragIn` (edge-detected by the caller). When `bounds` is set the
+ * watched interval is `bounds` (at-or-past a bound counts as out, since the drag
+ * clamps there); otherwise it's the visible `[min, max]` Y-range (out = scrolled /
+ * dragged off-screen).
+ */
+export declare function referenceValueOut(value: number, min: number, max: number, bounds?: [number, number]): boolean;
+//# sourceMappingURL=referenceDrag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referenceDrag.d.ts","sourceRoot":"","sources":["../../src/math/referenceDrag.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;2BAC2B;AAC3B,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,MAAM,CAMR;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,CAAC,EAAE,MAAM,EACT,IAAI,EAAE,MAAM,GACX,MAAM,CAcR;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACxB,OAAO,CAQT"}

package/dist/math/referenceGroup.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Pure, worklet-safe clustering for reference-line grouping — collapse Form-A
+ * lines whose value-Y positions sit near each other into one count handle. Free of
+ * hooks / SharedValues so it unit-tests without Reanimated; the per-frame call +
+ * rendering live in the controller / `ReferenceLineGroupOverlay`.
+ */
+/** One collapsed cluster of nearby reference lines. */
+export interface ReferenceGroup {
+    /** Centroid Y (canvas px) of the cluster — where the count handle is drawn. */
+    cy: number;
+    /** Number of lines collapsed into the cluster (≥ 2). */
+    count: number;
+}
+/** Result of clustering a frame's reference-line Y positions. */
+export interface ReferenceGrouping {
+    /**
+     * Index-aligned with the input Ys: `true` when this line's individual tag is
+     * collapsed into a cluster (a multi-line group) and should be suppressed.
+     */
+    hidden: boolean[];
+    /** One entry per multi-line cluster (singletons render normally, never here). */
+    groups: ReferenceGroup[];
+}
+/**
+ * Single-linkage cluster of reference-line handle Ys: lines whose sorted Y gaps are
+ * all `<= radius` chain into one group. Entries `< 0` (not a Form-A line / off the
+ * canvas) are ignored. Returns which lines are collapsed (`hidden`) plus a centroid
+ * + count per multi-line cluster. A non-positive `radius` disables grouping.
+ */
+export declare function groupReferenceLines(ys: number[], radius: number): ReferenceGrouping;
+//# sourceMappingURL=referenceGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"referenceGroup.d.ts","sourceRoot":"","sources":["../../src/math/referenceGroup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,wDAAwD;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,iFAAiF;IACjF,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,MAAM,EAAE,EACZ,MAAM,EAAE,MAAM,GACb,iBAAiB,CA6BnB"}

package/dist/math/referenceLines.d.ts

@@ -1,4 +1,4 @@
-import type { ReferenceLine } from "../types";
+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";
 /**
@@ -12,23 +12,49 @@ export declare function referenceLineForm(rl: ReferenceLine): ReferenceLineForm;
  * time bands (Form C) which constrain time, not value.
  */
 export declare function collectReferenceValues(lines: ReferenceLine[]): number[];
-/** Fully-resolved badge presentation for a Form-A reference line. */
-export interface ResolvedReferenceBadge {
-    position: "left" | "right";
+/**
+ * Fully-resolved badge **style/shape** + anchor — the resolved counterpart of
+ * {@link BadgeStyleConfig} (`position` / `icon` / `showText` plus the style knobs).
+ * Shared by the reference-line badge ({@link ResolvedReferenceBadge}) and the
+ * grouping count pill ({@link ResolvedReferenceGroupBadge}). Unset colors stay
+ * `undefined` so the overlay applies the appropriate theme default at render time.
+ */
+export interface ResolvedReferenceBadgeStyle {
+    position: "left" | "center" | "right";
     /** Leading glyph, or "" for none. */
     icon: string;
-    /** Whether the text label is shown. */
+    /** Whether the text label is shown (false → icon-only). */
     showText: boolean;
-    /** undefined → theme tooltipBg at render time. */
     background: string | undefined;
-    /** undefined → the line color at render time. */
     borderColor: string | undefined;
+    /** Border stroke width in px. Default `1`. */
+    borderWidth: number;
     radius: number;
+    textColor: string | undefined;
+    /** Per-badge font knobs; undefined → the chart font. */
+    fontSize: number | undefined;
+    fontFamily: string | undefined;
+    fontWeight: FontWeight | undefined;
+    /** Nudge the whole badge from its anchor, in px. Default `0`. */
+    offsetX: number;
+    offsetY: number;
+}
+/** Fully-resolved presentation for a Form-A reference-line badge — the shared
+ *  style/shape plus the in-range / legacy-text flags. */
+export interface ResolvedReferenceBadge extends ResolvedReferenceBadgeStyle {
     /** Show the pill at the value when in range (`badge`) vs only off-screen (legacy `offAxisBadge`). */
     inRange: boolean;
     /** Legacy `"word: value"` text format (off-axis badge) vs the `label`/value format. */
     legacyText: boolean;
 }
+/** Fully-resolved styling for the grouping **count pill** — exactly the shared
+ *  badge style/shape (no in-range / legacy concepts). */
+export type ResolvedReferenceGroupBadge = ResolvedReferenceBadgeStyle;
+/**
+ * Resolves the grouping count-pill styling from a {@link ReferenceLineBadgeConfig}
+ * (the same shape a per-line badge uses). Pure — driven only by the config.
+ */
+export declare function resolveReferenceGroupBadge(badge?: ReferenceLineBadgeConfig): ResolvedReferenceGroupBadge;
 /**
  * Resolves a Form-A reference line's badge presentation from the new `badge`
  * config or the legacy `offAxisBadge` flag (the `badge` config wins). Returns

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,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,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,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iDAAiD;IACjD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,OAAO,EAAE,OAAO,CAAC;IACjB,uFAAuF;IACvF,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,aAAa,GAChB,sBAAsB,GAAG,IAAI,CA4B/B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,IAAI,GAAG,OAAO,GAAG,OAAO,CAK1B"}
+{"version":3,"file":"referenceLines.d.ts","sourceRoot":"","sources":["../../src/math/referenceLines.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,wBAAwB,EACzB,MAAM,UAAU,CAAC;AAElB,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAE7E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,aAAa,GAAG,iBAAiB,CAQtE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE,CAgBvE;AAED;;;;;;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"}