@arcgis/charts-components 5.2.0-next.9 → 5.2.0-next.91

package/dist/chart-rendering/common/interfaces.d.ts

@@ -1,7 +1,7 @@
 import type MapView from "@arcgis/core/views/MapView.js";
 import type SceneView from "@arcgis/core/views/SceneView.js";
 import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView.js";
-import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
+import type { ChartLayerInput } from "../../interfaces.js";
 import type { WebChartDataItem, WebChartDataItemValue, WebChartDataTypes } from "../../spec/data-source.js";
 import type { WebChart, WebChartDataFilters, WebChartPieChartSlice, WebGaugeChart } from "../../spec/web-chart.js";
 import type { ActionModes, CursorRange } from "../../utils/cursor/interfaces.js";
@@ -12,11 +12,6 @@ export interface NotifyOptions {
   closable?: boolean;
 }
 
-export interface GaugeMinMaxFromData {
-  minimumFromData?: number;
-  maximumFromData?: number;
-}
-
 /**
  * Describes the signature of the callback function used to customize the pie chart legend value labels.
  *
@@ -63,9 +58,17 @@ export type PreRenderCallback = (props: {
 
 /** JSON representation of the runtime chart options for the update or initialization. */
 export interface ChartOptions {
-  /** Whether to allow the object id to be used as a statistic other than `COUNT`. */
+  /**
+   * Whether to allow the object id to be used as a statistic other than `COUNT`.
+   *
+   * @deprecated since 5.2. Won't be replaced.
+   */
   allowUsingObjectIdStat?: boolean;
-  /** Whether to consider a `null` statistic as valid. */
+  /**
+   * Whether to consider a `null` statistic as valid.
+   *
+   * @deprecated since 5.2. Won't be replaced.
+   */
   nullAsValid?: boolean;
   /**
    * A property representing the selection to apply on the chart.
@@ -89,6 +92,8 @@ export interface ChartOptions {
    *   - Data source using a feature layer compatible with envelope aggregation
    *
    * The extent (IExtent) is returned through the property [featuresExtentField](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/index/#featuresExtentField).
+   *
+   * @deprecated since 5.2. Won't be replaced.
    */
   returnFeaturesExtent?: boolean;
   /**
@@ -100,24 +105,33 @@ export interface ChartOptions {
   /** Used to perform client-side queries. */
   view?: MapView | SceneView;
   /** Used to perform queries. */
-  layer?: FeatureLayerView | SupportedLayer | SupportedRasterLayer;
+  layer?: ChartLayerInput | FeatureLayerView;
   /** Enable filter by selection. */
   filterBySelection?: boolean;
   /**
    * Re-initialize chart object if the chart object is disposed. Honored only during the update call.
    *
+   * @deprecated since 5.2. Won't be replaced.
    * @default true
    */
   autoRecreateChart?: boolean;
   /**
-   * Indicates whether to automatically inverse the data label text color when it's too dark or too light.
+   * Indicates whether to automatically adjust the data label text color for readability based on its background color.
    *
-   * **Note**: Currently this feature is only available for stacked bar series and pie charts with `dataLabelsInside` set to true.
+   * **Note**: Applicable to heat charts only.
    */
   autoInverseDataLabelTextColor?: boolean;
-  /** Optional create message to be displayed in the chart container. */
+  /**
+   * Optional create message to be displayed in the chart container.
+   *
+   * @deprecated since 5.2. Won't be replaced.
+   */
   createMessage?: string;
-  /** Used to hide the loader animation (curtain and spinner), showed by default at every update. */
+  /**
+   * Used to hide the loader animation (curtain and spinner), showed by default at every update.
+   *
+   * @deprecated since 5.2. Won't be replaced.
+   */
   hideLoaderAnimation?: boolean;
   /**
    * Indicates whether to enable or disable interactions on the chart.
@@ -170,6 +184,7 @@ export interface ChartOptions {
    * When data is retrieved from the server, the server excludes all features having a count of 0 from the response; hence resulting in missing entries on the charts.
    * When this property is set to true, the dataset will keep these gaps instead of filling them with 0s.
    *
+   * @deprecated since 5.2. Won't be replaced.
    * @default false
    */
   hideZeroCountCategories?: boolean;
@@ -182,12 +197,15 @@ export interface ChartOptions {
    */
   chartLimits?: ChartElementLimit;
   /**
-   * Set the chart's mode.
-   * - `zoom`: Allows to zoom on the chart. All selection is disabled.
-   * - `mono-selection`: The selection is enabled but only one element can be selected. Zoom is disabled.
-   * - `multi-selection`: The selection is enabled and allows selecting multiple elements. Zoom is disabled.
-   * - `multi-selection-with-ctrl-key`: The selection is enabled and allows selecting multiple elements when the ctrl/cmd key is pressed. Zoom is disabled.
-   * - `none`: The zoom and selection features are disabled.
+   * Specifies how user interactions on the chart are handled.
+   *
+   * - `monoSelection`: Select one data point or series at a time. Each new selection replaces the previous selection.
+   * - `multiSelection`: Select multiple data points or series. Each new selection is added to the existing selection.
+   * - `multiSelectionWithCtrlKey`: Select multiple data points or series only while holding Ctrl (or Cmd on macOS). Without the key, selection behaves like `monoSelection`.
+   * - `zoom`: Zoom into an area of the chart.
+   * - `none`: Disable interaction-driven selection and zoom actions.
+   *
+   * **Note**: Not applicable to gauges.
    */
   actionMode?: ActionModes;
   /**
@@ -205,7 +223,11 @@ export interface ChartOptions {
    * This is used to support a selection workflow while the filter by extent mode is enabled.
    */
   viewExtentUpdated?: boolean;
-  /** Used to apply runtime filters to the chart's data while in Feature Layer mode. */
+  /**
+   * Used to apply runtime filters to the chart's data while in Feature Layer mode.
+   *
+   * @deprecated since 5.2. Won't be replaced.
+   */
   runtimeDataFilters?: WebChartDataFilters;
   /**
    * This property will be effective when the component's `view` is provided or when the `layer` is set to a `FeatureLayerView`.
@@ -268,6 +290,8 @@ export interface ChartOptions {
    * Callback function executed after the data has been processed and before the chart renders.
    * Can be used to alter the config from information extracted from the data for instance.
    * Only applicable to pie chart and gauge.
+   *
+   * @deprecated since 5.2. Won't be replaced.
    */
   chartWillRender?: PreRenderCallback;
   /**
@@ -281,6 +305,8 @@ export interface ChartOptions {
   /**
    * Whether the chart considers the view's time zone (`timeZone`) and refreshes whenever it changes.
    * **Note**: This applies to all temporal charts but heat chart which benefits automatically from the feature.
+   *
+   * @deprecated since 5.2. Won't be replaced.
    */
   syncViewTimeZone?: boolean;
   /**

package/dist/chunks/{type-guards3.js → action-bar-utils.js}

@@ -1,13 +1,13 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { g as d } from "./series-types.js";
-import { i as p } from "./rotated-state.js";
-import { u as a } from "./chart-object-literals.js";
-import { u, c as f, C as x, A as b } from "./index3.js";
-import { D as e, A as o, a as n } from "./index6.js";
-import { Y as F } from "./index2.js";
+import { g } from "./series-types.js";
+import { i as B } from "./rotated-state.js";
+import { a } from "./chart-object-literals.js";
+import { m as x, h as f, a as u, A as b } from "./index2.js";
+import { D as e, c as o, A as n } from "./index5.js";
+import { p as F } from "./index.js";
 import { i as I } from "./index4.js";
-import { c as L } from "./type-guards.js";
-import { b as E, k as D } from "./type-guards2.js";
+import { i as L } from "./type-guards.js";
+import { i as E, g as D } from "./type-guards2.js";
 const T = [
   e.EditChart,
   e.Legend,
@@ -21,7 +21,7 @@ const T = [
   e.SwitchSelection,
   e.ExportAsCSV,
   e.ExportAsImage
-], v = [
+], V = [
   e.EditChart,
   e.Legend,
   e.RotateChart,
@@ -34,7 +34,7 @@ const T = [
   e.SwitchSelection,
   e.ExportAsImage,
   e.ExportAsCSV
-], w = [
+], v = [
   e.EditChart,
   e.Legend,
   e.RotateChart,
@@ -47,7 +47,7 @@ const T = [
   e.SwitchSelection,
   e.ExportAsImage,
   e.ExportAsCSV
-], V = [
+], w = [
   e.EditChart,
   e.Legend,
   e.FilterBySelection,
@@ -110,16 +110,16 @@ const T = [
   e.ExportAsImage,
   e.ExportAsCSV
 ];
-function K(r) {
-  switch (r) {
+function Q(c) {
+  switch (c) {
     case a.BarSeries:
       return T;
     case a.LineSeries:
-      return v;
+      return V;
     case a.ComboLineAndBarSeries:
-      return w;
+      return v;
     case a.PieSeries:
-      return V;
+      return w;
     case a.HistogramSeries:
       return P;
     case a.ScatterSeries:
@@ -134,40 +134,32 @@ function K(r) {
       return [];
   }
 }
-const Q = (r, i, t) => {
-  const s = r.target.assignedNodes().find((S) => "legendToggle" in S), c = d(t?.series);
-  return s && (s.chartType = c, G({
-    actionBar: s,
+const U = (c, i, t) => {
+  const l = c.target.assignedNodes().find((S) => "legendToggle" in S), s = g(t?.series);
+  return l && (l.chartType = s, W({
+    actionBar: l,
     chartComponent: i,
     config: t
-  })), s;
+  })), l;
 };
-function G(r) {
-  const { actionBar: i, chartComponent: t, config: l, isInfoModalDisplayed: s } = r, c = u(t.selectionData), S = l?.legend ? l.legend.visible ?? !0 : !1;
-  if (i.chartType = d(l?.series), t.enableConfiguration || t.configurationEnabled) {
-    const y = i.hiddenActions ?? [];
-    i.hiddenActions = y.filter((B) => B !== e.EditChart);
+function W(c) {
+  const { actionBar: i, chartComponent: t, config: r, isInfoModalDisplayed: l } = c, s = x(t.selectionData), S = r?.legend ? r.legend.visible ?? !0 : !1;
+  if (i.chartType = g(r?.series), t.enableConfiguration || t.configurationEnabled) {
+    const p = i.hiddenActions ?? [];
+    i.hiddenActions = p.filter((y) => y !== e.EditChart);
   }
   i.editChartState = t.enableConfiguration || t.configurationEnabled ? o.Enabled : o.Disabled;
-  const g = l && f(l.series);
-  i.legendState = g ? o.Enabled : o.Disabled;
-  const C = E(t?.model) && D(t?.model) ? t.model.legendVisibility : S;
-  i.legendToggle = g && C ? n.Active : n.Inactive;
-  const m = E(t?.model) && p(t.model) ? t.model.rotated : l?.rotated;
-  i.rotateChartToggle = m ? n.Active : n.Inactive;
-  const h = F(l?.series ?? []) === x.PieFromFields, A = L(t.layer);
-  i.filterBySelectionState = !A && !h && (t.filterBySelection || !c && !t.filterByExtent) ? o.Enabled : o.Disabled, i.filterBySelectionToggle = t.filterBySelection ? n.Active : n.Inactive, i.filterByExtentState = t.filterByViewExtent || !t.filterBySelection ? o.Enabled : o.Disabled, i.filterByExtentToggle = t.filterByViewExtent ? n.Active : n.Inactive, i.zoomState = t.filterBySelection ? o.Disabled : o.Enabled, i.zoomToggle = t.actionMode === b.Zoom ? n.Active : n.Inactive, i.selectionState = t.filterBySelection ? o.Disabled : o.Enabled, i.selectionToggle = (t.actionMode ?? i.actionBarSelectionMode) === i.actionBarSelectionMode ? n.Active : n.Inactive, i.clearSelectionState = c ? o.Disabled : o.Enabled, i.fullExtentState = t.filterBySelection ? o.Disabled : o.Enabled, i.switchSelectionState = t.filterBySelection ? o.Disabled : o.Enabled, i.exportActionState = s || I(l) ? o.Disabled : o.Enabled;
-}
-function U(r) {
-  return r?.tagName.toLowerCase() === "arcgis-chart";
-}
-function X(r) {
-  return r !== void 0 && d(r.series) === a.GaugeSeries;
+  const d = r && f(r.series);
+  i.legendState = d ? o.Enabled : o.Disabled;
+  const m = E(t?.model) && D(t?.model) ? t.model.legendVisibility : S;
+  i.legendToggle = d && m ? n.Active : n.Inactive;
+  const C = E(t?.model) && B(t.model) ? t.model.rotated : r?.rotated;
+  i.rotateChartToggle = C ? n.Active : n.Inactive;
+  const h = F(r?.series ?? []) === u.PieFromFields, A = L(t.layer);
+  i.filterBySelectionState = !A && !h && (t.filterBySelection || !s && !t.filterByExtent) ? o.Enabled : o.Disabled, i.filterBySelectionToggle = t.filterBySelection ? n.Active : n.Inactive, i.filterByExtentState = t.filterByViewExtent || !t.filterBySelection ? o.Enabled : o.Disabled, i.filterByExtentToggle = t.filterByViewExtent ? n.Active : n.Inactive, i.zoomState = t.filterBySelection ? o.Disabled : o.Enabled, i.zoomToggle = t.actionMode === b.Zoom ? n.Active : n.Inactive, i.selectionState = t.filterBySelection ? o.Disabled : o.Enabled, i.selectionToggle = (t.actionMode ?? i.actionBarSelectionMode) === i.actionBarSelectionMode ? n.Active : n.Inactive, i.clearSelectionState = s ? o.Disabled : o.Enabled, i.fullExtentState = t.filterBySelection ? o.Disabled : o.Enabled, i.switchSelectionState = t.filterBySelection ? o.Disabled : o.Enabled, i.exportActionState = l || I(r) ? o.Disabled : o.Enabled;
 }
 export {
-  U as a,
-  K as g,
-  X as i,
-  Q as o,
-  G as u
+  Q as g,
+  U as o,
+  W as u
 };

package/dist/chunks/axis-lines-symbol.js

@@ -2,13 +2,13 @@
 import { C as r, m as a } from "./model-setter.js";
 import { a as f, s as c } from "./utils2.js";
 import { cloneDeep as x } from "lodash-es";
-import { E as y, T as b, I as m, Z as S } from "./index.js";
+import { a3 as y, a5 as b, a4 as m, t as S } from "./index3.js";
 var p = Object.defineProperty, v = Object.getOwnPropertyDescriptor, _ = (s, e, t, l) => {
   for (var i = v(e, t), o = s.length - 1, n; o >= 0; o--)
     (n = s[o]) && (i = n(e, t, i) || i);
   return i && p(e, t, i), i;
 };
-function E(s) {
+function X(s) {
   return s !== void 0 && "xAxisTitleSymbol" in s;
 }
 class d extends r {
@@ -46,7 +46,7 @@ const A = (s) => {
       }) : t.labels.content = x(s), t.labels.content.text = l;
     }
 };
-function I(s) {
+function B(s) {
   return s !== void 0 && "axisLabelsSymbol" in s;
 }
 class O extends r {
@@ -76,7 +76,7 @@ const W = (s) => {
   for (const t of e.axes ?? [])
     t !== void 0 && (t.lineSymbol = x(s) ?? S());
 };
-function X(s) {
+function E(s) {
   return s !== void 0 && "axisLinesSymbol" in s;
 }
 class w extends r {
@@ -95,9 +95,9 @@ D([
 ], w.prototype, "axisLinesSymbol");
 export {
   d as W,
-  I as a,
-  E as b,
+  B as a,
+  X as b,
   O as c,
   w as d,
-  X as i
+  E as i
 };

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

@@ -1,23 +1,25 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { m as n } from "./model-setter.js";
-import { S, s as h, a as g } from "./serial-chart-model.js";
+import { m as d } from "./model-setter.js";
+import { g, s as h, a as m, b as S, W as p } from "./rounded-corners.js";
+import { S as y, s as u, a as v, b } from "./serial-chart-model.js";
 import { h as c } from "./serial-chart-data.js";
-import { f as m } from "./data.js";
-import { g as p, s as y, a as u, b as v } from "./bar-chart-series.js";
-import { u as O } from "./chart-object-literals.js";
-import { w as b, x as _, am as L, aB as I } from "./index.js";
-import { an as a } from "./index2.js";
-var C = Object.defineProperty, B = Object.getOwnPropertyDescriptor, d = (o, e, t, r) => {
-  for (var i = B(e, t), s = o.length - 1, f; s >= 0; s--)
-    (f = o[s]) && (i = f(e, t, i) || i);
-  return i && C(e, t, i), i;
+import { C } from "./index2.js";
+import { f as O } from "./data.js";
+import { f as _ } from "./utils.js";
+import { a as I } from "./chart-object-literals.js";
+import { an as L, $ as z, g as B, r as H } from "./index3.js";
+import { r as n } from "./index.js";
+var x = Object.defineProperty, D = Object.getOwnPropertyDescriptor, l = (a, e, t, r) => {
+  for (var i = D(e, t), s = a.length - 1, f; s >= 0; s--)
+    (f = a[s]) && (i = f(e, t, i) || i);
+  return i && x(e, t, i), i;
 };
-class l extends S {
+class o extends y {
   constructor() {
-    super(...arguments), this._chartType = O.BarSeries;
+    super(...arguments), this._chartType = I.BarSeries;
   }
   async setup(e) {
-    await this.loadConfigFromLayer(e), this.setupLocalProps(), e.config !== void 0 && this.updateSeriesFromLayerFilter(), typeof this.resolveSetup == "function" && this.resolveSetup();
+    await this.loadConfigFromLayer(e), this.setupLocalProps(), e.config !== void 0 && await this.rebuildSeries(), typeof this.resolveSetup == "function" && this.resolveSetup();
   }
   // #endregion
   // ---------------------------------------------------------------------------------------------
@@ -25,10 +27,10 @@ class l extends S {
   // ---------------------------------------------------------------------------------------------
   /** @private */
   generateDefaultConfig() {
-    const e = b(this.commonStrings);
+    const e = L(this.commonStrings);
     return e.series = [
-      _({
-        objectIDField: a(this.layerInfo.layer).idField,
+      z({
+        objectIDField: n(this.layerInfo.layer).idField,
         commonStrings: this.commonStrings
       })
     ], e;
@@ -44,10 +46,14 @@ class l extends S {
    * @param seriesIndex - The index of the series.
    */
   getSeriesHideOversizedSideBySideLabels(e) {
-    return p(e, this._config);
+    return g(e, this._config);
   }
   setSeriesHideOversizedSideBySideLabels(e, t) {
-    y(e, t, this._config);
+    h({
+      hide: e,
+      seriesIndex: t,
+      config: this._config
+    });
   }
   /**
    * Gets whether to hide oversized stacked labels of the series based on the series index.
@@ -56,10 +62,10 @@ class l extends S {
    * @param seriesIndex - The index of the series.
    */
   getSeriesHideOversizedStackedLabels(e) {
-    return u(e, this._config);
+    return m(e, this._config);
   }
   setSeriesHideOversizedStackedLabels(e, t) {
-    v(e, t, this._config);
+    S({ hide: e, seriesIndex: t, config: this._config });
   }
   // #endregion
   //#region Sorting Methods
@@ -68,25 +74,25 @@ class l extends S {
    * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
    */
   getSortOrder() {
-    return m(this._config);
+    return O(this._config);
   }
   resetSeriesStyling() {
     for (let e = 0; e < this.seriesLength; e += 1) {
-      const t = this.getSeriesId(e), r = L({
+      const t = this.getSeriesId(e), r = B({
         colorIndex: e,
-        opacity: I
+        opacity: H
       });
-      if (h(r, e, this._config), this.layerInfo !== void 0) {
+      if (u(r, e, this._config), this.layerInfo !== void 0) {
         const i = c({
           config: this._config,
           seriesIndex: e,
           layerInfo: this.layerInfo,
           commonStrings: this.commonStrings
         });
-        i !== a(this.layerInfo.layer).idField && g(i ?? t, e, this._config);
+        i !== n(this.layerInfo.layer).idField && v(i ?? t, e, this._config);
       }
     }
-    this._config.colorMatch = !0;
+    this.nullCategory !== void 0 && b(this._config, C.nullCategory), this._config.colorMatch = !0;
   }
   /**
    * Returns whether the series styling is able to be reset.
@@ -102,7 +108,7 @@ class l extends S {
           layerInfo: this.layerInfo,
           commonStrings: this.commonStrings
         }), s = this.getSeriesName(r);
-        if (i !== void 0 && i !== a(this.layerInfo.layer).idField && i !== s) {
+        if (i !== void 0 && i !== n(this.layerInfo.layer).idField && i !== s) {
           t = !0;
           break;
         }
@@ -111,15 +117,17 @@ class l extends S {
   }
   // #endregion
 }
-d([
-  n
-], l.prototype, "setSeriesHideOversizedSideBySideLabels");
-d([
-  n
-], l.prototype, "setSeriesHideOversizedStackedLabels");
-d([
-  n
-], l.prototype, "resetSeriesStyling");
+l([
+  d
+], o.prototype, "setSeriesHideOversizedSideBySideLabels");
+l([
+  d
+], o.prototype, "setSeriesHideOversizedStackedLabels");
+l([
+  d
+], o.prototype, "resetSeriesStyling");
+const F = [p];
+_(o, F);
 export {
-  l as BarChartModel
+  o as BarChartModel
 };