@arcgis/charts-components 4.34.0-next.98 → 4.34.0

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

@@ -1,4 +1,4 @@
-import { WebBoxPlot, WebChart, WebChartSeries, WebChartSortOrderKinds } from '@arcgis/charts-spec';
+import { WebBoxPlot, WebChart, WebChartSeries, WebChartSortOrderKinds } from '../../../spec';
 import { EsriColor } from '../types';
 /**
  * Returns true when the time interval info was set previously and are not in the new config
@@ -103,15 +103,29 @@ declare function hasSeriesOrderChanged(oldConfig: WebChart, newConfig: WebChart)
  * @returns
  */
 export declare function isSortBySeriesNeeded(oldConfig: WebChart, newConfig: WebChart): boolean;
+type DataOrderParameters = {
+    sortingField: string;
+    orderBy?: string[] | WebChartSortOrderKinds;
+    preferLabel?: boolean;
+};
 /**
  * Gets the `sortingField` and `orderBy` from the `orderOptions.data` for the boxplot chart.
  *
  * @param chartConfig The chart config
- * @returns A sortingField and orderBy object, or undefined.
+ * @returns An object with sortingField, optionally an orderBy and preferLabel, or undefined.
  */
-declare function getDataOrderParametersForBoxPlot(chartConfig: WebBoxPlot): {
+declare function getDataOrderParametersForBoxPlot(chartConfig: WebBoxPlot): DataOrderParameters | undefined;
+/**
+ * Gets the `sortingField` and `orderBy` from the `orderOptions.data` for the non-matrix heat chart.
+ *
+ * @param chartConfig The chart config
+ * @returns A sortingField and orderBy object, or undefined
+ *
+ * @remarks For matrix heat chart, this function will return undefined.
+ */
+declare function getDataOrderParametersForHeatChart(chartConfig: WebChart): {
     sortingField: string;
-    orderBy: string[] | WebChartSortOrderKinds;
+    orderBy: WebChartSortOrderKinds;
 } | undefined;
 /**
  * Gets the `sortingField` and `orderBy` from the `orderOptions.data` for bar, line, and pie charts,
@@ -121,23 +135,16 @@ declare function getDataOrderParametersForBoxPlot(chartConfig: WebBoxPlot): {
  * Notes: this function does not apply to boxplot, which is handled by `getDataOrderParametersForBoxPlot()`.
  *
  * @param chartConfig The chart configuration
- * @returns A sortingField and orderBy object, or undefined
+ * @returns An object with sortingField, optionally an orderBy and preferLabel, or undefined.
  */
-declare function getDataOrderParametersForCommonChart(chartConfig: WebChart): {
-    sortingField: string;
-    orderBy: string[] | WebChartSortOrderKinds;
-} | undefined;
+declare function getDataOrderParametersForCommonChart(chartConfig: WebChart): DataOrderParameters | undefined;
 /**
  * Constructs the `sortingField`, `orderBy`, and/or `preferLabel` for sorting the chart data.
  *
  * @param chartConfig The chart configuration
- * @returns An object with info about sortingField, orderBy, and optionally preferLabel
+ * @returns An object with sortingField, optionally an orderBy and preferLabel, or undefined.
  */
-export declare function getDataOrderParameters(chartConfig: WebChart): {
-    sortingField: string;
-    orderBy?: string[] | WebChartSortOrderKinds;
-    preferLabel?: boolean;
-} | undefined;
+export declare function getDataOrderParameters(chartConfig: WebChart): DataOrderParameters | undefined;
 /**
  * Returns true if the data order instructions (orderType or sortingField, orderBy, and/or preferLabel) have changed, or
  * the data update is needed.
@@ -185,10 +192,19 @@ export declare function sortConfigSeries<T extends WebChart | undefined>(chartCo
  * the split-by field and apply the right combination
  */
 export declare function getMeanLinesBoxPlotConfig(chartConfig: WebBoxPlot): WebBoxPlot;
+/**
+ * Checks if the given chart config is a matrix heat chart.  A matrix heat chart is defined as a chart with
+ * both axes using a category value format and the series type is heatSeries.
+ *
+ * @param chartConfig The chart config
+ * @returns True if the chart is a matrix heat chart, false otherwise
+ */
+export declare function isMatrixHeatChart(chartConfig?: WebChart): boolean;
 export declare const commonConfigutilsPrivateFunctions: {
     hasSeriesOrderChanged: typeof hasSeriesOrderChanged;
     hasConfigSeriesNamesChanged: typeof hasConfigSeriesNamesChanged;
     getDataOrderParametersForCommonChart: typeof getDataOrderParametersForCommonChart;
     getDataOrderParametersForBoxPlot: typeof getDataOrderParametersForBoxPlot;
+    getDataOrderParametersForHeatChart: typeof getDataOrderParametersForHeatChart;
 };
 export {};

package/dist/chart-rendering/common/data/box-plot/index.d.ts

@@ -1,4 +1,4 @@
-import { WebBoxPlot, WebChartDataItem, WebChartQuery, WebChartStatisticType } from '@arcgis/charts-spec';
+import { WebBoxPlot, WebChartDataItem, WebChartQuery, WebChartStatisticType } from '../../../../spec';
 import { AbortControllerKeyType, ChartElementLimit, QueryObject, BoxPlotYFieldKeys, ChartSubType } from '../../../../utils';
 import { OutliersFilterProps } from './interfaces';
 /**

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

@@ -1,4 +1,4 @@
-import { WebChartQuery, WebGaugeChart } from '@arcgis/charts-spec';
+import { WebChartQuery, WebGaugeChart } from '../../../../spec';
 import { AbortControllerKeyType, DataInfo, QueryObject } from '../../../../utils';
 import { ChartOptions } from '../../interfaces';
 /**

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartQuery, WebChartDataTransformations } from '@arcgis/charts-spec';
+import { WebChart, WebChartQuery, WebChartDataTransformations } from '../../../../spec';
 import { DataInfo, QueryObject } from '../../../../utils';
 import { FetchDataProps } from '../../interfaces';
 /**

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

@@ -1,5 +1,5 @@
 import { AbortControllerKeyType, ErrorStrings, QueryObject } from '../../../../utils';
-import { WebChart, WebChartDataItem, WebChartDataTransformations, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem, WebChartDataTransformations, WebChartQuery } from '../../../../spec';
 import { default as Graphic } from '@arcgis/core/Graphic';
 import { ChartOptions, FetchDataProps } from '../../interfaces';
 export interface TwoDimPoint {

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

@@ -1,11 +1,13 @@
-import { IField, WebBoxPlot, WebChart, WebChartDataItem, WebChartQuery } from '@arcgis/charts-spec';
+import { IField, WebBoxPlot, WebChart, WebChartDataItem, WebChartDataTypes, WebChartQuery } from '../../../spec';
 import { AbortControllerKeyType, BinnedServerData, DataInfo, ErrorStrings, QueryObject } from '../../../utils';
 import { ChartOptions } from '../interfaces';
 declare function fetchFinishedDataWithFilterBySelection(props: {
     queryObject?: QueryObject;
     chartConfig: WebChart;
     queryConfig: WebChartQuery;
+    currentChartData?: WebChartDataTypes;
     currentSelectionDataItems?: WebChartDataItem[];
+    currentSelectionOIDs?: number[];
     options?: ChartOptions;
     errorStrings: ErrorStrings;
     abortKey?: AbortControllerKeyType;
@@ -31,7 +33,9 @@ export declare function fetchFinishedBoxPlotData(props: {
 export declare function getData(props: {
     chartConfig: WebChart;
     queryObject?: QueryObject;
+    currentChartData?: WebChartDataTypes;
     currentSelectionDataItems?: WebChartDataItem[];
+    currentSelectionOIDs?: number[];
     binnedServerData?: BinnedServerData;
     options?: ChartOptions;
     errorStrings: ErrorStrings;

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem } from '../../../../spec';
 /**
  * Indicates whether the data context is associated to a slice group.
  *

package/dist/chart-rendering/common/data/scatter-plot/aggregation/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChart, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartQuery } from '../../../../../spec';
 import { default as Graphic } from '@arcgis/core/Graphic';
 import { default as AttributeBinsFeatureSet } from '@arcgis/core/rest/support/AttributeBinsFeatureSet.js';
 import { AbortControllerKeyType, ErrorStrings, QueryObject } from '../../../../../utils';

package/dist/chart-rendering/common/data/scatter-plot/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartScatterplotDataItem } from '@arcgis/charts-spec';
+import { WebChartScatterplotDataItem } from '../../../../spec';
 import { FetchScatterplotDataProps } from './interfaces';
 /**
  * Creates a WebChartScatterplotDataItem object with default values for r2 and trendLinePoints.

package/dist/chart-rendering/common/data/scatter-plot/interfaces.d.ts

@@ -1,6 +1,6 @@
 import { AbortControllerKeyType, QueryObject } from '../../../../utils';
 import { FetchDataProps } from '../../interfaces';
-import { WebChart, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartQuery } from '../../../../spec';
 export interface FetchScatterplotDataProps extends FetchDataProps {
     statsMap?: Map<string, number>;
     sortData?: boolean;

package/dist/chart-rendering/common/data/scatter-plot/trendline/index.d.ts

@@ -1,4 +1,4 @@
-import { WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChartDataItem } from '../../../../../spec';
 import { TrendlineDataProps } from './interfaces';
 /**
  * Returns whether the supports computing the trendline information on the server.

package/dist/chart-rendering/common/data/scatter-plot/trendline/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { QueryObject } from '../../../../../utils';
-import { WebChart, WebChartDataItem, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem, WebChartQuery } from '../../../../../spec';
 import { ChartOptions } from '../../../interfaces';
 export interface TrendlineDataProps {
     data?: WebChartDataItem[];

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

@@ -1,4 +1,4 @@
-import { WebChartDataItem, WebChartDataItemValue, RESTFieldType } from '@arcgis/charts-spec';
+import { WebChartDataItem, WebChartDataItemValue, RESTFieldType } from '../../../../../spec';
 import { BuildSelectionFilterProps } from './interfaces';
 declare function buildSelectionFilterForAScatterplotElement(props: BuildSelectionFilterProps): string;
 /**
@@ -42,12 +42,18 @@ declare function buildSelectionFilterForAPieChartElement(props: BuildSelectionFi
  * @param props.fieldType The field type
  * @param props.fieldValue The value of the field
  * @param props.unit The unit of the temporal binning
+ * @param props.outTimeZone The output time zone
+ * @param props.dataTimeZone The data time zone
+ * @param props.runsOnClientQueryEngine Whether the query will be executed on the client query engine (FeatureLayerView) or on the server
  */
 declare function getHeatChartFilterForCalendarParts(props: {
     field: string;
     fieldType?: RESTFieldType;
     fieldValue: WebChartDataItemValue;
     unit?: string;
+    outTimeZone?: string;
+    dataTimeZone?: string | null;
+    runsOnClientQueryEngine?: boolean;
 }): string | undefined;
 /**
  * Builds a selection filter for a heat chart element.
@@ -56,6 +62,9 @@ declare function getHeatChartFilterForCalendarParts(props: {
  * @param props.yAxisFieldType The y-axis field type
  * @param props.dataContext The data context containing the x and y values
  * @param props.chartConfig The chart configuration
+ * @param props.outTimeZone The output time zone
+ * @param props.dataTimeZone The data time zone
+ * @param props.runsOnClientQueryEngine Whether the query will be executed on the client query engine (FeatureLayerView) or on the server
  */
 declare function buildSelectionFilterForAHeatChartElement(props: BuildSelectionFilterProps): string;
 declare function buildSelectionFilterForAHistogramElement(props: BuildSelectionFilterProps): string;

package/dist/chart-rendering/common/data/selection/filter/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { RESTFieldType, WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { RESTFieldType, WebChart, WebChartDataItem } from '../../../../../spec';
 import { AbortControllerKeyType } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
 export declare const States: {
@@ -17,6 +17,9 @@ export interface BuildSelectionFilterProps extends SelectionProps {
     dataContext: WebChartDataItem;
     xAxisFieldType?: RESTFieldType;
     yAxisFieldType?: RESTFieldType;
+    outTimeZone?: string;
+    dataTimeZone?: string | null;
+    runsOnClientQueryEngine?: boolean;
     options?: ChartOptions;
     abortKey?: AbortControllerKeyType;
 }

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem } from '../../../../spec';
 import { ChartOptions } from '../../interfaces';
 /**
  * Function comparing two array containing selection items.
@@ -6,11 +6,17 @@ import { ChartOptions } from '../../interfaces';
  * @param props.itemsA First array
  * @param props.itemsB Second array
  * @param props.isPieFromFields Flag to indicate if the chart is a pie chart from fields
+ * @param props.x The x-axis field. Currently only used for a specific case related to the heat chart
+ * @param props.y The y-axis field. Currently only used for a specific case related to the heat chart
+ * @param props.outStatisticFieldName The out statistic field name. Currently only used for a specific case related to the heat chart
  */
 export declare function hasSelectionByItemsChanged(props: {
     itemsA?: WebChartDataItem[];
     itemsB?: WebChartDataItem[];
     isPieFromFields?: boolean;
+    x?: string;
+    y?: string;
+    outStatisticFieldName?: string;
 }): boolean;
 export declare function getSelectedData(props: {
     chartConfig: WebChart;

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartDataItem } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem } from '../../../../../spec';
 import { CompleteDataWithMissingCategoriesProps } from './interfaces';
 /**
  * Completes a chart data by adding all the unique values not already in the array

package/dist/chart-rendering/common/data/utils/categorical-data/interfaces.d.ts

@@ -1,5 +1,5 @@
 import { QueryObject, AbortControllerKeyType, LimitBehavior } from '../../../../../utils';
-import { WebChartDataItem, WebChart, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChartDataItem, WebChart, WebChartQuery } from '../../../../../spec';
 export interface CompleteDataWithMissingCategoriesProps {
     seriesData: WebChartDataItem[];
     chartConfig: WebChart;

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

@@ -1,4 +1,4 @@
-import { IExtent, IField, TimeIntervalInfo, ValueConversion, WebBoxPlot, WebChart, WebChartBin, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartSeriesType, WebGaugeChart, WebChartDataTransformations, WebChartSortOrderKinds } from '@arcgis/charts-spec';
+import { IExtent, IField, TimeIntervalInfo, ValueConversion, WebBoxPlot, WebChart, WebChartBin, WebChartDataItem, WebChartDataItemValue, WebChartDataTypes, WebChartSeriesType, WebGaugeChart, WebChartDataTransformations, WebChartSortOrderKinds } from '../../../../../spec';
 import { ChartElementLimit, SelectionIndexes, LimitBehavior } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
 import { DataUpdateNeededDetails } from './interfaces';
@@ -23,6 +23,7 @@ export declare function mergeExtents(extentList?: IExtent[]): IExtent | undefine
  * @param props.specificField A specific field to look for
  * @param props.preferLabel Whether to use field label instead of value
  * @param props.keepNullValues Whether to keep the null values
+ * @param props.config The chart's config
  */
 export declare function getXAxisValueFromContext(props: {
     value: Date | number | string;
@@ -31,6 +32,7 @@ export declare function getXAxisValueFromContext(props: {
     specificField?: string;
     preferLabel?: boolean;
     keepNullValues?: boolean;
+    config?: WebChart;
 }): Date | number | string;
 /**
  * Looks for the original x value in the data context. Chooses by order of priority:
@@ -46,10 +48,10 @@ export declare function getOriginalXValueFromContext(dataContext?: WebChartDataI
  * @param props.arrayToSort The array to sort
  * @param props.sortingField The field to sort by
  * @param props.orderBy The order by
- * @param props.forceAscendingOrder Whether to force the ascending order
- * @param props.isNonAggregated Whether the chart is non-aggregated
- * @param props.sortByCategory Whether to sort by the x-axis field
- * @param props.preferLabel Whether to use data labels
+ * @param props.forceAscendingOrder Whether to force the ascending order; only applies for non-heat charts
+ * @param props.isNonAggregated Whether the chart is non-aggregated; only applies for non-heat charts
+ * @param props.sortByCategory Whether to sort by the x-axis field; only applies for non-heat charts
+ * @param props.preferLabel Whether to use data labels; only applies for non-heat charts
  * @param props.isPieOrByFieldsChart Whether it is a pie or by fields chart
  */
 export declare function sortWebChartDataItemsUsingDirectionalSort(props: {
@@ -187,6 +189,27 @@ export declare function convertMultipleNumericFieldsData(props: {
  * @param newConfig The updated config
  */
 declare function hasGaugeValueConversionChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two heat chart configs to see if binning has changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasHeatChartBinningChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether additional tooltip fields (only non-numeric) changed
+ *
+ * **NOTE**: (only for scatterplot)
+ *
+ * @param {WebChart} props.oldConfig The previous config
+ * @param {WebChart} props.newConfig The updated config
+ * @param {IField[]|undefined} props.fieldList The layer field list
+ */
+export declare function hasAdditionalTooltipFieldsChanged(props: {
+    oldConfig: WebChart;
+    newConfig: WebChart;
+    fieldList?: IField[];
+}): boolean;
 /**
  * Compares two configs and indicates whether the color type change
  *
@@ -194,6 +217,20 @@ declare function hasGaugeValueConversionChanged(oldConfig: WebChart, newConfig:
  * @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.
@@ -221,17 +258,10 @@ declare function hasQueryChanged(props: {
     behaviorAfterLimit?: LimitBehavior;
 }): boolean;
 declare function hasFilterBySelectionChanged(filterBySelection?: boolean, options?: ChartOptions): boolean;
-declare function hasDataForFilterBySelectionChanged(props: {
+export declare function hasDataForFilterBySelectionChanged(props: {
     currentSelectionOIDs?: number[];
     options?: ChartOptions;
 }): boolean;
-/**
- * Compares two config data filters and returns true if they are identical, false otherwise
- *
- * @param oldConfig
- * @param newConfig
- */
-declare function hasConfigFilterChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
 /**
  * Compares the `binTemporalData` property from two configs and returns true if they are identical, false otherwise
  *
@@ -285,6 +315,7 @@ export declare function isDataUpdateNeeded(props: {
     currentSelectionDataItems?: WebChartDataItem[];
     currentSelectionOIDs?: number[];
     currentSelectionIndexes?: SelectionIndexes;
+    fieldList?: IField[];
 }): {
     dataUpdateNeeded: boolean;
     updateNeededDetails: DataUpdateNeededDetails;
@@ -364,12 +395,11 @@ export declare function extractPercentValue(inputValue: string): number | undefi
 export declare const commonUtilsMiscPrivateFunctions: {
     getMultiSeriesLimit: typeof getMultiSeriesLimit;
     hasFilterBySelectionChanged: typeof hasFilterBySelectionChanged;
-    hasConfigFilterChanged: typeof hasConfigFilterChanged;
     hasBinTemporalDataChanged: typeof hasBinTemporalDataChanged;
     hasGaugeValueConversionChanged: typeof hasGaugeValueConversionChanged;
     isNewDataRequiredForValueFormatChange: typeof isNewDataRequiredForValueFormatChange;
     hasShowMeanChanged: typeof hasShowMeanChanged;
-    hasDataForFilterBySelectionChanged: typeof hasDataForFilterBySelectionChanged;
+    hasHeatChartBinningChanged: typeof hasHeatChartBinningChanged;
     hasQueryChanged: typeof hasQueryChanged;
     isValidPercentValue: typeof isValidPercentValue;
 };

package/dist/chart-rendering/common/data/utils/misc/interfaces.d.ts

@@ -21,4 +21,10 @@ export interface DataUpdateNeededDetails {
     boxPlot: {
         showMeanChanged: boolean;
     };
+    heatChart: {
+        binningChanged: boolean;
+    };
+    scatterPlot: {
+        tooltipFieldsChanged: boolean;
+    };
 }

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

@@ -1,4 +1,4 @@
-import { TimeIntervalInfo, WebBoxPlot, WebChart, WebChartQuery, WebChartTemporalBinningTypes } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebBoxPlot, WebChart, WebChartQuery } from '../../../../../spec';
 import { QueryObject, ChartSubType } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
 import { UniqueQuery } from './interfaces';
@@ -18,8 +18,8 @@ import { UniqueQuery } from './interfaces';
  * @param props.queryObject  The query object (layer or feature layer view)
  * @param props.chartSubType The chart sub type
  * @param props.isTimeBinningSeries Whether the chart is using time binning
- * @param props.temporalBinningType The temporal binning type
  * @param props.returnFeaturesExtent Whether the features extent need to be fetched by the query
+ * @param props.splitByField The split-by field
  */
 declare function modifyOutStatistics(props: {
     uniqueQuery: WebChartQuery;
@@ -28,8 +28,8 @@ declare function modifyOutStatistics(props: {
     queryObject?: QueryObject;
     chartSubType: ChartSubType;
     isTimeBinningSeries: boolean;
-    temporalBinningType?: WebChartTemporalBinningTypes;
     returnFeaturesExtent?: boolean;
+    splitByField?: string;
 }): void;
 /**
  * Handles the limitation of features on the chart (when the chart limits are reached but the requested behavior is to render up to the limit).

package/dist/chart-rendering/common/data/utils/query-parser/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { WebChartQuery, IStatisticDefinition } from '@arcgis/charts-spec';
+import { WebChartQuery, IStatisticDefinition } from '../../../../../spec';
 export interface UniqueQuery {
     uniqueQuery: WebChartQuery;
     mapToStatField: Map<number | string | null, string>;

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

@@ -1,2 +1,15 @@
-import { WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { WebChartTemporalBinningUnits } from '../../../../../../spec';
+/**
+ * Generates the INTERVAL SQL instruction to shift date values from the data time zone to the output time zone.
+ * This is inspired by the Dashboards implementation currently found here:
+ * https://devtopia.esri.com/WebGIS/arcgis-dashboards/blob/develop-4/packages/dashboard-view-models/addon/-private/service-dataset.js.
+ * @param props.outTimeZone The output time zone (typically the user locale)
+ * @param props.dataTimeZone The data time zone (usually UTC but can be set differently on the layer)
+ * @param props.runsOnClientQueryEngine Whether the query will be executed on the client query engine (FeatureLayerView) or on the server
+ */
+export declare function getIntervalStatement(props: {
+    outTimeZone?: string;
+    dataTimeZone?: string | null;
+    runsOnClientQueryEngine?: boolean;
+}): string;
 export declare function getTimeBinGroupByFieldsForStatistics(dateFieldName: string, unit: WebChartTemporalBinningUnits): string[];

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

@@ -1,4 +1,4 @@
-import { WebChartDataItemValue } from '@arcgis/charts-spec';
+import { WebChartDataItemValue } from '../../../../../spec';
 /**
  * Transform a couple key/value to where clause equivalent to 'key = value'.
  * It adds quotes around the value if it's not detected as a number.

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

@@ -1,13 +1,6 @@
-import { WebChart, WebChartDataItem, WebChartDataTypes, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChart, WebChartDataItem, WebChartDataTypes, WebChartQuery } from '../../../../../spec';
 import { ErrorStrings, QueryObject } from '../../../../../utils';
 import { ChartOptions } from '../../../interfaces';
-/**
- * Builds a where clause following the pattern `<OID field> in (<list_of_OIDs>)`
- *
- * @param fieldOID
- * @param listOIDs
- */
-export declare function joinOIDs(fieldOID: string, listOIDs?: number[]): string | undefined;
 /**
  * Fetches data from a list of OIDs. If the chart is non aggregated we directly read the OIDs stored in the data context,
  * and if the chart is aggregated we perform queries to fetch the data.

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

@@ -1,7 +1,7 @@
-import { IExtent, IField, IStatisticDefinition, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartDataItem, WebChartDataItemValue, WebChartLineChartSeries, WebChartPieChartSeries, WebChartQuery, WebChartSeriesType } from '@arcgis/charts-spec';
 import { default as Graphic } from '@arcgis/core/Graphic';
+import { IExtent, IField, IStatisticDefinition, WebChart, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCalendarDatePartsUnits, WebChartDataItem, WebChartDataItemValue, WebChartLineChartSeries, WebChartPieChartSeries, WebChartQuery, WebChartSeriesType } from '../../../../../spec';
 import { DataInfo, QueryObject, ChartSubType, LimitBehavior } from '../../../../../utils';
-import { FetchDataProps } from '../../../interfaces';
+import { ChartOptions, FetchDataProps } from '../../../interfaces';
 import { ProcessUniqueQueryProps } from './interfaces';
 /**
  * Returns the feature extent and the extent key for a feature.
@@ -11,7 +11,7 @@ import { ProcessUniqueQueryProps } from './interfaces';
  * @param props.chartSubType The chart subtype
  * @returns
  */
-declare function getFeatureGeometryExtent(props: {
+export declare function getFeatureGeometryExtent(props: {
     feature: Graphic;
     splitByField?: string;
     chartSubType?: ChartSubType;
@@ -192,12 +192,29 @@ export declare function sortFetchedData(props: {
  * @param props
  */
 export declare function fetchFinishedGenericChartData(props: FetchDataProps): Promise<DataInfo>;
+/**
+ * Generates an array of values based on the given unit
+ * @param unit The unit used to generate the values to return
+ * @returns an array of string values, from "1" to the maximum value of the unit (e.g. "12" for MonthOfYear)
+ */
+declare function getExpectedValuesFromDatePartsUnit(unit: WebChartCalendarDatePartsUnits): string[] | undefined;
 /**
  * Fetching the data for a heat chart.
  * It fetches the data from the attribute bins and processes it to match the heat chart data structure.
  * @param props The list of properties required to fetch the data
  */
 export declare function fetchFinishedHeatChartData(props: FetchDataProps): Promise<DataInfo>;
+/**
+ * Function trimming the temporal dataset by considering the rendering limits.
+ * @param props.chartConfig The chart's config
+ * @param props.options The chart's options
+ * @param props.data The data to trim
+ */
+declare function trimTemporalDataset(props: {
+    chartConfig: WebChart;
+    options?: ChartOptions;
+    data: WebChartDataItem[];
+}): WebChartDataItem[];
 /**
  * Fetching the data for specifically a line chart using time binning options.
  *
@@ -234,5 +251,7 @@ export declare const commonUtilsSummarizeDataPrivateFunctions: {
     renameYFieldForSplitByNoAggregation: typeof renameYFieldForSplitByNoAggregation;
     trimCategories: typeof trimCategories;
     limitCategories: typeof limitCategories;
+    getExpectedValuesFromDatePartsUnit: typeof getExpectedValuesFromDatePartsUnit;
+    trimTemporalDataset: typeof trimTemporalDataset;
 };
 export {};

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

@@ -1,4 +1,4 @@
-import { WebChartDataItemValue, WebChartDataItem, WebChartQuery, WebChart, IStatisticDefinition } from '@arcgis/charts-spec';
+import { WebChartDataItemValue, WebChartDataItem, WebChartQuery, WebChart, IStatisticDefinition } from '../../../../../spec';
 import { QueryObject, AbortControllerKeyType, ChartElementLimit, ChartSubType } from '../../../../../utils';
 export interface SummarizeDataProps {
     data: [WebChartDataItemValue, WebChartDataItem[]][];
@@ -22,3 +22,4 @@ export interface ProcessUniqueQueryProps {
 /** List of chart subtypes that support direct category trimming. */
 export declare const supportedSubTypesForCategoryTrimming: ChartSubType[];
 export declare const totalFeatureCount = "arcgis_charts_total_feature_count";
+export declare const queryBinsServerLimit = 8000;

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

@@ -1,5 +1,5 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { TimeIntervalInfo, WebChart, WebChartDataItem, WebChartQuery, WebChartSeriesType, WebChartNullPolicyTypes, WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChart, WebChartDataItem, WebChartQuery, WebChartSeriesType, WebChartNullPolicyTypes, WebChartTemporalBinningUnits } from '../../../../../../spec';
 import { DateRange, QueryObject, TimeBinningStatistics, WebChartSeriesSupportingTemporalBinning } from '../../../../../../utils';
 /**
  * Given `getNumberOfBinsWithinDataRange()` returns a diff in days for weeks, months and years, we need
@@ -25,6 +25,7 @@ export declare function getTimeBinningStatistics(props: {
 }): Promise<TimeBinningStatistics>;
 /**
  * Maps query results into a WebChartDataItem[] for a chart using the charts solution for temporal binning.
+ * @param props.chartConfig The chart configuration
  * @param props.queryResults The query results
  * @param props.mapToStatField The map of unique values to stat fields
  * @param props.splitByField The split-by field
@@ -34,6 +35,7 @@ export declare function getTimeBinningStatistics(props: {
  * @param props.queryObject The query object used to fetch the data
  */
 export declare function mapTemporalBinningQueryAttributeBinsResults(props: {
+    chartConfig: WebChart;
     queryResults: __esri.AttributeBinsGraphic[];
     mapToStatField: Map<number | string | null, string>;
     splitByField?: string;

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

@@ -1,4 +1,4 @@
-import { Color, ISimpleFillSymbol, WebChartCursorCrosshair, WebChartDataItem, WebChartPieChartGroupSlice, RESTHorizontalAlignment, RESTSimpleMarkerSymbolStyle, RESTVerticalAlignment, WebChartLegendPositions, WebChartLineSmoothedKinds, WebChartSortOrderKinds, WebChartStackedKinds } from '@arcgis/charts-spec';
+import { Color, ISimpleFillSymbol, WebChartCursorCrosshair, WebChartDataItem, WebChartNullCategory, WebChartPieChartGroupSlice, RESTHorizontalAlignment, RESTSimpleMarkerSymbolStyle, RESTVerticalAlignment, WebChartLegendPositions, WebChartLineSmoothedKinds, WebChartSortOrderKinds, WebChartStackedKinds } from '../../../spec';
 import { SelectionTheme, ActionModes } from '../../../utils';
 import { EsriColor } from '../types';
 export interface GaugeNeedleDefaults {
@@ -159,6 +159,7 @@ export interface CommonChartDefaults {
     seriesSort: Readonly<WebChartSortOrderKinds>;
     technicalSortingFieldBySum: string;
     technicalSortingFieldByPercent: string;
+    technicalFieldSplitByField: string;
     color: Readonly<EsriColor>;
     dataTooltipVisible?: boolean;
     dataTooltipStyle?: Readonly<Partial<ISimpleFillSymbol>>;
@@ -296,6 +297,13 @@ export interface CommonChartDefaults {
         /** represents default value to use for when `replaceNoValueCategoryWithZero` is not defined in the `options` object. */
         replaceNoValueCategoryWithZero: boolean;
     };
+    /**
+     * Specifies how to display the category with null value
+     * Setting this property will ensure that the item with no data is displayed on the chart with the specified text and color.
+     */
+    nullCategory: WebChartNullCategory;
+    /** gray color used for various purposes */
+    grayColor: EsriColor;
 }
 /**
  * A nested dictionary which contains default values for cases when a property is undefined.

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

@@ -1,4 +1,4 @@
-import { WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartTypes } from '../../../spec';
 import { ChartElementLimit, DataInfo, DataWarningObject, ErrorStrings, QueryObject, DataWarningKeywords } from '../../../utils';
 interface DataLimitSubError {
     outlierLimit?: boolean;

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

@@ -1,5 +1,5 @@
+import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChart, WebChartDataItem, WebChartDataTypes, WebChartSeriesType } from '../../../spec';
 import { DataWarningObject, PieSlicesSymbols, SelectionData, SeriesSymbolsMap, ValidationStatus } from '../../../utils';
-import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChart, WebChartDataItem, WebChartDataTypes, WebChartSeriesType } from '@arcgis/charts-spec';
 /**
  * Sending an event carrying the chart processed data at any data update.
  * Contains the statistics for Histogram and Scatterplot