@arcgis/charts-components 4.34.0-next.51 → 4.34.0-next.52

package/dist/loader.js

@@ -2,7 +2,7 @@ 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.51 */
+v4.34.0-next.52 */
 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"],

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';
@@ -275,6 +275,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/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.js

@@ -3,7 +3,7 @@ import { a as p, e as W, i as x, g as S, b as g, r as y, h as K, l as P, m as c,
 import { c as A } from "./chunks/setup-utils.js";
 /*! 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.51 */
+v4.34.0-next.52 */
 export {
   i as BoxPlotDataSortingKinds,
   e as ColorFormatKeys,

package/dist/test/chart-rendering/test-utils/utils.d.ts

@@ -14,7 +14,7 @@ export declare function getPrivateFunction<T>(privateFunctionFolder: string, fun
  * @param functionName The function to mock
  * @param mockedImplementation The mocked implementation
  */
-export declare function mockPrivateFunction(privateFunctionFolder: string, functionName: string, mockedImplementation: any): void;
+export declare function mockPrivateFunction(privateFunctionFolder: string, functionName: string, mockedImplementation: any): Promise<void>;
 /**
  * Resets the mocked implementation of a specific private function
  *

package/dist/test/utils/test-utils/utils.d.ts

@@ -1,18 +1,10 @@
-/**
- * Provides an access to a private function, considering its source patch and name.
- * This is possible thanks to the plugin `babel-plugin-rewire-ts`.
- * See more info: https://github.com/rosswarren/babel-plugin-rewire-ts.
- * @param privateFunctionFolder The folder under src containing the private function
- * @param functionName The function's name
- */
-export declare function getPrivateFunction(functionFolder: string, functionName: string): any;
 /**
  * Provides a way to mock a function from the src folder.
  * @param functionFolder The folder under src containing the private function
  * @param functionName The function to mock
  * @param mockedImplementation The mocked implementation
  */
-export declare function mockFunction(functionFolder: string, functionName: string, mockedImplementation: any): void;
+export declare function mockFunction(functionFolder: string, functionName: string, mockedImplementation: any): Promise<void>;
 /**
  * Resets the mocked implementation of a specific private function
  * @param functionFolder The folder under src containing the private function

package/dist/utils/chart-config/converter/index.d.ts

@@ -1,5 +1,389 @@
-import { SupportedLayer, WebChart, WebGaugeChart } from '@arcgis/charts-spec';
+import { SupportedLayer, WebBoxPlot, WebChart, WebChartBoxPlotSeries, WebChartDirectionalDataOrder, WebChartLineChartSeries, WebGaugeChart, WebChartOrderDataByTypes } from '@arcgis/charts-spec';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { FormerWebChartBoxPlotDataSortTypes, FormerWebChartDataValueTypes } from './interfaces';
+/**
+ * Matches the config properties that have field names which mismatch the layer data source fields.
+ *
+ * @param {*} config The chart config
+ * @param {*} layer The layer instance
+ * @returns {Promise<WebChart>}
+ */
+declare function matchChartFieldsToLayerFields(configToUpdate: WebChart, layer?: SupportedLayer): Promise<WebChart>;
+/**
+ * This function will
+ * - Copy the optional `showOutliers` property from the series to the chart object (if not already defined)
+ * - Copy the optional `standardizeValues` property from the series to the chart object (if not already defined)
+ * - Construct the `sortDataBy` property for Pro box-plot, if present, based on what's provided at the first series level
+ *
+ * - Delete the series `showOutliers`
+ * - Delete the series `standardizeValues`
+ *
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function moveBoxPlotSeriesPropsToChart(configToUpdate: WebBoxPlot): WebBoxPlot;
+/**
+ * Constructs the `orderType` and `orderBy` of the `orderOptions.data` for box-plot, based on what's provided in the Pro box-plot series config
+ * @param seriesConfig
+ * @returns A object of type WebChartDirectionalDataOrder, with default values set to `Category` and `Ascending`
+ */
+declare function getProBoxPlotSortDataOption(seriesConfig: WebChartBoxPlotSeries | WebChartLineChartSeries): WebChartDirectionalDataOrder;
+/**
+ * Detects whether a config is a box plot config with mean lines from Pro. They follow a different structure than ours,
+ * by having a series of outStatistics on the line series.
+ * @param config The config to test
+ */
+declare function isBoxPlotConfigWithMeanLinesFromPro(config: WebBoxPlot): boolean;
+/**
+ * This function will
+ * - Construct the `orderOptions.data` property for Pro box-plot
+ * - Fill in the series `x` field for box plot, if empty, with `defaultBoxPlotCategory`
+ * - Delete the query `outStatistics` from all the series
+ * - Delete the query `orderByFields` from all the series
+ * - Handle the box plot with mean lines from Pro that follow a different spec
+ * @param configToUpdate The chart's config to update
+ * @returns the updated config
+ */
+declare function adjustBoxPlotConfig(configToUpdate: WebBoxPlot): WebBoxPlot;
+/**
+ * Copies the information from the config.dataSource.layer into the newest config.iLayer
+ * @param configToUpdate The config to update
+ */
+declare function convertDataSourceToILayer(configToUpdate: WebChart): WebChart;
+/**
+ * Prevents multiple objects to have the same id. This avoids a chart created with amCharts v5 to crash.
+ * @param configToUpdate The config to update
+ */
+declare function preventDuplicatedIds(configToUpdate: WebChart): WebChart;
+/**
+ * This function renames the orderByFields field name from `arcgis_charts_pie_category_from_fields_name`
+ * to `defaultPieFromFieldsName` (or `arcgis_charts_pie_from_fields_name`)
+ * @param configToUpdate The chart's config to update
+ */
+declare function adjustPieFromFieldsDefaultNameAndValue(configToUpdate: WebChart): WebChart;
+/**
+ * Moves the series[x].query.extent to config.dataFilters.geometry, and delete
+ * the extent properties from all the series query.
+ * @param configToUpdate The chart's config to update
+ */
+declare function moveSeriesQueryExtent(configToUpdate: WebChart): WebChart;
+/**
+ * For charts that offer rotation feature, this function will
+ * - Move the optional `rotated` property  from the series to the chart object
+ * if the chart object does not contain this property.
+ * - Remove all series' rotated property.
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function moveSeriesRotatedPropToChart(configToUpdate: WebChart): WebChart;
+/**
+ * In version 5.0.0 we modified property names in the config dataSource
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function renameDataSourceProperties(configToUpdate: WebChart): WebChart;
+/**
+ * In version 6.0.0 we removed the property config.dataSource.filter, replaced by config.dataFilters.where
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function copyDataSourceFilterToConfig(configToUpdate: WebChart): WebChart;
+/**
+ * This function returns the equivalent boolean value for the previous
+ * "originalValue" and "label" values for the sortLabelsBy property.
+ *
+ * @param previousType The previous value of the sortLabelsBy property
+ * @returns false if the previous value was "originalValue"; otherwise true
+ */
+declare function convertWebChartDataValueTypes(previousType?: FormerWebChartDataValueTypes | string): boolean;
+/**
+ * v15.0.0
+ * Converts Boxplot's previous version's sortDataBy.sortType property value to a new value of type WebChartOrderDataByTypes;
+ *
+ * @param previousType Boxplot's previous value of the sortDataBy.sortType property
+ * @returns the converted value of type WebChartOrderDataByTypes or undefined if the previous value is not recognized
+ */
+declare function convertBoxplotOldToNewDataSortType(previousType?: FormerWebChartBoxPlotDataSortTypes): WebChartOrderDataByTypes | undefined;
+/**
+ * For Pie chart, this function will:
+ * - Copy the optional `sortLabelsBy` property from the pie series to the chart object (if not already defined)
+ * - Delete the pie series `sortLabelsBy`
+ *
+ * Notes:
+ * From version 15.0.0 onward, the chart's `sortLabelsBy` property not longer exists.  However, the removal of it
+ * is handled in the `handleOrderOptionsChanges()` function.
+ *
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function movePieSeriesSortLabelsPropToChart(configToUpdate: WebChart): WebChart;
+/**
+ * For charts that offer different types of stacking series, this function will
+ * - Move the optional `stackedType` property  from the series to the chart object
+ * if the chart object does not contain this property.
+ * - Remove all series' stackedType property.
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function moveSeriesStackedTypePropToChart(configToUpdate: WebChart): WebChart;
+/**
+ * For the orderOptions.series property, it was previously a string, now it's an object with an order property (among other properties).
+ * @param configToUpdate config to update
+ * @returns the updated config
+ */
+declare function convertSortSeriesByToObject(configToUpdate: WebChart): WebChart;
+/**
+ * Set the chart's colorMatch property to the evaluated value from the series's colorType, if colorMatch is not defined.
+ * Delete the series' colorType property afterward, if present.
+ *
+ * @param configToUpdate config to update
+ * @returns
+ */
+declare function handleColorMatchChanges(configToUpdate: WebChart): WebChart;
+/**
+ * For Box-plot:
+ * - Move the `sortDataBy` property from the chart level to be a property of the `orderOptions.data`.
+ * @param configToUpdate The chart's config to update
+ * @returns The updated config
+ */
+declare function moveBoxPlotSortDataByProp(configToUpdate: WebBoxPlot): WebBoxPlot;
+/**
+ * Moves the boolean `scrollbarVisible` into the newer `scrollbar.visible` property
+ *
+ * @param configToUpdate config to update
+ */
+declare function moveScrollbarVisible(configToUpdate: WebChart): WebChart;
+/**
+ * v15.0.0
+ * This function will:
+ * - Analyze what the query's orderByFields is made off and decide whether to:
+ *   - move it to the chart's `orderOptions.orderByFields`
+ *   - or convert it to the chart's `orderOptions.data` (if it's a single field that matches either x or y)
+ * - Delete the `orderByFields` from all the series
+ * @param configToUpdate The chart's config to update
+ * @returns the updated config
+ */
+declare function moveOrConvertSeriesOrderByFieldsToChartOrderOptions(configToUpdate: WebChart): WebChart;
+/**
+ * v15.0.0
+ * Translates the `orderByFields`, if presents, to the data order object `orderType` and `orderBy` (WebChartDirectionalDataOrder).
+ * This function should only be called for non- box-plot charts.
+ * @param chartConfig The chart configuration
+ * @returns An object of type WebChartDirectionalDataOrder or undefined if no orderByFields is present in the config.
+ * Only WebChartDirectionalDataOrder is returned (but not WebChartPredefinedLabelsDataOrder) because WebChartPredefinedLabelsDataOrder was just introduced in v15.0.0
+ */
+declare function getDataOrderFromOrderByFields(chartConfig: WebChart): WebChartDirectionalDataOrder | undefined;
+/**
+ * v15.0.0
+ * When the old `sortLabelsBy` property is present and equal to "originalValue", we don't create the orderOptions.data
+ * Otherwise, if the new 'orderOptions.data` and/or 'orderOptions.series` is not present, this function will:
+ * - create or change the chart's `sortOptions` to `orderOptions`
+ * - convert the`sortOptions.sortDataBy` property to `orderOptions.data`
+ * - remove the `sortOptions.sortLabelsBy` property.  If this property is defined and equal to "originalValue", we don't set the orderOptions.data
+ * - convert the `sortOptions.sortSeriesBy` property to `orderOptions.series`
+ * - remove the `sortOptions` and `sortLabelsBy` properties afterward, regardless of whether any conversion took place
+ *
+ * @param configToUpdate The chart config to update
+ * @returns the updated chart config
+ */
+declare function handleOrderOptionsChanges(configToUpdate: WebChart): WebChart;
+/**
+ * For from fields charts (like PieFromFields or BarLineFromFields), if there is an `orderByFields` property,
+ * we convert it to the `orderOptions.data` property; and then remove the `orderByFields` property.
+ * @param configToUpdate Config to update
+ * @returns the updated chart config
+ */
+declare function applyDataOrderInstructionForFromFieldsCharts(configToUpdate: WebChart): WebChart;
+/**
+ * Converts temporal binning properties from the old pattern to the new pattern introduced in version 19.0.0.
+ * Former pattern:
+ *       "timeIntervalSize": 8,
+ *       "timeIntervalUnits": "esriTimeUnitsMonths",
+ *       "timeAggregationType": "equalIntervalsFromStartTime",
+ *       "trimIncompleteTimeInterval": true,
+ *       "nullPolicy": "null"
+ * New pattern:
+ *       "temporalBinning": {
+ *         "size": 8,
+ *         "unit": "month",
+ *         "timeAggregationType": "equalIntervalsFromStartTime",
+ *         "trimIncompleteTimeInterval": true,
+ *         "nullPolicy": "null"
+ *       }
+ * @param configToUpdate
+ * @param configToUpdate Config to update
+ * @returns the updated chart config
+ */
+declare function convertTemporalBinningProps(configToUpdate: WebChart): WebChart;
+declare function convertRESTStatisticTypeToWebChartStatisticType(configToUpdate: WebChart): WebChart;
+/**
+ * renames the subtitle property to subTitle if it exists
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function renameChartSubtitle(configToUpdate: WebChart): WebChart;
+/** **********************************************************************************************************
+ *                                                                                                          *
+ * Conversion functions to be called in `convertChartSpec()`                                      *
+ * For ease of maintenance, it's recommended to name the functions as `convertTo<major>x<minor>x<patch>()` *
+ *                                                                                                          *
+ *********************************************************************************************************** */
+declare function convertTo1x0x0(configToUpdate: WebChart, layer?: SupportedLayer): Promise<WebChart>;
+/**
+ * Conversions for 1.0.1:
+ *   - orderByField adjustment for PieFromFields
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo1x0x1(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 2.0.0:
+ *   - Removing the 'spacing' property from the gauge config
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo2x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 3.5.0:
+ *   - Moving the extent from the first series query to the config data filters geometry
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo3x5x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 4.0.1:
+ *   - Moving the rotated property from the first series to the chart object.
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo4x0x1(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 5.0.0:
+ *   - Renaming the datasource properties.
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo5x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 7.0.0:
+ *   - Copying the removed config.dataSource.filter to config.dataFilters.where
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo7x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 7.6.0:
+ *   - Move the `SortLabelsBy` property from the Pie series to the chart object.
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo7x6x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 8.0.1:
+ *  - Convert the `sortSeriesBy` property from a string to an object
+ * @param configToUpdate The chart's config to update
+ * @returns The converted config
+ */
+declare function convertTo8x0x1(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 9.3.0:
+ * - Set the chart's colorMatch property using the evaluated value from series' colorType, if needed.
+ * - Remove the series' colorType property if present.
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo9x3x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 10.0.0:
+ * - Moves the boolean `scrollbarVisible` into the newer `scrollbar.visible` property
+ * @param configToUpdate The chart's config to update
+ */
+declare function convertTo10x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 11.0.0:
+ *  - Move the `sortDataBy` property for Box-plot from the chart level to be a property of the `orderOptions`.
+ *  - Change the value of the `sortLabelsBy` property from "modifiedValue" to "label", if needed
+ * @param configToUpdate The chart's config to convert
+ * @returns The converted config
+ */
+declare function convertTo11x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for 12.0.0:
+ * - Move the series stackedType property to the chart object
+ * @param configToUpdate The chart's config to update
+ */
+declare function convertTo12x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for v15.0.0:
+ * - remove 'sortLabelsBy' and 'sortOptions' properties
+ * - use `orderOptions.data` and `orderOptions.series` properties for all chart
+ * @param configToUpdate The chart's config to update
+ */
+declare function convertTo15x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversions for v16.1.0:
+ * - converts the config dataSource property to an iLayer property
+ * @param configToUpdate The chart's config to update
+ */
+declare function convertTo16x1x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v16.0.1:
+ * when there is an orderByFields in the orderOptions,
+ * - add data order instruction for from fields charts,
+ * - move the orderByFields from the orderOptions
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo16x1x1(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v19.0.0:
+ * convert WebChartLabelBehavior.None -> WebChartLabelBehavior.Hide
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo19x0x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v20.2.0:
+ * Convert the temporal binning properties from the old pattern to the new pattern.
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo20x2x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v21.1.0:
+ * Transforms the values from the former interface RESTStatisticType to the new interface WebChartStatisticType.
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo21x1x0(configToUpdate: WebChart): WebChart;
+/**
+ * Conversion for v23.2.0:
+ * - Rename the subTitle property to subtitle
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo23x2x0(configToUpdate: WebChart): WebChart;
+/**
+ * Apply the needed function calls depending on the current chart version.
+ * Note: Additional switch cases and convertToxxx functions are to be added to this function accordingly.
+ * For example: if a newer spec version "X.Y.Z" has been released, considering the former version is "E.F.G" and the one before "A.B.C"
+ * 1. Case 1: the new spec version "X.Y.Z" requires a conversion:
+ *   1a. Create a new function called `convertToXxYxZ()`
+ *   1b. Have additional subroutines if needed to be called inside the `convertToXxYxZ()`
+ *   1c. Add a new case to the switch for the former version "E.F.G" that calls the new `convertToXxYxZ()`
+ *   1d. Add a call to `convertToXxYxZ()` in the block testing if the versions to convert includes the first web map version or an unrecognized one
+ * 2. Case 2: a conversion is not required
+ *   2a. Rename the function `convertToExFxG()` into `convertToXxYxZ()`
+ *   2b. Change the switch case "A.B.C" calling `convertToExFxG()` into a switch case "E.F.G" calling `convertToXxYxZ()`
+ *
+ * @param props.versionsToConvert a list of chart versions to be converted.
+ * @param props.configToUpdate the input chart config
+ * @returns the converted chart config
+ */
+declare function applyConversions<T extends WebChart>(props: {
+    versionsToConvert: string[];
+    configToUpdate: T | undefined;
+}): T;
 /**
  * Main function that converts the chart config with older chart JSON Schema, comparing to the current version.
  *
@@ -14,3 +398,54 @@ import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLa
  * @returns the updated web chart config.
  */
 export declare function convertChartSpec<T extends WebChart | WebGaugeChart>(config?: T, layerOrLayerView?: FeatureLayerView | SupportedLayer): Promise<T>;
+export declare const chartConfigConverterPrivateFunctions: {
+    matchChartFieldsToLayerFields: typeof matchChartFieldsToLayerFields;
+    moveSeriesQueryExtent: typeof moveSeriesQueryExtent;
+    moveSeriesRotatedPropToChart: typeof moveSeriesRotatedPropToChart;
+    renameDataSourceProperties: typeof renameDataSourceProperties;
+    copyDataSourceFilterToConfig: typeof copyDataSourceFilterToConfig;
+    adjustPieFromFieldsDefaultNameAndValue: typeof adjustPieFromFieldsDefaultNameAndValue;
+    moveBoxPlotSeriesPropsToChart: typeof moveBoxPlotSeriesPropsToChart;
+    movePieSeriesSortLabelsPropToChart: typeof movePieSeriesSortLabelsPropToChart;
+    getProBoxPlotSortDataOption: typeof getProBoxPlotSortDataOption;
+    isBoxPlotConfigWithMeanLinesFromPro: typeof isBoxPlotConfigWithMeanLinesFromPro;
+    preventDuplicatedIds: typeof preventDuplicatedIds;
+    adjustBoxPlotConfig: typeof adjustBoxPlotConfig;
+    convertSortSeriesByToObject: typeof convertSortSeriesByToObject;
+    moveBoxPlotSortDataByProp: typeof moveBoxPlotSortDataByProp;
+    handleColorMatchChanges: typeof handleColorMatchChanges;
+    moveScrollbarVisible: typeof moveScrollbarVisible;
+    moveSeriesStackedTypePropToChart: typeof moveSeriesStackedTypePropToChart;
+    convertBoxplotOldToNewDataSortType: typeof convertBoxplotOldToNewDataSortType;
+    getDataOrderFromOrderByFields: typeof getDataOrderFromOrderByFields;
+    convertWebChartDataValueTypes: typeof convertWebChartDataValueTypes;
+    moveOrConvertSeriesOrderByFieldsToChartOrderOptions: typeof moveOrConvertSeriesOrderByFieldsToChartOrderOptions;
+    handleOrderOptionsChanges: typeof handleOrderOptionsChanges;
+    applyDataOrderInstructionForFromFieldsCharts: typeof applyDataOrderInstructionForFromFieldsCharts;
+    convertTemporalBinningProps: typeof convertTemporalBinningProps;
+    convertRESTStatisticTypeToWebChartStatisticType: typeof convertRESTStatisticTypeToWebChartStatisticType;
+    renameChartSubtitle: typeof renameChartSubtitle;
+    convertTo1x0x0: typeof convertTo1x0x0;
+    convertTo1x0x1: typeof convertTo1x0x1;
+    convertTo2x0x0: typeof convertTo2x0x0;
+    convertTo3x5x0: typeof convertTo3x5x0;
+    convertTo4x0x1: typeof convertTo4x0x1;
+    convertTo5x0x0: typeof convertTo5x0x0;
+    convertTo7x0x0: typeof convertTo7x0x0;
+    convertTo7x6x0: typeof convertTo7x6x0;
+    convertTo8x0x1: typeof convertTo8x0x1;
+    convertTo9x3x0: typeof convertTo9x3x0;
+    convertTo10x0x0: typeof convertTo10x0x0;
+    convertTo11x0x0: typeof convertTo11x0x0;
+    convertTo12x0x0: typeof convertTo12x0x0;
+    convertTo15x0x0: typeof convertTo15x0x0;
+    convertTo16x1x0: typeof convertTo16x1x0;
+    convertTo16x1x1: typeof convertTo16x1x1;
+    convertTo19x0x0: typeof convertTo19x0x0;
+    convertTo20x2x0: typeof convertTo20x2x0;
+    convertTo21x1x0: typeof convertTo21x1x0;
+    convertTo23x2x0: typeof convertTo23x2x0;
+    applyConversions: typeof applyConversions;
+    convertDataSourceToILayer: typeof convertDataSourceToILayer;
+};
+export {};

package/dist/utils/chart-config/utils/index.d.ts

@@ -81,6 +81,16 @@ export declare function normalizeWhereClause(props: {
     normalize?: boolean;
     escape?: boolean;
 }): string;
+/**
+ * Gets the query type for the pie.
+ * @param series the pie series
+ */
+declare function getPieChartChartSubType(series: WebChartSeriesType[]): ChartSubType;
+/**
+ * Gets the query type for bar/line chart.
+ * @param series the bar/line series
+ */
+declare function getBarLineChartSubType(series: WebChartSeriesType[]): ChartSubType;
 /**
  * Gets the query type for box plot chart.
  * @param seriesConfig the box plot series config
@@ -114,3 +124,8 @@ export declare function isSeriesUsingTimeBinning(props: {
  * @param series The series to test
  */
 export declare function doesSeriesSupportTemporalBinning(series: WebChartSeriesType): series is WebChartSeriesSupportingTemporalBinning;
+export declare const chartConfigUtilsPrivateFunctions: {
+    getPieChartChartSubType: typeof getPieChartChartSubType;
+    getBarLineChartSubType: typeof getBarLineChartSubType;
+};
+export {};

package/dist/utils/chart-config/validator/index.d.ts

@@ -1,6 +1,76 @@
 import { WebChart, WebGaugeChart } from '@arcgis/charts-spec';
+import { WebChartJSONSchemas } from '@arcgis/charts-spec/json-schema';
+import { ErrorObject } from 'ajv';
 import { QueryObject } from '../../layer/interfaces';
-import { ValidationStatus } from './interfaces';
+import { ConfigWarningObject, CustomErrorObject, ValidationStatus } from './interfaces';
+/**
+ * Extracts schema name from the schema `$ref` path
+ * For e.g.:
+ *   - "#/definitions/WebChartInlineDataSource" => "WebChartInlineDataSource"
+ *   - "#/definitions/WebChartBarChartSeries" => "WebChartBarChartSeries"
+ * @param schemaRefPath
+ */
+declare function extractSchemaNameFromRefPath(schemaRefPath: string): string;
+/**
+ * Formats specific error messages based on the error keyword.
+ * @param errors Array storing the errors met during the validation
+ */
+declare function customizeValidationErrors(errors: ErrorObject[]): Promise<ErrorObject[]>;
+/**
+ * By default, the JSON schema created by ac-spec is suitable for WebChart validation.
+ * If we want to validate any other object, an appropriate schema can be generated via this function.
+ * @param schema
+ * @param schemaKey
+ */
+declare function createStartingSchema(schema: typeof WebChartJSONSchemas, schemaKey: keyof typeof WebChartJSONSchemas.definitions): typeof WebChartJSONSchemas;
+/**
+ * Tests whether a layer can be loaded.
+ * @param queryObject The query object (layer or feature layer view)
+ */
+declare function findLayerLoadError(queryObject: QueryObject): Promise<CustomErrorObject | undefined>;
+/**
+ * Check whether there exists a `StatisticDefinition` in any series' `Query` where non-count aggregation is applied to a non-numeric field
+ * @param props.seriesConfigs The series config list
+ * @param props.queryObject The query object
+ * @param props.allowUsingObjectIdStat Whether to allow using the object id field as a statistic field
+ */
+declare function findNumericAggregationWarnings(props: {
+    seriesConfigs: WebChart["series"];
+    queryObject: QueryObject;
+    allowUsingObjectIdStat?: boolean;
+}): Promise<ConfigWarningObject[]>;
+/**
+ * Verifies that the chart series are unique. Sets a message to display if not.
+ * @param chartConfig The chart config
+ */
+declare function findDuplicateSeriesIDWarnings(chartConfig?: WebChart): Promise<ConfigWarningObject[]>;
+/**
+ * Look for issues of level 'warning' in the chart config.
+ * @param props.input The input config
+ * @param props.queryObject The query object
+ * @param props.allowUsingObjectIdStat Whether to allow using the object id field as a statistic field
+ */
+declare function findWarnings(props: {
+    input: WebChart;
+    queryObject: QueryObject;
+    allowUsingObjectIdStat?: boolean;
+}): Promise<ConfigWarningObject[]>;
+/**
+ * Look for specific errors independent from the JSON schema.
+ * @param queryObject The query object
+ * @param chartConfig The chart config
+ */
+declare function findCustomErrors(queryObject?: QueryObject, chartConfig?: WebChart | WebGaugeChart): Promise<CustomErrorObject[]>;
+export declare const chartConfigValidatorPrivateFunctions: {
+    findCustomErrors: typeof findCustomErrors;
+    findWarnings: typeof findWarnings;
+    findNumericAggregationWarnings: typeof findNumericAggregationWarnings;
+    findDuplicateSeriesIDWarnings: typeof findDuplicateSeriesIDWarnings;
+    findLayerLoadError: typeof findLayerLoadError;
+    createStartingSchema: typeof createStartingSchema;
+    extractSchemaNameFromRefPath: typeof extractSchemaNameFromRefPath;
+    customizeValidationErrors: typeof customizeValidationErrors;
+};
 /**
  * Validates the `WebChart` config by checking for  and displays `Errors` and `Warnings`.
  * - `Errors` are violations in the config w.r.t the JSON schema.
@@ -20,3 +90,4 @@ export declare function validateWebChart(props: {
  * @param config The config to analyze
  */
 export declare function isPartialConfig(config?: WebChart): boolean;
+export {};

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

@@ -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>;