@ledgerhq/lumen-ui-react 0.1.55 → 0.1.57

package/dist/lib/Components/visualization/LineChart/LineChartEmptyState/index.d.ts

@@ -0,0 +1,3 @@
+export { LineChartEmptyState } from './LineChartEmptyState';
+export type { LineChartEmptyStateProps } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/Components/visualization/LineChart/LineChartEmptyState/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/LineChart/LineChartEmptyState/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,3 @@
+import { LineChartProps } from '../types';
+export type LineChartEmptyStateProps = Pick<LineChartProps, 'loading'>;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/LineChart/LineChartEmptyState/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,MAAM,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC"}

package/dist/lib/Components/visualization/LineChart/LineChartEmptyState/utils.d.ts

@@ -0,0 +1,8 @@
+import { DrawingArea } from '../../utils/types';
+/**
+ * Transform that fits `chartConfig.emptyState.placeholderLinePath` into the
+ * drawing area. Pair with `vector-effect: non-scaling-stroke` on the path so the
+ * stroke keeps a constant width despite the (potentially non-uniform) scale.
+ */
+export declare const buildPlaceholderTransform: (drawingArea: DrawingArea) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/lib/Components/visualization/LineChart/LineChartEmptyState/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/LineChart/LineChartEmptyState/utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,GAAI,aAAa,WAAW,KAAG,MAOpE,CAAC"}

package/dist/lib/Components/visualization/LineChart/LineChartEmptyState/utils.js

@@ -0,0 +1,8 @@
+import { chartConfig as e } from "../../config.js";
+const h = (t) => {
+  const l = t.width / e.emptyState.placeholderViewWidth, o = t.height / e.emptyState.placeholderViewHeight;
+  return `translate(${t.x}, ${t.y}) scale(${l}, ${o})`;
+};
+export {
+  h as buildPlaceholderTransform
+};

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

@@ -0,0 +1,3 @@
+export { LineChart } from './LineChart';
+export type { LineChartProps } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/LineChart/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

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

@@ -0,0 +1,82 @@
+import { XAxisProps } from '../Axis/XAxis';
+import { YAxisProps } from '../Axis/YAxis';
+import { CartesianChartProps } from '../CartesianChart/types';
+import { LineRenderOptions } from '../Line/types';
+import { Series } from '../utils/types';
+export type LineChartProps = LineRenderOptions & Pick<CartesianChartProps, 'width' | 'height' | 'inset' | 'animate' | 'children' | 'enableScrubbing' | 'onScrubberPositionChange' | 'magnetRadius'> & {
+    /**
+     * Data series to render as lines.
+     * Each series produces one `<Line>` element.
+     */
+    series?: Series[];
+    /**
+     * Chart-wide override controlling how null values are handled across all lines.
+     * When true, skips null values and draws continuous lines across gaps.
+     * When false, null values create gaps in the lines.
+     * When omitted, each series' own `connectNulls` value is used (defaulting to `false`).
+     */
+    connectNulls?: boolean;
+    /**
+     * Whether to render an x-axis.
+     * @default false
+     */
+    showXAxis?: boolean;
+    /**
+     * Whether to render a y-axis.
+     * @default false
+     */
+    showYAxis?: boolean;
+    /**
+     * Combined axis configuration and visual props for the x-axis.
+     * Includes scale/domain settings as well as visual options like `showGrid` and `showLine`.
+     */
+    xAxis?: XAxisProps;
+    /**
+     * Combined axis configuration and visual props for the y-axis.
+     * Includes scale/domain settings as well as visual options like `showGrid` and `showLine`.
+     */
+    yAxis?: YAxisProps;
+    /**
+     * Whether the chart is loading. When there is no data, renders an animated
+     * shimmer placeholder line (initial loading). When data is present (e.g. a
+     * time-range change), the current line is recoloured to a muted grey and
+     * shimmers until the new `series` is provided (transition loading).
+     *
+     * To get the transition behaviour, keep passing the previous `series` while
+     * refetching; clearing it falls back to the initial placeholder.
+     * @default false
+     */
+    loading?: boolean;
+    /**
+     * Text shown in the centre of the chart when there is no data and the chart
+     * is not loading.
+     * @default 'No data'
+     */
+    emptyLabel?: string;
+    /**
+     * When `true`, each series' `stroke` color is nudged so its HSL lightness
+     * differs from the surface background by at least 20 units.
+     *
+     * Colors that already meet that minimum are left untouched. Only applies to
+     * explicit 6-digit hex stroke values; other formats are passed through unchanged.
+     * @default false
+     */
+    enableColorContrast?: boolean;
+};
+/**
+ * Series-render fields shared by `LineChart` and its internal line
+ * sub-components. Derived from {@link LineChartProps} so the option types stay
+ * in sync.
+ */
+type LineSeriesRenderProps = Required<Pick<LineChartProps, 'series' | 'showArea' | 'areaType'>>;
+export type LineChartLinesProps = LineSeriesRenderProps & Pick<LineChartProps, 'connectNulls'> & {
+    stroke?: string;
+};
+export type LineChartTransitionLinesProps = Omit<LineChartLinesProps, 'stroke'>;
+export type LineChartContentProps = LineChartLinesProps & Required<Pick<LineChartProps, 'showXAxis' | 'showYAxis'>> & Pick<LineChartProps, 'children'> & {
+    xAxisConfig: XAxisProps;
+    yAxisConfig: YAxisProps;
+    isTransitionLoading: boolean;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/LineChart/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAC5C,IAAI,CACF,mBAAmB,EACjB,OAAO,GACP,QAAQ,GACR,OAAO,GACP,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,0BAA0B,GAC1B,cAAc,CACjB,GAAG;IACF;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEJ;;;;GAIG;AACH,KAAK,qBAAqB,GAAG,QAAQ,CACnC,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC,CACzD,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GACrD,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,GAAG;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEJ,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;AAEhF,MAAM,MAAM,qBAAqB,GAAG,mBAAmB,GACrD,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC,GACzD,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,GAAG;IACjC,WAAW,EAAE,UAAU,CAAC;IACxB,WAAW,EAAE,UAAU,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,CAAC"}

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

@@ -0,0 +1,56 @@
+import { XAxisProps } from '../Axis/XAxis';
+import { YAxisProps } from '../Axis/YAxis';
+import { ChartInset, Series } from '../utils/types';
+type ComputeAxisPaddingParams = {
+    showXAxis: boolean;
+    showYAxis: boolean;
+    xAxisPosition: XAxisProps['position'];
+    yAxisPosition: YAxisProps['position'];
+    yAxisWidth: YAxisProps['width'];
+};
+/**
+ * Reserves space on the relevant sides of the drawing area for visible axes.
+ * Returns `undefined` when no axis is shown so the chart keeps its full area.
+ */
+export declare const computeAxisPadding: ({ showXAxis, showYAxis, xAxisPosition, yAxisPosition, yAxisWidth, }: ComputeAxisPaddingParams) => Partial<ChartInset> | undefined;
+/**
+ * Derives the chart's display flags from its loading flag and whether it has
+ * drawable data. The four input combinations map to the initial-loading, empty,
+ * transition-loading, and ready states the chart renders.
+ */
+export declare const getChartDisplayStates: ({ loading, hasData, }: {
+    loading: boolean;
+    hasData: boolean;
+}) => {
+    showPlaceholder: boolean;
+    placeholderLoading: boolean;
+    showEmptyOverlay: boolean;
+    isTransitionLoading: boolean;
+};
+/**
+ * Accessibility label matching the chart's current state: the loading label
+ * while loading, the empty label when there is nothing to draw, otherwise none.
+ */
+export declare const getChartAriaLabel: ({ loading, hasData, emptyLabel, }: {
+    loading: boolean;
+    hasData: boolean;
+    emptyLabel: string;
+}) => string | undefined;
+/**
+ * Whether any series has at least `emptyState.minDrawablePoints` finite points,
+ * i.e. enough to actually draw a line. Drives the empty / loading / data states
+ * of the chart.
+ *
+ * When `xData` (the x-axis domain) is provided, only the first `xData.length`
+ * points of each series are considered — mirroring the cap in `toScaledPoints`
+ * (Line/utils.ts) — so a series longer than the axis cannot report drawable
+ * points that would never be plotted.
+ */
+export declare const canRenderLine: (series: Series[] | undefined, xData?: readonly (string | number)[]) => boolean;
+/**
+ * Overlays `overrides` on top of `defaults`, skipping keys whose override is
+ * `undefined`.
+ */
+export declare const mergeDefaults: <T extends object>(defaults: T, overrides?: Partial<T>) => T;
+export {};
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/LineChart/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAIzD,KAAK,wBAAwB,GAAG;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,aAAa,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;IACtC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,qEAMhC,wBAAwB,KAAG,OAAO,CAAC,UAAU,CAAC,GAAG,SAanD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,uBAGnC;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;;;;;CAKC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,mCAI/B;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB,KAAG,MAAM,GAAG,SAUZ,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EAAE,GAAG,SAAS,EAC5B,QAAQ,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,KACnC,OAWF,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EAC5C,UAAU,CAAC,EACX,YAAY,OAAO,CAAC,CAAC,CAAC,KACrB,CAUF,CAAC"}

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

@@ -0,0 +1,57 @@
+import { chartConfig as f } from "../config.js";
+import { isFiniteNumber as d } from "../utils/numbers.js";
+const { axis: l, emptyState: c } = f, g = ({
+  showXAxis: e,
+  showYAxis: t,
+  xAxisPosition: r,
+  yAxisPosition: n,
+  yAxisWidth: o
+}) => {
+  if (!e && !t)
+    return;
+  const i = o ?? l.defaultWidth;
+  return {
+    top: e && r === "top" ? l.defaultHeight : 0,
+    bottom: e && r === "bottom" ? l.defaultHeight : 0,
+    left: t && n === "start" ? i : 0,
+    right: t && n === "end" ? i : 0
+  };
+}, s = ({
+  loading: e,
+  hasData: t
+}) => ({
+  showPlaceholder: !t,
+  placeholderLoading: e && !t,
+  showEmptyOverlay: !e && !t,
+  isTransitionLoading: e && t
+}), p = ({
+  loading: e,
+  hasData: t,
+  emptyLabel: r
+}) => {
+  if (e)
+    return c.loadingAriaLabel;
+  if (!t)
+    return r;
+}, h = (e, t) => (e ?? []).some((r) => {
+  const n = r.data ?? [], o = t ? Math.min(n.length, t.length) : n.length;
+  let i = 0;
+  for (let a = 0; a < o; a++)
+    if (d(n[a]) && i++, i >= c.minDrawablePoints) return !0;
+  return !1;
+}), b = (e, t) => {
+  if (!t) return e;
+  const r = { ...e };
+  for (const n of Object.keys(t)) {
+    const o = t[n];
+    o !== void 0 && (r[n] = o);
+  }
+  return r;
+};
+export {
+  h as canRenderLine,
+  g as computeAxisPadding,
+  p as getChartAriaLabel,
+  s as getChartDisplayStates,
+  b as mergeDefaults
+};

package/dist/lib/Components/visualization/Point/Point.d.ts

@@ -0,0 +1,4 @@
+import { PointLabelProps, PointProps } from './types';
+export declare function PointLabel({ style, textAnchor, dominantBaseline, ...props }: Readonly<PointLabelProps>): import("react/jsx-runtime").JSX.Element;
+export declare const Point: import('react').NamedExoticComponent<Readonly<PointProps>>;
+//# sourceMappingURL=Point.d.ts.map

package/dist/lib/Components/visualization/Point/Point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Point.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Point/Point.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,eAAe,EAEf,UAAU,EACX,MAAM,SAAS,CAAC;AAKjB,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,UAAqB,EACrB,gBAAyB,EACzB,GAAG,KAAK,EACT,EAAE,QAAQ,CAAC,eAAe,CAAC,2CAe3B;AA+BD,eAAO,MAAM,KAAK,4DAwEhB,CAAC"}

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

@@ -0,0 +1,122 @@
+import { jsxs as A, jsx as l } from "react/jsx-runtime";
+import { memo as L } from "react";
+import { chartConfig as t } from "../config.js";
+import { usePointGeometry as S } from "./usePointGeometry.js";
+import { resolveLabel as W, computeLabelGeometry as G, buildArrowPoints as j } from "./utils.js";
+function w({
+  style: n,
+  textAnchor: o = "middle",
+  dominantBaseline: e = "auto",
+  ...i
+}) {
+  return /* @__PURE__ */ l(
+    "text",
+    {
+      textAnchor: o,
+      dominantBaseline: e,
+      style: {
+        fill: t.color.text,
+        fontSize: t.point.labelFontSize,
+        fontWeight: t.font.labelWeightMedium,
+        fontFamily: t.font.family,
+        ...n
+      },
+      ...i
+    }
+  );
+}
+function F({ x: n, y: o, size: e, color: i }) {
+  const c = e / 2, u = i ?? t.point.defaultColor;
+  return /* @__PURE__ */ l(
+    "circle",
+    {
+      "data-testid": "point-circle",
+      cx: n,
+      cy: o,
+      r: c,
+      style: {
+        fill: u,
+        stroke: t.color.markOutline
+      },
+      strokeWidth: t.strokeWidth.line
+    }
+  );
+}
+function M({ x: n, y: o, size: e, position: i }) {
+  return /* @__PURE__ */ l(
+    "polygon",
+    {
+      "data-testid": "point-arrow",
+      points: j(n, o, e / 2, i),
+      style: { fill: t.color.text }
+    }
+  );
+}
+const Y = L(function({
+  dataX: o,
+  dataY: e,
+  color: i,
+  label: c,
+  LabelComponent: u,
+  labelPosition: m = "top",
+  hidePoint: y = !1,
+  showLabelArrow: p = !0,
+  size: f = t.point.defaultSize,
+  onClick: x,
+  magnetic: b = !1,
+  labelAlignment: g = "auto"
+}) {
+  const { pixel: r, drawingArea: h, revealStyle: P, isVisible: k } = S({
+    dataX: o,
+    dataY: e,
+    magnetic: b
+  });
+  if (!k || !r)
+    return null;
+  const a = W(c, o), d = a !== void 0, s = d ? G({
+    text: a,
+    pixelX: r.x,
+    pixelY: r.y,
+    size: f,
+    labelPosition: m,
+    showLabelArrow: p,
+    area: h,
+    alignment: g
+  }) : null, v = u ?? w;
+  return /* @__PURE__ */ A(
+    "g",
+    {
+      "data-testid": "point-group",
+      onClick: x,
+      style: {
+        ...P,
+        ...x ? { cursor: "pointer" } : void 0
+      },
+      children: [
+        !y && /* @__PURE__ */ l(F, { x: r.x, y: r.y, size: f, color: i }),
+        d && p && /* @__PURE__ */ l(
+          M,
+          {
+            x: r.x,
+            y: r.y,
+            size: f,
+            position: m
+          }
+        ),
+        a != null && s && /* @__PURE__ */ l(
+          v,
+          {
+            x: s.x,
+            y: s.y,
+            textAnchor: s.textAnchor,
+            children: a
+          }
+        )
+      ]
+    }
+  );
+});
+export {
+  Y as Point,
+  w as PointLabel
+};

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

@@ -0,0 +1,3 @@
+export { Point, PointLabel } from './Point';
+export type { PointLabelComponent, PointLabelProps, PointProps } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Point/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/lib/Components/visualization/Point/pointContext/MagneticPointsProvider.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from 'react';
+type MagneticPointsProviderProps = {
+    children: ReactNode;
+};
+export declare function MagneticPointsProvider({ children, }: Readonly<MagneticPointsProviderProps>): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=MagneticPointsProvider.d.ts.map

package/dist/lib/Components/visualization/Point/pointContext/MagneticPointsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MagneticPointsProvider.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/Point/pointContext/MagneticPointsProvider.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,KAAK,2BAA2B,GAAG;IACjC,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,EACrC,QAAQ,GACT,EAAE,QAAQ,CAAC,2BAA2B,CAAC,2CAqCvC"}

package/dist/lib/Components/visualization/Point/pointContext/MagneticPointsProvider.js

@@ -0,0 +1,22 @@
+import { jsx as a } from "react/jsx-runtime";
+import { useRef as l, useState as v, useCallback as n, useMemo as g } from "react";
+import { MagneticRegistryProvider as h, MagneticSnapshotProvider as M } from "./magneticPointsContext.js";
+function S({
+  children: f
+}) {
+  const e = l(/* @__PURE__ */ new Set()), [s, o] = v(0), i = n((r) => {
+    e.current.has(r) || (e.current.add(r), o((t) => t + 1));
+  }, []), c = n((r) => {
+    e.current.has(r) && (e.current.delete(r), o((t) => t + 1));
+  }, []), u = n(() => e.current, []), m = g(
+    () => ({ register: i, unregister: c }),
+    [i, c]
+  ), p = g(
+    () => ({ version: s, getMagneticPoints: u }),
+    [s, u]
+  );
+  return /* @__PURE__ */ a(h, { value: m, children: /* @__PURE__ */ a(M, { value: p, children: f }) });
+}
+export {
+  S as MagneticPointsProvider
+};

package/dist/lib/Components/visualization/Point/pointContext/index.d.ts

@@ -0,0 +1,3 @@
+export { useMagneticRegistry, useMagneticSnapshot, type MagneticRegistryValue, type MagneticSnapshotValue, } from './magneticPointsContext';
+export { MagneticPointsProvider } from './MagneticPointsProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/Components/visualization/Point/pointContext/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/Point/pointContext/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/lib/Components/visualization/Point/pointContext/magneticPointsContext.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Stable registration API for magnetic points. Its identity never changes for
+ * the provider's lifetime, so consumers (every `Point`) do not re-render when
+ * the magnetic set changes — only when they mount/unmount.
+ */
+export type MagneticRegistryValue = {
+    register: (dataIndex: number) => void;
+    unregister: (dataIndex: number) => void;
+};
+/**
+ * Mutable snapshot of the registered magnetic points. Changes on every
+ * register/unregister (via `version`) and is consumed only by the scrubber,
+ * which needs to recompute its snap targets when the set changes.
+ */
+export type MagneticSnapshotValue = {
+    version: number;
+    getMagneticPoints: () => ReadonlySet<number>;
+};
+declare const MagneticRegistryProvider: import('react').FC<{
+    children: import('react').ReactNode;
+    value: MagneticRegistryValue;
+}>;
+declare const MagneticSnapshotProvider: import('react').FC<{
+    children: import('react').ReactNode;
+    value: MagneticSnapshotValue;
+}>;
+export declare const useMagneticRegistry: () => MagneticRegistryValue;
+export declare const useMagneticSnapshot: () => MagneticSnapshotValue;
+export { MagneticRegistryProvider, MagneticSnapshotProvider };
+//# sourceMappingURL=magneticPointsContext.d.ts.map

package/dist/lib/Components/visualization/Point/pointContext/magneticPointsContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magneticPointsContext.d.ts","sourceRoot":"","sources":["../../../../../../src/lib/Components/visualization/Point/pointContext/magneticPointsContext.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;CAC9C,CAAC;AAEF,QAAA,MAAO,wBAAwB;;;EAC+B,CAAC;AAE/D,QAAA,MAAO,wBAAwB;;;EAC+B,CAAC;AAE/D,eAAO,MAAM,mBAAmB,QAAO,qBAInC,CAAC;AAEL,eAAO,MAAM,mBAAmB,QAAO,qBAInC,CAAC;AAEL,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/lib/Components/visualization/Point/pointContext/magneticPointsContext.js

@@ -0,0 +1,14 @@
+import { createSafeContext as e } from "../../../../../libs/utils-shared/dist/index.js";
+const [a, t] = e("MagneticRegistry"), [o, n] = e("MagneticSnapshot"), i = () => t({
+  consumerName: "useMagneticRegistry",
+  contextRequired: !0
+}), c = () => n({
+  consumerName: "useMagneticSnapshot",
+  contextRequired: !0
+});
+export {
+  a as MagneticRegistryProvider,
+  o as MagneticSnapshotProvider,
+  i as useMagneticRegistry,
+  c as useMagneticSnapshot
+};

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

@@ -0,0 +1,110 @@
+import { ComponentType, MouseEvent, SVGProps } from 'react';
+export type PointLabelProps = {
+    x: number;
+    y: number;
+    children: string;
+} & Omit<SVGProps<SVGTextElement>, 'x' | 'y' | 'children'>;
+export type PointLabelComponent = ComponentType<PointLabelProps>;
+/**
+ * Horizontal alignment strategy for a point's label.
+ *
+ * - `'auto'`: keep the label inside the drawing area, anchoring it to the
+ *   nearest edge when it would overflow.
+ * - `'center'`: always centre the label on the point.
+ */
+export type LabelAlignment = 'center' | 'auto';
+/**
+ * Pixel position and styling inputs shared by the point's rendered glyphs. Each
+ * glyph picks the subset it needs and derives its own pixel geometry (e.g.
+ * radius from `size`).
+ */
+type PointGlyphProps = {
+    x: number;
+    y: number;
+    size: number;
+    color?: string;
+    position: 'top' | 'bottom';
+};
+export type PointMarkerProps = Pick<PointGlyphProps, 'x' | 'y' | 'size' | 'color'>;
+export type PointArrowProps = Pick<PointGlyphProps, 'x' | 'y' | 'size' | 'position'>;
+export type PointProps = {
+    /**
+     * X coordinate in data space (index or explicit value).
+     */
+    dataX: number;
+    /**
+     * Y coordinate in data space.
+     */
+    dataY: number;
+    /**
+     * Fill color of the point circle.
+     * Defaults to `var(--background-muted-strong)`.
+     *
+     * Use the `cssVar` helper from `@ledgerhq/lumen-design-core` to
+     * resolve a design-token CSS variable at runtime:
+     *
+     * @example
+     * ```tsx
+     * import { cssVar } from '@ledgerhq/lumen-design-core';
+     *
+     * <Point dataX={0} dataY={42} color={cssVar('var(--background-error-strong)')} />
+     * ```
+     */
+    color?: string;
+    /**
+     * Text label displayed near the point.
+     * A string is rendered directly; a function receives `dataX` and returns
+     * the label string, enabling index-based formatting.
+     */
+    label?: string | ((dataIndex: number) => string);
+    /**
+     * Custom component rendered instead of the default `PointLabel`.
+     * Receives pixel coordinates (`x`, `y`) and the resolved label as
+     * `children`. Use `PointLabel` inside your component to retain
+     * design-token styling while customising layout or appearance.
+     */
+    LabelComponent?: PointLabelComponent;
+    /**
+     * Placement of the label relative to the point.
+     * @default 'top'
+     */
+    labelPosition?: 'top' | 'bottom';
+    /**
+     * When `true`, the point circle is hidden but the label (if any) is still rendered.
+     * @default false
+     */
+    hidePoint?: boolean;
+    /**
+     * Diameter of the point circle in pixels.
+     * Internally converted to an SVG radius (`size / 2`).
+     * @default 10
+     */
+    size?: number;
+    /**
+     * When `true`, an arrow is displayed pointing from the point to the label.
+     * @default true
+     */
+    showLabelArrow?: boolean;
+    /**
+     * Called when the point is clicked.
+     */
+    onClick?: (event: MouseEvent<SVGGElement>) => void;
+    /**
+     * When `true`, the scrubber magnetically snaps to this point within the
+     * chart's `magnetRadius`. Requires `enableScrubbing` to be set on the
+     * parent chart.
+     * @default false
+     */
+    magnetic?: boolean;
+    /**
+     * Horizontal alignment of the label relative to the chart's drawing area.
+     * With `'auto'`, a label that would overflow the left/right edge is anchored
+     * to that edge and grows inward instead of being clipped, while the arrow
+     * keeps pointing at the exact data point. Use `'center'` to always centre the
+     * label on the point.
+     * @default 'auto'
+     */
+    labelAlignment?: LabelAlignment;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/Components/visualization/Point/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Point/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG;IAC5B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC;AAE3D,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAC,eAAe,CAAC,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE/C;;;;GAIG;AACH,KAAK,eAAe,GAAG;IACrB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,eAAe,EACf,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,OAAO,CAC7B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,eAAe,EACf,GAAG,GAAG,GAAG,GAAG,MAAM,GAAG,UAAU,CAChC,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACjD;;;;;OAKG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC,CAAC"}

package/dist/lib/Components/visualization/Point/usePointGeometry.d.ts

@@ -0,0 +1,33 @@
+import { CSSProperties } from 'react';
+import { BaseAxisProps } from '../Axis';
+import { DrawingArea } from '../utils/types';
+import { MagneticRegistryValue } from './pointContext/magneticPointsContext';
+type Pixel = {
+    x: number;
+    y: number;
+};
+type UsePointGeometryParams = {
+    dataX: number;
+    dataY: number;
+    magnetic: boolean;
+};
+type PointGeometry = {
+    pixel: Pixel | undefined;
+    drawingArea: DrawingArea;
+    revealStyle: CSSProperties | undefined;
+    isVisible: boolean;
+};
+/**
+ * Resolves a point's chart geometry and behaviour: projects its data
+ * coordinates to pixels, registers it as a magnetic snap target when enabled,
+ * exposes the reveal-animation style, and reports whether it falls inside the
+ * drawing area.
+ */
+export declare const usePointGeometry: ({ dataX, dataY, magnetic, }: UsePointGeometryParams) => PointGeometry;
+/**
+ * Registers/unregisters a data index as a magnetic snap target
+ * when the Point has `magnetic` enabled.
+ */
+export declare const useMagneticRegistration: (magnetic: boolean, dataX: number, getXAxisConfig: () => BaseAxisProps | undefined, { register, unregister }: MagneticRegistryValue) => void;
+export {};
+//# sourceMappingURL=usePointGeometry.d.ts.map

package/dist/lib/Components/visualization/Point/usePointGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePointGeometry.d.ts","sourceRoot":"","sources":["../../../../../src/lib/Components/visualization/Point/usePointGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,OAAO,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAGlF,KAAK,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC,KAAK,sBAAsB,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,WAAW,EAAE,aAAa,GAAG,SAAS,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAAI,6BAI9B,sBAAsB,KAAG,aAqB3B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,OAAO,EACjB,OAAO,MAAM,EACb,gBAAgB,MAAM,aAAa,GAAG,SAAS,EAC/C,0BAA0B,qBAAqB,KAC9C,IAQF,CAAC"}