@arcgis/charts-components 4.34.0-next.12 → 4.34.0-next.120

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 { IField, SupportedLayer, WebBoxPlot, WebChart, WebChartDataFilters, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartPieChartSlice, WebChartQuery, WebGaugeChart } from '../../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;
@@ -105,6 +105,8 @@ export interface BoxPlotTooltipFormatCallbackProps {
 export type BoxPlotTooltipFormatCallback = (props: BoxPlotTooltipFormatCallbackProps) => string;
 /** Describes the signature of the callback function used to customize the bar and line chart plot data labels */
 export type BarAndLineDataLabelFormatCallback = (statValue: number, percent?: number) => string;
+/** Describes the signature of the callback function used to customize the heat chart data labels */
+export type HeatChartDataLabelFormatCallback = (statValue: number, x?: string, y?: string) => string;
 export interface GuideTooltipFormatCallbackProps {
     guideName: string;
     start: Date | number | string;
@@ -130,39 +132,30 @@ 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 {
+/** JSON representation of the runtime chart options for the update or initialization. */
+export interface ChartOptions {
     /**
-     * Whether to display a warning message over the chart when the chart's data set is empty.
+     * Whether to allow the object id to be used as a statistic other than COUNT.
      *
-     * @default true
+     * @default false
      */
-    displayMessageWhenNoData?: boolean;
+    allowUsingObjectIdStat?: boolean;
     /**
      * 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.
+     * 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
      */
-    displayMessageWhenLogAxisNotPossible?: boolean;
-    /**
-     * 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 {
+    showUIMessages?: boolean;
     /**
      * A property representing the selection to apply on the chart.
      * The properties are considered in the following order:
@@ -211,6 +204,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 +242,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 +334,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

@@ -1,4 +1,4 @@
-import { WebChartTextSymbol, WebChartLabelBehavior } from '@arcgis/charts-spec';
+import { WebChartTextSymbol, WebChartLabelBehavior } from '../../../spec';
 import { LabelProperties } from '../defaults/interfaces';
 import { AxisLabelFormatCallback } from '../interfaces';
 /**
@@ -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/math/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartBin } from '@arcgis/charts-spec';
+import { WebChartBin } from '../../../spec';
 import { NormalDistributionProps } from './interfaces';
 /**
  * Function Definition: https://js.tensorflow.org/api/0.6.1/#linspace

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

@@ -1,6 +1,6 @@
 import { ActionModes, BinnedServerData, QueryObject, SelectionIndexes } from '../../../utils';
-import { IField, OverlayTerms, ScatterplotTrendLineData, TimeIntervalInfo, WebChart, WebChartDataItem, WebChartLabelBehavior, WebChartQuery, WebChartStackedKinds, WebChartTypes } from '@arcgis/charts-spec';
-import { AxisLabelFormatCallback, BarAndLineDataLabelFormatCallback, BarAndLineTooltipFormatCallback, BoxPlotTooltipFormatCallback, ChartOptions, GuideTooltipFormatCallback, HistogramLabelFormatCallback, PieChartLabelFormatCallback, PieChartLegendValueLabelFormatCallback, ScatterplotLabelFormatCallback } from '../interfaces';
+import { IField, OverlayTerms, ScatterplotTrendLineData, TimeIntervalInfo, WebChart, WebChartDataItem, WebChartLabelBehavior, WebChartQuery, WebChartStackedKinds, WebChartTypes } from '../../../spec';
+import { AxisLabelFormatCallback, BarAndLineDataLabelFormatCallback, BarAndLineTooltipFormatCallback, BoxPlotTooltipFormatCallback, ChartOptions, GuideTooltipFormatCallback, HeatChartDataLabelFormatCallback, HistogramLabelFormatCallback, PieChartLabelFormatCallback, PieChartLegendValueLabelFormatCallback, ScatterplotLabelFormatCallback } from '../interfaces';
 export interface CommonStorageType {
     legend: {
         pieChartLegendValueLabelsFormatter?: PieChartLegendValueLabelFormatCallback;
@@ -52,6 +52,7 @@ export interface CommonStorageType {
         barAndLineTooltipFormatter?: BarAndLineTooltipFormatCallback;
         barSeriesDataLabelFormatter?: BarAndLineDataLabelFormatCallback;
         lineSeriesDataLabelFormatter?: BarAndLineDataLabelFormatCallback;
+        heatChartDataLabelFormatter?: HeatChartDataLabelFormatCallback;
         scatterplotTooltipFormatter?: ScatterplotLabelFormatCallback;
         scatterplotDataLabelFormatter?: ScatterplotLabelFormatCallback;
         histogramTooltipFormatter?: HistogramLabelFormatCallback;

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

@@ -1,6 +1,27 @@
-import { WebChartBin, WebChartDataItem, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartBin, WebChartDataItem, WebChartTypes } from '../../../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/box-plot/index.d.ts

@@ -1,5 +1,5 @@
 import { ChartSubType } from '../../../../utils';
-import { WebChartDataItem, RESTRendererType } from '@arcgis/charts-spec';
+import { WebChartDataItem, RESTRendererType } from '../../../../spec';
 /**
  * Determines whether to set the whisker (step line series) with a default color. It is necessary as whiskers from a same series
  * can't use different colors, while their associated candle stick series can.

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

@@ -1,5 +1,5 @@
 import { QueryObject, ChartSubType } from '../../../utils';
-import { WebBoxPlot, WebChart, WebChartDataItem, WebChartHistogramSeries, WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { WebBoxPlot, WebChart, WebChartDataItem, WebChartHistogramSeries, WebChartTemporalBinningUnits } from '../../../spec';
 import { EsriColor } from '../types';
 /**
  * Returns true if dataTransformationType changed

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

@@ -1,5 +1,5 @@
-import { CommonStrings, PieSlicesSymbols } from '../../../../utils';
-import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '@arcgis/charts-spec';
+import { PieSlicesSymbols, UtilsStrings } from '../../../../utils';
+import { IField, ISimpleFillSymbol, WebChart, WebChartDataItem, WebChartPieChartSeries, WebChartPieChartSlice } from '../../../../spec';
 /**
  * Generates an id for a slice from a non aggregated slice.
  * it will generate `arcgis-charts-slice-id-<object id>` or `arcgis-charts-slice-id-<slice index>`
@@ -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 { WebChartDataItem, WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../../../utils';
+import { WebChartDataItem, WebChartPieChartSeries } from '../../../../../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,5 +1,5 @@
-import { CommonStrings } from '../../../utils';
-import { IField, WebChart } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../utils';
+import { IField, WebChart } from '../../../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/common/types/index.d.ts

@@ -1 +1 @@
-export type { Color as EsriColor } from '@arcgis/charts-spec';
+export type { Color as EsriColor } from '../../../spec';

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

@@ -1,6 +1,6 @@
 import { RadarChart } from '@amcharts/amcharts5/radar.js';
 import { ErrorStrings } from '../../../../../utils';
-import { WebChart } from '@arcgis/charts-spec';
+import { WebChart } from '../../../../../spec';
 import { UpdateGaugeAxisProps } from './interfaces';
 /**
  * Updates the gauge axis
@@ -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/gauge/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { RadarChart } from '@amcharts/amcharts5/radar.js';
-import { WebGaugeChart } from '@arcgis/charts-spec';
+import { WebGaugeChart } from '../../../../../spec';
 import { GaugeInnerLabelFormatCallback } from '../../../../common/interfaces';
 import { UpdateAxesCommonProps } from '../../../interfaces';
 export interface UpdateGaugeAxisProps extends UpdateAxesCommonProps<RadarChart, WebGaugeChart> {

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 { WebChart, WebChartDataTypes } from '../../../../../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

@@ -2,8 +2,8 @@ import { Root } from '@amcharts/amcharts5';
 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 { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes, WebChartLabelBehavior, WebChartTypes } from '../../../../spec';
+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/category-axis/index.d.ts

@@ -1,5 +1,5 @@
 import { XYChart } from '@amcharts/amcharts5/xy.js';
-import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions } from '../../../../../../../spec';
 import { AxisLabelFormatCallback } from '../../../../../../common/interfaces';
 /**
  * Generates the default label formatter for the category axis
@@ -13,3 +13,15 @@ export declare function generateDefaultCategoryAxisFormatter(props: {
     formatOptions: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
     isNonAggregatedChart?: boolean;
 }): AxisLabelFormatCallback;
+/**
+ * Generates the default label formatter for the category axis labels for heat charts.
+ *
+ * @param props.chart The chart
+ * @param props.isXAxis Whether the formatter is for the x-axis or y-axis
+ * @param props.formatOptions The format options
+ */
+export declare function generateDefaultCategoryAxisFormatterForHeatChart(props: {
+    chart: XYChart;
+    isXAxis?: boolean;
+    formatOptions: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
+}): AxisLabelFormatCallback;

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

@@ -1,6 +1,6 @@
 import { Chart } from '@amcharts/amcharts5';
 import { AxisRenderer, DateAxis } from '@amcharts/amcharts5/xy.js';
-import { DateTimeFormatOptions } from '@arcgis/charts-spec';
+import { DateTimeFormatOptions } from '../../../../../../../spec';
 /**
  * Returns true if the input chart is a XYChart and uses a date axis
  * @param chart The instance of chart to be tested

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 { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '../../../../../../spec';
 import { ErrorStrings } from '../../../../../../utils';
-import { WebChart, WebChartAxis, WebChartDataItem, WebChartDataItemValue, WebChartTypes } from '@arcgis/charts-spec';
 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

@@ -1,6 +1,6 @@
 import { Root, SerialChart, Series, Tooltip } from '@amcharts/amcharts5';
 import { Axis, AxisRenderer, ValueAxis, XYChart } from '@amcharts/amcharts5/xy.js';
-import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartDataTypes } from '../../../../../../spec';
 /**
  * Indicates whether the axes need to be recreated.
  *
@@ -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/cursor/index.d.ts

@@ -2,7 +2,7 @@ import { Chart, Root } from '@amcharts/amcharts5';
 import { RadarCursor } from '@amcharts/amcharts5/radar.js';
 import { XYCursor } from '@amcharts/amcharts5/xy.js';
 import { CursorRange, ActionModes } from '../../../../utils';
-import { WebChart, WebChartCursorCrosshair } from '@arcgis/charts-spec';
+import { WebChart, WebChartCursorCrosshair } from '../../../../spec';
 /**
  * Creates cursor on the chart if its compatible
  * Only for XYChart

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

@@ -1,6 +1,6 @@
 import { Axis, AxisRenderer } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings } from '../../../../utils';
-import { WebChartGuide } from '@arcgis/charts-spec';
+import { UtilsStrings } from '../../../../utils';
+import { WebChartGuide } from '../../../../spec';
 import { GuideTooltipFormatCallback } from '../../../common/interfaces';
 /**
  * Retrieve the start and end values of the guide from the config. The process also tries to convert
@@ -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/header-and-footer/index.d.ts

@@ -1,5 +1,5 @@
 import { Chart, Root } from '@amcharts/amcharts5';
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 import { HeaderProps } from './interfaces';
 /**
  * Initializes the header container and its children

package/dist/chart-rendering/next/chart-library-elements/header-and-footer/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 export interface HeaderProps {
     title?: WebChartText;
     subtitle?: WebChartText;

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 { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '../../../../../spec';
 import { ChartTypes } from '../../../../../utils';
-import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
 /**
  * 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/heat-chart/index.d.ts

@@ -0,0 +1,13 @@
+import { DataLabelUpdateProps } from '../interfaces';
+/**
+ * initialize a series data labels
+ *
+ * @param props.DataLabelUpdateProps props to pass to initialize series data labels
+ */
+export declare function initializeHeatChartDataLabel(props: DataLabelUpdateProps): void;
+/**
+ * Updates a series data labels
+ *
+ * @param props props to pass to update series data labels
+ */
+export declare function updateHeatChartDataLabel(props: DataLabelUpdateProps): void;

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

@@ -1,8 +1,8 @@
 import { Label, NumberFormatter } from '@amcharts/amcharts5';
 import { XYSeries } from '@amcharts/amcharts5/xy.js';
-import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartBarChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartBarChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartHeatChartSeries, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '../../../../../spec';
 import { LabelProperties } from '../../../../common/defaults/interfaces';
-import { BarAndLineDataLabelFormatCallback, HistogramLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../../common/interfaces';
+import { BarAndLineDataLabelFormatCallback, HeatChartDataLabelFormatCallback, HistogramLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../../common/interfaces';
 export interface DefaultDataLabelFormatterProps {
     numberFormatter: NumberFormatter;
     dataLabelsConfigContent: WebChartTextSymbol;
@@ -11,15 +11,16 @@ export interface DefaultDataLabelFormatterProps {
 }
 export interface DataLabelUpdateProps {
     series: XYSeries;
-    seriesConfig: WebChartBarChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
+    seriesConfig: WebChartBarChartSeries | WebChartHeatChartSeries | WebChartHistogramSeries | WebChartLineChartSeries;
     dataLabel?: Label;
     seriesType: WebChartTypes;
     labelDefaults?: LabelProperties;
     isRotated?: boolean;
     stackedType?: WebChartStackedKinds;
     dataLabelsConfig?: WebChartText | undefined;
+    autoInverseDataLabelTextColor?: boolean;
     yAxisValueFormat?: CategoryFormatOptions | DateTimeFormatOptions | NumberFormatOptions;
     defaultDataLabelFormatter?: (props: DefaultDataLabelFormatterProps) => DataLabelFormatter;
     externalDataLabelFormatter?: DataLabelFormatter;
 }
-export type DataLabelFormatter = BarAndLineDataLabelFormatCallback | HistogramLabelFormatCallback | ScatterplotLabelFormatCallback;
+export type DataLabelFormatter = BarAndLineDataLabelFormatCallback | HeatChartDataLabelFormatCallback | HistogramLabelFormatCallback | ScatterplotLabelFormatCallback;

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

@@ -1,5 +1,5 @@
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
-import { WebChartPieChartSeries } from '@arcgis/charts-spec';
+import { WebChartPieChartSeries } from '../../../../../../spec';
 import { PieChartLabelFormatCallback } from '../../../../../common/interfaces';
 /**
  * Initializes default properties to a pie series data labels