@arcgis/charts-components 4.34.0-next.13 → 4.34.0-next.130

package/dist/utils/components/action-bar-utils.d.ts

@@ -1,4 +1,4 @@
-import { WebChart } from '@arcgis/charts-spec';
+import { WebChart } from '../../spec';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 import { ArcgisChartsActionBar } from '../../components/arcgis-charts-action-bar/customElement.js';
 import { ChartTypes, DefaultChartActions } from '../../utils';
@@ -9,21 +9,6 @@ import { ChartTypes, DefaultChartActions } from '../../utils';
  * @returns {DefaultChartActions[]} The default actions for the given chart type
  */
 export declare function getDefaultChartActions(chartType: ChartTypes | undefined): DefaultChartActions[];
-/**
- * Creates a new tooltip object and adds it to the DOM
- *
- * @param innerHTML HTML to be displayed inside tooltip
- * @param referenceElement Element for which the tooltip will be shown
- * @returns The tooltip object that was created
- */
-export declare function createTooltip(innerHTML: string, referenceElement?: HTMLElement): HTMLCalciteTooltipElement;
-/**
- * Destroys tooltip by removing it from the DOM
- *
- * @param tooltip The tooltip to be destroyed
- * @returns Null return for caller to easily reset tooltip object to null
- */
-export declare function destroyTooltip(tooltip: HTMLCalciteTooltipElement | null): null;
 /**
  * Event handler for action bar slot change.
  *
@@ -34,8 +19,15 @@ export declare const onActionBarSlotChange: (e: Event, chartComponent: HTMLArcgi
 /**
  * Updates the action bar states based on the properties of the chart component and the config object.
  *
- * @param actionBar
- * @param chartComponent
- * @param config
+ * @param {HTMLArcgisChartsActionBarElement} props.actionBar - The action bar element to update.
+ * @param {HTMLArcgisChartElement} props.chartComponent - The chart component element.
+ * @param {WebChart} [props.config] - The configuration object for the chart.
+ * @param {boolean} [props.isWarningDisplayed] - Optional flag to indicate if a warning is displayed.
+ *
  */
-export declare function updateActionBarStates(actionBar: HTMLArcgisChartsActionBarElement, chartComponent: HTMLArcgisChartElement, config?: WebChart): void;
+export declare function updateActionBarStates(props: {
+    actionBar: HTMLArcgisChartsActionBarElement;
+    chartComponent: HTMLArcgisChartElement;
+    config?: WebChart;
+    isWarningDisplayed?: boolean;
+}): void;

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

@@ -1,4 +1,4 @@
-import { RESTSimpleLineSymbolStyle } from '@arcgis/charts-spec';
+import { RESTSimpleLineSymbolStyle } from '../../spec';
 import { NumericFieldsChangeProps } from '../../interfaces';
 import { FormatKeys } from '../../model';
 export interface RGB {
@@ -17,7 +17,7 @@ export declare const DefaultStatNumberFormat: {
     readonly minimumFractionDigits: 0;
     readonly maximumFractionDigits: 3;
 };
-export declare const aggregationList: ("count" | "avg" | "max" | "min" | "percentile-continuous" | "sum" | "no_aggregation")[];
+export declare const aggregationList: ("count" | "sum" | "min" | "max" | "avg" | "percentile-continuous" | "no_aggregation")[];
 export declare const pieAggregationList: ("count" | "sum")[];
 export declare function getFormatIcon(formatKey: FormatKeys | undefined): string | undefined;
 /**
@@ -88,18 +88,6 @@ export declare function sanitizeColor(color: RGB | undefined): RGB | null;
  * @param e Input element "keydown" event
  */
 export declare const blockNumericE: (e: KeyboardEvent) => void;
-/**
- * Creates a tooltip for the hovered action.
- *
- * @param actionElement
- */
-export declare const createActionTooltip: (actionElement: HTMLCalciteActionElement | HTMLCalciteIconElement | HTMLCalciteListElement) => HTMLCalciteTooltipElement;
-/**
- * Destroys tooltip for the action that was being hovered.
- *
- * @param tooltip
- */
-export declare const destroyActionTooltip: (tooltip: HTMLCalciteTooltipElement | undefined) => void;
 /**
  * emit numeric field change event
  *
@@ -115,3 +103,18 @@ export declare const emitNumericFieldsChange: (props: NumericFieldsChangeProps)
  * @param lineStyle
  */
 export declare function getLineStyleType(lineStyle: RESTSimpleLineSymbolStyle | undefined): string;
+/**
+ * Downloads an object as a file using a data URL.
+ *
+ * @param {string} objectURL - The data URL of the object to download.
+ * @param {string} downloadString - The name of the file to download.
+ * @category Public
+ */
+export declare function downloadFile(objectURL: string, downloadString: string): void;
+/**
+ * Destroys tooltip by removing it from the DOM
+ *
+ * @param tooltip The tooltip to be destroyed
+ * @returns Null return for caller to easily reset tooltip object to null
+ */
+export declare function destroyTooltip(tooltip: HTMLCalciteTooltipElement | null | undefined): null;

package/dist/utils/components/config-update.d.ts

@@ -1,7 +1,7 @@
-import { SupportedLayer, WebChart, WebChartLegendPositions } from '@arcgis/charts-spec';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { ChartOptions } from '../../chart-rendering/common/interfaces';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
+import { SupportedLayer, WebChart, WebChartLegendPositions } from '../../spec';
 /**
  * Updates the legend position for a given WebChart config.
  * Returns the updated config.
@@ -43,4 +43,4 @@ export declare function isValidDataSource(config?: WebChart, layer?: FeatureLaye
  * @param component The chart component
  * @param options The runtime options
  */
-export declare function addMissingSplitBySeries(component: ArcgisChart, options: ChartOptions): Promise<void>;
+export declare function addMissingSplitBySeries(component: ArcgisChart, config: WebChart | undefined, options: ChartOptions): Promise<void>;

package/dist/utils/components/event-payloads.d.ts

@@ -1,6 +1,8 @@
+import { default as MapView } from '@arcgis/core/views/MapView';
+import { default as SceneView } from '@arcgis/core/views/SceneView';
 import { ChartModel } from '../../model';
 import { DefaultChartActions, PieSlicesSymbols, SelectionData, SeriesSymbolsMap } from '../../utils';
-import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChartDataTypes, WebChartLegendPositions } from '@arcgis/charts-spec';
+import { CalculatedMinMaxBoundsPayload, LegendItemVisibility, WebChartDataTypes, WebChartLegendPositions } from '../../spec';
 import { JsxNode } from '@arcgis/lumina';
 export type PanelNumberChangePayload = {
     panelNumber: number;
@@ -35,7 +37,7 @@ export type SeriesColorChangePayload = {
 };
 export type NoRenderPropChangePayload = {
     propName: string;
-    value: WebChartLegendPositions | boolean;
+    value: MapView | SceneView | WebChartLegendPositions | boolean | number | undefined;
     model: ChartModel | undefined;
 };
 export type LegendItemVisibilityChangePayload = {

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

@@ -1,5 +1,5 @@
 import { SupportedCharts } from '../../utils';
-import { WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from '@arcgis/charts-spec';
+import { WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from '../../spec';
 /** Supported chart types. */
 export declare const supportedChartTypes: SupportedCharts[];
 export declare const maximumNumberOfSimultaneousUpdates = 1;
@@ -8,7 +8,6 @@ export interface MissingSplitBySeriesProps {
     seriesTemplate?: WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartLineChartSeries | WebChartRadarChartSeries;
 }
 export type WebChartSeriesUsingSplitBy = WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartLineChartSeries | WebChartRadarChartSeries;
-export type WebChartComponentVersion = "beta" | "stable";
 export declare const DownloadableChartImagesTypes: {
     readonly PNG: "png";
     readonly JPEG: "jpeg";

package/dist/utils/components/message-utils.d.ts

@@ -1,9 +1,9 @@
-import { ErrorStrings } from '../../utils';
-import { WebChartTypes } from '@arcgis/charts-spec';
+import { WebChartTypes } from '../../spec';
+import { ErrorStrings } from '../localization/interfaces';
 /**
  * Pulls the proper placeholder according to the chart type
  *
  * @param chartType The chart type to get the placeholder for
  * @category Private
  */
-export declare function getChartPlaceholder(chartType?: WebChartTypes, strings?: ErrorStrings): string | undefined;
+export declare function getChartPlaceholder(chartType?: WebChartTypes, errorStrings?: ErrorStrings): string | undefined;

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

@@ -1,5 +1,9 @@
 import { CSVOptions } from '../../interfaces';
-import { ChartModel } from '../../model';
+import { ModelTypes } from '../../model';
+import { IField, SupportedLayer } from '../../spec';
+import { ChartConfig } from '../types';
+import { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { SupportedLocalesForFormats } from '../localization/interfaces';
 /**
  * A utility function to compare if a value has changed deeply.
  * @param value
@@ -20,7 +24,11 @@ export declare function hasChangedDeepOrShallow<T>(value: T, oldValue?: T): bool
  *                               If `true`, all values will be quoted.
  *                               If `false` or `undefined`, only values that contain special characters will be quoted.
  */
-export declare const formatCell: (value: unknown, quoteAll?: boolean) => string;
+export declare const formatCell: (props: {
+    value: unknown;
+    quoteAll?: boolean;
+    locale?: SupportedLocalesForFormats;
+}) => string;
 /**
  * Converts an array of objects to a CSV string.
  * @param data - The data to convert.
@@ -31,7 +39,61 @@ 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 rawData - The raw data to be transformed.
- * @param model - The model that defines the chart type and the data transformation.
+ * @param props.config - [Optional] 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.
  */
-export declare function transformChartData<T extends Record<string, unknown>>(rawData: T[], model?: ChartModel): T[];
+export declare function transformChartData<T extends Record<string, unknown>>(props: {
+    config?: ChartConfig;
+    rawData: T[];
+    layer?: FeatureLayerView | SupportedLayer;
+    fieldList?: IField[];
+}): 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.
+ */
+export declare function transformBarLineChartData<T extends Record<string, unknown>>(props: {
+    config: ChartConfig<typeof ModelTypes.BarChart | typeof ModelTypes.ComboBarLineChart | typeof ModelTypes.LineChart>;
+    rows: T[];
+    layer?: FeatureLayerView | SupportedLayer;
+    fieldList?: IField[];
+}): 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.
+ */
+export declare function transformPieChartData<T extends Record<string, unknown>>(props: {
+    config: ChartConfig<typeof ModelTypes.PieChart>;
+    rows: T[];
+    layer?: FeatureLayerView | SupportedLayer;
+    fieldList?: IField[];
+}): 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.
+ */
+export declare function transformBoxPlotData<T extends Record<string, unknown>>(props: {
+    config: ChartConfig<typeof ModelTypes.BoxPlot>;
+    rows: T[];
+    layer?: FeatureLayerView | SupportedLayer;
+    fieldList?: IField[];
+}): T[];
+/**
+ * Check if the provided date is valid.
+ * @param {unknown} date - The date to check, should be a string or a number.
+ */
+export declare const isValidDate: (date: unknown) => date is Date | number | string;

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

@@ -1,4 +1,4 @@
-import { WebChartQuery } from '@arcgis/charts-spec';
+import { WebChartQuery } from '../../../spec';
 import { ChartElementLimit } from '../../defaults/interfaces';
 import { AbortControllerKeyType } from '../../layer/query-features/interfaces';
 import { QueryObject } from '../../layer/interfaces';

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

@@ -1,4 +1,4 @@
-import { WebChart, WebChartBin, WebChartDataItem, WebChartDataTypes, WebChartSeriesType, WebGaugeChart } from '@arcgis/charts-spec';
+import { WebChart, WebChartBin, WebChartDataItem, WebChartDataTypes, WebChartSeriesType, WebGaugeChart } from '../../spec';
 import { ChartSubType } from '../misc/interfaces';
 import { BoxPlotYValueProps, DataMinMax, BoxPlotYFieldKeys } from './interfaces';
 /**

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

@@ -1,4 +1,4 @@
-import { WebChartDataTypes, WebChartQuery } from '@arcgis/charts-spec';
+import { WebChartDataTypes, WebChartQuery } from '../../spec';
 import { DataWarningKeywords } from '../chart-config/validator/interfaces';
 import { ChartSubType } from '../misc/interfaces';
 import { BinnedServerData } from './time-binning/interfaces';

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

@@ -1,10 +1,10 @@
-import { TimeIntervalInfo, WebChartDataItem, WebChartFixedDateBinningUnits } from '@arcgis/charts-spec';
+import { TimeIntervalInfo, WebChartDataItem, WebChartTemporalBinningUnits } from '../../../spec';
 export interface DateRange {
     dateMinTimestamp: number;
     dateMaxTimestamp: number;
 }
 export interface IntervalUnitHelper {
-    unit: WebChartFixedDateBinningUnits;
+    unit: WebChartTemporalBinningUnits;
     threshold: number;
     unitMs: number;
     preferredIntervalSize: number[];
@@ -26,4 +26,4 @@ export interface GroupProps {
     newDateMin: number;
     newDateMax: number;
 }
-export declare const groupByWhenCaseForMedianTimeBinning = "${ groupByFieldsForStatistics } WHEN ${ dateField }>='${ startDate }' AND ${ dateField }${ endDateOperand }'${ endDate }' THEN '${ y }|${ binIndex}'";
+export declare const groupByWhenCaseForMedianTimeBinning = "{ groupByFieldsForStatistics } WHEN { dateField }>='{ startDate }' AND { dateField }{ endDateOperand }'{ endDate }' THEN '{ y }|{ binIndex}'";

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

@@ -1,4 +1,4 @@
-import { CategoryFormatOptions, Color, DateTimeFormatOptions, HistogramOverlays, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebChartStackedKinds, WebChartTypes } from '@arcgis/charts-spec';
+import { CategoryFormatOptions, Color, DateTimeFormatOptions, HistogramOverlays, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebChartStackedKinds, WebChartTypes } from '../../spec';
 import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 export declare const histogramBinCount = 32;
 export declare const featuresExtentField = "arcgis_charts_features_extent";
@@ -19,7 +19,12 @@ export declare const pieChartSpecialSlicesId: {
     emptySliceId: string;
 };
 export declare const defaultBoxPlotCategory = "arcgis_charts_box_plot_category";
-export declare const ramp: number[][];
+export declare const defaultHeatChartFields: {
+    valueField: string;
+    xField: string;
+    yField: string;
+};
+export declare const ramp: Color[];
 /**
  * Returns a specific color from the default ramp, given an index. If the index is > than the ramp length,
  * we use modulo to get the corresponding color.
@@ -184,7 +189,7 @@ export declare function getDefaultTimeAggregationTypeLabel(timeAggregationType:
  *  */
 export declare function getDefaultStackedType(): WebChartStackedKinds;
 /**
- * Returns the default label to show when there is no R2 value computed or set for scatter plot
+ * Returns the default label to show when there is no R2 value computed or set for scatterplot
  *
  * @returns {Promise<string>}
  */

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

@@ -1,4 +1,4 @@
-import { IFont, IStatisticDefinition } from '@arcgis/charts-spec';
+import { IFont, IStatisticDefinition } from '../../spec';
 export declare const LimitBehavior: {
     readonly Reject: "reject";
     readonly RenderUpToTheLimit: "renderUpToTheLimit";

package/dist/utils/index.d.ts

@@ -25,7 +25,6 @@ export * from './localization';
 export * from './localization/interfaces';
 export * from './misc';
 export * from './misc/interfaces';
-export type * from '../assets/t9n/utils/interfaces';
 export * from './type-guards';
 export * from './types';
 export * from './ui/chart-ui-utils';

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

@@ -1,7 +1,8 @@
-import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '@arcgis/charts-spec';
+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 Renderer } from '@arcgis/core/renderers/Renderer';
-import { QueryObject, QueryObjectProps, RendererInfo, SubtypeInfo } from './interfaces';
+import { IFeatureType, QueryObject, QueryObjectProps, RendererInfo, SubtypeInfo } from './interfaces';
 /**
  * Returns the renderer type and the field and normalization field if applicable.
  * @param layerRenderer
@@ -66,6 +67,29 @@ export declare function getLayerDateFields(fieldsInfo: IField[]): string[];
  * @param fieldsInfo
  */
 export declare function getLayerNumericFields(fieldsInfo: IField[]): string[];
+/**
+ * Retrieve the subtype name from the subtype id, if available.
+ * Otherwise, just simply returns the original value.
+ * @param props.subtypeInfo The subtypeInfo which consists of a typeIdField and a list of subtypes.
+ * @param props.fieldName The field name to check against the subtype's typeIdField
+ * @param props.fieldValueToMatch The field value, mainly the subtype id, to find the matching subtype name (if it's from a field that holds the subtypes for the features).
+ * @returns The matching subtype name if it's a subtype field; otherwise undefined.
+ * //TODO: may need to revise regrading the typeIdField property (See https://devtopia.esri.com/WebGIS/arcgis-js-api/issues/42555)
+ */
+declare function getSubtypeName(props: {
+    subtypeInfo?: SubtypeInfo;
+    fieldName: string;
+    fieldValueToMatch: number | string;
+}): string | undefined;
+/**
+ * Get the feature types from the layer, including all coded-value domains
+ * defined in the feature types.
+ * @param layer The layer to retrieve the information.
+ * @param propName Whether to fetch the types or subtypes
+ * @returns the feature types or undefined
+ */
+declare function getFeatureTypes(layer: FeatureLayer, propName: "types"): IFeatureType[] | undefined;
+declare function getFeatureTypes(layer: FeatureLayer | SubtypeGroupLayer, propName: "subtypes"): IFeatureType[] | undefined;
 /**
  * Retrieve subtype information from the query object.
  * @param queryObject The query object from which to retrieve the feature layer.
@@ -94,6 +118,14 @@ export declare function getFieldDescription(props: {
  * @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
+ * 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
@@ -168,3 +200,9 @@ export declare function extractFieldsUsedInConfig(config: WebChart, layer: Suppo
  * @returns {string[]} The list of layer fields
  */
 export declare function extractFieldsFromConfigList(layer: SupportedLayer): Promise<string[]>;
+export declare const layerPrivateFunctions: {
+    getServerRestInfo: typeof getServerRestInfo;
+    getSubtypeName: typeof getSubtypeName;
+    getFeatureTypes: typeof getFeatureTypes;
+};
+export {};

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

@@ -1,6 +1,17 @@
-import { IFeatureLayer, WebChart, WebChartDataTypes } from '@arcgis/charts-spec';
+import { Color, IFeatureLayer, WebChart, WebChartDataItemValue, WebChartDataTypes } from '../../../spec';
 import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer';
 import { WebChartConfigFields } from './interfaces';
+/**
+ * Converts a hex color into a ESRI Color array ([number, number, number, number])
+ * @param hex The hex code to convert
+ */
+declare function hexToRGB(hex: string): Color | undefined;
+/**
+ * Converts an input value typed as WebChartDataItemValue into a Color.
+ * Only values representing a hex code or an ESRI color will yield a result.
+ * @param inputColor The input value to convert to a color
+ */
+declare function convertColor(inputColor?: WebChartDataItemValue): Color | undefined;
 /**
  * Creates a chart renderer based on the provided config fields and inline data
  * @param props.categoryField The category field
@@ -14,6 +25,17 @@ export declare function convertConfigFieldsToChartRenderer(props: {
     configFields?: WebChartConfigFields;
     inlineData: WebChartDataTypes;
 }): WebChart["chartRenderer"];
+/**
+ * Removes the config fields from the feature set to add to the feature collection
+ * @param numericFields The list of numeric fields
+ * @param configFields The config fields
+ * @param inlineData The data to cure
+ */
+declare function removeConfigFieldsFromData(props: {
+    numericFields: string[];
+    configFields: WebChartConfigFields;
+    inlineData: WebChartDataTypes;
+}): WebChartDataTypes;
 /**
  * Converts an array of inline data to a feature set and returns an IFeatureLayer
  * @param props.categoryField The category field
@@ -47,3 +69,9 @@ export declare function convertInlineConfigToLayerConfig(props: {
     iLayer?: IFeatureLayer;
     layer?: FeatureLayer;
 }>;
+export declare const inlineConversionPrivateFunctions: {
+    hexToRGB: typeof hexToRGB;
+    convertColor: typeof convertColor;
+    removeConfigFieldsFromData: typeof removeConfigFieldsFromData;
+};
+export {};

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

@@ -1,7 +1,7 @@
-import { RESTRendererType, WebChart, ICodedValue, SupportedLayer } from '@arcgis/charts-spec';
+import { RESTRendererType, WebChart, ICodedValue, SupportedLayer } 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 { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 export interface QueryObjectProps {
     chartConfig: WebChart;
     layer?: FeatureLayerView | SupportedLayer;

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

@@ -1,7 +1,7 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { WebChartCalendarBasedBinning, WebChartDataItem, WebChartFixedDateBinning, WebChartQuery } from '@arcgis/charts-spec';
 import { default as AttributeBinsFeatureSet } from '@arcgis/core/rest/support/AttributeBinsFeatureSet.js';
-import { ErrorStrings } from '../../../assets/t9n/utils/interfaces';
+import { WebBoxPlot, WebChart, WebChartDataItem, WebChartQuery, WebChartTemporalBinning, WebHeatChart } from '../../../spec';
+import { ErrorStrings } from '../../localization/interfaces';
 import { ChartSubType } from '../../misc/interfaces';
 import { QueryObject } from '../interfaces';
 import { AbortControllerKeyType, Features } from './interfaces';
@@ -30,6 +30,36 @@ export declare function getQueryAttributeBinsForScatterplotFieldsAlias(x: string
     upperBoundaryAlias: string;
     stackAlias: string;
 };
+/**
+ * Fetches and returns the heat chart data using query(Attribute)Bins
+ * @param props.chartConfig The chart configuration
+ * @param props.queryObject The object used to query (FL or FLV)
+ * @param props.queryConfig The query configuration
+ * @param props.errorStrings The t9n error strings
+ */
+export declare function queryAttributeBinsForHeatChart(props: {
+    chartConfig: WebBoxPlot | WebChart | WebHeatChart;
+    queryObject: QueryObject;
+    queryConfig: WebChartQuery;
+    errorStrings: ErrorStrings;
+}): Promise<AttributeBinsFeatureSet | undefined>;
+/**
+ * Query the features for the matrix heat chart.
+ * @param props.chartConfig The chart configuration
+ * @param props.queryObject The object used to query (FL or FLV)
+ * @param props.queryConfig The query configuration
+ * @param props.returnFeaturesExtent Whether to add an out statistic to fetch the features extent
+ * @param props.errorStrings The t9n error strings
+ * @param props.abortKey The key to abort the query
+ */
+export declare function queryFeaturesForMatrixHeatChart(props: {
+    chartConfig: WebBoxPlot | WebChart | WebHeatChart;
+    queryObject: QueryObject;
+    queryConfig: WebChartQuery;
+    returnFeaturesExtent?: boolean;
+    errorStrings: ErrorStrings;
+    abortKey?: AbortControllerKeyType;
+}): Promise<Features | undefined>;
 /**
  * Uses query(Attribute)Bins to fetch the aggregated scatterplot data
  * @param props.queryObject The object used to query (FL or FLV)
@@ -135,7 +165,7 @@ export declare function getQueryAttributeBinsForTemporalDataAliases(x: string):
 export declare function queryAttributeBinsForTemporalData(props: {
     queryObject?: QueryObject;
     queryConfig: WebChartQuery;
-    temporalBinning?: WebChartCalendarBasedBinning | WebChartFixedDateBinning;
+    temporalBinning?: WebChartTemporalBinning;
     dateField: string;
     splitByField?: string;
     abortKey?: AbortControllerKeyType;

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

@@ -1,9 +1,9 @@
 /// <reference types="@arcgis/core/interfaces.d.ts" />
-import { SupportedLayer, WebChartCalendarBasedBinning, WebChartFixedDateBinning, WebChartQuery } from '@arcgis/charts-spec';
 import { default as Geometry } from '@arcgis/core/geometry/Geometry';
 import { default as AttributeBinsQuery } from '@arcgis/core/rest/support/AttributeBinsQuery.js';
 import { 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 { QueryObject } from '../interfaces';
 /**
  * Indicates whether a query can be cached. It is not when:
@@ -47,6 +47,13 @@ export declare function mapQueryTimeExtent(timeExtentConfig?: WebChartQuery["tim
  * @param geometryConfig The geometry from the config
  */
 export declare function mapQueryGeometry(geometryConfig?: WebChartQuery["geometry"]): Geometry | null | undefined;
+/**
+ * Sanitizes an outFields array by:
+ * - removing the duplicates
+ * @param outFields The array to sanitize
+ * @returns The sanitized array
+ */
+declare function sanitizeOutFields(outFields?: string[]): string[];
 /**
  * Maps properties from a WebChartQuery and properties specific to temporal binning into an AttributeBinsQuery object.
  * @param props.queryObject The layer or feature layer view
@@ -58,10 +65,46 @@ export declare function mapQueryGeometry(geometryConfig?: WebChartQuery["geometr
 export declare function mapAttributeBinsQueryForTemporalData(props: {
     queryObject?: QueryObject;
     queryConfig?: WebChartQuery;
-    temporalBinning: WebChartCalendarBasedBinning | WebChartFixedDateBinning;
+    temporalBinning: WebChartTemporalBinning;
     dateField: string;
     splitByField?: string;
-}): AttributeBinsQuery;
+}): Promise<AttributeBinsQuery>;
+/**
+ * Builds a SQL expression as well as the start and end values necessary for the calendar date parts binning.
+ * @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
+ */
+export declare function getCalendarDatePartsParameters(props: {
+    field: string;
+    fieldType?: RESTFieldType;
+    unit?: string;
+}): {
+    expression?: string;
+    start?: number;
+    end?: number;
+};
+/**
+ * Maps properties from a WebChartQuery and properties specific to heat chart into an AttributeBinsQuery object.
+ * @param props.queryObject The layer or feature layer view
+ * @param props.queryConfig The query configuration
+ * @param props.x The x field
+ * @param props.y The y field
+ * @param props.xTemporalBinning The x temporal binning configuration
+ * @param props.yTemporalBinning The y temporal binning configuration
+ * @param props.firstDayOfWeek The first day of the week, used for date-based bins
+ * @param props.outTimeZone The IANA time zone used for temporal bin calculations
+ */
+export declare function mapAttributeBinsQueryForHeatChart(props: {
+    queryObject?: QueryObject;
+    queryConfig?: WebChartQuery;
+    x: string;
+    y: string;
+    xTemporalBinning?: WebChartHeatChartSeries["xTemporalBinning"];
+    yTemporalBinning?: WebChartHeatChartSeries["yTemporalBinning"];
+    firstDayOfWeek?: number;
+    outTimeZone?: string;
+}): Promise<AttributeBinsQuery>;
 /**
  * Maps properties from a WebChartQuery and properties specific to temporal binning into an AttributeBinsQuery object.
  * @param props.queryObject The layer or feature layer view
@@ -95,3 +138,7 @@ export declare function mapQuery(props: {
     maxRecordCountFactor?: number;
 }): Query;
 export declare function getMaxRecordCountFactor(layer?: SupportedLayer): number | undefined;
+export declare const queryParserPrivateFunctions: {
+    sanitizeOutFields: typeof sanitizeOutFields;
+};
+export {};

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

@@ -1,8 +1,8 @@
-import { SupportedLayer, WebChart } from '@arcgis/charts-spec';
+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 { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { QueryObject } from '../interfaces';
 /**
  * Indicates whether the input object is a feature collection.
@@ -49,6 +49,12 @@ export declare function getMainLayer(layer: SupportedLayer | undefined): Feature
  * @returns A boolean
  */
 export declare function doesLayerSupportQueryWithDistance(layer: SupportedLayer): boolean;
+/**
+ * Indicates whether a layer supports the queryBins operation for the heat chart use case.
+ * @param layer The layer to test
+ * @returns A boolean indicating whether the operation is supported
+ */
+export declare function doesLayerSupportsQueryBinsForHeatChart(layer: SupportedLayer): boolean;
 /**
  * Indicates whether a layer supports the queryBins operation for the temporal data use case.
  * We currently only use the "date" operation.
@@ -57,7 +63,7 @@ export declare function doesLayerSupportQueryWithDistance(layer: SupportedLayer)
  * @param splitByField The split-by field
  * @returns A boolean indicating whether the operation is supported
  */
-export declare function doesLayerSupportsQueryBinsForTemporalData(layer: FeatureLayer | SubtypeGroupLayer, splitByField?: string): boolean;
+export declare function doesLayerSupportsQueryBinsForTemporalData(layer?: FeatureLayerView | SubtypeGroupLayer | SupportedLayer, splitByField?: string): boolean;
 /**
  * Indicates whether the layer supports the cacheHint parameter for the queryBins operation
  * @param queryObject The layer or feature layer view