@arcgis/charts-components 5.2.0-next.99 → 6.0.0-next.1

package/dist/chunks/box-plot-model.js

@@ -1,29 +1,30 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { log as d } from "@arcgis/toolkit/log";
-import { a as W } from "./chart-object-literals.js";
-import { l as f, ao as O, aa as P, g as D, r as A, ab as y, am as m, a9 as p } from "./index3.js";
-import { c6 as V, c1 as h } from "./index.js";
-import { C as T } from "./chart-model.js";
-import { m as o } from "./model-setter.js";
-import { B as E } from "./common.js";
-import { M as N, a as R, W as z, b as U } from "./data-labels-visibility.js";
+import { isEqual as W } from "es-toolkit/compat";
+import { log as y } from "@arcgis/toolkit/log";
+import { a as O } from "./chart-object-literals.js";
+import { l as p, ap as D, aa as P, g as R, ab as m, an as u, ac as S, r as A } from "./index3.js";
+import { cg as V, cb as h } from "./index.js";
+import { m as s } from "./model-setter.js";
+import { B as T } from "./common.js";
+import { M as E, a as N, W as z, b as U } from "./data-labels-visibility.js";
 import { M as X, a as j } from "./model-with-y-guides.js";
-import { W as k, c as G, d as K } from "./axis-lines-symbol.js";
-import { W as Y, c as q, d as H } from "./generate-x-axis-title.js";
+import { W as k, c as q, d as G } from "./axis-lines-symbol.js";
+import { W as K, c as Y, d as H } from "./generate-x-axis-title.js";
 import { W as J, a as Q } from "./x-bounds.js";
 import { W as Z } from "./data-labels-symbol.js";
 import { W as $ } from "./rotated-state.js";
 import { g as ee, b as te, s as ie, a as se } from "./series.js";
-import { j as oe, h as re, k as ne, f as ae } from "./utils.js";
-import { s as le, d as he, e as ce, f as ge, h as de, i as u, j as S, k as _, l as L, m as B, g as fe, n as ye, o as me, p as C, a as pe, c as ue, b as Se, q as _e, r as F, t as Le, u as Be, v as M, w as Ce, x, y as Fe, z as Me, A as xe, B as Ie, C as we, D as be, E as ve, F as We, G as I } from "./box-plot-data.js";
-var Oe = Object.defineProperty, Pe = Object.getOwnPropertyDescriptor, r = (c, e, t, n) => {
-  for (var s = Pe(e, t), a = c.length - 1, l; a >= 0; a--)
-    (l = c[a]) && (s = l(e, t, s) || s);
-  return s && Oe(e, t, s), s;
+import { k as re, j as oe, l as ne, h as ae } from "./utils.js";
+import { s as le, d as he, e as ce, f as ge, h as de, i as g, j as d, k as _, l as L, m as B, g as fe, n as ye, o as pe, p as C, a as me, c as ue, b as Se, q as _e, r as F, t as Le, u as Be, v as M, w as Ce, x, y as Fe, z as Me, A as xe, B as Ie, C as be, D as ve, E as we, F as We, G as I } from "./box-plot-data.js";
+import { C as Oe } from "./chart-model.js";
+var De = Object.defineProperty, Pe = Object.getOwnPropertyDescriptor, r = (c, e, t, n) => {
+  for (var o = Pe(e, t), a = c.length - 1, l; a >= 0; a--)
+    (l = c[a]) && (o = l(e, t, o) || o);
+  return o && De(e, t, o), o;
 };
-class i extends T {
+class i extends Oe {
   constructor() {
-    super(...arguments), this._chartType = W.BoxPlotSeries, this._category = f, this._splitByField = "", this._numericFields = [];
+    super(...arguments), this._chartType = O.BoxPlotSeries, this._category = p, this._splitByField = "", this._numericFields = [], this._splitBySeriesLimitReached = !1, this._splitBySeriesCount = 0;
   }
   async setup(e) {
     await this.loadConfigFromLayer(e), this.setupLocalProps(), e.config !== void 0 && await this.rebuildSeries(), typeof this.resolveSetup == "function" && this.resolveSetup();
@@ -31,6 +32,60 @@ class i extends T {
   // ---------------------------------------------------------------------------------------------
   // #region Data Props
   // ---------------------------------------------------------------------------------------------
+  /**
+   * The chart limits used when generating split-by series.
+   *
+   * @internal
+   */
+  get chartLimits() {
+    return this._chartLimits;
+  }
+  /**
+   * Sets the chart limits used when generating split-by series.
+   *
+   * When the limits change after model setup, the series are rebuilt asynchronously. Call the update() method to wait
+   * for the rebuild to complete.
+   *
+   * @internal
+   *
+   * @param chartLimits The chart limits to apply, or `undefined` to use the default limits.
+   */
+  set chartLimits(e) {
+    const t = !W(this._chartLimits, e);
+    this._chartLimits = e, t && this.layerInfo !== void 0 && this._config !== void 0 && this.processSeriesRebuild("chartLimits");
+  }
+  /**
+   * Get whether split-by series were trimmed to the configured chart limit.
+   *
+   * @internal
+   */
+  get splitBySeriesLimitReached() {
+    return this._splitBySeriesLimitReached;
+  }
+  /**
+   * Sets whether split-by series were trimmed to the configured chart limit.
+   *
+   * @internal
+   */
+  set splitBySeriesLimitReached(e) {
+    this._splitBySeriesLimitReached = e;
+  }
+  /**
+   * Get the number of split-by series before applying the configured chart limit.
+   *
+   * @internal
+   */
+  get splitBySeriesCount() {
+    return this._splitBySeriesCount;
+  }
+  /**
+   * Sets the number of split-by series before applying the configured chart limit.
+   *
+   * @internal
+   */
+  set splitBySeriesCount(e) {
+    this._splitBySeriesCount = e;
+  }
   /**
    * The category field for the box plot.
    */
@@ -39,7 +94,7 @@ class i extends T {
   }
   set category(e) {
     const t = e.trim() === "";
-    this._category = t ? f : e, this.processSeriesRebuild("category");
+    this._category = t ? p : e, this.processSeriesRebuild("category");
   }
   /**
    * The numeric fields array for the box plot.
@@ -49,7 +104,7 @@ class i extends T {
   }
   set numericFields(e) {
     const { layerFieldsInfo: t } = this.layerInfo;
-    typeof e == "string" && (e = [e]), oe(t, e) ? (this._numericFields = e, le(this._category, this._numericFields) && (this._splitByField = ""), this.processSeriesRebuild("numericFields")) : d("error", "box-plot-model", "Invalid `numericFields`");
+    typeof e == "string" && (e = [e]), re(t, e) ? (this._numericFields = e, le(this._category, this._numericFields) && (this._splitByField = ""), this.processSeriesRebuild("numericFields")) : y("error", "box-plot-model", "Invalid `numericFields`");
   }
   /**
    * The split-by field for the box plot.
@@ -58,7 +113,7 @@ class i extends T {
     return this._splitByField;
   }
   set splitByField(e) {
-    re(this.layerInfo.layerFieldsInfo, e) ? (this._splitByField = e, this.processSeriesRebuild("splitByField")) : d("error", "box-plot-model", "Invalid `splitByField`");
+    oe(this.layerInfo.layerFieldsInfo, e) ? (this._splitByField = e, this.processSeriesRebuild("splitByField")) : y("error", "box-plot-model", "Invalid `splitByField`");
   }
   /**
    * Whether outliers are shown.
@@ -89,13 +144,37 @@ class i extends T {
     }), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange"));
   }
   /**
-   * Gets the sort order of the box plot data.
+   * Gets the data sort order of the box plot.
+   *
+   * Data sort orders the chart's categories or summary statistics. It applies whether the chart has one series or many.
+   * This is distinct from {@link model/box-plot-model/box-plot-model#orderOfSeries orderOfSeries}, which
+   * reorders the series themselves and only has an effect on multi-series charts.
+   *
+   * Sort order kinds:
+   * - `xAxisAsc` / `xAxisDesc` — order by category axis values ascending or descending
+   * - `meanAsc` / `meanDesc` — order by mean ascending or descending
+   * - `medianAsc` / `medianDesc` — order by median ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @returns The current data sort order kind.
+   * @since 5.2
+   */
+  getDataSortOrder() {
+    return g(this._config);
+  }
+  setDataSortOrder(e, t) {
+    d(e, this._config, t);
+  }
+  /**
+   * Gets the data sort order of the box plot.
+   *
+   * @deprecated since 5.2. Use {@link model/box-plot-model/box-plot-model#getDataSortOrder getDataSortOrder} instead. This method will be removed from `BoxPlotModel` in 6.0.
    */
   getSortOrder() {
-    return u(this._config);
+    return g(this._config);
   }
   setSortOrder(e, t) {
-    S(e, this._config, t);
+    d(e, this._config, t);
   }
   /**
    * Gets the list of the category values for the chart.
@@ -109,15 +188,15 @@ class i extends T {
   }
   async setDataFilters(e) {
     super.setDataFilters(e);
-    const t = u(this._config);
-    if (t === E.customSort) {
+    const t = g(this._config);
+    if (t === T.customSort) {
       this.startAsyncUpdate();
       const n = await _({
         config: this._config,
         layerInfo: this.layerInfo,
         errorStrings: this.commonStrings.errorStrings
       });
-      S(t, this._config, n), this.finishAsyncUpdate();
+      d(t, this._config, n), this.finishAsyncUpdate();
     }
     this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange"));
   }
@@ -165,10 +244,10 @@ class i extends T {
   /**
    * The color of the boxes when showing mean lines.
    *
-   * Only applicable when mean lines are shown.
+   * **Note**: Only applicable when mean lines are shown.
    */
   get meanLinesBoxColor() {
-    return me(this._config);
+    return pe(this._config);
   }
   set meanLinesBoxColor(e) {
     C(e, this._config);
@@ -181,11 +260,11 @@ class i extends T {
    * @private
    */
   setupLocalProps() {
-    this._category = pe(this._config), this._splitByField = ue(this._config), this._numericFields = Se(this._config);
+    this._category = me(this._config), this._splitByField = ue(this._config), this._numericFields = Se(this._config);
   }
   /** @private */
   generateDefaultConfig() {
-    const e = O(this.commonStrings);
+    const e = D(this.commonStrings);
     return e.series = [P(this.commonStrings)], e;
   }
   resetConfig() {
@@ -209,7 +288,7 @@ class i extends T {
    * @private
    */
   async processSeriesRebuild(e) {
-    this.usingSplitBy() ? (this.startAsyncUpdate(), await this.fetchSplitByFieldInfos(), F(this.getBuildNewSeriesProps()), this.finishAsyncUpdate()) : F(this.getBuildNewSeriesProps()), this.setupLocalProps(), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate(e);
+    this.usingSplitBy() ? (this.startAsyncUpdate(), await this.fetchSplitByFieldInfos(), F(this.getBuildNewSeriesProps()), this.finishAsyncUpdate()) : (this._splitBySeriesLimitReached = !1, this._splitBySeriesCount = 0, F(this.getBuildNewSeriesProps())), this.setupLocalProps(), this.dispatchEvent(new CustomEvent("arcgisChartsModelDataChange")), this.emitConfigUpdate(e);
   }
   /**
    * Fetches the split-by field information and stores it in a private member for use in building the series.
@@ -224,8 +303,9 @@ class i extends T {
       aggregationFields: this.numericFields,
       splitByField: this._splitByField,
       fetchNullValues: e,
+      chartLimits: this._chartLimits,
       errorStrings: this.commonStrings?.errorStrings
-    }), this.splitByFieldInfos;
+    }), this._splitBySeriesLimitReached = this.splitByFieldInfos.seriesLimitReached, this._splitBySeriesCount = this.splitByFieldInfos.totalSeriesCount, this.splitByFieldInfos;
   }
   //#endregion
   // #region Private Methods
@@ -300,7 +380,13 @@ class i extends T {
     this.showMeanLines === !0 && Me({ width: e, seriesIndex: t, config: this._config });
   }
   /**
-   * The order of the series array by returning an array of series ids.
+   * The order of the series array as an array of series ids.
+   *
+   * Series order reorders the series themselves (legend and draw order). Use this only for a multi-series chart;
+   * on a single-series chart it has no effect.
+   *
+   * This is distinct from {@link model/box-plot-model/box-plot-model#getDataSortOrder getDataSortOrder}, which
+   * orders categories or summary statistics within the chart data.
    */
   get orderOfSeries() {
     return xe(this._config);
@@ -309,7 +395,7 @@ class i extends T {
     Ie(e, this._config);
   }
   moveSeries(e, t) {
-    we(e, t, this._config);
+    be(e, t, this._config);
   }
   /**
    * The index of the box plot series in the series array in config object when show mean is true.
@@ -317,11 +403,11 @@ class i extends T {
    * **Note**: There is only one box plot series when show mean is `true`. The function returns `-1` if show mean is `false`.
    */
   get boxPlotSeriesIndexWhenMeanLinesShown() {
-    return be(this._config);
+    return ve(this._config);
   }
   moveCustomSortValuesInOrderByList(e, t) {
-    const n = L(this._config), [s] = n.splice(e, 1);
-    n.splice(t, 0, s), B(n, this._config);
+    const n = L(this._config), [o] = n.splice(e, 1);
+    n.splice(t, 0, o), B(n, this._config);
   }
   // ---------------------------------------------------------------------------------------------
   // #region General Methods
@@ -330,7 +416,7 @@ class i extends T {
    * Generate the proper chart title given the current config.
    */
   generateChartTitle() {
-    return ve(this._config, this.layerInfo, this.commonStrings);
+    return we(this._config, this.layerInfo, this.commonStrings);
   }
   /**
    * Generate the proper y-axis title given the current config.
@@ -340,117 +426,120 @@ class i extends T {
   }
   resetSeriesStyling() {
     for (let e = this.showMeanLines === !0 ? 1 : 0; e < this.seriesLength; e += 1) {
-      const t = this.getSeriesId(e), n = D({
+      const t = this.getSeriesId(e), n = R({
         colorIndex: e,
         opacity: A
-      }), s = this._config.series[e];
+      }), o = this._config.series[e];
       x(n, e, this._config);
       const a = I({
-        series: s,
+        series: o,
         splitByField: this._splitByField,
         layerInfo: this.layerInfo,
         commonStrings: this.commonStrings
       });
-      M(a ?? t, e, this._config), this.showMeanLines === !0 && h(s) && (ie(m, s), se(p, s));
+      M(a ?? t, e, this._config), this.showMeanLines === !0 && h(o) && (ie(u, o), se(S, o));
     }
-    this.showMeanLines === !0 && C(y, this._config), this._config.colorMatch = !0;
+    this.showMeanLines === !0 && C(m, this._config), this._config.colorMatch = !0;
   }
   /**
    * Returns whether the series styling is able to be reset.
    */
   resetAvailable() {
-    const e = !this.colorMatch, t = this.showMeanLines === !0 && this.meanLinesBoxColor !== y;
-    let n = !1, s = !1;
+    const e = !this.colorMatch, t = this.showMeanLines === !0 && this.meanLinesBoxColor !== m;
+    let n = !1, o = !1;
     if (!e)
       for (let a = this.showMeanLines === !0 ? 1 : 0; a < this.seriesLength; a += 1) {
-        const l = this._config.series[a], g = I({
+        const l = this._config.series[a], f = I({
           series: l,
           splitByField: this._splitByField,
           layerInfo: this.layerInfo,
           commonStrings: this.commonStrings
-        }), w = this.getSeriesName(a);
-        if (g !== void 0 && g !== w) {
+        }), b = this.getSeriesName(a);
+        if (f !== void 0 && f !== b) {
           n = !0;
           break;
         }
         if (this.showMeanLines === !0 && h(l)) {
-          const b = this.getSeriesLineStyle(a), v = this.getSeriesLineWidth(a);
-          if (b !== m || v !== p) {
-            s = !0;
+          const v = this.getSeriesLineStyle(a), w = this.getSeriesLineWidth(a);
+          if (v !== u || w !== S) {
+            o = !0;
             break;
           }
         }
       }
-    return e || t || n || s;
+    return e || t || n || o;
   }
 }
 r([
-  o
+  s
 ], i.prototype, "showOutliers");
 r([
-  o
+  s
 ], i.prototype, "standardizeValues");
 r([
-  o
+  s
+], i.prototype, "setDataSortOrder");
+r([
+  s
 ], i.prototype, "setSortOrder");
 r([
-  o
+  s
 ], i.prototype, "setDataFilters");
 r([
-  o
+  s
 ], i.prototype, "orderByList");
 r([
-  o
+  s
 ], i.prototype, "showMeanLines");
 r([
-  o
+  s
 ], i.prototype, "meanLinesBoxColor");
 r([
-  o
+  s
 ], i.prototype, "resetConfig");
 r([
-  o
+  s
 ], i.prototype, "setSeriesName");
 r([
-  o
+  s
 ], i.prototype, "setSeriesColor");
 r([
-  o
+  s
 ], i.prototype, "setSeriesLineStyle");
 r([
-  o
+  s
 ], i.prototype, "setSeriesLineWidth");
 r([
-  o
+  s
 ], i.prototype, "orderOfSeries");
 r([
-  o
+  s
 ], i.prototype, "moveSeries");
 r([
-  o
+  s
 ], i.prototype, "moveCustomSortValuesInOrderByList");
 r([
-  o
+  s
 ], i.prototype, "resetSeriesStyling");
-const De = [
+const Re = [
   X,
+  E,
   N,
-  R,
   z,
   $,
   U,
   Z,
   j,
-  Y,
+  K,
   J,
-  q,
+  Y,
   Q,
   k,
+  q,
   G,
-  K,
   H
 ];
-ae(i, De);
+ae(i, Re);
 export {
   i as BoxPlotModel
 };

package/dist/chunks/chart-model.js

@@ -1,16 +1,16 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { f as j } from "./utils.js";
+import { h as j } from "./utils.js";
 import { g as F, W, c as L, d as I } from "./series-length.js";
 import { m as a, C as n } from "./model-setter.js";
-import { a0 as p, a2 as c, a1 as f } from "./index3.js";
+import { a1 as p, a3 as c, a2 as f } from "./index3.js";
 import { u as z } from "./index2.js";
-import { p as N } from "./index.js";
+import { q as N } from "./index.js";
 var R = Object.defineProperty, M = Object.getOwnPropertyDescriptor, U = (e, t, r, l) => {
   for (var i = M(t, r), s = e.length - 1, o; s >= 0; s--)
     (o = e[s]) && (i = o(t, r, i) || i);
   return i && R(t, r, i), i;
 };
-const B = (e) => e.title?.content, E = (e, t) => {
+const B = (e) => e.title?.content, q = (e, t) => {
   if (e) {
     const r = F(t);
     t.title === void 0 && (t.title = p({
@@ -32,16 +32,16 @@ class h extends n {
     return B(this._config);
   }
   set titleSymbol(t) {
-    E(t, this._config);
+    q(t, this._config);
   }
 }
 U([
   a
 ], h.prototype, "titleSymbol");
-var q = Object.defineProperty, A = Object.getOwnPropertyDescriptor, G = (e, t, r, l) => {
+var E = Object.defineProperty, A = Object.getOwnPropertyDescriptor, G = (e, t, r, l) => {
   for (var i = A(t, r), s = e.length - 1, o; s >= 0; s--)
     (o = e[s]) && (i = o(t, r, i) || i);
-  return i && q(t, r, i), i;
+  return i && E(t, r, i), i;
 };
 class u extends n {
   /**
@@ -373,12 +373,12 @@ class T extends n {
 Nt([
   a
 ], T.prototype, "backgroundColor");
-var Ut = Object.defineProperty, Bt = Object.getOwnPropertyDescriptor, Et = (e, t, r, l) => {
+var Ut = Object.defineProperty, Bt = Object.getOwnPropertyDescriptor, qt = (e, t, r, l) => {
   for (var i = Bt(t, r), s = e.length - 1, o; s >= 0; s--)
     (o = e[s]) && (i = o(t, r, i) || i);
   return i && Ut(t, r, i), i;
 };
-const qt = (e, t) => t.series[e].visible ?? !0, At = (e, t) => {
+const Et = (e, t) => t.series[e].visible ?? !0, At = (e, t) => {
   z({ detail: e }, t);
 };
 class C extends n {
@@ -388,13 +388,13 @@ class C extends n {
    * @param seriesIndex The series index
    */
   getSeriesVisibility(t) {
-    return qt(t, this._config);
+    return Et(t, this._config);
   }
   setSeriesVisibility(t) {
     At(t, this._config);
   }
 }
-Et([
+qt([
   a
 ], C.prototype, "setSeriesVisibility");
 const Gt = (e, t) => t.series[e]?.id;

package/dist/chunks/chart-object-literals.js

@@ -1,5 +1,5 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-const r = {
+const t = {
   Chart: "chart",
   Text: "chartText",
   Overlay: "chartOverlay",
@@ -28,7 +28,8 @@ const r = {
   Buffer: "buffer",
   SizePolicy: "sizeScale",
   CalendarDateParts: "calendarDateParts",
-  HistogramBin: "histogramBin"
+  HistogramBin: "histogramBin",
+  LocationOfInterest: "locationOfInterest"
 }, e = {
   Count: "count",
   Sum: "sum",
@@ -43,7 +44,7 @@ const r = {
   CentroidAggregate: "centroid-aggregate",
   ConvexHullAggregate: "convex-hull-aggregate",
   NoAggregation: "no_aggregation"
-}, t = {
+}, r = {
   /*
    * No data transformation applied.
    */
@@ -136,11 +137,11 @@ const r = {
 }, p = {
   Linear: "linear",
   Logarithmic: "logarithmic"
-}, W = {
+}, O = {
   Radial: "radial",
   Circular: "circular",
   Horizontal: "horizontal"
-}, O = {
+}, W = {
   YValue: "arcgis-charts-y-value",
   Mean: "arcgis-charts-mean",
   Median: "arcgis-charts-median",
@@ -165,7 +166,7 @@ export {
   f as G,
   c as S,
   m as W,
-  r as a,
+  t as a,
   C as b,
   n as c,
   e as d,
@@ -177,14 +178,14 @@ export {
   b as j,
   p as k,
   u as l,
-  W as m,
+  O as m,
   h as n,
   y as o,
   o as p,
   x as q,
   T as r,
-  t as s,
-  O as t,
+  r as s,
+  W as t,
   s as u,
   d as v
 };

package/dist/chunks/chart-ui-utils.js

@@ -3,7 +3,7 @@ import { F as o, W as f } from "./interfaces.js";
 import { i as b } from "./utils.js";
 import { R as u } from "./rest-js-object-literals.js";
 import { d as r, l as m } from "./chart-object-literals.js";
-import { D as p, bA as g } from "./index.js";
+import { E as p, bK as g } from "./index.js";
 import { t as d } from "./index2.js";
 import { F as n } from "./common.js";
 const F = {
@@ -55,7 +55,7 @@ function C(e) {
   }
   return t;
 }
-function A(e, t, a) {
+function E(e, t, a) {
   let i = !1;
   const s = typeof e == "string" ? Number.parseFloat(e) : e, c = typeof t == "string" ? Number.parseFloat(t) : t, l = typeof a == "string" ? Number.parseFloat(a) : a;
   return Number.isNaN(s) || (i = (c === void 0 || Number.isNaN(c) || s >= c) && (l === void 0 || Number.isNaN(l) || s <= l)), i;
@@ -68,7 +68,7 @@ function x(e, t) {
   }
   return a === void 0 ? "" : `${a}`;
 }
-function E(e) {
+function A(e) {
   const { inputElement: t, status: a } = e;
   t.status = a;
 }
@@ -160,11 +160,11 @@ export {
   P as f,
   U as g,
   C as h,
-  A as i,
+  E as i,
   w as j,
   W as k,
   R as l,
-  E as m,
+  A as m,
   V as n,
   M as o,
   I as p,