@arcgis/charts-components 5.0.0-next.61 → 5.0.0-next.63

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-11-20T04:41:37",
+  "timestamp": "2025-11-22T04:41:39",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.61",
+    "version": "5.0.0-next.63",
     "typescriptVersion": "5.9.3"
   },
   "schemaVersion": "2.1.0",
@@ -17,7 +17,7 @@
           "customElement": true,
           "name": "ArcgisChart",
           "tagName": "arcgis-chart",
-          "description": "The ArcGIS Chart component renders a chart based on the provided model. Get started by reading the [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/) page.\n\nSupported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.\n\nSee also:\n- [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)\n- [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)\n- [Tutorial: Create a heat chart](https://developers.arcgis.com/javascript/latest/tutorials/create-a-heat-chart/)\n- [Tutorial: Modify a chart](https://developers.arcgis.com/javascript/latest/tutorials/modify-a-chart/)",
+          "description": "The Chart component renders a chart based on the provided model. Get started by reading the [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/) page.\n\nSupported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.",
           "demos": [
             {
               "description": "Docs",
@@ -65,6 +65,22 @@
             }
           ],
           "docsTags": [
+            {
+              "name": "see",
+              "text": "[Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)"
+            },
+            {
+              "name": "see",
+              "text": "[Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)"
+            },
+            {
+              "name": "see",
+              "text": "[Tutorial: Create a heat chart](https://developers.arcgis.com/javascript/latest/tutorials/create-a-heat-chart/)"
+            },
+            {
+              "name": "see",
+              "text": "[Tutorial: Modify a chart](https://developers.arcgis.com/javascript/latest/tutorials/modify-a-chart/)"
+            },
             {
               "name": "since",
               "text": "4.32"
@@ -80,7 +96,7 @@
             {
               "kind": "field",
               "name": "actionMode",
-              "description": "Not applicable to gauge.\nDefines the cursor behavior on the chart (zoom, selection...).",
+              "description": "Specifies the user action behavior for the chart.\n\n- `monoSelection`: Select a single data point or series, new selection replaces the previous one.\n- `multiSelection`: Select multiple data points or series, new selection adds to the previous one.\n- `multiSelectionWithCtrlKey`: Select multiple data points or series while holding the Ctrl key (Cmd on Mac). When the key is held, each new selection is added; otherwise, the selection is replaced.\n- `none`: No action is performed on user interaction.\n- `zoom`: Zoom into a specific area of the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"monoSelection\" | \"multiSelection\" | \"multiSelectionWithCtrlKey\" | \"none\" | \"zoom\"",
                 "values": [
@@ -106,7 +122,7 @@
                   }
                 ]
               },
-              "default": "undefined",
+              "default": "multiSelectionWithCtrlKey",
               "attribute": "action-mode",
               "docsTags": [
                 {
@@ -122,7 +138,7 @@
             {
               "kind": "field",
               "name": "allowUsingObjectIdStat",
-              "description": "Whether to allow the object id to be used as a statistic other than COUNT.",
+              "description": "Whether to allow the object id to be used as a statistic other than `COUNT`.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -162,7 +178,7 @@
             {
               "kind": "field",
               "name": "autoDisposeChart",
-              "description": "Auto-disposes the chart when a new one is created in the same container.",
+              "description": "Auto disposes the chart when a new one is created in the same container.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -172,7 +188,7 @@
                 ]
               },
               "default": "undefined",
-              "deprecated": "since 5.0. Use `autoDestroyDisabled` instead. Will be removed in 6.0.",
+              "deprecated": "since 5.0. Use [autoDestroyDisabled](https://developers.arcgis.com/javascript/latest/references/charts-components/arcgis-chart/#autoDestroyDisabled)instead.",
               "attribute": "auto-dispose-chart",
               "docsTags": [
                 {
@@ -188,7 +204,7 @@
             {
               "kind": "field",
               "name": "autoInverseDataLabelTextColor",
-              "description": "When `true`, the data label text color is automatically inverted based on the data label background color.\nFor example if the data label is dark, and it's on top of a dark color series area, the text color will eventually\nbe set to either the chart's background color or white.",
+              "description": "When `true`, the data label text color is automatically adjusted for readability based on its background.\nIf the label is dark and appears over a dark series area, the text color is switched to either the chart background color or white.\n\n**Note**: Only applicable to bar chart.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -200,10 +216,6 @@
               "default": "undefined",
               "attribute": "auto-inverse-data-label-text-color",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "This feature is currently only available for bar chart."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -231,7 +243,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "<arcgis-chart layer-item-id=\"05e015c5f0314db9a487a9b46cb37eca\" chart-index=\"2\"></arcgis-chart>"
+                  "text": "```html\n<arcgis-chart layer-item-id=\"8871626e970a4f3e9d6113ec63a92f2f\" chart-index=\"2\"></arcgis-chart>\n```"
                 },
                 {
                   "name": "type",
@@ -246,7 +258,7 @@
             {
               "kind": "field",
               "name": "chartLimits",
-              "description": "Used to customize the number maximum of bars allowed on the chart.\nThe chart's behavior once that limit is reached can be adjusted through the `behaviorAfterLimit` nested property, to either reject the creation\nor update of the chart, or render the elements up to the given limits.",
+              "description": "Used to customize the number maximum of bars allowed on the chart.\nThe chart's behavior once that limit is reached can be adjusted through the `behaviorAfterLimit` nested property, to either reject the creation\nor update of the chart, or render the elements up to the given limits.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "ChartElementLimit",
                 "references": [
@@ -260,10 +272,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{ChartElementLimit | undefined}"
@@ -277,16 +285,12 @@
             {
               "kind": "field",
               "name": "chartWillRender",
-              "description": "Lifecycle function executed after the data has been processed and before the chart renders.\nCan be used to alter the config from information extracted from the data for instance.",
+              "description": "Lifecycle function executed after the data has been processed and before the chart renders.\nCan be used to alter the config from information extracted from the data for instance.\n\n**Note**: Applicable to gauge and pie chart only.",
               "type": {
                 "text": "(((props: {\n    chartConfig: WebChart | WebGaugeChart;\n    data?: WebChartDataTypes | undefined;\n    slices?: Array<WebChartPieChartSlice> | undefined;\n}) => Promise<WebChart | WebGaugeChart>))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to gauge and pie chart only."
-                },
                 {
                   "name": "type",
                   "text": "{PreRenderCallback | undefined}"
@@ -300,7 +304,7 @@
             {
               "kind": "method",
               "name": "clearSelection",
-              "description": "Clears all selection on the chart.",
+              "description": "Clears all selection on the chart.\n\n**Note**: Not applicable to gauge.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -316,10 +320,6 @@
                 }
               },
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "category",
                   "text": "Public"
@@ -360,7 +360,7 @@
             {
               "kind": "field",
               "name": "cursorRange",
-              "description": "Sets the cursor range:\n- CursorRange.MultiAxes: allows to draw a free rectangle\n- CursorRange.XAxis: allows to draw a rectangle bound to the x-axis\n- CursorRange.YAxis: allows to draw a rectangle bound to the y-axis\n- undefined: defaults to a preset behavior according to the chart type and action mode",
+              "description": "Sets the cursor range when `actionMode` is set to `zoom`, `multiSelection` or `multiSelectionWithCtrlKey`.\n\n- `multi-axes`: Allows to draw a free rectangle.\n- `x-axis`: Allows to draw a rectangle bound to the x-axis.\n- `y-axis`: Allows to draw a rectangle bound to the y-axis.\n- `undefined`: Defaults to the preset behavior according to the chart type and action mode.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"multi-axes\" | \"x-axis\" | \"y-axis\"",
                 "values": [
@@ -381,10 +381,6 @@
               "default": "undefined",
               "attribute": "cursor-range",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge.\nApplies only when the action mode is set to zoom or multi-selection."
-                },
                 {
                   "name": "type",
                   "text": "{CursorRange | undefined}"
@@ -398,7 +394,7 @@
             {
               "kind": "field",
               "name": "dataLabelFormatter",
-              "description": "A callback function used to format the data labels. If the returned string contains HTML tags they will be interpreted as such.",
+              "description": "A callback function used to format the data labels. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
                 "values": [
@@ -418,10 +414,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{BarAndLineDataLabelFormatCallback | undefined}"
@@ -463,7 +455,7 @@
             {
               "kind": "field",
               "name": "disableTogglingLegendItems",
-              "description": "Disables the toggling of series via the legend items.",
+              "description": "Disables the toggling of series via the legend items.\n\n**Note**: Only applicable to multi-series charts.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -475,10 +467,6 @@
               "default": "undefined",
               "attribute": "disable-toggling-legend-items",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Only applicable to multi-series charts."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -615,7 +603,7 @@
             {
               "kind": "method",
               "name": "exportAsCSV",
-              "description": "Export the current chart's data as a CSV file.",
+              "description": "Export the current chart's data as a CSV file.\n\nThe `Options` object can contain the following properties:\n- `columns`: An array of column to include in the CSV file.\n- `delimiter`: The delimiter to use in the CSV file. Default is `,`.\n- `includeHeader`: Whether to include the header row in the CSV file. Default is `true`.\n- `quoteAll`: Whether to quote all values in the CSV file. Default is `false`.\n- `locale`: The locale to use when formatting the CSV file. Default is `en`.\n   * * Locale supported are: \"ar\", \"ar-u-nu-latn\", \"bs\", \"bg\", \"ca\", \"cs\", \"da\", \"de\", \"el\", \"en\", \"en-US\", \"es\", \"et\", \"fi\", \"fr\", \"he\", \"hr\", \"hu\", \"id\", \"it\", \"ja\", \"ko\", \"lt\", \"lv\", \"no\", \"nl\", \"pl\", \"pt-BR\", \"pt-PT\", \"ro\", \"ru\", \"sr\", \"sl\", \"sk\", \"sv\", \"th\", \"tr\", \"uk\", \"vi\", \"zh-CN\", \"zh-HK\", \"zh-TW\"\n\n**Note**: The chart types supported by this method are:\n- Bar chart\n- Box plot\n- Combo bar and line chart\n- Histogram\n- Line chart\n- Pie chart",
               "parameters": [
                 {
                   "name": "options",
@@ -658,7 +646,7 @@
               "docsTags": [
                 {
                   "name": "param",
-                  "text": "options The options to use when exporting the data.\n\nNOTE: This method won't work for scatterplot series. The support charts for this method are:\n- Bar chart\n- Line chart\n- Combo bar-line chart\n- Box plot\n- Histogram\n- Pie chart\n\nThe `Options` object can contain the following properties:\n- `columns` - An array of column to include in the CSV file.\n- `delimiter` - The delimiter to use in the CSV file. Default is `,`.\n- `includeHeader` - Whether to include the header row in the CSV file. Default is `true`.\n- `quoteAll` - Whether to quote all values in the CSV file. Default is `false`.\n- `locale` - The locale to use when formatting the CSV file. Default is `en`.\n* * Locale supported are: \"ar\", \"ar-u-nu-latn\", \"bs\", \"bg\", \"ca\", \"cs\", \"da\", \"de\", \"el\", \"en\", \"en-US\", \"es\", \"et\", \"fi\", \"fr\", \"he\", \"hr\", \"hu\", \"id\", \"it\", \"ja\", \"ko\", \"lt\", \"lv\", \"no\", \"nl\", \"pl\", \"pt-BR\", \"pt-PT\", \"ro\", \"ru\", \"sr\", \"sl\", \"sk\", \"sv\", \"th\", \"tr\", \"uk\", \"vi\", \"zh-CN\", \"zh-HK\", \"zh-TW\""
+                  "text": "options The options to use when exporting the data."
                 },
                 {
                   "name": "category",
@@ -670,7 +658,7 @@
             {
               "kind": "method",
               "name": "exportAsImage",
-              "description": "Export the current chart as an image.",
+              "description": "Exports the current chart as an image. The default format is PNG, with SVG and JPEG available as alternatives.",
               "parameters": [
                 {
                   "name": "format",
@@ -723,7 +711,7 @@
             {
               "kind": "field",
               "name": "featureIndex",
-              "description": "The index of the feature to be rendered.\nOnly used when the gauge is a feature-based gauge.",
+              "description": "The index of the feature to render when using a feature based gauge.\n\n**Note**: Only applicable to gauge.",
               "type": {
                 "text": "number",
                 "values": [
@@ -736,10 +724,6 @@
               "deprecated": "since 5.0. Use charts model's [featureIndex](https://developers.arcgis.com/javascript/latest/charts-model/gauge-model/#featureindex) prop instead.",
               "attribute": "feature-index",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to gauge only."
-                },
                 {
                   "name": "type",
                   "text": "{number | undefined}"
@@ -753,7 +737,7 @@
             {
               "kind": "field",
               "name": "filterByExtent",
-              "description": "When `true`, all chart elements are filtered based on view extent.",
+              "description": "When `true`, all chart elements are filtered based on the view extent.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -778,7 +762,7 @@
             {
               "kind": "field",
               "name": "filterBySelection",
-              "description": "When `true`, all chart elements are filtered based on selection.",
+              "description": "When `true`, all chart elements are filtered based on the selection.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -790,10 +774,6 @@
               "default": "undefined",
               "attribute": "filter-by-selection",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -807,16 +787,12 @@
             {
               "kind": "field",
               "name": "gaugeInnerLabelFormatter",
-              "description": "A callback function used to format the gauge inner label. If the returned string contains HTML tags they will be\ninterpreted as such.",
+              "description": "A callback function used to format the gauge inner label. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Applicable to gauge only.",
               "type": {
                 "text": "(((value?: number | undefined) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to gauge only."
-                },
                 {
                   "name": "type",
                   "text": "{GaugeInnerLabelFormatCallback | undefined}"
@@ -830,16 +806,12 @@
             {
               "kind": "field",
               "name": "guideTooltipFormatter",
-              "description": "A callback function used to format the axes guides tooltip. If the returned string contains HTML tags they will be interpreted as such.",
+              "description": "A callback function used to format the axes guides tooltip. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Not applicable to pie chart.",
               "type": {
                 "text": "(((props: GuideTooltipFormatCallbackProps) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to pie chart."
-                },
                 {
                   "name": "type",
                   "text": "{GuideTooltipFormatCallback | undefined}"
@@ -853,7 +825,7 @@
             {
               "kind": "field",
               "name": "hideEmptySeries",
-              "description": "When `true`, the empty series are completely hidden from the chart and the legend.\nFor example a series can be empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).",
+              "description": "When `true`, the empty series are completely hidden from the chart and the legend.\nFor example, a series may become empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -865,10 +837,6 @@
               "default": "undefined",
               "attribute": "hide-empty-series",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -932,7 +900,7 @@
             {
               "kind": "field",
               "name": "ignoreSmoothRenderingLimit",
-              "description": "When `true`, disables the default setting that uses debounce functions to handle the visibility of markers\nthat are outside of the plotting area when the min/max bound changes and/or when a zoom action is performed\n(via chart cursor or scrollbar), to increase performance.\nThis property will be set when the chart is created and cannot be updated after that.\nIt's recommended that this property should only be set to true for small datasets.\nWhen left `undefined`, will be treated as `false`.",
+              "description": "When `true`, disables the default setting that uses debounce functions to handle the visibility of markers\nthat are outside of the plotting area when the min/max bound changes and/or when a zoom action is performed\n(via chart cursor or scrollbar), to increase performance.\nThis property will be set when the chart is created and cannot be updated after that.\nIt's recommended that this property should only be set to true for small datasets.\nWhen left `undefined`, will be treated as `false`.\n\n**Note**: Applicable to line chart only.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -944,10 +912,6 @@
               "default": "undefined",
               "attribute": "ignore-smooth-rendering-limit",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to line chart only."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1116,7 +1080,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "<arcgis-chart layer-item-id=\"05e015c5f0314db9a487a9b46cb37eca\" chart-index=\"2\"></arcgis-chart>"
+                  "text": "```html\n<arcgis-chart layer-item-id=\"8871626e970a4f3e9d6113ec63a92f2f\" chart-index=\"2\"></arcgis-chart>\n```"
                 },
                 {
                   "name": "type",
@@ -1131,7 +1095,7 @@
             {
               "kind": "field",
               "name": "layerRendererChangePolicy",
-              "description": "Allows the chart to update automatically when the layer's renderer changes.\nApplies when the color match feature is enabled.",
+              "description": "Allows the chart to update automatically when the layer's renderer changes.\nApplies when the color match feature is enabled.\n\n**Note**: If the property is set to `ignore` the chart will use the layer's renderer information when the data is updated.",
               "type": {
                 "text": "\"ignore\" | \"refresh\"",
                 "values": [
@@ -1148,10 +1112,6 @@
               "default": "\"refresh\"",
               "attribute": "layer-renderer-change-policy",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Even though that property is set to Ignore the chart will use the layer's renderer information when the data is updated."
-                },
                 {
                   "name": "type",
                   "text": "{LayerRendererChangePolicy}"
@@ -1165,7 +1125,7 @@
             {
               "kind": "field",
               "name": "legendPosition",
-              "description": "Used to set the legend's position on the chart.",
+              "description": "Sets the legend's position on the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"bottom\" | \"left\" | \"right\" | \"top\"",
                 "values": [
@@ -1191,10 +1151,6 @@
               "deprecated": "since 5.0. Use charts model's [legendPosition](https://developers.arcgis.com/javascript/latest/charts-model/bar-chart-model/#legendPosition) prop instead.",
               "attribute": "legend-position",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{WebChartLegendPositions | undefined}"
@@ -1208,16 +1164,12 @@
             {
               "kind": "field",
               "name": "legendValueLabelFormatter",
-              "description": "A callback function used to format the legend value labels. If the returned string contains HTML tags they will be\ninterpreted as such.\nIf provided, the formatter will be used if at least `WebChartPieChartLegend.displayNumericValue` or `WebChartPieChartLegend.displayPercentage` is true.",
+              "description": "A callback function used to format the legend value labels. If the returned string contains HTML tags they will be interpreted as such.\nIf provided, the formatter will be used if at least `WebChartPieChartLegend.displayNumericValue` or `WebChartPieChartLegend.displayPercentage` is true.\n\n**Note**: Applicable to pie chart only.",
               "type": {
                 "text": "(((value?: number | undefined, percent?: number | undefined) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to pie chart only."
-                },
                 {
                   "name": "type",
                   "text": "{PieChartLegendValueLabelFormatCallback | undefined}"
@@ -1231,7 +1183,7 @@
             {
               "kind": "field",
               "name": "legendVisibility",
-              "description": "When `true`, the legend is visible on the chart.",
+              "description": "When `true`, the legend is visible on the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1244,10 +1196,6 @@
               "deprecated": "since 5.0. Use charts model's [legendVisibility](https://developers.arcgis.com/javascript/latest/charts-model/bar-chart-model/#legendVisibility) prop instead.",
               "attribute": "legend-visibility",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1330,7 +1278,7 @@
             {
               "kind": "field",
               "name": "model",
-              "description": "Instance of an ArcGIS Chart Model. Provides an API to interact with the chart's configuration.\n**Note:** This property has a union type of `ChartModel | WebChart` meaning a raw chart config object can be passed to it instead, however it is recommended to use a `ChartModel` instance whenever possible.",
+              "description": "Provides an API to interact with the chart's configuration.\n\n**Note:** This property has a union type of `ChartModel | WebChart` meaning a raw chart config object can be passed to it instead, however it is recommended to use a `ChartModel` instance whenever possible.",
               "type": {
                 "text": "ChartModel | WebChart",
                 "references": [
@@ -1367,7 +1315,7 @@
             {
               "kind": "method",
               "name": "notify",
-              "description": "Notify method allows passing external messages to the chart component.\nIt can be used to pass validation or information messages.\nIn a situation where a config update is overriding your notification modal,\nconsider waiting for the `arcgisUpdateComplete` event.",
+              "description": "Notify method allows passing external messages to the chart component.\nIt can be used to pass validation or information messages.\nIn a situation where a config update is overriding your notification modal, consider waiting for the `arcgisUpdateComplete` event.",
               "parameters": [
                 {
                   "name": "message",
@@ -1460,7 +1408,7 @@
             {
               "kind": "field",
               "name": "nullAsValid",
-              "description": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only\nnull values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
+              "description": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only null values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1611,7 +1559,7 @@
             {
               "kind": "method",
               "name": "resetZoom",
-              "description": "Resets the chart zoom to bring it back to full extent",
+              "description": "Resets the chart zoom to bring it back to full extent\n\n**Note**: Applicable to XY charts only.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -1627,10 +1575,6 @@
                 }
               },
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Applicable to XY charts only."
-                },
                 {
                   "name": "category",
                   "text": "Public"
@@ -1641,7 +1585,7 @@
             {
               "kind": "field",
               "name": "returnFeaturesExtent",
-              "description": "When `true`, the features extent will be returned through the `arcgisDataProcessComplete` and `arcgisSelectionComplete` events payload.\nApplies only to:\n- charts using an aggregation\n- data source using a feature layer compatible with envelope aggregation\nThe extent (IExtent) is returned through a property called `arcgis_charts_features_extent`.",
+              "description": "When `true`, the features extent will be returned through the `arcgisDataProcessComplete` and `arcgisSelectionComplete` events payload.\nApplies only to:\n- charts using an aggregation\n- data source using a feature layer compatible with envelope aggregation\nThe extent (IExtent) is returned through a property called `arcgis_charts_features_extent`.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1653,10 +1597,6 @@
               "default": "undefined",
               "attribute": "return-features-extent",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1670,7 +1610,7 @@
             {
               "kind": "field",
               "name": "returnSelectionIndexes",
-              "description": "When `true`, the selection indexes will be computed whenever a selection is made on or passed to the chart.",
+              "description": "When `true`, the selection indexes will be computed whenever a selection is made on or passed to the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1682,10 +1622,6 @@
               "default": "undefined",
               "attribute": "return-selection-indexes",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1699,7 +1635,7 @@
             {
               "kind": "field",
               "name": "returnSelectionOIDs",
-              "description": "When `true`, the object ids will be computed whenever a selection is made on or passed to the chart.\nOnly considered for a data source using a feature layer.",
+              "description": "When `true`, the object ids will be computed whenever a selection is made on or passed to the chart.\nOnly considered for a data source using a feature layer.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1711,10 +1647,6 @@
               "default": "undefined",
               "attribute": "return-selection-oi-ds",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1728,7 +1660,7 @@
             {
               "kind": "field",
               "name": "rotation",
-              "description": "Applicable to bar chart, line chart, combo bar-line and box plot.\nWhen `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.",
+              "description": "When `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.\n\n**Note**: Applicable to bar chart, line chart, combo bar and line chart and box plot.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1754,7 +1686,7 @@
             {
               "kind": "field",
               "name": "runtimeDataFilters",
-              "description": "Applies runtime data filters to the chart's.",
+              "description": "Applies runtime data filters to the chart.",
               "type": {
                 "text": "{\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IPoint | IPolyline | IPolygon | IPolygonWithCurves | IEnvelope | IExtent | undefined;\n    objectIds?: Array<string | number> | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}"
               },
@@ -1773,16 +1705,12 @@
             {
               "kind": "field",
               "name": "secondaryYAxisLabelFormatter",
-              "description": "A callback function used to format the secondary y-axis labels. If the returned string contains HTML tags they will be interpreted as such.\nThe property will be effective only if 3 axes are defined (dual axis chart).",
+              "description": "A callback function used to format the secondary y-axis labels. If the returned string contains HTML tags they will be interpreted as such.\nThe property will be effective only if 3 axes are defined (dual axis chart).\n\n**Note**: Not applicable to pie chart or gauge.",
               "type": {
                 "text": "(((value: string | number | Date | null, originalValue?: WebChartDataItemValue) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to pie chart nor gauge."
-                },
                 {
                   "name": "type",
                   "text": "{AxisLabelFormatCallback | undefined}"
@@ -1796,7 +1724,7 @@
             {
               "kind": "field",
               "name": "selectionData",
-              "description": "When this property is set, it will apply a selection on the chart matching the provided selection.",
+              "description": "When this property is set, it will apply a selection on the chart matching the provided selection.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "SelectionData",
                 "references": [
@@ -1810,10 +1738,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{SelectionData | undefined}"
@@ -1827,7 +1751,7 @@
             {
               "kind": "field",
               "name": "selectionTheme",
-              "description": "Used to provide a customized theme for the selected and non selected elements.\nIf no style is provided for the selected elements, a default selection is applied.\nIf no style is provided for the non selected elements, the chart's style is applied.",
+              "description": "Used to provide a customized theme for the selected and non selected elements.\nIf no style is provided for the selected elements, a default selection is applied.\nIf no style is provided for the non selected elements, the chart's style is applied.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "SelectionTheme",
                 "references": [
@@ -1841,10 +1765,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{SelectionTheme | undefined}"
@@ -1858,7 +1778,7 @@
             {
               "kind": "field",
               "name": "setTimeBinningInfoWhenNotProvided",
-              "description": "When `true`, the series properties `unit` and `size` become optional and will be automatically set to values that fit the data set. Used when creating or updating a chart compatible with time binning.",
+              "description": "When `true`, the series properties `unit` and `size` become optional and will be automatically set to values that fit the data set. Used when creating or updating a chart compatible with time binning.\n\n**Note**: Only applicable to charts using the temporal binning feature (bar chart, line chart, combo bar and line chart, radar chart).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1870,10 +1790,6 @@
               "default": "undefined",
               "attribute": "set-time-binning-info-when-not-provided",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Only applicable to charts using the temporal binning feature (bar and line chart)."
-                },
                 {
                   "name": "type",
                   "text": "{boolean | undefined}"
@@ -1887,7 +1803,7 @@
             {
               "kind": "field",
               "name": "showUIMessages",
-              "description": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an\naxis when the data contains values <= 0).",
+              "description": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an axis when the data contains values <= 0).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -1912,7 +1828,7 @@
             {
               "kind": "method",
               "name": "switchSelection",
-              "description": "Switches the selection on the chart.",
+              "description": "Switches the selection on the chart.\n\n**Note**: Not applicable to gauge.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -1928,10 +1844,6 @@
                 }
               },
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "category",
                   "text": "Public"
@@ -2022,7 +1934,7 @@
             {
               "kind": "field",
               "name": "tooltipFormatter",
-              "description": "A callback function used to format the tooltips. If the returned string contains HTML tags they will be interpreted as such.",
+              "description": "A callback function used to format the tooltips. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
                 "values": [
@@ -2045,10 +1957,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to gauge."
-                },
                 {
                   "name": "type",
                   "text": "{BarAndLineTooltipFormatCallback | undefined}"
@@ -2062,7 +1970,7 @@
             {
               "kind": "field",
               "name": "updateSplitBySeries",
-              "description": "Whether to update the series when the data updates while the chart uses a split-by field configuration.\nIf `addMissingSeries` is set to `true` the missing series will be added to cover the split-by values not referenced\nby the config.\nThe default information from the property `updateSplitBySeries.seriesTemplate` will be applied to the new series.",
+              "description": "Whether to update the series when the data updates while the chart uses a split-by field configuration.\nIf `addMissingSeries` is set to `true` the missing series will be added to cover the split-by values not referenced by the config.\nThe default information from the property `updateSplitBySeries.seriesTemplate` will be applied to the new series.\n\n**Note**: Applicable only to bar chart, line chart and box plot when a split-by field is used.",
               "type": {
                 "text": "MissingSplitBySeriesProps",
                 "references": [
@@ -2076,10 +1984,6 @@
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Only applicable to bar chart, line chart and box plot, when they use a split-by field."
-                },
                 {
                   "name": "type",
                   "text": "{MissingSplitBySeriesProps | undefined}"
@@ -2143,7 +2047,7 @@
             {
               "kind": "field",
               "name": "view",
-              "description": "Used to access the LayerView instance in order to perform client-side queries.",
+              "description": "Used to access the feature layer view instance in order to perform client side queries.",
               "type": {
                 "text": "MapView | SceneView",
                 "references": [
@@ -2188,7 +2092,7 @@
             {
               "kind": "field",
               "name": "viewTimeExtentChangePolicy",
-              "description": "Whether the chart should be refreshed when the view's time extent changes.\nThis is not currently supported on histogram. Setting the property to \"refresh\" won't have any effect on that chart.",
+              "description": "Whether the chart should be refreshed when the view's time extent changes.\n\n**Note**: Not supported for histogram.",
               "type": {
                 "text": "\"ignore\" | \"refresh\"",
                 "values": [
@@ -2218,16 +2122,12 @@
             {
               "kind": "field",
               "name": "xAxisLabelFormatter",
-              "description": "Indicates whether to show the ArcGIS charts notify panel. False by default\nA callback function used to format the x-axis labels. If the returned string contains HTML tags they will be interpreted as such.",
+              "description": "Indicates whether to show the ArcGIS charts notify panel. False by default\nA callback function used to format the x-axis labels. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Not applicable to pie chart.",
               "type": {
                 "text": "(((value: string | number | Date | null, originalValue?: WebChartDataItemValue) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to pie chart."
-                },
                 {
                   "name": "type",
                   "text": "{AxisLabelFormatCallback | undefined}"
@@ -2241,16 +2141,12 @@
             {
               "kind": "field",
               "name": "yAxisLabelFormatter",
-              "description": "A callback function used to format the y-axis labels. If the returned string contains HTML tags they will be interpreted as such.",
+              "description": "A callback function used to format the y-axis labels. If the returned string contains HTML tags they will be interpreted as such.\n\n**Note**: Not applicable to pie chart or gauge.",
               "type": {
                 "text": "(((value: string | number | Date | null, originalValue?: WebChartDataItemValue) => string))"
               },
               "default": "undefined",
               "docsTags": [
-                {
-                  "name": "remarks",
-                  "text": "Not applicable to pie chart nor gauge."
-                },
                 {
                   "name": "type",
                   "text": "{AxisLabelFormatCallback | undefined}"
@@ -2265,7 +2161,7 @@
           "attributes": [
             {
               "name": "action-mode",
-              "description": "Not applicable to gauge.\nDefines the cursor behavior on the chart (zoom, selection...).",
+              "description": "Specifies the user action behavior for the chart.\n\n- `monoSelection`: Select a single data point or series, new selection replaces the previous one.\n- `multiSelection`: Select multiple data points or series, new selection adds to the previous one.\n- `multiSelectionWithCtrlKey`: Select multiple data points or series while holding the Ctrl key (Cmd on Mac). When the key is held, each new selection is added; otherwise, the selection is replaced.\n- `none`: No action is performed on user interaction.\n- `zoom`: Zoom into a specific area of the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"monoSelection\" | \"multiSelection\" | \"multiSelectionWithCtrlKey\" | \"none\" | \"zoom\"",
                 "values": [
@@ -2291,12 +2187,12 @@
                   }
                 ]
               },
-              "default": "undefined",
+              "default": "multiSelectionWithCtrlKey",
               "fieldName": "actionMode"
             },
             {
               "name": "allow-using-object-id-stat",
-              "description": "Whether to allow the object id to be used as a statistic other than COUNT.",
+              "description": "Whether to allow the object id to be used as a statistic other than `COUNT`.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2324,7 +2220,7 @@
             },
             {
               "name": "auto-dispose-chart",
-              "description": "Auto-disposes the chart when a new one is created in the same container.",
+              "description": "Auto disposes the chart when a new one is created in the same container.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2335,11 +2231,11 @@
               },
               "default": "undefined",
               "fieldName": "autoDisposeChart",
-              "deprecated": "since 5.0. Use `autoDestroyDisabled` instead. Will be removed in 6.0."
+              "deprecated": "since 5.0. Use [autoDestroyDisabled](https://developers.arcgis.com/javascript/latest/references/charts-components/arcgis-chart/#autoDestroyDisabled)instead."
             },
             {
               "name": "auto-inverse-data-label-text-color",
-              "description": "When `true`, the data label text color is automatically inverted based on the data label background color.\nFor example if the data label is dark, and it's on top of a dark color series area, the text color will eventually\nbe set to either the chart's background color or white.",
+              "description": "When `true`, the data label text color is automatically adjusted for readability based on its background.\nIf the label is dark and appears over a dark series area, the text color is switched to either the chart background color or white.\n\n**Note**: Only applicable to bar chart.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2367,7 +2263,7 @@
             },
             {
               "name": "cursor-range",
-              "description": "Sets the cursor range:\n- CursorRange.MultiAxes: allows to draw a free rectangle\n- CursorRange.XAxis: allows to draw a rectangle bound to the x-axis\n- CursorRange.YAxis: allows to draw a rectangle bound to the y-axis\n- undefined: defaults to a preset behavior according to the chart type and action mode",
+              "description": "Sets the cursor range when `actionMode` is set to `zoom`, `multiSelection` or `multiSelectionWithCtrlKey`.\n\n- `multi-axes`: Allows to draw a free rectangle.\n- `x-axis`: Allows to draw a rectangle bound to the x-axis.\n- `y-axis`: Allows to draw a rectangle bound to the y-axis.\n- `undefined`: Defaults to the preset behavior according to the chart type and action mode.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"multi-axes\" | \"x-axis\" | \"y-axis\"",
                 "values": [
@@ -2404,7 +2300,7 @@
             },
             {
               "name": "disable-toggling-legend-items",
-              "description": "Disables the toggling of series via the legend items.",
+              "description": "Disables the toggling of series via the legend items.\n\n**Note**: Only applicable to multi-series charts.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2465,7 +2361,7 @@
             },
             {
               "name": "feature-index",
-              "description": "The index of the feature to be rendered.\nOnly used when the gauge is a feature-based gauge.",
+              "description": "The index of the feature to render when using a feature based gauge.\n\n**Note**: Only applicable to gauge.",
               "type": {
                 "text": "number",
                 "values": [
@@ -2480,7 +2376,7 @@
             },
             {
               "name": "filter-by-extent",
-              "description": "When `true`, all chart elements are filtered based on view extent.",
+              "description": "When `true`, all chart elements are filtered based on the view extent.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2494,7 +2390,7 @@
             },
             {
               "name": "filter-by-selection",
-              "description": "When `true`, all chart elements are filtered based on selection.",
+              "description": "When `true`, all chart elements are filtered based on the selection.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2508,7 +2404,7 @@
             },
             {
               "name": "hide-empty-series",
-              "description": "When `true`, the empty series are completely hidden from the chart and the legend.\nFor example a series can be empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).",
+              "description": "When `true`, the empty series are completely hidden from the chart and the legend.\nFor example, a series may become empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2550,7 +2446,7 @@
             },
             {
               "name": "ignore-smooth-rendering-limit",
-              "description": "When `true`, disables the default setting that uses debounce functions to handle the visibility of markers\nthat are outside of the plotting area when the min/max bound changes and/or when a zoom action is performed\n(via chart cursor or scrollbar), to increase performance.\nThis property will be set when the chart is created and cannot be updated after that.\nIt's recommended that this property should only be set to true for small datasets.\nWhen left `undefined`, will be treated as `false`.",
+              "description": "When `true`, disables the default setting that uses debounce functions to handle the visibility of markers\nthat are outside of the plotting area when the min/max bound changes and/or when a zoom action is performed\n(via chart cursor or scrollbar), to increase performance.\nThis property will be set when the chart is created and cannot be updated after that.\nIt's recommended that this property should only be set to true for small datasets.\nWhen left `undefined`, will be treated as `false`.\n\n**Note**: Applicable to line chart only.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2630,7 +2526,7 @@
             },
             {
               "name": "layer-renderer-change-policy",
-              "description": "Allows the chart to update automatically when the layer's renderer changes.\nApplies when the color match feature is enabled.",
+              "description": "Allows the chart to update automatically when the layer's renderer changes.\nApplies when the color match feature is enabled.\n\n**Note**: If the property is set to `ignore` the chart will use the layer's renderer information when the data is updated.",
               "type": {
                 "text": "\"ignore\" | \"refresh\"",
                 "values": [
@@ -2649,7 +2545,7 @@
             },
             {
               "name": "legend-position",
-              "description": "Used to set the legend's position on the chart.",
+              "description": "Sets the legend's position on the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "\"bottom\" | \"left\" | \"right\" | \"top\"",
                 "values": [
@@ -2677,7 +2573,7 @@
             },
             {
               "name": "legend-visibility",
-              "description": "When `true`, the legend is visible on the chart.",
+              "description": "When `true`, the legend is visible on the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2692,7 +2588,7 @@
             },
             {
               "name": "null-as-valid",
-              "description": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only\nnull values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
+              "description": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only null values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2748,7 +2644,7 @@
             },
             {
               "name": "return-features-extent",
-              "description": "When `true`, the features extent will be returned through the `arcgisDataProcessComplete` and `arcgisSelectionComplete` events payload.\nApplies only to:\n- charts using an aggregation\n- data source using a feature layer compatible with envelope aggregation\nThe extent (IExtent) is returned through a property called `arcgis_charts_features_extent`.",
+              "description": "When `true`, the features extent will be returned through the `arcgisDataProcessComplete` and `arcgisSelectionComplete` events payload.\nApplies only to:\n- charts using an aggregation\n- data source using a feature layer compatible with envelope aggregation\nThe extent (IExtent) is returned through a property called `arcgis_charts_features_extent`.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2762,7 +2658,7 @@
             },
             {
               "name": "return-selection-indexes",
-              "description": "When `true`, the selection indexes will be computed whenever a selection is made on or passed to the chart.",
+              "description": "When `true`, the selection indexes will be computed whenever a selection is made on or passed to the chart.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2776,7 +2672,7 @@
             },
             {
               "name": "return-selection-oi-ds",
-              "description": "When `true`, the object ids will be computed whenever a selection is made on or passed to the chart.\nOnly considered for a data source using a feature layer.",
+              "description": "When `true`, the object ids will be computed whenever a selection is made on or passed to the chart.\nOnly considered for a data source using a feature layer.\n\n**Note**: Not applicable to gauge.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2790,7 +2686,7 @@
             },
             {
               "name": "rotation",
-              "description": "Applicable to bar chart, line chart, combo bar-line and box plot.\nWhen `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.",
+              "description": "When `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.\n\n**Note**: Applicable to bar chart, line chart, combo bar and line chart and box plot.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2805,7 +2701,7 @@
             },
             {
               "name": "set-time-binning-info-when-not-provided",
-              "description": "When `true`, the series properties `unit` and `size` become optional and will be automatically set to values that fit the data set. Used when creating or updating a chart compatible with time binning.",
+              "description": "When `true`, the series properties `unit` and `size` become optional and will be automatically set to values that fit the data set. Used when creating or updating a chart compatible with time binning.\n\n**Note**: Only applicable to charts using the temporal binning feature (bar chart, line chart, combo bar and line chart, radar chart).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2819,7 +2715,7 @@
             },
             {
               "name": "show-ui-messages",
-              "description": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an\naxis when the data contains values <= 0).",
+              "description": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an axis when the data contains values <= 0).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -2908,7 +2804,7 @@
             },
             {
               "name": "view-time-extent-change-policy",
-              "description": "Whether the chart should be refreshed when the view's time extent changes.\nThis is not currently supported on histogram. Setting the property to \"refresh\" won't have any effect on that chart.",
+              "description": "Whether the chart should be refreshed when the view's time extent changes.\n\n**Note**: Not supported for histogram.",
               "type": {
                 "text": "\"ignore\" | \"refresh\"",
                 "values": [
@@ -3238,7 +3134,7 @@
           "customElement": true,
           "name": "ArcgisChartsActionBar",
           "tagName": "arcgis-charts-action-bar",
-          "description": "The ArcGIS Charts Action Bar component enhances chart functionality by providing context-specific actions such as rotation, zooming, and filtering, as well as general actions like exporting the chart as an image or CSV file.\nThis component is designed to be used with a chart component and is not intended for standalone use.\n\nSee also:\n- [Tutorial: Chart and map interactions](https://developers.arcgis.com/javascript/latest/tutorials/chart-and-map-interactions/)",
+          "description": "The Charts Action Bar component provides context-specific actions such as rotation, zooming, and filtering, as well as general actions like exporting the chart as an image or CSV file.\nThis component is designed to be used with a chart component and is not intended for standalone use.",
           "demos": [
             {
               "description": "Docs",
@@ -3250,6 +3146,10 @@
             }
           ],
           "docsTags": [
+            {
+              "name": "see",
+              "text": "[Tutorial: Chart and map interactions](https://developers.arcgis.com/javascript/latest/tutorials/chart-and-map-interactions/)"
+            },
             {
               "name": "since",
               "text": "4.29"
@@ -3265,7 +3165,7 @@
             {
               "kind": "field",
               "name": "actionBarSelectionMode",
-              "description": "Action bar selection mode. Defines which selection mode the slotted action bar should use.",
+              "description": "Defines which selection mode the slotted action bar should use.\n- `monoSelection`: Select a single data point/series, new selection replaces the previous one.\n- `multiSelection`: Select multiple data points/series, new selection adds to the previous one.\n- `multiSelectionWithCtrlKey`: Select multiple data points/series while holding the Ctrl key (Cmd key on Mac), new selection adds to the previous one.",
               "type": {
                 "text": "\"monoSelection\" | \"multiSelection\" | \"multiSelectionWithCtrlKey\"",
                 "values": [
@@ -3389,7 +3289,7 @@
             {
               "kind": "field",
               "name": "clearSelectionState",
-              "description": "When disabled, interaction with the clear selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the clear selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3444,7 +3344,7 @@
             {
               "kind": "field",
               "name": "clearSelectionToggle",
-              "description": "When active, the clear selection action is highlighted.",
+              "description": "When `active`, the clear selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -3532,7 +3432,7 @@
             {
               "kind": "field",
               "name": "editChartState",
-              "description": "When disabled, interaction with the edit chart action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the edit chart action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3587,7 +3487,7 @@
             {
               "kind": "field",
               "name": "editChartToggle",
-              "description": "When active, the edit chart action is highlighted.",
+              "description": "When `active`, the edit chart action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -3642,7 +3542,7 @@
             {
               "kind": "field",
               "name": "exportActionState",
-              "description": "When disabled, interaction with the export action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the export action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3672,7 +3572,7 @@
             {
               "kind": "field",
               "name": "exportAsCSVState",
-              "description": "When disabled, interaction with the download CSV is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the download CSV is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3727,7 +3627,7 @@
             {
               "kind": "field",
               "name": "exportAsImageState",
-              "description": "When disabled, interaction with the download image is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the download image is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3782,7 +3682,7 @@
             {
               "kind": "field",
               "name": "filterByExtentState",
-              "description": "When disabled, interaction with the filter by extent action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the filter by extent action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3837,7 +3737,7 @@
             {
               "kind": "field",
               "name": "filterByExtentToggle",
-              "description": "When active, the filter by extent action is highlighted.",
+              "description": "When `active`, the filter by extent action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -3867,7 +3767,7 @@
             {
               "kind": "field",
               "name": "filterBySelectionState",
-              "description": "When disabled, interaction with the filter by selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the filter by selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -3922,7 +3822,7 @@
             {
               "kind": "field",
               "name": "filterBySelectionToggle",
-              "description": "When active, the filter by selection action is highlighted.",
+              "description": "When `active`, the filter by selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -3973,7 +3873,7 @@
             {
               "kind": "field",
               "name": "fullExtentState",
-              "description": "When disabled, interaction with the full extent action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the full extent action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4028,7 +3928,7 @@
             {
               "kind": "field",
               "name": "fullExtentToggle",
-              "description": "When active, the full extent action is highlighted.",
+              "description": "When `active`, the full extent action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4086,7 +3986,7 @@
             {
               "kind": "field",
               "name": "legendState",
-              "description": "When disabled, interaction with the legend action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the legend action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4141,7 +4041,7 @@
             {
               "kind": "field",
               "name": "legendToggle",
-              "description": "When active, the legend action is highlighted.",
+              "description": "When `active`, the legend action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4179,7 +4079,7 @@
             {
               "kind": "field",
               "name": "rotateChartState",
-              "description": "When disabled, interaction with the rotate chart action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the rotate chart action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4234,7 +4134,7 @@
             {
               "kind": "field",
               "name": "rotateChartToggle",
-              "description": "When active, the rotate chart action is highlighted.",
+              "description": "When `active`, the rotate chart action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4264,7 +4164,7 @@
             {
               "kind": "field",
               "name": "selectionState",
-              "description": "When disabled, interaction with the selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4319,7 +4219,7 @@
             {
               "kind": "field",
               "name": "selectionToggle",
-              "description": "When active, the selection action is highlighted.",
+              "description": "When `active`, the selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4349,7 +4249,7 @@
             {
               "kind": "field",
               "name": "switchSelectionState",
-              "description": "When disabled, interaction with the switch selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the switch selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4404,7 +4304,7 @@
             {
               "kind": "field",
               "name": "switchSelectionToggle",
-              "description": "When active, the switch selection action is highlighted.",
+              "description": "When `active`, the switch selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4434,7 +4334,7 @@
             {
               "kind": "field",
               "name": "zoomState",
-              "description": "When disabled, interaction with the zoom action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the zoom action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4489,7 +4389,7 @@
             {
               "kind": "field",
               "name": "zoomToggle",
-              "description": "When active, the zoom action is highlighted.",
+              "description": "When `active`, the zoom action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4520,7 +4420,7 @@
           "attributes": [
             {
               "name": "action-bar-selection-mode",
-              "description": "Action bar selection mode. Defines which selection mode the slotted action bar should use.",
+              "description": "Defines which selection mode the slotted action bar should use.\n- `monoSelection`: Select a single data point/series, new selection replaces the previous one.\n- `multiSelection`: Select multiple data points/series, new selection adds to the previous one.\n- `multiSelectionWithCtrlKey`: Select multiple data points/series while holding the Ctrl key (Cmd key on Mac), new selection adds to the previous one.",
               "type": {
                 "text": "\"monoSelection\" | \"multiSelection\" | \"multiSelectionWithCtrlKey\"",
                 "values": [
@@ -4594,7 +4494,7 @@
             },
             {
               "name": "clear-selection-state",
-              "description": "When disabled, interaction with the clear selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the clear selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4627,7 +4527,7 @@
             },
             {
               "name": "clear-selection-toggle",
-              "description": "When active, the clear selection action is highlighted.",
+              "description": "When `active`, the clear selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4646,7 +4546,7 @@
             },
             {
               "name": "edit-chart-state",
-              "description": "When disabled, interaction with the edit chart action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the edit chart action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4679,7 +4579,7 @@
             },
             {
               "name": "edit-chart-toggle",
-              "description": "When active, the edit chart action is highlighted.",
+              "description": "When `active`, the edit chart action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4712,7 +4612,7 @@
             },
             {
               "name": "export-action-state",
-              "description": "When disabled, interaction with the export action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the export action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4731,7 +4631,7 @@
             },
             {
               "name": "export-as-csv-state",
-              "description": "When disabled, interaction with the download CSV is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the download CSV is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4764,7 +4664,7 @@
             },
             {
               "name": "export-as-image-state",
-              "description": "When disabled, interaction with the download image is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the download image is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4797,7 +4697,7 @@
             },
             {
               "name": "filter-by-extent-state",
-              "description": "When disabled, interaction with the filter by extent action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the filter by extent action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4830,7 +4730,7 @@
             },
             {
               "name": "filter-by-extent-toggle",
-              "description": "When active, the filter by extent action is highlighted.",
+              "description": "When `active`, the filter by extent action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4849,7 +4749,7 @@
             },
             {
               "name": "filter-by-selection-state",
-              "description": "When disabled, interaction with the filter by selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the filter by selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4882,7 +4782,7 @@
             },
             {
               "name": "filter-by-selection-toggle",
-              "description": "When active, the filter by selection action is highlighted.",
+              "description": "When `active`, the filter by selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4915,7 +4815,7 @@
             },
             {
               "name": "full-extent-state",
-              "description": "When disabled, interaction with the full extent action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the full extent action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -4948,7 +4848,7 @@
             },
             {
               "name": "full-extent-toggle",
-              "description": "When active, the full extent action is highlighted.",
+              "description": "When `active`, the full extent action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -4967,7 +4867,7 @@
             },
             {
               "name": "legend-state",
-              "description": "When disabled, interaction with the legend action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the legend action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -5000,7 +4900,7 @@
             },
             {
               "name": "legend-toggle",
-              "description": "When active, the legend action is highlighted.",
+              "description": "When `active`, the legend action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -5019,7 +4919,7 @@
             },
             {
               "name": "rotate-chart-state",
-              "description": "When disabled, interaction with the rotate chart action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the rotate chart action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -5052,7 +4952,7 @@
             },
             {
               "name": "rotate-chart-toggle",
-              "description": "When active, the rotate chart action is highlighted.",
+              "description": "When `active`, the rotate chart action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -5071,7 +4971,7 @@
             },
             {
               "name": "selection-state",
-              "description": "When disabled, interaction with the selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -5104,7 +5004,7 @@
             },
             {
               "name": "selection-toggle",
-              "description": "When active, the selection action is highlighted.",
+              "description": "When `active`, the selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -5123,7 +5023,7 @@
             },
             {
               "name": "switch-selection-state",
-              "description": "When disabled, interaction with the switch selection action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the switch selection action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -5156,7 +5056,7 @@
             },
             {
               "name": "switch-selection-toggle",
-              "description": "When active, the switch selection action is highlighted.",
+              "description": "When `active`, the switch selection action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -5175,7 +5075,7 @@
             },
             {
               "name": "zoom-state",
-              "description": "When disabled, interaction with the zoom action is prevented and the component is displayed with lower opacity.",
+              "description": "When `disabled`, interaction with the zoom action is prevented and the component is displayed with lower opacity.",
               "type": {
                 "text": "\"disabled\" | \"enabled\"",
                 "values": [
@@ -5208,7 +5108,7 @@
             },
             {
               "name": "zoom-toggle",
-              "description": "When active, the zoom action is highlighted.",
+              "description": "When `active`, the zoom action is highlighted.",
               "type": {
                 "text": "\"active\" | \"inactive\"",
                 "values": [
@@ -5229,7 +5129,7 @@
           "events": [
             {
               "name": "arcgisActionBarToggle",
-              "description": "Event triggered once action bar expand is toggled",
+              "description": "Event triggered once action bar expand is toggled.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -5250,7 +5150,7 @@
             },
             {
               "name": "arcgisDefaultActionSelect",
-              "description": "Event triggered once a default action is selected",
+              "description": "Event triggered once a default action is selected.",
               "type": {
                 "text": "{\n    actionId: DefaultChartActions;\n    actionActive: boolean;\n}"
               },