@arcgis/charts-components 4.34.0-next.99 → 5.0.0-next.1

package/dist/chart-rendering/common/data/selection/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem } from '../../../../spec';
 import { ChartOptions } from '../../interfaces';
 /**
  * Function comparing two array containing selection items.
@@ -6,11 +6,17 @@ import { ChartOptions } from '../../interfaces';
  * @param props.itemsA First array
  * @param props.itemsB Second array
  * @param props.isPieFromFields Flag to indicate if the chart is a pie chart from fields
+ * @param props.x The x-axis field. Currently only used for a specific case related to the heat chart
+ * @param props.y The y-axis field. Currently only used for a specific case related to the heat chart
+ * @param props.outStatisticFieldName The out statistic field name. Currently only used for a specific case related to the heat chart
  */
 export declare function hasSelectionByItemsChanged(props: {
     itemsA?: WebChartDataItem[];
     itemsB?: WebChartDataItem[];
     isPieFromFields?: boolean;
+    x?: string;
+    y?: string;
+    outStatisticFieldName?: string;
 }): boolean;
 export declare function getSelectedData(props: {
     chartConfig: WebChart;

package/dist/chart-rendering/common/data/utils/categorical-data/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem } from '../../../../../spec';
 import { CompleteDataWithMissingCategoriesProps } from './interfaces';
 /**
  * Completes a chart data by adding all the unique values not already in the array

package/dist/chart-rendering/common/data/utils/categorical-data/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { QueryObject, AbortControllerKeyType, LimitBehavior } from '../../../../../utils';
-import { WebChartDataItem, WebChart, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChartDataItem, WebChart, WebChartQuery } from '../../../../../spec';
 export interface CompleteDataWithMissingCategoriesProps {
     seriesData: WebChartDataItem[];
     chartConfig: WebChart;

package/dist/chart-rendering/common/data/utils/misc/index.d.ts

@@ -1,4 +1,4 @@
-import { IExtent, IField, TimeIntervalInfo, ValueConversion, WebBoxPlot, WebChart, WebChartBin, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartSeriesType, WebGaugeChart, WebChartDataTransformations, WebChartSortOrderKinds } from '@arcgis/charts-spec';
+import { IExtent, IField, TimeIntervalInfo, ValueConversion, WebBoxPlot, WebChart, WebChartBin, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartSeriesType, WebGaugeChart, WebChartDataTransformations, WebChartSortOrderKinds } from '../../../../../spec';
 import { ChartElementLimit, SelectionIndexes, LimitBehavior } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
 import { DataUpdateNeededDetails } from './interfaces';
@@ -23,6 +23,7 @@ export declare function mergeExtents(extentList?: IExtent[]): IExtent | undefine
  * @param props.specificField A specific field to look for
  * @param props.preferLabel Whether to use field label instead of value
  * @param props.keepNullValues Whether to keep the null values
+ * @param props.config The chart's config
  */
 export declare function getXAxisValueFromContext(props: {
     value: Date | number | string;
@@ -31,6 +32,7 @@ export declare function getXAxisValueFromContext(props: {
     specificField?: string;
     preferLabel?: boolean;
     keepNullValues?: boolean;
+    config?: WebChart;
 }): Date | number | string;
 /**
  * Looks for the original x value in the data context. Chooses by order of priority:
@@ -46,10 +48,10 @@ export declare function getOriginalXValueFromContext(dataContext?: WebChartDataI
  * @param props.arrayToSort The array to sort
  * @param props.sortingField The field to sort by
  * @param props.orderBy The order by
- * @param props.forceAscendingOrder Whether to force the ascending order
- * @param props.isNonAggregated Whether the chart is non-aggregated
- * @param props.sortByCategory Whether to sort by the x-axis field
- * @param props.preferLabel Whether to use data labels
+ * @param props.forceAscendingOrder Whether to force the ascending order; only applies for non-heat charts
+ * @param props.isNonAggregated Whether the chart is non-aggregated; only applies for non-heat charts
+ * @param props.sortByCategory Whether to sort by the x-axis field; only applies for non-heat charts
+ * @param props.preferLabel Whether to use data labels; only applies for non-heat charts
  * @param props.isPieOrByFieldsChart Whether it is a pie or by fields chart
  */
 export declare function sortWebChartDataItemsUsingDirectionalSort(props: {
@@ -187,6 +189,13 @@ export declare function convertMultipleNumericFieldsData(props: {
  * @param newConfig The updated config
  */
 declare function hasGaugeValueConversionChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two heat chart configs to see if binning has changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasHeatChartBinningChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
 /**
  * Compares two configs and indicates whether the color type change
  *
@@ -194,6 +203,20 @@ declare function hasGaugeValueConversionChanged(oldConfig: WebChart, newConfig:
  * @param newConfig The updated config
  */
 export declare function hasColorMatchChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether the legend visibilty changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatLegendConfigChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether the gradient rules changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasGradientRulesChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
 /**
  * Compares the 'slices' array from the pie series, and indicates whether they are different.
  * Compare only the slices id and label to avoid false positives.
@@ -221,7 +244,7 @@ declare function hasQueryChanged(props: {
     behaviorAfterLimit?: LimitBehavior;
 }): boolean;
 declare function hasFilterBySelectionChanged(filterBySelection?: boolean, options?: ChartOptions): boolean;
-declare function hasDataForFilterBySelectionChanged(props: {
+export declare function hasDataForFilterBySelectionChanged(props: {
     currentSelectionOIDs?: number[];
     options?: ChartOptions;
 }): boolean;
@@ -369,7 +392,7 @@ export declare const commonUtilsMiscPrivateFunctions: {
     hasGaugeValueConversionChanged: typeof hasGaugeValueConversionChanged;
     isNewDataRequiredForValueFormatChange: typeof isNewDataRequiredForValueFormatChange;
     hasShowMeanChanged: typeof hasShowMeanChanged;
-    hasDataForFilterBySelectionChanged: typeof hasDataForFilterBySelectionChanged;
+    hasHeatChartBinningChanged: typeof hasHeatChartBinningChanged;
     hasQueryChanged: typeof hasQueryChanged;
     isValidPercentValue: typeof isValidPercentValue;
 };

package/dist/chart-rendering/common/data/utils/misc/interfaces.d.ts

@@ -21,4 +21,7 @@ export interface DataUpdateNeededDetails {
     boxPlot: {
         showMeanChanged: boolean;
     };
+    heatChart: {
+        binningChanged: boolean;
+    };
 }

package/dist/chart-rendering/common/data/utils/query-parser/index.d.ts

@@ -1,4 +1,4 @@
-import { TimeIntervalInfo, WebBoxPlot, WebChart, WebChartQuery, WebChartTemporalBinningTypes } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebBoxPlot, WebChart, WebChartQuery } from '../../../../../spec';
 import { QueryObject, ChartSubType } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
 import { UniqueQuery } from './interfaces';
@@ -18,8 +18,8 @@ import { UniqueQuery } from './interfaces';
  * @param props.queryObject  The query object (layer or feature layer view)
  * @param props.chartSubType The chart sub type
  * @param props.isTimeBinningSeries Whether the chart is using time binning
- * @param props.temporalBinningType The temporal binning type
  * @param props.returnFeaturesExtent Whether the features extent need to be fetched by the query
+ * @param props.splitByField The split-by field
  */
 declare function modifyOutStatistics(props: {
     uniqueQuery: WebChartQuery;
@@ -28,8 +28,8 @@ declare function modifyOutStatistics(props: {
     queryObject?: QueryObject;
     chartSubType: ChartSubType;
     isTimeBinningSeries: boolean;
-    temporalBinningType?: WebChartTemporalBinningTypes;
     returnFeaturesExtent?: boolean;
+    splitByField?: string;
 }): void;
 /**
  * Handles the limitation of features on the chart (when the chart limits are reached but the requested behavior is to render up to the limit).

package/dist/chart-rendering/common/data/utils/query-parser/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { WebChartQuery, IStatisticDefinition } from '@arcgis/charts-spec';
+import { WebChartQuery, IStatisticDefinition } from '../../../../../spec';
 export interface UniqueQuery {
     uniqueQuery: WebChartQuery;
     mapToStatField: Map<number | string | null, string>;

package/dist/chart-rendering/common/data/utils/query-parser/time-binning/index.d.ts

@@ -1,2 +1,2 @@
-import { WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { WebChartTemporalBinningUnits } from '../../../../../../spec';
 export declare function getTimeBinGroupByFieldsForStatistics(dateFieldName: string, unit: WebChartTemporalBinningUnits): string[];

package/dist/chart-rendering/common/data/utils/query-utils/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartDataItemValue } from '@arcgis/charts-spec';
+import { WebChartDataItemValue } from '../../../../../spec';
 /**
  * Transform a couple key/value to where clause equivalent to 'key = value'.
  * It adds quotes around the value if it's not detected as a number.

package/dist/chart-rendering/common/data/utils/selection/index.d.ts

@@ -1,13 +1,6 @@
-import { WebChart, WebChartDataItem, WebChartDataTypes, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem, WebChartDataTypes, WebChartQuery } from '../../../../../spec';
 import { ErrorStrings, QueryObject } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
-/**
- * Builds a where clause following the pattern `<OID field> in (<list_of_OIDs>)`
- *
- * @param fieldOID
- * @param listOIDs
- */
-export declare function joinOIDs(fieldOID: string, listOIDs?: number[]): string | undefined;
 /**
  * Fetches data from a list of OIDs. If the chart is non aggregated we directly read the OIDs stored in the data context,
  * and if the chart is aggregated we perform queries to fetch the data.

package/dist/chart-rendering/common/data/utils/summarize-data/index.d.ts

@@ -1,7 +1,7 @@
-import { IExtent, IField, IStatisticDefinition, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataItem, WebChartDataItemValue, WebChartLineChartSeries, WebChartPieChartSeries, WebChartQuery, WebChartSeriesType } from '@arcgis/charts-spec';
 import { default as Graphic } from '@arcgis/core/Graphic';
+import { IExtent, IField, IStatisticDefinition, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCalendarDatePartsUnits, WebChartDataItem, WebChartDataItemValue, WebChartLineChartSeries, WebChartPieChartSeries, WebChartQuery, WebChartSeriesType } from '../../../../../spec';
 import { DataInfo, QueryObject, ChartSubType, LimitBehavior } from '../../../../../utils';
-import { FetchDataProps } from '../../../interfaces';
+import { ChartOptions, FetchDataProps } from '../../../interfaces';
 import { ProcessUniqueQueryProps } from './interfaces';
 /**
  * Returns the feature extent and the extent key for a feature.
@@ -11,7 +11,7 @@ import { ProcessUniqueQueryProps } from './interfaces';
  * @param props.chartSubType The chart subtype
  * @returns
  */
-declare function getFeatureGeometryExtent(props: {
+export declare function getFeatureGeometryExtent(props: {
     feature: Graphic;
     splitByField?: string;
     chartSubType?: ChartSubType;
@@ -192,12 +192,29 @@ export declare function sortFetchedData(props: {
  * @param props
  */
 export declare function fetchFinishedGenericChartData(props: FetchDataProps): Promise<DataInfo>;
+/**
+ * Generates an array of values based on the given unit
+ * @param unit The unit used to generate the values to return
+ * @returns an array of string values, from "1" to the maximum value of the unit (e.g. "12" for MonthOfYear)
+ */
+declare function getExpectedValuesFromDatePartsUnit(unit: WebChartCalendarDatePartsUnits): string[] | undefined;
 /**
  * Fetching the data for a heat chart.
  * It fetches the data from the attribute bins and processes it to match the heat chart data structure.
  * @param props The list of properties required to fetch the data
  */
 export declare function fetchFinishedHeatChartData(props: FetchDataProps): Promise<DataInfo>;
+/**
+ * Function trimming the temporal dataset by considering the rendering limits.
+ * @param props.chartConfig The chart's config
+ * @param props.options The chart's options
+ * @param props.data The data to trim
+ */
+declare function trimTemporalDataset(props: {
+    chartConfig: WebChart;
+    options?: ChartOptions;
+    data: WebChartDataItem[];
+}): WebChartDataItem[];
 /**
  * Fetching the data for specifically a line chart using time binning options.
  *
@@ -234,5 +251,7 @@ export declare const commonUtilsSummarizeDataPrivateFunctions: {
     renameYFieldForSplitByNoAggregation: typeof renameYFieldForSplitByNoAggregation;
     trimCategories: typeof trimCategories;
     limitCategories: typeof limitCategories;
+    getExpectedValuesFromDatePartsUnit: typeof getExpectedValuesFromDatePartsUnit;
+    trimTemporalDataset: typeof trimTemporalDataset;
 };
 export {};

package/dist/chart-rendering/common/data/utils/summarize-data/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { WebChartDataItemValue, WebChartDataItem, WebChartQuery, WebChart, IStatisticDefinition } from '@arcgis/charts-spec';
+import { WebChartDataItemValue, WebChartDataItem, WebChartQuery, WebChart, IStatisticDefinition } from '../../../../../spec';
 import { QueryObject, AbortControllerKeyType, ChartElementLimit, ChartSubType } from '../../../../../utils';
 export interface SummarizeDataProps {
     data: [WebChartDataItemValue, WebChartDataItem[]][];

package/dist/chart-rendering/common/data/utils/summarize-data/time-binning/index.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { TimeIntervalInfo, WebChart, WebChartDataItem, WebChartQuery, WebChartSeriesType, WebChartNullPolicyTypes, WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChart, WebChartDataItem, WebChartQuery, WebChartSeriesType, WebChartNullPolicyTypes, WebChartTemporalBinningUnits } from '../../../../../../spec';
 import { DateRange, QueryObject, TimeBinningStatistics, WebChartSeriesSupportingTemporalBinning } from '../../../../../../utils';
 /**
  * Given `getNumberOfBinsWithinDataRange()` returns a diff in days for weeks, months and years, we need
@@ -25,6 +25,7 @@ export declare function getTimeBinningStatistics(props: {
 }): Promise<TimeBinningStatistics>;
 /**
  * Maps query results into a WebChartDataItem[] for a chart using the charts solution for temporal binning.
+ * @param props.chartConfig The chart configuration
  * @param props.queryResults The query results
  * @param props.mapToStatField The map of unique values to stat fields
  * @param props.splitByField The split-by field
@@ -34,6 +35,7 @@ export declare function getTimeBinningStatistics(props: {
  * @param props.queryObject The query object used to fetch the data
  */
 export declare function mapTemporalBinningQueryAttributeBinsResults(props: {
+    chartConfig: WebChart;
     queryResults: __esri.AttributeBinsGraphic[];
     mapToStatField: Map<number | string | null, string>;
     splitByField?: string;

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

@@ -1,4 +1,4 @@
-import { Color, ISimpleFillSymbol, WebChartCursorCrosshair, WebChartDataItem, WebChartPieChartGroupSlice, RESTHorizontalAlignment, RESTSimpleMarkerSymbolStyle, RESTVerticalAlignment, WebChartLegendPositions, WebChartLineSmoothedKinds, WebChartSortOrderKinds, WebChartStackedKinds } from '@arcgis/charts-spec';
+import { Color, ISimpleFillSymbol, WebChartCursorCrosshair, WebChartDataItem, WebChartNullCategory, WebChartPieChartGroupSlice, RESTHorizontalAlignment, RESTSimpleMarkerSymbolStyle, RESTVerticalAlignment, WebChartLegendPositions, WebChartLineSmoothedKinds, WebChartSortOrderKinds, WebChartStackedKinds } from '../../../spec';
 import { SelectionTheme, ActionModes } from '../../../utils';
 import { EsriColor } from '../types';
 export interface GaugeNeedleDefaults {
@@ -159,6 +159,7 @@ export interface CommonChartDefaults {
     seriesSort: Readonly<WebChartSortOrderKinds>;
     technicalSortingFieldBySum: string;
     technicalSortingFieldByPercent: string;
+    technicalFieldSplitByField: string;
     color: Readonly<EsriColor>;
     dataTooltipVisible?: boolean;
     dataTooltipStyle?: Readonly<Partial<ISimpleFillSymbol>>;
@@ -296,6 +297,13 @@ export interface CommonChartDefaults {
         /** represents default value to use for when `replaceNoValueCategoryWithZero` is not defined in the `options` object. */
         replaceNoValueCategoryWithZero: boolean;
     };
+    /**
+     * Specifies how to display the category with null value
+     * Setting this property will ensure that the item with no data is displayed on the chart with the specified text and color.
+     */
+    nullCategory: WebChartNullCategory;
+    /** gray color used for various purposes */
+    grayColor: EsriColor;
 }
 /**
  * A nested dictionary which contains default values for cases when a property is undefined.

package/dist/chart-rendering/common/error-utils/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartTypes } from '../../../spec';
 import { ChartElementLimit, DataInfo, DataWarningObject, ErrorStrings, QueryObject, DataWarningKeywords } from '../../../utils';
 interface DataLimitSubError {
     outlierLimit?: boolean;

package/dist/chart-rendering/common/events/index.d.ts

@@ -1,5 +1,5 @@
+import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChart, WebChartDataItem, WebChartDataTypes, WebChartSeriesType } from '../../../spec';
 import { DataWarningObject, PieSlicesSymbols, SelectionData, SeriesSymbolsMap, ValidationStatus } from '../../../utils';
-import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChart, WebChartDataItem, WebChartDataTypes, WebChartSeriesType } from '@arcgis/charts-spec';
 /**
  * Sending an event carrying the chart processed data at any data update.
  * Contains the statistics for Histogram and Scatterplot

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

@@ -1,7 +1,7 @@
-import { IField, SupportedLayer, WebBoxPlot, WebChart, WebChartDataFilters, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartPieChartSlice, WebChartQuery, WebGaugeChart } from '@arcgis/charts-spec';
 import { default as MapView } from '@arcgis/core/views/MapView';
 import { default as SceneView } from '@arcgis/core/views/SceneView';
 import { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { IField, SupportedLayer, WebBoxPlot, WebChart, WebChartDataFilters, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartPieChartSlice, WebChartQuery, WebGaugeChart } from '../../spec';
 import { AbortControllerKeyType, ActionModes, BinnedServerData, ChartElementLimit, CursorRange, ErrorStrings, LoaderColors, QueryObject, SelectionData, SelectionTheme, UtilsStrings } from '../../utils';
 export declare const uuidNamespace: string;
 export interface NotifyOptions {
@@ -45,6 +45,7 @@ export interface FetchDataProps {
      * only fetch the average (mean) statistic.
      */
     fetchFullBoxPlotData?: boolean;
+    completeHeatChartDataset?: boolean;
     fieldList?: IField[];
 }
 export interface UpdateChartElementsProps {
@@ -77,6 +78,7 @@ export interface ChartInstance {
     setActionMode: (actionMode?: ActionModes, cursorRange?: CursorRange) => void;
     exportImage: (exportProps: ExportChartImageOptions) => Promise<File>;
 }
+export type HeatChartLabelFormatCallback = (statValue: number, x?: number | string, y?: number | string) => string;
 /** Describes the signature of the callback function used to customize the pie chart data labels and tooltips */
 export type PieChartLabelFormatCallback = (category: string, value?: number, percent?: number, originalCategory?: WebChartDataItemValue) => string;
 /** Describes the signature of the callback function used to customize the pie chart legend value labels. */
@@ -84,7 +86,7 @@ export type PieChartLegendValueLabelFormatCallback = (value?: number, percent?:
 /** Describes the signature of the callback function used to customize the histogram tooltips */
 export type HistogramLabelFormatCallback = (count: number, binMinValue: number, binMaxValue: number) => string;
 /** Describes the signature of the callback function used to customize the scatterplot tooltips */
-export type ScatterplotLabelFormatCallback = (x: number, y: number, sizePolicyValue?: number) => string;
+export type ScatterplotLabelFormatCallback = (x: number, y: number, sizePolicyValue?: number, dataContext?: WebChartDataItem) => string;
 export interface BarAndLineTooltipFormatCallbackProps {
     seriesName: string;
     statValue?: number;
@@ -105,6 +107,8 @@ export interface BoxPlotTooltipFormatCallbackProps {
 export type BoxPlotTooltipFormatCallback = (props: BoxPlotTooltipFormatCallbackProps) => string;
 /** Describes the signature of the callback function used to customize the bar and line chart plot data labels */
 export type BarAndLineDataLabelFormatCallback = (statValue: number, percent?: number) => string;
+/** Describes the signature of the callback function used to customize the heat chart data labels */
+export type HeatChartDataLabelFormatCallback = (statValue: number, x?: string, y?: string) => string;
 export interface GuideTooltipFormatCallbackProps {
     guideName: string;
     start: Date | number | string;
@@ -130,22 +134,14 @@ export type PreRenderCallback = (props: {
     data?: WebChartDataTypes;
     slices?: WebChartPieChartSlice[];
 }) => Promise<WebChart | WebGaugeChart>;
-/**
- * Represents options regarding the display of information about the chart.
- */
-export interface DisplaySettings {
+/** JSON representation of the runtime chart options for the update or initialization. */
+export interface ChartOptions {
     /**
-     * Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an
-     * axis when the data contains values <= 0).
+     * Whether to allow the object id to be used as a statistic other than COUNT.
      *
-     * @default true
+     * @default false
      */
-    showUIMessages?: boolean;
-}
-/**
- * Represents options regarding the data query for the chart.
- */
-export interface QuerySettings {
+    allowUsingObjectIdStat?: boolean;
     /**
      * Whether to consider a `null` statistic as valid. If set to `false` and the data has only
      * null values, the chart's dataset will be considered empty:
@@ -155,23 +151,13 @@ export interface QuerySettings {
      * @default false
      */
     nullAsValid?: boolean;
-}
-/** JSON representation of the runtime chart options for the update or initialization. */
-export interface ChartOptions {
     /**
-     * Whether to allow the object id to be used as a statistic other than COUNT.
+     * Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an
+     * axis when the data contains values <= 0).
      *
-     * @default false
-     */
-    allowUsingObjectIdStat?: boolean;
-    /**
-     * Represents options regarding the display of information about the chart.
-     */
-    displaySettings?: DisplaySettings;
-    /**
-     * Represents query options to retrieve data for the chart.
+     * @default true
      */
-    querySettings?: QuerySettings;
+    showUIMessages?: boolean;
     /**
      * A property representing the selection to apply on the chart.
      * The properties are considered in the following order:

package/dist/chart-rendering/common/label/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartTextSymbol, WebChartLabelBehavior } from '@arcgis/charts-spec';
+import { WebChartTextSymbol, WebChartLabelBehavior } from '../../../spec';
 import { LabelProperties } from '../defaults/interfaces';
 import { AxisLabelFormatCallback } from '../interfaces';
 /**

package/dist/chart-rendering/common/math/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartBin } from '@arcgis/charts-spec';
+import { WebChartBin } from '../../../spec';
 import { NormalDistributionProps } from './interfaces';
 /**
  * Function Definition: https://js.tensorflow.org/api/0.6.1/#linspace

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

@@ -1,6 +1,6 @@
 import { ActionModes, BinnedServerData, QueryObject, SelectionIndexes } from '../../../utils';
-import { IField, OverlayTerms, ScatterplotTrendLineData, TimeIntervalInfo, WebChart, WebChartDataItem, WebChartLabelBehavior, WebChartQuery, WebChartStackedKinds, WebChartTypes } from '@arcgis/charts-spec';
-import { AxisLabelFormatCallback, BarAndLineDataLabelFormatCallback, BarAndLineTooltipFormatCallback, BoxPlotTooltipFormatCallback, ChartOptions, GuideTooltipFormatCallback, HistogramLabelFormatCallback, PieChartLabelFormatCallback, PieChartLegendValueLabelFormatCallback, ScatterplotLabelFormatCallback } from '../interfaces';
+import { IField, OverlayTerms, ScatterplotTrendLineData, TimeIntervalInfo, WebChart, WebChartDataItem, WebChartLabelBehavior, WebChartQuery, WebChartStackedKinds, WebChartTypes } from '../../../spec';
+import { AxisLabelFormatCallback, BarAndLineDataLabelFormatCallback, BarAndLineTooltipFormatCallback, BoxPlotTooltipFormatCallback, ChartOptions, GuideTooltipFormatCallback, HeatChartDataLabelFormatCallback, HeatChartLabelFormatCallback, HistogramLabelFormatCallback, PieChartLabelFormatCallback, PieChartLegendValueLabelFormatCallback, ScatterplotLabelFormatCallback } from '../interfaces';
 export interface CommonStorageType {
     legend: {
         pieChartLegendValueLabelsFormatter?: PieChartLegendValueLabelFormatCallback;
@@ -52,12 +52,14 @@ export interface CommonStorageType {
         barAndLineTooltipFormatter?: BarAndLineTooltipFormatCallback;
         barSeriesDataLabelFormatter?: BarAndLineDataLabelFormatCallback;
         lineSeriesDataLabelFormatter?: BarAndLineDataLabelFormatCallback;
+        heatChartDataLabelFormatter?: HeatChartDataLabelFormatCallback;
         scatterplotTooltipFormatter?: ScatterplotLabelFormatCallback;
         scatterplotDataLabelFormatter?: ScatterplotLabelFormatCallback;
         histogramTooltipFormatter?: HistogramLabelFormatCallback;
         histogramDataLabelFormatter?: HistogramLabelFormatCallback;
         pieChartDataLabelFormatter?: PieChartLabelFormatCallback;
         pieChartTooltipFormatter?: PieChartLabelFormatCallback;
+        heatChartTooltipFormatter?: HeatChartLabelFormatCallback;
         boxPlotTooltipFormatter?: BoxPlotTooltipFormatCallback;
     };
     axis: {

package/dist/chart-rendering/common/modal/index.d.ts

@@ -0,0 +1,11 @@
+import { LoaderColors } from '../../../utils';
+/**
+ * Computes the colors the chart's modal should use (background and text) from the loader colors when provided,
+ * or the chart defaults otherwise.
+ * @param loaderColors The loader colors`
+ * @returns String values representing the CSS colors (rgba) for the modal background and text.
+ */
+export declare function getModalColors(loaderColors?: LoaderColors): {
+    textCSSColor: string;
+    backgroundCSSColor: string;
+};

package/dist/chart-rendering/common/selection/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartBin, WebChartDataItem, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartBin, WebChartDataItem, WebChartTypes } from '../../../spec';
 import { ChartSubType } from '../../../utils';
 import { ChartOptions } from '../interfaces';
 /**
@@ -48,6 +48,7 @@ export declare function isElementPartOfSelection(props: {
     elementDataContext?: WebChartBin | WebChartDataItem;
     selectionDataItems: WebChartDataItem[];
     chartType?: WebChartTypes;
+    splitBy?: string;
     chartSubType?: ChartSubType;
     layerOidField?: string;
     xAxisField?: string;

package/dist/chart-rendering/common/series/box-plot/index.d.ts

@@ -1,5 +1,5 @@
 import { ChartSubType } from '../../../../utils';
-import { WebChartDataItem, RESTRendererType } from '@arcgis/charts-spec';
+import { WebChartDataItem, RESTRendererType } from '../../../../spec';
 /**
  * Determines whether to set the whisker (step line series) with a default color. It is necessary as whiskers from a same series
  * can't use different colors, while their associated candle stick series can.

package/dist/chart-rendering/common/series/index.d.ts

@@ -1,5 +1,5 @@
 import { QueryObject, ChartSubType } from '../../../utils';
-import { WebBoxPlot, WebChart, WebChartDataItem, WebChartHistogramSeries, WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { WebBoxPlot, WebChart, WebChartDataItem, WebChartHistogramSeries, WebChartTemporalBinningUnits } from '../../../spec';
 import { EsriColor } from '../types';
 /**
  * Returns true if dataTransformationType changed

package/dist/chart-rendering/common/series/pie-chart/index.d.ts

@@ -1,5 +1,5 @@
 import { PieSlicesSymbols, UtilsStrings } from '../../../../utils';
-import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '@arcgis/charts-spec';
+import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '../../../../spec';
 /**
  * Generates an id for a slice from a non aggregated slice.
  * it will generate `arcgis-charts-slice-id-<object id>` or `arcgis-charts-slice-id-<slice index>`

package/dist/chart-rendering/common/series/pie-chart/slice-grouping/index.d.ts

@@ -1,5 +1,5 @@
 import { UtilsStrings } from '../../../../../utils';
-import { WebChartDataItem, WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { WebChartDataItem, WebChartPieChartSeries } from '../../../../../spec';
 export declare function getPieChartGroupOfSlicesData(props: {
     data: WebChartDataItem[];
     seriesConfig: WebChartPieChartSeries[];

package/dist/chart-rendering/common/tooltips/index.d.ts

@@ -1,5 +1,5 @@
 import { UtilsStrings } from '../../../utils';
-import { IField, WebChart } from '@arcgis/charts-spec';
+import { IField, WebChart } from '../../../spec';
 /**
  * Returns the primary text if not empty, the default text otherwise
  *
@@ -15,7 +15,7 @@ export declare function getTooltipHeadingText(defaultText: string, primaryText?:
  * @param props.fieldName The field name from the hovered bar/marker
  * @param props.commonStrings The common strings containing the localized text
  */
-export declare function getTooltipLabelForBarLineFromFields(props: {
+export declare function getTooltipLabelFromFields(props: {
     config: WebChart;
     fieldName?: string;
     utilsStrings: UtilsStrings;

package/dist/chart-rendering/common/types/index.d.ts

@@ -1 +1 @@
-export type { Color as EsriColor } from '@arcgis/charts-spec';
+export type { Color as EsriColor } from '../../../spec';

package/dist/chart-rendering/next/chart-library-elements/axes/gauge/index.d.ts

@@ -1,6 +1,6 @@
 import { RadarChart } from '@amcharts/amcharts5/radar.js';
 import { ErrorStrings } from '../../../../../utils';
-import { WebChart } from '@arcgis/charts-spec';
+import { WebChart } from '../../../../../spec';
 import { UpdateGaugeAxisProps } from './interfaces';
 /**
  * Updates the gauge axis

package/dist/chart-rendering/next/chart-library-elements/axes/gauge/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { RadarChart } from '@amcharts/amcharts5/radar.js';
-import { WebGaugeChart } from '@arcgis/charts-spec';
+import { WebGaugeChart } from '../../../../../spec';
 import { GaugeInnerLabelFormatCallback } from '../../../../common/interfaces';
 import { UpdateAxesCommonProps } from '../../../interfaces';
 export interface UpdateGaugeAxisProps extends UpdateAxesCommonProps<RadarChart, WebGaugeChart> {

package/dist/chart-rendering/next/chart-library-elements/axes/histogram/index.d.ts

@@ -1,5 +1,5 @@
 import { XYChart } from '@amcharts/amcharts5/xy.js';
-import { WebChart, WebChartDataTypes } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataTypes } from '../../../../../spec';
 import { ErrorStrings, UtilsStrings } from '../../../../../utils';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../../common/interfaces';
 /**

package/dist/chart-rendering/next/chart-library-elements/axes/index.d.ts

@@ -2,7 +2,7 @@ import { Root } from '@amcharts/amcharts5';
 import { List } from '@amcharts/amcharts5/.internal/core/util/List.js';
 import { AxisRendererCircular, AxisRendererRadial } from '@amcharts/amcharts5/radar.js';
 import { Axis, AxisRenderer, XYChart, AxisRendererX, AxisRendererY } from '@amcharts/amcharts5/xy.js';
-import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes, WebChartLabelBehavior, WebChartTypes } from '../../../../spec';
 import { ErrorStrings, UtilsStrings } from '../../../../utils';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../common/interfaces';
 import { UpdateAxesProps } from '../../interfaces';

package/dist/chart-rendering/next/chart-library-elements/axes/utils/axis-format/category-axis/index.d.ts

@@ -1,5 +1,5 @@
 import { XYChart } from '@amcharts/amcharts5/xy.js';
-import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions } from '../../../../../../../spec';
 import { AxisLabelFormatCallback } from '../../../../../../common/interfaces';
 /**
  * Generates the default label formatter for the category axis
@@ -13,3 +13,15 @@ export declare function generateDefaultCategoryAxisFormatter(props: {
     formatOptions: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
     isNonAggregatedChart?: boolean;
 }): AxisLabelFormatCallback;
+/**
+ * Generates the default label formatter for the category axis labels for heat charts.
+ *
+ * @param props.chart The chart
+ * @param props.isXAxis Whether the formatter is for the x-axis or y-axis
+ * @param props.formatOptions The format options
+ */
+export declare function generateDefaultCategoryAxisFormatterForHeatChart(props: {
+    chart: XYChart;
+    isXAxis?: boolean;
+    formatOptions: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
+}): AxisLabelFormatCallback;

package/dist/chart-rendering/next/chart-library-elements/axes/utils/axis-format/date-axis/index.d.ts

@@ -1,6 +1,6 @@
 import { Chart } from '@amcharts/amcharts5';
 import { AxisRenderer, DateAxis } from '@amcharts/amcharts5/xy.js';
-import { DateTimeFormatOptions } from '@arcgis/charts-spec';
+import { DateTimeFormatOptions } from '../../../../../../../spec';
 /**
  * Returns true if the input chart is a XYChart and uses a date axis
  * @param chart The instance of chart to be tested