@arcgis/charts-components 5.2.0-next.8 → 5.2.0-next.85

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

@@ -1,13 +1,15 @@
 import type { DataOrderParameters } from "../../../chart-rendering/common/data/utils/summarize-data/interfaces.js";
+import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 import type { WebChartTypes, WebChartVersionStatus } from "../../../spec/chart-object-literals.js";
+import type { WebChartBin, WebChartDataItem } from "../../../spec/data-source.js";
 import type { RESTSymbolType } from "../../../spec/rest-js-object-literals.js";
-import type { IField } from "../../../spec/rest-js-types.js";
-import type { WebBoxPlot, WebChart, WebChartLegend, WebChartSeriesType, WebHeatChart } from "../../../spec/web-chart.js";
+import type { IField, ISimpleFillSymbol } from "../../../spec/rest-js-types.js";
+import type { WebBoxPlot, WebChart, WebChartLegend, WebChartNullCategory, WebChartSeriesType, WebHeatChart } from "../../../spec/web-chart.js";
 import type { DataUpdateDetails } from "../../data/interfaces.js";
+import type { ChartElementLimit } from "../../defaults/interfaces.js";
 import type { QueryObjectOrRaster as QueryObject } from "../../layer/interfaces.js";
 import type { ChartSubType, SelectionData } from "../../misc/interfaces.js";
 import type { WebChartSeriesSupportingTemporalBinning } from "./interfaces.js";
-import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 
 /**
  * Retrieve and construct chart version information based on the input version and the currently supported ArcGIS Chart versions
@@ -87,7 +89,7 @@ export function getSplitByValue(props: {
  * @param where
  * @internal
  */
-export function isAbsoluteTruthWhereClause(where?: string): boolean;
+export function isAbsoluteTruthWhereClause(where?: number | string): boolean;
 
 /**
  * Normalizes a where clause, by escaping the "'" character and other special characters if needed.
@@ -95,6 +97,7 @@ export function isAbsoluteTruthWhereClause(where?: string): boolean;
  *   - where = "field = 5" => returns "field = 5"
  *   - where = "field = 'value'" => returns "field = 'value'"
  *   - where = "field = 'va'lue'" => returns "field = 'va''lue'"
+ *   - where = "field = null => returns "field IS NULL"
  *
  * @param props - the where clause to normalize
  * @internal
@@ -128,6 +131,35 @@ export function getBoxPlotChartSubType(seriesConfig: WebChartSeriesType[]): Char
  */
 export function getChartSubType(series?: WebChartSeriesType[]): ChartSubType;
 
+/**
+ * A function to determine whether the scatterplot is aggregated.
+ * It can use a map of statistics containing the number of points (computed from the data side) or
+ * a data context object usually stored within each marker.
+ *
+ * @param props - an optional map of statistics
+ * @returns A boolean indicating whether the scatterplot is aggregated
+ * @internal
+ */
+export function isScatterplotAggregated(props: {
+    statsMap?: Map<string, number>;
+    dataContext?: WebChartDataItem;
+    chartLimits?: ChartElementLimit;
+}): boolean;
+
+/**
+ * A function to determine whether a chart is aggregated.
+ * Supports scatterplot, bar, line, combo, and pie chart. Defaults to true for the other types of chart.
+ *
+ * @param props - An optional data context object
+ * @returns A boolean indicating whether the chart is aggregated
+ * @internal
+ */
+export function isChartAggregated(props: {
+    dataContext?: WebChartBin | WebChartDataItem;
+    chartConfig: WebChart;
+    chartLimits?: ChartElementLimit;
+}): boolean;
+
 /**
  * Indicates whether the bar or line series is configured to use time binning.
  *
@@ -414,10 +446,10 @@ export function doesConfigChangeRequireNewData(props: {
     previousSelectionOIDs?: (number | string)[];
     fieldList?: IField[];
     queryObject?: QueryObject;
-    filterBySelection?: ChartOptions["filterBySelection"];
+    filterBySelection?: boolean;
     selectionData?: ChartOptions["selectionData"];
-    setTimeBinningInfoWhenNotProvided?: ChartOptions["setTimeBinningInfoWhenNotProvided"];
-    chartLimits?: ChartOptions["chartLimits"];
+    setTimeBinningInfoWhenNotProvided?: boolean;
+    chartLimits?: ChartElementLimit;
 }): {
     dataUpdateNeeded: boolean;
     dataUpdateDetails: DataUpdateDetails;
@@ -440,6 +472,7 @@ export function sortConfigSeries<T extends WebChart | undefined>(chartConfig: T,
  * This allows x and y category lists to be ordered independently from the flattened cell data traversal.
  *
  * @param props - The chart config containing the heat-chart multi-axis sort instructions
+ * @internal
  */
 export function getHeatChartAxisDataOrderInstruction(props: {
     chartConfig: WebHeatChart;
@@ -451,6 +484,7 @@ export function getHeatChartAxisDataOrderInstruction(props: {
  *
  * @param chartConfig - The chart configuration
  * @returns An array of objects with sortingField, optionally an orderBy and preferLabel, or undefined.
+ * @internal
  */
 export function getDataOrderParameters(chartConfig: WebChart | undefined): DataOrderParameters[] | undefined;
 
@@ -459,9 +493,25 @@ export function getDataOrderParameters(chartConfig: WebChart | undefined): DataO
  * the data update is needed.
  *
  * @param props - The previous chart config
+ * @internal
  */
 export function isNewSortNeeded(props: {
     oldConfig: WebChart | undefined;
     newConfig: WebChart;
     dataWasUpdated: boolean;
-}): boolean;
+}): boolean;
+
+/**
+ * Returns the fill symbol for the null category, if defined.
+ *
+ * @param nullCategory - The null category object
+ * @internal
+ */
+export function getNullCategoryFillSymbol(nullCategory?: WebChartNullCategory): ISimpleFillSymbol | undefined;
+
+/**
+ * Get the text for null category if it is supported and defined in the chart config
+ *
+ * @param chartConfig - chartConfig
+ */
+export function getNullCategoryText(chartConfig?: WebChart): string | undefined;

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

@@ -9,6 +9,7 @@ import type { WebChart, WebGaugeChart } from "../../../spec/web-chart.js";
  * - `Errors`: Violations in the config with regard to the JSON schema.
  * - `Warnings`: Undesired combinations in the config which don't violate the JSON schema but should still be blocked.
  *
+ * @deprecated since 5.1. Won't be replaced.
  * @param props - The input config, the query object and whether to allow using the object id field as a statistic field.
  * @returns The validation status.
  */

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

@@ -28,9 +28,9 @@ export interface CustomErrorObject {
 }
 
 /**
- * Validation Status interface which described the validity of the input WebChart config
+ * Validation Status interface which described the validity of the input WebChart config.
  *
- * @internal
+ * @deprecated since 5.1. Won't be replaced.
  */
 export interface ValidationStatus {
   valid: boolean;
@@ -55,6 +55,7 @@ export const ConfigErrorKeywords: {
 export const DataWarningKeywords: {
     readonly BadData: "badData";
     readonly EmptyDataSet: "emptyDataSet";
+    readonly NoValue: "noValue";
     readonly InvalidConfig: "invalidConfig";
     readonly HistogramEmptyField: "histogramEmptyField";
     readonly BarElementExceedsLimit: "barElementExceedsLimit";
@@ -64,6 +65,7 @@ export const DataWarningKeywords: {
     readonly HeatChartExceedsLimit: "heatChartExceedsLimit";
     readonly PieChartExceedsLimit: "pieChartExceedsLimit";
     readonly GaugeExceedsLimit: "gaugeExceedsLimit";
+    readonly RadarChartExceedsLimit: "radarChartExceedsLimit";
     readonly PieChartMixOfNegativePositiveSlices: "PieChartMixOfNegativePositiveSlices";
     readonly NegativeValueInSqrtCalculation: "negativeValueInSqrtCalculation";
     readonly NegativeValueInLogCalculation: "negativeValueInLogCalculation";
@@ -80,7 +82,6 @@ export interface ElementCountExceededParams {
   seriesLimit?: number;
 }
 
-/** @internal */
 export interface DataWarningObject {
   keyword: DataWarningKeywords;
   header?: string;

package/dist/utils/components/interfaces.d.ts

@@ -8,6 +8,8 @@ export interface MissingSplitBySeriesProps {
 export const DownloadableChartImagesTypes: {
     readonly PNG: "png";
     readonly JPEG: "jpeg";
+    readonly JPG: "jpg";
+    readonly WEBP: "webp";
     readonly SVG: "svg";
 };
 

package/dist/utils/cursor/interfaces.d.ts

@@ -1,3 +1,14 @@
+/**
+ * Specifies how user interactions on the chart are handled.
+ *
+ * - `monoSelection`: Select one data point or series at a time. Each new selection replaces the previous selection.
+ * - `multiSelection`: Select multiple data points or series. Each new selection is added to the existing selection.
+ * - `multiSelectionWithCtrlKey`: Select multiple data points or series only while holding Ctrl (or Cmd on macOS). Without the key, selection behaves like `monoSelection`.
+ * - `zoom`: Zoom into an area of the chart.
+ * - `none`: Disable interaction-driven selection and zoom actions.
+ *
+ * **Note**: Not applicable to gauges.
+ */
 export const ActionModes: {
     readonly MonoSelection: "monoSelection";
     readonly MultiSelection: "multiSelection";
@@ -8,6 +19,16 @@ export const ActionModes: {
 
 export type ActionModes = (typeof ActionModes)[keyof typeof ActionModes];
 
+/**
+ * Defines how the cursor selection rectangle is constrained when `actionMode` is `zoom`, `multiSelection`, or `multiSelectionWithCtrlKey`.
+ *
+ * - `multi-axes`: Allows drawing a free rectangle across both axes.
+ * - `x-axis`: Constrains the rectangle to the x-axis direction.
+ * - `y-axis`: Constrains the rectangle to the y-axis direction.
+ * - `undefined`: Uses the default behavior for the current chart type and action mode.
+ *
+ * **Note**: Not applicable to gauges.
+ */
 export const CursorRange: {
     readonly MultiAxes: "multi-axes";
     readonly XAxis: "x-axis";

package/dist/utils/data/categorical-data/index.d.ts

@@ -5,7 +5,7 @@ import type { AbortControllerKeyType } from "../../layer/query-features/interfac
 import type { ErrorStrings } from "../../localization/interfaces.js";
 
 /**
- * Fetches the unique values from a given field.
+ * Fetches the unique values from a given field and the number of features associated to each one of them.
  * /!\ Currently the results for a same split-by field might differ from a category field to another.
  * This is due to the server not being able to make a distinction in some cases between values having for
  * only difference trailing spaces (e.g. `value` and `value ` and `value  `). It means it will aggregate the

package/dist/utils/data/index.d.ts

@@ -1,7 +1,8 @@
 import type { ChartOptions } from "../../chart-rendering/common/interfaces.js";
 import type { WebChartStatisticType } from "../../spec/chart-object-literals.js";
 import type { WebChartBin, WebChartDataItem, WebChartDataTypes } from "../../spec/data-source.js";
-import type { WebChart, WebChartSeriesType, WebGaugeChart } from "../../spec/web-chart.js";
+import type { WebChart, WebChartDataFilters, WebChartSeriesType, WebGaugeChart } from "../../spec/web-chart.js";
+import type { ChartElementLimit } from "../defaults/interfaces.js";
 import type { QueryObject } from "../layer/interfaces.js";
 import type { ErrorStrings } from "../localization/interfaces.js";
 import type { ChartSubType } from "../misc/interfaces.js";
@@ -100,6 +101,7 @@ export function validateBarNLineChartDataItem(props: {
     x: string;
     y: string;
     nullAsValid?: boolean;
+    zeroCountAsValid?: boolean;
     aggregationType?: WebChartStatisticType;
 }): boolean;
 
@@ -113,6 +115,7 @@ export function validateBarNLineChartDataItem(props: {
 export function isEmptyDataset(props: {
     chartConfig?: WebChart | WebGaugeChart;
     nullAsValid?: boolean;
+    zeroCountAsValid?: boolean;
     dataSet?: WebChartDataItem[];
 }): boolean;
 
@@ -158,10 +161,11 @@ export function getDataMinMaxFromSeries(props: {
  * Get the series id related to the given axis (useful in dual axis mode).
  *
  * @param props - The chart configuration
+ * @internal
  */
 export function getAxisSeriesIds(props: {
     chartConfig: WebChart;
-    isSecondValueAxis?: boolean;
+    isSecondaryYAxis?: boolean;
     seriesIds?: string[];
 }): string[] | undefined;
 
@@ -183,6 +187,7 @@ export function whetherLogScaleIsDataCompatible(props: {
  *
  * @param modifiedData - The data to revert
  * @param seriesConfig - The series config
+ * @internal
  */
 export function revertPieFromFieldsProperties<T extends WebChartDataItem[] | WebChartDataTypes>(modifiedData: T, seriesConfig?: WebChart["series"]): T;
 
@@ -193,6 +198,7 @@ export function revertPieFromFieldsProperties<T extends WebChartDataItem[] | Web
  *
  * @param data - The data containing modified x or y values
  * @param seriesConfig - The series config
+ * @internal
  */
 export function revertOriginalXAndYValues<T extends WebChartDataItem[] | WebChartDataTypes>(data: T, seriesConfig?: WebChart["series"]): T;
 
@@ -201,6 +207,7 @@ export function revertOriginalXAndYValues<T extends WebChartDataItem[] | WebChar
  *
  * @param dataItem - The data item to sanitize
  * @returns The sanitized data item
+ * @internal
  */
 export function removeAdditionalStatisticsPerItem(dataItem: WebChartDataItem): WebChartDataItem;
 
@@ -210,6 +217,7 @@ export function removeAdditionalStatisticsPerItem(dataItem: WebChartDataItem): W
  * @param data - The data set to modify
  * @param seriesConfig - The series config
  * @returns The sanitized data
+ * @internal
  */
 export function removeAdditionalStatistics(data: WebChartDataTypes, seriesConfig: WebChartSeriesType[]): WebChartDataTypes;
 
@@ -227,6 +235,7 @@ export function roundToDecimals(num: number, dec: number): number;
  * The point is to send meaningful data to the user through events or the `chartWillRender()` function.
  *
  * @param props - The data to sanitize
+ * @internal
  */
 export function sanitizeData(props: {
     data?: WebChartDataTypes;
@@ -234,10 +243,10 @@ export function sanitizeData(props: {
 }): WebChartDataTypes | 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.
+ * Fetches data from a list of OIDs. If the ids are stored within the chart's data we directly use them, otherwise we perform queries to find the matching data items.
  *
  * @param props - A snapshot of the updated props, used to determine whether the selection OIDs have changed
+ * @internal
  */
 export function getSelectionItemsFromOIDs(props: {
     chartData?: WebChartDataTypes;
@@ -245,27 +254,24 @@ export function getSelectionItemsFromOIDs(props: {
     queryObject: QueryObject;
     dataWasUpdated?: boolean;
     selectionData?: ChartOptions["selectionData"];
-    replaceNoValueCategoryWithZero?: ChartOptions["replaceNoValueCategoryWithZero"];
-    hideZeroCountCategories?: ChartOptions["hideZeroCountCategories"];
-    chartLimits?: ChartOptions["chartLimits"];
-    setTimeBinningInfoWhenNotProvided?: ChartOptions["setTimeBinningInfoWhenNotProvided"];
-    returnFeaturesExtent?: ChartOptions["returnFeaturesExtent"];
-    popupTemplateFieldInfosEnabled?: ChartOptions["popupTemplateFieldInfosEnabled"];
+    replaceNoValueCategoryWithZero?: boolean;
+    hideZeroCountCategories?: boolean;
+    chartLimits?: ChartElementLimit;
+    setTimeBinningInfoWhenNotProvided?: boolean;
+    returnFeaturesExtent?: boolean;
+    popupTemplateFieldInfosEnabled?: boolean;
     view?: ChartOptions["view"];
     viewExtentUpdated?: ChartOptions["viewExtentUpdated"];
-    returnSelectionOIDs?: ChartOptions["returnSelectionOIDs"];
-    runtimeDataFilters?: ChartOptions["runtimeDataFilters"];
-    ignoreViewExtent?: ChartOptions["ignoreViewExtent"];
+    returnSelectionOIDs?: boolean | undefined;
+    runtimeDataFilters?: WebChartDataFilters;
+    ignoreViewExtent?: boolean;
     errorStrings: ErrorStrings;
     selectionIDsChanged: boolean;
 }): Promise<WebChartDataItem[] | undefined>;
 
-export const dataPrivateFunctions: {
-    shouldCheckDataMinMaxForLogScaleOnXAxis: (chartConfig?: WebChart | undefined) => boolean;
-    minMaxHasZeroOrNegativeValues: (min?: number | undefined, max?: number | undefined) => boolean;
-    isChartWithZeroOrNegativeValues: (props: {
-        chartConfig: WebChart;
-        chartData: Array<WebChartDataItem> | Array<WebChartBin>;
-        axisConfigIndex: number;
-    }) => boolean;
-};
+/**
+ * Indicates whether a data array is a WebChartBin[].
+ *
+ * @param data - The data array to test
+ */
+export function isWebChartBinArray(data: WebChartBin[] | WebChartDataItem[]): data is WebChartBin[];

package/dist/utils/data/interfaces.d.ts

@@ -1,4 +1,3 @@
-import type { GaugeMinMaxFromData } from "../../chart-rendering/common/interfaces.js";
 import type { WebChartDataTypes } from "../../spec/data-source.js";
 import type { WebChartQuery } from "../../spec/web-chart.js";
 import type { DataWarningKeywords } from "../chart-config/validator/interfaces.js";
@@ -19,7 +18,6 @@ export interface DataInfo {
   count?: number;
   data?: WebChartDataTypes;
   queryConfig?: WebChartQuery;
-  gaugeMinMaxFromData?: GaugeMinMaxFromData;
 }
 
 /** @internal */
@@ -65,7 +63,10 @@ export interface DataUpdateDetails {
       valueFormatChangeRequiresNewData?: boolean;
   };
   histogram?: { dataPropsChanged?: boolean; };
-  gauge?: { valueConversionChanged?: boolean; };
+  gauge?: {
+      valueConversionChanged?: boolean;
+      minMaxFromFieldsChanged?: boolean;
+  };
   boxPlot?: { showMeanChanged?: boolean; };
   heatChart?: {
       binningChanged?: boolean;

package/dist/utils/defaults/index.d.ts

@@ -2,12 +2,11 @@ import type { WebChartStackedKinds, WebChartTypes } from "../../spec/chart-objec
 import type { Color, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol } from "../../spec/rest-js-types.js";
 import type { CategoryFormatOptions, DateTimeFormatOptions, HistogramOverlays, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebHeatChart } from "../../spec/web-chart.js";
 import type { CommonStrings } from "../localization/interfaces.js";
-import type { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from "./interfaces.js";
+import type { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, GaugeChartDefaults, QueryDefaults, TextElements } from "./interfaces.js";
 
 /** @internal */
 export const histogramBinCount: 32;
 
-/** @internal */
 export const featuresExtentField: "arcgis_charts_features_extent";
 
 /** @internal */
@@ -56,12 +55,22 @@ export const defaultHeatChartFields: {
     yField: string;
 };
 
+/** @internal */
+export const isHeatChartEmptyCell: "arcgis_charts_heat_chart_empty_cell";
+
 /** @internal */
 export const defaultHeatChartNumberOfBreaks: {
     min: number;
     max: number;
 };
 
+export const gaugeDefaults: GaugeChartDefaults;
+
+export const gaugeSpecialIds: {
+    gaugeFirstLabelId: string;
+    gaugeLastLabelId: string;
+};
+
 /**
  * default color set from Pro
  *
@@ -450,7 +459,7 @@ export function getDefaultHistogramOverlays(): Required<HistogramOverlays>;
 export function getDefaultHistogramSymbol(): ISimpleFillSymbol;
 
 /** @internal */
-export function getDefaultHistogramSeries(): Omit<Required<WebChartHistogramSeries>, "dataTooltipDateFormat" | "dataTooltipPercentFormat" | "dataTooltipValueFormat" | "query">;
+export function getDefaultHistogramSeries(): Omit<Required<WebChartHistogramSeries>, "dataTooltipDateFormat" | "dataTooltipFontSize" | "dataTooltipPercentFormat" | "dataTooltipValueFormat" | "query">;
 
 /**
  * @param commonStrings
@@ -459,14 +468,27 @@ export function getDefaultHistogramSeries(): Omit<Required<WebChartHistogramSeri
  */
 export function getDefaultHistogram(commonStrings: CommonStrings, id?: string): WebChart;
 
+/** @internal */
+export type RequiredChartElementLimit = Required<ChartElementLimit>
+  & {
+  serialChart: Required<ChartElementLimit["serialChart"]>;
+  boxPlot: Required<ChartElementLimit["boxPlot"]>;
+  heatChart: Required<ChartElementLimit["heatChart"]>;
+  pieChart: Required<ChartElementLimit["pieChart"]>;
+  scatterplot: Required<ChartElementLimit["scatterplot"]>;
+  gauge: Required<ChartElementLimit["gauge"]>;
+};
+
 /**
  * Returns a list of render limitations, mainly set for performance reasons. They can be overridden through the chart options,
  * or let as defaults.
+ * The utility type 'Required' only affects the top-level properties so we need to specify a more complex return type to make
+ * sure all the nested properties are set.
  *
- * @param customizedLimits
+ * @param customizedLimits - Customized limits to override the default ones
  * @internal
  */
-export function getChartLimits(customizedLimits?: ChartElementLimit): Required<ChartElementLimit>;
+export function getChartLimits(customizedLimits?: ChartElementLimit): RequiredChartElementLimit;
 
 /**
  * Returns a list of technical limitations, mainly to the size of large queries.
@@ -524,4 +546,7 @@ export const defaultColorForBoxPlotWithMeanLines: Color;
 export const percentageSuffix: " percentage ";
 
 /** @internal */
-export const heatChartFirstDayOfWeek: 7;
+export const heatChartFirstDayOfWeek: 7;
+
+/** @internal */
+export const defaultCornerRadius: 5;

package/dist/utils/defaults/interfaces.d.ts

@@ -7,33 +7,97 @@ export const LimitBehavior: {
 
 export type LimitBehavior = (typeof LimitBehavior)[keyof typeof LimitBehavior];
 
+export interface SerialChartLimit {
+  series?: number;
+  elements?: number;
+  categories?: number;
+}
+
 export interface ChartElementLimit {
   behaviorAfterLimit?: LimitBehavior;
+  /** @deprecated since 5.2. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxCategoryCount?: number;
+  /** @deprecated since 5.2. Use [serialChart.series](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarChartSeriesCount?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarUniqueSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarTwoSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarTwoSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarThreePlusSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxBarThreePlusSeriesCountTotal?: number;
-  maxScatterPointsBeforeAggregation?: number;
-  maxScatterPointsAfterAggregation?: number;
+  /** @deprecated since 5.2. Use [serialChart.series](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineChartSeriesCount?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineUniqueSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineTwoSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineTwoSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineThreePlusSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
   maxLineThreePlusSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Use [serialChart.series](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarChartSeriesCount?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarUniqueSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarTwoSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarTwoSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarThreePlusSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [serialChart.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) or [serialChart.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-serialChart) instead. */
+  maxRadarThreePlusSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [scatterplot.aggregationThreshold](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-scatterplot) instead. */
+  maxScatterPointsBeforeAggregation?: number;
+  /** @deprecated since 5.2. Use [scatterplot.pointsAfterAggregation](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-scatterplot) instead. */
+  maxScatterPointsAfterAggregation?: number;
+  /** @deprecated since 5.2. Use [pieChart.slices](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-pieChart) instead. */
   maxPieChartSliceCountTotal?: number;
+  /** @deprecated since 5.2. Use [gauge.features](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-gauge) instead. */
   maxGaugeByFeaturesLimit?: number;
+  /** @deprecated since 5.2. Use [boxPlot.series](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxPlotSeriesCount?: number;
+  /** @deprecated since 5.2. Use [boxPlot.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxUniqueSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Use [boxPlot.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxTwoSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [boxPlot.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) or [boxPlot.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxTwoSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [boxPlot.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxThreePlusSeriesCountTotal?: number;
+  /** @deprecated since 5.2. Won't be directly replaced. Use [boxPlot.categories](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) or [boxPlot.elements](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxThreePlusSeriesCountPerSeries?: number;
+  /** @deprecated since 5.2. Use [boxPlot.outliers](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) instead. */
   maxBoxPlotOutlierLimit?: number;
+  /** @deprecated since 5.2. Use [heatChart.cells](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-heatChart) instead. */
   maxHeatChartCellLimit?: number;
+  /**
+   * Applies to charts that can have multiple series: bar chart, line chart, combo bar-line chart and radar chart.
+   *
+   * Box plot also can have multiple series but it has its own [boxPlot](https://developers.arcgis.com/javascript/latest/references/charts-components/utils/defaults/interfaces/#ChartElementLimit-boxPlot) property.
+   *
+   * @since 5.2
+   */
+  serialChart?: SerialChartLimit;
+  /** @since 5.2 */
+  boxPlot?: SerialChartLimit & { outliers?: number; };
+  /** @since 5.2 */
+  heatChart?: { cells?: number; };
+  /** @since 5.2 */
+  scatterplot?: {
+      aggregationThreshold?: number;
+      markersAfterAggregation?: number;
+  };
+  /** @since 5.2 */
+  pieChart?: { slices?: number; };
+  /** @since 5.2 */
+  gauge?: { features?: number; };
 }
 
 export interface ChartElementTechnicalLimit {
@@ -50,7 +114,7 @@ export interface QueryDefaults {
   maxParallelRequests: number;
   maxRecords: number;
   outStatistics: Readonly<IStatisticDefinition>;
-  uniqueIdsName: number | string;
+  uniqueIds: string;
   orderByJSAPIDelimiter: string;
   heatChartLowerBoundaryAlias: string;
   heatChartUpperBoundaryAlias: string;
@@ -79,4 +143,9 @@ export const TextElements: {
 };
 
 /** @internal */
-export type TextElements = (typeof TextElements)[keyof typeof TextElements];
+export type TextElements = (typeof TextElements)[keyof typeof TextElements];
+
+export interface GaugeChartDefaults {
+  axisMinimum: number;
+  axisMaximum: number;
+}

package/dist/utils/errors/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Class that enhances the debugging and error handling process. Rather than returning a generic [JavaScript
- * error](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error), this class returns a standardized error object with several properties.
+ * error](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error), this class returns a standardized error object with several properties.
  */
 export class ArcgisChartsError<T = any> extends Error {
   /** Creates a new `ArcgisChartsError` instance. */

package/dist/utils/layer/index.d.ts

@@ -1,14 +1,14 @@
-import type Extent from "@arcgis/core/geometry/Extent.js";
 import type FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";
 import type ImageryLayer from "@arcgis/core/layers/ImageryLayer.js";
 import type ImageryTileLayer from "@arcgis/core/layers/ImageryTileLayer.js";
 import type Layer from "@arcgis/core/layers/Layer.js";
-import type WCSLayer from "@arcgis/core/layers/WCSLayer.js";
 import type CodedValueDomain from "@arcgis/core/layers/support/CodedValueDomain.js";
+import type WCSLayer from "@arcgis/core/layers/WCSLayer.js";
 import type Renderer from "@arcgis/core/renderers/Renderer.js";
 import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView.js";
 import type MapView from "@arcgis/core/views/MapView.js";
 import type SceneView from "@arcgis/core/views/SceneView.js";
+import type { ChartOptions } from "../../chart-rendering/common/interfaces.js";
 import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
 import type { IFeatureLayer, IField, IImageServiceLayer, ITiledImageServiceLayer, IWCSLayer } from "../../spec/rest-js-types.js";
 import type { WebChart, WebChartDataFilters, WebChartQuery } from "../../spec/web-chart.js";
@@ -187,6 +187,7 @@ export function getFieldCodedValueDomain(queryObject: QueryObject, field?: strin
  *
  * @param fieldValue - The field value to get the description for
  * @param domain - The domain of the field
+ * @internal
  */
 export function getFieldDescriptionFromDomain(fieldValue: number | string, domain?: CodedValueDomain): string | undefined;
 
@@ -194,6 +195,7 @@ export function getFieldDescriptionFromDomain(fieldValue: number | string, domai
  * Get the field description from the query object given a field name and a field value.
  *
  * @param props - The query object (layer or feature layer view)
+ * @internal
  */
 export function getFieldDescriptionFromQueryObject(props: {
     queryObject: QueryObjectOrRaster;
@@ -273,8 +275,9 @@ export function buildQueryConfig(props: {
     queryObject?: QueryObjectOrRaster;
     chartConfig: WebChart;
     runtimeDataFilters?: WebChartDataFilters;
+    filterByViewExtent?: boolean;
     ignoreViewExtent?: boolean;
-    viewExtent?: Extent;
+    view?: ChartOptions["view"];
 }): WebChartQuery;
 
 /**