@arcgis/charts-components 4.34.0-next.1 → 4.34.0-next.100

package/dist/interfaces.d.ts

@@ -1,5 +1,6 @@
 import { Color, WebChartTemporalBinningUnits } from '@arcgis/charts-spec';
-import { EventEmitter } from '@arcgis/lumina/controllers';
+import { EventEmitter } from '@arcgis/lumina';
+import { SupportedLocale } from '@arcgis/toolkit/intl';
 export declare const Slot: {
     readonly actionBar: "action-bar";
     readonly customActionTop: "custom-action-top";
@@ -14,7 +15,7 @@ export interface ColorListItemProps {
     value: string;
     selected?: boolean;
     ref?: (e?: HTMLCalciteListItemElement) => void;
-    colorAction: () => void;
+    colorAction: (e: Event) => void;
 }
 export interface IntervalPopoverProps {
     size: number;
@@ -144,4 +145,13 @@ export interface CSVOptions {
      * @default false
      */
     quoteAll?: boolean;
+    /**
+     * Locale used for formatting numbers in the CSV.
+     * This affects how numbers are formatted, such as decimal and thousands separators.
+     * If not provided, the default locale will be used.
+     * @default "en"
+     *
+     * "ar", "ar-u-nu-latn", "bs", "bg", "ca", "cs", "da", "de", "el", "en", "en-US", "es", "et", "fi", "fr", "he", "hr", "hu", "id", "it", "ja", "ko", "lt", "lv", "no", "nl", "pl", "pt-BR", "pt-PT", "ro", "ru", "sr", "sl", "sk", "sv", "th", "tr", "uk", "vi", "zh-CN", "zh-HK", "zh-TW"
+     */
+    locale?: SupportedLocale;
 }

package/dist/loader.js

@@ -2,24 +2,24 @@ import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as t } from "@arcgis/lumina";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.1 */
+v4.34.0-next.100 */
 const o = t(e, {
-  "arcgis-chart": [() => import("./components/arcgis-chart/customElement.js"), "actionMode,autoDisposeChart,chartLimits:,chartWillRender:,componentVersion,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,ignoreSmoothRenderingLimit,ignoreViewExtent,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerRendererChangePolicy,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,messageOptions:,model:,placeholder,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionTheme:,setTimeBinningInfoWhenNotProvided,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,timeZone,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:;clearSelection,errorAlert,exportAsCSV,exportAsImage,notify,refresh,resetZoom,switchSelection"],
-  "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "actionBarSelectionMode,chartElement:,chartType,clearSelectionState,clearSelectionTitle,clearSelectionToggle,disableCSVExportForChartTypes:,disabledExportAction,editChartState,editChartTitle,editChartToggle,expanded,exportAsCSVState,exportAsCSVTitle,exportAsImageState,exportAsImageTitle,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,forceDisableActions,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartState,rotateChartTitle,rotateChartToggle,selectionState,selectionTitle,selectionToggle,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomState,zoomTitle,zoomToggle"],
+  "arcgis-chart": [() => import("./components/arcgis-chart/customElement.js"), "actionMode,allowUsingObjectIdStat,autoDisposeChart,autoInverseDataLabelTextColor,chartIndex,chartLimits:,chartWillRender:,componentVersion,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,displaySettings:,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,ignoreSmoothRenderingLimit,ignoreViewExtent,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerItemId,layerRendererChangePolicy,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,model:,placeholder,querySettings:,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionTheme:,setTimeBinningInfoWhenNotProvided,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,timeZone,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:;clearSelection,errorAlert,exportAsCSV,exportAsImage,notify,refresh,resetZoom,switchSelection"],
+  "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "actionBarSelectionMode,chartElement:,chartType,clearSelectionState,clearSelectionTitle,clearSelectionToggle,disableCSVExportForChartTypes:,editChartState,editChartTitle,editChartToggle,expanded,exportActionState,exportAsCSVState,exportAsCSVTitle,exportAsImageState,exportAsImageTitle,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,forceDisableActions,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartState,rotateChartTitle,rotateChartToggle,selectionState,selectionTitle,selectionToggle,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomState,zoomTitle,zoomToggle"],
   "arcgis-charts-config-axes": [() => import("./components/arcgis-charts-config-axes/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,messageOverrides:,model:,open,showEnableXLogOption,showEnableYLogOption,showMaxXBoundOption,showMaxYBoundOption,showMinXBoundOption,showMinYBoundOption"],
   "arcgis-charts-config-axis": [() => import("./components/arcgis-charts-config-axis/customElement.js"), "axisTitle,dataMaxValue,dataMinValue,initialMaxBound,initialMinBound,isXAxis,maxBoundMaxLimit,maxBoundMinLimit,messageOverrides:,minBoundMaxLimit,minBoundMinLimit,model:,showEnableLogOption,showMaxBoundOption,showMinBoundOption"],
   "arcgis-charts-config-bar-chart": [() => import("./components/arcgis-charts-config-bar-chart/customElement.js"), "calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,seriesColor:,timeZone,usePopupTemplateFieldsInfo"],
   "arcgis-charts-config-bar-chart-data": [() => import("./components/arcgis-charts-config-bar-chart-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:,open"],
   "arcgis-charts-config-bar-chart-popover": [() => import("./components/arcgis-charts-config-bar-chart-popover/customElement.js"), "contentKind,headingTitle,isCustomSortDisabled,isNoAggregationDisabled,layerFieldsInfo:,messageOverrides:,open,referenceElement:,selectedContent;reposition"],
-  "arcgis-charts-config-bar-chart-series": [() => import("./components/arcgis-charts-config-bar-chart-series/customElement.js"), "activeColorMatch,configSeriesOpen,messageOverrides:,model:,popoverPlacement"],
-  "arcgis-charts-config-bar-chart-series-popover": [() => import("./components/arcgis-charts-config-bar-chart-series-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedName;reposition"],
+  "arcgis-charts-config-bar-chart-series": [() => import("./components/arcgis-charts-config-bar-chart-series/customElement.js"), "activeColorMatch,messageOverrides:,model:,popoverPlacement"],
+  "arcgis-charts-config-bar-chart-series-popover": [() => import("./components/arcgis-charts-config-bar-chart-series-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedName,selectedSeriesIndex;reposition"],
   "arcgis-charts-config-box-plot": [() => import("./components/arcgis-charts-config-box-plot/customElement.js"), "calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,seriesColor:,usePopupTemplateFieldsInfo"],
   "arcgis-charts-config-box-plot-data": [() => import("./components/arcgis-charts-config-box-plot-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:"],
   "arcgis-charts-config-box-plot-popover": [() => import("./components/arcgis-charts-config-box-plot-popover/customElement.js"), "contentKind,headingTitle,isCustomSortDisabled,layerFieldsInfo:,messageOverrides:,open,referenceElement:,selectedContent;reposition"],
   "arcgis-charts-config-box-plot-series": [() => import("./components/arcgis-charts-config-box-plot-series/customElement.js"), "activeColorMatch,configSeriesOpen,messageOverrides:,model:,popoverPlacement"],
-  "arcgis-charts-config-box-plot-series-popover": [() => import("./components/arcgis-charts-config-box-plot-series-popover/customElement.js"), "isLineSymbol,labelCanBeConfigured,messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedLineStyle,selectedLineWidth,selectedName;reposition"],
+  "arcgis-charts-config-box-plot-series-popover": [() => import("./components/arcgis-charts-config-box-plot-series-popover/customElement.js"), "isLineSymbol,labelCanBeConfigured,messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedLineStyle,selectedLineWidth,selectedName,selectedSeriesIndex;reposition"],
   "arcgis-charts-config-category-format": [() => import("./components/arcgis-charts-config-category-format/customElement.js"), "categoryFormat:,messageOverrides:"],
-  "arcgis-charts-config-chart-rename-popover": [() => import("./components/arcgis-charts-config-chart-rename-popover/customElement.js"), "messageOverrides:,name,open,popoverReferenceElement:;reposition"],
+  "arcgis-charts-config-chart-rename-popover": [() => import("./components/arcgis-charts-config-chart-rename-popover/customElement.js"), "messageOverrides:,name,open,referenceElement:;reposition"],
   "arcgis-charts-config-color-style": [() => import("./components/arcgis-charts-config-color-style/customElement.js"), "enableClose,header,messageOverrides:,open,selectedColor:"],
   "arcgis-charts-config-colors": [() => import("./components/arcgis-charts-config-colors/customElement.js"), "heading,messageOverrides:,rgba:"],
   "arcgis-charts-config-create-flow": [() => import("./components/arcgis-charts-config-create-flow/customElement.js"), "activeLayerId,calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,chartData:,disableEditing,filterBySelection,headerTitle,layerList:,messageOverrides:,modelList:,open,panelNumber,popoverPlacement,r2,selectedChartId,seriesColor:,syncChartsToLayers,timeZone,usePopupTemplateFieldsInfo;setFocus"],
@@ -31,26 +31,27 @@ const o = t(e, {
   "arcgis-charts-config-guide": [() => import("./components/arcgis-charts-config-guide/customElement.js"), "calculatedMinMaxBounds:,index,latestGuidePosition,messageOverrides:,model:,orientation,timeZone"],
   "arcgis-charts-config-guide-popover": [() => import("./components/arcgis-charts-config-guide-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedElement:;reposition"],
   "arcgis-charts-config-guides": [() => import("./components/arcgis-charts-config-guides/customElement.js"), "calculatedMinMaxBounds:,enableXAxisGuide,enableYAxisGuide,messageOverrides:,model:,open,timeZone"],
+  "arcgis-charts-config-guides-type-popover": [() => import("./components/arcgis-charts-config-guides-type-popover/customElement.js"), "enableXAxisGuide,enableYAxisGuide,messageOverrides:,open,placement,referenceElement:;reposition"],
   "arcgis-charts-config-histogram": [() => import("./components/arcgis-charts-config-histogram/customElement.js"), "calculatedMinMaxBounds:,chartData:,layer:,model:,page,seriesColor:,usePopupTemplateFieldsInfo"],
-  "arcgis-charts-config-histogram-data": [() => import("./components/arcgis-charts-config-histogram-data/customElement.js"), "countValue,layerFieldsInfo:,maxValue,meanValue,medianValue,messageOverrides:,minValue,model:,nullsValue,open,standardDevValue,sumValue"],
-  "arcgis-charts-config-histogram-popover": [() => import("./components/arcgis-charts-config-histogram-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,placement,referenceElement:,selectedBinColor:,selectedNumericField,selectedOverlaySymbol:,selectedTransformationType;reposition"],
+  "arcgis-charts-config-histogram-data": [() => import("./components/arcgis-charts-config-histogram-data/customElement.js"), "countValue,layerFieldsInfo:,maxValue,meanValue,medianValue,messageOverrides:,minValue,model:,nullsValue,open,selectedOverlaySymbolType,standardDevValue,sumValue"],
+  "arcgis-charts-config-histogram-popover": [() => import("./components/arcgis-charts-config-histogram-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,placement,referenceElement:,selectedBinColor:,selectedNumericField,selectedOverlaySymbol:,selectedOverlaySymbolType,selectedTransformationType;reposition"],
   "arcgis-charts-config-invalid-input-message": [() => import("./components/arcgis-charts-config-invalid-input-message/customElement.js"), "invalidInputMessage,isInvalid"],
   "arcgis-charts-config-line-chart": [() => import("./components/arcgis-charts-config-line-chart/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,seriesColor:,timeZone,usePopupTemplateFieldsInfo"],
-  "arcgis-charts-config-line-chart-data": [() => import("./components/arcgis-charts-config-line-chart-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:,open,resetTimeInterval:"],
+  "arcgis-charts-config-line-chart-data": [() => import("./components/arcgis-charts-config-line-chart-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:,resetTimeInterval:"],
   "arcgis-charts-config-line-chart-popover": [() => import("./components/arcgis-charts-config-line-chart-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,referenceElement:,selectedContent;reposition"],
-  "arcgis-charts-config-line-chart-series": [() => import("./components/arcgis-charts-config-line-chart-series/customElement.js"), "activeColorMatch,configSeriesOpen,messageOverrides:,model:,popoverPlacement"],
-  "arcgis-charts-config-line-chart-series-popover": [() => import("./components/arcgis-charts-config-line-chart-series-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedLineStyle,selectedLineWidth,selectedName;reposition"],
+  "arcgis-charts-config-line-chart-series": [() => import("./components/arcgis-charts-config-line-chart-series/customElement.js"), "activeColorMatch,messageOverrides:,model:,popoverPlacement"],
+  "arcgis-charts-config-line-chart-series-popover": [() => import("./components/arcgis-charts-config-line-chart-series-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedLineStyle,selectedLineWidth,selectedName,selectedSeriesIndex;reposition"],
   "arcgis-charts-config-line-style": [() => import("./components/arcgis-charts-config-line-style/customElement.js"), "enableClose,header,lineStyle:,messageOverrides:,open,usePanel"],
   "arcgis-charts-config-number-format": [() => import("./components/arcgis-charts-config-number-format/customElement.js"), "messageOverrides:,numberFormat:"],
   "arcgis-charts-config-pie-chart": [() => import("./components/arcgis-charts-config-pie-chart/customElement.js"), "calculatedMinMaxBounds:,chartData:,filterBySelection,layer:,model:,page,popoverPlacement,seriesColor:,usePopupTemplateFieldsInfo"],
-  "arcgis-charts-config-pie-chart-data": [() => import("./components/arcgis-charts-config-pie-chart-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:,open"],
+  "arcgis-charts-config-pie-chart-data": [() => import("./components/arcgis-charts-config-pie-chart-data/customElement.js"), "layerFieldsInfo:,messageOverrides:,model:"],
   "arcgis-charts-config-pie-chart-popover": [() => import("./components/arcgis-charts-config-pie-chart-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,referenceElement:,selectedContent;reposition"],
-  "arcgis-charts-config-pie-chart-slices": [() => import("./components/arcgis-charts-config-pie-chart-slices/customElement.js"), "chartData:,configSliceOpen,messageOverrides:,model:,popoverPlacement"],
-  "arcgis-charts-config-pie-chart-slices-popover": [() => import("./components/arcgis-charts-config-pie-chart-slices-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedName;reposition"],
+  "arcgis-charts-config-pie-chart-slices": [() => import("./components/arcgis-charts-config-pie-chart-slices/customElement.js"), "chartData:,messageOverrides:,model:,popoverPlacement"],
+  "arcgis-charts-config-pie-chart-slices-popover": [() => import("./components/arcgis-charts-config-pie-chart-slices-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedName,selectedSliceId;reposition"],
   "arcgis-charts-config-scatter-plot": [() => import("./components/arcgis-charts-config-scatter-plot/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,r2,usePopupTemplateFieldsInfo"],
-  "arcgis-charts-config-scatter-plot-data": [() => import("./components/arcgis-charts-config-scatter-plot-data/customElement.js"), "isTableLayer,layerFieldsInfo:,messageOverrides:,model:,open,r2"],
+  "arcgis-charts-config-scatter-plot-data": [() => import("./components/arcgis-charts-config-scatter-plot-data/customElement.js"), "isTableLayer,layerFieldsInfo:,messageOverrides:,model:,r2"],
   "arcgis-charts-config-scatter-plot-popover": [() => import("./components/arcgis-charts-config-scatter-plot-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,placement,referenceElement:,selectedContent;reposition"],
-  "arcgis-charts-config-select-chart-type-popover": [() => import("./components/arcgis-charts-config-select-chart-type-popover/customElement.js"), "headerTitle,layerId,messageOverrides:,open,popoverPlacement,popoverReferenceElement:,selectedModelType;reposition"],
+  "arcgis-charts-config-select-chart-type-popover": [() => import("./components/arcgis-charts-config-select-chart-type-popover/customElement.js"), "headerTitle,layerId,messageOverrides:,open,popoverPlacement,referenceElement:,selectedModelType;reposition"],
   "arcgis-charts-config-view-charts": [() => import("./components/arcgis-charts-config-view-charts/customElement.js"), "disableEditing,layer:,messageOverrides:,modelList:,noGroup,selectedChartId"]
 });
 export {

package/dist/model/box-plot-model/box-plot-model.d.ts

@@ -234,6 +234,24 @@ export declare class BoxPlotModel extends ChartModel {
      * @param {number} toIndex The index to move the category item to.
      */
     moveCustomSortValuesInOrderByList(fromIndex: number, toIndex: number): void;
+    /**
+     * Generate the proper chart title given the current config.
+     *
+     * @returns {string}
+     */
+    generateChartTitle(): Promise<string>;
+    /**
+     * Generate the proper x-axis title given the current config.
+     *
+     * @returns {string}
+     */
+    generateXAxisTitle(): string;
+    /**
+     * Generate the proper y-axis title given the current config.
+     *
+     * @returns {string}
+     */
+    generateYAxisTitle(): Promise<string>;
     /**
      * Resets the series styling to the default styling.
      */

package/dist/model/box-plot-model/utils/box-plot-data.d.ts

@@ -1,7 +1,6 @@
-import { BoxPlotConfig, ChartConfig } from '../../../utils';
+import { BoxPlotConfig, ChartConfig, CommonStrings } from '../../../utils';
 import { Color, WebChartBoxPlotSeries, WebChartDataFilters, WebChartLineChartSeries } from '@arcgis/charts-spec';
 import { LayerInfo, ModelTypes, BoxPlotDataSortingKinds } from '../../interfaces/common';
-import { ModelCommonStrings } from '../../t9n/common/interfaces';
 /**
  * Gets the category field.
  */
@@ -33,6 +32,18 @@ export declare const buildNewSeries: (props: {
  * Gets whether the values are standardized.
  */
 export declare const getStandardizeValues: (config: BoxPlotConfig) => boolean;
+/**
+ * Gets the proper Y-axis title label based on the chart configuration.
+ * @param {BoxPlotConfig} config - The box plot config
+ * @param {LayerInfo} layerInfo - The layer info
+ */
+export declare function getYAxisTitleLabel(config: BoxPlotConfig, layerInfo: LayerInfo): Promise<string>;
+/**
+ * Generates the proper chart title given the current config.
+ * @param {BoxPlotConfig} config - The box plot config
+ * @param {LayerInfo} layerInfo - The layer info
+ */
+export declare function getChartTitle(config: BoxPlotConfig, layerInfo: LayerInfo): Promise<string>;
 /**
  * Sets the category field by updating the config accordingly.
  */
@@ -55,7 +66,7 @@ export declare const getDefaultSeriesName: (props: {
     series: WebChartBoxPlotSeries | WebChartLineChartSeries;
     splitByField: string;
     layerInfo: LayerInfo;
-    commonStrings: ModelCommonStrings;
+    commonStrings: CommonStrings;
 }) => string;
 /**
  * Sets the split-by field by updating the config accordingly.

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

@@ -1,4 +1,4 @@
-import { Color, IDrawingInfo, LegendItemVisibility, SupportedLayer, WebChartTextSymbol } from '@arcgis/charts-spec';
+import { Color, IDrawingInfo, LegendItemVisibility, NumberFormatOptions, SupportedLayer, WebChartTextSymbol } from '@arcgis/charts-spec';
 import { ModelParams } from '../interfaces/chart-interfaces';
 import { LayerInfo, ModelTypes } from '../interfaces/common';
 import { ChartConfig, ChartSubType, ChartTypes } from '../../utils';
@@ -75,6 +75,12 @@ export declare abstract class ChartModel extends EventTarget {
      * **Note: This promise does not need to be awaited if the `setup` method has already been awaited. It is simply provided as a way to await the setup process from other functions if needed to avoid race conditions.**
      */
     setupFinished: Promise<void>;
+    /**
+     * Generate the proper chart title from the current config.
+     *
+     * @returns {string}
+     */
+    abstract generateChartTitle(): Promise<string>;
     /**
      * Gets the version of the chart configuration.
      * @returns {string}
@@ -275,6 +281,22 @@ export declare abstract class ChartModel extends EventTarget {
      * @returns {ChartSubType}
      */
     getChartSubType(): ChartSubType;
+    /**
+     * Gets the data tooltip value format for a series.
+     *
+     * If the series index is out of bounds or the series list is empty, this function will return `undefined`.
+     *
+     * @param {number} seriesIndex The index of the series to retrieve the value format for.
+     * @returns {NumberFormatOptions | undefined}
+     */
+    getDataTooltipValueFormat(seriesIndex: number): NumberFormatOptions | undefined;
+    /**
+     * Sets the data tooltip value format for a series.
+     *
+     * @param {number} seriesIndex The index of the series to set the value format for.
+     * @param {NumberFormatOptions | undefined} valueFormat The value format to set.
+     */
+    setDataTooltipValueFormat(seriesIndex: number, valueFormat: NumberFormatOptions | undefined): void;
     /**
      * Sets whether to fetch `null` values for them to be counted or displayed as categories on the chart.
      *

package/dist/model/chart-model/utils/data.d.ts

@@ -11,3 +11,9 @@ export declare const setFetchNULLValues: (fetchNULLValues: boolean, config: Char
  * @returns {boolean} Boolean value indicates whether NULL values will be fetched.
  */
 export declare const getFetchNULLValues: (config: ChartConfig) => boolean;
+/**
+ * Gets the split by values from the chart config.
+ * @param config The chart config.
+ * @returns {string[]} An array of split by values.
+ */
+export declare const getSplitByValues: (config: ChartConfig) => string[];

package/dist/model/chart-model/utils/series.d.ts

@@ -1,3 +1,4 @@
+import { WebChartSeriesType, NumberFormatOptions } from '@arcgis/charts-spec';
 import { ChartConfig } from '../../../utils';
 /**
  * Gets the series id from the config
@@ -15,3 +16,20 @@ export declare const getSeriesLength: (config: ChartConfig) => number;
  * Gets the visibility of a series from the config
  */
 export declare const getSeriesVisibility: (seriesIndex: number, config: ChartConfig) => boolean;
+/**
+ * Returns the data tooltip value format for a series.
+ * @param  {WebChartSeriesType[]} series The chart series
+ * @param {number} seriesIndex The index of the series to retrieve the value format for
+ */
+export declare function getDataTooltipValueFormat(series: WebChartSeriesType[], seriesIndex: number): NumberFormatOptions | undefined;
+/**
+ * Sets the data tooltip value format for a series.
+ * @param {WebChartSeriesType[]} props.series - The chart series
+ * @param {number} props.seriesIndex - The index of the series to set the value format for
+ * @param {NumberFormatOptions | undefined} props.valueFormat - The value format to set
+ */
+export declare function setDataTooltipValueFormat(props: {
+    series: WebChartSeriesType[];
+    seriesIndex: number;
+    valueFormat: NumberFormatOptions | undefined;
+}): void;

package/dist/model/gauge-model/gauge-model.d.ts

@@ -5,6 +5,12 @@ import { ModelParams } from '../interfaces/chart-interfaces';
 import { LayerInfo, ModelTypes } from '../interfaces/common';
 import { ModelWithBasicXAxis, ModelWithXGuides } from '../mixins';
 export declare class GaugeModel extends ChartModel {
+    /**
+     * Generate the proper chart title given the current config.
+     *
+     * @returns {string}
+     */
+    generateChartTitle(): Promise<string>;
     /**
      * Current configuration used for the histogram.
      */

package/dist/model/gauge-model/utils/gauge-data.d.ts

@@ -72,3 +72,8 @@ export declare const getEndAngle: (config: ChartConfig<typeof ModelTypes.Gauge>)
  * @param config The guage chart config
  */
 export declare const setEndAngle: (endAngle: number, config: ChartConfig<typeof ModelTypes.Gauge>) => void;
+/**
+ * Gets the proper chart title given the current config.
+ * @returns {string}
+ */
+export declare function getChartTitle(): Promise<string>;

package/dist/model/histogram-model/histogram-model.d.ts

@@ -142,6 +142,18 @@ export declare class HistogramModel extends ChartModel {
      * @param overlays The overlays
      */
     setSeriesOverlays(overlays: HistogramOverlays): void;
+    /**
+     * Generate the proper chart title given the current config.
+     *
+     * @returns {string}
+     */
+    generateChartTitle(): Promise<string>;
+    /**
+     * Generate the proper x-axis title given the current config.
+     *
+     * @returns {string}
+     */
+    generateXAxisTitle(): string;
     protected generateDefaultConfig(): Promise<Omit<typeof this._config, "iLayer">>;
 }
 export interface HistogramModel extends ModelWithXYAxes, ModelWithLegend, ModelWithTooltips, ModelWithColorMatch, ModelWithDataLabels, ModelWithYGuides {

package/dist/model/histogram-model/utils/histogram-data.d.ts

@@ -1,6 +1,10 @@
 import { HistogramOverlays, ISimpleFillSymbol, ISimpleLineSymbol, WebChartDataTransformations } from '@arcgis/charts-spec';
 import { HistogramConfig } from '../../../utils';
 import { LayerInfo } from '../../interfaces/common';
+/**
+ * Generate the proper chart title given the current config.
+ */
+export declare function getChartTitle(config: HistogramConfig, layerInfo: LayerInfo): Promise<string>;
 /**
  * Gets the numeric field from the config
  * @param config The histogram config
@@ -97,7 +101,7 @@ export declare const setStandardDevSymbol: (symbol: ISimpleLineSymbol, config: H
 export declare const getShowNormalDistOverlay: (config: HistogramConfig) => boolean;
 /**
  * Sets the show normal distribution overlay in the config
- * @param show Wheter to show the normal distribution overlay
+ * @param show Whether to show the normal distribution overlay
  * @param config The histogram config
  */
 export declare const setShowNormalDistOverlay: (show: boolean, config: HistogramConfig) => void;

package/dist/model/index.d.ts

@@ -8,7 +8,7 @@ export type * from './line-chart-model/line-chart-model.js';
 export type * from './radar-chart-model/radar-chart-model.js';
 export type * from './pie-chart-model/pie-chart-model.js';
 export type * from './pie-chart-model/pie-chart-legend-model.js';
-export type * from './scatter-plot-model/scatter-plot-model.js';
+export type * from './scatterplot-model/scatterplot-model.js';
 export type * from './serial-chart-model/serial-chart-model.js';
 export type * from './combo-bar-line-chart-model/combo-bar-line-chart-model.js';
 export type * from './interfaces/chart-interfaces.js';

package/dist/model/interfaces/common.d.ts

@@ -1,14 +1,14 @@
-import { IField, SupportedLayer, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartGaugeSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartTypes } from '@arcgis/charts-spec';
+import { IField, SupportedLayer, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartTypes } from '@arcgis/charts-spec';
+import { SupportedChartSeries } from '../../utils';
 import { BarChartModel } from '../bar-chart-model/bar-chart-model';
 import { BoxPlotModel } from '../box-plot-model/box-plot-model';
+import { ComboBarLineChartModel } from '../combo-bar-line-chart-model/combo-bar-line-chart-model';
+import { GaugeModel } from '../gauge-model/gauge-model';
 import { HistogramModel } from '../histogram-model/histogram-model';
 import { LineChartModel } from '../line-chart-model/line-chart-model';
 import { PieChartModel } from '../pie-chart-model/pie-chart-model';
-import { ScatterplotModel } from '../scatter-plot-model/scatter-plot-model';
-import { GaugeModel } from '../gauge-model/gauge-model';
-import { ComboBarLineChartModel } from '../combo-bar-line-chart-model/combo-bar-line-chart-model';
 import { RadarChartModel } from '../radar-chart-model/radar-chart-model';
-import { SupportedChartSeries } from '../../utils';
+import { ScatterplotModel } from '../scatterplot-model/scatterplot-model';
 export declare const SerialChartDataSortingKinds: {
     readonly xAxisAsc: "xAxisAsc";
     readonly xAxisDesc: "xAxisDesc";
@@ -96,7 +96,6 @@ export declare const GuideOrientation: {
 export type GuideOrientation = (typeof GuideOrientation)[keyof typeof GuideOrientation];
 export interface SplitByFieldInfos {
     categoriesArray: (number | string)[];
-    fieldName: string;
     splitByFieldType: string | undefined;
     numericalField: string;
 }
@@ -131,8 +130,9 @@ export declare const ModelTypes: {
     readonly Histogram: "histogram";
     readonly Gauge: "gauge";
     readonly RadarChart: "radarChart";
+    readonly HeatChart: "heatChart";
 };
 export type ModelTypes = (typeof ModelTypes)[keyof typeof ModelTypes];
-export type ModelTypeToSeriesType<T extends ModelTypes> = T extends typeof ModelTypes.BarChart ? WebChartBarChartSeries : T extends typeof ModelTypes.LineChart ? WebChartLineChartSeries : T extends typeof ModelTypes.ComboBarLineChart ? WebChartBarChartSeries | WebChartLineChartSeries : T extends typeof ModelTypes.BoxPlot ? WebChartBoxPlotSeries | WebChartLineChartSeries : T extends typeof ModelTypes.PieChart ? WebChartPieChartSeries : T extends typeof ModelTypes.Scatterplot ? WebChartScatterplotSeries : T extends typeof ModelTypes.Histogram ? WebChartHistogramSeries : T extends typeof ModelTypes.Gauge ? WebChartGaugeSeries : T extends typeof ModelTypes.RadarChart ? WebChartRadarChartSeries : SupportedChartSeries;
-export type SeriesTypeToChartType<T extends SupportedChartSeries> = T extends WebChartBarChartSeries ? typeof WebChartTypes.BarSeries : T extends WebChartLineChartSeries ? typeof WebChartTypes.LineSeries : T extends WebChartBoxPlotSeries ? typeof WebChartTypes.BoxPlotSeries : T extends WebChartPieChartSeries ? typeof WebChartTypes.PieSeries : T extends WebChartScatterplotSeries ? typeof WebChartTypes.ScatterSeries : T extends WebChartHistogramSeries ? typeof WebChartTypes.HistogramSeries : T extends WebChartGaugeSeries ? typeof WebChartTypes.GaugeSeries : T extends WebChartRadarChartSeries ? typeof WebChartTypes.RadarSeries : never;
-export type ModelOfType<T> = T extends typeof ModelTypes.BoxPlot ? BoxPlotModel : T extends typeof ModelTypes.LineChart ? LineChartModel : T extends typeof ModelTypes.ComboBarLineChart ? ComboBarLineChartModel : T extends typeof ModelTypes.PieChart ? PieChartModel : T extends typeof ModelTypes.Scatterplot ? ScatterplotModel : T extends typeof ModelTypes.Histogram ? HistogramModel : T extends typeof ModelTypes.Gauge ? GaugeModel : T extends typeof ModelTypes.RadarChart ? RadarChartModel : BarChartModel;
+export type ModelTypeToSeriesType<T extends ModelTypes> = T extends typeof ModelTypes.BarChart ? WebChartBarChartSeries : T extends typeof ModelTypes.LineChart ? WebChartLineChartSeries : T extends typeof ModelTypes.ComboBarLineChart ? WebChartBarChartSeries | WebChartLineChartSeries : T extends typeof ModelTypes.BoxPlot ? WebChartBoxPlotSeries | WebChartLineChartSeries : T extends typeof ModelTypes.PieChart ? WebChartPieChartSeries : T extends typeof ModelTypes.Scatterplot ? WebChartScatterplotSeries : T extends typeof ModelTypes.Histogram ? WebChartHistogramSeries : T extends typeof ModelTypes.Gauge ? WebChartGaugeSeries : T extends typeof ModelTypes.RadarChart ? WebChartRadarChartSeries : T extends typeof ModelTypes.HeatChart ? WebChartHeatChartSeries : SupportedChartSeries;
+export type SeriesTypeToChartType<T extends SupportedChartSeries> = T extends WebChartBarChartSeries ? typeof WebChartTypes.BarSeries : T extends WebChartLineChartSeries ? typeof WebChartTypes.LineSeries : T extends WebChartBoxPlotSeries ? typeof WebChartTypes.BoxPlotSeries : T extends WebChartPieChartSeries ? typeof WebChartTypes.PieSeries : T extends WebChartScatterplotSeries ? typeof WebChartTypes.ScatterSeries : T extends WebChartHistogramSeries ? typeof WebChartTypes.HistogramSeries : T extends WebChartGaugeSeries ? typeof WebChartTypes.GaugeSeries : T extends WebChartRadarChartSeries ? typeof WebChartTypes.RadarSeries : T extends WebChartHeatChartSeries ? typeof WebChartTypes.HeatChartSeries : never;
+export type ModelOfType<T> = T extends typeof ModelTypes.BoxPlot ? BoxPlotModel : T extends typeof ModelTypes.LineChart ? LineChartModel : T extends typeof ModelTypes.ComboBarLineChart ? ComboBarLineChartModel : T extends typeof ModelTypes.PieChart ? PieChartModel : T extends typeof ModelTypes.Scatterplot ? ScatterplotModel : T extends typeof ModelTypes.Histogram ? HistogramModel : T extends typeof ModelTypes.Gauge ? GaugeModel : T extends typeof ModelTypes.RadarChart ? RadarChartModel : T extends typeof ModelTypes.HeatChart ? never : BarChartModel;

package/dist/model/mixins/model-with-basic-x-axis.d.ts

@@ -83,4 +83,10 @@ export declare abstract class ModelWithBasicXAxis extends ChartModel {
      * @param {ISimpleLineSymbol | undefined} newAxisLinesSymbol - The new axis lines symbol.
      */
     setAxisLinesSymbol(newAxisLinesSymbol: ISimpleLineSymbol | undefined): void;
+    /**
+     * Generate the proper x-axis title from the current config.
+     *
+     * @returns {string}
+     */
+    abstract generateXAxisTitle(): string;
 }

package/dist/model/mixins/model-with-xy-axes.d.ts

@@ -179,6 +179,11 @@ export declare abstract class ModelWithXYAxes extends ModelWithBasicXAxis {
      * @param {ISimpleLineSymbol | undefined} linesSymbol The grid lines symbol.
      */
     setGridLinesSymbol(linesSymbol: ISimpleLineSymbol | undefined): void;
+    /**
+     * Get the default x-axis title text.
+     * @returns {Promise<string>}
+     */
+    getDefaultXAxisTitleText(): Promise<string>;
     /**
      * Gets the display zero line setting for the specified axis.
      * @param axisIndex The index of the axis to get the display zero line for.
@@ -317,4 +322,10 @@ export declare abstract class ModelWithXYAxes extends ModelWithBasicXAxis {
      * @param config The chart configuration object
      */
     setCursorCrosshair(cursorCrosshair: WebChartCursorCrosshair): void;
+    /**
+     * Generate the proper y-axis title from the current config.
+     *
+     * @returns {string}
+     */
+    abstract generateYAxisTitle(): Promise<string> | string;
 }

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

@@ -416,6 +416,12 @@ export declare class PieChartModel extends ChartModel {
      * @param optimize The optimize data labels overlapping setting for the pie chart.
      */
     setOptimizeDataLabelsOverlapping(optimize: boolean): void;
+    /**
+     * Generate the proper chart title given the current config.
+     *
+     * @returns {string}
+     */
+    generateChartTitle(): Promise<string>;
 }
 export interface PieChartModel extends PieChartLegendModel, ModelWithTooltips, ModelWithColorMatch, ModelWithDataLabels {
 }

package/dist/model/pie-chart-model/utils/pie-chart-data.d.ts

@@ -17,6 +17,17 @@ export declare const getNumericFields: (config: ChartConfig<typeof ModelTypes.Pi
  * Gets the aggregation type.
  */
 export declare const getAggregationType: (config: ChartConfig<typeof ModelTypes.PieChart>, mode: PieChartDataModes) => WebChartStatisticType;
+/**
+ * Gets the proper chart title given the current config.
+ * @param {ChartConfig<typeof ModelTypes.PieChart>} props.config - The chart config.
+ * @param {LayerInfo} props.layerInfo - The layer info.
+ * @param {PieChartDataModes} props.mode - The pie chart data mode.
+ */
+export declare function getChartTitle(props: {
+    config: ChartConfig<typeof ModelTypes.PieChart>;
+    layerInfo: LayerInfo;
+    mode: PieChartDataModes;
+}): Promise<string>;
 /**
  * Sets the sort order by updating the config accordingly.
  */

package/dist/model/scatterplot-model/scatterplot-model.d.ts

@@ -0,0 +1,107 @@
+import { ISimpleLineSymbol, ISimpleMarkerSymbol, WebChart, SizePolicy, ScatterplotOverlays } from '@arcgis/charts-spec';
+import { ChartConfig, XYChartTypes } from '../../utils';
+import { ModelParams } from '../interfaces/chart-interfaces';
+import { LayerInfo, ModelTypes } from '../interfaces/common';
+import { ChartModel } from '../chart-model/chart-model';
+import { ModelWithColorMatch, ModelWithDataLabels, ModelWithXGuides, ModelWithYGuides, ModelWithLegend, ModelWithXYAxes, ModelWithTooltips } from '../mixins';
+export declare class ScatterplotModel extends ChartModel {
+    /**
+     * Current configuration used for the scatterplot.
+     */
+    protected _config: ChartConfig<typeof ModelTypes.Scatterplot, WebChart>;
+    protected _chartType: XYChartTypes;
+    protected layerInfo: LayerInfo;
+    setup(params: ModelParams<ChartConfig<typeof ModelTypes.Scatterplot>>): Promise<void>;
+    /**
+     * Gets the x-axis field.
+     * @returns {string}
+     */
+    getXAxisField(): string;
+    /**
+     * Sets the x-axis field.
+     * @param {string} fieldName
+     * @async **This method is `async` and must be awaited for the changes to take effect.**
+     */
+    setXAxisField(fieldName: string): Promise<void>;
+    /**
+     * Gets the y-axis field.
+     * @returns {string}
+     */
+    getYAxisField(): string;
+    /**
+     * Sets the y-axis field.
+     * @param {string} fieldName
+     * @async **This method is `async` and must be awaited for the changes to take effect.**
+     */
+    setYAxisField(fieldName: string): Promise<void>;
+    /**
+     * Gets whether the linear trend line is shown.
+     * @returns {boolean}
+     */
+    getShowLinearTrend(): boolean;
+    /**
+     * Sets whether to show the linear trend line.
+     * @param {boolean} show
+     */
+    setShowLinearTrend(show: boolean): void;
+    /**
+     * Gets the line symbol for the linear trend line.
+     * @returns {ISimpleLineSymbol}
+     */
+    getLinearTrendSymbol(): ISimpleLineSymbol;
+    /**
+     * Sets the line symbol for the linear trend line.
+     * @param {ISimpleLineSymbol} symbol
+     */
+    setLinearTrendSymbol(symbol: ISimpleLineSymbol): void;
+    /**
+     * Gets the marker symbol used for the scatterplot points when using a fixed symbol (i.e. no size policy is set).
+     * @returns {ISimpleMarkerSymbol}
+     */
+    getFixedMarkerSymbol(): ISimpleMarkerSymbol;
+    /**
+     * Sets the marker symbol used for the scatterplot points when using a fixed symbol (i.e. no size policy is set).
+     * @param {ISimpleMarkerSymbol} symbol
+     */
+    setFixedMarkerSymbol(symbol: ISimpleMarkerSymbol): void;
+    /**
+     * Gets the size policy for the scatterplot points. This is used to scale the size of the marker symbol based on a given field.
+     * @returns {SizePolicy | undefined}
+     */
+    getSizePolicy(): SizePolicy | undefined;
+    /**
+     * Sets the size policy for the scatterplot points. This is used to scale the size of the marker symbol based on a given field.
+     * @param {SizePolicy | undefined} sizePolicy
+     */
+    setSizePolicy(sizePolicy: SizePolicy | undefined): void;
+    /**
+     * Gets the chart overlays. The scatterplot implements only 1 overlay, **trendLine**.
+     */
+    getSeriesOverlays(): ScatterplotOverlays | undefined;
+    /**
+     * Sets the chart overlays. The scatterplot implements only 1 overlay, **trendLine**.
+     * @param {ScatterplotOverlays} overlays The overlays
+     */
+    setSeriesOverlays(overlays: ScatterplotOverlays): void;
+    /**
+     * Generate the proper chart title given the current config.
+     *
+     * @returns {string}
+     */
+    generateChartTitle(): Promise<string>;
+    /**
+     * Generate the proper x-axis title given the current config.
+     *
+     * @returns {string}
+     */
+    generateXAxisTitle(): string;
+    /**
+     * Generate the proper y-axis title given the current config.
+     *
+     * @returns {string}
+     */
+    generateYAxisTitle(): string;
+    protected generateDefaultConfig(): Promise<Omit<typeof this._config, "iLayer">>;
+}
+export interface ScatterplotModel extends ModelWithXYAxes, ModelWithLegend, ModelWithTooltips, ModelWithColorMatch, ModelWithDataLabels, ModelWithXGuides, ModelWithYGuides {
+}