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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -2,8 +2,8 @@ import { Graphics, Root, Series, Sprite, Template, Tooltip } from '@amcharts/amc
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
 import { RadarLineSeries } from '@amcharts/amcharts5/radar.js';
 import { XYSeries, ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
-import { ChartTypes } from '../../../../../utils';
 import { DateTimeFormatOptions, NumberFormatOptions, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataItemValue, WebChartLineChartSeries, WebChartRadarChartSeries } from '@arcgis/charts-spec';
+import { ChartTypes } from '../../../../../utils';
 import { BarAndLineChartTooltipProps } from '../interfaces';
 /**
  * Adding an extra padding on the tooltip's label to avoid its scrollbar to show up.
@@ -35,15 +35,10 @@ export declare function initializeLineAndRadarChartTooltip(element: Template<Gra
 export declare function initializeSeriesTooltip(series: PieSeries | XYSeries): Tooltip;
 /**
  * Initializes the tooltip associated to the markers on a series
- * @param root The root of the buttlet
- * @param series The series on what the bullet is assoicated with
+ * @param root The root of the bullet
+ * @param series The series on what the bullet is associated with
  */
 export declare function initializeBulletTooltip(root: Root, series: PieSeries | XYSeries): Tooltip;
-/**
- * Adds padding and background opacity to tooltip
- * @param tooltip The tooltip
- */
-export declare function setTooltipStyle(tooltip?: Tooltip): void;
 /**
  * A callback to check if tooltip needs to be reversed
  *

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

@@ -35,7 +35,7 @@ export declare function showElement(element: DataItem<IAxisDataItem> | Graphics
  * @param parent The parent container to search in.
  * @param useChildId Optional flag that tells the method to use the childId or search for it (note: used for dual axis charts)
  */
-export declare function findContainerChild<T extends Container | Label>(props: {
+export declare function findContainerChild<T extends Container | Graphics | Label>(props: {
     childId: string;
     parent: Container;
     useChildId?: boolean;
@@ -47,3 +47,11 @@ export declare function findContainerChild<T extends Container | Label>(props: {
  * @param parentUID The parent container id.
  */
 export declare function getUniqueElementID(elementId: string, parentUID: number): string;
+/**
+ * With amCharts v5, there is no layout validated method or knowning when the chart is ready
+ * see: https://www.amcharts.com/docs/v5/getting-started/root-element/#chart-ready-event
+ * For now, we do similar to amCharts an wait 100ms to do anything with elements positions
+ * "Our code waits until there's an idle moment of at least 100ms, before "deciding" the chart is fully functional and initial animations are played out."
+ * We return the timeout in case we need to clear it for "frameended"
+ */
+export declare function runAfterChartIsReady<T>(block: () => T, delay?: number): NodeJS.Timeout;

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

@@ -7,3 +7,5 @@ export declare const footerLabelId = "arcgis_charts_footer";
 export declare const legendContainerId = "arcgis_charts_legend_container";
 export declare const legendTitleId = "arcgis_charts_legend_title";
 export declare const axisTitleId = "arcgis_charts_axis_title_id";
+export declare const loaderContainerId = "arcgis_charts_loader_container";
+export declare const spinnerId = "arcgis_charts_loader_spinner";

package/dist/chart-rendering/next/defaults/index.d.ts

@@ -14,10 +14,16 @@ interface SpecificChartDefaults {
         histogramNormalDistribution: string;
     };
     chartPadding: number;
+    legendPadding: number;
     axisLabelSpacing: {
         verticalAxisLabelSidePadding: number;
         horizontalAxisLabelPaddingTop: number;
     };
+    heatChart: {
+        valueProperty: string;
+        xField: string;
+        yField: string;
+    };
 }
 /**
  * This interface is made to override the 'ChartDefaults' from the common rendering module.

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

@@ -2,7 +2,7 @@ import { Container, Graphics, ISpritePointerEvent } from '@amcharts/amcharts5';
 import { IPointerEvent } from '@amcharts/amcharts5/.internal/core/render/backend/Renderer.js';
 import { RadarChart } from '@amcharts/amcharts5/radar.js';
 import { XYChart, XYCursor } from '@amcharts/amcharts5/xy.js';
-import { CommonStrings, ErrorStrings, QueryObject } from '../../utils';
+import { ErrorStrings, QueryObject, UtilsStrings } from '../../utils';
 import { TimeIntervalInfo, WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../common/interfaces';
 export declare const amChartsV5License = "AM5C241025748";
@@ -54,7 +54,7 @@ export interface UpdateAxesCommonProps<ChartType extends RadarChart | XYChart, C
     data?: WebChartDataTypes;
     queryObject: QueryObject;
     xAxisLabelFormatter?: AxisLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }
 export interface UpdateAxesProps extends UpdateAxesCommonProps<XYChart, WebChart> {

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

@@ -1,8 +1,20 @@
 import { SerialChart } from '@amcharts/amcharts5';
-import { WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataTypes, WebGaugeChart, WebChartTypes } from '@arcgis/charts-spec';
 import { ErrorStrings, QueryObject, SelectionSource } from '../../../../utils';
 import { ChartOptions } from '../../../common/interfaces';
 import { ApplySelectionOnSeriesProps } from './interfaces';
+/**
+ * Checks whether a selection has been applied to all the series from a chart
+ *
+ * @param props.chart The chart
+ * @param props.chartType The chart type
+ * @param props.showMean Whether the mean lines are shown on the box plot
+ */
+declare function whetherSelectionAppliedToAllTheSeries(props: {
+    chart: SerialChart;
+    chartType?: WebChartTypes;
+    showMean?: boolean;
+}): boolean;
 /**
  * Apply a selection on a specific series
  *
@@ -36,3 +48,7 @@ export declare function applySelectionOnChart(props: {
  * @param selectionSource The source of the selection
  */
 export declare function finalizeSelection(chart: SerialChart, selectionSource: SelectionSource): Promise<void>;
+export declare const nextSelectionApplyPrivateFunctions: {
+    whetherSelectionAppliedToAllTheSeries: typeof whetherSelectionAppliedToAllTheSeries;
+};
+export {};

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

@@ -1,6 +1,11 @@
 import { Graphics, SerialChart, Slice, Template } from '@amcharts/amcharts5';
 import { PieSeries } from '@amcharts/amcharts5/percent.js';
-import { ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
+import { XYCursor, ColumnSeries, LineSeries } from '@amcharts/amcharts5/xy.js';
+/**
+ * Indicates whether a selection has been made by click-and-drag
+ * @param cursor The chart's cursor
+ */
+declare function isSelectionByRange(cursor?: XYCursor): boolean;
 /**
  * Adds the selection by click feature to a series
  * @param element The element to add the selection to (bullet, column template...)
@@ -13,3 +18,7 @@ export declare function addSelectionByClick(element: Graphics | Template<Graphic
  * @param chart The chart
  */
 export declare function addSelectionOnChart(chart: SerialChart): void;
+export declare const selectionPrivateFunctions: {
+    isSelectionByRange: typeof isSelectionByRange;
+};
+export {};

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

@@ -1,6 +1,6 @@
 import { Chart, Root, Modal } from '@amcharts/amcharts5';
-import { ErrorStrings, ValidationStatus, DataWarningKeywords } from '../../../../utils';
 import { WebChart, WebChartDataTypes, WebGaugeChart } from '@arcgis/charts-spec';
+import { ErrorStrings, ValidationStatus, DataWarningKeywords } from '../../../../utils';
 import { NotifyOptions } from '../../../common/interfaces';
 export declare function initializeChartModal(root: Root): Modal;
 export declare function resetChartModal(chartModal: Modal): void;
@@ -28,7 +28,7 @@ export declare function displayInvalidConfigMessage(props: {
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**
- * Setting a message for the chart to display when it fails to create the chart due to bad data.
+ * Setting a message for the chart to raise and display, if prefer, when it fails to create the chart due to bad data.
  *
  * @param chart The chart
  * @param chartModal The chart's modal
@@ -36,7 +36,6 @@ export declare function displayInvalidConfigMessage(props: {
  * @param invalidType The type of invalid data
  * @param elementCount The number of elements related to the error
  * @param seriesCount The number of series in the chart
- * @param openModal Whether to open the modal or not
  * @param errorStrings The t9n error strings
  */
 export declare function raiseInvalidDataWarning(props: {
@@ -46,7 +45,6 @@ export declare function raiseInvalidDataWarning(props: {
     invalidType?: DataWarningKeywords;
     elementCount?: number;
     seriesCount?: number;
-    openModal?: boolean;
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**

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

@@ -1,7 +1,8 @@
 import { Root, DateFormatter, NumberFormatter } from '@amcharts/amcharts5';
 import { ILocale } from '@amcharts/amcharts5/.internal/core/util/Language.js';
 import { WebChartTypes } from '@arcgis/charts-spec';
-export declare function fetchChartLocaleStrings(locale?: string): Promise<ILocale>;
+import { SupportedLocale } from '@arcgis/toolkit/intl';
+export declare function fetchChartLocaleStrings(locale?: SupportedLocale): Promise<ILocale>;
 /**
  * Generates a number or date formatter based on the chart's locale and the intl options
  *

package/dist/chart-rendering/next/utils/memory-storage/index.d.ts

@@ -1,10 +1,38 @@
 import { StorageType } from './interfaces';
+type AllStorageTypes = StorageType["axis"] | StorageType["chart"] | StorageType["guide"] | StorageType["label"] | StorageType["legend"] | StorageType["marker"] | StorageType["series"];
+type AllStorageKeys = keyof StorageType["axis"] & keyof StorageType["chart"] & keyof StorageType["guide"] & keyof StorageType["label"] & keyof StorageType["legend"] & keyof StorageType["marker"] & keyof StorageType["series"];
 /**
  * Disposes a specific storage. To be used when a chart is disposed for instance
  *
  * @param memoryStorageId
  */
 export declare function deleteStorage(storageKey?: number): void;
+/**
+ * Retrieves a legend property from a specific storage.
+ * @param storageKey The legend id
+ * @param propertyName The property to retrieve
+ */
+export declare function getValueFromLegendStorage<T>(storageKey: number, propertyName: AllStorageKeys): T | undefined;
+/**
+ * Updates a legend property from a specific storage
+ * @param storageKey The legend id
+ * @param informationToStore An object containing the properties to update. It will append and replace the existing ones for the given storage key and id.
+ */
+export declare function updateLegendStorage(storageKey: number, informationToStore: AllStorageTypes): void;
+/**
+ * Updates a specific storage
+ *
+ * @param storageKey The key to update (chart id, label id...)
+ * @param informationToStore An object containing the properties to update. It will append and replace the existing ones for the given storage key and id.
+ */
+declare function updateStorage(storageKey: number, informationToStore: AllStorageTypes): void;
+/**
+ * Retrieves a property from a specific storage
+ *
+ * @param storageKey The key to update (chart id, label id...)
+ * @param propertyName The property to retrieve
+ */
+declare function getValueFromStorage<T>(storageKey: number, propertyName: AllStorageKeys): T | undefined;
 /**
  * Retrieves a cursor property from a specific storage
  *
@@ -103,3 +131,8 @@ export declare function getValueFromGuideStorage<T>(storageKey: number, property
  * @param informationToStore An object containing the properties to update. It will append and replace the existing ones for the given storage key and id.
  */
 export declare function updateGuideStorage(storageKey: number, informationToStore: StorageType["guide"]): void;
+export declare const nextUtilsMemoryStoragePrivateFunctions: {
+    updateStorage: typeof updateStorage;
+    getValueFromStorage: typeof getValueFromStorage;
+};
+export {};

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

@@ -1,4 +1,4 @@
-import { Graphics, Template } from '@amcharts/amcharts5';
+import { Graphics, IDisposer, Template } from '@amcharts/amcharts5';
 import { WebChartDataTypes, WebChartTextSymbol } from '@arcgis/charts-spec';
 import { AxisLabelFormatCallback } from '../../../common/interfaces';
 import { CommonStorageType } from '../../../common/memory-storage/interfaces';
@@ -9,6 +9,7 @@ export type ZeroGridLineType = {
     visible?: boolean;
 };
 export interface StorageType extends CommonStorageType {
+    legend: CommonStorageType["legend"];
     cursor: CommonStorageType["cursor"];
     chart: CommonStorageType["chart"] & {
         data?: WebChartDataTypes;
@@ -17,12 +18,14 @@ export interface StorageType extends CommonStorageType {
     series: CommonStorageType["series"] & {
         bulletTemplate?: Template<Graphics>;
         isSelectionApplied?: boolean;
+        tooltipCallback?: IDisposer;
     };
     axis: CommonStorageType["axis"] & {
         rotation?: number;
         labelsSymbol?: MappedTextSymbol;
         zeroGridLine?: ZeroGridLineType;
         labelFormatter?: AxisLabelFormatCallback;
+        minGridDistanceCallbackDisposer?: IDisposer;
     };
     marker: CommonStorageType["marker"] & {
         selected?: boolean;

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

@@ -1,7 +1,99 @@
-import { GaugeChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, ErrorStrings, QueryObject } from '../../../../../utils';
-import { WebChartAxis, WebChartDataItem, WebGaugeChart } from '@arcgis/charts-spec';
+import { ILocale } from '@amcharts/amcharts4/.internal/core/utils/Language.js';
+import { Axis, AxisRendererCircular, ClockHand, GaugeChart, ValueAxis } from '@amcharts/amcharts4/charts.js';
+import { ErrorStrings, QueryObject, UtilsStrings } from '../../../../../utils';
+import { NumberFormatOptions, WebChartAxis, WebChartDataItem, WebChartGaugeAxis, WebChartNeedle, WebChartText, WebChartTextSymbol, WebGaugeChart } from '@arcgis/charts-spec';
 import { AxisLabelFormatCallback, GaugeInnerLabelFormatCallback } from '../../../../common/interfaces';
+declare function initializeAxisNeedle(chart: GaugeChart): ClockHand;
+/**
+ * Retrieves the value to display on the gauge. It will use either the one provided by the data, or the
+ * one already displayed.
+ */
+declare function getGaugeValue(props: {
+    chart: GaugeChart;
+    x?: string;
+    data?: WebChartDataItem[];
+    valueFormat: NumberFormatOptions;
+    minimum?: number | null;
+    maximum?: number | null;
+}): number | null | undefined;
+declare function updateAxisNeedle(props: {
+    chart: GaugeChart;
+    needle?: WebChartNeedle;
+    gaugeValue?: number | null;
+}): void;
+declare function initializeAxisInnerLabel(chart: GaugeChart): void;
+declare function updateAxisInnerLabel(props: {
+    chart: GaugeChart;
+    innerLabelConfig?: WebChartText;
+    valueFormat: NumberFormatOptions;
+    gaugeInnerLabelFormatter?: GaugeInnerLabelFormatCallback;
+    gaugeValue?: number | null;
+}): void;
+/**
+ * Creates ticks (with and without a label) based on the input parameters.
+ * This function also removes existing ones before creating new ones,
+ * and slightly adjusts the value of the last tick, if needed.
+ *
+ * @param props.axis The axis of which the ticks and labels are to be created
+ * @param props.min The min value for the first tick
+ * @param props.max The max value for the last tick
+ * @param props.labelsIncrement The label increment
+ * @param props.numberOfIntervals The number of intervals (space between 2 axis tick labels)
+ * @param props.valueFormat The number format of the axis
+ */
+declare function createGaugeTicksAndLabels(props: {
+    axis: ValueAxis<AxisRendererCircular>;
+    min: number;
+    max: number;
+    labelsIncrement: number;
+    numberOfIntervals: number;
+    valueFormat: NumberFormatOptions;
+}): void;
+declare function updateGaugeAxisLabels(props: {
+    chart: GaugeChart;
+    axis: Axis<AxisRendererCircular>;
+    onlyShowFirstAndLastLabels: boolean;
+    valueFormat: NumberFormatOptions;
+    axisLabelConfigContent?: WebChartText;
+    axisValueFormatter?: AxisLabelFormatCallback;
+}): void;
+declare function updateGaugeTicks(axis: Axis<AxisRendererCircular>, axisConfig?: WebChartGaugeAxis): void;
+/**
+ * Updates the axis labels' visibility.
+ *
+ * Note: the visibility is based on two properties from the axis config:
+ * - labels' `visible`
+ * - `onlyShowFirstAndLastLabels`
+ *
+ * @param axis the axis
+ * @param axisConfig the axis config
+ */
+declare function updateLabelsVisibility(axis: Axis<AxisRendererCircular>, axisConfig: WebChartGaugeAxis): void;
+/**
+ * Handles the "first and last labels" feature. If the option is enabled, we add guides at the chart's extremities and
+ * set labels on them to display the axis min and max.
+ *
+ * @param axisConfig
+ */
+declare function initializeFirstAndLastLabels(axisConfig: WebChartGaugeAxis): void;
+/**
+ * Adjusts the first and last labels position. They are currently created as guide labels, so we access them through
+ * the axis guides, to set a dx and dy adapter on them.
+ *
+ * Note: this function needs to be called after `updateAxis()` as we need the guides to be created on the axis first.
+ *
+ * @param axis
+ */
+declare function adjustFirstAndLastLabelsPosition(axis: Axis<AxisRendererCircular>): void;
+/** Apply the axis labels styling and the desired format to the first and last labels. */
+declare function updateFirstAndLastLabels(props: {
+    chart: GaugeChart;
+    axis: Axis<AxisRendererCircular>;
+    onlyShowFirstAndLastLabels: boolean;
+    valueFormat: NumberFormatOptions;
+    gaugeLabelConfigContent?: WebChartText;
+    axisValueFormatter?: AxisLabelFormatCallback;
+}): void;
 /**
  * Initializes the gauge axis
  *
@@ -9,6 +101,22 @@ import { AxisLabelFormatCallback, GaugeInnerLabelFormatCallback } from '../../..
  * @param valueFormat The axis value format
  */
 export declare function initializeGaugeAxis(chart: GaugeChart, valueFormat: WebChartAxis["valueFormat"]): void;
+declare function getInnerLabelHTMLValue(props: {
+    valueFormat: NumberFormatOptions;
+    iLocale: ILocale;
+    formatLocale?: string;
+    gaugeValue?: number | null;
+    innerLabelConfigContent?: WebChartTextSymbol;
+    gaugeInnerLabelFormatter?: GaugeInnerLabelFormatCallback;
+}): string;
+declare function getGaugeLabelHTMLValue(props: {
+    valueFormat: NumberFormatOptions;
+    iLocale: ILocale;
+    formatLocale?: string;
+    itemLabelValue?: number | null;
+    gaugeLabelConfigContent?: WebChartTextSymbol;
+    axisValueFormatter?: AxisLabelFormatCallback;
+}): string;
 /**
  * Updates a gauge axis based on the configuration.
  * The data is used to update the needle position and inner label value.
@@ -29,6 +137,23 @@ export declare function updateGaugeAxis(props: {
     queryObject?: QueryObject;
     axisValueFormatter?: AxisLabelFormatCallback;
     gaugeInnerLabelFormatter?: GaugeInnerLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;
+export declare const axesGaugePrivateFunctions: {
+    initializeFirstAndLastLabels: typeof initializeFirstAndLastLabels;
+    getGaugeLabelHTMLValue: typeof getGaugeLabelHTMLValue;
+    updateFirstAndLastLabels: typeof updateFirstAndLastLabels;
+    adjustFirstAndLastLabelsPosition: typeof adjustFirstAndLastLabelsPosition;
+    initializeAxisNeedle: typeof initializeAxisNeedle;
+    getGaugeValue: typeof getGaugeValue;
+    updateAxisNeedle: typeof updateAxisNeedle;
+    initializeAxisInnerLabel: typeof initializeAxisInnerLabel;
+    updateAxisInnerLabel: typeof updateAxisInnerLabel;
+    getInnerLabelHTMLValue: typeof getInnerLabelHTMLValue;
+    createGaugeTicksAndLabels: typeof createGaugeTicksAndLabels;
+    updateGaugeTicks: typeof updateGaugeTicks;
+    updateGaugeAxisLabels: typeof updateGaugeAxisLabels;
+    updateLabelsVisibility: typeof updateLabelsVisibility;
+};
+export {};

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

@@ -1,4 +1,11 @@
+import { AxisDataItem } from '@amcharts/amcharts4/charts.js';
 import { InitializeHistogramAxesProps, UpdateHistogramAxesProps } from './interfaces';
+/**
+ * Finds the width from the longest label
+ *
+ * @param axisTicks Array of ticks with labels
+ */
+declare function getLongestLabelWidth(axisTicks: AxisDataItem[]): number;
 export declare function initializeHistogramAxes(props: InitializeHistogramAxesProps): void;
 /**
  * Function to update the horizontal and vertical axes of the histogram
@@ -10,3 +17,7 @@ export declare function initializeHistogramAxes(props: InitializeHistogramAxesPr
  * @param props
  */
 export declare function updateHistogramAxes(props: UpdateHistogramAxesProps): Promise<void>;
+export declare const axesHistogramPrivateFunctions: {
+    getLongestLabelWidth: typeof getLongestLabelWidth;
+};
+export {};