@arcgis/charts-components 4.34.0-next.10 → 4.34.0-next.101

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

@@ -1,4 +1,4 @@
-import { CommonStrings } from '../../../utils';
+import { UtilsStrings } from '../../../utils';
 import { IField, WebChart } from '@arcgis/charts-spec';
 /**
  * Returns the primary text if not empty, the default text otherwise
@@ -18,7 +18,7 @@ export declare function getTooltipHeadingText(defaultText: string, primaryText?:
 export declare function getTooltipLabelForBarLineFromFields(props: {
     config: WebChart;
     fieldName?: string;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): string;
 /**
  * The tooltip y label is the label associated to the y-axis. It can be the name of the field used by the axis, its alias,
@@ -32,5 +32,5 @@ export declare function getTooltipYLabel(props: {
     objectIdField: string;
     seriesIndex: number;
     isStacked100: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): string;

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

@@ -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/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 { 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

@@ -3,7 +3,7 @@ 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 { 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/index.d.ts

@@ -1,6 +1,6 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { ErrorStrings } from '../../../../../../utils';
 import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '@arcgis/charts-spec';
+import { ErrorStrings } from '../../../../../../utils';
 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

@@ -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/guides/index.d.ts

@@ -1,5 +1,5 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings } from '../../../../utils';
+import { UtilsStrings } from '../../../../utils';
 import { WebChartGuide } from '@arcgis/charts-spec';
 import { GuideTooltipFormatCallback } from '../../../common/interfaces';
 /**
@@ -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/labels/axis-label/index.d.ts

@@ -1,7 +1,7 @@
 import { Label } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { ChartTypes } from '../../../../../utils';
 import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
+import { ChartTypes } from '../../../../../utils';
 /**
  * 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/interfaces.d.ts

@@ -18,6 +18,7 @@ export interface DataLabelUpdateProps {
     isRotated?: boolean;
     stackedType?: WebChartStackedKinds;
     dataLabelsConfig?: WebChartText | undefined;
+    autoInverseDataLabelTextColor?: boolean;
     yAxisValueFormat?: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
     defaultDataLabelFormatter?: (props: DefaultDataLabelFormatterProps) => DataLabelFormatter;
     externalDataLabelFormatter?: DataLabelFormatter;

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

@@ -1,6 +1,7 @@
 import { Sprite } from '@amcharts/amcharts5';
 import { XYSeries, XYChart } from '@amcharts/amcharts5/xy.js';
 import { WebChartTypes } from '@arcgis/charts-spec';
+import { AmChartsColor } from '../../../types';
 import { DataLabelUpdateProps } from './interfaces';
 /**
  * determine if label is outside the charting area
@@ -27,6 +28,16 @@ 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;
 /**
  * Generic function to update a series data labels.
  * This function contains common code for all the XY Charts. The specific code for each chart

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

@@ -33,10 +33,12 @@ 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;
     hideEmptySeries?: boolean;
+    seriesConfig: WebChartSeriesType[];
 }): void;

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

@@ -0,0 +1,11 @@
+import { WebChart, WebChartLegend } from '@arcgis/charts-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,22 @@
+import { WebChartPieChartLegend, WebChartSeriesType } from '@arcgis/charts-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 updatePieChartLegend(props: {
+    legend: Legend;
+    chart: PieChart;
+    seriesConfig: WebChartSeriesType[];
+    legendConfig: WebChartPieChartLegend;
+}): void;

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, Root, SerialChart } from '@amcharts/amcharts5';
 import { ChartOptions } from '../../../common/interfaces';
 import { LoaderHandle } from './interfaces';
 /**
@@ -14,6 +14,12 @@ export declare function initializeLoader(props: {
     chart: Chart;
     options?: ChartOptions;
 }): LoaderHandle;
+/** Updates the loader and spinner colors
+ *
+ * @param chart The chart
+ * @param updateOptions Update options
+ */
+export declare function updateLoaderAndSpinnerColors(chart: SerialChart, updateOptions?: ChartOptions): void;
 /**
  * Hides the loader when the chart is done rendering
  *

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

@@ -1,4 +1,6 @@
 import { ColumnSeries } from '@amcharts/amcharts5/xy.js';
+import { WebChart, WebChartGenericDataItem } from '@arcgis/charts-spec';
+import { LoaderHandle } from '../../loading-indicator/interfaces';
 import { InitializeBarChartSeriesProps, UpdateBarChartSeriesProps } from './interfaces';
 /**
  * Initialize a bar chart series
@@ -6,6 +8,32 @@ import { InitializeBarChartSeriesProps, UpdateBarChartSeriesProps } from './inte
  * @param props
  */
 export declare function initializeBarChartSeries(props: InitializeBarChartSeriesProps): ColumnSeries;
+/**
+ * Updates a bar chart series data
+ *
+ * @param props.columnSeries The column series
+ * @param props.data The chart data
+ * @param props.seriesIndex The series index
+ * @param props.chartConfig The chart configuration
+ * @param props.dataWasUpdated Whether the data was updated
+ * @param props.seriesWereReinitialized Whether the chart series were reinitialized before an update
+ * @param props.rotationChanged Whether the chart rotation changed
+ * @param props.timeZoneChanged Whether the time zone changed
+ * @param props.sortChanged Whether the sort changed
+ * @param props.loaderHandle The loader handle
+ */
+declare function updateBarChartSeriesData(props: {
+    columnSeries: ColumnSeries;
+    data?: WebChartGenericDataItem;
+    seriesIndex: number;
+    chartConfig: WebChart;
+    dataWasUpdated?: boolean;
+    seriesWereReinitialized?: boolean;
+    rotationChanged?: boolean;
+    timeZoneChanged?: boolean;
+    sortChanged?: boolean;
+    loaderHandle: LoaderHandle;
+}): void;
 /**
  * Updates a bar chart series
  *
@@ -20,10 +48,14 @@ export declare function initializeBarChartSeries(props: InitializeBarChartSeries
  * @param props.rotationChanged Whether the chart rotation changed
  * @param props.timeZoneChanged Whether the time zone changed
  * @param props.queryObject The query object
- * @param props.commonStrings The common strings
+ * @param props.utilsStrings The utility strings
  * @param props.seriesWereReinitialized Whether the chart series were reinitialized before an update
  * @param props.fieldList The field list
  * @param props.sortChanged Whether the sort changed
  * @param props.loaderHandle The loader handle
  */
 export declare function updateBarChartSeries(props: UpdateBarChartSeriesProps): void;
+export declare const nextSeriesBarchartPrivateFunctions: {
+    updateBarChartSeriesData: typeof updateBarChartSeriesData;
+};
+export {};

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

@@ -0,0 +1,18 @@
+import { ColumnSeries } from '@amcharts/amcharts5/xy.js';
+import { InitializeHeatChartSeriesProps, UpdateHeatChartSeriesProps } from './interfaces';
+/**
+ * Initializes a heat chart series with the provided properties.
+ * @param props.root The root element of the chart
+ * @param props.xAxis The x-axis to assign to the chart
+ * @param props.yAxis The y-axis to assign to the chart
+ * @returns A new instance of ColumnSeries configured for heat chart rendering
+ */
+export declare function initializeHeatChartSeries(props: InitializeHeatChartSeriesProps): ColumnSeries;
+/**
+ * Updates the heat chart series with the provided configuration.
+ * @param props.series The series to update
+ * @param props.data The data to set on the series
+ * @param props.loaderHandle The loader handle to hide after data is set
+ * @param props.chartConfig The chart configuration containing the series configuration
+ */
+export declare function updateHeatChartSeries(props: UpdateHeatChartSeriesProps): void;

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

@@ -0,0 +1,6 @@
+import { ColumnSeries } from '@amcharts/amcharts5/xy.js';
+import { WebChartGenericDataItem, WebChartHeatChartSeries, WebHeatChart } from '@arcgis/charts-spec';
+import { InitializeXYSeriesProps, UpdateXYSeriesProps } from '../interfaces';
+export interface InitializeHeatChartSeriesProps extends InitializeXYSeriesProps<WebChartHeatChartSeries> {
+}
+export type UpdateHeatChartSeriesProps = UpdateXYSeriesProps<WebChartGenericDataItem, WebChartHeatChartSeries, ColumnSeries, WebHeatChart>;

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

@@ -23,6 +23,6 @@ export declare function initializeHistogramSeries(props: InitializeHistogramSeri
  * @param props.allChartSeries All the chart series
  * @param props.seriesConfig The series configuration
  * @param props.data The data
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  */
 export declare function updateHistogramSeries(props: UpdateHistogramSeriesProps): Promise<void>;

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

@@ -1,6 +1,6 @@
 import { Root, Series } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer, ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings } from '../../../../../utils';
+import { UtilsStrings } from '../../../../../utils';
 import { IRendererSymbol, OverlayTerms, WebChart, WebChartAxis, WebChartHistogramDataItem, WebChartHistogramSeries, WebChartOverlay } from '@arcgis/charts-spec';
 import { InitializeXYSeriesProps, UpdateXYSeriesProps } from '../interfaces';
 export interface InitializeHistogramSeriesProps extends InitializeXYSeriesProps<WebChartHistogramSeries> {
@@ -17,13 +17,13 @@ export interface InitStatisticSeriesProps {
     xAxis: Axis<AxisRenderer>;
     yAxis: Axis<AxisRenderer>;
     type: OverlayTerms;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface UpdateStatisticSeriesProps {
     lineSeries: LineSeries;
     overlayConfig?: WebChartOverlay;
     data?: WebChartHistogramDataItem;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface UpdateNormalDistributionLineSeriesProps {
     lineSeries: LineSeries;

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

@@ -1,6 +1,6 @@
 import { SerialChart } from '@amcharts/amcharts5';
 import { WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
-import { CommonStrings, ErrorStrings, PieSlicesSymbols, QueryObject } from '../../../../utils';
+import { ErrorStrings, PieSlicesSymbols, QueryObject, UtilsStrings } from '../../../../utils';
 import { ChartOptions } from '../../../common/interfaces';
 import { LoaderHandle } from '../loading-indicator/interfaces';
 /**
@@ -9,13 +9,13 @@ import { LoaderHandle } from '../loading-indicator/interfaces';
  * @param props.chart The chart
  * @param props.chartConfig The chart configuration
  * @param props.options The runtime options
- * @param props.commonStrings The common t9n strings
+ * @param props.utilsStrings The t9n utils strings
  */
 export declare function initializeSeries(props: {
     chart: SerialChart;
     chartConfig: WebChart;
     options?: ChartOptions;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): Promise<void>;
 /**
  * Update the chart series
@@ -33,7 +33,7 @@ export declare function initializeSeries(props: {
  * @param props.pieSlicesSymbols The pre-computed pie slices symbols
  * @param props.queryObject The query object
  * @param props.loaderHandle The loader handle
- * @param props.commonStrings The common t9n strings
+ * @param props.utilsStrings The t9n utils strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function updateSeries(props: {
@@ -52,6 +52,8 @@ export declare function updateSeries(props: {
     pieSlicesSymbols?: PieSlicesSymbols;
     queryObject?: QueryObject;
     loaderHandle: LoaderHandle;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
+    groupOfSlicesUpdateNeeded?: boolean;
+    labelUpdateNeeded?: boolean;
 }): Promise<void>;

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

@@ -1,8 +1,8 @@
-import { Root } from '@amcharts/amcharts5';
+import { Root, SerialChart } from '@amcharts/amcharts5';
 import { RadarLineSeries } from '@amcharts/amcharts5/radar.js';
 import { Axis, AxisRenderer, ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
-import { IField, RESTRendererType, WebBoxPlot, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataTypes, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries, WebRadarChart } from '@arcgis/charts-spec';
-import { ChartSubType, CommonStrings, QueryObject, SeriesSymbolsMap, SubtypeInfo } from '../../../../utils';
+import { IField, RESTRendererType, WebBoxPlot, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataTypes, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries, WebRadarChart } from '@arcgis/charts-spec';
+import { ChartSubType, QueryObject, SeriesSymbolsMap, SubtypeInfo, UtilsStrings } from '../../../../utils';
 import { ChartOptions } from '../../../common/interfaces';
 import { ApplySelectionOnSeriesProps } from '../../selection/apply/interfaces';
 import { LoaderHandle } from '../loading-indicator/interfaces';
@@ -16,14 +16,15 @@ import { UpdateLineChartSeriesProps } from './line-chart/interfaces';
 import { UpdatePieChartSeriesProps } from './pie-chart/interfaces';
 import { UpdateRadarChartSeriesProps } from './radar-chart/interfaces';
 import { UpdateScatterplotMarkersStyleProps, UpdateTrendLineProps } from './scatter-plot/interfaces';
-export interface InitializeSeriesProps<SeriesType extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartPieChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries> {
+export interface InitializeSeriesProps<SeriesType extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartPieChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries> {
     chartConfig: WebChart;
     root: Root;
     options?: ChartOptions;
     seriesConfig: SeriesType;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
+    chart?: SerialChart;
 }
-export interface InitializeXYSeriesProps<SeriesType extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries> extends InitializeSeriesProps<SeriesType> {
+export interface InitializeXYSeriesProps<SeriesType extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries> extends InitializeSeriesProps<SeriesType> {
     xAxis: Axis<AxisRenderer>;
     yAxis: Axis<AxisRenderer>;
 }
@@ -41,14 +42,16 @@ export interface UpdateSeriesProps<DataTypes extends WebChartDataTypes, ConfigTy
     sortChanged?: boolean;
     colorMatchChanged?: boolean;
     seriesStyleChanged?: boolean;
+    autoInverseDataLabelTextColor?: boolean;
     subtypeInfo?: SubtypeInfo;
     rendererType?: RESTRendererType;
     fieldList?: IField[];
     chartSubType: ChartSubType;
     loaderHandle: LoaderHandle;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
+    groupOfSlicesUpdateNeeded?: boolean;
 }
-export interface UpdateXYSeriesProps<DataTypes extends WebChartDataTypes, SeriesConfig extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries, SeriesType extends ColumnSeries | LineSeries | RadarLineSeries, ConfigType extends WebBoxPlot | WebChart | WebRadarChart> extends UpdateSeriesProps<DataTypes, ConfigType> {
+export interface UpdateXYSeriesProps<DataTypes extends WebChartDataTypes, SeriesConfig extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries, SeriesType extends ColumnSeries | LineSeries | RadarLineSeries, ConfigType extends WebBoxPlot | WebChart | WebRadarChart> extends UpdateSeriesProps<DataTypes, ConfigType> {
     seriesConfig: SeriesConfig;
     series: SeriesType;
     seriesIndex: number;

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

@@ -25,7 +25,7 @@ export declare function initializeLineChartSeries(props: InitializeLineChartSeri
  * @param props.seriesWereReinitialized Whether the series were reinitialized before an update
  * @param props.timeZoneChanged Whether the time zone changed
  * @param props.sortChanged Whether the sort changed
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  * @param props.loaderHandle The loader handle
  */
 export declare function updateLineChartSeries(props: UpdateLineChartSeriesProps): void;

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

@@ -1,7 +1,7 @@
 import { Root } from '@amcharts/amcharts5';
-import { PieSeries } from '@amcharts/amcharts5/percent.js';
+import { PieChart, PieSeries } from '@amcharts/amcharts5/percent.js';
 import { WebChart, WebChartDataTypes } from '@arcgis/charts-spec';
-import { CommonStrings, PieSlicesSymbols, QueryObject } from '../../../../../utils';
+import { PieSlicesSymbols, QueryObject, UtilsStrings } from '../../../../../utils';
 import { InitializePieChartSeriesProps, UpdatePieChartSeriesProps } from './interfaces';
 /**
  * Generates a slices array containing the slices id, label and style.
@@ -12,7 +12,7 @@ import { InitializePieChartSeriesProps, UpdatePieChartSeriesProps } from './inte
  * @param props.queryObject The query object (layer or layer view)
  * @param props.usePopupTemplateFieldsInfo Whether to use the popup template info for the aliases
  * @param props.labelUpdateNeeded Whether the labels were updated
- * @param props.commonStrings The common t9n strings
+ * @param props.utilsStrings The t9n utils strings
  */
 export declare function computePieChartSlices(props: {
     root: Root;
@@ -21,7 +21,7 @@ export declare function computePieChartSlices(props: {
     queryObject: QueryObject;
     usePopupTemplateFieldsInfo?: boolean;
     labelUpdateNeeded: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): Promise<PieSlicesSymbols>;
 /**
  * Initialize a pie chart series
@@ -42,5 +42,12 @@ export declare function initializePieChartSeries(props: InitializePieChartSeries
  * @param props.data The data
  * @param props.options The runtime chart options
  * @param props.loaderHandle The loader handle
+ * @param props.labelUpdateNeeded If the label needs updating
  */
 export declare function updatePieChartSeries(props: UpdatePieChartSeriesProps): void;
+/**
+ * Updates the pie chart size to avoid the labels to be cut off on the edges or to overlap the legend.
+ *
+ * @param chart The pie chart
+ */
+export declare function updatePieChartSize(chart: PieChart, pieSeries?: PieSeries): void;

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

@@ -1,6 +1,6 @@
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
 import { Root } from '@amcharts/amcharts5';
-import { ChartSubType, CommonStrings, PieSlicesSymbols } from '../../../../../utils';
+import { ChartSubType, PieSlicesSymbols, UtilsStrings } from '../../../../../utils';
 import { IField, WebChart, WebChartGenericDataItem, WebChartPieChartSeries } from '@arcgis/charts-spec';
 import { InitializeSeriesProps, UpdateSeriesProps } from '../interfaces';
 export type InitializePieChartSeriesProps = InitializeSeriesProps<WebChartPieChartSeries>;
@@ -8,6 +8,8 @@ export interface UpdatePieChartSeriesProps extends UpdateSeriesProps<WebChartGen
     series: PieSeries;
     seriesConfig: WebChartPieChartSeries;
     pieSlicesSymbols?: PieSlicesSymbols;
+    groupOfSlicesUpdateNeeded?: boolean;
+    labelUpdateNeeded?: boolean;
 }
 export interface UpdatePieChartStyleProps {
     root: Root;
@@ -20,5 +22,5 @@ export interface UpdatePieChartStyleProps {
     fieldList?: IField[];
     labelUpdateNeeded: boolean;
     colorMatch: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }

package/dist/chart-rendering/next/chart-library-elements/series/pie-chart/slice-grouping/index.d.ts

@@ -1,14 +1,29 @@
 import { PieChart } from '@amcharts/amcharts5/percent.js';
-import { CommonStrings } from '../../../../../../utils';
-import { WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../../../../utils';
+import { WebChartDataItem, WebChartDataTypes, WebChartPieChartSeries } from '@arcgis/charts-spec';
+/**
+ * Initialize the pie chart slice group and the chart's data.
+ * @param props.chart The pie chart
+ * @param props.data The pie chart data
+ * @param props.seriesConfig The series config
+ * @param props.utilsStrings The t9n strings to fetch the slice group label
+ */
+export declare function initializePieChartGroupOfSlices(props: {
+    chart: PieChart;
+    data: WebChartDataItem[];
+    seriesConfig: WebChartPieChartSeries[];
+    utilsStrings: UtilsStrings;
+}): WebChartDataItem[] | undefined;
 /**
  * Update the pie chart slice group and the chart's data.
- * @param props.data The pie chart
+ * @param props.chart The pie chart
+ * @param props.data The chart's latest data
  * @param props.seriesConfig The series config
- * @param props.commonStrings The t9n strings to fetch the slice group label
+ * @param props.utilsStrings The t9n strings to fetch the slice group label
  */
 export declare function updatePieChartGroupOfSlices(props: {
     chart: PieChart;
+    data?: WebChartDataTypes;
     seriesConfig: WebChartPieChartSeries[];
-    commonStrings: CommonStrings;
-}): void;
+    utilsStrings: UtilsStrings;
+}): WebChartDataItem[] | undefined;

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

@@ -22,6 +22,6 @@ export declare function initializeRadarChartSeries(props: InitializeRadarChartSe
  * @param props.subtypeInfo The subtype info
  * @param props.queryObject The query object (layer or feature layer view)
  * @param props.loaderHandle The loader handle
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  */
 export declare function updateRadarChartSeries(props: UpdateRadarChartSeriesProps): void;