@arcgis/charts-components 5.0.0-next.5 → 5.0.0-next.51

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

@@ -1,4 +1,7 @@
-import { WebChart, WebChartSeriesType, RESTSymbolType, WebChartTypes, WebChartVersionStatus } from '../../../spec';
+import { ChartOptions } from '../../../chart-rendering/common/interfaces';
+import { IField, TimeIntervalInfo, WebBoxPlot, WebChart, WebChartSeriesType, RESTSymbolType, WebChartTypes, WebChartVersionStatus } from '../../../spec';
+import { DataUpdateDetails } from '../../data/interfaces';
+import { LimitBehavior } from '../../defaults/interfaces';
 import { ChartSubType } from '../../misc/interfaces';
 import { WebChartSeriesSupportingTemporalBinning } from './interfaces';
 /**
@@ -124,8 +127,276 @@ 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 | WebChart, newConfig: WebBoxPlot | WebChart): 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: WebChart, newConfig: WebChart): boolean;
+/**
+ * Compares two configs and indicates whether additional tooltip fields (only non-numeric) changed
+ *
+ * **NOTE**: (only for scatterplot)
+ *
+ * @param {WebChart} props.previousConfig The previous config
+ * @param {WebChart} props.newConfig The updated config
+ * @param {IField[]|undefined} 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 legend visibilty changed
+ *
+ * @param oldConfig The previous config
+ * @param newConfig The updated config
+ */
+export declare function hasHeatLegendConfigChanged(oldConfig: WebChart, newConfig: WebChart): 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: WebChart, newConfig: WebChart): 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: WebChart, newConfig: WebChart): 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: WebChart, newConfig: WebChart): 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;
+/**
+ * Determines if the series order has changed between the old and the new configs.
+ *
+ * @param oldConfig The previous chart config
+ * @param newConfig The new chart config
+ * @returns
+ */
+declare function hasSeriesOrderChanged(oldConfig: WebChart, newConfig: WebChart): boolean;
+/**
+ * Determines whether a sort by series is needed.
+ * A sort by series is needed when either the series order has changed or any of the series names have changed.
+ *
+ * @param oldConfig The previous chart config.
+ * @param newConfig The new chart config.
+ * @returns
+ */
+export declare function isSortBySeriesNeeded(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;
 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;
+    hasSeriesOrderChanged: typeof hasSeriesOrderChanged;
+    hasConfigSeriesNamesChanged: typeof hasConfigSeriesNamesChanged;
 };
 export {};

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

@@ -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,14 @@ export declare function validateWebChart(props: {
  * @param config The config to analyze
  */
 export declare function isPartialConfig(config?: WebChart): boolean;
+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/components/config-update.d.ts

@@ -1,23 +1,9 @@
+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';
-/**
- * Updates the legend position for a given WebChart config.
- * Returns the updated config.
- *
- * @param newLegendPosition
- * @param config
- */
-export declare function updateLegendPosition(newLegendPosition: WebChartLegendPositions, config?: WebChart): WebChart | undefined;
-/**
- * Updates the legend visibility for a given WebChart config.
- * Returns the updated config.
- *
- * @param visible
- * @param config
- */
-export declare function updateLegendVisibility(visible: boolean, config?: WebChart): WebChart | undefined;
+import { SupportedLayer, WebChart } from '../../spec';
+import { QueryObject } from '../../utils';
 /**
  * Resets the axes bounds.
  * Returns the updated config.
@@ -35,12 +21,23 @@ 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.layer The component's layer
  */
-export declare function addMissingSplitBySeries(component: ArcgisChart, config: WebChart | undefined, options: ChartOptions): Promise<void>;
+export declare function prepareConfigForRendering(props: {
+    creation: boolean;
+    configToAlter: WebChart | undefined;
+    chartContainer?: HTMLElement;
+    queryObject: QueryObject;
+    options: ChartOptions;
+    previousConfig?: WebChart | undefined;
+    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/watch-handlers.d.ts

@@ -1,37 +1,37 @@
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 /**
- * Adds a listener on the feature layer, so every time the definition expression (filter) is modified we update
+ * Adds a watch handler on the feature layer, so every time the definition expression (filter) is modified we update
  * the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFilterListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFilter(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the renderer is modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the renderer is modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerRendererListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerRenderer(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer view, so every time the view's extent is modified we update
+ * Adds a watch handler on the feature layer view, so every time the view's extent is modified we update
  * the chart.
  *
  * @param props.component The chart component
  */
-export declare function addExtentChangeListener(component: ArcgisChart): Promise<IHandle[] | undefined>;
+export declare function watchExtentChange(component: ArcgisChart): Promise<IHandle[] | undefined>;
 /**
- * Adds a listener on the view's time extent, so every time extent is modified we update the chart.
+ * Adds a watch handler on the view's time extent, so every time extent is modified we update the chart.
  * @param component The chart component
  */
-export declare function addViewTimeExtentListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchViewTimeExtent(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the fields are modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the fields are modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFieldsListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFields(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the layer's view; so every time the selection data is modified, we update the chart.
+ * Adds a watch handler on the layer's view; so every time the selection data is modified, we update the chart.
  * @param component The chart component
  */
-export declare function addSelectionsChangeInViewListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchSelectionsChangeInView(component: ArcgisChart): IHandle | undefined;

package/dist/utils/components/web-component-utils.d.ts

@@ -1,9 +1,9 @@
+import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
 import { CSVOptions } from '../../interfaces';
 import { ModelTypes } from '../../model';
 import { IField, SupportedLayer } from '../../spec';
-import { ChartConfig } from '../types';
-import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
 import { SupportedLocalesForFormats } from '../localization/interfaces';
+import { ChartConfig } from '../types';
 /**
  * A utility function to compare if a value has changed deeply.
  * @param value
@@ -97,3 +97,9 @@ export declare function transformBoxPlotData<T extends Record<string, unknown>>(
  * @param {unknown} date - The date to check, should be a string or a number.
  */
 export declare const isValidDate: (date: unknown) => date is Date | number | string;
+/**
+ * Returns a unique ID associated to a chart
+ *
+ * @param key A unique identifying the chart
+ */
+export declare function getChartUniqueInternalID(key: string): string;

package/dist/utils/data/index.d.ts

@@ -14,7 +14,7 @@ export declare function getBoxPlotStatisticFieldNames(y?: string): Record<BoxPlo
  * @param config the chart config
  * @default false
  */
-export declare function isGaugeByFeature(config: WebGaugeChart): boolean;
+export declare function isGaugeByFeature(config: WebChart): boolean;
 /**
  * From fetched data (type: WebChartDataTypes) returns the part containing the data that
  * is to be assigned to the chart (WebChartDataItem[] | WebChartBin[])

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

@@ -1,7 +1,6 @@
 import { WebChartDataTypes, WebChartQuery } from '../../spec';
 import { DataWarningKeywords } from '../chart-config/validator/interfaces';
 import { ChartSubType } from '../misc/interfaces';
-import { BinnedServerData } from './time-binning/interfaces';
 export interface DataMinMax {
     minY: number;
     maxY: number;
@@ -13,7 +12,6 @@ export interface DataInfo {
     invalidType?: DataWarningKeywords;
     count?: number;
     data?: WebChartDataTypes;
-    binnedServerData?: BinnedServerData;
     queryConfig?: WebChartQuery;
 }
 export declare const BoxPlotYFieldKeys: {
@@ -37,3 +35,33 @@ export interface BoxPlotYValueProps {
     showOutliers?: boolean;
     standardizeValues?: boolean;
 }
+export interface DataUpdateDetails {
+    common: {
+        queryChanged: boolean;
+        xOrYChanged: boolean;
+        numberOfSeriesChanged: boolean;
+        configFiltersChanged: boolean;
+        filterBySelectionChanged: boolean;
+        dataForFilterBySelectionChanged: boolean;
+        binTemporalDataChanged: boolean;
+        timeBinningChanged: boolean;
+        timeIntervalUnitChanged: boolean;
+        newTimeBinningWillBeCalculated: boolean;
+        valueFormatChangeRequiresNewData: boolean;
+    };
+    histogram: {
+        dataPropsChanged: boolean;
+    };
+    gauge: {
+        valueConversionChanged: boolean;
+    };
+    boxPlot: {
+        showMeanChanged: boolean;
+    };
+    heatChart: {
+        binningChanged: boolean;
+    };
+    scatterPlot: {
+        tooltipFieldsChanged: boolean;
+    };
+}

package/dist/utils/data/time-binning/interfaces.d.ts

@@ -14,10 +14,6 @@ export interface TimeBinningStatistics {
     dateRange: DateRange;
     numberOfFeatures: number;
 }
-export interface BinnedServerData {
-    data: WebChartDataItem[];
-    timeBinningStats: TimeBinningStatistics;
-}
 export interface GroupProps {
     binFirstOrLastIndex: number;
     data: WebChartDataItem[];

package/dist/utils/defaults/index.d.ts

@@ -1,6 +1,6 @@
 import { CategoryFormatOptions, Color, DateTimeFormatOptions, HistogramOverlays, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebChartStackedKinds, WebChartTypes } from '../../spec';
-import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 import { CommonStrings } from '../localization/interfaces';
+import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 export declare const histogramBinCount = 32;
 export declare const featuresExtentField = "arcgis_charts_features_extent";
 export declare const queryDefaults: QueryDefaults;

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

@@ -44,7 +44,7 @@ export interface QueryDefaults {
     maxParallelRequests: number;
     maxRecords: number;
     outStatistics: Readonly<IStatisticDefinition>;
-    uniqueIdsName: string;
+    uniqueIdsName: number | string;
     orderByJSAPIDelimiter: string;
 }
 export interface ChartTextProps {

package/dist/utils/layer/index.d.ts

@@ -1,7 +1,9 @@
-import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
+/// <reference types="@arcgis/core/interfaces.d.ts" />
 import { default as FeatureLayer } from '@arcgis/core/layers/FeatureLayer.js';
-import { default as SubtypeGroupLayer } from '@arcgis/core/layers/SubtypeGroupLayer';
+import { default as SubtypeGroupLayer } from '@arcgis/core/layers/SubtypeGroupLayer.js';
 import { default as Renderer } from '@arcgis/core/renderers/Renderer';
+import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView';
+import { IFeatureLayer, IField, SupportedLayer, WebChart, WebChartDataFilters, WebChartQuery } from '../../spec';
 import { IFeatureType, QueryObject, QueryObjectProps, RendererInfo, SubtypeInfo } from './interfaces';
 /**
  * Returns the renderer type and the field and normalization field if applicable.
@@ -38,7 +40,7 @@ export declare function getFieldFromName(fieldName: string, fields?: IField[]):
  * the field ID (every feature layer has one).
  * As a consequence the backup value returned if `oidField.name` is `undefined` doesn't matter because it will not happen.
  */
-export declare function getObjectIdField(layerFieldsInfo: IField[]): string;
+export declare function getObjectIdField(layerFieldsInfo?: IField[]): string;
 /**
  * Checks whether the given field has a valid numeric type.
  * Fields descriptions are [here](http://resources.esri.com/help/9.3/ArcGISEngine/ArcObjects/esriGeoDatabase/esriFieldType.htm).
@@ -145,6 +147,21 @@ export declare function findMatchingLayerFieldName(props: {
     fieldToMatch: string;
     returnUndefinedIfNotFound?: boolean;
 }): Promise<string>;
+/**
+ * Find the matching field in a list of fields based on the fieldToMatch parameter.
+ * It first looks for a perfect match (case-sensitive), then for an approximate match (case-insensitive).
+ * @param {IField[]} layerFieldList - The list of fields to search in.
+ * @param {string} fieldToMatch - The field name to match.
+ * @returns {IField | undefined} - The matching field if found, otherwise undefined.
+ *
+ * We look for a match in 2 steps:
+ *
+ * 1. Perfect match: the case of the fields is exactly the same. This helps when the layer has fields with the same name but with a
+ * different case (e.g. "field" and "FiElD"). Refer to https://devtopia.esri.com/WebGIS/arcgis-charts/issues/8305
+ *
+ * 2: Approximate match: we upper-case the fields to compare them
+ */
+export declare function findMatchingField(layerFieldList: IField[], fieldToMatch: string): IField | undefined;
 /**
  * Finds the matching layer fields for a list of fields.
  *
@@ -200,6 +217,32 @@ export declare function extractFieldsUsedInConfig(config: WebChart, layer: Suppo
  * @returns {string[]} The list of layer fields
  */
 export declare function extractFieldsFromConfigList(layer: SupportedLayer): Promise<string[]>;
+/**
+ * Finds the matching layer in the view based on the provided layer's portal item id.
+ * The matching is done based on the portalItem id.
+ * If no matching layer is found, returns `undefined`.
+ * @param {__esri.MapView | __esri.SceneView | undefined} props.view The map or scene view
+ * @param {string} props.portalItemId The portal item id of the layer
+ *
+ * @returns {FeatureLayerView | SupportedLayer | undefined} The matching layer in the view or undefined if not found
+ *
+ * @requires
+ * - view
+ * - portalItemId
+ *
+ * ```
+ *
+ * @example
+ * ```ts
+ * const matchingLayer = findMatchingLayerFromView({ view, portalItemId: 'abc123' });
+ * ```
+ *
+ * @category Public
+ */
+export declare function findMatchingLayerFromView(props: {
+    view?: __esri.MapView | __esri.SceneView;
+    portalItemId: string;
+}): FeatureLayerView | SupportedLayer | undefined;
 export declare const layerPrivateFunctions: {
     getServerRestInfo: typeof getServerRestInfo;
     getSubtypeName: typeof getSubtypeName;

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

@@ -6,6 +6,7 @@ export interface QueryObjectProps {
     chartConfig: WebChart;
     layer?: FeatureLayerView | SupportedLayer;
     view?: MapView | SceneView;
+    filterByExtent?: boolean;
 }
 export interface RendererInfo {
     rendererType?: RESTRendererType;