@arcgis/charts-components 5.2.0-next.12 → 5.2.0-next.120

package/dist/interfaces.d.ts

@@ -1,19 +1,79 @@
 import type FeatureLayer from "@arcgis/core/layers/FeatureLayer.js";
+import type Layer from "@arcgis/core/layers/Layer.js";
 import type SubtypeSublayer from "@arcgis/core/layers/support/SubtypeSublayer.js";
 import type ImageryLayer from "@arcgis/core/layers/ImageryLayer.js";
 import type ImageryTileLayer from "@arcgis/core/layers/ImageryTileLayer.js";
 import type WCSLayer from "@arcgis/core/layers/WCSLayer.js";
+import type FeatureLikeLayerView from "@arcgis/core/views/layers/FeatureLikeLayerView.js";
 import type { EventEmitter } from "@arcgis/lumina";
 import type { SupportedLocale } from "@arcgis/toolkit/intl";
 import type { WebChartTemporalBinningUnits } from "./spec/chart-object-literals.js";
 import type { List as List } from "@esri/calcite-components/components/calcite-list";
 
-/** Supported layer types for feature charts. */
-export type SupportedLayer = FeatureLayer | SubtypeSublayer;
+/**
+ * Supported layer types for feature charts.
+ *
+ * @deprecated since 5.2 - Use [ChartLayer](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayer) or [ChartLayerInput](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayerInput) instead.
+ */
+export type SupportedLayer = ChartLayer | SubtypeSublayer;
 
-/** Supported layer types for imagery charts. */
+/**
+ * Supported layer types for imagery charts.
+ *
+ * @deprecated since 5.2 - use [ChartLayerInput](https://developers.arcgis.com/javascript/latest/references/charts-components/interfaces/#ChartLayerInput) instead.
+ */
 export type SupportedRasterLayer = ImageryLayer | ImageryTileLayer | WCSLayer;
 
+/** FeatureLayer-like surface used by charts & model. */
+export type ChartLayer = Layer
+  & {
+  type: Layer["type"];
+  id: FeatureLayer["id"];
+  url?: FeatureLayer["url"];
+  fields: FeatureLayer["fields"];
+  fieldsIndex: FeatureLayer["fieldsIndex"];
+  capabilities: FeatureLayer["capabilities"];
+  sourceJSON?: FeatureLayer["sourceJSON"];
+  objectIdField: FeatureLayer["objectIdField"];
+  outFields: FeatureLayer["outFields"];
+  load: Layer["load"];
+  queryFeatures: FeatureLayer["queryFeatures"];
+  queryFeatureCount: FeatureLayer["queryFeatureCount"];
+  queryObjectIds: FeatureLayer["queryObjectIds"];
+  queryAttributeBins: FeatureLayer["queryAttributeBins"];
+  createQuery: FeatureLayer["createQuery"];
+  getFieldDomain?: FeatureLayer["getFieldDomain"];
+  renderer?: FeatureLayer["renderer"];
+  layerId?: FeatureLayer["layerId"];
+  isTable?: FeatureLayer["isTable"];
+  title?: FeatureLayer["title"];
+  popupTemplate?: FeatureLayer["popupTemplate"];
+  definitionExpression?: FeatureLayer["definitionExpression"];
+  fullExtent?: FeatureLayer["fullExtent"];
+  portalItem?: FeatureLayer["portalItem"];
+  charts?: FeatureLayer["charts"];
+  dateFieldsTimeZone?: FeatureLayer["dateFieldsTimeZone"];
+  version?: FeatureLayer["version"];
+  uniqueIdFields?: FeatureLayer["uniqueIdFields"];
+};
+
+/** Layer input accepted by chart components and models. */
+export type ChartLayerInput = ChartLayer | ChartLayerView | ImageryLayer | ImageryTileLayer | SubtypeSublayer | SupportedLayer | SupportedRasterLayer | WCSLayer;
+
+/** Layer inputs accepted by chart models. Excludes ChartLayerView because models operate on layers rather than views. */
+export type ChartLayerInputSansView = Exclude<ChartLayerInput, ChartLayerView>;
+
+/** Feature-like layer-view contract accepted by chart components for client-side queries. */
+export interface ChartLayerView {
+  get layer(): ChartLayer;
+  view: FeatureLikeLayerView["view"];
+  queryObjectIds: FeatureLikeLayerView["queryObjectIds"];
+  queryFeatureCount: FeatureLikeLayerView["queryFeatureCount"];
+  queryFeatures: FeatureLikeLayerView["queryFeatures"];
+  dataUpdating: FeatureLikeLayerView["dataUpdating"];
+  updating: FeatureLikeLayerView["updating"];
+}
+
 export interface IntervalPopoverProps {
   size: number;
   unit: WebChartTemporalBinningUnits;
@@ -175,27 +235,25 @@ export type ButtonDirections = (typeof ButtonDirections)[keyof typeof ButtonDire
  */
 export interface CSVOptions {
   /**
-   * Explicit list of columns to export.
-   * If not provided, all columns will be exported.
+   * An array of columns to include. Each string should correspond to a property name in the data objects.
+   * By default all columns will be exported.
    */
   columns?: string[];
-  /** Field delimiter. */
+  /** The delimiter to use. Defaults to a comma (`,`). */
   delimiter?: string;
-  /** Whether to include the header row in the CSV. */
+  /** Whether to include the header row. Defaults to `true`. */
   includeHeader?: boolean;
-  /** Whether to quote all fields. */
+  /** Whether to quote all values. Defaults to `false`. */
   quoteAll?: boolean;
   /**
-   * Locale used for formatting numbers in the CSV. This affects how numbers are formatted, such as decimal and thousands separators.
-   * If not provided, the default locale will be used.
+   * Locale used for formatting numbers (decimal and thousands separators) in the CSV. Defaults to `en`.
    *
-   * Supported locales include:
-   * `"ar"`, `"ar-u-nu-latn"`, `"bs"`, `"bg"`, `"ca"`, `"cs"`, `"da"`, `"de"`, `"el"`, `"en"`, `"en-US"`, `"es"`, `"et"`, `"fi"`, `"fr"`, `"he"`, `"hr"`, `"hu"`, `"id"`, `"it"`, `"ja"`, `"ko"`, `"lt"`, `"lv"`, `"no"`, `"nl"`, `"pl"`, `"pt-BR"`, `"pt-PT"`, `"ro"`, `"ru"`, `"sr"`, `"sl"`, `"sk"`, `"sv"`, `"th"`, `"tr"`, `"uk"`, `"vi"`, `"zh-CN"`, `"zh-HK"`, `"zh-TW"`
+   * Supported locales: `"ar"`, `"ar-u-nu-latn"`, `"bs"`, `"bg"`, `"ca"`, `"cs"`, `"da"`, `"de"`, `"el"`, `"en"`, `"en-US"`, `"es"`, `"et"`, `"fi"`, `"fr"`, `"he"`, `"hr"`, `"hu"`, `"id"`, `"it"`, `"ja"`, `"ko"`, `"lt"`, `"lv"`, `"no"`, `"nl"`, `"pl"`, `"pt-BR"`, `"pt-PT"`, `"ro"`, `"ru"`, `"sr"`, `"sl"`, `"sk"`, `"sv"`, `"th"`, `"tr"`, `"uk"`, `"vi"`, `"zh-CN"`, `"zh-HK"`, `"zh-TW"`.
    */
   locale?: SupportedLocale;
   /**
-   * Number of decimal places to round numeric values to in the CSV.
-   * If not provided, numbers will be rounded using the highest number of decimal places found in the data.
+   * Number of decimal places to round numeric values to.
+   * By default numbers will be rounded using the highest number of decimal places found in the data.
    */
   roundDecimals?: number;
 }

package/dist/json-schema/index.d.ts

@@ -2268,6 +2268,7 @@
                 };
             };
             required: string[];
+            description: string;
             deprecated: string;
             title: string;
         };
@@ -4949,15 +4950,24 @@
         WebChartDataItemValue: {
             anyOf: ({
                 type: string;
-                format: string;
+                items: {
+                    type: string[];
+                    $ref?: undefined;
+                };
+                format?: undefined;
                 $ref?: undefined;
+                not?: undefined;
+            } | {
+                type: string;
+                format: string;
                 items?: undefined;
+                $ref?: undefined;
                 not?: undefined;
             } | {
                 $ref: string;
                 type?: undefined;
-                format?: undefined;
                 items?: undefined;
+                format?: undefined;
                 not?: undefined;
             } | {
                 type: string;
@@ -4979,16 +4989,16 @@
                 not?: undefined;
             } | {
                 type: string;
+                items?: undefined;
                 format?: undefined;
                 $ref?: undefined;
-                items?: undefined;
                 not?: undefined;
             } | {
                 not: {};
                 type?: undefined;
+                items?: undefined;
                 format?: undefined;
                 $ref?: undefined;
-                items?: undefined;
             })[];
             title: string;
         };
@@ -5068,6 +5078,28 @@
             description: string;
             title: string;
         };
+        WebChartGaugeChartDataItem: {
+            type: string;
+            properties: {
+                dataItems: {
+                    type: string;
+                    items: {
+                        $ref: string;
+                    };
+                };
+                calculatedAxisMinimum: {
+                    type: string;
+                };
+                calculatedAxisMaximum: {
+                    type: string;
+                };
+                gaugeValue: {
+                    type: string;
+                };
+            };
+            required: string[];
+            title: string;
+        };
         ScatterplotTrendLineData: {
             type: string;
             properties: {
@@ -5143,6 +5175,10 @@
                     type: string;
                     description: string;
                 };
+                chartLimitsReached: {
+                    type: string;
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -5151,8 +5187,14 @@
         WebChartBin: {
             type: string;
             properties: {
+                type: {
+                    type: string;
+                    const: string;
+                    description: string;
+                };
                 count: {
                     type: string;
+                    description: string;
                 };
                 minValue: {
                     type: string;
@@ -5170,6 +5212,13 @@
                     type: string;
                     description: string;
                 };
+                arcgisChartsUniqueIds: {
+                    type: string;
+                    items: {
+                        type: string[];
+                    };
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -5550,6 +5599,16 @@
                     description: string;
                 };
                 symbol: {
+                    $ref: string;
+                    description: string;
+                    deprecated: string;
+                };
+                fillSymbol: {
+                    $ref: string;
+                    description: string;
+                    default: string;
+                };
+                markerSymbol: {
                     $ref: string;
                     description: string;
                     default: string;
@@ -8173,6 +8232,24 @@
                     };
                     description: string;
                 };
+                roundCorners: {
+                    type: string;
+                    properties: {
+                        rounded: {
+                            type: string;
+                            description: string;
+                            default: boolean;
+                        };
+                        cornerRadius: {
+                            type: string;
+                            description: string;
+                            minimum: number;
+                            multipleOf: number;
+                        };
+                    };
+                    required: string[];
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -8300,6 +8377,24 @@
                     };
                     description: string;
                 };
+                roundCorners: {
+                    type: string;
+                    properties: {
+                        rounded: {
+                            type: string;
+                            description: string;
+                            default: boolean;
+                        };
+                        cornerRadius: {
+                            type: string;
+                            description: string;
+                            minimum: number;
+                            multipleOf: number;
+                        };
+                    };
+                    required: string[];
+                    description: string;
+                };
                 innerRadius: {
                     type: string[];
                     description: string;
@@ -8447,6 +8542,24 @@
                     };
                     description: string;
                 };
+                roundCorners: {
+                    type: string;
+                    properties: {
+                        rounded: {
+                            type: string;
+                            description: string;
+                            default: boolean;
+                        };
+                        cornerRadius: {
+                            type: string;
+                            description: string;
+                            minimum: number;
+                            multipleOf: number;
+                        };
+                    };
+                    required: string[];
+                    description: string;
+                };
                 showOutliers: {
                     type: string;
                     description: string;
@@ -8587,6 +8700,24 @@
                     };
                     description: string;
                 };
+                roundCorners: {
+                    type: string;
+                    properties: {
+                        rounded: {
+                            type: string;
+                            description: string;
+                            default: boolean;
+                        };
+                        cornerRadius: {
+                            type: string;
+                            description: string;
+                            minimum: number;
+                            multipleOf: number;
+                        };
+                    };
+                    required: string[];
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -8722,6 +8853,24 @@
                     };
                     description: string;
                 };
+                roundCorners: {
+                    type: string;
+                    properties: {
+                        rounded: {
+                            type: string;
+                            description: string;
+                            default: boolean;
+                        };
+                        cornerRadius: {
+                            type: string;
+                            description: string;
+                            minimum: number;
+                            multipleOf: number;
+                        };
+                    };
+                    required: string[];
+                    description: string;
+                };
                 hideEmptyRowsAndColumns: {
                     type: string;
                     description: string;
@@ -8741,11 +8890,11 @@
             description: string;
             title: string;
         };
-        "Omit<(structure-1066060463-59771-61514-1066060463-59696-61515-1066060463-55801-61517-1066060463-0-64570|undefined)937098756,(\"data\"|\"orderByFields\")>": {
+        "Omit<(structure-1066060463-60438-62181-1066060463-60363-62182-1066060463-56468-63370-1066060463-0-66423|undefined)937098756,(\"data\"|\"orderByFields\")>": {
             $ref: string;
             title: string;
         };
-        "Pick<(structure-1066060463-59771-61514-1066060463-59696-61515-1066060463-55801-61517-1066060463-0-64570|undefined)937098756,Exclude<(\"series\"|\"data\"|\"orderByFields\"),(\"data\"|\"orderByFields\")>>": {
+        "Pick<(structure-1066060463-60438-62181-1066060463-60363-62182-1066060463-56468-63370-1066060463-0-66423|undefined)937098756,Exclude<(\"series\"|\"data\"|\"orderByFields\"),(\"data\"|\"orderByFields\")>>": {
             type: string;
             properties: {
                 series: {

package/dist/loader.js

@@ -1,9 +1,9 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
 import { r as e } from "./chunks/runtime.js";
 import { makeDefineCustomElements as t } from "@arcgis/lumina";
-const r = t(e, {
-  "arcgis-chart": [() => import("./components/arcgis-chart/customElement.js"), "_messages:,actionMode,allowUsingObjectIdStat,animationEnabled,aria:,autoDestroyDisabled,autoDisposeChart,autoInverseDataLabelTextColor,calciteThemingCSSVariables:,chartIndex,chartLimits:,chartWillRender:,commonStrings:,configurationEnabled,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableBetaFeatures,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,filterByViewExtent,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,hideUIMessages,hideZeroCountCategories,ignoreSmoothRenderingLimit,ignoreViewExtent,interactionsDisabled,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerItemId,layerRendererChangePolicy,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,messageOverrides:,model:,nullAsValid,placeholder,popupTemplateFieldInfosEnabled,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotated,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionManager:,selectionTheme:,setTimeBinningInfoWhenNotProvided,showEmptySeries,showLicenseWatermark,showUIMessages,skipChartCreationQueue,syncChartsSelection,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,syncViewSelection,syncViewTimeExtent,syncViewTimeZone,syncViewTimeZoneInclusionList:,timeZone,togglingLegendItemsDisabled,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:;clearSelection,destroy,errorAlert,exportAsCSV,exportAsImage,loadModel,notify,refresh,resetZoom,switchSelection;applySelectionFromSelectionManager"],
-  "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "_messages:,actionBarSelectionMode,chartElement:,chartType,clearSelectionState,clearSelectionTitle,clearSelectionToggle,commonStrings:,csvExportExclusionList:,disableCSVExportForChartTypes:,editChartState,editChartTitle,editChartToggle,expanded,exportActionState,exportAsCSVState,exportAsCSVTitle,exportAsImageState,exportAsImageTitle,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,forceDisableActions,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartState,rotateChartTitle,rotateChartToggle,selectionState,selectionTitle,selectionToggle,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomState,zoomTitle,zoomToggle"],
+const a = t(e, {
+  "arcgis-chart": [() => import("./components/arcgis-chart/customElement.js"), "_commonStrings:,_messages:,actionMode,allowUsingObjectIdStat,animationEnabled,aria:,autoDestroyDisabled,autoDisposeChart,autoInverseDataLabelTextColor,calciteThemingCSSVariables:,chartIndex,chartLimits:,chartWillRender:,configurationEnabled,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableBetaFeatures,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,filterByViewExtent,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,hideUIMessages,hideZeroCountCategories,ignoreSmoothRenderingLimit,ignoreViewExtent,interactionsDisabled,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerItemId,layerRendererChangePolicy,legendInteractionsDisabled,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,messageOverrides:,model:,nullAsValid,placeholder,popupTemplateFieldInfosEnabled,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotated,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionManager:,selectionTheme:,setTimeBinningInfoWhenNotProvided,showEmptySeries,showLicenseWatermark,showUIMessages,skipChartCreationQueue,syncChartsSelection,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,syncViewSelection,syncViewTimeExtent,syncViewTimeZone,syncViewTimeZoneInclusionList:,timeZone,togglingLegendItemsDisabled,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:,zeroCountAsValid;clearSelection,destroy,errorAlert,exportAsCSV,exportAsImage,loadModel,notify,refresh,resetZoom,switchSelection;applySelectionFromSelectionManager"],
+  "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "_messages:,actionBarSelectionMode,chartElement:,chartType,clearSelectionActive,clearSelectionDisabled,clearSelectionState,clearSelectionTitle,clearSelectionToggle,commonStrings:,csvExportExclusionList:,disableCSVExportForChartTypes:,editChartActive,editChartEnabled,editChartState,editChartTitle,editChartToggle,expanded,exportActionDisabled,exportActionState,exportAsCSVDisabled,exportAsCSVState,exportAsCSVTitle,exportAsImageDisabled,exportAsImageState,exportAsImageTitle,filterByExtentDisabled,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionActive,filterBySelectionDisabled,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,filterByViewExtentActive,forceDisableActions,fullExtentActive,fullExtentDisabled,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendActive,legendDisabled,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartActive,rotateChartDisabled,rotateChartState,rotateChartTitle,rotateChartToggle,selectionActive,selectionDisabled,selectionState,selectionTitle,selectionToggle,switchSelectionActive,switchSelectionDisabled,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomActive,zoomDisabled,zoomState,zoomTitle,zoomToggle"],
   "arcgis-charts-config-axes": [() => import("./components/arcgis-charts-config-axes/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,messageOverrides:,model:,open,showEnableXLogOption,showEnableYLogOption,showMaxXBoundOption,showMaxYBoundOption,showMinXBoundOption,showMinYBoundOption"],
   "arcgis-charts-config-axis": [() => import("./components/arcgis-charts-config-axis/customElement.js"), "axisTitle,dataMaxValue,dataMinValue,initialMaxBound,initialMinBound,isXAxis,maxBoundMaxLimit,maxBoundMinLimit,messageOverrides:,minBoundMaxLimit,minBoundMinLimit,model:,showEnableLogOption,showMaxBoundOption,showMinBoundOption"],
   "arcgis-charts-config-bar-chart": [() => import("./components/arcgis-charts-config-bar-chart/customElement.js"), "calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,popupTemplateFieldInfosEnabled,seriesColor:,timeZone,usePopupTemplateFieldsInfo"],
@@ -21,7 +21,7 @@ const r = t(e, {
   "arcgis-charts-config-color-style": [() => import("./components/arcgis-charts-config-color-style/customElement.js"), "enableClose,header,messageOverrides:,open,selectedColor:"],
   "arcgis-charts-config-colors": [() => import("./components/arcgis-charts-config-colors/customElement.js"), "heading,messageOverrides:,rgba:"],
   "arcgis-charts-config-create-flow": [() => import("./components/arcgis-charts-config-create-flow/customElement.js"), "activeLayerId,calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,chartData:,close,disableEditing,filterBySelection,headerTitle,layerList:,messageOverrides:,modelList:,panelNumber,popoverPlacement,popupTemplateFieldInfosEnabled,r2,selectedChartId,seriesColor:,syncChartsToLayers,timeZone,usePopupTemplateFieldsInfo;setFocus"],
-  "arcgis-charts-config-field-select": [() => import("./components/arcgis-charts-config-field-select/customElement.js"), "disabled,invalid,label"],
+  "arcgis-charts-config-field-picker": [() => import("./components/arcgis-charts-config-field-picker/customElement.js"), "disabled,invalid,label"],
   "arcgis-charts-config-font-style": [() => import("./components/arcgis-charts-config-font-style/customElement.js"), "enableClose,fontStyle:,header,messageOverrides:,open"],
   "arcgis-charts-config-format": [() => import("./components/arcgis-charts-config-format/customElement.js"), "messageOverrides:,model:"],
   "arcgis-charts-config-format-popover": [() => import("./components/arcgis-charts-config-format-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedElement:;reposition"],
@@ -57,5 +57,5 @@ const r = t(e, {
   "arcgis-charts-info-modal": [() => import("./components/arcgis-charts-info-modal/customElement.js"), "calciteThemeColors:,heading,loaderColors:,message,showLoader"]
 });
 export {
-  r as defineCustomElements
+  a as defineCustomElements
 };

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

@@ -1,9 +1,10 @@
 import type { ModelParams } from "../interfaces/chart-interfaces.js";
 import type { ModelTypes, SerialChartDataSortingKinds } from "../interfaces/common.js";
+import type { WithRoundedCorners } from "../properties/rounded-corners.js";
 import type { SerialChartModel } from "../serial-chart-model/serial-chart-model.js";
 import type { ChartConfig } from "../../utils/types/index.js";
 
-export class BarChartModel extends SerialChartModel {
+export class BarChartModel extends BarChartModelSuperclass {
   /**
    * Gets whether to hide oversized data labels of the side-by-side series based on the series index.
    * If the index is out of bounds, it will return `undefined`.
@@ -32,9 +33,9 @@ export class BarChartModel extends SerialChartModel {
    * Sets whether to hide oversized data labels of the side-by-side series based on the series index.
    *
    * @param hide - The value for hiding oversized data labels.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all the series will be updated.
    */
-  setSeriesHideOversizedSideBySideLabels(hide: boolean | undefined, seriesIndex: number): void;
+  setSeriesHideOversizedSideBySideLabels(hide: boolean | undefined, seriesIndex?: number): void;
   /**
    * Sets whether to hide oversized stacked labels of the series based on the series index.
    *
@@ -48,4 +49,5 @@ export class BarChartModel extends SerialChartModel {
    * @param params
    */
   setup(params: ModelParams<ChartConfig<typeof ModelTypes.BarChart>>): Promise<void>;
-}
+}
+declare const BarChartModelSuperclass: typeof SerialChartModel & typeof WithRoundedCorners

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

@@ -104,6 +104,8 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * @param toIndex - Index to move the series to.
    */
   moveSeries(fromIndex: number, toIndex: number): void;
+  /** Rebuilds the series based on the current configuration. */
+  rebuildSeries(): Promise<void>;
   /** Returns whether the series styling is able to be reset. */
   resetAvailable(): boolean;
   /** Resets the config to the default config */
@@ -139,18 +141,18 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * **Note**: Only applicable when mean lines are shown.
    *
    * @param newStyle - The new style for the series.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setSeriesLineStyle(newStyle: RESTSimpleLineSymbolStyle | undefined, seriesIndex: number): void;
+  setSeriesLineStyle(newStyle: RESTSimpleLineSymbolStyle | undefined, seriesIndex?: number): void;
   /**
    * Sets the line width of the series based on the series index.
    *
    * **Note**: Only applicable when mean lines are shown.
    *
    * @param newWidth - The new width for the series.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setSeriesLineWidth(newWidth: number | undefined, seriesIndex: number): void;
+  setSeriesLineWidth(newWidth: number | undefined, seriesIndex?: number): void;
   /**
    * Sets name of the series based on the series index.
    *
@@ -171,7 +173,11 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * @param params
    */
   setup(params: ModelParams<ChartConfig<typeof ModelTypes.BoxPlot>>): Promise<void>;
-  /** Updates the series based on the layer filter. */
+  /**
+   * Updates the series based on the layer filter.
+   *
+   * @deprecated since 5.2. Use [rebuildSeries](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#rebuildSeries) instead.
+   */
   updateSeriesFromLayerFilter(): Promise<void>;
 }
 declare const BoxPlotModelSuperclass: typeof ChartModel & typeof WithGenerateXAxisTitle & typeof WithAxisLinesSymbol & typeof WithAxisLabelsSymbol & typeof WithXAxisTitleSymbol & typeof WithXBounds & typeof WithXAxisTitleVisibility & typeof WithXAxisLabelsVisibility & typeof WithXAxisTitleText & typeof ModelWithYGuides & typeof WithDataLabelsSymbol & typeof WithDataLabelsVisibility & typeof WithRotatedState & typeof WithColorMatch & typeof ModelWithTooltips & typeof ModelWithLegend & typeof ModelWithMultiAxes

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

@@ -15,6 +15,8 @@ export abstract class ChartModelBase extends EventTarget {
   get chartType(): ChartTypes;
   /** Data store object that can be used to store any data needed for the chart. */
   dataStore: any;
+  /** The current revision number of the chart configuration. Increments with each update. */
+  get revision(): number;
   /** Generate the proper chart title from the current config. */
   abstract generateChartTitle(): string;
   /**
@@ -23,6 +25,14 @@ export abstract class ChartModelBase extends EventTarget {
    * @param otherModel - The other chart model to compare to.
    */
   isSameChartAs(otherModel: ChartModel | undefined): boolean;
+  /**
+   * Recalls a previous chart configuration based on its revision number. Returns `undefined` if the requested revision is not available (beyond the stored history limit).
+   *
+   * If no `configRevision` number is provided, it recalls the last configuration just before the current one.
+   *
+   * @param configRevision
+   */
+  recall(configRevision?: number): ChartConfig | undefined;
   /**
    * Completes the async setup process for the chart model. Must be called before using the model.
    *

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

@@ -0,0 +1,24 @@
+import type { WebChart } from "../../spec/web-chart.js";
+
+/**
+ * A lightweight wrapper for a `WebChart` config that has a similar shape to a `ChartModel`. Just used internally for the case where the chart component receives a raw `WebChart` config instead of a full `ChartModel` instance.
+ *
+ *  \@private
+ */
+export class ChartModelWrapper extends EventTarget {
+  constructor(config: WebChart | undefined);
+  asyncUpdatesPromise: Promise<void>;
+  /** The current chart configuration object. */
+  accessor config: WebChart | undefined;
+  get layer(): undefined;
+  /** The current revision number of the chart configuration. Increments with each update. */
+  get revision(): number;
+  /**
+   * Recalls a previous chart configuration based on its revision number. Returns `undefined` if the requested revision is not available (beyond the stored history limit).
+   *
+   * If no `configRevision` number is provided, it recalls the last configuration just before the current one.
+   *
+   * @param configRevision
+   */
+  recall(configRevision?: number): WebChart | undefined;
+}