@arcgis/charts-components 4.34.0-next.9 → 4.34.0-next.90

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

@@ -1,3 +1,4 @@
+import { Scrollbar } from '@amcharts/amcharts4/.internal/core/elements/Scrollbar.js';
 import { Chart } from '@amcharts/amcharts4/charts.js';
 import { WebChartAxisScrollBar } from '@arcgis/charts-spec';
 /**
@@ -6,6 +7,15 @@ import { WebChartAxisScrollBar } from '@arcgis/charts-spec';
  * @param chart The chart
  */
 export declare function initializeChartScrollbar(chart: Chart): void;
+/**
+ * Updates a scrollbar's focusable property.
+ * We disable it when the scrollbar is hidden to avoid the focus to bet set on an invisible object.
+ * See https://devtopia.esri.com/WebGIS/arcgis-charts/issues/7589
+ *
+ * @param scrollbar The scrollbar to update
+ * @param visible The scrollbar visibility
+ */
+declare function updateScrollbarFocus(scrollbar: Scrollbar, visible: boolean): void;
 /**
  * Updates scrollbar on the chart based on input value from scrollbar
  *
@@ -18,3 +28,7 @@ export declare function updateChartScrollbar(props: {
     scrollbarXConfig?: WebChartAxisScrollBar;
     scrollbarYConfig?: WebChartAxisScrollBar;
 }): void;
+export declare const chartScrollbarPrivateFunctions: {
+    updateScrollbarFocus: typeof updateScrollbarFocus;
+};
+export {};

package/dist/chart-rendering/stable/chart-library-elements/series/box-plot/index.d.ts

@@ -1,5 +1,5 @@
 import { Chart, XYChart, CandlestickSeries, LineSeries, StepLineSeries } from '@amcharts/amcharts4/charts.js';
-import { WebBoxPlot, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebBoxPlot, WebChartBoxPlotDataItem, WebChartBoxPlotSeries, WebChartDataItem, WebChartLineChartSeries } from '@arcgis/charts-spec';
 import { InitializeBoxPlotSeriesProps, UpdateBoxPlotSeriesProps } from './interfaces';
 /**
  * Finds a candle stick series from its id
@@ -34,6 +34,20 @@ export declare function getOutliersSeries(chart: XYChart, candleStickSeriesId: s
  * @returns
  */
 export declare function shouldShowSeriesOutliers(showOutliers?: boolean, seriesVisibility?: boolean): boolean;
+declare function updateSeriesDataFields(props: {
+    chartConfig: WebBoxPlot;
+    seriesConfig: WebChartBoxPlotSeries | WebChartLineChartSeries;
+    meanLineSeries?: LineSeries;
+    candleStickSeries?: CandlestickSeries;
+    topStepLineSeries?: StepLineSeries;
+    medianStepLineSeries?: StepLineSeries;
+    bottomStepLineSeries?: StepLineSeries;
+    outliersSeries?: LineSeries;
+    creation?: boolean;
+    rotationChanged?: boolean;
+    outliersVisibilityChanged?: boolean;
+    standardizeValuesVisibilityChanged?: boolean;
+}): void;
 /**
  * Function initializing the box plot series. Set only the properties that are not going to be modified
  * through a chart update. See updateBoxPlotChartSeries for the other properties.
@@ -52,9 +66,45 @@ export declare function sortBoxPlotMeanLinesData(props: {
     chartData: WebChartDataItem[];
     chartConfig: WebBoxPlot;
 }): void;
+/**
+ * Helps repositioning the step line and outliers series
+ *
+ * @param props.numberOfSeries The number of series on the chart
+ * @param props.chart The chart
+ * @param props.showMean Whether to show the mean line
+ */
+declare function updateSeriesLocation(props: {
+    numberOfSeries: number;
+    chart: XYChart;
+    showMean?: boolean;
+}): void;
+/**
+ * Assigns the data to the outliers series.
+ * Currently the same data is assigned to all the series and they pick what they need following
+ * their data fields.
+ *
+ * @param props.outliersSeries The series to assign data to
+ * @param props.chartData The data
+ * @param props.dataWasUpdated Whether the data was updated
+ * @param props.rotationChanged Whether the rotation changed
+ * @param props.seriesReordered Whether the series were reordered
+ */
+declare function updateOutliersSeriesData(props: {
+    outliersSeries: LineSeries;
+    chartData?: WebChartBoxPlotDataItem;
+    dataWasUpdated?: boolean;
+    rotationChanged?: boolean;
+    seriesReordered?: boolean;
+}): void;
 /**
  * Function updating a column series properties without having to recreate the whole series.
  *
  * @param props
  */
 export declare function updateBoxPlotSeries(props: UpdateBoxPlotSeriesProps): void;
+export declare const seriesBoxPlotPrivateFunctions: {
+    updateSeriesDataFields: typeof updateSeriesDataFields;
+    updateOutliersSeriesData: typeof updateOutliersSeriesData;
+    updateSeriesLocation: typeof updateSeriesLocation;
+};
+export {};

package/dist/chart-rendering/stable/chart-library-elements/series/box-plot/interfaces.d.ts

@@ -15,6 +15,7 @@ export interface UpdateBoxPlotSeriesProps extends UpdateSeriesProps<CandlestickS
     options?: ChartOptions;
     outliersVisibilityChanged?: boolean;
     rotationChanged?: boolean;
+    seriesReordered?: boolean;
     showOutliers?: boolean;
     showMean?: boolean;
     standardizeValuesVisibilityChanged?: boolean;

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

@@ -1,5 +1,5 @@
 import { Axis, AxisRendererX, AxisRendererY, ColumnSeries, LineSeries, XYChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings } from '../../../../../utils';
+import { UtilsStrings } from '../../../../../utils';
 import { IRendererSymbol, NumberFormatOptions, WebChart, WebChartHistogramDataItem, WebChartHistogramSeries, WebChartOverlay } from '@arcgis/charts-spec';
 import { ChartOptions } from '../../../../common/interfaces';
 import { LoaderHandle } from '../../loading-indicator/interfaces';
@@ -35,7 +35,7 @@ export interface UpdateStatisticSeriesProps {
     valueFormat: NumberFormatOptions;
     overlay?: WebChartOverlay;
     chartData?: WebChartHistogramDataItem;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface UpdateNormalDistributionLineSeriesProps {
     lineSeries: LineSeries;
@@ -53,6 +53,6 @@ export interface UpdateHistogramSeriesProps extends UpdateXYSeriesProps<ColumnSe
 }
 export interface InitializeHistogramSeriesProps extends InitializeSeriesProps<XYChart> {
     seriesConfig: WebChartHistogramSeries;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     options?: ChartOptions;
 }

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

@@ -1,5 +1,5 @@
 import { CandlestickSeries, ColumnSeries, GaugeChart, LineSeries, PieChart, PieSeries, XYChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, QueryObject, SelectionTheme, SeriesSymbolsMap, SubtypeInfo } from '../../../../utils';
+import { QueryObject, SelectionTheme, SeriesSymbolsMap, SubtypeInfo, UtilsStrings } from '../../../../utils';
 import { IField, RESTRendererType, WebChartAxis, WebChartBarChartSeries, WebChartLineChartSeries, WebChartSeriesType } from '@arcgis/charts-spec';
 import { ChartOptions } from '../../../common/interfaces';
 import { ApplySelectionOnSeriesProps } from '../../selection/apply/interfaces';
@@ -34,7 +34,7 @@ export interface UpdateSeriesProps<SeriesType extends CandlestickSeries | Column
     dataWasUpdated?: boolean;
     subtypeInfo?: SubtypeInfo;
     fieldList?: IField[];
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface UpdateXYSeriesProps<SeriesType extends CandlestickSeries | ColumnSeries | LineSeries | PieSeries, SeriesConfigType extends WebChartSeriesType> extends UpdateSeriesProps<SeriesType, SeriesConfigType> {
     axes: [WebChartAxis, WebChartAxis];

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

@@ -1,4 +1,5 @@
 import { LineSeries } from '@amcharts/amcharts4/charts.js';
+import { WebChartLineChartSeries } from '@arcgis/charts-spec';
 import { InitializeLineSeriesProps, UpdateLineSeriesProps, UpdateLineSeriesStyleProps } from './interfaces';
 /**
  * Function initializing the line chart series. Set only the properties that are not going to be modified
@@ -7,6 +8,13 @@ import { InitializeLineSeriesProps, UpdateLineSeriesProps, UpdateLineSeriesStyle
  * @param props
  */
 export declare function initializeLineChartSeries(props: InitializeLineSeriesProps): LineSeries;
+/**
+ * Updates a line series area visibility and color
+ *
+ * @param seriesConfig The line series config
+ * @param lineSeries The line series
+ */
+declare function updateLineArea(seriesConfig: WebChartLineChartSeries, lineSeries: LineSeries): void;
 /**
  * Styles a line series and its markers.
  * This is used by the line chart, combo bar/line chart and box plot.
@@ -25,3 +33,7 @@ export declare function updateLineSeriesStyle(props: UpdateLineSeriesStyleProps)
  * @param props
  */
 export declare function updateLineChartSeries(props: UpdateLineSeriesProps): void;
+export declare const seriesLinechartPrivateFunctions: {
+    updateLineArea: typeof updateLineArea;
+};
+export {};

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

@@ -1,8 +1,28 @@
 import { PieChart, PieSeries } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, PieSlicesSymbols, QueryObject, SelectionTheme } from '../../../../../utils';
-import { WebChart, WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { PieSlicesSymbols, QueryObject, SelectionTheme, UtilsStrings } from '../../../../../utils';
+import { WebChart, WebChartDataItem, WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { getSliceSymbol } from '../../../../common/series/pie-chart';
 import { LoaderHandle } from '../../loading-indicator/interfaces';
 import { UpdatePieChartSeriesProps } from './interfaces';
+/**
+ * This function sets the series default colors, overriding the default amCharts theme.
+ * This is made to prevent color glitches making the default theme appear momentarily when updating the
+ * chart's data (refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/6005).
+ * This function needs to be called **before** the slices are populated (after a data change) otherwise it doesn't have any effect.
+ * It also means that workaround is only effective when the data changes, which seems to fit the conditions triggering
+ * the bug anyway.
+ *
+ * @param props.chartData The pie chart's data
+ * @param props.pieSeries The pie chart series instance
+ * @param props.seriesConfig The pie chart series config
+ * @param props.pieSlicesSymbols The pre-computed slices symbol
+ */
+declare function overrideSeriesDefaultColors(props: {
+    chartData?: WebChartDataItem[];
+    pieSeries: PieSeries;
+    seriesConfig: WebChartPieChartSeries;
+    pieSlicesSymbols?: PieSlicesSymbols;
+}): void;
 export declare function initializePieChartSeries(props: {
     seriesConfig: WebChartPieChartSeries;
     hideLoaderHandle: LoaderHandle["hideLoader"];
@@ -23,7 +43,7 @@ export declare function computePieChartSlices(props: {
     queryObject: QueryObject;
     usePopupTemplateFieldsInfo?: boolean;
     labelUpdateNeeded: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): Promise<PieSlicesSymbols>;
 /**
  * Function updating chart series and assign its data
@@ -31,3 +51,8 @@ export declare function computePieChartSlices(props: {
  * @param props
  */
 export declare function updatePieChartSeries(props: UpdatePieChartSeriesProps): void;
+export declare const seriesPiechartPrivateFunctions: {
+    overrideSeriesDefaultColors: typeof overrideSeriesDefaultColors;
+    getSliceSymbol: typeof getSliceSymbol;
+};
+export {};

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

@@ -1,5 +1,5 @@
 import { PieChart, PieSeries } from '@amcharts/amcharts4/charts.js';
-import { PieSlicesSymbols, ChartSubType, CommonStrings, SelectionTheme } from '../../../../../utils';
+import { PieSlicesSymbols, ChartSubType, SelectionTheme, UtilsStrings } from '../../../../../utils';
 import { WebChartPieChartSeries, IField } from '@arcgis/charts-spec';
 import { UpdateSeriesProps } from '../interfaces';
 export interface UpdatePieChartSeriesProps extends UpdateSeriesProps<PieSeries, WebChartPieChartSeries> {
@@ -7,7 +7,7 @@ export interface UpdatePieChartSeriesProps extends UpdateSeriesProps<PieSeries,
     selectionTheme?: SelectionTheme;
     groupOfSlicesWasUpdated?: boolean;
     pieSlicesSymbols?: PieSlicesSymbols;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface UpdatePieChartStyleProps {
     x: string;
@@ -19,5 +19,5 @@ export interface UpdatePieChartStyleProps {
     fieldList?: IField[];
     labelUpdateNeeded: boolean;
     colorMatch: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }

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

@@ -1,15 +1,15 @@
 import { PieChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings } from '../../../../../../utils';
+import { UtilsStrings } from '../../../../../../utils';
 import { WebChartPieChartSeries } from '@arcgis/charts-spec';
 /**
  * Update the pie chart slice group and the chart's data.
  *
  * @param props.chart The pie chart
  * @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;
     seriesConfig: WebChartPieChartSeries[];
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): void;

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

@@ -1,9 +1,28 @@
 import { LineSeries } from '@amcharts/amcharts4/charts.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
+ * @returns
+ */
+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): boolean;
+export declare const scatterPlotSizePolicyPrivateFunctions: {
+    hasSizePolicyChanged: typeof hasSizePolicyChanged;
+};
+export {};

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

@@ -97,6 +97,20 @@ export declare function disposeStyleOrSelectionCallback(chart: SerialChart, styl
  * @param chart The chart containing the series
  */
 export declare function getVisibleSeriesIDs(chart?: PieChart | XYChart): string[] | undefined;
+/**
+ * Indicates whether a data item contains statistics that will lead to render a box-plot candle.
+ *
+ * @param props.dataItem The data item containing the statistics
+ * @param props.y The y field
+ * @param props.splitBy The split-by field
+ * @param props.showOutliers Whether the outliers are shown
+ */
+declare function isValidBoxPlotCandle(props: {
+    dataItem: WebChartDataItem;
+    y?: string;
+    splitBy?: string;
+    showOutliers?: boolean;
+}): boolean;
 /**
  * Indicates whether a data item for a box-plot mean line series is valid.
  *
@@ -157,4 +171,7 @@ export declare function enforceSeriesVisibility(chart: SerialChart): void;
  * @returns The matching series config when found
  */
 export declare function findSeriesConfig(seriesInstance: Series, chartConfig?: WebChart): WebChartSeries | undefined;
+export declare const seriesUtilsPrivateFunctions: {
+    isValidBoxPlotCandle: typeof isValidBoxPlotCandle;
+};
 export {};

package/dist/chart-rendering/stable/chart-library-elements/symbols/index.d.ts

@@ -5,11 +5,11 @@ import { MappedFillSymbol, MappedLineSymbol, MappedMarkerSymbol, MappedTextSymbo
 /**
  * Maps Esri's symbol (SimpleLineSymbol, SimpleFillSymbol, SimpleMarkerSymbol) with color ramp options to an object informing the charting library **how to draw the symbol**
  *
- * @param props.symbol
- * @param props.defaultToColorFromRamp
- * @param props.colorRampIndex
- * @param props.isChartFillSymbol
- * @param props.chartBackgroundColor
+ * @param props.symbol The symbol to map
+ * @param props.defaultToColorFromRamp Indicates whether to use the color ramp to set the symbol's color if it is not defined.
+ * @param props.colorRampIndex The index of the color in the color ramp to use for the symbol's color.
+ * @param props.isChartFillSymbol Indicates whether the symbol is a fill symbol for a chart.
+ * @param props.chartBackgroundColor The background color of the chart.
  * @returns
  */
 export declare function mapSymbol<T extends ISimpleFillSymbol | ISimpleLineSymbol | ISimpleMarkerSymbol>(props: {

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

@@ -1,5 +1,5 @@
 import { Axis, AxisDataItem } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings } from '../../../../../utils';
+import { UtilsStrings } from '../../../../../utils';
 import { GuideTooltipFormatCallback } from '../../../../common/interfaces';
 export declare function initializeGuideTooltip(guide: AxisDataItem, guideIndex: number, axis: Axis): void;
 /**
@@ -13,5 +13,5 @@ export declare function initializeGuideTooltip(guide: AxisDataItem, guideIndex:
 export declare function updateGuideTooltipFormatter(props: {
     axis: Axis;
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): void;

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

@@ -1,5 +1,5 @@
 import { CandlestickSeries, ColumnSeries, LineSeries, PieSeries, StepLineSeries } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, QueryObject } from '../../../../utils';
+import { QueryObject, UtilsStrings } from '../../../../utils';
 import { IField, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, 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 | WebChartScatterplotSeries, TFormatter extends BarAndLineTooltipFormatCallback | BoxPlotTooltipFormatCallback | HistogramLabelFormatCallback | PieChartLabelFormatCallback | ScatterplotLabelFormatCallback> {
@@ -8,7 +8,7 @@ export interface TooltipProps<TSeries extends ColumnSeries | LineSeries | PieSer
     seriesConfig: TSeriesConfig;
     fieldList?: IField[];
     tooltipFormatter?: TFormatter;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface BarAndLineChartTooltipProps extends TooltipProps<ColumnSeries | LineSeries, WebChartBarChartSeries | WebChartLineChartSeries, BarAndLineTooltipFormatCallback> {
     setTimeBinningInfoWhenNotProvided?: boolean;

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

@@ -2,14 +2,14 @@ import { LineSeries } from '@amcharts/amcharts4/charts.js';
 import { Sprite } from '@amcharts/amcharts4/core.js';
 import { ScatterplotTooltipProps } from './interfaces';
 /**
- * Initializes the tooltip associated to the markers on a scatter plot
+ * Initializes the tooltip associated to the markers on a scatterplot
  *
  * @param marker The marker template on which to add the tooltip adapter
  * @param series The Series parent of the marker
  */
 export declare function initializeScatterplotTooltip(marker: Sprite, series: 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
  */

package/dist/chart-rendering/stable/index.d.ts

@@ -1,7 +1,38 @@
-import { CommonStrings, ErrorStrings, QueryObject } from '../../utils';
-import { WebChart, WebGaugeChart } from '@arcgis/charts-spec';
+import { Chart, GaugeChart, PieChart, XYChart } from '@amcharts/amcharts4/charts.js';
+import { WebChart, WebGaugeChart, WebChartTypes } from '@arcgis/charts-spec';
+import { CursorRange, ErrorStrings, QueryObject, UtilsStrings, ActionModes } from '../../utils';
 import { AnyConfigType, ChartInstance, ChartOptions, CreateChartProps, GlobalOptions, XYConfigWithILayer } from '../common/interfaces';
 import { ChartResult } from './interfaces';
+/**
+ * Applies the action mode (selection, zoom...) to the chart. It will change the cursor behavior as well as the
+ * selection events.
+ *
+ * @param props.chart The chart
+ * @param props.actionMode The action mode (selection, zoom...)
+ * @param props.cursorRange The cursor range (multi-axes, x-axis...)
+ */
+declare function setActionMode(props: {
+    chart: GaugeChart | PieChart | XYChart;
+    actionMode?: ActionModes;
+    cursorRange?: CursorRange;
+}): void;
+declare function activateMobileFeatures(chart: GaugeChart | PieChart | XYChart, enableResponsiveFeatures?: boolean): void;
+/**
+ * Initializes the chart axes
+ *
+ * @param props.chart The chart
+ * @param props.axesConfig The axes configuration
+ * @param props.chartType The chart type
+ * @param props.isRotated Indicates if the chart is rotated
+ * @param props.errorStrings The t9n error strings
+ */
+declare function initializeAxes(props: {
+    chart: Chart;
+    axesConfig: WebChart["axes"];
+    chartType?: WebChartTypes;
+    isRotated?: boolean;
+    errorStrings: ErrorStrings;
+}): Promise<void>;
 /**
  * Creates a chart
  *
@@ -23,7 +54,7 @@ export declare function createPieChart(props: {
     chartContainer?: HTMLElement;
     chartConfig?: WebChart;
     queryObject?: QueryObject;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
     options?: ChartOptions;
     globalOptions?: GlobalOptions;
@@ -37,7 +68,7 @@ export declare function createGaugeChart(props: {
     chartContainer?: HTMLElement;
     chartConfig?: WebGaugeChart;
     queryObject?: QueryObject;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
     options?: ChartOptions;
     globalOptions?: GlobalOptions;
@@ -53,3 +84,9 @@ export declare function createGaugeChart(props: {
  * @param props.t9nStrings The t9n strings
  */
 export declare function createChart(createChartProps: CreateChartProps<AnyConfigType>): Promise<ChartInstance>;
+export declare const stablePrivateFunctions: {
+    activateMobileFeatures: typeof activateMobileFeatures;
+    setActionMode: typeof setActionMode;
+    initializeAxes: typeof initializeAxes;
+};
+export {};

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

@@ -2,11 +2,11 @@ import { SpritePointerTypeEvent } from '@amcharts/amcharts4/.internal/core/Sprit
 import { PointerEvent, PointerTypeEvent } from '@amcharts/amcharts4/.internal/core/interaction/InteractionObjectEvents.js';
 import { Axis, Chart, GaugeChart, Legend, PieChart, PieSeries, XYChart } from '@amcharts/amcharts4/charts.js';
 import { Container, Label, MouseTouchEvent, Sprite, SpriteMouseTouchEvent, SpritePointEvent } from '@amcharts/amcharts4/core.js';
-import { CommonStrings, ErrorStrings, QueryObject } from '../../utils';
+import { ErrorStrings, QueryObject, UtilsStrings } from '../../utils';
 import { WebChart, WebChartDataTypes, WebChartTypes } from '@arcgis/charts-spec';
 import { AxisLabelFormatCallback, GaugeInnerLabelFormatCallback, GuideTooltipFormatCallback } from '../common/interfaces';
 import { FooterElements, HeaderElements } from './chart-library-elements/header-and-footer/interfaces';
-import { LoaderHandle } from './chart-library-elements/loading-indicator/interfaces';
+import { LoaderElements, LoaderHandle } from './chart-library-elements/loading-indicator/interfaces';
 export declare const EventTypes: {
     readonly Ready: "ready";
     readonly Hidden: "hidden";
@@ -72,6 +72,7 @@ export interface ChartElements {
     footerElements: FooterElements;
     legendElements: LegendElements;
     loaderHandle: LoaderHandle;
+    loaderElements: LoaderElements;
 }
 export interface ChartResult {
     chart: GaugeChart | PieChart | XYChart;
@@ -93,6 +94,6 @@ export interface UpdateAxesProps {
     yAxisLabelFormatter?: AxisLabelFormatCallback;
     secondaryYAxisLabelFormatter?: AxisLabelFormatCallback;
     gaugeInnerLabelFormatter?: GaugeInnerLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }

package/dist/chart-rendering/stable/selection/apply/index.d.ts

@@ -1,9 +1,27 @@
 import { SerialChart, PieChart, XYChart } from '@amcharts/amcharts4/charts.js';
-import { WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataTypes, WebGaugeChart, WebChartTypes } from '@arcgis/charts-spec';
 import { ErrorStrings, QueryObject, SelectionSource } from '../../../../utils';
 import { ChartOptions } from '../../../common/interfaces';
 import { ElementSelectionProps } from '../interface';
 import { ApplySelectionOnSeriesProps } from './interfaces';
+/**
+ * Checks whether a selection has been applied to all the series from a chart
+ *
+ * @param props.chart The chart
+ * @param props.chartType The chart type
+ * @param props.showMean Whether the mean lines are shown on the box plot
+ */
+declare function whetherSelectionAppliedToAllTheSeries(props: {
+    chart: SerialChart;
+    chartType?: WebChartTypes;
+    showMean?: boolean;
+}): boolean;
+/**
+ * Goes through a chart series to reset for each one of them the flag indicating whether a selection has been applied
+ *
+ * @param chart The chart referencing the series
+ */
+declare function resetSeriesSelectionFlag(chart: SerialChart): void;
 /**
  * Apply a selection on a specific series
  *
@@ -37,3 +55,8 @@ export declare function applySelection(props: {
     listSelectedElements: ElementSelectionProps[];
     selectionSource: SelectionSource;
 }): Promise<void>;
+export declare const selectionApplyPrivateFunctions: {
+    whetherSelectionAppliedToAllTheSeries: typeof whetherSelectionAppliedToAllTheSeries;
+    resetSeriesSelectionFlag: typeof resetSeriesSelectionFlag;
+};
+export {};

package/dist/chart-rendering/stable/selection/switch/index.d.ts

@@ -16,10 +16,10 @@ export declare function switchElementsSelectionState(elements: ListTemplate<Spri
  */
 export declare function switchColumnSelectionFromSeries(series: ColumnSeries, seriesIndex: number): ElementSelectionProps[];
 /**
- * Inverses all the selected data points in a line series or scatter plot.
+ * Inverses all the selected data points in a line series or scatterplot.
  *
- * @param series
- * @param seriesIndex
+ * @param series The series instance
+ * @param seriesIndex The series instance
  */
 export declare function switchSelectedMarkersFromSeries(series: LineSeries, seriesIndex: number): ElementSelectionProps[];
 /**

package/dist/chart-rendering/stable/utils/chart-lifecycle/index.d.ts

@@ -1,5 +1,5 @@
 import { Chart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, ErrorStrings, PieSlicesSymbols, QueryObject, ValidationStatus } from '../../../../utils';
+import { ErrorStrings, PieSlicesSymbols, QueryObject, UtilsStrings, ValidationStatus } from '../../../../utils';
 import { WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
 import { ChartOptions } from '../../../common/interfaces';
 /**
@@ -11,7 +11,7 @@ import { ChartOptions } from '../../../common/interfaces';
  * @param props.queryObject The query object (layer or layer view)
  * @param props.options The runtime chart options
  * @param props.currentValidationStatus The current validation status
- * @param props.commonStrings The t9n common strings
+ * @param props.utilsStrings The t9n utils strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function chartWillRender(props: {
@@ -22,7 +22,7 @@ export declare function chartWillRender(props: {
     queryObject?: QueryObject;
     options?: ChartOptions;
     currentValidationStatus?: ValidationStatus;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<{
     alteredConfig: WebChart | WebGaugeChart;

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

@@ -8,6 +8,13 @@ import { WebChart, WebGaugeChart } from '@arcgis/charts-spec';
  * @param errorStrings The object containing all the t9n error messages
  */
 export declare function handleCriticalErrors(chart: Chart, errorStrings: ErrorStrings): void;
+/**
+ * Sets the position attribute of the element containing the AmCharts SVG element
+ *
+ * @param chart
+ * @param position
+ */
+declare function setSvgContainerPosition(chart: Chart, position?: string): void;
 /**
  * Initializes the chart modal.
  *
@@ -35,13 +42,12 @@ export declare function isValidConfig(props: {
     errorStrings: ErrorStrings;
 }): Promise<ValidationStatus>;
 /**
- * Setting a message for the chart to display when it fails to create the chart due to bad data.
+ * Setting a message for the chart to raise and display, if prefer, when it fails to create the chart due to bad data.
  *
  * @param chart The chart
  * @param invalidType The type of invalid data
  * @param elementCount The number of elements related to the error
  * @param seriesCount The number of series in the chart
- * @param openModal Whether to open the modal or not
  * @param errorStrings The t9n error strings
  */
 export declare function raiseInvalidDataWarning(props: {
@@ -50,7 +56,6 @@ export declare function raiseInvalidDataWarning(props: {
     invalidType?: DataWarningKeywords;
     elementCount?: number;
     seriesCount?: number;
-    openModal?: boolean;
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**
@@ -77,3 +82,7 @@ export declare function raiseNoDataWarning(props: {
  * @param errorStrings The t9n error strings
  */
 export declare function raiseLogScaleNotCompatibleWarning(chart: Chart, errorStrings: ErrorStrings): Promise<void>;
+export declare const utilsErrorModalPrivateFunctions: {
+    setSvgContainerPosition: typeof setSvgContainerPosition;
+};
+export {};

package/dist/chart-rendering/stable/utils/localization/index.d.ts

@@ -1,7 +1,8 @@
 import { NumberFormatter, DateFormatter } from '@amcharts/amcharts4/core.js';
 import { ILocale } from '@amcharts/amcharts4/.internal/core/utils/Language.js';
 import { WebChartTypes } from '@arcgis/charts-spec';
-export declare function fetchChartLocaleStrings(locale?: string): Promise<ILocale>;
+import { SupportedLocale } from '@arcgis/toolkit/intl';
+export declare function fetchChartLocaleStrings(locale?: SupportedLocale): Promise<ILocale>;
 export declare function getFormatter(props: {
     type: typeof WebChartTypes.DateAxisFormat | typeof WebChartTypes.NumberAxisFormat;
     iLocale: ILocale;