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

package/field-types/auto-base-unit-steps.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The provided time-interval steps when `baseUnit` is set to either `"fit"` or `"auto"`.
+ * The axis will try to divide the active period into the smallest possible units
+ * that yield `maxDateGroups` or less discrete intervals.
+ */
+export interface AutoBaseUnitSteps {
+    /**
+     * The preferred interval steps when displaying milliseconds.
+     */
+    milliseconds?: number[];
+    /**
+     * The preferred interval steps when displaying seconds.
+     */
+    seconds?: number[];
+    /**
+     * The preferred interval steps when displaying minutes.
+     */
+    minutes?: number[];
+    /**
+     * The preferred interval steps when displaying hours.
+     */
+    hours?: number[];
+    /**
+     * The preferred interval steps when displaying days.
+     */
+    days?: number[];
+    /**
+     * The preferred interval steps when displaying weeks.
+     */
+    weeks?: number[];
+    /**
+     * The preferred interval steps when displaying months.
+     */
+    months?: number[];
+    /**
+     * The preferred interval steps when displaying years.
+     */
+    years?: number[];
+}

package/field-types/axis-labels-position.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
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The position of the axis labels.
+ *
+ * @example
+ * ```jsx
+ * import { Chart, ChartValueAxis, ChartValueAxisItem } from '@progress/kendo-react-charts';
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartValueAxis>
+ *      <ChartValueAxisItem labels={{ position: "end" }}/>
+ *    </ChartValueAxis>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type AxisLabelsPosition = 'start' | 'end' | 'onAxis' | '';

package/field-types/axis-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 axis lines. Affects the major and minor axis ticks, but not the grid lines (see the [basic usage example](https://www.telerik.com/kendo-react-ui/components/charts/api/chartaxisdefaults)).
+ */
+export interface AxisLine {
+    /**
+     * The color of the lines. Accepts a valid CSS color string, including hex and rgb. Setting the `color` option affects the major and minor axis ticks, but not the grid lines.
+     */
+    color?: string;
+    /**
+     * The dash type of the line.
+     */
+    dashType?: DashType;
+    /**
+     * If set to `true`, the Chart displays the axis lines. By default, the axis lines are visible.
+     */
+    visible?: boolean;
+    /**
+     * The width of the line in pixels. Affects the major and minor axis ticks, but not the grid lines.
+     */
+    width?: number;
+}

package/field-types/axis-ticks.interface.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @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 configuration for the major and minor axis ticks (see the [basic usage example](https://www.telerik.com/kendo-react-ui/components/charts/api/chartaxisdefaults)).
+ */
+export interface AxisTicks {
+    /**
+     * The color of the tick lines. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The length of the tick line in pixels.
+     */
+    size?: number;
+    /**
+     * The number of ticks to skip at the beginning.
+     */
+    skip?: number;
+    /**
+     * The tick-rendering step. Renders every n<sup>th</sup> tick, where `n` is the step.
+     */
+    step?: number;
+    /**
+     * If set to `true,` the Chart displays the axis ticks. By default, only the major axis ticks are visible.
+     */
+    visible?: boolean;
+    /**
+     * The width of the ticks in pixels.
+     */
+    width?: number;
+}

package/field-types/axis-title-position.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
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The position of an axis title.
+ *
+ * @example
+ * ```jsx
+ * import { Chart, ChartValueAxis, ChartValueAxisItem } from '@progress/kendo-react-charts';
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartValueAxis>
+ *      <ChartValueAxisItem title={{ text: 'Title', position: "top" }}/>
+ *    </ChartValueAxis>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type AxisTitlePosition = 'top' | 'bottom' | 'left' | 'right' | 'center';

package/field-types/base-unit.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The `baseUnit` type of an X or Y axis.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartXAxis,
+ *  ChartXAxisItem,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const baseUnit = "months";
+ * const data = [[new Date(2000, 0, 1), 1], [new Date(2001, 0, 1), 1]];
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartXAxis>
+ *     <ChartXAxisItem baseUnit={baseUnit} />
+ *    </ChartXAxis>
+ *    <ChartSeries>
+ *      <ChartSeriesItem type="scatter" data={data} />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type BaseUnit = 'milliseconds' | 'seconds' | 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';

package/field-types/border.interface.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { DashType } from './dash-type.js';
+/**
+ * The appearance settings for the border lines (see the [basic usage example](https://www.telerik.com/kendo-react-ui/components/charts/api/charttitle)).
+ */
+export interface Border {
+    /**
+     * The color of the border line. Accepts a valid CSS color string, including HEX and RGB.
+     */
+    color?: string;
+    /**
+     * The dash type of the border line.
+     */
+    dashType?: DashType;
+    /**
+     * The opacity of the border. By default the border is opaque.
+     *
+     * @default 1
+     */
+    opacity?: number | string;
+    /**
+     * The width of the border line in pixels.
+     */
+    width?: number;
+}

package/field-types/bullet-target-line.interface.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @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 target line of the Bullet series.
+ */
+export interface BulletTargetLine {
+    /**
+     * The width of the Bullet target line in pixels.
+     */
+    width?: number;
+}

package/field-types/bullet-target.interface.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @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 } from './border.interface.js';
+import { BulletTargetLine } from './bullet-target-line.interface.js';
+/**
+ * The appearance settings for the target of the Bullet series.
+ */
+export interface BulletTarget {
+    /**
+     * The width of the border in pixels. By default, the border width is set to `zero`, which means that the border is not visible.
+     */
+    border?: Border;
+    /**
+     * The target color.
+     */
+    color?: string;
+    /**
+     * The appearance settings for the target line of the Bullet series.
+     */
+    line?: BulletTargetLine;
+}

package/field-types/category-base-unit.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 { BaseUnit } from './base-unit.js';
+/**
+ * The `baseUnit` type of the category axis.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartCategoryAxis,
+ *  ChartCategoryAxisItem,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const baseUnit = "months";
+ * const data = [{ category: new Date(2000, 0, 1), value: 1 }, { category: new Date(2001, 0, 1), value: 1}];
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartCategoryAxis>
+ *     <ChartCategoryAxisItem baseUnit={baseUnit} />
+ *    </ChartCategoryAxis>
+ *    <ChartSeries>
+ *      <ChartSeriesItem categoryField="category" data={data} />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type CategoryBaseUnit = BaseUnit | 'auto' | 'fit';

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

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The dash line type.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [1, 2, 3];
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartSeries>
+ *      <ChartSeriesItem type="line" data={data} dashType="dot" />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type DashType = 'dash' | 'dashDot' | 'dot' | 'longDash' | 'longDashDot' | 'longDashDotDot' | 'solid';

package/field-types/date-formats.interface.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The format that is used to display the labels when they are dates.
+ *
+ * The Chart selects the appropriate format for the current `baseUnit`. Setting the `format` option of the labels overrides the date formats.
+ */
+export interface DateFormats {
+    /**
+     * The provided format when the axis `baseUnit` is set to `"milliseconds"`.
+     */
+    milliseconds?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"seconds"`.
+     */
+    seconds?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"minutes"`.
+     */
+    minutes?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"hours"`.
+     */
+    hours?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"days"`.
+     */
+    days?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"weeks"`.
+     */
+    weeks?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"months"`.
+     */
+    months?: string;
+    /**
+     * The provided format when the axis `baseUnit` is set to `"years"`.
+     */
+    years?: string;
+}

package/field-types/drag-action.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
+ *-------------------------------------------------------------------------------------------
+ */
+import { LockAxis } from './lock-axis.js';
+import { ModifierKey } from './modifier-key.js';
+/**
+ * Configures the drag behavior during the pan and zoom operations.
+ */
+export interface DragAction {
+    /**
+     * Specifies a keyboard key that has to be pressed to activate the gesture.
+     */
+    key?: ModifierKey;
+    /**
+     * Specifies an axis that will not be panned or zoomed.
+     */
+    lock?: LockAxis;
+}

package/field-types/error-bar-line.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @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 error bar lines.
+ */
+export interface ErrorBarLine {
+    /**
+     * The dash type of the line.
+     */
+    dashType?: DashType;
+    /**
+     * The width of the line in pixels.
+     */
+    width?: number;
+}

package/field-types/grid-lines.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 { DashType } from './dash-type.js';
+/**
+ * The appearance configuration for the major and minor axis grid lines (see the [basic usage example](https://www.telerik.com/kendo-react-ui/components/charts/api/chartaxisdefaults)).
+ */
+export interface GridLines {
+    /**
+     * The color of the grid lines. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The dash type of the grid lines.
+     */
+    dashType?: DashType;
+    /**
+     * The number of lines to skip at the beginning.
+     */
+    skip?: number;
+    /**
+     * The tick-rendering step. Renders every n<sup>th</sup> line, where `n` is the step.
+     */
+    step?: number;
+    /**
+     * If set to `true`, the Chart displays the lines. By default, only the major axis grid lines are visible.
+     */
+    visible?: boolean;
+    /**
+     * The width of the lines in pixels.
+     */
+    width?: number;
+}

package/field-types/highlight-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 highlight line of the Candlestick and OHLC series.
+ */
+export interface HighlightLine {
+    /**
+     * The color of the highlighted line. Accepts a valid CSS color string, including hex and rgb. The default color is computed from the base-point color.
+     */
+    color?: string;
+    /**
+     * The dash type of the line.
+     */
+    dashType?: DashType;
+    /**
+     * The opacity of the line. By default, the border is opaque (`opacity = 1`).
+     */
+    opacity?: number;
+    /**
+     * The width of the line in pixels.
+     */
+    width?: number;
+}

package/field-types/label-connectors.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
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The appearance settings for the label connectors on the Donut and Pie series.
+ */
+export interface LabelConnectors {
+    /**
+     * The color of the connecting line. Accepts a valid CSS color string, including hex and rgb.
+     */
+    color?: string;
+    /**
+     * The distance between the connector line and the main chart.
+     */
+    padding?: number;
+    /**
+     * The width of the connector line in pixels.
+     */
+    width?: number;
+}

package/field-types/label-rotation.interface.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The rotation configuration for the axis labels.
+ */
+export interface LabelRotation {
+    /**
+     * The alignment of the rotated labels relative to the slot center.
+     *
+     * The supported values are:
+     * * `"end"`
+     * * `"center"`
+     *
+     * By default, the Charts align the closest end of the label to the center. If set to `"center"`, the center of the rotated label will be aligned instead.
+     */
+    align?: 'end' | 'center';
+    /**
+     * The rotation angle of the labels. By default, the labels are not rotated. Can be set to `"auto"`. In this case, the labels will be rotated only if the slot size is not sufficient for the entire labels.
+     */
+    angle?: number | 'auto';
+}

package/field-types/legend-labels.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 { LegendLabelsContentArgs } from '../argument-types/legend-labels-content-args.interface.js';
+import { Margin } from './margin.interface.js';
+import { Padding } from './padding.interface.js';
+/**
+ * The appearance configuration for the legend labels.
+ */
+export interface LegendLabels {
+    /**
+     * The color of the legend 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 legend 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 labels. A numeric value sets all margins.
+     */
+    margin?: Margin | number;
+    /**
+     * The padding of the labels. A numeric value sets all paddings.
+     */
+    padding?: Padding | number;
+    /**
+     * A function used to generate the content of each label.
+     */
+    content?: (e: LegendLabelsContentArgs) => string;
+}

package/field-types/line-style.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The line style of the series.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *  Chart,
+ *  ChartSeries,
+ *  ChartSeriesItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const data = [1, 2, 3];
+ *
+ * const ChartContainer = () => (
+ *  <Chart>
+ *    <ChartSeries>
+ *      <ChartSeriesItem type="line" data={data} style="smooth" />
+ *    </ChartSeries>
+ *  </Chart>
+ * );
+ * ```
+ */
+export type LineStyle = 'normal' | 'step' | 'smooth';

package/field-types/lock-axis.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 an axis for locking during the pan and zoom operations.
+ */
+export type LockAxis = 'none' | 'x' | 'y';

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

@@ -0,0 +1,28 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * The margin configuration for each side.
+ */
+export interface Margin {
+    /**
+     * The top margin in pixels.
+     */
+    top?: number;
+    /**
+     * The right margin in pixels.
+     */
+    right?: number;
+    /**
+     * The bottom margin in pixels.
+     */
+    bottom?: number;
+    /**
+     * The left margin in pixels.
+     */
+    left?: number;
+}