panelui-native 0.7.0 → 0.9.0

package/lib/module/components/line-chart/index.js

@@ -0,0 +1,1024 @@
+"use strict";
+
+/**
+ * LineChart — a time series, drawn and animated on the UI thread.
+ *
+ * The chart is composed rather than configured: the grid, each series, the
+ * axis and the crosshair are separate children, so a chart that wants no grid
+ * simply does not have one. A single component with twenty booleans is how
+ * charts end up unreadable at the call site.
+ *
+ * ```tsx
+ * <LineChart data={visits} xDataKey="date">
+ *   <LineChart.Grid />
+ *   <LineChart.Area dataKey="visits" />
+ *   <LineChart.Line dataKey="visits" />
+ *   <LineChart.XAxis />
+ *   <LineChart.Tooltip />
+ * </LineChart>
+ * ```
+ *
+ * Internally there are two layers, and the parts sort themselves into the
+ * right one: the geometry is SVG, and anything with text or a gesture on it is
+ * a React Native view laid over the top. That split is not a detail — SVG text
+ * ignores the platform's text scaling and the theme's font, and a gesture
+ * handler cannot be attached to an SVG node at all.
+ *
+ * Three things animate, each for a different reason:
+ *
+ * - **The reveal.** On mount the plot is uncovered left to right by an animated
+ *   clip rectangle. Everything inside shares that clip, so the line, its fill
+ *   and its markers arrive together rather than as three separate effects.
+ * - **The y-domain.** When the data changes the *scale* is tweened rather than
+ *   the path swapped, so a series that grows is redrawn against a moving axis
+ *   instead of jumping to a new shape. The reveal does not replay — it happened
+ *   once, and repeating it on every refresh turns a data update into an
+ *   animation.
+ * - **The crosshair.** A drag resolves the nearest index on the UI thread and
+ *   moves the line and the dots from there. Only the index crosses back into
+ *   JS, and only when it changes, so a drag costs a handful of re-renders
+ *   rather than one per frame.
+ *
+ * Colours come from the `--color-chart-*` tokens, so a chart follows the active
+ * theme and is put on brand by overriding those five in the app's own
+ * global.css. Nothing here hardcodes a hex.
+ */
+import { Children, createContext, forwardRef, isValidElement, useContext, useEffect, useImperativeHandle, useMemo, useRef, useState } from 'react';
+import { StyleSheet, View } from 'react-native';
+import { Gesture, GestureDetector } from 'react-native-gesture-handler';
+import Animated, { cancelAnimation, Easing, runOnJS, useAnimatedProps, useAnimatedStyle, useReducedMotion, useSharedValue, withRepeat, withTiming } from 'react-native-reanimated';
+import Svg, { Circle, ClipPath, Defs, G, Line as SvgLine, LinearGradient, Path, Rect, Stop } from 'react-native-svg';
+import { useCSSVariable } from 'uniwind';
+import { Text } from "../../primitives/text.js";
+import { cn } from "../../utils/cn.js";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+const AnimatedPath = Animated.createAnimatedComponent(Path);
+const AnimatedRect = Animated.createAnimatedComponent(Rect);
+const AnimatedCircle = Animated.createAnimatedComponent(Circle);
+const AnimatedLinearGradient = Animated.createAnimatedComponent(LinearGradient);
+
+/** Room left around the plot for the axis labels and the marker rings. */
+const PADDING = {
+  top: 12,
+  right: 10,
+  bottom: 22,
+  left: 10
+};
+
+/**
+ * Which layer a part belongs to. Read off the component itself, so composition
+ * stays a flat list of children instead of two nested slots the caller has to
+ * remember the order of.
+ */
+
+const LineChartContext = /*#__PURE__*/createContext(null);
+function useChart(component) {
+  const context = useContext(LineChartContext);
+  if (!context) {
+    throw new Error(`${component} must be used within a <LineChart>`);
+  }
+  return context;
+}
+
+/**
+ * The point under the crosshair, for something rendered *inside* the chart.
+ *
+ * A readout usually belongs in the card's header, which is outside this
+ * provider — use `onActiveIndexChange` for that. A hook cannot reach up out of
+ * the subtree it is called in, and pretending otherwise is how a component
+ * ends up with a context that has to wrap half the screen.
+ */
+export function useLineChart() {
+  const {
+    data,
+    activeIndexJS,
+    xDataKey
+  } = useChart('useLineChart');
+  return {
+    activeIndex: activeIndexJS,
+    activePoint: activeIndexJS >= 0 ? data[activeIndexJS] ?? null : null,
+    xDataKey
+  };
+}
+
+/** Imperative handle: re-run the reveal on demand, for a "replay" control. */
+
+const LineChartRoot = /*#__PURE__*/forwardRef(function LineChartRoot({
+  className,
+  data,
+  xDataKey = 'date',
+  status = 'ready',
+  aspectRatio = 2,
+  animationDuration = 1100,
+  domainDuration = 500,
+  yDomain,
+  curve = 'monotone',
+  onActiveIndexChange,
+  compact = false,
+  children,
+  ...props
+}, ref) {
+  const [size, setSize] = useState({
+    width: 0,
+    height: 0
+  });
+  const [series, setSeries] = useState([]);
+  const [activeIndexJS, setActiveIndexJS] = useState(-1);
+  const clipId = useRef(`panelui-clip-${Math.random().toString(36).slice(2, 9)}`).current;
+  const reveal = useSharedValue(0);
+  const domainMin = useSharedValue(0);
+  const domainMax = useSharedValue(0);
+  const activeIndex = useSharedValue(-1);
+  const reducedMotion = useReducedMotion();
+  const registerSeries = useMemo(() => (key, color) => setSeries(current => {
+    const existing = current.find(([k]) => k === key);
+    if (existing?.[1] === color) return current;
+    return [...current.filter(([k]) => k !== key), [key, color]];
+  }), []);
+  const unregisterSeries = useMemo(() => key => setSeries(current => current.filter(([k]) => k !== key)), []);
+
+  // A sparkline has no axis or grid to leave room for, so the line reaches the
+  // edges; a stroke of a couple of pixels still needs a hair of inset not to be
+  // clipped at the very top and bottom.
+  const pad = compact ? {
+    top: 2,
+    right: 1,
+    bottom: 2,
+    left: 1
+  } : PADDING;
+  const plot = {
+    left: pad.left,
+    top: pad.top,
+    width: Math.max(size.width - pad.left - pad.right, 0),
+    height: Math.max(size.height - pad.top - pad.bottom, 0)
+  };
+
+  // One extent across every registered series, so two series share one axis
+  // and stay comparable — a per-series scale makes them look alike when they
+  // are orders of magnitude apart.
+  const seriesKeys = series.map(([key]) => key).join('|');
+  const extent = useMemo(() => {
+    if (yDomain) return yDomain;
+    const keys = seriesKeys ? seriesKeys.split('|') : [];
+    let min = Infinity;
+    let max = -Infinity;
+    for (const row of data) {
+      for (const key of keys) {
+        const value = row[key];
+        if (typeof value !== 'number' || Number.isNaN(value)) continue;
+        if (value < min) min = value;
+        if (value > max) max = value;
+      }
+    }
+    if (min === Infinity) return [0, 1];
+    // A flat series has no extent of its own; give it one so it lands on the
+    // middle of the plot instead of dividing by zero.
+    if (min === max) return [min - 1, max + 1];
+    // A little headroom, so the peak is not welded to the top edge.
+    const pad = (max - min) * 0.1;
+    return [min - pad, max + pad];
+  }, [data, yDomain, seriesKeys]);
+  const loading = status === 'loading';
+  useEffect(() => {
+    if (loading) return;
+    const [min, max] = extent;
+    // The first domain lands without a tween: there is no previous scale to
+    // move from, and animating up from zero reads as the numbers changing.
+    const first = domainMin.value === 0 && domainMax.value === 0;
+    if (first || reducedMotion) {
+      domainMin.value = min;
+      domainMax.value = max;
+      return;
+    }
+    domainMin.value = withTiming(min, {
+      duration: domainDuration
+    });
+    domainMax.value = withTiming(max, {
+      duration: domainDuration
+    });
+  }, [extent, loading, reducedMotion, domainDuration, domainMin, domainMax]);
+
+  // Plays once, when there is both a plot to reveal and data to reveal in it.
+  const revealed = useRef(false);
+  const playReveal = useMemo(() => () => {
+    if (reducedMotion) {
+      reveal.value = 1;
+      return;
+    }
+    reveal.value = 0;
+    reveal.value = withTiming(1, {
+      duration: animationDuration,
+      easing: Easing.bezier(0.85, 0, 0.15, 1)
+    });
+  }, [reducedMotion, animationDuration, reveal]);
+  useEffect(() => {
+    if (revealed.current || loading || plot.width <= 0 || !data.length) return;
+    revealed.current = true;
+    playReveal();
+  }, [loading, plot.width, data.length, playReveal]);
+
+  // `replay()` re-runs the reveal — for a control the caller wires up.
+  useImperativeHandle(ref, () => ({
+    replay: playReveal
+  }), [playReveal]);
+  const clipProps = useAnimatedProps(() => ({
+    width: plot.width * reveal.value
+  }));
+
+  // One place the crosshair index lands, so the chart's own children and a
+  // readout outside it never disagree about which point is active.
+  const handleActiveIndex = useMemo(() => index => {
+    setActiveIndexJS(index);
+    onActiveIndexChange?.(index, index >= 0 ? data[index] ?? null : null);
+  }, [onActiveIndexChange, data]);
+  const onLayout = event => {
+    const {
+      width,
+      height
+    } = event.nativeEvent.layout;
+    setSize(current => Math.abs(current.width - width) < 1 && Math.abs(current.height - height) < 1 ? current : {
+      width,
+      height
+    });
+    props.onLayout?.(event);
+  };
+  const context = useMemo(() => ({
+    data,
+    xDataKey,
+    plot,
+    status,
+    curve,
+    series,
+    registerSeries,
+    unregisterSeries,
+    domainMin,
+    domainMax,
+    activeIndex,
+    activeIndexJS,
+    setActiveIndexJS: handleActiveIndex,
+    clipId
+  }),
+  // `plot` is rebuilt every render from `size`, so it is compared by value.
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [data, xDataKey, plot.width, plot.height, plot.left, plot.top, status, curve, series, registerSeries, unregisterSeries, domainMin, domainMax, activeIndex, activeIndexJS, handleActiveIndex, clipId]);
+  const {
+    svg,
+    overlay
+  } = partition(children);
+  return /*#__PURE__*/_jsx(LineChartContext.Provider, {
+    value: context,
+    children: /*#__PURE__*/_jsx(View, {
+      ...props,
+      onLayout: onLayout,
+      style: [{
+        aspectRatio
+      }, props.style],
+      className: cn('w-full', className),
+      children: plot.width > 0 ? /*#__PURE__*/_jsxs(_Fragment, {
+        children: [/*#__PURE__*/_jsxs(Svg, {
+          width: "100%",
+          height: "100%",
+          style: StyleSheet.absoluteFill,
+          children: [/*#__PURE__*/_jsx(Defs, {
+            children: /*#__PURE__*/_jsx(ClipPath, {
+              id: clipId,
+              children: /*#__PURE__*/_jsx(AnimatedRect, {
+                x: plot.left,
+                y: 0,
+                height: size.height,
+                animatedProps: clipProps
+              })
+            })
+          }), svg]
+        }), overlay]
+      }) : null
+    })
+  });
+});
+LineChartRoot.displayName = 'LineChart';
+
+/** Sorts the children into the SVG tree and the view layer over it. */
+function partition(children) {
+  const svg = [];
+  const overlay = [];
+  Children.forEach(children, (child, index) => {
+    if (! /*#__PURE__*/isValidElement(child)) return;
+    const layer = child.type.layer ?? 'svg';
+    (layer === 'overlay' ? overlay : svg).push(
+    /*#__PURE__*/
+    // Children of a `Children.forEach` need keys of their own once they are
+    // put into a new array.
+    _jsx(ChildSlot, {
+      children: child
+    }, index));
+  });
+  return {
+    svg,
+    overlay
+  };
+}
+
+/** Identity wrapper, purely so the partitioned arrays can carry keys. */
+function ChildSlot({
+  children
+}) {
+  return /*#__PURE__*/_jsx(_Fragment, {
+    children: children
+  });
+}
+
+/* -------------------------------------------------------------------------- */
+/* SVG layer                                                                  */
+/* -------------------------------------------------------------------------- */
+
+/** Horizontal reference lines. Drawn under everything, outside the reveal clip. */
+function LineChartGrid({
+  rows = 4,
+  color,
+  dashArray = '4,6',
+  opacity = 1
+}) {
+  const {
+    plot
+  } = useChart('LineChart.Grid');
+  const token = useCSSVariable('--color-border');
+  const stroke = color ?? (typeof token === 'string' ? token : 'rgba(128,128,128,0.2)');
+  return /*#__PURE__*/_jsx(G, {
+    opacity: opacity,
+    children: Array.from({
+      length: rows + 1
+    }, (_, index) => {
+      const y = plot.top + plot.height / rows * index;
+      return /*#__PURE__*/_jsx(SvgLine, {
+        x1: plot.left,
+        x2: plot.left + plot.width,
+        y1: y,
+        y2: y,
+        stroke: stroke,
+        strokeWidth: 1,
+        strokeDasharray: dashArray
+      }, index);
+    })
+  });
+}
+LineChartGrid.displayName = 'LineChart.Grid';
+LineChartGrid.layer = 'svg';
+/** One series. */
+function LineChartLine({
+  dataKey,
+  color,
+  colorIndex = 1,
+  strokeWidth = 2.5,
+  dashArray,
+  showMarkers = false
+}) {
+  const {
+    data,
+    plot,
+    domainMin,
+    domainMax,
+    curve,
+    status,
+    registerSeries,
+    unregisterSeries,
+    clipId
+  } = useChart('LineChart.Line');
+  const stroke = useSeriesColor(color, colorIndex);
+  useEffect(() => {
+    registerSeries(dataKey, stroke);
+    return () => unregisterSeries(dataKey);
+  }, [dataKey, stroke, registerSeries, unregisterSeries]);
+  const values = useMemo(() => numbersOf(data, dataKey), [data, dataKey]);
+  const loading = status === 'loading';
+  const animatedProps = useAnimatedProps(() => ({
+    d: linePath(values, plot, domainMin.value, domainMax.value, curve, loading)
+  }));
+  return /*#__PURE__*/_jsxs(G, {
+    clipPath: `url(#${clipId})`,
+    children: [/*#__PURE__*/_jsx(AnimatedPath, {
+      animatedProps: animatedProps,
+      fill: "none",
+      stroke: loading ? 'transparent' : stroke,
+      strokeWidth: strokeWidth,
+      strokeDasharray: dashArray,
+      strokeLinecap: "round",
+      strokeLinejoin: "round"
+    }), showMarkers && !loading ? values.map((value, index) => value === null ? null : /*#__PURE__*/_jsx(PointMarker, {
+      index: index,
+      total: values.length,
+      value: value,
+      plot: plot,
+      domainMin: domainMin,
+      domainMax: domainMax,
+      color: stroke
+    }, index)) : null]
+  });
+}
+LineChartLine.displayName = 'LineChart.Line';
+LineChartLine.layer = 'svg';
+
+/** A dot at one point. Follows the y-domain tween exactly as the line does. */
+function PointMarker({
+  index,
+  total,
+  value,
+  plot,
+  domainMin,
+  domainMax,
+  color
+}) {
+  const animatedProps = useAnimatedProps(() => ({
+    cy: yOf(value, plot, domainMin.value, domainMax.value)
+  }));
+  return /*#__PURE__*/_jsx(AnimatedCircle, {
+    animatedProps: animatedProps,
+    cx: xOf(index, total, plot),
+    r: 3,
+    fill: color
+  });
+}
+/**
+ * The fill under a series. A separate child from the line, because a chart with
+ * two series usually wants the fill on only one of them — two translucent
+ * fills over each other make a third colour that means nothing.
+ */
+function LineChartArea({
+  dataKey,
+  color,
+  colorIndex = 1,
+  opacity = 0.18
+}) {
+  const {
+    data,
+    plot,
+    domainMin,
+    domainMax,
+    curve,
+    status,
+    clipId
+  } = useChart('LineChart.Area');
+  const fill = useSeriesColor(color, colorIndex);
+  const gradientId = useRef(`panelui-area-${Math.random().toString(36).slice(2, 9)}`).current;
+  const values = useMemo(() => numbersOf(data, dataKey), [data, dataKey]);
+  const loading = status === 'loading';
+  const animatedProps = useAnimatedProps(() => ({
+    d: areaPath(values, plot, domainMin.value, domainMax.value, curve, loading)
+  }));
+  return /*#__PURE__*/_jsxs(G, {
+    clipPath: `url(#${clipId})`,
+    children: [/*#__PURE__*/_jsx(Defs, {
+      children: /*#__PURE__*/_jsxs(LinearGradient, {
+        id: gradientId,
+        x1: "0",
+        y1: "0",
+        x2: "0",
+        y2: "1",
+        children: [/*#__PURE__*/_jsx(Stop, {
+          offset: "0",
+          stopColor: fill,
+          stopOpacity: opacity
+        }), /*#__PURE__*/_jsx(Stop, {
+          offset: "1",
+          stopColor: fill,
+          stopOpacity: 0
+        })]
+      })
+    }), /*#__PURE__*/_jsx(AnimatedPath, {
+      animatedProps: animatedProps,
+      fill: `url(#${gradientId})`,
+      stroke: "none"
+    })]
+  });
+}
+LineChartArea.displayName = 'LineChart.Area';
+LineChartArea.layer = 'svg';
+/**
+ * The loading state: a flat rule where the series will be, with a highlight
+ * travelling along it. Drawn inside the same SVG rather than as an overlay, so
+ * arriving data is one tree changing rather than one view replacing another —
+ * which is what lets the flat line become the series instead of cutting to it.
+ */
+function LineChartSkeleton({
+  duration = 1400,
+  color
+}) {
+  const {
+    plot,
+    status
+  } = useChart('LineChart.Skeleton');
+  const token = useCSSVariable('--color-skeleton');
+  const base = color ?? (typeof token === 'string' ? token : 'rgba(128,128,128,0.2)');
+  const highlight = useSeriesColor(undefined, 1);
+  const sweep = useSharedValue(0);
+  const reducedMotion = useReducedMotion();
+  const loading = status === 'loading';
+  useEffect(() => {
+    if (!loading || reducedMotion) {
+      cancelAnimation(sweep);
+      sweep.value = 0;
+      return;
+    }
+    sweep.value = 0;
+    sweep.value = withRepeat(withTiming(1, {
+      duration,
+      easing: Easing.linear
+    }), -1, false);
+    return () => cancelAnimation(sweep);
+  }, [loading, reducedMotion, duration, sweep]);
+
+  // The band travels by moving the gradient's own endpoints, so the whole
+  // effect is two numbers changing on the UI thread.
+  const animatedProps = useAnimatedProps(() => ({
+    x1: `${(sweep.value * 1.4 - 0.4) * 100}%`,
+    x2: `${(sweep.value * 1.4 - 0.4 + 0.4) * 100}%`
+  }));
+  if (!loading) return null;
+  const y = plot.top + plot.height / 2;
+  const gradientId = 'panelui-chart-skeleton';
+  return /*#__PURE__*/_jsxs(G, {
+    children: [/*#__PURE__*/_jsx(Defs, {
+      children: /*#__PURE__*/_jsxs(AnimatedLinearGradient, {
+        id: gradientId,
+        animatedProps: animatedProps,
+        y1: "0",
+        y2: "0",
+        children: [/*#__PURE__*/_jsx(Stop, {
+          offset: "0",
+          stopColor: base
+        }), /*#__PURE__*/_jsx(Stop, {
+          offset: "0.5",
+          stopColor: highlight,
+          stopOpacity: 0.55
+        }), /*#__PURE__*/_jsx(Stop, {
+          offset: "1",
+          stopColor: base
+        })]
+      })
+    }), /*#__PURE__*/_jsx(SvgLine, {
+      x1: plot.left,
+      x2: plot.left + plot.width,
+      y1: y,
+      y2: y,
+      stroke: `url(#${gradientId})`,
+      strokeWidth: 2.5,
+      strokeLinecap: "round"
+    })]
+  });
+}
+LineChartSkeleton.displayName = 'LineChart.Skeleton';
+LineChartSkeleton.layer = 'svg';
+
+/* -------------------------------------------------------------------------- */
+/* Overlay layer                                                              */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * The x labels. Real text rather than SVG text, so they follow the theme's font
+ * and the platform's text scaling — SVG text does neither.
+ */
+function LineChartXAxis({
+  ticks = 4,
+  format,
+  className
+}) {
+  const {
+    data,
+    xDataKey,
+    plot
+  } = useChart('LineChart.XAxis');
+  const labels = useMemo(() => {
+    if (!data.length) return [];
+    const count = Math.min(ticks, data.length);
+    const step = count > 1 ? (data.length - 1) / (count - 1) : 0;
+    return Array.from({
+      length: count
+    }, (_, index) => {
+      const dataIndex = Math.round(index * step);
+      const datum = data[dataIndex];
+      if (!datum) return null;
+      return {
+        key: dataIndex,
+        text: format ? format(datum, dataIndex) : String(datum[xDataKey] ?? '')
+      };
+    }).filter(label => label !== null);
+  }, [data, ticks, format, xDataKey]);
+  return /*#__PURE__*/_jsx(View, {
+    pointerEvents: "none",
+    style: {
+      position: 'absolute',
+      left: plot.left,
+      right: PADDING.right,
+      bottom: 0,
+      height: PADDING.bottom
+    },
+    className: cn('flex-row items-center justify-between', className),
+    children: labels.map(label => /*#__PURE__*/_jsx(Text, {
+      size: "xs",
+      muted: true,
+      children: label.text
+    }, label.key))
+  });
+}
+LineChartXAxis.displayName = 'LineChart.XAxis';
+LineChartXAxis.layer = 'overlay';
+/**
+ * The crosshair, the gesture that drives it, and the label that rides it.
+ *
+ * They live in the view layer: a gesture handler cannot be attached to an SVG
+ * node, and once the gesture is a view the crosshair may as well be one too —
+ * a 1px view moved by `translateX` costs less than re-rendering an SVG line.
+ * The label follows on the UI thread the same way; only its *text* crosses back
+ * into JS, and only when the active index changes.
+ *
+ * The hit area is the whole plot. A crosshair you have to land on the line to
+ * summon is a crosshair nobody finds.
+ */
+function LineChartTooltip({
+  color,
+  showLabel = true,
+  formatValue,
+  formatX
+}) {
+  const {
+    data,
+    xDataKey,
+    plot,
+    domainMin,
+    domainMax,
+    series,
+    activeIndex,
+    activeIndexJS,
+    setActiveIndexJS,
+    status
+  } = useChart('LineChart.Tooltip');
+  const token = useCSSVariable('--color-foreground');
+  const stroke = color ?? (typeof token === 'string' ? token : '#888888');
+  const total = data.length;
+  const left = plot.left;
+  const width = plot.width;
+
+  /*
+   * Built in one closure, and everything it captures is a number or a shared
+   * value. A worklet may only call another worklet, and the rule is enforced by
+   * crashing the app rather than by warning — so the resolver is declared here,
+   * next to its callers, instead of as a helper further down the file where it
+   * would be easy to leave un-workletised.
+   */
+  const pan = useMemo(() => {
+    const resolve = x => {
+      'worklet';
+
+      if (total < 2 || width <= 0) return;
+      const ratio = (x - left) / width;
+      const next = Math.round(Math.min(1, Math.max(0, ratio)) * (total - 1));
+      if (next === activeIndex.value) return;
+      activeIndex.value = next;
+      // Only the index needs JS, and only when it changes — a drag across a
+      // hundred points costs a hundred re-renders at most, not one per frame
+      // for the length of the gesture.
+      runOnJS(setActiveIndexJS)(next);
+    };
+    return Gesture.Pan().minDistance(0).onBegin(event => {
+      'worklet';
+
+      resolve(event.x);
+    }).onUpdate(event => {
+      'worklet';
+
+      resolve(event.x);
+    }).onFinalize(() => {
+      'worklet';
+
+      activeIndex.value = -1;
+      runOnJS(setActiveIndexJS)(-1);
+    });
+  }, [total, left, width, activeIndex, setActiveIndexJS]);
+  const crosshairStyle = useAnimatedStyle(() => {
+    const index = activeIndex.value;
+    return {
+      opacity: index < 0 ? 0 : 0.45,
+      transform: [{
+        translateX: index < 0 ? 0 : xOf(index, total, plot)
+      }]
+    };
+  });
+
+  // The label centres over the crosshair but is clamped inside the plot, so it
+  // never runs off the edge at the first or last point.
+  const labelStyle = useAnimatedStyle(() => {
+    const index = activeIndex.value;
+    if (index < 0) return {
+      opacity: 0
+    };
+    const x = xOf(index, total, plot);
+    const half = LABEL_WIDTH / 2;
+    const clamped = Math.min(plot.left + plot.width - half, Math.max(plot.left + half, x));
+    return {
+      opacity: 1,
+      transform: [{
+        translateX: clamped - half
+      }]
+    };
+  });
+  const active = activeIndexJS >= 0 ? data[activeIndexJS] : null;
+  const fmtValue = formatValue ?? (value => compactNumber(value));
+  const fmtX = formatX ?? (datum => String(datum[xDataKey] ?? ''));
+  if (status === 'loading') return null;
+  return /*#__PURE__*/_jsx(GestureDetector, {
+    gesture: pan,
+    children: /*#__PURE__*/_jsxs(View, {
+      style: StyleSheet.absoluteFill,
+      children: [/*#__PURE__*/_jsx(Animated.View, {
+        pointerEvents: "none",
+        style: [{
+          position: 'absolute',
+          left: 0,
+          top: plot.top,
+          width: 1,
+          height: plot.height,
+          backgroundColor: stroke
+        }, crosshairStyle]
+      }), series.map(([key, seriesColor]) => /*#__PURE__*/_jsx(TooltipDot, {
+        values: numbersOf(data, key),
+        plot: plot,
+        domainMin: domainMin,
+        domainMax: domainMax,
+        activeIndex: activeIndex,
+        color: seriesColor
+      }, key)), showLabel ? /*#__PURE__*/_jsx(Animated.View, {
+        pointerEvents: "none",
+        style: [{
+          position: 'absolute',
+          left: 0,
+          top: Math.max(plot.top - 4, 0),
+          width: LABEL_WIDTH
+        }, labelStyle],
+        children: /*#__PURE__*/_jsx(View, {
+          className: "items-center rounded-xl border border-border bg-popover px-2.5 py-1.5 shadow-lg",
+          children: active ? /*#__PURE__*/_jsxs(_Fragment, {
+            children: [/*#__PURE__*/_jsx(Text, {
+              size: "xs",
+              muted: true,
+              numberOfLines: 1,
+              children: fmtX(active)
+            }), series.map(([key, seriesColor]) => {
+              const value = active[key];
+              if (typeof value !== 'number') return null;
+              return /*#__PURE__*/_jsxs(View, {
+                className: "flex-row items-center gap-1.5",
+                children: [series.length > 1 ? /*#__PURE__*/_jsx(View, {
+                  style: {
+                    backgroundColor: seriesColor
+                  },
+                  className: "h-1.5 w-1.5 rounded-full"
+                }) : null, /*#__PURE__*/_jsx(Text, {
+                  size: "sm",
+                  weight: "semibold",
+                  numberOfLines: 1,
+                  children: fmtValue(value, key)
+                })]
+              }, key);
+            })]
+          }) : null
+        })
+      }) : null]
+    })
+  });
+}
+LineChartTooltip.displayName = 'LineChart.Tooltip';
+LineChartTooltip.layer = 'overlay';
+const LABEL_WIDTH = 112;
+
+/** A compact number for the crosshair label: 1204 → "1.2k", 24801 → "24.8k". */
+function compactNumber(value) {
+  const abs = Math.abs(value);
+  if (abs >= 1_000_000) return `${(value / 1_000_000).toFixed(1)}M`;
+  if (abs >= 1_000) return `${(value / 1_000).toFixed(1)}k`;
+  return `${Math.round(value)}`;
+}
+const DOT = 9;
+
+/** The dot riding one series under the crosshair. */
+function TooltipDot({
+  values,
+  plot,
+  domainMin,
+  domainMax,
+  activeIndex,
+  color
+}) {
+  const style = useAnimatedStyle(() => {
+    const index = activeIndex.value;
+    const value = index < 0 ? null : values[index];
+    if (index < 0 || value === null || value === undefined) return {
+      opacity: 0
+    };
+    return {
+      opacity: 1,
+      transform: [{
+        translateX: xOf(index, values.length, plot) - DOT / 2
+      }, {
+        translateY: yOf(value, plot, domainMin.value, domainMax.value) - DOT / 2
+      }]
+    };
+  });
+  return /*#__PURE__*/_jsx(Animated.View, {
+    pointerEvents: "none",
+    style: [{
+      position: 'absolute',
+      left: 0,
+      top: 0,
+      width: DOT,
+      height: DOT,
+      borderRadius: DOT / 2,
+      backgroundColor: color
+    }, style]
+  });
+}
+/**
+ * A swatch and a name per registered series. Sits in the top-left of the plot
+ * by default — move it with `className`.
+ */
+function LineChartLegend({
+  className,
+  labels,
+  ...props
+}) {
+  const {
+    series
+  } = useChart('LineChart.Legend');
+  return /*#__PURE__*/_jsx(View, {
+    pointerEvents: "none",
+    className: cn('absolute left-2.5 top-0 flex-row flex-wrap items-center gap-4', className),
+    ...props,
+    children: series.map(([key, color]) => /*#__PURE__*/_jsxs(View, {
+      className: "flex-row items-center gap-1.5",
+      children: [/*#__PURE__*/_jsx(View, {
+        style: {
+          backgroundColor: color
+        },
+        className: "h-2 w-2 rounded-full"
+      }), /*#__PURE__*/_jsx(Text, {
+        size: "xs",
+        muted: true,
+        children: labels?.[key] ?? key
+      })]
+    }, key))
+  });
+}
+LineChartLegend.displayName = 'LineChart.Legend';
+LineChartLegend.layer = 'overlay';
+
+/* -------------------------------------------------------------------------- */
+/* Scales and paths                                                           */
+/* -------------------------------------------------------------------------- */
+
+/** Only reached if the theme CSS was never imported. */
+const FALLBACK_SERIES = ['#3b82f6', '#10b981', '#f59e0b', '#8b5cf6', '#ec4899'];
+
+/** Series colour: an explicit one, else the `--color-chart-*` token. */
+function useSeriesColor(explicit, index) {
+  const token = useCSSVariable(`--color-chart-${index}`);
+  return explicit ?? (typeof token === 'string' ? token : FALLBACK_SERIES[index - 1]);
+}
+function numbersOf(data, key) {
+  return data.map(row => {
+    const value = row[key];
+    return typeof value === 'number' && !Number.isNaN(value) ? value : null;
+  });
+}
+function xOf(index, total, plot) {
+  'worklet';
+
+  if (total <= 1) return plot.left + plot.width / 2;
+  return plot.left + plot.width * index / (total - 1);
+}
+function yOf(value, plot, min, max) {
+  'worklet';
+
+  const span = max - min || 1;
+  return plot.top + plot.height - (value - min) / span * plot.height;
+}
+
+/**
+ * Monotone cubic tangents.
+ *
+ * Written out rather than taken from a charting dependency, because it is forty
+ * lines and it has to run inside a worklet — the path is rebuilt on the UI
+ * thread on every frame the y-domain is tweening.
+ *
+ * Monotone is the right default for a time series. A plain cubic spline
+ * overshoots between points, so a series that never goes below zero draws a dip
+ * under the axis between two low values — a shape that is not in the data. This
+ * one cannot, because the tangent at each point is clamped against the slopes
+ * either side of it, and a local peak or trough is given a flat one.
+ */
+function tangents(xs, ys) {
+  'worklet';
+
+  const n = xs.length;
+  const slopes = [];
+  for (let i = 0; i < n - 1; i += 1) {
+    slopes.push((ys[i + 1] - ys[i]) / (xs[i + 1] - xs[i] || 1));
+  }
+  const result = new Array(n).fill(0);
+  result[0] = slopes[0] ?? 0;
+  result[n - 1] = slopes[n - 2] ?? 0;
+  for (let i = 1; i < n - 1; i += 1) {
+    const previous = slopes[i - 1];
+    const next = slopes[i];
+    result[i] = previous * next <= 0 ? 0 : (previous + next) / 2;
+  }
+
+  // Fritsch–Carlson: pull any tangent back inside the circle of radius 3, which
+  // is the condition for the segment to stay monotone.
+  for (let i = 0; i < n - 1; i += 1) {
+    const slope = slopes[i];
+    if (slope === 0) {
+      result[i] = 0;
+      result[i + 1] = 0;
+      continue;
+    }
+    const a = result[i] / slope;
+    const b = result[i + 1] / slope;
+    const magnitude = Math.sqrt(a * a + b * b);
+    if (magnitude > 3) {
+      result[i] = 3 / magnitude * a * slope;
+      result[i + 1] = 3 / magnitude * b * slope;
+    }
+  }
+  return result;
+}
+
+/** Points, split at the gaps — a null breaks the series rather than crossing it. */
+function runsOf(values, plot, min, max) {
+  'worklet';
+
+  const runs = [];
+  let run = [];
+  for (let i = 0; i < values.length; i += 1) {
+    const value = values[i];
+    if (value === null || value === undefined) {
+      if (run.length) runs.push(run);
+      run = [];
+      continue;
+    }
+    run.push({
+      x: xOf(i, values.length, plot),
+      y: yOf(value, plot, min, max)
+    });
+  }
+  if (run.length) runs.push(run);
+  return runs;
+}
+function segment(points, curve) {
+  'worklet';
+
+  if (!points.length) return '';
+  if (points.length < 3 || curve === 'linear') {
+    return points.map((p, i) => `${i === 0 ? 'M' : 'L'}${p.x},${p.y}`).join(' ');
+  }
+  const xs = points.map(p => p.x);
+  const ys = points.map(p => p.y);
+  const ms = tangents(xs, ys);
+  let d = `M${xs[0]},${ys[0]}`;
+  for (let i = 0; i < points.length - 1; i += 1) {
+    const dx = (xs[i + 1] - xs[i]) / 3;
+    d += ` C${xs[i] + dx},${ys[i] + ms[i] * dx} ${xs[i + 1] - dx},${ys[i + 1] - ms[i + 1] * dx} ${xs[i + 1]},${ys[i + 1]}`;
+  }
+  return d;
+}
+function linePath(values, plot, min, max, curve, loading) {
+  'worklet';
+
+  if (loading || plot.width <= 0) {
+    // Flat down the middle: the shape the skeleton holds, and the shape the
+    // real series grows out of once the data arrives.
+    const y = plot.top + plot.height / 2;
+    return `M${plot.left},${y} L${plot.left + plot.width},${y}`;
+  }
+  return runsOf(values, plot, min, max).map(run => segment(run, curve)).join(' ');
+}
+function areaPath(values, plot, min, max, curve, loading) {
+  'worklet';
+
+  if (loading || plot.width <= 0) return '';
+  const baseline = plot.top + plot.height;
+  return runsOf(values, plot, min, max).map(run => {
+    const top = segment(run, curve);
+    if (!top) return '';
+    const first = run[0];
+    const last = run[run.length - 1];
+    return `${top} L${last.x},${baseline} L${first.x},${baseline} Z`;
+  }).join(' ');
+}
+export const LineChart = Object.assign(LineChartRoot, {
+  Grid: LineChartGrid,
+  Area: LineChartArea,
+  Line: LineChartLine,
+  Skeleton: LineChartSkeleton,
+  XAxis: LineChartXAxis,
+  Tooltip: LineChartTooltip,
+  Legend: LineChartLegend
+});
+//# sourceMappingURL=index.js.map