@coinbase/cds-mobile-visualization 3.4.0-beta.5 → 3.4.0-beta.6

package/esm/chart/bar/__stories__/BarChart.stories.js

@@ -1,17 +1,15 @@
-const _excluded = ["children"];
+const _excluded = ["children"],
+  _excluded2 = ["animate"];
 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; }
 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); }
-import { memo, useContext, useState } from 'react';
-import { Rect as SvgRect } from 'react-native-svg';
+import { memo, useEffect, useState } from 'react';
 import { Button } from '@coinbase/cds-mobile/buttons';
 import { Example, ExampleScreen } from '@coinbase/cds-mobile/examples/ExampleScreen';
 import { useTheme } from '@coinbase/cds-mobile/hooks/useTheme';
 import { VStack } from '@coinbase/cds-mobile/layout';
 import { XAxis, YAxis } from '../../axis';
 import { CartesianChart } from '../../CartesianChart';
-import { useCartesianChartContext } from '../../ChartProvider';
 import { ReferenceLine, SolidLine } from '../../line';
-import { isCategoricalScale, ScrubberContext } from '../../utils';
 import { Bar } from '../Bar';
 import { BarChart } from '../BarChart';
 import { BarPlot } from '../BarPlot';
@@ -92,13 +90,37 @@ const FiatAndStablecoinBalance = () => {
     }
   });
 };
-const MonthlyRewards = () => {
+const CustomBarStackComponent = /*#__PURE__*/memo(_ref => {
+  let {
+      children
+    } = _ref,
+    props = _objectWithoutPropertiesLoose(_ref, _excluded);
   const theme = useTheme();
+  if (props.height === 0) {
+    const diameter = props.width;
+    return /*#__PURE__*/_jsx(Bar, {
+      roundBottom: true,
+      roundTop: true,
+      borderRadius: 1000,
+      fill: theme.color.bgTertiary,
+      height: diameter,
+      originY: props.y,
+      width: diameter,
+      x: props.x,
+      y: props.y - diameter
+    });
+  }
+  return /*#__PURE__*/_jsx(DefaultBarStack, _extends({}, props, {
+    children: children
+  }));
+});
+const MonthlyRewards = () => {
   const months = ['J', 'F', 'M', 'A', 'M', 'J', 'J', 'A', 'S', 'O', 'N', 'D'];
   const purple = [null, 6, 8, 10, 7, 6, 6, 8, null, null, null, null];
   const blue = [null, 10, 12, 11, 10, 9, 10, 11, null, null, null, null];
   const cyan = [null, 7, 10, 12, 11, 10, 8, 11, null, null, null, null];
   const green = [10, null, null, null, 1, null, null, 6, null, null, null, null];
+  const [roundBaseline, setRoundBaseline] = useState(true);
   const series = [{
     id: 'purple',
     data: purple,
@@ -116,46 +138,29 @@ const MonthlyRewards = () => {
     data: green,
     color: '#33c481'
   }];
-  const CustomBarStackComponent = _ref => {
-    let {
-        children
-      } = _ref,
-      props = _objectWithoutPropertiesLoose(_ref, _excluded);
-    if (props.height === 0) {
-      const diameter = props.width;
-      return /*#__PURE__*/_jsx(Bar, {
-        roundBottom: true,
-        roundTop: true,
-        borderRadius: 1000,
-        fill: theme.color.bgTertiary,
-        height: diameter,
-        originY: props.y,
-        width: diameter,
-        x: props.x,
-        y: props.y - diameter
-      });
-    }
-    return /*#__PURE__*/_jsx(DefaultBarStack, _extends({}, props, {
-      children: children
-    }));
-  };
-  return /*#__PURE__*/_jsx(BarChart, {
-    roundBaseline: true,
-    showXAxis: true,
-    stacked: true,
-    BarStackComponent: CustomBarStackComponent,
-    borderRadius: 1000,
-    height: 300,
-    inset: 0,
-    series: series,
-    showYAxis: false,
-    stackMinSize: 24,
-    xAxis: {
-      tickLabelFormatter: index => {
-        return months[index];
-      },
-      categoryPadding: 0.27
-    }
+  return /*#__PURE__*/_jsxs(VStack, {
+    gap: 2,
+    children: [/*#__PURE__*/_jsx(BarChart, {
+      showXAxis: true,
+      stacked: true,
+      BarStackComponent: CustomBarStackComponent,
+      borderRadius: 1000,
+      height: 300,
+      inset: 0,
+      roundBaseline: roundBaseline,
+      series: series,
+      showYAxis: false,
+      stackMinSize: 24,
+      xAxis: {
+        tickLabelFormatter: index => {
+          return months[index];
+        },
+        categoryPadding: 0.27
+      }
+    }), /*#__PURE__*/_jsx(Button, {
+      onPress: () => setRoundBaseline(!roundBaseline),
+      children: "Toggle Round Baseline"
+    })]
   });
 };
 const MultipleYAxes = () => {
@@ -184,33 +189,40 @@ const MultipleYAxes = () => {
     }],
     children: [/*#__PURE__*/_jsx(XAxis, {
       showLine: true,
-      showTickMarks: true
+      showTickMarks: true,
+      label: "Month"
     }), /*#__PURE__*/_jsx(YAxis, {
       showGrid: true,
       showLine: true,
       showTickMarks: true,
       axisId: "revenue",
+      label: "Revenue",
       position: "left",
       requestedTickCount: 5,
       tickLabelFormatter: value => "$" + value + "k",
-      width: 60
+      width: 80
     }), /*#__PURE__*/_jsx(YAxis, {
       showLine: true,
       showTickMarks: true,
       axisId: "profit",
+      label: "Profit",
       requestedTickCount: 5,
-      tickLabelFormatter: value => "$" + value + "k"
+      tickLabelFormatter: value => "$" + value + "k",
+      width: 70
     }), /*#__PURE__*/_jsx(BarPlot, {})]
   });
 };
+const initialData = [45, 52, 38, 45, 19, 23, 32];
+const MyCustomLine = /*#__PURE__*/memo(_ref2 => {
+  let props = _objectWithoutPropertiesLoose(_ref2, _excluded2);
+  return /*#__PURE__*/_jsx(SolidLine, _extends({}, props));
+});
 const UpdatingChartValues = () => {
-  const [data, setData] = useState([45, 52, 38, 45, 19, 23, 32]);
+  const [data, setData] = useState(initialData);
   return /*#__PURE__*/_jsxs(VStack, {
     gap: 2,
     children: [/*#__PURE__*/_jsx(BarChart, {
-      showXAxis: true,
-      showYAxis: true,
-      height: defaultChartHeight,
+      height: 100,
       series: [{
         id: 'weekly-data',
         data: data
@@ -226,14 +238,136 @@ const UpdatingChartValues = () => {
         showGrid: true,
         showTickMarks: true,
         showLine: true,
-        tickMarkSize: 12
+        tickMarkSize: 12,
+        domain: {
+          max: 250
+        }
       }
+    }), /*#__PURE__*/_jsx(BarChart, {
+      height: 100,
+      series: [{
+        id: 'weekly-data',
+        data: data
+      }],
+      transition: {
+        type: 'timing',
+        duration: 300
+      },
+      xAxis: {
+        data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],
+        showTickMarks: true,
+        showLine: true
+      },
+      yAxis: {
+        requestedTickCount: 5,
+        tickLabelFormatter: value => "$" + value + "k",
+        showGrid: true,
+        showTickMarks: true,
+        showLine: true,
+        tickMarkSize: 12,
+        domain: {
+          max: 250
+        }
+      }
+    }), /*#__PURE__*/_jsx(BarChart, {
+      height: 100,
+      series: [{
+        id: 'weekly-data',
+        data: data.map((d, i) => i % 2 === 0 ? d : -d)
+      }],
+      xAxis: {
+        data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],
+        showTickMarks: true,
+        showLine: true
+      },
+      yAxis: {
+        requestedTickCount: 5,
+        tickLabelFormatter: value => "$" + value + "k",
+        showGrid: true,
+        showTickMarks: true,
+        showLine: true,
+        tickMarkSize: 12,
+        domain: {
+          max: 250
+        }
+      },
+      children: /*#__PURE__*/_jsx(ReferenceLine, {
+        LineComponent: MyCustomLine,
+        dataY: 0
+      })
     }), /*#__PURE__*/_jsx(Button, {
-      onPress: () => setData(data => data.map(d => d + 10)),
+      onPress: () => setData(data => data[0] > 200 ? initialData : data.map(d => d + 50)),
       children: "Update Data"
     })]
   });
 };
+const AnimatedUpdatingChartValues = () => {
+  const [data, setData] = useState([45, 52, 38, 45, 19, 23, 32]);
+  useEffect(() => {
+    const interval = setInterval(() => {
+      setData(prevData => prevData.map(value => {
+        // Generate random change between -15 and +15
+        const change = Math.floor(Math.random() * 31) - 15;
+        // Ensure values stay between 10 and 200
+        return Math.max(10, Math.min(200, value + change));
+      }));
+    }, 1000);
+    return () => clearInterval(interval);
+  }, []);
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'weekly-data',
+      data: data
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],
+      showTickMarks: true,
+      showLine: true
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => "$" + value + "k",
+      showGrid: true,
+      showTickMarks: true,
+      showLine: true,
+      tickMarkSize: 12,
+      domain: {
+        max: 250
+      }
+    }
+  });
+};
+const NegativeValuesWithTopAxis = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsxs(CartesianChart, {
+    height: defaultChartHeight,
+    series: [{
+      id: 'losses',
+      data: [-45, -52, -38, -45, -19, -23, -32],
+      color: theme.color.fgNegative
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'],
+      scaleType: 'band'
+    },
+    children: [/*#__PURE__*/_jsx(XAxis, {
+      showLine: true,
+      showTickMarks: true,
+      label: "Day of Week",
+      position: "top"
+    }), /*#__PURE__*/_jsx(YAxis, {
+      showGrid: true,
+      showLine: true,
+      showTickMarks: true,
+      label: "Loss",
+      requestedTickCount: 5,
+      tickLabelFormatter: value => "$" + value + "k"
+    }), /*#__PURE__*/_jsx(BarPlot, {})]
+  });
+};
 const tabs = [{
   id: 'week',
   label: '1W'
@@ -244,38 +378,290 @@ const tabs = [{
   id: 'year',
   label: '1Y'
 }];
-const ScrubberRect = /*#__PURE__*/memo(() => {
-  var _useContext;
+const YAxisContinuousColorMap = () => {
   const theme = useTheme();
-  const {
-    getXScale,
-    getYScale
-  } = useCartesianChartContext();
-  const {
-    scrubberPosition
-  } = (_useContext = useContext(ScrubberContext)) != null ? _useContext : {};
-  const xScale = getXScale();
-  const yScale = getYScale();
-  if (!xScale || !yScale || scrubberPosition === undefined || !isCategoricalScale(xScale)) return null;
-  const yScaleDomain = yScale.range();
-  const [yMax, yMin] = yScaleDomain;
-  const barWidth = xScale.bandwidth();
-  return /*#__PURE__*/_jsx(SvgRect, {
-    fill: theme.color.bgLine,
-    height: yMax - yMin,
-    width: barWidth,
-    x: xScale(scrubberPosition),
-    y: yMin
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'temperature',
+      data: [12, 25, 38, 52, 45, 30, 18],
+      // Continuous gradient from blue (cold) to red (hot)
+      gradient: {
+        axis: 'y',
+        stops: _ref3 => {
+          let {
+            min,
+            max
+          } = _ref3;
+          return [{
+            offset: min,
+            color: theme.color.accentBoldGreen
+          }, {
+            offset: (min + max) / 2,
+            color: theme.color.accentBoldYellow
+          }, {
+            offset: max,
+            color: theme.color.accentBoldRed
+          }];
+        }
+      }
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => value + "\xB0C",
+      showGrid: true
+    }
   });
-});
+};
+const YAxisDiscreteColorMap = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'temperature',
+      data: [12, 25, 38, 52, 45, 30, 18],
+      // Hard transitions based on performance thresholds
+      gradient: {
+        axis: 'y',
+        stops: [{
+          offset: 20,
+          color: theme.color.accentBoldGreen
+        }, {
+          offset: 20,
+          color: theme.color.accentBoldYellow
+        }, {
+          offset: 40,
+          color: theme.color.accentBoldYellow
+        }, {
+          offset: 40,
+          color: theme.color.accentBoldRed
+        }, {
+          offset: 60,
+          color: theme.color.accentBoldRed
+        }] // Hard transitions at 20, 40
+      }
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => value + "\xB0C",
+      showGrid: true
+    }
+  });
+};
+const XAxisContinuousColorMap = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'weekly-trend',
+      data: [45, 52, 38, 45, 48, 50, 55],
+      // Gradient from left (start of week) to right (end of week)
+      gradient: {
+        axis: 'x',
+        stops: _ref4 => {
+          let {
+            min,
+            max
+          } = _ref4;
+          return [{
+            offset: min,
+            color: theme.color.accentBoldPurple
+          }, {
+            offset: max,
+            color: theme.color.accentBoldBlue
+          }];
+        }
+      }
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => "" + value,
+      showGrid: true
+    }
+  });
+};
+const XAxisDiscreteColorMap = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'weekly-trend',
+      data: [45, 52, 38, 45, 48, 50, 55],
+      // Hard color transition from purple to blue at midweek
+      gradient: {
+        axis: 'x',
+        stops: [{
+          offset: 4,
+          color: theme.color.accentBoldPurple
+        },
+        // First half of week
+        {
+          offset: 4,
+          color: theme.color.accentBoldBlue
+        } // Second half of week - hard transition at index 4 (Thursday)
+        ]
+      }
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => "" + value,
+      showGrid: true
+    }
+  });
+};
+const XAxisMultiSegmentColorMap = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'quarters',
+      data: [120, 135, 142, 128, 145, 158, 162, 155, 168, 175, 182, 190],
+      // Different color for each quarter
+      gradient: {
+        axis: 'x',
+        stops: [{
+          offset: 3,
+          color: theme.color.accentBoldBlue
+        },
+        // Q1 (Jan-Mar)
+        {
+          offset: 3,
+          color: theme.color.accentBoldGreen
+        },
+        // Q2 (Apr-Jun)
+        {
+          offset: 6,
+          color: theme.color.accentBoldGreen
+        }, {
+          offset: 6,
+          color: theme.color.accentBoldYellow
+        },
+        // Q3 (Jul-Sep)
+        {
+          offset: 9,
+          color: theme.color.accentBoldYellow
+        }, {
+          offset: 9,
+          color: theme.color.accentBoldPurple
+        } // Q4 (Oct-Dec)
+        ] // Hard transitions at indices 3, 6, 9
+      }
+    }],
+    xAxis: {
+      data: ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => "$" + value + "k",
+      showGrid: true
+    }
+  });
+};
+const ColorMapWithOpacity = () => {
+  const theme = useTheme();
+  return /*#__PURE__*/_jsx(BarChart, {
+    showXAxis: true,
+    showYAxis: true,
+    height: defaultChartHeight,
+    series: [{
+      id: 'confidence',
+      data: [25, 35, 45, 55, 65, 75, 85],
+      // Gradient with opacity changes
+      gradient: {
+        axis: 'y',
+        stops: _ref5 => {
+          let {
+            min,
+            max
+          } = _ref5;
+          return [{
+            offset: min,
+            color: theme.color.accentBoldBlue,
+            opacity: 0
+          },
+          // Low values - more transparent
+          {
+            offset: max,
+            color: theme.color.accentBoldBlue,
+            opacity: 1.0
+          } // High values - more opaque
+          ];
+        }
+      }
+    }],
+    xAxis: {
+      data: ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun']
+    },
+    yAxis: {
+      requestedTickCount: 5,
+      tickLabelFormatter: value => value + "%",
+      showGrid: true
+    }
+  });
+};
 const BarChartStories = () => {
   return /*#__PURE__*/_jsxs(ExampleScreen, {
     children: [/*#__PURE__*/_jsx(Example, {
       title: "Basic",
       children: /*#__PURE__*/_jsx(UpdatingChartValues, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Animated Auto-Updating",
+      children: /*#__PURE__*/_jsx(AnimatedUpdatingChartValues, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Negative Values with Top Axis",
+      children: /*#__PURE__*/_jsx(NegativeValuesWithTopAxis, {})
     }), /*#__PURE__*/_jsx(Example, {
       title: "Positive and Negative Cash Flow",
       children: /*#__PURE__*/_jsx(PositiveAndNegativeCashFlow, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Fiat & Stablecoin Balance",
+      children: /*#__PURE__*/_jsx(FiatAndStablecoinBalance, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Monthly Rewards",
+      children: /*#__PURE__*/_jsx(MonthlyRewards, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Multiple Y Axes",
+      children: /*#__PURE__*/_jsx(MultipleYAxes, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Y-Axis Continuous ColorMap",
+      children: /*#__PURE__*/_jsx(YAxisContinuousColorMap, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "Y-Axis Discrete ColorMap",
+      children: /*#__PURE__*/_jsx(YAxisDiscreteColorMap, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "X-Axis Continuous ColorMap",
+      children: /*#__PURE__*/_jsx(XAxisContinuousColorMap, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "X-Axis Discrete ColorMap",
+      children: /*#__PURE__*/_jsx(XAxisDiscreteColorMap, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "X-Axis Multi-Segment ColorMap",
+      children: /*#__PURE__*/_jsx(XAxisMultiSegmentColorMap, {})
+    }), /*#__PURE__*/_jsx(Example, {
+      title: "ColorMap with Opacity",
+      children: /*#__PURE__*/_jsx(ColorMapWithOpacity, {})
     })]
   });
 };

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';