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

package/dts/visualizations/chart/legend/Legend.d.ts

@@ -0,0 +1,139 @@
+import { type BoxBaseProps, type BoxDefaultElement, type BoxProps } from '../../../layout';
+import type { LegendShape } from '../utils';
+export type LegendShapeProps = {
+  /**
+   * Color of the legend shape.
+   * @default 'var(--color-fgPrimary)'
+   */
+  color?: string;
+  /**
+   * Shape to display. Can be a preset shape or a custom ReactNode.
+   * @default 'circle'
+   */
+  shape?: LegendShape;
+  /**
+   * Custom class name for the shape element.
+   */
+  className?: string;
+  /**
+   * Custom styles for the shape element.
+   */
+  style?: React.CSSProperties;
+};
+export type LegendShapeComponent = React.FC<LegendShapeProps>;
+export type LegendEntryProps = {
+  /**
+   * Id of the series.
+   */
+  seriesId: string;
+  /**
+   * Label of the series.
+   * If a ReactNode is provided, it replaces the default Text component.
+   */
+  label: React.ReactNode;
+  /**
+   * Color of the series.
+   * @default 'var(--color-fgPrimary)'
+   */
+  color?: string;
+  /**
+   * Shape of the series.
+   */
+  shape?: LegendShape;
+  /**
+   * Custom component to render the legend shape.
+   * @default DefaultLegendShape
+   */
+  ShapeComponent?: LegendShapeComponent;
+  /**
+   * Custom class name for the root element.
+   */
+  className?: string;
+  /** Custom class names for individual elements of the LegendEntry component */
+  classNames?: {
+    /** Root element */
+    root?: string;
+    /** Shape element */
+    shape?: string;
+    /**
+     * Label element
+     * @note not applied when label is a ReactNode.
+     */
+    label?: string;
+  };
+  /**
+   * Custom styles for the root element.
+   */
+  style?: React.CSSProperties;
+  /** Custom styles for individual elements of the LegendEntry component */
+  styles?: {
+    /** Root element */
+    root?: React.CSSProperties;
+    /** Shape element */
+    shape?: React.CSSProperties;
+    /**
+     * Label element
+     * @note not applied when label is a ReactNode.
+     */
+    label?: React.CSSProperties;
+  };
+};
+export type LegendEntryComponent = React.FC<LegendEntryProps>;
+export type LegendBaseProps = Omit<BoxBaseProps, 'children'> & {
+  /**
+   * Array of series IDs to display in the legend.
+   * By default, all series will be displayed.
+   */
+  seriesIds?: string[];
+  /**
+   * Custom component to render each legend entry.
+   * @default DefaultLegendEntry
+   */
+  EntryComponent?: LegendEntryComponent;
+  /**
+   * Custom component to render the legend shape within each entry.
+   * Only used when EntryComponent is not provided or is DefaultLegendEntry.
+   * @default DefaultLegendShape
+   */
+  ShapeComponent?: LegendShapeComponent;
+  /**
+   * Accessibility label for the legend group.
+   * @default 'Legend'
+   */
+  accessibilityLabel?: string;
+};
+export type LegendProps = Omit<BoxProps<BoxDefaultElement>, 'children'> &
+  LegendBaseProps & {
+    /** Custom class names for individual elements of the Legend component */
+    classNames?: {
+      /** Root element */
+      root?: string;
+      /** Entry element */
+      entry?: string;
+      /** Entry shape element */
+      entryShape?: string;
+      /**
+       * Entry label element
+       * @note not applied when label is a ReactNode.
+       */
+      entryLabel?: string;
+    };
+    /** Custom styles for individual elements of the Legend component */
+    styles?: {
+      /** Root element */
+      root?: React.CSSProperties;
+      /** Entry element */
+      entry?: React.CSSProperties;
+      /** Entry shape element */
+      entryShape?: React.CSSProperties;
+      /**
+       * Entry label element
+       * @note not applied when label is a ReactNode.
+       */
+      entryLabel?: React.CSSProperties;
+    };
+  };
+export declare const Legend: import('react').NamedExoticComponent<
+  Omit<LegendProps, 'ref'> & import('react').RefAttributes<HTMLDivElement>
+>;
+//# sourceMappingURL=Legend.d.ts.map

package/dts/visualizations/chart/legend/Legend.d.ts.map

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

package/dts/visualizations/chart/legend/index.d.ts

@@ -0,0 +1,4 @@
+export * from './DefaultLegendEntry';
+export * from './DefaultLegendShape';
+export * from './Legend';
+//# sourceMappingURL=index.d.ts.map

package/dts/visualizations/chart/legend/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/legend/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC"}

package/dts/visualizations/chart/line/DefaultReferenceLineLabel.d.ts

@@ -0,0 +1,9 @@
+import type { ReferenceLineLabelComponentProps } from './ReferenceLine';
+export type DefaultReferenceLineLabelProps = ReferenceLineLabelComponentProps;
+/**
+ * DefaultReferenceLineLabel is the default label component for ReferenceLine.
+ * Provides standard styling with elevation, inset, and color defaults.
+ * When elevated, automatically adds bounds to prevent shadow cutoff at chart edges.
+ */
+export declare const DefaultReferenceLineLabel: import('react').NamedExoticComponent<ReferenceLineLabelComponentProps>;
+//# sourceMappingURL=DefaultReferenceLineLabel.d.ts.map

package/dts/visualizations/chart/line/DefaultReferenceLineLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultReferenceLineLabel.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/DefaultReferenceLineLabel.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,iBAAiB,CAAC;AAExE,MAAM,MAAM,8BAA8B,GAAG,gCAAgC,CAAC;AAQ9E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,wEAyDrC,CAAC"}

package/dts/visualizations/chart/line/DottedLine.d.ts

@@ -0,0 +1,26 @@
+import { type SVGProps } from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import { type PathProps } from '../Path';
+import type { LineComponentProps } from './Line';
+export type DottedLineProps = SharedProps &
+  Pick<
+    PathProps,
+    | 'className'
+    | 'clipOffset'
+    | 'clipRect'
+    | 'strokeLinecap'
+    | 'strokeLinejoin'
+    | 'strokeDasharray'
+    | 'strokeDashoffset'
+    | 'style'
+    | 'vectorEffect'
+  > &
+  LineComponentProps & {
+    fill?: SVGProps<SVGPathElement>['fill'];
+  };
+/**
+ * A customizable dotted line component.
+ * Supports gradient for gradient effects on the dots.
+ */
+export declare const DottedLine: import('react').NamedExoticComponent<DottedLineProps>;
+//# sourceMappingURL=DottedLine.d.ts.map

package/dts/visualizations/chart/line/DottedLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DottedLine.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/DottedLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAS,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,WAAW,GACvC,IAAI,CACF,SAAS,EACP,WAAW,GACX,YAAY,GACZ,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,OAAO,GACP,cAAc,CACjB,GACD,kBAAkB,GAAG;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,UAAU,uDAsDtB,CAAC"}

package/dts/visualizations/chart/line/Line.d.ts

@@ -0,0 +1,146 @@
+import React from 'react';
+import type { SVGProps } from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import { type AreaComponent } from '../area/Area';
+import type { PathProps } from '../Path';
+import { type PointBaseProps, type PointProps } from '../point';
+import { type ChartPathCurveType, type GradientDefinition } from '../utils';
+export type LineBaseProps = SharedProps & {
+  /**
+   * 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 line to render.
+   * @default 'solid'
+   */
+  type?: 'solid' | 'dotted';
+  /**
+   * Whether to show area fill under the line.
+   */
+  showArea?: boolean;
+  /**
+   * The type of area fill to add to the line.
+   * @default 'gradient'
+   */
+  areaType?: 'gradient' | 'solid' | 'dotted';
+  /**
+   * Baseline value for the area.
+   * 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
+   */
+  areaBaseline?: number;
+  /**
+   * Component to render the line.
+   * Takes precedence over the type prop if provided.
+   */
+  LineComponent?: LineComponent;
+  /**
+   * Custom component to render line area fill.
+   */
+  AreaComponent?: AreaComponent;
+  /**
+   * Opacity of the line's stroke.
+   * Will also be applied to points and area fill.
+   * @default 1
+   */
+  opacity?: number;
+  /**
+   * Controls whether and how to render points at each data point in the series.
+   * - `true`: Show all points with default styling
+   * - `false` or `undefined`: Hide all points
+   * - Function: Called for every entry in the data array to customize individual points
+   *
+   * @param defaults - The default point props computed by the Line component
+   * @returns true for default point, false/null/undefined for no point, or Partial<PointProps> to customize
+   */
+  points?:
+    | boolean
+    | ((defaults: PointBaseProps) => boolean | null | undefined | Partial<PointProps>);
+  /**
+   * When true, the area is connected across null values.
+   */
+  connectNulls?: boolean;
+  /**
+   * The color of the line.
+   * @default color of the series or 'var(--color-fgPrimary)'
+   */
+  stroke?: string;
+  /**
+   * Opacity of the line
+   * @note when combined with gradient, both will be applied
+   * @default 1
+   */
+  strokeOpacity?: number;
+  /**
+   * Width of the line
+   * @default 2
+   */
+  strokeWidth?: number;
+  /**
+   * Gradient configuration.
+   * When provided, creates gradient or threshold-based coloring.
+   */
+  gradient?: GradientDefinition;
+  /**
+   * Whether to animate the line.
+   * Overrides the animate value from the chart context.
+   */
+  animate?: boolean;
+};
+export type LineProps = LineBaseProps &
+  Pick<PathProps, 'transitions' | 'transition'> & {
+    /**
+     * Handler for when a point is clicked.
+     * Passed through to Point components rendered via points.
+     */
+    onPointClick?: PointProps['onClick'];
+    /**
+     * Custom style for the line.
+     */
+    style?: React.CSSProperties;
+    /**
+     * Custom className for the line.
+     */
+    className?: string;
+  };
+export type LineComponentProps = Pick<
+  LineProps,
+  | 'stroke'
+  | 'strokeOpacity'
+  | 'strokeWidth'
+  | 'gradient'
+  | 'animate'
+  | 'transitions'
+  | 'transition'
+  | 'style'
+  | 'className'
+> &
+  Pick<PathProps, 'clipRect' | 'strokeLinecap'> & {
+    /**
+     * Path of the line.
+     */
+    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 LineComponent = React.FC<LineComponentProps>;
+export declare const Line: React.NamedExoticComponent<LineProps>;
+//# sourceMappingURL=Line.d.ts.map

package/dts/visualizations/chart/line/Line.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Line.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/Line.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAS,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EACL,KAAK,kBAAkB,EAMvB,KAAK,kBAAkB,EACxB,MAAM,UAAU,CAAC;AAKlB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IACxC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3C;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;OAQG;IACH,MAAM,CAAC,EACH,OAAO,GACP,CAAC,CAAC,QAAQ,EAAE,cAAc,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IACrF;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IAC9B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,aAAa,GACnC,IAAI,CAAC,SAAS,EAAE,aAAa,GAAG,YAAY,CAAC,GAAG;IAC9C;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,SAAS,EACP,QAAQ,GACR,eAAe,GACf,aAAa,GACb,UAAU,GACV,SAAS,GACT,aAAa,GACb,YAAY,GACZ,OAAO,GACP,WAAW,CACd,GACC,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,eAAe,CAAC,GAAG;IAC9C;;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;AAEJ,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAEzD,eAAO,MAAM,IAAI,uCAoOhB,CAAC"}

package/dts/visualizations/chart/line/LineChart.d.ts

@@ -0,0 +1,77 @@
+import { type XAxisProps } from '../axis/XAxis';
+import { type YAxisProps } from '../axis/YAxis';
+import { type CartesianChartBaseProps, type CartesianChartProps } from '../CartesianChart';
+import { type CartesianAxisConfigProps, type Series } from '../utils';
+import { type LineProps } from './Line';
+export type LineSeries = Series &
+  Partial<
+    Pick<
+      LineProps,
+      | 'curve'
+      | 'showArea'
+      | 'areaType'
+      | 'areaBaseline'
+      | 'type'
+      | 'LineComponent'
+      | 'AreaComponent'
+      | 'stroke'
+      | 'strokeWidth'
+      | 'strokeOpacity'
+      | 'opacity'
+      | 'points'
+      | 'connectNulls'
+      | 'transitions'
+      | 'transition'
+      | 'onPointClick'
+    >
+  >;
+export type LineChartBaseProps = Omit<CartesianChartBaseProps, 'xAxis' | 'yAxis' | 'series'> &
+  Pick<
+    LineProps,
+    | 'showArea'
+    | 'areaType'
+    | 'type'
+    | 'LineComponent'
+    | 'AreaComponent'
+    | 'curve'
+    | 'points'
+    | 'strokeWidth'
+    | 'strokeOpacity'
+    | 'connectNulls'
+    | 'transitions'
+    | 'transition'
+    | 'onPointClick'
+    | 'opacity'
+  > & {
+    /**
+     * Configuration objects that define how to visualize the data.
+     * Each series supports Line component props for individual customization.
+     */
+    series?: Array<LineSeries>;
+    /**
+     * 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<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 LineChartProps = LineChartBaseProps &
+  Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'>;
+export declare const LineChart: import('react').NamedExoticComponent<
+  Omit<LineChartProps, 'ref'> & import('react').RefAttributes<SVGSVGElement>
+>;
+//# sourceMappingURL=LineChart.d.ts.map

package/dts/visualizations/chart/line/LineChart.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/LineChart.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACzB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,wBAAwB,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEtE,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAC7B,OAAO,CACL,IAAI,CACF,SAAS,EACP,OAAO,GACP,UAAU,GACV,UAAU,GACV,cAAc,GACd,MAAM,GACN,eAAe,GACf,eAAe,GACf,QAAQ,GACR,aAAa,GACb,eAAe,GACf,SAAS,GACT,QAAQ,GACR,cAAc,GACd,aAAa,GACb,YAAY,GACZ,cAAc,CACjB,CACF,CAAC;AAEJ,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GAC1F,IAAI,CACF,SAAS,EACP,UAAU,GACV,UAAU,GACV,MAAM,GACN,eAAe,GACf,eAAe,GACf,OAAO,GACP,QAAQ,GACR,aAAa,GACb,eAAe,GACf,cAAc,GACd,aAAa,GACb,YAAY,GACZ,cAAc,GACd,SAAS,CACZ,GAAG;IACF;;;OAGG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC3B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;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,kHAmIrB,CAAC"}

package/dts/visualizations/chart/line/ReferenceLine.d.ts

@@ -0,0 +1,187 @@
+import React from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import type {
+  ChartTextChildren,
+  ChartTextProps,
+  TextHorizontalAlignment,
+  TextVerticalAlignment,
+} from '../text/ChartText';
+import type { ChartInset } from '../utils';
+import type { LineComponent } from './Line';
+export type ReferenceLineLabelComponentProps = Pick<
+  ChartTextProps,
+  | 'x'
+  | 'y'
+  | 'children'
+  | 'testID'
+  | 'dx'
+  | 'dy'
+  | 'font'
+  | 'fontFamily'
+  | 'fontSize'
+  | 'fontWeight'
+  | 'color'
+  | 'elevated'
+  | 'inset'
+  | 'background'
+  | 'borderRadius'
+  | 'disableRepositioning'
+  | 'styles'
+  | 'classNames'
+  | 'horizontalAlignment'
+  | 'verticalAlignment'
+  | 'className'
+  | 'style'
+  | 'opacity'
+> & {
+  /**
+   * Bounds inset for label to prevent cutoff at chart edges.
+   * @default { top: 4, bottom: 20, left: 12, right: 12 } when elevated is true, otherwise undefined
+   */
+  boundsInset?: number | ChartInset;
+};
+export type ReferenceLineLabelComponent = React.FC<ReferenceLineLabelComponentProps>;
+export type ReferenceLineBaseProps = SharedProps & {
+  /**
+   * Label content to display near the reference line.
+   * Can be a string or ReactNode for rich formatting.
+   *
+   * @example
+   * // Simple string label
+   * label="Target Price"
+   *
+   * @example
+   * // ReactNode with styling
+   * label={<tspan style={{ fontWeight: 'bold', fill: 'red' }}>Stop Loss</tspan>}
+   */
+  label?: ChartTextChildren;
+  /**
+   * Component to render the line.
+   * @default DottedLine
+   */
+  LineComponent?: LineComponent;
+  /**
+   * Component to render the label.
+   * @default DefaultReferenceLineLabel
+   */
+  LabelComponent?: ReferenceLineLabelComponent;
+  /**
+   * Whether to elevate the label with a shadow.
+   * When true, applies elevation and automatically adds bounds to keep label within chart area.
+   */
+  labelElevated?: boolean;
+  /**
+   * Font style for the label text.
+   */
+  labelFont?: ChartTextProps['font'];
+  /**
+   * Horizontal offset for the label in pixels.
+   */
+  labelDx?: number;
+  /**
+   * Vertical offset for the label in pixels.
+   */
+  labelDy?: number;
+  /**
+   * Horizontal alignment of the label text.
+   */
+  labelHorizontalAlignment?: TextHorizontalAlignment;
+  /**
+   * Vertical alignment of the label text.
+   */
+  labelVerticalAlignment?: TextVerticalAlignment;
+  /**
+   * Bounds inset for the label to prevent cutoff at chart edges.
+   * Especially useful when labelElevated is true to prevent shadow clipping.
+   * Can be a number (applied to all sides) or a ChartInset object.
+   * @default { top: 4, bottom: 20, left: 12, right: 12 } when labelElevated is true, otherwise none
+   */
+  labelBoundsInset?: number | ChartInset;
+  /**
+   * The color of the line.
+   * @default 'var(--color-bgLine)'
+   */
+  stroke?: string;
+  /**
+   * Opacity applied to both the line and label.
+   * @default 1
+   */
+  opacity?: number;
+};
+export type HorizontalReferenceLineProps = ReferenceLineBaseProps & {
+  /**
+   * Y-value for horizontal reference line (data value).
+   */
+  dataY: number;
+  /**
+   * The ID of the y-axis to use for positioning.
+   * Defaults to defaultAxisId if not specified.
+   * @note Only used for axis selection when layout is 'vertical'. Horizontal layout supports a single y-axis.
+   */
+  yAxisId?: string;
+  /**
+   * Position of the label along the horizontal line.
+   * @default 'right'
+   */
+  labelPosition?: TextHorizontalAlignment;
+  dataX?: never;
+};
+export type VerticalReferenceLineProps = ReferenceLineBaseProps & {
+  /**
+   * X-value for vertical reference line (data index).
+   */
+  dataX: number;
+  /**
+   * Position of the label along the vertical line.
+   * @default 'top'
+   */
+  labelPosition?: TextVerticalAlignment;
+  dataY?: never;
+  yAxisId?: never;
+};
+export type ReferenceLineProps = (HorizontalReferenceLineProps | VerticalReferenceLineProps) & {
+  /**
+   * Custom class name for the root element.
+   */
+  className?: string;
+  /**
+   * Custom inline styles for the root element.
+   */
+  style?: React.CSSProperties;
+  /**
+   * Custom class names for the component parts.
+   */
+  classNames?: {
+    /**
+     * Custom class name for the root element.
+     */
+    root?: string;
+    /**
+     * Custom class name for the line path.
+     */
+    line?: string;
+    /**
+     * Custom class name for the text label.
+     */
+    label?: string;
+  };
+  /**
+   * Custom styles for the component parts.
+   */
+  styles?: {
+    /**
+     * Custom styles for the root element.
+     */
+    root?: React.CSSProperties;
+    /**
+     * Custom styles for the line path.
+     */
+    line?: React.CSSProperties;
+    /**
+     * Custom styles for the text label.
+     */
+    label?: React.CSSProperties;
+  };
+};
+export declare const ReferenceLine: React.NamedExoticComponent<ReferenceLineProps>;
+//# sourceMappingURL=ReferenceLine.d.ts.map

package/dts/visualizations/chart/line/ReferenceLine.d.ts.map

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

package/dts/visualizations/chart/line/SolidLine.d.ts

@@ -0,0 +1,25 @@
+import { type SVGProps } from 'react';
+import type { SharedProps } from '@coinbase/cds-common/types';
+import { type PathProps } from '../Path';
+import type { LineComponentProps } from './Line';
+export type SolidLineProps = SharedProps &
+  Pick<
+    PathProps,
+    | 'className'
+    | 'clipOffset'
+    | 'clipRect'
+    | 'strokeLinecap'
+    | 'strokeLinejoin'
+    | 'strokeDasharray'
+    | 'strokeDashoffset'
+    | 'style'
+  > &
+  LineComponentProps & {
+    fill?: SVGProps<SVGPathElement>['fill'];
+  };
+/**
+ * A customizable solid line component.
+ * Supports gradient for gradient effects and smooth data transitions.
+ */
+export declare const SolidLine: import('react').NamedExoticComponent<SolidLineProps>;
+//# sourceMappingURL=SolidLine.d.ts.map

package/dts/visualizations/chart/line/SolidLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SolidLine.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/SolidLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAS,MAAM,OAAO,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,MAAM,MAAM,cAAc,GAAG,WAAW,GACtC,IAAI,CACF,SAAS,EACP,WAAW,GACX,YAAY,GACZ,UAAU,GACV,eAAe,GACf,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,OAAO,CACV,GACD,kBAAkB,GAAG;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,SAAS,sDAkDrB,CAAC"}

package/dts/visualizations/chart/line/index.d.ts

@@ -0,0 +1,7 @@
+export * from './DefaultReferenceLineLabel';
+export * from './DottedLine';
+export * from './Line';
+export * from './LineChart';
+export * from './ReferenceLine';
+export * from './SolidLine';
+//# sourceMappingURL=index.d.ts.map

package/dts/visualizations/chart/line/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/visualizations/chart/line/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}