@progress/kendo-charts 2.12.3-develop.3 → 2.13.0-develop.1

package/dist/npm/argument-types/series-labels-content-args.interface.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Represents the context for the `content` function of the series label.
+ */
+export interface SeriesLabelsContentArgs {
+  /**
+   * Specifies the text of the label.
+   */
+  text: string;
+
+  /**
+   * Specifies the original data item used to construct the point. If binding to an array, it will be `null`.
+   */
+  dataItem: any;
+
+  /**
+   * Specifies the category name. Available for the Area, Bar, Column, Bubble, Donut, Funnel, Pyramid, Line, and Pie
+   * series.
+   */
+  category: any;
+
+  /**
+   * Specifies the value of the point. The value can be a number or object containing each bound field.
+   */
+  value: any;
+
+  /**
+   * Specifies the point value represented as a percentage.
+   * Available only for the Donut, Pie, and 100% Stacked charts.
+   */
+  percentage?: number;
+
+  /**
+   * Specifies the cumulative point value on the stack.
+   * Available only for the stackable series.
+   */
+  stackValue?: number;
+
+  /**
+   * Specifies the sum of point values from the last `"runningTotal"` summary point onwards.
+   * Available for the Waterfall series.
+   */
+  runningTotal?: number;
+
+  /**
+   * Specifies the sum of all previous series values.
+   * Available for the Waterfall series.
+   */
+  total?: number;
+
+  /**
+   * Specifies the data series configuration object.
+   */
+  series: any;
+}

package/dist/npm/argument-types/series-labels-visual-args.interface.d.ts

@@ -0,0 +1,77 @@
+import { Chart } from '../chart';
+import { drawing, geometry } from '@progress/kendo-drawing';
+
+/**
+ * Represents the context for the `visual` function of the series label.
+ */
+export interface SeriesLabelsVisualArgs<TChart = Chart> {
+  /**
+   * Specifies a function that gets the default visual.
+   */
+  createVisual: () => drawing.Element;
+
+  /**
+   * Specifies the options of the label.
+   */
+  options: any;
+
+  /**
+   * Specifies the rectangle that defines the normal position of the visual.
+   */
+  rect: geometry.Rect;
+
+  /**
+   * Specifies the instance of the Chart component.
+   */
+  sender: TChart;
+
+  /**
+   * Specifies the text of the label.
+   */
+  text: string;
+
+  /**
+   * Specifies the data item associated with the point.
+   */
+  dataItem: any;
+
+  /**
+   * Specifies the category of the point.
+   */
+  category: any;
+
+  /**
+   * Specifies the value of the point.
+   */
+  value: any;
+
+  /**
+   * Specifies the point value represented as a percentage.
+   * Available only for the Donut, Pie, and 100% stacked charts.
+   */
+  percentage?: number;
+
+  /**
+   * Specifies the cumulative point value on the stack.
+   * Available only for the stackable series.
+   */
+  stackValue?: number;
+
+  /**
+   * Specifies the sum of point values from the last `"runningTotal"` summary point onwards.
+   * Available for the Waterfall series.
+   */
+  runningTotal?: number;
+
+  /**
+   * Specifies the sum of all previous series values.
+   * Available for the Waterfall series.
+   */
+  total?: number;
+
+  /**
+   * Specifies the point series.
+   */
+  series: any;
+
+}

package/dist/npm/argument-types/series-note-content-args.interface.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Represents the context for the series note `content` function.
+ */
+export interface SeriesNoteContentArgs {
+  /**
+   * Specifies the category of the point.
+   */
+  category: any;
+
+  /**
+   * Provides the data item associated with the point.
+   */
+  dataItem: any;
+
+  /**
+   * Specifies the point series.
+   */
+  series: any;
+
+  /**
+   * Represents the value of the point.
+   */
+  value: string;
+
+  /**
+   * Defines the note text.
+   */
+  text: string;
+}

package/dist/npm/argument-types/series-note-visual-args.interface.d.ts

@@ -0,0 +1,52 @@
+import { Chart } from '../chart';
+import { drawing, geometry } from '@progress/kendo-drawing';
+
+/**
+ * Represents the context for the series note `visual` function.
+ */
+export interface SeriesNoteVisualArgs<TChart = Chart> {
+  /**
+   * Specifies the category of the point.
+   */
+  category: any;
+
+  /**
+   * Specifies a function that gets the default visual.
+   */
+  createVisual: () => drawing.Element;
+
+  /**
+   * Provides the data item associated with the point.
+   */
+  dataItem: any;
+
+  /**
+   * Defines the options for the note.
+   */
+  options: any;
+
+  /**
+   * Specifies the rectangle that defines the normal position of the visual.
+   */
+  rect: geometry.Rect;
+
+  /**
+   * Specifies the instance of the Chart component.
+   */
+  sender: TChart;
+
+  /**
+   * Specifies the point series.
+   */
+  series: any;
+
+  /**
+   * Represents the value of the point.
+   */
+  value: string;
+
+  /**
+   * Defines the note text.
+   */
+  text: string;
+}

package/dist/npm/argument-types/series-visual-args.interface.d.ts

@@ -0,0 +1,95 @@
+import { Chart } from '../chart';
+import { drawing, geometry } from '@progress/kendo-drawing';
+
+/**
+ * Represents the context for the `visual` function of the series point.
+ */
+export interface SeriesVisualArgs<TChart = Chart> {
+  /**
+   * Specifies the category of the point.
+   */
+  category: any;
+
+  /**
+   * Specifies a function that gets the default visual.
+   */
+  createVisual: () => drawing.Element;
+
+  /**
+   * Specifies the center point of the segment. Available for the Donut and Pie series.
+   */
+  center?: geometry.Point;
+
+  /**
+   * Provides the data item associated with the point.
+   */
+  dataItem: any;
+
+  /**
+   * Specifies the end angle of the segment. Available for the Donut and Pie series.
+   */
+  endAngle?: number;
+
+  /**
+   * Specifies the inner radius of the segment. Available for the Donut and Pie series.
+   */
+  innerRadius?: number;
+
+  /**
+   * Defines the options for the point.
+   */
+  options: any;
+
+  /**
+   * Specifies the point value represented as a percentage.
+   * Available only for the Donut, Pie, and 100% stacked charts.
+   */
+  percentage?: number;
+
+  /**
+   * Specifies the segment points. Available for the Donut and Pie series.
+   */
+  points?: geometry.Point[];
+
+  /**
+   * Specifies the segment radius. Available for the Donut and Pie series.
+   */
+  radius?: number;
+
+  /**
+   * Specifies the rectangle that defines the normal position of the visual.
+   */
+  rect: geometry.Rect;
+
+  /**
+   * Specifies the sum of point values from the last `"runningTotal"` summary point onwards.
+   * Available for the Waterfall series.
+   */
+  runningTotal?: number;
+
+  /**
+   * Specifies the instance of the Chart component.
+   */
+  sender: TChart;
+
+  /**
+   * Specifies the series to which the point belongs.
+   */
+  series: any;
+
+  /**
+   * Specifies the start angle of the segment. Available for the Donut and Pie series.
+   */
+  startAngle?: number;
+
+  /**
+   * Specifies the sum of all previous series values.
+   * Available for the Waterfall series.
+   */
+  total?: number;
+
+  /**
+   * Represents the value of the point.
+   */
+  value: any;
+}

package/dist/npm/argument-types/title-visual-args.interface.d.ts

@@ -0,0 +1,32 @@
+import { Chart } from '../chart';
+import { drawing, geometry } from '@progress/kendo-drawing';
+
+/**
+ * Represents the context for the title `visual` function.
+ */
+export interface TitleVisualArgs<TChart = Chart> {
+  /**
+   * Specifies a function that gets the default visual.
+   */
+  createVisual: () => drawing.Element;
+
+  /**
+   * Specifies the title options.
+   */
+  options: any;
+
+  /**
+   * Specifies the rectangle that defines the normal position of the visual.
+   */
+  rect: geometry.Rect;
+
+  /**
+   * Specifies the instance of the Chart component.
+   */
+  sender: TChart;
+
+  /**
+   * Specifies the text of the title.
+   */
+  text: string;
+}

package/dist/npm/chart-options.d.ts

@@ -0,0 +1,226 @@
+import {
+  AxisDefaults,
+  CategoryAxis,
+  ChartArea,
+  DragAction,
+  Legend,
+  Pane,
+  PaneDefaults,
+  PlotArea,
+  Series,
+  SeriesDefaults,
+  Title,
+  Tooltip,
+  ValueAxis,
+  XAxis,
+  YAxis,
+  Zoomable
+} from './property-types';
+
+
+/**
+ * Represents a configuration object that groups all root-level Chart options.
+ */
+export interface ChartOptions {
+  /**
+   * Defines whether the Chart can be panned.
+   * Panning is not available for the `Donut`, `Pie`, `Funnel`, `Pyramid`, `Polar`, and `Radar` series.
+   * {% platform_content angular %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-angular-ui/components/charts/pan-zoom) example.
+   * {% endplatform_content %}
+   * {% platform_content react %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-react-ui/components/charts/chart/pan-zoom) example.
+   * {% endplatform_content %}
+   * {% platform_content vue %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-vue-ui/components/charts/chart/pan-zoom) example.
+   * {% endplatform_content %}
+   */
+  pannable?: boolean | DragAction;
+
+  /**
+   * Defines the preferred rendering engine.
+   * If the browser does not support it, the Chart switches to the first available mode.
+   *
+   * The supported values are:
+   * - `"svg"`—If available, renders the component as an inline `.svg` file.
+   * - `"canvas"`—If available, renders the component as a `canvas` element.
+   *
+   * {% platform_content angular %}
+   * See [Rendering Modes](https://www.telerik.com/kendo-angular-ui/components/charts/rendering) example.
+   * {% endplatform_content %}
+   * {% platform_content react %}
+   * See [Rendering Modes](https://www.telerik.com/kendo-react-ui/components/charts/chart/rendering) example.
+   * {% endplatform_content %}
+   * {% platform_content vue %}
+   * See [Rendering Modes](https://www.telerik.com/kendo-vue-ui/components/charts/chart/rendering) example.
+   * {% endplatform_content %}
+   */
+  renderAs?: 'svg' | 'canvas';
+
+  /**
+   * Defines the default colors for the Chart series.
+   * When all colors are used, new colors are pulled from the start again.
+   */
+  seriesColors?: string[];
+
+  /**
+   * Defines the configuration options or the text of the Chart subtitle.
+   */
+  subtitle?: string | Title;
+
+  /**
+   * Defines the configuration options or the text of the Chart title.
+   */
+  title?: string | Title;
+
+  /**
+   * Defines whether the Chart plays animations when it displays the series.
+   * By default, animations are enabled.
+   */
+  transitions?: boolean;
+
+  /**
+   * @hidden
+   * Defines whether the Chart automatically repaints when its styles are modified through CSS variables.
+   */
+  observeStyles?: boolean;
+
+  /**
+   * Defines whether the Chart can be zoomed.
+   * Zooming is not available for the `Donut`, `Pie`, `Funnel`, `Pyramid`, `Polar`, and `Radar` series.
+   * {% platform_content angular %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-angular-ui/components/charts/pan-zoom) example.
+   * {% endplatform_content %}
+   * {% platform_content react %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-react-ui/components/charts/chart/pan-zoom) example.
+   * {% endplatform_content %}
+   * {% platform_content vue %}
+   * See the [Panning and Zooming](https://www.telerik.com/kendo-vue-ui/components/charts/chart/pan-zoom) example.
+   * {% endplatform_content %}
+   */
+  zoomable?: boolean | Zoomable;
+
+  /**
+   * Defines the default options for all Chart axes. Accepts the options which are supported by
+   * `categoryAxis`, `valueAxis`, `xAxis`, and `yAxis`.
+   *
+   * {% platform_content angular %}
+   * See also the configuration components for the individual axes:
+   * * [CategoryAxisComponent](https://www.telerik.com/kendo-angular-ui/components/charts/api/categoryaxisitemcomponent)
+   * * [ValueAxisComponent](https://www.telerik.com/kendo-angular-ui/components/charts/api/valueaxisitemcomponent)
+   * * [XAxisComponent](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxisitemcomponent)
+   * * [YAxisComponent](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxisitemcomponent)
+   * {% endplatform_content %}
+   */
+  axisDefaults?: AxisDefaults;
+
+  /**
+   * Defines the configuration options of the category axis.
+   */
+  categoryAxis?: CategoryAxis | CategoryAxis[];
+
+  /**
+   * Defines the configuration options of the Chart area.
+   * Represents the entire visible area of the Chart.
+   */
+  chartArea?: ChartArea;
+
+  /**
+   * Defines the configuration options of the Chart legend.
+   */
+  legend?: Legend;
+
+  /**
+   * If no series are defined, or all series are empty, a No Data Overlay will be displayed.
+   * It clears automatically when the series receive data.
+   *
+   * To disable the No Data Overlay, set this option to `false`.
+   *
+   * {% platform_content angular %}
+   * See the [No Data Overlay](https://www.telerik.com/kendo-angular-ui/components/charts/data-binding/no-data-overlay) example.
+   * {% endplatform_content %}
+   * {% platform_content react %}
+   * See the [No Data Overlay](https://www.telerik.com/kendo-react-ui/components/charts/chart/data-binding#no-data-overlay) example.
+   * {% endplatform_content %}
+   * {% platform_content vue %}
+   * See the [No Data Overlay](https://www.telerik.com/kendo-vue-ui/components/charts/data-binding#no-data-overlay) example.
+   * {% endplatform_content %}
+   */
+  noData?: boolean;
+
+  /**
+   * Defines the configuration of the Chart panes.
+   * Panes are used to split the Chart into two or more parts. The panes are ordered from top to bottom.
+   * To associate each axis with a pane, set its `pane` option to the name of the desired pane.
+   * Axes that do not have a specified pane are placed in the top (default) pane.
+   * To move a series to the desired pane, associate them with an axis.
+   */
+  panes?: Pane[];
+
+  /**
+   * Defines the default options of all panes.
+   */
+  paneDefaults?: PaneDefaults;
+
+  /**
+   * Defines the configuration options of the plot area.
+   * Specifies the area which displays the series.
+   */
+  plotArea?: PlotArea;
+
+  /**
+   * Defines the configuration of the Chart series.
+   * Determines the series type by the value of the `type` field.
+   * If a `type` value is missing, the Chart renders the type that is
+   * specified in `seriesDefaults`.
+   * Some options accept functions as arguments. These arguments are evaluated for each point
+   * which is supplied as a parameter. If no value is returned, the Chart uses the `theme` or
+   * `seriesDefaults` values.
+   * {% platform_content angular %}
+   * See also:
+   * * [`SeriesDefaultsComponent`](https://www.telerik.com/kendo-angular-ui/components/charts/api/seriesdefaultscomponent)
+   * {% endplatform_content %}
+   */
+  series?: Series[];
+
+  /**
+   * Defines the default options of all series.
+   */
+  seriesDefaults?: SeriesDefaults;
+
+  /**
+   * Defines the configuration options of the Chart series tooltips.
+   * Displays the tooltip when the
+   * `tooltip.visible` option is set to `true`.
+   * {% platform_content angular %}
+   * See also:
+   * * [`TooltipComponent`](https://www.telerik.com/kendo-angular-ui/components/charts/api/tooltipcomponent)
+   * {% endplatform_content %}
+   */
+  tooltip?: Tooltip;
+
+  /**
+   * Defines the configuration options of the value axis.
+   */
+  valueAxis?: ValueAxis | ValueAxis[];
+
+  /**
+   * Defines the configuration options of the Scatter Chart X-axis.
+   * Supports all `valueAxis` options.
+   * {% platform_content angular %}
+   * See also:
+   * * [`XAxisComponent`](https://www.telerik.com/kendo-angular-ui/components/charts/api/xaxisitemcomponent)
+   * {% endplatform_content %}
+   */
+  xAxis?: XAxis | XAxis[];
+
+  /**
+   * Defines the configuration options of the Scatter Chart Y-axis.
+   * Supports all `valueAxis` options.
+   * {% platform_content angular %}
+   * See also:
+   * * [`YAxisComponent`](https://www.telerik.com/kendo-angular-ui/components/charts/api/yaxisitemcomponent)
+   * {% endplatform_content %}
+   */
+  yAxis?: YAxis | YAxis[];
+}

package/dist/npm/chart.d.ts

@@ -1,8 +1,9 @@
+import { ChartOptions } from './chart-options';
 
 export class Chart {
-    constructor(element: HTMLElement, options: any, theme: any, context: any);
+    constructor(element: HTMLElement, options: ChartOptions, theme: any, context: any);
 
-    setOptions(options: any, theme?: any): void;
+    setOptions(options: ChartOptions, theme?: any): void;
 
     noTransitionsRedraw(): void;
 
@@ -12,7 +13,7 @@ export class Chart {
 
     hideElements(): void;
 
-    applyOptions(options: any, theme?: any): void;
+    applyOptions(options: ChartOptions, theme?: any): void;
 
     bindCategories(): void;
 

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

@@ -0,0 +1,62 @@
+/**
+ * Specifies the allowed time-interval steps when `baseUnit` is set to either `"fit"` or `"auto"`.
+ *
+ * Divides the active period into the smallest possible intervals
+ * that do not exceed the set `maxDateGroups` value.
+ *
+* {% platform_content angular %}
+ * ```html
+ * <kendo-chart-category-axis>
+ *  <kendo-chart-category-axis-item [autoBaseUnitSteps]="baseUnitSteps">
+ *  </kendo-chart-category-axis-item>
+ * </kendo-chart-category-axis>
+ * ```
+ * ```ts
+ * public baseUnitSteps: AutoBaseUnitSteps = {
+ *  // Do not allow zooming into hours
+ *  weeks: [],
+ * };
+ * ```
+* {% endplatform_content %}
+ */
+export interface AutoBaseUnitSteps {
+  /**
+   * Specifies the interval steps when displaying milliseconds.
+   */
+  milliseconds?: number[];
+
+  /**
+   * Specifies the interval steps when displaying seconds.
+   */
+  seconds?: number[];
+
+  /**
+   * Specifies the interval steps when displaying minutes.
+   */
+  minutes?: number[];
+
+  /**
+   * Specifies the interval steps when displaying hours.
+   */
+  hours?: number[];
+
+  /**
+   * Specifies the interval steps when displaying days.
+   */
+  days?: number[];
+
+  /**
+   * Specifies the interval steps when displaying weeks.
+   */
+  weeks?: number[];
+
+  /**
+   * Specifies the interval steps when displaying months.
+   */
+  months?: number[];
+
+  /**
+   * Specifies the interval steps when displaying years.
+   */
+  years?: number[];
+}