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

package/Sparkline.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { SparklineProps } from './SparklineProps.js';
+import { Surface } from '@progress/kendo-drawing';
+import * as React from 'react';
+/**
+ * The root Sparkline component.
+ *
+ * @remarks
+ * Supported children components are: {@link ChartValueAxis}.
+ *
+ * @example
+ * ```jsx
+ * import {
+ *     Sparkline,
+ *     ChartValueAxis,
+ *     ChartValueAxisItem
+ * } from '@progress/kendo-react-charts';
+ *
+ * const sparklineData = [ 936, 968, 1025, 999, 998, 1014, 1017, 1010, 1010, 1007 ];
+ * const bulletData = [ 21, 23 ];
+ * const bulletValueAxis = {
+ *     min: 0,
+ *     max: 30,
+ *     plotBands: [{
+ *         from: 0, to: 15, color: '#787878', opacity: 0.15
+ *     }, {
+ *         from: 15, to: 22, color: '#787878', opacity: 0.3
+ *     }, {
+ *         from: 22, to: 30, color: '#787878', opacity: 0.15
+ *     }]
+ * };
+ *
+ * const SparklineContainer = () => (
+ *      <ul>
+ *        <li>
+ *            Base Sparkline chart
+ *            <Sparkline data={sparklineData} />
+ *        </li>
+ *        <li>
+ *            Bar/Column type Sparkline chart
+ *            <Sparkline data={sparklineData} type="column" />
+ *        </li>
+ *        <li>
+ *            Area type Sparkline chart
+ *            <Sparkline data={sparklineData} type="area" />
+ *        </li>
+ *        <li>
+ *            Pie type Sparkline chart
+ *            <Sparkline data={sparklineData} type="pie" />
+ *        </li>
+ *        <li>
+ *            Bullet type Sparkline chart
+ *            <Sparkline data={bulletData} type="bullet">
+ *                <ChartValueAxis>
+ *                    <ChartValueAxisItem {...bulletValueAxis} />
+ *                </ChartValueAxis>
+ *            </Sparkline>
+ *        </li>
+ *      </ul>
+ * );
+ * ```
+ */
+export declare class Sparkline extends React.Component<SparklineProps, {}> {
+    private _baseChart;
+    /**
+     * @hidden
+     */
+    get chartInstance(): any;
+    /**
+     * The Drawing `Surface` of the Sparkline.
+     */
+    get surface(): Surface | null;
+    /**
+     * The DOM element of the Sparkline.
+     */
+    get element(): HTMLDivElement | null;
+    /**
+     * @hidden
+     */
+    deriveOptionsFromParent: (options: any) => any;
+    /**
+     * @hidden
+     */
+    render(): any;
+    private getTarget;
+}

package/SparklineProps.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 { BaseChartProps } from './BaseChartProps.js';
+/**
+ * Represents the props of the KendoReact Sparkline component.
+ */
+export interface SparklineProps extends Omit<BaseChartProps, 'drilldownState' | 'onDrilldown' | 'onLegendItemClick' | 'onLegendItemHover' | 'onNoteClick' | 'onNoteHover' | 'axisLabelClick'> {
+    /**
+     * The data for the default Sparkline series. Discarded if series are supplied.
+     */
+    data?: any;
+    /**
+     * The data for the default Sparkline series. Discarded if series are supplied.
+     */
+    type?: string;
+}

package/StockChart.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { StockChartProps } from './StockChartProps.js';
+import { Surface } from '@progress/kendo-drawing';
+import * as React from 'react';
+/**
+ * The root StockChart component.
+ *
+ * @remarks
+ * Supported children components are: {@link ChartAxisDefaults}, {@link ChartCategoryAxis}, {@link ChartArea}, {@link ChartNavigator},
+ *  {@link ChartLegend}, {@link ChartPane}, {@link ChartPaneDefaults}, {@link ChartPanes}, {@link ChartPlopArea}, {@link ChartPlopArea},
+ *  {@link ChartSeries}, {@link ChartSeriesDefaults}, {@link ChartSubTitle}, {@link ChartTitle}, {@link ChartTooltip},
+ *  {@link ChartValueAxis}, {@link ChartXAxis}, {@link ChartYAxis}, {@link ChartZoomable}.
+ */
+export declare class StockChart extends React.Component<StockChartProps, {}> {
+    private _baseChart;
+    /**
+     * @hidden
+     */
+    get chartInstance(): any;
+    /**
+     * The Drawing `Surface` of the StockChart.
+     */
+    get surface(): Surface | null;
+    /**
+     * The DOM element of the StockChart.
+     */
+    get element(): HTMLDivElement | null;
+    /**
+     * @hidden
+     */
+    deriveOptionsFromParent: (options: any) => any;
+    /**
+     * @hidden
+     */
+    onRefresh: (chartOptions: any, themeOptions: any, chartInstance: any) => void;
+    /**
+     * @hidden
+     */
+    render(): any;
+    private getTarget;
+}

package/StockChartProps.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 { BaseChartProps } from './BaseChartProps.js';
+import { NavigatorFilterEvent } from './common/events.js';
+/**
+ * Represents the props of the KendoReact StockChart component.
+ */
+export interface StockChartProps extends Omit<BaseChartProps, 'drilldownState' | 'onDrilldown'> {
+    /**
+     * Specifies whether the StockChart will perform full or partial redraw upon re-render. The partial redraw is required when the `onNavigatorFilter` event is handled and the data for the main panes is limited to a specific set. The default value is `false`.
+     */
+    partialRedraw?: boolean;
+    /**
+     * Fires when the navigator range is changed.
+     */
+    onNavigatorFilter?: (event: NavigatorFilterEvent) => void;
+    /**
+     * @hidden
+     */
+    children?: React.ReactNode;
+}

package/api-types/axis-range.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 axis range.
+ */
+export interface AxisRange {
+    /**
+     * The axis minimum value.
+     */
+    min: number | Date;
+    /**
+     * The axis maximum value.
+     */
+    max: number | Date;
+}

package/api-types/chart-axis.interface.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { geometry } from '@progress/kendo-drawing';
+import { AxisRange } from './axis-range.interface.js';
+/**
+ * An interface for the Chart axes API.
+ */
+export interface ChartAxisType {
+    /**
+     * Returns the axis range.
+     *
+     * @returns {AxisRange} - The axis range.
+     */
+    range(): AxisRange;
+    /**
+     * Returns a slot that is based on the specified `from` and `to` values ([see example](https://www.telerik.com/kendo-react-ui/components/charts/chart/elements/plot-bands#toc-custom-plot-bands)).
+     *
+     * @param from - The slot start value.
+     * @param to - The end slot value. If not specified, the `from` value is used.
+     * @param limit - The parameters for the exported image.
+     * @returns {Promise<string>} - Indicates whether the slot is limited to the current range.
+     * By default, the range is limited.
+     */
+    slot(from: string | number | Date, to?: string | number | Date, limit?: boolean): geometry.Rect | geometry.Arc;
+    /**
+     * Returns the value that corresponds to the passed surface point.
+     *
+     * @param { Point } point - The surface point of the Chart.
+     * @returns {string | number | Date} - The value that corresponds to the point.
+     */
+    value(point: geometry.Point): string | number | Date;
+    /**
+     * Returns the axis range which is determined by the minimum and maximum point values that are associated with the axis.
+     *
+     * @returns {AxisRange} - The value range.
+     */
+    valueRange(): AxisRange;
+}

package/api-types/chart-drilldown-state.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
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Describes a single drilldown step.
+ */
+export interface ChartDrilldownStep {
+    /**
+     * The parent series name.
+     */
+    seriesName: string;
+    /**
+     * The drilldown value of the selected series point.
+     */
+    drilldownValue: any;
+}
+/**
+ * The Chart drilldown state.
+ */
+export interface ChartDrilldownState {
+    /**
+     * A stack of all drilldown steps performed in the Chart.
+     *
+     * If the `steps` are empty the Chart is the root level.
+     */
+    steps: ChartDrilldownStep[];
+}

package/api-types/chart-pane.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 { Group } from '@progress/kendo-drawing';
+/**
+ * An interface for the Chart panes.
+ */
+export interface ChartPaneType {
+    /**
+     * The group which holds the Drawing elements of the Chart.
+     */
+    chartsVisual: Group;
+    /**
+     * The Drawing group that is used to draw the pane.
+     */
+    visual: Group;
+}

package/api-types/chart-plotarea.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 { MultiPath, Group } from '@progress/kendo-drawing';
+/**
+ * An interface for the plot area of the Chart.
+ */
+export interface ChartPlotAreaType {
+    /**
+     * The Drawing `MultiPath` that is used to draw the background.
+     */
+    backgroundVisual: MultiPath;
+    /**
+     * The Drawing `Group` that is used to draw the plot area.
+     */
+    visual: Group;
+}

package/api-types/event-axis-options.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 axis options for the Chart events.
+ */
+export interface EventAxisOptions {
+    /**
+     * The axis name.
+     */
+    name: string;
+}

package/api-types/event-series-options.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 series options for the Chart events.
+ */
+export interface EventSeriesOptions {
+    /**
+     * The series index.
+     */
+    index: number;
+    /**
+     * The series name.
+     */
+    name: string;
+    /**
+     * The series visibility.
+     */
+    visible: boolean;
+}

package/api-types/series-point.interface.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @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';
+/**
+ * A series point.
+ */
+export interface SeriesPointType {
+    /**
+     * The point category value. Available only for the Categorical points (Bar, Line, and other).
+     */
+    category?: string | Date | number;
+    /**
+     * The point `dataItem`.
+     */
+    dataItem?: any;
+    /**
+     * The point options.
+     */
+    options?: any;
+    /**
+     * The point value represented as a percentage value. Available only for the Donut, Pie, and 100% Stacked chart points.
+     */
+    percentage?: number;
+    /**
+     * The sum of point values since the last `"runningTotal"` summary point. Available for the Waterfall series points.
+     */
+    runningTotal?: number;
+    /**
+     * The sum of all previous series values. Available for the Waterfall series points.
+     */
+    total?: number;
+    /**
+     * The point value.
+     */
+    value?: any;
+    /**
+     * The Drawing element used to draw the point.
+     */
+    visual?: drawing.Element;
+}

package/argument-types/axis-label-visual-args.interface.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Chart } from '../Chart.js';
+import { drawing, geometry } from '@progress/kendo-drawing';
+/**
+ * The context for the visual function of the axis label.
+ */
+export interface AxisLabelVisualArgs {
+    /**
+     * A function that can be used to get the default visual.
+     */
+    createVisual: () => drawing.Element;
+    /**
+     * The default culture (if set) of the label.
+     */
+    culture: string;
+    /**
+     * If a field is specified, represents the data item.
+     */
+    dataItem?: any;
+    /**
+     * The default format of the label.
+     */
+    format: string;
+    /**
+     * The label options.
+     */
+    options: any;
+    /**
+     * The rectangle that defines the normal position of the visual.
+     */
+    rect: geometry.Rect;
+    /**
+     * The instance of the Chart component.
+     */
+    sender: Chart;
+    /**
+     * The text of the label.
+     */
+    text: string;
+    /**
+     * The value of the label.
+     */
+    value: any;
+}

package/argument-types/axis-note-visual-args.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Chart } from '../Chart.js';
+import { drawing, geometry } from '@progress/kendo-drawing';
+/**
+ * The context for the point highlight visual function.
+ */
+export interface AxisNoteVisualArgs {
+    /**
+     * A function that can be used to get the default visual.
+     */
+    createVisual: () => drawing.Element;
+    /**
+     * The options of the note.
+     */
+    options: any;
+    /**
+     * The rectangle that defines the normal position of the visual.
+     */
+    rect: geometry.Rect;
+    /**
+     * The instance of the Chart component.
+     */
+    sender: Chart;
+    /**
+     * The value of the note.
+     */
+    value: string;
+}

package/argument-types/drilldown-series-factory-props.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
+ *-------------------------------------------------------------------------------------------
+ */
+/**
+ * Represents the props of a [Drilldown Series Factory](https://www.telerik.com/kendo-react-ui/components/charts/api/chartseriesitemprops#toc-drilldownseriesfactory) component.
+ */
+export interface DrilldownSeriesFactoryProps {
+    /**
+     * The drilldown field value.
+     */
+    drilldownValue: any;
+    /**
+     * The series point to drill down to.
+     */
+    point: any;
+    /**
+     * The series to drill down to.
+     */
+    series: any;
+}

package/argument-types/error-bars-visual-args.interface.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Chart } from '../Chart.js';
+import { drawing, geometry } from '@progress/kendo-drawing';
+/**
+ * The context for the error bars visual function.
+ */
+export interface ErrorBarsVisualArgs {
+    /**
+     * A function that can be used to get the default visual.
+     */
+    createVisual: () => drawing.Element;
+    /**
+     * The high value of the error bar.
+     */
+    high: number;
+    /**
+     * The low value of the error bar.
+     */
+    low: number;
+    /**
+     * The `options` object of the error bar.
+     */
+    options: any;
+    /**
+     * The rectangle that defines the normal position of the visual.
+     */
+    rect: geometry.Rect;
+    /**
+     * The instance of the Chart component.
+     */
+    sender: Chart;
+}

package/argument-types/highlight-toggle-args.interface.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @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';
+/**
+ * The context for the highlight toggle function.
+ */
+export interface HighlightToggleArgs {
+    /**
+     * A function that can be used to prevent the showing of the default highlight overlay.
+     */
+    preventDefault: () => void;
+    /**
+     * A Boolean value which indicates whether to show the highlight.
+     */
+    show: boolean;
+    /**
+     * The visual element that needs to be highlighted.
+     */
+    visual: drawing.Element;
+    /**
+     * The point category.
+     */
+    category: any;
+    /**
+     * The point `dataItem`.
+     */
+    dataItem?: any;
+    /**
+     * The value of the point.
+     */
+    value: any;
+    /**
+     * The series of the point.
+     */
+    series?: any;
+}

package/argument-types/highlight-visual-args.interface.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ *-------------------------------------------------------------------------------------------
+ * Copyright © 2026 Progress Software Corporation. All rights reserved.
+ * Licensed under commercial license. See LICENSE.md in the package root for more information
+ *-------------------------------------------------------------------------------------------
+ */
+import { Chart } from '../Chart.js';
+import { drawing, geometry } from '@progress/kendo-drawing';
+/**
+ * The context for the point highlight visual function.
+ */
+export interface HighlightVisualArgs {
+    /**
+     * The point category.
+     */
+    category: any;
+    /**
+     * A function that can be used to get the default visual.
+     */
+    createVisual: () => drawing.Element;
+    /**
+     * The data item of the point.
+     */
+    dataItem: any;
+    /**
+     * The point options.
+     */
+    options: any;
+    /**
+     * The point value represented as a percentage value. Available only for the Donut, Pie, and 100% stacked series.
+     */
+    percentage?: number;
+    /**
+     * The rectangle that defines the normal position of the visual.
+     */
+    rect: geometry.Rect;
+    /**
+     * The sum of point values since the last `runningTotal` summary point. Available for the Waterfall series.
+     */
+    runningTotal?: number;
+    /**
+     * The instance of the Chart component.
+     */
+    sender: Chart;
+    /**
+     * The series of the point.
+     */
+    series: any;
+    /**
+     * The sum of all previous series values. Available for the Waterfall series.
+     */
+    total?: number;
+    /**
+     * The value of the point.
+     */
+    value: any;
+}