@gravity-ui/charts 1.22.0 → 1.24.0

package/dist/esm/hooks/useTooltip/index.js

@@ -6,13 +6,14 @@ export const useTooltip = ({ dispatcher, tooltip }) => {
     React.useEffect(() => {
         if (tooltip === null || tooltip === void 0 ? void 0 : tooltip.enabled) {
             dispatcher.on('hover-shape.tooltip', (nextHovered, nextPointerPosition) => {
-                const isHoveredChanged = !isEqual(prevHovered.current, nextHovered);
+                const filteredNextHovered = nextHovered === null || nextHovered === void 0 ? void 0 : nextHovered.filter((item) => 'y' in item.data ? item.data.y !== null : true);
+                const isHoveredChanged = !isEqual(prevHovered.current, filteredNextHovered);
                 const newTooltipState = {
                     pointerPosition: nextPointerPosition,
-                    hovered: isHoveredChanged ? nextHovered : prevHovered.current,
+                    hovered: isHoveredChanged ? filteredNextHovered : prevHovered.current,
                 };
                 if (isHoveredChanged) {
-                    prevHovered.current = nextHovered;
+                    prevHovered.current = filteredNextHovered;
                 }
                 setTooltipState(newTooltipState);
             });
@@ -23,5 +24,8 @@ export const useTooltip = ({ dispatcher, tooltip }) => {
             }
         };
     }, [dispatcher, tooltip]);
-    return { hovered, pointerPosition };
+    return {
+        hovered,
+        pointerPosition,
+    };
 };

package/dist/esm/hooks/useZoom/index.d.ts

@@ -1,5 +1,6 @@
+import type { PreparedXAxis, PreparedYAxis } from '../useAxis/types';
 import type { ChartScale } from '../useAxisScales';
-import type { PreparedAxis, PreparedZoom } from '../useChartOptions/types';
+import type { PreparedZoom } from '../useChartOptions/types';
 import type { PreparedSplit } from '../useSplit/types';
 import type { ZoomState } from './types';
 interface UseZoomProps {
@@ -9,9 +10,9 @@ interface UseZoomProps {
     plotContainerWidth: number;
     preparedSplit: PreparedSplit;
     preparedZoom: PreparedZoom | null;
-    xAxis: PreparedAxis | null;
+    xAxis: PreparedXAxis | null;
     xScale?: ChartScale;
-    yAxis: PreparedAxis[];
+    yAxis: PreparedYAxis[];
     yScale?: (ChartScale | undefined)[];
 }
 export declare function useZoom(props: UseZoomProps): void;

package/dist/esm/hooks/useZoom/index.js

@@ -4,6 +4,7 @@ import { useBrush } from '../useBrush';
 import { selectionToZoomBounds } from './utils';
 export function useZoom(props) {
     const { node, onUpdate, plotContainerHeight, plotContainerWidth, preparedSplit, preparedZoom, xAxis, xScale, yAxis, yScale, } = props;
+    const isBrushDisabled = Boolean(!xAxis || !yAxis || !xScale || !yScale);
     const areas = React.useMemo(() => {
         const result = [];
         if (!preparedZoom) {
@@ -47,6 +48,7 @@ export function useZoom(props) {
     useBrush({
         areas,
         brushOptions: preparedZoom === null || preparedZoom === void 0 ? void 0 : preparedZoom.brush,
+        disabled: isBrushDisabled,
         node,
         type: preparedZoom === null || preparedZoom === void 0 ? void 0 : preparedZoom.type,
         onBrushEnd: handleChartBrushEnd,

package/dist/esm/hooks/useZoom/utils.d.ts

@@ -1,12 +1,13 @@
 import type { BrushSelection } from 'd3';
+import type { ZoomType } from '../../constants';
+import type { PreparedXAxis, PreparedYAxis } from '../useAxis/types';
 import type { ChartScale } from '../useAxisScales';
-import type { PreparedAxis, PreparedZoom } from '../useChartOptions/types';
 import type { ZoomState } from './types';
 export declare function selectionToZoomBounds(args: {
     selection: BrushSelection;
-    xAxis: PreparedAxis;
+    xAxis: PreparedXAxis;
     xScale: ChartScale;
-    yAxes: PreparedAxis[];
+    yAxes: PreparedYAxis[];
     yScales: (ChartScale | undefined)[];
-    zoomType: PreparedZoom['type'];
+    zoomType: ZoomType;
 }): Partial<ZoomState>;

package/dist/esm/hooks/useZoom/utils.js

@@ -1,13 +1,14 @@
+import { ZOOM_TYPE } from '../../constants';
 export function selectionToZoomBounds(args) {
     const { selection, xAxis, xScale, yAxes, yScales, zoomType } = args;
     const zoomState = {};
     switch (zoomType) {
-        case 'x': {
+        case ZOOM_TYPE.X: {
             const [x0, x1] = selection;
             zoomState.x = selectionXToZoomBounds({ xAxis, xScale, selection: [x0, x1] });
             break;
         }
-        case 'y': {
+        case ZOOM_TYPE.Y: {
             const [y1, y0] = selection;
             yAxes.forEach((yAxis, index) => {
                 if (!Array.isArray(zoomState.y)) {
@@ -27,7 +28,7 @@ export function selectionToZoomBounds(args) {
             });
             break;
         }
-        case 'xy': {
+        case ZOOM_TYPE.XY: {
             const [x0, y0] = selection[0];
             const [x1, y1] = selection[1];
             zoomState.x = selectionXToZoomBounds({ xAxis, xScale, selection: [x0, x1] });

package/dist/esm/hooks/utils/bar-x.d.ts

@@ -1,7 +1,7 @@
 import type { BarXSeries, BarXSeriesData } from '../../types';
-import type { PreparedAxis } from '../useChartOptions/types';
+import type { PreparedXAxis } from '../useAxis/types';
 import type { PreparedBarXSeries, PreparedSeriesOptions } from '../useSeries/types';
-export declare function groupBarXDataByXValue<T extends BarXSeries | PreparedBarXSeries>(series: T[], xAxis: PreparedAxis): Record<string | number, Record<string, {
+export declare function groupBarXDataByXValue<T extends BarXSeries | PreparedBarXSeries>(series: T[], xAxis: PreparedXAxis): Record<string | number, Record<string, {
     data: BarXSeriesData;
     series: T;
 }[]>>;

package/dist/esm/hooks/utils/bar-y.d.ts

@@ -1,9 +1,15 @@
 import type { BarYSeries, BarYSeriesData } from '../../types';
+import type { PreparedYAxis } from '../useAxis/types';
 import type { ChartScale } from '../useAxisScales';
-import type { PreparedAxis } from '../useChartOptions/types';
 import type { PreparedBarYSeries, PreparedSeriesOptions } from '../useSeries/types';
-export declare function groupBarYDataByYValue<T extends BarYSeries | PreparedBarYSeries>(series: T[], yAxis: PreparedAxis[]): Record<string | number, Record<string, {
-    data: BarYSeriesData;
+/**
+ * BarY always filters out data with null or replace null by zero.
+ */
+type PreparedBarYSeriesData = BarYSeriesData & {
+    x?: number | string;
+};
+export declare function groupBarYDataByYValue<T extends BarYSeries | PreparedBarYSeries>(series: T[], yAxis: PreparedYAxis[]): Record<string | number, Record<string, {
+    data: PreparedBarYSeriesData;
     series: T;
 }[]>>;
 export declare function getBarYLayout(args: {
@@ -16,3 +22,4 @@ export declare function getBarYLayout(args: {
     barGap: number;
     barSize: number;
 };
+export {};

package/dist/esm/hooks/utils/bar-y.js

@@ -4,10 +4,14 @@ import { getDataCategoryValue } from '../../utils';
 import { MIN_BAR_GAP, MIN_BAR_GROUP_GAP, MIN_BAR_WIDTH } from '../constants';
 import { getSeriesStackId } from '../useSeries/utils';
 import { getBandSize } from './get-band-size';
+const isSeriesDataValid = (d) => d.x !== null;
 export function groupBarYDataByYValue(series, yAxis) {
     const data = {};
     series.forEach((s) => {
         s.data.forEach((d) => {
+            if (!isSeriesDataValid(d)) {
+                return;
+            }
             const axisIndex = get(s, 'yAxis', 0);
             const seriesYAxis = yAxis[axisIndex];
             const categories = get(seriesYAxis, 'categories', []);

package/dist/esm/i18n/keysets/en.json

@@ -4,9 +4,9 @@
     "label_unknown-plugin": "Unknown plugin type \"{{type}}\"",
     "label_unknown-error": "Unknown error",
     "label_invalid-axis-category-data-point": "It seems you are trying to use inappropriate data type for \"{{key}}\" value in series \"{{seriesName}}\" for axis with type \"category\". Strings and numbers are allowed.",
-    "label_invalid-axis-datetime-data-point": "It seems you are trying to use inappropriate data type for \"{{key}}\" value in series \"{{seriesName}}\" for axis with type \"datetime\". Only numbers are allowed.",
+    "label_invalid-axis-datetime-data-point": "It seems you are trying to use inappropriate data type for \"{{key}}\" value in series \"{{seriesName}}\" for axis with type \"datetime\". Numbers are allowed.",
     "label_invalid-axis-linear-data-point": "It seems you are trying to use inappropriate data type for \"{{key}}\" value in series \"{{seriesName}}\" for axis with type \"linear\". Numbers and nulls are allowed.",
-    "label_invalid-pie-data-value": "It seems you are trying to use inappropriate data type for \"value\" value. Only numbers are allowed.",
+    "label_invalid-pie-data-value": "It seems you are trying to use inappropriate data type for \"value\" value. Only numbers or nulls are allowed.",
     "label_invalid-series-type": "It seems you haven't defined \"series.type\" property, or defined it incorrectly. Available values: [{{types}}].",
     "label_invalid-series-property": "It seems you are trying to use inappropriate value for \"{{key}}\", or defined it incorrectly. Available values: [{{values}}].",
     "label_invalid-treemap-redundant-value": "It seems you are trying to set \"value\" for container node. Check node with this properties: { id: \"{{id}}\", name: \"{{name}}\" }",

package/dist/esm/i18n/keysets/ru.json

@@ -4,9 +4,9 @@
     "label_unknown-plugin": "Неизвестный тип плагина \"{{type}}\"",
     "label_unknown-error": "Неизвестная ошибка",
     "label_invalid-axis-category-data-point": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"{{key}}\" в серии \"{{seriesName}}\" для оси с типом \"category\". Допускается использование строк и чисел.",
-    "label_invalid-axis-datetime-data-point": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"{{key}}\" в серии \"{{seriesName}}\" для оси с типом \"datetime\". Допускается только использование чисел.",
+    "label_invalid-axis-datetime-data-point": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"{{key}}\" в серии \"{{seriesName}}\" для оси с типом \"datetime\". Допускается использование чисел.",
     "label_invalid-axis-linear-data-point": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"{{key}}\" в серии \"{{seriesName}}\" для оси с типом \"linear\". Допускается использование чисел и значений null.",
-    "label_invalid-pie-data-value": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"value\". Допускается только использование чисел.",
+    "label_invalid-pie-data-value": "Похоже, что вы пытаетесь использовать недопустимый тип данных для значения \"value\". Допускается только использование чисел или null.",
     "label_invalid-series-type": "Похоже, что вы не указали значение \"series.type\" или указали его неверно. Доступные значения: [{{types}}].",
     "label_invalid-series-property": "Похоже, что вы пытаетесь использовать недопустимое значение для \"{{key}}\", или указали его неверно. Доступные значения: [{{values}}].",
     "label_invalid-treemap-redundant-value": "Похоже, что вы пытаетесь установить значение \"value\" для узла, используемого в качестве контейнера. Проверьте узел с этими свойствами: { id: \"{{id}}\", name: \"{{name}}\" }",

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

@@ -1,8 +1,9 @@
-import type { SeriesType } from '../../constants';
+import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
 import type { BaseSeries, BaseSeriesData } from './base';
 import type { ChartLegend, RectLegendSymbolOptions } from './legend';
 import type { PointMarkerOptions } from './marker';
+import type { ChartSeriesRangeSliderOptions } from './series';
 export interface AreaSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     /**
      * The `x` value of the point. Depending on the context , it may represents:
@@ -17,7 +18,7 @@ export interface AreaSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
      * - timestamp value (for `datetime` y axis)
      * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
      */
-    y?: string | number;
+    y?: string | number | null;
     /** Data label value of the point. If not specified, the y value is used. */
     label?: string | number;
     /** Individual marker options for the point. */
@@ -41,7 +42,7 @@ export interface AreaMarkerOptions extends PointMarkerOptions {
     symbol?: AreaMarkerSymbol;
 }
 export interface AreaSeries<T = MeaningfulAny> extends BaseSeries {
-    type: typeof SeriesType.Area;
+    type: typeof SERIES_TYPE.Area;
     data: AreaSeriesData<T>[];
     /** The name of the series (used in legend, tooltip etc) */
     name: string;
@@ -73,4 +74,18 @@ export interface AreaSeries<T = MeaningfulAny> extends BaseSeries {
     marker?: AreaMarkerOptions;
     /** Y-axis index (when using two axes) */
     yAxis?: number;
+    /**
+     * Specifies how null or undefined values should be handled in the series.
+     *
+     * - `'connect'`: Connect points across null values (skip nulls in rendering)
+     * - `'zero'`: Treat null values as zero
+     * - `'skip'`: Omit the data point (creates gap in area)
+     *
+     * @default 'skip'
+     */
+    nullMode?: 'connect' | 'zero' | 'skip';
+    /**
+     * Options to configure how this series appears and behaves in the Range Slider component.
+     */
+    rangeSlider?: ChartSeriesRangeSliderOptions;
 }

package/dist/esm/types/chart/axis.d.ts

@@ -1,6 +1,8 @@
+import type { DurationInput } from '@gravity-ui/date-utils';
 import type { AXIS_TYPE, DashStyle } from '../../constants';
 import type { FormatNumberOptions } from '../formatter';
 import type { BaseTextStyle } from './base';
+import type { ChartBrush } from './brush';
 export type ChartAxisType = (typeof AXIS_TYPE)[keyof typeof AXIS_TYPE];
 export type ChartAxisTitleAlignment = 'left' | 'center' | 'right';
 export interface ChartAxisLabels {
@@ -40,6 +42,40 @@ export interface ChartAxisLabels {
      * */
     maxWidth?: number | string;
 }
+export interface ChartAxisRangeSlider {
+    /**
+     * Range slider brush configuration.
+     */
+    brush?: ChartBrush;
+    /**
+     * Configuration for the range slider state after the initial chart render.
+     */
+    defaultRange?: {
+        /**
+         * Default size of the range slider.
+         *
+         * The value type depends on the axis scale:
+         * - For `datetime` axes: {@link https://github.com/gravity-ui/date-utils/blob/8d53ff16a4582831140e75f1305dc6a0112a5ad6/src/typings/duration.ts#L7 DurationInput}
+         * - For `linear` and `logarithmic` axes: numeric value
+         */
+        size?: DurationInput | number;
+    };
+    /**
+     * Enable or disable the display of range slider
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * The height of the range slider in pixels.
+     * @default 40
+     */
+    height?: number;
+    /**
+     * The pixel distance between the range slider and the the X axis or X axis labels.
+     * @default 10
+     */
+    margin?: number;
+}
 export interface ChartAxis {
     categories?: string[];
     /** Configure a crosshair that follows either the mouse pointer or the hovered point. */
@@ -124,6 +160,15 @@ export interface ChartAxis {
     order?: 'sortAsc' | 'sortDesc' | 'reverse';
 }
 export interface ChartXAxis extends ChartAxis {
+    /**
+     * Configuration options for the chart range slider component.
+     *
+     * The range slider allows users to select a specific range of data to display
+     * on the chart by adjusting the slider handles.
+     *
+     * Supported only for `linear`, `datetime`, and `logarithmic` axes.
+     */
+    rangeSlider?: ChartAxisRangeSlider;
 }
 export type PlotLayerPlacement = 'before' | 'after';
 export interface AxisPlot {

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

@@ -1,8 +1,8 @@
-import type { SeriesType } from '../../constants';
+import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
 import type { BaseSeries, BaseSeriesData } from './base';
 import type { ChartLegend, RectLegendSymbolOptions } from './legend';
-import type { ChartSeriesOptions } from './series';
+import type { ChartSeriesOptions, ChartSeriesRangeSliderOptions } from './series';
 export interface BarXSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     /**
      * The `x` value of the bar. Depending on the context , it may represents:
@@ -17,7 +17,7 @@ export interface BarXSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
      * - timestamp value (for `datetime` y axis)
      * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
      */
-    y?: string | number;
+    y?: string | number | null;
     /**
      * Corresponding value of axis category.
      *
@@ -30,7 +30,7 @@ export interface BarXSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     opacity?: number;
 }
 export interface BarXSeries<T = MeaningfulAny> extends BaseSeries {
-    type: typeof SeriesType.BarX;
+    type: typeof SERIES_TYPE.BarX;
     data: BarXSeriesData<T>[];
     /** The name of the series (used in legend, tooltip etc) */
     name: string;
@@ -69,4 +69,17 @@ export interface BarXSeries<T = MeaningfulAny> extends BaseSeries {
     };
     /** Y-axis index (when using two axes) */
     yAxis?: number;
+    /**
+     * Specifies how null or undefined values should be handled in the series.
+     *
+     * - `'skip'`: Omit data points with null values (no bar shown)
+     * - `'zero'`: Treat null values as zero
+     *
+     * @default 'skip'
+     */
+    nullMode?: 'zero' | 'skip';
+    /**
+     * Options to configure how this series appears and behaves in the Range Slider component.
+     */
+    rangeSlider?: ChartSeriesRangeSliderOptions;
 }

package/dist/esm/types/chart/bar-y.d.ts

@@ -1,4 +1,4 @@
-import type { SeriesType } from '../../constants';
+import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
 import type { BaseSeries, BaseSeriesData } from './base';
 import type { ChartLegend, RectLegendSymbolOptions } from './legend';
@@ -9,7 +9,7 @@ export interface BarYSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
      * - timestamp value (for `datetime` x axis)
      * - x axis category value (for `category` x axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `xAxis.categories`
      */
-    x?: string | number;
+    x?: string | number | null;
     /**
      * The `y` value of the bar. Depending on the context , it may represents:
      * - numeric value (for `linear` y axis)
@@ -23,7 +23,7 @@ export interface BarYSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     opacity?: number;
 }
 export interface BarYSeries<T = MeaningfulAny> extends BaseSeries {
-    type: typeof SeriesType.BarY;
+    type: typeof SERIES_TYPE.BarY;
     data: BarYSeriesData<T>[];
     /** The name of the series (used in legend, tooltip etc) */
     name: string;
@@ -71,4 +71,13 @@ export interface BarYSeries<T = MeaningfulAny> extends BaseSeries {
     legend?: ChartLegend & {
         symbol?: RectLegendSymbolOptions;
     };
+    /**
+     * Specifies how null or undefined values should be handled in the series.
+     *
+     * - `'skip'`: Omit data points with null values (no bar shown)
+     * - `'zero'`: Treat null values as zero
+     *
+     * @default 'skip'
+     */
+    nullMode?: 'zero' | 'skip';
 }

package/dist/esm/types/chart/base.d.ts

@@ -15,37 +15,38 @@ export type CustomFormat = {
     }) => string;
 };
 export type ValueFormat = NumberFormat | DateFormat;
+export interface BaseDataLabels {
+    /**
+     * Enable or disable the data labels
+     * @default true
+     */
+    enabled?: boolean;
+    style?: Partial<BaseTextStyle>;
+    /**
+     * @default 5
+     * */
+    padding?: number;
+    /**
+     * @default false
+     * */
+    allowOverlap?: boolean;
+    /**
+     * Allows to use any html-tags to display the content.
+     * The element will be displayed outside the box of the SVG element.
+     *
+     * @default false
+     * */
+    html?: boolean;
+    /** Formatting settings for labels. */
+    format?: ValueFormat;
+}
 export interface BaseSeries {
     /** Initial visibility of the series */
     visible?: boolean;
     /**
      * Options for the series data labels, appearing next to each data point.
      * */
-    dataLabels?: {
-        /**
-         * Enable or disable the data labels
-         * @default true
-         */
-        enabled?: boolean;
-        style?: Partial<BaseTextStyle>;
-        /**
-         * @default 5
-         * */
-        padding?: number;
-        /**
-         * @default false
-         * */
-        allowOverlap?: boolean;
-        /**
-         * Allows to use any html-tags to display the content.
-         * The element will be displayed outside the box of the SVG element.
-         *
-         * @default false
-         * */
-        html?: boolean;
-        /** Formatting settings for labels. */
-        format?: ValueFormat;
-    };
+    dataLabels?: BaseDataLabels;
     /** You can set the cursor to "pointer" if you have click events attached to the series, to signal to the user that the points and lines can be clicked. */
     cursor?: string;
     /**

package/dist/esm/types/chart/brush.d.ts

@@ -0,0 +1,22 @@
+export interface ChartBrush {
+    borderColor?: string;
+    borderWidth?: number;
+    handles?: {
+        borderColor?: string;
+        borderWidth?: number;
+        enabled?: boolean;
+        /**
+         * Height of the handles in pixels.
+         * @default 15
+         */
+        height?: number;
+        /**
+         * Width of the handles in pixels.
+         * @default 8
+         */
+        width?: number;
+    };
+    style?: {
+        fillOpacity?: number;
+    };
+}

package/dist/esm/types/chart/brush.js

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

package/dist/esm/types/chart/funnel.d.ts

@@ -0,0 +1,46 @@
+import type { DashStyle, SERIES_TYPE } from '../../constants';
+import type { MeaningfulAny } from '../misc';
+import type { BaseDataLabels, BaseSeries, BaseSeriesData } from './base';
+import type { ChartLegend, RectLegendSymbolOptions } from './legend';
+export interface FunnelSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
+    /** The value of the funnel segment. */
+    value: number;
+    /** The name of the funnel segment (used in legend, tooltip etc). */
+    name: string;
+    /** Initial data label of the funnel segment. If not specified, the value is used. */
+    label?: string;
+}
+export interface FunnelSeries<T = MeaningfulAny> extends Omit<BaseSeries, 'dataLabels'> {
+    type: typeof SERIES_TYPE.Funnel;
+    data: FunnelSeriesData<T>[];
+    /** The name of the funnel series. */
+    name?: string;
+    /** The color of the funnel series. */
+    color?: string;
+    /** Individual series legend options. Has higher priority than legend options in widget data */
+    legend?: ChartLegend & {
+        symbol?: RectLegendSymbolOptions;
+    };
+    /** Lines or areas connecting the funnel segments. */
+    connectors?: {
+        enabled?: boolean;
+        /** The height of the connector area relative to the funnel segment. */
+        height?: string | number;
+        /** Option for line stroke style */
+        lineDashStyle?: DashStyle;
+        /** Opacity for the connector line. */
+        lineOpacity?: number;
+        /** Connector line color. */
+        lineColor?: string;
+        /** Connector line width in pixels. */
+        lineWidth?: number;
+        /** Connector area color. */
+        areaColor?: string;
+        /** Opacity for the connector area. */
+        areaOpacity?: number;
+    };
+    dataLabels?: Omit<BaseDataLabels, 'html' | 'allowOverlap'> & {
+        /** Horizontal alignment of the data labels. */
+        align?: 'left' | 'center' | 'right';
+    };
+}

package/dist/esm/types/chart/funnel.js

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

package/dist/esm/types/chart/heatmap.d.ts

@@ -1,4 +1,4 @@
-import type { SeriesType } from '../../constants';
+import type { SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
 import type { BaseSeries, BaseSeriesData } from './base';
 import type { ChartLegend, RectLegendSymbolOptions } from './legend';
@@ -18,12 +18,12 @@ export interface HeatmapSeriesData<T = MeaningfulAny> extends BaseSeriesData<T>
      */
     y?: string | number;
     /** Value of the heatmap cell */
-    value?: number;
+    value?: number | null;
     /** Data label value of the heatmap cell. If not specified, the value is used. */
     label?: string;
 }
 export interface HeatmapSeries<T = MeaningfulAny> extends BaseSeries {
-    type: typeof SeriesType.Heatmap;
+    type: typeof SERIES_TYPE.Heatmap;
     data: HeatmapSeriesData<T>[];
     /** The name of the series (used in legend, tooltip etc) */
     name: string;
@@ -44,4 +44,13 @@ export interface HeatmapSeries<T = MeaningfulAny> extends BaseSeries {
      * The color of the border surrounding each cell.
      */
     borderColor?: string;
+    /**
+     * Specifies how null or undefined values should be handled in the series.
+     *
+     * - `'zero'`: Treat null values as zero
+     * - `'skip'`: Omit data points with null values (show gaps)
+     *
+     * @default 'skip'
+     */
+    nullMode?: 'zero' | 'skip';
 }

package/dist/esm/types/chart/legend.d.ts

@@ -59,6 +59,12 @@ export interface ChartLegend {
      * @default false
      * */
     html?: boolean;
+    /**
+     * The position of the legend box within the chart area.
+     *
+     * @default 'bottom'
+     * */
+    position?: 'top' | 'bottom';
 }
 export interface BaseLegendSymbol {
     /**

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

@@ -1,8 +1,9 @@
-import type { DashStyle, LineCap, SeriesType } from '../../constants';
+import type { DashStyle, LineCap, SERIES_TYPE } from '../../constants';
 import type { MeaningfulAny } from '../misc';
 import type { BaseSeries, BaseSeriesData } from './base';
 import type { ChartLegend, RectLegendSymbolOptions } from './legend';
 import type { PointMarkerOptions } from './marker';
+import type { ChartSeriesRangeSliderOptions } from './series';
 export interface LineSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     /**
      * The `x` value of the point. Depending on the context , it may represents:
@@ -17,7 +18,7 @@ export interface LineSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
      * - timestamp value (for `datetime` y axis)
      * - y axis category value (for `category` y axis). If the type is a string, then it is a category value itself. If the type is a number, then it is the index of an element in the array of categories described in `yAxis[0].categories`
      */
-    y?: string | number;
+    y?: string | number | null;
     /** Data label value of the point. If not specified, the y value is used. */
     label?: string | number;
     marker?: {
@@ -29,7 +30,7 @@ export interface LineSeriesData<T = MeaningfulAny> extends BaseSeriesData<T> {
     };
 }
 export interface LineSeries<T = MeaningfulAny> extends BaseSeries {
-    type: typeof SeriesType.Line;
+    type: typeof SERIES_TYPE.Line;
     data: LineSeriesData<T>[];
     /** The name of the series (used in legend, tooltip etc) */
     name: string;
@@ -54,4 +55,18 @@ export interface LineSeries<T = MeaningfulAny> extends BaseSeries {
     opacity?: number;
     /** Y-axis index (when using two axes) */
     yAxis?: number;
+    /**
+     * Specifies how null or undefined values should be handled in the series.
+     *
+     * - `'connect'`: Connect points across null values (skip nulls in rendering)
+     * - `'zero'`: Treat null values as zero
+     * - `'skip'`: Omit the data point (creates gap in line)
+     *
+     * @default 'skip'
+     */
+    nullMode?: 'connect' | 'zero' | 'skip';
+    /**
+     * Options to configure how this series appears and behaves in the Range Slider component.
+     */
+    rangeSlider?: ChartSeriesRangeSliderOptions;
 }