@progress/kendo-react-charts 13.3.0-develop.9 → 13.4.0-develop.1

package/option-types/series-item/labels.to.interface.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Border, Margin, Padding } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesLabelsTo {
+    /**
+     * The background color of the `to` labels. Accepts a valid CSS color string, including hex and rgb.
+     */
+    background?: string;
+    /**
+     * The border of the `to` labels.
+     */
+    border?: Border;
+    /**
+     * The text color of the `to` labels. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The function which returns the Chart series `to` label content. You can split the text into multiple lines by using line feed characters (`"\n"`).
+     *
+     * The fields available in the function argument are:
+     * - `category`—The category name. Available for the Area, Bar, Column, Bubble, Donut, Line, Pie, and Waterfall series.
+     * - `dataItem`—The original data item used to construct the point. If binding to an array, it will be `null`.
+     * - `percentage`—The point value represented as a percentage value. Available only for the Donut, Pie, and 100% stacked charts.
+     * - `series`—The data series.
+     * - `value`—The point value. Can be a number or object containing each bound field.
+     * - `runningTotal`—The sum of point values since the last `"runningTotal"` summary point. Available for the Waterfall series.
+     * - `total`—The sum of all previous series values. Available for the Waterfall series.
+     */
+    content?: (e: any) => string;
+    /**
+     * The font style of the `to` labels.
+     */
+    font?: string;
+    /**
+     * The format of the `to` labels. Uses [IntlService format](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice#toc-format).
+     */
+    format?: string;
+    /**
+     * The margin of the `to` labels. A numeric value sets all margins.
+     */
+    margin?: Margin | number;
+    /**
+     * The padding of the `to` labels. A numeric value sets all paddings.
+     */
+    padding?: Padding | number;
+    /**
+     * The position of the `to` labels.
+     *
+     * The available options are:
+     * - `"center"`—The label is positioned at the point center.
+     * - `"insideBase"`—The label is positioned inside, near the base of the bar.
+     * - `"insideEnd"`—The label is positioned inside, near the end of the point.
+     * - `"outsideEnd"`—The label is positioned outside, near the end of the point.
+     * - `"above"`—The label is positioned at the top of the marker. Applicable for the RangeArea and VerticalRangeArea series.
+     * - `"below"`—The label is positioned at the bottom of the marker. Applicable for the RangeArea and VerticalRangeArea series.
+     * - `"left"`—The label is positioned to the left of the marker. Applicable for the RangeArea and VerticalRangeArea series.
+     * - `"right"`—The label is positioned to the right of the marker. Applicable for the RangeArea and VerticalRangeArea series.
+     */
+    position?: 'center' | 'insideBase' | 'insideEnd' | 'outsideEnd';
+    /**
+     * If set to `true`, the Chart displays the series `to` labels. By default, the Chart series `to` labels are not displayed.
+     */
+    visible?: boolean;
+}

package/option-types/series-item/markers.interface.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { drawing } from '@progress/kendo-drawing';
+import { Border, MarkersVisualArgs, MarkerType } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesMarkers {
+    /**
+     * The background color of the series markers.
+     */
+    background?: string;
+    /**
+     * The border of the markers.
+     */
+    border?: Border;
+    /**
+     * The rotation angle of the markers.
+     */
+    rotation?: number;
+    /**
+     * The marker size in pixels.
+     */
+    size?: number;
+    /**
+     * The border radius in pixels when `type` is set to `"roundedRect"`. Defaults to 1/5 of the marker size.
+     */
+    borderRadius?: number;
+    /**
+     * The shape of the series markers.
+     *
+     * The supported values are:
+     * * `"circle"`—The marker shape is a circle.
+     * * `"square"`—The marker shape is a square.
+     * * `"triangle"`—The marker shape is a triangle.
+     * * `"cross"`—The marker shape is a cross.
+     * * `"rect"`—An alias for "square".
+     * * `"roundedRect"`—The marker shape is a rounded rectangle.
+     */
+    type?: MarkerType;
+    /**
+     * If set to `true`, the Chart displays the series markers. By default, the Chart series markers are displayed.
+     */
+    visible?: boolean;
+    /**
+     * A function for creating a custom visual for the markers.
+     *
+     * The available argument fields are:
+     * - `rect`—The [geometry Rect](https://www.telerik.com/kendo-react-ui/components/drawing/api/geometry/rect) that defines where the visual has to be rendered.
+     * - `options`—The marker options.
+     * - `createVisual`—A function that can be used to get the default visual.
+     * - `category`—The category of the marker point.
+     * - `dataItem`—The `dataItem` of the marker point.
+     * - `value`—The value of the marker point.
+     * - `sender`—The Chart instance.
+     * - `series`—The series of the marker point.
+     */
+    visual?: (e: MarkersVisualArgs) => drawing.Element;
+    /**
+     * The Chart series marker configuration for the `from` point. Supported for the RangeArea and VerticalRangeArea series.
+     */
+    from?: SeriesMarkers;
+    /**
+     * The Chart series marker configuration for the `to` point. Supported for the RangeArea and VerticalRangeArea series.
+     */
+    to?: SeriesMarkers;
+}

package/option-types/series-item/notes.icon.interface.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Border, MarkerType } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesNotesIcon {
+    /**
+     * The background color of the notes icon.
+     */
+    background?: string;
+    /**
+     * The border of the notes icon.
+     */
+    border?: Border;
+    /**
+     * The size of the notes icon.
+     */
+    size?: number;
+    /**
+     * The icon shape.
+     *
+     * The supported values are:
+     * * `"circle"`—The marker shape is a circle.
+     * * `"square"`—The marker shape is a square.
+     * * `"triangle"`—The marker shape is a triangle.
+     * * `"cross"`—The marker shape is a cross.
+     */
+    type?: MarkerType;
+    /**
+     * The visibility of the notes icon.
+     */
+    visible?: boolean;
+}

package/option-types/series-item/notes.interface.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { drawing } from '@progress/kendo-drawing';
+import { NoteLine, NotePosition, SeriesNoteVisualArgs } from '../../common/property-types.js';
+import { SeriesNotesIcon } from './notes.icon.interface.js';
+import { SeriesNotesLabel } from './notes.label.interface.js';
+/**
+ * @hidden
+ */
+export interface SeriesNotes {
+    /**
+     * The line of the series notes.
+     */
+    line?: NoteLine;
+    /**
+     * The position of the series note.
+     *
+     * The available options are:
+     * - `"top"`—The note is positioned on the top.
+     * - `"bottom"`—The note is positioned on the bottom.
+     * - `"left"`—The note is positioned on the left.
+     * - `"right"`—The note is positioned on the right.
+     */
+    position?: NotePosition;
+    /**
+     * A function for creating a custom visual for the notes.
+     *
+     * The available argument fields are:
+     * - `rect`—The geometry [`Rect`](https://www.telerik.com/kendo-react-ui/components/drawing/api/geometry/rect) that defines the note target rect.
+     * - `options`—The note options.
+     * - `createVisual`—A function that can be used to get the default visual.
+     * - `category`—The category of the note point.
+     * - `dataItem`—The `dataItem` of the note point.
+     * - `value`—The value of the note point.
+     * - `sender`—The Chart instance.
+     * - `series`—The series of the note point.
+     * - `text`—The note text.
+     */
+    visual?: (e: SeriesNoteVisualArgs) => drawing.Element;
+    /**
+     * The icon of the notes.
+     */
+    icon?: SeriesNotesIcon;
+    /**
+     * The label of the notes.
+     */
+    label?: SeriesNotesLabel;
+}

package/option-types/series-item/notes.label.interface.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Border, NoteLabelPosition } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesNotesLabel {
+    /**
+     * The background color of the label. Accepts a valid CSS color string, including hex and rgb.
+     */
+    background?: string;
+    /**
+     * The border of the label.
+     */
+    border?: Border;
+    /**
+     * The text color of the label. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The function which returns the label content. The function argument contains a `value` field which defines the point value. You can split the text into multiple lines by using line feed characters (`"\n"`).
+     */
+    content?: (e: any) => string;
+    /**
+     * The font style of the label.
+     */
+    font?: string;
+    /**
+     * The format for displaying the notes label. Uses the [`format`](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice#toc-format) method of IntlService. Contains one placeholder (`"{0}"`) which represents the axis value.
+     */
+    format?: string;
+    /**
+     * The position of the labels.
+     *
+     * The available options are:
+     * - `"inside"`—The label is positioned inside the icon.
+     * - `"outside"`—The label is positioned outside the icon.
+     */
+    position?: NoteLabelPosition;
+    /**
+     * The rotation angle of the label. By default, the label is not rotated.
+     */
+    rotation?: number;
+    /**
+     * If set to `true`, the Chart displays the series notes label. By default, the series notes label is visible.
+     */
+    visible?: boolean;
+}

package/option-types/series-item/outliers.interface.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Border, MarkerType } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesOutliers {
+    /**
+     * The background color of the series outliers.
+     */
+    background?: string;
+    /**
+     * The border of the outliers.
+     */
+    border?: Border;
+    /**
+     * The rotation angle of the outliers.
+     */
+    rotation?: number;
+    /**
+     * The marker size in pixels.
+     */
+    size?: number;
+    /**
+     * The outliers shape.
+     *
+     * The supported values are:
+     * * `"circle"`—The marker shape is a circle.
+     * * `"square"`—The marker shape is a square.
+     * * `"triangle"`—The marker shape is a triangle.
+     * * `"cross"`—The marker shape is a cross.
+     */
+    type?: MarkerType;
+}

package/option-types/series-item/tooltip.interface.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Border, Padding } from '../../common/property-types.js';
+/**
+ * @hidden
+ */
+export interface SeriesTooltip {
+    /**
+     * The background color of the tooltip. Accepts a valid CSS color string, including hex and rgb.
+     */
+    background?: string;
+    /**
+     * The border configuration options.
+     */
+    border?: Border;
+    /**
+     * The text color of the tooltip. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The font of the tooltip.
+     */
+    font?: string;
+    /**
+     * The format of the labels. Uses the [`format`](https://www.telerik.com/kendo-react-ui/components/intl/api/intlservice#toc-format) method of IntlService.
+     *
+     * The available format placeholders are:
+     * - Area, Bar, Column, Line, Funnel, Pyramid, Pie, radarArea, radarColumn and radarLine: {0} - value.
+     * - Bubble: {0} - x value, {1} - y value, {2} - size value, {3} - category name.
+     * - Scatter, scatterLine: {0} - x value, {1} - y value.
+     * - PolarArea, polarLine and polarScatterL: {0} - x value (degrees), {1} - y value.
+     * - Candlestick and OHLC: {0} - open value, {1} - high value, {2} - low value, {3} - close value, {4} - category name.
+     * - RangeArea, rangeBar, rangeColumn: {0} - from value, {1} - to value.
+     */
+    format?: string;
+    /**
+     * The padding of the tooltip. A numeric value sets all paddings.
+     */
+    padding?: Padding | number;
+    /**
+     * If set to `true`, the Chart displays the series tooltip. By default, the series tooltip is not displayed.
+     */
+    visible?: boolean;
+}

package/option-types/series-item/trendline.interface.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { TrendlineForecast } from '../../common/property-types.js';
+/**
+ * The configuration options of the series trendlines.
+ */
+export interface SeriesTrendline {
+    /**
+     * The trendline forecast settings. By default, the trendline does not display a forecast.
+     *
+     * The forecast setting is supported for Linear Trendlines on date and scatter series.
+     */
+    forecast?: TrendlineForecast;
+    /**
+     * The number of intervals to take when calculating averages. The value should be an integer greater than 2.
+     *
+     * The period setting is supported only for Moving Average trendlines.
+     */
+    period?: number;
+    /**
+     * The order (degree) of the Polynomial trendline. The default value is 2.
+     *
+     * Accepted values are from 2 to 6:
+     * * 2: a Quadratic polynomial trendline with a single extreme point (minimum or maximum) point.
+     * * 3: a Cubic polynomial trendline with up to 2 extreme points.
+     * * 4: a polynomial trendline of 4th degree with up to 3 extreme points.
+     * * 5: a polynomial trendline of 5th degree with up to 4 extreme points.
+     * * 6: a polynomial trendline of 6th degree with up to 5 extreme points.
+     *
+     */
+    order?: number;
+}