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

package/dist/chart-rendering/common/data/utils/summarize-data/index.d.ts

@@ -1,7 +1,36 @@
-import { IField, WebChart, WebChartDataItem, WebChartQuery } from '@arcgis/charts-spec';
-import { DataInfo, QueryObject, LimitBehavior } from '../../../../../utils';
+import { IExtent, IField, IStatisticDefinition, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataItem, WebChartDataItemValue, WebChartLineChartSeries, WebChartPieChartSeries, WebChartQuery, WebChartSeriesType } from '@arcgis/charts-spec';
+import { default as Graphic } from '@arcgis/core/Graphic';
+import { DataInfo, QueryObject, ChartSubType, LimitBehavior } from '../../../../../utils';
 import { FetchDataProps } from '../../../interfaces';
 import { ProcessUniqueQueryProps } from './interfaces';
+/**
+ * Returns the feature extent and the extent key for a feature.
+ *
+ * @param props.feature The feature to fetch the extent from
+ * @param props.splitByField The split-by field from the config
+ * @param props.chartSubType The chart subtype
+ * @returns
+ */
+declare function getFeatureGeometryExtent(props: {
+    feature: Graphic;
+    splitByField?: string;
+    chartSubType?: ChartSubType;
+}): {
+    featureExtent: IExtent | undefined;
+    featureExtentKey: string;
+};
+/**
+ * Regroups all the data items related to a same category together.
+ *
+ * @param props.input The scattered list of data items
+ * @param props.x The category field used to group the data
+ * @param props.splitByField The split-by field from the config
+ */
+declare function mergeDataItems(props: {
+    input: WebChartDataItem[];
+    x: string;
+    splitByField?: string;
+}): WebChartDataItem;
 /**
  * Group a dataset over a x field
  *
@@ -18,6 +47,23 @@ export declare function groupDataByCategory(props: {
     x: string;
     splitByField?: string;
 }): WebChartDataItem[];
+/**
+ * Calculates for each data item (category) for bar and line:
+ *   - the category's sum
+ *   - the percent for the first series
+ *
+ * @param data The chart's data
+ * @param seriesConfig The series config
+ * @returns
+ */
+declare function calculateSeriesPercent(data: WebChartDataItem[], seriesConfig: WebChartBarChartSeries[] | WebChartBoxPlotSeries[] | WebChartLineChartSeries[] | WebChartPieChartSeries[]): WebChartDataItem[];
+/**
+ * Calculate the Interquartile Range (IQR) for the given attributes and return the processed attributes objects with calculated IQR property .
+ *   IQR is the difference between the first quartile and the third quartile.
+ *   `@param` {WebChartBoxPlotSeries[]} seriesConfig - The list of series in the box plot chart config
+ *   `@param` {WebChartDataItem} attributes - The data object containing the first and third quartile values.
+ */
+declare function calculateInterQuartileRange(seriesConfig: WebChartBoxPlotSeries[], attributes: WebChartDataItem): WebChartDataItem;
 /**
  * Assigns the specified property to a best-guessed value from the query results.
  * If its upper-cased or lowercased corresponding properties (that are not coming from the config) exist, remove them as well.
@@ -26,6 +72,80 @@ export declare function groupDataByCategory(props: {
  * @param propertyNames The properties referencing the proper case
  */
 export declare function restoreAttributesCase(attributes: WebChartDataItem, propertyNames: (string | undefined)[] | string): void;
+/**
+ * Builds a list of the outStatisticFieldName used in the config and restore their case to prevent a shift between
+ * the query results' case and the config's.
+ * See issues:
+ * - https://devtopia.esri.com/webgis/arcgis-charts/issues/6038
+ * - https://devtopia.esri.com/WebGIS/arcgis-charts/issues/7837
+ *
+ * @param attributes The attributes associated with a feature returned from the query result
+ * @param seriesConfig The series config
+ */
+declare function restoreStatFieldNamesCase(attributes: WebChartDataItem, seriesConfig: WebChartSeriesType[]): void;
+/**
+ * This function goes through the properties of the dataItem and compare them with the outStatisticFieldNames
+ * in the list of outStatistics. If a match is found, swap that property to its corresponding onStatisticField
+ * property instead.
+ *
+ * Refer to issue https://devtopia.esri.com/webgis/arcgis-charts/issues/6018 for details
+ *
+ * @param dataItem The dataItem of which properties may change.
+ * @param outStatistics The list of outStatistics to find the matching onStatisticFields for the properties in the dataItem.
+ */
+declare function swapStatFieldNamesToStatisticFields(dataItem: WebChartDataItem, outStatistics: IStatisticDefinition[]): WebChartDataItem;
+/**
+ * Since the series's dataFields.valueY was set to `${y}_${splitByValue},
+ * we need to add a new property to the dataItem using that format and populate it with the value from to the y property.
+ *
+ * @param props.dataItem The dataItem of which properties are to be manipulated.
+ * @param props.splitByField The split-by-field
+ * @param props.y The y property for all series.
+ */
+declare function renameYFieldForSplitByNoAggregation(props: {
+    dataItem: WebChartDataItem;
+    splitByField: string;
+    y: string;
+}): void;
+/**
+ * Removes a prefix added to the box plot out statistic field names by `buildUniqueBoxPlotOutStatistics()`.
+ * The prefix was added to avoid the queries to fail on some specific services. Refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/7376
+ *
+ * @param attributes The attributes to be modified
+ * @param y The numeric field name used as a prefix
+ */
+declare function removeBoxPlotOutStatisticFieldNamePrefix(attributes: WebChartDataItem, y: string): void;
+/**
+ * Trims the number of categories based on the provided `maxCategoryCount`. This is possible only for charts having
+ * a query response for which each result is a category. If a result contains potentially multiple categories it will
+ * be handled by the `limitCategories()` function.
+ *
+ * @param props.queryResponse The query response to be trimmed
+ * @param props.chartConfig The chart configuration
+ * @param props.maxCategoryCount The maximum number of categories to keep
+ */
+declare function trimCategories(props: {
+    queryResponse: Graphic[];
+    chartConfig: WebChart;
+    maxCategoryCount?: number;
+}): Graphic[];
+/**
+ * Limits the number of categories based on the provided `maxCategoryCount`.
+ * This function is called for each data item and will decide whether to keep the item or not.
+ *
+ * @param props.attributes The attributes to be checked
+ * @param props.uniqueCategoryList The list of unique categories to keep track of how many categories have been processed
+ * @param props.maxCategoryCount The maximum number of categories to keep
+ * @param props.x The x field
+ * @param props.chartSubType The chart sub-type
+ */
+declare function limitCategories(props: {
+    attributes: WebChartDataItem;
+    uniqueCategoryList: Set<WebChartDataItemValue>;
+    maxCategoryCount?: number;
+    x: string;
+    chartSubType: ChartSubType;
+}): boolean;
 /**
  * Function executing a unique query and processing its results.
  *
@@ -72,6 +192,12 @@ export declare function sortFetchedData(props: {
  * @param props
  */
 export declare function fetchFinishedGenericChartData(props: FetchDataProps): Promise<DataInfo>;
+/**
+ * Fetching the data for a heat chart.
+ * It fetches the data from the attribute bins and processes it to match the heat chart data structure.
+ * @param props The list of properties required to fetch the data
+ */
+export declare function fetchFinishedHeatChartData(props: FetchDataProps): Promise<DataInfo>;
 /**
  * Fetching the data for specifically a line chart using time binning options.
  *
@@ -97,3 +223,16 @@ export declare function fetchFinishedGenericChartSelectionData(props: FetchDataP
  * @param props.abortKey The abort key to cancel queries
  */
 export declare function fetchFinishedBoxPlotSelectionData(props: FetchDataProps): Promise<DataInfo>;
+export declare const commonUtilsSummarizeDataPrivateFunctions: {
+    restoreStatFieldNamesCase: typeof restoreStatFieldNamesCase;
+    mergeDataItems: typeof mergeDataItems;
+    removeBoxPlotOutStatisticFieldNamePrefix: typeof removeBoxPlotOutStatisticFieldNamePrefix;
+    calculateSeriesPercent: typeof calculateSeriesPercent;
+    calculateInterQuartileRange: typeof calculateInterQuartileRange;
+    getFeatureGeometryExtent: typeof getFeatureGeometryExtent;
+    swapStatFieldNamesToStatisticFields: typeof swapStatFieldNamesToStatisticFields;
+    renameYFieldForSplitByNoAggregation: typeof renameYFieldForSplitByNoAggregation;
+    trimCategories: typeof trimCategories;
+    limitCategories: typeof limitCategories;
+};
+export {};

package/dist/chart-rendering/common/data/utils/summarize-data/time-binning/index.d.ts

@@ -31,6 +31,7 @@ export declare function getTimeBinningStatistics(props: {
  * @param props.nullPolicy The null policy
  * @param props.x The series x field
  * @param props.y The series y field
+ * @param props.queryObject The query object used to fetch the data
  */
 export declare function mapTemporalBinningQueryAttributeBinsResults(props: {
     queryResults: __esri.AttributeBinsGraphic[];
@@ -39,7 +40,8 @@ export declare function mapTemporalBinningQueryAttributeBinsResults(props: {
     nullPolicy?: WebChartNullPolicyTypes;
     x: string;
     y?: string;
-}): WebChartDataItem[];
+    queryObject?: QueryObject;
+}): Promise<WebChartDataItem[]>;
 /**
  * Maps query results into a WebChartDataItem[] for a chart using the charts solution for temporal binning.
  * @param props.queryObject The object to query (layer or feature layer view)

package/dist/chart-rendering/common/defaults/interfaces.d.ts

@@ -209,6 +209,8 @@ export interface CommonChartDefaults {
     generalFontSize: number;
     chartEllipsis: string;
     backgroundColor: Readonly<EsriColor>;
+    lightTextColor: Readonly<EsriColor>;
+    darkTextColor: Readonly<EsriColor>;
     /** Note: Gauge has its own default value. See `gaugeMinGridDistance` */
     xAxisMinGridDistance: number;
     xCategoryAxisMinGridDistance: number;
@@ -289,6 +291,8 @@ export interface CommonChartDefaults {
     options: {
         /** represents default value to use for when `hideEmptySeries` is not defined in the `options` object. */
         hideEmptySeries: boolean;
+        /** indicates whether to automatically inverse the data label text color when it's too dark or too light */
+        autoInverseDataLabelTextColor: boolean;
         /** represents default value to use for when `replaceNoValueCategoryWithZero` is not defined in the `options` object. */
         replaceNoValueCategoryWithZero: boolean;
     };

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

@@ -2,7 +2,7 @@ import { DataWarningObject, PieSlicesSymbols, SelectionData, SeriesSymbolsMap, V
 import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChart, WebChartDataItem, WebChartDataTypes, WebChartSeriesType } from '@arcgis/charts-spec';
 /**
  * Sending an event carrying the chart processed data at any data update.
- * Contains the statistics for Histogram and Scatter Plot
+ * Contains the statistics for Histogram and Scatterplot
  *
  * @param props.data The data payload
  * @param props.seriesConfig The array of series config

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

@@ -1,8 +1,8 @@
 import { IField, SupportedLayer, WebBoxPlot, WebChart, WebChartDataFilters, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartPieChartSlice, WebChartQuery, WebGaugeChart } from '@arcgis/charts-spec';
 import { default as MapView } from '@arcgis/core/views/MapView';
 import { default as SceneView } from '@arcgis/core/views/SceneView';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
-import { AbortControllerKeyType, ActionModes, BinnedServerData, ChartElementLimit, CommonStrings, CursorRange, ErrorStrings, LoaderColors, QueryObject, SelectionData, SelectionTheme } from '../../utils';
+import { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { AbortControllerKeyType, ActionModes, BinnedServerData, ChartElementLimit, CursorRange, ErrorStrings, LoaderColors, QueryObject, SelectionData, SelectionTheme, UtilsStrings } from '../../utils';
 export declare const uuidNamespace: string;
 export interface NotifyOptions {
     closable?: boolean;
@@ -11,7 +11,7 @@ export type AnyConfigType = WebBoxPlot | WebChart | WebGaugeChart;
 export type ConfigWithILayer = WebBoxPlot | WebChart | WebGaugeChart;
 export type XYConfigWithILayer = WebBoxPlot | WebChart;
 export interface T9NStrings {
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }
 export interface CreateChartProps<ConfigType extends AnyConfigType> {
@@ -52,7 +52,7 @@ export interface UpdateChartElementsProps {
     forceDataUpdate?: boolean;
     updateOptions?: ChartOptions;
     updateGlobalOptions?: GlobalOptions;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }
 export interface ExportChartImageOptions {
     format: "jpg" | "png";
@@ -83,7 +83,7 @@ export type PieChartLabelFormatCallback = (category: string, value?: number, per
 export type PieChartLegendValueLabelFormatCallback = (value?: number, percent?: number) => string;
 /** Describes the signature of the callback function used to customize the histogram tooltips */
 export type HistogramLabelFormatCallback = (count: number, binMinValue: number, binMaxValue: number) => string;
-/** Describes the signature of the callback function used to customize the scatter plot tooltips */
+/** Describes the signature of the callback function used to customize the scatterplot tooltips */
 export type ScatterplotLabelFormatCallback = (x: number, y: number, sizePolicyValue?: number) => string;
 export interface BarAndLineTooltipFormatCallbackProps {
     seriesName: string;
@@ -130,39 +130,48 @@ export type PreRenderCallback = (props: {
     data?: WebChartDataTypes;
     slices?: WebChartPieChartSlice[];
 }) => Promise<WebChart | WebGaugeChart>;
-/** Represents the options available to handle specific messages displayed by the chart. */
-export interface MessageOptions {
+/**
+ * Represents options regarding the display of information about the chart.
+ */
+export interface DisplaySettings {
     /**
-     * Whether to display a warning message over the chart when the chart's data set is empty.
+     * Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an
+     * axis when the data contains values <= 0).
      *
      * @default true
      */
-    displayMessageWhenNoData?: boolean;
+    showUIMessages?: boolean;
+}
+/**
+ * Represents options regarding the data query for the chart.
+ */
+export interface QuerySettings {
     /**
      * Whether to consider a `null` statistic as valid. If set to `false` and the data has only
      * null values, the chart's dataset will be considered empty:
      * - the corresponding warning event will be sent
-     * - the "no data" message will be displayed (unless `displayMessageWhenNoData` is set to `false`)
+     * - the "no data" message will be displayed (unless `showUIMesssages` is set to `false`)
      *
      * @default false
      */
     nullAsValid?: boolean;
-    /**
-     * Whether to display a warning message over the chart when the logarithmic scale can't be applied to an
-     * axis when the data contains values <= 0.
-     *
-     * @default true
-     */
-    displayMessageWhenLogAxisNotPossible?: boolean;
+}
+/** JSON representation of the runtime chart options for the update or initialization. */
+export interface ChartOptions {
     /**
      * Whether to allow the object id to be used as a statistic other than COUNT.
      *
      * @default false
      */
     allowUsingObjectIdStat?: boolean;
-}
-/** JSON representation of the runtime chart options for the update or initialization. */
-export interface ChartOptions {
+    /**
+     * Represents options regarding the display of information about the chart.
+     */
+    displaySettings?: DisplaySettings;
+    /**
+     * Represents query options to retrieve data for the chart.
+     */
+    querySettings?: QuerySettings;
     /**
      * A property representing the selection to apply on the chart.
      * The properties are considered in the following order:
@@ -211,6 +220,12 @@ export interface ChartOptions {
      * default is true;
      */
     autoRecreateChart?: boolean;
+    /**
+     * Indicates whether to automatically inverse the data label text color when it's too dark or too light.
+     *
+     * @remark Currently this feature is only available for stacked bar series and pie charts with `dataLabelsInside` set to true.
+     */
+    autoInverseDataLabelTextColor?: boolean;
     /** optional create message to be displayed in the chart container. */
     createMessage?: string;
     /**
@@ -243,7 +258,7 @@ export interface ChartOptions {
     /**
      * Used to customize the chart's limits, especially the maximum number of elements (bars, markers...) to be displayed.
      * The chart's behavior once that limit is reached can be adjusted through the `behaviorAfterLimit` nested property, to either reject the creation
-     * or update of the chart, or render the elements up to the given limits. Available on all charts but scatter plot and histogram.
+     * or update of the chart, or render the elements up to the given limits. Available on all charts but scatterplot and histogram.
      */
     chartLimits?: ChartElementLimit;
     /**
@@ -335,8 +350,6 @@ export interface ChartOptions {
      * be interpreted properly.
      */
     gaugeInnerLabelFormatter?: GaugeInnerLabelFormatCallback;
-    /** Represents the options available to handle specific messages displayed by the chart. */
-    messageOptions?: MessageOptions;
     /**
      * Used to disable the toggling of legend items for XYChart series, Pie slices,
      * Histogram overlays, and Scatter-plot trend line.

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

@@ -40,6 +40,21 @@ export declare function generateTruncationCallback(characterLimit?: number | nul
  * @param value The value containing the brackets to escape
  */
 export declare function escapeBrackets(value: string): string;
+/**
+ * Generate a `CSS` styling string displaying the `font-style` property
+ *
+ * @param fontStyle The font style
+ * @param format Describes the expected output format
+ */
+declare function mapFontStyle(fontStyle?: string, format?: "amChartsV4" | "amChartsV5" | "html"): string;
+/**
+ * Map ITextSymbol's `kerning` property to letter-spacing
+ * See MDN's SVG [letter-kerning](https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/letter-spacing)
+ *
+ * @param kerning Whether to enable kerning
+ * @param format Describes the expected output format
+ */
+declare function mapKerning(kerning?: boolean, format?: "amChartsV4" | "amChartsV5" | "html"): string;
 /**
  * Attaches inline css styling to a string.
  * The output format depends on the props.type:
@@ -68,3 +83,8 @@ export declare function attachInlineCSS(props: {
  * @param input The input string to transform
  */
 export declare function kebabize(input?: string): string | undefined;
+export declare const commonLabelPrivateFunctions: {
+    mapFontStyle: typeof mapFontStyle;
+    mapKerning: typeof mapKerning;
+};
+export {};

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

@@ -1,6 +1,27 @@
 import { WebChartBin, WebChartDataItem, WebChartTypes } from '@arcgis/charts-spec';
 import { ChartSubType } from '../../../utils';
 import { ChartOptions } from '../interfaces';
+/**
+ * This function helps matching a list of selection data with a specific box plot element (candle stick, marker) represented by its data context.
+ *
+ * @param props.elementDataContext The data context to test upon the selection items
+ * @param props.chartSubType The chart sub type
+ * @param props.layerOidField The layer Object Id
+ * @param props.xAxisField The x-axis field
+ * @param props.yAxisField The y-axis field
+ * @param props.splitBy The split-by clause (field = value)
+ * @param props.showOutliers Whether the outliers are shown on the chart
+ * @returns A predicate for Array.some to be used by `isElementPartOfSelection()`
+ */
+declare function getBoxPlotSelectionPredicate(props: {
+    elementDataContext?: WebChartBin | WebChartDataItem;
+    chartSubType?: ChartSubType;
+    layerOidField?: string;
+    xAxisField?: string;
+    yAxisField?: string;
+    splitBy?: string;
+    showOutliers?: boolean;
+}): ((oneSelectedItem: WebChartDataItem, selectedItemIndex: number) => boolean) | undefined;
 /**
  * Indicates whether a slice data context matches a selection data context
  *
@@ -44,3 +65,7 @@ export declare function getSelectedElementData(props: {
     showOutliers?: boolean;
     isFeatureCollectionLayer: boolean;
 }): WebChartDataItem;
+export declare const commonSelectionPrivateFunctions: {
+    getBoxPlotSelectionPredicate: typeof getBoxPlotSelectionPredicate;
+};
+export {};

package/dist/chart-rendering/common/series/pie-chart/index.d.ts

@@ -1,4 +1,4 @@
-import { CommonStrings, PieSlicesSymbols } from '../../../../utils';
+import { PieSlicesSymbols, UtilsStrings } from '../../../../utils';
 import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '@arcgis/charts-spec';
 /**
  * Generates an id for a slice from a non aggregated slice.
@@ -105,7 +105,7 @@ export declare function computeSliceLabel(props: {
     isPieFromFields: boolean;
     labelUpdateNeeded: boolean;
     colorMatch: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): string | undefined;
 /**
  * Indicates whether an update is necessary on the pie chart slice group

package/dist/chart-rendering/common/series/pie-chart/slice-grouping/index.d.ts

@@ -1,7 +1,7 @@
-import { CommonStrings } from '../../../../../utils';
+import { UtilsStrings } from '../../../../../utils';
 import { WebChartDataItem, WebChartPieChartSeries } from '@arcgis/charts-spec';
 export declare function getPieChartGroupOfSlicesData(props: {
     data: WebChartDataItem[];
     seriesConfig: WebChartPieChartSeries[];
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
 }): WebChartDataItem[];

package/dist/chart-rendering/common/t9n/misc/index.d.ts

@@ -0,0 +1,7 @@
+import { CommonStrings } from '../../../../utils';
+/**
+ * Fetches the translation JSON from common assets.
+ * @param locale The locale to fetch, e.g. "messages.en.json"
+ * @throws {Error} If the file cannot be loaded
+ */
+export declare function fetchT9nJson(locale: string): Promise<CommonStrings>;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/chart-rendering/next/chart-library-elements/labels/axis-label/index.d.ts

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

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

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