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

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

@@ -1,9 +1,23 @@
 import { Axis, AxisDataItem, AxisRenderer, AxisRendererCircular } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings } from '../../../../utils';
-import { WebChartGuide } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../../utils';
+import { WebChartGuide, WebChartAxisTypes } from '@arcgis/charts-spec';
 import { AxisDataItemType } from '../../../common/guides-and-ticks';
 import { GuideTooltipFormatCallback } from '../../../common/interfaces';
 import { UpdateTicksProps } from './interfaces';
+/**
+ * Return the guide input value. If the input string represents a percentage value, calculate and return the equivalent decimal value.
+ *
+ * @param props.inputValue the input value
+ * @param props.axisType the type of axis.
+ * @param props.axisMin the axis min value; required when guide's start and end values are input as percentage
+ * @param props.axisMax the axis max value; required when guide's start and end values are input as percentage
+ */
+declare function convertGuideValue(props: {
+    inputValue: Date | number | string | null | undefined;
+    axisType: WebChartAxisTypes;
+    axisMin?: number;
+    axisMax?: number;
+}): Date | number | string | null | undefined;
 /**
  * Retrieve the start and end values of the guide from the config. The process also tries to convert
  * the value accordingly (depending on whether it's a Date, Percentage, decimal, etc).
@@ -27,6 +41,10 @@ export declare function updateGuidesArray<T extends Axis>(props: {
     axis: T;
     guides?: WebChartGuide[];
     guideTooltipFormatter?: GuideTooltipFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): void;
 export declare function updateTicksArray(props: UpdateTicksProps): void;
+export declare const guidesAndTicksPrivateFunctions: {
+    convertGuideValue: typeof convertGuideValue;
+};
+export {};

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

@@ -1,6 +1,33 @@
 import { Axis, AxisDataItem, AxisRendererCircular, GaugeChart } from '@amcharts/amcharts4/charts.js';
 import { Label } from '@amcharts/amcharts4/core.js';
 import { WebChartGaugeAxis } from '@arcgis/charts-spec';
+import { AutoResizeCallbackType } from './interfaces';
+/**
+ * Disposes a specific auto-resize callback. It disposes it and updates the chart's memory storage.
+ *
+ * @param chart The gauge chart
+ * @param type The type of callback to dispose
+ */
+declare function disposeResizeCallback(chart: GaugeChart, type: AutoResizeCallbackType): void;
+/**
+ * Adjusts a scale so a given font size can stay within the min/max limits and bounds defined for a label.
+ *
+ * @param props.scaleToAdjust The current scale value
+ * @param props.fontSize The base font size
+ * @param props.type The type of label to handle (axis label, inner label or first/last labels)
+ * @param props.chart The gauge chart
+ * @param props.labelList The label list
+ * @param props.axisConfig The axis config
+ * @returns The adjusted scale
+ */
+declare function adjustLabelScale(props: {
+    scaleToAdjust: number;
+    fontSize: number;
+    type: AutoResizeCallbackType;
+    chart: GaugeChart;
+    labelList: Label[];
+    axisConfig?: WebChartGaugeAxis;
+}): number;
 /**
  * Check the list of data items to make sure at least there is one has a value
  *
@@ -41,3 +68,8 @@ export declare function handleFirstAndLastLabelsAutoResizing(props: {
     axisConfig: WebChartGaugeAxis;
     axis: Axis<AxisRendererCircular>;
 }): void;
+export declare const utilsGaugePrivateFunctions: {
+    adjustLabelScale: typeof adjustLabelScale;
+    disposeResizeCallback: typeof disposeResizeCallback;
+};
+export {};

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

@@ -1,8 +1,15 @@
-import { SerialChart, Series } from '@amcharts/amcharts4/charts.js';
+import { SerialChart, Legend, Series } from '@amcharts/amcharts4/charts.js';
 import { Label, ListTemplate } from '@amcharts/amcharts4/core.js';
-import { WebChartSeriesType } from '@arcgis/charts-spec';
+import { WebChartSeriesType, WebChartTypes } from '@arcgis/charts-spec';
 import { LegendElements } from '../../interfaces';
 import { UpdateLegendProps } from './interfaces';
+/**
+ * Checks if the legend label and value label are misplaced, and swap them if so.
+ * The reason why it happens is not clear (see issue https://devtopia.esri.com/WebGIS/arcgis-charts/issues/4750)
+ *
+ * @param legend The legend
+ */
+declare function handleMisplacedLabels(legend: Legend): void;
 /**
  * Enforces the legend labels opacity according to their corresponding series visibility;
  * If series visibility is not provided, it will be defaulted to true.
@@ -10,7 +17,7 @@ import { UpdateLegendProps } from './interfaces';
  * If `sliceCategory` is defined, it will ignore check to seriesId
  *
  * @param props.labels List of labels that are used to match with it's corresponding series to set the opacity
- * @param props.seriesId Passing the seriesId first if label opacity is to be applied to (Bar chart, Histogram, Scatter Plot, Line chart or Combo chart)
+ * @param props.seriesId Passing the seriesId first if label opacity is to be applied to (Bar chart, Histogram, Scatterplot, Line chart or Combo chart)
  * @param props.sliceCategory Slice category value of any slice of the Pie Chart
  */
 export declare function reapplyLabelOpacity(props: {
@@ -24,6 +31,39 @@ export declare function reapplyLabelOpacity(props: {
  * @param series The chart series of which legend labels are to be set.
  */
 export declare function handleLegendLabelsOpacity(series: Series): void;
+/**
+ * Sets up legend items order for Histogram Or PieChart
+ *
+ * @param legend
+ */
+declare function orderHistogramOrPieChartLegendItems(legend: Legend): boolean;
+/**
+ * Builds the legend order key based on chart or chart config
+ * Each keyCombination has a total of 6 parts in the order of rotatedKey, rtlKey, stackedKeyType, legendPositionKey, axisTypeKey and orderByFieldsKey
+ *
+ * @param legend legend for building the key
+ */
+declare function buildLegendOrderKey(legend: Legend): string;
+/**
+ * Sets up Legend items order for Bar and Line charts
+ *
+ * @param legend the legend for bar/line chart
+ */
+declare function orderBarLineChartLegendItems(legend: Legend): boolean;
+/**
+ * Sets up the legend items in the proper order for the chart's stacking and rotation
+ *
+ * @param legendElements The legend elements
+ * @param chartType The chart type
+ */
+declare function orderLegendItems(legendElements: LegendElements, chartType?: WebChartTypes): void;
+/**
+ * Allows to modify the shape of the legend markers. By default they are rounded rectangles,
+ * and according to the `webChartLegend.roundMarkers` value they can be rendered as circles.
+ *
+ * @param legend The legend object containing the markers
+ */
+declare function updateLegendMarkerShape(legend: Legend): void;
 /**
  * Initializes the legend with default values and assign it to the chart.
  * Set adapters on some properties.
@@ -37,3 +77,12 @@ export declare function initializeLegend(chart: SerialChart, seriesConfig: WebCh
  * @param props
  */
 export declare function updateLegend(props: UpdateLegendProps): void;
+export declare const legendPrivateFunctions: {
+    handleMisplacedLabels: typeof handleMisplacedLabels;
+    updateLegendMarkerShape: typeof updateLegendMarkerShape;
+    orderHistogramOrPieChartLegendItems: typeof orderHistogramOrPieChartLegendItems;
+    orderBarLineChartLegendItems: typeof orderBarLineChartLegendItems;
+    orderLegendItems: typeof orderLegendItems;
+    buildLegendOrderKey: typeof buildLegendOrderKey;
+};
+export {};

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

@@ -1,6 +1,20 @@
 import { Legend } from '@amcharts/amcharts4/charts.js';
 import { OverEvent } from '../../../interfaces';
 import { UpdateLegendProps } from '../interfaces';
+/**
+ * Indicates if the legend is displayed in one column. It is always true on a legend being displayed on the side,
+ * and eventually when displayed on the top and bottom.
+ *
+ * @param legend The legend
+ */
+declare function isLegendDisplayedInOneColumn(legend: Legend): boolean;
+/**
+ * Indicates if the legend is displayed in one line.
+ *
+ * @param legend The legend
+ * @returns
+ */
+declare function isLegendDisplayedInOneLine(legend: Legend): boolean;
 /**
  * Initializes the pie chart legend value labels.
  *
@@ -15,3 +29,8 @@ export declare function initializePieChartLegendValueLabel(legend: Legend): void
  */
 export declare function updatePieChartLegendValueLabel(props: UpdateLegendProps): void;
 export declare function legendOverHandler(event: OverEvent): void;
+export declare const legendPiechartPrivateFunctions: {
+    isLegendDisplayedInOneColumn: typeof isLegendDisplayedInOneColumn;
+    isLegendDisplayedInOneLine: typeof isLegendDisplayedInOneLine;
+};
+export {};

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

@@ -39,7 +39,6 @@ export declare function updateLineElements(props: LineElementsProps): MappedLine
  * @param {FillElementsProps} props
  * @param {Sprite} props.element
  * @param {boolean} props.visible
- * @param {WebChartConfigFields} props.propertyFields
  * @param {boolean} props.defaultToColorFromRamp
  * @param {number} props.colorRampIndex
  * @param {ISimpleFillSymbol} props.fillSymbol

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

@@ -1,18 +1,32 @@
 import { SerialChart, Series } from '@amcharts/amcharts4/charts.js';
 import { ListTemplate } from '@amcharts/amcharts4/core.js';
 import { ChartOptions } from '../../../common/interfaces';
-import { LoaderHandle } from './interfaces';
-export declare function initializeLoader(chart: SerialChart, options?: ChartOptions): LoaderHandle;
+import { LoaderElements, LoaderHandle } from './interfaces';
+/** Initialize the loader and defines the nested functions
+ *
+ * @param chart The chart to which the loader is attached
+ * @param options The chart options
+ */
+export declare function initializeLoader(chart: SerialChart, options?: ChartOptions): {
+    loaderElements: LoaderElements;
+    loaderHandle: LoaderHandle;
+};
+/** Updates the loader and spinner colors
+ *
+ * @param loaderElements The loader elements
+ * @param updateOptions Update options
+ */
+export declare function updateLoaderAndSpinnerColors(loaderElements: LoaderElements, updateOptions?: ChartOptions): void;
 /**
  * Checks whether all the non-overlay series are `"ready"`
  *
- * @param series
+ * @param series The series to check
  */
 export declare function whetherSeriesReady(series: ListTemplate<Series>): boolean;
 /**
  * Attaches a hide-loader handle to the input series's `"ready"` event
  *
- * @param series
- * @param hideLoaderHandle
+ * @param seriesInstance The series instance to attach the loader handle to
+ * @param hideLoaderHandle The handle to hide the loader
  */
 export declare function attachLoaderHandle(seriesInstance: Series, hideLoaderHandle: LoaderHandle["hideLoader"]): void;

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
  */