@arcgis/charts-components 5.2.0-next.5 → 5.2.0-next.50

package/dist/chunks/x-bounds.js

@@ -4,12 +4,12 @@ import { cloneDeep as h } from "lodash-es";
 import { G as g } from "./common.js";
 import { i as c } from "./rest-js-object-literals.js";
 import { u as x } from "./chart-object-literals.js";
-import { af as S, I as L, T as b, Z as T } from "./index.js";
+import { ag as S, J as L, T as b, _ as T } from "./index.js";
 import { M as C } from "./index2.js";
 import { q as X, p as B } from "./index5.js";
 import { m as a, C as f } from "./model-setter.js";
 import { e as M, f as A } from "./utils2.js";
-import { k as p, s as y, f as O } from "./utils.js";
+import { l as p, s as y, h as O } from "./utils.js";
 const P = (t) => {
   for (const e of t.axes ?? [])
     for (const i of e?.guides ?? [])
@@ -57,22 +57,22 @@ const V = (t) => {
 }, $ = (t) => {
   const { name: e, axis: i, index: s } = d(t);
   i?.guides?.[s] !== void 0 && (i.guides[s].name = e);
-}, I = (t) => {
+}, N = (t) => {
   const { axis: e, index: i } = d(t);
   return e?.guides?.[i]?.label?.text;
-}, N = (t) => {
+}, I = (t) => {
   const { labelText: e, axis: i, index: s } = d(t), o = i?.guides?.[s]?.label ?? S(e, L(b.GuideLabel), b.GuideLabel);
   i?.guides?.[s] !== void 0 && (i.guides[s].label = { ...o, text: e });
 }, q = (t) => {
   const { axis: e, index: i } = d(t);
   return e?.guides?.[i]?.above ?? !1;
-}, U = (t) => {
+}, J = (t) => {
   const { above: e, axis: i, index: s } = d(t);
   i?.guides?.[s] !== void 0 && (i.guides[s].above = e);
-}, Y = (t) => {
+}, U = (t) => {
   const { axis: e, index: i } = d(t);
   return e?.guides?.[i]?.style;
-}, Z = (t) => {
+}, Y = (t) => {
   const { style: e, axis: i, index: s } = d(t);
   i?.guides?.[s] !== void 0 && (i.guides[s].style = e);
 }, Ge = (t) => {
@@ -97,10 +97,10 @@ const V = (t) => {
   const { reverseColor: e, axis: i, index: s } = d(t);
   i?.guides?.[s] !== void 0 && (i.guides[s].tooltipReverseColor = e);
 };
-var J = Object.defineProperty, K = Object.getOwnPropertyDescriptor, u = (t, e, i, s) => {
-  for (var o = K(e, i), n = t.length - 1, r; n >= 0; n--)
+var K = Object.defineProperty, Q = Object.getOwnPropertyDescriptor, u = (t, e, i, s) => {
+  for (var o = Q(e, i), n = t.length - 1, r; n >= 0; n--)
     (r = t[n]) && (o = r(e, i, o) || o);
-  return o && J(e, i, o), o;
+  return o && K(e, i, o), o;
 };
 class l extends _ {
   /**
@@ -167,10 +167,10 @@ class l extends _ {
    * @param orientation - Default `y`. The axis orientation of the guide.
    */
   getGuideLabelText(e, i) {
-    return I({ config: this._config, index: e, orientation: i });
+    return N({ config: this._config, index: e, orientation: i });
   }
   setGuideLabelText(e, i, s) {
-    N({ labelText: e, config: this._config, index: i, orientation: s });
+    I({ labelText: e, config: this._config, index: i, orientation: s });
   }
   /**
    * Gets whether the guide should be rendered above the other chart elements.
@@ -182,7 +182,7 @@ class l extends _ {
     return q({ config: this._config, index: e, orientation: i });
   }
   setGuideAbove(e, i, s) {
-    U({ above: e, config: this._config, index: i, orientation: s });
+    J({ above: e, config: this._config, index: i, orientation: s });
   }
   /**
    * Gets the guide style.
@@ -191,10 +191,10 @@ class l extends _ {
    * @param orientation - Default `y`. The axis orientation of the guide.
    */
   getGuideStyle(e, i) {
-    return Y({ config: this._config, index: e, orientation: i });
+    return U({ config: this._config, index: e, orientation: i });
   }
   setGuideStyle(e, i, s) {
-    Z({ style: e, config: this._config, index: i, orientation: s });
+    Y({ style: e, config: this._config, index: i, orientation: s });
   }
   /**
    * Gets whether the tooltip text color should be reversed for a guide.
@@ -249,10 +249,10 @@ class he extends f {
     });
   }
 }
-var Q = Object.defineProperty, k = Object.getOwnPropertyDescriptor, ee = (t, e, i, s) => {
+var Z = Object.defineProperty, k = Object.getOwnPropertyDescriptor, ee = (t, e, i, s) => {
   for (var o = k(e, i), n = t.length - 1, r; n >= 0; n--)
     (r = t[n]) && (o = r(e, i, o) || o);
-  return o && Q(e, i, o), o;
+  return o && Z(e, i, o), o;
 };
 const ie = (t) => p({ config: t, axisIndex: 0, isMax: !0 }), te = (t, e) => {
   y({ config: t, value: e, axisIndex: 0, isMax: !0 });

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

@@ -22,125 +22,53 @@ import type { ErrorPolicy, LayerFieldsChangePolicy, LayerFilterChangePolicy, Lay
 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 ArcGIS Chart component renders a chart by setting a [model](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#model) object that defines the chart's configuration and data.
+ * There are different ways to render a chart with the ArcGIS Chart component:
  *
- * Supported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.
+ * ##### Load from a layer item
  *
- * @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-a-chart/)
+ * To load a chart from a layer item, first the chart needs to be [configured in Map Viewer](https://doc.arcgis.com/en/arcgis-online/create-maps/configure-charts-mv.htm) and [saved to the layer item](https://doc.arcgis.com/en/arcgis-online/create-maps/duplicate-save-layers.htm#ESRI_SECTION1_2AE9121DFA5D4E099F0D434EBA7D9365).
+ * Then set the [layerItemId](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#layerItemId) property to the item's ID and the [chartIndex](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#chartIndex) property to the index of the chart within the item.
  *
- * **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.
+ * ```html
+ * <arcgis-chart layer-item-id="..." chart-index="0"></arcgis-chart>
+ * ```
+ *
+ * ##### Create a new chart with charts model
+ *
+ * To create a new chart, use the [`createModel()`](/references/charts-components/model/shared/setup-utils/#createModel) method with a layer and a chart type, then configure the chart using the model's properties and methods.
+ *
+ * ```js
+ * import FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";
+ * import { createModel } from "@arcgis/charts-components/model/shared/setup-utils.js";
+ *
+ * const myLayer = new FeatureLayer({ portalItem: { id: "..." } });
+ *
+ * const chartElement = document.querySelector("arcgis-chart");
+ * const barChartModel = await createModel({ layer: myLayer, chartType: "barChart" });
+ * barChartModel.xAxisField = "field";
+ * ```
+ *
+ * Each supported chart type has its own configuration properties and methods, which are covered with examples in the [chart types documentation](https://developers.arcgis.com/javascript/latest/charts/chart-types/chart-types-intro).
+ *
+ * ##### See also:
+ * - [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)
+ * - [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-a-chart/)
+ * - [Tutorial: Chart and map interactions](https://developers.arcgis.com/javascript/latest/tutorials/chart-and-map-interactions/)
+ *
+ * > [!WARNING]
+ * > When the chart is rendering 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.
+ *
+ * @slot [action-bar] - Slot for the [arcgis-charts-action-bar](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-charts-action-bar/) component or [calcite-action-bar](https://developers.arcgis.com/calcite-design-system/components/action-bar/) component.
  * @since 4.32
  */
 export abstract class ArcgisChart extends LitElement {
-  /** @internal */
-  protected _messages: Partial<{ chartNotFoundWarning: string; }> & T9nMeta<{ chartNotFoundWarning: string; }>;
-  /**
-   * Specifies the user action behavior for the chart.
-   *
-   * - `monoSelection`: Select a single data point or series, new selection replaces the previous one.
-   * - `multiSelection`: Select multiple data points or series, new selection adds to the previous one.
-   * - `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.
-   * - `none`: No action is performed on user interaction.
-   * - `zoom`: Zoom into a specific area of the chart.
-   *
-   * **Note**: Not applicable to gauges.
-   */
-  accessor actionMode: ActionModes | undefined;
-  /**
-   * Whether to allow the object id to be used as a statistic other than `Count`.
-   *
-   * @default false
-   */
-  accessor allowUsingObjectIdStat: boolean;
-  /**
-   * 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 | undefined;
-  /**
-   * 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;
-  /**
-   * Auto disposes the chart when a new one is created in the same container.
-   *
-   * @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;
-  /**
-   * 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;
-  /**
-   * Allows picking the Calcite CSS variables to use when applying a Calcite theme.
-   *
-   * By default the following variables are used:
-   * background: --calcite-color-foreground-1
-   * text: --calcite-color-text-1
-   * line: --calcite-color-border-1
-   * secondary line: --calcite-color-text-3
-   * spinner: --calcite-color-brand-hover
-   *
-   * The charts colors are overridden by those associated to those CSS variables, but only if they have not been
-   * customized beforehand.
-   *
-   * @since 5.1
-   */
-  accessor calciteThemingCSSVariables: CalciteThemeCSSVariables;
-  /**
-   * The index of the chart to be rendered from the layer. Must be used in conjunction with the `layerItemId` or `layer` property.
-   *
-   * If a `layer` or `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.
-   *
-   * If the `chartIndex` is out of bounds, the first chart in the layer will be rendered and a warning event will be emitted.
-   *
-   * @example
-   * ```html
-   * <arcgis-chart layer-item-id="8871626e970a4f3e9d6113ec63a92f2f" chart-index="2"></arcgis-chart>
-   * ```
-   */
-  accessor chartIndex: number | undefined;
-  /**
-   * 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 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 model from information extracted from the data.
-   *
-   * **Note**: Applicable to gauges and pie charts only.
-   */
-  accessor chartWillRender: PreRenderCallback | undefined;
   /**
    * Localized common strings.
    *
    * @internal
    */
-  protected commonStrings: {
+  protected _commonStrings: {
       utilsStrings: {
           chartType: {
               chart: string;
@@ -675,6 +603,106 @@ export abstract class ArcgisChart extends LitElement {
           "Invalid date": string;
       };
   }>;
+  /** @internal */
+  protected _messages: Partial<{ chartNotFoundWarning: string; }> & T9nMeta<{ chartNotFoundWarning: string; }>;
+  /**
+   * Specifies the user action behavior for the chart.
+   *
+   * - `monoSelection`: Select a single data point or series, new selection replaces the previous one.
+   * - `multiSelection`: Select multiple data points or series, new selection adds to the previous one.
+   * - `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.
+   * - `none`: No action is performed on user interaction.
+   * - `zoom`: Zoom into a specific area of the chart.
+   *
+   * **Note**: Not applicable to gauges.
+   */
+  accessor actionMode: ActionModes | undefined;
+  /**
+   * Whether to allow the object id to be used as a statistic other than `Count`.
+   *
+   * @default false
+   */
+  accessor allowUsingObjectIdStat: boolean;
+  /**
+   * 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/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-label), [\`description\`](https://developer.mozilla.org/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-description), [\`describedByElements\`](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements), and [\`labelledByElements\`](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements).
+   *
+   * @since 5.0
+   */
+  accessor aria: DOMContainerAria | undefined;
+  /**
+   * 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;
+  /**
+   * Auto disposes the chart when a new one is created in the same container.
+   *
+   * @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;
+  /**
+   * 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;
+  /**
+   * Allows picking the Calcite CSS variables to use when applying a Calcite theme.
+   *
+   * By default the following variables are used:
+   * - background: `--calcite-color-foreground-1`
+   * - text: `--calcite-color-text-1`
+   * - line: `--calcite-color-border-1`
+   * - secondary line: `--calcite-color-text-3`
+   * - spinner: `--calcite-color-brand-hover`
+   *
+   * The charts colors are overridden by those associated to those CSS variables, but only if they have not been
+   * customized beforehand.
+   *
+   * @since 5.1
+   */
+  accessor calciteThemingCSSVariables: CalciteThemeCSSVariables;
+  /**
+   * The index of the chart to be rendered from the layer. Must be used in conjunction with the `layerItemId` or `layer` property.
+   *
+   * If a `layer` or `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.
+   *
+   * If the `chartIndex` is out of bounds, the first chart in the layer will be rendered and a warning event will be emitted.
+   *
+   * @example
+   * ```html
+   * <arcgis-chart layer-item-id="8871626e970a4f3e9d6113ec63a92f2f" chart-index="2"></arcgis-chart>
+   * ```
+   */
+  accessor chartIndex: number | undefined;
+  /**
+   * 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 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 model from information extracted from the data.
+   *
+   * **Note**: Applicable to gauges and pie charts only.
+   */
+  accessor chartWillRender: PreRenderCallback | undefined;
   /**
    * 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,
@@ -748,7 +776,7 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * The index of the feature to render when using a feature based gauge.
    *
-   * **Note**: Only applicable to gauges.
+   * **Note**: Applicable to gauges only.
    *
    * @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.
    */
@@ -788,7 +816,7 @@ export abstract class ArcgisChart extends LitElement {
   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).
+   * For example, a series may become empty after applying a data filter, filter by attribute or geometry (as when using the filter by view extent).
    *
    * **Note**: Not applicable to gauges.
    *
@@ -824,7 +852,7 @@ export abstract class ArcgisChart extends LitElement {
    * 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.
+   * will be populated with 0s.
    *
    * @default false
    * @since 5.1
@@ -882,9 +910,11 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor layerFilterChangePolicy: LayerFilterChangePolicy;
   /**
-   * Layer item ID associated with the chart to be rendered. Can be used in conjunction with the `chartIndex` property.
+   * Layer item ID associated with the chart to be rendered. Can be used in conjunction with the `chartIndex` property. If `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.
    *
-   * If `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.
+   * The layer item ID can be found in the URL of the layer's item page on ArcGIS Online or Enterprise. For example, in the URL `https://www.arcgis.com/home/item.html?id=8871626e970a4f3e9d6113ec63a92f2f`, the layer item ID is `8871626e970a4f3e9d6113ec63a92f2f`.
+   *
+   * Supported layers include: `FeatureLayer`, `SubtypeSublayer`, `ImageryLayer`, `ImageryTileLayer` and `WCSLayer`.
    *
    * @example
    * ```html
@@ -893,13 +923,11 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor layerItemId: string | undefined;
   /**
-   * Allows the chart to update automatically when the layer's renderer changes.
-   * Applies when the color match is enabled.
-   *
-   * @deprecated
-   * since 5.1. Won't be replaced.
+   * Allows the chart to update automatically when the layer's renderer changes. Applies when the color match is enabled.
    *
    * **Note**: If the property is set to `ignore` the chart will still use the layer's renderer information when the data is updated.
+   *
+   * @deprecated since 5.1. Won't be replaced.
    * @default "refresh"
    */
   accessor layerRendererChangePolicy: LayerRendererChangePolicy;
@@ -913,7 +941,7 @@ export abstract class ArcgisChart extends LitElement {
   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.
+   * If provided, the formatter will be used if at least [displayNumericValue](https://developers.arcgis.com/javascript/latest/references/charts-components/spec/web-chart/#WebChartPieChartLegend-displayNumericValue) or [displayPercentage](https://developers.arcgis.com/javascript/latest/references/charts-components/spec/web-chart/#WebChartPieChartLegend-displayPercentage) is `true`.
    *
    * **Note**: Applicable to pie charts only.
    */
@@ -934,12 +962,12 @@ export abstract class ArcgisChart extends LitElement {
    * @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] };
+   * chartComponent.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; } & {
+  accessor messageOverrides: {
       utilsStrings?: {
           chartType?: {
               chart?: string | undefined;
@@ -1206,7 +1234,7 @@ export abstract class ArcgisChart extends LitElement {
           "Unable to load file: %1"?: string | undefined;
           "Invalid date"?: string | undefined;
       } | undefined;
-  };
+  } & { chartNotFoundWarning?: string | undefined; };
   /**
    * Provides an API to interact with the chart's configuration.
    *
@@ -1238,19 +1266,19 @@ export abstract class ArcgisChart extends LitElement {
   accessor queueChartCreation: boolean | undefined;
   /**
    * 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.
+   * will be populated with 0s.
    *
    * @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;
   /**
-   * When `true`, the features extent will be returned through the `arcgisDataProcessComplete` and `arcgisSelectionComplete` events payload.
+   * When `true`, the features extent will be returned through the [@arcgisDataProcessComplete](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#event-arcgisDataProcessComplete) and [@arcgisSelectionComplete](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#event-arcgisSelectionComplete) events payload.
    * Applies only to:
    * - Charts using an aggregation.
    * - Data source using a feature layer compatible with envelope aggregation.
    *
-   * The extent (`IExtent`) is returned through a property called `arcgis_charts_features_extent`.
+   * The extent (IExtent) is returned through the property [featuresExtentField](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/index/#featuresExtentField).
    *
    * **Note**: Not applicable to gauges.
    *
@@ -1277,7 +1305,7 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * When `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.
    *
-   * **Note**: Applicable to bar chart, line chart, combo bar and line chart and box plot.
+   * **Note**: Applicable to bar chart, line chart, combo bar line chart and box plot.
    *
    * @default false
    */
@@ -1285,7 +1313,7 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * When `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.
    *
-   * **Note**: Applicable to bar chart, line chart, combo bar and line chart and box plot.
+   * **Note**: Applicable to bar chart, line chart, combo bar line chart and box plot.
    *
    * @deprecated since 5.0. Use either [rotated](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#rotated) or the charts model's [rotated](https://developers.arcgis.com/javascript/latest/references/charts-components/model/bar-chart-model/bar-chart-model/#rotated) prop instead.
    * @default false
@@ -1296,7 +1324,7 @@ export abstract class ArcgisChart extends LitElement {
    *
    * @example
    * ```ts
-   * myChart.runtimeDataFilters = {
+   * chartComponent.runtimeDataFilters = {
    *   where: "FieldValue = 9",
    * };
    * ```
@@ -1304,9 +1332,8 @@ export abstract class ArcgisChart extends LitElement {
   accessor runtimeDataFilters: WebChartDataFilters | undefined;
   /**
    * 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**: Appliable to bar charts, line charts, combo bar line charts and radar charts.
+   * **Note**: Appliable to bar charts, line charts, combo bar line charts with dual axes.
    */
   accessor secondaryYAxisLabelFormatter: AxisLabelFormatCallback | undefined;
   /**
@@ -1316,8 +1343,8 @@ export abstract class ArcgisChart extends LitElement {
    */
   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.
+   * Selection manager object used to synchronize the selections with the chart when [syncViewSelection](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#syncViewSelection) is `true`.
+   * It has precedence over the layer view's [SelectionManager](/references/core/views/SelectionManager/) when both are available.
    *
    * @since 5.1
    */
@@ -1329,9 +1356,9 @@ export abstract class ArcgisChart extends LitElement {
    *
    * **Note**: Not applicable to gauges.
    *
-   * * \@example
+   * @example
    * ```ts
-   * myChart.selectionTheme = {
+   * chartComponent.selectionTheme = {
    *   "selectedElementsTheme": {
    *     "transformation": {
    *       "scale": 1.2
@@ -1349,7 +1376,7 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * 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.
    *
-   * **Note**: Only applicable to charts using the temporal binning feature (bar chart, line chart, combo bar and line chart, radar chart).
+   * **Note**: Only applicable to charts using the temporal binning feature (bar chart, line chart, combo bar line chart, radar chart).
    *
    * @default false
    */
@@ -1358,7 +1385,7 @@ export abstract class ArcgisChart extends LitElement {
    * 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).
+   * For example a series can be empty after applying a data filter, filter by attribute or geometry (as when using the filter by view extent).
    *
    * **Note**: Not applicable to gauges.
    *
@@ -1405,14 +1432,14 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor syncSelection: boolean;
   /**
-   * Determines whether the chart's selection should be synchronized with either the chart's `selectionManager` or the layer view's.
+   * Determines whether the chart's selection should be synchronized with either the chart's [selectionManager](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#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) prop 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.
+   * Determines whether the chart's selection should be synchronized with either the chart's [selectionManager](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#selectionManager) or the layer view's.
    *
    * @default false
    * @since 5.1
@@ -1428,7 +1455,8 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor syncViewTimeExtent: boolean;
   /**
-   * Whether the chart's data should be in sync with the view's time zone (`timeZone`).
+   * Whether the chart's data should be in sync with the view's [timeZone](/references/core/views/MapView/#timeZone).
+   *
    * **Note**: This applies only to charts supporting temporal data. Additionally if the data is binned, it applies only if the layer has the
    * capacity to handle the `/queryBins` operation. For any other case the chart will ignore the view's time zone regardless of the value of this property.
    *
@@ -1437,7 +1465,8 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor syncViewTimeZone: boolean;
   /**
-   * List of chart types to include from syncing the view's time zone (`timeZone`) with the data. Currently heat charts are included by default.
+   * List of chart types to include from syncing the view's [`timeZone`](/references/core/views/MapView/#timeZone) with the data. Currently heat charts are included by default.
+   *
    * **Note**: This applies only to charts supporting temporal data. Additionally if the data is binned, it applies only if the layer has the
    * capacity to handle the `/queryBins` operation. For any other case the chart will ignore the view's time zone regardless of the content of this list.
    *
@@ -1451,10 +1480,6 @@ export abstract class ArcgisChart extends LitElement {
    * ```ts
    * chartComponent.timeZone = "America/Los_Angeles";
    * ```
-   * @example
-   * ```html
-   * <arcgis-chart time-zone="America/Los_Angeles"></arcgis-chart>
-   * ```
    */
   accessor timeZone: MapView["timeZone"] | undefined;
   /**
@@ -1470,7 +1495,7 @@ export abstract class ArcgisChart extends LitElement {
    *
    * @example
    * ```ts
-   * myChart.tooltipFormatter = ({ statValue }) => {
+   * chartComponent.tooltipFormatter = ({ statValue }) => {
    *   return `<b>Custom tooltip</b> for ${statValue}`;
    * };
    * ```
@@ -1564,7 +1589,7 @@ export abstract class ArcgisChart extends LitElement {
    * **Note**: The chart types supported by this method are:
    * - Bar chart
    * - Box plot
-   * - Combo bar and line chart
+   * - Combo bar line chart
    * - Heat chart
    * - Histogram
    * - Line chart
@@ -1575,7 +1600,8 @@ export abstract class ArcgisChart extends LitElement {
   exportAsCSV(options?: CSVOptions): Promise<void>;
   /**
    * Exports the current chart as an image. Default format is `png`.
-   * - Alternative formats supported are: `jpeg` and `svg`.
+   * - Alternative formats supported are: `jpeg`, `jpg`, `webp`, and `svg`.
+   * - When WebP format is used on Safari, it will fallback to PNG rendering.
    *
    * @param format
    */
@@ -1636,7 +1662,11 @@ export abstract class ArcgisChart extends LitElement {
   readonly arcgisDataProcessComplete: import("@arcgis/lumina").TargetedEvent<this, DataProcessCompletePayload>;
   /** Event triggered when an error occurred while fetching of processing the data for the chart. */
   readonly arcgisDataProcessError: import("@arcgis/lumina").TargetedEvent<this, void>;
-  /** Event triggered when an invalid configuration is detected. */
+  /**
+   * Event triggered when an invalid configuration is detected.
+   *
+   * @deprecated since 5.1. Won't be replaced.
+   */
   readonly arcgisInvalidConfigWarningRaise: import("@arcgis/lumina").TargetedEvent<this, DataWarningObject>;
   /** Event triggered once a legend item visibility has been changed. */
   readonly arcgisLegendItemVisibilityChange: import("@arcgis/lumina").TargetedEvent<this, LegendItemVisibilityChangePayload>;