@arcgis/charts-components 5.2.0-next.10 → 5.2.0-next.101

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";
@@ -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, 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.10",
+  "version": "5.2.0-next.101",
   "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.4",
+    "@arcgis/lumina": "5.2.0-next.101",
+    "@arcgis/toolkit": "5.2.0-next.101",
     "@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/lumina": "5.2.0-next.10",
-    "@arcgis/toolkit": "5.2.0-next.10"
+    "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.101",
+    "@esri/calcite-components": "^5.2.0-next.65"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"