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

package/option-types/category-axis-item/select.interface.d.ts

@@ -4,31 +4,30 @@
 *-------------------------------------------------------------------------------------------*/
 import { MousewheelSelect } from '../../common/property-types';
 /**
- * The configuration of the category axis selection options.
+ * Represents the configuration of the category axis selection options.
  */
 export interface CategoryAxisSelect {
     /**
-     * The lower boundary of the selected range.
+     * Specifies the lower boundary of the selected range.
      */
     from?: any;
     /**
-     * The maximum value which the user can select.
+     * Specifies the maximum value which the user can select.
      */
     max?: any;
     /**
-     * The minimum value which the user can select.
+     * Specifies the minimum value which the user can select.
      */
     min?: any;
     /**
-     * The mousewheel configuration of the selection.
-     * If set to `false`, the mousewheel does not update the selection.
+     * Specifies the mousewheel configuration of the selection.
+     * When set to `false`, the mousewheel does not update the selection.
      */
     mousewheel?: boolean | MousewheelSelect;
     /**
-     * The upper boundary of the selected range.
-     * The category with the specified index (date) is not included in the selected range
-     * unless the axis is justified. To select all categories, set
-     * a value that is larger than the last category index (date).
+     * Specifies the upper boundary of the selected range.
+     * The category with the specified index (date) is not included in the selected range unless the axis is justified.
+     * To select all categories, set a value that is larger than the last category index (date).
      */
     to?: any;
 }

package/option-types/category-axis-item/title.interface.d.ts

@@ -5,53 +5,53 @@
 import { drawing } from '@progress/kendo-drawing';
 import { AxisTitlePosition, Border, Margin, Padding, TitleVisualArgs } from '../../common/property-types';
 /**
- * The configuration options of the category axis title.
+ * Represents the configuration options of the category axis title.
  */
 export interface CategoryAxisTitle {
     /**
-     * The background color of the title. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the background color of the title. Accepts a valid CSS color string, including hex and rgb.
      */
     background?: string;
     /**
-     * The border of the title.
+     * Specifies the border of the title.
      */
     border?: Border;
     /**
-     * The text color of the title. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the text color of the title. Accepts a valid CSS color string, including hex and rgb.
      */
     color?: string;
     /**
-     * The font style of the title.
+     * Specifies the font style of the title.
      */
     font?: string;
     /**
-     * The margin of the title. A numeric value sets all margins.
+     * Specifies the margin of the title. A numeric value sets all margins.
      */
     margin?: Margin | number;
     /**
-     * The padding of the title. A numeric value sets all paddings.
+     * Specifies the padding of the title. A numeric value sets all paddings.
      */
     padding?: Padding | number;
     /**
-     * The position of the title.
+     * Specifies the position of the title.
      */
     position?: AxisTitlePosition;
     /**
-     * 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.
      */
     rotation?: number;
     /**
-     * The text of the title.
+     * Specifies the text of the title.
      * The text can be split into multiple lines by using the line feed characters (`"\n"`).
      */
     text?: string;
     /**
-     * If set to `true`, the Chart displays the category axis title.
-     * By default, the category axis title is visible.
+     * Determines whether the Chart displays the category axis title.
+     * When set to `true`, the title is visible. By default, the category axis title is visible.
      */
     visible?: boolean;
     /**
-     * A function that can be used to create a custom visual for the title.
+     * Specifies a function that can be used to create a custom visual for the title.
      */
     visual?: (e: TitleVisualArgs) => drawing.Element;
 }

package/option-types/category-axis-item.interface.d.ts

@@ -10,172 +10,156 @@ import { CategoryAxisNotes } from './category-axis-item/notes.interface';
 import { CategoryAxisSelect } from './category-axis-item/select.interface';
 import { CategoryAxisTitle } from './category-axis-item/title.interface';
 /**
- * The configuration options of the category axis.
+ * Represents the category axis configuration options.
  */
 export interface CategoryAxis {
     /**
-     * The time-interval steps when `baseUnit` is set either to `"fit"` or `"auto"`.
-     * The axis will try to divide the active period into the smallest possible units
-     * that yield `maxDateGroups` or less discrete intervals.
+     * Sets the time-interval steps when `baseUnit` is set to `"fit"` or `"auto"`.
+     * The axis tries to divide the active period into the smallest possible units that yield `maxDateGroups` or less discrete intervals.
      */
     autoBaseUnitSteps?: AutoBaseUnitSteps;
     /**
-     * The category index or the date (for date category axis) at which the first value axis crosses this axis.
-     * The category indices or the date (for date category axis) at which the value axes cross the category axis (when set as an array).
-     * To denote the far end of the axis, set an index greater than or equal to the number of categories.
+     * Sets the category index or date at which the first value axis crosses this axis.
+     * Use an array to set the category indices or dates at which the value axes cross the category axis. To denote the far end of the axis, set an index greater than or equal to the number of categories.
      */
     axisCrossingValue?: any | any[];
     /**
-     * The background color of the axis.
+     * Sets the background color of the axis.
      */
     background?: string;
     /**
-     * The base time interval for the date axis. The default base unit is automatically determined by the
-     * minimum difference between subsequent categories.
-     * Setting `baseUnit` to `"fit"` sets such a base unit and [`categoryAxis.baseUnitStep`](slug:api_charts_categoryaxis#toc-baseunitstep)
-     * that the total number of categories does not exceed [`categoryAxis.maxDateGroups`](slug:api_charts_categoryaxis#toc-maxdategroups).
-     *
-     * Series data is aggregated for the specified base unit by using the [`series.aggregate`](slug:api_charts_series#toc-aggregate) function.
+     * Sets the base time interval for the date axis.
+     * The default base unit is automatically determined by the minimum difference between subsequent categories. Use `"fit"` to set a base unit and [`categoryAxis.baseUnitStep`](slug:api_charts_categoryaxis#toc-baseunitstep) so the total number of categories does not exceed [`categoryAxis.maxDateGroups`](slug:api_charts_categoryaxis#toc-maxdategroups). Series data is aggregated for the specified base unit by using the [`series.aggregate`](slug:api_charts_series#toc-aggregate) function.
      */
     baseUnit?: CategoryBaseUnit;
     /**
-     * The step (interval) between the categories in base units. Setting it to `"auto"` sets the step to such
-     * a value that the total number of categories does not exceed [`categoryAxis.maxDateGroups`](slug:api_charts_categoryaxis#toc-maxdategroups).
-     * The option is ignored if [`categoryAxis.baseUnit`](slug:api_charts_categoryaxis#toc-baseunit) is set to `"fit"`.
+     * Sets the step (interval) between categories in base units.
+     * Use `"auto"` to set the step so the total number of categories does not exceed [`categoryAxis.maxDateGroups`](slug:api_charts_categoryaxis#toc-maxdategroups). This option is ignored if [`categoryAxis.baseUnit`](slug:api_charts_categoryaxis#toc-baseunit) is set to `"fit"`.
      */
     baseUnitStep?: number | 'auto';
     /**
-     * The category names. The Chart creates a category for every item of the array.
+     * Sets the category names.
+     * The Chart creates a category for every item of the array.
      */
     categories?: any[];
     /**
-     * The color to apply to all axis elements. Accepts a valid CSS color string, including HEX and RGB.
-     * Can be overridden by [`categoryAxis.labels.color`](slug:api_charts_categoryaxislabels#toc-color) and [`categoryAxis.line.color`](slug:api_charts_axisline#toc-color).
+     * Sets the color to apply to all axis elements.
+     * Accepts a valid CSS color string, including HEX and RGB and can be overridden by [`categoryAxis.labels.color`](slug:api_charts_categoryaxislabels#toc-color) and [`categoryAxis.line.color`](slug:api_charts_axisline#toc-color).
      */
     color?: string;
     /**
-     * If set to `true`, the Chart positions categories and series points on major ticks.
-     * This removes the empty space before and after the series.
-     * The default value is `false` except for `"area"`, `"verticalArea"`, `"rangeArea"`, and `"verticalRangeArea"`.
-     * The option is ignored if the [`series.type`](slug:api_charts_series#toc-type) option is set to `"bar"`, `"column"`, `"boxPlot"`, `"ohlc"`,
-     * `"candlestick"`, or `"waterfall"`.
+     * Determines if the Chart positions categories and series points on major ticks.
+     * This removes the empty space before and after the series. The default value is `false` except for `"area"`, `"verticalArea"`, `"rangeArea"`, and `"verticalRangeArea"`. This option is ignored if [`series.type`](slug:api_charts_series#toc-type) is set to `"bar"`, `"column"`, `"boxPlot"`, `"ohlc"`, `"candlestick"`, or `"waterfall"`.
      */
     justified?: boolean;
     /**
-     * The configuration of the axis lines. Also affects the major and minor ticks, but not the grid lines.
+     * Configures the axis lines.
+     * Also affects the major and minor ticks, but not the grid lines.
      */
     line?: AxisLine;
     /**
-     * The configuration of the major grid lines.
+     * Configures the major grid lines.
      * These are the lines that are an extension of the major ticks through the body of the Chart.
      */
     majorGridLines?: GridLines;
     /**
-     * The configuration of the category axis major ticks.
+     * Configures the category axis major ticks.
      */
     majorTicks?: AxisTicks;
     /**
-     * The last date displayed on a date category axis or the index of the last category displayed on a category axis.
-     * By default, the max value is the same as the last category.
-     * This is often used in combination with the [`categoryAxis.min`]({% slug api_charts_categoryaxis %}#toc-min) and
-     * [`categoryAxis.roundToBaseUnit`]({% slug api_charts_categoryaxis %}#toc-roundtobaseunit) options to set up a fixed date range.
+     * Sets the last date displayed on a date category axis or the index of the last category displayed on a category axis.
+     * By default, the max value is the same as the last category. This is often used in combination with [`categoryAxis.min`]({% slug api_charts_categoryaxis %}#toc-min) and [`categoryAxis.roundToBaseUnit`]({% slug api_charts_categoryaxis %}#toc-roundtobaseunit) to set up a fixed date range.
      */
     max?: any;
     /**
-     * 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"`.
+     * Sets 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"`.
      */
     maxDateGroups?: number;
     /**
-     * The maximum number of ticks and labels to display. Applicable for date category axis.
+     * Sets the maximum number of ticks and labels to display.
+     * Applicable for date category axis.
      */
     maxDivisions?: number;
     /**
-     * The first date which is displayed on a date category axis or the index of the first category which is displayed on a category axis.
-     * By default, the min value is the same as the first category.
-     * This is often used in combination with the [`categoryAxis.max`]({% slug api_charts_categoryaxis %}#toc-max) and
-     * [`categoryAxis.roundToBaseUnit`]({% slug api_charts_categoryaxis %}#toc-roundtobaseunit) options to set up a fixed date range.
+     * Sets the first date displayed on a date category axis or the index of the first category displayed on a category axis.
+     * By default, the min value is the same as the first category. This is often used in combination with [`categoryAxis.max`]({% slug api_charts_categoryaxis %}#toc-max) and [`categoryAxis.roundToBaseUnit`]({% slug api_charts_categoryaxis %}#toc-roundtobaseunit) to set up a fixed date range.
      */
     min?: any;
     /**
-     * The configuration of the minor grid lines.
+     * Configures the minor grid lines.
      * These are the lines that are an extension of the minor ticks through the body of the Chart.
      */
     minorGridLines?: GridLines;
     /**
-     * The configuration of the category axis minor ticks.
+     * Configures the category axis minor ticks.
      */
     minorTicks?: AxisTicks;
     /**
-     * The unique axis name. Used to associate a series with a category axis,
-     * which utilizes the [`series.categoryAxis`]({% slug api_charts_series %}#toc-categoryaxis) option.
+     * Sets the unique axis name.
+     * Used to associate a series with a category axis, which utilizes the [`series.categoryAxis`]({% slug api_charts_series %}#toc-categoryaxis) option.
      */
     name?: string;
     /**
-     * The configuration of the date axis date range labels.
+     * Configures the date axis date range labels.
      */
     rangeLabels?: CategoryAxisRangeLabels;
     /**
-     * The name of the pane in which the category axis has to be rendered.
+     * Sets the name of the pane in which the category axis has to be rendered.
      * If not set, the axis will be rendered in the first (default) pane.
      */
     pane?: string;
     /**
-     * The plot bands of the category axis.
+     * Sets the plot bands of the category axis.
      */
     plotBands?: PlotBand[];
     /**
-     * If set to `true`, the category axis direction is reversed.
+     * Determines if the category axis direction is reversed.
      * By default, categories are listed from left to right and from bottom to top.
      */
     reverse?: boolean;
     /**
-     * If set to `true`, the Chart rounds the first and last date to the nearest base unit.
+     * Determines if the Chart rounds the first and last date to the nearest base unit.
      */
     roundToBaseUnit?: boolean;
     /**
-     * The angle (degrees) of the first category on the axis.
-     * Angles increase clockwise with zero to the left. Negative values are acceptable.
+     * Sets the angle (degrees) of the first category on the axis.
+     * Angles increase clockwise with zero to the left and negative values are acceptable.
      */
     startAngle?: number;
     /**
-     * The category axis type.
-     * The supported values include `category` for a discrete category axis and `date` for a specialized axis for displaying chronological data.
+     * Sets the category axis type.
+     * Use `"category"` for a discrete category axis or `"date"` for a specialized axis for displaying chronological data.
      */
     type?: 'category' | 'date';
     /**
-     * If set to `true`, the Chart displays the category axis. By default, the category axis is visible.
+     * Determines if the Chart displays the category axis.
+     * By default, the category axis is visible.
      */
     visible?: boolean;
     /**
-     * The week start day when the `baseUnit` is set to `"weeks"`.
+     * Sets the week start day when the `baseUnit` is set to `"weeks"`.
      */
     weekStartDay?: WeekStartDay;
     /**
-     * The configuration options of the crosshair.
+     * Configures the crosshair options.
      * The crosshair is displayed when the [`categoryAxis.crosshair.visible`]({% slug api_charts_categoryaxiscrosshair %}#toc-visible) option is set to `true`.
      */
     crosshair?: CategoryAxisCrosshair;
     /**
-     * The configuration of the axis labels.
+     * Configures the axis labels.
      */
     labels?: CategoryAxisLabels;
     /**
-     * The configuration of the category axis notes.
+     * Configures the category axis notes.
      */
     notes?: CategoryAxisNotes;
     /**
-     * The selected axis range. If set, the axis selection is enabled.
-     * The range is index-based, starting from zero.
-     * Categories with indexes in the range (`select.from`, `select.to`) will be selected.
-     * That is, the last category in the range will not be included in the selection.
-     * If the categories are dates, the range has to be also specified with date values.
-     * Selection is only supported if the axis is horizontal.
+     * Configures the selected axis range.
+     * Setting this option enables axis selection and the range is index-based, starting from zero. Categories with indexes in the range (`select.from`, `select.to`) will be selected, but the last category in the range will not be included in the selection. If the categories are dates, specify the range with date values. Selection is only supported if the axis is horizontal.
      */
     select?: CategoryAxisSelect;
     /**
-     * The title configuration of the category axis.
+     * Configures the title of the category axis.
      * To display the title, set the [`categoryAxis.title.text`]({% slug api_charts_categoryaxistitle %}#toc-text) option.
      */
     title?: CategoryAxisTitle;

package/option-types/chart-area.interface.d.ts

@@ -4,31 +4,31 @@
 *-------------------------------------------------------------------------------------------*/
 import { Border, Margin } from '../common/property-types';
 /**
- * The configuration options of the Chart area.
+ * Specifies the configuration options of the Chart area.
  */
 export interface ChartArea {
     /**
-     * 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.
      */
     background?: string;
     /**
-     * The border of the Chart area.
+     * Specifies the border of the Chart area.
      */
     border?: Border;
     /**
-     * The height of the Chart area.
+     * Specifies the height of the Chart area.
      */
     height?: number;
     /**
-     * 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.
      */
     margin?: Margin | number;
     /**
-     * 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.
      */
     opacity?: number;
     /**
-     * The width of the Chart area.
+     * Specifies the width of the Chart area.
      */
     width?: number;
 }

package/option-types/legend/inactive-items.interface.d.ts

@@ -4,11 +4,11 @@
 *-------------------------------------------------------------------------------------------*/
 import { LegendLabels } from '../../common/property-types';
 /**
- * The configuration options of the inactive legend items.
+ * Represents the configuration options of the inactive legend items.
  */
 export interface LegendInactiveItems {
     /**
-     * The label configuration of the Chart legend.
+     * Specifies the label configuration of the Chart legend.
      */
     labels?: LegendLabels;
 }

package/option-types/legend/item.interface.d.ts

@@ -6,39 +6,39 @@ import { drawing } from '@progress/kendo-drawing';
 import { Border, DashType, LegendItemVisualArgs } from '../../common/property-types';
 import { SeriesMarkers } from './../series-item/markers.interface';
 /**
- * The configuration options of the legend item.
+ * Represents the configuration options of the legend item.
  */
 export interface LegendItem {
     /**
-     * The cursor style of the legend item.
+     * Specifies the cursor style of the legend item.
      */
     cursor?: string;
     /**
-       * Sets the type of the legend item.
+       * Specifies the type of the legend item.
        * The default value is based on the series type.
        */
     type?: LegendItemType;
     /**
-     * Sets the configuration of the legend items of type `line`.
+     * Specifies the configuration of the legend items of type `line`.
      * This is the default legend item type for all line and scatter series.
      */
     line?: LegendItemLine;
     /**
-     * Sets the configuration of the legend items of type `area`.
+     * Specifies the configuration of the legend items of type `area`.
      * By default, all series except line and scatter use this legend type.
      */
     area?: LegendItemArea;
     /**
-     * The markers configuration of the legend item.
+     * Specifies the markers configuration of the legend item.
      * Defaults to the series options.
      */
     markers?: LegendItemMarkers;
     /**
-     * The highlight configuration of the legend item.
+     * Specifies the highlight configuration of the legend item.
      */
     highlight?: LegendItemHighlight;
     /**
-     * A function for creating a custom visual for the legend items.
+     * Specifies a function for creating a custom visual for the legend items.
      */
     visual?: (e: LegendItemVisualArgs) => drawing.Element;
 }
@@ -52,7 +52,7 @@ export interface LegendItemMarkersBorder extends Omit<Border, 'width'> {
  */
 export interface LegendItemMarkers extends Omit<SeriesMarkers, 'size' | 'border' | 'rotation' | 'from' | 'to'> {
     /**
-     * The border of the markers.
+     * Specifies the border of the markers.
      */
     border?: LegendItemMarkersBorder;
 }
@@ -61,11 +61,12 @@ export interface LegendItemMarkers extends Omit<SeriesMarkers, 'size' | 'border'
  */
 export interface LegendItemHighlight {
     /**
-     * If set to `false`, the hover effect of the legend item is disabled.
+     * Determines whether the hover effect of the legend item is disabled.
+     * When set to `false`, the hover effect is disabled.
      */
     visible?: boolean;
     /**
-     * The `markers` configuration of the legend item when it is hovered.
+     * Specifies the `markers` configuration of the legend item when it is hovered.
      */
     markers?: LegendItemMarkers;
 }
@@ -75,17 +76,17 @@ export interface LegendItemHighlight {
  */
 export interface LegendItemLine {
     /**
-     * The color of the legend item. Accepts a valid CSS color string, including HEX and RGB.
+     * Specifies the color of the legend item. Accepts a valid CSS color string, including HEX and RGB.
      * Defaults to the series color.
      */
     color?: string;
     /**
-     * The opacity of the legend item.
+     * Specifies the opacity of the legend item.
      * Defaults to the series opacity.
      */
     opacity?: number;
     /**
-     * The dash type of the legend item.
+     * Specifies the dash type of the legend item.
      * Defaults to the series dash type.
      */
     dashType?: DashType;
@@ -96,20 +97,19 @@ export interface LegendItemLine {
  */
 export interface LegendItemArea {
     /**
-     * The background color of the legend item. Accepts a valid CSS color string, including HEX and RGB.
+     * Specifies the background color of the legend item. Accepts a valid CSS color string, including HEX and RGB.
      * Defaults to the series color.
      */
     background?: string;
     /**
-     * The opacity of the legend item.
+     * Specifies the opacity of the legend item.
      * Defaults to the series opacity.
      */
     opacity?: number;
 }
 /**
- * The type of the Chart legend item.
+ * Specifies the type of the Chart legend item.
  *
- * - `"line"`&mdash;the legend items are rendered as a line. This is the default value for line charts.
- * - `"area"`&mdash;the legend items are rendered as a filled rectangle. This is the default value for area charts.
+ * The options are `"line"` for rendering legend items as a line (default for line charts) and `"area"` for rendering legend items as a filled rectangle (default for area charts).
  */
 export type LegendItemType = 'line' | 'area';

package/option-types/legend/legend-title.interface.d.ts

@@ -5,53 +5,54 @@
 import { Element } from '@progress/kendo-drawing';
 import { Border, Margin, Padding, TitleVisualArgs } from '../../common/property-types';
 /**
- * The configuration options for the Legend title
+ * Represents the configuration options for the Legend title
  * ([see example]({% slug legend_chart_charts %}#toc-setting-a-title)).
  */
 export interface LegendTitle {
     /**
-     * The alignment of the title.
+     * Specifies the alignment of the title.
      */
     align?: 'center' | 'left' | 'right';
     /**
-     * The background color of the title. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the background color of the title. Accepts a valid CSS color string, including hex and rgb.
      */
     background?: string;
     /**
-     * The border of the title.
+     * Specifies the border of the title.
      */
     border?: Border;
     /**
-     * The text color of the title. Accepts a valid CSS color string, including hex and rgb.
+     * Specifies the text color of the title. Accepts a valid CSS color string, including hex and rgb.
      */
     color?: string;
     /**
-     * The font of the title.
+     * Specifies the font of the title.
      */
     font?: string;
     /**
-     * The margin of the title. A numeric value sets all margins.
+     * Specifies the margin of the title. A numeric value sets all margins.
      */
     margin?: Margin | number;
     /**
-     * The padding of the title. A numeric value sets all margins.
+     * Specifies the padding of the title. A numeric value sets all margins.
      */
     padding?: Padding | number;
     /**
-     * The position of the title.
+     * Specifies the position of the title.
      */
     position?: 'top' | 'bottom';
     /**
-     * The text of the title.
+     * Specifies the text of the title.
      * You can split the text into multiple lines by using the line feed characters ("\n").
      */
     text?: string;
     /**
-     * If set to `true`, the Chart displays the Legend title. By default, the title is displayed.
+     * Determines whether the Chart displays the Legend title.
+     * When set to `true`, the title is visible. By default, the title is displayed.
      */
     visible?: boolean;
     /**
-     * A function for creating a custom visual for the title.
+     * Specifies a function for creating a custom visual for the title.
      */
     visual?: (args: TitleVisualArgs) => Element;
 }

package/option-types/legend/markers.interface.d.ts

@@ -5,28 +5,28 @@
 import { drawing } from '@progress/kendo-drawing';
 import { MarkersVisualArgs, MarkerType } from '../../common/property-types';
 /**
- * The configuration options of the legend markers.
+ * Represents the configuration options of the legend markers.
  */
 export interface LegendMarkers {
     /**
-     * The width (in pixels) of the markers. Defaults to `15`.
+     * Specifies the width (in pixels) of the markers. Defaults to `15`.
      */
     width?: number;
     /**
-     * The height (in pixels) of the markers. Defaults to `3`.
+     * Specifies the height (in pixels) of the markers. Defaults to `3`.
      */
     height?: number;
     /**
-     * The shape of the legend item markers. Defaults to `circle`.
+     * Specifies the shape of the legend item markers. Defaults to `circle`.
      */
     type?: MarkerType;
     /**
-     * If set to `true`, the Chart displays the markers.
-     * By default, the legend item markers are displayed.
+     * Determines whether the Chart displays the markers.
+     * When set to `true`, the markers are visible. By default, the legend item markers are displayed.
      */
     visible?: boolean;
     /**
-     * A function for creating a custom visual for the markers.
+     * Specifies a function for creating a custom visual for the markers.
      */
     visual?: (e: MarkersVisualArgs) => drawing.Element;
 }