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

package/field-types/marker-type.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Specifies the marker type.
+ *
+ * > Note that `"rect"` is an alias for `"square"`.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [1, 2, 3];
+ * const markerType = "cross";
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartSeries>
+ *      <ChartSeriesItem type="line" data={data} markers={{ type: markerType }} />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type MarkerType = 'square' | 'circle' | 'triangle' | 'cross' | 'rect' | 'roundedRect';

package/field-types/modifier-key.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Specifies a modifier key.
+ */
+export type ModifierKey = 'none' | 'ctrl' | 'shift' | 'alt';

package/field-types/mousewheel-select.interface.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Configuration of the mousewheel action for selection.
+ */
+export interface MousewheelSelect {
+    /**
+     * If set to `true`, the option reverses the mousewheel direction. For `"zoom out"`, the regular direction is down. For `"zoom in"`, the regular direction is up.
+     */
+    reverse?: boolean;
+    /**
+     * The zoom direction of the selection.
+     *
+     * The supported values are:
+     * * `"both"`—Zooming expands and contracts the selection on both sides.
+     * * `"left"`—Zooming expands and contracts the selection on the left side only.
+     * * `"right"`—Zooming expands and contracts the selection on the right side only.
+     */
+    zoom?: 'both' | 'left' | 'right';
+}

package/field-types/mousewheel-zoom.interface.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { LockAxis } from './lock-axis.js';
+/**
+ * The configuration of the mousewheel action for zooming.
+ */
+export interface MousewheelZoom {
+    /**
+     * Specifies an axis that will not be zoomed.
+     */
+    lock?: LockAxis;
+    /**
+     * Specifies the zoom rate as percentage of the axis range. The default value is 0.3 or 30% of the axis range.
+     *
+     * The accepted range is from 0.01 to 0.9 (1% to 90%).
+     *
+     * @default 0.3
+     */
+    rate?: number;
+}

package/field-types/negative-bubble-values.interface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The appearance settings for the negative values in the Bubble series.
+ */
+export interface NegativeBubbleValues {
+    /**
+     * The color of the negative bubble Chart values.
+     */
+    color?: string;
+    /**
+     * If set to `true`, the Chart displays the negative bubbles. By default, the negative bubbles are not displayed.
+     */
+    visible?: boolean;
+}

package/field-types/note-label-position.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The position of a note label.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartValueAxis,
+ *  ChartValueAxisItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [{value: 1, label: { text: 'Foo' }}];
+ * const position = "outside";
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartValueAxis>
+ *      <ChartValueAxisItem notes={{ data, label: { position } }} />
+ *    </ChartValueAxis>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type NoteLabelPosition = 'inside' | 'outside';

package/field-types/note-line.interface.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { DashType } from './dash-type.js';
+/**
+ * The appearance settings for the note-connecting line.
+ */
+export interface NoteLine {
+    /**
+     * The color of the note line. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The dash type of the note line.
+     */
+    dashType?: DashType;
+    /**
+     * The length of the connecting line in pixels.
+     */
+    length?: number;
+    /**
+     * The width of the connecting line in pixels.
+     */
+    width?: number;
+}

package/field-types/note-position.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Specifies the position of a note.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartValueAxis,
+ *  ChartValueAxisItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [{value: 1}];
+ * const position = "right";
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartValueAxis>
+ *      <ChartValueAxisItem notes={{ data, position }} />
+ *    </ChartValueAxis>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type NotePosition = 'top' | 'bottom' | 'left' | 'right';

package/field-types/overlay.interface.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The appearance settings for the overlay of the series elements.
+ */
+export interface Overlay {
+    /**
+     * The gradient of the Chart series.
+     *
+     * The supported values are:
+     * * `"glass"`—Applicable for the Bar, Column, and Candlestick series.
+     * * `"none"`
+     * * `"roundedBevel"`—Applicable for the Donut and Pie series.
+     * * `"sharpBevel"`—Applicable for the Donut and Pie series.
+     */
+    gradient?: 'glass' | 'none' | 'roundedBevel' | 'sharpBevel';
+}

package/field-types/padding.interface.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Margin } from './margin.interface.js';
+/**
+ * The padding configuration for each side (see the [basic usage example](https://www.telerik.com/kendo-react-ui/components/charts/api/charttitle)).
+ */
+export interface Padding extends Margin {
+}

package/field-types/plot-band-label.interface.d.ts

@@ -0,0 +1,94 @@
+/**
+ * @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 { PlotBandLabelVisualArgs } from '../common/property-types.js';
+import { Border } from './border.interface.js';
+import { Margin } from './margin.interface.js';
+import { Padding } from './padding.interface.js';
+/**
+ * The appearance configuration for the plot band label.
+ */
+export interface PlotBandLabel {
+    /**
+     * The horizontal alignment of the label text.
+     *
+     * By default, the label is aligned to the left.
+     *
+     * The supported values are:
+     * - `"center"`—The label is positioned in the center of the plot band.
+     * - `"right"`—The label is positioned on the right side of the plot band.
+     * - `"left"`—The label is positioned on the left side of the plot band.
+     */
+    align?: 'center' | 'right' | 'left';
+    /**
+     * 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 color of the plot band label text.
+     * Accepts a valid [CSS `color`](https://developer.mozilla.org/en-US/docs/Web/CSS/color)
+     * configuration string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The font of the plot band label text.
+     * Accepts a valid [CSS `font`](https://developer.mozilla.org/en-US/docs/Web/CSS/font)
+     * configuration string.
+     */
+    font?: string;
+    /**
+     * The margin of the label. A numeric value sets all margins.
+     */
+    margin?: Margin | number;
+    /**
+     * The padding of the label. A numeric value sets all paddings.
+     */
+    padding?: Padding | number;
+    /**
+     * The vertical position of the label inside the plot band.
+     *
+     * By default, the label is aligned to the top.
+     *
+     * The supported values are:
+     * - `"bottom"`—The label is positioned on the bottom of the plot band.
+     * - `"center"`—The label is positioned in the center of the plot band.
+     * - `"top"`—The label is positioned on the top of the plot band.
+     */
+    position?: 'bottom' | 'center' | 'top';
+    /**
+     * The rotation angle of the label. By default, the label is not rotated.
+     */
+    rotation?: number;
+    /**
+     * The text of the label.
+     *
+     * > The text can be split into multiple lines by using line feed characters ("\n").
+     */
+    text?: string;
+    /**
+     * If set to `false`, the will not display the plot band label.
+     * By default, the plot band labels are not displayed.
+     */
+    visible?: boolean;
+    /**
+     * A function that can be used to create a custom visual for the label.
+     *
+     * The available argument fields are:
+     *
+     * - `text`—The label text.
+     * - `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 label options.
+     * - `createVisual`—A function that can be used to get the default visual.
+     * - `sender`—A reference to the Chart instance.
+     */
+    visual?: (e: PlotBandLabelVisualArgs) => drawing.Element;
+}

package/field-types/plot-band.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 { PlotBandLabel } from './plot-band-label.interface.js';
+/**
+ * A plot band ([see example](https://www.telerik.com/kendo-react-ui/components/charts/chart/elements/plot-bands)).
+ */
+export interface PlotBand {
+    /**
+     * The color of the plot band.
+     */
+    color?: string;
+    /**
+     * The start position of the plot band in axis units.
+     */
+    from?: number | Date;
+    /**
+     * The opacity of the plot band.
+     */
+    opacity?: number;
+    /**
+     * The end position of the plot band in axis units.
+     */
+    to?: number | Date;
+    /**
+     * The label configuration of the plot band.
+     *
+     * To display a label, set the text option.
+     *
+     * See [Plot Bands - Labels](https://www.telerik.com/kendo-react-ui/components/charts/chart/elements/plot-bands#toc-labels) for sample usage.
+     */
+    label?: PlotBandLabel;
+}

package/field-types/series-labels-position.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Configures the position of the series labels.
+ *
+ * - `"above"`—The label is positioned at the top of the marker. Applicable for series that render points, including the Bubble series.
+ * - `"below"`—The label is positioned at the bottom of the marker. Applicable for series that render points, including the Bubble series.
+ * - `"center"`—The label is positioned at the point center. Applicable for the Bar, Column, Donut, Pie, Funnel, Pyramid, RadarColumn, and Waterfall series.
+ * - `"insideBase"`—The label is positioned inside, near the base of the bar. Applicable for the Bar, Column, and Waterfall series.
+ * - `"insideEnd"`—The label is positioned inside, near the end of the point. Applicable for the Bar, Column, Donut, Pie, RadarColumn, and Waterfall series.
+ * - `"left"`—The label is positioned to the left of the marker. Applicable for series that render points, including the Bubble series.
+ * - `"outsideEnd"`—The label is positioned outside, near the end of the point. Applicable for the Bar, Column, Donut, Pie, RadarColumn, and Waterfall series. Not applicable for stacked series.
+ * - `"right"`—The label is positioned to the right of the marker. Applicable for series that render points, including the Bubble series.
+ * - `"top"`—The label is positioned at the top of the segment. Applicable for the Funnel and Pyramid series.
+ * - `"bottom"`—The label is positioned at the bottom of the segment. Applicable for the Funnel and Pyramid series.
+ * - `"auto"`—The from and to labels are positioned at the top or bottom (for the RangeArea series), or to the left or right (for the VerticalRangeArea series), so that they are outside the filled area. Applicable for the RangeArea and VerticalRangeArea series.
+ */
+export type SeriesLabelsPosition = 'auto' | 'above' | 'below' | 'center' | 'insideBase' | 'insideEnd' | 'left' | 'outsideEnd' | 'right' | 'top' | 'bottom';

package/field-types/series-line.interface.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { LineStyle } from './line-style.js';
+/**
+ * The appearance settings for the line of the Area, Candlestick, OHLC, and Waterfall series.
+ */
+export interface SeriesLine {
+    /**
+     * The color of the line. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The line opacity. By default, the line is opaque (`opacity = 1`).
+     */
+    opacity?: number;
+    /**
+     * The drawing style of the line. Applicable for the Area, Range Area, Polar Area, and Radar Area series.
+     *
+     * The supported values are:
+     * * `"normal" (default)`—The values are connected with a straight line.
+     * * `"step"`—The values are connected with a right-angled line. Supported only for the Area and Range Area series.
+     * * `"smooth"`—The values are connected with a smooth line.
+     */
+    style?: LineStyle;
+    /**
+     * The line width in pixels.
+     * By default, the width is set to `0` and the line is not visible.
+     */
+    width?: number;
+}

package/field-types/series-stack.interface.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Configures the Stacked series.
+ */
+export interface SeriesStack {
+    /**
+     * The optional stack group name. The `group` option is supported for the Bar and Column series.
+     */
+    group?: string;
+    /**
+     * The type of stack to plot.
+     *
+     * The supported types are:
+     * * `"normal"`—The value of the stack is the sum of all points in the category (or group).
+     * * `"100%"`—The value of the stack is always 100% (1.00). Points within the category (or group) are represented in percentage.
+     */
+    type?: 'normal' | '100%';
+}

package/field-types/series-type.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * [The series type](https://www.telerik.com/kendo-react-ui/components/charts/series-types#series-type)
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [1, 2, 3];
+ * const seriesType = "verticalLine";
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartSeries>
+ *      <ChartSeriesItem type="line" data={data} type={seriesType} />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type SeriesType = 'area' | 'bar' | 'boxPlot' | 'bubble' | 'bullet' | 'candlestick' | 'column' | 'donut' | 'exponentialTrendline' | 'funnel' | 'pyramid' | 'heatmap' | 'horizontalWaterfall' | 'line' | 'linearTrendline' | 'logarithmicTrendline' | 'movingAverageTrendline' | 'ohlc' | 'pie' | 'polarArea' | 'polarLine' | 'polarScatter' | 'polynomialTrendline' | 'powerTrendline' | 'radarArea' | 'radarColumn' | 'radarLine' | 'rangeArea' | 'rangeBar' | 'rangeColumn' | 'scatter' | 'scatterLine' | 'verticalArea' | 'verticalBoxPlot' | 'verticalBullet' | 'verticalLine' | 'verticalRangeArea' | 'waterfall';

package/field-types/trendline-forecast.interface.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The series trendline forecast settings.
+ */
+export interface TrendlineForecast {
+    /**
+     * The number of intervals to extend the trendline before the first data point.
+     */
+    before?: number;
+    /**
+     * The number of intervals to extend the trendline after the last data point.
+     */
+    after?: number;
+}

package/field-types/week-start-day.enum.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Specifies the `weekStartDay` of a [ChartCategoryAxisItem](https://www.telerik.com/kendo-react-ui/components/charts/api/chartcategoryaxisitem).
+ */
+export declare enum WeekStartDay {
+    /**
+     * Specifies Sunday as the first day of the week.
+     */
+    Sunday = 0,
+    /**
+     * Specifies Monday as the first day of the week.
+     */
+    Monday = 1,
+    /**
+     * Specifies Tuesday as the first day of the week.
+     */
+    Tuesday = 2,
+    /**
+     * Specifies Wednesday as the first day of the week.
+     */
+    Wednesday = 3,
+    /**
+     * Specifies Thursday as the first day of the week.
+     */
+    Thursday = 4,
+    /**
+     * Specifies Friday as the first day of the week.
+     */
+    Friday = 5,
+    /**
+     * Specifies Saturday as the first day of the week.
+     */
+    Saturday = 6
+}