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

package/dist/es/chart/plotarea/categorical-plotarea.js

@@ -131,7 +131,8 @@ class CategoricalPlotArea extends PlotAreaBase {
             this._seriesPointsCache = {};
             this._currentPointsCache = {};
             categoryAxis.options.dataItems = [];
-            series = this.aggregateSeries(series, categoryAxis, categoryAxis.totalRangeIndices());
+
+            series = this.aggregateSeries(series, categoryAxis);
         }
 
         const min = range ? range.min : 0;
@@ -304,7 +305,7 @@ class CategoricalPlotArea extends PlotAreaBase {
         return result;
     }
 
-    aggregateSeries(series, categoryAxis, range) {
+    aggregateSeries(series, categoryAxis, range = null) {
         const srcData = series.data;
         if (!srcData.length) {
             return series;
@@ -314,11 +315,13 @@ class CategoricalPlotArea extends PlotAreaBase {
         const result = deepExtend({}, series);
         const aggregator = new SeriesAggregator(deepExtend({}, series), SeriesBinder.current, DefaultAggregates.current);
         const data = result.data = [];
-
         const dataItems = categoryAxis.options.dataItems || [];
 
+        // Use full range if not provided, otherwise use current range to aggregate only visible categories
+        const aggregateRange = range || { min: 0, max: srcPoints.length - 1 };
+
         const categoryItem = (idx) => {
-            const categoryIdx = idx - range.min;
+            const categoryIdx = idx - aggregateRange.min;
             let point = srcPoints[idx];
             if (!point) {
                 point = srcPoints[idx] = {};
@@ -335,7 +338,7 @@ class CategoricalPlotArea extends PlotAreaBase {
             return point;
         };
 
-        for (let idx = range.min; idx <= range.max; idx++) {
+        for (let idx = aggregateRange.min; idx <= aggregateRange.max; idx++) {
             const point = categoryItem(idx);
             data[point.categoryIx] = point.item;
 
@@ -345,7 +348,7 @@ class CategoricalPlotArea extends PlotAreaBase {
         }
 
         if (inArray(result.type, OUT_OF_RANGE_SERIES)) {
-            createOutOfRangePoints(result, range, categoryAxis.totalCount(), categoryItem, (idx) => srcPoints[idx]);
+            createOutOfRangePoints(result, aggregateRange, categoryAxis.totalCount(), categoryItem, (idx) => srcPoints[idx]);
         }
 
         categoryAxis.options.dataItems = dataItems;

package/dist/es2015/chart/plotarea/categorical-plotarea.js

@@ -131,7 +131,8 @@ class CategoricalPlotArea extends PlotAreaBase {
             this._seriesPointsCache = {};
             this._currentPointsCache = {};
             categoryAxis.options.dataItems = [];
-            series = this.aggregateSeries(series, categoryAxis, categoryAxis.totalRangeIndices());
+
+            series = this.aggregateSeries(series, categoryAxis);
         }
 
         const min = range ? range.min : 0;
@@ -304,7 +305,7 @@ class CategoricalPlotArea extends PlotAreaBase {
         return result;
     }
 
-    aggregateSeries(series, categoryAxis, range) {
+    aggregateSeries(series, categoryAxis, range = null) {
         const srcData = series.data;
         if (!srcData.length) {
             return series;
@@ -314,11 +315,13 @@ class CategoricalPlotArea extends PlotAreaBase {
         const result = deepExtend({}, series);
         const aggregator = new SeriesAggregator(deepExtend({}, series), SeriesBinder.current, DefaultAggregates.current);
         const data = result.data = [];
-
         const dataItems = categoryAxis.options.dataItems || [];
 
+        // Use full range if not provided, otherwise use current range to aggregate only visible categories
+        const aggregateRange = range || { min: 0, max: srcPoints.length - 1 };
+
         const categoryItem = (idx) => {
-            const categoryIdx = idx - range.min;
+            const categoryIdx = idx - aggregateRange.min;
             let point = srcPoints[idx];
             if (!point) {
                 point = srcPoints[idx] = {};
@@ -335,7 +338,7 @@ class CategoricalPlotArea extends PlotAreaBase {
             return point;
         };
 
-        for (let idx = range.min; idx <= range.max; idx++) {
+        for (let idx = aggregateRange.min; idx <= aggregateRange.max; idx++) {
             const point = categoryItem(idx);
             data[point.categoryIx] = point.item;
 
@@ -345,7 +348,7 @@ class CategoricalPlotArea extends PlotAreaBase {
         }
 
         if (inArray(result.type, OUT_OF_RANGE_SERIES)) {
-            createOutOfRangePoints(result, range, categoryAxis.totalCount(), categoryItem, (idx) => srcPoints[idx]);
+            createOutOfRangePoints(result, aggregateRange, categoryAxis.totalCount(), categoryItem, (idx) => srcPoints[idx]);
         }
 
         categoryAxis.options.dataItems = dataItems;

package/dist/npm/api-types/axis-range.interface.d.ts

@@ -1,14 +1,14 @@
 /**
- * The axis range.
+ * Represents the axis range with minimum and maximum values.
  */
 export interface AxisRange {
     /**
-     * The axis minimum value.
+     * Specifies the axis minimum value.
      */
     min: number | Date;
 
     /**
-     * The axis maximum value.
+     * Specifies the axis maximum value.
      */
     max: number | Date;
 }

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

@@ -2,13 +2,13 @@ import { geometry } from '@progress/kendo-drawing';
 import { AxisRange } from './axis-range.interface';
 
 /**
- * An interface for the Chart axes API.
+ * Represents a Chart axis instance.
  */
-export interface ChartAxisType {
+export interface ChartAxis {
     /**
      * Returns the axis range.
      *
-     * @returns {AxisRange} - The axis range.
+     * @returns {AxisRange} The axis range.
      */
     range(): AxisRange;
 
@@ -25,26 +25,25 @@ export interface ChartAxisType {
      * See [Custom Plot Bands](https://www.telerik.com/kendo-vue-ui/components/charts/elements/plot-bands#custom-plot-bands) example.
      * {% endplatform_content %}
      *
-     * @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.
+     * @param from The start value of the slot.
+     * @param to The end value of the slot. If not specified, the `from` value is used.
+     * @param limit Indicates whether the slot is limited to the current range. By default, the range is limited.
+     * @returns {geometry.Rect | geometry.Arc} The slot rectangle or arc geometry.
      */
     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.
+     * @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.
+     * @returns {AxisRange} The value range.
      */
     valueRange(): AxisRange;
 }

package/dist/npm/api-types/chart-pane.interface.d.ts

@@ -1,9 +1,10 @@
 import { Group } from '@progress/kendo-drawing';
+import { ChartAxis } from './chart-axis.interface';
 
 /**
  * An interface for the Chart panes.
  */
-export interface ChartPaneType {
+export interface ChartPane {
     /**
      * The group which holds the Drawing elements of the Chart.
      */
@@ -13,4 +14,12 @@ export interface ChartPaneType {
      * The Drawing group that is used to draw the pane.
      */
     visual: Group;
+
+    /**
+     * Returns the axis from the pane with the specified name.
+     *
+     * @param {string} name The name of the axis.
+     * @returns {ChartAxis} The axis with the corresponding name.
+     */
+    findAxisByName(name: string): ChartAxis;
 }

package/dist/npm/api-types/chart-plotarea.interface.d.ts

@@ -3,7 +3,7 @@ import { MultiPath, Group } from '@progress/kendo-drawing';
 /**
  * An interface for the plot area of the Chart.
  */
-export interface ChartPlotAreaType {
+export interface ChartPlotArea {
     /**
      * The Drawing `MultiPath` that is used to draw the background.
      */

package/dist/npm/api-types/chart-svg-export-options.interface.d.ts

@@ -0,0 +1,16 @@
+import { SVGExportOptions } from '@progress/kendo-drawing';
+
+/**
+ * Represents the Kendo UI for Angular Chart SVG export options.
+ */
+export interface ChartSVGExportOptions extends SVGExportOptions {
+  /**
+   * Specifies the width (in pixels) of the exported SVG. If not set, the width of the exported element will be used.
+   */
+  width?: number;
+
+  /**
+   * Specifies the height (in pixels) of the exported SVG. If not set, the height of the exported element will be used.
+   */
+  height?: number;
+}

package/dist/npm/api-types/chart-visual-export-options.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Represents the options for customizing the exported visual.
+ */
+export interface ChartVisualExportOptions {
+  /**
+   * Specifies the width (in pixels) of the exported scene. Defaults to the width of the element.
+   */
+  width?: number;
+
+  /**
+   * Specifies the height (in pixels) of the exported scene. Defaults to the height of the element.
+   */
+  height?: number;
+}

package/dist/npm/api-types/event-axis-options.interface.d.ts

@@ -1,5 +1,5 @@
 /**
- * The axis options for the Chart events.
+ * The axis options for Chart events.
  */
 export interface EventAxisOptions {
     /**

package/dist/npm/api-types/series-point-marker.interface.d.ts

@@ -0,0 +1,16 @@
+import { drawing } from '@progress/kendo-drawing';
+
+/**
+ * Represents a series point marker.
+ */
+export interface SeriesPointMarker {
+    /**
+     * Specifies the point marker options.
+     */
+    options?: any;
+
+    /**
+     * Specifies the Drawing element used to draw the series point marker.
+     */
+    visual?: drawing.Element;
+}

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

@@ -1,46 +1,67 @@
 import { drawing } from '@progress/kendo-drawing';
+import { SeriesPointMarker } from './series-point-marker.interface';
 
 /**
- * A series point.
+ * Represents a series point in the Chart.
  */
-export interface SeriesPointType {
+export interface SeriesPoint {
     /**
-     * The point category value. Available only for the Categorical points (Bar, Line, and other).
+     * Specifies the category value of the point. Available for Categorical points such as Bar and Line series.
      */
-    category?: string | Date | number;
+    category?: string|Date|number;
 
     /**
-     * The point `dataItem`.
+     * Specifies the `dataItem` associated with the point.
      */
     dataItem?: any;
 
     /**
-     * The point options.
+     * Specifies the options for the point.
      */
     options?: any;
 
     /**
-     * The point value represented as a percentage value. Available only for the Donut, Pie, and 100% Stacked chart points.
+     * Defines the index of the point in the series. Available for Categorical and Funnel charts.
+     */
+    index?: number;
+
+    /**
+     * Specifies the marker associated with the point, if any. Available only for Line and ScatterLine series.
+     */
+    marker?: SeriesPointMarker;
+
+    /**
+     * Specifies the value of the point as a percentage. Available for 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.
+     * Defines 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.
+     * Specifies the sum of all previous series values. Available for the Waterfall series points.
      */
     total?: number;
 
     /**
-     * The point value.
+     * Specifies the minimum value for the series. Available for the Heatmap series points.
+     */
+    min?: number;
+
+    /**
+     * Specifies the maximum value for the series. Available for the Heatmap series points.
+     */
+    max?: number;
+
+    /**
+     * Represents the value of the point.
      */
     value?: any;
 
     /**
-     * The Drawing element used to draw the point.
+     * Provides the Drawing element used to draw the point.
      */
     visual?: drawing.Element;
 }

package/dist/npm/api-types.d.ts

@@ -5,3 +5,7 @@ export * from './api-types/chart-plotarea.interface';
 export * from './api-types/event-axis-options.interface';
 export * from './api-types/event-series-options.interface';
 export * from './api-types/series-point.interface';
+export * from './api-types/series-point-marker.interface';
+export * from './api-types/chart-svg-export-options.interface';
+export * from './api-types/chart-visual-export-options.interface';
+

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

@@ -3,15 +3,10 @@
  *
  * The possible values are:
  * - `"normal"`—Connects the values with a straight line.
- * - `"step"`—Connects the values with a right-angled line. Available when series type is set to `"line"`.
+ * - `"step"`—Connects the values with a right-angled line. Available when [`series.type`]({% slug api_charts_series %}#type) is set to `"line"`.
  * - `"smooth"`—Connects the values with a smooth line. Not supported for stacked area series with missing values.
  *
  * {% platform_content angular %}
- * See also:
- * - [`series.type`](https://www.telerik.com/kendo-angular-ui/components/charts/api/series#type)
- * {% endplatform_content %}
- *
- * {% platform_content angular %}
  * @example
  * ```ts
  * import { Component } from '@angular/core';

package/dist/npm/field-types/series-labels-alignment.d.ts

@@ -1,5 +1,5 @@
 /**
- * Specifies the alignment of the label when series type is set to `"donut"`, `"funnel"`, `"pyramid"` or `"pie"`.
+ * Specifies the alignment of the label when [`series.type`]({% slug api_charts_series %}#type) is set to `"donut"`, `"funnel"`, `"pyramid"` or `"pie"`.
  *
  * The supported values for `"donut"` and `"pie"` are:
  *