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

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

@@ -10,46 +10,96 @@ import * as i0 from "@angular/core";
 import * as i1 from "../common/configuration.service";
 import * as i2 from "../common/collection.service";
 /**
- * The configuration component for a value axis.
+ * Represents the Kendo UI for Angular Chart Value Axis Item component.
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-value-axis>
+ *   <kendo-chart-value-axis-item>
+ *     <kendo-chart-value-axis-item-title text="Value Axis Title"></kendo-chart-value-axis-item-title>
+ *   </kendo-chart-value-axis-item>
+ *  </kendo-chart-value-axis>
+ * </kendo-chart>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link ValueAxisCrosshairComponent}, {@link ValueAxisLabelsComponent}, {@link ValueAxisNotesComponent}, and {@link ValueAxisTitleComponent}.
  */
 export class ValueAxisItemComponent extends CollectionItemComponent {
     configurationService;
     collectionService;
+    /**
+     * Specifies the value or array of values at which the axis crosses with another axis.
+     */
     axisCrossingValue;
+    /**
+     * Specifies the background color of the axis.
+     */
     background;
+    /**
+     * Specifies the color of the axis.
+     */
     color;
+    /**
+     * Specifies the configuration of the axis line.
+     */
     line;
+    /**
+     * Specifies the configuration of the major grid lines.
+     */
     majorGridLines;
+    /**
+     * Specifies the configuration of the major ticks.
+     */
     majorTicks;
+    /**
+     * Specifies the interval between major divisions.
+     */
     majorUnit;
     /**
-     * The maximum value of the axis.
+     * Specifies the maximum value of the axis.
      * @default 1
      */
     max;
     /**
-     * The minimum value of the axis.
+     * Specifies the minimum value of the axis.
      * @default 0
      */
     min;
+    /**
+     * Specifies the configuration of the minor grid lines.
+     */
     minorGridLines;
+    /**
+     * Specifies the configuration of the minor ticks.
+     */
     minorTicks;
+    /**
+     * Specifies the interval between minor divisions.
+     */
     minorUnit;
     /**
-     * The unique axis name. Used to associate a series with a value axis by using the [`series.axis`]({% slug api_charts_series %}#toc-axis) option.
+     * Specifies the unique axis name. Use this name to associate a series with a value axis by using the [`series.axis`]({% slug api_charts_series %}#toc-axis) option.
      * @default 'primary'
      */
     name;
     /**
-     * If set to `true`, the Chart prevents the automatic axis range from snapping to zero.
-     * Setting it to `false` forces the automatic axis range to snap to zero.
+     * Determines whether the Chart prevents the automatic axis range from snapping to zero.
+     * Set to `false` to force the automatic axis range to snap to zero.
      * @default true
      */
     narrowRange;
+    /**
+     * Specifies the name of the pane that the axis renders in.
+     */
     pane;
+    /**
+     * Specifies the plot bands configuration.
+     */
     plotBands;
     /**
-     * If set to `true`, the value axis direction is reversed.
+     * Determines whether the value axis direction is reversed.
      * By default, the categories are listed from left to right and from bottom to top.
      *
      * Radar and Polar Charts do not support reverse value axes.
@@ -57,22 +107,34 @@ export class ValueAxisItemComponent extends CollectionItemComponent {
      */
     reverse;
     /**
-     * The axis type.
+     * Specifies the axis type.
      *
-     * The "numeric" value refers to a numeric axis, while "log" represents a logarithmic axis.
+     * The `numeric` value refers to a numeric axis, while `log` represents a logarithmic axis.
      * @default 'numeric'
      *
      */
     type;
     /**
-     * If set to `true`, the Chart displays the value axis. By default, the value axis is visible.
+     * Determines whether the Chart displays the value axis. By default, the value axis is visible.
      * @default true
      */
     visible;
     // These options are also available as child components
+    /**
+     * Specifies the configuration of the crosshair.
+     */
     crosshair;
+    /**
+     * Specifies the configuration of the labels.
+     */
     labels;
+    /**
+     * Specifies the configuration of the notes.
+     */
     notes;
+    /**
+     * Specifies the configuration of the title.
+     */
     title;
     constructor(configurationService, collectionService) {
         super(configurationService, collectionService);

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

@@ -12,16 +12,18 @@ 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 value axis configuration components.
+ * Represents a collection of one or more value axis configuration components.
  *
  * @example
  * ```html
  * <kendo-chart>
  *     <kendo-chart-value-axis>
- *         ....
  *     </kendo-chart-value-axis>
  * </kendo-chart>
  * ```
+ *
+ * @remarks
+ * Supported children components are: {@link ValueAxisItemComponent}.
  */
 export class ValueAxisComponent extends CollectionComponent {
     configurationService;

package/esm2022/chart/x-axis-item/crosshair.component.mjs

@@ -8,28 +8,50 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The crosshair configuration options
+ * Represents the crosshair configuration options of the X axis
  * ([see example]({% slug api_charts_xaxiscomponent %})).
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-x-axis>
+ *   <kendo-chart-x-axis-item>
+ *    <kendo-chart-x-axis-item-crosshair [visible]="true" color="#ff0000" [width]="2">
+ *     <kendo-chart-x-axis-item-crosshair-tooltip format="c"></kendo-chart-x-axis-item-crosshair-tooltip>
+ *    </kendo-chart-x-axis-item-crosshair>
+ *   </kendo-chart-x-axis-item>
+ *  </kendo-chart-x-axis>
+ * </kendo-chart>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link XAxisCrosshairTooltipComponent}.
  */
 export class XAxisCrosshairComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the color of the crosshair.
+     */
     color;
     /**
-     * The opacity of the crosshair. By default, the crosshair is opaque.
+     * Specifies the opacity of the crosshair. By default, the crosshair is opaque.
      * @default 1
      */
     opacity;
     /**
-     * If set to `true`, the Chart displays the X-axis crosshair of the Scatter Chart.
+     * Determines whether the Chart displays the X-axis crosshair of the Scatter Chart.
      * @default false
      */
     visible;
     /**
-     * The width of the crosshair in pixels.
+     * Specifies the width of the crosshair in pixels.
      * @default 1
      */
     width;
     // These options are also available as child components
+    /**
+     * Specifies the tooltip configuration of the crosshair.
+     */
     tooltip;
     constructor(configurationService) {
         super('crosshair', configurationService);

package/esm2022/chart/x-axis-item/crosshair.tooltip.component.mjs

@@ -8,32 +8,41 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration options of the crosshair tooltip.
+ * Represents the configuration options of the crosshair tooltip in the X axis.
  * The crosshair tooltip is displayed when the `visible` option is set to `true`.
  */
 export class XAxisCrosshairTooltipComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the tooltip.
+     */
     background;
+    /**
+     * Specifies the border configuration of the tooltip.
+     */
     border;
+    /**
+     * Specifies the text color of the tooltip.
+     */
     color;
     /**
-     * The font of the tooltip.
+     * Specifies the font of the tooltip.
      * @default '12px sans-serif'
      */
     font;
     /**
-     * The format for displaying the tooltip. Uses the [`format`]({% slug api_intl_intlservice %}#toc-format) method of `IntlService`.
+     * Specifies the format for displaying the tooltip. Uses the [`format`]({% slug api_intl_intlservice %}#toc-format) method of `IntlService`.
      * Contains one placeholder (`"{0}"`) which represents the value.
      * @default '{0}'
      */
     format;
     /**
-     * The padding of the crosshair tooltip. A numeric value sets all paddings.
+     * Specifies the padding of the crosshair tooltip. A numeric value sets all paddings.
      * @default 0
      */
     padding;
     /**
-     * If set to `true`, the Chart displays the crosshair tooltip of the Scatter chart X axis.
+     * Determines whether the Chart displays the crosshair tooltip of the Scatter chart X axis.
      * By default, the crosshair tooltip of the Scatter chart X axis is not visible.
      * @default false
      */

package/esm2022/chart/x-axis-item/labels.component.mjs

@@ -8,55 +8,85 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The axis labels configuration.
+ * Represents the labels configuration of the X axis.
  */
 export class XAxisLabelsComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the labels.
+     */
     background;
+    /**
+     * Specifies the border configuration of the labels.
+     */
     border;
+    /**
+     * Specifies the text color of the labels.
+     */
     color;
+    /**
+     * Specifies a function that returns the content of the labels.
+     */
     content;
+    /**
+     * Specifies the culture information for the labels.
+     */
     culture;
+    /**
+     * Specifies the date formats for the labels.
+     */
     dateFormats;
     /**
-     * The font style of the labels.
+     * Specifies the font style of the labels.
      * @default '12px sans-serif'
      */
     font;
+    /**
+     * Specifies the format of the labels.
+     */
     format;
+    /**
+     * Specifies the margin of the labels.
+     */
     margin;
+    /**
+     * Specifies whether the labels are mirrored.
+     */
     mirror;
     /**
-     * The padding of the labels. A numeric value sets all paddings.
+     * Specifies the padding of the labels. A numeric value sets all paddings.
      * @default 0
      */
     padding;
     /**
-     * The position of the axis labels. By default, labels are positioned next to the axis.
+     * Specifies the position of the axis labels. By default, labels are positioned next to the axis.
      * @default 'onAxis'
      */
     position;
     /**
-     * The rotation angle of the labels. By default, the labels are not rotated. Can be set to `"auto"`.
+     * Specifies the rotation angle of the labels. By default, the labels are not rotated. Can be set to `"auto"`.
      * In this case, the labels are rotated only if the slot size is not sufficient for the entire labels.
      * @default 0
      */
     rotation;
     /**
-     * The number of labels to skip.
+     * Specifies the number of labels to skip.
      * @default 1
      */
     skip;
     /**
-     * The label rendering step&mdash;renders every n<sup>th</sup> label. By default, every label is rendered.
+     * Specifies the label rendering step&mdash;renders every n<sup>th</sup> label. By default, every label is rendered.
      * @default 1
      */
     step;
     /**
-     * If set to `true`, the Chart displays the X-axis labels. By default, the X-axis labels are visible.
+     * Determines whether the Chart displays the X-axis labels. By default, the X-axis labels are visible.
      * @default true
      */
     visible;
+    /**
+     * Specifies a function that returns a custom visual for the labels.
+     */
     visual;
     constructor(configurationService) {
         super('labels', configurationService);

package/esm2022/chart/x-axis-item/notes.component.mjs

@@ -8,20 +8,53 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The configuration of the X-axis notes.
- * For an example on the basic usage of the XAxisNotesComponent,
- * refer to the [demo on the XAxisComponent]({% slug api_charts_xaxiscomponent %})
+ * Represents the configuration of the X-axis notes.
+ * For an example on the basic usage of the `XAxisNotesComponent`,
+ * refer to the [demo on the `XAxisComponent`]({% slug api_charts_xaxiscomponent %})
  * or to the documentation about the
  * [axis notes]({% slug notes_chart_charts %}#toc-axis-notes).
+ *
+ * @example
+ * ```html
+ * <kendo-chart>
+ *  <kendo-chart-x-axis>
+ *   <kendo-chart-x-axis-item>
+ *    <kendo-chart-x-axis-item-notes>
+ *    </kendo-chart-x-axis-item-notes>
+ *  </kendo-chart-x-axis-item>
+ *  </kendo-chart-x-axis>
+ * </kendo-chart>
+ * ```
+ *
+ * @remarks
+ * Supported children components are: {@link XAxisNotesIconComponent} and {@link XAxisNotesLabelComponent}.
  */
 export class XAxisNotesComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the data for the notes.
+     */
     data;
+    /**
+     * Specifies the line configuration of the notes.
+     */
     line;
+    /**
+     * Specifies the position of the notes.
+     */
     position;
+    /**
+     * Specifies a function that returns a custom visual for the notes.
+     */
     visual;
     // These options are also available as child components
+    /**
+     * Specifies the icon configuration of the notes.
+     */
     icon;
+    /**
+     * Specifies the label configuration of the notes.
+     */
     label;
     constructor(configurationService) {
         super('notes', configurationService);

package/esm2022/chart/x-axis-item/notes.icon.component.mjs

@@ -8,20 +8,29 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The icon of the notes.
+ * Represents the notes icon configuration of the X axis.
  */
 export class XAxisNotesIconComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the icon.
+     */
     background;
+    /**
+     * Specifies the border configuration of the icon.
+     */
     border;
+    /**
+     * Specifies the size of the icon.
+     */
     size;
     /**
-     * The shape of the notes icon.
+     * Specifies the shape of the notes icon.
      * @default 'circle'
      */
     type;
     /**
-     * The visibility of the notes icon.
+     * Determines whether the notes icon is visible.
      * @default true
      */
     visible;

package/esm2022/chart/x-axis-item/notes.label.component.mjs

@@ -8,37 +8,49 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The label of the notes.
+ * Represents the notes label configuration of the X axis.
  */
 export class XAxisNotesLabelComponent extends SettingsComponent {
     configurationService;
+    /**
+     * Specifies the background color of the label.
+     */
     background;
+    /**
+     * Specifies the border configuration of the label.
+     */
     border;
+    /**
+     * Specifies the text color of the label.
+     */
     color;
+    /**
+     * Specifies a function that returns the content of the notes label.
+     */
     content;
     /**
-     * The font style of the label.
+     * Specifies the font style of the label.
      * @default '12px sans-serif''
      */
     font;
     /**
-     * The format for displaying the notes label. Uses the [`format`]({% slug api_intl_intlservice %}#toc-format) method of `IntlService`.
+     * Specifies the format for displaying the notes label. Uses the [`format`]({% slug api_intl_intlservice %}#toc-format) method of `IntlService`.
      * Contains one placeholder (`"{0}"`) which represents the axis value.
      * @default '{0}'
      */
     format;
     /**
-     * The position of the labels.
+     * Specifies the position of the labels.
      * @default 'inside'
      */
     position;
     /**
-     * The rotation angle of the label. By default, the label is not rotated.
+     * Specifies the rotation angle of the label. By default, the label is not rotated.
      * @default 0
      */
     rotation;
     /**
-     * If set to `true`, the Chart displays the X-axis notes label.
+     * Determines whether the Chart displays the X-axis notes label.
      * By default, the X-axis notes label is visible.
      * @default true
      */

package/esm2022/chart/x-axis-item/title.component.mjs

@@ -8,45 +8,60 @@ import { SettingsComponent } from '../../common/settings.component';
 import * as i0 from "@angular/core";
 import * as i1 from "../../common/configuration.service";
 /**
- * The title configuration of the Scatter Chart X axis.
+ * Represents the title configuration of the Scatter Chart X axis.
  */
 export class XAxisTitleComponent 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 'bold 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 padding of the title. A numeric value sets all paddings.
+     * Specifies the padding of the title. A numeric value sets all paddings.
      * @default 5
      */
     padding;
     /**
-     * The position of the title.
+     * Specifies the position of the title.
      * @default 'center'
      */
     position;
     /**
-     * The rotation angle of the title. By default, the title is not rotated.
+     * Specifies the rotation angle of the title. By default, the title is not rotated.
      * @default 0
      */
     rotation;
+    /**
+     * Specifies the text of the title.
+     */
     text;
     /**
-     * If set to `true`, the Chart displays the X axis title of the Scatter Chart.
+     * Determines whether the Chart displays the X axis title of the Scatter Chart.
      * By default, the X-axis title of the Scatter Chart is visible.
      * @default true
      */
     visible;
+    /**
+     * Specifies a function that returns a custom visual for the title.
+     */
     visual;
     constructor(configurationService) {
         super('title', configurationService);