@coinbase/cds-web 8.66.2 → 9.0.0-rc.1

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

@@ -0,0 +1,83 @@
+import React from 'react';
+import type { SVGProps } from 'react';
+import type { PathBaseProps, PathProps } from '../Path';
+import { type ChartPathCurveType, type GradientDefinition } from '../utils';
+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 'bump'
+   */
+  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;
+  /**
+   * When true, the area is connected across null values.
+   */
+  connectNulls?: boolean;
+  /**
+   * The color of the area.
+   * @default color of the series or 'var(--color-fgPrimary)'
+   */
+  fill?: PathBaseProps['fill'];
+  /**
+   * Opacity of the area
+   * @note when combined with gradient, both will be applied
+   * @default 1
+   */
+  fillOpacity?: PathBaseProps['fillOpacity'];
+  /**
+   * Baseline value for the gradient.
+   * When set, overrides the default baseline.
+   *
+   * @deprecated this prop has no functionality. Use 'baseline' on axis config instead. This will be removed in a future major release.
+   * @deprecationExpectedRemoval v5
+   */
+  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: SVGProps<SVGPathElement>['d'];
+  /**
+   * ID of the x-axis to use.
+   * If not provided, defaults to the default x-axis.
+   * @note Only used for axis selection when layout is 'horizontal'. Vertical layout uses a single x-axis.
+   */
+  xAxisId?: string;
+  /**
+   * ID of the y-axis to use.
+   * If not provided, defaults to the default y-axis.
+   * @note Only used for axis selection when layout is 'vertical'. Horizontal layout supports a single y-axis.
+   */
+  yAxisId?: string;
+};
+export type AreaComponent = React.FC<AreaComponentProps>;
+export declare const Area: React.NamedExoticComponent<AreaProps>;
+//# sourceMappingURL=Area.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Area.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/area/Area.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,KAAK,kBAAkB,EAAe,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMzF,MAAM,MAAM,aAAa,GAAG;IAC1B;;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;IAC9B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;AAEtF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,SAAS,EACT,MAAM,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,YAAY,CAC5F,GAAG;IACF;;OAEG;IACH,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAEzD,eAAO,MAAM,IAAI,uCA6FhB,CAAC"}

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

@@ -0,0 +1,90 @@
+import { type XAxisProps, type YAxisProps } from '../axis';
+import { type CartesianChartBaseProps, type CartesianChartProps } from '../CartesianChart';
+import { type LineProps } from '../line/Line';
+import { type CartesianAxisConfigProps, type Series } from '../utils';
+import { type AreaProps } from './Area';
+export type AreaSeries = Series &
+  Partial<
+    Pick<
+      AreaProps,
+      | 'AreaComponent'
+      | 'curve'
+      | 'fillOpacity'
+      | 'type'
+      | 'fill'
+      | 'connectNulls'
+      | 'transitions'
+      | 'transition'
+    >
+  > &
+  Partial<Pick<LineProps, 'LineComponent' | 'strokeWidth' | 'stroke' | 'opacity'>> & {
+    /**
+     * The type of line to render for this series.
+     * Overrides the chart-level lineType if provided.
+     * @default 'solid'
+     */
+    lineType?: 'solid' | 'dotted';
+  };
+export type AreaChartBaseProps = Omit<CartesianChartBaseProps, 'xAxis' | 'yAxis' | 'series'> &
+  Pick<
+    AreaProps,
+    | 'AreaComponent'
+    | 'curve'
+    | 'fillOpacity'
+    | 'type'
+    | 'connectNulls'
+    | 'transitions'
+    | 'transition'
+  > &
+  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';
+    /**
+     * Configuration for x-axis.
+     * Accepts axis config and axis props.
+     * To show the axis, set `showXAxis` to true.
+     */
+    xAxis?: Partial<CartesianAxisConfigProps> & XAxisProps;
+    /**
+     * Configuration for y-axis.
+     * Accepts axis config and axis props.
+     * To show the axis, set `showYAxis` to true.
+     */
+    yAxis?: Partial<CartesianAxisConfigProps> & YAxisProps;
+  };
+export type AreaChartProps = AreaChartBaseProps &
+  Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'>;
+export declare const AreaChart: import('react').NamedExoticComponent<
+  Omit<AreaChartProps, 'ref'> & import('react').RefAttributes<SVGSVGElement>
+>;
+//# sourceMappingURL=AreaChart.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AreaChart.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/area/AreaChart.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,EAAQ,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EACL,KAAK,wBAAwB,EAE7B,KAAK,MAAM,EAEZ,MAAM,UAAU,CAAC;AAElB,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAC7B,OAAO,CACL,IAAI,CACF,SAAS,EACP,eAAe,GACf,OAAO,GACP,aAAa,GACb,MAAM,GACN,MAAM,GACN,cAAc,GACd,aAAa,GACb,YAAY,CACf,CACF,GACD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,CAAC,CAAC,GAAG;IACjF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;CAC/B,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GAC1F,IAAI,CACF,SAAS,EACP,eAAe,GACf,OAAO,GACP,aAAa,GACb,MAAM,GACN,cAAc,GACd,aAAa,GACb,YAAY,CACf,GACD,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,CAAC;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,UAAU,CAAC;IACvD;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,UAAU,CAAC;CACxD,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAC7C,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;AAE1D,eAAO,MAAM,SAAS,kHA2KrB,CAAC"}

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

@@ -0,0 +1,45 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type DottedAreaProps = Pick<
+  PathProps,
+  | 'stroke'
+  | 'strokeWidth'
+  | 'strokeOpacity'
+  | 'strokeLinecap'
+  | 'strokeLinejoin'
+  | 'strokeDasharray'
+  | 'strokeDashoffset'
+  | 'clipOffset'
+  | 'children'
+> &
+  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/visualizations/chart/area/DottedArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DottedArea.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/area/DottedArea.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAG/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,IAAI,CAChC,SAAS,EACP,QAAQ,GACR,aAAa,GACb,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,YAAY,GACZ,UAAU,CACb,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,uDAqFtB,CAAC"}

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

@@ -0,0 +1,39 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type GradientAreaProps = Pick<
+  PathProps,
+  | 'stroke'
+  | 'strokeWidth'
+  | 'strokeOpacity'
+  | 'strokeLinecap'
+  | 'strokeLinejoin'
+  | 'strokeDasharray'
+  | 'strokeDashoffset'
+  | 'clipRect'
+  | 'clipOffset'
+  | 'children'
+> &
+  AreaComponentProps & {
+    /**
+     * Opacity at peak values.
+     * @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 which uses Path with SVG linearGradient.
+ *
+ * When no gradient is provided, automatically creates an appropriate gradient:
+ * - For data crossing zero: Creates a diverging gradient with peak opacity at both extremes
+ *   and baseline opacity at zero (or the specified baseline).
+ * - For all-positive or all-negative data: Creates a simple gradient from baseline to peak.
+ */
+export declare const GradientArea: import('react').NamedExoticComponent<GradientAreaProps>;
+//# sourceMappingURL=GradientArea.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GradientArea.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/area/GradientArea.tsx"],"names":[],"mappings":"AAIA,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,QAAQ,GACR,aAAa,GACb,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,YAAY,GACZ,UAAU,CACb,GACC,kBAAkB,GAAG;IACnB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,yDA8DxB,CAAC"}

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

@@ -0,0 +1,23 @@
+import { type PathProps } from '../Path';
+import type { AreaComponentProps } from './Area';
+export type SolidAreaProps = Pick<
+  PathProps,
+  | 'stroke'
+  | 'strokeWidth'
+  | 'strokeOpacity'
+  | 'strokeLinecap'
+  | 'strokeLinejoin'
+  | 'strokeDasharray'
+  | 'strokeDashoffset'
+  | 'clipRect'
+  | 'clipOffset'
+  | 'children'
+> &
+  AreaComponentProps;
+/**
+ * A customizable solid area component which uses Path.
+ * 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/visualizations/chart/area/SolidArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidArea.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/area/SolidArea.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,cAAc,GAAG,IAAI,CAC/B,SAAS,EACP,QAAQ,GACR,aAAa,GACb,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,YAAY,GACZ,UAAU,CACb,GACC,kBAAkB,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,SAAS,sDAyCrB,CAAC"}

package/dts/visualizations/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/visualizations/chart/area/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/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/visualizations/chart/axis/Axis.d.ts

@@ -0,0 +1,254 @@
+import type React from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import type { Transition } from 'framer-motion';
+import { type LineComponent } from '../line';
+import type { ChartTextChildren, ChartTextProps } from '../text/ChartText';
+import { type AxisBandPlacement } from '../utils';
+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 axisUpdateAnimationTransition: Transition;
+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 & {
+  /**
+   * Placement of grid lines relative to each band.
+   * Options: 'start', 'middle', 'end', 'edges'
+   * @note This property only applies to band scales.
+   * @default 'edges'
+   */
+  bandGridLinePlacement?: AxisBandPlacement;
+  /**
+   * Placement of tick marks relative to each band.
+   * Options: 'start', 'middle', 'end', 'edges'
+   * @note This property only applies to band scales.
+   * @default 'middle'
+   */
+  bandTickMarkPlacement?: AxisBandPlacement;
+  /**
+   * 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 value axes by layout:
+   * - X axis when chart layout is horizontal
+   * - Y axis when chart layout is vertical
+   */
+  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.
+   *
+   * For band scales with string data, the value will be the string label (e.g., "Jan", "Feb").
+   * For numeric scales, the value will be the number.
+   *
+   * @example
+   * // XAxis with categorical data
+   * tickLabelFormatter: (value) => String(value).toUpperCase()
+   *
+   * @example
+   * // YAxis with numeric data
+   * tickLabelFormatter: (value) => `$${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/visualizations/chart/axis/Axis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Axis.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/axis/Axis.tsx"],"names":[],"mappings":"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"}

package/dts/visualizations/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/visualizations/chart/axis/DefaultAxisTickLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultAxisTickLabel.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/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/visualizations/chart/axis/XAxis.d.ts

@@ -0,0 +1,22 @@
+import { type AxisBaseProps, type AxisProps } from './Axis';
+export type XAxisBaseProps = AxisBaseProps & {
+  /**
+   * The ID of the axis to render.
+   * Defaults to defaultAxisId if not specified.
+   * @note Only used for axis selection when layout is 'horizontal'. Vertical layout uses a single x-axis.
+   */
+  axisId?: string;
+  /**
+   * 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/visualizations/chart/axis/XAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XAxis.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/axis/XAxis.tsx"],"names":[],"mappings":"AAmBA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAGf,MAAM,QAAQ,CAAC;AAahB,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;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,kDA2VjB,CAAC"}

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

@@ -0,0 +1,22 @@
+import { type AxisBaseProps, type AxisProps } from './Axis';
+export type YAxisBaseProps = AxisBaseProps & {
+  /**
+   * The ID of the axis to render.
+   * Defaults to defaultAxisId if not specified.
+   * @note Only used for axis selection when layout is 'vertical'. Horizontal layout supports a single y-axis.
+   */
+  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/visualizations/chart/axis/YAxis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YAxis.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/axis/YAxis.tsx"],"names":[],"mappings":"AAmBA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EAGf,MAAM,QAAQ,CAAC;AAahB,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG;IAC3C;;;;OAIG;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,kDAmVjB,CAAC"}

package/dts/visualizations/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/visualizations/chart/axis/index.d.ts.map

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