@arcgis/charts-components 5.2.0-next.13 → 5.2.0-next.131

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/layer/index.d.ts

@@ -5,14 +5,13 @@ import type Layer from "@arcgis/core/layers/Layer.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";
-import type { QueryObject, QueryObjectOrRaster, QueryObjectProps, RendererInfo } from "./interfaces.js";
+import type { QueryObject, QueryObjectOrRaster, RendererInfo } from "./interfaces.js";
 
 /**
  * Returns the renderer type and the field and normalization field if applicable.
@@ -22,6 +21,16 @@ import type { QueryObject, QueryObjectOrRaster, QueryObjectProps, RendererInfo }
  */
 export function getRendererInfo(layerRenderer?: Renderer): RendererInfo;
 
+/**
+ * Function creating a FeatureLayer from a set of parameters.
+ * It returns the created Feature Layer.
+ * It is memoized (cached) to avoid multiple creations for a same feature layer.
+ *
+ * @param featureLayer
+ * @internal
+ */
+export function getFeatureLayerUnloaded(featureLayer: IFeatureLayer): FeatureLayer;
+
 /**
  * Function creating a FeatureLayer from a set of parameters.
  * It returns the created Feature Layer.
@@ -58,13 +67,18 @@ export function getLayer(iLayer: IFeatureLayer | IImageServiceLayer | ITiledImag
 export function getLayer(iLayer: IFeatureLayer | IImageServiceLayer | ITiledImageServiceLayer | IWCSLayer, abortSignal?: AbortSignal): Promise<FeatureLayer | ImageryLayer | ImageryTileLayer | WCSLayer>;
 
 /**
- * Returns the proper query object to use according to the situation.
- * It can return either a FeatureLayer, an ImageryLayer, an ImageryTileLayer, a WCSLayer, or a FeatureLayerView (and possibly nothing).
+ * Returns the layer object for the given layer or ILayer synchronously (without loading it).
+ * It can return either a FeatureLayer, an ImageryLayer, an ImageryTileLayer, or a WCSLayer (and possibly nothing).
  *
  * @param props
  * @internal
  */
-export function getQueryObject(props: QueryObjectProps): Promise<QueryObjectOrRaster | undefined>;
+export function getQueryObjectUnloaded(props: {
+    layerOrLayerView?: QueryObjectOrRaster;
+    iLayer?: WebChart["iLayer"];
+    view?: MapView | SceneView;
+    layerItemId?: string;
+}): QueryObjectOrRaster | undefined;
 
 /**
  * Fetches all the fields info from a layer.
@@ -187,6 +201,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 +209,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,6 +289,7 @@ export function buildQueryConfig(props: {
     queryObject?: QueryObjectOrRaster;
     chartConfig: WebChart;
     runtimeDataFilters?: WebChartDataFilters;
+    filterByViewExtent?: boolean;
     ignoreViewExtent?: boolean;
     view?: ChartOptions["view"];
 }): WebChartQuery;
@@ -324,7 +341,7 @@ export function extractFieldsFromConfigList(layer: SupportedLayer): Promise<stri
 export function findMatchingLayerFromView(props: {
     view?: MapView | SceneView;
     portalItemId: string;
-}): FeatureLayerView | SupportedLayer | undefined;
+}): SupportedLayer | undefined;
 
 /**
  * Loads the layer. Generates raster info if it's an ImageryLayer or an ImageryTileLayer.
@@ -332,4 +349,4 @@ export function findMatchingLayerFromView(props: {
  * @param layer - The layer
  * @param abortSignal - Optional abort signal to cancel the request
  */
-export function loadLayer(layer: Layer | SupportedLayer | SupportedRasterLayer, abortSignal?: AbortSignal): Promise<void>;
+export function loadLayer(layer: Layer | SupportedLayer | SupportedRasterLayer | undefined, abortSignal?: AbortSignal): Promise<void>;

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

@@ -1,18 +1,5 @@
-import type MapView from "@arcgis/core/views/MapView.js";
-import type SceneView from "@arcgis/core/views/SceneView.js";
-import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView.js";
-import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
+import type { ChartLayerView, SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
 import type { RESTRendererType } from "../../spec/rest-js-object-literals.js";
-import type { WebChart } from "../../spec/web-chart.js";
-
-/** @internal */
-export interface QueryObjectProps {
-  chartConfig?: WebChart;
-  layer?: QueryObjectOrRaster;
-  view?: MapView | SceneView;
-  filterByViewExtent?: boolean;
-  abortSignal?: AbortSignal;
-}
 
 /** @internal */
 export interface RendererInfo {
@@ -33,6 +20,6 @@ export interface ServerRestInfo {
   };
 }
 
-export type QueryObject = FeatureLayerView | SupportedLayer;
+export type QueryObject = ChartLayerView | SupportedLayer;
 
 export type QueryObjectOrRaster = QueryObject | SupportedRasterLayer;

package/dist/utils/layer/query-features/index.d.ts

@@ -1,12 +1,12 @@
 import type AttributeBinsGraphic from "@arcgis/core/AttributeBinsGraphic.js";
 import type AttributeBinsFeatureSet from "@arcgis/core/rest/support/AttributeBinsFeatureSet.js";
+import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 import type { WebChartDataItem } from "../../../spec/data-source.js";
 import type { WebChartQuery, WebChartTemporalBinning, WebHeatChart } from "../../../spec/web-chart.js";
 import type { ErrorStrings } from "../../localization/interfaces.js";
 import type { ChartSubType } from "../../misc/interfaces.js";
 import type { QueryObject } from "../interfaces.js";
 import type { AbortControllerKeyType, Features } from "./interfaces.js";
-import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 
 /**
  * Performs a query analytic.
@@ -48,7 +48,8 @@ export function queryAttributeBinsForHeatChart(props: {
     queryObject: QueryObject;
     queryConfig: WebChartQuery;
     view?: ChartOptions["view"];
-    syncViewTimeZone?: ChartOptions["syncViewTimeZone"];
+    syncViewTimeZone?: boolean;
+    returnStatisticsAggregatedIds: boolean;
     errorStrings: ErrorStrings;
     abortSignal?: AbortSignal;
 }): Promise<AttributeBinsFeatureSet | undefined>;
@@ -64,6 +65,7 @@ export function queryFeaturesForMatrixHeatChart(props: {
     queryObject: QueryObject;
     queryConfig: WebChartQuery;
     returnFeaturesExtent?: boolean;
+    returnStatisticsAggregatedIds: boolean;
     errorStrings: ErrorStrings;
     abortKey?: AbortControllerKeyType;
     abortSignal?: AbortSignal;
@@ -84,6 +86,7 @@ export function queryAttributeBinsForScatterplot(props: {
     xMax: number;
     x: string;
     y: string;
+    returnStatisticsAggregatedIds: boolean;
     errorStrings: ErrorStrings;
     abortSignal?: AbortSignal;
 }): Promise<AttributeBinsFeatureSet | undefined>;
@@ -126,6 +129,7 @@ export function queryFeatures(props: {
     queryObject: QueryObject;
     queryConfig?: WebChartQuery;
     returnUniqueIdsOnly?: boolean;
+    returnStatisticsAggregatedIds: boolean;
     errorStrings: ErrorStrings;
     abortKey?: AbortControllerKeyType;
     abortSignal?: AbortSignal;
@@ -144,6 +148,7 @@ export function queryAllFeatures(props: {
     returnUniqueIdsOnly?: boolean;
     featureCount?: number;
     noBatch?: boolean;
+    returnStatisticsAggregatedIds: boolean;
     errorStrings: ErrorStrings;
     abortKey?: AbortControllerKeyType;
     abortSignal?: AbortSignal;
@@ -199,6 +204,6 @@ export function queryAttributeBinsForTemporalData(props: {
     errorStrings: ErrorStrings;
     view?: ChartOptions["view"];
     syncViewTimeZone?: boolean;
-    abortKey?: AbortControllerKeyType;
+    returnStatisticsAggregatedIds: boolean;
     abortSignal?: AbortSignal;
 }): Promise<AttributeBinsGraphic[]>;

package/dist/utils/layer/query-parser/index.d.ts

@@ -1,5 +1,4 @@
 import type Geometry from "@arcgis/core/geometry/Geometry.js";
-import type FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";
 import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js";
 import type AttributeBinsQuery from "@arcgis/core/rest/support/AttributeBinsQuery.js";
 import type Query from "@arcgis/core/rest/support/Query.js";
@@ -9,6 +8,7 @@ import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js
 import type { RESTFieldType } from "../../../spec/rest-js-object-literals.js";
 import type { WebChartHeatChartSeries, WebChartQuery, WebChartTemporalBinning } from "../../../spec/web-chart.js";
 import type { QueryObject } from "../interfaces.js";
+import type { ChartLayer, SupportedLayer } from "../../../interfaces.js";
 
 /**
  * Indicates whether a query can be cached. It is not when:
@@ -24,7 +24,7 @@ export function isQueryCacheable(query: AttributeBinsQuery | Query | QueryProper
  * @param layer
  * @internal
  */
-export function getMaxRecords(layer?: Pick<FeatureLayer, "sourceJSON"> | SubtypeSublayer): number;
+export function getMaxRecords(layer?: Pick<ChartLayer, "sourceJSON"> | SubtypeSublayer): number;
 
 /**
  * Function building a where clause by concatenating a list of filters by using the AND operator.
@@ -33,7 +33,7 @@ export function getMaxRecords(layer?: Pick<FeatureLayer, "sourceJSON"> | Subtype
  * @param operand - The operand to use to combine the filters (OR, AND...)
  * @internal
  */
-export function combineFilters(filterList: (string | null | undefined)[], operand?: string): string;
+export function combineFilters(filterList: (number | string | null | undefined)[], operand?: string): string;
 
 /**
  * Computes the time extent to be used by the query.
@@ -87,7 +87,8 @@ export function mapAttributeBinsQueryForTemporalData(props: {
     splitByField?: string;
     axisTimeZone?: string;
     view?: ChartOptions["view"];
-    syncViewTimeZone?: ChartOptions["syncViewTimeZone"];
+    syncViewTimeZone?: boolean;
+    returnStatisticsAggregatedIds: boolean;
 }): AttributeBinsQuery;
 
 /**
@@ -128,7 +129,8 @@ export function mapAttributeBinsQueryForHeatChart(props: {
     configTimeZone?: string;
     includeLeapDay?: boolean;
     view?: ChartOptions["view"];
-    syncViewTimeZone?: ChartOptions["syncViewTimeZone"];
+    syncViewTimeZone?: boolean;
+    returnStatisticsAggregatedIds: boolean;
 }): AttributeBinsQuery;
 
 /**
@@ -146,6 +148,7 @@ export function mapAttributeBinsQueryForScatterplot(props: {
     xMax: number;
     x: string;
     y: string;
+    returnStatisticsAggregatedIds: boolean;
 }): AttributeBinsQuery;
 
 /**
@@ -158,10 +161,11 @@ export function mapQuery(props: {
     queryObject: QueryObject;
     queryConfig?: WebChartQuery;
     maxRecordCountFactor?: number;
+    returnStatisticsAggregatedIds: boolean;
 }): Query;
 
 /**
  * @param layer
  * @internal
  */
-export function getMaxRecordCountFactor(layer?: Pick<FeatureLayer, "sourceJSON"> | SubtypeSublayer): number | undefined;
+export function getMaxRecordCountFactor(layer?: Pick<ChartLayer, "sourceJSON"> | SupportedLayer): number | undefined;

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

@@ -4,8 +4,9 @@ import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js
 import type FeatureLayerView from "@arcgis/core/views/layers/FeatureLayerView.js";
 import type LayerView from "@arcgis/core/views/layers/LayerView.js";
 import type Layer from "@arcgis/core/layers/Layer.js";
+import type { SelectableLayerWithObjectIds } from "@arcgis/core/views/selection/types.js";
 import type { QueryObject, QueryObjectOrRaster } from "../interfaces.js";
-import type { SupportedLayer, SupportedRasterLayer } from "../../../interfaces.js";
+import type { ChartLayer, ChartLayerInput, ChartLayerView, SupportedLayer, SupportedRasterLayer } from "../../../interfaces.js";
 import type { WebChart } from "../../../spec/web-chart.js";
 import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 
@@ -23,7 +24,7 @@ export function isFeatureCollectionLayer(queryObject: QueryObjectOrRaster | unde
  * @param queryObject
  * @internal
  */
-export function isFeatureLayerView(queryObject: LayerView | QueryObjectOrRaster | SubtypeGroupLayer | undefined): queryObject is FeatureLayerView;
+export function isChartLayerView(queryObject: LayerView | QueryObjectOrRaster | SubtypeGroupLayer | undefined): queryObject is ChartLayerView;
 
 /**
  * Indicates whether the input object is an instance of `FeatureLayer`.
@@ -33,6 +34,22 @@ export function isFeatureLayerView(queryObject: LayerView | QueryObjectOrRaster
  */
 export function isFeatureLayer(queryObject: Layer | QueryObjectOrRaster | undefined): queryObject is FeatureLayer;
 
+/**
+ * Indicates whether an input exposes the feature-layer contract required by charts.
+ *
+ * @param queryObject
+ * @internal
+ */
+export function isFeatureLayerLike(queryObject: Layer | QueryObjectOrRaster | undefined): queryObject is ChartLayer;
+
+/**
+ * Indicates whether a chart layer exposes the object ID selection contract.
+ *
+ * @param queryObject
+ * @internal
+ */
+export function isSelectableLayerWithObjectIds(queryObject: ChartLayerInput | undefined): queryObject is ChartLayerInput & SelectableLayerWithObjectIds;
+
 /**
  * Indicates whether the input object is an instance of `SubtypeGroupLayer`.
  *
@@ -65,7 +82,7 @@ export function isSupportedLayer(queryObject: Layer | QueryObjectOrRaster | unde
  * @param layer
  * @internal
  */
-export function getMainLayer(layer: FeatureLayer | SubtypeSublayer | undefined): FeatureLayer | SubtypeGroupLayer | undefined;
+export function getMainLayer(layer: ChartLayer | SubtypeSublayer | undefined): ChartLayer | SubtypeGroupLayer | undefined;
 
 /**
  * @param layer
@@ -77,19 +94,19 @@ export function getMainLayer(layer: SupportedRasterLayer): SupportedRasterLayer;
  * @param layer
  * @internal
  */
-export function getMainLayer(layer: FeatureLayer | SubtypeSublayer | SupportedRasterLayer): FeatureLayer | SubtypeGroupLayer | SupportedRasterLayer;
+export function getMainLayer(layer: ChartLayer | SubtypeSublayer | SupportedRasterLayer): ChartLayer | SubtypeGroupLayer | SupportedRasterLayer;
 
 /**
  * @param layer
  * @internal
  */
-export function getMainLayer(layer: FeatureLayer | SubtypeSublayer | SupportedRasterLayer | undefined): FeatureLayer | SubtypeGroupLayer | SupportedRasterLayer | undefined;
+export function getMainLayer(layer: ChartLayer | SubtypeSublayer | SupportedRasterLayer | undefined): ChartLayer | SubtypeGroupLayer | SupportedRasterLayer | undefined;
 
 /**
  * @param layer
  * @internal
  */
-export function getMainLayer(layer: FeatureLayer | SubtypeSublayer | SupportedRasterLayer | undefined): FeatureLayer | SubtypeGroupLayer | SupportedRasterLayer | undefined;
+export function getMainLayer(layer: ChartLayer | SubtypeSublayer | SupportedRasterLayer | undefined): ChartLayer | SubtypeGroupLayer | SupportedRasterLayer | undefined;
 
 /**
  * Indicates whether a layer supports queries with a `distance` parameter
@@ -161,19 +178,19 @@ export function doesLayerSupportsQueryBinsForScatterplot(queryObject: QueryObjec
  * @param layerOrLayerView
  * @internal
  */
-export function getLayerFromLayerOrLayerView(layerOrLayerView: FeatureLayerView | SupportedLayer): SupportedLayer;
+export function getLayerFromLayerOrLayerView(layerOrLayerView: ChartLayerView | SupportedLayer): SupportedLayer;
 
 /**
  * @param layerOrLayerView
  * @internal
  */
-export function getLayerFromLayerOrLayerView(layerOrLayerView: FeatureLayerView | SupportedLayer | SupportedRasterLayer): SupportedLayer | SupportedRasterLayer;
+export function getLayerFromLayerOrLayerView(layerOrLayerView: ChartLayerView | SupportedLayer | SupportedRasterLayer): SupportedLayer | SupportedRasterLayer;
 
 /**
  * @param layerOrLayerView
  * @internal
  */
-export function getLayerFromLayerOrLayerView(layerOrLayerView: FeatureLayerView | SupportedLayer | SupportedRasterLayer): SupportedLayer | SupportedRasterLayer;
+export function getLayerFromLayerOrLayerView(layerOrLayerView: ChartLayerView | SupportedLayer | SupportedRasterLayer): SupportedLayer | SupportedRasterLayer;
 
 /**
  * Returns a feature layer from a QueryObject instance.

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

@@ -19,7 +19,7 @@ export interface ComponentLocaleItem<T extends LocaleItem> {
 }
 
 /** @internal */
-export const SupportedLocalesForFormats: (("id" | "ar" | "bg" | "bs" | "ca" | "cs" | "da" | "de" | "el" | "en" | "es" | "et" | "fi" | "fr" | "he" | "hr" | "hu" | "it" | "ja" | "ko" | "lt" | "lv" | "nl" | "nb" | "no" | "pl" | "pt-BR" | "pt-PT" | "ro" | "ru" | "sk" | "sl" | "sr" | "sv" | "th" | "tr" | "uk" | "vi" | "zh-CN" | "zh-HK" | "zh-TW") | string | string | string | string | string | string | string | string | string | string | string)[];
+export const SupportedLocalesForFormats: (SupportedLocale | string | string | string | string | string | string | string | string | string | string | string)[];
 
 /** @internal */
 export type SupportedLocalesForFormats = SupportedLocale | "ar-u-nu-latn" | "de-AT" | "de-CH" | "de-DE" | "en-AU" | "en-GB" | "es-ES" | "es-MX" | "fr-CA" | "it-CH" | "it-IT";
@@ -169,6 +169,10 @@ export const CommonStringsIdentity: (value: {
             twoTemporalSeriesLineCountCannotExceedLimit: string;
             threePlusTemporalSeriesLineCountCannotExceedLimit: string;
             lineSeriesCountCannotExceedLimit: string;
+            uniqueSeriesRadarCountCannotExceedLimit: string;
+            twoSeriesRadarCountCannotExceedLimit: string;
+            threePlusSeriesRadarCountCannotExceedLimit: string;
+            radarSeriesCountCannotExceedLimit: string;
             uniqueSeriesBoxCountCannotExceedLimit: string;
             twoSeriesBoxCountCannotExceedLimit: string;
             threePlusBoxLineCountCannotExceedLimit: string;
@@ -298,6 +302,13 @@ export const CommonStringsIdentity: (value: {
         "Unable to load file: %1": string;
         "Invalid date": string;
     };
+    imageryAoiToolsStrings: {
+        polyline: string;
+        circle: string;
+        rectangle: string;
+        polygon: string;
+        freehandPolygon: string;
+    };
 }) => {
     utilsStrings: {
         chartType: {
@@ -436,6 +447,10 @@ export const CommonStringsIdentity: (value: {
             twoTemporalSeriesLineCountCannotExceedLimit: string;
             threePlusTemporalSeriesLineCountCannotExceedLimit: string;
             lineSeriesCountCannotExceedLimit: string;
+            uniqueSeriesRadarCountCannotExceedLimit: string;
+            twoSeriesRadarCountCannotExceedLimit: string;
+            threePlusSeriesRadarCountCannotExceedLimit: string;
+            radarSeriesCountCannotExceedLimit: string;
             uniqueSeriesBoxCountCannotExceedLimit: string;
             twoSeriesBoxCountCannotExceedLimit: string;
             threePlusBoxLineCountCannotExceedLimit: string;
@@ -565,4 +580,11 @@ export const CommonStringsIdentity: (value: {
         "Unable to load file: %1": string;
         "Invalid date": string;
     };
+    imageryAoiToolsStrings: {
+        polyline: string;
+        circle: string;
+        rectangle: string;
+        polygon: string;
+        freehandPolygon: string;
+    };
 };

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

@@ -15,13 +15,13 @@ export const ChartSubType: {
     readonly PieNoAggregation: "pieNoAggregation";
     readonly PieFromCategory: "pieFromCategory";
     readonly PieFromFields: "pieFromFields";
-    readonly BoxPlotMonoField: "boxPlotMonoField";
-    readonly BoxPlotMultiFields: "boxPlotMultiFields";
-    readonly BoxPlotMonoFieldAndCategory: "boxPlotMonoFieldAndCategory";
-    readonly BoxPlotMultiFieldsAndCategory: "boxPlotMultiFieldsAndCategory";
-    readonly BoxPlotMonoFieldAndSplitBy: "boxPlotMonoFieldAndSplitBy";
-    readonly BoxPlotMultiFieldsAndSplitBy: "boxPlotMultiFieldsAndSplitBy";
-    readonly BoxPlotMonoFieldAndCategoryAndSplitBy: "boxPlotMonoFieldAndCategoryAndSplitBy";
+    readonly BoxPlotC1MonoField: "boxPlotC1MonoField";
+    readonly BoxPlotC2MultiFields: "boxPlotC2MultiFields";
+    readonly BoxPlotC3MonoFieldAndCategory: "boxPlotC3MonoFieldAndCategory";
+    readonly BoxPlotC4MultiFieldsAndCategory: "boxPlotC4MultiFieldsAndCategory";
+    readonly BoxPlotC5MonoFieldAndSplitBy: "boxPlotC5MonoFieldAndSplitBy";
+    readonly BoxPlotC6MultiFieldsAndSplitBy: "boxPlotC6MultiFieldsAndSplitBy";
+    readonly BoxPlotC7MonoFieldAndCategoryAndSplitBy: "boxPlotC7MonoFieldAndCategoryAndSplitBy";
 };
 
 export type ChartSubType = (typeof ChartSubType)[keyof typeof ChartSubType];
@@ -43,6 +43,7 @@ export interface SelectionData {
   selectionOIDs?: (number | string)[];
   selectionSource?: SelectionSource;
   selectionPixelTarget?: PixelHighlightTarget;
+  selectionFilters?: string[];
 }
 
 export interface SelectionThemeProperties {

package/dist/utils/type-guards/chart-types.d.ts

@@ -0,0 +1,10 @@
+import type { WebChart } from "../../spec/web-chart.js";
+
+/**
+ * Check the `subType` in the chart config to determine whether the chart is a gauge by feature.
+ * If `subType` is not defined, the chart is defaulted to be a statistic gauge.
+ *
+ * @param config - the chart config
+ * @internal
+ */
+export function isGaugeByFeature(config: WebChart): boolean;

package/dist/utils/type-guards/series-types.d.ts

@@ -1,4 +1,4 @@
-import type { WebChartCalendarDatePartsBinning, WebChartHeatChartSeries, WebChartSeries, WebChartTemporalBinning } from "../../spec/web-chart.js";
+import type { WebChartBarChartSeries, WebChartCalendarDatePartsBinning, WebChartHeatChartSeries, WebChartLineChartSeries, WebChartRadarChartSeries, WebChartSeries, WebChartTemporalBinning } from "../../spec/web-chart.js";
 import type { ChartTypes } from "../misc/index.js";
 
 /**
@@ -35,4 +35,11 @@ export function getChartOrSeriesType(chartSeries: WebChartSeries[] | undefined,
  * @returns The binning type for the specified axis
  * @internal
  */
-export function getHeatChartBinningType(chartSeries: WebChartHeatChartSeries | undefined, isXAxis?: boolean): WebChartCalendarDatePartsBinning | WebChartTemporalBinning | undefined;
+export function getHeatChartBinningType(chartSeries: WebChartHeatChartSeries | undefined, isXAxis?: boolean): WebChartCalendarDatePartsBinning | WebChartTemporalBinning | undefined;
+
+/**
+ * Type guard to know if the series type supports null category
+ *
+ * @param series - series The series to check
+ */
+export function supportsNullCategory(series: WebChartSeries): series is WebChartBarChartSeries | WebChartLineChartSeries | WebChartRadarChartSeries;

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

@@ -5,7 +5,7 @@ import type { WebBoxPlot, WebChart, WebChartBarChartSeries, WebChartBoxPlotSerie
 export interface ActionBarHideActionsProps {
   /** Determines whether to hide clear selection action or not. */
   hideClearSelection?: boolean;
-  /** Determines whether to hide filter by extent action or not. */
+  /** Determines whether to hide filter by view extent action or not. */
   hideFilterByExtent?: boolean;
   /** Determines whether to hide filter by selection action or not. */
   hideFilterBySelection?: boolean;
@@ -48,7 +48,7 @@ export const ChartComponentEvents: {
 /** @internal */
 export const DefaultChartActions: {
     readonly FilterBySelection: "filterBySelection";
-    readonly FilterByExtent: "filterByExtent";
+    readonly FilterByViewExtent: "filterByViewExtent";
     readonly Legend: "legend";
     readonly RotateChart: "rotateChart";
     readonly Selection: "selection";