@gravity-ui/charts 1.43.1 → 1.45.0

package/dist/esm/core/series/constants.d.ts

@@ -4,4 +4,4 @@ export declare const DEFAULT_LEGEND_SYMBOL_SIZE = 8;
 export declare const DEFAULT_LEGEND_SYMBOL_PADDING = 5;
 export declare const DEFAULT_DATALABELS_PADDING = 5;
 export declare const DEFAULT_HALO_OPTIONS: Required<Halo>;
-export declare const DEFAULT_POINT_MARKER_OPTIONS: Omit<Required<PointMarkerOptions>, 'enabled'>;
+export declare const DEFAULT_POINT_MARKER_OPTIONS: Omit<Required<PointMarkerOptions>, 'color' | 'enabled'>;

package/dist/esm/core/series/constants.js

@@ -7,8 +7,8 @@ export const DEFAULT_HALO_OPTIONS = {
     size: 6,
 };
 export const DEFAULT_POINT_MARKER_OPTIONS = {
-    radius: 4,
     borderColor: '',
     borderWidth: 0,
+    radius: 4,
     symbol: 'circle',
 };

package/dist/esm/core/series/prepare-annotation.d.ts

@@ -0,0 +1,12 @@
+import type { ChartAnnotationLabel, ChartAnnotationPopup } from '../../types';
+import type { PreparedAnnotation } from './types';
+type AnnotationOptionsLabel = Omit<ChartAnnotationLabel, 'text'> | undefined;
+export declare function prepareAnnotation(args: {
+    annotation: {
+        label: ChartAnnotationLabel;
+        popup?: ChartAnnotationPopup;
+    };
+    optionsLabel?: AnnotationOptionsLabel;
+    optionsPopup?: ChartAnnotationPopup;
+}): Promise<PreparedAnnotation>;
+export {};

package/dist/esm/core/series/prepare-annotation.js

@@ -0,0 +1,31 @@
+import { annotationLabelDefaults, annotationPopupDefaults } from '../constants';
+import { getTextSizeFn } from '../utils';
+function resolvePadding(padding) {
+    if (padding === undefined) {
+        return annotationPopupDefaults.padding;
+    }
+    if (typeof padding === 'number') {
+        return [padding, padding];
+    }
+    return padding;
+}
+export async function prepareAnnotation(args) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    const { annotation, optionsLabel, optionsPopup } = args;
+    const style = Object.assign(Object.assign(Object.assign({}, annotationLabelDefaults.style), optionsLabel === null || optionsLabel === void 0 ? void 0 : optionsLabel.style), annotation.label.style);
+    const getTextSize = getTextSizeFn({ style });
+    const textSize = await getTextSize(annotation.label.text);
+    return {
+        label: {
+            style,
+            text: annotation.label.text,
+            size: { height: textSize.height, width: textSize.width },
+        },
+        popup: {
+            backgroundColor: (_c = (_b = (_a = annotation.popup) === null || _a === void 0 ? void 0 : _a.backgroundColor) !== null && _b !== void 0 ? _b : optionsPopup === null || optionsPopup === void 0 ? void 0 : optionsPopup.backgroundColor) !== null && _c !== void 0 ? _c : annotationPopupDefaults.backgroundColor,
+            borderRadius: (_f = (_e = (_d = annotation.popup) === null || _d === void 0 ? void 0 : _d.borderRadius) !== null && _e !== void 0 ? _e : optionsPopup === null || optionsPopup === void 0 ? void 0 : optionsPopup.borderRadius) !== null && _f !== void 0 ? _f : annotationPopupDefaults.borderRadius,
+            offset: (_j = (_h = (_g = annotation.popup) === null || _g === void 0 ? void 0 : _g.offset) !== null && _h !== void 0 ? _h : optionsPopup === null || optionsPopup === void 0 ? void 0 : optionsPopup.offset) !== null && _j !== void 0 ? _j : annotationPopupDefaults.offset,
+            padding: resolvePadding((_l = (_k = annotation.popup) === null || _k === void 0 ? void 0 : _k.padding) !== null && _l !== void 0 ? _l : optionsPopup === null || optionsPopup === void 0 ? void 0 : optionsPopup.padding),
+        },
+    };
+}

package/dist/esm/core/series/prepare-legend.js

@@ -136,7 +136,7 @@ async function getGroupedLegendItems(args) {
         else {
             resultItem.textWidth = textWidth;
         }
-        textWidthsInLine.push(textWidth);
+        textWidthsInLine.push(resultItem.textWidth);
         const textsWidth = textWidthsInLine.reduce((acc, width) => acc + width, 0);
         if (!result[lineIndex]) {
             result[lineIndex] = [];
@@ -155,7 +155,7 @@ async function getGroupedLegendItems(args) {
         else if (isCurrentLineOverMaxWidth) {
             result[lineIndex].pop();
             lineIndex += 1;
-            textWidthsInLine = [textWidth];
+            textWidthsInLine = [resultItem.textWidth];
             const nextLineIndex = lineIndex;
             result[nextLineIndex] = [];
             result[nextLineIndex].push(resultItem);

package/dist/esm/core/series/prepare-x-range.d.ts

@@ -0,0 +1,11 @@
+import type { ScaleOrdinal } from 'd3-scale';
+import type { ChartSeriesOptions, XRangeSeries } from '../../types';
+import type { PreparedLegend, PreparedXRangeSeries } from './types';
+type PrepareXRangeSeriesArgs = {
+    colorScale: ScaleOrdinal<string, string>;
+    series: XRangeSeries[];
+    legend: PreparedLegend;
+    seriesOptions?: ChartSeriesOptions;
+};
+export declare function prepareXRangeSeries(args: PrepareXRangeSeriesArgs): PreparedXRangeSeries[];
+export {};

package/dist/esm/core/series/prepare-x-range.js

@@ -0,0 +1,41 @@
+import get from 'lodash/get';
+import { getUniqId } from '../utils';
+import { DASH_STYLE, DEFAULT_DATALABELS_STYLE } from '../constants';
+import { DEFAULT_DATALABELS_PADDING } from './constants';
+import { prepareLegendSymbol } from './utils';
+export function prepareXRangeSeries(args) {
+    const { colorScale, series: seriesList, seriesOptions, legend } = args;
+    return seriesList.map((series) => {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u;
+        const name = series.name || '';
+        const color = series.color || colorScale(name);
+        return {
+            type: series.type,
+            color,
+            name,
+            id: getUniqId(),
+            visible: get(series, 'visible', true),
+            legend: {
+                enabled: get(series, 'legend.enabled', legend.enabled),
+                symbol: prepareLegendSymbol(series),
+                groupId: (_b = (_a = series.legend) === null || _a === void 0 ? void 0 : _a.groupId) !== null && _b !== void 0 ? _b : getUniqId(),
+                itemText: (_d = (_c = series.legend) === null || _c === void 0 ? void 0 : _c.itemText) !== null && _d !== void 0 ? _d : name,
+            },
+            data: series.data,
+            opacity: (_e = series.opacity) !== null && _e !== void 0 ? _e : null,
+            borderRadius: (_h = (_f = series.borderRadius) !== null && _f !== void 0 ? _f : (_g = seriesOptions === null || seriesOptions === void 0 ? void 0 : seriesOptions['x-range']) === null || _g === void 0 ? void 0 : _g.borderRadius) !== null && _h !== void 0 ? _h : 0,
+            borderWidth: (_l = (_j = series.borderWidth) !== null && _j !== void 0 ? _j : (_k = seriesOptions === null || seriesOptions === void 0 ? void 0 : seriesOptions['x-range']) === null || _k === void 0 ? void 0 : _k.borderWidth) !== null && _l !== void 0 ? _l : 0,
+            borderColor: (_p = (_m = series.borderColor) !== null && _m !== void 0 ? _m : (_o = seriesOptions === null || seriesOptions === void 0 ? void 0 : seriesOptions['x-range']) === null || _o === void 0 ? void 0 : _o.borderColor) !== null && _p !== void 0 ? _p : 'var(--gcharts-shape-border-color)',
+            borderDashStyle: (_s = (_q = series.borderDashStyle) !== null && _q !== void 0 ? _q : (_r = seriesOptions === null || seriesOptions === void 0 ? void 0 : seriesOptions['x-range']) === null || _r === void 0 ? void 0 : _r.borderDashStyle) !== null && _s !== void 0 ? _s : DASH_STYLE.Solid,
+            cursor: get(series, 'cursor', null),
+            tooltip: series.tooltip,
+            dataLabels: {
+                enabled: get(series, 'dataLabels.enabled', false),
+                style: Object.assign({}, DEFAULT_DATALABELS_STYLE, (_t = series.dataLabels) === null || _t === void 0 ? void 0 : _t.style),
+                html: get(series, 'dataLabels.html', false),
+                padding: get(series, 'dataLabels.padding', DEFAULT_DATALABELS_PADDING),
+                format: (_u = series.dataLabels) === null || _u === void 0 ? void 0 : _u.format,
+            },
+        };
+    });
+}

package/dist/esm/core/series/prepareSeries.js

@@ -11,6 +11,7 @@ import { prepareSankeySeries } from './prepare-sankey';
 import { prepareScatterSeries } from './prepare-scatter';
 import { prepareTreemap } from './prepare-treemap';
 import { prepareWaterfallSeries } from './prepare-waterfall';
+import { prepareXRangeSeries } from './prepare-x-range';
 export async function prepareSeries(args) {
     const { type, series, seriesOptions, legend, colors, colorScale } = args;
     switch (type) {
@@ -108,6 +109,14 @@ export async function prepareSeries(args) {
                 colors,
             });
         }
+        case 'x-range': {
+            return prepareXRangeSeries({
+                series: series,
+                seriesOptions,
+                legend,
+                colorScale,
+            });
+        }
         default: {
             throw new ChartError({
                 message: `Series type "${type}" does not support data preparation for series that do not support the presence of axes`,

package/dist/esm/core/series/types.d.ts

@@ -1,5 +1,21 @@
-import type { AreaSeries, AreaSeriesData, BarXSeries, BarXSeriesData, BarYSeries, BarYSeriesData, BaseTextStyle, ChartLegend, ChartSeries, ChartSeriesRangeSliderOptions, ConnectorCurve, ConnectorShape, FunnelSeries, FunnelSeriesData, HeatmapSeries, HeatmapSeriesData, LineSeries, LineSeriesData, LineSeriesLineBaseStyle, PathLegendSymbolOptions, PieSeries, PieSeriesData, RadarSeries, RadarSeriesCategory, RadarSeriesData, RectLegendSymbolOptions, SankeySeries, SankeySeriesData, ScatterSeries, ScatterSeriesData, SymbolLegendSymbolOptions, TreemapSeries, TreemapSeriesData, ValueFormat, WaterfallSeries, WaterfallSeriesData } from '../../types';
+import type { AreaSeries, AreaSeriesData, BarXSeries, BarXSeriesData, BarYSeries, BarYSeriesData, BaseTextStyle, ChartLegend, ChartSeries, ChartSeriesRangeSliderOptions, ConnectorCurve, ConnectorShape, FunnelSeries, FunnelSeriesData, HeatmapSeries, HeatmapSeriesData, LineSeries, LineSeriesData, LineSeriesLineBaseStyle, PathLegendSymbolOptions, PieSeries, PieSeriesData, RadarSeries, RadarSeriesCategory, RadarSeriesData, RectLegendSymbolOptions, SankeySeries, SankeySeriesData, ScatterSeries, ScatterSeriesData, SymbolLegendSymbolOptions, TreemapSeries, TreemapSeriesData, ValueFormat, WaterfallSeries, WaterfallSeriesData, XRangeSeries, XRangeSeriesData } from '../../types';
 import type { DashStyle, LayoutAlgorithm, LineCap, LineJoin, SeriesOptionsDefaults, SymbolType } from '../constants';
+export type PreparedAnnotation = {
+    label: {
+        size: {
+            height: number;
+            width: number;
+        };
+        style: BaseTextStyle;
+        text: string;
+    };
+    popup: {
+        backgroundColor: string;
+        borderRadius: number;
+        offset: number;
+        padding: [number, number];
+    };
+};
 export type RectLegendSymbol = {
     shape: 'rect';
 } & Required<RectLegendSymbolOptions>;
@@ -339,7 +355,23 @@ export type PreparedFunnelSeries = {
     };
     connectors: Required<FunnelSeries['connectors']>;
 } & BasePreparedSeries;
-export type PreparedSeries = PreparedScatterSeries | PreparedBarXSeries | PreparedBarYSeries | PreparedPieSeries | PreparedLineSeries | PreparedAreaSeries | PreparedTreemapSeries | PreparedWaterfallSeries | PreparedSankeySeries | PreparedRadarSeries | PreparedHeatmapSeries | PreparedFunnelSeries;
+export type PreparedXRangeSeries = {
+    type: XRangeSeries['type'];
+    data: XRangeSeriesData[];
+    borderRadius: number;
+    borderWidth: number;
+    borderColor: string;
+    borderDashStyle: DashStyle;
+    opacity: number | null;
+    dataLabels: {
+        enabled: boolean;
+        style: BaseTextStyle;
+        html: boolean;
+        padding: number;
+        format?: ValueFormat;
+    };
+} & BasePreparedSeries;
+export type PreparedSeries = PreparedScatterSeries | PreparedBarXSeries | PreparedBarYSeries | PreparedPieSeries | PreparedLineSeries | PreparedAreaSeries | PreparedTreemapSeries | PreparedWaterfallSeries | PreparedSankeySeries | PreparedRadarSeries | PreparedHeatmapSeries | PreparedFunnelSeries | PreparedXRangeSeries;
 export type PreparedZoomableSeries = Extract<PreparedSeries, {
     data: Array<unknown>;
 }>;

package/dist/esm/core/types/chart/annotation.d.ts

@@ -0,0 +1,45 @@
+import type { BaseTextStyle } from './base';
+export interface ChartAnnotationLabel {
+    /** Annotation text */
+    text: string;
+    /** Text style. fontColor defaults to 'var(--g-color-text-light-primary)' */
+    style?: Partial<BaseTextStyle>;
+}
+export interface ChartAnnotationPopup {
+    /**
+     * Background color of the popup.
+     * @default 'var(--g-color-base-float-heavy)'
+     */
+    backgroundColor?: string;
+    /**
+     * Border radius of the popup.
+     * @default 4
+     */
+    borderRadius?: number;
+    /**
+     * Distance in pixels between the anchor point and the popup edge along the main axis.
+     * The main axis depends on the automatically chosen placement:
+     * for top/bottom — vertical distance, for left/right — horizontal distance.
+     * @default 5
+     */
+    offset?: number;
+    /**
+     * Popup padding. Number or [vertical, horizontal].
+     * @default [4, 8]
+     */
+    padding?: number | [number, number];
+}
+/** Default annotation settings applied to all data points in a series */
+export interface ChartAnnotationSeriesOptions {
+    /** Default label style for annotations */
+    label?: Omit<ChartAnnotationLabel, 'text'>;
+    /** Default popup settings for annotations */
+    popup?: ChartAnnotationPopup;
+}
+/** Annotation for a specific data point. Renders as a popup with text label near the data point. */
+export interface ChartPointAnnotation {
+    /** Text content and style of the annotation */
+    label: ChartAnnotationLabel;
+    /** Visual settings for the annotation popup container (background, padding, etc.) */
+    popup?: ChartAnnotationPopup;
+}

package/dist/esm/core/types/chart/annotation.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/chart/area.d.ts

@@ -1,5 +1,6 @@
 import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
+import type { ChartPointAnnotation } from './annotation';
 import type { BaseSeries, BaseSeriesData, BaseSeriesLegend } from './base';
 import type { RectLegendSymbolOptions } from './legend';
 import type { PointMarkerOptions } from './marker';
@@ -23,6 +24,8 @@ export interface AreaSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     label?: string | number;
     /** Individual marker options for the point. */
     marker?: {
+        /** Fill color of the marker for this point */
+        color?: string;
         /** States for a single point marker. */
         states?: {
             /** The normal state of a single point marker. */
@@ -35,6 +38,11 @@ export interface AreaSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
             };
         };
     };
+    /**
+     * Annotation displayed near this data point as a bubble with text label and optional marker.
+     * Useful for highlighting specific values, events, or adding contextual notes.
+     */
+    annotation?: ChartPointAnnotation;
 }
 export type AreaMarkerSymbol = 'circle' | 'square';
 export interface AreaMarkerOptions extends PointMarkerOptions {
@@ -76,9 +84,10 @@ export interface AreaSeries<T = MeaningfulAny> extends BaseSeries {
     /**
      * Specifies how null or undefined values should be handled in the series.
      *
-     * - `'connect'`: Connect points across null values (skip nulls in rendering)
+     * - `'connect'`: Connect points across null values (skip nulls in rendering). **Not supported with `stacking`.**
      * - `'zero'`: Treat null values as zero
      * - `'skip'`: Omit the data point (creates gap in area)
+     *
      * @default 'skip'
      */
     nullMode?: 'connect' | 'zero' | 'skip';

package/dist/esm/core/types/chart/bar-x.d.ts

@@ -1,5 +1,6 @@
 import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
+import type { ChartPointAnnotation } from './annotation';
 import type { BaseSeries, BaseSeriesData, BaseSeriesLegend } from './base';
 import type { RectLegendSymbolOptions } from './legend';
 import type { ChartSeriesOptions, ChartSeriesRangeSliderOptions } from './series';
@@ -27,6 +28,11 @@ export interface BarXSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     label?: string | number;
     /** Individual opacity for the bar-x column. */
     opacity?: number;
+    /**
+     * Annotation displayed near this data point as a bubble with text label.
+     * Useful for highlighting specific values, events, or adding contextual notes.
+     */
+    annotation?: ChartPointAnnotation;
 }
 export interface BarXSeries<T = MeaningfulAny> extends BaseSeries {
     type: typeof SERIES_TYPE.BarX;

package/dist/esm/core/types/chart/line.d.ts

@@ -1,5 +1,6 @@
 import type { DashStyle, LineCap, LineJoin, SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
+import type { ChartPointAnnotation } from './annotation';
 import type { BaseSeries, BaseSeriesData, BaseSeriesLegend } from './base';
 import type { RectLegendSymbolOptions } from './legend';
 import type { PointMarkerOptions } from './marker';
@@ -22,12 +23,19 @@ export interface LineSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     /** Data label value of the point. If not specified, the y value is used. */
     label?: string | number;
     marker?: {
+        /** Fill color of the marker for this point */
+        color?: string;
         states?: {
             normal?: {
                 enabled: boolean;
             };
         };
     };
+    /**
+     * Annotation displayed near this data point as a bubble with text label and optional marker.
+     * Useful for highlighting specific values, events, or adding contextual notes.
+     */
+    annotation?: ChartPointAnnotation;
 }
 export interface LineSeriesLineBaseStyle {
     /**

package/dist/esm/core/types/chart/marker.d.ts

@@ -1,12 +1,14 @@
 import type { SymbolType } from '../../constants';
 export interface PointMarkerOptions {
-    /** Enable or disable the point marker */
-    enabled?: boolean;
-    /** The radius of the point marker */
-    radius?: number;
     /** The color of the point marker's border */
     borderColor?: string;
     /** The width of the point marker's border */
     borderWidth?: number;
+    /** Fill color of the marker */
+    color?: string;
+    /** Enable or disable the point marker */
+    enabled?: boolean;
+    /** The radius of the point marker */
+    radius?: number;
     symbol?: `${SymbolType}`;
 }

package/dist/esm/core/types/chart/series.d.ts

@@ -1,6 +1,7 @@
 import type React from 'react';
 import type { DashStyle, LineCap, LineJoin } from '../../constants';
 import type { MeaningfulAny } from '../misc';
+import type { ChartAnnotationSeriesOptions } from './annotation';
 import type { AreaSeries, AreaSeriesData } from './area';
 import type { BarXSeries, BarXSeriesData } from './bar-x';
 import type { BarYSeries, BarYSeriesData } from './bar-y';
@@ -15,8 +16,9 @@ import type { SankeySeries, SankeySeriesData } from './sankey';
 import type { ScatterSeries, ScatterSeriesData } from './scatter';
 import type { TreemapSeries, TreemapSeriesData } from './treemap';
 import type { WaterfallSeries, WaterfallSeriesData } from './waterfall';
-export type ChartSeries<T = MeaningfulAny> = ScatterSeries<T> | PieSeries<T> | BarXSeries<T> | BarYSeries<T> | LineSeries<T> | AreaSeries<T> | TreemapSeries<T> | WaterfallSeries<T> | SankeySeries<T> | RadarSeries<T> | HeatmapSeries<T> | FunnelSeries<T>;
-export type ChartSeriesData<T = MeaningfulAny> = ScatterSeriesData<T> | PieSeriesData<T> | BarXSeriesData<T> | BarYSeriesData<T> | LineSeriesData<T> | AreaSeriesData<T> | TreemapSeriesData<T> | WaterfallSeriesData<T> | SankeySeriesData<T> | RadarSeriesData<T> | HeatmapSeriesData<T> | FunnelSeriesData<T>;
+import type { XRangeSeries, XRangeSeriesData } from './x-range';
+export type ChartSeries<T = MeaningfulAny> = ScatterSeries<T> | PieSeries<T> | BarXSeries<T> | BarYSeries<T> | LineSeries<T> | AreaSeries<T> | TreemapSeries<T> | WaterfallSeries<T> | SankeySeries<T> | RadarSeries<T> | HeatmapSeries<T> | FunnelSeries<T> | XRangeSeries<T>;
+export type ChartSeriesData<T = MeaningfulAny> = ScatterSeriesData<T> | PieSeriesData<T> | BarXSeriesData<T> | BarYSeriesData<T> | LineSeriesData<T> | AreaSeriesData<T> | TreemapSeriesData<T> | WaterfallSeriesData<T> | SankeySeriesData<T> | RadarSeriesData<T> | HeatmapSeriesData<T> | FunnelSeriesData<T> | XRangeSeriesData<T>;
 export interface DataLabelRendererData<T = MeaningfulAny> {
     data: ChartSeriesData<T>;
 }
@@ -100,6 +102,8 @@ export interface ChartSeriesOptions {
             hover?: BasicHoverState;
             inactive?: BasicInactiveState;
         };
+        /** Default annotation settings for all bar-x data points */
+        annotation?: ChartAnnotationSeriesOptions;
     };
     'bar-y'?: {
         /**
@@ -211,6 +215,8 @@ export interface ChartSeriesOptions {
          * @default 'round' when dashStyle is not 'solid', 'unset' when dashStyle is not 'solid'
          */
         linejoin?: `${LineJoin}`;
+        /** Default annotation settings for all line data points */
+        annotation?: ChartAnnotationSeriesOptions;
     };
     area?: {
         /**
@@ -230,6 +236,8 @@ export interface ChartSeriesOptions {
         };
         /** Options for the point markers of line series */
         marker?: PointMarkerOptions;
+        /** Default annotation settings for all area data points */
+        annotation?: ChartAnnotationSeriesOptions;
     };
     treemap?: {
         /** Options for the series states that provide additional styling information to the series. */
@@ -291,6 +299,32 @@ export interface ChartSeriesOptions {
             hover?: BasicHoverState;
         };
     };
+    'x-range'?: {
+        /**
+         * The corner radius of the border surrounding each bar.
+         * @default 0
+         */
+        borderRadius?: number;
+        /**
+         * The width of the border surrounding each bar.
+         * @default 0
+         */
+        borderWidth?: number;
+        /**
+         * The color of the border surrounding each bar.
+         */
+        borderColor?: string;
+        /**
+         * The dash style of the border surrounding each bar.
+         * @default 'Solid'
+         */
+        borderDashStyle?: DashStyle;
+        /** Options for the series states that provide additional styling information to the series. */
+        states?: {
+            hover?: BasicHoverState;
+            inactive?: BasicInactiveState;
+        };
+    };
 }
 export type ChartSeriesRangeSliderOptions = {
     /**

package/dist/esm/core/types/chart/tooltip.d.ts

@@ -15,6 +15,7 @@ import type { SankeySeries, SankeySeriesData } from './sankey';
 import type { ScatterSeries, ScatterSeriesData } from './scatter';
 import type { TreemapSeries, TreemapSeriesData } from './treemap';
 import type { WaterfallSeries, WaterfallSeriesData } from './waterfall';
+import type { XRangeSeries, XRangeSeriesData } from './x-range';
 export interface TooltipDataChunkBarX<T = MeaningfulAny> {
     data: BarXSeriesData<T>;
     series: BarXSeries<T>;
@@ -46,6 +47,7 @@ export interface TooltipDataChunkLine<T = MeaningfulAny> {
         id: string;
         name: string;
     };
+    closest?: boolean;
 }
 export interface TooltipDataChunkArea<T = MeaningfulAny> {
     data: AreaSeriesData<T>;
@@ -87,7 +89,11 @@ export interface TooltipDataChunkFunnel<T = MeaningfulAny> {
         name: string;
     };
 }
-export type TooltipDataChunk<T = MeaningfulAny> = (TooltipDataChunkBarX<T> | TooltipDataChunkBarY<T> | TooltipDataChunkPie<T> | TooltipDataChunkScatter<T> | TooltipDataChunkLine<T> | TooltipDataChunkArea<T> | TooltipDataChunkTreemap<T> | TooltipDataChunkSankey<T> | TooltipDataChunkWaterfall<T> | TooltipDataChunkRadar<T> | TooltipDataChunkHeatmap<T> | TooltipDataChunkFunnel<T>) & {
+export interface TooltipDataChunkXRange<T = MeaningfulAny> {
+    data: XRangeSeriesData<T>;
+    series: XRangeSeries<T>;
+}
+export type TooltipDataChunk<T = MeaningfulAny> = (TooltipDataChunkBarX<T> | TooltipDataChunkBarY<T> | TooltipDataChunkPie<T> | TooltipDataChunkScatter<T> | TooltipDataChunkLine<T> | TooltipDataChunkArea<T> | TooltipDataChunkTreemap<T> | TooltipDataChunkSankey<T> | TooltipDataChunkWaterfall<T> | TooltipDataChunkRadar<T> | TooltipDataChunkHeatmap<T> | TooltipDataChunkFunnel<T> | TooltipDataChunkXRange<T>) & {
     closest?: boolean;
 };
 export interface ChartTooltipRendererArgs<T = MeaningfulAny> {

package/dist/esm/core/types/chart/x-range.d.ts

@@ -0,0 +1,59 @@
+import type { DashStyle, SERIES_TYPE } from '../../constants';
+import type { MeaningfulAny } from '../misc';
+import type { BaseSeries, BaseSeriesData, BaseSeriesLegend } from './base';
+import type { RectLegendSymbolOptions } from './legend';
+export interface XRangeSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
+    /**
+     * The start value of the bar on the x-axis. Can be a numeric or timestamp value.
+     */
+    x0: number | string;
+    /**
+     * The end value of the bar on the x-axis. Can be a numeric or timestamp value.
+     */
+    x1: number | string;
+    /**
+     * The `y` value. Depending on the context it may represent:
+     * - a category value (for `category` y axis). If string, it is the category itself. If number, it is the index in `yAxis[0].categories`.
+     * - a numeric value (for `linear` y axis)
+     */
+    y?: string | number;
+    /** Individual color for the bar. Overrides the series color. */
+    color?: string;
+    /** Data label value. If not specified, the series name is used. */
+    label?: string | number;
+    /** Individual opacity for the bar. */
+    opacity?: number;
+}
+export interface XRangeSeries<T = MeaningfulAny> extends BaseSeries {
+    type: typeof SERIES_TYPE.XRange;
+    data: XRangeSeriesData<T>[];
+    /** The name of the series (used in legend, tooltip etc) */
+    name: string;
+    /** The main color of the series (hex, rgba) */
+    color?: string;
+    /** Individual opacity for the entire series. */
+    opacity?: number | null;
+    /**
+     * The corner radius of the border surrounding each bar.
+     * @default 0
+     */
+    borderRadius?: number;
+    /**
+     * The width of the border surrounding each bar.
+     * @default 0
+     */
+    borderWidth?: number;
+    /**
+     * The color of the border surrounding each bar.
+     */
+    borderColor?: string;
+    /**
+     * The dash style of the border surrounding each bar.
+     * @default 'Solid'
+     */
+    borderDashStyle?: DashStyle;
+    /** Individual series legend options. Has higher priority than legend options in widget data */
+    legend?: BaseSeriesLegend & {
+        symbol?: RectLegendSymbolOptions;
+    };
+}

package/dist/esm/core/types/chart/x-range.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/core/types/chart/zoom.d.ts

@@ -18,7 +18,7 @@ export interface ChartZoom {
      *
      * Supported zoom types by series type:
      * - `Area`, `Line`, `Scatter`: `x`, `y`, `xy`
-     * - `BarX`: `x`
+     * - `BarX`, `XRange`: `x`
      * - `BarY`: `y`
      *
      * Default zoom type by series type:

package/dist/esm/core/types/index.d.ts

@@ -7,6 +7,7 @@ import type { ChartTitle } from './chart/title';
 import type { ChartTooltip } from './chart/tooltip';
 import type { MeaningfulAny } from './misc';
 export * from './misc';
+export * from './chart/annotation';
 export * from './chart/axis';
 export * from './chart/base';
 export * from './chart/chart';
@@ -30,6 +31,7 @@ export * from './chart/radar';
 export * from './chart/heatmap';
 export * from './chart/funnel';
 export * from './chart/brush';
+export * from './chart/x-range';
 export interface ChartData<T = MeaningfulAny> {
     /**
      * General options for the chart.

package/dist/esm/core/types/index.js

@@ -1,4 +1,5 @@
 export * from './misc';
+export * from './chart/annotation';
 export * from './chart/axis';
 export * from './chart/base';
 export * from './chart/chart';
@@ -22,3 +23,4 @@ export * from './chart/radar';
 export * from './chart/heatmap';
 export * from './chart/funnel';
 export * from './chart/brush';
+export * from './chart/x-range';

package/dist/esm/core/utils/axis/x-axis.js

@@ -12,7 +12,15 @@ function getTicksCount(args) {
     if (series) {
         const xDataSet = new Set();
         series === null || series === void 0 ? void 0 : series.forEach((item) => {
-            if (isSeriesWithNumericalXValues(item)) {
+            if (item.type === 'x-range') {
+                item.data.forEach((d) => {
+                    if (d.x0 !== null && d.x1 !== null) {
+                        xDataSet.add(d.x0);
+                        xDataSet.add(d.x1);
+                    }
+                });
+            }
+            else if (isSeriesWithNumericalXValues(item)) {
                 item.data.forEach((data) => {
                     xDataSet.add(data.x);
                 });

package/dist/esm/core/utils/color.js

@@ -22,6 +22,12 @@ export function getDomainForContinuousColorScale(args) {
                 acc.push(...s.data.map((d) => Number(d.y)));
                 break;
             }
+            case 'x-range': {
+                // Use bar duration (x1 - x0) as the color domain value so that
+                // longer bars can be visually distinguished by color intensity.
+                acc.push(...s.data.map((d) => Math.abs(Number(d.x1) - Number(d.x0))));
+                break;
+            }
             default: {
                 throw Error(`The method for calculation a domain for a continuous color scale for the "${s.type}" series is not defined`);
             }

package/dist/esm/core/utils/common.js

@@ -57,6 +57,16 @@ export const getDomainDataXBySeries = (series) => {
                 acc.push(...getDomainDataForStackedSeries(seriesList, 'y', 'x'));
                 break;
             }
+            case 'x-range': {
+                seriesList.forEach((s) => {
+                    s.data.forEach((d) => {
+                        if (!isNil(d.x0) && !isNil(d.x1)) {
+                            acc.push(d.x0, d.x1);
+                        }
+                    });
+                });
+                break;
+            }
             default: {
                 seriesList.filter(isSeriesWithNumericalXValues).forEach((s) => {
                     acc.push(...s.data.map((d) => d.x));