@coinbase/cds-web-visualization 3.3.0 → 3.4.0-beta.1

package/CHANGELOG.md

@@ -0,0 +1,26 @@
+# @coinbase/cds-web-visualization
+
+> [NPM registry](https://www.npmjs.com/package/@coinbase/cds-web-visualization)
+
+All notable changes to this project will be documented in this file.
+
+`@coinbase/cds-web-visualization` adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+<!-- template-start -->
+
+## 3.4.0-beta.1 (10/3/2025 PST)
+
+#### 🚀 Updates
+
+- Introduces new data visualization components: CartesianChart, LineChart, BarChart, etc,
+- Deprecates Sparkline components.
+
+## 3.3.1 (10/1/2025 PST)
+
+#### 🐞 Fixes
+
+- Update links for new repo. [[#42](https://github.com/coinbase/cds/pull/42)]
+
+## 3.3.0 (9/18/2025 PST)
+
+- Prepare for open source release.

package/dts/chart/CartesianChart.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import { type BoxBaseProps, type BoxProps } from '@coinbase/cds-web/layout';
+import { type ScrubberProviderProps } from './scrubber/ScrubberProvider';
+import { type AxisConfigProps, type ChartInset, type Series } from './utils';
+export type CartesianChartBaseProps = BoxBaseProps &
+  Pick<ScrubberProviderProps, 'enableScrubbing' | 'onScrubberPositionChange'> & {
+    /**
+     * Configuration objects that define how to visualize the data.
+     * Each series contains its own data array.
+     */
+    series?: Array<Series>;
+    /**
+     * Whether to animate the chart.
+     * @default true
+     */
+    animate?: boolean;
+    /**
+     * Configuration for x-axis.
+     */
+    xAxis?: Partial<Omit<AxisConfigProps, 'id'>>;
+    /**
+     * Configuration for y-axis(es). First defined axis becomes default.
+     */
+    yAxis?: Partial<Omit<AxisConfigProps, 'data'>> | Partial<Omit<AxisConfigProps, 'data'>>[];
+    /**
+     * Inset around the entire chart (outside the axes).
+     */
+    inset?: number | Partial<ChartInset>;
+  };
+export type CartesianChartProps = BoxProps<'svg'> & CartesianChartBaseProps;
+export declare const CartesianChart: React.MemoExoticComponent<
+  React.ForwardRefExoticComponent<
+    Omit<CartesianChartProps, 'ref'> & React.RefAttributes<SVGSVGElement>
+  >
+>;
+//# sourceMappingURL=CartesianChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CartesianChart.d.ts","sourceRoot":"","sources":["../../src/chart/CartesianChart.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyD,MAAM,OAAO,CAAC;AAI9E,OAAO,EAAO,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGjF,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE3F,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,UAAU,EAUf,KAAK,MAAM,EAEZ,MAAM,SAAS,CAAC;AAYjB,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;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC1F;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACtC,CAAC;AAEJ,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,uBAAuB,CAAC;AAE5E,eAAO,MAAM,cAAc,mIAqS1B,CAAC"}

package/dts/chart/ChartProvider.d.ts

@@ -0,0 +1,6 @@
+import type { CartesianChartContextValue } from './utils/context';
+export declare const useCartesianChartContext: () => CartesianChartContextValue;
+export declare const CartesianChartProvider: import('react').Provider<
+  CartesianChartContextValue | undefined
+>;
+//# sourceMappingURL=ChartProvider.d.ts.map

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

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

package/dts/chart/Path.d.ts

@@ -0,0 +1,34 @@
+import 'd3-transition';
+import type { SVGProps } from 'react';
+import type { Rect, SharedProps } from '@coinbase/cds-common/types';
+export type PathProps = SharedProps &
+  Omit<
+    SVGProps<SVGPathElement>,
+    | 'onAnimationStart'
+    | 'onAnimationEnd'
+    | 'onAnimationIteration'
+    | 'onAnimationStartCapture'
+    | 'onAnimationEndCapture'
+    | 'onAnimationIterationCapture'
+    | 'onDrag'
+    | 'onDragEnd'
+    | 'onDragStart'
+    | 'onDragCapture'
+    | 'onDragEndCapture'
+    | 'onDragStartCapture'
+  > & {
+    /**
+     * Whether to animate this path. Overrides the animate prop on the Chart component.
+     */
+    animate?: boolean;
+    /**
+     * Custom clip path rect. If provided, this overrides the default chart rect for clipping.
+     */
+    clipRect?: Rect;
+    /**
+     * The offset to add to the clip rect boundaries.
+     */
+    clipOffset?: number;
+  };
+export declare const Path: import('react').NamedExoticComponent<PathProps>;
+//# sourceMappingURL=Path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Path.d.ts","sourceRoot":"","sources":["../../src/chart/Path.tsx"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AAGvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAOpE,MAAM,MAAM,SAAS,GAAG,WAAW,GACjC,IAAI,CACF,QAAQ,CAAC,cAAc,CAAC,EACtB,kBAAkB,GAClB,gBAAgB,GAChB,sBAAsB,GACtB,yBAAyB,GACzB,uBAAuB,GACvB,6BAA6B,GAC7B,QAAQ,GACR,WAAW,GACX,aAAa,GACb,eAAe,GACf,kBAAkB,GAClB,oBAAoB,CACvB,GAAG;IACF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,IAAI,CAAC;IAChB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ,eAAO,MAAM,IAAI,iDAuEhB,CAAC"}

package/dts/chart/PeriodSelector.d.ts

@@ -0,0 +1,61 @@
+import React from 'react';
+import type { Polymorphic } from '@coinbase/cds-web/core/polymorphism';
+import { type SegmentedTabsProps, type TabsActiveIndicatorProps } from '@coinbase/cds-web/tabs';
+import { type TextBaseProps } from '@coinbase/cds-web/typography';
+export declare const PeriodSelectorActiveIndicator: React.MemoExoticComponent<
+  ({
+    activeTabRect,
+    background,
+    position,
+    borderRadius,
+    style,
+  }: TabsActiveIndicatorProps) => import('react/jsx-runtime').JSX.Element | null
+>;
+export declare const liveTabLabelDefaultElement = 'span';
+export type LiveTabLabelDefaultElement = typeof liveTabLabelDefaultElement;
+export type LiveTabLabelBaseProps = TextBaseProps & {
+  /**
+   * The label to display.
+   * @default 'LIVE'
+   */
+  label?: string;
+  /**
+   * Whether to hide the dot.
+   */
+  hideDot?: boolean;
+  /**
+   * Whether to disable the pulse animation.
+   */
+  disablePulse?: boolean;
+};
+export type LiveTabLabelProps<AsComponent extends React.ElementType> = Polymorphic.Props<
+  AsComponent,
+  LiveTabLabelBaseProps
+>;
+type LiveTabLabelComponent = (<AsComponent extends React.ElementType = LiveTabLabelDefaultElement>(
+  props: LiveTabLabelProps<AsComponent>,
+) => Polymorphic.ReactReturn) &
+  Polymorphic.ReactNamed;
+export declare const LiveTabLabel: LiveTabLabelComponent;
+export type PeriodSelectorProps = SegmentedTabsProps;
+/**
+ * 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-web/tabs').TabsProps<string>,
+        'TabComponent' | 'TabsActiveIndicatorComponent'
+      >
+    > &
+      Omit<
+        import('@coinbase/cds-web/tabs').TabsProps<string>,
+        'TabComponent' | 'TabsActiveIndicatorComponent'
+      > &
+      React.RefAttributes<HTMLElement>
+  >
+>;
+export {};
+//# sourceMappingURL=PeriodSelector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PeriodSelector.d.ts","sourceRoot":"","sources":["../../src/chart/PeriodSelector.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC;AAEvE,OAAO,EAEL,KAAK,kBAAkB,EAEvB,KAAK,wBAAwB,EAE9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAaxE,eAAO,MAAM,6BAA6B,4FAOrC,wBAAwB,oDAwB5B,CAAC;AAEF,eAAO,MAAM,0BAA0B,SAAS,CAAC;AAEjD,MAAM,MAAM,0BAA0B,GAAG,OAAO,0BAA0B,CAAC;AAE3E,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,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,WAAW,SAAS,KAAK,CAAC,WAAW,IAAI,WAAW,CAAC,KAAK,CACtF,WAAW,EACX,qBAAqB,CACtB,CAAC;AAYF,KAAK,qBAAqB,GAAG,CAAC,CAAC,WAAW,SAAS,KAAK,CAAC,WAAW,GAAG,0BAA0B,EAC/F,KAAK,EAAE,iBAAiB,CAAC,WAAW,CAAC,KAClC,WAAW,CAAC,WAAW,CAAC,GAC3B,WAAW,CAAC,UAAU,CAAC;AAEzB,eAAO,MAAM,YAAY,EAAE,qBA+C1B,CAAC;AASF,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,cAAc,+TA0B1B,CAAC"}

package/dts/chart/Point.d.ts

@@ -0,0 +1,153 @@
+import React from 'react';
+import type { SVGProps } from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import type { ChartTextChildren } from './text/ChartText';
+import { type ChartTextProps } from './text';
+/**
+ * Parameters passed to renderPoints callback function.
+ */
+export type RenderPointsParams = {
+  /**
+   * X coordinate in SVG pixel space.
+   */
+  x: number;
+  /**
+   * Y coordinate in SVG pixel space.
+   */
+  y: number;
+  /**
+   * X coordinate in data space (usually same as index).
+   */
+  dataX: number;
+  /**
+   * Y coordinate in data space (same as value).
+   */
+  dataY: number;
+};
+/**
+ * Shared configuration for point appearance and behavior.
+ * Used by line-associated points rendered via Line/LineChart components.
+ */
+export type PointConfig = {
+  /**
+   * The fill color of the point.
+   */
+  fill?: string;
+  /**
+   * Optional Y-axis id to specify which axis to plot along.
+   * Defaults to the first y-axis
+   */
+  yAxisId?: string;
+  /**
+   * Radius of the point.
+   * @default 4
+   */
+  radius?: number;
+  /**
+   * Opacity of the point.
+   */
+  opacity?: number;
+  /**
+   * Handler for when the point is clicked.
+   */
+  onClick?: (
+    event: React.MouseEvent,
+    point: {
+      x: number;
+      y: number;
+      dataX: number;
+      dataY: number;
+    },
+  ) => void;
+  /**
+   * Handler for when the scrubber enters this point.
+   */
+  onScrubberEnter?: (point: { x: number; y: number }) => void;
+  /**
+   * Color of the outer stroke around the point.
+   * @default 'var(--color-bg)'
+   */
+  stroke?: string;
+  /**
+   * Outer stroke width of the point.
+   * Set to  0 to remove the stroke.
+   * @default 2
+   */
+  strokeWidth?: number;
+  /**
+   * Custom class name for the point.
+   */
+  className?: string;
+  /**
+   * Custom styles for the point.
+   */
+  style?: React.CSSProperties;
+  /**
+   * Accessibility label for screen readers to describe the point.
+   * If not provided, a default label will be generated using the data coordinates.
+   */
+  accessibilityLabel?: string;
+  /**
+   * Simple text label to display at the point position.
+   * If provided, a ChartText will be automatically rendered.
+   */
+  label?: ChartTextChildren;
+  /**
+   * Configuration for the automatically rendered label.
+   * Only used when `label` prop is provided.
+   */
+  labelProps?: Omit<ChartTextProps, 'x' | 'y' | 'children'>;
+};
+export type PointProps = SharedProps &
+  PointConfig &
+  Omit<SVGProps<SVGCircleElement>, 'onClick'> & {
+    /**
+     * X coordinate in data space (not pixel coordinates).
+     */
+    dataX: number;
+    /**
+     * Y coordinate in data space (not pixel coordinates).
+     */
+    dataY: number;
+    /**
+     * Coordinates in SVG pixel space.
+     * Overrides dataX and dataY for pixel coordinate calculation.
+     */
+    pixelCoordinates?: {
+      x: number;
+      y: number;
+    };
+    /**
+     * Override the chart's animation setting for this specific point.
+     * When undefined, uses the chart context's animation setting.
+     */
+    animate?: boolean;
+    /**
+     * Custom class names for the component.
+     */
+    classNames?: {
+      /**
+       * Custom class name for the point container element.
+       */
+      container?: string;
+      /**
+       * Custom class name for the inner circle element.
+       */
+      point?: string;
+    };
+    /**
+     * Custom styles for the component.
+     */
+    styles?: {
+      /**
+       * Custom styles for the point container element.
+       */
+      container?: React.CSSProperties;
+      /**
+       * Custom styles for the inner circle element.
+       */
+      point?: React.CSSProperties;
+    };
+  };
+export declare const Point: React.NamedExoticComponent<PointProps>;
+//# sourceMappingURL=Point.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Point.d.ts","sourceRoot":"","sources":["../../src/chart/Point.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmC,MAAM,OAAO,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAK9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,QAAQ,CAAC;AAqBxD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,CAAC,EAAE,CACR,KAAK,EAAE,KAAK,CAAC,UAAU,EACvB,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAC1D,IAAI,CAAC;IACV;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5D;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,GAAG,GAAG,GAAG,UAAU,CAAC,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,WAAW,GAClC,WAAW,GACX,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,SAAS,CAAC,GAAG;IAC5C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,gBAAgB,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAChC;;WAEG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;KAC7B,CAAC;CACH,CAAC;AAEJ,eAAO,MAAM,KAAK,wCAsKjB,CAAC"}

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

@@ -0,0 +1,48 @@
+import React from 'react';
+import type { SVGProps } from 'react';
+import { type ChartPathCurveType } from '../utils';
+export type AreaComponentProps = {
+  d: SVGProps<SVGPathElement>['d'];
+  /**
+   * The color of the area.
+   * @default color of the series or 'var(--color-fgPrimary)'
+   */
+  fill?: string;
+  fillOpacity?: number;
+  stroke?: string;
+  strokeWidth?: number;
+  yAxisId?: string;
+  animate?: boolean;
+  /**
+   * Baseline value for the gradient.
+   * When set, overrides the default baseline.
+   */
+  baseline?: number;
+};
+export type AreaComponent = React.FC<AreaComponentProps>;
+export type AreaProps = Pick<
+  AreaComponentProps,
+  'fill' | 'fillOpacity' | 'stroke' | 'strokeWidth' | 'baseline'
+> & {
+  /**
+   * 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'
+   */
+  curve?: ChartPathCurveType;
+  /**
+   * The type of area to render.
+   * @default 'solid'
+   */
+  type?: 'solid' | 'dotted' | 'gradient';
+  /**
+   * Component to render the area.
+   * Takes precedence over the type prop if provided.
+   */
+  AreaComponent?: AreaComponent;
+};
+export declare const Area: React.NamedExoticComponent<AreaProps>;
+//# sourceMappingURL=Area.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Area.d.ts","sourceRoot":"","sources":["../../../src/chart/area/Area.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,UAAU,CAAC;AAMhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,IAAI,CAC1B,kBAAkB,EAClB,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,CAC/D,GAAG;IACF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACvC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAEF,eAAO,MAAM,IAAI,uCAmFhB,CAAC"}

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

@@ -0,0 +1,52 @@
+import { type XAxisProps, type YAxisProps } from '../axis';
+import { type CartesianChartProps } from '../CartesianChart';
+import { type LineProps } from '../line/Line';
+import { type AxisConfigProps, type Series } from '../utils';
+import { type AreaProps } from './Area';
+export type AreaSeries = Series &
+  Partial<Pick<AreaProps, 'AreaComponent' | 'curve' | 'fillOpacity' | 'type' | 'fill'>> &
+  Partial<Pick<LineProps, 'LineComponent' | 'strokeWidth' | 'stroke' | 'opacity'>>;
+export type AreaChartProps = Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'> &
+  Pick<AreaProps, 'AreaComponent' | 'curve' | 'fillOpacity' | 'type'> &
+  Pick<LineProps, 'LineComponent' | 'strokeWidth'> & {
+    /**
+     * Configuration objects that define how to visualize the data.
+     * Each series supports Area and Line component props for individual customization.
+     */
+    series?: Array<AreaSeries>;
+    /**
+     * Whether to stack the areas on top of each other.
+     * When true, each series builds cumulative values on top of the previous series.
+     *
+     * **Note**: Only applies to series data containing singular numbers (e.g., `[10, 20, 30]`).
+     * Series with [baseline, value] tuples (e.g., `[[0, 10], [0, -5]]`) will be skipped during stacking
+     * and rendered as-is.
+     */
+    stacked?: boolean;
+    /**
+     * Whether to show the X axis.
+     */
+    showXAxis?: boolean;
+    /**
+     * Whether to show the Y axis.
+     */
+    showYAxis?: boolean;
+    /**
+     * Whether to show lines on top of the areas.
+     * Useful for stacked contexts to show the outline of each area.
+     */
+    showLines?: boolean;
+    /**
+     * The type of line to render.
+     * @default 'solid'
+     */
+    lineType?: 'solid' | 'dotted' | 'gradient';
+    xAxis?: Partial<AxisConfigProps> & XAxisProps;
+    yAxis?: Partial<AxisConfigProps> & YAxisProps;
+  };
+export declare const AreaChart: import('react').MemoExoticComponent<
+  import('react').ForwardRefExoticComponent<
+    Omit<AreaChartProps, 'ref'> & import('react').RefAttributes<SVGSVGElement>
+  >
+>;
+//# sourceMappingURL=AreaChart.d.ts.map

package/dts/chart/area/AreaChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AreaChart.d.ts","sourceRoot":"","sources":["../../../src/chart/area/AreaChart.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,UAAU,EAAS,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,KAAK,eAAe,EAIpB,KAAK,MAAM,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAC7B,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,GAAG,MAAM,CAAC,CAAC,GACrF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC;AAEnF,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GAClF,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC,GACnE,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG,aAAa,CAAC,GAAG;IACjD;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3B;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE3C,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;CAC/C,CAAC;AAEJ,eAAO,MAAM,SAAS,4JAuKrB,CAAC"}

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

@@ -0,0 +1,68 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type DottedAreaProps = Omit<PathProps, 'd' | 'fill' | 'fillOpacity' | 'clipRect'> &
+  Omit<AreaComponentProps, 'clipRect'> & {
+    /**
+     * Size of the pattern unit (width and height).
+     * @default 4
+     */
+    patternSize?: number;
+    /**
+     * Size of the dots within the pattern.
+     * @default 1
+     */
+    dotSize?: number;
+    /**
+     * Opacity at the peak values (top/bottom of gradient).
+     * @default 0.3
+     */
+    peakOpacity?: number;
+    /**
+     * Opacity at the baseline (0 or edge closest to 0).
+     * @default 0
+     */
+    baselineOpacity?: number;
+    /**
+     * ID of the y-axis to use for gradient range.
+     * If not provided, defaults to the default y-axis.
+     */
+    yAxisId?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    /**
+     * Custom class names for the component.
+     */
+    classNames?: {
+      /**
+       * Custom class name for the root element.
+       */
+      root?: string;
+      /**
+       * Custom class name for the pattern element.
+       */
+      pattern?: string;
+      /**
+       * Custom class name for the area path element.
+       */
+      path?: string;
+    };
+    /**
+     * Custom styles for the component.
+     */
+    styles?: {
+      /**
+       * Custom styles for the root element.
+       */
+      root?: React.CSSProperties;
+      /**
+       * Custom styles for the pattern element.
+       */
+      pattern?: React.CSSProperties;
+      /**
+       * Custom styles for the area path element.
+       */
+      path?: React.CSSProperties;
+    };
+  };
+export declare const DottedArea: import('react').NamedExoticComponent<DottedAreaProps>;
+//# sourceMappingURL=DottedArea.d.ts.map

package/dts/chart/area/DottedArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DottedArea.d.ts","sourceRoot":"","sources":["../../../src/chart/area/DottedArea.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC,GACtF,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,GAAG;IACrC;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC3B;;WAEG;QACH,OAAO,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC9B;;WAEG;QACH,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;KAC5B,CAAC;CACH,CAAC;AAEJ,eAAO,MAAM,UAAU,uDA+HtB,CAAC"}

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

@@ -0,0 +1,30 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type GradientAreaProps = Omit<PathProps, 'd' | 'fill' | 'fillOpacity'> &
+  AreaComponentProps & {
+    /**
+     * The color at peak values (top/bottom of gradient).
+     * @default fill or 'var(--color-fgPrimary)'
+     */
+    peakColor?: string;
+    /**
+     * The color at the baseline (0 or edge closest to 0).
+     * @default peakColor or fill
+     */
+    baselineColor?: string;
+    /**
+     * Opacity at peak values.
+     * @default 0.3
+     */
+    peakOpacity?: number;
+    /**
+     * Opacity at the baseline.
+     * @default 0
+     */
+    baselineOpacity?: number;
+  };
+/**
+ * A customizable gradient area component which uses Path.
+ */
+export declare const GradientArea: import('react').NamedExoticComponent<GradientAreaProps>;
+//# sourceMappingURL=GradientArea.d.ts.map

package/dts/chart/area/GradientArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GradientArea.d.ts","sourceRoot":"","sources":["../../../src/chart/area/GradientArea.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,GAC3E,kBAAkB,GAAG;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,YAAY,yDAsGxB,CAAC"}

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

@@ -0,0 +1,8 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type SolidAreaProps = Omit<PathProps, 'd' | 'fill' | 'fillOpacity'> & AreaComponentProps;
+/**
+ * A customizable solid area component which uses Path.
+ */
+export declare const SolidArea: import('react').NamedExoticComponent<SolidAreaProps>;
+//# sourceMappingURL=SolidArea.d.ts.map

package/dts/chart/area/SolidArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidArea.d.ts","sourceRoot":"","sources":["../../../src/chart/area/SolidArea.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,MAAM,GAAG,aAAa,CAAC,GAAG,kBAAkB,CAAC;AAEhG;;GAEG;AACH,eAAO,MAAM,SAAS,sDAIrB,CAAC"}

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

@@ -0,0 +1,6 @@
+export * from './Area';
+export * from './AreaChart';
+export * from './DottedArea';
+export * from './GradientArea';
+export * from './SolidArea';
+//# sourceMappingURL=index.d.ts.map

package/dts/chart/area/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/area/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}