@arcgis/charts-components 5.2.0-next.60 → 5.2.0-next.62

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

@@ -1,7 +1,7 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { isEqual as D } from "lodash-es";
-import { q as I, u, r as h } from "./chart-object-literals.js";
-import { bd as b, bs as v, k as p, ap as M } from "./index2.js";
+import { q as b, u, r as h } from "./chart-object-literals.js";
+import { bd as I, bs as v, k as p, ap as M } from "./index2.js";
 import { i as P } from "./index4.js";
 import { C as O } from "./chart-model.js";
 import { m as o } from "./model-setter.js";
@@ -15,24 +15,24 @@ import { W as ge, c as ce, d as fe } from "./generate-x-axis-title.js";
 import { W as he, a as pe } from "./x-bounds.js";
 import { W as me } from "./data-labels-symbol.js";
 import { W as de } from "./rotated-state.js";
-import { g as W, u as ye, s as T, j as ue, k as Se, f as _e, h as xe } from "./utils.js";
+import { g as W, u as ye, s as T, h as ue, j as Se, k as _e, f as xe } from "./utils.js";
 import { d as F, e as B, a as Te } from "./data.js";
-import { B as Fe, Z as Be, x as Ce, a4 as Ae, a2 as Ie } from "./index.js";
+import { B as Fe, Z as Be, x as Ce, a4 as Ae, a2 as be } from "./index.js";
 import { s as L } from "./series-types.js";
 const C = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, A = (s) => {
   const { assign: e, seriesIndex: i, config: t, commonStrings: r } = s;
   e && t.axes !== void 0 && !t.axes?.[2] && (t.axes[2] = Ce(r, u.BarSeries)[1]), t.series && t.series.forEach((a, g) => {
     g === i ? a.assignToSecondValueAxis = e : g !== i && a?.assignToSecondValueAxis !== !0 && (a.assignToSecondValueAxis = !1);
   }), t.axes?.[2] && !t.series.some((a) => a.assignToSecondValueAxis) && t.axes.splice(2, 1);
-}, be = (s, e) => e.series?.[s]?.name, ve = (s, e, i) => {
+}, Ie = (s, e) => e.series?.[s]?.name, ve = (s, e, i) => {
   i.series?.[e] && (i.series[e].name = s);
 }, Oe = (s, e) => {
   const i = e.series?.[s];
   let t;
-  return b(i) ? t = i.fillSymbol?.color : v(i) && (t = i.lineSymbol?.color), t;
+  return I(i) ? t = i.fillSymbol?.color : v(i) && (t = i.lineSymbol?.color), t;
 }, We = (s, e, i) => {
   const t = i.series?.[e];
-  t && (b(t) ? t.fillSymbol = {
+  t && (I(t) ? t.fillSymbol = {
     ...Fe(e),
     ...t.fillSymbol,
     color: s
@@ -45,7 +45,7 @@ const C = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, A = (s) => {
   e.series?.sort(
     (i, t) => s.findIndex((r) => i.id === r) - s.findIndex((r) => t.id === r)
   );
-}, Me = (s) => s.stackedType ?? I.Side, Pe = (s) => {
+}, Me = (s) => s.stackedType ?? b.Side, Pe = (s) => {
   const { newStackedType: e, config: i, layerInfo: t, commonStrings: r } = s;
   if (i.stackedType = e, t !== void 0) {
     const a = W({
@@ -57,7 +57,7 @@ const C = (s, e) => e.series?.[s].assignToSecondValueAxis ?? !1, A = (s) => {
     });
     ye(i, 1, a);
   }
-  i.axes?.[1] && (e === I.Stacked100 ? i.axes[1].valueFormat = Ae() : i.axes[1].valueFormat = Ie()), T({ config: i, value: null, axisIndex: 1, isMax: !1 }), T({ config: i, value: null, axisIndex: 1, isMax: !0 });
+  i.axes?.[1] && (e === b.Stacked100 ? i.axes[1].valueFormat = Ae() : i.axes[1].valueFormat = be()), T({ config: i, value: null, axisIndex: 1, isMax: !1 }), T({ config: i, value: null, axisIndex: 1, isMax: !0 });
 }, Ve = (s) => {
   const e = {};
   return s.series.forEach((i) => {
@@ -277,10 +277,18 @@ class n extends O {
   }
   /**
    * Updates the series based on the layer filter.
+   *
+   * @deprecated since 5.2. Use {@link model/serial-chart-model/serial-chart-model#rebuildSeries rebuildSeries} instead.
    */
   updateSeriesFromLayerFilter() {
     this.layerInfo !== void 0 && m(this.getBuildNewSeriesProps());
   }
+  /**
+   * Rebuilds the series based on the current configuration.
+   */
+  async rebuildSeries() {
+    await this.processSeriesRebuild("rebuildSeries");
+  }
   /**
    * Whether temporal binning is enabled for all series in the config.
    *
@@ -303,7 +311,7 @@ class n extends O {
    * @param seriesIndex - The index of the series.
    */
   getSeriesName(e) {
-    return be(e, this._config);
+    return Ie(e, this._config);
   }
   setSeriesName(e, i) {
     ve(e, i, this._config);
@@ -523,6 +531,6 @@ xe(n, Xe);
 export {
   n as S,
   ve as a,
-  be as g,
+  Ie as g,
   We as s
 };

package/dist/chunks/utils.js

@@ -1,42 +1,42 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { substitute as b } from "@arcgis/core/intl.js";
-import { w as C, H as j, M as q, T as k, F as M, x as W } from "./index.js";
-import { g as $ } from "./series-types.js";
-import { l as E, d as S, q as U, D as H } from "./index3.js";
-import { bw as K, ap as I, ag as P, h as O, cs as L, a6 as h, cr as V, aJ as X } from "./index2.js";
-import { q as R, u as f, r as A, p as G } from "./chart-object-literals.js";
+import { q, u as f, r as A, p as C } from "./chart-object-literals.js";
+import { bw as j, ap as I, ag as k, h as O, cq as L, cr as V, aJ as M, a6 as b } from "./index2.js";
 import { d as T } from "./type-guards.js";
+import { l as W, d as S, q as $, D as E } from "./index3.js";
+import { substitute as h } from "@arcgis/core/intl.js";
+import { w as U, H, M as K, T as P, F as X, x as R } from "./index.js";
+import { g as G } from "./series-types.js";
 function se(s, e, i) {
   const t = s?.axes?.[e];
-  t?.title !== void 0 ? t.title.content.text = i : t !== void 0 && (t.title = j({
+  t?.title !== void 0 ? t.title.content.text = i : t !== void 0 && (t.title = H({
     text: i,
     visible: !0,
-    font: q(k.AxisTitle)
+    font: K(P.AxisTitle)
   }));
 }
 function ae(s) {
   const { config: e, layerInfo: i, commonStrings: t, numericFields: a, aggregationType: r } = s;
   let o = "";
   if (e)
-    if (E(e) === R.Stacked100)
+    if (W(e) === q.Stacked100)
       o = t.utilsStrings.statistics.percent;
     else {
-      const d = C(r, t);
+      const d = U(r, t);
       if (e.series[0]?.type === f.HeatSeries)
         o = S(i.layerFieldsInfo, e.series[0].y);
       else if (a.length === 1) {
         const g = S(i.layerFieldsInfo, a[0]), n = I(i.layer).idField;
-        r === A.NoAggregation ? o = g : r === A.Count && n !== void 0 && a[0] === n ? o = t.utilsStrings.statistics.count : o = b(t.axisLabels.aggregationOfFieldName, {
+        r === A.NoAggregation ? o = g : r === A.Count && n !== void 0 && a[0] === n ? o = t.utilsStrings.statistics.count : o = h(t.axisLabels.aggregationOfFieldName, {
           aggregation: d,
           fieldName: g
         });
-      } else a.length > 1 && (r === A.NoAggregation ? o = t.axisLabels.values : o = b(t.axisLabels.aggregationOfValues, {
+      } else a.length > 1 && (r === A.NoAggregation ? o = t.axisLabels.values : o = h(t.axisLabels.aggregationOfValues, {
         aggregation: d
       }));
     }
   return o;
 }
-const B = (s, e, i) => s.axes?.[e] ?? W(i, s.type)[e], w = (s) => {
+const B = (s, e, i) => s.axes?.[e] ?? R(i, s.type)[e], w = (s) => {
   const { config: e, axis: i, axisIndex: t } = s;
   e.axes !== void 0 && (e.axes[t] = i);
 }, re = (s) => {
@@ -46,7 +46,7 @@ const B = (s, e, i) => s.axes?.[e] ?? W(i, s.type)[e], w = (s) => {
 }, N = (s) => {
   const { config: e, value: i, axisIndex: t, isMax: a } = s, r = e?.axes?.[t];
   r !== void 0 && (a ? r.maximum = i : r.minimum = i);
-}, oe = (s) => s.axes?.[0]?.valueFormat ?? M(), ne = (s, e, i) => {
+}, oe = (s) => s.axes?.[0]?.valueFormat ?? X(), ne = (s, e, i) => {
   const t = B(s, 0, e);
   if (t !== void 0 && i !== void 0) {
     const a = {
@@ -59,7 +59,7 @@ const B = (s, e, i) => s.axes?.[e] ?? W(i, s.type)[e], w = (s) => {
   const t = s.axes?.[e];
   t !== void 0 && (t.integerOnlyValues = i);
 }, J = (s) => {
-  const e = $(s.series);
+  const e = G(s.series);
   return e === f.BarSeries || e === f.ComboLineAndBarSeries || e === f.LineSeries;
 }, Q = (s) => {
   const { axisIndex: e, config: i, isMultiAxis: t } = s;
@@ -71,7 +71,7 @@ const B = (s, e, i) => s.axes?.[e] ?? W(i, s.type)[e], w = (s) => {
 }, v = (s, e) => {
   let i;
   const t = e.axes?.[s]?.valueFormat;
-  return (s === 0 || s >= 1 && K(t)) && (i = t), i;
+  return (s === 0 || s >= 1 && j(t)) && (i = t), i;
 }, ue = (s) => {
   const { config: e, commonStrings: i, valueFormat: t, axisIndex: a = 0 } = s, r = B(e, a, i);
   if (r !== void 0 && t !== void 0) {
@@ -96,28 +96,26 @@ async function xe(s) {
   const { config: e, layer: i, xAxisField: t, splitByField: a, layerFieldsInfo: r, aggregationFields: o, fetchNullValues: u, errorStrings: d } = s, n = r.filter((F) => F.name === a)[0]?.type, x = u !== !0 ? `${a} IS NOT NULL` : "", l = t && u !== !0 ? `${t} IS NOT NULL` : "", { where: m } = e?.dataFilters ?? {}, D = {
     where: O([m, x, l]),
     // excluding the null values from the list
-    orderByFields: U(a) ? [] : [`${a} ${G.Ascending}`],
+    orderByFields: $(a) ? [] : [`${a} ${C.Ascending}`],
     // default sorting ascending for split-by field
     geometry: e?.dataFilters?.geometry
   };
   let p = "";
   o?.length === 0 ? p = I(i).idField : o && ([p] = o);
-  let y = i ? T(i) ? await V({
+  let y = i ? T(i) ? await L({
     layer: i,
     category: e?.series[0].x ?? "",
     splitByField: a
-  }) : Array.from(
-    (await L({
-      queryObject: i,
-      category: e?.series[0].x ?? "",
-      splitByField: a,
-      queryConfig: D,
-      errorStrings: d
-    })).keys()
-  ) : [];
+  }) : await V({
+    queryObject: i,
+    category: e?.series[0].x ?? "",
+    splitByField: a,
+    queryConfig: D,
+    errorStrings: d
+  }) : [];
   if (y = y.slice(0, 500), e) {
-    const F = e?.series.map((c) => X({ where: c.query?.where })?.toString() ?? "").filter((c) => c !== void 0 && c !== "");
-    y = H({
+    const F = e?.series.map((c) => M({ where: c.query?.where })?.toString() ?? "").filter((c) => c !== void 0 && c !== "");
+    y = E({
       arrayA: y,
       arrayB: F,
       getKey: (c) => c === null ? null : c?.toString()
@@ -135,7 +133,7 @@ function ye(s, e) {
   return i;
 }
 function me(s, e) {
-  const i = P(s);
+  const i = k(s);
   let t = e.length === 0, a = 0;
   for (const r of e) {
     for (const o of i)
@@ -167,22 +165,22 @@ async function Fe(s) {
     geometry: i?.dataFilters?.geometry
   };
   let n;
-  return T(r) ? n = (await V({
+  return T(r) ? n = (await L({
     layer: r,
     category: t,
     fetchNullValues: u
   })).map((x) => {
     const l = String(x);
-    return h({
+    return b({
       queryObject: e.layer,
       fieldName: t,
       fieldValue: l
     }) ?? l;
   }) : n = // fetch unique category values asynchronously
-  Array.from((await L({ queryObject: r, category: t, queryConfig: g, errorStrings: a })).keys()).map(
+  (await V({ queryObject: r, category: t, queryConfig: g, errorStrings: a })).map(
     (x) => {
       const l = String(x);
-      return h({
+      return b({
         queryObject: e.layer,
         fieldName: t,
         fieldValue: l
@@ -199,12 +197,12 @@ export {
   Fe as c,
   ne as d,
   le as e,
-  xe as f,
+  pe as f,
   ae as g,
-  pe as h,
+  ye as h,
   Ae as i,
-  ye as j,
-  me as k,
+  me as j,
+  xe as k,
   re as l,
   v as m,
   de as n,

package/dist/chunks/web-component-utils.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { isEqual as ue, capitalize as v, isNumber as W, zip as ae } from "lodash-es";
+import { isEqual as ue, capitalize as B, isNumber as W, zip as ae } from "lodash-es";
 import { d as Y } from "./interfaces.js";
 import { g as ce, a as q, b as oe, c as z } from "./box-plot-data.js";
 import { g as fe } from "./histogram-data.js";
@@ -7,8 +7,8 @@ import { g as me, a as de, b as ye } from "./pie-chart-data.js";
 import { g as ie } from "./series-length.js";
 import { g as re, d as le, e as ge } from "./serial-chart-data.js";
 import { g as _, a as pe } from "./data.js";
-import { Y as U, ap as be, af as xe, aM as E, cL as Fe, B as V, a6 as De, bj as Se, dv as ve } from "./index2.js";
-import { k as H, az as $, g as R, as as Be, b as he, a as Q } from "./index.js";
+import { Y as U, ap as be, af as xe, aM as E, cL as Fe, B as V, a6 as De, bj as Se, dw as Be } from "./index2.js";
+import { k as H, az as $, g as R, as as ve, b as he, a as Q } from "./index.js";
 import { q as K, C as g, F as A } from "./index3.js";
 import { g as Pe } from "./series-types.js";
 import { V as Ve } from "./index5.js";
@@ -56,7 +56,7 @@ function G(l) {
         label: i.heatChartCalendarDatePartsUnits.dayOfWeek,
         value: Ae({
           weekdayNumber: e,
-          firstDayOfWeek: "firstDayOfWeek" in o ? o.firstDayOfWeek : Be,
+          firstDayOfWeek: "firstDayOfWeek" in o ? o.firstDayOfWeek : ve,
           locale: t
         })
       };
@@ -153,11 +153,11 @@ function ct(l, e = {}) {
     const f = t ?? Object.keys(l[0]), u = [], p = a ?? we(r ?? "en");
     if (r !== void 0 && p !== "," && (c += `sep=${p}\r
 `), o) {
-      const B = f.map((b) => J({ value: b, quoteAll: i, locale: r, roundDecimals: n }));
-      u.push(B.join(p));
+      const v = f.map((b) => J({ value: b, quoteAll: i, locale: r, roundDecimals: n }));
+      u.push(v.join(p));
     }
-    l.forEach((B) => {
-      const b = f.map((x) => J({ value: B[x], quoteAll: i, locale: r, roundDecimals: n }));
+    l.forEach((v) => {
+      const b = f.map((x) => J({ value: v[x], quoteAll: i, locale: r, roundDecimals: n }));
       u.push(b.join(p));
     }), c += u.join(`\r
 `);
@@ -269,7 +269,7 @@ function $e(l, e) {
 }
 function Ne(l) {
   const { fieldName: e, dataContext: t } = l, a = A.rendererSymbolField;
-  return e === a && t !== void 0 ? ve(t) : void 0;
+  return e === a && t !== void 0 ? Be(t) : void 0;
 }
 function ee(l) {
   const { config: e, splitByField: t, splitByValue: a, splitByValueIndex: o, layer: i, fieldList: r, timeZone: n } = l;
@@ -293,11 +293,11 @@ function Te(l) {
     fieldList: o
   });
   return t.map((p) => {
-    const B = p[H.xField], b = p[H.yField], x = p[H.valueField], D = typeof x == "number" && Number.isFinite(x) ? x.toFixed(2) : x;
-    let m = { label: n.x, value: B }, d = { label: n.y, value: b };
+    const v = p[H.xField], b = p[H.yField], x = p[H.valueField], D = typeof x == "number" && Number.isFinite(x) ? x.toFixed(2) : x;
+    let m = { label: n.x, value: v }, d = { label: n.y, value: b };
     if (n.xTemporalBinning !== void 0) {
       const { label: F, value: S } = G({
-        value: Number(B),
+        value: Number(v),
         config: e,
         formatLocale: i,
         unit: n.xTemporalBinning.unit,
@@ -323,9 +323,9 @@ function Te(l) {
   });
 }
 function Re(l, e, t) {
-  const a = fe(l), o = `${v(Y.Min)} of ${a}`, i = `${v(Y.Max)} of ${a}`, r = `${v(Y.Count)} of ${a}`;
+  const a = fe(l), o = `${B(Y.Min)} of ${a}`, i = `${B(Y.Max)} of ${a}`, r = `${B(Y.Count)} of ${a}`;
   return e.map((n) => {
-    const { minValue: s, maxValue: c, count: f } = n, u = W(s), p = W(c), B = W(f), b = {};
+    const { minValue: s, maxValue: c, count: f } = n, u = W(s), p = W(c), v = W(f), b = {};
     if (u && (b[o] = h({
       value: s,
       originalValue: s,
@@ -346,7 +346,7 @@ function Re(l, e, t) {
       });
       b.Label = `${String(x ?? "")} - ${String(D ?? "")}`;
     }
-    return B && (b[r] = f), b;
+    return v && (b[r] = f), b;
   });
 }
 function Ie(l, e, t) {
@@ -355,7 +355,7 @@ function Ie(l, e, t) {
   return t ? o = t.map((i) => a.find((r) => r.toLowerCase().includes(i.toLowerCase())) || "") : o = a.filter((r) => r.toLowerCase().includes(e.toLowerCase())), o.filter((i) => i.trim() !== "");
 }
 function Ke(l) {
-  const { config: e, rows: t, layer: a, fieldList: o, formatters: i, useRendererLabel: r = !1, timeZone: n } = l, s = pe(e), c = re(e), f = v(c), u = le(e), p = U(e.series), B = ie(e), b = ge(e), { idField: x, isTraditionalTypeOID: D } = be(xe(a)), m = D && u.length === 1 && u[0] === x;
+  const { config: e, rows: t, layer: a, fieldList: o, formatters: i, useRendererLabel: r = !1, timeZone: n } = l, s = pe(e), c = re(e), f = B(c), u = le(e), p = U(e.series), v = ie(e), b = ge(e), { idField: x, isTraditionalTypeOID: D } = be(xe(a)), m = D && u.length === 1 && u[0] === x;
   let d;
   switch (p) {
     case g.BarAndLineNoAggregation:
@@ -434,7 +434,7 @@ function Ke(l) {
           useRendererLabel: r,
           timeZone: n
         });
-        return B.map((P, C) => {
+        return v.map((P, C) => {
           const w = ee({
             config: e,
             splitByField: b,
@@ -462,7 +462,7 @@ function Ke(l) {
           formatter: i?.xAxisLabelFormatter,
           useRendererLabel: r,
           timeZone: n
-        }), S = Ie(y, u[0], B), P = y[b], C = B.findIndex((I) => $e(I, P)), w = ee({
+        }), S = Ie(y, u[0], v), P = y[b], C = v.findIndex((I) => $e(I, P)), w = ee({
           config: e,
           splitByField: b,
           splitByValue: P,
@@ -504,11 +504,11 @@ function je(l) {
 function Ee(l) {
   const { config: e, rows: t, layer: a, fieldList: o, formatters: i, useRendererLabel: r = !1, timeZone: n } = l, s = me(e), c = U(e.series);
   let f = je(t);
-  const u = de(e), p = c !== g.PieFromFields ? X.Category : X.Fields, B = ye(e, p), b = _({
+  const u = de(e), p = c !== g.PieFromFields ? X.Category : X.Fields, v = ye(e, p), b = _({
     config: e,
     xAxisField: s,
     numericFields: u,
-    aggregationType: B,
+    aggregationType: v,
     mode: p,
     layer: a,
     fieldList: o
@@ -527,7 +527,7 @@ function Ee(l) {
     return c === g.PieFromCategory && x.toLowerCase() === b.name.toLowerCase() && (y = b.description, F = b.name), d[y] = h({
       value: D[F],
       originalValue: D[F]
-    }), d[v($.trim())] = h({
+    }), d[B($.trim())] = h({
       value: D[`${F}${$}`],
       originalValue: D[`${F}${$}`]
     }), d;
@@ -540,7 +540,7 @@ function Ee(l) {
     }), d.Value = h({
       value: m[x],
       originalValue: m[x]
-    }), d[v($.trim())] = h({
+    }), d[B($.trim())] = h({
       value: m[`${x}${$}`],
       originalValue: m[`${x}${$}`]
     })), d;
@@ -569,13 +569,13 @@ function T(l) {
         fieldList: r,
         timeZone: n
       });
-      t[s] = x, t[v(V.Outlier)] = e[u];
+      t[s] = x, t[B(V.Outlier)] = e[u];
       break;
     }
     case g.BoxPlotMultiFieldsAndCategory: {
-      t[v(s)] = e[s], u = `${c.find(
+      t[B(s)] = e[s], u = `${c.find(
         (D) => Object.keys(e).some((m) => m.toLowerCase().includes(D.toLowerCase()))
-      ) ?? ""}_${u}`, t[v(V.Outlier)] = e[u];
+      ) ?? ""}_${u}`, t[B(V.Outlier)] = e[u];
       break;
     }
     case g.BoxPlotMonoFieldAndSplitBy:
@@ -587,7 +587,7 @@ function T(l) {
         fieldList: r,
         timeZone: n
       });
-      u = `${x}_${u}`, t.Field = e[p], t[v(f)] = D, t[v(V.Outlier)] = e[u];
+      u = `${x}_${u}`, t.Field = e[p], t[B(f)] = D, t[B(V.Outlier)] = e[u];
       break;
     }
     case g.BoxPlotMonoFieldAndCategoryAndSplitBy: {
@@ -598,25 +598,25 @@ function T(l) {
         fieldList: r,
         timeZone: n
       });
-      u = `${x}_${u}`, t[v(s)] = e[s], t[v(f)] = D, t[v(V.Outlier)] = e[u];
+      u = `${x}_${u}`, t[B(s)] = e[s], t[B(f)] = D, t[B(V.Outlier)] = e[u];
       break;
     }
     case g.BoxPlotMonoField:
     case g.BoxPlotMultiFields:
     default: {
-      t.Field = e[p], t[v(V.Outlier)] = e[u];
+      t.Field = e[p], t[B(V.Outlier)] = e[u];
       break;
     }
   }
-  const B = `${u}${Q}`, b = e[B];
-  b !== void 0 && (t[`${v(V.Outlier)} Z-Score`] = b);
+  const v = `${u}${Q}`, b = e[v];
+  b !== void 0 && (t[`${B(V.Outlier)} Z-Score`] = b);
 }
 function Ue(l) {
   const { rawData: e, outRow: t, config: a, splitByValue: o, layer: i, fieldList: r, timeZone: n } = l, s = U(a.series), c = e[`${o}_${V.Average}`], f = z(a), u = q(a);
   let p = "";
   switch (s) {
     case g.BoxPlotMonoFieldAndSplitBy: {
-      p = `${o}_${f}`, t.Field = e[R], t[v(f)] = M({
+      p = `${o}_${f}`, t.Field = e[R], t[B(f)] = M({
         field: f,
         value: e[p],
         layer: i,
@@ -626,7 +626,7 @@ function Ue(l) {
       break;
     }
     case g.BoxPlotMultiFieldsAndSplitBy: {
-      p = `${o}_${V.Average}`, t.Field = e[R], t[v(f)] = M({
+      p = `${o}_${V.Average}`, t.Field = e[R], t[B(f)] = M({
         field: f,
         value: e[p],
         layer: i,
@@ -636,7 +636,7 @@ function Ue(l) {
       break;
     }
     case g.BoxPlotMonoFieldAndCategoryAndSplitBy: {
-      p = `${o}_${V.Average}`, t[u] = e[u], t[v(f)] = M({
+      p = `${o}_${V.Average}`, t[u] = e[u], t[B(f)] = M({
         field: f,
         value: o,
         layer: i,
@@ -646,16 +646,16 @@ function Ue(l) {
       break;
     }
   }
-  t[v(V.Average)] = c;
-  const B = `${String(c)}${Q}`, b = e[B];
-  b !== void 0 && (t[`${v(V.Average)} Z-Score`] = b);
+  t[B(V.Average)] = c;
+  const v = `${String(c)}${Q}`, b = e[v];
+  b !== void 0 && (t[`${B(V.Average)} Z-Score`] = b);
 }
 function Ze(l) {
   const { config: e, rows: t, layer: a, fieldList: o, formatters: i, useRendererLabel: r = !1, timeZone: n } = l, s = U(e.series);
   let c = s;
   const f = ce(e), u = Array.isArray(t) && t.length > 0 && t.every((m) => m[A.boxPlot.boxPlotMeanLineMarkerId] !== void 0);
   f && !u && (s === g.BoxPlotMonoFieldAndSplitBy ? c = g.BoxPlotMonoField : s === g.BoxPlotMultiFieldsAndSplitBy ? c = g.BoxPlotMultiFields : s === g.BoxPlotMonoFieldAndCategoryAndSplitBy && (c = g.BoxPlotMonoFieldAndCategory));
-  const p = q(e), B = oe(e), b = ie(e), x = z(e);
+  const p = q(e), v = oe(e), b = ie(e), x = z(e);
   let D;
   switch (c) {
     case g.BoxPlotMonoField:
@@ -708,7 +708,7 @@ function Ze(l) {
     }
     case g.BoxPlotMultiFieldsAndCategory: {
       D = t.flatMap(
-        (m) => B.map((d) => {
+        (m) => v.map((d) => {
           const y = {};
           let F = "";
           if (y.Field = d, m[A.boxPlot.boxPlotOutlierId])

package/dist/chunks/x-bounds.js

@@ -8,7 +8,7 @@ import { ai as S, M as L, T as b, a0 as T } from "./index.js";
 import { M as C, bF as M, bE as X } from "./index2.js";
 import { m as a, C as f } from "./model-setter.js";
 import { e as B, f as A } from "./utils2.js";
-import { l as p, s as y, h as O } from "./utils.js";
+import { l as p, s as y, f as O } from "./utils.js";
 const P = (t) => {
   for (const e of t.axes ?? [])
     for (const i of e?.guides ?? [])

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

@@ -830,7 +830,8 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor filterByExtent: boolean;
   /**
-   * When `true`, all chart elements are filtered based on the selection.
+   * When `true`, the chart uses the current selection as a data filter and renders only selected elements instead of rendering the full dataset with selection styling.
+   * Axis bounds, time binning intervals will be computed based on the selected elements only.
    *
    * **Note**: Not applicable to gauges or charts configured with imagery layers.
    *
@@ -838,7 +839,7 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor filterBySelection: boolean;
   /**
-   * When `true`, all chart elements are filtered based on the view extent.
+   * When `true`, chart queries are constrained to the current map view extent. The chart refreshes as the view extent changes, and the axis bounds or other derived values are recalculated from the view extent data.
    *
    * @default false
    */
@@ -846,12 +847,35 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Callback function used to format the gauge inner label. If the returned string contains HTML tags they will be interpreted as such.
    *
+   * @example
+   * ```ts
+   * // Render a centered custom gauge label with the value formatted to 2 decimal places.
+   * chartElement.gaugeInnerLabelFormatter = (value) => {
+   *   return `<div style="text-align: center;"><u>Custom gauge inner label: </u><br /><b>${Number(value).toFixed(2)}</b></div>`;
+   * };
+   * ```
+   *
+   * ![gaugeInnerLabelFormatter](https://developers.arcgis.com/javascript/latest/assets/references/components/chart/gaugeInnerLabelFormatter.avif)
+   *
    * **Note**: Applicable to gauges only.
    */
   accessor gaugeInnerLabelFormatter: GaugeInnerLabelFormatCallback | undefined;
   /**
    * Callback function used to format the axes guides tooltip. If the returned string contains HTML tags they will be interpreted as such.
    *
+   * @example
+   * ```ts
+   * // Render a custom tooltip with the guide's start and end values.
+   * chartElement.guideTooltipFormatter = (guide) => {
+   *   return `
+   *     <u>Custom guide tooltip</u><br />
+   *     Range: <b>${guide.start} - ${guide.end}</b>
+   *   `;
+   * };
+   * ```
+   *
+   * ![guideTooltipFormatter](https://developers.arcgis.com/javascript/latest/assets/references/components/chart/guideTooltipFormatter.avif)
+   *
    * **Note**: Not applicable to pie charts.
    */
   accessor guideTooltipFormatter: GuideTooltipFormatCallback | undefined;
@@ -915,18 +939,18 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor ignoreSmoothRenderingLimit: boolean;
   /**
-   * This property will be effective when the component's `view` is provided or when the `layer` is set to a FeatureLayerView.
+   * When `true`, it signals the queries to ignore the view's extent, whether an additional geometry filter is provided or not.
    *
-   * By default the queries made by the chart will consider the view's extent as the unique geometry filter applicable. This implies ignoring any
-   * geometry passed through the model (`component.model.dataFilters`) or the runtime filters (`component.runtimeDataFilters`).
+   * This property will be effective when the component's [view](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#view) property is provided or when the [layer](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#layer) property is set to [`FeatureLayerView`](/references/core/views/layers/FeatureLayerView/).
    *
-   * Setting this property to `false` signals the queries to ignore the view's extent, whether an additional geometry filter is provided or not.
+   * By default the queries made by the chart will consider the view's extent as the unique geometry filter applicable. This implies ignoring any
+   * geometry filters passed through the [model](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#model) or the [runtimeDataFilters](https://developers.arcgis.com/javascript/latest/references/charts-components/components/arcgis-chart/#runtimeDataFilters) properties.
    *
    * @default false
    */
   accessor ignoreViewExtent: boolean;
   /**
-   * Disables all interactions on the chart.
+   * When `true`, all interactions such as zooming and selection are disabled on the chart. The chart will be rendered in a read-only state.
    *
    * @default false
    */
@@ -953,9 +977,10 @@ export abstract class ArcgisChart extends LitElement {
   /**
    * Layer item ID associated with the chart to be rendered. Can be used in conjunction with the `chartIndex` property. If `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.
    *
-   * The layer item ID can be found in the URL of the layer's item page on ArcGIS Online or Enterprise. For example, in the URL `https://www.arcgis.com/home/item.html?id=8871626e970a4f3e9d6113ec63a92f2f`, the layer item ID is `8871626e970a4f3e9d6113ec63a92f2f`.
+   * The layer item ID can be found in the URL of the layer's item page on ArcGIS Online or Enterprise.
+   * For example, in the URL `https://www.arcgis.com/home/item.html?id=8871626e970a4f3e9d6113ec63a92f2f`, the layer item ID is `8871626e970a4f3e9d6113ec63a92f2f`.
    *
-   * Supported layers include: `FeatureLayer`, `SubtypeSublayer`, `ImageryLayer`, `ImageryTileLayer` and `WCSLayer`.
+   * Supported layer types include: [`FeatureLayer`](/references/core/layers/FeatureLayer), [`SubtypeSublayer`](/references/core/layers/support/SubtypeSublayer), [`ImageryLayer`](/references/core/layers/ImageryLayer), [`ImageryTileLayer`](/references/core/layers/ImageryTileLayer) and [`WCSLayer`](/references/core/layers/WCSLayer).
    *
    * @example
    * ```html
@@ -981,8 +1006,25 @@ export abstract class ArcgisChart extends LitElement {
    */
   accessor legendPosition: WebChartLegendPositions | undefined;
   /**
-   * A callback function used to format the legend value labels. If the returned string contains HTML tags they will be interpreted as such.
-   * If provided, the formatter will be used if at least [displayNumericValue](https://developers.arcgis.com/javascript/latest/references/charts-components/spec/web-chart/#WebChartPieChartLegend-displayNumericValue) or [displayPercentage](https://developers.arcgis.com/javascript/latest/references/charts-components/spec/web-chart/#WebChartPieChartLegend-displayPercentage) is `true`.
+   * When the pie chart label contains either a numeric value or a percentage (which can be set through the
+   * [setDisplayNumericValue](https://developers.arcgis.com/javascript/latest/references/charts-components/model/pie-chart-model/pie-chart-model/#setDisplayNumericValue) and
+   * [setDisplayPercentage](https://developers.arcgis.com/javascript/latest/references/charts-components/model/pie-chart-model/pie-chart-model/#setDisplayPercentage) methods from the pie chart model), this property
+   * can be used to format the numeric value and/or percentage. If the returned string contains HTML tags they will be interpreted as such.
+   *
+   * @example
+   * ```ts
+   * // Set the pie chart model to display both numeric value and percentage.
+   * pieChartModel.setDisplayNumericValue(true);
+   * pieChartModel.setDisplayPercentage(true);
+   *
+   * // Render the numeric value and percentage in bold and italic respectively, with 2 decimal places.
+   * chartElement.legendValueLabelFormatter = (value, percentage) => {
+   *   const formatTo2Decimals = (input) => Number(input).toFixed(2);
+   *   return `<strong><u>${formatTo2Decimals(value)}</u></strong> (<em>${formatTo2Decimals(percentage)}%</em>)`;
+   * };
+   * ```
+   *
+   * ![legendValueLabelFormatter](https://developers.arcgis.com/javascript/latest/assets/references/components/chart/legendValueLabelFormatter.avif)
    *
    * **Note**: Applicable to pie charts only.
    */