@arcgis/charts-components 4.34.0-next.16 → 4.34.0-next.161

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

@@ -1,7 +1,8 @@
-import { WebChartStackedKinds as y } 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, cg as L } from "./interfaces.js";
 import "d3-array";
-import { aq as F, ag as I, a8 as B, a6 as v, k as g, cs as l, o as A } 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,182 +10,190 @@ 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 { C as u, j as O, k as M, l as U, m as b, n as x, o as L, p as D, q as w, r as N, t as E, v as V, w as k, x as S, y as o, u as W, c as P, d as X, z as j, A as z, B as c, D as K, E as Y, F as G, G as q, H, I as J, J as Q, K as d, L as f, N as h, O as m, P as p, Q as R, a as Z, M as $, i as ee, e as ie } from "./serial-chart-data.js";
-import { l as C, j as T } from "./index4.js";
-import { S as te } from "./common.js";
-import { M as se, a as ae, b as oe, c as ne } from "./model-with-data-labels.js";
-import { M as re } from "./model-with-rotation.js";
+import "./runtime.js";
+import "@arcgis/toolkit/dom";
+import { C as T, M as w, b as D, a as N } from "./model-with-multi-axes.js";
+import { l as n, j as a, k as g } from "./index4.js";
+import { t as P, v as V, w as W, x as k, y as E, z as R, A as z, B as K, C as j, D as G, E as X, b as _, j as h, k as c, u as Y, s as f, f as q, i as H, F as y, G as u, H as p, I as S, J as C, K as J, L as Q, h as Z, m as $, M as A, N as ee, e 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.16 */
-class ge extends u {
+v4.34.0-next.161 */
+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 O(this._config);
+  get temporalBinningSize() {
+    return P(this._config);
   }
-  /**
-   * Sets the time interval size for a temporal bar/line chart.
-   * @param {number | undefined} newSize The new time interval size.
-   */
-  setTemporalBinningSize(e) {
-    M(e, this._config), this.emitConfigUpdate("setTemporalBinningSize");
+  set temporalBinningSize(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      V(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 U(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) {
-    b(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() {
-    return x(this._config);
+  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) {
-    L(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 D(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 N(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) {
-    E(e, this._config), this.emitConfigUpdate("setNullPolicy");
+  set nullPolicy(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      G(e, this._config), this.emitConfigUpdate("nullPolicy");
+    });
   }
   /**
    * Resets the time interval to default for a temporal line chart.
    */
   resetTimeInterval() {
-    V(this._config), this.emitConfigUpdate("resetTimeInterval");
+    this.guardSetterFromAsyncOverwrite(() => {
+      X(this._config), this.emitConfigUpdate("resetTimeInterval");
+    });
   }
 }
-const le = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, ce = (s, e, i) => {
-  i.series?.[e] && (i.series[e].assignToSecondValueAxis = s);
-}, de = (s, e) => e.series?.[s]?.name, fe = (s, e, i) => {
-  i.series?.[e] && (i.series[e].name = s);
-}, he = (s, e) => {
-  const i = e.series?.[s];
-  let t;
-  return C(i) ? t = i.fillSymbol?.color : T(i) && (t = i.lineSymbol?.color), t;
-}, me = (s, e, i) => {
-  const t = i.series?.[e];
-  t && (C(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(i) && (i.lineSymbol = {
     ...I(e),
-    ...t.lineSymbol,
+    ...i.lineSymbol,
     color: s
   }));
-}, pe = (s) => s.series.map((e) => e.id), ye = (s, e) => {
+}, ye = (s) => s.series.map((e) => e.id), ue = (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)
   );
-}, ue = (s) => s.stackedType ?? y.Side, Se = async (s) => {
-  const { newStackedType: e, config: i, layerInfo: t } = s;
-  if (i.stackedType = e, t !== void 0) {
-    const a = await k({
-      config: i,
-      layerInfo: t,
-      numericFields: o(i),
-      aggregationType: S(i)
+}, pe = (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)
     });
-    W(i, 1, a);
+    Y(t, 1, o);
   }
-  i.axes?.[1] && (e === y.Stacked100 ? i.axes[1].valueFormat = B() : i.axes[1].valueFormat = v()), await P(i, null), await X(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 Ce extends u {
+class Fe extends T {
+  constructor() {
+    super(...arguments), this._xAxisField = "", this._aggregationType = l.Count, this._splitByField = "", this._numericFields = [];
+  }
+  // #endregion
   // ---------------------------------------------------------------------------------------------
-  // Data Props
+  // #region Data Props
   // ---------------------------------------------------------------------------------------------
   /**
-   * Gets the x-axis field for the chart.
-   * @returns {string}
+   * The x-axis field for the chart.
    */
-  getXAxisField() {
-    return j(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 || await z(e, this._config, this.layerInfo);
-    const t = o(this._config), r = g(this._config.series) === l.BarAndLineFromFields, n = t.includes(this.layerInfo?.objectIdField ?? "");
-    if (i || r && n) {
-      await this.resetConfig();
-      const _ = t.length === 1 && t[0] === this.layerInfo?.objectIdField;
-      this.layerInfo && t.length > 0 && !_ && await c(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 S(this._config);
+  get splitByField() {
+    return this._splitByField;
+  }
+  set splitByField(e) {
+    this.layerInfo?.layerFieldsInfo && q(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 K(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.
@@ -192,121 +201,88 @@ class Ce extends u {
    * @returns {boolean}
    */
   getAssignToSecondValueAxis(e) {
-    return le(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) {
-    ce(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 Y(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 && G(this.layerInfo?.layerFieldsInfo, e) && (await q(e, this._config, this.layerInfo), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate("setSplitByField"));
+  setSortOrder(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      u(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]), H(this.layerInfo?.layerFieldsInfo ?? [], e) && this.layerInfo) {
-      await c(e, this._config, this.layerInfo);
-      const t = o(this._config);
-      g(this._config.series) === l.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 J(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) {
-    Q(e, this._config);
-    const i = d(this._config);
-    if (i === te.customSort) {
-      const t = await f(this._config, this.layerInfo);
-      h(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);
+      u(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 f(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 S(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) {
-    h(e, this._config, i), this.emitConfigUpdate("setSortOrder");
+  set orderByList(e) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      !M(this._config) && (C(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 m(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) {
-    !A(this._config) && (p(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 R({
-      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
   // ---------------------------------------------------------------------------------------------
-  // Series Props
+  // #region Series Props
   // ---------------------------------------------------------------------------------------------
   /**
    * Gets the name of the series based on the series index.
@@ -315,15 +291,17 @@ class Ce extends u {
    * @returns {string | undefined}
    */
   getSeriesName(e) {
-    return de(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) {
-    fe(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`.
@@ -331,32 +309,36 @@ class Ce extends u {
    * @returns {Color | undefined}
    */
   getSeriesColor(e) {
-    return he(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) {
-    me(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 pe(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) {
-    ye(e, this._config), this.emitConfigUpdate("setOrderOfSeries");
+    this.guardSetterFromAsyncOverwrite(() => {
+      ue(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.
@@ -365,67 +347,160 @@ class Ce extends u {
    *
    * @returns {WebChartStackedKinds | undefined}
    */
-  getStackedType() {
-    return ue(this._config);
+  get stackedType() {
+    return pe(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 Se({
-      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 = m(this._config), [a] = t.splice(e, 1);
-    t.splice(i, 0, a), p(t, this._config), this.emitConfigUpdate("moveCustomSortValuesInOrderByList");
+  moveCustomSortValuesInOrderByList(e, t) {
+    this.guardSetterFromAsyncOverwrite(() => {
+      const i = S(this._config), [r] = i.splice(e, 1);
+      i.splice(t, 0, r), C(i, this._config), this.emitConfigUpdate("moveCustomSortValuesInOrderByList");
+    });
+  }
+  /**
+   * The null category configuration of the bar chart.
+   */
+  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 = Z(this._config), this._aggregationType = h(this._config), this._splitByField = $(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 = [], A(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 A(this.getBuildNewSeriesProps());
+        this.asyncConfigUpdateInProgress = !1, this.resolveSetup?.();
+      }
+      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 Public Methods
+  // ---------------------------------------------------------------------------------------------
+  /**
+   * Generate the proper chart title given the current config.
+   */
+  generateChartTitle() {
+    return this.layerInfo !== void 0 ? ee(this._config, this.layerInfo, this.commonStrings) : "";
+  }
+  /**
+   * Generate the proper x-axis title given the current config.
+   */
+  generateXAxisTitle() {
+    return this.layerInfo !== void 0 ? L(this.layerInfo.layerFieldsInfo, this._xAxisField) : "";
+  }
+  /**
+   * Generate the proper y-axis title given the current config.
+   */
+  generateYAxisTitle() {
+    return this.layerInfo !== void 0 ? _({
+      config: this._config,
+      layerInfo: this.layerInfo,
+      commonStrings: this.commonStrings,
+      numericFields: c(this._config),
+      aggregationType: h(this._config)
+    }) : "";
+  }
+  // #endregion
 }
-Z(Ce, [
-  $,
+te(Fe, [
+  w,
   se,
-  ae,
-  oe,
   re,
+  oe,
+  ae,
   ne,
-  ee,
-  ie,
-  ge
+  D,
+  N,
+  le
 ]);
 export {
-  Ce as S,
-  fe as a,
-  me as s
+  Fe as S,
+  de as a,
+  ce as g,
+  fe as s
 };