@arcgis/charts-components 4.34.0-next.11 → 4.34.0-next.110

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 '../../../../../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 {};

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

@@ -1,6 +1,6 @@
 import { XYChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, ErrorStrings } from '../../../../../utils';
-import { WebChart, WebChartBin } from '@arcgis/charts-spec';
+import { ErrorStrings, UtilsStrings } from '../../../../../utils';
+import { WebChart, WebChartBin } from '../../../../../spec';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../../common/interfaces';
 export interface UpdateHistogramAxesProps {
     chart: XYChart;
@@ -9,7 +9,7 @@ export interface UpdateHistogramAxesProps {
     guideTooltipFormatter?: GuideTooltipFormatCallback;
     xAxisLabelFormatter?: AxisLabelFormatCallback;
     yAxisLabelFormatter?: AxisLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }
 export interface InitializeHistogramAxesProps {

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

@@ -1,6 +1,6 @@
 import { XYChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, ErrorStrings } from '../../../../utils';
-import { TimeIntervalInfo, WebChart, WebChartTypes } from '@arcgis/charts-spec';
+import { ErrorStrings, UtilsStrings } from '../../../../utils';
+import { TimeIntervalInfo, WebChart, WebChartTypes } from '../../../../spec';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../common/interfaces';
 export interface UpdateBarAndLineChartProps {
     chart: XYChart;
@@ -15,7 +15,7 @@ export interface UpdateBarAndLineChartProps {
     xAxisLabelFormatter?: AxisLabelFormatCallback;
     yAxisLabelFormatter?: AxisLabelFormatCallback;
     secondaryYAxisLabelFormatter?: AxisLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }
 export interface InitializeBarAndLineChartAxesProps {

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

@@ -1,6 +1,6 @@
 import { XYChart } from '@amcharts/amcharts4/charts.js';
-import { CommonStrings, ErrorStrings } from '../../../../../utils';
-import { WebChart } from '@arcgis/charts-spec';
+import { ErrorStrings, UtilsStrings } from '../../../../../utils';
+import { WebChart } from '../../../../../spec';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../../common/interfaces';
 export declare function initializeScatterplotAxes(chart: XYChart, axesConfig: WebChart["axes"]): void;
 export declare function updateScatterplotAxes(props: {
@@ -10,6 +10,6 @@ export declare function updateScatterplotAxes(props: {
     guideTooltipFormatter?: GuideTooltipFormatCallback;
     xAxisLabelFormatter?: AxisLabelFormatCallback;
     yAxisLabelFormatter?: AxisLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;

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

@@ -1,7 +1,7 @@
-import { Axis, PieChart, CategoryAxis, ValueAxis, XYChart } from '@amcharts/amcharts4/charts.js';
+import { Axis, PieChart, CategoryAxis, DateAxis, ValueAxis, XYChart } from '@amcharts/amcharts4/charts.js';
 import { DataItem } from '@amcharts/amcharts4/core.js';
 import { ErrorStrings } from '../../../../../../utils';
-import { WebChartAxis, WebChartTextSymbol, WebChartTypes } from '@arcgis/charts-spec';
+import { DateTimeFormatOptions, WebChartAxis, WebChartTextSymbol, WebChartTypes } from '../../../../../../spec';
 import { AxisLabelFormatCallback } from '../../../../../common/interfaces';
 /**
  * Returns true if the input chart is a XYChart and uses a date axis
@@ -47,6 +47,19 @@ export declare function categoryAxisFormatterCallback(props: {
  * @param axis The axis on which to assign set the label formatter
  */
 export declare function initializeAxisFormatter(axis: Axis): void;
+/**
+ * Updates an adapter on a date axis labels that formats them according to either the config
+ * or a custom formatter passed when the chart is created or updated.
+ *
+ * @param props.axis is an instance of DateAxis
+ * @param props.formatOptions contains INTL.DateTimeFormat options info for formatting date-time
+ * @param props.axisValueFormatter custom label formatter
+ */
+declare function updateDateAxisFormatter(props: {
+    axis: DateAxis;
+    formatOptions: DateTimeFormatOptions;
+    dateAxisFormatter?: AxisLabelFormatCallback;
+}): void;
 /**
  * Updates the formatter used by the axis to render the labels.
  *
@@ -69,3 +82,7 @@ export declare function updateAxisFormat(props: {
     axisValueFormatter?: AxisLabelFormatCallback;
     errorStrings: ErrorStrings;
 }): Promise<void>;
+export declare const utilsAxisformatPrivateFunctions: {
+    updateDateAxisFormatter: typeof updateDateAxisFormatter;
+};
+export {};

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

@@ -1,7 +1,8 @@
 import { Axis, AxisRenderer, GaugeChart, XYSeries, XYChart } from '@amcharts/amcharts4/charts.js';
 import { List } from '@amcharts/amcharts4/core.js';
-import { CommonStrings, ErrorStrings } from '../../../../../../utils';
-import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartLabelBehavior, WebChartStackedKinds, WebChartTypes } from '@arcgis/charts-spec';
+import { ErrorStrings, UtilsStrings } from '../../../../../../utils';
+import { TimeIntervalInfo, WebChart, WebChartAxis, WebChartLabelBehavior, WebChartStackedKinds, WebChartTypes } from '../../../../../../spec';
+import { getAxisSeriesIds } from '../../../../../common/axes';
 import { AxisLabelFormatCallback, GuideTooltipFormatCallback } from '../../../../../common/interfaces';
 /**
  * Resets the chart's axes zoom level to display the chart in full extent.
@@ -56,6 +57,59 @@ export declare function initializeXYChartAxes(props: {
  * @param isSecondValueAxis Whether the axis is the second value axis (in dual axis mode)
  */
 export declare function whetherLogScaleIsDataCompatible(axis: Axis, isSecondValueAxis?: boolean): boolean;
+/**
+ * Activating the `logarithmic` property of the axis.
+ * Activated only on a value or date axis and according to the config property.
+ *
+ * @param props.axis The axis
+ * @param props.isLogarithmic Whether the axis should use a logarithmic scale
+ * @param props.isSecondValueAxis Whether the axis is the second value axis (in dual axis mode)
+ */
+declare function updateAxisLogarithmic(props: {
+    axis: Axis;
+    isLogarithmic?: boolean;
+    isSecondValueAxis?: boolean;
+}): void;
+/**
+ * Indicates whether the `strictMinMax` option should be applied to the axis.
+ * Returns true only if:
+ *   - the axis is a value axis
+ *   - the axis config logarithmic scale is off, or is on with at least minimum or maximum value specified
+ *   - the axis config buffer is not requested
+ *
+ * @param axis The axis
+ * @param axisConfig The axis config
+ * @returns
+ */
+declare function shouldApplyStrictMinMax(axis: Axis, axisConfig?: WebChartAxis): boolean;
+/**
+ * Activating the `strictMinMax` property of the axis.
+ * `strictMinMax` will remove any buffer around the data's extent, so the top/bottom of the highest/lowest bar or point will
+ * determine the axis max/min
+ * Activated when the axis is ValueAxis, when the logarithmic option is off (or on with at least the minimum or maximum value specified) and when the buffer option is true.
+ *
+ * @param axis The axis to apply the strictMinMax to
+ * @param axisConfig The axis config
+ */
+declare function updateAxisStrictMinMax(axis: Axis, axisConfig?: WebChartAxis): boolean;
+/**
+ * Calculates the minimum value to the nearest and lowest power of 10 for an axis when the axis is logarithmic
+ * For example,
+ * - if min = 5, we set the new min to 1
+ * - if min = 12, we set the new min to 10
+ * - if min = 55, we set the new min to 10
+ * - if min = 9999, we set the new min to 1,000
+ * - if min = 12345, we set the new min to 10,000
+ * - if min = 0.05, we set the new min to 0.01
+ * - if min = 0.0005, we set the new min to 0.0001
+ * The point is to force the axis to render nice rounded values, going 10, 100, 1,000...
+ * ...rather than something like 344.67, 3,446.7, 34,467...
+ *
+ * @param dataMinValue The minimum value from the data
+ * @returns The calculated minimum value if the input dataMinValue is greater than 0
+ * Otherwise, undefined
+ */
+declare function getBestMinValueForAxisLogarithmic(dataMinValue: number): number | undefined;
 /**
  * Updates an axis min max properties.
  *
@@ -85,6 +139,16 @@ export declare function updateBaseInterval(props: {
     timeIntervalInfo?: TimeIntervalInfo;
     dateBaseInterval?: TimeIntervalInfo;
 }): void;
+/**
+ * Indicates whether a series should be used to trigger the update of the axis min/max values.
+ * We are currently rejecting:
+ * - the overlays (trendline and histogram)
+ * - the box plot series that are not CandlestickSeries
+ *
+ * @param series The series instance
+ * @param chartType The chart type
+ */
+declare function allowSeriesToUpdateAxisMinMax(series: XYSeries, chartType?: WebChartTypes): boolean;
 /**
  * When a series is shown or hidden (from the legend for instance), or when its data is updated, we want the value
  * axis bounds to be updated accordingly to the visible series only. When `strictMinMax` is set to `true`, amCharts
@@ -110,7 +174,7 @@ export declare function updateAxis(props: {
     axisValueFormatter?: AxisLabelFormatCallback;
     isSecondValueAxis?: boolean;
     isRotated?: boolean;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;
 /**
@@ -128,7 +192,7 @@ export declare function updateAxis(props: {
  * @param props.xAxisLabelFormatter The x-axis label HTML formatter
  * @param props.yAxisLabelFormatter The y-axis label HTML formatter
  * @param props.secondaryYAxisLabelFormatter The secondary y-axis label HTML formatter
- * @param props.commonStrings The common t9n strings
+ * @param props.utilsStrings The t9n utils strings
  * @param props.errorStrings The t9n error strings
  */
 export declare function updateXYChartAxes(props: {
@@ -144,6 +208,15 @@ export declare function updateXYChartAxes(props: {
     xAxisLabelFormatter?: AxisLabelFormatCallback;
     yAxisLabelFormatter?: AxisLabelFormatCallback;
     secondaryYAxisLabelFormatter?: AxisLabelFormatCallback;
-    commonStrings: CommonStrings;
+    utilsStrings: UtilsStrings;
     errorStrings: ErrorStrings;
 }): Promise<void>;
+export declare const utilsAxisrendererPrivateFunctions: {
+    getBestMinValueForAxisLogarithmic: typeof getBestMinValueForAxisLogarithmic;
+    shouldApplyStrictMinMax: typeof shouldApplyStrictMinMax;
+    updateAxisStrictMinMax: typeof updateAxisStrictMinMax;
+    updateAxisLogarithmic: typeof updateAxisLogarithmic;
+    getAxisSeriesIds: typeof getAxisSeriesIds;
+    allowSeriesToUpdateAxisMinMax: typeof allowSeriesToUpdateAxisMinMax;
+};
+export {};

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

@@ -1,7 +1,7 @@
 import { Axis, AxisRendererX, AxisRendererY, GaugeChart, PieChart, XYChart, XYCursor } from '@amcharts/amcharts4/charts.js';
 import { IStyleProperty } from '@amcharts/amcharts4/core.js';
 import { CursorRange, ActionModes } from '../../../../utils';
-import { WebChartCursorCrosshair } from '@arcgis/charts-spec';
+import { WebChartCursorCrosshair } from '../../../../spec';
 /**
  * Creates cursor on the chart if its compatible
  * Only for XYChart

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

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

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

@@ -1,5 +1,5 @@
 import { ValueAxisDataItem, ValueAxis } from '@amcharts/amcharts4/charts.js';
-import { WebChartAxis } from '@arcgis/charts-spec';
+import { WebChartAxis } from '../../../../spec';
 import { NumberFormatter } from '@amcharts/amcharts4/core.js';
 export interface HistogramTickProps {
     axisTick: ValueAxisDataItem;

package/dist/chart-rendering/stable/chart-library-elements/header-and-footer/index.d.ts

@@ -1,5 +1,5 @@
 import { Container } from '@amcharts/amcharts4/core.js';
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 import { FooterElements, HeaderElements, HeaderProps } from './interfaces';
 export declare function initializeHeaderContainer(parent: Container): HeaderElements;
 export declare function updateHeaderContainer(headerElements: HeaderElements, props?: HeaderProps): void;

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

@@ -1,4 +1,4 @@
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../spec';
 import { Container, Label } from '@amcharts/amcharts4/core.js';
 export interface HeaderProps {
     title?: WebChartText;

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

@@ -1,6 +1,6 @@
 import { Axis } from '@amcharts/amcharts4/charts.js';
 import { Label } from '@amcharts/amcharts4/core.js';
-import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartAxis, WebChartText, WebChartLabelBehavior, WebChartTypes } from '../../../../../spec';
 /**
  * Hides or shows the last label on the axis, whether it's cut off on the edge or not.
  *

package/dist/chart-rendering/stable/chart-library-elements/label/data-label/bar-chart/index.d.ts

@@ -1,6 +1,6 @@
 import { ColumnSeries } from '@amcharts/amcharts4/charts.js';
 import { Label } from '@amcharts/amcharts4/core.js';
-import { WebChartStackedKinds } from '@arcgis/charts-spec';
+import { WebChartStackedKinds } from '../../../../../../spec';
 import { DataLabelUpdateProps } from '../interfaces';
 /**
  * Looks for an existing series data label. Bar chart has two data labels, one being displayed while in side-by-side and

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

@@ -1,6 +1,6 @@
 import { Series } from '@amcharts/amcharts4/charts.js';
 import { Label } from '@amcharts/amcharts4/core.js';
-import { WebChartStackedKinds, WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartStackedKinds, WebChartTypes } from '../../../../../spec';
 import { BarAndLineDataLabelFormatCallback } from '../../../../common/interfaces';
 import { DataLabelUpdateProps, DefaultDataLabelFormatterProps } from './interfaces';
 /**

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

@@ -1,6 +1,6 @@
 import { ColumnSeries, LineSeries } from '@amcharts/amcharts4/charts.js';
 import { Label, NumberFormatter } from '@amcharts/amcharts4/core.js';
-import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, DateTimeFormatOptions, NumberFormatOptions, WebChartStackedKinds, WebChartText, WebChartTextSymbol, WebChartTypes } from '../../../../../spec';
 import { LabelProperties } from '../../../../common/defaults/interfaces';
 import { BarAndLineDataLabelFormatCallback, HistogramLabelFormatCallback, ScatterplotLabelFormatCallback } from '../../../../common/interfaces';
 export interface DefaultDataLabelFormatterProps {

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

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

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

@@ -1,5 +1,5 @@
 import { Axis, AxisRenderer, AxisLabel, AxisLabelCircular, AxisRendererCircular } from '@amcharts/amcharts4/charts.js';
-import { WebChartText, RESTSymbolType } from '@arcgis/charts-spec';
+import { WebChartText, RESTSymbolType } from '../../../../../spec';
 /**
  * Initializes a guide label
  *

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

@@ -1,5 +1,5 @@
 import { Container, Label } from '@amcharts/amcharts4/core.js';
-import { WebChartText } from '@arcgis/charts-spec';
+import { WebChartText } from '../../../../../spec';
 import { LabelProperties } from '../../../../common/defaults/interfaces';
 export declare function applyLabelDefaults(label: Label, defaults?: LabelProperties): void;
 export declare function initializeLabel(defaults?: LabelProperties, parent?: Container): Label;

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

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

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

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

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

@@ -1,5 +1,5 @@
 import { IRoundedRectangleAdapters } from '@amcharts/amcharts4/core.js';
-import { WebChart, WebChartLegend } from '@arcgis/charts-spec';
+import { WebChart, WebChartLegend } from '../../../../spec';
 import { PieChartLegendValueLabelFormatCallback } from '../../../common/interfaces';
 import { LegendElements } from '../../interfaces';
 export interface UpdateLegendProps {