@arcgis/charts-components 5.0.0-next.6 → 5.0.0-next.60

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

@@ -1,7 +1,9 @@
-import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
+/// <reference types="@arcgis/core/interfaces.d.ts" />
 import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer.js';
-import { default as SubtypeGroupLayer } from '@arcgis/core/layers/SubtypeGroupLayer';
+import { default as SubtypeGroupLayer } from '@arcgis/core/layers/SubtypeGroupLayer.js';
 import { default as Renderer } from '@arcgis/core/renderers/Renderer';
+import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
 import { IFeatureType, QueryObject, QueryObjectProps, RendererInfo, SubtypeInfo } from './interfaces';
 /**
  * Returns the renderer type and the field and normalization field if applicable.
@@ -38,7 +40,7 @@ export declare function getFieldFromName(fieldName: string, fields?: IField[]):
  * the field ID (every feature layer has one).
  * As a consequence the backup value returned if `oidField.name` is `undefined` doesn't matter because it will not happen.
  */
-export declare function getObjectIdField(layerFieldsInfo: IField[]): string;
+export declare function getObjectIdField(layerFieldsInfo?: IField[]): string;
 /**
  * Checks whether the given field has a valid numeric type.
  * Fields descriptions are [here](http://resources.esri.com/help/9.3/ArcGISEngine/ArcObjects/esriGeoDatabase/esriFieldType.htm).
@@ -145,6 +147,21 @@ export declare function findMatchingLayerFieldName(props: {
     fieldToMatch: string;
     returnUndefinedIfNotFound?: boolean;
 }): Promise<string>;
+/**
+ * Find the matching field in a list of fields based on the fieldToMatch parameter.
+ * It first looks for a perfect match (case-sensitive), then for an approximate match (case-insensitive).
+ * @param {IField[]} layerFieldList - The list of fields to search in.
+ * @param {string} fieldToMatch - The field name to match.
+ * @returns {IField | undefined} - The matching field if found, otherwise undefined.
+ *
+ * We look for a match in 2 steps:
+ *
+ * 1. Perfect match: the case of the fields is exactly the same. This helps when the layer has fields with the same name but with a
+ * different case (e.g. "field" and "FiElD"). Refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/8305
+ *
+ * 2: Approximate match: we upper-case the fields to compare them
+ */
+export declare function findMatchingField(layerFieldList: IField[], fieldToMatch: string): IField | undefined;
 /**
  * Finds the matching layer fields for a list of fields.
  *
@@ -200,6 +217,32 @@ export declare function extractFieldsUsedInConfig(config: WebChart, layer: Suppo
  * @returns {string[]} The list of layer fields
  */
 export declare function extractFieldsFromConfigList(layer: SupportedLayer): Promise<string[]>;
+/**
+ * Finds the matching layer in the view based on the provided layer's portal item id.
+ * The matching is done based on the portalItem id.
+ * If no matching layer is found, returns `undefined`.
+ * @param {__esri.MapView | __esri.SceneView | undefined} props.view The map or scene view
+ * @param {string} props.portalItemId The portal item id of the layer
+ *
+ * @returns {FeatureLayerView | SupportedLayer | undefined} The matching layer in the view or undefined if not found
+ *
+ * @requires
+ * - view
+ * - portalItemId
+ *
+ * ```
+ *
+ * @example
+ * ```ts
+ * const matchingLayer = findMatchingLayerFromView({ view, portalItemId: 'abc123' });
+ * ```
+ *
+ * @category Public
+ */
+export declare function findMatchingLayerFromView(props: {
+    view?: __esri.MapView | __esri.SceneView;
+    portalItemId: string;
+}): FeatureLayerView | SupportedLayer | undefined;
 export declare const layerPrivateFunctions: {
     getServerRestInfo: typeof getServerRestInfo;
     getSubtypeName: typeof getSubtypeName;

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

@@ -6,6 +6,7 @@ export interface QueryObjectProps {
     chartConfig: WebChart;
     layer?: FeatureLayerView | SupportedLayer;
     view?: MapView | SceneView;
+    filterByExtent?: boolean;
 }
 export interface RendererInfo {
     rendererType?: RESTRendererType;

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

@@ -1,4 +1,4 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
+import { default as AttributeBinsGraphic } from '@arcgis/core/AttributeBinsGraphic.js';
 import { default as AttributeBinsFeatureSet } from '@arcgis/core/rest/support/AttributeBinsFeatureSet.js';
 import { WebBoxPlot, WebChart, WebChartDataItem, WebChartQuery, WebChartTemporalBinning, WebHeatChart } from '../../../spec';
 import { ErrorStrings } from '../../localization/interfaces';
@@ -140,7 +140,7 @@ export declare function queryUniqueIDs(props: {
     queryConfig: WebChartQuery;
     uniqueFeature?: boolean;
     abortKey?: AbortControllerKeyType;
-}): Promise<number[]>;
+}): Promise<(number | string)[]>;
 /**
  * Aborts all existing queries and initializes a controller for new ones. The queries are associated
  * to a unique key to avoid cancelling queries for other charts.
@@ -169,4 +169,4 @@ export declare function queryAttributeBinsForTemporalData(props: {
     dateField: string;
     splitByField?: string;
     abortKey?: AbortControllerKeyType;
-}): Promise<__esri.AttributeBinsGraphic[]>;
+}): Promise<AttributeBinsGraphic[]>;

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

@@ -74,11 +74,19 @@ export declare function mapAttributeBinsQueryForTemporalData(props: {
  * @param props.field The field used by the heat chart
  * @param props.fieldType The field type
  * @param props.unit The unit of the temporal binning
+ * @param props.addIntervalStatement Whether to add the interval statement to shift the date from the data time zone to the output time zone
+ * @param props.outTimeZone The output time zone
+ * @param props.dataTimeZone The data time zone
+ * @param props.runsOnClientQueryEngine Whether the query will be executed on the client query engine (FeatureLayerView) or on the server
  */
 export declare function getCalendarDatePartsParameters(props: {
     field: string;
     fieldType?: RESTFieldType;
     unit?: string;
+    addIntervalStatement: boolean;
+    outTimeZone?: string;
+    dataTimeZone?: string | null;
+    runsOnClientQueryEngine?: boolean;
 }): {
     expression?: string;
     start?: number;

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

@@ -1,8 +1,8 @@
-import { SupportedLayer, WebChart } from '../../../spec';
 import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer';
 import { default as SubtypeGroupLayer } from '@arcgis/core/layers/SubtypeGroupLayer';
 import { default as SubtypeSublayer } from '@arcgis/core/layers/support/SubtypeSublayer';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { SupportedLayer, WebChart } from '../../../spec';
 import { QueryObject } from '../interfaces';
 /**
  * Indicates whether the input object is a feature collection.
@@ -13,7 +13,7 @@ export declare function isFeatureCollectionLayer(queryObject: QueryObject): quer
  * Indicates whether the input object is an instance of `FeatureLayerView`.
  * @param queryObject
  */
-export declare function isFeatureLayerView(queryObject: QueryObject): queryObject is FeatureLayerView;
+export declare function isFeatureLayerView(queryObject: QueryObject | SubtypeGroupLayer): queryObject is FeatureLayerView;
 /**
  * Indicates whether the input object is an instance of `FeatureLayer`.
  * @param queryObject

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

@@ -170,7 +170,7 @@ export declare function getOverlayColorIndex(overlayType: OverlayTerms | undefin
  * @param props.config The config that gets updated for each series visibility
  * @param props.event The event that is currently being called
  */
-export declare function updateSeriesVisibility(event: CustomEvent<LegendItemVisibility>, config?: WebBoxPlot | WebChart): void;
+export declare function updateSeriesVisibility(event: Pick<CustomEvent<LegendItemVisibility>, "detail">, config?: WebBoxPlot | WebChart): void;
 /**
  * Sanitize an HTML string to prevent XSS attacks (https://owasp.org/www-community/attacks/xss/)
  * @param inputToSanitize The HTML string to sanitize
@@ -184,13 +184,6 @@ export declare function sanitizeHTMLOutput(inputToSanitize: string): string;
  *   - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number/isNaN
  */
 export declare function isValidNumber(value: WebChartDataItemValue): boolean;
-/**
- * Updates the chart rotation for a given WebChart config.
- * Returns the updated config.
- * @param newRotation new rotation
- * @param config the chart config
- */
-export declare function updateRotation<T extends WebBoxPlot | WebChart>(newRotation: boolean, config?: T): T | undefined;
 /**
  * Gets the sorting field or (sorting type for box-plot) and orderBy from an input string.
  * @param stringToParse The input string to parse, like `orderByField` of a query clause or `orderDataBy` property of a chart config.

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

@@ -32,7 +32,7 @@ export type SelectionIndexes = Map<number, {
 export interface SelectionData {
     selectionItems?: WebChartDataItem[];
     selectionIndexes?: SelectionIndexes;
-    selectionOIDs?: number[];
+    selectionOIDs?: (number | string)[];
     selectionSource?: SelectionSource;
 }
 export interface SelectionThemeProperties {

package/dist/utils/ui/chart-ui-utils.d.ts

@@ -1,8 +1,9 @@
 import { WebChart, WebChartTypes } from '../../spec';
+import { CommonStrings } from '../localization/interfaces';
 export declare function getChartIcon(chart: WebChart): string;
 /**
  * Gets the chart type text based on the provided chart type.
  * @param chartType
  * @category Private
  */
-export declare function getChartText(chartType: WebChartTypes): Promise<string>;
+export declare function getChartText(chartType: WebChartTypes, commonStrings: CommonStrings): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/charts-components",
-  "version": "5.0.0-next.6",
+  "version": "5.0.0-next.60",
   "description": "Reusable ArcGIS charting Web Components.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,9 +27,9 @@
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
     "@amcharts/amcharts4": "^4.10.31",
-    "@amcharts/amcharts5": "~5.13.6",
-    "@arcgis/lumina": "5.0.0-next.6",
-    "@arcgis/toolkit": "5.0.0-next.6",
+    "@amcharts/amcharts5": "~5.14.4",
+    "@arcgis/lumina": "5.0.0-next.60",
+    "@arcgis/toolkit": "5.0.0-next.60",
     "ajv": "6.12.6",
     "d3-array": "^3.2.1",
     "d3-shape": "^3.2.0",
@@ -44,7 +44,7 @@
   },
   "peerDependencies": {
     "@arcgis/core": ">=5.0.0-next.1 <5.1",
-    "@esri/calcite-components": "^3.3.0"
+    "@esri/calcite-components": "^3.3.2"
   },
   "css.customData": [
     "dist/docs/vscode.css-custom-data.json"