@progress/kendo-angular-charts 19.1.2-develop.3 → 19.1.2-develop.5

package/esm2022/chart/category-axis-item.component.mjs

@@ -13,82 +13,158 @@ import * as i1 from "../common/configuration.service";
 import * as i2 from "../common/collection.service";
 import * as i3 from "@progress/kendo-angular-intl";
 /**
- * The configuration component for a category axis ([see example]({% slug axes_chart_charts %})).
+ * Represents the configuration component for a category axis ([see example]({% slug axes_chart_charts %})).
+ *
+ * @remarks
+ * Supported children components are: {@link CategoryAxisCrosshairComponent}, {@link CategoryAxisLabelsComponent},
+ * {@link CategoryAxisNotesComponent}, {@link CategoryAxisSelectComponent}, {@link CategoryAxisTitleComponent}, and {@link CategoryAxisRangeLabelsComponent}.
  */
 export class CategoryAxisItemComponent extends CollectionItemComponent {
     configurationService;
     collectionService;
     intl;
+    /**
+     * Specifies the automatic base unit steps configuration.
+     */
     autoBaseUnitSteps;
+    /**
+     * Specifies the axis crossing value or values.
+     */
     axisCrossingValue;
+    /**
+     * Specifies the background color of the axis.
+     */
     background;
+    /**
+     * Specifies the base unit of the axis.
+     */
     baseUnit;
+    /**
+     * Specifies the base unit step of the axis.
+     */
     baseUnitStep;
+    /**
+     * Specifies the categories for the axis.
+     */
     categories;
+    /**
+     * Specifies the color of the axis.
+     */
     color;
+    /**
+     * Determines whether the axis is justified.
+     */
     justified;
+    /**
+     * Specifies the line configuration of the axis.
+     */
     line;
+    /**
+     * Specifies the major grid lines configuration of the axis.
+     */
     majorGridLines;
+    /**
+     * Specifies the major ticks configuration of the axis.
+     */
     majorTicks;
+    /**
+     * Specifies the maximum value of the axis.
+     */
     max;
     /**
-     * The maximum number of groups (categories) to display when
+     * Specifies the maximum number of groups (categories) to display when
      * [`categoryAxis.baseUnit`]({% slug api_charts_categoryaxis %}#toc-baseunit) is set to `"fit"` or
      * [`categoryAxis.baseUnitStep`]({% slug api_charts_categoryaxis %}#toc-baseunitstep) is set to `"auto"`.
      * @default 10
      */
     maxDateGroups;
+    /**
+     * Specifies the maximum divisions of the axis.
+     */
     maxDivisions;
+    /**
+     * Specifies the minimum value of the axis.
+     */
     min;
+    /**
+     * Specifies the minor grid lines configuration of the axis.
+     */
     minorGridLines;
+    /**
+     * Specifies the minor ticks configuration of the axis.
+     */
     minorTicks;
     /**
-     * The unique axis name. Used to associate a series with a category axis,
+     * Specifies the unique axis name. Use it to associate a series with a category axis,
      * which utilizes the [`series.categoryAxis`]({% slug api_charts_series %}#toc-categoryaxis) option.
      * @default 'primary'
      */
     name;
+    /**
+     * Specifies the pane of the axis.
+     */
     pane;
+    /**
+     * Specifies the plot bands configuration of the axis.
+     */
     plotBands;
     /**
-     * If set to `true`, the category axis direction is reversed.
-     * By default, categories are listed from left to right and from bottom to top.
+     * Determines whether the category axis direction is reversed.
+     * Categories are listed from left to right and from bottom to top by default.
      * @default false
      */
     reverse;
     /**
-     * If set to `true`, the Chart rounds the first and last date to the nearest base unit.
+     * Determines whether the Chart rounds the first and last date to the nearest base unit.
      * @default true
      */
     roundToBaseUnit;
     /**
-     * The angle (degrees) of the first category on the axis.
-     * Angles increase clockwise with zero to the left. Negative values are acceptable.
+     * Specifies the angle (degrees) of the first category on the axis.
+     * Use positive values to increase the angle clockwise with zero to the left. Negative values are acceptable.
      * @default 90
      */
     startAngle;
     /**
-     * The category axis type.
-     * The supported values include `category` for a discrete category axis and `date` for a specialized axis for displaying chronological data.
+     * Specifies the category axis type.
+     * Use `category` for a discrete category axis and `date` for a specialized axis for displaying chronological data.
      * @default 'category'
      */
     type;
     /**
-     * If set to `true`, the Chart displays the category axis. By default, the category axis is visible.
+     * Determines whether the Chart displays the category axis. The category axis is visible by default.
      * @default true
      */
     visible;
     /**
-     * The week start day when the `baseUnit` is set to `"weeks"`.
+     * Specifies the week start day when the `baseUnit` is set to `"weeks"`.
      * @default 'Sunday'
      */
     weekStartDay;
     // These options are also available as child components
+    /**
+     * Specifies the crosshair configuration of the axis.
+     */
     crosshair;
+    /**
+     * Specifies the labels configuration of the axis.
+     */
     labels;
+    /**
+     * Specifies the notes configuration of the axis.
+     */
     notes;
+    /**
+     * Specifies the selection configuration of the axis.
+     */
     select;
+    /**
+     * Specifies the title configuration of the axis.
+     */
     title;
+    /**
+     * Specifies the range labels configuration of the axis.
+     */
     rangeLabels;
     intlSubscription;
     constructor(configurationService, collectionService, intl, localeId) {

package/esm2022/chart/category-axis.component.mjs

@@ -12,13 +12,13 @@ import * as i0 from "@angular/core";
 import * as i1 from "../common/configuration.service";
 import * as i2 from "../common/collection.service";
 /**
- * A collection of one or more category axis items.
+ * Represents a collection of one or more category axis items.
  *
  * @example
  * ```ts
  * import { Component } from '@angular/core';
  *
- * _@Component({
+ *  @Component({
  *   selector: 'my-app',
  *   template: `
  *     <kendo-chart>
@@ -36,6 +36,9 @@ import * as i2 from "../common/collection.service";
  * class AppComponent {
  * }
  * ```
+ *
+ * @remarks
+ * Supported children components are: {@link CategoryAxisItemComponent}.
  */
 export class CategoryAxisComponent extends CollectionComponent {
     configurationService;

package/esm2022/chart/chart-area.component.mjs

@@ -8,35 +8,46 @@ import { SettingsComponent } from '../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../common/configuration.service";
 /**
- * The configuration options of the Chart area.
+ * Represents the Kendo UI for Angular Chart Area configuration.
  * Represents the entire visible area of the Chart
  * ([see example]({% slug chartarea_chart_charts %})).
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-area background="#f0f0f0" [border]="{ color: '#ccc', width: 1 }">
+ *  </kendo-chart-area>
+ * </kendo-chart>
+ * ```
  */
 export class ChartAreaComponent extends SettingsComponent {
     configurationService;
     /**
-     * The background color of the Chart area. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the background color of the Chart area. Accepts a valid CSS color string, including hex and rgb.
      * @default 'white'
      */
     background;
+    /**
+     * Specifies the border configuration of the Chart area.
+     */
     border;
     /**
-     * The height of the Chart area.
+     * Specifies the height of the Chart area.
      * @default 400
      */
     height;
     /**
-     * The margin of the Chart area. A numeric value sets all margins.
+     * Specifies the margin of the Chart area. A numeric value sets all margins.
      * @default 5
      */
     margin;
     /**
-     * The background opacity of the Chart area. By default, the background is opaque.
+     * Specifies the background opacity of the Chart area. By default, the background is opaque.
      * @default 1
      */
     opacity;
     /**
-     * The width of the Chart area.
+     * Specifies the width of the Chart area.
      * @default 600
      */
     width;

package/esm2022/chart/donut-center-template.directive.mjs

@@ -5,9 +5,16 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * A directive which selects a [template](link:site.data.urls.angular['templatesyntax'])
+ * Represents a directive which selects a [template](link:site.data.urls.angular['templatesyntax'])
  * within the `<kendo-chart>` component for the
  * [Donut center template](slug:donut_seriestypes_charts#toc-using-the-center-template).
+ *
+ * @example
+ * <kendo-chart>
+ *   <ng-template kendoChartDonutCenterTemplate>
+ *     <span>Center Content</span>
+ *   </ng-template>
+ * </kendo-chart>
  */
 export class DonutCenterTemplateDirective {
     templateRef;

package/esm2022/chart/legend/inactive-items.component.mjs

@@ -8,11 +8,11 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration of the inactive Chart legend items.
+ * Represents the Kendo UI for Angular Chart Legend Inactive Items configuration.
  *
  * @example
  *
- * ```html-no-run
+ * ```html
  * <kendo-chart>
  *   <kendo-chart-legend>
  *      <kendo-chart-legend-inactive-items [labels]="{color: 'pink'}"></kendo-chart-legend-inactive-items>
@@ -22,6 +22,9 @@ import * as i1 from "../../common/configuration.service";
  */
 export class LegendInactiveItemsComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the labels configuration for inactive legend items.
+     */
     labels;
     constructor(configurationService) {
         super('legend.inactiveItems', configurationService);

package/esm2022/chart/legend/item.component.mjs

@@ -8,11 +8,11 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration of the Chart legend item.
+ * Represents the Kendo UI for Angular Chart Legend Item configuration.
  *
  * @example
  *
- * ```html-no-run
+ * ```html
  * <kendo-chart>
  *   <kendo-chart-legend>
  *      <kendo-chart-legend-item cursor="crosshair"></kendo-chart-legend-item>
@@ -22,12 +22,33 @@ import * as i1 from "../../common/configuration.service";
  */
 export class LegendItemComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the cursor style for legend items.
+     */
     cursor;
+    /**
+     * Specifies the type of the legend item.
+     */
     type;
+    /**
+     * Specifies the line configuration for the legend item.
+     */
     line;
+    /**
+     * Specifies the area configuration for the legend item.
+     */
     area;
+    /**
+     * Specifies the markers configuration for the legend item.
+     */
     markers;
+    /**
+     * Specifies the highlight configuration for the legend item.
+     */
     highlight;
+    /**
+     * Specifies a function that creates a custom visual for the legend item.
+     */
     visual;
     constructor(configurationService) {
         super('legend.item', configurationService);

package/esm2022/chart/legend.component.mjs

@@ -8,77 +8,119 @@ import { SettingsComponent } from '../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../common/configuration.service";
 /**
- * The configuration options of the Chart legend
+ * Represents the Kendo UI for Angular Chart Legend configuration
  * ([see example]({% slug legend_chart_charts %})).
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-legend position="top" [visible]="true">
+ *  </kendo-chart-legend>
+ * </kendo-chart>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link LegendInactiveItemsComponent} and {@link LegendItemComponent}.
  */
 export class LegendComponent extends SettingsComponent {
     configurationService;
     /**
+     * Specifies the alignment of the legend.
      * The legend is horizontally aligned when [`legend.position`]({% slug api_charts_legend %}#toc-position) is set to `"top"` or `"bottom"`.
      * The legend is vertically aligned when [`legend.position`]({% slug api_charts_legend %}#toc-position) is set to `"left"` or `"right"`.
      * @default 'center'
      */
     align;
     /**
-     * The background color of the legend. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the background color of the legend. Accepts a valid CSS color string, including hex and rgb.
      * @default 'white'
      */
     background;
+    /**
+     * Specifies the border configuration of the legend.
+     */
     border;
+    /**
+     * Specifies the height of the legend.
+     */
     height;
+    /**
+     * Specifies the labels configuration of the legend.
+     */
     labels;
     /**
-     * The margin of the Chart legend. A numeric value sets all paddings.
+     * Specifies the margin of the Chart legend. A numeric value sets all paddings.
      * @default 5
      */
     margin;
     /**
-     * The X offset of the Chart legend. The offset is relative to the default position of the legend.
+     * Specifies the X offset of the Chart legend. The offset is relative to the default position of the legend.
      * For example, a value of `20` moves the legend 20 pixels to the right of its initial position.
      * Negative values move the legend to the left of its current position.
      * @default 0
      */
     offsetX;
     /**
-     * The Y offset of the chart legend. The offset is relative to the current position of the legend.
+     * Specifies the Y offset of the chart legend. The offset is relative to the current position of the legend.
      * For example, a value of `20` moves the legend 20 pixels down from its initial position.
      * Negative values move the legend upwards from its current position.
      * @default 0
      */
     offsetY;
     /**
-     * The orientation of the legend items.
+     * Specifies the orientation of the legend items.
      * @default 'vertical'
      */
     orientation;
     /**
-     * The padding of the Chart legend. A numeric value sets all paddings.
+     * Specifies the padding of the Chart legend. A numeric value sets all paddings.
      * @default 5
      */
     padding;
     /**
-     * The positions of the Chart legend.
+     * Specifies the positions of the Chart legend.
      * Setting the legend position to `custom` allows you to position the legend using the [`legend.offsetX`](slug:api_charts_legend#toc-offsetx) and [`legend.offsetY`](slug:api_charts_legend#toc-offsety) options.
      * @default 'right'
      */
     position;
     /**
-     * If set to `true`, the legend items are reversed.
+     * Determines whether the legend items are reversed.
      * @default false
      */
     reverse;
     /**
-     * If set to `true`, the Chart displays the legend. By default, the Chart legend is visible.
+     * Determines whether the Chart displays the legend. By default, the Chart legend is visible.
      * @default true
      */
     visible;
+    /**
+     * Specifies the width of the legend.
+     */
     width;
+    /**
+     * Specifies the markers configuration of the legend.
+     */
     markers;
+    /**
+     * Specifies the spacing between legend items.
+     */
     spacing;
     // These options are also available as child components
+    /**
+     * Specifies the inactive items configuration of the legend.
+     */
     inactiveItems;
+    /**
+     * Specifies the item configuration of the legend.
+     */
     item;
+    /**
+     * Specifies the title configuration of the legend.
+     */
     title;
+    /**
+     * Specifies the focus highlight configuration of the legend.
+     */
     focusHighlight;
     constructor(configurationService) {
         super('legend', configurationService);

package/esm2022/chart/localization/custom-messages.component.mjs

@@ -8,11 +8,13 @@ import { ChartMessages } from './messages';
 import * as i0 from "@angular/core";
 import * as i1 from "@progress/kendo-angular-l10n";
 /**
- * Custom component messages override default component messages.
+ * Represents the custom messages component of the Kendo UI for Angular Chart.
+ * This component allows you to customize the messages displayed in the Chart, such as the "No data available" message.
+ *
  * @example
  * ```html
  * <kendo-chart [data]="data">
- *     <kendo-chart-messages noData='No data available'></kendo-chart-messages>
+ *     <kendo-chart-messages noData='No data'></kendo-chart-messages>
  * </kendo-chart>
  * ```
  */

package/esm2022/chart/no-data-template.directive.mjs

@@ -5,9 +5,16 @@
 import { Directive, TemplateRef, Optional } from '@angular/core';
 import * as i0 from "@angular/core";
 /**
- * A directive which selects a [template](link:site.data.urls.angular['templatesyntax'])
+ * Represents a directive which selects a [template](link:site.data.urls.angular['templatesyntax'])
  * within the `<kendo-chart>` component for the
  * [No Data Overlay](slug:databinding_chart_charts#toc-no-data-overlay).
+ *
+ * @example
+ * <kendo-chart>
+ *   <ng-template kendoChartNoDataTemplate>
+ *     <span>No data available</span>
+ *   </ng-template>
+ * </kendo-chart>
  */
 export class NoDataTemplateDirective {
     templateRef;

package/esm2022/chart/pane/title.component.mjs

@@ -8,36 +8,49 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration of the Chart pane title.
+ * Represents the title configuration for the Chart panes.
  */
 export class PanesTitleComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Sets the background color of the title.
+     */
     background;
+    /**
+     * Specifies the border configuration of the title.
+     */
     border;
+    /**
+     * Sets the text color of the title.
+     */
     color;
     /**
-     * The font style of the title.
+     * Defines the font style of the title.
      * @default '700 18px sans-serif'
      */
     font;
     /**
-     * The margin of the title. A numeric value sets all margins.
+     * Specifies the margin of the title. A numeric value sets all margins.
      * @default 5
      */
     margin;
     /**
-     * The position of the title.
-     *
-     * The positioning of the axis title can be set to `left` for left positioning, `right` for right positioning (both applicable to the horizontal axis), or `center` for positioning in the center.
+     * Specifies the position of the title.
      * @default 'center'
      */
     position;
+    /**
+     * Sets the text content of the title.
+     */
     text;
     /**
-     * If set to `true`, the Chart displays the pane title.
+     * Determines whether the Chart displays the pane title.
      * @default true
      */
     visible;
+    /**
+     * Provides a function that creates a custom visual for the title.
+     */
     visual;
     constructor(configurationService) {
         super('title', configurationService);

package/esm2022/chart/pane-defaults/title.component.mjs

@@ -8,35 +8,47 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration of the pane default title.
+ * Represents the default title configuration of all Chart panes.
  */
 export class PaneDefaultsTitleComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the title.
+     */
     background;
+    /**
+     * Specifies the border configuration of the title.
+     */
     border;
+    /**
+     * Specifies the text color of the title.
+     */
     color;
     /**
-     * The font style of the title.
+     * Specifies the font style of the title.
      * @default '16px sans-serif'
      */
     font;
     /**
-     * The margin of the title. A numeric value sets all margins.
+     * Specifies the margin of the title. A numeric value sets all margins.
      * @default 5
      */
     margin;
     /**
-     * The position of the title.
+     * Specifies the position of the title.
      *
      * The positioning of the axis title can be set to `left` for left positioning, `right` for right positioning (both applicable to the horizontal axis), or `center` for positioning in the center.
      * @default 'center'
      */
     position;
     /**
-     * If set to `true`, the Chart displays the pane title.
+     * Determines whether the Chart displays the pane title.
      * @default true
      */
     visible;
+    /**
+     * Specifies a function that creates a custom visual for the title.
+     */
     visual;
     constructor(configurationService) {
         super('paneDefaults.title', configurationService);

package/esm2022/chart/pane-defaults.component.mjs

@@ -8,25 +8,52 @@ import { SettingsComponent } from '../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../common/configuration.service";
 /**
- * The default options for all chart panes,
+ * Represents the default options for all Chart panes
  * ([see example](slug:panes_chart_charts#toc-default-settings)).
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-pane-defaults background="#f0f0f0" [border]="{ color: '#ccc', width: 1 }">
+ *   <kendo-chart-pane-defaults-title [visible]="true"></kendo-chart-pane-defaults-title>
+ *  </kendo-chart-pane-defaults>
+ * </kendo-chart>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link PaneDefaultsTitleComponent}.
  */
 export class PaneDefaultsComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the pane.
+     */
     background;
+    /**
+     * Specifies the border configuration of the pane.
+     */
     border;
+    /**
+     * Determines whether the pane clips its content.
+     */
     clip;
+    /**
+     * Specifies the height of the pane.
+     */
     height;
     /**
-     * The margin of the pane. A numeric value sets all margins.
+     * Specifies the margin of the pane. A numeric value sets all margins.
      * @default 0
      */
     margin;
     /**
-     * The padding of the pane. A numeric value sets all paddings.
+     * Specifies the padding of the pane. A numeric value sets all paddings.
      * @default 0
      */
     padding;
+    /**
+     * Specifies the title configuration of the pane.
+     */
     title;
     constructor(configurationService) {
         super('paneDefaults', configurationService);