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

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 { default as 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 { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '../../../../spec';
 import { PieSlicesSymbols, UtilsStrings } from '../../../../utils';
-import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '@arcgis/charts-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

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

@@ -1,5 +1,5 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '../../../../../../spec';
 import { ErrorStrings } from '../../../../../../utils';
 import { AxisLabelFormatCallback } from '../../../../../common/interfaces';
 /**

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

@@ -1,6 +1,6 @@
 import { Root, SerialChart, Series, Tooltip } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer, ValueAxis, XYChart } from '@amcharts/amcharts5/xy.js';
-import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes } from '../../../../../../spec';
 /**
  * Indicates whether the axes need to be recreated.
  *

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

@@ -1,8 +1,8 @@
 import { Chart, Root } from '@amcharts/amcharts5';
 import { RadarCursor } from '@amcharts/amcharts5/radar.js';
 import { XYCursor } from '@amcharts/amcharts5/xy.js';
+import { WebChart, WebChartCursorCrosshair } from '../../../../spec';
 import { CursorRange, ActionModes } from '../../../../utils';
-import { WebChart, WebChartCursorCrosshair } from '@arcgis/charts-spec';
 /**
  * Creates cursor on the chart if its compatible
  * Only for XYChart

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

@@ -1,6 +1,6 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
 import { UtilsStrings } from '../../../../utils';
-import { WebChartGuide } from '@arcgis/charts-spec';
+import { WebChartGuide } from '../../../../spec';
 import { GuideTooltipFormatCallback } from '../../../common/interfaces';
 /**
  * Retrieve the start and end values of the guide from the config. The process also tries to convert

package/dist/chart-rendering/next/chart-library-elements/header-and-footer/index.d.ts

@@ -1,5 +1,5 @@
 import { Chart, Root } from '@amcharts/amcharts5';
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 import { HeaderProps } from './interfaces';
 /**
  * Initializes the header container and its children

package/dist/chart-rendering/next/chart-library-elements/header-and-footer/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 export interface HeaderProps {
     title?: WebChartText;
     subtitle?: WebChartText;

package/dist/chart-rendering/next/chart-library-elements/labels/axis-label/index.d.ts

@@ -1,6 +1,6 @@
 import { Label } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '../../../../../spec';
 import { ChartTypes } from '../../../../../utils';
 /**
  * Updates the axis min grid distance. It represents the minimum distance in pixels between the grid elements

package/dist/chart-rendering/next/chart-library-elements/labels/data-label/heat-chart/index.d.ts

@@ -0,0 +1,13 @@
+import { DataLabelUpdateProps } from '../interfaces';
+/**
+ * initialize a series data labels
+ *
+ * @param props.DataLabelUpdateProps props to pass to initialize series data labels
+ */
+export declare function initializeHeatChartDataLabel(props: DataLabelUpdateProps): void;
+/**
+ * Updates a series data labels
+ *
+ * @param props props to pass to update series data labels
+ */
+export declare function updateHeatChartDataLabel(props: DataLabelUpdateProps): void;

package/dist/chart-rendering/next/chart-library-elements/labels/data-label/interfaces.d.ts

@@ -1,8 +1,8 @@
 import { Label, NumberFormatter } from '@amcharts/amcharts5';
 import { XYSeries } from '@amcharts/amcharts5/xy.js';
-import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartBarChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartBarChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartHeatChartSeries, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '../../../../../spec';
 import { LabelProperties } from '../../../../common/defaults/interfaces';
-import { BarAndLineDataLabelFormatCallback, HistogramLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../../common/interfaces';
+import { BarAndLineDataLabelFormatCallback, HeatChartDataLabelFormatCallback, HistogramLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../../common/interfaces';
 export interface DefaultDataLabelFormatterProps {
     numberFormatter: NumberFormatter;
     dataLabelsConfigContent: WebChartTextSymbol;
@@ -11,7 +11,7 @@ export interface DefaultDataLabelFormatterProps {
 }
 export interface DataLabelUpdateProps {
     series: XYSeries;
-    seriesConfig: WebChartBarChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
+    seriesConfig: WebChartBarChartSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
     dataLabel?: Label;
     seriesType: WebChartTypes;
     labelDefaults?: LabelProperties;
@@ -23,4 +23,4 @@ export interface DataLabelUpdateProps {
     defaultDataLabelFormatter?: (props: DefaultDataLabelFormatterProps) => DataLabelFormatter;
     externalDataLabelFormatter?: DataLabelFormatter;
 }
-export type DataLabelFormatter = BarAndLineDataLabelFormatCallback | HistogramLabelFormatCallback | ScatterplotLabelFormatCallback;
+export type DataLabelFormatter = BarAndLineDataLabelFormatCallback | HeatChartDataLabelFormatCallback | HistogramLabelFormatCallback | ScatterplotLabelFormatCallback;

package/dist/chart-rendering/next/chart-library-elements/labels/data-label/pie-chart/index.d.ts

@@ -1,5 +1,5 @@
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
-import { WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { WebChartPieChartSeries } from '../../../../../../spec';
 import { PieChartLabelFormatCallback } from '../../../../../common/interfaces';
 /**
  * Initializes default properties to a pie series data labels

package/dist/chart-rendering/next/chart-library-elements/labels/data-label/utils.d.ts

@@ -1,8 +1,12 @@
-import { Sprite } from '@amcharts/amcharts5';
+import { Sprite, Label } from '@amcharts/amcharts5';
 import { XYSeries, XYChart } from '@amcharts/amcharts5/xy.js';
-import { WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartTypes } from '../../../../../spec';
 import { AmChartsColor } from '../../../types';
-import { DataLabelUpdateProps } from './interfaces';
+import { DataLabelFormatter, DataLabelUpdateProps, DefaultDataLabelFormatterProps } from './interfaces';
+interface finalizeBarLineAndHeatChartDataLabelsProps extends DataLabelUpdateProps {
+    isHeatChart?: boolean;
+    dataLabelFormatter: (props: DefaultDataLabelFormatterProps) => DataLabelFormatter;
+}
 /**
  * determine if label is outside the charting area
  *
@@ -35,9 +39,31 @@ export declare function removeSeriesDataLabel(series: XYSeries, index?: number):
  *
  * @param textBackgroundColor The background color of the data label, it can be the color of the column or the series.
  * @param chartBackgroundColor The background color of the chart.
+ * @param fillOpacity The fill opactiy of the background of the data label
  * @returns The best inverse color to use for the data label text
  */
-export declare function getContrastTextColor(textBackgroundColor: AmChartsColor, chartBackgroundColor: AmChartsColor): AmChartsColor;
+export declare function getContrastTextColor(props: {
+    textBackgroundColor: AmChartsColor;
+    chartBackgroundColor: AmChartsColor;
+    fillOpacity?: number;
+}): AmChartsColor;
+/**
+ * Adds a color adapter to the data label to inverse the text color based on the series color and the chart background color.
+ *
+ * @param props.dataLabel The data label to add the adapter to
+ * @param props.labelConfigColor The color configured for the data label
+ * @param props.seriesColor The series color, used as a fallback for the text background color
+ * @param props.backgroundColor The chart background color, used as a fallback for the text background color
+ * @param props.autoInverseDataLabelTextColor If true, the text color will be inverted based on the series and chart background colors
+ */
+export declare function addDataLabelColorAdapter(props: {
+    dataLabel: Label;
+    labelConfigColor?: AmChartsColor;
+    seriesColor?: AmChartsColor;
+    backgroundColor?: AmChartsColor;
+    autoInverseDataLabelTextColor?: boolean;
+    isHeatChart?: boolean;
+}): void;
 /**
  * Generic function to update a series data labels.
  * This function contains common code for all the XY Charts. The specific code for each chart
@@ -52,9 +78,11 @@ export declare function updateDataLabel(props: DataLabelUpdateProps): void;
  * @param props.DataLabelUpdateProps props to pass to sets series data labels
  */
 export declare function setSeriesDataLabel(props: DataLabelUpdateProps): void;
+export declare function finalizeBarLineAndHeatChartDataLabels(props: finalizeBarLineAndHeatChartDataLabelsProps): void;
 /**
  * Updates a series data labels
  *
  * @param props props to pass to update series data labels
  */
 export declare function updateBarLineSeriesDataLabel(props: DataLabelUpdateProps): void;
+export {};

package/dist/chart-rendering/next/chart-library-elements/labels/guide-label/index.d.ts

@@ -1,7 +1,7 @@
 import { DataItem } from '@amcharts/amcharts5';
 import { AxisRendererCircular } from '@amcharts/amcharts5/radar.js';
 import { Axis, AxisRenderer, IAxisDataItem } from '@amcharts/amcharts5/xy.js';
-import { WebChartGuide, WebChartTextSymbol, RESTSymbolType } from '@arcgis/charts-spec';
+import { WebChartGuide, WebChartTextSymbol, RESTSymbolType } from '../../../../../spec';
 /**
  * Initializes a guide label
  *

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

@@ -1,5 +1,5 @@
 import { Container, Root, Template, Label } from '@amcharts/amcharts5';
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 import { LabelProperties } from '../../../common/defaults/interfaces';
 export declare function applyLabelDefaults(label: Label, defaults?: LabelProperties): void;
 /**
@@ -25,10 +25,12 @@ export declare function initializeLabel(props: {
  * @param labelConfig the config of the label
  * @param defaults default settings for label
  * @param skipSettingText skipSettingText in some cases, label text is set already so we can skip setting it
+ * @param skipSettingXAndY skip setting the x and y offsets and centering on certain labels that don't need it
  */
 export declare function updateLabel(props: {
     label: Label | Template<Label>;
     labelConfig?: WebChartText;
     defaults?: LabelProperties;
     skipSettingText?: boolean;
+    skipSettingXAndY?: boolean;
 }): void;

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

@@ -31,3 +31,49 @@ export declare function autoAdjustLabelDimension(props: {
     label: Label;
     labelType?: LabelType;
 }): void;
+/**
+ * Gets the formatted time string for a given hour and minute, supporting all Intl.DateTimeFormatOptions.
+ *
+ * @param props.hour The hour (0-23)
+ * @param props.minute The minute (0-59)
+ * @param props.format Intl.DateTimeFormatOptions for formatting
+ * @param props.locale The locale to use for formatting
+ * @returns For a valid input value, the function returns the formatted input string according to the provided format,
+ * or a string representation of the hour and minute if the format is not provided; otherwise, it returns the input value as a string.
+ */
+export declare function getHourOfDayString(props: {
+    hour: number;
+    minute?: number;
+    format?: Intl.DateTimeFormatOptions;
+    locale?: string;
+}): string;
+/**
+ * Gets the name of the weekday for a given weekday number, supporting all Intl.DateTimeFormatOptions.
+ *
+ * @param props weekdayNumber The weekday number (1-7)
+ * @param props.format Intl.DateTimeFormatOptions for formatting
+ * @param props.locale The locale to use for formatting
+ * @param props.firstDayOfWeek The first day of the week (1 = Monday, 7 = Sunday), defaults to 7 (Sunday).
+ * @returns For a valid input value, the function returns the formatted input string according to the provided format,
+ * or the weekday name (like Monday for example) if the format is not provided; otherwise, it returns the input value as a string.
+ */
+export declare function getWeekdayName(props: {
+    weekdayNumber: number;
+    format?: Intl.DateTimeFormatOptions;
+    locale?: string;
+    firstDayOfWeek?: number;
+}): string;
+/**
+ * Gets the name of the month for a given month number, supporting all Intl.DateTimeFormatOptions.
+ *
+ * @param props monthNumber The month number (1-12)
+ * @param props.format Intl.DateTimeFormatOptions for formatting
+ * @param props.locale The locale to use for formatting
+ * @returns For a valid input value, the function returns the formatted input string according to the provided format,
+ * or the month (like January for example) if the format is not provided; otherwise, it returns the input value as a string.
+ */
+export declare function getMonthName(props: {
+    monthNumber: number;
+    format?: Intl.DateTimeFormatOptions;
+    locale?: string;
+}): string;

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

@@ -0,0 +1,25 @@
+import { HeatLegend } from '@amcharts/amcharts5';
+import { WebChartSeriesType, WebChart } from '../../../../../spec';
+import { XYChart } from '@amcharts/amcharts5/xy.js';
+/**
+ * Initializes the legend
+ *
+ * @param chart The chart
+ */
+export declare function initializeHeatLegend(chart: XYChart): HeatLegend;
+/**
+ * Update the legend
+ *
+ * @param chart The chart
+ * @param chartConfig The chart config
+ * @param legend The legend
+ * @param hideEmptySeries if we should hide empty series
+ * @param seriesConfig The series config
+ */
+export declare function updateHeatChartLegend(props: {
+    chart: XYChart;
+    chartConfig: WebChart;
+    legend?: HeatLegend;
+    hideEmptySeries?: boolean;
+    seriesConfig: WebChartSeriesType[];
+}): void;

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

@@ -1,5 +1,5 @@
-import { Legend, SerialChart, Series } from '@amcharts/amcharts5';
-import { WebChart, WebChartSeriesType } from '@arcgis/charts-spec';
+import { HeatLegend, Legend, SerialChart, Series } from '@amcharts/amcharts5';
+import { WebChart, WebChartSeriesType } from '../../../../spec';
 /**
  * Assigns the appropriate label opacity to a chart's legend when there is a chart update
  *
@@ -25,7 +25,23 @@ export declare function updateLegendData(props: {
  *
  * @param chart The chart
  */
-export declare function initializeLegend(chart: SerialChart, seriesConfig: WebChartSeriesType[]): Legend;
+export declare function initializeLegend(props: {
+    chart: SerialChart;
+    seriesConfig?: WebChartSeriesType[];
+    isHeatChart?: boolean;
+}): HeatLegend | Legend;
+/**
+ * Sets the legend visibility
+ *
+ * @param props.chart The chart
+ * @param props.legend The legend
+ * @param props.showLegend Whether to show the legend
+ */
+export declare function setLegendVisibility(props: {
+    chart: SerialChart;
+    legend: HeatLegend | Legend;
+    showLegend: boolean;
+}): void;
 /**
  * Updates the legend
  *
@@ -38,7 +54,9 @@ export declare function initializeLegend(chart: SerialChart, seriesConfig: WebCh
 export declare function updateLegend(props: {
     chart: SerialChart;
     chartConfig: WebChart;
-    legend?: Legend;
+    legend?: HeatLegend | Legend;
     hideEmptySeries?: boolean;
     seriesConfig: WebChartSeriesType[];
+    isHeatChart?: boolean;
+    heatChartLegendUpdatedNeeded?: boolean;
 }): void;

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartLegend } from '@arcgis/charts-spec';
+import { WebChart, WebChartLegend } from '../../../../spec';
 import { PieChartLegendValueLabelFormatCallback } from '../../../common/interfaces';
 import { Legend, SerialChart } from '@amcharts/amcharts5';
 export interface UpdateLegendProps {