@arcgis/charts-components 4.34.0-next.132 → 4.34.0-next.134

package/dist/json-schema/index.d.ts

@@ -3014,7 +3014,7 @@ export namespace WebChartJSONSchemas {
                     $ref: string;
                     description: string;
                 };
-                heatRuleType: {
+                heatRulesType: {
                     $ref: string;
                     description: string;
                     default: string;
@@ -3023,7 +3023,7 @@ export namespace WebChartJSONSchemas {
                     $ref: string;
                     description: string;
                 };
-                noData: {
+                emptyCells: {
                     type: string;
                     properties: {
                         text: {
@@ -3031,10 +3031,9 @@ export namespace WebChartJSONSchemas {
                             description: string;
                             default: string;
                         };
-                        color: {
+                        symbol: {
                             $ref: string;
                             description: string;
-                            default: string;
                         };
                     };
                     description: string;

package/dist/loader.js

@@ -2,7 +2,7 @@ import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as t } from "@arcgis/lumina";
 /*! 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.132 */
+v4.34.0-next.134 */
 const o = t(e, {
   "arcgis-chart": [() => import("./components/arcgis-chart/customElement.js"), "actionMode,allowUsingObjectIdStat,autoDisposeChart,autoInverseDataLabelTextColor,chartIndex,chartLimits:,chartWillRender:,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableBetaFeatures,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,ignoreSmoothRenderingLimit,ignoreViewExtent,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerItemId,layerRendererChangePolicy,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,model:,nullAsValid,placeholder,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionTheme:,setTimeBinningInfoWhenNotProvided,showUIMessages,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,timeZone,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:;clearSelection,errorAlert,exportAsCSV,exportAsImage,loadModel,notify,refresh,resetZoom,switchSelection"],
   "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "actionBarSelectionMode,chartElement:,chartType,clearSelectionState,clearSelectionTitle,clearSelectionToggle,disableCSVExportForChartTypes:,editChartState,editChartTitle,editChartToggle,expanded,exportActionState,exportAsCSVState,exportAsCSVTitle,exportAsImageState,exportAsImageTitle,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,forceDisableActions,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartState,rotateChartTitle,rotateChartToggle,selectionState,selectionTitle,selectionToggle,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomState,zoomTitle,zoomToggle"],

package/dist/model/box-plot-model/box-plot-model.d.ts

@@ -1,5 +1,5 @@
 import { ChartConfig, XYChartTypes } from '../../utils';
-import { Color, RESTSimpleLineSymbolStyle, WebChart, WebChartDataFilters } from '../../spec';
+import { Color, RESTSimpleLineSymbolStyle, WebChart } from '../../spec';
 import { ChartModel } from '../chart-model/chart-model';
 import { ModelParams } from '../interfaces/chart-interfaces';
 import { LayerInfo, ModelTypes, BoxPlotDataSortingKinds } from '../interfaces/common';
@@ -11,6 +11,12 @@ export declare class BoxPlotModel extends ChartModel {
     protected _config: ChartConfig<typeof ModelTypes.BoxPlot, WebChart>;
     protected _chartType: XYChartTypes;
     protected layerInfo: LayerInfo;
+    /**
+     * Specifies whether the model supports custom sort.
+     * @default true
+     * @readonly
+     */
+    static supportsCustomSort: boolean;
     /**
      * Common strings used in the model.
      * @category Private
@@ -33,11 +39,6 @@ export declare class BoxPlotModel extends ChartModel {
      * @async **This method is `async` and must be awaited for the changes to take effect.**
      */
     setCategory(newCategory: string): Promise<void>;
-    /**
-     * Gets the list of the category values for the chart.
-     * @returns {string[]}
-     */
-    getCustomSortValues(): Promise<string[]>;
     /**
      * Gets the numeric fields array for the box plot.
      * @returns {string[]}
@@ -93,6 +94,11 @@ export declare class BoxPlotModel extends ChartModel {
      * @param {string[]} orderByList The new list of category's values for custom sort.
      */
     setSortOrder(newSortOrder: BoxPlotDataSortingKinds, orderByList?: string[]): void;
+    /**
+     * Gets the list of the category values for the chart.
+     * @returns {string[]}
+     */
+    getCustomSortValues(): Promise<string[]>;
     /**
      * Gets the list of category's values for custom sort
      * @returns {string[]}
@@ -108,16 +114,6 @@ export declare class BoxPlotModel extends ChartModel {
      * @async **This method is `async` and must be awaited for the changes to take effect.*
      */
     updateSeriesFromLayerFilter(): Promise<void>;
-    /**
-     * Gets the data filter for the bar chart.
-     * @returns {WebChartDataFilters | undefined}
-     */
-    getDataFilter(): WebChartDataFilters | undefined;
-    /**
-     * Sets the data filter for the bar chart.
-     * @param {WebChartDataFilters | undefined} newDataFilter The new data filter.
-     */
-    setDataFilter(newDataFilter: WebChartDataFilters | undefined): Promise<void>;
     /**
      * Gets whether mean lines are shown.
      * @returns {boolean | undefined}

package/dist/model/box-plot-model/utils/box-plot-data.d.ts

@@ -1,5 +1,5 @@
 import { BoxPlotConfig, ChartConfig, CommonStrings } from '../../../utils';
-import { Color, WebChartBoxPlotSeries, WebChartDataFilters, WebChartLineChartSeries } from '../../../spec';
+import { Color, WebChartBoxPlotSeries, WebChartLineChartSeries } from '../../../spec';
 import { LayerInfo, ModelTypes, BoxPlotDataSortingKinds } from '../../interfaces/common';
 /**
  * Gets the category field.
@@ -123,18 +123,6 @@ export declare const getOrderByList: (config: ChartConfig<typeof ModelTypes.BoxP
  * @param  {ChartConfig<typeof ModelTypes.BoxPlot>} config - The chart config.
  */
 export declare const setOrderByList: (values: string[], config: ChartConfig<typeof ModelTypes.BoxPlot>) => void;
-/**
- * Get the data filter from the config.
- * @param  {ChartConfig<typeof ModelTypes.BoxPlot>} config - The chart config.
- * @returns WebChartDataFilters | undefined - The data filter.
- */
-export declare const getDataFilter: (config: ChartConfig<typeof ModelTypes.BoxPlot>) => WebChartDataFilters | undefined;
-/**
- * Set the data filter in the config.
- * @param  {WebChartDataFilters | undefined} dataFilter - The data filter.
- * @param  {ChartConfig<typeof ModelTypes.BoxPlot>} config - The chart config.
- */
-export declare const setDataFilter: (dataFilter: WebChartDataFilters | undefined, config: ChartConfig<typeof ModelTypes.BoxPlot>) => void;
 /**
  * Get the custom sort values from the config.
  * @param  {ChartConfig<typeof ModelTypes.BoxPlot>} config - The chart config.

package/dist/model/chart-model/chart-model.d.ts

@@ -1,4 +1,4 @@
-import { Color, IDrawingInfo, LegendItemVisibility, NumberFormatOptions, SupportedLayer, WebChartTextSymbol } from '../../spec';
+import { Color, IDrawingInfo, LegendItemVisibility, NumberFormatOptions, SupportedLayer, WebChartDataFilters, WebChartTextSymbol } from '../../spec';
 import { ModelParams } from '../interfaces/chart-interfaces';
 import { LayerInfo, ModelTypes } from '../interfaces/common';
 import { ChartConfig, ChartSubType, ChartTypes } from '../../utils';
@@ -27,6 +27,11 @@ export declare abstract class ChartModel extends EventTarget {
      * Data store object that can be used to store any data needed for the chart.
      */
     dataStore: any;
+    /**
+     * Whether this chart type supports custom sort.
+     * Default: false (no custom sort).
+     */
+    static supportsCustomSort: boolean;
     /**
      * Completes the async setup process for the chart model. Must be called before using the model.
      * @param {ModelParams} params The parameters to be used to set up the chart model.
@@ -314,6 +319,35 @@ export declare abstract class ChartModel extends EventTarget {
      * @returns {string[]}
      */
     getSplitByValues(): string[];
+    /**
+     * Get the sort order kind.
+     * Only called if `supportsCustomSort` is true.
+     */
+    protected getSortOrderKind(): string;
+    /**
+     * Get custom sort values.
+     * Only called if `supportsCustomSort` is true.
+     */
+    getCustomSortValues(): Promise<string[]>;
+    /**
+     * Set sort order kind.
+     * Only called if `supportsCustomSort` is true.
+     */
+    setSortOrderKind(_sortOrder: string, _orderByList: string[]): void;
+    /**
+     * Check if the given sort order is a 'custom sort'.
+     * Only called if `supportsCustomSort` is true.
+     */
+    protected isSortOrderCustomSort(sortOrder: string): boolean;
+    /**
+     * Gets the data filter for the bar chart.
+     * @returns {WebChartDataFilters | undefined}
+     */
+    getDataFilters(): WebChartDataFilters | undefined;
+    /**
+     * Shared method for all chart types.
+     */
+    setDataFilter(newDataFilters: WebChartDataFilters | undefined): Promise<void>;
     /**
      * Emits a config update event.
      * @category Protected

package/dist/model/chart-model/utils/data.d.ts

@@ -1,3 +1,4 @@
+import { WebChartDataFilters } from '../../../spec';
 import { ChartConfig } from '../../../utils';
 /**
  * Sets whether to fetch `null` values for them to be counted or displayed as categories on the chart.
@@ -17,3 +18,15 @@ export declare const getFetchNULLValues: (config: ChartConfig) => boolean;
  * @returns {string[]} An array of split by values.
  */
 export declare const getSplitByValues: (config: ChartConfig) => string[];
+/**
+ * Get the data filter from the config.
+ * @param  {ChartConfig} config - The chart config.
+ * @returns WebChartDataFilters | undefined - The data filter.
+ */
+export declare const getDataFilters: (config: ChartConfig) => WebChartDataFilters | undefined;
+/**
+ * Set the data filter in the config.
+ * @param  {WebChartDataFilters | undefined} dataFilter - The data filter.
+ * @param  {ChartConfig} config - The chart config.
+ */
+export declare const setDataFilters: (dataFilter: WebChartDataFilters | undefined, config: ChartConfig) => void;

package/dist/model/interfaces/common.d.ts

@@ -9,6 +9,7 @@ import { LineChartModel } from '../line-chart-model/line-chart-model';
 import { PieChartModel } from '../pie-chart-model/pie-chart-model';
 import { RadarChartModel } from '../radar-chart-model/radar-chart-model';
 import { ScatterplotModel } from '../scatterplot-model/scatterplot-model';
+export declare const customSortString = "customSort";
 export declare const SerialChartDataSortingKinds: {
     readonly xAxisAsc: "xAxisAsc";
     readonly xAxisDesc: "xAxisDesc";

package/dist/model/pie-chart-model/pie-chart-model.d.ts

@@ -22,6 +22,12 @@ export declare class PieChartModel extends ChartModel {
      */
     protected _mode: PieChartDataModes;
     protected layerInfo: LayerInfo;
+    /**
+     * Specifies whether the model supports custom sort.
+     * @default true
+     * @readonly
+     */
+    static supportsCustomSort: boolean;
     /**
      * Array of hidden grouped slice ids
      * @category Private

package/dist/model/serial-chart-model/serial-chart-model.d.ts

@@ -1,6 +1,6 @@
 import { SerialChartTypes } from '../../utils';
 import { ChartModel } from '../chart-model/chart-model';
-import { Color, WebChartStatisticType, WebChartDataFilters, WebChartStackedKinds } from '../../spec';
+import { Color, WebChartStatisticType, WebChartStackedKinds } from '../../spec';
 import { SerialChartConfig } from '../interfaces/chart-interfaces';
 import { SerialChartDataSortingKinds } from '../interfaces/common';
 import { ModelWithColorMatch, ModelWithDataLabels, ModelWithLegend, ModelWithTooltips, ModelWithRotation, ModelWithTemporalBinning, ModelWithXGuides, ModelWithYGuides, ModelWithMultiAxes } from '../mixins';
@@ -14,6 +14,12 @@ export declare abstract class SerialChartModel extends ChartModel {
      * Current configuration used for the series chart.
      */
     protected _config: SerialChartConfig;
+    /**
+     * Specifies whether the model supports custom sort.
+     * @default true
+     * @readonly
+     */
+    static supportsCustomSort: boolean;
     /**
      * Gets the x-axis field for the chart.
      * @returns {string}
@@ -69,21 +75,6 @@ export declare abstract class SerialChartModel extends ChartModel {
      * @async **This method is `async` and must be awaited for the changes to take effect.**
      */
     setNumericFields(newNumericFields: string[] | string): Promise<void>;
-    /**
-     * Gets the data filter for the bar chart.
-     * @returns {WebChartDataFilters | undefined}
-     */
-    getDataFilter(): WebChartDataFilters | undefined;
-    /**
-     * Sets the data filter for the bar chart.
-     * @param {WebChartDataFilters | undefined} newDataFilter The new data filter.
-     */
-    setDataFilter(newDataFilter: WebChartDataFilters | undefined): Promise<void>;
-    /**
-     * Gets the list of the category values for the chart.
-     * @returns {string[]}
-     */
-    getCustomSortValues(): Promise<string[]>;
     /**
      * Gets the sort order for the bar chart.
      * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
@@ -95,6 +86,11 @@ export declare abstract class SerialChartModel extends ChartModel {
      * @param {string[]} orderByList The list of category's values to order by.
      */
     setSortOrder(newSortOrder: SerialChartDataSortingKinds, orderByList?: string[]): void;
+    /**
+     * Gets the list of the category values for the chart.
+     * @returns {string[]}
+     */
+    getCustomSortValues(): Promise<string[]>;
     /**
      * Gets the list of custom sort values for custom sort
      * @returns {string[]}
@@ -110,6 +106,18 @@ export declare abstract class SerialChartModel extends ChartModel {
      * @async **This method is `async` and must be awaited for the changes to take effect.**
      */
     updateSeriesFromLayerFilter(): Promise<void>;
+    /**
+     * Gets whether temporal binning is enabled for all series in the config.
+     * @returns {boolean} - Whether temporal binning is enabled.
+     */
+    getBinTemporalData(): boolean;
+    /**
+     * Enable or disable temporal binning for all series in the config.
+     * @param {boolean} value - Whether to enable or disable temporal binning.
+     *
+     * **NOTE** This method removes any existing temporal binning settings if `value` is set to `false`.
+     */
+    setBinTemporalData(value: boolean): void;
     /**
      * Gets the name of the series based on the series index.
      * If the index is out of bounds, it will return `undefined`.

package/dist/model/serial-chart-model/utils/serial-chart-data.d.ts

@@ -1,4 +1,4 @@
-import { WebChartDataFilters, WebChartStatisticType } from '../../../spec';
+import { WebChartStatisticType } from '../../../spec';
 import { ChartConfig, CommonStrings } from '../../../utils';
 import { SerialChartConfig } from '../../interfaces/chart-interfaces';
 import { LayerInfo, SerialChartDataSortingKinds } from '../../interfaces/common';
@@ -146,18 +146,6 @@ export declare const getDefaultSeriesName: (props: {
  * @param  {ChartConfig} config - The chart config.
  */
 export declare const setOrderByList: (values: string[], config: ChartConfig) => void;
-/**
- * Get the data filter from the config.
- * @param  {ChartConfig} config - The chart config.
- * @returns WebChartDataFilters | undefined - The data filter.
- */
-export declare const getDataFilter: (config: ChartConfig) => WebChartDataFilters | undefined;
-/**
- * Set the data filter in the config.
- * @param  {WebChartDataFilters | undefined} dataFilter - The data filter.
- * @param  {ChartConfig} config - The chart config.
- */
-export declare const setDataFilter: (dataFilter: WebChartDataFilters | undefined, config: ChartConfig) => void;
 /**
  * Get the custom sort values from the config.
  * @param  {SerialChartConfig} config - The chart config.
@@ -166,3 +154,17 @@ export declare const setDataFilter: (dataFilter: WebChartDataFilters | undefined
  * @returns string[] - The custom sort values.
  */
 export declare const getCustomSortValues: (config: SerialChartConfig, layerInfo: LayerInfo | undefined) => Promise<string[]>;
+/**
+ * Get whether temporal binning is enabled for the series in the config.
+ * @param {SerialChartConfig} config - The chart config.
+ * @returns {boolean} - Whether temporal binning is enabled.
+ */
+export declare function getBinTemporalData(config: SerialChartConfig): boolean;
+/**
+ * Enable or disable temporal binning for all series in the config.
+ * @param {SerialChartConfig} config - The chart config.
+ * @param {boolean} value - Whether to enable or disable temporal binning.
+ *
+ * **NOTE** This method removes any existing temporal binning settings if `value` is set to `false`.
+ */
+export declare function setBinTemporalData(value: boolean, config: SerialChartConfig): void;

package/dist/model.js

@@ -0,0 +1,108 @@
+import { M as i } from "./chunks/common.js";
+import { B as m, C as y, F as g, G as C, L as w, a as f, P as u, b, S as L, T, c as p } from "./chunks/common.js";
+import { s as r, t as s, u as n } from "./chunks/type-guards.js";
+import { a as P, e as S, i as k, g as x, b as W, r as v, h as G, l as K, m as D, p as F, j as H, k as O, q as R, n as A, o as E, d as X, f as Y, c as $ } from "./chunks/type-guards.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.134 */
+async function c(a) {
+  const o = "config" in a ? r(a.config) : a.chartType;
+  let t;
+  if (!("layer" in a) && !("iLayer" in a) && "config" in a && a.config.iLayer === void 0)
+    throw new Error(
+      "The source is missing. You can provide it to createModel through either `iLayer`, `layer`, or by setting the `config.iLayer` property."
+    );
+  switch (o) {
+    case i.LineChart: {
+      const { LineChartModel: e } = await import("./chunks/line-chart-model.js");
+      t = new e();
+      break;
+    }
+    case i.ComboBarLineChart: {
+      const { ComboBarLineChartModel: e } = await import("./chunks/combo-bar-line-chart-model.js");
+      t = new e();
+      break;
+    }
+    case i.PieChart: {
+      const { PieChartModel: e } = await import("./chunks/pie-chart-model.js");
+      t = new e();
+      break;
+    }
+    case i.Histogram: {
+      const { HistogramModel: e } = await import("./chunks/histogram-model.js");
+      t = new e();
+      break;
+    }
+    case i.Scatterplot: {
+      const { ScatterplotModel: e } = await import("./chunks/scatterplot-model.js");
+      t = new e();
+      break;
+    }
+    case i.BoxPlot: {
+      const { BoxPlotModel: e } = await import("./chunks/box-plot-model.js");
+      t = new e();
+      break;
+    }
+    case i.Gauge: {
+      const { GaugeModel: e } = await import("./chunks/gauge-model.js");
+      t = new e();
+      break;
+    }
+    case i.RadarChart: {
+      const { RadarChartModel: e } = await import("./chunks/radar-chart-model.js");
+      t = new e();
+      break;
+    }
+    case i.BarChart:
+    default: {
+      const { BarChartModel: e } = await import("./chunks/bar-chart-model.js");
+      t = new e();
+      break;
+    }
+  }
+  if (await t?.setup({
+    layer: "layer" in a ? a.layer : void 0,
+    iLayer: "iLayer" in a ? a.iLayer : void 0,
+    config: "config" in a ? a.config : void 0
+  }), o !== void 0 && s(t, o))
+    return t;
+  {
+    const e = n(t.getChartType());
+    throw new Error(
+      `Please check the arguments provided to \`createModel\`. The generated model's type (\`${e}\`) does not match the type specified by either the \`chartType\` or the \`config\` argument (\`${o}\`).`
+    );
+  }
+}
+export {
+  m as BoxPlotDataSortingKinds,
+  y as ColorFormatKeys,
+  g as FormatKeys,
+  C as GuideOrientation,
+  w as LineFormatKeys,
+  i as ModelTypes,
+  f as PieChartDataModes,
+  u as PieChartDataSortingKinds,
+  b as PieChartSlicesDisplay,
+  L as SerialChartDataSortingKinds,
+  T as TextFormatKeys,
+  c as createModel,
+  p as customSortString,
+  P as isBarChartModel,
+  S as isBoxPlotModel,
+  k as isChartModel,
+  x as isHistogramModel,
+  W as isLineChartModel,
+  v as isModelOfType,
+  G as isModelWithBasicXAxis,
+  K as isModelWithDataLabels,
+  D as isModelWithGuides,
+  F as isModelWithLegend,
+  H as isModelWithMultiAxes,
+  O as isModelWithRotation,
+  R as isModelWithTemporalBinning,
+  A as isModelWithXGuides,
+  E as isModelWithYGuides,
+  X as isPieChartModel,
+  Y as isScatterplotModel,
+  $ as isSerialChartModel
+};

package/dist/spec/web-chart.d.ts

@@ -1322,29 +1322,27 @@ export interface WebChartHeatChartSeries extends WebChartSeries {
      *
      * @default WebChartHeatChartHeatRulesTypes.Gradient
      */
-    heatRuleType?: WebChartHeatChartHeatRulesTypes;
+    heatRulesType?: WebChartHeatChartHeatRulesTypes;
     /**
      * Specifies the details of the gradient rules for the heat chart.
      */
     gradientRules?: WebChartHeatChartGradient;
     /**
-     * Specifies how to display items with no data, in term of text and color.
+     * Specifies how to display the empty cells, in terms of text and symbology.
      */
-    noData?: {
+    emptyCells?: {
         /**
-         * Specifies the text to use for the item with no data.
+         * Specifies the text to use by the empty cells.
          * If none is provided, the default `null` text will be used.
          *
          * @default `null`
          */
         text?: string;
         /**
-         * Specifies the color to use for the item with no data.
-         * If none is provided, the default color will be used.
-         *
-         * @default [150, 150, 150, 255] - light gray
+         * Specifies the symbol to use by the empty cells.
+         * If none is provided, the default symbol will be used.
          */
-        color?: Color;
+        symbol?: ISimpleFillSymbol;
     };
 }
 export type WebChartRadarChartSeries = WebChartLineChartSeries<"radarSeries">;

package/dist/types/preact.d.ts

@@ -1,10 +1,10 @@
 /// <reference types="../index.d.ts" />
 import type { ArcgisChart } from "../components/arcgis-chart";
 import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-bar";
-import { JSX as PreactJsx } from "preact";
+import { HTMLAttributes } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, PreactJsx.HTMLAttributes<HTMLArcgisChartElement> {
+interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, HTMLAttributes<HTMLArcgisChartElement> {
   onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;
@@ -22,20 +22,20 @@ interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'al
 }
 type ArcgisChartSetterTypes = ArcgisChart["_setterTypes"]
 
-interface PreactArcgisChartsActionBar extends Partial<Pick<ArcgisChartsActionBar, 'actionBarSelectionMode' | 'chartElement' | 'chartType' | 'clearSelectionState' | 'clearSelectionTitle' | 'clearSelectionToggle' | 'disableCSVExportForChartTypes' | 'editChartState' | 'editChartTitle' | 'editChartToggle' | 'expanded' | 'exportActionState' | 'exportAsCSVState' | 'exportAsCSVTitle' | 'exportAsImageState' | 'exportAsImageTitle' | 'filterByExtentState' | 'filterByExtentTitle' | 'filterByExtentToggle' | 'filterBySelectionState' | 'filterBySelectionTitle' | 'filterBySelectionToggle' | 'forceDisableActions' | 'fullExtentState' | 'fullExtentTitle' | 'fullExtentToggle' | 'hiddenActions' | 'legendState' | 'legendTitle' | 'legendToggle' | 'messageOverrides' | 'rotateChartState' | 'rotateChartTitle' | 'rotateChartToggle' | 'selectionState' | 'selectionTitle' | 'selectionToggle' | 'switchSelectionState' | 'switchSelectionTitle' | 'switchSelectionToggle' | 'zoomState' | 'zoomTitle' | 'zoomToggle'>>, PreactJsx.HTMLAttributes<HTMLArcgisChartsActionBarElement> {
+interface PreactArcgisChartsActionBar extends Partial<Pick<ArcgisChartsActionBar, 'actionBarSelectionMode' | 'chartElement' | 'chartType' | 'clearSelectionState' | 'clearSelectionTitle' | 'clearSelectionToggle' | 'disableCSVExportForChartTypes' | 'editChartState' | 'editChartTitle' | 'editChartToggle' | 'expanded' | 'exportActionState' | 'exportAsCSVState' | 'exportAsCSVTitle' | 'exportAsImageState' | 'exportAsImageTitle' | 'filterByExtentState' | 'filterByExtentTitle' | 'filterByExtentToggle' | 'filterBySelectionState' | 'filterBySelectionTitle' | 'filterBySelectionToggle' | 'forceDisableActions' | 'fullExtentState' | 'fullExtentTitle' | 'fullExtentToggle' | 'hiddenActions' | 'legendState' | 'legendTitle' | 'legendToggle' | 'messageOverrides' | 'rotateChartState' | 'rotateChartTitle' | 'rotateChartToggle' | 'selectionState' | 'selectionTitle' | 'selectionToggle' | 'switchSelectionState' | 'switchSelectionTitle' | 'switchSelectionToggle' | 'zoomState' | 'zoomTitle' | 'zoomToggle'>>, HTMLAttributes<HTMLArcgisChartsActionBarElement> {
   onarcgisActionBarToggle?: EventHandler<HTMLArcgisChartsActionBarElement["arcgisActionBarToggle"]>;
   onarcgisDefaultActionSelect?: EventHandler<HTMLArcgisChartsActionBarElement["arcgisDefaultActionSelect"]>;
 }
 
 declare module 'preact' {
   namespace createElement.JSX {
-    interface IntrinsicElements extends PreactJsx.IntrinsicElements {
+    interface IntrinsicElements {
       "arcgis-chart": PreactArcgisChart;
       "arcgis-charts-action-bar": PreactArcgisChartsActionBar;
     }
   }
   namespace h.JSX {
-    interface IntrinsicElements extends PreactJsx.IntrinsicElements {
+    interface IntrinsicElements {
       "arcgis-chart": PreactArcgisChart;
       "arcgis-charts-action-bar": PreactArcgisChartsActionBar;
     }

package/dist/types/preact10.d.ts

@@ -0,0 +1,45 @@
+/// <reference types="../index.d.ts" />
+import type { ArcgisChart } from "../components/arcgis-chart";
+import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-bar";
+import { JSX as PreactJsx } from "preact";
+import type { EventHandler } from "@arcgis/lumina";
+
+/** @deprecated Update to Preact 10.27.2+ or 11+ and consume types/preact file over types/preact10 */
+interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, PreactJsx.HTMLAttributes<HTMLArcgisChartElement> {
+  onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
+  onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
+  onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;
+  onarcgisConfigChange?: EventHandler<HTMLArcgisChartElement["arcgisConfigChange"]>;
+  onarcgisDataFetchComplete?: EventHandler<HTMLArcgisChartElement["arcgisDataFetchComplete"]>;
+  onarcgisDataProcessComplete?: EventHandler<HTMLArcgisChartElement["arcgisDataProcessComplete"]>;
+  onarcgisDataProcessError?: EventHandler<HTMLArcgisChartElement["arcgisDataProcessError"]>;
+  onarcgisLegendItemVisibilityChange?: EventHandler<HTMLArcgisChartElement["arcgisLegendItemVisibilityChange"]>;
+  onarcgisNoRenderPropChange?: EventHandler<HTMLArcgisChartElement["arcgisNoRenderPropChange"]>;
+  onarcgisRuntimeError?: EventHandler<HTMLArcgisChartElement["arcgisRuntimeError"]>;
+  onarcgisSelectionComplete?: EventHandler<HTMLArcgisChartElement["arcgisSelectionComplete"]>;
+  onarcgisSeriesColorChange?: EventHandler<HTMLArcgisChartElement["arcgisSeriesColorChange"]>;
+  onarcgisSeriesOrder?: EventHandler<HTMLArcgisChartElement["arcgisSeriesOrder"]>;
+  onarcgisUpdateComplete?: EventHandler<HTMLArcgisChartElement["arcgisUpdateComplete"]>;
+}
+type ArcgisChartSetterTypes = ArcgisChart["_setterTypes"]
+
+/** @deprecated Update to Preact 10.27.2+ or 11+ and consume types/preact file over types/preact10 */
+interface PreactArcgisChartsActionBar extends Partial<Pick<ArcgisChartsActionBar, 'actionBarSelectionMode' | 'chartElement' | 'chartType' | 'clearSelectionState' | 'clearSelectionTitle' | 'clearSelectionToggle' | 'disableCSVExportForChartTypes' | 'editChartState' | 'editChartTitle' | 'editChartToggle' | 'expanded' | 'exportActionState' | 'exportAsCSVState' | 'exportAsCSVTitle' | 'exportAsImageState' | 'exportAsImageTitle' | 'filterByExtentState' | 'filterByExtentTitle' | 'filterByExtentToggle' | 'filterBySelectionState' | 'filterBySelectionTitle' | 'filterBySelectionToggle' | 'forceDisableActions' | 'fullExtentState' | 'fullExtentTitle' | 'fullExtentToggle' | 'hiddenActions' | 'legendState' | 'legendTitle' | 'legendToggle' | 'messageOverrides' | 'rotateChartState' | 'rotateChartTitle' | 'rotateChartToggle' | 'selectionState' | 'selectionTitle' | 'selectionToggle' | 'switchSelectionState' | 'switchSelectionTitle' | 'switchSelectionToggle' | 'zoomState' | 'zoomTitle' | 'zoomToggle'>>, PreactJsx.HTMLAttributes<HTMLArcgisChartsActionBarElement> {
+  onarcgisActionBarToggle?: EventHandler<HTMLArcgisChartsActionBarElement["arcgisActionBarToggle"]>;
+  onarcgisDefaultActionSelect?: EventHandler<HTMLArcgisChartsActionBarElement["arcgisDefaultActionSelect"]>;
+}
+
+declare module 'preact' {
+  namespace createElement.JSX {
+    interface IntrinsicElements {
+      "arcgis-chart": PreactArcgisChart;
+      "arcgis-charts-action-bar": PreactArcgisChartsActionBar;
+    }
+  }
+  namespace h.JSX {
+    interface IntrinsicElements {
+      "arcgis-chart": PreactArcgisChart;
+      "arcgis-charts-action-bar": PreactArcgisChartsActionBar;
+    }
+  }
+}

package/dist/utils/chart-config/converter/index.d.ts

@@ -12,7 +12,11 @@ import { FormerWebChartBoxPlotDataSortTypes, FormerWebChartDataValueTypes } from
  * @param configToUpdate The config to update
  * @param chartContainer The chart's container
  */
-declare function applyDefaultFirstDayOfWeek(configToUpdate: WebChart | WebHeatChart, chartContainer?: HTMLElement): WebChart | WebHeatChart;
+declare function applyDefaultFirstDayOfWeek(props: {
+    configToUpdate: WebChart | WebHeatChart;
+    chartContainer?: HTMLElement;
+    layer?: SupportedLayer;
+}): WebChart | WebHeatChart;
 /**
  * Matches the config properties that have field names which mismatch the layer data source fields.
  *

package/dist/utils/localization/interfaces.d.ts

@@ -106,6 +106,7 @@ declare const CommonStringsIdentity: (value: {
             invalidValueFormatForHistogram: string;
             invalidValueFormatForScatterplot: string;
             invalidValueFormatForGauge: string;
+            invalidValueFormatForHeatChart: string;
             mismatchAxisAndValueFormat: string;
             queryError: string;
             simpleError: string;
@@ -130,6 +131,7 @@ declare const CommonStringsIdentity: (value: {
             pieChartCannotHaveMixtureOfPositiveAndNegativeSlices: string;
             pieChartSlicesCannotExceedLimit: string;
             gaugeCannotExceedLimit: string;
+            heatChartCannotExceedLimit: string;
             negativeValueInDataForLogTransformation: string;
             negativeValueInDataForSqrtTransformation: string;
             logarithmicXAxisNotPossible: string;
@@ -356,6 +358,7 @@ declare const CommonStringsIdentity: (value: {
             invalidValueFormatForHistogram: string;
             invalidValueFormatForScatterplot: string;
             invalidValueFormatForGauge: string;
+            invalidValueFormatForHeatChart: string;
             mismatchAxisAndValueFormat: string;
             queryError: string;
             simpleError: string;
@@ -380,6 +383,7 @@ declare const CommonStringsIdentity: (value: {
             pieChartCannotHaveMixtureOfPositiveAndNegativeSlices: string;
             pieChartSlicesCannotExceedLimit: string;
             gaugeCannotExceedLimit: string;
+            heatChartCannotExceedLimit: string;
             negativeValueInDataForLogTransformation: string;
             negativeValueInDataForSqrtTransformation: string;
             logarithmicXAxisNotPossible: string;