@arcgis/charts-components 5.0.0-next.13 → 5.0.0-next.131

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

@@ -1,6 +1,13 @@
-import { WebChart, WebChartSeriesType, RESTSymbolType, WebChartTypes, WebChartVersionStatus } from '../../../spec';
+import { ChartOptions } from '../../../chart-rendering/common/interfaces';
+import { DataUpdateDetails } from '../../data/interfaces';
+import { LimitBehavior } from '../../defaults/interfaces';
 import { ChartSubType } from '../../misc/interfaces';
 import { WebChartSeriesSupportingTemporalBinning } from './interfaces';
+import { WebChartTypes, WebChartVersionStatus } from '../../../spec/chart-object-literals';
+import { WebBoxPlot, WebChart, WebChartLegend, WebChartSeriesType, WebHeatChart } from '../../../spec/web-chart';
+import { RESTSymbolType } from '../../../spec/rest-js-object-literals';
+import { TimeIntervalInfo } from '../../../spec/data-source';
+import { IField } from '../../../spec/rest-js-types';
 /**
  * Retrieve and construct chart version information based on the input version and the currently supported ArcGIS Chart versions
  * defined in `chartConfigVersions`.  Returned information includes:
@@ -124,8 +131,300 @@ export declare function isSeriesUsingTimeBinning(props: {
  * @param series The series to test
  */
 export declare function doesSeriesSupportTemporalBinning(series: WebChartSeriesType): series is WebChartSeriesSupportingTemporalBinning;
+/**
+ * Compares the queries from two configs and indicates whether a query changed.  Noted that the query comparison
+ * includes the orderByFields from the orderOptions.
+ *
+ * A sort on the series is made before comparing to prevent a false positive on query reorder.
+ *
+ * @param props.previousConfig The former chart config
+ * @param props.newConfig The new chart config
+ * @param props.behaviorAfterLimit The chart's behavior once the data limit is reached
+ */
+declare function hasQueryChanged(props: {
+    previousConfig: WebChart;
+    newConfig: WebChart;
+    behaviorAfterLimit?: LimitBehavior;
+}): boolean;
+/**
+ * Compares two config data filters and returns true if they are identical, false otherwise
+ *
+ * @param previousConfig
+ * @param newConfig
+ */
+export declare function hasConfigFilterChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether the filter by selection was enabled or disabled
+ * @param previousFilterBySelection The previous valued for the filter by selection
+ * @param options The runtime options containing the new value for the filter by selection
+ */
+declare function hasFilterBySelectionChanged(previousFilterBySelection?: boolean, options?: ChartOptions): boolean;
+/**
+ * Compares the `binTemporalData` property from two configs and returns true if they are identical, false otherwise
+ *
+ * @param previousConfig
+ * @param newConfig
+ */
+declare function hasBinTemporalDataChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether a change of value format type requires new data. Two cases require it:
+ * - change from date format to numeric format
+ * - specific to non aggregated charts: change from category format to value format
+ *
+ * @param previousConfig The former chart config
+ * @param newConfig The new chart config
+ */
+declare function isNewDataRequiredForValueFormatChange(previousConfig: WebBoxPlot | WebChart, newConfig: WebBoxPlot | WebChart): boolean;
+/**
+ * Compares the `showMean` from two configs and indicates whether they are different
+ *
+ * @param previousConfig The former chart config
+ * @param newConfig The new chart config
+ */
+declare function hasShowMeanChanged(previousConfig: WebBoxPlot, newConfig: WebBoxPlot): boolean;
+/**
+ * Compares two gauge configs and indicates whether the series value conversion changed
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasGaugeValueConversionChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two heat chart configs to see if binning has changed
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+declare function hasHeatChartBinningChanged(previousConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compares two heat chart configs and indicates whether the hide empty rows and columns option changed
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatChartHideEmptyRowsAndColumnsChanged(previousConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compares two heat chart configs and indicates whether to include leap day
+ *
+ * @param previousConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatChartIncludeLeapDayChanged(previousConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether additional tooltip fields (only non-numeric) changed
+ *
+ * **NOTE**: Only applicable to scatterplot
+ *
+ * @param props.previousConfig - The previous config
+ * @param props.newConfig - The updated config
+ * @param props.fieldList - The layer field list
+ */
+export declare function hasAdditionalTooltipFieldsChanged(props: {
+    previousConfig: WebChart;
+    newConfig: WebChart;
+    fieldList?: IField[];
+}): boolean;
+/**
+ * Compares two configs and indicates whether the color type change
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasColorMatchChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether the stacked type changed
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ * @returns
+ */
+export declare function hasStackedTypeChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Normalizes the legend position
+ * @param legend The legend
+ * @returns The normalized legend
+ */
+export declare function normalizeLegendPosition(legend: WebChartLegend): WebChartLegend;
+/**
+ * Compares two configs and indicates whether the legend visibility changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatLegendConfigChanged(oldConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compates two configs and indicates whether the heat legend position changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatLegendPositionChanged(oldConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compares two configs and indicates whether the gradient rules changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasGradientRulesChanged(oldConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compares two configs and indicates whether the heat rules type changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatRulesTypeChanged(oldConfig: WebHeatChart, newConfig: WebHeatChart): boolean;
+/**
+ * Compares the 'slices' array from the pie series, and indicates whether they are different.
+ * Compare only the slices id and label to avoid false positives.
+ *
+ * @param props.oldConfig The previous chart config
+ * @param props.newConfig The newest chart config
+ */
+export declare function hasSlicesConfigChanged(props: {
+    oldConfig: WebChart;
+    newConfig: WebChart;
+}): boolean;
+export declare function hasDataForFilterBySelectionChanged(props: {
+    previousSelectionOIDs?: (number | string)[];
+    options?: ChartOptions;
+}): boolean;
+/**
+ * Compares the split by value for each series element in the box plot config and returns true if the series has different split by value between new and old box plot config, false otherwise.
+ *
+ * @param oldSeries The former series config
+ * @param newSeries The new series config
+ */
+export declare function hasSplitByValueChanged(oldSeries: WebChart["series"], newSeries: WebChart["series"]): boolean;
+/**
+ * Verify if the order of the numeric fields has changed
+ *
+ * @param oldSeries - The previous series config
+ * @param newSeries - The new series config
+ */
+export declare function hasNumericFieldsChanged(oldSeries: WebChart["series"], newSeries: WebChart["series"]): boolean;
+/**
+ * Returns true when the time interval info was set previously and are not in the new config
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasTimeIntervalInfoBeenReset(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when the dual axis feature was enabled or disabled (number of axes changed)
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasDualAxisChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when the series are not associated to the same axis anymore
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasSeriesAxisChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true when at least one guide's 'above' property changed from an update to another.
+ *
+ * @param oldConfig The old chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+export declare function hasAnyGuideAboveChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the rotated property changed since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasRotationChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the rotated property changed since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasOutliersVisibilityChanged(oldConfig: WebBoxPlot, newConfig: WebBoxPlot): boolean;
+/**
+ * Returns true if the 'standardizeValues' property changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasStandardizeValuesVisibilityChanged(oldConfig: WebBoxPlot, newConfig: WebBoxPlot): boolean;
+/**
+ * Returns true if the 'chartRenderer' property changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasChartRendererChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Returns true if the 'timeZone' property from the axis value format changed in the chart config since the previous update.
+ *
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasIntlTimeZoneChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether the size policy changed from the previous update
+ * @param oldConfig the old chart config
+ * @param newConfig the new chart config
+ */
+export declare function hasSizePolicyChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Indicates whether a series reinitialization is necessary due to size policy changes
+ * @param oldConfig The old chart config
+ * @param newConfig The new chart config
+ */
+export declare function doSizePolicyChangesRequireSeriesReinit(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Function saying if a data update is needed. We compare different properties from the former config and the new one
+ * in order to decide if the update is needed.
+ *
+ * @param props
+ */
+export declare function doesConfigChangeRequireNewData(props: {
+    previousConfig: WebBoxPlot | WebChart;
+    newConfig: WebBoxPlot | WebChart;
+    options?: ChartOptions;
+    previousFilterBySelection?: boolean;
+    previousTimeIntervalInfo?: TimeIntervalInfo;
+    previousSelectionOIDs?: (number | string)[];
+    fieldList?: IField[];
+}): {
+    dataUpdateNeeded: boolean;
+    dataUpdateDetails: DataUpdateDetails;
+};
+/**
+ * Determines if any of the series' name has changed between the previous and the new configs.
+ *
+ * The order of the series is preserved when comparing for changes.
+ *
+ * @param oldConfig The previous chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+declare function hasConfigSeriesNamesChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Sorts the series in the config based on the series sort options.
+ * When no sort option is provide, no sorting is performed.
+ *
+ * @param chartConfig The optional chart config to sort the series
+ * @param chartContainer The HTML chart container
+ * @returns The updated chart config with the series sorted, or undefined if the input config is undefined
+ */
+export declare function sortConfigSeries<T extends WebChart | undefined>(chartConfig: T, chartContainer?: HTMLElement): T;
+/** @private */
 export declare const chartConfigUtilsPrivateFunctions: {
     getPieChartChartSubType: typeof getPieChartChartSubType;
     getBarLineChartSubType: typeof getBarLineChartSubType;
+    hasQueryChanged: typeof hasQueryChanged;
+    hasFilterBySelectionChanged: typeof hasFilterBySelectionChanged;
+    hasBinTemporalDataChanged: typeof hasBinTemporalDataChanged;
+    hasGaugeValueConversionChanged: typeof hasGaugeValueConversionChanged;
+    isNewDataRequiredForValueFormatChange: typeof isNewDataRequiredForValueFormatChange;
+    hasShowMeanChanged: typeof hasShowMeanChanged;
+    hasHeatChartBinningChanged: typeof hasHeatChartBinningChanged;
+    hasConfigSeriesNamesChanged: typeof hasConfigSeriesNamesChanged;
 };
 export {};

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

@@ -1,3 +1,4 @@
-import { WebChartBarChartSeries, WebChartLineChartSeries, WebChartRadarChartSeries, WebChartTypes } from '../../../spec';
+import { WebChartTypes } from '../../../spec/chart-object-literals';
+import { WebChartBarChartSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from '../../../spec/web-chart';
 export type WebChartSeriesSupportingTemporalBinning = WebChartBarChartSeries | WebChartLineChartSeries | WebChartRadarChartSeries;
 export declare const webChartTypesSupportingTemporalBinning: (WebChartTypes | undefined)[];

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

@@ -1,8 +1,8 @@
-import { WebChart, WebGaugeChart } from '../../../spec';
 import { WebChartJSONSchemas } from '../../../json-schema';
 import { ErrorObject } from 'ajv';
 import { QueryObject } from '../../layer/interfaces';
 import { ConfigWarningObject, CustomErrorObject, ValidationStatus } from './interfaces';
+import { WebChart, WebGaugeChart } from '../../../spec/web-chart';
 /**
  * Extracts schema name from the schema `$ref` path
  * For e.g.:
@@ -61,16 +61,6 @@ declare function findWarnings(props: {
  * @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.
@@ -90,4 +80,15 @@ export declare function validateWebChart(props: {
  * @param config The config to analyze
  */
 export declare function isPartialConfig(config?: WebChart): boolean;
+/** @private */
+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;
+};
 export {};

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

@@ -1,11 +1,12 @@
 import { default as Ajv } from 'ajv';
-import { RESTFieldType, WebChartStatisticType } from '../../../spec';
 import { ErrorKeywords } from '../../errors/interfaces';
+import { RESTFieldType } from '../../../spec/rest-js-object-literals';
+import { WebChartStatisticType } from '../../../spec/chart-object-literals';
 export declare const ConfigWarningKeywords: {
     readonly NonNumericAggregation: "nonNumericAggregation";
     readonly DuplicateSeriesID: "duplicateSeriesId";
 };
-type ConfigWarningKeywords = (typeof ConfigWarningKeywords)[keyof typeof ConfigWarningKeywords];
+export type ConfigWarningKeywords = (typeof ConfigWarningKeywords)[keyof typeof ConfigWarningKeywords];
 interface NumericAggregationParams {
     fieldName: string;
     fieldType: RESTFieldType;
@@ -52,6 +53,7 @@ export declare const ConfigErrorKeywords: {
 export declare const DataWarningKeywords: {
     readonly BadData: "badData";
     readonly EmptyDataSet: "emptyDataSet";
+    readonly InvalidConfig: "invalidConfig";
     readonly HistogramEmptyField: "histogramEmptyField";
     readonly BarElementExceedsLimit: "barElementExceedsLimit";
     readonly LineChartExceedsLimit: "lineChartExceedsLimit";

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

@@ -5,8 +5,8 @@ import { ChartTypes, DefaultChartActions } from '../../utils';
 /**
  * Returns the default actions for a given chart type
  *
- * @param {ChartTypes} chartType The chart type for which to get the default actions
- * @returns {DefaultChartActions[]} The default actions for the given chart type
+ * @param props.chartType - The chart type for which to get the default actions
+ * @returns The default actions for the given chart type
  */
 export declare function getDefaultChartActions(chartType: ChartTypes | undefined): DefaultChartActions[];
 /**
@@ -19,10 +19,10 @@ 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 {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.
+ * @param props.actionBar - The action bar element to update.
+ * @param props.chartComponent - The chart component element.
+ * @param props.config - The configuration object for the chart.
+ * @param props.isWarningDisplayed - Optional flag to indicate if a warning is displayed.
  *
  */
 export declare function updateActionBarStates(props: {

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

@@ -1,6 +1,7 @@
 import { RESTSimpleLineSymbolStyle } from '../../spec';
-import { NumericFieldsChangeProps } from '../../interfaces';
+import { NumericFieldsChangeProps, WebChartCalendarTypes } from '../../interfaces';
 import { FormatKeys } from '../../model';
+import { HeatChartModel } from '../../model/heat-chart-model/heat-chart-model';
 export interface RGB {
     r: number;
     g: number;
@@ -17,9 +18,9 @@ export declare const DefaultStatNumberFormat: {
     readonly minimumFractionDigits: 0;
     readonly maximumFractionDigits: 3;
 };
-export declare const aggregationList: ("count" | "sum" | "min" | "max" | "avg" | "percentile-continuous" | "no_aggregation")[];
+export declare const aggregationList: ("avg" | "count" | "max" | "min" | "percentile-continuous" | "sum" | "no_aggregation")[];
 export declare const pieAggregationList: ("count" | "sum")[];
-export declare function getFormatIcon(formatKey: FormatKeys | undefined): string | undefined;
+export declare function getFormatIcon(formatKey: FormatKeys | undefined): HTMLCalciteIconElement["icon"] | undefined;
 /**
  * Validates a value entered in a numeric calcite-input.
  * Controls that the value is not undefined, not empty (invalid) and in between the [min, max] range if provided
@@ -85,30 +86,22 @@ export declare function sanitizeColor(color: RGB | undefined): RGB | null;
 /**
  * Handler for "keydown" event on numberic input element. Prevents input of "e" character.
  *
- * @param e Input element "keydown" event
+ * @param e - Input element "keydown" event
  */
 export declare const blockNumericE: (e: KeyboardEvent) => void;
 /**
- * emit numeric field change event
- *
- * @param props.pickListElement
- * @param props.eventEmitter
- * @param props.contentKind
- * @category Public
+ * Emit numeric field change event.
  */
 export declare const emitNumericFieldsChange: (props: NumericFieldsChangeProps) => void;
 /**
  * Returns the line style type based on the provided line style.
- *
- * @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
+ * @param objectURL - The data URL of the object to download.
+ * @param downloadString - The name of the file to download.
  */
 export declare function downloadFile(objectURL: string, downloadString: string): void;
 /**
@@ -118,3 +111,9 @@ export declare function downloadFile(objectURL: string, downloadString: string):
  * @returns Null return for caller to easily reset tooltip object to null
  */
 export declare function destroyTooltip(tooltip: HTMLCalciteTooltipElement | null | undefined): null;
+/**
+ * Gets the calendar type based on the heat chart model's temporal binning configuration.
+ * @param {HeatChartModel} model - The heat chart model.
+ * @returns {WebChartCalendarTypes | undefined} The calendar type, or undefined if not applicable.
+ */
+export declare function getCalendarType(model: HeatChartModel): WebChartCalendarTypes | undefined;

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

@@ -1,7 +1,10 @@
+import { default as Graphic } from '@arcgis/core/Graphic';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
 import { ChartOptions } from '../../chart-rendering/common/interfaces';
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
-import { SupportedLayer, WebChart, WebChartLegendPositions } from '../../spec';
+import { SupportedLayer } from '../../interfaces';
+import { WebBoxPlot, WebChart, WebChartLegendPositions } from '../../spec';
+import { QueryObject } from '../../utils';
 /**
  * Updates the legend position for a given WebChart config.
  * Returns the updated config.
@@ -18,6 +21,13 @@ export declare function updateLegendPosition(newLegendPosition: WebChartLegendPo
  * @param config
  */
 export declare function updateLegendVisibility(visible: boolean, config?: WebChart): WebChart | undefined;
+/**
+ * Updates the chart rotation for a given WebChart config.
+ * Returns the updated config.
+ * @param newRotation new rotation
+ * @param config the chart config
+ */
+export declare function updateRotation<T extends WebBoxPlot | WebChart>(newRotation: boolean, config?: T): T | undefined;
 /**
  * Resets the axes bounds.
  * Returns the updated config.
@@ -35,12 +45,26 @@ export declare function resetAxesBounds(config?: WebChart): WebChart | undefined
  */
 export declare function isValidDataSource(config?: WebChart, layer?: FeatureLayerView | SupportedLayer): boolean;
 /**
- * Will add missing series to the chart config if:
- * - the config uses a split-by field
- * - adding missing series was requested (through the `updateSplitBySeries` property)
- * - unique values for the given split-by field don't have a series associated
- *
- * @param component The chart component
- * @param options The runtime options
+ * Alters the providing config to prepare it for rendering:
+ * - add the iLayer if missing
+ * - convert it to the latest version
+ * @param props.configToAlter The config to alter
+ * @param props.chartContainer The chart container
+ * @param props.queryObject The query object
+ * @param props.options The runtime options
+ * @param props.updateSplitBySeries The updateSplitBySeries property
+ * @param props.addMissingSeries Whether to add missing series for split-by charts
+ * @param props.layer The component's layer
  */
-export declare function addMissingSplitBySeries(component: ArcgisChart, config: WebChart | undefined, options: ChartOptions): Promise<void>;
+export declare function prepareConfigForRendering(props: {
+    configToAlter: WebChart | undefined;
+    chartContainer?: HTMLElement;
+    queryObject: QueryObject;
+    options: ChartOptions;
+    updateSplitBySeries: ArcgisChart["updateSplitBySeries"];
+    addMissingSeries: boolean;
+    layer: ArcgisChart["layer"];
+}): Promise<{
+    alteredConfig: ArcgisChart["config"];
+    preFetchedQueryResponse?: Graphic[];
+}>;

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

@@ -0,0 +1,36 @@
+import { ChartOptions } from '../../chart-rendering/common/interfaces';
+import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
+import { IField, WebChart } from '../../spec';
+import { DataUpdateDetails } from '../data/interfaces';
+import { SelectionData } from '../misc/interfaces';
+/**
+ * Indicates whether a data update is needed based on the changed properties.
+ * Checks for:
+ * - specific properties that require a data update when changed,
+ * - change of layer type (FeatureLayer to FeatureLayerView or vice-versa),
+ * - changes in the config that require a data update.
+ * @param props.config The current chart config
+ * @param props.previousConfig The previous chart config
+ * @param props.dataUpdateNeededProps The list of properties that require a data update when changed
+ * @param props.updatedProps A map of the properties that have been updated with their old and new values
+ * @param props.filterBySelection The current filterBySelection value
+ * @param props.previousSelectionOIDs The previous selection OIDs
+ * @param props.chartData The current chart data
+ * @param props.options The current chart options
+ * @param props.fieldList The list of fields in the layer or feature layer view
+ * @returns
+ */
+export declare function isDataUpdateNeeded(props: {
+    config: WebChart | undefined;
+    previousConfig: WebChart | undefined;
+    dataUpdateNeededProps: ArcgisChart["dataUpdateNeededProps"];
+    updatedProps: ArcgisChart["updatedProps"];
+    filterBySelection: ArcgisChart["filterBySelection"];
+    previousSelectionOIDs: SelectionData["selectionOIDs"];
+    chartData: ArcgisChart["chartData"];
+    options: ChartOptions;
+    fieldList: IField[];
+}): {
+    dataUpdateNeeded: boolean;
+    dataUpdateDetails: DataUpdateDetails | undefined;
+};

package/dist/utils/components/error-modal-utils.d.ts

@@ -0,0 +1,22 @@
+import { WebChart, WebGaugeChart } from '../../spec';
+import { ValidationStatus } from '../chart-config/validator/interfaces';
+import { ErrorStrings } from '../localization/interfaces';
+/**
+ * Validates the `WebChart` config and displays the `Errors` and `Warnings` them in the chart popup.
+ * Both `Errors` and `Warnings` are non-dismissible.
+ *
+ * @param props.chart The chart
+ * @param props.chartConfig The optional chart config
+ * @param props.createMessage The optional error and warning to be displayed
+ * @param props.status The validation status containing details about why the config is invalid
+ * @param props.errorStrings The t9n error strings
+ */
+export declare function generateWarningForInvalidConfig(props: {
+    chartConfig?: WebChart | WebGaugeChart;
+    createMessage?: string;
+    status: ValidationStatus;
+    errorStrings: ErrorStrings;
+}): {
+    title: string;
+    message: string;
+};

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

@@ -1,9 +1,12 @@
 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 '../../spec';
 import { JsxNode } from '@arcgis/lumina';
+import { ChartModel } from '../../model/chart-model/chart-model';
+import { PieSlicesSymbols, SelectionData, SeriesSymbolsMap } from '../misc/interfaces';
+import { WebChartDataTypes } from '../../spec/data-source';
+import { CalculatedMinMaxBoundsPayload, LegendItemVisibility } from '../../spec/events';
+import { WebChartLegendPositions } from '../../spec/chart-object-literals';
+import { DefaultChartActions } from '../types/index';
 export type PanelNumberChangePayload = {
     panelNumber: number;
     modelList: ChartModel[];
@@ -12,9 +15,6 @@ export type DataChangeErrorPayload = {
     error: Error;
     model: ChartModel;
 };
-export type PopoverOpenChangePayload = {
-    open: boolean | undefined;
-};
 export type PopoverChangePayload = {
     open: boolean | undefined;
     element: JsxNode;

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

@@ -1,5 +1,5 @@
-import { SupportedCharts } from '../../utils';
-import { WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from '../../spec';
+import { WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from '../../spec/web-chart';
+import { SupportedCharts } from '../misc';
 /** Supported chart types. */
 export declare const supportedChartTypes: SupportedCharts[];
 export declare const maximumNumberOfSimultaneousUpdates = 1;

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

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