@coinbase/cds-mobile-visualization 3.4.0-beta.1 → 3.4.0-beta.11

package/esm/chart/gradient/Gradient.js

@@ -0,0 +1,53 @@
+import { memo, useMemo } from 'react';
+import { LinearGradient, vec } from '@shopify/react-native-skia';
+import { useCartesianChartContext } from '../ChartProvider';
+import { getColorWithOpacity, getGradientConfig } from '../utils/gradient';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Renders a Skia LinearGradient element based on a GradientDefinition.
+ * The gradient should be used as a child of a Path component.
+ *
+ * @example
+ * <Path d={pathString} stroke="red">
+ *   {gradient && <Gradient gradient={gradient} yAxisId={yAxisId} />}
+ * </Path>
+ */
+export const Gradient = /*#__PURE__*/memo(_ref => {
+  var _gradient$axis;
+  let {
+    gradient,
+    yAxisId
+  } = _ref;
+  const context = useCartesianChartContext();
+  const xScale = context.getXScale();
+  const yScale = context.getYScale(yAxisId);
+  const axis = (_gradient$axis = gradient.axis) != null ? _gradient$axis : 'y';
+  const scale = axis === 'x' ? xScale : yScale;
+
+  // Process gradient definition into stops
+  const stops = useMemo(() => {
+    if (!xScale || !yScale) return;
+    return getGradientConfig(gradient, xScale, yScale);
+  }, [gradient, xScale, yScale]);
+  if (!stops || !scale) return;
+  const range = scale.range();
+
+  // Determine gradient direction based on axis
+  // For y-axis, we need to flip the gradient direction because y-scales are inverted
+  // (higher data values have smaller pixel values, appearing at the top)
+  const start = axis === 'x' ? vec(range[0], 0) : vec(0, range[0]);
+  const end = axis === 'x' ? vec(range[1], 0) : vec(0, range[1]);
+
+  // Extract colors and positions for LinearGradient
+  const colors = stops.map(s => {
+    var _s$opacity;
+    return getColorWithOpacity(s.color, (_s$opacity = s.opacity) != null ? _s$opacity : 1);
+  });
+  const positions = stops.map(s => s.offset);
+  return /*#__PURE__*/_jsx(LinearGradient, {
+    colors: colors,
+    end: end,
+    positions: positions,
+    start: start
+  });
+});

package/esm/chart/gradient/index.js

@@ -0,0 +1 @@
+export * from './Gradient';

package/esm/chart/index.js

@@ -3,11 +3,13 @@ export * from './area';
 export * from './axis';
 export * from './bar';
 export * from './CartesianChart';
+export * from './ChartContextBridge';
 export * from './ChartProvider';
+export * from './gradient';
 export * from './line';
 export * from './Path';
 export * from './PeriodSelector';
-export * from './Point';
+export * from './point';
 export * from './scrubber';
 export * from './text';
 export * from './utils';

package/esm/chart/line/DefaultReferenceLineLabel.js

@@ -0,0 +1,66 @@
+const _excluded = ["color", "elevated", "borderRadius", "inset", "boundsInset"];
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
+import { memo, useMemo } from 'react';
+import { useTheme } from '@coinbase/cds-mobile';
+import { useCartesianChartContext } from '../ChartProvider';
+import { ChartText } from '../text';
+import { getChartInset } from '../utils';
+import { jsx as _jsx } from "react/jsx-runtime";
+const elevatedInset = {
+  top: 8,
+  bottom: 8,
+  left: 12,
+  right: 12
+};
+const elevatedBorderRadius = 4;
+// Default bounds inset when elevated to prevent shadow clipping
+const elevatedBoundsInset = {
+  top: 4,
+  bottom: 20,
+  left: 12,
+  right: 12
+};
+const nonElevatedBoundsInset = {
+  top: 0,
+  bottom: 0,
+  left: 0,
+  right: 0
+};
+
+/**
+ * DefaultReferenceLineLabel is the default label component for ReferenceLine.
+ * Provides standard styling with elevation, inset, and color defaults.
+ * When elevated, automatically adds bounds to prevent shadow cutoff at chart edges.
+ */
+export const DefaultReferenceLineLabel = /*#__PURE__*/memo(_ref => {
+  let {
+      color,
+      elevated,
+      borderRadius = elevated ? elevatedBorderRadius : undefined,
+      inset = elevated ? elevatedInset : undefined,
+      boundsInset: boundsInsetProp
+    } = _ref,
+    props = _objectWithoutPropertiesLoose(_ref, _excluded);
+  const theme = useTheme();
+  const {
+    width: chartWidth,
+    height: chartHeight
+  } = useCartesianChartContext();
+  const bounds = useMemo(() => {
+    const boundsInset = getChartInset(boundsInsetProp, elevated ? elevatedBoundsInset : nonElevatedBoundsInset);
+    return {
+      x: boundsInset.left,
+      y: boundsInset.top,
+      width: chartWidth - boundsInset.left - boundsInset.right,
+      height: chartHeight - boundsInset.top - boundsInset.bottom
+    };
+  }, [elevated, boundsInsetProp, chartWidth, chartHeight]);
+  return /*#__PURE__*/_jsx(ChartText, _extends({
+    borderRadius: borderRadius,
+    bounds: bounds,
+    color: color != null ? color : theme.color.fgMuted,
+    elevated: elevated,
+    inset: inset
+  }, props));
+});

package/esm/chart/line/DottedLine.js

@@ -1,35 +1,50 @@
-const _excluded = ["fill", "stroke", "strokeDasharray", "strokeLinecap", "strokeLinejoin", "strokeOpacity", "strokeWidth", "vectorEffect"];
+const _excluded = ["fill", "stroke", "dashIntervals", "strokeCap", "strokeJoin", "strokeOpacity", "strokeWidth", "gradient", "yAxisId", "d", "animate", "transition"];
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 import { memo } from 'react';
 import { useTheme } from '@coinbase/cds-mobile/hooks/useTheme';
+import { DashPathEffect } from '@shopify/react-native-skia';
+import { Gradient } from '../gradient';
 import { Path } from '../Path';
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
- * A customizable dotted line component which uses path element.
+ * A customizable dotted line component.
+ * Supports gradient for gradient effects on the dots and smooth data transitions via AnimatedPath.
  */
 export const DottedLine = /*#__PURE__*/memo(_ref => {
   let {
       fill = 'none',
       stroke,
-      strokeDasharray = '0 4',
-      strokeLinecap = 'round',
-      strokeLinejoin = 'round',
+      dashIntervals = [0, 4],
+      strokeCap = 'round',
+      strokeJoin = 'round',
       strokeOpacity = 1,
       strokeWidth = 2,
-      vectorEffect = 'non-scaling-stroke'
+      gradient,
+      yAxisId,
+      d,
+      animate,
+      transition
     } = _ref,
     props = _objectWithoutPropertiesLoose(_ref, _excluded);
   const theme = useTheme();
-  return /*#__PURE__*/_jsx(Path, _extends({
+  return /*#__PURE__*/_jsxs(Path, _extends({
+    animate: animate,
     clipOffset: strokeWidth,
+    d: d,
     fill: fill,
-    stroke: stroke != null ? stroke : theme.color.bgLine,
-    strokeDasharray: strokeDasharray,
-    strokeLinecap: strokeLinecap,
-    strokeLinejoin: strokeLinejoin,
+    stroke: stroke != null ? stroke : theme.color.fgPrimary,
+    strokeCap: strokeCap,
+    strokeJoin: strokeJoin,
     strokeOpacity: strokeOpacity,
     strokeWidth: strokeWidth,
-    vectorEffect: vectorEffect
-  }, props));
+    transition: transition
+  }, props, {
+    children: [/*#__PURE__*/_jsx(DashPathEffect, {
+      intervals: dashIntervals
+    }), gradient && /*#__PURE__*/_jsx(Gradient, {
+      gradient: gradient,
+      yAxisId: yAxisId
+    })]
+  }));
 });

package/esm/chart/line/Line.js

@@ -1,70 +1,69 @@
-const _excluded = ["seriesId", "curve", "type", "areaType", "areaBaseline", "stroke", "showArea", "LineComponent", "AreaComponent", "opacity", "renderPoints"];
+const _excluded = ["seriesId", "curve", "type", "areaType", "areaBaseline", "stroke", "strokeOpacity", "showArea", "LineComponent", "AreaComponent", "opacity", "points", "connectNulls", "transition", "gradient"];
 function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
-import React, { memo, useMemo } from 'react';
-import { useTheme } from '@coinbase/cds-mobile/hooks/useTheme';
+import React, { memo, useEffect, useMemo } from 'react';
+import { useSharedValue, withDelay, withTiming } from 'react-native-reanimated';
+import { useTheme } from '@coinbase/cds-mobile';
+import { Group } from '@shopify/react-native-skia';
 import { Area } from '../area/Area';
 import { useCartesianChartContext } from '../ChartProvider';
-import { Point } from '../Point';
-import { getLinePath } from '../utils';
+import { Point } from '../point';
+import { accessoryFadeTransitionDelay, accessoryFadeTransitionDuration, getLineData, getLinePath } from '../utils';
+import { evaluateGradientAtValue, getGradientStops } from '../utils/gradient';
+import { convertToSerializableScale } from '../utils/scale';
 import { DottedLine } from './DottedLine';
-import { GradientLine } from './GradientLine';
 import { SolidLine } from './SolidLine';
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 export const Line = /*#__PURE__*/memo(_ref => {
   var _ref2;
   let {
       seriesId,
-      curve = 'linear',
+      curve = 'bump',
       type = 'solid',
       areaType = 'gradient',
       areaBaseline,
-      stroke: specifiedStroke,
-      showArea = false,
+      stroke: strokeProp,
+      strokeOpacity,
+      showArea,
       LineComponent: SelectedLineComponent,
       AreaComponent,
       opacity = 1,
-      renderPoints
+      points,
+      connectNulls,
+      transition,
+      gradient: gradientProp
     } = _ref,
     props = _objectWithoutPropertiesLoose(_ref, _excluded);
   const theme = useTheme();
   const {
+    animate,
     getSeries,
     getSeriesData,
     getXScale,
     getYScale,
     getXAxis
   } = useCartesianChartContext();
-  const matchedSeries = getSeries(seriesId);
-  const sourceData = useMemo(() => {
-    return getSeriesData(seriesId) || null;
-  }, [seriesId, getSeriesData]);
-  const xAxis = getXAxis();
-  const xScale = getXScale();
-  const yScale = getYScale(matchedSeries == null ? void 0 : matchedSeries.yAxisId);
 
-  // Convert sourceData to number array (line only supports numbers, not tuples)
-  // If data is stacked (tuples), extract the actual values from [baseline, actualValue] format
-  const chartData = useMemo(() => {
-    if (!sourceData) return [];
+  // Animation state for delayed point rendering (matches web timing)
+  const pointsOpacity = useSharedValue(animate ? 0 : 1);
 
-    // Check if this is stacked data (array of tuples)
-    const firstNonNull = sourceData.find(d => d !== null);
-    if (Array.isArray(firstNonNull)) {
-      // Extract actual values from [baseline, value] tuples
-      return sourceData.map(d => {
-        if (d === null) return null;
-        if (Array.isArray(d)) return d[1];
-        return d;
-      });
+  // Delay point appearance until after path enter animation completes
+  useEffect(() => {
+    if (animate) {
+      pointsOpacity.value = withDelay(accessoryFadeTransitionDelay, withTiming(1, {
+        duration: accessoryFadeTransitionDuration
+      }));
     }
+  }, [animate, pointsOpacity]);
+  const matchedSeries = useMemo(() => getSeries(seriesId), [getSeries, seriesId]);
+  const gradient = useMemo(() => gradientProp != null ? gradientProp : matchedSeries == null ? void 0 : matchedSeries.gradient, [gradientProp, matchedSeries == null ? void 0 : matchedSeries.gradient]);
+  const sourceData = useMemo(() => getSeriesData(seriesId), [getSeriesData, seriesId]);
+  const xAxis = useMemo(() => getXAxis(), [getXAxis]);
+  const xScale = useMemo(() => getXScale(), [getXScale]);
+  const yScale = useMemo(() => getYScale(matchedSeries == null ? void 0 : matchedSeries.yAxisId), [getYScale, matchedSeries == null ? void 0 : matchedSeries.yAxisId]);
 
-    // Regular number array
-    if (sourceData.every(d => typeof d === 'number' || d === null)) {
-      return sourceData;
-    }
-    return [];
-  }, [sourceData]);
+  // Convert sourceData to number array (line only supports numbers, not tuples)
+  const chartData = useMemo(() => getLineData(sourceData), [sourceData]);
   const path = useMemo(() => {
     if (!xScale || !yScale || chartData.length === 0) return '';
 
@@ -75,9 +74,10 @@ export const Line = /*#__PURE__*/memo(_ref => {
       xScale,
       yScale,
       curve,
-      xData
+      xData,
+      connectNulls
     });
-  }, [chartData, xScale, yScale, curve, xAxis == null ? void 0 : xAxis.data]);
+  }, [chartData, xScale, yScale, curve, xAxis == null ? void 0 : xAxis.data, connectNulls]);
   const LineComponent = useMemo(() => {
     if (SelectedLineComponent) {
       return SelectedLineComponent;
@@ -85,55 +85,94 @@ export const Line = /*#__PURE__*/memo(_ref => {
     switch (type) {
       case 'dotted':
         return DottedLine;
-      case 'gradient':
-        return GradientLine;
-      case 'solid':
       default:
         return SolidLine;
     }
   }, [SelectedLineComponent, type]);
-  const stroke = (_ref2 = specifiedStroke != null ? specifiedStroke : matchedSeries == null ? void 0 : matchedSeries.color) != null ? _ref2 : theme.color.fgPrimary;
+
+  // Get series color for stroke
+  const stroke = (_ref2 = strokeProp != null ? strokeProp : matchedSeries == null ? void 0 : matchedSeries.color) != null ? _ref2 : theme.color.fgPrimary;
   const xData = useMemo(() => {
     const data = xAxis == null ? void 0 : xAxis.data;
     return data && Array.isArray(data) && data.length > 0 && typeof data[0] === 'number' ? data : null;
   }, [xAxis == null ? void 0 : xAxis.data]);
-  if (!xScale || !yScale) return;
+  const gradientConfig = useMemo(() => {
+    if (!gradient || !xScale || !yScale) return;
+    const gradientScale = gradient.axis === 'x' ? xScale : yScale;
+    const serializableScale = convertToSerializableScale(gradientScale);
+    if (!serializableScale) return;
+    const domain = {
+      min: serializableScale.domain[0],
+      max: serializableScale.domain[1]
+    };
+    const stops = getGradientStops(gradient.stops, domain);
+    return {
+      scale: serializableScale,
+      stops
+    };
+  }, [gradient, xScale, yScale]);
+  if (!xScale || !yScale || !path) return;
   return /*#__PURE__*/_jsxs(_Fragment, {
     children: [showArea && /*#__PURE__*/_jsx(Area, {
       AreaComponent: AreaComponent,
       baseline: areaBaseline,
+      connectNulls: connectNulls,
       curve: curve,
       fill: stroke,
       fillOpacity: opacity,
+      gradient: gradient,
       seriesId: seriesId,
+      transition: transition,
       type: areaType
     }), /*#__PURE__*/_jsx(LineComponent, _extends({
       d: path,
+      gradient: gradient,
       stroke: stroke,
-      strokeOpacity: opacity
-    }, props)), renderPoints && chartData.map((value, index) => {
-      var _xScale, _yScale, _pointConfig$fill, _pointConfig$opacity;
-      if (value === null) {
-        return null;
-      }
-      const xValue = xData && xData[index] !== undefined ? xData[index] : index;
-      const pointResult = renderPoints({
-        dataY: value,
-        dataX: xValue,
-        x: (_xScale = xScale == null ? void 0 : xScale(xValue)) != null ? _xScale : 0,
-        y: (_yScale = yScale == null ? void 0 : yScale(value)) != null ? _yScale : 0
-      });
-      if (pointResult === false || pointResult === null || pointResult === undefined) {
-        return null;
-      }
-      const pointConfig = pointResult === true ? {} : pointResult;
-      return /*#__PURE__*/_jsx(Point, _extends({
-        dataX: xValue,
-        dataY: value
-      }, pointConfig, {
-        fill: (_pointConfig$fill = pointConfig.fill) != null ? _pointConfig$fill : stroke,
-        opacity: (_pointConfig$opacity = pointConfig.opacity) != null ? _pointConfig$opacity : opacity
-      }), seriesId + "-renderpoint-" + index);
+      strokeOpacity: strokeOpacity != null ? strokeOpacity : opacity,
+      transition: transition,
+      yAxisId: matchedSeries == null ? void 0 : matchedSeries.yAxisId
+    }, props)), points && /*#__PURE__*/_jsx(Group, {
+      opacity: pointsOpacity,
+      children: chartData.map((value, index) => {
+        if (value === null) return;
+        const xValue = xData && xData[index] !== undefined ? xData[index] : index;
+        let pointFill = stroke;
+        if (gradientConfig && gradient) {
+          var _gradient$axis;
+          // Use the appropriate data value based on gradient axis
+          const axis = (_gradient$axis = gradient.axis) != null ? _gradient$axis : 'y';
+          const dataValue = axis === 'x' ? xValue : value;
+          const evaluatedColor = evaluateGradientAtValue(gradientConfig.stops, dataValue, gradientConfig.scale);
+          if (evaluatedColor) {
+            // Apply gradient color to fill if not explicitly set
+            pointFill = evaluatedColor;
+          }
+        }
+
+        // Build defaults that would be passed to Point
+        const defaults = {
+          dataX: xValue,
+          dataY: value,
+          fill: pointFill,
+          yAxisId: matchedSeries == null ? void 0 : matchedSeries.yAxisId,
+          opacity
+        };
+
+        // If points is true, render with defaults
+        if (points === true) {
+          return /*#__PURE__*/_jsx(Point, _extends({
+            transition: transition
+          }, defaults), seriesId + "-" + xValue);
+        }
+
+        // Call the function with defaults
+        const result = points(defaults);
+        if (!result) return;
+        const pointConfig = result === true ? {} : result;
+        return /*#__PURE__*/_jsx(Point, _extends({
+          transition: transition
+        }, defaults, pointConfig), seriesId + "-" + xValue);
+      })
     })]
   });
 });

package/esm/chart/line/LineChart.js

@@ -1,4 +1,4 @@
-const _excluded = ["series", "showArea", "areaType", "type", "LineComponent", "AreaComponent", "curve", "renderPoints", "strokeWidth", "showXAxis", "showYAxis", "xAxis", "yAxis", "inset", "children"],
+const _excluded = ["series", "showArea", "areaType", "type", "LineComponent", "AreaComponent", "curve", "points", "strokeWidth", "strokeOpacity", "connectNulls", "transition", "opacity", "showXAxis", "showYAxis", "xAxis", "yAxis", "inset", "children"],
   _excluded2 = ["scaleType", "data", "categoryPadding", "domain", "domainLimit", "range"],
   _excluded3 = ["scaleType", "data", "categoryPadding", "domain", "domainLimit", "range", "id"],
   _excluded4 = ["id", "data", "label", "color", "yAxisId"];
@@ -20,23 +20,21 @@ export const LineChart = /*#__PURE__*/memo(/*#__PURE__*/forwardRef((_ref, ref) =
       LineComponent,
       AreaComponent,
       curve,
-      renderPoints,
+      points,
       strokeWidth,
+      strokeOpacity,
+      connectNulls,
+      transition,
+      opacity,
       showXAxis,
       showYAxis,
       xAxis,
       yAxis,
-      inset: userInset,
+      inset,
       children
     } = _ref,
     chartProps = _objectWithoutPropertiesLoose(_ref, _excluded);
-  const calculatedInset = useMemo(() => getChartInset(userInset, defaultChartInset), [userInset]);
-
-  // Check if we have valid data across all series
-  const hasData = useMemo(() => {
-    if (!series || series.length === 0) return false;
-    return series.some(s => s.data && s.data.length > 0);
-  }, [series]);
+  const calculatedInset = useMemo(() => getChartInset(inset, defaultChartInset), [inset]);
 
   // Convert LineSeries to Series for Chart context
   const chartSeries = useMemo(() => {
@@ -44,7 +42,10 @@ export const LineChart = /*#__PURE__*/memo(/*#__PURE__*/forwardRef((_ref, ref) =
       id: s.id,
       data: s.data,
       label: s.label,
-      color: s.color
+      color: s.color,
+      yAxisId: s.yAxisId,
+      stackId: s.stackId,
+      gradient: s.gradient
     }));
   }, [series]);
 
@@ -94,7 +95,8 @@ export const LineChart = /*#__PURE__*/memo(/*#__PURE__*/forwardRef((_ref, ref) =
     yAxis: yAxisConfig,
     children: [showXAxis && /*#__PURE__*/_jsx(XAxis, _extends({}, xAxisVisualProps)), showYAxis && /*#__PURE__*/_jsx(YAxis, _extends({
       axisId: yAxisId
-    }, yAxisVisualProps)), hasData && (series == null ? void 0 : series.map(_ref4 => {
+    }, yAxisVisualProps)), series == null ? void 0 : series.map(_ref4 => {
+      var _linePropsFromSeries$;
       let {
           id
         } = _ref4,
@@ -103,13 +105,17 @@ export const LineChart = /*#__PURE__*/memo(/*#__PURE__*/forwardRef((_ref, ref) =
         AreaComponent: AreaComponent,
         LineComponent: LineComponent,
         areaType: areaType,
+        connectNulls: connectNulls,
         curve: curve,
-        renderPoints: renderPoints,
+        opacity: opacity,
+        points: points,
         seriesId: id,
         showArea: showArea,
+        strokeOpacity: strokeOpacity,
         strokeWidth: strokeWidth,
+        transition: (_linePropsFromSeries$ = linePropsFromSeries.transition) != null ? _linePropsFromSeries$ : transition,
         type: type
       }, linePropsFromSeries), id);
-    })), children]
+    }), children]
   }));
 }));