@ledgerhq/lumen-ui-react-visualization 0.1.9 → 0.1.11

package/dist/lib/Components/LineChart/LineChart.js

@@ -1,10 +1,10 @@
-import { jsxs as b, jsx as e } from "react/jsx-runtime";
-import { useMemo as E } from "react";
-import { DEFAULT_AXIS_WIDTH as H, YAxis as j } from "../Axis/YAxis/YAxis.js";
-import { DEFAULT_AXIS_HEIGHT as m, XAxis as F } from "../Axis/XAxis/XAxis.js";
-import { CartesianChart as U } from "../CartesianChart/CartesianChart.js";
-import { Line as V } from "../Line/Line.js";
-function q({
+import { jsxs as H, jsx as e } from "react/jsx-runtime";
+import { useMemo as j } from "react";
+import { DEFAULT_AXIS_WIDTH as F, YAxis as U } from "../Axis/YAxis/YAxis.js";
+import { DEFAULT_AXIS_HEIGHT as m, XAxis as V } from "../Axis/XAxis/XAxis.js";
+import { CartesianChart as W } from "../CartesianChart/CartesianChart.js";
+import { Line as h } from "../Line/Line.js";
+function B({
   series: r,
   showArea: d = !1,
   areaType: c = "gradient",
@@ -15,29 +15,31 @@ function q({
   width: x = "100%",
   height: y = 160,
   inset: T,
-  children: g
+  enableScrubbing: g,
+  onScrubberPositionChange: u,
+  children: A
 }) {
   const {
-    scaleType: u,
-    data: A,
-    domain: D,
+    scaleType: D,
+    data: C,
+    domain: I,
     ...n
   } = f ?? {}, {
-    scaleType: C,
-    data: I,
-    domain: P,
+    scaleType: P,
+    data: L,
+    domain: S,
     ...o
-  } = l ?? {}, L = {
-    scaleType: u,
-    data: A,
-    domain: D
-  }, S = {
-    scaleType: C,
-    data: I,
-    domain: P
-  }, _ = E(() => {
+  } = l ?? {}, _ = {
+    scaleType: D,
+    data: C,
+    domain: I
+  }, b = {
+    scaleType: P,
+    data: L,
+    domain: S
+  }, E = j(() => {
     if (!t && !i) return;
-    const a = n.position === "top" ? "top" : "bottom", s = o.position === "end" ? "right" : "left", p = o.width ?? H;
+    const a = n.position === "top" ? "top" : "bottom", s = o.position === "end" ? "right" : "left", p = o.width ?? F;
     return {
       top: t && a === "top" ? m : 0,
       bottom: t && a === "bottom" ? m : 0,
@@ -51,21 +53,23 @@ function q({
     o.position,
     o.width
   ]);
-  return /* @__PURE__ */ b(
-    U,
+  return /* @__PURE__ */ H(
+    W,
     {
       series: r ?? [],
-      xAxis: L,
-      yAxis: S,
+      xAxis: _,
+      yAxis: b,
       width: x,
       height: y,
       inset: T,
-      axisPadding: _,
+      axisPadding: E,
+      enableScrubbing: g,
+      onScrubberPositionChange: u,
       children: [
-        t && /* @__PURE__ */ e(F, { ...n }),
-        i && /* @__PURE__ */ e(j, { ...o }),
+        t && /* @__PURE__ */ e(V, { ...n }),
+        i && /* @__PURE__ */ e(U, { ...o }),
         r?.map((a) => /* @__PURE__ */ e(
-          V,
+          h,
           {
             seriesId: a.id,
             showArea: d,
@@ -73,11 +77,11 @@ function q({
           },
           a.id
         )),
-        g
+        A
       ]
     }
   );
 }
 export {
-  q as LineChart
+  B as LineChart
 };

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

@@ -59,5 +59,16 @@ export type LineChartProps = {
      * Additional SVG content rendered inside the chart after lines and axes.
      */
     children?: ReactNode;
+    /**
+     * Enables scrubbing (hover/touch/keyboard) interactions on the chart.
+     * When true, add a `<Scrubber>` as a child to visualise the interaction.
+     * @default false
+     */
+    enableScrubbing?: boolean;
+    /**
+     * Callback fired whenever the scrubber moves to a new data index or is cleared.
+     * Receives `undefined` when the scrubber leaves the chart.
+     */
+    onScrubberPositionChange?: (index: number | undefined) => void;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/LineChart/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/LineChart/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,wBAAwB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE,CAAC"}

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

@@ -0,0 +1,17 @@
+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.
+ *
+ * Must be used as a child of `LineChart` (or `CartesianChart`) with
+ * `enableScrubbing` enabled. Renders nothing when no scrubber position is active.
+ *
+ * @example
+ * ```tsx
+ * <LineChart series={data} enableScrubbing>
+ *   <Scrubber label={(i) => data[i].date} />
+ * </LineChart>
+ * ```
+ */
+export declare function Scrubber({ label, hideLine, hideOverlay, showBeacons, }: Readonly<ScrubberProps>): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=Scrubber.d.ts.map

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

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

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

@@ -0,0 +1,134 @@
+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
+}) {
+  const u = N(), { scrubberPosition: e } = V(), {
+    getXScale: b,
+    getXAxisConfig: v,
+    getYScale: p,
+    drawingArea: O,
+    series: x,
+    seriesMap: y
+  } = H(), o = c(() => {
+    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 };
+  }).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)
+    return null;
+  const {
+    x: _,
+    y: s,
+    width: S,
+    height: n
+  } = O, k = o + E, I = s - f, L = 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(
+        "linearGradient",
+        {
+          id: u,
+          gradientUnits: "userSpaceOnUse",
+          x1: o,
+          y1: s,
+          x2: o,
+          y2: s + n,
+          children: [
+            /* @__PURE__ */ i(
+              "stop",
+              {
+                offset: "0%",
+                stopColor: t("var(--border-base)"),
+                stopOpacity: g
+              }
+            ),
+            /* @__PURE__ */ i("stop", { offset: "20%", stopColor: t("var(--border-base)") }),
+            /* @__PURE__ */ i("stop", { offset: "80%", stopColor: t("var(--border-base)") }),
+            /* @__PURE__ */ i(
+              "stop",
+              {
+                offset: "100%",
+                stopColor: t("var(--border-base)"),
+                stopOpacity: g
+              }
+            )
+          ]
+        }
+      ) }),
+      /* @__PURE__ */ i(
+        "line",
+        {
+          "data-testid": "scrubber-line",
+          x1: o,
+          y1: s,
+          x2: o,
+          y2: s + n,
+          stroke: `url(#${u})`,
+          strokeWidth: t("var(--stroke-1)")
+        }
+      )
+    ] }),
+    !C && /* @__PURE__ */ i(
+      "rect",
+      {
+        "data-testid": "scrubber-overlay",
+        x: k,
+        y: I,
+        width: L,
+        height: T,
+        fill: t("var(--background-base)"),
+        opacity: X
+      }
+    ),
+    m !== void 0 && /* @__PURE__ */ i(
+      "text",
+      {
+        "data-testid": "scrubber-label",
+        x: o,
+        y: s - D,
+        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)")
+        },
+        children: m
+      }
+    ),
+    d && Y.map((r) => /* @__PURE__ */ i(
+      "circle",
+      {
+        "data-testid": `scrubber-beacon-${r.id}`,
+        cx: o,
+        cy: r.pixelY,
+        r: G,
+        fill: r.stroke,
+        stroke: t("var(--background-canvas)"),
+        strokeWidth: P
+      },
+      r.id
+    ))
+  ] });
+}
+export {
+  K as Scrubber
+};

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

@@ -0,0 +1,3 @@
+import { ScrubberProviderProps } from './types';
+export declare function ScrubberProvider({ children, svgRef, enableScrubbing, onScrubberPositionChange, }: Readonly<ScrubberProviderProps>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ScrubberProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScrubberProvider.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/ScrubberProvider.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAG3E,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,MAAM,EACN,eAAe,EACf,wBAAwB,GACzB,EAAE,QAAQ,CAAC,qBAAqB,CAAC,2CAiLjC"}

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

@@ -0,0 +1,122 @@
+import { jsx as D } from "react/jsx-runtime";
+import { useState as w, useRef as y, useCallback as a, useEffect as R, useMemo as T } from "react";
+import { getDataIndexFromPosition as X } from "./utils.js";
+import { useCartesianChartContext as A } from "../CartesianChart/context/cartesianChartContext.js";
+import { ScrubberContextProvider as B } from "./context/scrubberContext.js";
+function N({
+  children: k,
+  svgRef: L,
+  enableScrubbing: o,
+  onScrubberPositionChange: x
+}) {
+  const { getXScale: M, getXAxisConfig: g, dataLength: s } = A(), [m, C] = w(
+    void 0
+  ), v = y(m);
+  v.current = m;
+  const c = a(
+    (t) => {
+      const e = t === void 0 ? void 0 : Math.max(0, Math.min(t, s - 1));
+      C(e), x?.(e);
+    },
+    [s, x]
+  ), i = a(
+    (t) => {
+      const e = M();
+      if (!e || !o || s <= 0) return;
+      const n = X(
+        t,
+        e,
+        g(),
+        s
+      );
+      n !== v.current && c(n);
+    },
+    [
+      o,
+      M,
+      g,
+      s,
+      c
+    ]
+  ), r = a(() => {
+    o && c(void 0);
+  }, [o, c]), h = a(
+    (t) => {
+      const n = t.currentTarget.getBoundingClientRect();
+      i(t.clientX - n.left);
+    },
+    [i]
+  ), f = a(
+    (t) => {
+      if (!o || !t.touches.length) return;
+      const e = t.touches[0], u = t.currentTarget.getBoundingClientRect();
+      i(e.clientX - u.left);
+    },
+    [o, i]
+  ), l = a(
+    (t) => {
+      if (!t.touches.length) return;
+      t.preventDefault();
+      const e = t.touches[0], u = t.currentTarget.getBoundingClientRect();
+      i(e.clientX - u.left);
+    },
+    [i]
+  ), E = a(
+    (t) => {
+      if (!o || s <= 0) return;
+      const e = s - 1, n = v.current ?? e, u = t.shiftKey ? Math.min(10, Math.max(1, Math.floor(e * 0.1))) : 1;
+      let d;
+      switch (t.key) {
+        case "ArrowLeft":
+          t.preventDefault(), d = Math.max(0, n - u);
+          break;
+        case "ArrowRight":
+          t.preventDefault(), d = Math.min(e, n + u);
+          break;
+        case "Home":
+          t.preventDefault(), d = 0;
+          break;
+        case "End":
+          t.preventDefault(), d = e;
+          break;
+        case "Escape":
+          t.preventDefault(), d = void 0;
+          break;
+        default:
+          return;
+      }
+      c(d);
+    },
+    [o, s, c]
+  ), p = a(() => {
+    !o || v.current === void 0 || r();
+  }, [o, r]);
+  R(() => {
+    const t = L.current;
+    if (!(!t || !o))
+      return t.addEventListener("mousemove", h), t.addEventListener("mouseleave", r), t.addEventListener("touchstart", f, { passive: !1 }), t.addEventListener("touchmove", l, { passive: !1 }), t.addEventListener("touchend", r), t.addEventListener("touchcancel", r), t.addEventListener("keydown", E), t.addEventListener("blur", p), () => {
+        t.removeEventListener("mousemove", h), t.removeEventListener("mouseleave", r), t.removeEventListener("touchstart", f), t.removeEventListener("touchmove", l), t.removeEventListener("touchend", r), t.removeEventListener("touchcancel", r), t.removeEventListener("keydown", E), t.removeEventListener("blur", p);
+      };
+  }, [
+    L,
+    o,
+    h,
+    r,
+    f,
+    l,
+    E,
+    p
+  ]);
+  const P = T(
+    () => ({
+      enableScrubbing: o,
+      scrubberPosition: m,
+      onScrubberPositionChange: c
+    }),
+    [o, m, c]
+  );
+  return /* @__PURE__ */ D(B, { value: P, children: k });
+}
+export {
+  N as ScrubberProvider
+};

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

@@ -0,0 +1,2 @@
+export { ScrubberContextProvider, useScrubberContext } from './scrubberContext';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Scrubber/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

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

@@ -0,0 +1,8 @@
+import { ScrubberContextValue } from '../types';
+declare const ScrubberContextProvider: import('react').FC<{
+    children: import('react').ReactNode;
+    value: ScrubberContextValue;
+}>;
+export declare const useScrubberContext: () => ScrubberContextValue;
+export { ScrubberContextProvider };
+//# sourceMappingURL=scrubberContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrubberContext.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/Scrubber/context/scrubberContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,QAAA,MAAO,uBAAuB;;;EACuB,CAAC;AAEtD,eAAO,MAAM,kBAAkB,QAAO,oBAIlC,CAAC;AAEL,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

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

@@ -0,0 +1,9 @@
+import { createSafeContext as e } from "../../../../libs/utils-shared/dist/index.js";
+const [o, r] = e("Scrubber"), u = () => r({
+  consumerName: "useScrubberContext",
+  contextRequired: !0
+});
+export {
+  o as ScrubberContextProvider,
+  u as useScrubberContext
+};

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

@@ -0,0 +1,4 @@
+export { Scrubber } from './Scrubber';
+export { useScrubberContext } from './context';
+export type { ScrubberProps, ScrubberContextValue } from './types';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,53 @@
+import { ReactNode, RefObject } from 'react';
+export type ScrubberContextValue = {
+    /**
+     * Whether scrubbing interactions are enabled.
+     */
+    enableScrubbing: boolean;
+    /**
+     * The current data index of the scrubber, or undefined when idle.
+     */
+    scrubberPosition: number | undefined;
+    /**
+     * Callback to update the scrubber position.
+     */
+    onScrubberPositionChange: (index: number | undefined) => void;
+};
+export type ScrubberProviderProps = {
+    children: ReactNode;
+    /**
+     * Ref to the root SVG element where event listeners will be attached.
+     */
+    svgRef: RefObject<SVGSVGElement | null>;
+    /**
+     * Whether scrubbing is enabled.
+     */
+    enableScrubbing: boolean;
+    /**
+     * Optional external callback fired whenever the scrubber position changes.
+     */
+    onScrubberPositionChange?: (index: number | undefined) => void;
+};
+export type ScrubberProps = {
+    /**
+     * Formats a label string shown above the reference line for a given data index.
+     * When omitted, no label is rendered.
+     */
+    label?: (dataIndex: number) => string;
+    /**
+     * Hides the vertical reference line.
+     * @default false
+     */
+    hideLine?: boolean;
+    /**
+     * Hides the semi-transparent overlay that dims data after the scrubber position.
+     * @default false
+     */
+    hideOverlay?: boolean;
+    /**
+     * Shows the beacon dots on each series at the scrubbed data index.
+     * @default false
+     */
+    showBeacons?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,30 @@
+import { AxisConfigProps, ChartScaleFunction } from '../../utils/types';
+import { useCartesianChartContext } from '../CartesianChart/context';
+export declare const BEACON_RADIUS = 5;
+export declare const BEACON_STROKE_WIDTH = 2;
+export declare const LABEL_OFFSET_Y = 12;
+export declare const OVERLAY_OFFSET = 2;
+export declare const OVERLAY_LINE_INSET = 0.5;
+export declare const OVERLAY_OPACITY = 0.8;
+export declare const LINE_GRADIENT_EDGE_OPACITY = 0.1;
+/**
+ * Converts a pixel position along the x-axis into the nearest data index.
+ *
+ * For band (categorical) scales, finds the band whose center is closest to
+ * `pixelX`. For numeric scales, uses `scale.invert()` and rounds to the
+ * nearest integer, clamped to the valid index range.
+ */
+export declare const getDataIndexFromPosition: (pixelX: number, scale: ChartScaleFunction, axisConfig: Partial<AxisConfigProps> | undefined, dataLength: number) => number;
+/**
+ * Resolves the pixel y-coordinate for a given series data point at a data index.
+ * Returns undefined when the value is null/missing or the scale is unavailable.
+ */
+export declare const resolvePixelY: (dataIndex: number, seriesData: (number | null)[] | undefined, getYScale: ReturnType<typeof useCartesianChartContext>["getYScale"]) => number | undefined;
+/**
+ * Resolves the pixel x-coordinate for a given data index using the x-scale.
+ * When numeric x-axis data is provided, the corresponding axis value is used;
+ * otherwise the data index is used as the x input.
+ * Returns undefined when the scale is unavailable or the value cannot be mapped.
+ */
+export declare const resolvePixelX: (dataIndex: number, getXScale: ReturnType<typeof useCartesianChartContext>["getXScale"], axisConfig?: AxisConfigProps) => number | undefined;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/lib/Components/Scrubber/utils.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAE1E,eAAO,MAAM,aAAa,IAAI,CAAC;AAC/B,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAgC9C;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,MAAM,EACd,OAAO,kBAAkB,EACzB,YAAY,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,EAChD,YAAY,MAAM,KACjB,MA2BF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EACjB,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,SAAS,EACzC,WAAW,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,WAAW,CAAC,KAClE,MAAM,GAAG,SASX,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GACxB,WAAW,MAAM,EACjB,WAAW,UAAU,CAAC,OAAO,wBAAwB,CAAC,CAAC,WAAW,CAAC,EACnE,aAAa,eAAe,KAC3B,MAAM,GAAG,SAMX,CAAC"}

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

@@ -0,0 +1,57 @@
+import { getPointOnScale as d, isNumericScale as u, isCategoricalScale as l } from "../../utils/scales/scales.js";
+const v = 5, _ = 2, m = 12, A = 2, I = 0.5, O = 0.8, h = 0.1, f = (o) => typeof o[0] == "number", a = (o, n, r) => {
+  let e = 0, t = 1 / 0;
+  for (let i = 0; i < o; i++) {
+    const s = r(i);
+    if (s === void 0) continue;
+    const c = Math.abs(n - s);
+    c < t && (t = c, e = i);
+  }
+  return e;
+}, S = (o, n, r, e) => {
+  if (l(n)) {
+    const t = n.domain(), i = n.bandwidth();
+    return a(t.length, o, (s) => {
+      const c = n(t[s]);
+      return c === void 0 ? void 0 : c + i / 2;
+    });
+  }
+  if (u(n)) {
+    const t = r?.data;
+    if (t && t.length > 0 && f(t))
+      return a(
+        t.length,
+        o,
+        (s) => n(t[s])
+      );
+    const i = n.invert(o);
+    return Math.max(
+      0,
+      Math.min(Math.round(i), e - 1)
+    );
+  }
+  return 0;
+}, x = (o, n, r) => {
+  const e = r();
+  if (!e || !u(e) || !n) return;
+  const t = n[o];
+  if (t != null)
+    return e(t);
+}, N = (o, n, r) => {
+  const e = n();
+  if (!e) return;
+  const t = r?.data?.[o];
+  return d(typeof t == "number" ? t : o, e);
+};
+export {
+  v as BEACON_RADIUS,
+  _ as BEACON_STROKE_WIDTH,
+  m as LABEL_OFFSET_Y,
+  h as LINE_GRADIENT_EDGE_OPACITY,
+  I as OVERLAY_LINE_INSET,
+  A as OVERLAY_OFFSET,
+  O as OVERLAY_OPACITY,
+  S as getDataIndexFromPosition,
+  N as resolvePixelX,
+  x as resolvePixelY
+};

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/Components/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/Components/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC"}

package/dist/lib/utils/scales/scales.d.ts

@@ -25,6 +25,11 @@ export declare const isCategoricalScale: (scale: ChartScaleFunction) => scale is
  * Checks if a scale is a numeric scale.
  */
 export declare const isNumericScale: (scale: ChartScaleFunction) => scale is NumericScale;
+/**
+ * Converts a single data-space value to pixel-space on a given scale.
+ * For band scales the result is centered within the band.
+ */
+export declare const getPointOnScale: (value: number, scale: ChartScaleFunction) => number;
 /**
  * Projects a single data-space coordinate pair into pixel-space.
  * Handles centering for categorical (band) scales.

package/dist/lib/utils/scales/scales.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/scales/scales.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,+BAI7B;IACD,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB,KAAG,YAMH,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,6BAIjC;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,gBAUH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,eAAe,CAAC,WAAW,CAAC,KACtC,SAAS,IAAI,MAA8B,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,kBAAkB,KACxB,KAAK,IAAI,gBAEX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,kBAAkB,KACxB,KAAK,IAAI,YAEX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,kBAAkB,EAC1B,QAAQ,kBAAkB,KACzB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAQxB,CAAC"}
+{"version":3,"file":"scales.d.ts","sourceRoot":"","sources":["../../../../src/lib/utils/scales/scales.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACb,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,+BAI7B;IACD,SAAS,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;CACnB,KAAG,YAMH,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,6BAIjC;IACD,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,gBAUH,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,eAAe,CAAC,WAAW,CAAC,KACtC,SAAS,IAAI,MAA8B,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAC7B,OAAO,kBAAkB,KACxB,KAAK,IAAI,gBAEX,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GACzB,OAAO,kBAAkB,KACxB,KAAK,IAAI,YAEX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,MAAM,EACb,OAAO,kBAAkB,KACxB,MAKF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,OAAO,MAAM,EACb,OAAO,MAAM,EACb,QAAQ,kBAAkB,EAC1B,QAAQ,kBAAkB,KACzB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAGvB,CAAC"}