@gravity-ui/charts 1.43.1 → 1.45.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/annotation.d.ts

@@ -0,0 +1,12 @@
+export declare const annotationLabelDefaults: {
+    style: {
+        fontSize: string;
+        fontColor: string;
+    };
+};
+export declare const annotationPopupDefaults: {
+    backgroundColor: string;
+    borderRadius: number;
+    offset: number;
+    padding: [number, number];
+};

package/dist/cjs/core/constants/defaults/annotation.js

@@ -0,0 +1,12 @@
+export const annotationLabelDefaults = {
+    style: {
+        fontSize: '13px',
+        fontColor: 'var(--g-color-text-light-primary)',
+    },
+};
+export const annotationPopupDefaults = {
+    backgroundColor: 'var(--g-color-base-float-heavy)',
+    borderRadius: 4,
+    offset: 5,
+    padding: [4, 8],
+};

package/dist/cjs/core/constants/defaults/index.d.ts

@@ -1,3 +1,4 @@
+export * from './annotation';
 export * from './axis';
 export * from './brush';
 export * from './data-labels';

package/dist/cjs/core/constants/defaults/index.js

@@ -1,3 +1,4 @@
+export * from './annotation';
 export * from './axis';
 export * from './brush';
 export * from './data-labels';

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/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/cjs/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/cjs/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/cjs/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/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,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/cjs/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/cjs/core/types/chart/annotation.js

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

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