@arcgis/charts-components 5.0.0-next.115 → 5.0.0-next.117

package/dist/model/shared/utils.d.ts

@@ -1,5 +1,6 @@
 import { SupportedLayer } from '../../interfaces';
-import { IField, WebChart, WebChartAxis, WebChartGaugeAxis } from '../../spec';
+import { IField, WebChart, WebChartAxis, WebChartGaugeAxis, WebHeatChart } from '../../spec';
+import { ChartConfig } from '../../utils';
 import { LayerInfo, SplitByFieldInfos } from '../interfaces/common';
 /**
  * Returns the necessary information for building series based on a split-by field.
@@ -46,4 +47,12 @@ export declare function getCategoryLabels(props: {
     config: WebChart;
     category: string;
 }): Promise<string[]>;
+/**
+ * Checks if the given chart config is a matrix heat chart.  A matrix heat chart is defined as a heat chart with
+ * both axes using a category value format.
+ *
+ * @param chartConfig The chart config
+ * @returns True if the chart is a matrix heat chart, false otherwise
+ */
+export declare function isMatrixHeatChart(chartConfig?: ChartConfig | WebHeatChart): boolean;
 export {};

package/dist/model.js

@@ -1,11 +1,11 @@
 import { M as i } from "./chunks/common.js";
 import { B as m, C as y, F as g, G as C, H as w, L as f, a as u, P as L, b, S as p, T, c as S } from "./chunks/common.js";
-import { y as r, z as s, A as n } from "./chunks/type-guards.js";
-import { b as B, g as P, i as x, d as W, k as v, a as G, j as H, c as K, x as D, l as F, q as A, r as O, u as R, n as E, m as X, p as Y, w as $, o as j, s as q, t as z, v as I, f as J, h as N, e as Q } from "./chunks/type-guards.js";
+import { w as r, x as s, y as n } from "./chunks/type-guards.js";
+import { a as B, f as P, i as x, c as W, k as v, j as G, h as H, b as K, v as D, l as F, p as O, s as A, n as E, m as R, u as X, o as Y, q as $, r as j, t as q, e as z, g as I, d as J } from "./chunks/type-guards.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.115 */
-async function h(t) {
+v5.0.0-next.117 */
+async function c(t) {
   const o = "config" in t ? r(t.config) : t.chartType;
   let a;
   if (!("layer" in t) && !("iLayer" in t) && "config" in t && t.config.iLayer === void 0)
@@ -91,7 +91,7 @@ export {
   b as PieChartSlicesDisplay,
   p as SerialChartDataSortingKinds,
   T as TextFormatKeys,
-  h as createModel,
+  c as createModel,
   S as customSortString,
   B as isBarChartModel,
   P as isBoxPlotModel,
@@ -103,18 +103,16 @@ export {
   K as isLineChartModel,
   D as isModelOfType,
   F as isModelWithBasicXAxis,
-  A as isModelWithDataLabels,
   O as isModelWithGuides,
-  R as isModelWithLegend,
+  A as isModelWithLegend,
   E as isModelWithLineMarkerStyling,
-  X as isModelWithMultiAxes,
-  Y as isModelWithRotation,
-  $ as isModelWithTemporalBinning,
-  j as isModelWithTooltips,
-  q as isModelWithXGuides,
-  z as isModelWithYGuides,
-  I as isPieChartLegendModel,
-  J as isPieChartModel,
-  N as isScatterplotModel,
-  Q as isSerialChartModel
+  R as isModelWithMultiAxes,
+  X as isModelWithTemporalBinning,
+  Y as isModelWithTooltips,
+  $ as isModelWithXGuides,
+  j as isModelWithYGuides,
+  q as isPieChartLegendModel,
+  z as isPieChartModel,
+  I as isScatterplotModel,
+  J as isSerialChartModel
 };

package/dist/spec/chart-object-literals.d.ts

@@ -312,3 +312,30 @@ export interface WebChartOrderSeriesBy {
      */
     orderBy?: WebChartSortOrderKinds;
 }
+/**
+ * Represents the different types of views that can be applied to a heat chart.
+ */
+export declare const WebChartHeatChartViewTypes: {
+    /**
+     * A single calendar view showing all data in one calendar.
+     */
+    readonly singleCalendarView: "SingleCalendarView";
+    /**
+     * Multiple sequential calendar views (e.g., years).
+     */
+    readonly sequentialCalendarViews: "SequentialCalendarViews";
+};
+export type WebChartHeatChartViewTypes = (typeof WebChartHeatChartViewTypes)[keyof typeof WebChartHeatChartViewTypes];
+/**
+ * Class break types for data classification in charts.
+ */
+export declare const WebChartClassBreakTypes: {
+    readonly equalInterval: "equal-interval";
+    readonly quantile: "quantile";
+    readonly naturalBreaks: "natural-breaks";
+    readonly manual: "manual";
+};
+/**
+ * Class break types for data classification in charts.
+ */
+export type WebChartClassBreakTypes = (typeof WebChartClassBreakTypes)[keyof typeof WebChartClassBreakTypes];

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

@@ -1,4 +1,4 @@
-import { GaugeChartSubTypes, SizePolicyScaleTypes, WebChartCalendarDatePartsUnits, WebChartDataTransformations, WebChartDirectionalDataOrder, WebChartHeatChartHeatRulesTypes, WebChartLabelBehavior, WebChartLegendPositions, WebChartMultiAxesDataOrder, WebChartNullPolicyTypes, WebChartOrderSeriesBy, WebChartPredefinedLabelsDataOrder, WebChartRadarChartAxisLabelsOrientation, WebChartStackedKinds, WebChartTemporalBinningUnits, WebChartTimeAggregationTypes, WebChartTypes } from './chart-object-literals';
+import { GaugeChartSubTypes, SizePolicyScaleTypes, WebChartCalendarDatePartsUnits, WebChartClassBreakTypes, WebChartDataTransformations, WebChartDirectionalDataOrder, WebChartHeatChartHeatRulesTypes, WebChartHeatChartViewTypes, WebChartLabelBehavior, WebChartLegendPositions, WebChartMultiAxesDataOrder, WebChartNullPolicyTypes, WebChartOrderSeriesBy, WebChartPredefinedLabelsDataOrder, WebChartRadarChartAxisLabelsOrientation, WebChartStackedKinds, WebChartTemporalBinningUnits, WebChartTimeAggregationTypes, WebChartTypes } from './chart-object-literals';
 import { TimeIntervalInfo } from './data-source';
 import { RESTUnits } from './rest-js-object-literals';
 import { Color, IDrawingInfo, IEnvelope, IExtent, IFeatureLayer, IPoint, IPolygon, IPolygonWithCurves, IPolyline, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, IStatisticDefinition, ITextSymbol } from './rest-js-types';
@@ -6,7 +6,7 @@ import { QueryMixin } from '@arcgis/core/rest/support/QueryMixin';
 /**
  * Version of the current specification.
  */
-export declare const WebChartCurrentVersion = "24.8.0";
+export declare const WebChartCurrentVersion = "25.0.0";
 /**
  * Stores information regarding a numeric conversion.
  */
@@ -763,6 +763,11 @@ interface WebChartTemporalBinningExtras {
     nullPolicy?: WebChartNullPolicyTypes;
 }
 export interface WebChartCalendarDatePartsBinning extends WebChartTemporalBinningBase {
+    /**
+     * Represents a unique string identifier for the CalendarDatePartsBinning object.
+     * For CalendarDatePartsBinning object, it is "calendarDateParts".
+     */
+    type: typeof WebChartTypes.CalendarDateParts;
     /**
      * Represents the unit to use to bin the data.
      */
@@ -1326,6 +1331,38 @@ export interface WebChartHeatChartGradient {
      */
     outsideRangeUpperColor?: Color;
 }
+/**
+ * JSON representation of the Heat chart - class breaks type
+ */
+export interface WebChartHeatChartHeatClassBreaks {
+    /**
+     * The number of classes breaks to be used for the heat chart.
+     *
+     * @default 5
+     */
+    breaksCount?: number;
+    /**
+     * The classification method to be used for the  heat chart.
+     */
+    classificationMethod?: WebChartClassBreakTypes;
+}
+/**
+ * JSON representation of the Heat chart empty cell configuration
+ */
+export interface WebChartHeatChartEmptyCell {
+    /**
+     * 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 symbol to use by the empty cells.
+     * If none is provided, the default symbol will be used.
+     */
+    symbol?: ISimpleFillSymbol;
+}
 /**
  * JSON representation of the Heat chart series
  */
@@ -1358,23 +1395,14 @@ export interface WebChartHeatChartSeries extends WebChartSeries {
      * Specifies the details of the gradient rules for the heat chart.
      */
     gradientRules?: WebChartHeatChartGradient;
+    /**
+     * Specifies the details of the class breaks rules for the heat chart.
+     */
+    classBreaksRules?: WebChartHeatChartHeatClassBreaks;
     /**
      * Specifies how to display the empty cells, in terms of text and symbology.
      */
-    emptyCells?: {
-        /**
-         * 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 symbol to use by the empty cells.
-         * If none is provided, the default symbol will be used.
-         */
-        symbol?: ISimpleFillSymbol;
-    };
+    emptyCells?: WebChartHeatChartEmptyCell;
 }
 export type WebChartRadarChartSeries = WebChartLineChartSeries<"radarSeries">;
 /**
@@ -1607,6 +1635,12 @@ export interface WebHeatChart extends WebChart, WebChartTemporalBinningExtras {
      * @default false
      */
     hideEmptyRowsAndColumns?: boolean;
+    /**
+     * The calendar view type for the heat chart.
+     *
+     * **NOTE**: This property is only applicable to the Calendar heat chart.
+     */
+    viewType?: WebChartHeatChartViewTypes;
     /**
      * Whether to include leap day (Feb. 29th) in queries
      * @default false

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

@@ -272,6 +272,12 @@ declare function renameChartSubtitle(configToUpdate: WebChart): WebChart;
  * @param configToUpdate The chart's config to update
  */
 declare function convertTemporalBinningProps2(configToUpdate: WebChart): WebChart;
+/**
+ * Add the `type` property to temporal binning properties in the heat chart series
+ * @param configToUpdate
+ * @returns
+ */
+declare function transformPropsInHeatChart(configToUpdate: WebChart): WebChart;
 /**
  * Conversions for 1.0.1:
  *   - orderByField adjustment for PieFromFields
@@ -413,6 +419,13 @@ declare function convertTo23x3x0(configToUpdate: WebChart): WebChart;
  * @returns The updated chart config
  */
 declare function convertTo24x8x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v25.0.0:
+ * - Add the `type` property to temporal binning properties in the heat chart series
+ * @param configToUpdate The chart's config to update
+ * @returns The updated chart config
+ */
+declare function convertTo25x0x0(configToUpdate: WebChart): WebChart;
 /**
  * Apply the needed function calls depending on the current chart version.
  * Note: Additional switch cases and convertToxxx functions are to be added to this function accordingly.
@@ -499,7 +512,9 @@ export declare const chartConfigConverterPrivateFunctions: {
     convertTo21x1x0: typeof convertTo21x1x0;
     convertTo23x3x0: typeof convertTo23x3x0;
     convertTo24x8x0: typeof convertTo24x8x0;
+    convertTo25x0x0: typeof convertTo25x0x0;
     convertTemporalBinningProps2: typeof convertTemporalBinningProps2;
+    transformPropsInHeatChart: typeof transformPropsInHeatChart;
     applyConversions: typeof applyConversions;
     convertDataSourceToILayer: typeof convertDataSourceToILayer;
     applyDefaultFirstDayOfWeek: typeof applyDefaultFirstDayOfWeek;

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

@@ -1,4 +1,4 @@
-import { IFeatureLayer, WebChart, WebChartCalendarBinningOffsetUnits, WebChartDataTypes, WebChartNullPolicyTypes, WebChartSeries, WebChartSeriesQuery, WebChartSortOrderKinds, WebChartTemporalSeries, WebChartText, WebChartTimeAggregationTypes } from '../../../spec';
+import { IFeatureLayer, WebChart, WebChartCalendarBinningOffsetUnits, WebChartCalendarDatePartsUnits, WebChartClassBreakTypes, WebChartDataTypes, WebChartNullPolicyTypes, WebChartSeries, WebChartSeriesQuery, WebChartSortOrderKinds, WebChartTemporalSeries, WebChartText, WebChartTimeAggregationTypes } from '../../../spec';
 export type FormerWebChartSubtitle = WebChart & {
     subTitle?: WebChartText;
 };
@@ -46,6 +46,18 @@ export type FormerWebChartWithDataPreferLabel = WebChart & {
         };
     };
 };
+export type FormerWebHeatChartWithDifferentProps = WebChart & {
+    series: {
+        breaksCount?: number;
+        classificationMethod?: WebChartClassBreakTypes;
+        xTemporalBinning: {
+            unit: WebChartCalendarDatePartsUnits;
+        };
+        yTemporalBinning: {
+            unit: WebChartCalendarDatePartsUnits;
+        };
+    }[];
+};
 /**
  * JSON representation of the inline data source
  */

package/dist/utils/chart-config/utils/class-breaks/index.d.ts

@@ -0,0 +1,16 @@
+import { RESTSymbolType, RESTSimpleFillSymbolStyle, Color } from '../../../../spec';
+export interface ClassBreakInfo {
+    label: string;
+    classMinValue: number;
+    classMaxValue: number;
+    symbol: {
+        type: RESTSymbolType;
+        style: RESTSimpleFillSymbolStyle;
+        color: Color;
+        outline: {
+            style: RESTSimpleFillSymbolStyle;
+            color: Color;
+            width: number;
+        };
+    };
+}

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

@@ -401,23 +401,6 @@ export declare function doesConfigChangeRequireNewData(props: {
  * @returns
  */
 declare function hasConfigSeriesNamesChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
-/**
- * Determines if the series order has changed between the old and the new configs.
- *
- * @param oldConfig The previous chart config
- * @param newConfig The new chart config
- * @returns
- */
-declare function hasSeriesOrderChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
-/**
- * Determines whether a sort by series is needed.
- * A sort by series is needed when either the series order has changed or any of the series names have changed.
- *
- * @param oldConfig The previous chart config.
- * @param newConfig The new chart config.
- * @returns
- */
-export declare function isSortBySeriesNeeded(oldConfig: WebChart, newConfig: WebChart): boolean;
 /**
  * Sorts the series in the config based on the series sort options.
  * When no sort option is provide, no sorting is performed.
@@ -437,7 +420,6 @@ export declare const chartConfigUtilsPrivateFunctions: {
     isNewDataRequiredForValueFormatChange: typeof isNewDataRequiredForValueFormatChange;
     hasShowMeanChanged: typeof hasShowMeanChanged;
     hasHeatChartBinningChanged: typeof hasHeatChartBinningChanged;
-    hasSeriesOrderChanged: typeof hasSeriesOrderChanged;
     hasConfigSeriesNamesChanged: typeof hasConfigSeriesNamesChanged;
 };
 export {};

package/dist/utils/components/chart-ui-utils.d.ts

@@ -1,6 +1,7 @@
 import { RESTSimpleLineSymbolStyle } from '../../spec';
-import { NumericFieldsChangeProps } from '../../interfaces';
+import { NumericFieldsChangeProps, WebChartCalendarTypes } from '../../interfaces';
 import { FormatKeys } from '../../model';
+import { HeatChartModel } from '../../model/heat-chart-model/heat-chart-model';
 export interface RGB {
     r: number;
     g: number;
@@ -110,3 +111,9 @@ export declare function downloadFile(objectURL: string, downloadString: string):
  * @returns Null return for caller to easily reset tooltip object to null
  */
 export declare function destroyTooltip(tooltip: HTMLCalciteTooltipElement | null | undefined): null;
+/**
+ * Gets the calendar type based on the heat chart model's temporal binning configuration.
+ * @param {HeatChartModel} model - The heat chart model.
+ * @returns {WebChartCalendarTypes | undefined} The calendar type, or undefined if not applicable.
+ */
+export declare function getCalendarType(model: HeatChartModel): WebChartCalendarTypes | undefined;

package/dist/utils/components/config-update.d.ts

@@ -2,9 +2,9 @@ import { default as Graphic } from '@arcgis/core/Graphic';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { ChartOptions } from '../../chart-rendering/common/interfaces';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
+import { SupportedLayer } from '../../interfaces';
 import { WebBoxPlot, WebChart, WebChartLegendPositions } from '../../spec';
 import { QueryObject } from '../../utils';
-import { SupportedLayer } from '../../interfaces';
 /**
  * Updates the legend position for a given WebChart config.
  * Returns the updated config.
@@ -49,15 +49,18 @@ export declare function isValidDataSource(config?: WebChart, layer?: FeatureLaye
  * - add the iLayer if missing
  * - convert it to the latest version
  * @param props.configToAlter The config to alter
+ * @param props.chartContainer The chart container
+ * @param props.queryObject The query object
+ * @param props.options The runtime options
+ * @param props.updateSplitBySeries The updateSplitBySeries property
+ * @param props.addMissingSeries Whether to add missing series for split-by charts
  * @param props.layer The component's layer
  */
 export declare function prepareConfigForRendering(props: {
-    creation: boolean;
     configToAlter: WebChart | undefined;
     chartContainer?: HTMLElement;
     queryObject: QueryObject;
     options: ChartOptions;
-    previousConfig?: WebChart | undefined;
     updateSplitBySeries: ArcgisChart["updateSplitBySeries"];
     addMissingSeries: boolean;
     layer: ArcgisChart["layer"];

package/dist/utils/data/stats/class-breaks.d.ts

@@ -0,0 +1,91 @@
+import { Color } from '../../../spec';
+import { ClassBreakInfo } from '../../chart-config/utils/class-breaks';
+import { ClassBreaksRendererResult } from '@arcgis/core/smartMapping/renderers/color.js';
+import { ColorRamp } from '@arcgis/core/smartMapping/symbology/types.js';
+/**
+ * Generates a color per class break (length = `numberOfClassBreaks`).
+ *
+ * @param props - Options.
+ * @param props.numberOfClassBreaks - Number of colors to generate.
+ * @param props.selectedColorRamp - Optional ArcGIS color ramp to sample from (assumed already flipped upstream).
+ * @param props.colorRamp - Optional explicit Charts colors. If its length matches `numberOfClassBreaks`, it is used as-is.
+ * @returns Charts colors as an array of RGBA tuples.
+ *
+ * @example
+ * ```ts
+ * // Prefer the explicit colorRamp when it already matches the break count.
+ * generateColorsForClassBreaks({ numberOfClassBreaks: 5, colorRamp: [[...], ...] });
+ * ```
+ */
+export declare function generateColorsForClassBreaks(props: {
+    numberOfClassBreaks: number;
+    selectedColorRamp?: ColorRamp;
+    colorRamp?: Color[];
+}): Color[];
+/**
+ * Builds {@link ClassBreakInfo} entries (label + symbol) from a Smart Mapping renderer result.
+ *
+ * @param props - Options.
+ * @param props.classBreaksRendererResult - ArcGIS Core class breaks renderer output.
+ * @param props.numberOfClassBreaks - Number of breaks used to generate colors.
+ * @param props.selectedColorRamp - Optional ArcGIS ramp (assumed already flipped upstream).
+ * @param props.colorRamp - Optional explicit Charts colors.
+ * @returns Array of {@link ClassBreakInfo}; empty if there are no break infos.
+ *
+ * @note Gotcha: min/max values are normalized for display (`floor(min)`, `ceil(max)`).
+ *
+ * @example
+ * ```ts
+ * const infos = extractClassBreakInfos({ classBreaksRendererResult, numberOfClassBreaks: 5 });
+ * // infos[0].label might be "≤ 10"
+ * ```
+ */
+export declare function extractClassBreakInfos(props: {
+    classBreaksRendererResult: ClassBreaksRendererResult;
+    numberOfClassBreaks: number;
+    selectedColorRamp?: ColorRamp;
+    colorRamp?: Color[];
+}): ClassBreakInfo[];
+/**
+ * Converts a Charts RGB/RGBA tuple to a CSS hex string.
+ *
+ * @param rgbaColor - `[r, g, b]` or `[r, g, b, a]` (alpha is ignored).
+ * @returns Hex color string in the form `#RRGGBB`.
+ *
+ * @note Values are clamped to 0–255.
+ *
+ * @example
+ * ```ts
+ * convertRgbaToHexString([255, 0, 0, 255]); // → "#ff0000"
+ * ```
+ */
+export declare function convertRgbaToHexString(rgbaColor: number[] | null | undefined): string;
+export declare const ColorRampCategoriesToTags: {
+    readonly all: readonly ["*"];
+    readonly light: readonly ["light"];
+    readonly dark: readonly ["dark"];
+    readonly redsAndYellows: readonly ["oranges", "reds", "yellows"];
+    readonly greens: readonly ["greens"];
+    readonly blues: readonly ["blues"];
+    readonly purplesAndPinks: readonly ["purples", "pinks"];
+    readonly browns: readonly ["browns"];
+    readonly grays: readonly ["grays"];
+    readonly bright: readonly ["bright"];
+    readonly subdued: readonly ["subdued"];
+    readonly colorblindFriendly: readonly ["colorblind-friendly"];
+};
+export declare const ColorRampCategories: {
+    readonly all: "all";
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly redsAndYellows: "redsAndYellows";
+    readonly greens: "greens";
+    readonly blues: "blues";
+    readonly purplesAndPinks: "purplesAndPinks";
+    readonly browns: "browns";
+    readonly grays: "grays";
+    readonly bright: "bright";
+    readonly subdued: "subdued";
+    readonly colorblindFriendly: "colorblindFriendly";
+};
+export type ColorRampCategories = (typeof ColorRampCategories)[keyof typeof ColorRampCategories];

package/dist/utils/defaults/index.d.ts

@@ -90,7 +90,7 @@ export declare function getDefaultLineChartLineSymbol(seriesIndex?: number): ISi
 export declare function getDefaultScatterplotMarkerSymbol(useRandomColor?: boolean): ISimpleMarkerSymbol;
 export declare function getDefaultScatterplotSizePolicy(): Required<SizePolicy>;
 export declare function getDefaultTrendLine(useRandomColor?: boolean): Required<ScatterplotOverlays>;
-export declare function getHeatChartSeries(objectIdField?: string): WebChartHeatChartSeries;
+export declare function getHeatChartSeries(commonStrings: CommonStrings, objectIDField?: string): WebChartHeatChartSeries;
 export declare function getScatterplotSeries(): WebChartScatterplotSeries;
 /**
  * Returns default axes based on chart type as per the WebChart Specification
@@ -170,8 +170,8 @@ export declare function getDefaultGauge(commonStrings: CommonStrings, id?: strin
 export declare function getDefaultScatterplot(commonStrings: CommonStrings, id?: string): WebChart;
 /**
  * Gets default heat chart
- * @param commonStrings
- * @param id
+ * @param commonStrings Common strings
+ * @param objectIDField Object ID field
  * @returns WebHeatChart
  */
 export declare function getDefaultHeatChart(commonStrings: CommonStrings, objectIDField: string): WebHeatChart;

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

@@ -67,6 +67,7 @@ declare const CommonStringsIdentity: (value: {
             pieChartCreateMsg: string;
             histogramCreateMsg: string;
             scatterplotCreateMsg: string;
+            calendarHeatChartCreateMsg: string;
         };
         notifications: {
             invalidConfig: string;
@@ -319,6 +320,7 @@ declare const CommonStringsIdentity: (value: {
             pieChartCreateMsg: string;
             histogramCreateMsg: string;
             scatterplotCreateMsg: string;
+            calendarHeatChartCreateMsg: string;
         };
         notifications: {
             invalidConfig: string;

package/dist/utils/type-guards/index.d.ts

@@ -1,4 +1,4 @@
-import { CategoryFormatOptions, DateTimeFormatOptions, IFeatureLayer, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, WebBoxPlot, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataTypes, WebChartGenericDataItem, WebChartHistogramDataItem, WebChartLineChartSeries, WebChartRadarChartSeries, WebChartScatterplotDataItem, WebChartSeries, WebChartStackedKinds, WebChartTextSymbol, WebGaugeChart, WebHeatChart } from '../../spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, IFeatureLayer, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, WebBoxPlot, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataTypes, WebChartGenericDataItem, WebChartHeatChartSeries, WebChartHistogramDataItem, WebChartLineChartSeries, WebChartRadarChartSeries, WebChartScatterplotDataItem, WebChartSeries, WebChartStackedKinds, WebChartTextSymbol, WebGaugeChart, WebHeatChart } from '../../spec';
 import { ModelTypes } from '../../model';
 import { ChartTypes } from '../misc';
 import { ChartConfig } from '../types';
@@ -85,6 +85,11 @@ export declare function isRadarChartSeries(series: WebChartSeries | undefined):
  * @param series - The series to check.
  */
 export declare function isBarChartSeries(series: WebChartSeries | undefined): series is WebChartBarChartSeries;
+/**
+ * Determines if the series is a heat chart series.
+ * @param {WebChartSeries | undefined} series The series to check.
+ */
+export declare function isHeatChartSeries(series: WebChartSeries | undefined): series is WebChartHeatChartSeries;
 /**
  * Type guard to check if the series is a `BarChartSeries`.
  *
@@ -103,6 +108,12 @@ export declare const isLineChartSeriesArray: (series: WebChartSeries[]) => serie
  * @param series - The series to check.
  */
 export declare const isRadarChartSeriesArray: (series: WebChartSeries[]) => series is WebChartRadarChartSeries[];
+/**
+ * Type guard to check if the series is a HeatChartSeries.
+ * @param {WebChartSeries[]} series - The series to check.
+ * @returns {series is WebChartHeatChartSeries[]}
+ */
+export declare const isHeatChartSeriesArray: (series: WebChartSeries[]) => series is WebChartHeatChartSeries[];
 /**
  * Determines if the series array is of type box plot series.
  *

package/dist/utils/types/index.d.ts

@@ -98,6 +98,10 @@ export type GaugeChartConfig = WebGaugeChart;
  * Type alias for a Box Plot config.
  */
 export type BoxPlotConfig = WebBoxPlot;
+/**
+ * Type alias for a Heat Chart config.
+ */
+export type HeatChartConfig = WebHeatChart;
 /**
  * Type alias for the supported chart series types.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/charts-components",
-  "version": "5.0.0-next.115",
+  "version": "5.0.0-next.117",
   "description": "Reusable ArcGIS charting Web Components.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,8 +28,8 @@
   "dependencies": {
     "@amcharts/amcharts4": "^4.10.31",
     "@amcharts/amcharts5": "~5.15.0",
-    "@arcgis/lumina": "5.0.0-next.115",
-    "@arcgis/toolkit": "5.0.0-next.115",
+    "@arcgis/lumina": "5.0.0-next.117",
+    "@arcgis/toolkit": "5.0.0-next.117",
     "ajv": "6.12.6",
     "d3-array": "^3.2.1",
     "d3-shape": "^3.2.0",

package/dist/cdn/2VH5SRZZ.js

@@ -1,4 +0,0 @@
-/*! 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.115 */
-import{a as p}from"./NQRONGZE.js";import{a as I,b as E}from"./ZJ7QTII4.js";import b from"./M4YV2QY4.js";import"./5DS7BG4I.js";import{a as c}from"./W64CZPBS.js";import a from"./QVRSCIHR.js";import{g as m}from"./HJBFCMQQ.js";import"./EWJOK3I4.js";import"./K55E4LKR.js";import{a as l}from"./OU3L46HV.js";import{A as o,D as v,F as C,g as f,h as n,x as h,y as r,z as N}from"./T6JTPLQE.js";import"./YPEPDHAZ.js";export default $arcgis.t(([,{a:g,f:M,g:x,h:B,i:i}])=>{var d={linkContainer:"link-container",label:"label",mb2:"mb-2"},L=f`.hide{display:none}.am5-modal{width:100%;height:100%;position:absolute;z-index:100000;top:0;left:0}.am5-html-container{z-index:101!important}.am5-modal-curtain{top:0;left:0;width:100%;height:100%;position:absolute;background:#fff!important;z-index:100}.am5-modal-wrapper{top:0;left:0;width:100%;height:100%;position:absolute;display:flex;align-items:center;justify-content:center;white-space:nowrap;background:#ffffff80;z-index:101}.am5-modal-content{display:inline-block;padding:1.2em;vertical-align:middle;text-align:start;white-space:normal;background:#fff;border-radius:4px;box-shadow:#00000073 0 0 36px;color:#000}.am5-layer-1000{z-index:1000!important}.am5-layer-30{z-index:100!important}.arcgis-charts-modal{box-shadow:none!important}.arcgis-charts-modal-header{background-color:#0000000d;font-weight:700;padding:4px;align-content:center}.show{display:block}.notifyPanel{flex:0 1 auto}.disable-interactions{pointer-events:none}.dim-text{color:var(--arcgis-charts-dim-text)}calcite-block{width:var(--arcgis-charts-config-calcite-block-width, var(--arcgis-charts-config-calcite-block-default-width));height:var(--arcgis-charts-config-calcite-block-height, var(--arcgis-charts-config-calcite-block-default-height));border:0px;-webkit-box-shadow:0 0 0 0;box-shadow:0 0}.label{display:flex;justify-content:space-between}.mb-2{margin-bottom:var(--arcgis-charts-config-margin-minor)}.link-container{display:flex;justify-content:flex-end;margin-top:-.75rem}`,b=class extends N{constructor(){super(...arguments),this._messages=c(),this.commonStrings=c({name:"common",blocking:!0}),this.axisModel=new p,this.minBoundInputElement=h(),this.maxBoundInputElement=h(),this.showLogScaleSwitch=h(),this.defaultMinBound=Number.NaN,this.defaultMaxBound=Number.NaN,this.onMaxBoundsChange=()=>{let e=this.maxBoundInputElement.value?.value,t=this.maxBoundInputElement.value?.status;if(e!==void 0&&e!==""){let s=this.maxBoundInputElement.value?.min===void 0?this.axisModel.getMinBound():Math.max(this.maxBoundInputElement.value.min,this.axisModel.getMinBound()),a=Number.parseFloat(e);if(a!==this.axisModel.getMinBound()&&M(a,s,this.maxBoundInputElement.value?.max)){if(a!==this.axisModel.getMaxBound()){this.axisModel.setMaxBound(a);let u=this.getAxisBoundsFromStateStore();u&&(u.currMaxBound=a)}t=i.IDLE}else t=i.INVALID}else t=i.IDLE;this.maxBoundInputElement.value&&B({inputElement:this.maxBoundInputElement.value,status:t}),t!==i.INVALID&&this.minBoundInputElement.value?.status===i.INVALID&&this.onMinBoundsChange(),this.requestUpdate()},this.onMaxBoundsChangeDebounced=m(this.onMaxBoundsChange,g.DebounceTimer),this.onMinBoundsChange=()=>{let e=this.minBoundInputElement.value?.value,t=this.minBoundInputElement.value?.status;if(e!==void 0&&e!==""){let s=this.minBoundInputElement.value?.max===void 0?this.axisModel.getMaxBound():Math.min(this.minBoundInputElement.value.max,this.axisModel.getMaxBound()),a=Number.parseFloat(e);if(a!==this.axisModel.getMaxBound()&&M(a,this.minBoundInputElement.value?.min,s)){if(a!==this.axisModel.getMinBound()){this.axisModel.setMinBound(a);let u=this.getAxisBoundsFromStateStore();u&&(u.currMinBound=a)}t=i.IDLE}else t=i.INVALID}else t=i.IDLE;this.minBoundInputElement.value&&B({inputElement:this.minBoundInputElement.value,status:t}),t!==i.INVALID&&this.maxBoundInputElement.value?.status===i.INVALID&&this.onMaxBoundsChange(),this.updateEnableLogarithmic(this.axisModel.getLogarithmic()&&(this.dataMinValue??Number.NaN)>0),this.requestUpdate()},this.onMinBoundsChangeDebounced=m(this.onMinBoundsChange,g.DebounceTimer),this.onModelConfigChange=()=>{this.requestUpdate()},this.disableMaxBoundResetBtn=!0,this.disableMinBoundResetBtn=!0,this.isXAxis=!1,this.axisTitle=""}static{this.properties={disableMaxBoundResetBtn:16,disableMinBoundResetBtn:16,messageOverrides:0,model:0,isXAxis:5,axisTitle:1,maxBoundMaxLimit:9,maxBoundMinLimit:9,minBoundMinLimit:9,minBoundMaxLimit:9,showMaxBoundOption:5,showMinBoundOption:5,showEnableLogOption:5,dataMaxValue:9,dataMinValue:9,initialMaxBound:9,initialMinBound:9}}static{this.styles=L}load(){this.modelChange(this.model),this.dataMinValue!==void 0&&this.dataMinValueChange(this.dataMinValue,Number.NaN),this.dataMaxValue!==void 0&&this.dataMaxValueChange(this.dataMaxValue,Number.NaN)}willUpdate(e){e.has("model")&&this.modelChange(this.model,e.get("model")),e.has("dataMinValue")&&this.dataMinValueChange(this.dataMinValue??Number.NaN,e.get("dataMinValue")),e.has("dataMaxValue")&&this.dataMaxValueChange(this.dataMaxValue??Number.NaN,e.get("dataMaxValue")),e.has("initialMaxBound")&&this.initialMaxBoundChange(),e.has("initialMinBound")&&this.initialMinBoundChange()}updated(){this.disableResetButtons()}disconnectedCallback(){super.disconnectedCallback(),this.model.removeEventListener("arcgisChartsModelConfigChange",this.onModelConfigChange)}modelChange(e,t){this.axisModel=new p(this.model,this.isXAxis),t?.removeEventListener("arcgisChartsModelConfigChange",this.onModelConfigChange),e?.addEventListener("arcgisChartsModelConfigChange",this.onModelConfigChange)}dataMinValueChange(e,t){Number.isNaN(t)&&!Number.isNaN(e)&&(this.defaultMinBound=e)}dataMaxValueChange(e,t){Number.isNaN(t)&&!Number.isNaN(e)&&(this.defaultMaxBound=e)}initialMaxBoundChange(){Number.isNaN(this.axisModel.getMaxBound())||this.axisModel.setMaxBound(this.axisModel.getMaxBound())}initialMinBoundChange(){Number.isNaN(this.axisModel.getMinBound())||this.axisModel.setMinBound(this.axisModel.getMinBound())}getAxisBoundsFromStateStore(){let e,t=I.chartAxesBoundDataMap,s=this.model.chartId;if(s){let a=E({chartId:s,isXAxis:this.isXAxis,isLogarithmic:this.axisModel.getLogarithmic()});e=t[s]?.[a]}return e}disableResetButtons(){let e=this.getAxisBoundsFromStateStore();e&&(this.disableMaxBoundResetBtn=e.defaultMaxBound===e.currMaxBound,this.disableMinBoundResetBtn=e.defaultMinBound===e.currMinBound)}onShowLogScaleMouseEnter(){this.showLogScaleTooltip?.remove(),this.showLogScaleSwitch.value?.disabled&&(this.showLogScaleTooltip=v(n`<calcite-tooltip .referenceElement=${this.showLogScaleSwitch.value??document.body} open>${this.commonStrings.utilsStrings.tooltips?.logDisabled??""}</calcite-tooltip>`),document.body.appendChild(this.showLogScaleTooltip))}onShowLogScaleMouseLeave(){this.showLogScaleTooltip?.remove()}onCategoryFormatChange(e){this.axisModel.setValueFormat(e.target.categoryFormat)}updateEnableLogarithmic(e){e!==this.axisModel.getLogarithmic()&&(this.axisModel.setLogarithmic(e),this.requestUpdate())}onNumberFormatChange(e){this.axisModel.setValueFormat({type:l.NumberAxisFormat,intlOptions:e.detail}),this.requestUpdate()}onRevertMaxBoundsToDefault(){if(this.maxBoundInputElement.value?.status===i.INVALID||this.axisModel.getMaxBound()!==this.defaultMaxBound){let e=this.getAxisBoundsFromStateStore();this.axisModel.getMinBound()>this.defaultMaxBound&&this.axisModel.setMinBound(e?.defaultMinBound??Number.NaN),this.axisModel.setMaxBound(e?.defaultMaxBound??Number.NaN),this.requestUpdate()}}onRevertMinBoundsToDefault(){(this.minBoundInputElement.value?.status===i.INVALID||this.axisModel.getMinBound()!==this.defaultMinBound)&&(this.axisModel.getMaxBound()<this.defaultMinBound&&this.axisModel.setMaxBound(Number.NaN),this.axisModel.setMinBound(Number.NaN),this.requestUpdate())}enableLogScale(e){let{checked:t}=e.target;this.axisModel.setLogarithmic(t&&(this.dataMinValue??Number.NaN)>0),this.requestUpdate()}render(){return n`<calcite-block .hidden=${this.axisModel.getValueFormat()?.type===l.DateAxisFormat} expanded .heading=${this.axisTitle}>${this.renderAxis()}</calcite-block>`}renderAxis(){let e=null,t={...this.axisModel.getValueFormat()};switch(this.axisModel.getValueFormat()?.type){case l.CategoryAxisFormat:e=n`<arcgis-charts-config-category-format .categoryFormat=${t} @arcgisChartsConfigCategoryFormatChange=${this.onCategoryFormatChange}></arcgis-charts-config-category-format>`;break;case l.NumberAxisFormat:e=n`<div>${this.renderShowLogScale()}${this.renderMinBound()}${this.renderMaxBound()}<arcgis-charts-config-number-format .numberFormat=${{...t.intlOptions}} @arcgisChartsConfigNumberFormatChange=${this.onNumberFormatChange}></arcgis-charts-config-number-format></div>`;break;case l.DateAxisFormat:e=null;break}return e}renderMaxBound(){let e;if(!this.showMaxBoundOption)e=null;else{let t=x(this.axisModel.getMaxBound(),this.initialMaxBound);e=n`<div><calcite-label class=${o(d.label)}>${this._messages.maxBounds}<calcite-input type=number number-button-type=none .min=${this.maxBoundMinLimit??Number.MIN_SAFE_INTEGER} .max=${this.maxBoundMaxLimit??Number.MAX_SAFE_INTEGER} step=any .value=${t} @calciteInputInput=${this.onMaxBoundsChangeDebounced} ${r(this.maxBoundInputElement)}></calcite-input></calcite-label><div class=${o(d.linkContainer)}><calcite-button .disabled=${this.disableMaxBoundResetBtn} @click=${this.onRevertMaxBoundsToDefault} appearance=transparent icon-end=reset>${this._messages.revertToDefault}</calcite-button></div></div>`}return e}renderMinBound(){let e;if(!this.showMinBoundOption)e=null;else{let t=x(this.axisModel.getMinBound(),this.initialMinBound??void 0);e=n`<div><calcite-label class=${o(d.label)}>${this._messages.minBounds}<calcite-input type=number number-button-type=none .min=${this.minBoundMinLimit??Number.MIN_SAFE_INTEGER} .max=${this.minBoundMaxLimit??Number.MAX_SAFE_INTEGER} step=any .value=${t} @calciteInputInput=${this.onMinBoundsChangeDebounced} ${r(this.minBoundInputElement)}></calcite-input></calcite-label><div class=${o(d.linkContainer)}><calcite-button .disabled=${this.disableMinBoundResetBtn} appearance=transparent icon-end=reset @click=${this.onRevertMinBoundsToDefault}>${this._messages.revertToDefault}</calcite-button></div></div>`}return e}renderShowLogScale(){let e;return this.showEnableLogOption&&(e=n`<calcite-label layout=inline-space-between class=${o({[d.label]:!0,[d.mb2]:!0})}>${this._messages.logScale}<div @mouseenter=${this.onShowLogScaleMouseEnter} @mouseleave=${this.onShowLogScaleMouseLeave}><calcite-switch .checked=${this.axisModel.getLogarithmic()&&(this.dataMinValue??Number.NaN)>0} .disabled=${(this.dataMinValue??Number.NaN)<=0} @calciteSwitchChange=${this.enableLogScale} ${r(this.showLogScaleSwitch)}></calcite-switch></div></calcite-label>`),e}};C("arcgis-charts-config-axis",b);return b},a,b)

package/dist/cdn/32BMOX2K.js

@@ -1,4 +0,0 @@
-/*! 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.115 */
-import{b as e,c as l,d as o}from"./5AENVGQN.js";import a from"./QVRSCIHR.js";import{d,l as y,q as h}from"./SZ2A2V3P.js";import{a as r,w as S}from"./OU3L46HV.js";export default $arcgis.t(([,,,,,,,{Bb:p,Kb:x,Kd:C,Xc:B,rb:g,u:m}])=>{var v=[e.EditChart,e.Legend,e.RotateChart,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsCSV,e.ExportAsImage],D=[e.EditChart,e.Legend,e.RotateChart,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],w=[e.EditChart,e.Legend,e.RotateChart,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],L=[e.EditChart,e.Legend,e.FilterBySelection,e.FilterByExtent,e.Selection,e.ClearSelection,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],T=[e.EditChart,e.Legend,e.FilterBySelection,e.Selection,e.ClearSelection,e.SwitchSelection],V=[e.EditChart,e.Legend,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],Z=[e.EditChart,e.Legend,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],M=[e.EditChart,e.Legend,e.RotateChart,e.FilterBySelection,e.FilterByExtent,e.Zoom,e.Selection,e.ClearSelection,e.FullExtent,e.SwitchSelection,e.ExportAsImage,e.ExportAsCSV],P=[e.EditChart,e.FilterByExtent,e.ExportAsImage,e.ExportAsCSV];function K(a){switch(a){case r.BarSeries:return v;case r.LineSeries:return D;case r.ComboLineAndBarSeries:return w;case r.PieSeries:return L;case r.HistogramSeries:return V;case r.ScatterSeries:return Z;case r.BoxPlotSeries:return M;case r.GaugeSeries:return P;case r.HeatSeries:return T;default:return[]}}var O=(a,i,t)=>{let n=a.target.assignedNodes().find(c=>"legendToggle"in c),s=S(t?.series);return n&&(n.chartType=s,R({actionBar:n,chartComponent:i,config:t})),n};function R(a){let{actionBar:i,chartComponent:t,config:n,isWarningDisplayed:s}=a,c=x(t.selectionData),f=n?.legend?n.legend.visible??!0:!1;if(i.chartType=S(n?.series),t.enableConfiguration){let F=i.hiddenActions??[];i.hiddenActions=F.filter(I=>I!==e.EditChart)}i.editChartState=t.enableConfiguration?o.Enabled:o.Disabled;let E=n&&p(n.series);i.legendState=E?o.Enabled:o.Disabled;let u=d(t?.model)&&h(t?.model)?t.model.legendVisibility:f;i.legendToggle=E&&u?l.Active:l.Inactive;let A=d(t?.model)&&y(t.model)?t.model.rotatedState:n?.rotated;i.rotateChartToggle=A?l.Active:l.Inactive;let b=B(n?.series??[])===g.PieFromFields;i.filterBySelectionState=!b&&(t.filterBySelection===!0||!c&&t.filterByExtent!==!0)?o.Enabled:o.Disabled,i.filterBySelectionToggle=t.filterBySelection===!0?l.Active:l.Inactive,i.filterByExtentState=t.filterByExtent===!0||t.filterBySelection!==!0?o.Enabled:o.Disabled,i.filterByExtentToggle=t.filterByExtent===!0?l.Active:l.Inactive,i.zoomState=t.filterBySelection?o.Disabled:o.Enabled,i.zoomToggle=t.actionMode===m.Zoom?l.Active:l.Inactive,i.selectionState=t.filterBySelection?o.Disabled:o.Enabled,i.selectionToggle=(t.actionMode??i.actionBarSelectionMode)===i.actionBarSelectionMode?l.Active:l.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||C(n)?o.Disabled:o.Enabled}return{a:K,b:O,c:R}},"geometry/support/jsonUtils","rest/support/AttributeBinsQuery","rest/support/Query","rest/support/StatisticDefinition","time/TimeExtent","core/promiseUtils","request",a)