@ledgerhq/lumen-ui-react-visualization 0.1.10 → 0.1.12

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/DefaultScrubberTooltip.js

@@ -0,0 +1,85 @@
+import { jsxs as R, jsx as f } from "react/jsx-runtime";
+import { ChartTooltipItem as _ } from "./ChartTooltipItem.js";
+import { TOOLTIP_TRANSITION as D, BORDER_RADIUS as x, PADDING_Y as O, ROW_HEIGHT as u, PADDING_X as E, ROW_GAP as g, DEFAULT_OFFSET as L, DEFAULT_TOOLTIP_MIN_WIDTH as S } from "./constants.js";
+import { useTooltipMeasurement as W, computeTooltipWidth as F, computeTooltipHeight as H, computeTooltipX as N, computeItemsBaseY as P } from "./utils.js";
+import { cssVar as o } from "../../../../libs/design-core/dist/lib/cssVar/cssVar.js";
+const A = {
+  fontSize: o("var(--font-style-body-4-size)"),
+  fontFamily: o("var(--font-family-font)"),
+  fill: o("var(--text-base)"),
+  fontWeight: o("var(--font-style-body-4-weight-medium)")
+};
+function $({
+  pixelX: T,
+  drawingArea: e,
+  title: l,
+  items: i,
+  offset: m = L,
+  minWidth: h = S
+}) {
+  const t = l != null, { widths: c, titleRef: d, labelRefs: y, valueRefs: I } = W(
+    i,
+    t,
+    l
+  );
+  if (i.length === 0)
+    return null;
+  const a = F(c, t, h), s = N(T, m, a, e), v = H(i.length, t), b = P(e.y, t);
+  return /* @__PURE__ */ R(
+    "g",
+    {
+      "data-testid": "chart-tooltip",
+      role: "tooltip",
+      style: {
+        opacity: c === null ? 0 : 1,
+        transition: D,
+        pointerEvents: "none"
+      },
+      children: [
+        /* @__PURE__ */ f(
+          "rect",
+          {
+            x: s,
+            y: e.y,
+            width: a,
+            height: v,
+            rx: x,
+            fill: o("var(--background-muted)")
+          }
+        ),
+        t && /* @__PURE__ */ f(
+          "text",
+          {
+            ref: d,
+            "data-testid": "chart-tooltip-title",
+            x: s + E,
+            y: e.y + O + u / 2,
+            dominantBaseline: "middle",
+            style: A,
+            children: l
+          }
+        ),
+        i.map((n, r) => /* @__PURE__ */ f(
+          _,
+          {
+            label: n.label,
+            value: n.value,
+            x: s,
+            y: b + r * (u + g) + u / 2,
+            width: a,
+            labelRef: (p) => {
+              y.current[r] = p;
+            },
+            valueRef: (p) => {
+              I.current[r] = p;
+            }
+          },
+          `${n.label}-${n.value}-${r}`
+        ))
+      ]
+    }
+  );
+}
+export {
+  $ as DefaultScrubberTooltip
+};

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/constants.d.ts

@@ -0,0 +1,11 @@
+export declare const DEFAULT_OFFSET = 10;
+export declare const PADDING_X = 8;
+export declare const PADDING_Y = 8;
+export declare const ROW_HEIGHT = 16;
+export declare const ROW_GAP = 6;
+export declare const TITLE_GAP = 6;
+export declare const BORDER_RADIUS = 4;
+export declare const TOOLTIP_TRANSITION = "opacity 0.15s ease-out 0.05s";
+export declare const LABEL_VALUE_GAP = 12;
+export declare const DEFAULT_TOOLTIP_MIN_WIDTH = 80;
+//# sourceMappingURL=constants.d.ts.map

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Scrubber/DefaultScrubberTooltip/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,kBAAkB,iCAAiC,CAAC;AACjE,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,yBAAyB,KAAK,CAAC"}

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/constants.js

@@ -0,0 +1,13 @@
+const o = 10, s = 8, t = 8, T = 16, _ = 6, c = 6, A = 4, I = "opacity 0.15s ease-out 0.05s", n = 12, D = 80;
+export {
+  A as BORDER_RADIUS,
+  o as DEFAULT_OFFSET,
+  D as DEFAULT_TOOLTIP_MIN_WIDTH,
+  n as LABEL_VALUE_GAP,
+  s as PADDING_X,
+  t as PADDING_Y,
+  _ as ROW_GAP,
+  T as ROW_HEIGHT,
+  c as TITLE_GAP,
+  I as TOOLTIP_TRANSITION
+};

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/index.d.ts

@@ -0,0 +1,3 @@
+export { ChartTooltipItem } from './ChartTooltipItem';
+export { DefaultScrubberTooltip } from './DefaultScrubberTooltip';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Scrubber/DefaultScrubberTooltip/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/utils.d.ts

@@ -0,0 +1,43 @@
+import { RefObject } from 'react';
+import { DrawingArea } from '../../../utils/types';
+import { ChartTooltipItemData, SvgTextContent } from '../types';
+type Widths = {
+    title: number;
+    labels: number[];
+    values: number[];
+};
+type UseTooltipMeasurementReturn = {
+    widths: Widths | null;
+    titleRef: RefObject<SVGTextElement | null>;
+    labelRefs: RefObject<(SVGTextElement | null)[]>;
+    valueRefs: RefObject<(SVGTextElement | null)[]>;
+};
+export declare const safeGetBBoxWidth: (el: SVGGraphicsElement | null) => number;
+/**
+ * Derive the auto-fit tooltip width from measured text widths,
+ * clamped to a minimum floor.
+ */
+export declare const computeTooltipWidth: (widths: Widths | null, hasTitle: boolean, minWidth: number) => number;
+/**
+ * Compute the tooltip's horizontal position, flipping to the left
+ * of the scrubber line when it would overflow the drawing area.
+ */
+export declare const computeTooltipX: (pixelX: number, offset: number, tooltipWidth: number, drawingArea: DrawingArea) => number;
+/**
+ * Compute the total tooltip height from item count and title presence.
+ */
+export declare const computeTooltipHeight: (itemCount: number, hasTitle: boolean) => number;
+/**
+ * Vertical offset where tooltip rows begin, accounting for title presence.
+ */
+export declare const computeItemsBaseY: (drawingAreaY: number, hasTitle: boolean) => number;
+/**
+ * Manages SVG text measurement for the tooltip via `getBBox`.
+ *
+ * A single `ResizeObserver` is created on mount and reused for the
+ * component's entire lifetime, avoiding the cost of tearing down and
+ * recreating an observer on every scrubber movement.
+ */
+export declare function useTooltipMeasurement(items: ChartTooltipItemData[], hasTitle: boolean, title: SvgTextContent | null | undefined): UseTooltipMeasurementReturn;
+export {};
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Scrubber/DefaultScrubberTooltip/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAUrE,KAAK,MAAM,GAAG;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,KAAK,2BAA2B,GAAG;IACjC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,SAAS,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,SAAS,EAAE,SAAS,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;CACjD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,IAAI,kBAAkB,GAAG,IAAI,KAAG,MAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,GAAG,IAAI,EACrB,UAAU,OAAO,EACjB,UAAU,MAAM,KACf,MAUF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,MAAM,EACd,QAAQ,MAAM,EACd,cAAc,MAAM,EACpB,aAAa,WAAW,KACvB,MAOF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC/B,WAAW,MAAM,EACjB,UAAU,OAAO,KAChB,MAQF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC5B,cAAc,MAAM,EACpB,UAAU,OAAO,KAChB,MAGF,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,oBAAoB,EAAE,EAC7B,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,GACvC,2BAA2B,CAkD7B"}

package/dist/lib/Components/Scrubber/DefaultScrubberTooltip/utils.js

@@ -0,0 +1,59 @@
+import { useRef as i, useState as W, useEffect as _, useLayoutEffect as g } from "react";
+import { LABEL_VALUE_GAP as E, PADDING_Y as d, ROW_HEIGHT as p, ROW_GAP as x, PADDING_X as G, TITLE_GAP as b } from "./constants.js";
+const m = (t) => {
+  if (!t || typeof t.getBBox != "function") return 0;
+  try {
+    return t.getBBox().width;
+  } catch {
+    return 0;
+  }
+}, A = (t, e, r) => {
+  const n = t && e ? t.title : 0, c = t ? t.labels.map(
+    (a, f) => a + E + (t.values[f] ?? 0)
+  ) : [], l = Math.max(n, ...c) + G * 2;
+  return Math.max(l, r);
+}, H = (t, e, r, n) => {
+  const c = t + e + r > n.x + n.width;
+  return Math.max(
+    n.x,
+    c ? t - e - r : t + e
+  );
+}, I = (t, e) => {
+  const r = e ? p + b : 0;
+  return d * 2 + r + t * p + (t - 1) * x;
+}, P = (t, e) => {
+  const r = e ? p + b : 0;
+  return t + d + r;
+};
+function y(t, e, r) {
+  const n = i(null), c = i([]), s = i([]), l = i(null), a = i(() => {
+  }), [f, v] = W(null);
+  return a.current = () => {
+    const o = e ? m(n.current) : 0, u = t.map(
+      (R, h) => m(c.current[h])
+    ), B = t.map(
+      (R, h) => m(s.current[h])
+    );
+    v({
+      title: o,
+      labels: u,
+      values: B
+    });
+  }, _(() => {
+    if (!(typeof ResizeObserver > "u"))
+      return l.current = new ResizeObserver(() => a.current()), () => l.current?.disconnect();
+  }, []), g(() => {
+    if (t.length === 0) return;
+    c.current.length = t.length, s.current.length = t.length, a.current();
+    const o = l.current;
+    o && (o.disconnect(), n.current && o.observe(n.current), c.current.forEach((u) => u && o.observe(u)), s.current.forEach((u) => u && o.observe(u)));
+  }, [t, r, e]), { widths: f, titleRef: n, labelRefs: c, valueRefs: s };
+}
+export {
+  P as computeItemsBaseY,
+  I as computeTooltipHeight,
+  A as computeTooltipWidth,
+  H as computeTooltipX,
+  m as safeGetBBoxWidth,
+  y as useTooltipMeasurement
+};

package/dist/lib/Components/Scrubber/Scrubber.d.ts

@@ -1,7 +1,8 @@
 import { ScrubberProps } from './types';
 /**
  * Renders the scrubber visuals: vertical reference line, future-data overlay
- * rect, per-series beacon dots, and an optional formatted label above the line.
+ * rect, per-series beacon dots, optional label above the line, and an optional
+ * tooltip when {@link ScrubberProps.tooltip} is set, using {@link DefaultScrubberTooltip}.
  *
  * Must be used as a child of `LineChart` (or `CartesianChart`) with
  * `enableScrubbing` enabled. Renders nothing when no scrubber position is active.
@@ -12,6 +13,17 @@ import { ScrubberProps } from './types';
  *   <Scrubber label={(i) => data[i].date} />
  * </LineChart>
  * ```
+ *
+ * @example Tooltip
+ * ```tsx
+ * <Scrubber
+ *   tooltip={(i) => ({
+ *     title: `${counts[i]} Transactions`,
+ *     items: [{ label: 'Index', value: String(i) }],
+ *     minWidth: 160,
+ *   })}
+ * />
+ * ```
  */
-export declare function Scrubber({ label, hideLine, hideOverlay, showBeacons, }: Readonly<ScrubberProps>): import("react/jsx-runtime").JSX.Element | null;
+export declare function Scrubber({ label, hideLine, hideOverlay, showBeacons, tooltip, }: Readonly<ScrubberProps>): import("react/jsx-runtime").JSX.Element | null;
 //# sourceMappingURL=Scrubber.d.ts.map

package/dist/lib/Components/Scrubber/Scrubber.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Scrubber.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/Scrubber.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa7C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAgB,EAChB,WAAmB,EACnB,WAAmB,GACpB,EAAE,QAAQ,CAAC,aAAa,CAAC,kDA0IzB"}
+{"version":3,"file":"Scrubber.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/Scrubber.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAa7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAgB,EAChB,WAAmB,EACnB,WAAmB,EACnB,OAAO,GACR,EAAE,QAAQ,CAAC,aAAa,CAAC,kDA2KzB"}

package/dist/lib/Components/Scrubber/Scrubber.js

@@ -1,134 +1,160 @@
-import { jsxs as l, jsx as i, Fragment as F } from "react/jsx-runtime";
-import { useId as N, useMemo as c } from "react";
-import { resolvePixelX as R, resolvePixelY as W, LINE_GRADIENT_EDGE_OPACITY as g, OVERLAY_OPACITY as X, LABEL_OFFSET_Y as D, BEACON_STROKE_WIDTH as P, BEACON_RADIUS as G, OVERLAY_OFFSET as f, OVERLAY_LINE_INSET as E } from "./utils.js";
-import { useScrubberContext as V } from "./context/scrubberContext.js";
-import { useCartesianChartContext as H } from "../CartesianChart/context/cartesianChartContext.js";
-import { cssVar as t } from "../../../libs/design-core/dist/lib/cssVar/cssVar.js";
-function K({
-  label: a,
-  hideLine: A = !1,
-  hideOverlay: C = !1,
-  showBeacons: d = !1
+import { jsxs as v, jsx as o, Fragment as F } from "react/jsx-runtime";
+import { useId as N, useMemo as d } from "react";
+import { resolvePixelX as P, resolvePixelY as R, LINE_GRADIENT_EDGE_OPACITY as O, OVERLAY_OPACITY as X, LABEL_OFFSET_Y as G, BEACON_STROKE_WIDTH as V, BEACON_RADIUS as H, OVERLAY_OFFSET as m, OVERLAY_LINE_INSET as S } from "./utils.js";
+import { useScrubberContext as M } from "./context/scrubberContext.js";
+import { useCartesianChartContext as U } from "../CartesianChart/context/cartesianChartContext.js";
+import { DefaultScrubberTooltip as j } from "./DefaultScrubberTooltip/DefaultScrubberTooltip.js";
+import { cssVar as r } from "../../../libs/design-core/dist/lib/cssVar/cssVar.js";
+function Z({
+  label: n,
+  hideLine: Y = !1,
+  hideOverlay: _ = !1,
+  showBeacons: l = !1,
+  tooltip: f
 }) {
-  const u = N(), { scrubberPosition: e } = V(), {
-    getXScale: b,
-    getXAxisConfig: v,
-    getYScale: p,
-    drawingArea: O,
-    series: x,
-    seriesMap: y
-  } = H(), o = c(() => {
+  const b = N(), { scrubberPosition: e } = M(), {
+    getXScale: p,
+    getXAxisConfig: h,
+    getYScale: y,
+    drawingArea: x,
+    series: g,
+    seriesMap: E
+  } = U(), i = d(() => {
     if (e !== void 0)
-      return R(e, b, v());
-  }, [e, b, v]), Y = c(() => e === void 0 || !d ? [] : x.map((r) => {
-    const w = y.get(r.id)?.data, h = W(e, w, p);
-    return h === void 0 ? null : { id: r.id, stroke: r.stroke, pixelY: h };
+      return P(e, p, h());
+  }, [e, p, h]), I = d(() => e === void 0 || !l ? [] : g.map((t) => {
+    const u = E.get(t.id)?.data, C = R(e, u, y);
+    return C === void 0 ? null : { id: t.id, stroke: t.stroke, pixelY: C };
   }).filter(
-    (r) => r !== null
-  ), [e, d, x, y, p]), m = c(() => {
-    if (!(e === void 0 || !a))
-      return a(e);
-  }, [e, a]);
-  if (e === void 0 || o === void 0)
+    (t) => t !== null
+  ), [e, l, g, E, y]), A = d(() => {
+    if (!(e === void 0 || !n))
+      return n(e);
+  }, [e, n]), a = d(() => {
+    if (e === void 0 || !f)
+      return;
+    const t = f(e);
+    if (t.items.length === 0) return;
+    const u = typeof t.title == "function" ? t.title(e) : t.title;
+    return {
+      items: t.items,
+      resolvedTitle: u,
+      offset: t.offset,
+      minWidth: t.minWidth
+    };
+  }, [e, f]);
+  if (e === void 0 || i === void 0)
     return null;
   const {
-    x: _,
+    x: T,
     y: s,
-    width: S,
-    height: n
-  } = O, k = o + E, I = s - f, L = Math.max(
+    width: k,
+    height: c
+  } = x, W = i + S, L = s - m, w = Math.max(
     0,
-    _ + S - o - E + f
-  ), T = n + f * 2;
-  return /* @__PURE__ */ l("g", { "data-testid": "scrubber", children: [
-    !A && /* @__PURE__ */ l(F, { children: [
-      /* @__PURE__ */ i("defs", { children: /* @__PURE__ */ l(
+    T + k - i - S + m
+  ), D = c + m * 2;
+  return /* @__PURE__ */ v("g", { "data-testid": "scrubber", children: [
+    !Y && /* @__PURE__ */ v(F, { children: [
+      /* @__PURE__ */ o("defs", { children: /* @__PURE__ */ v(
         "linearGradient",
         {
-          id: u,
+          id: b,
           gradientUnits: "userSpaceOnUse",
-          x1: o,
+          x1: i,
           y1: s,
-          x2: o,
-          y2: s + n,
+          x2: i,
+          y2: s + c,
           children: [
-            /* @__PURE__ */ i(
+            /* @__PURE__ */ o(
               "stop",
               {
                 offset: "0%",
-                stopColor: t("var(--border-base)"),
-                stopOpacity: g
+                stopColor: r("var(--border-base)"),
+                stopOpacity: O
               }
             ),
-            /* @__PURE__ */ i("stop", { offset: "20%", stopColor: t("var(--border-base)") }),
-            /* @__PURE__ */ i("stop", { offset: "80%", stopColor: t("var(--border-base)") }),
-            /* @__PURE__ */ i(
+            /* @__PURE__ */ o("stop", { offset: "20%", stopColor: r("var(--border-base)") }),
+            /* @__PURE__ */ o("stop", { offset: "80%", stopColor: r("var(--border-base)") }),
+            /* @__PURE__ */ o(
               "stop",
               {
                 offset: "100%",
-                stopColor: t("var(--border-base)"),
-                stopOpacity: g
+                stopColor: r("var(--border-base)"),
+                stopOpacity: O
               }
             )
           ]
         }
       ) }),
-      /* @__PURE__ */ i(
+      /* @__PURE__ */ o(
         "line",
         {
           "data-testid": "scrubber-line",
-          x1: o,
+          x1: i,
           y1: s,
-          x2: o,
-          y2: s + n,
-          stroke: `url(#${u})`,
-          strokeWidth: t("var(--stroke-1)")
+          x2: i,
+          y2: s + c,
+          stroke: `url(#${b})`,
+          strokeWidth: r("var(--stroke-1)")
         }
       )
     ] }),
-    !C && /* @__PURE__ */ i(
+    !_ && /* @__PURE__ */ o(
       "rect",
       {
         "data-testid": "scrubber-overlay",
-        x: k,
-        y: I,
-        width: L,
-        height: T,
-        fill: t("var(--background-base)"),
+        x: W,
+        y: L,
+        width: w,
+        height: D,
+        fill: r("var(--background-base)"),
         opacity: X
       }
     ),
-    m !== void 0 && /* @__PURE__ */ i(
+    A !== void 0 && /* @__PURE__ */ o(
       "text",
       {
         "data-testid": "scrubber-label",
-        x: o,
-        y: s - D,
+        x: i,
+        y: s - G,
         textAnchor: "middle",
         style: {
-          fill: t("var(--text-base)"),
-          fontSize: t("var(--font-style-body-4-size)"),
-          fontWeight: t("var(--font-style-body-4-weight-medium)"),
-          fontFamily: t("var(--font-family-font)")
+          fill: r("var(--text-base)"),
+          fontSize: r("var(--font-style-body-4-size)"),
+          fontWeight: r("var(--font-style-body-4-weight-medium)"),
+          fontFamily: r("var(--font-family-font)")
         },
-        children: m
+        children: A
       }
     ),
-    d && Y.map((r) => /* @__PURE__ */ i(
+    l && I.map((t) => /* @__PURE__ */ o(
       "circle",
       {
-        "data-testid": `scrubber-beacon-${r.id}`,
-        cx: o,
-        cy: r.pixelY,
-        r: G,
-        fill: r.stroke,
-        stroke: t("var(--background-canvas)"),
-        strokeWidth: P
+        "data-testid": `scrubber-beacon-${t.id}`,
+        cx: i,
+        cy: t.pixelY,
+        r: H,
+        fill: t.stroke,
+        stroke: r("var(--background-canvas)"),
+        strokeWidth: V
       },
-      r.id
-    ))
+      t.id
+    )),
+    a !== void 0 && /* @__PURE__ */ o(
+      j,
+      {
+        pixelX: i,
+        drawingArea: x,
+        dataIndex: e,
+        title: a.resolvedTitle,
+        items: a.items,
+        offset: a.offset,
+        minWidth: a.minWidth
+      }
+    )
   ] });
 }
 export {
-  K as Scrubber
+  Z as Scrubber
 };

package/dist/lib/Components/Scrubber/index.d.ts

@@ -1,4 +1,5 @@
 export { Scrubber } from './Scrubber';
 export { useScrubberContext } from './context';
-export type { ScrubberProps, ScrubberContextValue } from './types';
+export { ChartTooltipItem, DefaultScrubberTooltip, } from './DefaultScrubberTooltip';
+export type { ChartTooltipItemData, ChartTooltipItemProps, ScrubberContextValue, ScrubberProps, ScrubberTooltipContent, ScrubberTooltipProps, SvgTextContent, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/lib/Components/Scrubber/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,cAAc,GACf,MAAM,SAAS,CAAC"}

package/dist/lib/Components/Scrubber/types.d.ts

@@ -1,4 +1,5 @@
-import { ReactNode, RefObject } from 'react';
+import { ReactElement, ReactNode, Ref, RefObject, SVGProps } from 'react';
+import { DrawingArea } from '../../utils/types';
 export type ScrubberContextValue = {
     /**
      * Whether scrubbing interactions are enabled.
@@ -28,6 +29,97 @@ export type ScrubberProviderProps = {
      */
     onScrubberPositionChange?: (index: number | undefined) => void;
 };
+/**
+ * Valid content for an SVG `<text>` element: a plain string,
+ * a number, or a `<tspan>` element.
+ */
+export type SvgTextContent = string | number | ReactElement<SVGProps<SVGTSpanElement>, 'tspan'>;
+export type ChartTooltipItemData = {
+    /** Label displayed on the left side of the row. */
+    label: SvgTextContent;
+    /** Value displayed on the right side of the row. */
+    value: SvgTextContent;
+};
+export type ChartTooltipItemProps = ChartTooltipItemData & {
+    /**
+     * X position in SVG coordinate space.
+     * @default 0
+     */
+    x?: number;
+    /**
+     * Y midline position in SVG coordinate space.
+     * @default 0
+     */
+    y?: number;
+    /**
+     * Width allocated to this row, used to right-align the value text.
+     */
+    width: number;
+    /**
+     * Optional ref forwarded to the label `<text>` element. Useful to measure
+     * the label's natural width via `getBBox` for auto-fit layouts.
+     */
+    labelRef?: Ref<SVGTextElement>;
+    /**
+     * Optional ref forwarded to the value `<text>` element. Useful to measure
+     * the value's natural width via `getBBox` for auto-fit layouts.
+     */
+    valueRef?: Ref<SVGTextElement>;
+};
+export type ScrubberTooltipLayoutProps = {
+    /**
+     * Horizontal gap in pixels between the scrubber line and the tooltip box.
+     * @default 10
+     */
+    offset?: number;
+    /**
+     * Minimum width in pixels. The tooltip auto-fits to the rendered content
+     * but never collapses below this floor; raise it to avoid jitter when
+     * value length changes between indices.
+     * @default 80
+     */
+    minWidth?: number;
+};
+export type ScrubberTooltipProps = ScrubberTooltipLayoutProps & {
+    /**
+     * Horizontal pixel position of the scrubber line within the SVG coordinate
+     * space. Used to place the tooltip left or right of the line.
+     */
+    pixelX: number;
+    /**
+     * Bounding box of the chart's drawing area (x, y, width, height). Used to
+     * constrain the tooltip so it never overflows the chart boundaries.
+     */
+    drawingArea: DrawingArea;
+    /**
+     * Zero-based index of the data point currently under the scrubber. Maps
+     * directly to the series data arrays so consumers can look up values.
+     */
+    dataIndex: number;
+    /**
+     * Optional title displayed at the top of the tooltip. Pass `null` or omit
+     * to render the tooltip without a title row.
+     */
+    title?: SvgTextContent | null;
+    /**
+     * List of label/value pairs rendered as rows inside the tooltip body.
+     */
+    items: ChartTooltipItemData[];
+};
+/**
+ * Return value of the `tooltip` callback on {@link ScrubberProps}.
+ */
+export type ScrubberTooltipContent = ScrubberTooltipLayoutProps & {
+    /**
+     * Optional header. Static value or callback per data index.
+     * A callback may return `null` or `undefined` to suppress the title.
+     */
+    title?: SvgTextContent | ((index: number) => SvgTextContent | null | undefined);
+    /**
+     * Tooltip rows for this index. Return an empty array to hide the tooltip.
+     */
+    items: ChartTooltipItemData[];
+};
 export type ScrubberProps = {
     /**
      * Formats a label string shown above the reference line for a given data index.
@@ -49,5 +141,11 @@ export type ScrubberProps = {
      * @default false
      */
     showBeacons?: boolean;
+    /**
+     * Produces tooltip content for the active data index. When set, {@link DefaultScrubberTooltip}
+     * is rendered. Optional `offset` and `minWidth` on the returned object tune layout.
+     * Return `{ items: [] }` to hide the tooltip at an index.
+     */
+    tooltip?: (dataIndex: number) => ScrubberTooltipContent;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/lib/Components/Scrubber/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,wBAAwB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACxC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC;;OAEG;IACH,wBAAwB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACxC;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,MAAM,GACN,YAAY,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC,CAAC;AAErD,MAAM,MAAM,oBAAoB,GAAG;IACjC,mDAAmD;IACnD,KAAK,EAAE,cAAc,CAAC;IACtB,oDAAoD;IACpD,KAAK,EAAE,cAAc,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,oBAAoB,GAAG;IACzD;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG;IAC9D;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC;IACzB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B;;OAEG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG;IAChE;;;OAGG;IACH,KAAK,CAAC,EACF,cAAc,GACd,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;IAC3D;;OAEG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,sBAAsB,CAAC;CACzD,CAAC"}

package/dist/lib/Components/index.d.ts

@@ -1,4 +1,5 @@
 export * from './LineChart';
 export * from './Point';
+export * from './ReferenceLine';
 export * from './Scrubber';
 //# sourceMappingURL=index.d.ts.map