@arcgis/charts-components 5.2.0-next.9 → 5.2.0-next.91

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

@@ -1,18 +1,18 @@
-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";
-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 +22,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 +68,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 +202,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 +210,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 +290,9 @@ export function buildQueryConfig(props: {
     queryObject?: QueryObjectOrRaster;
     chartConfig: WebChart;
     runtimeDataFilters?: WebChartDataFilters;
+    filterByViewExtent?: boolean;
     ignoreViewExtent?: boolean;
-    viewExtent?: Extent;
+    view?: ChartOptions["view"];
 }): WebChartQuery;
 
 /**
@@ -332,4 +350,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/inline-conversion/index.d.ts

@@ -8,7 +8,6 @@ import type { WebChart } from "../../../spec/web-chart.js";
  * Creates a chart renderer based on the provided config fields and inline data.
  *
  * @param props - The category field, the numeric fields, the config fields and the data to convert.
- * @internal
  */
 export function convertConfigFieldsToChartRenderer(props: {
     categoryField: string;
@@ -21,7 +20,6 @@ export function convertConfigFieldsToChartRenderer(props: {
  * Converts an array of inline data to a feature set and returns an `IFeatureLayer`.
  *
  * @param props - The category field, the category type, the numeric fields and the inline data to convert.
- * @internal
  */
 export function convertInlineDataToLayerDefinition(props: {
     categoryField: string;
@@ -34,7 +32,6 @@ export function convertInlineDataToLayerDefinition(props: {
  * Converts an array of inline data into a feature collection. Also returns a `chartRenderer` if the `configFields` are provided.
  *
  * @param props - The category field, the category type, the numeric fields, the config fields and the inline data to convert.
- * @internal
  */
 export function convertInlineConfigToLayerConfig(props: {
     categoryField: string;

package/dist/utils/layer/inline-conversion/interfaces.d.ts

@@ -1,8 +1,6 @@
 /**
  * Former interface describing the property `configFields` from an inline data source.
  * Is an object which dictate which data-item field should be used for defining a property of the rendered element (line, point, bars, etc). Used in inline data source mode only.
- *
- * @internal
  */
 export interface WebChartConfigFields {
   fillColor?: string;

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

@@ -1,18 +1,6 @@
-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 { 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 {

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";
@@ -8,7 +7,8 @@ import type { QueryProperties } from "@arcgis/core/rest/support/Query.js";
 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, QueryObjectOrRaster } from "../interfaces.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,16 +33,16 @@ 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.
  *
- * @param queryObject - The layer or feature layer view
+ * @param viewTimeExtent - The layer or feature layer view
  * @param defaultTimeExtent - The time extent defined at the series config level or provided at runtime
  * @internal
  */
-export function getQueryTimeExtent(queryObject?: QueryObjectOrRaster, defaultTimeExtent?: WebChartQuery["timeExtent"]): WebChartQuery["timeExtent"] | undefined;
+export function getQueryTimeExtent(viewTimeExtent?: TimeExtent | null, defaultTimeExtent?: WebChartQuery["timeExtent"]): WebChartQuery["timeExtent"] | undefined;
 
 /**
  * Computes the extent to be used by the query. We prioritize the feature layer view extent
@@ -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, SupportedLayer, SupportedRasterLayer } from "../../../interfaces.js";
 import type { WebChart } from "../../../spec/web-chart.js";
 import type { ChartOptions } from "../../../chart-rendering/common/interfaces.js";
 
@@ -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

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;
@@ -436,6 +440,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;

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

@@ -15,7 +15,6 @@ export type SerialChartType = typeof WebChartTypes.BarSeries | typeof WebChartTy
 /** @internal */
 export type SupportedChartType = typeof WebChartTypes.BarSeries | typeof WebChartTypes.BoxPlotSeries | typeof WebChartTypes.HeatSeries | typeof WebChartTypes.HistogramSeries | typeof WebChartTypes.LineSeries | typeof WebChartTypes.PieSeries | typeof WebChartTypes.RadarSeries | typeof WebChartTypes.ScatterSeries;
 
-/** @internal */
 export type ChartTypes = Extract<WebChartTypes, WebChartType>;
 
 /** @internal */
@@ -251,8 +250,8 @@ export function sanitizeHTMLOutput(inputToSanitize: string): string;
  * Indicates if a provided number value is valid.
  * An invalid value is: undefined | NaN | Infinite | -Infinite | null
  * See for more details:
- *   - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isFinite
- *   - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isNaN
+ *   - https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isFinite
+ *   - https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number/isNaN
  *
  * @param value
  * @internal

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

@@ -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

@@ -104,11 +104,7 @@ export type BoxPlotConfig = WebBoxPlot;
  */
 export type HeatChartConfig = WebHeatChart;
 
-/**
- * Type alias for the supported chart series types.
- *
- * @internal
- */
+/** Type alias for the supported chart series types. */
 export type SupportedChartSeries = WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartGaugeSeries | WebChartHistogramSeries | WebChartLineChartSeries | WebChartPieChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries;
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/charts-components",
-  "version": "5.2.0-next.9",
+  "version": "5.2.0-next.91",
   "description": "Reusable ArcGIS charting Web Components.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,25 +29,24 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@amcharts/amcharts4": "^4.10.31",
-    "@amcharts/amcharts5": "~5.18.0",
+    "@amcharts/amcharts5": "~5.20.3",
+    "@arcgis/lumina": "5.2.0-next.91",
+    "@arcgis/toolkit": "5.2.0-next.91",
     "@esri/arcgis-html-sanitizer": "~4.1.0",
     "@lit/task": "^1.0.3",
+    "@zumer/snapdom": "^2.24.1",
     "ajv": "6.12.6",
     "d3-shape": "^3.2.0",
-    "fastq": "~1.13.0",
-    "html2canvas": "^1.4.1",
     "jszip": "^3.10.1",
     "lit": "^3.3.0",
     "lodash-es": "^4.18.1",
     "luxon": "~3.7.2",
     "simple-statistics": "^7.8.8",
-    "tslib": "^2.8.1",
-    "@arcgis/toolkit": "5.2.0-next.9",
-    "@arcgis/lumina": "5.2.0-next.9"
+    "tslib": "^2.8.1"
   },
   "peerDependencies": {
-    "@arcgis/core": "^5.2.0-next",
-    "@esri/calcite-components": "^5.1.1-next.3"
+    "@arcgis/core": "5.2.0-next.91",
+    "@esri/calcite-components": "^5.2.0-next.52"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"

package/dist/cdn/2B4S6PH2.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{a as y}from"./VOTZAPI3.js";import{a as $}from"./JNNB2DIA.js";import{b as _,c as B}from"./IHO3OLL3.js";import g from"./ZAHVBXAQ.js";import{a as f}from"./MRTKZZTF.js";import{f as s}from"./AK7X7SGI.js";import e from"./STM26XZG.js";import"./WNKDEOFZ.js";import d from"./3X5JIVJJ.js";import"./EZV7JSQJ.js";import{n as E,u as S}from"./ADGMA3ST.js";import{wa as x,xa as A}from"./PAIRUVLU.js";import{a as P}from"./KX7KGXKQ.js";import{l as b}from"./SP2IPHWF.js";import"./NZR4L5AA.js";import{A as I,B as c,G as F,g as L,i as a,n as u,y as h,z as m}from"./CHQDKVVQ.js";import"./QP5UAIC6.js";import"./XJFVSX2E.js";import{k as r,o as p}from"./547RDEMV.js";import"./U67P6YAZ.js";export default $arcgis.t(([{pb:v,qb:D,sb:T,tb:z},,{a:w,c:C,g:K,k:d,o:N}])=>{var j=L`.hide{visibility:hidden}.am5-html-container{z-index:101!important}.am5-layer-1000{z-index:1000!important}.am5-layer-30{z-index:100!important}.show{display:block}.notifyPanel{flex:0 1 auto}.disable-interactions{pointer-events:none}.dim-text{color:var(--arcgis-charts-dim-text)}.name{display:flex;flex-direction:column;margin:.5rem;padding:.5rem;background:#fff;min-width:250px}.header{margin:0;font-weight:bolder}.fab{display:flex;justify-content:stretch}.pick-list-item-label{font-size:small}.sort-icon-color{color:#000}.sort-y-axis{transform:rotate(90deg)}calcite-panel{max-height:60vh}calcite-panel .size-section{width:19rem;margin:1rem 0;display:flex;flex-wrap:wrap;justify-content:space-evenly}calcite-panel .size-section calcite-label{width:8rem;margin-bottom:.25rem}calcite-panel .apply-button{width:17rem}`,o={jsAppFlyout:"js-app-flyout",name:"line-chart-data-popover",numericFieldPickList:"line-chart-data-numeric-fields-pick-list",header:"header",fab:"fab",pickListItemLabel:"pick-list-item-label",sizeSection:"size-section",applyButton:"apply-button"},k=class extends I{constructor(){super(...arguments),this._messages=f(),this.commonStrings=f({name:"common",blocking:!0}),this.picklist=h(),this.intervalSizeElement=h(),this.intervalTypeElement=h(),this.popoverElement=h(),this.placement="leading",this.offsetDistance=-200,this.pickListHasChanged=!1,this.open=!1,this.layerFieldsInfo=[],this.arcgisChartsConfigLineChartDataPopoverChange=u(),this.arcgisChartsConfigLineChartPopoverClose=u()}static{this.properties={aggregationLabels:16,timeAggregationLabels:16,messageOverrides:0,headingTitle:1,referenceElement:0,open:5,contentKind:1,layerFieldsInfo:0,selectedContent:1}}static{this.styles=j}async reposition(){await this.popoverElement.value?.reposition()}willUpdate(e){e.has("selectedContent")&&this.selectedContentChange(this.selectedContent,e.get("selectedContent"));let t=C.map(l=>x(l,this.commonStrings));b(this.aggregationLabels,t)||(this.aggregationLabels=t);let i=[p.Start,p.End].map(l=>A(l,this.commonStrings));b(this.timeAggregationLabels,i)||(this.timeAggregationLabels=i)}updated(){setTimeout(()=>{typeof this.picklist.value?.setFocus=="function"&&this.picklist.value?.setFocus()},w.PopoverTimer),_(this.popoverElement.value,this.open)}selectedContentChange(e,t){this.pickListHasChanged=B(e,t)}buildAggregationPickListItems(){return y(C,e=>e,(e,t)=>a`<calcite-list-item .label=${this.aggregationLabels?.[t]} .value=${e} .selected=${d(e,this.selectedContent)}></calcite-list-item>`)}buildIntervalAlignmentPickListItems(){let e=[p.Start,p.End];return y(e,t=>t,(t,i)=>a`<calcite-list-item .label=${this.timeAggregationLabels?.[i]} .value=${t} .selected=${d(t,this.selectedContent)}></calcite-list-item>`)}buildPickListItem(e){return $(e.name,a`<calcite-list-item .label=${E(this.layerFieldsInfo,e.name)} .value=${e.name} .selected=${d(e.name,this.selectedContent)}></calcite-list-item>`)}buildPickListItems(e){let t=this.layerFieldsInfo?.length??0,i=[];switch(e){case s.numericFields:{for(let l=0;l<t;l+=1){let n=this.layerFieldsInfo?.[l];n&&v(n)&&i.push(this.buildPickListItem(n))}break}case s.xAxisField:{for(let l=0;l<t;l+=1){let n=this.layerFieldsInfo?.[l];n&&(v(n)||D(n)||T(n))&&i.push(this.buildPickListItem(n))}break}case s.splitByField:{let l=$(" ",a`<calcite-list-item label=" " value=" " .selected=${d("",this.selectedContent)}></calcite-list-item>`);i.push(l);for(let n=0;n<t;n+=1){let g=this.layerFieldsInfo?.[n];g&&(z(g)||g.type===P.String)&&i.push(this.buildPickListItem(g))}break}}return i}closePopover(){if(this.contentKind===s.numericFields&&this.pickListHasChanged){let e={pickListElement:this.picklist.value,eventEmitter:this.arcgisChartsConfigLineChartDataPopoverChange,contentKind:this.contentKind};N(e)}this.open=!1,this.arcgisChartsConfigLineChartPopoverClose.emit()}onDataContentTypeChange(e){this.pickListHasChanged=!0;let t=e.target.selectedItems;this.arcgisChartsConfigLineChartDataPopoverChange.emit({contentKind:this.contentKind,value:t.map(i=>i.value)}),this.open=!1}intervalChange(){let e=Number.parseInt(this.intervalSizeElement.value?.value??""),t=this.intervalTypeElement.value?.selectedOption?.value;!Number.isNaN(e)&&e>0&&this.arcgisChartsConfigLineChartDataPopoverChange.emit({contentKind:this.contentKind,value:[{intervalSize:e,intervalUnits:t}]}),this.open=!1}onNumericFieldsChange(e){e.target!==null&&(this.selectedContent=e.target.selectedItems.map(t=>t.value))}onNumericFieldSelectionDone(){this.closePopover()}renderAggregationType(){let e=this.buildAggregationPickListItems();return a`<calcite-list label class=${c(o.pickListItemLabel)} selection-mode=single selection-appearance=border @calciteListChange=${this.onDataContentTypeChange}>${e}</calcite-list>`}renderXAxisField(){let e=this.buildPickListItems(s.xAxisField);return a`<calcite-list label class=${c(o.pickListItemLabel)} selection-mode=single selection-appearance=border filter-enabled @calciteListChange=${this.onDataContentTypeChange} ${m(this.picklist)}>${e}</calcite-list>`}renderNumericFields(){let e=this.buildPickListItems(s.numericFields);return a`<calcite-list label class=${c(o.numericFieldPickList)} selection-mode=multiple filter-enabled @calciteListChange=${this.onNumericFieldsChange} ${m(this.picklist)}>${e}</calcite-list>`}renderSplitByField(){let e=this.buildPickListItems(s.splitByField);return a`<calcite-list label class=${c(o.pickListItemLabel)} selection-mode=single selection-appearance=border filter-enabled @calciteListChange=${this.onDataContentTypeChange} ${m(this.picklist)}>${e}</calcite-list>`}renderIntervalAlignment(){let e=this.buildIntervalAlignmentPickListItems();return a`<calcite-list label class=${c(o.pickListItemLabel)} selection-mode=single selection-appearance=border @calciteListChange=${this.onDataContentTypeChange}>${e}</calcite-list>`}renderInterval(){let e=this.selectedContent,t=[r.Second,r.Minute,r.Hour,r.Day,r.Week,r.Month,r.Year];return a`<div><div class=${c(o.sizeSection)}><calcite-label scale=m>${this._messages.intervalSize}<calcite-input type=number scale=m min=1 step=any .value=${K(e?.size,1)} ${m(this.intervalSizeElement)}></calcite-input></calcite-label><calcite-label scale=m>${this._messages.intervalType}<calcite-select .label=${this._messages.intervalType??""} ${m(this.intervalTypeElement)}>${t.map(i=>a`<calcite-option .value=${i} .label=${S(i,this._messages)} .selected=${e?.unit===i}></calcite-option>`)}</calcite-select></calcite-label><calcite-button class=${c(o.applyButton)} appearance=outline @click=${this.intervalChange}>${this._messages.apply}</calcite-button></div></div>`}renderPopoverInfo(){let e;switch(this.contentKind){case s.aggregation:e=this.renderAggregationType();break;case s.xAxisField:e=this.renderXAxisField();break;case s.numericFields:e=this.renderNumericFields();break;case s.splitByField:e=this.renderSplitByField();break;case s.intervalAlignment:e=this.renderIntervalAlignment();break;case s.interval:e=this.renderInterval();break}return e}render(){let e;return this.contentKind===s.numericFields&&(e=a`<div slot=footer><calcite-fab class=${c(o.fab)} appearance=outline-fill kind=neutral .icon=${void 0} .label=${this._messages.selectionDone} scale=s text-enabled .text=${this._messages.selectionDone} @click=${this.onNumericFieldSelectionDone}></calcite-fab></div>`),a`<div class=${c(o.jsAppFlyout)}><calcite-popover class=${c(o.name)} .referenceElement=${this.referenceElement??document.body} .placement=${this.placement} .offsetDistance=${this.offsetDistance} @calcitePopoverClose=${this.closePopover} .open=${this.open} label auto-close ${m(this.popoverElement)}><calcite-panel closable .closed=${!this.open} @calcitePanelClose=${this.closePopover}><div slot=header-content class=${c(o.header)}>${this.headingTitle??""}</div>${this.renderPopoverInfo()}${e}</calcite-panel></calcite-popover></div>`}};F("arcgis-charts-config-line-chart-popover",k);return k},d,e,g)

package/dist/cdn/3EIVHDDK.js

@@ -1,2 +0,0 @@
-/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{a as i}from"./P4HSSZRL.js";import{b as m}from"./IHO3OLL3.js";import{a as g}from"./MRTKZZTF.js";import{f as h}from"./KX7KGXKQ.js";import"./SP2IPHWF.js";import"./NZR4L5AA.js";import{A as n,B as p,G as c,i as o,n as t,y as a,z as l}from"./CHQDKVVQ.js";import"./547RDEMV.js";import"./U67P6YAZ.js";var C={jsAppFlyout:"js-app-flyout"},r=class extends n{constructor(){super(...arguments),this._messages=g(),this.popoverElement=a(),this.placement="leading",this.open=!1,this.arcgisChartsConfigGuidePopoverColorChange=t(),this.arcgisChartsConfigGuidePopoverSymbolChange=t(),this.arcgisChartsConfigPopoverClose=t()}static{this.properties={messageOverrides:0,selectedElement:0,referenceElement:0,placement:1,open:5}}async reposition(){await this.popoverElement.value?.reposition()}updated(){m(this.popoverElement.value,this.open)}guidePopoverClose(){this.open=!1,this.arcgisChartsConfigPopoverClose.emit()}updateColorProperties(s){let e=s.detail;e!==void 0&&(e[3]=i),this.selectedElement=e,this.arcgisChartsConfigGuidePopoverColorChange.emit(this.selectedElement)}updateSymbolProperties(s){let{lineStyle:e}=s.target;e?.color!==void 0&&(e.color[3]=i),this.selectedElement=e,this.arcgisChartsConfigGuidePopoverSymbolChange.emit(s.detail)}render(){let s=this.selectedElement,e=this.selectedElement;return o`<div class=${p(C.jsAppFlyout)}><calcite-popover .referenceElement=${this.referenceElement??document.body} .placement=${this.placement} .open=${this.open} offset-distance=20 offset-skidding=60 label pointer-disabled @calcitePopoverClose=${this.guidePopoverClose} auto-close ${l(this.popoverElement)}>${Array.isArray(s)&&o`<arcgis-charts-config-color-style .header=${this._messages.fillStyle} enable-close .open=${this.open} .selectedColor=${s} @arcgisChartsConfigColorStyleClose=${this.guidePopoverClose} @arcgisChartsConfigColorStyleChange=${this.updateColorProperties}></arcgis-charts-config-color-style>`||""}${e?.type===h.SLS&&o`<arcgis-charts-config-line-style .header=${this._messages.lineStyle} .open=${this.open} enable-close .lineStyle=${e} @arcgisChartsConfigLineStyleClose=${this.guidePopoverClose} @arcgisChartsConfigLineStyleChange=${this.updateSymbolProperties}></arcgis-charts-config-line-style>`||""}</calcite-popover></div>`}};c("arcgis-charts-config-guide-popover",r);export{r as ArcgisChartsConfigGuidePopover};