@arcgis/charts-components 4.34.0-next.99 → 4.34.0

package/dist/chunks/serial-chart-model.js

@@ -1,7 +1,8 @@
-import { WebChartStackedKinds as u } from "@arcgis/charts-spec";
-import "lodash-es";
+import "@arcgis/toolkit/intl";
+import { isEqual as x } from "lodash-es";
+import { e as F, W as v, a as l } from "./series-types.js";
+import { aB as B, aq as I, aw as O, ai as b, ag as U, b as m, y as M, ci as L } from "./interfaces.js";
 import "d3-array";
-import { at as F, aj as A, ab as v, a9 as B, k as g, cr as c, q as O, c7 as x } from "./interfaces.js";
 import "@arcgis/core/geometry/support/jsonUtils.js";
 import "@arcgis/core/rest/support/AttributeBinsQuery.js";
 import "@arcgis/core/rest/support/Query.js";
@@ -9,186 +10,191 @@ import "@arcgis/core/rest/support/StatisticDefinition.js";
 import "@arcgis/core/time/TimeExtent.js";
 import "@arcgis/core/core/promiseUtils.js";
 import "@arcgis/core/request.js";
-import "@arcgis/toolkit/intl";
 import "./runtime.js";
 import "@arcgis/toolkit/dom";
-import { C, M, b as U, a as b } from "./model-with-y-guides.js";
-import { l as S, j as T } from "./index5.js";
-import { x as L, y as w, z as D, A as N, B as E, C as V, D as k, E as W, F as X, G as P, H as j, e as _, r, t as o, u as z, c as Y, d as K, q as G, I as q, J as f, K as R, w as H, k as J, L as Q, j as Z, M as $, N as ee, O as d, P as h, Q as m, R as p, S as y, T as ie, U as te, i as se } from "./data.js";
-import { S as ae } from "./common.js";
-import { M as oe, a as ne, b as re, c as le } from "./model-with-data-labels.js";
-import { M as ge } from "./model-with-rotation.js";
+import { C as T, M as w, b as D, a as P } from "./model-with-multi-axes.js";
+import { l as n, j as a, k as g } from "./index4.js";
+import { q as V, r as N, t as W, v as k, w as E, x as R, y as z, z as K, A as j, B as q, C as G, b as _, f as h, h as c, u as X, s as f, e as Y, i as H, D as y, E as p, F as u, G as J, H as Q, k as Z, I as S, J as $, d as ee } from "./data2.js";
+import { b as C, c as A, a as te } from "./data.js";
+import { S as ie } from "./common.js";
+import { M as se, a as re, b as oe, c as ne } from "./model-with-data-labels.js";
+import { M as ae } from "./model-with-rotation.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.99 */
-class ce extends C {
+v4.34.0 */
+class le extends T {
   /**
-   * Sets the time interval size for a temporal bar/line chart.
-   * @returns {number | undefined}
+   * Time interval size for a temporal bar/line chart.
    */
-  getTemporalBinningSize() {
-    return L(this._config);
+  get temporalBinningSize() {
+    return V(this._config);
   }
-  /**
-   * Sets the time interval size for a temporal bar/line chart.
-   * @param {number | undefined} newSize The new time interval size.
-   */
-  setTemporalBinningSize(e) {
-    w(e, this._config), this.emitConfigUpdate("setTemporalBinningSize");
+  set temporalBinningSize(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      N(e, this._config), this.emitConfigUpdate("temporalBinningSize");
+    });
   }
   /**
-   * Gets the time interval units for a temporal bar/line chart.
-   * @returns {WebChartFixedDateBinningUnits | undefined}
+   * Time interval units for a temporal bar/line chart.
    */
-  getTemporalBinningUnit() {
-    return D(this._config);
+  get temporalBinningUnit() {
+    return W(this._config);
   }
-  /**
-   * Sets the time interval units for a temporal bar/line chart.
-   * @param {WebChartFixedDateBinningUnits | undefined} newUnit The new time interval units.
-   */
-  setTemporalBinningUnit(e) {
-    N(e, this._config), this.emitConfigUpdate("setTemporalBinningUnit");
+  set temporalBinningUnit(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      k(e, this._config), this.emitConfigUpdate("temporalBinningUnit");
+    });
   }
   /**
-   * Gets the time aggregation type for a temporal bar/line chart.
-   * @returns {WebChartTimeAggregationTypes | undefined}
+   * Time aggregation type for a temporal bar/line chart.
    */
-  getTimeAggregationType() {
+  get timeAggregationType() {
     return E(this._config);
   }
-  /**
-   * Sets the time aggregation type for a temporal bar/line chart.
-   * @param {WebChartTimeAggregationTypes | undefined} newTimeAggregationType The new time aggregation type.
-   */
-  setTimeAggregationType(e) {
-    V(e, this._config), this.emitConfigUpdate("setTimeAggregationType");
+  set timeAggregationType(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      R(e, this._config), this.emitConfigUpdate("timeAggregationType");
+    });
   }
   /**
-   * Gets whether to trim incomplete time intervals for a temporal bar/line chart.
-   * @returns {boolean | undefined}
+   * Whether to trim incomplete time intervals for a temporal bar/line chart.
    */
-  getTrimIncompleteTimeInterval() {
-    return k(this._config);
+  get trimIncompleteTimeInterval() {
+    return z(this._config);
   }
-  /**
-   * Sets whether to trim incomplete time intervals for a temporal bar/line chart.
-   * @param {boolean | undefined} newTrimIncompleteTimeInterval The new state.
-   */
-  setTrimIncompleteTimeInterval(e) {
-    W(e, this._config), this.emitConfigUpdate("setTrimIncompleteTimeInterval");
+  set trimIncompleteTimeInterval(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      K(e, this._config), this.emitConfigUpdate("trimIncompleteTimeInterval");
+    });
   }
   /**
-   * Gets the policy which tells the chart how to handle null values.
+   * Policy which tells the chart how to handle null values.
    *
    * `null`: Break the bar where null values are present.
    *
    * `zero`: Treats null values as zero.
    *
    * `interpolate`: Bar series: same effect as `null` - Line series: connects the lines across null values.
-   *
-   * @return {WebChartNullPolicyTypes | undefined}
    */
-  getNullPolicy() {
-    return X(this._config);
+  get nullPolicy() {
+    return j(this._config);
   }
-  /**
-   * Sets the policy which tells the chart how to handle null values.
-   *
-   * `null`: Break the bar where null values are present.
-   *
-   * `zero`: Treats null values as zero.
-   *
-   * `interpolate`: Bar series: same effect as `null` - Line series: connects the lines across null values.
-   *
-   * @param {WebChartNullPolicyTypes | undefined} newNullPolicy The new null policy.
-   */
-  setNullPolicy(e) {
-    P(e, this._config), this.emitConfigUpdate("setNullPolicy");
+  set nullPolicy(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      q(e, this._config), this.emitConfigUpdate("nullPolicy");
+    });
   }
   /**
    * Resets the time interval to default for a temporal line chart.
    */
   resetTimeInterval() {
-    j(this._config), this.emitConfigUpdate("resetTimeInterval");
+    this.guardSetterFromAsyncOverwrite(() => {
+      G(this._config), this.emitConfigUpdate("resetTimeInterval");
+    });
   }
 }
-const fe = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, de = (s, e, i) => {
-  i.series?.[e] && (i.series[e].assignToSecondValueAxis = s);
-}, he = (s, e) => e.series?.[s]?.name, me = (s, e, i) => {
-  i.series?.[e] && (i.series[e].name = s);
-}, pe = (s, e) => {
-  const i = e.series?.[s];
-  let t;
-  return S(i) ? t = i.fillSymbol?.color : T(i) && (t = i.lineSymbol?.color), t;
-}, ye = (s, e, i) => {
-  const t = i.series?.[e];
-  t && (S(t) ? t.fillSymbol = {
-    ...F(e),
-    ...t.fillSymbol,
+const ge = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, he = (s) => {
+  const { assign: e, seriesIndex: t, config: i, commonStrings: r } = s;
+  e && i.axes !== void 0 && !i.axes?.[2] && (i.axes[2] = O(r, v.BarSeries)[1]), i.series && i.series.forEach((o, d) => {
+    d === t ? o.assignToSecondValueAxis = e : d !== t && o?.assignToSecondValueAxis !== !0 && (o.assignToSecondValueAxis = !1);
+  }), i.axes?.[2] && !i.series.some((o) => o.assignToSecondValueAxis) && i.axes.splice(2, 1);
+}, ce = (s, e) => e.series?.[s]?.name, de = (s, e, t) => {
+  t.series?.[e] && (t.series[e].name = s);
+}, me = (s, e) => {
+  const t = e.series?.[s];
+  let i;
+  return n(t) ? i = t.fillSymbol?.color : a(t) && (i = t.lineSymbol?.color), i;
+}, fe = (s, e, t) => {
+  const i = t.series?.[e];
+  i && (n(i) ? i.fillSymbol = {
+    ...B(e),
+    ...i.fillSymbol,
     color: s
-  } : T(t) && (t.lineSymbol = {
-    ...A(e),
-    ...t.lineSymbol,
+  } : a(i) && (i.lineSymbol = {
+    ...I(e),
+    ...i.lineSymbol,
     color: s
   }));
-}, ue = (s) => s.series.map((e) => e.id), Ce = (s, e) => {
+}, ye = (s) => s.series.map((e) => e.id), pe = (s, e) => {
   e.series?.sort(
-    (i, t) => s.findIndex((a) => i.id === a) - s.findIndex((a) => t.id === a)
+    (t, i) => s.findIndex((r) => t.id === r) - s.findIndex((r) => i.id === r)
   );
-}, Se = (s) => s.stackedType ?? u.Side, Te = async (s) => {
-  const { newStackedType: e, config: i, layerInfo: t } = s;
-  if (i.stackedType = e, t !== void 0) {
-    const a = await _({
-      config: i,
-      layerInfo: t,
-      numericFields: o(i),
-      aggregationType: r(i)
+}, ue = (s) => s.stackedType ?? F.Side, Se = (s) => {
+  const { newStackedType: e, config: t, layerInfo: i, commonStrings: r } = s;
+  if (t.stackedType = e, i !== void 0) {
+    const o = _({
+      config: t,
+      layerInfo: i,
+      commonStrings: r,
+      numericFields: c(t),
+      aggregationType: h(t)
     });
-    z(i, 1, a);
+    X(t, 1, o);
   }
-  i.axes?.[1] && (e === u.Stacked100 ? i.axes[1].valueFormat = v() : i.axes[1].valueFormat = B()), await Y(i, null), await K(i, null);
+  t.axes?.[1] && (e === F.Stacked100 ? t.axes[1].valueFormat = b() : t.axes[1].valueFormat = U()), f({ config: t, value: null, axisIndex: 1, isMax: !1 }), f({ config: t, value: null, axisIndex: 1, isMax: !0 });
+}, Ce = (s) => {
+  let e;
+  const t = s.series.find(
+    (i) => (n(i) || a(i) || g(i)) && i.nullCategory !== void 0
+  );
+  return (n(t) || a(t) || g(t)) && (e = t?.nullCategory), e;
+}, Ae = (s, e) => {
+  s.series.forEach((t) => {
+    (n(t) || a(t) || g(t)) && (t.nullCategory = e);
+  });
 };
-class _e extends C {
+class Fe extends T {
+  constructor() {
+    super(...arguments), this._xAxisField = "", this._aggregationType = l.Count, this._splitByField = "", this._numericFields = [];
+  }
+  // #endregion
   // ---------------------------------------------------------------------------------------------
   // #region Data Props
   // ---------------------------------------------------------------------------------------------
   /**
-   * Gets the x-axis field for the chart.
-   * @returns {string}
+   * The x-axis field for the chart.
    */
-  getXAxisField() {
-    return G(this._config);
+  get xAxisField() {
+    return this._xAxisField;
+  }
+  set xAxisField(e) {
+    if (this._xAxisField = e, this.dirtyAsyncSetters.push("xAxisField"), e.trim() === "" || e === m) {
+      const r = this.numericFields;
+      this.resetConfig(), this.numericFields = r;
+    }
+    this.processSeriesRebuild();
   }
   /**
-   * Sets the x-axis field for the chart.
-   * @param {string} newXAxisField The new x-axis field.
+   * The aggregation type for the bar chart. Must be one of the values allowed by `WebChartStatisticType`.
    */
-  async setXAxisField(e) {
-    const i = e.trim() === "";
-    !i && this.layerInfo && await q(e, this._config, this.layerInfo);
-    const t = o(this._config), l = g(this._config.series) === c.BarAndLineFromFields, n = t.includes(this.layerInfo?.objectIdField ?? "");
-    if (i || l && n) {
-      await this.resetConfig();
-      const I = t.length === 1 && t[0] === this.layerInfo?.objectIdField;
-      this.layerInfo && t.length > 0 && !I && await f(t, this._config, this.layerInfo);
-    }
-    this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setXAxisField");
+  get aggregationType() {
+    return this._aggregationType;
+  }
+  set aggregationType(e) {
+    this._aggregationType = e, this.dirtyAsyncSetters.push("aggregationType"), this.processSeriesRebuild();
   }
   /**
-   * Gets the aggregation type for the bar chart.
-   * @returns {WebChartStatisticType}
+   * The split-by field for the chart.
    */
-  getAggregationType() {
-    return r(this._config);
+  get splitByField() {
+    return this._splitByField;
+  }
+  set splitByField(e) {
+    this.layerInfo?.layerFieldsInfo && Y(this.layerInfo?.layerFieldsInfo, e) && (this._splitByField = e, this.dirtyAsyncSetters.push("splitByField"), this.processSeriesRebuild());
   }
   /**
-   * Sets the aggregation type for the chart.
-   * @param {WebChartStatisticType} newAggregationType The new aggregation type. Must be one of the values allowed by `WebChartStatisticType`.
-   * @async **This method is `async` and must be awaited for the changes to take effect.**
+   * The numeric fields array for the chart.
    */
-  async setAggregationType(e) {
-    this.layerInfo && (await R(e, this._config, this.layerInfo), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setAggregationType"));
+  get numericFields() {
+    return this._numericFields;
+  }
+  set numericFields(e) {
+    typeof e == "string" && (e = [e]);
+    const t = H(this.layerInfo?.layerFieldsInfo ?? [], e), i = (this.xAxisField === "" || this.xAxisField === m) && e.length === 0;
+    if (t && !i) {
+      const r = this.layerInfo?.objectIdField ?? "";
+      e.length === 0 ? (e.push(r), this._aggregationType = l.Count) : this._aggregationType === l.Count && e.length >= 1 && !e.includes(r) && (this._aggregationType = l.Sum), this._numericFields = e, this.dirtyAsyncSetters.push("numericFields"), this.numericFields.length > 1 && (this._splitByField = "", this.dirtyAsyncSetters.push("splitByField")), this.processSeriesRebuild();
+    } else i && this.resetConfig();
   }
   /**
    * Gets whether the series should be assigned to the second value axis.
@@ -196,118 +202,84 @@ class _e extends C {
    * @returns {boolean}
    */
   getAssignToSecondValueAxis(e) {
-    return fe(e, this._config);
+    return ge(e, this._config);
   }
   /**
    * Sets whether the series should be assigned to the second value axis.
    * @param assign - The value for the setting.
    * @param seriesIndex - The index of the series.
    */
-  setAssignToSecondValueAxis(e, i) {
-    de(e, i, this._config), this.emitConfigUpdate("setAssignToSecondValueAxis");
+  setAssignToSecondValueAxis(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      he({ assign: e, seriesIndex: t, config: this._config, commonStrings: this.commonStrings }), this.emitConfigUpdate("setAssignToSecondValueAxis");
+    });
   }
   /**
-   * Gets the split-by field for the chart.
-   * @returns {string}
+   * Gets the sort order for the bar chart.
+   * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
    */
-  getSplitByField() {
-    return H(this._config);
+  getSortOrder() {
+    return y(this._config);
   }
   /**
-   * Sets the split-by field for the chart.
-   * @param {string} newSplitByField The new split-by field.
-   * @async **This method is `async` and must be awaited for the changes to take effect.**
+   * Sets the sort order for the bar chart.
+   * @param {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc"}  newSortOrder The new sort order.
+   * @param {string[]} orderByList The list of category's values to order by.
    */
-  async setSplitByField(e) {
-    this.layerInfo?.layerFieldsInfo && J(this.layerInfo?.layerFieldsInfo, e) && (await Q(e, this._config, this.layerInfo), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setSplitByField"));
+  setSortOrder(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      C(e, this._config, t), this.emitConfigUpdate("setSortOrder");
+    });
   }
   /**
-   * Gets the numeric fields array for the chart.
+   * Gets the list of the category values for the chart.
    * @returns {string[]}
    */
-  getNumericFields() {
-    return o(this._config);
-  }
-  /**
-   * Sets the numeric field or numeric fields array for the chart.
-   * @param {string | string[]} newNumericFields The new numeric field string or numeric fields array.
-   * @async **This method is `async` and must be awaited for the changes to take effect.**
-   */
-  async setNumericFields(e) {
-    if (typeof e == "string" && (e = [e]), Z(this.layerInfo?.layerFieldsInfo ?? [], e) && this.layerInfo) {
-      await f(e, this._config, this.layerInfo);
-      const t = o(this._config);
-      g(this._config.series) === c.BarAndLineFromFields && t.some((n) => n === this.layerInfo?.objectIdField) && await this.resetConfig(), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setNumericFields");
-    }
-  }
-  /**
-   * Gets the data filter for the bar chart.
-   * @returns {WebChartDataFilters | undefined}
-   */
-  getDataFilter() {
-    return $(this._config);
+  async getCustomSortValues() {
+    return await p(this._config, this.layerInfo);
   }
   /**
    * Sets the data filter for the bar chart.
    * @param {WebChartDataFilters | undefined} newDataFilter The new data filter.
    */
-  async setDataFilter(e) {
-    ee(e, this._config);
-    const i = d(this._config);
-    if (i === ae.customSort) {
-      const t = await h(this._config, this.layerInfo);
-      m(i, this._config, t);
+  async setDataFilters(e) {
+    super.setDataFilters(e);
+    const t = y(this._config);
+    if (t === ie.customSort) {
+      const i = await p(this._config, this.layerInfo);
+      C(t, this._config, i);
     }
     this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setDataFilter");
   }
   /**
-   * Gets the list of the category values for the chart.
-   * @returns {string[]}
-   */
-  async getCustomSortValues() {
-    return await h(this._config, this.layerInfo);
-  }
-  /**
-   * Gets the sort order for the bar chart.
-   * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
+   * The list of custom sort values for custom sort
    */
-  getSortOrder() {
-    return d(this._config);
+  get orderByList() {
+    return A(this._config);
   }
-  /**
-   * Sets the sort order for the bar chart.
-   * @param {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc"}  newSortOrder The new sort order.
-   * @param {string[]} orderByList The list of category's values to order by.
-   */
-  setSortOrder(e, i) {
-    m(e, this._config, i), this.emitConfigUpdate("setSortOrder");
+  set orderByList(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      !M(this._config) && (u(e, this._config), this.emitConfigUpdate("orderByList"));
+    });
   }
   /**
-   * Gets the list of custom sort values for custom sort
-   * @returns {string[]}
+   * Updates the series based on the layer filter.
+   * @async **This method is `async` and must be awaited for the changes to take effect.**
    */
-  getOrderByList() {
-    return p(this._config);
+  async updateSeriesFromLayerFilter() {
+    this.layerInfo !== void 0 && (this.dirtyAsyncSetters.push("updateSeriesFromLayerFilter"), await this.processSeriesRebuild());
   }
   /**
-   * Sets the list of custom sort values for custom sort
-   * @param {string[]} newOrderByList The new list of custom sort values
+   * Whether temporal binning is enabled for all series in the config.
+   * **Note:** Setting this prop removes any existing temporal binning settings if `value` is set to `false`.
    */
-  setOrderByList(e) {
-    !O(this._config) && (y(e, this._config), this.emitConfigUpdate("setOrderByList"));
+  get binTemporalData() {
+    return J(this._config);
   }
-  /**
-   * Updates the series based on the layer filter.
-   * @async **This method is `async` and must be awaited for the changes to take effect.**
-   */
-  async updateSeriesFromLayerFilter() {
-    this.layerInfo !== void 0 && (await ie({
-      splitByField: this.getSplitByField(),
-      numericFields: this.getNumericFields(),
-      aggregationType: this.getAggregationType(),
-      config: this._config,
-      layerInfo: this.layerInfo
-    }), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("updateSeriesFromLayerFilter"));
+  set binTemporalData(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      Q(e, this._config), this.emitConfigUpdate("enableTemporalBinning");
+    });
   }
   // #endregion
   // ---------------------------------------------------------------------------------------------
@@ -320,15 +292,17 @@ class _e extends C {
    * @returns {string | undefined}
    */
   getSeriesName(e) {
-    return he(e, this._config);
+    return ce(e, this._config);
   }
   /**
    * Sets name of the series based on the series index.
    * @param {string} name The name for the series.
    * @param {number} seriesIndex The index of the series.
    */
-  setSeriesName(e, i) {
-    me(e, i, this._config), this.emitConfigUpdate("setSeriesName");
+  setSeriesName(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      de(e, t, this._config), this.emitConfigUpdate("setSeriesName");
+    });
   }
   /**
    * Gets the color of the series based on the series index. If the index is out of bounds, it will return `undefined`.
@@ -336,32 +310,36 @@ class _e extends C {
    * @returns {Color | undefined}
    */
   getSeriesColor(e) {
-    return pe(e, this._config);
+    return me(e, this._config);
   }
   /**
    * Sets the color of the series based on the series index.
    * @param {Color | undefined} newColor The new color for the series.
    * @param {number} seriesIndex The index of the series.
    */
-  setSeriesColor(e, i) {
-    ye(e, i, this._config), this.emitConfigUpdate("setSeriesColor");
+  setSeriesColor(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      fe(e, t, this._config), this.emitConfigUpdate("setSeriesColor");
+    });
   }
   /**
    * Gets the order of the series array by returning an array of series ids.
    * @returns {string[]}
    */
   getOrderOfSeries() {
-    return ue(this._config);
+    return ye(this._config);
   }
   /**
    * Sets the order of the series array by providing an array of series ids.
    * @param {string[]} newOrder The new order of the series array.
    */
   setOrderOfSeries(e) {
-    Ce(e, this._config), this.emitConfigUpdate("setOrderOfSeries");
+    this.guardSetterFromAsyncOverwrite(() => {
+      pe(e, this._config), this.emitConfigUpdate("setOrderOfSeries");
+    });
   }
   /**
-   * Gets how the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
+   * How the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
    * when multiple attributes/fields corresponding to the same set of classes are to be visualized.
    *
    * Currently this property is only used for bar and line series.
@@ -370,102 +348,164 @@ class _e extends C {
    *
    * @returns {WebChartStackedKinds | undefined}
    */
-  getStackedType() {
-    return Se(this._config);
+  get stackedType() {
+    return ue(this._config);
   }
-  /**
-   * Sets how the bars/lines should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
-   * when multiple attributes/fields corresponding to the same set of classes are to be visualized.
-   *
-   * Currently this property is only used for bar and line series.
-   *
-   * @param {WebChartStackedKinds | undefined} newStackedType The new stacked type.
-   *
-   * @default sideBySide
-   */
-  async setStackedType(e) {
-    await Te({
-      newStackedType: e,
-      config: this._config,
-      layerInfo: this.layerInfo
-    }), this.emitConfigUpdate("setStackedType");
+  set stackedType(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      Se({
+        newStackedType: e,
+        config: this._config,
+        layerInfo: this.layerInfo,
+        commonStrings: this.commonStrings
+      }), this.emitConfigUpdate("stackedType");
+    });
   }
   /**
    * Moves a series from one index in the series array to another.
    * @param {number} fromIndex Index to move the series from.
    * @param {number} toIndex Index to move the series to.
    */
-  moveSeries(e, i) {
-    const t = this.getOrderOfSeries(), [a] = t.splice(e, 1);
-    t.splice(i, 0, a), this.setOrderOfSeries(t), this.emitConfigUpdate("moveSeries");
+  moveSeries(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      const i = this.getOrderOfSeries(), [r] = i.splice(e, 1);
+      i.splice(t, 0, r), this.setOrderOfSeries(i), this.emitConfigUpdate("moveSeries");
+    });
   }
   /**
    * Moves the custom sort values in-place for the order by list in the config.
-   *
-   * NOTE: This method should be only used when the sort order is set to `SerialChartDataSortingKinds.customSort`.
+   * **Note:** This method should be only used when the sort order is set to `SerialChartDataSortingKinds.customSort`.
    * @param {number} fromIndex The index to move the custom sort value from.
    * @param {number} toIndex The index to move the custom sort value to.
    */
-  moveCustomSortValuesInOrderByList(e, i) {
-    const t = p(this._config), [a] = t.splice(e, 1);
-    t.splice(i, 0, a), y(t, this._config), this.emitConfigUpdate("moveCustomSortValuesInOrderByList");
+  moveCustomSortValuesInOrderByList(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      const i = A(this._config), [r] = i.splice(e, 1);
+      i.splice(t, 0, r), u(i, this._config), this.emitConfigUpdate("moveCustomSortValuesInOrderByList");
+    });
+  }
+  /**
+   * The null category configuration of the bar chart.
+   *
+   * @requires the following to be set on the model for the null category to be applied:
+   * - `fetchNULLValues` to be set to `true` on the model.
+   * - `colorMatch` to be set to `false` on the model
+   */
+  get nullCategory() {
+    return Ce(this._config);
+  }
+  set nullCategory(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      const t = this.nullCategory;
+      x(t, e) || (Ae(this._config, e), this.emitConfigUpdate("setNullCategory"));
+    });
+  }
+  /**
+   * Sets up the local props based on the current config.
+   * @category Protected
+   */
+  setupLocalProps() {
+    this._xAxisField = te(this._config), this._aggregationType = h(this._config), this._splitByField = Z(this._config), this._numericFields = c(this._config);
   }
   /**
    * Resets the config to the default config
+   * @category Protected
    */
-  async resetConfig() {
+  resetConfig() {
     const e = this._config.id;
-    this._config = await this.generateDefaultConfig(), this._config.id = e, this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("resetConfig");
+    this._config = this.generateDefaultConfig(), this._config.id = e, this.setupLocalProps(), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("resetConfig");
+  }
+  /**
+   * Determines if we can rebuild the series synchronously.
+   * We can call the build new series function synchronously when either is true:
+   * - there is no split-by field
+   * - there are multiple numeric fields
+   * @category Protected
+   */
+  canUseSynchronousSeriesRebuild() {
+    return this.splitByField === "" || this.numericFields.length > 1;
+  }
+  /**
+   * Processes the series rebuild.
+   * If multiple async setters are called in succession, this function will only rebuild the series once after all setters have been called.
+   * @category Protected
+   * @async
+   */
+  async processSeriesRebuild() {
+    if (this.layerInfo !== void 0) {
+      const e = this.dirtyAsyncSetters[this.dirtyAsyncSetters.length - 1];
+      if (this.canUseSynchronousSeriesRebuild())
+        this.dirtyAsyncSetters = [], S(this.getBuildNewSeriesProps());
+      else if (!this.asyncConfigUpdateInProgress) {
+        for (this.asyncConfigUpdateInProgress = !0, this.setupFinished = new Promise((t) => {
+          this.resolveSetup = t;
+        }); this.dirtyAsyncSetters.length > 0; )
+          this.dirtyAsyncSetters = [], await S(this.getBuildNewSeriesProps());
+        this.asyncConfigUpdateInProgress = !1, this.resolveSetup?.();
+      }
+      this.setupLocalProps(), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate(e);
+    }
+  }
+  // #endregion
+  // #region Private Methods
+  /**
+   * Gets the properties needed to build a new series array.
+   */
+  getBuildNewSeriesProps() {
+    return {
+      xAxisField: this.xAxisField,
+      splitByField: this.splitByField,
+      numericFields: this.numericFields,
+      aggregationType: this.aggregationType,
+      config: this._config,
+      layerInfo: this.layerInfo,
+      commonStrings: this.commonStrings
+    };
   }
   // #endregion
   // ---------------------------------------------------------------------------------------------
-  // #region General Props
+  // #region Public Methods
   // ---------------------------------------------------------------------------------------------
   /**
    * Generate the proper chart title given the current config.
-   *
-   * @returns {string}
    */
-  async generateChartTitle() {
-    return this.layerInfo !== void 0 ? await te(this._config, this.layerInfo) : "";
+  generateChartTitle() {
+    return this.layerInfo !== void 0 ? $(this._config, this.layerInfo, this.commonStrings) : "";
   }
   /**
    * Generate the proper x-axis title given the current config.
-   *
-   * @returns {string}
    */
   generateXAxisTitle() {
-    const e = this.getXAxisField();
-    return this.layerInfo !== void 0 ? x(this.layerInfo.layerFieldsInfo, e) : "";
+    return this.layerInfo !== void 0 ? L(this.layerInfo.layerFieldsInfo, this._xAxisField) : "";
   }
   /**
    * Generate the proper y-axis title given the current config.
-   *
-   * @returns {string}
    */
-  async generateYAxisTitle() {
-    return this.layerInfo !== void 0 ? await _({
+  generateYAxisTitle() {
+    return this.layerInfo !== void 0 ? _({
       config: this._config,
       layerInfo: this.layerInfo,
-      numericFields: o(this._config),
-      aggregationType: r(this._config)
+      commonStrings: this.commonStrings,
+      numericFields: c(this._config),
+      aggregationType: h(this._config)
     }) : "";
   }
   // #endregion
 }
-se(_e, [
-  M,
+ee(Fe, [
+  w,
+  se,
+  re,
   oe,
+  ae,
   ne,
-  re,
-  ge,
-  le,
-  U,
-  b,
-  ce
+  D,
+  P,
+  le
 ]);
 export {
-  _e as S,
-  me as a,
-  ye as s
+  Fe as S,
+  de as a,
+  ce as g,
+  fe as s
 };