@ledgerhq/lumen-ui-react 0.1.56 → 0.1.58

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

@@ -0,0 +1,114 @@
+import { jsxs as f, jsx as t, Fragment as y } from "react/jsx-runtime";
+import { useId as b } from "react";
+import { chartConfig as h } from "../config.js";
+import { DefaultScrubberTooltip as m } from "./DefaultScrubberTooltip/DefaultScrubberTooltip.js";
+import { useScrubberGeometry as g } from "./useScrubberGeometry.js";
+const { color: C, strokeWidth: x, scrubber: e } = h;
+function k({ pixelX: r, top: s, bottom: o }) {
+  const l = b();
+  return /* @__PURE__ */ f(y, { children: [
+    /* @__PURE__ */ t("defs", { children: /* @__PURE__ */ f(
+      "linearGradient",
+      {
+        id: l,
+        gradientUnits: "userSpaceOnUse",
+        x1: r,
+        y1: s,
+        x2: r,
+        y2: o,
+        children: [
+          /* @__PURE__ */ t(
+            "stop",
+            {
+              offset: "0%",
+              stopColor: e.lineColor,
+              stopOpacity: e.lineGradientEdgeOpacity
+            }
+          ),
+          /* @__PURE__ */ t("stop", { offset: "20%", stopColor: e.lineColor }),
+          /* @__PURE__ */ t("stop", { offset: "80%", stopColor: e.lineColor }),
+          /* @__PURE__ */ t(
+            "stop",
+            {
+              offset: "100%",
+              stopColor: e.lineColor,
+              stopOpacity: e.lineGradientEdgeOpacity
+            }
+          )
+        ]
+      }
+    ) }),
+    /* @__PURE__ */ t(
+      "line",
+      {
+        "data-testid": "scrubber-line",
+        x1: r,
+        y1: s,
+        x2: r,
+        y2: o,
+        stroke: `url(#${l})`,
+        strokeWidth: x.hairline
+      }
+    )
+  ] });
+}
+function j({
+  hideLine: r = !1,
+  hideOverlay: s = !1,
+  showBeacons: o = !1,
+  tooltip: l
+}) {
+  const p = g({ showBeacons: o, tooltip: l });
+  if (!p)
+    return null;
+  const { pixelX: c, drawingArea: n, beacons: u, overlay: a, tooltipPayload: i } = p;
+  return /* @__PURE__ */ f("g", { "data-testid": "scrubber", children: [
+    !r && /* @__PURE__ */ t(
+      k,
+      {
+        pixelX: c,
+        top: n.y,
+        bottom: n.y + n.height
+      }
+    ),
+    !s && /* @__PURE__ */ t(
+      "rect",
+      {
+        "data-testid": "scrubber-overlay",
+        x: a.x,
+        y: a.y,
+        width: a.width,
+        height: a.height,
+        fill: e.overlayColor,
+        opacity: e.overlayOpacity
+      }
+    ),
+    o && u.map((d) => /* @__PURE__ */ t(
+      "circle",
+      {
+        "data-testid": `scrubber-beacon-${d.id}`,
+        cx: c,
+        cy: d.pixelY,
+        r: e.beaconRadius,
+        fill: d.stroke,
+        stroke: C.markOutline,
+        strokeWidth: e.beaconStrokeWidth
+      },
+      d.id
+    )),
+    i !== void 0 && /* @__PURE__ */ t(
+      m,
+      {
+        pixelX: c,
+        drawingArea: n,
+        title: i.resolvedTitle,
+        items: i.items,
+        offset: i.offset,
+        minWidth: i.minWidth
+      }
+    )
+  ] });
+}
+export {
+  j as Scrubber
+};

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

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

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

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

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

@@ -0,0 +1,154 @@
+import { jsx as K } from "react/jsx-runtime";
+import { useState as j, useRef as C, useMemo as X, useCallback as c, useEffect as z } from "react";
+import { chartConfig as H } from "../config.js";
+import { clamp as g } from "../utils/numbers.js";
+import { buildSortedMagnets as N, getDataIndexFromPosition as U, resolvePixelX as V, applyMagnetization as G } from "./utils.js";
+import { useCartesianChartContext as J } from "../CartesianChart/context/cartesianChartContext.js";
+import { useMagneticSnapshot as O } from "../Point/pointContext/magneticPointsContext.js";
+import { ScrubberContextProvider as Q } from "./context/scrubberContext.js";
+const { scrubber: l } = H;
+function te({
+  children: T,
+  svgRef: D,
+  enableScrubbing: r,
+  onScrubberPositionChange: R,
+  magnetRadius: E = l.defaultMagnetRadius
+}) {
+  const { getXScale: m, getXAxisConfig: v, dataLength: n } = J(), { getMagneticPoints: w, version: B } = O(), [h, F] = j(
+    void 0
+  ), p = C(h);
+  p.current = h;
+  const L = C(null), f = C(0), A = X(() => {
+    const e = w();
+    return N({
+      magneticIndices: e,
+      getPixelForIndex: (t) => V(t, m, v())
+    });
+  }, [B, w, m, v]), a = c(
+    (e) => {
+      const t = e === void 0 || n <= 0 ? void 0 : g(e, 0, n - 1);
+      F(t), R?.(t);
+    },
+    [n, R]
+  ), I = c(
+    (e) => {
+      const t = m();
+      if (!t || !r || n <= 0) return;
+      const i = v();
+      let o = U(
+        e,
+        t,
+        i,
+        n
+      );
+      E > 0 && (o = G({
+        resolvedIndex: o,
+        pixelX: e,
+        sortedMagnets: A,
+        magnetRadius: E
+      })), o !== p.current && a(o);
+    },
+    [
+      r,
+      m,
+      v,
+      n,
+      A,
+      E,
+      a
+    ]
+  ), u = c(
+    (e) => {
+      L.current = e, f.current || (f.current = requestAnimationFrame(() => {
+        f.current = 0;
+        const t = L.current;
+        t !== null && (L.current = null, I(t));
+      }));
+    },
+    [I]
+  ), s = c(() => {
+    r && a(void 0);
+  }, [r, a]), x = c(
+    (e) => {
+      const i = e.currentTarget.getBoundingClientRect();
+      u(e.clientX - i.left);
+    },
+    [u]
+  ), P = c(
+    (e) => {
+      if (!r || !e.touches.length) return;
+      const t = e.touches[0], o = e.currentTarget.getBoundingClientRect();
+      u(t.clientX - o.left);
+    },
+    [r, u]
+  ), k = c(
+    (e) => {
+      if (!e.touches.length) return;
+      e.preventDefault();
+      const t = e.touches[0], o = e.currentTarget.getBoundingClientRect();
+      u(t.clientX - o.left);
+    },
+    [u]
+  ), M = c(
+    (e) => {
+      if (!r || n <= 0) return;
+      const t = n - 1, i = p.current ?? t, o = e.shiftKey ? g(
+        Math.floor(t * l.keyboardPageStepRatio),
+        l.keyboardPageStepMin,
+        l.keyboardPageStepMax
+      ) : l.keyboardStep;
+      let d;
+      switch (e.key) {
+        case "ArrowLeft":
+          e.preventDefault(), d = g(i - o, 0, t);
+          break;
+        case "ArrowRight":
+          e.preventDefault(), d = g(i + o, 0, t);
+          break;
+        case "Home":
+          e.preventDefault(), d = 0;
+          break;
+        case "End":
+          e.preventDefault(), d = t;
+          break;
+        case "Escape":
+          e.preventDefault(), d = void 0;
+          break;
+        default:
+          return;
+      }
+      a(d);
+    },
+    [r, n, a]
+  ), y = c(() => {
+    !r || p.current === void 0 || s();
+  }, [r, s]);
+  z(() => {
+    const e = D.current;
+    if (!(!e || !r))
+      return e.addEventListener("mousemove", x), e.addEventListener("mouseleave", s), e.addEventListener("touchstart", P, { passive: !1 }), e.addEventListener("touchmove", k, { passive: !1 }), e.addEventListener("touchend", s), e.addEventListener("touchcancel", s), e.addEventListener("keydown", M), e.addEventListener("blur", y), () => {
+        e.removeEventListener("mousemove", x), e.removeEventListener("mouseleave", s), e.removeEventListener("touchstart", P), e.removeEventListener("touchmove", k), e.removeEventListener("touchend", s), e.removeEventListener("touchcancel", s), e.removeEventListener("keydown", M), e.removeEventListener("blur", y), cancelAnimationFrame(f.current), f.current = 0;
+      };
+  }, [
+    D,
+    r,
+    x,
+    s,
+    P,
+    k,
+    M,
+    y
+  ]);
+  const q = X(
+    () => ({
+      enableScrubbing: r,
+      scrubberPosition: h,
+      onScrubberPositionChange: a
+    }),
+    [r, h, a]
+  );
+  return /* @__PURE__ */ K(Q, { value: q, children: T });
+}
+export {
+  te as ScrubberProvider
+};

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

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

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

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

package/dist/lib/Components/visualization/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/visualization/Scrubber/context/scrubberContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrubberContext.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/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/visualization/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/visualization/Scrubber/index.d.ts

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

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

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

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

@@ -0,0 +1,130 @@
+import { ReactElement, ReactNode, Ref, RefObject, SVGProps } from 'react';
+import { ScrubbingOptions } from '../CartesianChart/types';
+import { DrawingArea } from '../utils/types';
+export type ScrubberContextValue = Required<Pick<ScrubbingOptions, 'enableScrubbing' | 'onScrubberPositionChange'>> & {
+    /**
+     * The current data index of the scrubber, or undefined when idle.
+     */
+    scrubberPosition: number | undefined;
+};
+export type ScrubberProviderProps = Omit<ScrubbingOptions, 'enableScrubbing'> & Required<Pick<ScrubbingOptions, 'enableScrubbing'>> & {
+    children: ReactNode;
+    /**
+     * Ref to the root SVG element where event listeners will be attached.
+     */
+    svgRef: RefObject<SVGSVGElement | null>;
+};
+/**
+ * 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;
+    /**
+     * Optional title displayed at the top of the tooltip. Omit to render
+     * the tooltip without a title row.
+     */
+    title?: SvgTextContent;
+    /**
+     * 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 `undefined` to suppress the title.
+     */
+    title?: SvgTextContent | ((index: number) => SvgTextContent | undefined);
+    /**
+     * Tooltip rows for this index. Return an empty array to hide the tooltip.
+     */
+    items: ChartTooltipItemData[];
+};
+export type ScrubberProps = {
+    /**
+     * 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;
+    /**
+     * 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/visualization/Scrubber/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/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,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CACzC,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,GAAG,0BAA0B,CAAC,CACvE,GAAG;IACF;;OAEG;IACH,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAC3E,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,CAAC,GAAG;IACpD,QAAQ,EAAE,SAAS,CAAC;IACpB;;OAEG;IACH,MAAM,EAAE,SAAS,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;CACzC,CAAC;AAEJ;;;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;;OAEG;IACH,KAAK,EAAE,cAAc,CAAC;IACtB;;OAEG;IACH,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,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB;;OAEG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,0BAA0B,GAAG;IAChE;;;OAGG;IACH,KAAK,CAAC,EAAE,cAAc,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC,CAAC;IACzE;;OAEG;IACH,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B;;;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/visualization/Scrubber/useScrubberGeometry.d.ts

@@ -0,0 +1,29 @@
+import { DrawingArea } from '../utils/types';
+import { ScrubberProps } from './types';
+import { OverlayRect, ScrubberTooltipPayload } from './utils';
+type Beacon = {
+    id: string;
+    stroke: string;
+    pixelY: number;
+};
+type ScrubberGeometry = {
+    pixelX: number;
+    drawingArea: DrawingArea;
+    beacons: Beacon[];
+    overlay: OverlayRect;
+    tooltipPayload: ScrubberTooltipPayload | undefined;
+};
+type UseScrubberGeometryParams = {
+    showBeacons: boolean;
+    tooltip: ScrubberProps['tooltip'];
+};
+/**
+ * Resolves the scrubber's chart geometry: reads the scrubber and chart
+ * contexts, projects the active data index to the line's `pixelX`, and derives
+ * the per-series beacons, the future-data overlay rect, and the tooltip
+ * payload. Returns `null` when no scrubber position is active or the position
+ * cannot be projected.
+ */
+export declare const useScrubberGeometry: ({ showBeacons, tooltip, }: UseScrubberGeometryParams) => ScrubberGeometry | null;
+export {};
+//# sourceMappingURL=useScrubberGeometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useScrubberGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Scrubber/useScrubberGeometry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC5B,MAAM,SAAS,CAAC;AAIjB,KAAK,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,KAAK,gBAAgB,GAAG;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,sBAAsB,GAAG,SAAS,CAAC;CACpD,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACnC,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,2BAGjC,yBAAyB,KAAG,gBAAgB,GAAG,IA4CjD,CAAC"}

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

@@ -0,0 +1,37 @@
+import { useMemo as t } from "react";
+import { chartConfig as x } from "../config.js";
+import { resolvePixelX as b, resolvePixelY as g, resolveTooltipPayload as C, computeOverlayRect as y } from "./utils.js";
+import { useScrubberContext as P } from "./context/scrubberContext.js";
+import { useCartesianChartContext as S } from "../CartesianChart/context/cartesianChartContext.js";
+const { color: X } = x, D = ({
+  showBeacons: i,
+  tooltip: n
+}) => {
+  const { scrubberPosition: r } = P(), {
+    getXScale: s,
+    getXAxisConfig: l,
+    getYScale: u,
+    drawingArea: a,
+    series: c,
+    seriesMap: d
+  } = S(), o = t(() => {
+    if (r !== void 0)
+      return b(r, s, l());
+  }, [r, s, l]), f = t(() => r === void 0 || !i ? [] : c.map((e) => {
+    const p = d.get(e.id)?.data, m = g(r, p, u);
+    return m === void 0 ? null : { id: e.id, stroke: e.stroke || X.stroke, pixelY: m };
+  }).filter((e) => e !== null), [r, i, c, d, u]), v = t(() => {
+    if (r !== void 0)
+      return C(n, r);
+  }, [r, n]);
+  return r === void 0 || o === void 0 ? null : {
+    pixelX: o,
+    drawingArea: a,
+    beacons: f,
+    overlay: y(o, a),
+    tooltipPayload: v
+  };
+};
+export {
+  D as useScrubberGeometry
+};

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

@@ -0,0 +1,79 @@
+import { BaseAxisProps } from '../Axis';
+import { useCartesianChartContext } from '../CartesianChart/context';
+import { ChartScaleFunction, DrawingArea } from '../utils/types';
+import { ChartTooltipItemData, ScrubberTooltipContent, SvgTextContent } from './types';
+export type MagnetEntry = {
+    index: number;
+    pixelX: number;
+};
+export type OverlayRect = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+export type ScrubberTooltipPayload = {
+    items: ChartTooltipItemData[];
+    resolvedTitle: SvgTextContent | undefined;
+    offset?: number;
+    minWidth?: number;
+};
+/**
+ * Resolves each magnetic index to its pixel position and returns them sorted
+ * by `pixelX` ascending. Indices that cannot be projected are filtered out.
+ * The sorted output enables early-exit in {@link applyMagnetization}.
+ */
+export declare const buildSortedMagnets: ({ magneticIndices, getPixelForIndex, }: {
+    magneticIndices: ReadonlySet<number>;
+    getPixelForIndex: (index: number) => number | undefined;
+}) => MagnetEntry[];
+/**
+ * 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<BaseAxisProps> | 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?: BaseAxisProps) => number | undefined;
+/**
+ * Binary search for the magnet whose `pixelX` is closest to `pixelX`.
+ * Returns -1 when the array is empty. Favors the left neighbor on ties.
+ */
+export declare const nearestIndex: (sortedMagnets: readonly MagnetEntry[], pixelX: number) => number;
+/**
+ * Given a resolved data index and the raw pixel position, checks whether any
+ * magnetic point is within `magnetRadius` pixels of `pixelX`. If so, returns
+ * the closest magnetic index; otherwise returns the original `resolvedIndex`.
+ */
+export declare const applyMagnetization: ({ resolvedIndex, pixelX, sortedMagnets, magnetRadius, }: {
+    resolvedIndex: number;
+    pixelX: number;
+    sortedMagnets: readonly MagnetEntry[];
+    magnetRadius: number;
+}) => number;
+/**
+ * Computes the rect that dims the data after the scrubber line. It starts just
+ * right of the line and spans to the drawing area's right edge, padded by
+ * `overlayOffset` on the top, bottom, and right. Width is clamped at 0 so the
+ * rect never inverts when the line sits at the right edge.
+ */
+export declare const computeOverlayRect: (pixelX: number, drawingArea: DrawingArea) => OverlayRect;
+/**
+ * Resolves the `tooltip` callback for a data index into render-ready payload:
+ * invokes the callback, resolves a function `title`, and returns `undefined`
+ * when there is no callback or it yields no items (so nothing is rendered).
+ */
+export declare const resolveTooltipPayload: (tooltip: ((dataIndex: number) => ScrubberTooltipContent) | undefined, scrubberPosition: number) => ScrubberTooltipPayload | undefined;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Scrubber/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAQ1E,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,EAAE,oBAAoB,EAAE,CAAC;IAC9B,aAAa,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,wCAGhC;IACD,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACzD,KAAG,WAAW,EAad,CAAC;AAgCF;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GACnC,QAAQ,MAAM,EACd,OAAO,kBAAkB,EACzB,YAAY,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC9C,YAAY,MAAM,KACjB,MAwBF,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,aAAa,KACzB,MAAM,GAAG,SAMX,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,YAAY,GACvB,eAAe,SAAS,WAAW,EAAE,EACrC,QAAQ,MAAM,KACb,MAsBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,yDAKhC;IACD,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,YAAY,EAAE,MAAM,CAAC;CACtB,KAAG,MAWH,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAQ,MAAM,EACd,aAAa,WAAW,KACvB,WAYD,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,sBAAsB,CAAC,GAAG,SAAS,EACpE,kBAAkB,MAAM,KACvB,sBAAsB,GAAG,SAiB3B,CAAC"}