@arcgis/charts-components 5.2.0-next.11 → 5.2.0-next.111

package/dist/interfaces.d.ts

@@ -1,4 +1,5 @@
 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";
@@ -8,12 +9,56 @@ 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 | ImageryLayer | ImageryTileLayer | SubtypeSublayer | SupportedLayer | SupportedRasterLayer | WCSLayer;
+
 export interface IntervalPopoverProps {
   size: number;
   unit: WebChartTemporalBinningUnits;
@@ -175,27 +220,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

@@ -4949,15 +4949,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 +4988,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 +5077,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 +5174,10 @@
                     type: string;
                     description: string;
                 };
+                chartLimitsReached: {
+                    type: string;
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -5151,8 +5186,14 @@
         WebChartBin: {
             type: string;
             properties: {
+                type: {
+                    type: string;
+                    const: string;
+                    description: string;
+                };
                 count: {
                     type: string;
+                    description: string;
                 };
                 minValue: {
                     type: string;
@@ -5170,6 +5211,13 @@
                     type: string;
                     description: string;
                 };
+                arcgisChartsUniqueIds: {
+                    type: string;
+                    items: {
+                        type: string[];
+                    };
+                    description: string;
+                };
             };
             required: string[];
             description: string;
@@ -5550,6 +5598,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 +8231,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 +8376,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 +8541,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 +8699,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 +8852,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 +8889,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-60478-62221-1066060463-60403-62222-1066060463-56508-63410-1066060463-0-66463|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-60478-62221-1066060463-60403-62222-1066060463-56508-63410-1066060463-0-66463|undefined)937098756,Exclude<(\"series\"|\"data\"|\"orderByFields\"),(\"data\"|\"orderByFields\")>>": {
             type: string;
             properties: {
                 series: {

package/dist/loader.js

@@ -2,7 +2,7 @@
 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-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,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"],
   "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"],
@@ -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"],

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;
+}

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

@@ -1,5 +1,6 @@
 import type { ModelParams } from "../interfaces/chart-interfaces.js";
 import type { ModelTypes } from "../interfaces/common.js";
+import type { WithRoundedCorners } from "../properties/rounded-corners.js";
 import type { WithNegativeValuesStackedToBaseline } from "../properties/series/negative-values-stacked-to-baseline.js";
 import type { SerialChartModel } from "../serial-chart-model/serial-chart-model.js";
 import type { WebChartTypes } from "../../spec/chart-object-literals.js";
@@ -16,7 +17,7 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    */
   getAreaColor(seriesIndex: number): Color | undefined;
   /**
-   * Gets whether to hide oversized data labels of the side-by-side series based on the series index. '
+   * 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`.
    *
@@ -84,10 +85,12 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    */
   isMarkerVisible(seriesIndex: number): boolean;
   /**
-   * Specify the color of the filled area for line chart.
-   * **Note:** This method will only work if the series is a line chart series.
+   * Specify the color of the filled area.
+   *
+   * **Note:** This method will only work if the series is a line series.
+   * **Note:** `color` will be applied only if [`setAreaVisible`](#setareavisible) is true, and is defaulted to the line color if not provided.
    *
-   * @param color - The color of the filled area for line chart.
+   * @param color - The color of the filled area.
    * @param seriesIndex - The index of the series.
    */
   setAreaColor(color: Color | undefined, seriesIndex: number): void;
@@ -96,21 +99,30 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    * **Note:** This method will only work if the series is a line chart series.
    *
    * @param visible - `true` if the line series should show area, `false` otherwise.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setAreaVisible(visible: boolean, seriesIndex: number): void;
+  setAreaVisible(visible: boolean, seriesIndex?: number): void;
   /**
    * Specify whether line segments of the series should be smoothed.
    * **Note:** This method will only work if the series is a line chart series.
    *
    * @param smoothed - `true` if line segment of the series should be smoothed, `false` otherwise.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
+   */
+  setLineSmoothed(smoothed: boolean, seriesIndex?: number): void;
+  /**
+   * Indicate whether to show or hide the markers/bullets of the line series.
+   * **Note:** This method will only work if the series is a line chart series.
+   *
+   * @param visible - `true` if the markers/bullets of the line series should be shown, `false` otherwise.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setLineSmoothed(smoothed: boolean, seriesIndex: number): void;
+  setMarkersVisible(visible: boolean, seriesIndex?: number): void;
   /**
    * Indicate whether to show or hide the markers/bullets of the line series.
    * **Note:** This method will only work if the series is a line chart series.
    *
+   * @deprecated since 5.2. Use [setMarkersVisible](https://developers.arcgis.com/javascript/latest/references/charts-components/model/combo-bar-line-chart-model/combo-bar-line-chart-model/#setMarkersVisible) instead. This method will be removed from `ComboBarLineChartModel` in 6.0.
    * @param visible - `true` if the markers/bullets of the line series should be shown, `false` otherwise.
    * @param seriesIndex - The index of the series.
    */
@@ -121,33 +133,33 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    * **Note:** This method will only work if the series is a bar chart series.
    *
    * @param hide - The value for hiding oversized labels.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setSeriesHideOversizedSideBySideLabels(hide: boolean | undefined, seriesIndex: number): void;
+  setSeriesHideOversizedSideBySideLabels(hide: boolean | undefined, seriesIndex?: number): void;
   /**
    * Sets whether to hide oversized data labels of the stacked series based on the series index.
    * **Note:** This method will only work if the series is a bar chart series.
    *
    * @param hide - The value for hiding oversized stacked labels.
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
-  setSeriesHideOversizedStackedLabels(hide: boolean | undefined, seriesIndex: number): void;
+  setSeriesHideOversizedStackedLabels(hide: boolean | undefined, seriesIndex?: number): void;
   /**
    * Sets the line style of the series based on the series index.
    * **Note**: This method will only work if the series is a line chart series.
    *
    * @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**: This method will only work if the series is a line chart series.
    *
    * @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 the marker color of the series based on the series index.
    * **Note**: This method will only work if the series is a line chart series.
@@ -161,17 +173,17 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    * **Note:** This method will only work if the series is a line chart series.
    *
    * @param newSize - The new size 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.
    */
-  setSeriesMarkerSize(newSize: number | undefined, seriesIndex: number): void;
+  setSeriesMarkerSize(newSize: number | undefined, seriesIndex?: number): void;
   /**
    * Sets the marker style of the series based on the series index.
    * **Note:** This method will only work if the series is a line chart series.
    *
    * @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.
    */
-  setSeriesMarkerStyle(newStyle: RESTSimpleMarkerSymbolStyle | undefined, seriesIndex: number): void;
+  setSeriesMarkerStyle(newStyle: RESTSimpleMarkerSymbolStyle | undefined, seriesIndex?: number): void;
   /**
    * Changes the chart series type at the specified index from bar to line and vice-versa.
    *
@@ -186,4 +198,4 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
    */
   setup(params: ModelParams<ChartConfig<typeof ModelTypes.ComboBarLineChart>>): Promise<void>;
 }
-declare const ComboBarLineChartModelSuperclass: typeof SerialChartModel & typeof WithNegativeValuesStackedToBaseline
+declare const ComboBarLineChartModelSuperclass: typeof SerialChartModel & typeof WithRoundedCorners & typeof WithNegativeValuesStackedToBaseline