@coinbase/cds-web-visualization 3.4.0-beta.5 → 3.4.0-beta.7

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

@@ -3,12 +3,24 @@ import type { SharedProps } from '@coinbase/cds-common/types';
 import { type PathProps } from '../Path';
 import type { LineComponentProps } from './Line';
 export type DottedLineProps = SharedProps &
-  Omit<PathProps, 'fill' | 'strokeWidth'> &
-  Pick<LineComponentProps, 'strokeWidth'> & {
+  Pick<
+    PathProps,
+    | 'className'
+    | 'clipOffset'
+    | 'clipRect'
+    | 'strokeLinecap'
+    | 'strokeLinejoin'
+    | 'strokeDasharray'
+    | 'strokeDashoffset'
+    | 'style'
+    | 'vectorEffect'
+  > &
+  LineComponentProps & {
     fill?: SVGProps<SVGPathElement>['fill'];
   };
 /**
- * A customizable dotted line component which uses path element.
+ * 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/chart/line/DottedLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DottedLine.d.ts","sourceRoot":"","sources":["../../../src/chart/line/DottedLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,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,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,GACvC,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,UAAU,uDA2BtB,CAAC"}
+{"version":3,"file":"DottedLine.d.ts","sourceRoot":"","sources":["../../../src/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,uDAkDtB,CAAC"}

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

@@ -1,40 +1,27 @@
 import React from 'react';
 import type { SVGProps } from 'react';
 import type { SharedProps } from '@coinbase/cds-common/types';
+import { type Transition } from 'framer-motion';
 import { type AreaComponent } from '../area/Area';
-import { type PointConfig, type RenderPointsParams } from '../Point';
-import { type ChartPathCurveType } from '../utils';
-export type LineComponentProps = {
-  d: SVGProps<SVGPathElement>['d'];
-  stroke: string;
-  strokeOpacity?: number;
-  strokeWidth?: number;
-  testID?: string;
-  animate?: boolean;
-};
-export type LineComponent = React.FC<LineComponentProps>;
-export type LineProps = SharedProps & {
+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 'linear'
+   * @default 'bump'
    */
   curve?: ChartPathCurveType;
   /**
    * The type of line to render.
    * @default 'solid'
    */
-  type?: 'solid' | 'dotted' | 'gradient';
-  /**
-   * Handler for when a dot is clicked.
-   * Automatically makes dots appear pressable when provided.
-   */
-  onPointClick?: PointConfig['onClick'];
+  type?: 'solid' | 'dotted';
   /**
-   * Show area fill under the line.
+   * Whether to show area fill under the line.
    */
   showArea?: boolean;
   /**
@@ -56,25 +43,80 @@ export type LineProps = SharedProps & {
    * 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.
+   * Opacity of the line
+   * @note when combined with gradient, both will be applied
    * @default 1
    */
-  opacity?: number;
+  strokeOpacity?: number;
   /**
-   * Callback function to determine how to render points at each data point in the series.
-   * Called for every entry in the data array.
-   *
-   * @param params - Contains the data and pixel coordinates of the data point.
-   * @returns true for default point, false/null/undefined for no point, or PointConfig for custom point
+   * Width of the line
+   * @default 2
    */
-  renderPoints?: (params: RenderPointsParams) => boolean | null | undefined | PointConfig;
   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 & {
+  /**
+   * Transition configuration for line animations.
+   */
+  transition?: Transition;
+  /**
+   * Handler for when a point is clicked.
+   * Passed through to Point components rendered via points.
+   */
+  onPointClick?: PointProps['onClick'];
 };
+export type LineComponentProps = Pick<
+  LineProps,
+  'stroke' | 'strokeOpacity' | 'strokeWidth' | 'gradient' | 'animate' | 'transition'
+> & {
+  /**
+   * Path of the line
+   */
+  d: SVGProps<SVGPathElement>['d'];
+  /**
+   * ID of the y-axis to use.
+   * If not provided, defaults to the default y-axis.
+   */
+  yAxisId?: string;
+};
+export type LineComponent = React.FC<LineComponentProps>;
 export declare const Line: React.NamedExoticComponent<LineProps>;
 //# sourceMappingURL=Line.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Line.d.ts","sourceRoot":"","sources":["../../../src/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;AAG9D,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGxD,OAAO,EAAS,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,KAAK,kBAAkB,EAAe,MAAM,UAAU,CAAC;AAMhE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG;IACpC;;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,YAAY,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACtC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC3C;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,CAAC;IACxF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,IAAI,uCAsKhB,CAAC"}
+{"version":3,"file":"Line.d.ts","sourceRoot":"","sources":["../../../src/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;AAC9D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAQ,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAS,KAAK,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EAGL,KAAK,kBAAkB,EAKvB,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;;;OAGG;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,GAAG;IACtC;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,SAAS,EACT,QAAQ,GAAG,eAAe,GAAG,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CACnF,GAAG;IACF;;OAEG;IACH,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC;AAEzD,eAAO,MAAM,IAAI,uCA8MhB,CAAC"}

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

@@ -1,6 +1,6 @@
 import { type XAxisProps } from '../axis/XAxis';
 import { type YAxisProps } from '../axis/YAxis';
-import { type CartesianChartProps } from '../CartesianChart';
+import { type CartesianChartBaseProps, type CartesianChartProps } from '../CartesianChart';
 import { type AxisConfigProps, type Series } from '../utils';
 import { type LineProps } from './Line';
 export type LineSeries = Series &
@@ -8,32 +8,38 @@ export type LineSeries = Series &
     Pick<
       LineProps,
       | 'curve'
-      | 'onPointClick'
       | 'showArea'
       | 'areaType'
       | 'areaBaseline'
       | 'type'
-      | 'type'
       | 'LineComponent'
       | 'AreaComponent'
       | 'stroke'
-      | 'opacity'
-      | 'renderPoints'
       | 'strokeWidth'
+      | 'strokeOpacity'
+      | 'opacity'
+      | 'points'
+      | 'connectNulls'
+      | 'transition'
+      | 'onPointClick'
     >
   >;
-export type LineChartProps = Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'> &
+export type LineChartBaseProps = Omit<CartesianChartBaseProps, 'xAxis' | 'yAxis' | 'series'> &
   Pick<
     LineProps,
     | 'showArea'
     | 'areaType'
     | 'type'
-    | 'onPointClick'
     | 'LineComponent'
     | 'AreaComponent'
     | 'curve'
-    | 'renderPoints'
+    | 'points'
     | 'strokeWidth'
+    | 'strokeOpacity'
+    | 'connectNulls'
+    | 'transition'
+    | 'onPointClick'
+    | 'opacity'
   > & {
     /**
      * Configuration objects that define how to visualize the data.
@@ -48,9 +54,21 @@ export type LineChartProps = Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'seri
      * 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 LineChartProps = LineChartBaseProps &
+  Omit<CartesianChartProps, 'xAxis' | 'yAxis' | 'series'>;
 export declare const LineChart: import('react').MemoExoticComponent<
   import('react').ForwardRefExoticComponent<
     Omit<LineChartProps, 'ref'> & import('react').RefAttributes<SVGSVGElement>

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

@@ -1 +1 @@
-{"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../src/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,EAAkB,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,KAAK,eAAe,EAAoC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE/F,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,MAAM,UAAU,GAAG,MAAM,GAC7B,OAAO,CACL,IAAI,CACF,SAAS,EACP,OAAO,GACP,cAAc,GACd,UAAU,GACV,UAAU,GACV,cAAc,GACd,MAAM,GACN,MAAM,GACN,eAAe,GACf,eAAe,GACf,QAAQ,GACR,SAAS,GACT,cAAc,GACd,aAAa,CAChB,CACF,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,GAClF,IAAI,CACF,SAAS,EACP,UAAU,GACV,UAAU,GACV,MAAM,GACN,cAAc,GACd,eAAe,GACf,eAAe,GACf,OAAO,GACP,cAAc,GACd,aAAa,CAChB,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,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;CAC/C,CAAC;AAEJ,eAAO,MAAM,SAAS,4JAkHrB,CAAC"}
+{"version":3,"file":"LineChart.d.ts","sourceRoot":"","sources":["../../../src/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,eAAe,EAAoC,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAE/F,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,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,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,eAAe,CAAC,GAAG,UAAU,CAAC;IAC9C;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,CAAC;CAC/C,CAAC;AAEJ,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAC7C,IAAI,CAAC,mBAAmB,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,CAAC;AAE1D,eAAO,MAAM,SAAS,4JA0HrB,CAAC"}

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

@@ -6,12 +6,14 @@ import type {
   TextHorizontalAlignment,
   TextVerticalAlignment,
 } from '../text/ChartText';
+import type { ChartInset } from '../utils';
 import type { LineComponent } from './Line';
-/**
- * Configuration for ReferenceLine label rendering using ChartText.
- */
-export type ReferenceLineLabelProps = Pick<
+export type ReferenceLineLabelComponentProps = Pick<
   ChartTextProps,
+  | 'x'
+  | 'y'
+  | 'children'
+  | 'testID'
   | 'dx'
   | 'dy'
   | 'font'
@@ -19,18 +21,27 @@ export type ReferenceLineLabelProps = Pick<
   | 'fontSize'
   | 'fontWeight'
   | 'color'
-  | 'elevation'
+  | 'elevated'
   | 'inset'
   | 'background'
   | 'borderRadius'
   | 'disableRepositioning'
-  | 'bounds'
   | 'styles'
   | 'classNames'
   | 'horizontalAlignment'
   | 'verticalAlignment'
->;
-type BaseReferenceLineProps = SharedProps & {
+  | '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.
@@ -49,17 +60,85 @@ type BaseReferenceLineProps = SharedProps & {
    * @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;
   /**
-   * Props for the label rendering.
-   * Consolidates styling and positioning options for the ChartText component.
-   * Alignment defaults are set based on line orientation and can be overridden here.
+   * 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.
+   */
+  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'
    */
-  labelProps?: ReferenceLineLabelProps;
+  labelPosition?: TextVerticalAlignment;
+  dataY?: never;
+  yAxisId?: never;
+};
+export type ReferenceLineProps = (HorizontalReferenceLineProps | VerticalReferenceLineProps) & {
   /**
    * Custom class name for the root element.
    */
@@ -95,37 +174,5 @@ type BaseReferenceLineProps = SharedProps & {
     label?: React.CSSProperties;
   };
 };
-export type HorizontalReferenceLineProps = BaseReferenceLineProps & {
-  /**
-   * 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.
-   */
-  yAxisId?: string;
-  /**
-   * Position of the label along the horizontal line.
-   * @default 'right'
-   */
-  labelPosition?: TextHorizontalAlignment;
-  dataX?: never;
-};
-export type VerticalReferenceLineProps = BaseReferenceLineProps & {
-  /**
-   * 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;
 export declare const ReferenceLine: React.NamedExoticComponent<ReferenceLineProps>;
-export {};
 //# sourceMappingURL=ReferenceLine.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ReferenceLine.d.ts","sourceRoot":"","sources":["../../../src/chart/line/ReferenceLine.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAK9D,OAAO,KAAK,EACV,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,qBAAqB,EACtB,MAAM,mBAAmB,CAAC;AAI3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,cAAc,EACZ,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,OAAO,GACP,WAAW,GACX,OAAO,GACP,YAAY,GACZ,cAAc,GACd,sBAAsB,GACtB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,qBAAqB,GACrB,mBAAmB,CACtB,CAAC;AAEF,KAAK,sBAAsB,GAAG,WAAW,GAAG;IAC1C;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,UAAU,CAAC,EAAE,uBAAuB,CAAC;IACrC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE;QACX;;WAEG;QACH,IAAI,CAAC,EAAE,MAAM,CAAC;QACd;;WAEG;QACH,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;WAEG;QACH,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAC3B;;WAEG;QACH,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;KAC7B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,sBAAsB,GAAG;IAClE;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAC;IACxC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG,sBAAsB,GAAG;IAChE;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,qBAAqB,CAAC;IACtC,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,4BAA4B,GAAG,0BAA0B,CAAC;AAE3F,eAAO,MAAM,aAAa,gDAmIzB,CAAC"}
+{"version":3,"file":"ReferenceLine.d.ts","sourceRoot":"","sources":["../../../src/chart/line/ReferenceLine.tsx"],"names":[],"mappings":"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"}

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

@@ -3,12 +3,23 @@ import type { SharedProps } from '@coinbase/cds-common/types';
 import { type PathProps } from '../Path';
 import type { LineComponentProps } from './Line';
 export type SolidLineProps = SharedProps &
-  Omit<PathProps, 'fill' | 'strokeWidth'> &
-  Pick<LineComponentProps, 'strokeWidth'> & {
+  Pick<
+    PathProps,
+    | 'className'
+    | 'clipOffset'
+    | 'clipRect'
+    | 'strokeLinecap'
+    | 'strokeLinejoin'
+    | 'strokeDasharray'
+    | 'strokeDashoffset'
+    | 'style'
+  > &
+  LineComponentProps & {
     fill?: SVGProps<SVGPathElement>['fill'];
   };
 /**
- * A customizable solid line component which uses path element.
+ * 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/chart/line/SolidLine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SolidLine.d.ts","sourceRoot":"","sources":["../../../src/chart/line/SolidLine.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,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,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,CAAC,GACvC,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,GAAG;IACxC,IAAI,CAAC,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;CACzC,CAAC;AAEJ;;GAEG;AACH,eAAO,MAAM,SAAS,sDAuBrB,CAAC"}
+{"version":3,"file":"SolidLine.d.ts","sourceRoot":"","sources":["../../../src/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,sDA8CrB,CAAC"}

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

@@ -1,5 +1,5 @@
+export * from './DefaultReferenceLineLabel';
 export * from './DottedLine';
-export * from './GradientLine';
 export * from './Line';
 export * from './LineChart';
 export * from './ReferenceLine';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/chart/line/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/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"}

package/dts/chart/point/DefaultPointLabel.d.ts

@@ -0,0 +1,10 @@
+import { type ChartTextProps } from '../text';
+import type { PointLabelProps } from './Point';
+export type DefaultPointLabelProps = PointLabelProps &
+  Omit<ChartTextProps, 'children' | 'x' | 'y' | 'horizontalAlignment' | 'verticalAlignment'>;
+/**
+ * DefaultPointLabel is the default label component for point labels.
+ * It renders text at the specified position relative to the point.
+ */
+export declare const DefaultPointLabel: import('react').NamedExoticComponent<DefaultPointLabelProps>;
+//# sourceMappingURL=DefaultPointLabel.d.ts.map

package/dts/chart/point/DefaultPointLabel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultPointLabel.d.ts","sourceRoot":"","sources":["../../../src/chart/point/DefaultPointLabel.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAClD,IAAI,CAAC,cAAc,EAAE,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,qBAAqB,GAAG,mBAAmB,CAAC,CAAC;AAE7F;;;GAGG;AACH,eAAO,MAAM,iBAAiB,8DAwB7B,CAAC"}