@coinbase/cds-mobile-visualization 3.4.0-beta.2 → 3.4.0-beta.20

package/CHANGELOG.md

@@ -8,6 +8,128 @@ All notable changes to this project will be documented in this file.
 
 <!-- template-start -->
 
+## 3.4.0-beta.20 (2/27/2026 PST)
+
+#### 🚀 Updates
+
+- Add styles props to PeriodSelector. [[#438](https://github.com/coinbase/cds/pull/438/)]
+
+#### 📘 Misc
+
+- Update outdated doc links. [[#440](https://github.com/coinbase/cds/pull/440)]
+
+## 3.4.0-beta.19 (2/20/2026 PST)
+
+#### 🚀 Updates
+
+- Support custom enter transitions [[#400](https://github.com/coinbase/cds/pull/400/)]
+
+## 3.4.0-beta.18 (2/6/2026 PST)
+
+#### 🚀 Updates
+
+- Fix line chart enter animations not properly syncing with scrubber. [[#374](https://github.com/coinbase/cds/pull/374)]
+
+## 3.4.0-beta.17 (2/4/2026 PST)
+
+#### 🚀 Updates
+
+- Add support preferred side for scrubber beacon label group. [[#366](https://github.com/coinbase/cds/pull/366)]
+
+## 3.4.0-beta.16 (1/28/2026 PST)
+
+#### 🐞 Fixes
+
+- Fix every context rendering a second time in CDS Chart for performance. [[#339](https://github.com/avocado-cb/cds/pull/339)] [DEX2-874]
+
+## 3.4.0-beta.15 (1/27/2026 PST)
+
+#### 🐞 Fixes
+
+- Fix padding on PeriodSelector. [[#330](https://github.com/coinbase/cds/pull/330)]
+
+## 3.4.0-beta.14 (1/22/2026 PST)
+
+#### 🚀 Updates
+
+- Add chart Legend component. [[#302](https://github.com/coinbase/cds/pull/302)]
+- Add support for hideBeaconLabels in Scrubber. [[#302](https://github.com/coinbase/cds/pull/302)]
+- Add support for custom bar components. [[#302](https://github.com/coinbase/cds/pull/302)]
+
+## 3.4.0-beta.13 (1/20/2026 PST)
+
+#### 🚀 Updates
+
+- Feat: support styling default scrubber beacon. [[#315](https://github.com/coinbase/cds/pull/315)]
+- Fix: idlePulse works on mobile even when Chart animation is off, matching web. [[#315](https://github.com/coinbase/cds/pull/315)]
+
+#### 📘 Misc
+
+- Internal: code connect file lint fixes. [[#311](https://github.com/coinbase/cds/pull/311)]
+- Internal: update figma code connect config and some mapping files. [[#304](https://github.com/coinbase/cds/pull/304)]
+
+## 3.4.0-beta.12 (1/8/2026 PST)
+
+#### 🐞 Fixes
+
+- Fix pulse with spread operator broken on new react-native architecture. [[#296](https://github.com/coinbase/cds/pull/296)]
+
+## 3.4.0-beta.11 (1/7/2026 PST)
+
+#### 🐞 Fixes
+
+- Allow customization of axis tick mark and grid line alignment in band scale. [[#291](https://github.com/coinbase/cds/pull/291)]
+
+## 3.4.0-beta.10 (1/6/2026 PST)
+
+#### 🐞 Fixes
+
+- Fix axis clip line issues when multiple axes are present on one side. [[#285](https://github.com/coinbase/cds/pull/285)]
+
+## 3.4.0-beta.9 (12/18/2025 PST)
+
+#### 🐞 Fixes
+
+- Fix: update package exports. [[#261](https://github.com/coinbase/cds/pull/261)]
+
+#### 📘 Misc
+
+- Update storybook to use new Text import. [[#238](https://github.com/coinbase/cds/pull/238)]
+
+## 3.4.0-beta.8 (12/2/2025 PST)
+
+#### 🐞 Fixes
+
+- Fix reanimated animation warning. [[#211](https://github.com/coinbase/cds/pull/211)]
+
+## 3.4.0-beta.7 (12/2/2025 PST)
+
+#### 🐞 Fixes
+
+- Fix babel build issue with transitions. [[#201](https://github.com/coinbase/cds/pull/201)]
+- Improve opacity customization for ReferenceLine. [[#201](https://github.com/coinbase/cds/pull/201)]
+
+## 3.4.0-beta.6 (10/16/2025 PST)
+
+#### 🚀 Updates
+
+- Support connecting null values in Area and Line
+- Added label to XAxis and YAxis
+- Switched charts to @shopify/react-native-skia
+- Added gradient support
+
+## 3.4.0-beta.5 (11/4/2025 PST)
+
+This is an artificial version bump with no new change.
+
+## 3.4.0-beta.4 (10/27/2025 PST)
+
+This is an artificial version bump with no new change.
+
+## 3.4.0-beta.3 (10/6/2025 PST)
+
+This is an artificial version bump with no new change.
+
 ## 3.4.0-beta.2 (10/6/2025 PST)
 
 This is an artificial version bump with no new change.

package/dts/chart/CartesianChart.d.ts

@@ -1,9 +1,10 @@
 import React from 'react';
-import { type View, type ViewStyle } from 'react-native';
+import { type StyleProp, type View, type ViewStyle } from 'react-native';
 import type { BoxBaseProps, BoxProps } from '@coinbase/cds-mobile/layout';
+import { type SkTypefaceFontProvider } from '@shopify/react-native-skia';
 import { type ScrubberProviderProps } from './scrubber/ScrubberProvider';
-import { type AxisConfigProps, type ChartInset, type Series } from './utils';
-export type CartesianChartBaseProps = BoxBaseProps &
+import { type AxisConfigProps, type ChartInset, type LegendPosition, type Series } from './utils';
+export type CartesianChartBaseProps = Omit<BoxBaseProps, 'fontFamily'> &
   Pick<ScrubberProviderProps, 'enableScrubbing' | 'onScrubberPositionChange'> & {
     /**
      * Configuration objects that define how to visualize the data.
@@ -21,47 +22,67 @@ export type CartesianChartBaseProps = BoxBaseProps &
     xAxis?: Partial<Omit<AxisConfigProps, 'id'>>;
     /**
      * Configuration for y-axis(es). Can be a single config or array of configs.
-     * If array, first axis becomes default if no id is specified.
      */
     yAxis?: Partial<AxisConfigProps> | Partial<AxisConfigProps>[];
     /**
      * Inset around the entire chart (outside the axes).
      */
     inset?: number | Partial<ChartInset>;
+    /**
+     * Whether to show the legend or a custom legend element.
+     * - `true` renders the default Legend component
+     * - A React element renders that element as the legend
+     * - `false` or omitted hides the legend
+     */
+    legend?: boolean | React.ReactNode;
+    /**
+     * Position of the legend relative to the chart.
+     * @default 'bottom'
+     */
+    legendPosition?: LegendPosition;
+    /**
+     * Accessibility label for the legend group.
+     * @default 'Legend'
+     */
+    legendAccessibilityLabel?: string;
   };
 export type CartesianChartProps = CartesianChartBaseProps &
   Pick<ScrubberProviderProps, 'allowOverflowGestures'> &
-  BoxProps & {
+  Omit<BoxProps, 'fontFamily'> & {
+    /**
+     * Default font families to use within ChartText.
+     * If not provided, will be the default for the system.
+     * @example
+     * ['Helvetica', 'sans-serif']
+     */
+    fontFamilies?: string[];
+    /**
+     * Skia font provider to allow for custom fonts.
+     * If not provided, the only available fonts will be those defined by the system.
+     */
+    fontProvider?: SkTypefaceFontProvider;
     /**
-     * Chart width. If not provided, will use the container's measured width.
+     * Custom styles for the root element.
      */
-    width?: number | string;
+    style?: StyleProp<ViewStyle>;
     /**
-     * Chart height. If not provided, will use the container's measured height.
+     * Custom styles for the component.
      */
-    height?: number | string;
+    styles?: {
+      /**
+       * Custom styles for the root element.
+       */
+      root?: StyleProp<ViewStyle>;
+      /**
+       * Custom styles for the chart canvas element.
+       */
+      chart?: StyleProp<ViewStyle>;
+    };
   };
 export declare const CartesianChart: React.MemoExoticComponent<
   React.ForwardRefExoticComponent<
-    import('@coinbase/cds-mobile/styles/styleProps').StyleProps & {
-      children?: React.ReactNode;
-      style?: import('react-native').Animated.WithAnimatedValue<
-        import('react-native').StyleProp<ViewStyle>
-      >;
-      animated?: boolean;
-      elevation?: import('@coinbase/cds-common').ElevationLevels;
-      font?: import('@coinbase/cds-common').ThemeVars.FontFamily | 'inherit';
-      pin?: import('@coinbase/cds-common').PinningDirection;
-      bordered?: boolean;
-      borderedTop?: boolean;
-      borderedBottom?: boolean;
-      borderedStart?: boolean;
-      borderedEnd?: boolean;
-      borderedHorizontal?: boolean;
-      borderedVertical?: boolean;
-      dangerouslySetBackground?: string;
-      testID?: string;
-    } & Pick<ScrubberProviderProps, 'enableScrubbing' | 'onScrubberPositionChange'> & {
+    Omit<BoxBaseProps, 'fontFamily'> &
+      Pick<ScrubberProviderProps, 'enableScrubbing' | 'onScrubberPositionChange'> & {
         /**
          * Configuration objects that define how to visualize the data.
          * Each series contains its own data array.
@@ -78,23 +99,60 @@ export declare const CartesianChart: React.MemoExoticComponent<
         xAxis?: Partial<Omit<AxisConfigProps, 'id'>>;
         /**
          * Configuration for y-axis(es). Can be a single config or array of configs.
-         * If array, first axis becomes default if no id is specified.
          */
         yAxis?: Partial<AxisConfigProps> | Partial<AxisConfigProps>[];
         /**
          * Inset around the entire chart (outside the axes).
          */
         inset?: number | Partial<ChartInset>;
+        /**
+         * Whether to show the legend or a custom legend element.
+         * - `true` renders the default Legend component
+         * - A React element renders that element as the legend
+         * - `false` or omitted hides the legend
+         */
+        legend?: boolean | React.ReactNode;
+        /**
+         * Position of the legend relative to the chart.
+         * @default 'bottom'
+         */
+        legendPosition?: LegendPosition;
+        /**
+         * Accessibility label for the legend group.
+         * @default 'Legend'
+         */
+        legendAccessibilityLabel?: string;
       } & Pick<ScrubberProviderProps, 'allowOverflowGestures'> &
-      Omit<import('react-native').ViewProps, 'style'> & {
+      Omit<BoxProps, 'fontFamily'> & {
+        /**
+         * Default font families to use within ChartText.
+         * If not provided, will be the default for the system.
+         * @example
+         * ['Helvetica', 'sans-serif']
+         */
+        fontFamilies?: string[];
+        /**
+         * Skia font provider to allow for custom fonts.
+         * If not provided, the only available fonts will be those defined by the system.
+         */
+        fontProvider?: SkTypefaceFontProvider;
         /**
-         * Chart width. If not provided, will use the container's measured width.
+         * Custom styles for the root element.
          */
-        width?: number | string;
+        style?: StyleProp<ViewStyle>;
         /**
-         * Chart height. If not provided, will use the container's measured height.
+         * Custom styles for the component.
          */
-        height?: number | string;
+        styles?: {
+          /**
+           * Custom styles for the root element.
+           */
+          root?: StyleProp<ViewStyle>;
+          /**
+           * Custom styles for the chart canvas element.
+           */
+          chart?: StyleProp<ViewStyle>;
+        };
       } & React.RefAttributes<View>
   >
 >;

package/dts/chart/CartesianChart.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CartesianChart.d.ts","sourceRoot":"","sources":["../../src/chart/CartesianChart.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiD,MAAM,OAAO,CAAC;AACtE,OAAO,EAAE,KAAK,IAAI,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAG1E,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,UAAU,EAUf,KAAK,MAAM,EAEZ,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,uBAAuB,GAAG,YAAY,GAChD,IAAI,CAAC,qBAAqB,EAAE,iBAAiB,GAAG,0BAA0B,CAAC,GAAG;IAC5E;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC,CAAC;IAC7C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;IAC9D;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtC,CAAC;AAEJ,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GACvD,IAAI,CAAC,qBAAqB,EAAE,uBAAuB,CAAC,GACpD,QAAQ,GAAG;IACT;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B,CAAC;AAEJ,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;IAtCvB;;;OAGG;aACM,KAAK,CAAC,MAAM,CAAC;IACtB;;;OAGG;cACO,OAAO;IACjB;;OAEG;YACK,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;IAC5C;;;OAGG;YACK,OAAO,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC,eAAe,CAAC,EAAE;IAC7D;;OAEG;YACK,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;;IAMpC;;OAEG;YACK,MAAM,GAAG,MAAM;IACvB;;OAEG;aACM,MAAM,GAAG,MAAM;+BAuS3B,CAAC"}
+{"version":3,"file":"CartesianChart.d.ts","sourceRoot":"","sources":["../../src/chart/CartesianChart.tsx"],"names":[],"mappings":"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"}

package/dts/chart/ChartContextBridge.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Simplified context bridge utilities for React Native.
+ * Adapted from its-fine to enable context sharing across React renderers
+ * https://github.com/pmndrs/its-fine/blob/598b81f02778c22ed21121c2b1a786bdefb14e23/src/index.tsx
+ */
+import * as React from 'react';
+/**
+ * A react-internal tree node provider that binds React children to the React tree for chart context bridging.
+ */
+export declare class ChartBridgeProvider extends React.Component<{
+  children?: React.ReactNode;
+}> {
+  private _reactInternals;
+  render(): import('react/jsx-runtime').JSX.Element;
+}
+export type ContextMap = Map<React.Context<any>, any> & {
+  get<T>(context: React.Context<T>): T | undefined;
+};
+/**
+ * Represents a chart context bridge provider component.
+ */
+export type ChartContextBridge = React.FC<React.PropsWithChildren<object>>;
+/**
+ * Returns a ChartContextBridge of live context providers to pierce Context across renderers.
+ * Pass ChartContextBridge as a component to a secondary renderer (e.g., Skia Canvas) to enable context-sharing in charts.
+ */
+export declare function useChartContextBridge(): ChartContextBridge;
+//# sourceMappingURL=ChartContextBridge.d.ts.map

package/dts/chart/ChartContextBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChartContextBridge.d.ts","sourceRoot":"","sources":["../../src/chart/ChartContextBridge.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAuF/B;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK,CAAC,SAAS,CAAC;IAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC;IACtF,OAAO,CAAC,eAAe,CAAY;IAEnC,MAAM;CAOP;AA4BD,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG;IACtD,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;CAClD,CAAC;AAmCF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC;AAE3E;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAgB1D"}

package/dts/chart/ChartProvider.d.ts

@@ -1,4 +1,7 @@
 import type { CartesianChartContextValue } from './utils';
+export declare const CartesianChartContext: import('react').Context<
+  CartesianChartContextValue | undefined
+>;
 export declare const useCartesianChartContext: () => CartesianChartContextValue;
 export declare const CartesianChartProvider: import('react').Provider<
   CartesianChartContextValue | undefined

package/dts/chart/ChartProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ChartProvider.d.ts","sourceRoot":"","sources":["../../src/chart/ChartProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAI1D,eAAO,MAAM,wBAAwB,QAAO,0BAQ3C,CAAC;AAEF,eAAO,MAAM,sBAAsB,kEAAiC,CAAC"}
+{"version":3,"file":"ChartProvider.d.ts","sourceRoot":"","sources":["../../src/chart/ChartProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,SAAS,CAAC;AAE1D,eAAO,MAAM,qBAAqB,iEAEjC,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAO,0BAQ3C,CAAC;AAEF,eAAO,MAAM,sBAAsB,kEAAiC,CAAC"}

package/dts/chart/Path.d.ts

@@ -1,48 +1,113 @@
-import { type PathProps as SvgPathProps } from 'react-native-svg';
-import type { Rect as RectType, SharedProps } from '@coinbase/cds-common/types';
-export type PathProps = SharedProps &
-  SvgPathProps & {
+import type { Rect } from '@coinbase/cds-common/types';
+import { type AnimatedProp, type PathProps as SkiaPathProps } from '@shopify/react-native-skia';
+import { type Transition } from './utils/transition';
+/**
+ * Duration in milliseconds for path enter transition.
+ */
+export declare const pathEnterTransitionDuration = 500;
+export type PathBaseProps = {
+  /**
+   * Whether to animate this path. Overrides the animate prop on the Chart component.
+   */
+  animate?: boolean;
+  /**
+   * Initial path for enter animation.
+   * When provided, the first animation will go from initialPath to d.
+   * If not provided, defaults to d (no enter animation).
+   */
+  initialPath?: string;
+  /**
+   * Fill color for the path.
+   * When provided, will render a fill with the given color.
+   * If not provided, will not render a fill.
+   */
+  fill?: string;
+  /**
+   * Opacity for the path fill.
+   */
+  fillOpacity?: number;
+  /**
+   * Stroke color for the path.
+   * When provided, will render a fill with the given color.
+   * If not provided, will not render a fill.
+   */
+  stroke?: string;
+  /**
+   * Opacity for the path stroke.
+   */
+  strokeOpacity?: AnimatedProp<number>;
+};
+export type PathProps = PathBaseProps &
+  Pick<
+    SkiaPathProps,
+    | 'antiAlias'
+    | 'blendMode'
+    | 'children'
+    | 'dither'
+    | 'invertClip'
+    | 'origin'
+    | 'matrix'
+    | 'strokeCap'
+    | 'strokeJoin'
+    | 'strokeMiter'
+    | 'strokeWidth'
+    | 'style'
+    | 'transform'
+  > & {
     /**
-     * The SVG path data string
+     * Transition configuration for enter and update animations.
+     * @note Disable an animation by passing in null.
+     *
+     * @default transitions = {{
+     *   enter: { type: 'timing', duration: 500 },
+     *   update: { type: 'spring', stiffness: 900, damping: 120 }
+     * }}
+     *
+     * @example
+     * // Custom enter and update transitions
+     * transitions={{ enter: { type: 'timing', duration: 300 }, update: { type: 'spring', damping: 20 } }}
+     *
+     * @example
+     * // Disable enter animation
+     * transitions={{ enter: null }}
      */
-    d?: string;
+    transitions?: {
+      /**
+       * Transition for the initial enter/reveal animation.
+       * Set to `null` to disable.
+       */
+      enter?: Transition | null;
+      /**
+       * Transition for subsequent data update animations.
+       * Set to `null` to disable.
+       */
+      update?: Transition | null;
+    };
     /**
-     * Path fill color
+     * Transition for updates.
+     * @deprecated Use `transitions.update` instead.
      */
-    fill?: string;
+    transition?: Transition;
     /**
-     * Path stroke color
+     * The SVG path data string.
      */
-    stroke?: string;
+    d?: AnimatedProp<string | undefined>;
     /**
-     * Path stroke width
+     * Offset added to the clip rect boundaries.
      */
-    strokeWidth?: number;
-    /**
-     * Path stroke opacity
-     */
-    strokeOpacity?: number;
+    clipOffset?: number;
     /**
-     * Path fill opacity
+     * Custom clip path.
+     * When set, overrides clipRect.
+     * @note pass null to disable clipping.
      */
-    fillOpacity?: number;
+    clipPath?: string | null;
     /**
      * Custom clip path rect. If provided, this overrides the default chart rect for clipping.
+     * @default drawingArea of chart + clipOffset
+     * Will be overridden by clipPath if set.
      */
-    clipRect?: RectType;
-    /**
-     * Stroke dash array for dashed lines
-     */
-    strokeDasharray?: string;
-    /**
-     * Whether to animate the path.
-     * Overrides the animate prop on the Chart component.
-     */
-    animate?: boolean;
-    /**
-     * The offset to add to the clip rect boundaries.
-     */
-    clipOffset?: number;
+    clipRect?: Rect;
   };
 export declare const Path: import('react').NamedExoticComponent<PathProps>;
 //# sourceMappingURL=Path.d.ts.map

package/dts/chart/Path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../src/chart/Path.tsx"],"names":[],"mappings":"AAQA,OAAO,EAKL,KAAK,SAAS,IAAI,YAAY,EAG/B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAmChF,MAAM,MAAM,SAAS,GAAG,WAAW,GACjC,YAAY,GAAG;IACb;;OAEG;IACH,CAAC,CAAC,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ,eAAO,MAAM,IAAI,iDA2HhB,CAAC"}
+{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../src/chart/Path.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EACL,KAAK,YAAY,EAGjB,KAAK,SAAS,IAAI,aAAa,EAGhC,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAIL,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAI5B;;GAEG;AACH,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,aAAa,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,aAAa,GACnC,IAAI,CACF,aAAa,EACX,WAAW,GACX,WAAW,GACX,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,YAAY,GACZ,aAAa,GACb,aAAa,GACb,OAAO,GACP,WAAW,CACd,GAAG;IACF;;;;;;;;;;;;;;;;OAgBG;IACH,WAAW,CAAC,EAAE;QACZ;;;WAGG;QACH,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC1B;;;WAGG;QACH,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAC5B,CAAC;IACF;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,CAAC,CAAC,EAAE,YAAY,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IACrC;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;CACjB,CAAC;AA0EJ,eAAO,MAAM,IAAI,iDAyKf,CAAC"}

package/dts/chart/PeriodSelector.d.ts

@@ -1,13 +1,13 @@
 import React from 'react';
 import { View } from 'react-native';
 import { type SegmentedTabsProps, type TabsActiveIndicatorProps } from '@coinbase/cds-mobile/tabs';
-import { type TextBaseProps } from '@coinbase/cds-mobile/typography/Text';
+import { type TextBaseProps } from '@coinbase/cds-mobile/typography';
 export declare const PeriodSelectorActiveIndicator: ({
   activeTabRect,
   background,
   position,
   borderRadius,
-}: TabsActiveIndicatorProps) => import('react/jsx-runtime').JSX.Element | null;
+}: TabsActiveIndicatorProps) => import('react/jsx-runtime').JSX.Element | undefined;
 export type LiveTabLabelBaseProps = TextBaseProps & {
   /**
    * The label to display.
@@ -62,23 +62,16 @@ export declare const LiveTabLabel: React.MemoExoticComponent<
     } & React.RefAttributes<View>
   >
 >;
-export type PeriodSelectorProps = SegmentedTabsProps;
+export type PeriodSelectorProps = Omit<SegmentedTabsProps, 'styles'> &
+  Pick<SegmentedTabsProps, 'styles'>;
 /**
  * PeriodSelector is a specialized version of SegmentedTabs optimized for chart period selection.
  * It provides transparent background, primary wash active state, and full-width layout by default.
  */
 export declare const PeriodSelector: React.MemoExoticComponent<
   React.ForwardRefExoticComponent<
-    Partial<
-      Pick<
-        import('@coinbase/cds-mobile/tabs').TabsProps<string>,
-        'TabComponent' | 'TabsActiveIndicatorComponent'
-      >
-    > &
-      Omit<
-        import('@coinbase/cds-mobile/tabs').TabsProps<string>,
-        'TabComponent' | 'TabsActiveIndicatorComponent'
-      > &
+    Omit<SegmentedTabsProps, 'styles'> &
+      Pick<SegmentedTabsProps, 'styles'> &
       React.RefAttributes<any>
   >
 >;

package/dts/chart/PeriodSelector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeriodSelector.d.ts","sourceRoot":"","sources":["../../src/chart/PeriodSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAc,IAAI,EAAkB,MAAM,cAAc,CAAC;AAGhE,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAGhF,eAAO,MAAM,6BAA6B,GAAI,wDAK3C,wBAAwB,mDAmD1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAStD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;IAxBvB;;;OAGG;YACK,MAAM;IACd;;OAEG;cACO,OAAO;IACjB;;OAEG;YACK,GAAG;+BAyCZ,CAAC;AASF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,cAAc,6TA0B1B,CAAC"}
+{"version":3,"file":"PeriodSelector.d.ts","sourceRoot":"","sources":["../../src/chart/PeriodSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,EAAc,IAAI,EAAkB,MAAM,cAAc,CAAC;AAGhE,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAG3E,eAAO,MAAM,6BAA6B,GAAI,wDAK3C,wBAAwB,wDAmD1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAAG;IAClD;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAStD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;IAxBvB;;;OAGG;YACK,MAAM;IACd;;OAEG;cACO,OAAO;IACjB;;OAEG;YACK,GAAG;+BAyCZ,CAAC;AASF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,GAClE,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC,CAAC;AAErC;;;GAGG;AACH,eAAO,MAAM,cAAc,gKA0B1B,CAAC"}

package/dts/chart/area/Area.d.ts

@@ -1,33 +1,15 @@
 import React from 'react';
-import type { Rect } from '@coinbase/cds-common/types';
+import type { PathBaseProps, PathProps } from '../Path';
 import { type ChartPathCurveType } from '../utils';
-export type AreaComponentProps = {
-  d: string;
-  fill: string;
-  fillOpacity?: number;
-  clipRect?: Rect;
-  stroke?: string;
-  strokeWidth?: number;
-  /**
-   * ID of the y-axis to use.
-   * If not provided, defaults to the default y-axis.
-   */
-  yAxisId?: string;
-  /**
-   * Baseline value for the gradient.
-   * When set, overrides the default baseline.
-   */
-  baseline?: number;
-};
-export type AreaComponent = React.FC<AreaComponentProps>;
-export type AreaProps = {
+import type { GradientDefinition } from '../utils/gradient';
+export type AreaBaseProps = {
   /**
    * The ID of the series to render. Will be used to find the data from the chart context.
    */
   seriesId: string;
   /**
    * The curve interpolation method to use for the line.
-   * @default 'linear'
+   * @default 'bump'
    */
   curve?: ChartPathCurveType;
   /**
@@ -40,23 +22,52 @@ export type AreaProps = {
    * Takes precedence over the type prop if provided.
    */
   AreaComponent?: AreaComponent;
+  /**
+   * When true, the area is connected across null values.
+   */
+  connectNulls?: boolean;
   /**
    * The color of the area.
-   * @default color of the series or theme.color.fgPrimary
+   * @default color of the series or 'var(--color-fgPrimary)'
    */
-  fill?: string;
+  fill?: PathBaseProps['fill'];
   /**
-   * Opacity of the area.
+   * Opacity of the area
+   * @note when combined with gradient, both will be applied
    * @default 1
    */
-  fillOpacity?: number;
-  stroke?: string;
-  strokeWidth?: number;
+  fillOpacity?: PathBaseProps['fillOpacity'];
   /**
    * Baseline value for the gradient.
    * When set, overrides the default baseline.
    */
   baseline?: number;
+  /**
+   * Gradient configuration.
+   * When provided, creates gradient or threshold-based coloring.
+   */
+  gradient?: GradientDefinition;
+  /**
+   * Whether to animate the area.
+   * Overrides the animate value from the chart context.
+   */
+  animate?: PathBaseProps['animate'];
+};
+export type AreaProps = AreaBaseProps & Pick<PathProps, 'transitions' | 'transition'>;
+export type AreaComponentProps = Pick<
+  AreaProps,
+  'fill' | 'fillOpacity' | 'baseline' | 'gradient' | 'animate' | 'transitions' | 'transition'
+> & {
+  /**
+   * Path of the area
+   */
+  d: string;
+  /**
+   * ID of the y-axis to use.
+   * If not provided, defaults to the default y-axis.
+   */
+  yAxisId?: string;
 };
+export type AreaComponent = React.FC<AreaComponentProps>;
 export declare const Area: React.NamedExoticComponent<AreaProps>;
 //# sourceMappingURL=Area.d.ts.map