@gravity-ui/charts 1.43.1 → 1.44.0

package/dist/cjs/components/ChartInner/utils/zoom.js

@@ -6,7 +6,8 @@ function mapSeriesTypeToZoomType(seriesType) {
         case SERIES_TYPE.Area: {
             return [ZOOM_TYPE.X, ZOOM_TYPE.XY, ZOOM_TYPE.Y];
         }
-        case SERIES_TYPE.BarX: {
+        case SERIES_TYPE.BarX:
+        case SERIES_TYPE.XRange: {
             return [ZOOM_TYPE.X];
         }
         case SERIES_TYPE.BarY: {
@@ -36,6 +37,7 @@ function getDefaultZoomType(seriesType) {
         }
         case SERIES_TYPE.Area:
         case SERIES_TYPE.BarX:
+        case SERIES_TYPE.XRange:
         case SERIES_TYPE.Line:
         case SERIES_TYPE.Waterfall: {
             return ZOOM_TYPE.X;

package/dist/cjs/components/Tooltip/DefaultTooltipContent/index.js

@@ -43,12 +43,15 @@ export const DefaultTooltipContent = ({ hovered, pinned, rowRenderer, totals, va
         const colorSymbol = getTooltipRowColorSymbol({ series, color });
         return (React.createElement(Row, { key: id, active: active, color: color, colorSymbol: colorSymbol ? (React.createElement("div", { dangerouslySetInnerHTML: { __html: colorSymbol.outerHTML } })) : undefined, label: React.createElement("span", { dangerouslySetInnerHTML: { __html: name } }), striped: striped, value: formattedValue }));
     };
-    const formattedHeadValue = headerFormat
-        ? getFormattedValue({
-            value: measureValue === null || measureValue === void 0 ? void 0 : measureValue.value,
-            format: headerFormat,
-        })
-        : measureValue === null || measureValue === void 0 ? void 0 : measureValue.formattedValue;
+    let formattedHeadValue;
+    if (measureValue) {
+        formattedHeadValue = headerFormat
+            ? getFormattedValue({
+                value: measureValue.value,
+                format: headerFormat,
+            })
+            : measureValue.formattedValue;
+    }
     React.useEffect(() => {
         if (!contentRowsRef.current) {
             return;
@@ -186,6 +189,28 @@ export const DefaultTooltipContent = ({ hovered, pinned, rowRenderer, totals, va
                     formattedValue,
                 });
             }
+            case 'x-range': {
+                const xRangeData = data;
+                const format = rowValueFormat || getDefaultValueFormat({ axis: xAxis });
+                const x0Formatted = getFormattedValue({
+                    value: xRangeData.x0,
+                    format,
+                });
+                const x1Formatted = getFormattedValue({
+                    value: xRangeData.x1,
+                    format,
+                });
+                return renderRow({
+                    id,
+                    active,
+                    color,
+                    name: series.name,
+                    striped,
+                    value: hoveredValues[i],
+                    formattedValue: `${x0Formatted} — ${x1Formatted}`,
+                    series,
+                });
+            }
             default: {
                 return null;
             }

package/dist/cjs/components/Tooltip/DefaultTooltipContent/utils.js

@@ -48,7 +48,7 @@ export const getMeasureValue = ({ data, xAxis, yAxis, headerFormat, }) => {
         const value = (_b = (_a = data[0].category) === null || _a === void 0 ? void 0 : _a.key) !== null && _b !== void 0 ? _b : null;
         return { value };
     }
-    if (data.some((item) => item.series.type === 'bar-y')) {
+    if (data.some((item) => ['bar-y', 'x-range'].includes(item.series.type))) {
         const value = getYRowData((_c = data[0]) === null || _c === void 0 ? void 0 : _c.data, yAxis);
         const formattedValue = getFormattedValue({
             value: getYRowData((_d = data[0]) === null || _d === void 0 ? void 0 : _d.data, yAxis),
@@ -72,7 +72,9 @@ export function getHoveredValues(args) {
             case 'area':
             case 'line':
             case 'bar-x':
-            case 'scatter': {
+            case 'waterfall':
+            case 'scatter':
+            case 'x-range': {
                 return getYRowData(data, yAxis);
             }
             case 'bar-y': {
@@ -90,9 +92,6 @@ export function getHoveredValues(args) {
                 const { target, data: source } = seriesItem;
                 return (_a = source.links.find((d) => d.name === (target === null || target === void 0 ? void 0 : target.name))) === null || _a === void 0 ? void 0 : _a.value;
             }
-            case 'waterfall': {
-                return getYRowData(data, yAxis);
-            }
             default: {
                 return undefined;
             }

package/dist/cjs/core/constants/chart-types.d.ts

@@ -11,5 +11,6 @@ export declare const SERIES_TYPE: {
     readonly Radar: "radar";
     readonly Heatmap: "heatmap";
     readonly Funnel: "funnel";
+    readonly XRange: "x-range";
 };
 export type SeriesType = (typeof SERIES_TYPE)[keyof typeof SERIES_TYPE];

package/dist/cjs/core/constants/chart-types.js

@@ -11,4 +11,5 @@ export const SERIES_TYPE = {
     Radar: 'radar',
     Heatmap: 'heatmap',
     Funnel: 'funnel',
+    XRange: 'x-range',
 };

package/dist/cjs/core/constants/defaults/series-options.d.ts

@@ -21,7 +21,11 @@ type DefaultWaterfallSeriesOptions = Partial<ChartSeriesOptions['waterfall']> &
         barPadding: number;
     };
 };
-export type SeriesOptionsDefaults = Partial<ChartSeriesOptions> & DefaultBarXSeriesOptions & DefaultBarYSeriesOptions & DefaultWaterfallSeriesOptions;
+export type SeriesOptionsDefaults = Partial<ChartSeriesOptions> & DefaultBarXSeriesOptions & DefaultBarYSeriesOptions & DefaultWaterfallSeriesOptions & {
+    'x-range': {
+        borderRadius: number;
+    };
+};
 export declare const seriesOptionsDefaults: SeriesOptionsDefaults;
 export declare const seriesRangeSliderOptionsDefaults: Required<ChartSeriesRangeSliderOptions>;
 export {};

package/dist/cjs/core/constants/defaults/series-options.js

@@ -133,6 +133,19 @@ export const seriesOptionsDefaults = {
             },
         },
     },
+    'x-range': {
+        borderRadius: 0,
+        states: {
+            hover: {
+                enabled: true,
+                brightness: 0.3,
+            },
+            inactive: {
+                enabled: false,
+                opacity: 0.5,
+            },
+        },
+    },
 };
 export const seriesRangeSliderOptionsDefaults = {
     visible: true,

package/dist/cjs/core/i18n/keysets/en.json

@@ -21,7 +21,8 @@
     "label_invalid-axis-labels-html-not-supported-axis-type": "It seems you are trying to use \"labels.html\" property for an axis with an unsupported type. This property is supported only for \"category\" axis.",
     "label_duplicate-axis-categories": "It seems you have duplicate value \"{{duplicate}}\" found in {{key}}[{{axisIndex}}].",
     "label_invalid-axis-categories": "It seems you are trying to use inappropriate value for \"categories\", or defined it incorrectly. Categories must be a non-empty array for an axis with \"category\" type.",
-    "label_inconsistent-y-axis-configuration": "It seems you have inconsistent Y-axis configuration. Possible reasons:\n1. Multiple Y axes with the same position and plot index.\n2. At the moment, 'category' axis is not supported in dual Y-axis configurations."
+    "label_inconsistent-y-axis-configuration": "It seems you have inconsistent Y-axis configuration. Possible reasons:\n1. Multiple Y axes with the same position and plot index.\n2. At the moment, 'category' axis is not supported in dual Y-axis configurations.",
+    "label_stacking-area-connect-null-mode": "It seems you are using \"nullMode: 'connect'\" with a stacking area series. The \"connect\" null mode is not supported in stacking mode. Use \"zero\" or \"skip\" instead."
   },
   "tooltip": {
     "label_totals_sum": "Sum",

package/dist/cjs/core/i18n/keysets/ru.json

@@ -21,7 +21,8 @@
     "label_invalid-axis-labels-html-not-supported-axis-type": "Похоже, что вы пытаетесь использовать свойство \"labels.html\" для оси с неподдерживаемым типом. Это свойство поддерживается только для оси типа \"category\".",
     "label_duplicate-axis-categories": "Похоже, что у вас есть дублирующееся значение категории \"{{duplicate}}\" в оси {{key}}[{{axisIndex}}].",
     "label_invalid-axis-categories": "Похоже, что вы пытаетесь использовать недопустимое значение для \"categories\", или указали его неверно. Категории для оси типа \"category\" должны быть непустым массивом.",
-    "label_inconsistent-y-axis-configuration": "Похоже, что конфигурация осей Y неконсистентна. Возможные причины:\n1. Несколько осей Y имеют одинаковые значения position и plotIndex.\n2. На данный момент категорийные оси не поддерживаются в конфигурациях с двумя осями Y."
+    "label_inconsistent-y-axis-configuration": "Похоже, что конфигурация осей Y неконсистентна. Возможные причины:\n1. Несколько осей Y имеют одинаковые значения position и plotIndex.\n2. На данный момент категорийные оси не поддерживаются в конфигурациях с двумя осями Y.",
+    "label_stacking-area-connect-null-mode": "Похоже, что вы используете \"nullMode: 'connect'\" с серией area с накоплением. Режим null \"connect\" не поддерживается в режиме накопления. Используйте \"zero\" или \"skip\"."
   },
   "tooltip": {
     "label_totals_sum": "Сумма",

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/core/series/types.d.ts

@@ -1,4 +1,4 @@
-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 RectLegendSymbol = {
     shape: 'rect';
@@ -339,7 +339,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/cjs/core/types/chart/area.d.ts

@@ -76,9 +76,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/cjs/core/types/chart/series.d.ts

@@ -15,8 +15,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>;
 }
@@ -291,6 +292,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/cjs/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>;
@@ -87,7 +88,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/cjs/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/cjs/core/types/chart/x-range.js

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

package/dist/cjs/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/cjs/core/types/index.d.ts

@@ -30,6 +30,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/cjs/core/types/index.js

@@ -22,3 +22,4 @@ export * from './chart/radar';
 export * from './chart/heatmap';
 export * from './chart/funnel';
 export * from './chart/brush';
+export * from './chart/x-range';

package/dist/cjs/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/cjs/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/cjs/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));

package/dist/cjs/core/utils/get-closest-data.js

@@ -288,6 +288,25 @@ export function getClosestPoints(args) {
                 }
                 break;
             }
+            case 'x-range': {
+                const data = list;
+                const pointsInXRange = data.filter((d) => pointerX >= d.x &&
+                    pointerX <= d.x + d.width &&
+                    pointerY >= d.y &&
+                    pointerY <= d.y + d.height);
+                if (pointsInXRange.length === 0) {
+                    break;
+                }
+                const closestByX = pointsInXRange.length === 1
+                    ? pointsInXRange[0]
+                    : sort(pointsInXRange, (d) => Math.abs(d.x + d.width / 2 - pointerX))[0];
+                result.push(...pointsInXRange.map((d) => ({
+                    data: d.data,
+                    series: d.series,
+                    closest: d === closestByX,
+                })));
+                break;
+            }
         }
     });
     if (closestPointsByXValue.length) {

package/dist/cjs/core/validation/index.js

@@ -265,6 +265,18 @@ function validateStacking({ series }) {
         });
     }
 }
+function validateStackingAreaNullMode({ series }) {
+    const availableStackingValues = ['normal', 'percent'];
+    const invalid = series.find((s) => s.type === 'area' &&
+        availableStackingValues.includes(s.stacking) &&
+        s.nullMode === 'connect');
+    if (invalid) {
+        throw new ChartError({
+            code: CHART_ERROR_CODE.INVALID_DATA,
+            message: i18n('error', 'label_stacking-area-connect-null-mode'),
+        });
+    }
+}
 function validateTreemapSeries({ series }) {
     const parentIds = {};
     series.data.forEach((d) => {
@@ -379,6 +391,7 @@ export function validateData(data) {
     }
     validateAxes({ xAxis: data.xAxis, yAxis: data.yAxis });
     validateTooltip({ tooltip: data.tooltip });
+    validateStackingAreaNullMode({ series: data.series.data });
     if (data.series.data.some((s) => isEmpty(s.data))) {
         throw new ChartError({
             code: CHART_ERROR_CODE.INVALID_DATA,

package/dist/cjs/core/zoom/zoom.js

@@ -69,13 +69,30 @@ export function getZoomedSeriesData(args) {
             prevPointInRange = currentPointInRange;
             if (zoomState.x) {
                 const [xMin, xMax] = zoomState.x;
-                const x = 'x' in point ? ((_a = point.x) !== null && _a !== void 0 ? _a : undefined) : undefined;
-                inXRange = isValueInRange({
-                    axis: xAxis,
-                    value: x,
-                    min: xMin,
-                    max: xMax,
-                });
+                if ('x0' in point && 'x1' in point) {
+                    const isStartInRange = isValueInRange({
+                        axis: xAxis,
+                        value: point.x0,
+                        min: xMin,
+                        max: xMax,
+                    });
+                    const isEndInRange = isValueInRange({
+                        axis: xAxis,
+                        value: point.x1,
+                        min: xMin,
+                        max: xMax,
+                    });
+                    inXRange = isStartInRange || isEndInRange;
+                }
+                else {
+                    const x = 'x' in point ? ((_a = point.x) !== null && _a !== void 0 ? _a : undefined) : undefined;
+                    inXRange = isValueInRange({
+                        axis: xAxis,
+                        value: x,
+                        min: xMin,
+                        max: xMax,
+                    });
+                }
             }
             if (zoomState.y) {
                 const yAxisIndex = 'yAxis' in seriesItem && typeof seriesItem.yAxis === 'number'