@arcgis/charts-components 4.33.0-next.110 → 4.33.0-next.112

package/dist/components/arcgis-chart/customElement.js

@@ -52,7 +52,7 @@ import { html as rl } from "lit-html";
 import { css as dS } from "@lit/reactive-element/css-tag.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.33/esri/copyright.txt for details.
-v4.33.0-next.110 */
+v4.33.0-next.112 */
 var tm = { exports: {} };
 function uS(t) {
   var e = new t(), i = e;
@@ -28274,9 +28274,6 @@ async function Ff(t) {
 }
 const uM = ({ message: t, heading: e, options: i }) => rl`<calcite-alert .icon=${i?.icon ?? "exclamationMarkTriangle"} .open=${i?.active === !0} .autoClose=${i?.autoClose ?? !1} .autoCloseDuration=${i?.duration ?? "medium"} scale=m .kind=${i?.kind ?? "danger"} .ariaHidden=${i?.active !== !0} dir=ltr role=alertdialog label="arcgis charts notify panel">${e !== void 0 ? rl`<div slot=title>${e}</div>` : null}${t !== void 0 ? rl`<div slot=message>${t}</div>` : null}</calcite-alert>`, fM = dS`.hide{display:none}.am5-modal{width:100%;height:100%;position:absolute;z-index:100000;top:0;left:0}.am5-modal-curtain{top:0;left:0;width:100%;height:100%;position:absolute;background:#fff!important;z-index:100}.am5-modal-wrapper{top:0;left:0;width:100%;height:100%;position:absolute;display:flex;align-items:center;justify-content:center;white-space:nowrap;background:#ffffff80;z-index:101}.am5-modal-content{display:inline-block;padding:1.2em;vertical-align:middle;text-align:start;white-space:normal;background:#fff;border-radius:4px;box-shadow:#00000073 0 0 36px;color:#000}.am5-layer-1000{z-index:1000!important}.arcgis-charts-modal{box-shadow:none!important}.arcgis-charts-modal-header{background-color:#0000000d;font-weight:700;padding:4px;align-content:center}.show{display:block}.notifyPanel{flex:0 1 auto}.disable-interactions{pointer-events:none}.dim-text{color:var(--arcgis-charts-dim-text)}.chart{flex-grow:1;overflow-y:hidden}.chart>div{justify-content:center;align-items:center}.chart .arcgis-charts-modal-inside{padding:1em 1em 1em 0}.chart .arcgis-charts-modal-inside ol{padding-left:2em}.chart .arcgis-charts-modal-curtain{width:100%;height:100%;position:absolute;top:0;left:0;z-index:2001;background-color:#fff;opacity:.5;opacity:1}.chart .arcgis-charts-modal-content{background:#fffc;color:#000;display:inline-block;top:0;left:0;overflow:visible;z-index:2002;position:absolute;max-width:90%;max-height:90%;width:auto!important;height:auto!important;margin:auto!important;inset:auto!important}.chart .arcgis-charts-modal-header{display:block;width:100%;min-height:1.8em;background:#0000000d}.chart .arcgis-charts-modal-close{display:block;position:absolute;top:.3em;right:.3em;background:url(data:image/svg+xml;charset=utf-8;base64,PHN2ZyBoZWlnaHQ9IjUxMiIgdmVyc2lvbj0iMSIgdmlld0JveD0iMCAwIDUxMiA1MTIiIHdpZHRoPSI1MTIiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PHBhdGggZD0iTTQ0NS4yIDEwOS4ybC00Mi40LTQyLjRMMjU2IDIxMy42IDEwOS4yIDY2LjhsLTQyLjQgNDIuNEwyMTMuNiAyNTYgNjYuOCA0MDIuOGw0Mi40IDQyLjRMMjU2IDI5OC40bDE0Ni44IDE0Ni44IDQyLjQtNDIuNEwyOTguNCAyNTYiLz48L3N2Zz4=) center center/80% no-repeat #6464641a;width:1.2em;height:1.2em;cursor:pointer}.chart .arcgis-charts-modal-title{font-weight:700;font-size:110%;padding:.5em 1.2em .5em 1em}:host{width:var(--chart-width, var(--arcgis-charts-default-width));height:var(--chart-height, var(--arcgis-charts-default-height));display:flex;flex-direction:row}`;
 class mM extends Oy {
-  //#endregion
-  //#region Lifecycle
-  // TODO: Investigate further if there is a way to refactor our payload types, without violating the required argument type for `this.listen`, so that these type casts are not needed.
   constructor() {
     super(), this.chartRef = Ny(), this.skipNextUpdate = !1, this.commonStrings = Gd({ name: "common", blocking: !0 }), this.errorStrings = Gd({ name: "errors", blocking: !0 }), this.noRenderProps = [
       "disableInteractions",
@@ -28319,57 +28316,24 @@ class mM extends Oy {
   get rotation() {
     return this._rotation;
   }
-  /**
-   * Applicable to bar chart, line chart, combo bar-line and box plot.
-   * When `true`, the chart is rotated 90 degrees so that the x-axis becomes vertical and the y-axis becomes horizontal.
-   *
-   * @type {boolean | undefined}
-   * @category Public
-   * @default undefined
-   */
   set rotation(e) {
     this._rotation = e, this.rotationChange(this.rotation);
   }
   get legendPosition() {
     return this._legendPosition;
   }
-  /**
-   * Used to set the legend's position on the chart.
-   *
-   * @remarks
-   * Not applicable to gauge.
-   * @type {WebChartLegendPositions | undefined}
-   * @category Public
-   * @default undefined
-   */
   set legendPosition(e) {
     this._legendPosition = e, this.legendPositionChange(this.legendPosition);
   }
   get legendVisibility() {
     return this._legendVisibility;
   }
-  /**
-   * When `true`, the legend is visible on the chart.
-   *
-   * @remarks
-   * Not applicable to gauge.
-   * @type {boolean | undefined}
-   * @category Public
-   * @default undefined
-   */
   set legendVisibility(e) {
     this._legendVisibility = e, this.legendVisibilityChange(this.legendVisibility);
   }
   get view() {
     return this._view;
   }
-  /**
-   * Used to access the LayerView instance in order to perform client-side queries.
-   *
-   * @type {MapView | SceneView | undefined}
-   * @category Public
-   * @default undefined
-   */
   set view(e) {
     const i = this.view;
     this._view = e, this.viewChange(this.view, i);
@@ -28377,59 +28341,22 @@ class mM extends Oy {
   get filterByExtent() {
     return this._filterByExtent;
   }
-  /**
-   * When `true`, all chart elements are filtered based on view extent.
-   *
-   * @type {boolean | undefined}
-   * @category Public
-   * @default undefined
-   */
   set filterByExtent(e) {
     this._filterByExtent = e, this.filterByExtentChanged(this.filterByExtent);
   }
   get disableInteractions() {
     return this._disableInteractions ?? !1;
   }
-  /**
-   * Disables all interactions on the chart.
-   *
-   * @type {boolean | undefined}
-   * @category Public
-   * @default false
-   */
   set disableInteractions(e) {
     this._disableInteractions = e, this.disableInteractionsChange(this.disableInteractions);
   }
   get featureIndex() {
     return this._featureIndex;
   }
-  /**
-   * The index of the feature to be rendered.
-   * Only used when the gauge is a feature-based gauge.
-   *
-   * @remarks
-   * Applicable to gauge only.
-   * @type {number | undefined}
-   * @category Public
-   * @default undefined
-   */
   set featureIndex(e) {
     const i = this.featureIndex;
     this._featureIndex = e, this.featureIndexChange(this.featureIndex, i);
   }
-  //#endregion
-  //#region Public Methods
-  /**
-   * Export the current chart to an image
-   *
-   * @param {"png" | "jpg"} [props.format] image format to export the chart to. Supports 'png' | 'jpg'
-   * @param {number | undefined} [props.quality] quality of the image should be 0 - 1. If outside of the range, it will default to 1
-   * @param {number | undefined} [props.maxWidth] max width in px
-   * @param {number | undefined} [props.minWidth] min width in px
-   * @param {number | undefined} [props.maxHeight] max height in px
-   * @param {number | undefined} [props.minHeight] min height in px
-   * @returns
-   */
   async exportImage(e) {
     if (!this.chart)
       throw new Error(this.errorStrings?.errors?.exportImageChartNotReady);
@@ -28439,22 +28366,9 @@ class mM extends Oy {
       throw new Error(this.errorStrings?.errors?.exportImage);
     }
   }
-  /**
-   * Clears all selection on the chart.
-   *
-   * @remarks
-   * Not applicable to gauge.
-   * @category Public
-   */
   async clearSelection() {
     this.chart !== void 0 && (this.chart.clearSelection(), this.filterBySelection === !0 && await this.refresh());
   }
-  /**
-   * Triggers an alert to display an error message.
-   *
-   * @category Public
-   * @param {string | undefined} [errorMessage]
-   */
   async errorAlert(e) {
     this.errorPolicy === us.Throw && (this.notifyHeading = this.errorStrings?.errorHeading, this.notifyMessage = e, this.notifyOptions = {
       kind: "danger",
@@ -28462,61 +28376,22 @@ class mM extends Oy {
       active: !0
     }, this.actionBarElement && (this.actionBarElement.forceDisableActions = !0), this.showNotifyPanel = !0);
   }
-  /**
-   * 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.
-   *
-   * @category Public
-   * @param {string | undefined} [message] The message to display in the notification panel.
-   * @param {string | undefined} [heading] The heading to display in the notification panel.
-   * @param {NotifyOptions | undefined} [options] The options to apply to the notification panel.
-   */
   async notify(e, i, a) {
     this.chart !== void 0 && this.chart.notify(e, i, a);
   }
-  /**
-   * Re-render the chart.
-   *
-   * @param {boolean} [props.updateData] Indicates whether to fetch new data. Default: true.
-   * @param {boolean} [props.updateExtent] Indicates whether the view's extent is to update. Default: false.
-   * @param {boolean} [props.resetAxesBounds] Option to reset the axes bounds along with the refresh. Default: false;
-   * @category Public
-   */
   async refresh(e) {
     const { updateData: i = !0, resetAxesBounds: a = !1, updateExtent: n = !1 } = e ?? {};
     this.updatedProps.add(i ? "forceDataUpdate" : "forceSimpleUpdate"), this.viewExtentUpdated = n, a && (delete this.config?.axes?.[0]?.minimum, delete this.config?.axes?.[0]?.maximum, delete this.config?.axes?.[1]?.minimum, delete this.config?.axes?.[1]?.maximum), await this.updated(), this.viewExtentUpdated = !1;
   }
-  /**
-   * Resets the chart zoom to bring it back to full extent
-   *
-   * @remarks
-   * Applicable to XY charts only.
-   * @category Public
-   */
   async resetZoom() {
     this.chart !== void 0 && this.chart.resetZoom();
   }
-  /**
-   * Switches the selection on the chart.
-   *
-   * @remarks
-   * Not applicable to gauge.
-   * @category Public
-   */
   async switchSelection() {
     this.chart !== void 0 && this.filterBySelection !== !0 && await this.chart.switchSelection();
   }
-  /**
-   * Called when the component is added to the DOM.
-   *
-   * @category Lifecycle
-   */
   connectedCallback() {
     super.connectedCallback(), this.addConfigListeners(), document.addEventListener("arcgisSelectionComplete", this.handleExternalSelection);
   }
-  /** @category Lifecycle */
   async load() {
     if (this.syncSelectionsBetweenChartAndLayerViewPolicy === ws.Enabled) {
       const e = this.getSelectionFromLayerView();
@@ -28551,22 +28426,12 @@ class mM extends Oy {
       }
     }, cS);
   }
-  /**
-   * TODO: [MIGRATION] consider whether in this case migrating to `hasChanged()` parameter on `@property()` decorator would be better than using shouldUpdate
-   * https://lit.dev/docs/components/properties/#haschanged
-   * Otherwise, you should simplify the code inserted by the codemod a bit (merge shouldUpdate and _shouldUpdate into one method)
-   */
   shouldUpdate(e) {
     let i = !1;
     return [...e.entries()].forEach(([a, n]) => {
       this._shouldUpdate(this[a], n, a) && (i = !0);
     }), i;
   }
-  /**
-   * Prevents render for noRenderProps
-   *
-   * @category Lifecycle
-   */
   _shouldUpdate(...e) {
     const [i, , a] = e;
     this.updatedProps.add(a);
@@ -28575,12 +28440,9 @@ class mM extends Oy {
     const o = !this.skipNextUpdate && !n;
     return this.skipNextUpdate = !1, o;
   }
-  /** @category Lifecycle */
   async willUpdate(e) {
     e.has("model") && this.modelChange(), e.has("selectionData") && this.selectionDataChange(), e.has("layer") && await this.layerChange(), e.has("runtimeDataFilters") && await this.runtimeDataFiltersChange(), e.has("returnFeaturesExtent") && await this.returnFeaturesExtentChange(), e.has("timeZone") && this.timeZoneChange(), e.has("filterBySelection") && this.filterBySelectionChanged(), e.has("layerFilterChangePolicy") && (this.hasUpdated || this.layerFilterChangePolicy !== Ls.Refresh) && this.layerFilterChangePolicyCallBack(this.layerFilterChangePolicy), e.has("viewTimeExtentChangePolicy") && (this.hasUpdated || this.viewTimeExtentChangePolicy !== vo.Ignore) && this.viewTimeExtentChangePolicyCallback(this.viewTimeExtentChangePolicy), e.has("layerRendererChangePolicy") && (this.hasUpdated || this.layerRendererChangePolicy !== Ts.Refresh) && this.layerRendererChangePolicyCallBack(this.layerRendererChangePolicy), e.has("config") && this.configChange(this.config, e.get("config")), e.has("layerFieldsChangePolicy") && (this.hasUpdated || this.layerFieldsChangePolicy !== As.Refresh) && this.layerFieldsChangePolicyCallBack(this.layerFieldsChangePolicy);
   }
-  /** @category Lifecycle */
-  /** This lifecycle method is not expected to return a promise. The returned promise will be ignored by Lit rather than awaited. */
   async updated() {
     if (this.chart === void 0 && this.chartCreationProcessing !== void 0 && (await this.chartCreationProcessing, this.chartCreationProcessing = void 0), this.config !== void 0 && this.chart !== void 0 && !this.showNotifyPanel)
       try {
@@ -28591,25 +28453,12 @@ class mM extends Oy {
     else this.chart === void 0 && this.chartCreationProcessing === void 0 && !this.showNotifyPanel && await this.createChartInstance();
     this.placeholder !== void 0 ? await this.notify(this.placeholder) : this.enableConfiguration && ds(this.config) && this.applyPlaceholderForPartialConfig(this.config), this.actionBarElement !== void 0 && rS(this.actionBarElement, this.el, this.config);
   }
-  /** @category Lifecycle */
-  /** This lifecycle method is not expected to return a promise. The returned promise will be ignored by Lit rather than awaited. */
   async loaded() {
     this.modelChange(), this.chartRef.value !== void 0 && await this.createChartInstance();
   }
-  /**
-   * Called when the component is removed from the DOM.
-   *
-   * @category Lifecycle
-   */
   disconnectedCallback() {
     super.disconnectedCallback(), this.removeConfigListeners(), this.removeLayerListeners(), this.removeExtentChangeListeners(), this.removeViewTimeExtentChangeListener(), document.removeEventListener(aS.SelectionComplete, this.handleExternalSelection), this.chart !== void 0 && this.chart.dispose();
   }
-  //#endregion
-  //#region Private Methods
-  /**
-   * Apply the selection from the view to the chart.
-   * @category Public
-   */
   applySelectionFromView() {
     const e = this.getSelectionFromLayerView();
     e && (this.selectionData = {
@@ -28617,42 +28466,15 @@ class mM extends Oy {
       selectionSource: Xe.ProgrammaticSelection
     }, this.arcgisSelectionComplete.emit({ selectionData: this.selectionData, model: this._model }));
   }
-  /**
-   * Listener on event coming from the chart container indicating the chart data has been processed
-   * emitting an event carrying the data
-   *
-   * @param {CustomEvent<WebChartDataTypes>} event The event carrying the chart data processed by the core
-   * @category Custom-event handler
-   */
   handleDataProcessComplete(e) {
     this.arcgisDataProcessComplete.emit({ chartData: e.detail, model: this._model });
   }
-  /**
-   * Listener on event coming from the chart container when the chart data has been fetched but not yet fully processed.
-   * For instance it can be useful for a pie chart to see all the slices before they get grouped into an 'other' slice during the post-processing step.
-   *
-   * @param {CustomEvent<WebChartDataTypes>} event The event carrying the fetched data
-   * @category Custom-event handler
-   */
   handleDataFetchComplete(e) {
     this.arcgisDataFetchComplete.emit(e.detail);
   }
-  /**
-   * Listener on event coming from the chart container indicating a legend item visibility has been changed
-   * emitting an event carrying the item id and its new visibility
-   *
-   * @param {CustomEvent} event The event carrying the item id and its new visibility
-   * @category Custom-event handler
-   */
   handleLegendItemVisibilityChanged(e) {
     ub(e, this.config), this.arcgisLegendItemVisibilityChange.emit({ legendItemVisibility: e.detail, model: this._model });
   }
-  /**
-   * Listener on event coming from the chart container indicating a chart is updated
-   *
-   * @param {CustomEvent} event The event carrying the ValidationStatus
-   * @category Custom-event handler
-   */
   handleUpdateCompleted(e) {
     if (this.enableConfiguration) {
       const i = e.detail, a = this.errorStrings?.notifications;
@@ -28669,22 +28491,9 @@ class mM extends Oy {
     }
     this.arcgisUpdateComplete.emit(e.detail);
   }
-  /**
-   * Listener on event coming from the chart container indicating an error in the data set
-   *
-   * @param {CustomEvent} event The event carrying details about the error
-   * @category Custom-event handler
-   */
   handleBadDataWarningRaise(e) {
     this.arcgisBadDataWarningRaise.emit(e.detail);
   }
-  /**
-   * Listener on event coming from the chart container indicating the chart series color
-   * have been assigned
-   *
-   * @param {CustomEvent<SeriesSymbolsMap>} event The event carrying the series colors
-   * @category Custom-event handler
-   */
   handleSeriesColorsChange(e) {
     this.arcgisSeriesColorChange.emit({
       data: e.detail.data,
@@ -28692,21 +28501,9 @@ class mM extends Oy {
       model: this._model
     });
   }
-  /**
-   * Listener on event coming from the chart container indicating a selection has been applied to the chart.
-   *
-   * @param {CustomEvent<SelectionData>} event The event carrying the selected elements
-   * @category Custom-event handler
-   */
   handleSelection(e) {
     this.selectionData = { ...e.detail }, this.arcgisSelectionComplete.emit({ selectionData: e.detail, model: this._model });
   }
-  /**
-   * Listener on event coming from the chart container
-   * when more elements than the authorized limit have been selected.
-   *
-   * @category Custom-event handler
-   */
   handleTooManySelectedElements() {
     this.errorPolicy === us.Throw && (this.notifyHeading = this.errorStrings?.tooManySelectedElements?.title, this.notifyMessage = this.errorStrings?.tooManySelectedElements?.message, this.notifyOptions = {
       kind: "warning",
@@ -28715,199 +28512,63 @@ class mM extends Oy {
       active: !0
     }, this.showNotifyPanel = !0);
   }
-  /**
-   * Listener on event coming from the closure of a calcite-alert.
-   * The handler helps keeping in sync the boolean `showNotifyPanel` with the panel's state.
-   *
-   * @param {CustomEvent} event
-   * @category Custom-event handler
-   */
   handleAlertClosed(e) {
     e.target === this.el && (this.skipNextUpdate = !0, this.showNotifyPanel = !1);
   }
-  /**
-   * Listener on event coming from the chart container indicating the chart axes
-   * min and max values have been computed
-   *
-   * @param {CustomEvent} event The event carrying the axes min and max
-   * @category Custom-event handler
-   */
   handleAxesMinMaxChange(e) {
     this.arcgisAxesMinMaxChange.emit({ bounds: e.detail, model: this._model });
   }
-  /**
-   * Listener on event coming from the chart container indicating a the series order changed on the chart.
-   *
-   * @param event The event carrying a list of series id as they are visually ordered on the chart
-   * @category Custom-event handler
-   */
   handleSeriesOrder(e) {
     this.arcgisSeriesOrder.emit(e.detail);
   }
-  /**
-   * Called every time the model property is updated.
-   *
-   * @category Watch handler
-   */
   modelChange() {
     sS(this.model) ? (this._model = this.model, this.config = Ee(this._model?.getConfig()), this.addModelListeners()) : this.config = this.model;
   }
-  /**
-   * Called every time the `selectionData` is updated.
-   * Updates the selections in the `view.selectionManager` if the sync between the chart and the layer view is enabled.
-   *
-   * @category private
-   */
   async selectionDataChange() {
     this.layer !== void 0 && this.syncSelectionsBetweenChartAndLayerViewPolicy === ws.Enabled && this.view !== void 0 && this.setSelectionInLayerView();
   }
-  /**
-   * Called every time the view property is updated.
-   * Add listeners to it to keep the chart in sync.
-   *
-   * @param {MapView | SceneView | undefined} newView The new view
-   * @param {MapView | SceneView | undefined} oldView The old view
-   * @category Watch handler
-   */
   async viewChange(e, i) {
     await this.setExtentChangeListener(), await this.setViewTimeExtentChangeListener(), i !== void 0 && e === void 0 && await this.refresh(), this.view ? this.setViewSelectionsChangeListener() : this.removeViewSelectionsChangeListener();
   }
-  /**
-   * Called every time the layer property is updated.
-   * Adds listeners to it to keep the chart in sync.
-   *
-   * @category Watch handler
-   */
   async layerChange() {
     await this.addLayerListeners();
   }
-  /**
-   * Called every time the `runtimeDataFilters` property is updated.
-   * The property name is added to the `updatedProps` list in order to trigger later a data update.
-   * The mechanism is also done by `componentShouldUpdate` but doesn't always work when multiple properties are
-   * updated at the same time (e.g. only 1 `componentShouldUpdate` is called while 2 properties were changed).
-   * For that reason all the properties implying a data update (see this.dataUpdateNeededProps) need a `@Watch`
-   * to ensure the chart update to consider them properly.
-   * Refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/6095
-   *
-   * @category Watch handler
-   */
   async runtimeDataFiltersChange() {
     this.updatedProps.add("runtimeDataFilters");
   }
-  /**
-   * Called every time the `returnFeaturesExtent` property is updated.
-   * The property name is added to the `updatedProps` list in order to trigger later a data update.
-   * The mechanism is also done by `componentShouldUpdate` but doesn't always work when multiple properties are
-   * updated at the same time (e.g. only 1 `componentShouldUpdate` is called while 2 properties were changed).
-   * For that reason all the properties implying a data update (see this.dataUpdateNeededProps) need a `@Watch`
-   * to ensure the chart update to consider them properly.
-   * Refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/6095
-   *
-   * @category Watch handler
-   */
   async returnFeaturesExtentChange() {
     this.updatedProps.add("returnFeaturesExtent");
   }
-  /**
-   * Called every time the feature index is updated.
-   *
-   * @type {number} newFeatureIndex The new gauge feature index to render
-   * @type {number | undefined} oldFeatureIndex The old gauge feature index to remove
-   * @param newFeatureIndex The new gauge feature index to render
-   * @category Watch handler
-   */
   featureIndexChange(e, i) {
     i === void 0 && typeof e == "number" && this.updatedProps.add("forceDataUpdate");
   }
-  /**
-   * Called every time the disableInteractions property is updated.
-   * Helps setting a css class on the chart to either enable or disable the chart interactions.
-   *
-   * @param {boolean} newValue The new value for the disableInteractions property
-   */
   async disableInteractionsChange(e) {
     navigator.userAgent.search("Firefox") !== -1 && (e ? this.chartRef.value?.classList.add(Ca.DisableInteractions) : this.chartRef.value?.classList.remove(Ca.DisableInteractions));
   }
-  /**
-   * Called every time the rotation property is updated
-   *
-   * @param {boolean} newRotation The new rotation value for the chart
-   * @category Watch handler
-   */
   rotationChange(e) {
     e !== void 0 && (this.config = mb(e, this.config));
   }
-  /**
-   * Called every time the position of the legend is updated
-   *
-   * @param {WebChartLegendPositions} newLegendPosition The new position of the legend
-   * @category Watch handler
-   */
   legendPositionChange(e) {
     e !== void 0 && (this.config = eM(e, this.config));
   }
-  /**
-   * Called every time the visibility of the legend is updated
-   *
-   * @param {boolean} newLegendVisibility The new visibility of the legend
-   * @category Watch handler
-   */
   legendVisibilityChange(e) {
     e !== void 0 && (this.config = tM(e, this.config));
   }
-  /**
-   * Called every time the time zone is updated
-   *
-   * @category Watch handler
-   */
   timeZoneChange() {
     this.updateConfigTimeZone();
   }
-  /**
-   * Called every time the filter by selection is updated.
-   * Resets the axes min/max.
-   *
-   * @category Watch handler
-   */
   filterBySelectionChanged() {
     this.config = iM(this.config);
   }
-  /**
-   * Called every time the property `layerFilterChangePolicy` changes.
-   * Adds a listener on the layer's filter when the property is `refresh` or `undefined`, removes it otherwise.
-   *
-   * @param {LayerFilterChangePolicy | undefined} newRefreshOnLayerFilter The new value of refresh on layer filter change
-   * @category Watch handler
-   */
   layerFilterChangePolicyCallBack(e) {
     e !== Ls.Ignore ? this.setLayerFilterListener() : this.removeLayerFilterListener();
   }
-  /**
-   * Called every time the property `layerFilterChangePolicy` changes.
-   * Adds a listener on the layer's time extent when the property is `refresh`, removes it otherwise.
-   * @param {ViewTimeExtentChangePolicy | undefined} newViewTimeExtentChangePolicy The new value of refresh on view time extent change
-   * @category Watch handler
-   */
   viewTimeExtentChangePolicyCallback(e) {
     e !== vo.Refresh ? this.removeViewTimeExtentChangeListener() : this.setViewTimeExtentChangeListener();
   }
-  /**
-   * Called every time when the property `layerRendererChangePolicy` changes
-   * Adds a listener on the layer's renderer when the property is `true`, removes it otherwise.
-   *
-   * @param {LayerRendererChangePolicy | undefined} newRefreshOnLayerRenderer The new value of refresh on layer renderer
-   * @category Watch handler
-   */
   layerRendererChangePolicyCallBack(e) {
     e !== Ts.Ignore ? this.setLayerRendererListener() : this.removeLayerRendererListener();
   }
-  /**
-   * Called every time when the property `filterByExtent` changes
-   * Adds a listener on the layer's renderer when the property is `true`, removes it otherwise.
-   *
-   * @category Watch handler
-   */
   async filterByExtentChanged(e) {
     e || await this.refresh({
       updateData: !0,
@@ -28915,53 +28576,23 @@ class mM extends Oy {
       updateExtent: !0
     }), this.filterByExtent ? this.setExtentChangeListener() : this.removeExtentChangeListeners();
   }
-  /**
-   * Called every time the property `config` changes.
-   *
-   * @category Watch handler
-   */
   async configChange(e, i) {
     this.arcgisConfigChange.emit({ newConfig: e, oldConfig: i, functionCalled: this.lastModelFunctionCalled }), this.lastModelFunctionCalled = void 0, this.actionBarElement && !ds(e) && (this.actionBarElement.forceDisableActions = !1);
   }
-  /**
-   * Called every time when the property `layerFieldsChangePolicy` changes
-   * Adds a listener on the layer's fields when the property is `true`, removes it otherwise.
-   *
-   * @param {LayerFieldsChangePolicy | undefined} newRefreshOnLayerFields The new value of refresh on layer fields
-   * @category Watch handler
-   */
   layerFieldsChangePolicyCallBack(e) {
     e !== As.Ignore ? this.setLayerFieldsListener() : this.removeLayerFieldsListener();
   }
-  /**
-   * Adds listeners for events from charts config UI.
-   *
-   * @category Private
-   */
   addConfigListeners() {
     document.addEventListener("arcgisChartsConfigPanelNumberChange", this.configPanelNumberChange), document.addEventListener("arcgisChartsConfigDataChangeError", this.configDataChangeError), document.addEventListener("arcgisChartsConfigPopoverOpenChange", this.configPopoverOpenChange);
   }
-  /**
-   * Removes listeners for events from charts config UI.
-   *
-   * @category Private
-   */
   removeConfigListeners() {
     document.removeEventListener("arcgisChartsConfigPanelNumberChange", this.configPanelNumberChange), document.removeEventListener("arcgisChartsConfigDataChangeError", this.configDataChangeError), document.removeEventListener("arcgisChartsConfigPopoverOpenChange", this.configPopoverOpenChange);
   }
-  /**
-   * Get the selection from the layer's view.
-   * @category Private
-   */
   getSelectionFromLayerView() {
     let e;
     const i = this.view;
     return i !== void 0 && "selectionManager" in i && "getSelection" in i.selectionManager && (e = i?.selectionManager?.getSelection(this.layer)), e;
   }
-  /**
-   * Set the selection in the layer's view.
-   * @category Private
-   */
   setSelectionInLayerView() {
     let e;
     const i = this.selectionData?.selectionOIDs?.length === 0 || this.selectionData?.selectionOIDs === void 0 || this.selectionData?.selectionSource === Xe.ClearSelection, a = (this.selectionData?.selectionOIDs?.length ?? 0) > 0;
@@ -28969,11 +28600,6 @@ class mM extends Oy {
     const n = this.view;
     e && n !== void 0 && "selectionManager" in n && "setSelection" in n.selectionManager && n.selectionManager.setSelection(this.layer, e);
   }
-  /**
-   * Adds the listener to the model to listen to the config changes
-   *
-   * @category Private
-   */
   addModelListeners() {
     this._model !== void 0 && this._model.addEventListener("arcgisChartsModelConfigChange", async (e) => {
       const i = e;
@@ -28986,129 +28612,52 @@ class mM extends Oy {
       })), this.config = Ee(a);
     });
   }
-  /**
-   * Adds the listener to listen to the layer definitionExpression and renderer changes
-   *
-   * @category Private
-   */
   async addLayerListeners() {
     this.removeLayerListeners(), this.layerFilterListener = await xf(this), this.layerRendererListener = await Cf(this), this.layerFieldsListener = await vf(this), this.viewSelectionsChangeListener = await Ff(this);
   }
-  /**
-   * Adds the listener to listen to the layer definitionExpression changes
-   *
-   * @category Private
-   */
   async setLayerFilterListener() {
     this.removeLayerFilterListener(), this.layerFilterListener = await xf(this);
   }
-  /**
-   * Adds a listener to listen to the layer's renderer changes when color match is enabled for a layer data source
-   *
-   * @category Private
-   */
   async setLayerRendererListener() {
     this.removeLayerRendererListener(), this.layerRendererListener = await Cf(this);
   }
-  /**
-   * Adds a listener to listen to the layer's fields changes
-   *
-   * @category Private
-   */
   async setLayerFieldsListener() {
     this.removeLayerFieldsListener(), this.layerFieldsListener = await vf(this);
   }
-  /**
-   * Adds a listener to listen to the view's extent change
-   *
-   * @category Private
-   */
   async setExtentChangeListener() {
     this.filterByExtent && (this.removeExtentChangeListeners(), this.extentChangeListeners = await cM(this));
   }
-  /**
-   * Adds a listener to listen to the view's time extent change
-   * @category Private
-   */
   async setViewTimeExtentChangeListener() {
     this.removeViewTimeExtentChangeListener(), this.viewTimeExtentChangeListener = await dM(this);
   }
-  /**
-   * Adds a listener to listen to the selections change in the view
-   * @category Private
-   */
   async setViewSelectionsChangeListener() {
     this.removeViewSelectionsChangeListener(), this.viewSelectionsChangeListener = await Ff(this);
   }
-  /**
-   * Removes the listeners added to listen to the layer definitionExpression and renderer changes
-   *
-   * @category Private
-   */
   removeLayerListeners() {
     this.removeLayerFilterListener(), this.removeLayerRendererListener(), this.removeLayerFieldsListener();
   }
-  /**
-   * Removes the layer filter listener when layer definitionExpression changes
-   *
-   * @category Private
-   */
   removeLayerFilterListener() {
     this.layerFilterListener?.remove();
   }
-  /**
-   * Removes the layer renderer listener when layer renderer changes
-   *
-   * @category Private
-   */
   removeLayerRendererListener() {
     this.layerRendererListener?.remove();
   }
-  /**
-   * Removes the layer fields listener when layer fields change
-   *
-   * @category Private
-   */
   removeLayerFieldsListener() {
     this.layerFieldsListener?.remove();
   }
-  /**
-   * Removes the listeners added to listen to the view's extent change
-   *
-   * @category Private
-   */
   removeExtentChangeListeners() {
     this.extentChangeListeners !== void 0 && (this.extentChangeListeners.forEach((e) => e.remove()), this.extentChangeListeners = []);
   }
-  /**
-   * Removes the listener added to listen to the selections change in the view
-   * @category Private
-   */
   removeViewSelectionsChangeListener() {
     this.viewSelectionsChangeListener !== void 0 && this.viewSelectionsChangeListener.remove();
   }
-  /**
-   * Removes the listeners added to listen to the view's time extent change
-   * @category Private
-   */
   removeViewTimeExtentChangeListener() {
     this.viewTimeExtentChangeListener?.remove(), this.runtimeDataFilters?.timeExtent && delete this.runtimeDataFilters.timeExtent;
   }
-  /**
-   * Applies the placeholder message for a partial config.
-   *
-   * @param {WebChart | undefined} config
-   * @category Private
-   */
   async applyPlaceholderForPartialConfig(e) {
     const i = z(e?.series), a = rM(i, this.errorStrings);
     await this.notify(a);
   }
-  /**
-   * If the chart config version is newer than the current one, display a message in a popup.
-   *
-   * @category Private
-   */
   checkForIncompatibleChartVersion() {
     const e = this.config?.version;
     this.errorPolicy === us.Throw && gb(e).versionStatus === Iy.Newer && (this.notifyHeading = this.errorStrings.incompatibleChartVersion?.title, this.notifyMessage = this.errorStrings.incompatibleChartVersion?.message ? Gt(this.errorStrings.incompatibleChartVersion.message, {
@@ -29119,29 +28668,12 @@ class mM extends Oy {
       active: !0
     }, this.showNotifyPanel = !0);
   }
-  /**
-   * Checks if this chart component's model exists in provided the model list.
-   *
-   * @param {ChartModel[]} modelList
-   * @category Private
-   */
   ourModelExistsIn(e) {
     return e.some((i) => this._model?.isSameChartAs(i));
   }
-  /**
-   * Updates the config's time zone if needed.
-   *
-   * @category Private
-   */
   updateConfigTimeZone() {
     this.config?.axes?.[0]?.valueFormat.type === b.DateAxisFormat && (this.config.axes[0].valueFormat.intlOptions.timeZone = hb(this.timeZone));
   }
-  /**
-   * Gathers the component's runtime chart options
-   *
-   * @param dataUpdated
-   * @returns
-   */
   gatherComponentOptions(e) {
     let i = this.runtimeDataFilters;
     return this.view && this.viewTimeExtentChangePolicy === vo.Refresh && this.view.timeExtent?.start != null && this.view.timeExtent?.end != null && (i = {
@@ -29184,12 +28716,6 @@ class mM extends Oy {
       pieChartLegendValueLabelFormatter: this.legendValueLabelFormatter
     };
   }
-  /**
-   * creates arcgis chart instance
-   *
-   * @param {boolean} firstCreation Indicates whether it's the first time the component is created
-   * @category Private
-   */
   async createChartInstance(e = !0) {
     this.chartCreationProcessing !== void 0 && (await this.chartCreationProcessing, this.chartCreationProcessing = void 0), this.updateConfigTimeZone(), this.checkForIncompatibleChartVersion(), this.updatedProps.clear();
     try {
@@ -29218,9 +28744,6 @@ class mM extends Oy {
       i.name === tn.QueryFeaturesError ? this.arcgisDataProcessError.emit(i.details) : this.arcgisRuntimeError.emit(i.details ?? i), this.errorAlert(i?.message), this.chart?.dispose(), this.chartCreationProcessing = void 0, this.chart = void 0;
     }
   }
-  //#endregion
-  //#region Rendering
-  /** @category Lifecycle */
   render() {
     const e = this.showNotifyPanel ? uM({ heading: this.notifyHeading, message: this.notifyMessage, options: this.notifyOptions }) : null, i = this.showNotifyPanel && this.notifyOptions?.kind === "danger" ? Ca.Hide : `${Ca.Chart} ${Ca.Show}`, a = this.showNotifyPanel ? `${Ca.Show} ${Ca.NotifyPanel}` : Ca.Hide;
     return Dy`<slot name=${iS.actionBar} @slotchange=${(n) => {