@coinbase/cds-web-visualization 3.3.2 → 3.4.0-beta.10

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

@@ -0,0 +1,255 @@
+import type React from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import { type LineComponent } from '../line';
+import type { ChartTextChildren, ChartTextProps } from '../text/ChartText';
+export declare const axisLineStyles =
+  '\n  stroke: var(--color-fg);\n  stroke-linecap: square;\n  stroke-width: 1px;\n';
+export declare const axisTickMarkStyles =
+  '\n  stroke: var(--color-fg);\n  stroke-linecap: square;\n  stroke-width: 1px;\n';
+/**
+ * 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'
+  | 'testID'
+  | 'dx'
+  | 'dy'
+  | 'font'
+  | 'fontFamily'
+  | 'fontSize'
+  | 'fontWeight'
+  | 'color'
+  | 'elevated'
+  | 'inset'
+  | 'background'
+  | 'borderRadius'
+  | 'disableRepositioning'
+  | 'bounds'
+  | 'styles'
+  | 'classNames'
+  | 'horizontalAlignment'
+  | 'verticalAlignment'
+  | 'className'
+  | 'style'
+>;
+export type AxisTickLabelComponent = React.FC<AxisTickLabelComponentProps>;
+export type AxisBaseProps = SharedProps & {
+  /**
+   * 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 & {
+  /**
+   * Custom className for the axis.
+   */
+  className?: string;
+  /**
+   * Custom classNames for the axis.
+   */
+  classNames?: {
+    /**
+     * Custom className for the root element.
+     */
+    root?: string;
+    /**
+     * Custom className for the axis label.
+     */
+    label?: string;
+    /**
+     * Custom className for the tick labels.
+     */
+    tickLabel?: string;
+    /**
+     * Custom className for the grid lines.
+     */
+    gridLine?: string;
+    /**
+     * Custom className for the axis line.
+     */
+    line?: string;
+    /**
+     * Custom className for the tick marks.
+     */
+    tickMark?: string;
+  };
+  /**
+   * Custom style for the axis.
+   */
+  style?: React.CSSProperties;
+  /**
+   * Custom styles for the axis.
+   */
+  styles?: {
+    /**
+     * Custom style for the root element.
+     */
+    root?: React.CSSProperties;
+    /**
+     * Custom style for the axis label.
+     */
+    label?: React.CSSProperties;
+    /**
+     * Custom style for the tick labels.
+     */
+    tickLabel?: React.CSSProperties;
+    /**
+     * Custom style for the grid lines.
+     */
+    gridLine?: React.CSSProperties;
+    /**
+     * Custom style for the axis line.
+     */
+    line?: React.CSSProperties;
+    /**
+     * Custom style for the tick marks.
+     */
+    tickMark?: React.CSSProperties;
+  };
+  /**
+   * 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) => {
+   *   if (index % 12 === 0) {
+   *     return <tspan style={{ fontWeight: 'bold' }}>${prices[index]}</tspan>;
+   *   }
+   *   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 elevation
+   * TickLabelComponent={(props) => (
+   *   <DefaultAxisTickLabel {...props} elevated color="var(--color-fgPrimary)" />
+   * )}
+   *
+   * @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":"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"}

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":"AAaA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAGf,MAAM,QAAQ,CAAC;AAahB,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,kDAgQjB,CAAC"}

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

@@ -0,0 +1,21 @@
+import type { AxisBaseProps, 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":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAcvD,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,kDA0PjB,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,94 @@
+import React from 'react';
+import type { SVGProps } from 'react';
+import type { Transition } from 'framer-motion';
+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 for animations.
+   * Used to calculate initial animation state.
+   */
+  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 animation.
+   */
+  transition?: Transition;
+};
+export type BarComponentProps = Omit<BarProps, 'BarComponent'> & {
+  /**
+   * The path data for the bar shape.
+   */
+  d: SVGProps<SVGPathElement>['d'];
+};
+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 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;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAMhD,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;;;OAGG;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,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,GAAG,sCAkDf,CAAC"}

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

@@ -0,0 +1,62 @@
+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<BarChartProps, 'ref'> & import('react').RefAttributes<SVGSVGElement>
+  >
+>;
+//# 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":"AAEA,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,2JA0HpB,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":"AAMA,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,oDAqGnB,CAAC"}

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

@@ -0,0 +1,103 @@
+import React from 'react';
+import type { Rect } from '@coinbase/cds-common';
+import type { Transition } from 'framer-motion';
+import type { ChartScaleFunction, Series } from '../utils';
+import { type BarProps } from './Bar';
+export type BarStackBaseProps = Pick<
+  BarProps,
+  'BarComponent' | 'fillOpacity' | 'stroke' | 'strokeWidth' | 'borderRadius'
+> & {
+  /**
+   * Array of series configurations that belong to this stack.
+   */
+  series: Series[];
+  /**
+   * The category index for this stack.
+   */
+  categoryIndex: number;
+  /**
+   * X position for this stack.
+   */
+  x: number;
+  /**
+   * Width of this stack.
+   */
+  width: number;
+  /**
+   * Y scale function.
+   */
+  yScale: ChartScaleFunction;
+  /**
+   * Chart rect for bounds.
+   */
+  rect: Rect;
+  /**
+   * Y axis ID to use.
+   * If not provided, will use the yAxisId from the first series.
+   */
+  yAxisId?: string;
+  /**
+   * Custom component to render the stack container.
+   * Can be used to add clip paths, outlines, or other custom styling.
+   * @default DefaultBarStack
+   */
+  BarStackComponent?: BarStackComponent;
+  /**
+   * Whether to round the baseline of a bar (where the value is 0).
+   */
+  roundBaseline?: boolean;
+  /**
+   * Gap between bars in the stack.
+   */
+  stackGap?: number;
+  /**
+   * Minimum size for individual bars in the stack.
+   */
+  barMinSize?: number;
+  /**
+   * Minimum size for the entire stack.
+   */
+  stackMinSize?: number;
+};
+export type BarStackProps = BarStackBaseProps & {
+  /**
+   * Transition configuration for animation.
+   */
+  transition?: Transition;
+};
+export type BarStackComponentProps = Pick<
+  BarStackProps,
+  'x' | 'width' | 'categoryIndex' | 'borderRadius' | 'transition'
+> & {
+  /**
+   * The y position of the stack.
+   */
+  y: number;
+  /**
+   * The height of the stack.
+   */
+  height: number;
+  /**
+   * The bar elements to render within the stack.
+   */
+  children: React.ReactNode;
+  /**
+   * Whether to round the top corners.
+   */
+  roundTop?: boolean;
+  /**
+   * Whether to round the bottom corners.
+   */
+  roundBottom?: boolean;
+  /**
+   * The y-origin for animations (baseline position).
+   */
+  yOrigin?: number;
+};
+export type BarStackComponent = React.FC<BarStackComponentProps>;
+/**
+ * BarStack component that renders a single stack of bars at a specific category index.
+ * Handles the stacking logic for bars within a single category.
+ */
+export declare const BarStack: React.NamedExoticComponent<BarStackProps>;
+//# sourceMappingURL=BarStack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BarStack.d.ts","sourceRoot":"","sources":["../../../src/chart/bar/BarStack.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG3D,OAAO,EAA0B,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAK9D,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAClC,QAAQ,EACR,cAAc,GAAG,aAAa,GAAG,QAAQ,GAAG,aAAa,GAAG,cAAc,CAC3E,GAAG;IACF;;OAEG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAC3B;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG;IAC9C;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,aAAa,EACb,GAAG,GAAG,OAAO,GAAG,eAAe,GAAG,cAAc,GAAG,YAAY,CAChE,GAAG;IACF;;OAEG;IACH,CAAC,EAAE,MAAM,CAAC;IACV;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,QAAQ,2CA+lBpB,CAAC"}

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

@@ -0,0 +1,36 @@
+import type { BarStackProps } from './BarStack';
+export type BarStackGroupProps = Pick<
+  BarStackProps,
+  | 'BarComponent'
+  | 'fillOpacity'
+  | 'stroke'
+  | 'strokeWidth'
+  | 'borderRadius'
+  | 'roundBaseline'
+  | 'stackGap'
+  | 'barMinSize'
+  | 'stackMinSize'
+  | 'BarStackComponent'
+  | 'transition'
+> &
+  Pick<BarStackProps, 'series' | 'yAxisId'> & {
+    /**
+     * Index of this stack within the category (0-based).
+     */
+    stackIndex: number;
+    /**
+     * Total number of stacks per category.
+     */
+    totalStacks: number;
+    /**
+     * Padding between bar groups (0-1).
+     * @default 0.1
+     */
+    barPadding?: number;
+  };
+/**
+ * BarStackGroup component that renders a group of stacks across all categories.
+ * Delegates the actual stacking logic to BarStack for each category.
+ */
+export declare const BarStackGroup: import('react').NamedExoticComponent<BarStackGroupProps>;
+//# sourceMappingURL=BarStackGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BarStackGroup.d.ts","sourceRoot":"","sources":["../../../src/chart/bar/BarStackGroup.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,aAAa,EACX,cAAc,GACd,aAAa,GACb,QAAQ,GACR,aAAa,GACb,cAAc,GACd,eAAe,GACf,UAAU,GACV,YAAY,GACZ,cAAc,GACd,mBAAmB,GACnB,YAAY,CACf,GACC,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAAG;IAC1C;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,aAAa,0DAqEzB,CAAC"}