@arcgis/charts-components 4.34.0-next.15 → 4.34.0-next.150

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
@@ -10,7 +10,7 @@ import { UpdateGaugeAxisProps } from './interfaces';
  * @param props.data The chart data
  * @param props.queryObject The query object (layer or layer view)
  * @param props.xAxisLabelFormatter The external formatter for the axis labels
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function updateGaugeAxis(props: UpdateGaugeAxisProps): Promise<void>;

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,6 +1,6 @@
 import { XYChart } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings, ErrorStrings } from '../../../../../utils';
-import { WebChart, WebChartDataTypes } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataTypes } from '../../../../../spec';
+import { ErrorStrings, UtilsStrings } from '../../../../../utils';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../../common/interfaces';
 /**
  * Update the axes for an XYChart
@@ -11,7 +11,7 @@ import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../..
  * @param props.data The data to feed the axis
  * @param props.yAxisLabelFormatter The y-axis label formatter
  * @param props.guideTooltipFormatter The guide's tooltip formatter
- * @param props.commonStrings List of t9n strings
+ * @param props.utilsStrings List of t9n strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function updateHistogramAxes(props: {
@@ -21,7 +21,7 @@ export declare function updateHistogramAxes(props: {
     data?: WebChartDataTypes;
     yAxisLabelFormatter?: AxisLabelFormatCallback;
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**

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

@@ -2,8 +2,8 @@ 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 { CommonStrings, ErrorStrings } from '../../../../utils';
+import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes, WebChartLabelBehavior, WebChartTypes } from '../../../../spec';
+import { ErrorStrings, UtilsStrings } from '../../../../utils';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../common/interfaces';
 import { UpdateAxesProps } from '../../interfaces';
 import { UpdateGaugeAxisProps } from './gauge/interfaces';
@@ -48,13 +48,6 @@ export declare function initializeAxis(props: {
     x: string;
     isAxisForHistogramOverlaySeries?: boolean;
 }): Axis<AxisRenderer> | undefined;
-/**
- * Assigns the data to the axis
- *
- * @param axis The axis to assign the data to
- * @param data The data to assign to the axis
- */
-export declare function updateAxisData(axis: Axis<AxisRenderer>, data?: WebChartDataTypes): void;
 /**
  * Updates an axis
  * props.chartConfig The chart's config
@@ -71,7 +64,7 @@ export declare function updateAxisData(axis: Axis<AxisRenderer>, data?: WebChart
  * @param props.isSecondValueAxis Whether the axis is the second value axis
  * @param props.externalAxisLabelFormatter The axis value formatter
  * @param props.guideTooltipFormatter The guide's tooltip formatter
- * @param props.commonStrings List of t9n strings
+ * @param props.utilsStrings List of t9n strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function updateAxis(props: {
@@ -88,7 +81,7 @@ export declare function updateAxis(props: {
     isSecondValueAxis?: boolean;
     externalAxisLabelFormatter?: AxisLabelFormatCallback;
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**

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,6 +1,6 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
+import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '../../../../../../spec';
 import { ErrorStrings } from '../../../../../../utils';
-import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '@arcgis/charts-spec';
 import { AxisLabelFormatCallback } from '../../../../../common/interfaces';
 /**
  * Checks whether the WebChartAxis valueFormat is in sync with the amCharts Axis' instance type

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.
  *
@@ -34,6 +34,13 @@ export declare function isHorizontalAxis(axisRenderer: AxisRenderer): boolean;
  * @param axisRenderer The renderer associated with the axis to check for.
  */
 export declare function isVerticalAxis(axisRenderer: AxisRenderer): boolean;
+/**
+ * Determines whether the chart with stacked series contains negative values.
+ *
+ * @param chart The chart
+ * @returns boolean indicating if the chart data has negative values; true if it does, false otherwise
+ */
+declare function isStackedSeriesWithNegativeValues(chart: XYChart): boolean;
 /**
  * Indicates whether the log scale is compatible with the data.
  *
@@ -98,6 +105,12 @@ export declare function updateBaseInterval(props: {
     timeIntervalInfo?: TimeIntervalInfo;
     dateBaseInterval?: TimeIntervalInfo;
 }): void;
+/**
+ * For log axis, we want to round the min or max of an axis either up or down to the nearest power of 10
+ * @param props.num The number
+ * @param props.isRoundUp If we should round up or down
+ */
+export declare function roundToNearestPowerOf10(num: number | null | undefined, isRoundUp: boolean): number | null | undefined;
 /**
  * Update chart's axes using either chart config's min/max or the min/max from data.
  *
@@ -151,3 +164,7 @@ export declare function disableAxisGhostLabel(axis: Axis<AxisRenderer>): void;
  * @param chart The chart
  */
 export declare function resetZoomToFullExtent(chart: SerialChart): void;
+export declare const nextUtilsAxisRendererPrivateFunctions: {
+    isStackedSeriesWithNegativeValues: typeof isStackedSeriesWithNegativeValues;
+};
+export {};

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 { CommonStrings } from '../../../../utils';
-import { WebChartGuide } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../../utils';
+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
@@ -20,12 +20,12 @@ export declare function getGuideValuesFromConfig<T extends Axis<AxisRenderer>>(a
  * @param props.anyGuideAboveChanged Whether any guide's above property was changed
  * @param props.guideConfigs The guides config
  * @param props.guideTooltipFormatter The guide tooltip formatter
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  */
 export declare function updateAxisGuides<T extends Axis<AxisRenderer>>(props: {
     axis: T;
     anyGuideAboveChanged?: boolean;
     guideConfigs?: WebChartGuide[];
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): void;

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,7 +1,7 @@
 import { Label } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
+import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '../../../../../spec';
 import { ChartTypes } from '../../../../../utils';
-import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
 /**
  * Updates the axis min grid distance. It represents the minimum distance in pixels between the grid elements
  * and its labels.

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,15 +11,16 @@ export interface DefaultDataLabelFormatterProps {
 }
 export interface DataLabelUpdateProps {
     series: XYSeries;
-    seriesConfig: WebChartBarChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
+    seriesConfig: WebChartBarChartSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
     dataLabel?: Label;
     seriesType: WebChartTypes;
     labelDefaults?: LabelProperties;
     isRotated?: boolean;
     stackedType?: WebChartStackedKinds;
     dataLabelsConfig?: WebChartText | undefined;
+    autoInverseDataLabelTextColor?: boolean;
     yAxisValueFormat?: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
     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,7 +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 { DataLabelUpdateProps } from './interfaces';
+import { WebChartTypes } from '../../../../../spec';
+import { AmChartsColor } from '../../../types';
+import { DataLabelFormatter, DataLabelUpdateProps, DefaultDataLabelFormatterProps } from './interfaces';
+interface finalizeBarLineAndHeatChartDataLabelsProps extends DataLabelUpdateProps {
+    isHeatChart?: boolean;
+    dataLabelFormatter: (props: DefaultDataLabelFormatterProps) => DataLabelFormatter;
+}
 /**
  * determine if label is outside the charting area
  *
@@ -27,6 +32,33 @@ export declare function initializeBarLineSeriesDataLabel(props: DataLabelUpdateP
  * @param index Index of what series bullets should be removed
  */
 export declare function removeSeriesDataLabel(series: XYSeries, index?: number): void;
+/**
+ * Gets the best inverse color to use for the data label text based on the background color of the text.
+ * If the chart background color is contrasting enough with the text background color, it will be used as the text color.
+ * Otherwise, either black or white will be used based on the lightness of the text background color.
+ *
+ * @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.
+ * @returns The best inverse color to use for the data label text
+ */
+export declare function getContrastTextColor(textBackgroundColor: AmChartsColor, chartBackgroundColor: AmChartsColor): 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
@@ -41,9 +73,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
  *
@@ -33,10 +49,14 @@ export declare function initializeLegend(chart: SerialChart, seriesConfig: WebCh
  * @param props.chartConfig The chart config
  * @param props.legend The legend
  * @param props.hideEmptySeries Whether to hide the series in the legend if the data item is empty or invalid
+ * @param props.seriesConfig The series config
  */
 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

@@ -0,0 +1,11 @@
+import { WebChart, WebChartLegend } from '../../../../spec';
+import { PieChartLegendValueLabelFormatCallback } from '../../../common/interfaces';
+import { Legend, SerialChart } from '@amcharts/amcharts5';
+export interface UpdateLegendProps {
+    legend: Legend;
+    chart?: SerialChart;
+    seriesConfig: WebChart["series"];
+    webChartLegend?: WebChartLegend;
+    disableTogglingLegendItems?: boolean;
+    pieChartLegendValueLabelFormatter?: PieChartLegendValueLabelFormatCallback;
+}

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

@@ -0,0 +1,23 @@
+import { WebChartPieChartLegend, WebChartSeriesType, WebChartLegendPositions } from '../../../../../spec';
+import { UpdateLegendProps } from '../interfaces';
+import { PieChart } from '@amcharts/amcharts5/percent';
+import { Legend } from '@amcharts/amcharts5';
+/**
+ * Initializes the pie chart legend value labels.
+ * @param legend The legend
+ * @param chart The chart
+ */
+export declare function initializePieChartLegendValueLabel(legend: Legend): void;
+/**
+ * Updates the pie chart legend value labels style and content.
+ * Updates the formatter used by the html adapter set on the labels.
+ * @param props
+ */
+export declare function updatePieChartLegendValueLabel(props: UpdateLegendProps): void;
+export declare function updatePieLegendCategoryLabel(legend: Legend, legendPosition: WebChartLegendPositions): void;
+export declare function updatePieChartLegend(props: {
+    legend: Legend;
+    chart: PieChart;
+    seriesConfig: WebChartSeriesType[];
+    legendConfig: WebChartPieChartLegend;
+}): void;

package/dist/chart-rendering/next/chart-library-elements/line-fill-marker/index.d.ts

@@ -2,7 +2,7 @@ import { Graphics, RoundedRectangle, Sprite, Template } from '@amcharts/amcharts
 import { State } from '@amcharts/amcharts5/.internal/core/util/States.js';
 import { TemplateState } from '@amcharts/amcharts5/.internal/core/util/Template.js';
 import { SelectionThemeProperties } from '../../../../utils';
-import { ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol } from '@arcgis/charts-spec';
+import { ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol } from '../../../../spec';
 import { MappedFillSymbol, MappedLineSymbol, MappedMarkerSymbol } from '../symbols/interfaces';
 import { FillElementsProps, LineElementsProps, MarkerElementsProps, UpdateSymbolProps } from './interfaces';
 export declare function setOutlineProperties(element: Graphics | Sprite | Template<Graphics>, outline: MappedLineSymbol): void;

package/dist/chart-rendering/next/chart-library-elements/line-fill-marker/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { Graphics, Root, Sprite, Template } from '@amcharts/amcharts5';
-import { IRendererSymbol, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, WebChartSeriesType } from '@arcgis/charts-spec';
+import { IRendererSymbol, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, WebChartSeriesType } from '../../../../spec';
 interface ElementsProps {
     element?: Graphics | Sprite | Template<Graphics>;
     visible?: boolean;
@@ -29,5 +29,6 @@ export interface UpdateSymbolProps<T extends ISimpleFillSymbol | ISimpleLineSymb
     y?: string;
     isChartFillSymbol?: boolean;
     keepCurrentVisibility?: boolean;
+    preferSeriesSymbolOverRendererSymbol?: boolean;
 }
 export {};

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

@@ -1,4 +1,4 @@
-import { Chart, Root } from '@amcharts/amcharts5';
+import { Chart, Modal, Root, SerialChart } from '@amcharts/amcharts5';
 import { ChartOptions } from '../../../common/interfaces';
 import { LoaderHandle } from './interfaces';
 /**
@@ -14,6 +14,17 @@ export declare function initializeLoader(props: {
     chart: Chart;
     options?: ChartOptions;
 }): LoaderHandle;
+/**
+ * Applies to the loader colors to the loading curtain, spinner and chart modal.
+ * @param props.chart The chart
+ * @param props.updateOptions Update options
+ * @param props.chartModal The chart's modal
+ */
+export declare function applyLoaderColors(props: {
+    chart: SerialChart;
+    updateOptions?: ChartOptions;
+    chartModal?: Modal;
+}): void;
 /**
  * Hides the loader when the chart is done rendering
  *

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

@@ -1,5 +1,5 @@
 import { Chart } from '@amcharts/amcharts5';
-import { WebChartAxisScrollBar } from '@arcgis/charts-spec';
+import { WebChartAxisScrollBar } from '../../../../spec';
 /**
  * Initializes the scrollbars for the chart
  *