@arcgis/charts-components 5.0.0-next.17 → 5.0.0-next.171

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

@@ -1,252 +1,466 @@
-import { a as l, d as a, W as T } from "./series-types.js";
+/* COPYRIGHT Esri - https://js.arcgis.com/5.0/LICENSE.txt */
+import { m as e } from "./model-setter.js";
+import { H as o } from "./common.js";
+import { S as u, g as _, a as C } from "./serial-chart-model.js";
+import { a as S, b as T, s as A, c as O, d as F, e as L, f as x, h as D, i as b, j as v, k as w, l as B, m as P, n as R, o as E, p as k, q as W, r as I, t as G, u as H, v as N, w as Y, x as M, y as U, z as V, A as m, B as d, C as X, D as j, E as K, F as q, G as z, H as J, I as y, J as Q, K as Z, L as $, M as tt, N as et, O as it, P as st, Q as rt } from "./serial-chart-data.js";
+import { s as c } from "./data.js";
+import { W as ot, a as h } from "./series-types.js";
+import { bR as f, d7 as nt, br as at } from "./index.js";
 import "@arcgis/toolkit/intl";
 import "lodash-es";
+import "luxon";
 import "d3-array";
-import { x as m, cg as f, ck as S, aQ as A } from "./interfaces.js";
+import "@arcgis/toolkit/type";
+import "@arcgis/core/Graphic.js";
+import "@arcgis/core/renderers/support/jsonUtils.js";
+import "@arcgis/core/symbols/support/symbolUtils.js";
+import "@arcgis/core/intl.js";
+import "@arcgis/core/layers/support/FeatureFilter.js";
+import "@arcgis/core/smartMapping/statistics/histogram.js";
+import "@arcgis/core/smartMapping/statistics/summaryStatistics.js";
+import "simple-statistics";
+import "@arcgis/core/request.js";
+import "@arcgis/core/AttributeBinsGraphic.js";
 import "@arcgis/core/geometry/support/jsonUtils.js";
 import "@arcgis/core/rest/support/AttributeBinsQuery.js";
-import "@arcgis/core/rest/support/Query.js";
 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 "./runtime.js";
 import "@arcgis/toolkit/dom";
-import "@arcgis/core/intl.js";
-import { a as _, c as x } from "./model-with-data-labels.js";
-import "./model-with-multi-axes.js";
-import { S as C, g as v, a as B } from "./serial-chart-model.js";
-import { a as p, u as h, e as L } from "./data.js";
-import { r as u } from "./config-update.js";
-/*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
-See https://js.arcgis.com/5.0/esri/copyright.txt for details.
-v5.0.0-next.17 */
-const w = (t) => {
-  const { xField: e, config: i, layerInfo: s } = t, { layerFieldsInfo: r } = s, g = p(0, i), n = y(i), c = m(i), o = i.series[0];
-  if (typeof e == "string" && n !== e && o && (o.x = e, u(i), n === g || c)) {
-    const d = f(r, e);
-    h(i, 0, d);
-  }
-}, y = (t) => t.series[0].x ?? "", O = (t, e) => {
-  const i = t.series[0];
-  i.heatRulesType = e;
-}, R = (t) => t.series[0].heatRulesType, U = (t, e) => {
-  const i = t.series[0];
-  i.gradientRules = e;
-}, W = (t) => t.series[0].gradientRules, I = (t) => {
-  const { yField: e, config: i, layerInfo: s } = t, { layerFieldsInfo: r } = s, g = p(1, i), n = F(i), c = m(i), o = i.series[0];
-  if (typeof e == "string" && n !== e && o && (o.y = e, u(i), n === g || c)) {
-    const d = f(r, e);
-    h(i, 1, d);
-  }
-}, F = (t) => t.series[0].y ?? "", N = (t, e) => {
-  const i = e.series[0];
-  i.xTemporalBinning = t;
-}, P = (t) => t.series[0].xTemporalBinning, b = (t, e) => {
-  const i = e.series[0];
-  i.yTemporalBinning = t;
-}, G = (t) => t.series[0].yTemporalBinning, M = (t, e) => {
-  const i = e.series[0];
-  i.gridLine && (i.gridLine.width = t);
-}, X = (t) => t.series[0].gridLine?.width, Y = (t, e) => {
-  const i = e.series[0], s = t?.length === 4 && t.every((r) => typeof r == "number");
-  i.gridLine && s && (i.gridLine.color = t);
-}, H = (t) => t.series[0].gridLine?.color, q = (t, e) => {
-  const i = e.legend;
-  t === a.Bottom && i && (i.position = a.Bottom);
-}, $ = (t) => t.legend?.position ?? a.Bottom, D = (t) => t.series[0].query?.outStatistics?.[0]?.onStatisticField, E = (t, e) => {
-  const i = e.series[0].query?.outStatistics?.[0];
-  i && (i.onStatisticField = t, i.outStatisticFieldName = `${i.statisticType}_${t}`);
-}, V = (t) => t.series[0].query?.outStatistics?.[0].statisticType ?? l.Count, j = (t, e) => {
-  const i = e.series[0]?.query?.outStatistics?.[0];
-  i && t !== l.NoAggregation && (i.statisticType = t, i.outStatisticFieldName = `${t}_${i.onStatisticField}`);
+var gt = Object.defineProperty, pt = Object.getOwnPropertyDescriptor, i = (p, t, r, a) => {
+  for (var n = pt(t, r), g = p.length - 1, l; g >= 0; g--)
+    (l = p[g]) && (n = l(t, r, n) || n);
+  return n && gt(t, r, n), n;
 };
-class k extends C {
+class s extends u {
   constructor() {
-    super(...arguments), this._chartType = T.HeatSeries;
+    super(...arguments), this._chartType = ot.HeatSeries;
   }
+  /**
+   * Generate the proper chart title given the current config.
+   */
   generateChartTitle() {
-    throw new Error("Method not implemented.");
+    return this.layerInfo !== void 0 ? S(this._config, this.layerInfo, this.commonStrings) : "";
   }
-  async setup(e) {
-    await this.loadConfigFromLayer(e), typeof this.resolveSetup == "function" && this.resolveSetup();
+  /**
+   * Generate the proper y-axis title given the current config.
+   */
+  generateYAxisTitle() {
+    const t = this.yTemporalBinning?.unit;
+    return t !== void 0 ? this.commonStrings.utilsStrings.heatChartCalendarDatePartsUnits[t] : "";
+  }
+  async setup(t) {
+    await this.loadConfigFromLayer(t), this.setupLocalProps(), typeof this.resolveSetup == "function" && this.resolveSetup();
   }
   /**
-   * The x axis field used by the heat chart
+   * The y axis field used by the heat chart.
    */
-  get xAxisField() {
-    return y(this._config);
+  get yAxisField() {
+    return T(this._config);
   }
-  set xAxisField(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      w({
-        xField: e,
-        config: this._config,
-        layerInfo: this.layerInfo
-      }), this.emitConfigUpdate("xAxisField");
+  set yAxisField(t) {
+    A({
+      yField: t,
+      config: this._config,
+      layerInfo: this.layerInfo
     });
   }
   /**
-   * The y axis field used by the heat chart
+   * The calendar view type for the heat chart.
+   * `SingleCalendarView` - A single calendar view showing all data in one calendar.
+   * `SequentialCalendarViews` - Multiple sequential calendar views (e.g., years).
+   *
+   * **Note**: This is only applicable for calendar heat charts (when `xAxisField` and `yAxisField` are date fields).
    */
-  get yAxisField() {
-    return F(this._config);
+  get viewType() {
+    return O(this._config);
   }
-  set yAxisField(e) {
+  set viewType(t) {
     this.guardSetterFromAsyncOverwrite(() => {
-      I({
-        yField: e,
-        config: this._config,
-        layerInfo: this.layerInfo
-      }), this.emitConfigUpdate("yAxisField");
+      F(t, this._config), this.emitConfigUpdate("heatChartViewType");
     });
   }
   /**
-   * The x temporal binning used by the heat chart
+   * The x axis temporal binning used by the heat chart.
+   *
+   * @example
+   * ```ts
+   * heatChartModel.xTemporalBinning = {
+   *   type: WebChartTypes.CalendarDateParts,
+   *   unit: WebChartCalendarDatePartsUnits.MonthOfYear,
+   * };
+   * ```
    */
   get xTemporalBinning() {
-    return P(this._config);
+    return L(this._config);
   }
-  set xTemporalBinning(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      N(e, this._config), this.emitConfigUpdate("xTemporalBinning");
+  set xTemporalBinning(t) {
+    x({
+      commonStrings: this.commonStrings,
+      binning: t,
+      config: this._config
     });
   }
   /**
-   * The y temporal binning used by the heat chart
+   * The y axis temporal binning used by the heat chart.
+   *
+   * @example
+   * ```ts
+   * heatChartModel.yTemporalBinning = {
+   *   type: WebChartTypes.CalendarDateParts,
+   *   unit: WebChartCalendarDatePartsUnits.DayOfMonth,
+   * };
+   * ```
    */
   get yTemporalBinning() {
-    return G(this._config);
+    return D(this._config);
+  }
+  set yTemporalBinning(t) {
+    b({
+      commonStrings: this.commonStrings,
+      binning: t,
+      config: this._config
+    });
+  }
+  /**
+   * The number of class breaks used by the heat chart.
+   * @default 5
+   * */
+  get breaksCount() {
+    return v(this._config);
   }
-  set yTemporalBinning(e) {
+  set breaksCount(t) {
     this.guardSetterFromAsyncOverwrite(() => {
-      b(e, this._config), this.emitConfigUpdate("yTemporalBinning");
+      w(t, this._config), this.emitConfigUpdate("breaksCount");
     });
   }
   /**
-   * The grid line width used by the heat chart
+   * The classification method to be used for the heat chart.
+   * `equal-interval` - Divides the range of values into equal-sized intervals.
+   * `quantile` - Divides the range of values into intervals that contain an equal number of features.
+   * `natural-breaks` - Identifies natural groupings of values in the data by minimizing the variance within classes and maximizing the variance between classes.
+   * `manual` - Allows you to manually specify the class breaks.
    */
-  get gridLineWidth() {
-    return X(this._config);
+  get classificationMethod() {
+    return B(this._config);
   }
-  set gridLineWidth(e) {
+  set classificationMethod(t) {
     this.guardSetterFromAsyncOverwrite(() => {
-      M(e, this._config), this.emitConfigUpdate("gridLineWidth");
+      t && (P(t, this._config), this.emitConfigUpdate("classificationMethod"));
     });
   }
   /**
-   * The grid line color used by the heat chart
+   * Hide the empty rows and columns in the heat chart.
+   */
+  get hideEmptyRowsAndColumns() {
+    return R(this._config);
+  }
+  set hideEmptyRowsAndColumns(t) {
+    E(this._config, t);
+  }
+  /**
+   * The grid line width used by the heat chart.
+   */
+  get gridLineWidth() {
+    return k(this._config);
+  }
+  set gridLineWidth(t) {
+    W(t, this._config);
+  }
+  /**
+   * The grid line color used by the heat chart.
    */
   get gridLineColor() {
-    return H(this._config);
+    return I(this._config);
   }
-  set gridLineColor(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      Y(e, this._config), this.emitConfigUpdate("gridLineColor");
-    });
+  set gridLineColor(t) {
+    G(t, this._config);
   }
   /**
-   * The name of the series that is used by the heat chart
+   * The name of the series that is used by the heat chart.
+   * @internal
    */
   get seriesName() {
-    return v(0, this._config);
+    return _(0, this._config);
   }
-  set seriesName(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      typeof e == "string" && (B(e, 0, this.config), this.emitConfigUpdate("seriesName"));
-    });
+  set seriesName(t) {
+    typeof t == "string" && C(t, 0, this._config);
   }
   /**
-   * The heat rules type used by the heat chart
+   * The heat rules type used by the heat chart.
+   * `gradient`: A gradient of colors is applied to the cells based on their values, with the range of colors determined by the minimum and maximum values in the data.
+   * `renderer`: A class break renderer is used to apply specific colors to cells based on defined value ranges, allowing for more customized visualizations.
    */
   get heatRulesType() {
-    return R(this._config);
+    return H(this._config);
   }
-  set heatRulesType(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      O(this._config, e), this.emitConfigUpdate("heatRulesType");
-    });
+  set heatRulesType(t) {
+    N(this._config, t);
   }
   /**
-   * The grandient rules used by the heat chart
+   * Set the gradient rules for the heat chart, which define how data values map to colors.
+   *
+   * @example
+   * In this example, we set the gradient rules for the heat chart to use a color gradient from light blue to red, with specific colors for values outside the defined range.
+   *
+   * ```js
+   * heatChartModel.gradientRules = {
+   *   colorList: [
+   *     [200, 225, 255, 255],
+   *     [220, 0, 0, 255],
+   *   ],
+   *   minValue: 100,
+   *   maxValue: 250,
+   *   outsideRangeLowerColor: [0, 255, 255, 255],
+   *   outsideRangeUpperColor: [0, 30, 30, 255],
+   * };
+   * ```
    */
   get gradientRules() {
-    return W(this._config);
+    return Y(this._config);
   }
-  set gradientRules(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      U(this._config, e), this.emitConfigUpdate("gradientRules");
-    });
+  set gradientRules(t) {
+    M(this._config, t);
   }
   /**
-   * The numeric fields used by the heat chart. Only the first field in the array will be used.
-   * An empty string will be ignored.
+   * Gets the grid lines symbol. Contains styling information such as line width, line style, and line color.
+   */
+  getGridLinesSymbol() {
+    return this._config.series?.[0]?.gridLine;
+  }
+  setGridLinesSymbol(t) {
+    this._config.series?.[0] && (this._config.series[0].gridLine = t);
+  }
+  /**
+   * Heat chart only supports one numeric field, if there are multiple numeric fields provided in the array, only the first one will be used and the rest will be ignored.
    */
   get numericFields() {
-    const e = D(this._config);
-    return e !== void 0 ? [e] : [];
+    const t = U(this._config);
+    return t !== void 0 ? [t] : [];
   }
-  set numericFields(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      const i = e[0];
-      S(i) || (E(i, this._config), this.emitConfigUpdate("numericFields"));
-    });
+  set numericFields(t) {
+    const { idField: r } = f(this.layerInfo.layer), a = nt(t[0]), n = a ? r : t[0];
+    V(n, this._config);
+    const g = m(this._config);
+    a && g !== h.Count && d(h.Count, this._config);
   }
   /**
-   * The aggregation type for the heat chart. Must be one of the values allowed by WebChartStatisticType.
+   * The aggregation type for the heat chart.
    */
   get aggregationType() {
-    return V(this._config);
+    return m(this._config);
   }
-  set aggregationType(e) {
-    this.guardSetterFromAsyncOverwrite(() => {
-      j(e, this._config), this.emitConfigUpdate("aggregationType");
-    });
+  set aggregationType(t) {
+    d(t, this._config);
   }
   /**
-   * Split-by field is not used by heat chart
+   * Split-by field not supported for heat charts.
+   * @internal
    */
   get splitByField() {
     return "";
   }
-  set splitByField(e) {
+  set splitByField(t) {
+  }
+  get legendPosition() {
+    return X(this._config);
+  }
+  set legendPosition(t) {
+    j(t, this._config);
+  }
+  get nullPolicy() {
+    return K(this._config);
+  }
+  set nullPolicy(t) {
+    q(t, this._config);
+  }
+  get emptyCell() {
+    return z(this._config);
   }
   /**
-   * The heat charts legend's title (not supported yet)
+   * The heat chart's empty cell configuration.
    */
-  set legendTitleText(e) {
+  set emptyCell(t) {
     this.guardSetterFromAsyncOverwrite(() => {
+      J(t, this._config), this.emitConfigUpdate("emptyCell");
     });
   }
-  get legendPosition() {
+  getSortOrder() {
+    return o.Asc;
+  }
+  setSortOrder(t, r) {
+  }
+  /**
+   * Get the sort order on the x axis for the heat chart.
+   * @returns {"Asc" | "Desc" | "customSort"}
+   */
+  getXAxisSortOrder() {
+    const t = y(this._config)[0];
+    return t === o.Asc || t === o.Desc || t === o.customSort ? t : o.Asc;
+  }
+  setXAxisSortOrder(t, r) {
+    c(t, this._config, r);
+  }
+  /**
+   * Gets the sort order for on the y axis for heat chart.
+   * @returns {"Asc" | "Desc" | "customSort"}
+   */
+  getYAxisSortOrder() {
+    const t = y(this._config)[1];
+    return t === o.Asc || t === o.Desc || t === o.customSort ? t : o.Asc;
+  }
+  setYAxisSortOrder(t, r) {
+    c(t, this._config, r, !0);
+  }
+  get emptyCellText() {
+    return Q(this._config);
+  }
+  set emptyCellText(t) {
+    Z(t, this._config);
+  }
+  get includeLeapDay() {
     return $(this._config);
   }
   /**
-   * The heat charts legend's position
+   * Whether to include leap day (February 29) in the heat chart when using "day of month" temporal binning.
    */
-  set legendPosition(e) {
+  set includeLeapDay(t) {
     this.guardSetterFromAsyncOverwrite(() => {
-      e === a.Bottom && (q(e, this._config), this.emitConfigUpdate("legendVisibility"));
+      tt(t, this._config), this.emitConfigUpdate("includeLeapDay");
     });
   }
   /**
-   * The heat chart's rotatedState (not supported)
+   * The first day of the week used for date-based bins.
+   *
+   * - `1`: Monday
+   * - `7`: Sunday
    */
-  set rotatedState(e) {
+  get firstDayOfWeek() {
+    return et(this._config);
+  }
+  set firstDayOfWeek(t) {
     this.guardSetterFromAsyncOverwrite(() => {
+      it(t, this._config), this.emitConfigUpdate("firstDayOfWeek");
     });
   }
+  get emptyCellSymbol() {
+    return st(this._config);
+  }
+  set emptyCellSymbol(t) {
+    rt(t, this._config);
+  }
+  // Chart override methods that aren't supported
+  /**
+   * The heat chart's rotatedState (not supported)
+   * @internal
+   */
+  get rotatedState() {
+    return !1;
+  }
+  set rotatedState(t) {
+  }
+  setAssignToSecondValueAxis(t, r) {
+  }
+  set stackedType(t) {
+  }
+  set binTemporalData(t) {
+  }
+  set nullCategory(t) {
+  }
   /**
    * Generates the default config for the heat chart
+   * @private
    */
   generateDefaultConfig() {
-    const e = A(this.commonStrings, this.layerInfo?.objectIdField);
-    return e.axes?.forEach((i) => {
-      i && (i.valueFormat = { intlOptions: { timeZone: void 0 }, type: "date" });
-    }), e;
+    const t = at(this.commonStrings, f(this.layerInfo.layer).idField);
+    return t.axes?.forEach((r, a) => {
+      r && (r.valueFormat = {
+        // use short date format for y axis labels
+        intlOptions: { timeZone: void 0, dateStyle: a > 0 ? "long" : "medium" },
+        type: "date"
+      });
+    }), t;
   }
 }
-L(k, [_, x]);
+i([
+  e
+], s.prototype, "yAxisField");
+i([
+  e
+], s.prototype, "xTemporalBinning");
+i([
+  e
+], s.prototype, "yTemporalBinning");
+i([
+  e
+], s.prototype, "hideEmptyRowsAndColumns");
+i([
+  e
+], s.prototype, "gridLineWidth");
+i([
+  e
+], s.prototype, "gridLineColor");
+i([
+  e
+], s.prototype, "seriesName");
+i([
+  e
+], s.prototype, "heatRulesType");
+i([
+  e
+], s.prototype, "gradientRules");
+i([
+  e
+], s.prototype, "setGridLinesSymbol");
+i([
+  e
+], s.prototype, "numericFields");
+i([
+  e
+], s.prototype, "aggregationType");
+i([
+  e
+], s.prototype, "splitByField");
+i([
+  e
+], s.prototype, "legendPosition");
+i([
+  e
+], s.prototype, "nullPolicy");
+i([
+  e
+], s.prototype, "setSortOrder");
+i([
+  e
+], s.prototype, "setXAxisSortOrder");
+i([
+  e
+], s.prototype, "setYAxisSortOrder");
+i([
+  e
+], s.prototype, "emptyCellText");
+i([
+  e
+], s.prototype, "firstDayOfWeek");
+i([
+  e
+], s.prototype, "emptyCellSymbol");
+i([
+  e
+], s.prototype, "rotatedState");
+i([
+  e
+], s.prototype, "setAssignToSecondValueAxis");
+i([
+  e
+], s.prototype, "stackedType");
+i([
+  e
+], s.prototype, "binTemporalData");
+i([
+  e
+], s.prototype, "nullCategory");
 export {
-  k as HeatChartModel
+  s as HeatChartModel
 };