@arcgis/charts-components 5.1.0-next.9 → 5.1.0-next.91

package/dist/components/arcgis-chart/customElement.d.ts

@@ -1,34 +1,36 @@
 /// <reference path="../../index.d.ts" />
-import type MapView from "@arcgis/core/views/MapView";
-import type SceneView from "@arcgis/core/views/SceneView";
-import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView";
-import type { DOMContainerAria } from "@arcgis/core/views/DOMContainer";
+import type MapView from "@arcgis/core/views/MapView.js";
+import type SceneView from "@arcgis/core/views/SceneView.js";
+import type SelectionManager from "@arcgis/core/views/SelectionManager.js";
+import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView.js";
+import type { DOMContainerAria } from "@arcgis/core/views/DOMContainer.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { AxisLabelFormatCallback, ChartOptions, GaugeInnerLabelFormatCallback, GuideTooltipFormatCallback, PieChartLegendValueLabelFormatCallback, PreRenderCallback } from "../../chart-rendering/common/interfaces.js";
-import type { CSVOptions, SupportedLayer } from "../../interfaces.js";
-import type { AxesMinMaxChangePayload, DataProcessCompletePayload, LegendItemVisibilityChangePayload, NoRenderPropChangePayload, SelectionCompletePayload, SeriesColorChangePayload } from "../../utils/components/event-payloads.js";
-import type { MissingSplitBySeriesProps, DownloadableChartImagesTypes } from "../../utils/components/interfaces.js";
+import type { CSVOptions, SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
 import type { ChartModel } from "../../model/chart-model/chart-model.js";
 import type { WebChartLegendPositions } from "../../spec/chart-object-literals.js";
-import type { WebChart, WebChartDataFilters } from "../../spec/web-chart.js";
 import type { WebChartDataTypes } from "../../spec/data-source.js";
-import type { LoaderColors, SelectionData, SelectionTheme } from "../../utils/misc/interfaces.js";
-import type { ErrorPolicy, LayerFieldsChangePolicy, LayerFilterChangePolicy, LayerRendererChangePolicy, SyncSelectionsBetweenChartAndLayerViewPolicy, ViewTimeExtentChangePolicy } from "../../utils/types/index.js";
+import type { WebChart, WebChartDataFilters } from "../../spec/web-chart.js";
+import type { DataWarningObject, ValidationStatus } from "../../utils/chart-config/validator/interfaces.js";
+import type { AxesMinMaxChangePayload, DataProcessCompletePayload, LegendItemVisibilityChangePayload, NoRenderPropChangePayload, SelectionCompletePayload, SeriesColorChangePayload } from "../../utils/components/event-payloads.js";
+import type { MissingSplitBySeriesProps, DownloadableChartImagesTypes } from "../../utils/components/interfaces.js";
 import type { ActionModes, CursorRange } from "../../utils/cursor/interfaces.js";
 import type { ChartElementLimit } from "../../utils/defaults/interfaces.js";
-import type { DataWarningObject, ValidationStatus } from "../../utils/chart-config/validator/interfaces.js";
+import type { LoaderColors, SelectionData, SelectionTheme } from "../../utils/misc/interfaces.js";
+import type { ErrorPolicy, LayerFieldsChangePolicy, LayerFilterChangePolicy, LayerRendererChangePolicy, SyncSelectionsBetweenChartAndLayerViewPolicy, ViewTimeExtentChangePolicy } from "../../utils/types/index.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 
 /**
- * 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.
+ * 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.
  *
  * Supported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.
  *
  * @slot [action-bar] - Slot for adding a `charts-action-bar` component or `calcite-action-bar`.
  * @see [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)
- * @see [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)
- * @see [Tutorial: Create a heat chart](https://developers.arcgis.com/javascript/latest/tutorials/create-a-heat-chart/)
- * @see [Tutorial: Modify a chart](https://developers.arcgis.com/javascript/latest/tutorials/modify-a-chart/)
+ * @see
+ * [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-a-chart/)
+ *
+ * **Note**: When the chart is getting rendered while its container is not yet fully sized, a console error about the chart's attribute height may appear. This is a known issue and should not affect the functionality of the chart.
  * @since 4.32
  */
 export abstract class ArcgisChart extends LitElement {
@@ -43,25 +45,32 @@ export abstract class ArcgisChart extends LitElement {
    * - `none`: No action is performed on user interaction.
    * - `zoom`: Zoom into a specific area of the chart.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    */
   accessor actionMode: ActionModes | undefined;
   /**
-   * Whether to allow the object id to be used as a statistic other than `COUNT`.
+   * Whether to allow the object id to be used as a statistic other than `Count`.
    *
    * @default false
    */
   accessor allowUsingObjectIdStat: boolean;
   /**
-   * The ARIA attributes for the chart.
+   * Enable animation on the chart.
+   *
+   * @default false
+   */
+  accessor animationEnabled: boolean | undefined;
+  /**
+   * The ARIA attributes for the chart. Provides accessibility information to assistive technologies such as screen readers. Supports the following properties: [\`label\`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [\`description\`](https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [\`describedByElements\`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaDescribedByElements), and [\`labelledByElements\`](https://developer.mozilla.org/en-US/docs/Web/API/Element/ariaLabelledByElements).
    *
    * @since 5.0
    */
-  accessor aria: DOMContainerAria;
+  accessor aria: DOMContainerAria | undefined;
   /**
-   * When `true`, the chart will not be destroyed automatically when it is disconnected from the document. This is useful when you want to move the chart to a different place on the page, or temporarily hide it.
+   * If `true`, the component will not be destroyed automatically when it is disconnected from the document. This is useful when you want to move the component to a different place on the page, or temporarily hide it. If this is set, make sure to call the [destroy()](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#destroy)  method when you are done to prevent memory leaks.
    *
    * @default false
+   * @since 5.0
    */
   accessor autoDestroyDisabled: boolean;
   /**
@@ -70,14 +79,16 @@ export abstract class ArcgisChart extends LitElement {
    * @deprecated since 5.0. Use [autoDestroyDisabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#autoDestroyDisabled) instead.
    * @default false
    */
-  accessor autoDisposeChart: boolean | undefined;
+  accessor autoDisposeChart: boolean;
   /**
    * When `true`, the data label text color is automatically adjusted for readability based on its background.
    * If the label is dark and appears over a dark series area, the text color is switched to either the chart background color or white.
    *
+   * **Note**: Applicable to heat charts only.
+   *
    * @default false
    */
-  accessor autoInverseDataLabelTextColor: boolean | undefined;
+  accessor autoInverseDataLabelTextColor: boolean;
   /**
    * The index of the chart to be rendered from the layer. Must be used in conjunction with the `layerItemId` or `layer` property.
    *
@@ -92,19 +103,19 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor chartIndex: number | undefined;
   /**
-   * Used to customize the number maximum of bars allowed on the chart.
+   * Customize the maximum number of series allowed on the chart.
    *
    * The chart's behavior once that limit is reached can be adjusted through the `behaviorAfterLimit` nested property, to either reject the creation
    * or update of the chart, or render the elements up to the given limits.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    */
   accessor chartLimits: ChartElementLimit | undefined;
   /**
    * Lifecycle function executed after the data has been processed and before the chart renders.
-   * Can be used to alter the config from information extracted from the data for instance.
+   * Can be used to alter the model from information extracted from the data.
    *
-   * **Note**: Applicable to gauge and pie chart only.
+   * **Note**: Applicable to gauges and pie charts only.
    */
   accessor chartWillRender: PreRenderCallback | undefined;
   /**
@@ -183,6 +194,9 @@ export abstract class ArcgisChart extends LitElement {
               histogramCreateMsg: string;
               scatterplotCreateMsg: string;
               calendarHeatChartCreateMsg: string;
+              comboBarLineChartCreateMsg: string;
+              radarChartCreateMsg: string;
+              gaugeCreateMsg: string;
           };
           notifications: {
               invalidConfig: string;
@@ -438,6 +452,9 @@ export abstract class ArcgisChart extends LitElement {
               histogramCreateMsg: string;
               scatterplotCreateMsg: string;
               calendarHeatChartCreateMsg: string;
+              comboBarLineChartCreateMsg: string;
+              radarChartCreateMsg: string;
+              gaugeCreateMsg: string;
           };
           notifications: {
               invalidConfig: string;
@@ -623,6 +640,14 @@ export abstract class ArcgisChart extends LitElement {
           "Invalid date": string;
       };
   }>;
+  /**
+   * Whether to use features uniquely designed for a chart currently being configured by a user via the UI.
+   * When true, the slotted charts action bar will expose an Edit chart action, surfaces relevant error states,
+   * and can show a helpful in-container placeholder about the chart’s purpose.
+   *
+   * @default false
+   */
+  accessor configurationEnabled: boolean;
   /**
    * Sets the cursor range when `actionMode` is set to `zoom`, `multiSelection` or `multiSelectionWithCtrlKey`.
    *
@@ -631,48 +656,50 @@ export abstract class ArcgisChart extends LitElement {
    * - `y-axis`: Allows to draw a rectangle bound to the y-axis.
    * - `undefined`: Defaults to the preset behavior according to the chart type and action mode.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    */
   accessor cursorRange: CursorRange | undefined;
   /**
-   * A callback function used to format the data labels. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the data labels. If the returned string contains HTML tags they will be interpreted as such.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    */
   accessor dataLabelFormatter: ChartOptions["dataLabelFormatter"] | undefined;
   /**
-   * Whether to disable automatic chart theming based on Calcite theme detection.
-   *
-   * **Note**: Currently, only the `calcite-mode-dark` theme is supported. When this theme
-   * is applied, all chart colors are automatically adjusted for dark mode and
-   * any custom chart colors will be overridden. This includes series, axes, grid and other elements.
-   *
-   * When `true`, the chart component will not apply any Calcite-based theming,
-   * even if a supported Calcite theme is detected.
-   *
-   * When `false` (default), the chart component will automatically apply the
-   * supported Calcite theme if it is detected on the chart container or any
-   * parent element.
+   * Disables all interactions on the chart.
    *
+   * @deprecated since 5.1. Use [interactionsDisabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#interactionsDisabled) instead.
    * @default false
-   * @since 5.0
    */
-  accessor disableAutoTheming: boolean;
+  accessor disableInteractions: boolean;
   /**
-   * Disables all interactions on the chart.
+   * Disables the toggling of series from the legend items.
+   *
+   * **Note**: Only applicable to multi-series charts.
    *
+   * @deprecated since 5.1. Use [togglingLegendItemsDisabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#togglingLegendItemsDisabled) instead.
    * @default false
    */
-  get disableInteractions(): boolean;
-  set disableInteractions(value: boolean | undefined);
+  accessor disableTogglingLegendItems: boolean;
   /**
-   * Disables the toggling of series via the legend items.
+   * Whether to enable automatic chart theming based on Calcite theme detection.
    *
-   * **Note**: Only applicable to multi-series charts.
+   * **Note**: Currently, only the `calcite-mode-dark` theme is supported. When this theme
+   * is applied, all chart colors are automatically adjusted for dark mode and
+   * any custom chart colors will be overridden. This includes series, axes, grid and other elements.
+   *
+   * When `true`, the chart component will automatically apply the
+   * supported Calcite theme if it is detected on the chart container or any
+   * parent element.
+   *
+   * When `false` (default), the chart component will not apply any Calcite-based theming,
+   * even if a supported Calcite theme is detected.
    *
    * @default false
+   * @since 5.0
+   * @internal
    */
-  accessor disableTogglingLegendItems: boolean | undefined;
+  accessor enableAutoTheming: boolean;
   /**
    * Whether to enable the beta features from the chart component.
    *
@@ -682,16 +709,20 @@ export abstract class ArcgisChart extends LitElement {
   accessor enableBetaFeatures: boolean;
   /**
    * Whether to use features uniquely designed for a chart currently being configured by a user via the UI.
+   * When true, the slotted charts action bar will expose an Edit chart action, surfaces relevant error states,
+   * and can show a helpful in-container placeholder about the chart’s purpose.
    *
+   * @deprecated since 5.1. Use [configurationEnabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#configurationEnabled) instead.
    * @default false
    */
   accessor enableConfiguration: boolean;
   /**
    * Enables the responsive features.
    *
+   * @deprecated since 5.1. Won't be replaced.
    * @default false
    */
-  accessor enableResponsiveFeatures: boolean | undefined;
+  accessor enableResponsiveFeatures: boolean;
   /**
    * Whether to display an error alert and hide the chart when it can't be created or updated.
    *
@@ -701,9 +732,9 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * The index of the feature to render when using a feature based gauge.
    *
-   * **Note**: Only applicable to gauge.
+   * **Note**: Only applicable to gauges.
    *
-   * @deprecated since 5.0. Use charts model's [featureIndex](https://developers.arcgis.com/javascript/latest/charts-model/gauge-model/#featureindex) prop instead.
+   * @deprecated since 5.0. Use charts model's [featureIndex](https://developers.arcgis.com/javascript/latest/references/charts-components/model/gauge-model/gauge-model/#featureIndex) prop instead.
    */
   accessor featureIndex: number | undefined;
   /**
@@ -711,39 +742,41 @@ export abstract class ArcgisChart extends LitElement {
    *
    * @default false
    */
-  accessor filterByExtent: boolean | undefined;
+  accessor filterByExtent: boolean;
   /**
    * When `true`, all chart elements are filtered based on the selection.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges or charts configured with imagery layers.
    *
    * @default false
    */
-  accessor filterBySelection: boolean | undefined;
+  accessor filterBySelection: boolean;
   /**
-   * A callback function used to format the gauge inner label. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the gauge inner label. If the returned string contains HTML tags they will be interpreted as such.
    *
-   * **Note**: Applicable to gauge only.
+   * **Note**: Applicable to gauges only.
    */
   accessor gaugeInnerLabelFormatter: GaugeInnerLabelFormatCallback | undefined;
   /**
-   * A callback function used to format the axes guides tooltip. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the axes guides tooltip. If the returned string contains HTML tags they will be interpreted as such.
    *
-   * **Note**: Not applicable to pie chart.
+   * **Note**: Not applicable to pie charts.
    */
   accessor guideTooltipFormatter: GuideTooltipFormatCallback | undefined;
   /**
    * When `true`, the empty series are completely hidden from the chart and the legend.
    * For example, a series may become empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    *
+   * @deprecated since 5.1. Use [showEmptySeries](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#showEmptySeries) instead.
    * @default false
    */
   accessor hideEmptySeries: boolean | undefined;
   /**
    * Hides the license watermark.
    *
+   * @deprecated since 5.1. Use [showLicenseWatermark](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#showLicenseWatermark) instead.
    * @default false
    */
   accessor hideLicenseWatermark: boolean | undefined;
@@ -752,7 +785,28 @@ export abstract class ArcgisChart extends LitElement {
    *
    * @default false
    */
-  accessor hideLoaderAnimation: boolean | undefined;
+  accessor hideLoaderAnimation: boolean;
+  /**
+   * 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).
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor hideUIMessages: boolean;
+  /**
+   * Whether to keep missing categories from a count aggregation as gaps in the chart's data.
+   *
+   * When data is retrieved from the server, the server excludes all features having a count of 0 from the response; hence resulting in missing entries on the charts.
+   *
+   * When this property is set to `true`, the dataset will keep these gaps instead of filling them with 0s.
+   *
+   * When left to `false`,  the chart's dataItems associated with empty (no value) categories (from only a `Count` aggregation)
+   * will be populated with 0s, via the`completeDataForEmptyCategoriesWithZeros` method.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor hideZeroCountCategories: boolean;
   /**
    * When `true`, disables the default setting that uses debounce functions to handle the visibility of markers
    * that are outside of the plotting area when the min/max bound changes and/or when a zoom action is performed
@@ -762,27 +816,34 @@ export abstract class ArcgisChart extends LitElement {
    * It's recommended that this property should only be set to `true` for small datasets.
    * When left `undefined`, will be treated as `false`.
    *
-   * **Note**: Applicable to line chart only.
+   * **Note**: Applicable to line charts only.
    *
+   * @deprecated since 5.1. Won't be replaced.
    * @default false
    */
-  accessor ignoreSmoothRenderingLimit: boolean | undefined;
+  accessor ignoreSmoothRenderingLimit: boolean;
   /**
    * This property will be effective when the component's `view` is provided or when the `layer` is set to a FeatureLayerView.
    *
    * By default the queries made by the chart will consider the view's extent as the unique geometry filter applicable. This implies ignoring any
-   * geometry passed through the config (`component.config.dataFilters`) or the runtime filters (`component.runtimeDataFilters`).
+   * geometry passed through the model (`component.model.dataFilters`) or the runtime filters (`component.runtimeDataFilters`).
    *
    * Setting this property to `false` signals the queries to ignore the view's extent, whether an additional geometry filter is provided or not.
    *
    * @default false
    */
-  accessor ignoreViewExtent: boolean | undefined;
+  accessor ignoreViewExtent: boolean;
+  /**
+   * Disables all interactions on the chart.
+   *
+   * @default false
+   */
+  accessor interactionsDisabled: boolean;
   /**
    * Used to perform queries.
    * If the layer is a `FeatureLayerView` or if the layer and the `view` property are both provided, the queries will be executed client-side.
    */
-  accessor layer: FeatureLayerView | SupportedLayer | undefined;
+  accessor layer: FeatureLayerView | SupportedLayer | SupportedRasterLayer | undefined;
   /**
    * Allows the chart to update automatically when the layer's fields change.
    *
@@ -811,7 +872,7 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Allows the chart to update automatically when the layer's renderer changes.
    *
-   * Applies when the color match feature is enabled.
+   * Applies when the color match is enabled.
    *
    * **Note**: If the property is set to `ignore` the chart will use the layer's renderer information when the data is updated.
    *
@@ -821,28 +882,36 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Sets the legend's position on the chart.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    *
-   * @deprecated since 5.0. Use charts model's [legendPosition](https://developers.arcgis.com/javascript/latest/charts-model/bar-chart-model/#legendPosition) prop instead.
+   * @deprecated since 5.0. Use charts model's [legendPosition](https://developers.arcgis.com/javascript/latest/references/charts-components/model/bar-chart-model/bar-chart-model/#legendPosition) prop instead.
    */
   accessor legendPosition: WebChartLegendPositions | undefined;
   /**
    * A callback function used to format the legend value labels. If the returned string contains HTML tags they will be interpreted as such.
    * If provided, the formatter will be used if at least `WebChartPieChartLegend.displayNumericValue` or `WebChartPieChartLegend.displayPercentage` is true.
    *
-   * **Note**: Applicable to pie chart only.
+   * **Note**: Applicable to pie charts only.
    */
   accessor legendValueLabelFormatter: PieChartLegendValueLabelFormatCallback | undefined;
   /**
    * When `true`, the legend is visible on the chart.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    *
-   * @deprecated since 5.0. Use charts model's [legendVisibility](https://developers.arcgis.com/javascript/latest/charts-model/bar-chart-model/#legendVisibility) prop instead.
+   * @deprecated since 5.0. Use charts model's [legendVisibility](https://developers.arcgis.com/javascript/latest/references/charts-components/model/bar-chart-model/bar-chart-model/#legendVisibility) prop instead.
    * @default false
    */
-  accessor legendVisibility: boolean | undefined;
-  /** Defines the colors for the loader animation. */
+  accessor legendVisibility: boolean;
+  /**
+   * Defines the colors for the loader animation.
+   *
+   * @example
+   * ```ts
+   * // Set a blue curtain and a red spinner for the loader animation
+   * myChart.loaderColors = { curtainColor: [30, 144, 255, 255], spinnerColor: [255, 0, 0, 255] };
+   * ```
+   */
   accessor loaderColors: LoaderColors | undefined;
   /** Custom message overrides for the chart's strings. */
   accessor messageOverrides: { chartNotFoundWarning?: string | undefined; } & {
@@ -916,6 +985,9 @@ export abstract class ArcgisChart extends LitElement {
               histogramCreateMsg?: string | undefined;
               scatterplotCreateMsg?: string | undefined;
               calendarHeatChartCreateMsg?: string | undefined;
+              comboBarLineChartCreateMsg?: string | undefined;
+              radarChartCreateMsg?: string | undefined;
+              gaugeCreateMsg?: string | undefined;
           } | undefined;
           notifications?: {
               invalidConfig?: string | undefined;
@@ -1104,13 +1176,13 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Provides an API to interact with the chart's configuration.
    *
-   * **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.
+   * **Note**: This property has a union type of `ChartModel | WebChart` meaning a raw chart configuration object can be passed to it instead, however it is recommended to use the `ChartModel` instance whenever possible.
    */
   accessor model: ChartModel | WebChart | undefined;
   /**
    * 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:
    * - The corresponding warning event will be sent
-   * - The "no data" message will be displayed (unless `showUIMesssages` is set to `false`)
+   * - The "no data" message will be displayed (unless `hideUIMessages` is set to `true` or `showUIMessages` is set to `false`)
    *
    * @default false
    */
@@ -1118,15 +1190,23 @@ export abstract class ArcgisChart extends LitElement {
   /** A placeholder string to provides a brief hint to the user indicating needed information for creating a chart. */
   accessor placeholder: string | undefined;
   /**
-   * Builds charts sequentially instead of rendering them all at once
+   * Allows the use of the fields alias from the `layer.popupTemplate` when rendering the field names on the chart (e.g. tooltips, axes, legend).
+   *
+   * @default false
+   */
+  accessor popupTemplateFieldInfosEnabled: boolean | undefined;
+  /**
+   * Builds charts sequentially instead of rendering them all at once.
    *
+   * @deprecated since 5.1. Use [skipChartCreationQueue](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#skipChartCreationQueue) instead.
    * @default false
    */
   accessor queueChartCreation: boolean | undefined;
   /**
-   * When `true`, the chart's dataItems associated with empty (no value) categories (from only a `Count` aggregation)
+   * When `true`, the chart's `dataItems` associated with empty (no value) categories (from only a `Count` aggregation)
    * will be populated with 0s, via the `completeDataForEmptyCategoriesWithZeros` method.
    *
+   * @deprecated since 5.0. Use [hideZeroCountCategories](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#hideZeroCountCategories) instead.
    * @default false
    */
   accessor replaceNoValueCategoryWithZero: boolean | undefined;
@@ -1138,24 +1218,24 @@ export abstract class ArcgisChart extends LitElement {
    *
    * The extent (`IExtent`) is returned through a property called `arcgis_charts_features_extent`.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    *
    * @default false
    */
-  accessor returnFeaturesExtent: boolean | undefined;
+  accessor returnFeaturesExtent: boolean;
   /**
    * When `true`, the selection indexes will be computed whenever a selection is made on or passed to the chart.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    *
    * @default false
    */
-  accessor returnSelectionIndexes: boolean | undefined;
+  accessor returnSelectionIndexes: boolean;
   /**
    * When `true`, the object ids will be computed whenever a selection is made on or passed to the chart.
    * Only considered for a data source using a feature layer.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges or charts configured with imagery layers. It's always `false` for imagery layers. No object ids will be computed.
    *
    * @default false
    */
@@ -1165,31 +1245,63 @@ export abstract class ArcgisChart extends LitElement {
    *
    * **Note**: Applicable to bar chart, line chart, combo bar and line chart and box plot.
    *
-   * @deprecated since 5.0. Use charts model's [rotatedState](https://developers.arcgis.com/javascript/latest/charts-model/bar-chart-model/#rotatedstate) prop instead.
+   * @deprecated since 5.0. Use charts model's [rotatedState](https://developers.arcgis.com/javascript/latest/references/charts-components/model/bar-chart-model/bar-chart-model/#rotatedState) prop instead.
    * @default false
    */
-  accessor rotation: boolean | undefined;
-  /** Applies runtime data filters to the chart. */
+  accessor rotation: boolean;
+  /**
+   * Applies runtime data filters to the chart.
+   *
+   * @example
+   * ```ts
+   * myChart.runtimeDataFilters = {
+   *   where: "FieldValue = 9",
+   * };
+   * ```
+   */
   accessor runtimeDataFilters: WebChartDataFilters | undefined;
   /**
-   * A callback function used to format the secondary y-axis labels. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the secondary y-axis labels. If the returned string contains HTML tags they will be interpreted as such.
    * The property will be effective only if 3 axes are defined (dual axis chart).
    *
-   * **Note**: Not applicable to pie chart or gauge.
+   * **Note**: Appliable to bar charts, line charts, combo bar line charts and radar charts.
    */
   accessor secondaryYAxisLabelFormatter: AxisLabelFormatCallback | undefined;
   /**
    * When this property is set, it will apply a selection on the chart matching the provided selection.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
    */
   accessor selectionData: SelectionData | undefined;
+  /**
+   * Selection manager object used to synchronize the selections with the chart when `syncViewSelection` is `true`.
+   * It has precedence over the layer view's [SelectionManager](https://developers.arcgis.com/javascript/latest/references/core/views/SelectionManager/) when both are available.
+   *
+   * @since 5.1
+   */
+  accessor selectionManager: SelectionManager | undefined;
   /**
    * Used to provide a customized theme for the selected and non selected elements.
    * - If no style is provided for the selected elements, a default selection is applied.
    * - If no style is provided for the non selected elements, the chart's style is applied.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Not applicable to gauges.
+   *
+   * * \@example
+   * ```ts
+   * myChart.selectionTheme = {
+   *   "selectedElementsTheme": {
+   *     "transformation": {
+   *       "scale": 1.2
+   *     }
+   *   },
+   *   "nonSelectedElementsTheme": {
+   *     "transformation": {
+   *       "opacity": 0.5
+   *     }
+   *   }
+   * }
+   * ```
    */
   accessor selectionTheme: SelectionTheme | undefined;
   /**
@@ -1199,13 +1311,43 @@ export abstract class ArcgisChart extends LitElement {
    *
    * @default false
    */
-  accessor setTimeBinningInfoWhenNotProvided: boolean | undefined;
+  accessor setTimeBinningInfoWhenNotProvided: boolean;
+  /**
+   * Show the series on the chart even if it doesn't have data (i.e. empty)
+   *
+   * When `false`, the empty series are completely hidden from the chart and the legend.
+   * For example a series can be empty after applying a data filter, filter by attribute or geometry (as when using the filter by extent).
+   *
+   * **Note**: Not applicable to gauges.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor showEmptySeries: boolean;
+  /**
+   * Shows the license watermark.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor showLicenseWatermark: boolean;
   /**
    * 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).
    *
+   * @deprecated since 5.1. Use [hideUIMessages](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#hideUIMessages) instead.
    * @default false
    */
   accessor showUIMessages: boolean | undefined;
+  /**
+   * Whether to skip the chart rendering queue.
+   *
+   * When `true`, charts will render immediately without waiting for other charts to finish rendering.
+   * When `false` (default), charts are queued so that only one chart renders at a time.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor skipChartCreationQueue: boolean;
   /**
    * Whether to synchronize the selection between chart components from the same layer.
    *
@@ -1213,23 +1355,46 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor syncSelection: boolean;
   /**
-   * Determines whether the selections from the chart should be synchronized with the layer view and vice versa.
+   * Determines whether the chart's selection should be synchronized with either the chart's `selectionManager` or the layer view's.
    *
+   * @deprecated since 5.1. Use [syncViewSelection](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#syncViewSelection) instead.
    * @default "disabled"
    */
   accessor syncSelectionsBetweenChartAndLayerViewPolicy: SyncSelectionsBetweenChartAndLayerViewPolicy;
+  /**
+   * Determines whether the chart's selection should be synchronized with either the chart's `selectionManager` or the layer view's.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor syncViewSelection: boolean;
   /** Used to set a custom time zone for the chart. */
   accessor timeZone: MapView["timeZone"] | undefined;
   /**
-   * A callback function used to format the tooltips. If the returned string contains HTML tags they will be interpreted as such.
+   * Disables the toggling of series via the legend items.
    *
-   * **Note**: Not applicable to gauge.
+   * **Note**: Only applicable to multi-series charts.
+   *
+   * @default false
+   */
+  accessor togglingLegendItemsDisabled: boolean | undefined;
+  /**
+   * Callback function used to format the tooltips. If the returned string contains HTML tags they will be interpreted as such.
+   *
+   * @example
+   * ```ts
+   * myChart.tooltipFormatter = ({ statValue }) => {
+   *   return `<b>Custom tooltip</b> for ${statValue}`;
+   * };
+   * ```
+   *
+   * **Note**: Not applicable to gauges.
    */
   accessor tooltipFormatter: ChartOptions["tooltipFormatter"] | undefined;
   /**
    * Whether to update the series when the data updates while the chart uses a split-by field configuration.
    *
-   * If `addMissingSeries` is set to `true` the missing series will be added to cover the split-by values not referenced by the config.
+   * If `addMissingSeries` is set to `true` the missing series will be added to cover the split-by values not referenced by the model.
    * The default information from the property `updateSplitBySeries.seriesTemplate` will be applied to the new series.
    *
    * **Note**: Applicable only to bar chart, line chart and box plot when a split-by field is used.
@@ -1238,37 +1403,45 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Enable animation on the chart.
    *
+   * @deprecated since 5.1. Use [animationEnabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#animationEnabled) instead.
    * @default false
    */
-  accessor useAnimatedCharts: boolean | undefined;
+  accessor useAnimatedCharts: boolean;
   /**
    * Allows the use of the fields alias from the `layer.popupTemplate` when rendering the field names on the chart (e.g. tooltips, axes, legend).
    *
+   * @deprecated since 5.1. Use [popupTemplateFieldInfosEnabled](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#popupTemplateFieldInfosEnabled) instead.
    * @default false
    */
-  accessor usePopupTemplateFieldsInfo: boolean | undefined;
+  accessor usePopupTemplateFieldsInfo: boolean;
   /** Used to access the feature layer view instance in order to perform client side queries. */
   accessor view: MapView | SceneView | undefined;
   /**
    * Whether the chart should be refreshed when the view's time extent changes.
    *
-   * **Note**: Not supported for histogram.
+   * **Note**: Not applicable for histograms.
    *
    * @default "ignore"
    */
   accessor viewTimeExtentChangePolicy: ViewTimeExtentChangePolicy;
   /**
-   * A callback function used to format the x-axis labels. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the x-axis labels. If the returned string contains HTML tags they will be interpreted as such.
    *
-   * **Note**: Not applicable to pie chart.
+   * **Note**: Not applicable to pie charts.
    */
   accessor xAxisLabelFormatter: AxisLabelFormatCallback | undefined;
   /**
-   * A callback function used to format the y-axis labels. If the returned string contains HTML tags they will be interpreted as such.
+   * Callback function used to format the y-axis labels. If the returned string contains HTML tags they will be interpreted as such.
    *
-   * **Note**: Not applicable to pie chart or gauge.
+   * **Note**: Not applicable to pie charts or gauges.
    */
   accessor yAxisLabelFormatter: AxisLabelFormatCallback | undefined;
+  /**
+   * Apply the selection from the selection manager to the chart.
+   *
+   * @internal
+   */
+  applySelectionFromSelectionManager(): void;
   /**
    * Clears all selection on the chart.
    *
@@ -1276,11 +1449,11 @@ export abstract class ArcgisChart extends LitElement {
    */
   clearSelection(): Promise<void>;
   /**
-   * Triggers an alert to display an error message.
+   * Destroys the chart instance and removes it from the DOM.
    *
-   * @param errorMessage
+   * @since 5.1
    */
-  errorAlert(errorMessage?: string): Promise<void>;
+  destroy(): Promise<void>;
   /**
    * Export the current chart's data as a CSV file.
    *
@@ -1315,10 +1488,10 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Notify method allows passing external messages to the chart component.
    * It can be used to pass validation or information messages.
-   * In a situation where a config update is overriding your notification modal, consider waiting for the `arcgisUpdateComplete` event.
+   * In a situation where a model update is overriding the notification modal, consider waiting for the [@arcgisUpdateComplete](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#event-arcgisUpdateComplete) event.
    *
-   * @param message - The message to display in the notification panel.
-   * @param heading - The heading to display in the notification panel.
+   * @param message - The message to display in the chart's info modal.
+   * @param heading - The heading to display in the chart's info modal.
    */
   notify(message?: string, heading?: string): Promise<void>;
   /**
@@ -1331,7 +1504,7 @@ export abstract class ArcgisChart extends LitElement {
       resetAxesBounds?: boolean;
   }): Promise<void>;
   /**
-   * Resets the chart zoom to bring it back to full extent
+   * Resets the chart zoom to bring it back to full extent.
    *
    * **Note**: Applicable to XY charts only.
    */
@@ -1342,14 +1515,11 @@ export abstract class ArcgisChart extends LitElement {
    * **Note**: Not applicable to gauge.
    */
   switchSelection(): Promise<void>;
-  "@setterTypes": {
-    disableInteractions?: boolean | undefined;
-  };
   /** Event triggered once the chart axes min/max values are computed. */
   readonly arcgisAxesMinMaxChange: import("@arcgis/lumina").TargetedEvent<this, AxesMinMaxChangePayload>;
   /** Event triggered when an error is detected with the data set. */
   readonly arcgisBadDataWarningRaise: import("@arcgis/lumina").TargetedEvent<this, DataWarningObject>;
-  /** Event triggered when the chart is not found for the given `chartIndex` property. */
+  /** Event triggered when the chart is not found for the given [chartIndex](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#chartIndex) property. */
   readonly arcgisChartNotFoundWarning: import("@arcgis/lumina").TargetedEvent<this, string>;
   /** Event triggered when the chart config is changed. */
   readonly arcgisConfigChange: import("@arcgis/lumina").TargetedEvent<this, {
@@ -1362,7 +1532,7 @@ export abstract class ArcgisChart extends LitElement {
    *
    * For instance it can be useful to see all the slices before they get grouped into an 'other' slice during the post-processing step.
    *
-   * **Note**: Applicable to pie chart only.
+   * **Note**: Applicable to pie charts only.
    */
   readonly arcgisDataFetchComplete: import("@arcgis/lumina").TargetedEvent<this, WebChartDataTypes>;
   /** Event triggered once the chart data has been processed. */