@coinbase/cds-mobile-visualization 3.3.0 → 3.4.0-beta.10

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

@@ -0,0 +1,46 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type DottedAreaProps = Pick<
+  PathProps,
+  | 'initialPath'
+  | 'children'
+  | 'stroke'
+  | 'strokeOpacity'
+  | 'strokeWidth'
+  | 'strokeCap'
+  | 'strokeJoin'
+  | 'clipRect'
+  | 'clipPath'
+  | 'clipOffset'
+> &
+  AreaComponentProps & {
+    /**
+     * 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).
+     * @note only used when no gradient is provided
+     * @default 1
+     */
+    peakOpacity?: number;
+    /**
+     * Opacity at the baseline (0 or edge closest to 0).
+     * @note only used when no gradient is provided
+     * @default 0
+     */
+    baselineOpacity?: number;
+  };
+/**
+ * A customizable dotted area gradient component.
+ * When no gradient is provided, renders a default gradient based
+ * on the fill color and peak/baseline opacities.
+ */
+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":"AAMA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,eAAe,GACf,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,YAAY,CACf,GACC,kBAAkB,GAAG;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,uDAwEtB,CAAC"}

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

@@ -0,0 +1,36 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type GradientAreaProps = Pick<
+  PathProps,
+  | 'initialPath'
+  | 'children'
+  | 'stroke'
+  | 'strokeOpacity'
+  | 'strokeWidth'
+  | 'strokeCap'
+  | 'strokeJoin'
+  | 'clipRect'
+  | 'clipPath'
+  | 'clipOffset'
+> &
+  AreaComponentProps & {
+    /**
+     * Opacity at peak of gradient.
+     * @note only used when no gradient is provided
+     * @default 0.3
+     */
+    peakOpacity?: number;
+    /**
+     * Opacity at the baseline.
+     * @note only used when no gradient is provided
+     * @default 0
+     */
+    baselineOpacity?: number;
+  };
+/**
+ * A customizable gradient area component.
+ * When no gradient is provided, renders a default gradient based
+ * on the fill color and peak/baseline opacities.
+ */
+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":"AAKA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,SAAS,EACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,eAAe,GACf,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,YAAY,CACf,GACC,kBAAkB,GAAG;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,YAAY,yDA6CxB,CAAC"}

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

@@ -0,0 +1,23 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type SolidAreaProps = Pick<
+  PathProps,
+  | 'initialPath'
+  | 'children'
+  | 'stroke'
+  | 'strokeOpacity'
+  | 'strokeWidth'
+  | 'strokeCap'
+  | 'strokeJoin'
+  | 'clipRect'
+  | 'clipPath'
+  | 'clipOffset'
+> &
+  AreaComponentProps;
+/**
+ * A customizable solid area component.
+ * When a gradient is provided, renders with gradient fill.
+ * Otherwise, renders with solid fill.
+ */
+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":"AAIA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,SAAS,EACP,aAAa,GACb,UAAU,GACV,QAAQ,GACR,eAAe,GACf,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,UAAU,GACV,YAAY,CACf,GACC,kBAAkB,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,SAAS,sDAiBrB,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"}

package/dts/chart/axis/Axis.d.ts

@@ -0,0 +1,194 @@
+import type React from 'react';
+import { type LineComponent } from '../line';
+import type { ChartTextChildren, ChartTextProps } from '../text/ChartText';
+/**
+ * Animation variants for grouped axis tick labels - initial mount
+ * Note: Mobile currently doesn't use these variants. Axes render immediately without animation.
+ * Web uses similar variants with delay to match path enter animation timing.
+ */
+export declare const axisTickLabelsInitialAnimationVariants: {
+  initial: {
+    opacity: number;
+  };
+  animate: {
+    opacity: number;
+    transition: {
+      duration: number;
+      delay: number;
+    };
+  };
+  exit: {
+    opacity: number;
+    transition: {
+      duration: number;
+    };
+  };
+};
+/**
+ * Animation variants for axis elements - updates (used for both grid lines and tick labels)
+ */
+export declare const axisUpdateAnimationVariants: {
+  initial: {
+    opacity: number;
+  };
+  animate: {
+    opacity: number;
+    transition: {
+      duration: number;
+      delay: number;
+    };
+  };
+  exit: {
+    opacity: number;
+    transition: {
+      duration: number;
+    };
+  };
+};
+export type AxisTickLabelComponentProps = Pick<
+  ChartTextProps,
+  | 'x'
+  | 'y'
+  | 'children'
+  | 'dx'
+  | 'dy'
+  | 'font'
+  | 'fontFamilies'
+  | 'fontSize'
+  | 'fontWeight'
+  | 'fontStyle'
+  | 'color'
+  | 'horizontalAlignment'
+  | 'verticalAlignment'
+  | 'opacity'
+>;
+export type AxisTickLabelComponent = React.FC<AxisTickLabelComponentProps>;
+export type AxisBaseProps = {
+  /**
+   * Label text to display for the axis.
+   */
+  label?: string;
+  /**
+   * Gap between the tick labels and the axis label.
+   * @default 4
+   */
+  labelGap?: number;
+  /**
+   * Minimum gap between tick labels.
+   * Labels will be hidden if they are closer than this gap.
+   * @default 4
+   */
+  minTickLabelGap?: number;
+  /**
+   * Requested number of ticks to display.
+   * This value is passed into d3 and may not be respected.
+   * @note This property is overridden when `ticks` is provided.
+   * @note this property overrides the `tickInterval` property.
+   * @default 5 (for y-axis)
+   */
+  requestedTickCount?: number;
+  /**
+   * Whether to show grid lines at each tick position.
+   */
+  showGrid?: boolean;
+  /**
+   * Whether to show the axis line.
+   */
+  showLine?: boolean;
+  /**
+   * Whether to show tick marks on the axis.
+   */
+  showTickMarks?: boolean;
+  /**
+   * Size of the tick marks.
+   * @default 4
+   */
+  tickMarkSize?: number;
+  /**
+   * Custom tick configuration for the axis.
+   * When provided, this overrides the `requestedTickCount` property.
+   *
+   * - **Array**: Uses these exact values for tick positioning and labels.
+   * - **Function**: Filters based on the predicate function.
+   *   - For **x-axis**: Checks every data index (0, 1, 2, ..., dataLength-1)
+   *   - For **y-axis**: Filters d3-generated tick values
+   *
+   * @example
+   * // Exact tick values
+   * ticks: [0, 25, 50, 75, 100]
+   *
+   * @example
+   * // Show every 12th data point on x-axis
+   * ticks: (index) => index % 12 === 0
+   */
+  ticks?: number[] | ((value: number) => boolean);
+  /**
+   * Space between the axis tick mark and labels.
+   * If tick marks are not shown, this is the gap between the axis and the chart.
+   * @default 2 for x-axis, 8 for y-axis
+   */
+  tickMarkLabelGap?: number;
+  /**
+   * Interval at which to show ticks.
+   * When provided, calculates tick count based on available space.
+   * @note this property is overridden by the `requestedTickCount` and `ticks` properties.
+   * @default 32 (for x-axis)
+   */
+  tickInterval?: number;
+  /**
+   * Minimum step size for tick generation.
+   * Prevents the step from being smaller than this value.
+   * @default 1
+   */
+  tickMinStep?: number;
+  /**
+   * Maximum step size for tick generation.
+   * Prevents the step from being larger than this value.
+   */
+  tickMaxStep?: number;
+};
+export type AxisProps = AxisBaseProps & {
+  /**
+   * Component to render the grid lines.
+   * @default DottedLine
+   */
+  GridLineComponent?: LineComponent;
+  /**
+   * Component to render the axis line.
+   * @default SolidLine
+   */
+  LineComponent?: LineComponent;
+  /**
+   * Component to render the tick marks.
+   * @default SolidLine
+   */
+  TickMarkLineComponent?: LineComponent;
+  /**
+   * Formatter function for axis tick values.
+   * Tick values will be wrapped in ChartText component.
+   *
+   * @example
+   * // XAxis
+   * tickLabelFormatter: (index) => {
+   *   return `$${prices[index]}`;
+   * }
+   *
+   * @example
+   * // YAxis
+   * tickLabelFormatter: (value) => `$${prices[value]}`
+   */
+  tickLabelFormatter?: (value: number) => ChartTextChildren;
+  /**
+   * Component to render tick labels.
+   * Allows for custom styling and formatting that works cross-platform.
+   *
+   * @example
+   * // Custom tick label component with offset positioning
+   * TickLabelComponent={(props) => (
+   *   <DefaultAxisTickLabel {...props} dx={4} dy={-12} />
+   * )}
+   * @default DefaultAxisTickLabel
+   */
+  TickLabelComponent?: AxisTickLabelComponent;
+};
+//# sourceMappingURL=Axis.d.ts.map

package/dts/chart/axis/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../../src/chart/axis/Axis.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;CAiBlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;CAiBvC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,cAAc,EACZ,GAAG,GACH,GAAG,GACH,UAAU,GACV,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,cAAc,GACd,UAAU,GACV,YAAY,GACZ,WAAW,GACX,OAAO,GACP,qBAAqB,GACrB,mBAAmB,GACnB,SAAS,CACZ,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,EAAE,CAAC,2BAA2B,CAAC,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG;IAC1B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;OAMG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;;;;;;;;;;;OAgBG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC;IAChD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG;IACtC;;;OAGG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,aAAa,CAAC;IACtC;;;;;;;;;;;;;OAaG;IACH,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAC1D;;;;;;;;;;OAUG;IACH,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;CAC7C,CAAC"}

package/dts/chart/axis/DefaultAxisTickLabel.d.ts

@@ -0,0 +1,8 @@
+import type { AxisTickLabelComponentProps } from './Axis';
+export type DefaultAxisTickLabelProps = AxisTickLabelComponentProps;
+/**
+ * DefaultAxisTickLabel is the default label component for axis tick labels.
+ * Provides standard styling for both X and Y axis tick labels.
+ */
+export declare const DefaultAxisTickLabel: import('react').NamedExoticComponent<AxisTickLabelComponentProps>;
+//# sourceMappingURL=DefaultAxisTickLabel.d.ts.map

package/dts/chart/axis/DefaultAxisTickLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAxisTickLabel.d.ts","sourceRoot":"","sources":["../../../src/chart/axis/DefaultAxisTickLabel.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,QAAQ,CAAC;AAE1D,MAAM,MAAM,yBAAyB,GAAG,2BAA2B,CAAC;AAEpE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,mEAE/B,CAAC"}

package/dts/chart/axis/XAxis.d.ts

@@ -0,0 +1,16 @@
+import { type AxisBaseProps, type AxisProps } from './Axis';
+export type XAxisBaseProps = AxisBaseProps & {
+  /**
+   * The position of the axis relative to the chart's drawing area.
+   * @default 'bottom'
+   */
+  position?: 'top' | 'bottom';
+  /**
+   * Height of the axis. This value is inclusive of the padding.
+   * @default 32 when no label is provided, 52 when a label is provided
+   */
+  height?: number;
+};
+export type XAxisProps = AxisProps & XAxisBaseProps;
+export declare const XAxis: import('react').NamedExoticComponent<XAxisProps>;
+//# sourceMappingURL=XAxis.d.ts.map

package/dts/chart/axis/XAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XAxis.d.ts","sourceRoot":"","sources":["../../../src/chart/axis/XAxis.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAM5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;AAEpD,eAAO,MAAM,KAAK,kDA+NjB,CAAC"}

package/dts/chart/axis/YAxis.d.ts

@@ -0,0 +1,21 @@
+import { type AxisBaseProps, type AxisProps } from './Axis';
+export type YAxisBaseProps = AxisBaseProps & {
+  /**
+   * The ID of the axis to render.
+   * Defaults to defaultAxisId if not specified.
+   */
+  axisId?: string;
+  /**
+   * The position of the axis relative to the chart's drawing area.
+   * @default 'right'
+   */
+  position?: 'left' | 'right';
+  /**
+   * Width of the axis. This value is inclusive of the padding.
+   * @default 44 when no label is provided, 64 when a label is provided
+   */
+  width?: number;
+};
+export type YAxisProps = AxisProps & YAxisBaseProps;
+export declare const YAxis: import('react').NamedExoticComponent<YAxisProps>;
+//# sourceMappingURL=YAxis.d.ts.map

package/dts/chart/axis/YAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YAxis.d.ts","sourceRoot":"","sources":["../../../src/chart/axis/YAxis.tsx"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAM5D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,CAAC;AAEpD,eAAO,MAAM,KAAK,kDA0NjB,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from './Axis';
+export * from './DefaultAxisTickLabel';
+export * from './XAxis';
+export * from './YAxis';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/axis/index.ts"],"names":[],"mappings":"AACA,cAAc,QAAQ,CAAC;AACvB,cAAc,wBAAwB,CAAC;AACvC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/dts/chart/bar/Bar.d.ts

@@ -0,0 +1,92 @@
+import React from 'react';
+import { type Transition } from '../utils';
+export type BarBaseProps = {
+  /**
+   * X coordinate of the bar (left edge).
+   */
+  x: number;
+  /**
+   * Y coordinate of the bar (top edge).
+   */
+  y: number;
+  /**
+   * Width of the bar.
+   */
+  width: number;
+  /**
+   * Height of the bar.
+   */
+  height: number;
+  /**
+   * Border radius for the bar.
+   * @default 4
+   */
+  borderRadius?: number;
+  /**
+   * Whether to round the top of the bar.
+   */
+  roundTop?: boolean;
+  /**
+   * Whether to round the bottom of the bar.
+   */
+  roundBottom?: boolean;
+  /**
+   * Y coordinate of the baseline/origin.
+   */
+  originY?: number;
+  /**
+   * The x-axis data value for this bar.
+   */
+  dataX?: number | string;
+  /**
+   * The y-axis data value for this bar.
+   */
+  dataY?: number | [number, number] | null;
+  /**
+   * Fill color for the bar.
+   */
+  fill?: string;
+  /**
+   * Fill opacity for the bar.
+   */
+  fillOpacity?: number;
+  /**
+   * Stroke color for the bar outline.
+   */
+  stroke?: string;
+  /**
+   * Stroke width for the bar outline.
+   */
+  strokeWidth?: number;
+  /**
+   * Component to render the bar.
+   */
+  BarComponent?: BarComponent;
+};
+export type BarProps = BarBaseProps & {
+  /**
+   * Transition configuration for bar animations.
+   */
+  transition?: Transition;
+};
+export type BarComponentProps = Omit<BarProps, 'BarComponent'> & {
+  /**
+   * The path data for the bar shape.
+   */
+  d: string;
+};
+export type BarComponent = React.FC<BarComponentProps>;
+/**
+ * Simple bar component that renders a single bar at the specified position.
+ *
+ * This component is intentionally kept simple - it just renders a static bar at the given
+ * x, y, width, height coordinates. Complex positioning logic (like handling stacks,
+ * groups, gaps, etc.) should be handled by parent components like BarChart or BarStack.
+ *
+ * @example
+ * ```tsx
+ * <Bar x={10} y={20} width={50} height={100} fill="blue" />
+ * ```
+ */
+export declare const Bar: React.NamedExoticComponent<BarProps>;
+//# sourceMappingURL=Bar.d.ts.map

package/dts/chart/bar/Bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bar.d.ts","sourceRoot":"","sources":["../../../src/chart/bar/Bar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAG7C,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAIvD,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACzC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG;IACpC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,QAAQ,EAAE,cAAc,CAAC,GAAG;IAC/D;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,sCA0Df,CAAC"}

package/dts/chart/bar/BarChart.d.ts

@@ -0,0 +1,113 @@
+import type { View } from 'react-native';
+import { type XAxisProps, type YAxisProps } from '../axis';
+import { type CartesianChartBaseProps, type CartesianChartProps } from '../CartesianChart';
+import { type AxisConfigProps, type Series } from '../utils';
+import { type BarPlotProps } from './BarPlot';
+export type BarChartBaseProps = Omit<CartesianChartBaseProps, 'xAxis' | 'yAxis' | 'series'> &
+  Pick<
+    BarPlotProps,
+    | 'barPadding'
+    | 'BarComponent'
+    | 'fillOpacity'
+    | 'stroke'
+    | 'strokeWidth'
+    | 'borderRadius'
+    | 'BarStackComponent'
+    | 'roundBaseline'
+    | 'stackGap'
+    | 'barMinSize'
+    | 'stackMinSize'
+    | 'transition'
+  > & {
+    /**
+     * Configuration objects that define how to visualize the data.
+     */
+    series?: Array<Series>;
+    /**
+     * 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 start & end value tuples (e.g., `[[0, 10], [5, 20]]`) 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;
+    /**
+     * Configuration for x-axis.
+     * Accepts axis config and axis props.
+     * To show the axis, set `showXAxis` to true.
+     */
+    xAxis?: Partial<AxisConfigProps> & XAxisProps;
+    /**
+     * Configuration for y-axis.
+     * Accepts axis config and axis props.
+     * To show the axis, set `showYAxis` to true.
+     */
+    yAxis?: Partial<AxisConfigProps> & YAxisProps;
+  };
+export type BarChartProps = BarChartBaseProps &
+  Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'>;
+export declare const BarChart: import('react').MemoExoticComponent<
+  import('react').ForwardRefExoticComponent<
+    Omit<CartesianChartBaseProps, 'series' | 'xAxis' | 'yAxis'> &
+      Pick<
+        BarPlotProps,
+        | 'borderRadius'
+        | 'strokeWidth'
+        | 'stroke'
+        | 'transition'
+        | 'fillOpacity'
+        | 'BarComponent'
+        | 'BarStackComponent'
+        | 'roundBaseline'
+        | 'stackGap'
+        | 'barMinSize'
+        | 'stackMinSize'
+        | 'barPadding'
+      > & {
+        /**
+         * Configuration objects that define how to visualize the data.
+         */
+        series?: Array<Series>;
+        /**
+         * 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 start & end value tuples (e.g., `[[0, 10], [5, 20]]`) 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;
+        /**
+         * Configuration for x-axis.
+         * Accepts axis config and axis props.
+         * To show the axis, set `showXAxis` to true.
+         */
+        xAxis?: Partial<AxisConfigProps> & XAxisProps;
+        /**
+         * Configuration for y-axis.
+         * Accepts axis config and axis props.
+         * To show the axis, set `showYAxis` to true.
+         */
+        yAxis?: Partial<AxisConfigProps> & YAxisProps;
+      } & Omit<CartesianChartProps, 'series' | 'xAxis' | 'yAxis'> &
+      import('react').RefAttributes<View>
+  >
+>;
+//# sourceMappingURL=BarChart.d.ts.map

package/dts/chart/bar/BarChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.d.ts","sourceRoot":"","sources":["../../../src/chart/bar/BarChart.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAS,KAAK,UAAU,EAAS,KAAK,UAAU,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,eAAe,EAIpB,KAAK,MAAM,EACZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAW,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GACzF,IAAI,CACF,YAAY,EACV,YAAY,GACZ,cAAc,GACd,aAAa,GACb,QAAQ,GACR,aAAa,GACb,cAAc,GACd,mBAAmB,GACnB,eAAe,GACf,UAAU,GACV,YAAY,GACZ,cAAc,GACd,YAAY,CACf,GAAG;IACF;;OAEG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;CAC/C,CAAC;AAEJ,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAC3C,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;AAE1D,eAAO,MAAM,QAAQ;IAtCjB;;OAEG;aACM,KAAK,CAAC,MAAM,CAAC;IACtB;;;;;;;OAOG;cACO,OAAO;IACjB;;OAEG;gBACS,OAAO;IACnB;;OAEG;gBACS,OAAO;IACnB;;;;OAIG;YACK,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU;IAC7C;;;;OAIG;YACK,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU;mGAgIhD,CAAC"}

package/dts/chart/bar/BarPlot.d.ts

@@ -0,0 +1,30 @@
+import type { BarStackGroupProps } from './BarStackGroup';
+export type BarPlotBaseProps = Pick<
+  BarStackGroupProps,
+  | 'barPadding'
+  | 'BarComponent'
+  | 'fillOpacity'
+  | 'stroke'
+  | 'strokeWidth'
+  | 'borderRadius'
+  | 'roundBaseline'
+  | 'stackGap'
+  | 'barMinSize'
+  | 'stackMinSize'
+  | 'BarStackComponent'
+> & {
+  /**
+   * Array of series IDs to render.
+   * If not provided, renders all series in the chart.
+   */
+  seriesIds?: string[];
+};
+export type BarPlotProps = BarPlotBaseProps & Pick<BarStackGroupProps, 'transition'>;
+/**
+ * BarPlot component that handles multiple series with proper stacking coordination.
+ * Groups series by stack ID + y-axis ID combination and renders BarStackGroup for each group.
+ * This allows series with different y-axes to be rendered side by side while preventing
+ * cross-axis stacking (e.g., comparing $1M vs $1B companies on different scales).
+ */
+export declare const BarPlot: import('react').NamedExoticComponent<BarPlotProps>;
+//# sourceMappingURL=BarPlot.d.ts.map

package/dts/chart/bar/BarPlot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BarPlot.d.ts","sourceRoot":"","sources":["../../../src/chart/bar/BarPlot.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG1D,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,kBAAkB,EAChB,YAAY,GACZ,cAAc,GACd,aAAa,GACb,QAAQ,GACR,aAAa,GACb,cAAc,GACd,eAAe,GACf,UAAU,GACV,YAAY,GACZ,cAAc,GACd,mBAAmB,CACtB,GAAG;IACF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,OAAO,oDAwGnB,CAAC"}