@arcgis/charts-components 5.2.0-next.87 → 5.2.0-next.89

package/dist/interfaces.d.ts

@@ -1,4 +1,5 @@
 import type FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
 import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js";
 import type ImageryLayer from "@arcgis/core/layers/ImageryLayer.js";
 import type ImageryTileLayer from "@arcgis/core/layers/ImageryTileLayer.js";
@@ -8,12 +9,56 @@ import type { SupportedLocale } from "@arcgis/toolkit/intl";
 import type { WebChartTemporalBinningUnits } from "./spec/chart-object-literals.js";
 import type { List as List } from "@esri/calcite-components/components/calcite-list";
 
-/** Supported layer types for feature charts. */
-export type SupportedLayer = FeatureLayer | SubtypeSublayer;
+/**
+ * Supported layer types for feature charts.
+ *
+ * @deprecated since 5.2 - Use [ChartLayer](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayer) or [ChartLayerInput](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayerInput) instead.
+ */
+export type SupportedLayer = ChartLayer | SubtypeSublayer;
 
-/** Supported layer types for imagery charts. */
+/**
+ * Supported layer types for imagery charts.
+ *
+ * @deprecated since 5.2 - use [ChartLayerInput](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayerInput) instead.
+ */
 export type SupportedRasterLayer = ImageryLayer | ImageryTileLayer | WCSLayer;
 
+/** FeatureLayer-like surface used by charts & model. */
+export type ChartLayer = Layer
+  & {
+  type: Layer["type"];
+  id: FeatureLayer["id"];
+  url?: FeatureLayer["url"];
+  fields: FeatureLayer["fields"];
+  fieldsIndex: FeatureLayer["fieldsIndex"];
+  capabilities: FeatureLayer["capabilities"];
+  sourceJSON?: FeatureLayer["sourceJSON"];
+  objectIdField: FeatureLayer["objectIdField"];
+  outFields: FeatureLayer["outFields"];
+  load: Layer["load"];
+  queryFeatures: FeatureLayer["queryFeatures"];
+  queryFeatureCount: FeatureLayer["queryFeatureCount"];
+  queryObjectIds: FeatureLayer["queryObjectIds"];
+  queryAttributeBins: FeatureLayer["queryAttributeBins"];
+  createQuery: FeatureLayer["createQuery"];
+  getFieldDomain?: FeatureLayer["getFieldDomain"];
+  renderer?: FeatureLayer["renderer"];
+  layerId?: FeatureLayer["layerId"];
+  isTable?: FeatureLayer["isTable"];
+  title?: FeatureLayer["title"];
+  popupTemplate?: FeatureLayer["popupTemplate"];
+  definitionExpression?: FeatureLayer["definitionExpression"];
+  fullExtent?: FeatureLayer["fullExtent"];
+  portalItem?: FeatureLayer["portalItem"];
+  charts?: FeatureLayer["charts"];
+  dateFieldsTimeZone?: FeatureLayer["dateFieldsTimeZone"];
+  version?: FeatureLayer["version"];
+  uniqueIdFields?: FeatureLayer["uniqueIdFields"];
+};
+
+/** Layer input accepted by chart components and models. */
+export type ChartLayerInput = ChartLayer | ImageryLayer | ImageryTileLayer | SubtypeSublayer | SupportedLayer | SupportedRasterLayer | WCSLayer;
+
 export interface IntervalPopoverProps {
   size: number;
   unit: WebChartTemporalBinningUnits;

package/dist/model/interfaces/chart-interfaces.d.ts

@@ -1,4 +1,4 @@
-import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
+import type { ChartLayerInput } from "../../interfaces.js";
 import type { IFeatureLayer, IImageServiceLayer, ITiledImageServiceLayer } from "../../spec/rest-js-types.js";
 import type { WebChartBarChartSeries, WebChartHeatChartSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from "../../spec/web-chart.js";
 import type { CommonStrings } from "../../utils/localization/interfaces.js";
@@ -8,7 +8,7 @@ import type { ModelTypes } from "./common.js";
 /** Parameters for creating a chart model. */
 export type ModelParams<T extends ChartConfig> = {
   /** Layer instance associated with the chart. */
-  layer?: SupportedLayer | SupportedRasterLayer;
+  layer?: ChartLayerInput;
   /** Layer description to be used when the `layer` property is not set. */
   iLayer?: IFeatureLayer | IImageServiceLayer | ITiledImageServiceLayer;
   /** Chart config object to be edited. If not provided, a new config will be created using default values. */

package/dist/model/shared/setup-utils.d.ts

@@ -1,4 +1,4 @@
-import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
+import type { ChartLayerInput } from "../../interfaces.js";
 import type { IFeatureLayer, IImageServiceLayer, ITiledImageServiceLayer } from "../../spec/rest-js-types.js";
 import type { CommonStrings } from "../../utils/localization/interfaces.js";
 import type { ChartConfig } from "../../utils/types/index.js";
@@ -33,7 +33,7 @@ export type CreateModelProps<T extends ModelTypes> = (ILayerAndSourcelessConfig<
  * A new model of the specified type will be created using default values.
  */
 export type LayerAndType<T extends ModelTypes> = {
-  layer: SupportedLayer | SupportedRasterLayer;
+  layer: ChartLayerInput;
   chartType: T;
 };
 
@@ -53,7 +53,7 @@ export type ILayerAndType<T extends ModelTypes> = {
  * The `config` is considered "sourceless" since its `iLayer` property is not required.
  */
 export type LayerAndSourcelessConfig<T extends ModelTypes> = {
-  layer: SupportedLayer | SupportedRasterLayer;
+  layer: ChartLayerInput;
   config: ChartConfig<T>;
 };
 

package/dist/utils/chart-config/converter/index.js

@@ -2,7 +2,7 @@
 import { getElementLocale as $e } from "@arcgis/toolkit/intl/dom";
 import { cloneDeep as n, isEmpty as B } from "lodash-es";
 import { DateTime as Ye } from "luxon";
-import { q as Qe, cf as se, bt as Ke, W as ne, aN as ae, cg as Xe, bC as Je, bD as Ze, p as O, bh as Ue, ch as b, ci as te, N as et, O as tt, w as Z, cj as rt, cc as it, ck as ot, Y as st } from "../../../chunks/index.js";
+import { q as Qe, cg as se, bu as Ke, W as ne, aN as ae, ch as Xe, bD as Je, bE as Ze, p as O, bh as Ue, ci as b, cj as te, N as et, O as tt, w as Z, ck as rt, cd as it, cl as ot, Y as st } from "../../../chunks/index.js";
 import { a8 as nt, p as at, l as dt, a2 as lt, s as ct } from "../../../chunks/index3.js";
 import { i as ut } from "../../../chunks/type-guards.js";
 import { a as f, D as k, i as de } from "../../../chunks/index2.js";
@@ -441,7 +441,7 @@ function Ne(r) {
   const e = n(r);
   return e.horizontalAxisLabelsBehavior === L.NONE && (e.horizontalAxisLabelsBehavior = ie.Hide), e.verticalAxisLabelsBehavior === L.NONE && (e.verticalAxisLabelsBehavior = ie.Hide), e;
 }
-function Re(r) {
+function Ee(r) {
   const e = n(r), i = e.series[0];
   if (i && !i.temporalBinning && st(e.series[0]) && ("timeIntervalSize" in i || "timeIntervalUnits" in i || "timeAggregationType" in i || "trimIncompleteTimeInterval" in i || "nullPolicy" in i)) {
     if (i.temporalBinning = {}, i.timeIntervalSize !== void 0 && (i.temporalBinning.size = i.timeIntervalSize, delete i.timeIntervalSize), i.timeIntervalUnits) {
@@ -475,7 +475,7 @@ function Re(r) {
   }
   return e;
 }
-function Ee(r) {
+function Re(r) {
   const e = n(r);
   return e.series.forEach((i) => {
     i.query?.outStatistics?.forEach((t) => {
@@ -537,10 +537,10 @@ function N(r) {
   let e = n(r);
   return e = Ae(e), e;
 }
-function R(r) {
+function E(r) {
   return Me(r);
 }
-function E(r) {
+function R(r) {
   let e = n(r);
   return ne(e) && (e = De(e)), e;
 }
@@ -560,10 +560,10 @@ function z(r) {
   return Ne(r);
 }
 function H(r) {
-  return Re(r);
+  return Ee(r);
 }
 function $(r) {
-  return Ee(r);
+  return Re(r);
 }
 function Y(r) {
   let e = n(r);
@@ -588,7 +588,7 @@ function J(r) {
 function ze(r) {
   const { versionsToConvert: e, configToUpdate: i } = r;
   let t = n(i);
-  return e.length > 0 && t !== void 0 && (t = Ie(t), e.includes(se) || e.includes(Xe) ? (t = je(t), t = w(t), t = A(t), t = D(t), t = M(t), t = I(t), t = W(t), t = q(t), t = N(t), t = R(t), t = E(t), t = V(t), t = G(t), t = _(t), t = j(t), t = z(t), t = H(t), t = $(t), t = Y(t), t = Q(t), t = K(t), t = X(t), t = J(t)) : e.forEach((o) => {
+  return e.length > 0 && t !== void 0 && (t = Ie(t), e.includes(se) || e.includes(Xe) ? (t = je(t), t = w(t), t = A(t), t = D(t), t = M(t), t = I(t), t = W(t), t = q(t), t = N(t), t = E(t), t = R(t), t = V(t), t = G(t), t = _(t), t = j(t), t = z(t), t = H(t), t = $(t), t = Y(t), t = Q(t), t = K(t), t = X(t), t = J(t)) : e.forEach((o) => {
     if (t !== void 0)
       switch (o) {
         case "1.0.1":
@@ -616,10 +616,10 @@ function ze(r) {
           t = N(t);
           break;
         case "9.7.0":
-          t = R(t);
+          t = E(t);
           break;
         case "10.0.0":
-          t = E(t);
+          t = R(t);
           break;
         case "11.0.0":
           t = V(t);
@@ -702,8 +702,8 @@ const Mt = {
   convertWebChartLabelBehaviorNoneToHide: Ne,
   handleOrderOptionsChanges: We,
   applyDataOrderInstructionForFromFieldsCharts: qe,
-  convertTemporalBinningProps: Re,
-  convertRESTStatisticTypeToWebChartStatisticType: Ee,
+  convertTemporalBinningProps: Ee,
+  convertRESTStatisticTypeToWebChartStatisticType: Re,
   renameChartSubtitle: Ve,
   applyMandatoryConversions: he,
   convertTo1x0x1: je,
@@ -715,8 +715,8 @@ const Mt = {
   convertTo7x6x0: W,
   convertTo8x0x1: q,
   convertTo9x3x0: N,
-  convertTo10x0x0: R,
-  convertTo11x0x0: E,
+  convertTo10x0x0: E,
+  convertTo11x0x0: R,
   convertTo12x0x0: V,
   convertTo15x0x0: G,
   convertTo16x1x0: _,

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.
@@ -168,4 +168,4 @@ export function mapQuery(props: {
  * @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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/charts-components",
-  "version": "5.2.0-next.87",
+  "version": "5.2.0-next.89",
   "description": "Reusable ArcGIS charting Web Components.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,9 +29,9 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@amcharts/amcharts4": "^4.10.31",
-    "@amcharts/amcharts5": "~5.20.2",
-    "@arcgis/lumina": "5.2.0-next.87",
-    "@arcgis/toolkit": "5.2.0-next.87",
+    "@amcharts/amcharts5": "~5.20.3",
+    "@arcgis/lumina": "5.2.0-next.89",
+    "@arcgis/toolkit": "5.2.0-next.89",
     "@esri/arcgis-html-sanitizer": "~4.1.0",
     "@lit/task": "^1.0.3",
     "@zumer/snapdom": "^2.24.1",
@@ -45,7 +45,7 @@
     "tslib": "^2.8.1"
   },
   "peerDependencies": {
-    "@arcgis/core": "5.2.0-next.87",
+    "@arcgis/core": "5.2.0-next.89",
     "@esri/calcite-components": "^5.2.0-next.52"
   },
   "css.customData": [