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

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,7 @@ export declare function updateSeries(props: {
     pieSlicesSymbols?: PieSlicesSymbols;
     queryObject?: QueryObject;
     loaderHandle: LoaderHandle;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
+    groupOfSlicesUpdateNeeded?: 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
@@ -44,3 +44,9 @@ export declare function initializePieChartSeries(props: InitializePieChartSeries
  * @param props.loaderHandle The loader handle
  */
 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,7 @@ export interface UpdatePieChartSeriesProps extends UpdateSeriesProps<WebChartGen
     series: PieSeries;
     seriesConfig: WebChartPieChartSeries;
     pieSlicesSymbols?: PieSlicesSymbols;
+    groupOfSlicesUpdateNeeded?: boolean;
 }
 export interface UpdatePieChartStyleProps {
     root: Root;
@@ -20,5 +21,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;

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

@@ -2,21 +2,21 @@ import { SerialChart, Series } from '@amcharts/amcharts5';
 import { LineSeries } from '@amcharts/amcharts5/xy.js';
 import { InitializeScatterplotSeriesProps, UpdateScatterplotSeriesProps } from './interfaces';
 /**
- * Indicates whether the provided series instance is a scatter plot overlay series (trendline).
+ * Indicates whether the provided series instance is a scatterplot overlay series (trendline).
  *
  * @param series The series instance
  */
 export declare function isScatterplotOverlaySeries(series: Series): boolean;
 /**
- * Finds a scatter plot series amongst the chart's series. For now we handle only one marker series
- * per scatter plot so it will return the first it finds.
+ * Finds a scatterplot series amongst the chart's series. For now we handle only one marker series
+ * per scatterplot so it will return the first it finds.
  *
  * @param chart The chart
  */
 export declare function getScatterplotMarkerSeries(chart: SerialChart): Series | undefined;
 /**
- * Finds a scatter plot trend line series amongst the chart's series. For now we handle only one trend line series
- * per scatter plot so it will return the first it finds.
+ * Finds a scatterplot trend line series amongst the chart's series. For now we handle only one trend line series
+ * per scatterplot so it will return the first it finds.
  *
  * @param chart The chart
  */
@@ -28,7 +28,7 @@ export declare function getTrendLineSeries(chart: SerialChart): Series | undefin
  */
 export declare function initializeScatterplotSeries(props: InitializeScatterplotSeriesProps): LineSeries[];
 /**
- * Update the scatter plot series
+ * Update the scatterplot series
  *
  * @param props.root The root
  * @param props.chartConfig The chart configuration
@@ -43,6 +43,6 @@ export declare function initializeScatterplotSeries(props: InitializeScatterplot
  * @param props.seriesStyleChanged Whether the series style changed
  * @param props.seriesWereReinitialized Whether the series were reinitialized before an update
  * @param props.loaderHandle The loader handle
- * @param props.commonStrings The common strings
+ * @param props.utilsStrings The utils strings
  */
 export declare function updateScatterplotSeries(props: UpdateScatterplotSeriesProps): void;

package/dist/chart-rendering/next/chart-library-elements/series/scatter-plot/size-policy/index.d.ts

@@ -1,9 +1,27 @@
 import { LineSeries } from '@amcharts/amcharts5/xy.js';
 import { WebChartScatterplotSeries } from '@arcgis/charts-spec';
 /**
- * Updates the series size policy, making the scatter plot a bubble plot
+ * Indicates whether the size policy changed from the previous update
+ *
+ * @param props.seriesConfig The scatterplot series config
+ * @param props.series The scatterplot series
+ * @param props.newMin The new min size
+ * @param props.newMax The new max size
+ */
+declare function hasSizePolicyChanged(props: {
+    seriesConfig: WebChartScatterplotSeries;
+    series: LineSeries;
+    newMin: number;
+    newMax: number;
+}): boolean;
+/**
+ * Updates the series size policy, making the scatterplot a bubble plot
  *
  * @param seriesConfig The series config
  * @param series The chart series
  */
 export declare function updateSizePolicy(seriesConfig: WebChartScatterplotSeries, series: LineSeries): void;
+export declare const nextScatterPlotSizePolicyPrivateFunctions: {
+    hasSizePolicyChanged: typeof hasSizePolicyChanged;
+};
+export {};

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

@@ -26,6 +26,7 @@ export declare function getBarOrLineSeriesDataFields(chartConfig: WebChart, seri
  * @param props.colorMatchChanged Whether the color match changed
  * @param props.seriesStyleChanged Whether the series style changed
  * @param props.sortChanged Whether the sort changed
+ * @param props.groupOfSlicesUpdateNeeded Whether the group slices updated needed
  * @returns True if styling is needed, false otherwise
  */
 export declare function isStylingNeeded(props: UpdateSeriesProps<WebChartDataTypes, WebChart>): boolean;
@@ -108,6 +109,14 @@ export declare function getAxes(props: {
  * @param series - the series to set the accessibility features
  */
 export declare function setAccessibilityFeatures(series: Series): void;
+/**
+ * Indicates whether the scatterplot series need to be reinitialized.
+ * It returns true when the field name changed. The other properties (policy type and min/max values) don't require a reinit.
+ *
+ * @param chart The chart
+ * @param chartConfig The chart's config
+ */
+declare function isInitializingScatterplotSeriesNeeded(chart: XYChart, chartConfig: WebChart): boolean;
 /**
  * Indicates whether the series need to be reinitialized.
  *
@@ -163,3 +172,7 @@ export declare function hideOutOfTheContainerMarker(bulletSprite: Graphics, mark
  * @returns
  */
 export declare function hasColorMatchBeenApplied(chart: Chart, chartConfig?: WebChart): boolean;
+export declare const nextSeriesUtilsPrivateFunctions: {
+    isInitializingScatterplotSeriesNeeded: typeof isInitializingScatterplotSeriesNeeded;
+};
+export {};

package/dist/chart-rendering/next/chart-library-elements/symbols/utils/property-map/index.d.ts

@@ -1,5 +1,5 @@
 import { Pattern, Percent, Root } from '@amcharts/amcharts5';
-import { ISimpleMarkerSymbol, SimpleFillSymbolStyle, RESTSimpleLineSymbolStyle } from '@arcgis/charts-spec';
+import { ISimpleMarkerSymbol, SimpleFillSymbolStyle, WebChartTextSymbol, RESTHorizontalAlignment, RESTSimpleLineSymbolStyle } from '@arcgis/charts-spec';
 import { AmChartsColor } from '../../../../types';
 /**
  * Maps a width defined as a number or a string following the pattern 'xxx%' into
@@ -50,3 +50,20 @@ export declare function mapAngle(angle?: number, defaultAngle?: number): number;
  * @param size
  */
 export declare function mapPath(style: ISimpleMarkerSymbol["style"], size?: number): string;
+/**
+ * Horizontal alignment
+ *
+ * @param alignment horizontal alignment
+ * @param defaults the defaults
+ * @param isTopOrBottom if it should be top or bottom
+ */
+export declare function mapHAlignmentToAlign(alignment: WebChartTextSymbol["horizontalAlignment"], defaults?: RESTHorizontalAlignment): Percent | undefined;
+type HCenterAlignment = "center" | "left" | "right" | undefined;
+/**
+ * Horizontal alignment for center
+ *
+ * @param alignment horizontal alignment
+ * @param defaults the defaults
+ */
+export declare function mapHAlignmentToHCenter(alignment: WebChartTextSymbol["horizontalAlignment"], defaults?: RESTHorizontalAlignment): HCenterAlignment;
+export {};

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

@@ -1,6 +1,6 @@
 import { DataItem } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer, IAxisDataItem } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings } from '../../../../../utils';
+import { UtilsStrings } from '../../../../../utils';
 import { GuideTooltipFormatCallback } from '../../../../common/interfaces';
 /**
  * Initializes the guide tooltip for an axis.
@@ -20,10 +20,10 @@ export declare function initializeGuideTooltip(props: {
  *
  * @param props.axis The axis containing the guides that need their label to be formatted
  * @param props.guideTooltipFormatter A custom formatter for the guides' label
- * @param props.commonStrings List of t9n strings
+ * @param props.utilsStrings List of t9n strings
  */
 export declare function updateGuideTooltipFormatter(props: {
     axis: Axis<AxisRenderer>;
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): void;

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

@@ -1,6 +1,6 @@
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
 import { ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings, QueryObject } from '../../../../utils';
+import { QueryObject, UtilsStrings } from '../../../../utils';
 import { IField, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries } from '@arcgis/charts-spec';
 import { BarAndLineTooltipFormatCallback, BoxPlotTooltipFormatCallback, HistogramLabelFormatCallback, PieChartLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../common/interfaces';
 export interface TooltipProps<TSeries extends ColumnSeries | LineSeries | PieSeries, TSeriesConfig extends WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartPieChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries, TFormatter extends BarAndLineTooltipFormatCallback | BoxPlotTooltipFormatCallback | HistogramLabelFormatCallback | PieChartLabelFormatCallback | ScatterplotLabelFormatCallback> {
@@ -10,10 +10,10 @@ export interface TooltipProps<TSeries extends ColumnSeries | LineSeries | PieSer
     fieldList?: IField[];
     tooltipFormatter?: TFormatter;
     axes?: [WebChartAxis, WebChartAxis?, WebChartAxis?];
-    commonStrings?: CommonStrings;
+    utilsStrings?: UtilsStrings;
 }
 export interface BarAndLineChartTooltipProps extends TooltipProps<ColumnSeries | LineSeries, WebChartBarChartSeries | WebChartLineChartSeries | WebChartRadarChartSeries, BarAndLineTooltipFormatCallback> {
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     setTimeBinningInfoWhenNotProvided?: boolean;
     seriesIndex: number;
     queryObject?: QueryObject;

package/dist/chart-rendering/next/chart-library-elements/tooltips/scatter-plot/index.d.ts

@@ -3,7 +3,7 @@ import { LineSeries } from '@amcharts/amcharts5/xy.js';
 import { WebChartScatterplotSeries } from '@arcgis/charts-spec';
 import { ScatterplotTooltipProps } from './interfaces';
 /**
- * Adds the html code to the tooltip associated to the scatter plot bullets
+ * Adds the html code to the tooltip associated to the scatterplot bullets
  *
  * @param seriesConfig The series config
  * @param markerSeries the line series parent of the element
@@ -15,14 +15,14 @@ export declare function scatterplotTooltipContentCallback(props: {
     tooltip: Sprite | Tooltip;
 }): string | undefined;
 /**
- * Initializes the tooltip associated to the markers on a scatter plot
+ * Initializes the tooltip associated to the markers on a scatterplot
  *
  * @param element The bullet element which has the tooltip on it
  * @param markerSeries The series on which to initialize the tooltip
  */
 export declare function initializeScatterplotTooltip(element: Template<Graphics>, markerSeries: LineSeries): void;
 /**
- * Updates/initializes the tooltip for a Sprite marker in Scatter Plot.
+ * Updates/initializes the tooltip for a Sprite marker in scatterplot.
  *
  * @param props.axesConfig The axes config
  * @param props.seriesConfig The series config