@arcgis/charts-components 5.2.0-next.98 → 6.0.0-next.0

package/dist/interfaces.d.ts

@@ -4,6 +4,7 @@ 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";
@@ -31,7 +32,7 @@ export type ChartLayer = Layer
   url?: FeatureLayer["url"];
   fields: FeatureLayer["fields"];
   fieldsIndex: FeatureLayer["fieldsIndex"];
-  capabilities: FeatureLayer["capabilities"];
+  capabilities?: FeatureLayer["capabilities"] | null;
   sourceJSON?: FeatureLayer["sourceJSON"];
   objectIdField: FeatureLayer["objectIdField"];
   outFields: FeatureLayer["outFields"];
@@ -39,7 +40,7 @@ export type ChartLayer = Layer
   queryFeatures: FeatureLayer["queryFeatures"];
   queryFeatureCount: FeatureLayer["queryFeatureCount"];
   queryObjectIds: FeatureLayer["queryObjectIds"];
-  queryAttributeBins: FeatureLayer["queryAttributeBins"];
+  queryAttributeBins?: FeatureLayer["queryAttributeBins"];
   createQuery: FeatureLayer["createQuery"];
   getFieldDomain?: FeatureLayer["getFieldDomain"];
   renderer?: FeatureLayer["renderer"];
@@ -57,7 +58,22 @@ export type ChartLayer = Layer
 };
 
 /** Layer input accepted by chart components and models. */
-export type ChartLayerInput = ChartLayer | ImageryLayer | ImageryTileLayer | SubtypeSublayer | SupportedLayer | SupportedRasterLayer | WCSLayer;
+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"];
+  queryAttributeBins?: FeatureLikeLayerView["queryAttributeBins"];
+  queryObjectIds: FeatureLikeLayerView["queryObjectIds"];
+  queryFeatureCount: FeatureLikeLayerView["queryFeatureCount"];
+  queryFeatures: FeatureLikeLayerView["queryFeatures"];
+  dataUpdating: FeatureLikeLayerView["dataUpdating"];
+  updating: FeatureLikeLayerView["updating"];
+}
 
 export interface IntervalPopoverProps {
   size: number;

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

@@ -2268,6 +2268,7 @@
                 };
             };
             required: string[];
+            description: string;
             deprecated: string;
             title: string;
         };
@@ -7196,11 +7197,61 @@
                     };
                     description: string;
                 };
+                locationsOfInterest: {
+                    type: string;
+                    items: {
+                        $ref: string;
+                    };
+                    description: string;
+                };
             };
             required: string[];
             description: string;
             title: string;
         };
+        WebChartLocationOfInterest: {
+            type: string;
+            properties: {
+                type: {
+                    type: string;
+                    const: string;
+                    description: string;
+                };
+                geometry: {
+                    $ref: string;
+                    description: string;
+                };
+                symbol: {
+                    $ref: string;
+                    description: string;
+                };
+                label: {
+                    type: string;
+                    description: string;
+                };
+                enabled: {
+                    type: string;
+                    description: string;
+                };
+            };
+            required: string[];
+            description: string;
+            title: string;
+        };
+        WebChartLocationOfInterestGeometry: {
+            anyOf: {
+                $ref: string;
+            }[];
+            description: string;
+            title: string;
+        };
+        WebChartLocationOfInterestSymbol: {
+            anyOf: {
+                $ref: string;
+            }[];
+            description: string;
+            title: string;
+        };
         WebChartPieChartTick: {
             type: string;
             properties: {
@@ -8889,11 +8940,11 @@
             description: string;
             title: string;
         };
-        "Omit<(structure-1066060463-60478-62221-1066060463-60403-62222-1066060463-56508-63410-1066060463-0-66463|undefined)937098756,(\"data\"|\"orderByFields\")>": {
+        "Omit<(structure-1066060463-61830-63573-1066060463-61755-63574-1066060463-57860-64762-1066060463-0-67815|undefined)937098756,(\"data\"|\"orderByFields\")>": {
             $ref: string;
             title: string;
         };
-        "Pick<(structure-1066060463-60478-62221-1066060463-60403-62222-1066060463-56508-63410-1066060463-0-66463|undefined)937098756,Exclude<(\"series\"|\"data\"|\"orderByFields\"),(\"data\"|\"orderByFields\")>>": {
+        "Pick<(structure-1066060463-61830-63573-1066060463-61755-63574-1066060463-57860-64762-1066060463-0-67815|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"), "_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"],
+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:,truncateLongTitles,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,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionActive,filterBySelectionDisabled,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,filterByViewExtentActive,filterByViewExtentDisabled,filterByViewExtentTitle,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"],
@@ -20,7 +20,7 @@ const r = t(e, {
   "arcgis-charts-config-chart-rename-popover": [() => import("./components/arcgis-charts-config-chart-rename-popover/customElement.js"), "messageOverrides:,name,open,referenceElement:;reposition"],
   "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-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,view:;setFocus"],
   "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:"],
@@ -49,13 +49,14 @@ const r = t(e, {
   "arcgis-charts-config-pie-chart-popover": [() => import("./components/arcgis-charts-config-pie-chart-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,referenceElement:,selectedContent;reposition"],
   "arcgis-charts-config-pie-chart-slices": [() => import("./components/arcgis-charts-config-pie-chart-slices/customElement.js"), "chartData:,messageOverrides:,model:,popoverPlacement"],
   "arcgis-charts-config-pie-chart-slices-popover": [() => import("./components/arcgis-charts-config-pie-chart-slices-popover/customElement.js"), "messageOverrides:,open,placement,referenceElement:,selectedColor:,selectedName,selectedSliceId;reposition"],
-  "arcgis-charts-config-scatter-plot": [() => import("./components/arcgis-charts-config-scatter-plot/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,popupTemplateFieldInfosEnabled,r2,usePopupTemplateFieldsInfo"],
-  "arcgis-charts-config-scatter-plot-data": [() => import("./components/arcgis-charts-config-scatter-plot-data/customElement.js"), "isTableLayer,layerFieldsInfo:,messageOverrides:,model:,r2"],
+  "arcgis-charts-config-scatter-plot": [() => import("./components/arcgis-charts-config-scatter-plot/customElement.js"), "calculatedDataMinMaxBounds:,calculatedMinMaxBounds:,layer:,model:,page,popoverPlacement,popupTemplateFieldInfosEnabled,r2,usePopupTemplateFieldsInfo,view:"],
+  "arcgis-charts-config-scatter-plot-aoi": [() => import("./components/arcgis-charts-config-scatter-plot-aoi/customElement.js"), "messageOverrides:,view:"],
+  "arcgis-charts-config-scatter-plot-data": [() => import("./components/arcgis-charts-config-scatter-plot-data/customElement.js"), "isTableLayer,layerFieldsInfo:,messageOverrides:,model:,r2,view:"],
   "arcgis-charts-config-scatter-plot-popover": [() => import("./components/arcgis-charts-config-scatter-plot-popover/customElement.js"), "contentKind,headingTitle,layerFieldsInfo:,messageOverrides:,open,placement,referenceElement:,selectedContent;reposition"],
   "arcgis-charts-config-select-chart-type-popover": [() => import("./components/arcgis-charts-config-select-chart-type-popover/customElement.js"), "headerTitle,isRasterBarChartSupported,layerId,layerType,messageOverrides:,open,popoverPlacement,referenceElement:,selectedModelType;reposition"],
   "arcgis-charts-config-view-charts": [() => import("./components/arcgis-charts-config-view-charts/customElement.js"), "disableEditing,layer:,messageOverrides:,modelList:,noGroup,selectedChartId"],
   "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

@@ -5,6 +5,22 @@ import type { SerialChartModel } from "../serial-chart-model/serial-chart-model.
 import type { ChartConfig } from "../../utils/types/index.js";
 
 export class BarChartModel extends BarChartModelSuperclass {
+  /**
+   * Gets the data sort order for the bar chart.
+   *
+   * Data sort orders the chart's categories or numeric values. It applies whether the chart has one series or many.
+   * This is distinct from [getOrderOfSeries](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#getOrderOfSeries), which
+   * reorders the series themselves and only has an effect on multi-series charts.
+   *
+   * Sort order kinds:
+   * - `xAxisAsc` / `xAxisDesc` — order by category axis values ascending or descending
+   * - `yAxisAsc` / `yAxisDesc` — order by numeric values ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
+   * @since 5.2
+   */
+  getDataSortOrder(): SerialChartDataSortingKinds;
   /**
    * 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`.
@@ -20,8 +36,9 @@ export class BarChartModel extends BarChartModelSuperclass {
    */
   getSeriesHideOversizedStackedLabels(seriesIndex: number): boolean | undefined;
   /**
-   * Gets the sort order for the bar chart.
+   * Gets the data sort order for the bar chart.
    *
+   * @deprecated since 5.2. Use [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/bar-chart-model/bar-chart-model/#getDataSortOrder) instead. This method will be removed from `BarChartModel` in 6.0.
    * @returns {"xAxisAsc" | "xAxisDesc" | "yAxisAsc" | "yAxisDesc" | "customSort"}
    */
   getSortOrder(): SerialChartDataSortingKinds;
@@ -33,14 +50,14 @@ export class BarChartModel extends BarChartModelSuperclass {
    * 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. If omitted, all the series will be updated.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
   setSeriesHideOversizedSideBySideLabels(hide: boolean | undefined, seriesIndex?: number): void;
   /**
    * Sets whether to hide oversized stacked labels of the series based on the series index.
    *
    * @param hide - The value for hiding oversized stacked labels.
-   * @param seriesIndex - The index of the series. When not provided all the series will be updated.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
   setSeriesHideOversizedStackedLabels(hide: boolean | undefined, seriesIndex?: number): void;
   /**

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

@@ -2,7 +2,6 @@ import type { RESTSimpleLineSymbolStyle } from "../../spec/rest-js-object-litera
 import type { Color } from "../../spec/rest-js-types.js";
 import type { WebChartDataFilters } from "../../spec/web-chart.js";
 import type { ChartConfig } from "../../utils/types/index.js";
-import type { ChartModel } from "../chart-model/chart-model.js";
 import type { ModelParams } from "../interfaces/chart-interfaces.js";
 import type { ModelTypes, BoxPlotDataSortingKinds } from "../interfaces/common.js";
 import type { ModelWithLegend } from "../mixins/model-with-legend.js";
@@ -21,6 +20,8 @@ import type { WithColorMatch } from "../properties/color-match.js";
 import type { WithDataLabelsSymbol } from "../properties/data-labels/data-labels-symbol.js";
 import type { WithDataLabelsVisibility } from "../properties/data-labels/data-labels-visibility.js";
 import type { WithRotatedState } from "../properties/rotated-state.js";
+import type { ChartModel } from "../chart-model/chart-model.js";
+import type { ChartElementLimit } from "../../utils/defaults/interfaces.js";
 
 export class BoxPlotModel extends BoxPlotModelSuperclass {
   /**
@@ -31,10 +32,16 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
   get boxPlotSeriesIndexWhenMeanLinesShown(): number;
   /** The category field for the box plot. */
   accessor category: string;
+  /**
+   * The chart limits used when generating split-by series.
+   *
+   * @internal
+   */
+  accessor chartLimits: ChartElementLimit | undefined;
   /**
    * The color of the boxes when showing mean lines.
    *
-   * Only applicable when mean lines are shown.
+   * **Note**: Only applicable when mean lines are shown.
    */
   accessor meanLinesBoxColor: Color | undefined;
   /** The numeric fields array for the box plot. */
@@ -42,7 +49,15 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
   set numericFields(value: string[] | string);
   /** The list of category values for custom sort. */
   accessor orderByList: string[];
-  /** The order of the series array by returning an array of series ids. */
+  /**
+   * The order of the series array as an array of series ids.
+   *
+   * Series order reorders the series themselves (legend and draw order). Use this only for a multi-series chart;
+   * on a single-series chart it has no effect.
+   *
+   * This is distinct from [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#getDataSortOrder), which
+   * orders categories or summary statistics within the chart data.
+   */
   accessor orderOfSeries: string[];
   /** Whether mean lines are shown. */
   accessor showMeanLines: boolean | undefined;
@@ -50,6 +65,18 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
   accessor showOutliers: boolean;
   /** The split-by field for the box plot. */
   accessor splitByField: string;
+  /**
+   * Get the number of split-by series before applying the configured chart limit.
+   *
+   * @internal
+   */
+  accessor splitBySeriesCount: number;
+  /**
+   * Get whether split-by series were trimmed to the configured chart limit.
+   *
+   * @internal
+   */
+  accessor splitBySeriesLimitReached: boolean;
   /** Whether values are standardized as z-scores. */
   accessor standardizeValues: boolean;
   /** Generate the proper chart title given the current config. */
@@ -58,6 +85,23 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
   generateYAxisTitle(): string;
   /** Gets the list of the category values for the chart. */
   getCustomSortValues(): Promise<string[]>;
+  /**
+   * Gets the data sort order of the box plot.
+   *
+   * Data sort orders the chart's categories or summary statistics. It applies whether the chart has one series or many.
+   * This is distinct from [orderOfSeries](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#orderOfSeries), which
+   * reorders the series themselves and only has an effect on multi-series charts.
+   *
+   * Sort order kinds:
+   * - `xAxisAsc` / `xAxisDesc` — order by category axis values ascending or descending
+   * - `meanAsc` / `meanDesc` — order by mean ascending or descending
+   * - `medianAsc` / `medianDesc` — order by median ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @returns The current data sort order kind.
+   * @since 5.2
+   */
+  getDataSortOrder(): BoxPlotDataSortingKinds;
   /**
    * Gets the color of the series based on the series index. If the index is out of bounds, it will return `undefined`.
    *
@@ -86,12 +130,17 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * @param seriesIndex - The index of the series.
    */
   getSeriesName(seriesIndex: number): string | undefined;
-  /** Gets the sort order of the box plot data. */
+  /**
+   * Gets the data sort order of the box plot.
+   *
+   * @deprecated since 5.2. Use [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#getDataSortOrder) instead. This method will be removed from `BoxPlotModel` in 6.0.
+   */
   getSortOrder(): BoxPlotDataSortingKinds;
   /**
    * Move the custom sort values in-place for the order by list in the config.
    *
-   * **Note**: This method should be only used when the sort order is set to `BoxPlotDataSortingKinds.customSort`.
+   * **Note**: This method should only be used when the data sort order is set to `BoxPlotDataSortingKinds.customSort`
+   * via [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#setDataSortOrder).
    *
    * @param fromIndex - The index to move the custom sort item from.
    * @param toIndex - The index to move the category item to.
@@ -124,6 +173,24 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * ```
    */
   setDataFilters(newDataFilter: WebChartDataFilters | undefined): Promise<void>;
+  /**
+   * Sets the data sort order of the box plot.
+   *
+   * Data sort orders the chart's categories or summary statistics. It applies whether the chart has one series or many.
+   * This is distinct from [orderOfSeries](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#orderOfSeries), which
+   * reorders the series themselves and only has an effect on multi-series charts.
+   *
+   * Sort order kinds:
+   * - `xAxisAsc` / `xAxisDesc` — order by category axis values ascending or descending
+   * - `meanAsc` / `meanDesc` — order by mean ascending or descending
+   * - `medianAsc` / `medianDesc` — order by median ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values for custom sort.
+   * @since 5.2
+   */
+  setDataSortOrder(newSortOrder: BoxPlotDataSortingKinds, orderByList?: string[]): void;
   /**
    * Sets the color of the series based on the series index.
    *
@@ -141,7 +208,7 @@ 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. If omitted, all mean lines will be updated.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
   setSeriesLineStyle(newStyle: RESTSimpleLineSymbolStyle | undefined, seriesIndex?: number): void;
   /**
@@ -150,7 +217,7 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    * **Note**: Only applicable when mean lines are shown.
    *
    * @param newWidth - The new width for the series.
-   * @param seriesIndex - The index of the series. If omitted, all mean lines will be updated.
+   * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
   setSeriesLineWidth(newWidth: number | undefined, seriesIndex?: number): void;
   /**
@@ -161,10 +228,11 @@ export class BoxPlotModel extends BoxPlotModelSuperclass {
    */
   setSeriesName(newName: string, seriesIndex: number): void;
   /**
-   * Sets the sort order of the box plot data.
+   * Sets the data sort order of the box plot.
    *
-   * @param newSortOrder - The new sort order.
-   * @param orderByList - The new list of category's values for custom sort.
+   * @deprecated since 5.2. Use [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/box-plot-model/box-plot-model/#setDataSortOrder) instead. This method will be removed from `BoxPlotModel` in 6.0.
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values for custom sort.
    */
   setSortOrder(newSortOrder: BoxPlotDataSortingKinds, orderByList?: string[]): void;
   /**

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

@@ -47,6 +47,7 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
   getSeriesLineWidth(seriesIndex: number): number | undefined;
   /**
    * Gets the marker color of the series based on the series index.
+   *
    * If the index is out of bounds, it will return `undefined`.
    *
    * @param seriesIndex - The index of the series.
@@ -146,6 +147,7 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
   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.
@@ -154,6 +156,7 @@ export class ComboBarLineChartModel extends ComboBarLineChartModelSuperclass {
   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.

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

@@ -32,7 +32,13 @@ export class HeatChartModel extends SerialChartModel {
   accessor classificationMethod: WebChartClassBreakTypes | undefined;
   /** The name of the color ramp used by the heat chart. */
   accessor colorRampName: string | undefined;
-  /** The heat chart's empty cell configuration. */
+  /**
+   * Gets the heat chart's empty cell configuration
+   *
+   * @deprecated
+   * since 5.2 Use [emptyCellText](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#emptyCellText) or [emptyCellSymbol](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#emptyCellSymbol) to retrieve the text or symbol for an empty heat chart cell instead.
+   * This property will be removed from `HeatChartModel` in 6.0
+   */
   accessor emptyCell: WebChartHeatChartEmptyCell | undefined;
   /** The heat chart's empty cell symbol. */
   accessor emptyCellSymbol: ISimpleFillSymbol | undefined;
@@ -171,6 +177,18 @@ export class HeatChartModel extends SerialChartModel {
    * @internal
    */
   getAssignToSecondValueAxis(): boolean;
+  /**
+   * Gets the data sort order for the heat chart.
+   *
+   * Heat charts do not use a single data sort order. Use
+   * [getXAxisSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#getXAxisSortOrder) and
+   * [getYAxisSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#getYAxisSortOrder) to order data on each axis.
+   *
+   * @returns A default ascending sort order. Prefer the axis-specific getters for heat charts.
+   * @internal
+   * @since 5.2
+   */
+  getDataSortOrder(): HeatChartDataSortingKinds | SerialChartDataSortingKinds;
   /** Gets the grid lines symbol. Contains styling information such as line width, line style, and line color. */
   getGridLinesSymbol(): ISimpleLineSymbol | undefined;
   /**
@@ -179,16 +197,29 @@ export class HeatChartModel extends SerialChartModel {
    * @internal
    */
   getSeriesToSecondaryYAxis(): boolean;
-  /** Gets the sort order for the bar chart. */
+  /**
+   * Gets the data sort order for the heat chart.
+   *
+   * @deprecated since 5.2. Use [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#getDataSortOrder) instead. This method will be removed from `HeatChartModel` in 6.0.
+   * @internal
+   */
   getSortOrder(): HeatChartDataSortingKinds | SerialChartDataSortingKinds;
   /**
-   * Get the sort order on the x axis for the heat chart.
+   * Gets the data sort order on the x axis for the heat chart.
+   *
+   * This orders category or value labels along the x axis. It does not reorder series.
+   *
+   * Sort order kinds: `Asc`, `Desc`, or `customSort` (an explicit category list via `orderByList`).
    *
    * @returns {"Asc" | "Desc" | "customSort"}
    */
   getXAxisSortOrder(): HeatChartDataSortingKinds;
   /**
-   * Gets the sort order for on the y axis for heat chart.
+   * Gets the data sort order on the y axis for the heat chart.
+   *
+   * This orders category or value labels along the y axis. It does not reorder series.
+   *
+   * Sort order kinds: `Asc`, `Desc`, or `customSort` (an explicit category list via `orderByList`).
    *
    * @returns {"Asc" | "Desc" | "customSort"}
    */
@@ -202,6 +233,15 @@ export class HeatChartModel extends SerialChartModel {
    * @internal
    */
   setAssignToSecondValueAxis(_assign: boolean, _seriesIndex: number): void;
+  /**
+   * setDataSortOrder is not used by heat chart; instead use setXAxisSortOrder for the x axis and setYAxisSortOrder for the y axis.
+   *
+   * @param _newSortOrder - Unused. Prefer [setXAxisSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#setXAxisSortOrder) or [setYAxisSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#setYAxisSortOrder).
+   * @param _orderByList - Unused. Prefer the axis-specific setters for heat charts.
+   * @internal
+   * @since 5.2
+   */
+  setDataSortOrder(_newSortOrder: HeatChartDataSortingKinds | SerialChartDataSortingKinds, _orderByList?: string[]): void;
   /**
    * Sets the grid lines symbol. Contains styling information such as line width, line style, and line color.
    *
@@ -239,6 +279,7 @@ export class HeatChartModel extends SerialChartModel {
   /**
    * setSortOrder is not used by heat chart; instead use setXAxisSortOrder for the x axis and setYAxisSortOrder for the y axis.
    *
+   * @deprecated since 5.2. Use [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/heat-chart-model/heat-chart-model/#setDataSortOrder) instead. This method will be removed from `HeatChartModel` in 6.0.
    * @param _newSortOrder
    * @param _orderByList
    * @internal
@@ -251,17 +292,25 @@ export class HeatChartModel extends SerialChartModel {
    */
   setup(params: ModelParams<ChartConfig<typeof ModelTypes.HeatChart>>): Promise<void>;
   /**
-   * Sets the sort order on the x axis for the heat chart.
+   * Sets the data sort order on the x axis for the heat chart.
+   *
+   * This orders category or value labels along the x axis. It does not reorder series.
    *
-   * @param newSortOrder - The new sort order.
-   * @param orderByList - The list of category's values to order by.
+   * Sort order kinds: `Asc`, `Desc`, or `customSort` (an explicit category list via `orderByList`).
+   *
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values to order by when using `customSort`.
    */
   setXAxisSortOrder(newSortOrder: HeatChartDataSortingKinds, orderByList?: string[]): void;
   /**
-   * Sets the sort order on the y axis for heat chart.
+   * Sets the data sort order on the y axis for the heat chart.
+   *
+   * This orders category or value labels along the y axis. It does not reorder series.
+   *
+   * Sort order kinds: `Asc`, `Desc`, or `customSort` (an explicit category list via `orderByList`).
    *
-   * @param newSortOrder - The new sort order.
-   * @param orderByList - The list of category's values to order by.
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values to order by when using `customSort`.
    */
   setYAxisSortOrder(newSortOrder: HeatChartDataSortingKinds, orderByList?: string[]): void;
 }

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

@@ -1,20 +1,23 @@
-import type { ChartLayerInput } from "../../interfaces.js";
+import type { ChartLayerInputSansView } from "../../interfaces.js";
 import type { IFeatureLayer, IImageServiceLayer, ITiledImageServiceLayer } from "../../spec/rest-js-types.js";
 import type { WebChartBarChartSeries, WebChartHeatChartSeries, WebChartLineChartSeries, WebChartRadarChartSeries } from "../../spec/web-chart.js";
 import type { CommonStrings } from "../../utils/localization/interfaces.js";
 import type { ChartConfig } from "../../utils/types/index.js";
+import type { ChartElementLimit } from "../../utils/defaults/interfaces.js";
 import type { ModelTypes } from "./common.js";
 
 /** Parameters for creating a chart model. */
 export type ModelParams<T extends ChartConfig> = {
   /** Layer instance associated with the chart. */
-  layer?: ChartLayerInput;
+  layer?: ChartLayerInputSansView;
   /** Layer description to be used when the `layer` property is not set. */
   iLayer?: IFeatureLayer | IImageServiceLayer | ITiledImageServiceLayer;
   /** Chart config object to be edited. If not provided, a new config will be created using default values. */
   config?: T;
   /** t9n error strings */
   commonStrings?: CommonStrings;
+  /** Maximum number of chart elements allowed while building the model. */
+  chartLimits?: ChartElementLimit;
 };
 
 /** Type alias for the supported serial chart config. */

package/dist/model/interfaces/common.d.ts

@@ -1,4 +1,4 @@
-import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
+import type { ChartLayerInputSansView } from "../../interfaces.js";
 import type { WebChartTypes } from "../../spec/chart-object-literals.js";
 import type { IField } from "../../spec/rest-js-types.js";
 import type { WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartPieChartSeries, WebChartRadarChartSeries, WebChartScatterplotSeries } from "../../spec/web-chart.js";
@@ -127,6 +127,8 @@ export type GuideOrientation = (typeof GuideOrientation)[keyof typeof GuideOrien
 
 export interface SplitByFieldInfos {
   categoriesArray: (number | string)[];
+  seriesLimitReached: boolean;
+  totalSeriesCount: number;
   splitByFieldType?: string;
   numericalField: string;
 }
@@ -141,7 +143,7 @@ export interface PieSeriesDisplayOptions {
 
 export interface LayerInfo {
   /** Layer used for this bar chart. */
-  layer: SupportedLayer | SupportedRasterLayer;
+  layer: ChartLayerInputSansView;
   /** Fields information for the layer. */
   layerFieldsInfo: IField[];
   /** Object ID field name for the layer. */