@arcgis/charts-components 5.0.0-next.4 → 5.0.0-next.42

package/dist/spec/web-chart.d.ts

@@ -6,7 +6,7 @@ import { Color, IDrawingInfo, IEnvelope, IExtent, IFeatureLayer, IPoint, IPolygo
 /**
  * Version of the current specification.
  */
-export declare const WebChartCurrentVersion = "24.3.0";
+export declare const WebChartCurrentVersion = "24.5.0";
 /**
  * Stores information regarding a numeric conversion
  */
@@ -267,7 +267,7 @@ export interface DateTimeFormatOptions {
      */
     type: typeof WebChartTypes.DateAxisFormat;
     /**
-     * Represent the JS native [Intl.DateTimeFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormatt), which is based on [CLDR](http://cldr.unicode.org/translation/date-time-1/date-time-patterns) specifications.
+     * Represent the JS native [Intl.DateTimeFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat), which is based on [CLDR](http://cldr.unicode.org/translation/date-time-1/date-time-patterns) specifications.
      */
     intlOptions: Intl.DateTimeFormatOptions;
     /**
@@ -627,9 +627,9 @@ export interface WebChartQuery {
      */
     fetchNullValues?: boolean;
     /**
-     * An array of objectIds of the features to be filtered.
+     * An array of objectIds or uniqueIds of the features to be filtered.
      */
-    objectIds?: number[];
+    objectIds?: (number | string)[];
 }
 /**
  * Subset of the WebChartQuery, used at the series level
@@ -1283,6 +1283,8 @@ export interface WebChartBoxPlotSeries extends WebChartSeries {
     type: typeof WebChartTypes.BoxPlotSeries;
     /**
      * Specifies the numeric field(s) used by the box plot series.
+     * @minLength 1
+     * @minItems 1
      */
     y: string[] | string;
     /**

package/dist/store.d.ts

@@ -1,3 +1,4 @@
+import { TimeIntervalInfo } from './spec';
 /**
  * Type definition for axes bound data
  * Holds the default and current min and max bound values for an axis
@@ -28,15 +29,18 @@ type AppState = {
     chartAxesBoundDataMap: ChartAxesBoundDataMap;
     /** Stores cached scatterplot data representing specific UI states that are not saved at the model level */
     scatterplotData: ScatterplotDataMap;
+    /** Stores cached time binning interval for each chart */
+    timeBinningIntervalMap: Record<string, TimeIntervalInfo | undefined>;
 };
 declare const state: {
     selectedChartId: string;
     chartAxesBoundDataMap: ChartAxesBoundDataMap;
     scatterplotData: ScatterplotDataMap;
+    timeBinningIntervalMap: {};
 };
 /**
  * Generates the min max axis key for the selected chart based on the axis type and logarithmic scale.
- * The key is used to fetch/store the min max axis related values in the stencil store for the selected chart
+ * The key is used to fetch/store the min max axis related values in the state for the selected chart
  *
  * @param {string} props.chartId - The selected chart id
  * @param {boolean} props.isXAxis - The axis type (`true` for x-axis, `false` for y-axis)
@@ -48,9 +52,26 @@ export declare const generateAxisMinMaxKey: (props: {
     isLogarithmic: boolean;
 }) => string;
 /**
- * Deletes the min max axis key from the stencil store for the selected chart
+ * Deletes the min max axis key from the state for the selected chart
  *
- * @param {AppState} appState - The current app state in the stencil store
+ * @param {AppState} appState - The current app state
  */
 export declare const deleteMinMaxAxisKey: (appState: AppState) => void;
+/**
+ * Gets the axes bound data for the selected chart
+ * @param {AppState} appState - The current app state
+ * @returns {TimeIntervalInfo | undefined} - The axes bound data map for the selected chart
+ */
+export declare const getTimeBinningForChart: (appState: AppState) => TimeIntervalInfo | undefined;
+/**
+ * Sets the time binning interval for a specific chart
+ * @param {AppState} appState - The current app state
+ * @param {TimeIntervalInfo} timeBinning - The time binning interval to set
+ */
+export declare const setTimeBinningForChart: (appState: AppState, timeBinning: TimeIntervalInfo) => void;
+/**
+ * Resets the time binning interval for a specific chart
+ * @param {AppState} appState - The current app state
+ */
+export declare const resetTimeBinningForChart: (appState: AppState) => void;
 export default state;

package/dist/types/lumina.d.ts

@@ -3,7 +3,7 @@ import type { ArcgisChart } from "../components/arcgis-chart";
 import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-bar";
 import type { h, EventHandler } from "@arcgis/lumina";
 
-interface LuminaArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, h.JSX.HTMLAttributes<HTMLArcgisChartElement> {
+interface LuminaArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'messageOverrides' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, h.JSX.HTMLAttributes<HTMLArcgisChartElement> {
   onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;

package/dist/types/preact.d.ts

@@ -4,7 +4,7 @@ import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-b
 import { HTMLAttributes } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, HTMLAttributes<HTMLArcgisChartElement> {
+interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'messageOverrides' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, HTMLAttributes<HTMLArcgisChartElement> {
   onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;

package/dist/types/preact10.d.ts

@@ -5,7 +5,7 @@ import { JSX as PreactJsx } from "preact";
 import type { EventHandler } from "@arcgis/lumina";
 
 /** @deprecated Update to Preact 10.27.2+ or 11+ and consume types/preact file over types/preact10 */
-interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, PreactJsx.HTMLAttributes<HTMLArcgisChartElement> {
+interface PreactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'messageOverrides' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, PreactJsx.HTMLAttributes<HTMLArcgisChartElement> {
   onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;

package/dist/types/react.d.ts

@@ -4,7 +4,7 @@ import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-b
 import type { HTMLProps } from 'react';
 import type { EventHandler } from "@arcgis/lumina"; 
 
-interface ReactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, HTMLProps<HTMLArcgisChartElement> {
+interface ReactArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'messageOverrides' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, HTMLProps<HTMLArcgisChartElement> {
   onarcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;

package/dist/types/stencil.d.ts

@@ -4,7 +4,7 @@ import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-b
 import { JSXBase as StencilJsx } from "@stencil/core/internal";
 import type { EventHandler } from "@arcgis/lumina";
 
-interface StencilArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, StencilJsx.HTMLAttributes<HTMLArcgisChartElement> {
+interface StencilArcgisChart extends Partial<Pick<ArcgisChart, 'actionMode' | 'allowUsingObjectIdStat' | 'autoDisposeChart' | 'autoInverseDataLabelTextColor' | 'chartIndex' | 'chartLimits' | 'chartWillRender' | 'cursorRange' | 'dataLabelFormatter' | 'disableTogglingLegendItems' | 'enableConfiguration' | 'enableResponsiveFeatures' | 'errorPolicy' | 'featureIndex' | 'filterByExtent' | 'filterBySelection' | 'gaugeInnerLabelFormatter' | 'guideTooltipFormatter' | 'hideEmptySeries' | 'hideLicenseWatermark' | 'hideLoaderAnimation' | 'ignoreSmoothRenderingLimit' | 'ignoreViewExtent' | 'layer' | 'layerFieldsChangePolicy' | 'layerFilterChangePolicy' | 'layerItemId' | 'layerRendererChangePolicy' | 'legendPosition' | 'legendValueLabelFormatter' | 'legendVisibility' | 'loaderColors' | 'messageOverrides' | 'model' | 'nullAsValid' | 'placeholder' | 'queueChartCreation' | 'replaceNoValueCategoryWithZero' | 'returnFeaturesExtent' | 'returnSelectionIndexes' | 'returnSelectionOIDs' | 'rotation' | 'runtimeDataFilters' | 'secondaryYAxisLabelFormatter' | 'selectionData' | 'selectionTheme' | 'setTimeBinningInfoWhenNotProvided' | 'showUIMessages' | 'syncSelection' | 'syncSelectionsBetweenChartAndLayerViewPolicy' | 'timeZone' | 'tooltipFormatter' | 'updateSplitBySeries' | 'useAnimatedCharts' | 'usePopupTemplateFieldsInfo' | 'view' | 'viewTimeExtentChangePolicy' | 'xAxisLabelFormatter' | 'yAxisLabelFormatter'>>, ArcgisChartSetterTypes, StencilJsx.HTMLAttributes<HTMLArcgisChartElement> {
   onArcgisAxesMinMaxChange?: EventHandler<HTMLArcgisChartElement["arcgisAxesMinMaxChange"]>;
   onArcgisBadDataWarningRaise?: EventHandler<HTMLArcgisChartElement["arcgisBadDataWarningRaise"]>;
   onArcgisChartNotFoundWarning?: EventHandler<HTMLArcgisChartElement["arcgisChartNotFoundWarning"]>;

package/dist/utils/chart-config/converter/index.d.ts

@@ -17,6 +17,8 @@ declare function applyDefaultFirstDayOfWeek(props: {
     chartContainer?: HTMLElement;
     layer?: SupportedLayer;
 }): WebChart | WebHeatChart;
+declare function adjustAxes(configToUpdate: WebChart): WebChart;
+declare function adjustSeries(configToUpdate: WebChart): WebChart;
 /**
  * Matches the config properties that have field names which mismatch the layer data source fields.
  *
@@ -61,6 +63,11 @@ declare function isBoxPlotConfigWithMeanLinesFromPro(config: WebBoxPlot): boolea
  * @returns the updated config
  */
 declare function adjustBoxPlotConfig(configToUpdate: WebBoxPlot): WebBoxPlot;
+/**
+ * Sets the legend max height to `NaN` when the provided value is not a finite number.
+ * @param configToUpdate The chart's config to update
+ */
+declare function resetLegendMaxHeight(configToUpdate: WebChart): WebChart;
 /**
  * Copies the information from the config.dataSource.layer into the newest config.iLayer
  * @param configToUpdate The config to update
@@ -88,6 +95,12 @@ declare function applyMandatoryConversions(props: {
  * @param configToUpdate The chart's config to update
  */
 declare function adjustPieFromFieldsDefaultNameAndValue(configToUpdate: WebChart): WebChart;
+/**
+ * Remove the optional `spacing` property for gauge chart (from version 2.0.0).
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function removeSpacingPropertyFromGauge(configToUpdate: WebChart): WebChart;
 /**
  * Moves the series[x].query.extent to config.dataFilters.geometry, and delete
  * the extent properties from all the series query.
@@ -221,6 +234,12 @@ declare function handleOrderOptionsChanges(configToUpdate: WebChart): WebChart;
  * @returns the updated chart config
  */
 declare function applyDataOrderInstructionForFromFieldsCharts(configToUpdate: WebChart): WebChart;
+/**
+ * we convert convert WebChartLabelBehavior.None -> WebChartLabelBehavior.Hide
+ * @param configToUpdate Config to update
+ * @returns the updated chart config
+ */
+declare function convertWebChartLabelBehaviorNoneToHide(configToUpdate: WebChart): WebChart;
 /**
  * Converts temporal binning properties from the old pattern to the new pattern introduced in version 19.0.0.
  * Former pattern:
@@ -388,12 +407,12 @@ declare function convertTo21x1x0(configToUpdate: WebChart): WebChart;
  */
 declare function convertTo23x3x0(configToUpdate: WebChart): WebChart;
 /**
- * Conversion for v24.3.0:
+ * Conversion for v24.5.0:
  * - Converts the temporal binning properties from the old pattern to the new pattern
  * @param configToUpdate The chart's config to update
  * @returns The updated chart config
  */
-declare function convertTo24x3x0(configToUpdate: WebChart): WebChart;
+declare function convertTo24x5x0(configToUpdate: WebChart): WebChart;
 /**
  * Apply the needed function calls depending on the current chart version.
  * Note: Additional switch cases and convertToxxx functions are to be added to this function accordingly.
@@ -430,12 +449,16 @@ declare function applyConversions<T extends WebChart>(props: {
  */
 export declare function convertChartSpec<T extends WebChart | WebGaugeChart>(config?: T, layerOrLayerView?: FeatureLayerView | SupportedLayer, chartContainer?: HTMLElement): Promise<T>;
 export declare const chartConfigConverterPrivateFunctions: {
+    adjustAxes: typeof adjustAxes;
+    adjustSeries: typeof adjustSeries;
     matchChartFieldsToLayerFields: typeof matchChartFieldsToLayerFields;
+    resetLegendMaxHeight: typeof resetLegendMaxHeight;
     moveSeriesQueryExtent: typeof moveSeriesQueryExtent;
     moveSeriesRotatedPropToChart: typeof moveSeriesRotatedPropToChart;
     renameDataSourceProperties: typeof renameDataSourceProperties;
     copyDataSourceFilterToConfig: typeof copyDataSourceFilterToConfig;
     adjustPieFromFieldsDefaultNameAndValue: typeof adjustPieFromFieldsDefaultNameAndValue;
+    removeSpacingPropertyFromGauge: typeof removeSpacingPropertyFromGauge;
     moveBoxPlotSeriesPropsToChart: typeof moveBoxPlotSeriesPropsToChart;
     movePieSeriesSortLabelsPropToChart: typeof movePieSeriesSortLabelsPropToChart;
     getProBoxPlotSortDataOption: typeof getProBoxPlotSortDataOption;
@@ -451,6 +474,7 @@ export declare const chartConfigConverterPrivateFunctions: {
     getDataOrderFromOrderByFields: typeof getDataOrderFromOrderByFields;
     convertWebChartDataValueTypes: typeof convertWebChartDataValueTypes;
     moveOrConvertSeriesOrderByFieldsToChartOrderOptions: typeof moveOrConvertSeriesOrderByFieldsToChartOrderOptions;
+    convertWebChartLabelBehaviorNoneToHide: typeof convertWebChartLabelBehaviorNoneToHide;
     handleOrderOptionsChanges: typeof handleOrderOptionsChanges;
     applyDataOrderInstructionForFromFieldsCharts: typeof applyDataOrderInstructionForFromFieldsCharts;
     convertTemporalBinningProps: typeof convertTemporalBinningProps;
@@ -476,7 +500,7 @@ export declare const chartConfigConverterPrivateFunctions: {
     convertTo20x2x0: typeof convertTo20x2x0;
     convertTo21x1x0: typeof convertTo21x1x0;
     convertTo23x3x0: typeof convertTo23x3x0;
-    convertTo24x3x0: typeof convertTo24x3x0;
+    convertTo24x5x0: typeof convertTo24x5x0;
     convertTemporalBinningProps2: typeof convertTemporalBinningProps2;
     applyConversions: typeof applyConversions;
     convertDataSourceToILayer: typeof convertDataSourceToILayer;

package/dist/utils/chart-config/utils/index.d.ts

@@ -1,4 +1,7 @@
-import { WebChart, WebChartSeriesType, RESTSymbolType, WebChartTypes, WebChartVersionStatus } from '../../../spec';
+import { ChartOptions } from '../../../chart-rendering/common/interfaces';
+import { IField, TimeIntervalInfo, WebBoxPlot, WebChart, WebChartSeriesType, RESTSymbolType, WebChartTypes, WebChartVersionStatus } from '../../../spec';
+import { DataUpdateDetails } from '../../data/interfaces';
+import { LimitBehavior } from '../../defaults/interfaces';
 import { ChartSubType } from '../../misc/interfaces';
 import { WebChartSeriesSupportingTemporalBinning } from './interfaces';
 /**
@@ -124,8 +127,264 @@ export declare function isSeriesUsingTimeBinning(props: {
  * @param series The series to test
  */
 export declare function doesSeriesSupportTemporalBinning(series: WebChartSeriesType): series is WebChartSeriesSupportingTemporalBinning;
+/**
+ * Compares the queries from two configs and indicates whether a query changed.  Noted that the query comparison
+ * includes the orderByFields from the orderOptions.
+ *
+ * A sort on the series is made before comparing to prevent a false positive on query reorder.
+ *
+ * @param props.previousConfig The former chart config
+ * @param props.newConfig The new chart config
+ * @param props.behaviorAfterLimit The chart's behavior once the data limit is reached
+ */
+declare function hasQueryChanged(props: {
+    previousConfig: WebChart;
+    newConfig: WebChart;
+    behaviorAfterLimit?: LimitBehavior;
+}): boolean;
+/**
+ * Compares two config data filters and returns true if they are identical, false otherwise
+ *
+ * @param previousConfig
+ * @param newConfig
+ */
+export declare function hasConfigFilterChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether the filter by selection was enabled or disabled
+ * @param previousFilterBySelection The previous valued for the filter by selection
+ * @param options The runtime options containing the new value for the filter by selection
+ */
+declare function hasFilterBySelectionChanged(previousFilterBySelection?: boolean, options?: ChartOptions): boolean;
+/**
+ * Compares the `binTemporalData` property from two configs and returns true if they are identical, false otherwise
+ *
+ * @param previousConfig
+ * @param newConfig
+ */
+declare function hasBinTemporalDataChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether a change of value format type requires new data. Two cases require it:
+ * - change from date format to numeric format
+ * - specific to non aggregated charts: change from category format to value format
+ *
+ * @param previousConfig The former chart config
+ * @param newConfig The new chart config
+ */
+declare function isNewDataRequiredForValueFormatChange(previousConfig: WebBoxPlot | WebChart, newConfig: WebBoxPlot | WebChart): boolean;
+/**
+ * Compares the `showMean` from two configs and indicates whether they are different
+ *
+ * @param previousConfig The former chart config
+ * @param newConfig The new chart config
+ */
+declare function hasShowMeanChanged(previousConfig: WebBoxPlot | WebChart, newConfig: WebBoxPlot | WebChart): boolean;
+/**
+ * Compares two gauge configs and indicates whether the series value conversion changed
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasGaugeValueConversionChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two heat chart configs to see if binning has changed
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasHeatChartBinningChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether additional tooltip fields (only non-numeric) changed
+ *
+ * **NOTE**: (only for scatterplot)
+ *
+ * @param {WebChart} props.previousConfig The previous config
+ * @param {WebChart} props.newConfig The updated config
+ * @param {IField[]|undefined} props.fieldList The layer field list
+ */
+export declare function hasAdditionalTooltipFieldsChanged(props: {
+    previousConfig: WebChart;
+    newConfig: WebChart;
+    fieldList?: IField[];
+}): boolean;
+/**
+ * Compares two configs and indicates whether the color type change
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasColorMatchChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether the legend visibilty changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatLegendConfigChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether the gradient rules changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasGradientRulesChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares the 'slices' array from the pie series, and indicates whether they are different.
+ * Compare only the slices id and label to avoid false positives.
+ *
+ * @param props.oldConfig The previous chart config
+ * @param props.newConfig The newest chart config
+ */
+export declare function hasSlicesConfigChanged(props: {
+    oldConfig: WebChart;
+    newConfig: WebChart;
+}): boolean;
+export declare function hasDataForFilterBySelectionChanged(props: {
+    previousSelectionOIDs?: (number | string)[];
+    options?: ChartOptions;
+}): boolean;
+/**
+ * Compares the split by value for each series element in the box plot config and returns true if the series has different split by value between new and old box plot config, false otherwise.
+ *
+ * @param oldSeries The former series config
+ * @param newSeries The new series config
+ */
+export declare function hasSplitByValueChanged(oldSeries: WebChart["series"], newSeries: WebChart["series"]): boolean;
+/**
+ * Verify if the order of the numeric fields has changed
+ *
+ * @param oldSeries - The previous series config
+ * @param newSeries - The new series config
+ */
+export declare function hasNumericFieldsChanged(oldSeries: WebChart["series"], newSeries: WebChart["series"]): boolean;
+/**
+ * Returns true when the time interval info was set previously and are not in the new config
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasTimeIntervalInfoBeenReset(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when the dual axis feature was enabled or disabled (number of axes changed)
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasDualAxisChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when the series are not associated to the same axis anymore
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasSeriesAxisChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when at least one guide's 'above' property changed from an update to another.
+ *
+ * @param oldConfig The old chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+export declare function hasAnyGuideAboveChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the rotated property changed since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasRotationChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the rotated property changed since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasOutliersVisibilityChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the 'standardizeValues' property changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasStandardizeValuesVisibilityChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the 'chartRenderer' property changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasChartRendererChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the 'timeZone' property from the axis value format changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasIntlTimeZoneChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Function saying if a data update is needed. We compare different properties from the former config and the new one
+ * in order to decide if the update is needed.
+ *
+ * @param props
+ */
+export declare function doesConfigChangeRequireNewData(props: {
+    previousConfig: WebBoxPlot | WebChart;
+    newConfig: WebBoxPlot | WebChart;
+    options?: ChartOptions;
+    previousFilterBySelection?: boolean;
+    previousTimeIntervalInfo?: TimeIntervalInfo;
+    previousSelectionOIDs?: (number | string)[];
+    fieldList?: IField[];
+}): {
+    dataUpdateNeeded: boolean;
+    dataUpdateDetails: DataUpdateDetails;
+};
+/**
+ * Determines if any of the series' name has changed between the previous and the new configs.
+ *
+ * The order of the series is preserved when comparing for changes.
+ *
+ * @param oldConfig The previous chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+declare function hasConfigSeriesNamesChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Determines if the series order has changed between the old and the new configs.
+ *
+ * @param oldConfig The previous chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+declare function hasSeriesOrderChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Determines whether a sort by series is needed.
+ * A sort by series is needed when either the series order has changed or any of the series names have changed.
+ *
+ * @param oldConfig The previous chart config.
+ * @param newConfig The new chart config.
+ * @returns
+ */
+export declare function isSortBySeriesNeeded(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Sorts the series in the config based on the series sort options.
+ * When no sort option is provide, no sorting is performed.
+ *
+ * @param chartConfig The optional chart config to sort the series
+ * @param chartContainer The HTML chart container
+ * @returns The updated chart config with the series sorted, or undefined if the input config is undefined
+ */
+export declare function sortConfigSeries<T extends WebChart | undefined>(chartConfig: T, chartContainer?: HTMLElement): T;
 export declare const chartConfigUtilsPrivateFunctions: {
     getPieChartChartSubType: typeof getPieChartChartSubType;
     getBarLineChartSubType: typeof getBarLineChartSubType;
+    hasQueryChanged: typeof hasQueryChanged;
+    hasFilterBySelectionChanged: typeof hasFilterBySelectionChanged;
+    hasBinTemporalDataChanged: typeof hasBinTemporalDataChanged;
+    hasGaugeValueConversionChanged: typeof hasGaugeValueConversionChanged;
+    isNewDataRequiredForValueFormatChange: typeof isNewDataRequiredForValueFormatChange;
+    hasShowMeanChanged: typeof hasShowMeanChanged;
+    hasHeatChartBinningChanged: typeof hasHeatChartBinningChanged;
+    hasSeriesOrderChanged: typeof hasSeriesOrderChanged;
+    hasConfigSeriesNamesChanged: typeof hasConfigSeriesNamesChanged;
 };
 export {};

package/dist/utils/chart-config/validator/index.d.ts

@@ -61,16 +61,6 @@ declare function findWarnings(props: {
  * @param chartConfig The chart config
  */
 declare function findCustomErrors(queryObject?: QueryObject, chartConfig?: WebChart | WebGaugeChart): Promise<CustomErrorObject[]>;
-export declare const chartConfigValidatorPrivateFunctions: {
-    findCustomErrors: typeof findCustomErrors;
-    findWarnings: typeof findWarnings;
-    findNumericAggregationWarnings: typeof findNumericAggregationWarnings;
-    findDuplicateSeriesIDWarnings: typeof findDuplicateSeriesIDWarnings;
-    findLayerLoadError: typeof findLayerLoadError;
-    createStartingSchema: typeof createStartingSchema;
-    extractSchemaNameFromRefPath: typeof extractSchemaNameFromRefPath;
-    customizeValidationErrors: typeof customizeValidationErrors;
-};
 /**
  * Validates the `WebChart` config by checking for  and displays `Errors` and `Warnings`.
  * - `Errors` are violations in the config w.r.t the JSON schema.
@@ -90,4 +80,14 @@ export declare function validateWebChart(props: {
  * @param config The config to analyze
  */
 export declare function isPartialConfig(config?: WebChart): boolean;
+export declare const chartConfigValidatorPrivateFunctions: {
+    findCustomErrors: typeof findCustomErrors;
+    findWarnings: typeof findWarnings;
+    findNumericAggregationWarnings: typeof findNumericAggregationWarnings;
+    findDuplicateSeriesIDWarnings: typeof findDuplicateSeriesIDWarnings;
+    findLayerLoadError: typeof findLayerLoadError;
+    createStartingSchema: typeof createStartingSchema;
+    extractSchemaNameFromRefPath: typeof extractSchemaNameFromRefPath;
+    customizeValidationErrors: typeof customizeValidationErrors;
+};
 export {};

package/dist/utils/components/config-update.d.ts

@@ -1,7 +1,9 @@
+import { default as Graphic } from '@arcgis/core/Graphic';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { ChartOptions } from '../../chart-rendering/common/interfaces';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 import { SupportedLayer, WebChart, WebChartLegendPositions } from '../../spec';
+import { QueryObject } from '../../utils';
 /**
  * Updates the legend position for a given WebChart config.
  * Returns the updated config.
@@ -35,12 +37,23 @@ export declare function resetAxesBounds(config?: WebChart): WebChart | undefined
  */
 export declare function isValidDataSource(config?: WebChart, layer?: FeatureLayerView | SupportedLayer): boolean;
 /**
- * Will add missing series to the chart config if:
- * - the config uses a split-by field
- * - adding missing series was requested (through the `updateSplitBySeries` property)
- * - unique values for the given split-by field don't have a series associated
- *
- * @param component The chart component
- * @param options The runtime options
+ * Alters the providing config to prepare it for rendering:
+ * - add the iLayer if missing
+ * - convert it to the latest version
+ * @param props.configToAlter The config to alter
+ * @param props.layer The component's layer
  */
-export declare function addMissingSplitBySeries(component: ArcgisChart, config: WebChart | undefined, options: ChartOptions): Promise<void>;
+export declare function prepareConfigForRendering(props: {
+    creation: boolean;
+    configToAlter: WebChart | undefined;
+    chartContainer?: HTMLElement;
+    queryObject: QueryObject;
+    options: ChartOptions;
+    previousConfig?: WebChart | undefined;
+    updateSplitBySeries: ArcgisChart["updateSplitBySeries"];
+    addMissingSeries: boolean;
+    layer: ArcgisChart["layer"];
+}): Promise<{
+    alteredConfig: ArcgisChart["config"];
+    preFetchedQueryResponse?: Graphic[];
+}>;