@arcgis/charts-components 4.34.0-next.9 → 4.34.0-next.90

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

@@ -1,5 +1,389 @@
-import { SupportedLayer, WebChart, WebGaugeChart } from '@arcgis/charts-spec';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { SupportedLayer, WebBoxPlot, WebChart, WebChartBoxPlotSeries, WebChartDirectionalDataOrder, WebChartLineChartSeries, WebGaugeChart, WebChartOrderDataByTypes } from '@arcgis/charts-spec';
+import { 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.3.0:
+ * - Rename the subTitle property to subtitle
+ * @param configToUpdate The chart's config to update
+ * @returns
+ */
+declare function convertTo23x3x0(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;
+    convertTo23x3x0: typeof convertTo23x3x0;
+    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/action-bar-utils.d.ts

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

@@ -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,5 +1,5 @@
 import { SupportedLayer, WebChart, WebChartLegendPositions } from '@arcgis/charts-spec';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { ChartOptions } from '../../chart-rendering/common/interfaces';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 /**
@@ -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,3 +1,5 @@
+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';
@@ -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/message-utils.d.ts

@@ -1,9 +1,9 @@
-import { ErrorStrings } from '../../utils';
 import { WebChartTypes } from '@arcgis/charts-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;