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

package/dist/utils/components/watch-handlers.d.ts

@@ -1,37 +1,37 @@
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 /**
- * Adds a listener on the feature layer, so every time the definition expression (filter) is modified we update
+ * Adds a watch handler on the feature layer, so every time the definition expression (filter) is modified we update
  * the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFilterListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFilter(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the renderer is modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the renderer is modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerRendererListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerRenderer(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer view, so every time the view's extent is modified we update
+ * Adds a watch handler on the feature layer view, so every time the view's extent is modified we update
  * the chart.
  *
  * @param props.component The chart component
  */
-export declare function addExtentChangeListener(component: ArcgisChart): Promise<IHandle[] | undefined>;
+export declare function watchExtentChange(component: ArcgisChart): Promise<IHandle[] | undefined>;
 /**
- * Adds a listener on the view's time extent, so every time extent is modified we update the chart.
+ * Adds a watch handler on the view's time extent, so every time extent is modified we update the chart.
  * @param component The chart component
  */
-export declare function addViewTimeExtentListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchViewTimeExtent(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the fields are modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the fields are modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFieldsListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFields(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the layer's view; so every time the selection data is modified, we update the chart.
+ * Adds a watch handler on the layer's view; so every time the selection data is modified, we update the chart.
  * @param component The chart component
  */
-export declare function addSelectionsChangeInViewListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchSelectionsChangeInView(component: ArcgisChart): IHandle | undefined;

package/dist/utils/components/web-component-utils.d.ts

@@ -1,28 +1,23 @@
-import { CSVOptions } from '../../interfaces';
-import { ModelTypes } from '../../model';
-import { IField, SupportedLayer } from '../../spec';
-import { ChartConfig } from '../types';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { SupportedLayer, CSVOptions } from '../../interfaces';
+import { ModelTypes } from '../../model';
+import { IField } from '../../spec';
 import { SupportedLocalesForFormats } from '../localization/interfaces';
+import { ChartConfig } from '../types';
 /**
  * A utility function to compare if a value has changed deeply.
- * @param value
- * @param oldValue
  */
 export declare function hasChangedDeep<T>(value: T, oldValue?: T): boolean;
 /**
  * A utility function to compare if a value has changed deeply or shallowly.
- * @param value
- * @param oldValue
  */
 export declare function hasChangedDeepOrShallow<T>(value: T, oldValue?: T): boolean;
 /**
  * Formats a cell value for CSV output.
  * This function handles quoting and escaping of special characters.
- * @param {unknown} value - The value to format.
- * @param {boolean} [quoteAll] - Whether to quote all values.
- *                               If `true`, all values will be quoted.
- *                               If `false` or `undefined`, only values that contain special characters will be quoted.
+ *
+ * @param value - The value to format.
+ * @param quoteAll - Whether to quote all values. If `true`, all values will be quoted. If `false` or `undefined`, only values that contain special characters will be quoted.
  */
 export declare const formatCell: (props: {
     value: unknown;
@@ -31,6 +26,7 @@ export declare const formatCell: (props: {
 }) => string;
 /**
  * Converts an array of objects to a CSV string.
+ *
  * @param data - The data to convert.
  * @param options - Options for CSV conversion.
  * @returns The CSV string.
@@ -39,10 +35,11 @@ export declare function arrayToCSV<T extends Record<string, unknown>>(data: T[],
 /**
  * Transform the raw data to a format that is suitable for exporting to CSV.
  * This function is used to transform the data before it is passed to the CSV export function.
- * @param props.config - [Optional] The chart configuration that defines the chart type and data transformation.
+ *
+ * @param props.config - The chart configuration that defines the chart type and data transformation.
  * @param props.rawData - The raw data to be transformed, which is an array of objects.
- * @param props.layer - [Optional] The layer associated with the chart, used for additional data context.
- * @param props.fieldList - [Optional] The list of fields in the layer, used to determine field types and names.
+ * @param props.layer - The layer associated with the chart, used for additional data context.
+ * @param props.fieldList - The list of fields in the layer, used to determine field types and names.
  */
 export declare function transformChartData<T extends Record<string, unknown>>(props: {
     config?: ChartConfig;
@@ -52,12 +49,14 @@ export declare function transformChartData<T extends Record<string, unknown>>(pr
 }): T[];
 /**
  * Transform the histogram data to a format that is suitable for exporting to CSV.
+ *
  * @param config - The histogram model or config
  * @param rows - The raw data to be transformed.
  */
 export declare function transformHistogramData<T extends Record<string, unknown>>(config: ChartConfig<typeof ModelTypes.Histogram>, rows: T[]): T[];
 /**
  * Processes the chart data for bar and line charts.
+ *
  * @param props.config - The chart model.
  * @param props.rows - The raw data to be transformed.
  * @param props.layer - The layer associated with the chart.
@@ -70,6 +69,7 @@ export declare function transformBarLineChartData<T extends Record<string, unkno
 }): T[];
 /**
  * Transform the pie chart data to a format that is suitable for exporting to CSV.
+ *
  * @param props.model - The pie chart model.
  * @param props.rows - The raw data to be transformed.
  * @param props.layer - The layer associated with the chart.
@@ -82,6 +82,7 @@ export declare function transformPieChartData<T extends Record<string, unknown>>
 }): T[];
 /**
  * Transform the box plot data to a format that is suitable for exporting to CSV.
+ *
  * @param model - The box plot model.
  * @param rows - The raw data to be transformed.
  * @returns The transformed data.
@@ -94,6 +95,14 @@ export declare function transformBoxPlotData<T extends Record<string, unknown>>(
 }): T[];
 /**
  * Check if the provided date is valid.
- * @param {unknown} date - The date to check, should be a string or a number.
+ *
+ * @param date - The date to check, should be a string or a number.
  */
 export declare const isValidDate: (date: unknown) => date is Date | number | string;
+/**
+ * Returns a unique ID.
+ *
+ * @example
+ * 33c2c20e-5a9e-c7be-1b23-b210e6218831
+ */
+export declare function generateGUID(): string;

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

@@ -11,30 +11,32 @@ export declare function getBoxPlotStatisticFieldNames(y?: string): Record<BoxPlo
  * 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
- * @default false
+ * @param config - the chart config
  */
-export declare function isGaugeByFeature(config: WebGaugeChart): boolean;
+export declare function isGaugeByFeature(config: WebChart): boolean;
 /**
  * From fetched data (type: WebChartDataTypes) returns the part containing the data that
  * is to be assigned to the chart (WebChartDataItem[] | WebChartBin[])
- * @param props.fetchedData The fetched finished data
+ *
+ * @param props.fetchedData - The fetched finished data
  */
 export declare function extractChartDataFromFetchedData(fetchedData?: WebChartDataTypes): WebChartBin[] | WebChartDataItem[] | undefined;
 /**
  * Determine whether the current box plot has multi-fields or not based on its query type
- * @param chartSubType: Box plot sub type
+ *
+ * @param chartSubType - Box plot sub type
  */
 export declare function isMultiFieldsBoxPlot(chartSubType?: ChartSubType): boolean;
 /**
  * Compute Y value for given Box Plot Y field key based on the provided config
- * @param props.key The BoxPlotYFieldKeys related to the stat
- * @param props.y The y field to use to get the y value
- * @param props.chartSubType The box plot sub type
- * @param props.splitBy The where clause used as a split-by value for a given series
- * @param props.splitByValue The split-by value for a given series
- * @param props.showOutliers Whether to show the outliers
- * @param props.standardizeValues Whether to show the standardized values
+ *
+ * @param props.key - The BoxPlotYFieldKeys related to the stat
+ * @param props.y - The y field to use to get the y value
+ * @param props.chartSubType - The box plot sub type
+ * @param props.splitBy - The where clause used as a split-by value for a given series
+ * @param props.splitByValue - The split-by value for a given series
+ * @param props.showOutliers - Whether to show the outliers
+ * @param props.standardizeValues - Whether to show the standardized values
  */
 export declare function getBoxPlotYValue(props: BoxPlotYValueProps): string;
 /**
@@ -99,7 +101,7 @@ export declare function isEmptyDataset(props: {
     dataSet?: WebChartDataItem[];
 }): boolean;
 /**
- * Gets the data min and max values for a stacked series
+ * Gets the data min and max values for a stacked series; also an indicator whether the data has negative values.
  * @param seriesConfig The config for the series
  * @param filteredSeriesIds List of series ids to use as a filter
  * @param filteredData The data to look into
@@ -111,6 +113,7 @@ export declare function getDataMinMaxFromStackedSeries(props: {
 }): {
     stackedMinY: number;
     stackedMaxY: number;
+    dataHasNegativeValues: boolean;
 };
 /**
  * Looks for the min and max values from a data set, considering only the visible series.

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

@@ -1,7 +1,6 @@
 import { WebChartDataTypes, WebChartQuery } from '../../spec';
 import { DataWarningKeywords } from '../chart-config/validator/interfaces';
 import { ChartSubType } from '../misc/interfaces';
-import { BinnedServerData } from './time-binning/interfaces';
 export interface DataMinMax {
     minY: number;
     maxY: number;
@@ -13,7 +12,6 @@ export interface DataInfo {
     invalidType?: DataWarningKeywords;
     count?: number;
     data?: WebChartDataTypes;
-    binnedServerData?: BinnedServerData;
     queryConfig?: WebChartQuery;
 }
 export declare const BoxPlotYFieldKeys: {
@@ -37,3 +35,34 @@ export interface BoxPlotYValueProps {
     showOutliers?: boolean;
     standardizeValues?: boolean;
 }
+export interface DataUpdateDetails {
+    common: {
+        queryChanged: boolean;
+        xOrYChanged: boolean;
+        numberOfSeriesChanged: boolean;
+        configFiltersChanged: boolean;
+        filterBySelectionChanged: boolean;
+        dataForFilterBySelectionChanged: boolean;
+        binTemporalDataChanged: boolean;
+        timeBinningChanged: boolean;
+        timeIntervalUnitChanged: boolean;
+        newTimeBinningWillBeCalculated: boolean;
+        valueFormatChangeRequiresNewData: boolean;
+    };
+    histogram: {
+        dataPropsChanged: boolean;
+    };
+    gauge: {
+        valueConversionChanged: boolean;
+    };
+    boxPlot: {
+        showMeanChanged: boolean;
+    };
+    heatChart: {
+        binningChanged: boolean;
+        hideEmptyRowsAndColumnsChanged: boolean;
+    };
+    scatterPlot: {
+        tooltipFieldsChanged: boolean;
+    };
+}

package/dist/utils/data/time-binning/interfaces.d.ts

@@ -14,10 +14,6 @@ export interface TimeBinningStatistics {
     dateRange: DateRange;
     numberOfFeatures: number;
 }
-export interface BinnedServerData {
-    data: WebChartDataItem[];
-    timeBinningStats: TimeBinningStatistics;
-}
 export interface GroupProps {
     binFirstOrLastIndex: number;
     data: WebChartDataItem[];

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

@@ -1,6 +1,6 @@
 import { CategoryFormatOptions, Color, DateTimeFormatOptions, HistogramOverlays, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebChartStackedKinds, WebChartTypes } from '../../spec';
-import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 import { CommonStrings } from '../localization/interfaces';
+import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 export declare const histogramBinCount = 32;
 export declare const featuresExtentField = "arcgis_charts_features_extent";
 export declare const queryDefaults: QueryDefaults;

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

@@ -44,7 +44,7 @@ export interface QueryDefaults {
     maxParallelRequests: number;
     maxRecords: number;
     outStatistics: Readonly<IStatisticDefinition>;
-    uniqueIdsName: string;
+    uniqueIdsName: number | string;
     orderByJSAPIDelimiter: string;
 }
 export interface ChartTextProps {

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

@@ -17,11 +17,11 @@ export declare class ArcgisChartsError<T = any> extends Error {
      */
     details?: T;
     /**
-     * Creates a new ArcgisChartsError instance.
+     * Creates a new `ArcgisChartsError` instance.
      *
-     * @param {string} name - A unique error name.
-     * @param {string} [message] - A message describing the details of the error.
-     * @param {Object} [details] - The details object provides additional details specific to the error.
+     * @param name - A unique error name.
+     * @param message - A message describing the details of the error.
+     * @param details - The details object provides additional details specific to the error.
      */
     constructor(name: string, message?: string, details?: T);
 }

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

@@ -1,8 +1,12 @@
-import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
 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 { default as MapView } from '@arcgis/core/views/MapView.js';
+import { default as SceneView } from '@arcgis/core/views/SceneView.js';
+import { IFeatureLayer, IField, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
 import { IFeatureType, QueryObject, QueryObjectProps, RendererInfo, SubtypeInfo } from './interfaces';
+import { SupportedLayer } from '../../interfaces';
 /**
  * Returns the renderer type and the field and normalization field if applicable.
  * @param layerRenderer
@@ -38,7 +42,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).
@@ -114,31 +118,23 @@ export declare function getFieldDescription(props: {
 }): string | undefined;
 /**
  * Returns feature layer field names used in its renderer.
- * @param {FeatureLayer} layer
- * @returns {Promise<string[]>}
  */
 export declare function getRendererFieldNames(layer: SupportedLayer): Promise<string[]>;
 /**
  * Returns the ArcGIS server's rest/info url of the feature server given a feature layer url.
- * @example   getServerRestInfo(https://servicesdev.arcgis.com/b5ADkBof6gCHCFQm/arcgis/rest/services/Steph_Curry/FeatureServer/2
+ *
+ * @example
+ * getServerRestInfo(https://servicesdev.arcgis.com/b5ADkBof6gCHCFQm/arcgis/rest/services/Steph_Curry/FeatureServer/2
  * returns https://servicesdev.arcgis.com/b5ADkBof6gCHCFQm/arcgis/rest/info
- * @param {string} resUrl
- * @returns {string}
  */
 declare function getServerRestInfo(resUrl: string): string;
 /**
  * Returns a boolean to indicate if the feature layer is on standard feature data store or not.
  * https://doc.arcgis.com/en/arcgis-online/reference/faq.htm#anchor7
- * @param {FeatureLayer} layer
- * @returns {Promise<boolean>}
  */
 export declare function isStandardLayer(layer: SupportedLayer): Promise<boolean>;
 /**
  * Finds the matching field name for a given layer based on the fieldToMatch parameter.
- * @param {QueryObject} props.queryObject
- * @param {string} props.fieldToMatch
- * @param {boolean} props.returnUndefinedIfNotFound
- * @returns {Promise<string>}
  */
 export declare function findMatchingLayerFieldName(props: {
     queryObject: QueryObject;
@@ -146,12 +142,23 @@ export declare function findMatchingLayerFieldName(props: {
     returnUndefinedIfNotFound?: boolean;
 }): Promise<string>;
 /**
- * Finds the matching layer fields for a list of fields.
+ * 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).
+ *
+ * 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
  *
- * @param {(string[] | undefined)} props.fields
- * @param {SupportedLayer} props.queryObject
- * @param {boolean} props.returnUndefinedIfNotFound
- * @returns
+ * 2: Approximate match: we upper-case the fields to compare them
+ *
+ * @param layerFieldList - The list of fields to search in.
+ * @param fieldToMatch - The field name to match.
+ * @returns The matching field if found, otherwise undefined.
+ */
+export declare function findMatchingField(layerFieldList: IField[], fieldToMatch: string): IField | undefined;
+/**
+ * Finds the matching layer fields for a list of fields.
  */
 export declare function matchFieldsList(props: {
     fieldsList: string[] | undefined;
@@ -161,12 +168,12 @@ export declare function matchFieldsList(props: {
 /**
  * Builds a WebChartQuery based on information coming from the runtime filters (chart options), the config and the data source.
  * The filters by attributes from all sources are all combined together (using the AND operator).
- * Regarding the other filters (by geometry, gdb version and time extent) only one of each can be applied. The runtime
- * filters are chosen over the config filters.
- * @param props.queryObject The query object (feature layer or feature layer view)
- * @param props.chartConfig The chart's config
- * @param props.runtimeDataFilters The runtime data filters
- * @param props.ignoreViewExtent Whether to ignore the view extent
+ * Regarding the other filters (by geometry, gdb version and time extent) only one of each can be applied. The runtime filters are chosen over the config filters.
+ *
+ * @param props.queryObject - The query object (feature layer or feature layer view)
+ * @param props.chartConfig - The chart's config
+ * @param props.runtimeDataFilters - The runtime data filters
+ * @param props.ignoreViewExtent - Whether to ignore the view extent
  */
 export declare function buildQueryConfig(props: {
     queryObject?: QueryObject;
@@ -176,30 +183,49 @@ export declare function buildQueryConfig(props: {
 }): WebChartQuery;
 /**
  * Ger the list of the fields used in the charts
- * @category Public
- *
  *
- * @param {WebChart[] | undefined} layer - the supported layer
- * @param {WebChart[] | undefined} chartList - List of charts stored in the layer
- *
- * @returns {Promise<string[]>} - The list of fields used in the charts
+ * @param layer - the supported layer
+ * @param chartList - List of charts stored in the layer
+ * @returns The list of fields used in the charts
  */
 export declare function getFieldsUsedInCharts(layer: SupportedLayer): Promise<string[]>;
 /**
  * Fetches the fields used in the chart configuration and returns the matching fields from the feature layer.
- * @param {ChartConfig} config The chart configuration
- * @param {SupportedLayer} layer The feature layer
  *
- * @returns {Promise<string[]>} The list of matching fields
+ * @param config - The chart configuration
+ * @param layer - The feature layer
+ * @returns The list of matching fields
  */
 export declare function extractFieldsUsedInConfig(config: WebChart, layer: SupportedLayer | undefined): Promise<string[]>;
 /**
  * Get the list of layer fields from the series list of the chart config.
- * @param {SupportedLayer} layer The layer
  *
- * @returns {string[]} The list of layer fields
+ * @param layer - The layer
+ * @returns 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`.
+ *
+ * @example
+ * ```ts
+ * const matchingLayer = findMatchingLayerFromView({ view, portalItemId: 'abc123' });
+ * ```
+ *
+ * @param props.view - The map or scene view
+ * @param props.portalItemId - The portal item id of the layer
+ * @returns The matching layer in the view or undefined if not found
+ *
+ * @requires
+ * - view
+ * - portalItemId
+ */
+export declare function findMatchingLayerFromView(props: {
+    view?: MapView | SceneView;
+    portalItemId: string;
+}): FeatureLayerView | SupportedLayer | undefined;
 export declare const layerPrivateFunctions: {
     getServerRestInfo: typeof getServerRestInfo;
     getSubtypeName: typeof getSubtypeName;

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

@@ -1,11 +1,13 @@
-import { RESTRendererType, WebChart, ICodedValue, SupportedLayer } from '../../spec';
+import { RESTRendererType, WebChart, ICodedValue } from '../../spec';
 import { default as MapView } from '@arcgis/core/views/MapView';
 import { default as SceneView } from '@arcgis/core/views/SceneView';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { SupportedLayer } from '../../interfaces';
 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

@@ -1,9 +1,10 @@
-/// <reference types="@arcgis/core/interfaces.d.ts" />
 import { default as Geometry } from '@arcgis/core/geometry/Geometry';
+import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer.js';
+import { default as SubtypeSublayer } from '@arcgis/core/layers/support/SubtypeSublayer.js';
 import { default as AttributeBinsQuery } from '@arcgis/core/rest/support/AttributeBinsQuery.js';
-import { default as Query } from '@arcgis/core/rest/support/Query.js';
+import { QueryProperties, default as Query } from '@arcgis/core/rest/support/Query.js';
 import { default as TimeExtent } from '@arcgis/core/time/TimeExtent.js';
-import { SupportedLayer, WebChartHeatChartSeries, WebChartQuery, WebChartTemporalBinning, RESTFieldType } from '../../../spec';
+import { WebChartHeatChartSeries, WebChartQuery, WebChartTemporalBinning, RESTFieldType } from '../../../spec';
 import { QueryObject } from '../interfaces';
 /**
  * Indicates whether a query can be cached. It is not when:
@@ -11,8 +12,8 @@ import { QueryObject } from '../interfaces';
  * - a date filter is set
  * @param query The query object or query parameters
  */
-export declare function isQueryCacheable(query: __esri.QueryProperties | AttributeBinsQuery | Query): boolean;
-export declare function getMaxRecords(layer?: SupportedLayer): number;
+export declare function isQueryCacheable(query: AttributeBinsQuery | Query | QueryProperties): boolean;
+export declare function getMaxRecords(layer?: Pick<FeatureLayer, "sourceJSON"> | SubtypeSublayer): number;
 /**
  * Function building a where clause by concatenating a list of filters by using the AND operator.
  * @param filterList The list of filters to combine
@@ -74,11 +75,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;
@@ -137,7 +146,7 @@ export declare function mapQuery(props: {
     queryConfig?: WebChartQuery;
     maxRecordCountFactor?: number;
 }): Query;
-export declare function getMaxRecordCountFactor(layer?: SupportedLayer): number | undefined;
+export declare function getMaxRecordCountFactor(layer?: Pick<FeatureLayer, "sourceJSON"> | SubtypeSublayer): number | undefined;
 export declare const queryParserPrivateFunctions: {
     sanitizeOutFields: typeof sanitizeOutFields;
 };

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

@@ -1,9 +1,10 @@
-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 { WebChart } from '../../../spec';
 import { QueryObject } from '../interfaces';
+import { SupportedLayer } from '../../../interfaces';
 /**
  * Indicates whether the input object is a feature collection.
  * @param queryObject
@@ -13,7 +14,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
@@ -28,7 +29,7 @@ export declare function isSubtypeGroupLayer(queryObject: QueryObject | SubtypeGr
  * Indicates whether the input object is an instance of `SubtypeSublayer`.
  * @param queryObject
  */
-export declare function isSubtypeSublayer(queryObject: QueryObject): queryObject is SubtypeSublayer;
+export declare function isSubtypeSublayer(queryObject: Pick<SubtypeSublayer, "type"> | QueryObject): queryObject is SubtypeSublayer;
 /**
  * Indicates whether the input object is an instance of `SupportedLayer` (`FeatureLayer` or `SubtypeSublayer`).
  * @param queryObject
@@ -41,8 +42,8 @@ export declare function isSupportedLayer(queryObject: QueryObject): queryObject
  *
  * @param layer
  */
-export declare function getMainLayer(layer: SupportedLayer): FeatureLayer | SubtypeGroupLayer;
-export declare function getMainLayer(layer: SupportedLayer | undefined): FeatureLayer | SubtypeGroupLayer | null | undefined;
+export declare function getMainLayer(layer: FeatureLayer | Pick<SubtypeSublayer, "parent" | "type">): FeatureLayer | SubtypeGroupLayer;
+export declare function getMainLayer(layer: FeatureLayer | Pick<SubtypeSublayer, "parent" | "type"> | undefined): FeatureLayer | SubtypeGroupLayer | null | undefined;
 /**
  * Indicates whether a layer supports queries with a `distance` parameter
  * @param layer The layer to test

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

@@ -3,27 +3,19 @@ import { ErrorStrings, LocaleInfo, UtilsStrings, SupportedLocalesForFormats } fr
 /**
  * Finds the locale info of the closest element to the given element.
  *
- * @param element The element to get the locale info from.
+ * @param element - The element to get the locale info from.
  */
 export declare function getLocaleInfo(element?: HTMLElement): LocaleInfo;
 /**
  * Converts the given `timeZone` from ArcGIS `MapView` to a valid time zone string.
- * @param {MapView["timeZone"] | undefined} timeZone
- * @returns {MapView["timeZone"] | undefined}
  */
 export declare function convertTimeZone(timeZone: MapView["timeZone"] | undefined): string | undefined;
 /**
  * Returns the date string in the Calcite date picker's expected format `YYYY-MM-DD` based on the given date and time zone.
- * @param {Date} date
- * @param {string} timeZone
- * @returns {string}
  */
 export declare function getDateStringInCalciteDatePickerFormat(date: Date, timeZone: string): string;
 /**
  * Returns the time string in the Calcite time picker's expected format `HH:mm` based on the given date and time zone.
- * @param {Date} date
- * @param {string} timeZone
- * @returns {string}
  */
 export declare function getTimeStringInCalciteTimePickerFormat(date: Date, timeZone: string): string;
 /**