@arcgis/charts-components 4.34.0-next.15 → 4.34.0-next.151

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 { 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 { default as 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;
+    dateMinTimestamp: number | null | undefined;
+    dateMaxTimestamp: number | null | undefined;
 }
 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,5 +1,6 @@
-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, 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';
 export declare const histogramBinCount = 32;
 export declare const featuresExtentField = "arcgis_charts_features_extent";
 export declare const queryDefaults: QueryDefaults;
@@ -19,7 +20,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.
@@ -65,7 +71,7 @@ export declare function getDefaultValueAxis(text?: string): WebChartAxis;
 export declare function getDefaultLegend(): WebChartLegend;
 export declare function getDefaultOverlay(overlayIndex: number): WebChartOverlay;
 export declare function getDefaultBackground(): Color;
-export declare function getDefaultTitle(): Promise<string>;
+export declare function getDefaultTitle(commonStrings: CommonStrings): string;
 export declare function getDefaultBoxPlotElementSymbol(seriesIndex?: number, useRandomColor?: boolean): ISimpleFillSymbol;
 /**
  * Returns a default marker symbol for a line chart
@@ -82,13 +88,14 @@ export declare function getDefaultLineChartLineSymbol(seriesIndex?: number): ISi
 export declare function getDefaultScatterplotMarkerSymbol(useRandomColor?: boolean): ISimpleMarkerSymbol;
 export declare function getDefaultScatterplotSizePolicy(): Required<SizePolicy>;
 export declare function getDefaultTrendLine(useRandomColor?: boolean): Required<ScatterplotOverlays>;
+export declare function getHeatChartSeries(objectIdField?: string): WebChartHeatChartSeries;
 export declare function getScatterplotSeries(): WebChartScatterplotSeries;
 /**
  * Returns default axes based on chart type as per the WebChart Specification
+ * @param commonStrings The common strings used in the chart
  * @param chartType The type of WebChart which is of type WebChartTypes
- *
  */
-export declare function getDefaultAxes(chartType: WebChartTypes): Promise<WebChartAxis[]>;
+export declare function getDefaultAxes(commonStrings: CommonStrings, chartType: WebChartTypes): WebChartAxis[];
 /**
  * Returns the default gauge needle
  */
@@ -96,21 +103,23 @@ export declare function getDefaultGaugeNeedle(): WebChartNeedle;
 /**
  * Returns the gauge axes
  */
-export declare function getGaugeAxes(): Promise<WebChartGaugeAxis[]>;
+export declare function getGaugeAxes(commonStrings: CommonStrings): WebChartGaugeAxis[];
 /**
  * Returns a default LineChartSeries object as per the WebChart Specification
  */
 export declare function getDefaultLineChartSeries(props: {
+    commonStrings: CommonStrings;
     objectIDField?: string;
     seriesIndex?: number;
-}): Promise<Required<Pick<WebChartLineChartSeries, "dataLabels" | "lineSymbol" | "markerSymbol" | "query">> & WebChartLineChartSeries>;
+}): Required<Pick<WebChartLineChartSeries, "dataLabels" | "lineSymbol" | "markerSymbol" | "query">> & WebChartLineChartSeries;
 /**
  * Returns a default RadarChartSeries object as per the WebChart Specification
  */
 export declare function getDefaultRadarChartSeries(props: {
+    commonStrings: CommonStrings;
     objectIDField?: string;
     seriesIndex?: number;
-}): Promise<Required<Pick<WebChartRadarChartSeries, "dataLabels" | "lineSymbol" | "markerSymbol" | "query">> & WebChartRadarChartSeries>;
+}): Required<Pick<WebChartRadarChartSeries, "dataLabels" | "lineSymbol" | "markerSymbol" | "query">> & WebChartRadarChartSeries;
 /**
  * Returns a default symbol for a bar chart series
  * @param seriesIndex The series index to pick a symbol color
@@ -122,11 +131,12 @@ export declare function getDefaultBarChartSeriesSymbol(seriesIndex?: number): IS
 export declare function getDefaultBarChartSeries(props: {
     objectIDField?: string;
     seriesIndex?: number;
-}): Promise<Required<Pick<WebChartBarChartSeries, "dataLabels" | "fillSymbol" | "query">> & WebChartBarChartSeries>;
+    commonStrings: CommonStrings;
+}): Required<Pick<WebChartBarChartSeries, "dataLabels" | "fillSymbol" | "query">> & WebChartBarChartSeries;
 /**
  * Returns a default BoxPlotSeries object as per the WebBoxPlot Specification
  */
-export declare function getDefaultBoxPlotSeries(seriesIndex?: number): Promise<WebChartBoxPlotSeries>;
+export declare function getDefaultBoxPlotSeries(commonStrings: CommonStrings, seriesIndex?: number): WebChartBoxPlotSeries;
 /**
  * Returns a default pie chart tick object as per the WebChart Specification
  */
@@ -138,7 +148,7 @@ export declare function getDefaultPieChartSymbol(): ISimpleFillSymbol;
 /**
  * Returns a default PieChartSeries object as per the WebChart Specification
  */
-export declare function getDefaultPieChartSeries(objectIDField?: string): Promise<Required<Pick<WebChartPieChartSeries, "dataLabels" | "fillSymbol" | "query">> & WebChartPieChartSeries>;
+export declare function getDefaultPieChartSeries(commonStrings: CommonStrings, objectIDField?: string): Required<Pick<WebChartPieChartSeries, "dataLabels" | "fillSymbol" | "query">> & WebChartPieChartSeries;
 /**
  * Returns a default GaugeSeries object as per the WebChart Specification
  */
@@ -149,17 +159,24 @@ export declare function getDefaultGaugeSeries(props: {
  * Returns the default chart rotation.
  */
 export declare function getDefaultChartRotation(): boolean;
-export declare function getDefaultBarChart(id?: string): Promise<WebChart>;
-export declare function getDefaultBoxPlot(id?: string): Promise<WebBoxPlot>;
-export declare function getDefaultLineChart(id?: string): Promise<WebChart>;
-export declare function getDefaultRadarChart(id?: string): Promise<WebChart>;
-export declare function getDefaultPieChart(id?: string): Promise<WebChart>;
-export declare function getDefaultGauge(id?: string): Promise<WebGaugeChart>;
-export declare function getDefaultScatterplot(id?: string): Promise<WebChart>;
+export declare function getDefaultBarChart(commonStrings: CommonStrings, id?: string): WebChart;
+export declare function getDefaultBoxPlot(commonStrings: CommonStrings, id?: string): WebBoxPlot;
+export declare function getDefaultLineChart(commonStrings: CommonStrings, id?: string): WebChart;
+export declare function getDefaultRadarChart(commonStrings: CommonStrings, id?: string): WebChart;
+export declare function getDefaultPieChart(commonStrings: CommonStrings, id?: string): WebChart;
+export declare function getDefaultGauge(commonStrings: CommonStrings, id?: string): WebGaugeChart;
+export declare function getDefaultScatterplot(commonStrings: CommonStrings, id?: string): WebChart;
+/**
+ * Gets default heat chart
+ * @param commonStrings
+ * @param id
+ * @returns WebChart
+ */
+export declare function getDefaultHeatChart(commonStrings: CommonStrings, objectIDField: string): WebChart;
 export declare function getDefaultHistogramOverlays(): Required<HistogramOverlays>;
 export declare function getDefaultHistogramSymbol(): ISimpleFillSymbol;
 export declare function getDefaultHistogramSeries(): Omit<Required<WebChartHistogramSeries>, "dataTooltipDateFormat" | "dataTooltipPercentFormat" | "dataTooltipValueFormat" | "query">;
-export declare function getDefaultHistogram(id?: string): Promise<WebChart>;
+export declare function getDefaultHistogram(commonStrings: CommonStrings, id?: string): WebChart;
 /**
  * Returns a list of render limitations, mainly set for performance reasons. They can be overridden through the chart options,
  * or let as defaults.
@@ -173,22 +190,19 @@ export declare function getChartTechnicalLimits(): ChartElementTechnicalLimit;
  * Returns the label for the provided aggregation type.
  * @param aggregationType
  */
-export declare function getDefaultAggregationTypeLabel(aggregationType: string | undefined): Promise<string>;
+export declare function getDefaultAggregationTypeLabel(aggregationType: string | undefined, commonStrings: CommonStrings): string;
 /**
  * Returns the label for the provided time aggregation type.
- * @param aggregationType
  */
-export declare function getDefaultTimeAggregationTypeLabel(timeAggregationType: string | undefined): Promise<string>;
+export declare function getDefaultTimeAggregationTypeLabel(timeAggregationType: string | undefined, commonStrings: CommonStrings): string;
 /**
  * Returns the default stacked type for Bar or Line chart with multiple series.
  *  */
 export declare function getDefaultStackedType(): WebChartStackedKinds;
 /**
- * Returns the default label to show when there is no R2 value computed or set for scatter plot
- *
- * @returns {Promise<string>}
+ * Returns the default label to show when there is no R2 value computed or set for scatterplot
  */
-export declare function getDefaultNoR2Label(): Promise<string>;
+export declare function getDefaultNoR2Label(commonStrings: CommonStrings): string;
 export declare const pieChartInnerRadius = 0;
 export declare const boxPlotOutliersSuffix = "_arcgis_charts_outliers";
 export declare const boxPlotZScoreSuffix = "_arcgis_charts_z_score";

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";
@@ -30,6 +30,7 @@ export interface ChartElementLimit {
     maxBoxThreePlusSeriesCountTotal?: number;
     maxBoxThreePlusSeriesCountPerSeries?: number;
     maxBoxPlotOutlierLimit?: number;
+    maxHeatChartCellLimit?: number;
 }
 export interface ChartElementTechnicalLimit {
     maxScatterCellsPerQuery: number;

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,4 +1,4 @@
-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';