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

package/dist/model/mixins/model-with-guides.d.ts

@@ -17,7 +17,7 @@ export abstract class ModelWithGuides extends ChartModel {
    * Gets the end value of a guide.
    *
    * @param index - Default `0`. The index of the guide in the list of guides for the given axis orientation.
-   * @param orientation - Default `y`. The axis orientation of the guide.
+   * @param orientation - Default `y`. The axis orientation of the guide. If it's a gauge, the default is `x`
    */
   getGuideEnd(index?: number, orientation?: GuideOrientation): Date | number | string | null | undefined;
   /**
@@ -38,7 +38,7 @@ export abstract class ModelWithGuides extends ChartModel {
    * Gets the start value of a guide.
    *
    * @param index - Default `0`. The index of the guide in the list of guides for the given axis orientation.
-   * @param orientation - Default `y`. The axis orientation of the guide.
+   * @param orientation - Default `y`. The axis orientation of the guide. If it's a gauge, the default is `x`
    */
   getGuideStart(index?: number, orientation?: GuideOrientation): Date | number | string | null;
   /**
@@ -48,6 +48,13 @@ export abstract class ModelWithGuides extends ChartModel {
    * @param orientation - Default `y`. The axis orientation of the guide.
    */
   getGuideStyle(index?: number, orientation?: GuideOrientation): ISimpleFillSymbol | ISimpleLineSymbol | undefined;
+  /**
+   * Gets whether the tooltip text color should be reversed for a guide.
+   *
+   * @param index - The index of the guide in the list of guides for the given axis orientation.
+   * @param orientation - The axis orientation of the guide.
+   */
+  getGuideTooltipReverseColor(index: number, orientation?: GuideOrientation): boolean;
   /**
    * Gets whether a guide is visible.
    *
@@ -58,6 +65,7 @@ export abstract class ModelWithGuides extends ChartModel {
   /**
    * Gets whether the tooltip text color should be reversed for a guide.
    *
+   * @deprecated since 5.2. Use [getGuideTooltipReverseColor](https://developers.arcgis.com/javascript/latest/references/charts-components/model/mixins/model-with-guides/#getGuideTooltipReverseColor) instead. This method will be removed from `ModelWithGuides` in 6.0.
    * @param index - The index of the guide in the list of guides for the given axis orientation.
    * @param orientation - The axis orientation of the guide.
    */
@@ -75,7 +83,7 @@ export abstract class ModelWithGuides extends ChartModel {
    *
    * @param end - New end value to set.
    * @param index - Default `0`. The index of the guide in the list of guides for the given axis orientation.
-   * @param orientation - Default `y`. The axis orientation of the guide.
+   * @param orientation - Default `y`. The axis orientation of the guide. If it's a gauge, the default is `x`
    */
   setGuideEnd(end: Date | number | string | null | undefined, index?: number, orientation?: GuideOrientation): void;
   /**
@@ -99,7 +107,7 @@ export abstract class ModelWithGuides extends ChartModel {
    *
    * @param start - New start value to set.
    * @param index - Default `0`. The index of the guide in the list of guides for the given axis orientation.
-   * @param orientation - Default `y`. The axis orientation of the guide.
+   * @param orientation - Default `y`. The axis orientation of the guide. If it's a gauge, the default is `x`
    */
   setGuideStart(start: Date | number | string | null, index?: number, orientation?: GuideOrientation): void;
   /**
@@ -121,6 +129,14 @@ export abstract class ModelWithGuides extends ChartModel {
    * ```
    */
   setGuideStyle(style: ISimpleFillSymbol | ISimpleLineSymbol, index?: number, orientation?: GuideOrientation): void;
+  /**
+   * Sets whether the tooltip text color should be reversed for a guide.
+   *
+   * @param reverseColor - New reverseColor boolean to set.
+   * @param index - The index of the guide in the list of guides for the given axis orientation. If omitted, all guides for the orientation will be updated.
+   * @param orientation - The axis orientation of the guide.
+   */
+  setGuideTooltipReverseColor(reverseColor: boolean, index?: number, orientation?: GuideOrientation): void;
   /**
    * Sets whether a guide is visible.
    *
@@ -132,9 +148,10 @@ export abstract class ModelWithGuides extends ChartModel {
   /**
    * Sets whether the tooltip text color should be reversed for a guide.
    *
+   * @deprecated since 5.2. Use [setGuideTooltipReverseColor](https://developers.arcgis.com/javascript/latest/references/charts-components/model/mixins/model-with-guides/#setGuideTooltipReverseColor) instead. This method will be removed from `ModelWithGuides` in 6.0.
    * @param reverseColor - New reverseColor boolean to set.
-   * @param index - The index of the guide in the list of guides for the given axis orientation.
+   * @param index - The index of the guide in the list of guides for the given axis orientation. If omitted, all guides for the orientation will be updated.
    * @param orientation - The axis orientation of the guide.
    */
-  setTooltipReverseColor(reverseColor: boolean, index: number, orientation?: GuideOrientation): void;
+  setTooltipReverseColor(reverseColor: boolean, index?: number, orientation?: GuideOrientation): void;
 }

package/dist/model/mixins/model-with-line-marker-styling.d.ts

@@ -84,7 +84,7 @@ export abstract class ModelWithLineMarkerStyling extends ChartModel {
    * Specify whether to connect the lines when there's a gap in the data.
    * **Note:** Can be overridden by the temporal data setting `nullPolicy`.
    *
-   * @param connect - Whether to connect the gap in the data
+   * @param connect - Whether to connect the gap in the data.
    * @param seriesIndex - The index of the series. If omitted, all compatible series will be updated.
    */
   setConnectLines(connect: boolean | undefined, seriesIndex?: number): void;

package/dist/model/mixins/model-with-multi-axes.d.ts

@@ -129,9 +129,9 @@ export abstract class ModelWithMultiAxes extends ChartModel {
    * Sets the visibility of the specified axis labels.
    *
    * @param isVisible - The visibility state for the axis labels.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all axes will be updated.
    */
-  setAxisLabelsVisibility(isVisible: boolean, axisIndex: number): void;
+  setAxisLabelsVisibility(isVisible: boolean, axisIndex?: number): void;
   /**
    * Sets the scrollbar configuration for the specified axis.
    *
@@ -143,9 +143,9 @@ export abstract class ModelWithMultiAxes extends ChartModel {
    * Sets the title text symbol for the specified axis. Contains styling information such as font, color, and symbol style.
    *
    * @param titleSymbol - The title text symbol to set.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all axes will be updated.
    */
-  setAxisTitleSymbol(titleSymbol: WebChartTextSymbol | undefined, axisIndex: number): void;
+  setAxisTitleSymbol(titleSymbol: WebChartTextSymbol | undefined, axisIndex?: number): void;
   /**
    * Sets the title text for the specified axis.
    *
@@ -157,9 +157,9 @@ export abstract class ModelWithMultiAxes extends ChartModel {
    * Sets the visibility of the specified axis title.
    *
    * @param isVisible - The visibility state for the axis title.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all axes will be updated.
    */
-  setAxisTitleVisibility(isVisible: boolean, axisIndex: number): void;
+  setAxisTitleVisibility(isVisible: boolean, axisIndex?: number): void;
   /**
    * Sets the value format for the specified axis.
    *
@@ -179,24 +179,24 @@ export abstract class ModelWithMultiAxes extends ChartModel {
    * - This setting is only applicable to the axis of type `ValueAxis`.
    *
    * @param buffer - The setting for the buffer.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all compatible value axes will be updated.
    */
-  setBuffer(buffer: boolean, axisIndex: number): void;
+  setBuffer(buffer: boolean, axisIndex?: number): void;
   /**
    * Sets the display cursor tooltip setting for the specified axis.
    *
    * @param displayCursorTooltip - The display cursor tooltip setting for the axis.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all axes will be updated.
    */
-  setDisplayCursorTooltip(displayCursorTooltip: boolean, axisIndex: number): void;
+  setDisplayCursorTooltip(displayCursorTooltip: boolean, axisIndex?: number): void;
   /**
    * Sets the display zero line setting for the specified axis.
    * - This setting is only applicable to the axis of type `ValueAxis`.
    *
    * @param displayZeroLine - The display zero line setting for the axis.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all compatible value axes will be updated.
    */
-  setDisplayZeroLine(displayZeroLine: boolean, axisIndex: number): void;
+  setDisplayZeroLine(displayZeroLine: boolean, axisIndex?: number): void;
   /**
    * Sets the grid lines symbol. Contains styling information such as line width, line style, and line color.
    *
@@ -230,9 +230,9 @@ export abstract class ModelWithMultiAxes extends ChartModel {
    * - This setting is only applicable to the axis of type `ValueAxis`.
    *
    * @param integerOnlyValues - The boolean value to set for the integer only values setting.
-   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis.
+   * @param axisIndex - Axis index for the chart: `0` for x-axis, `1` for primary y-axis, and `2` for secondary y-axis. If omitted, all compatible value axes will be updated.
    */
-  setIntegerOnlyValues(integerOnlyValues: boolean, axisIndex: number): void;
+  setIntegerOnlyValues(integerOnlyValues: boolean, axisIndex?: number): void;
   /**
    * Sets whether logarithmic scale is enabled for the specified axis.
    *

package/dist/model/mixins/model-with-tooltips.d.ts

@@ -3,34 +3,30 @@ import type { ChartModel } from "../chart-model/chart-model.js";
 export abstract class ModelWithTooltips extends ChartModel {
   /**
    * Gets the setting of the `dataTooltipReverseColor` property.
-   * - If the `seriesIndex` is provided, the `dataTooltipReverseColor` for that series will be returned. Otherwise, the same property of the first series will be returned.
    * - If the `dataTooltipReverseColor` is not set on the series, the default value of `false` will be returned.
    *
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, the first series will be used.
    */
   getDataTooltipReverseColor(seriesIndex?: number): boolean;
   /**
    * Gets the visibility of the data tooltips.
-   * - If the `seriesIndex` is provided, the visibility for that series will be returned. Otherwise, the visibility of the first series will be returned.
    * - If the visibility is not set on the series, the default value of `true` will be returned.
    *
-   * @param seriesIndex - The index of the series.
+   * @param seriesIndex - The index of the series. If omitted, the first series will be used.
    */
   getDataTooltipVisibility(seriesIndex?: number): boolean;
   /**
    * Sets the setting of the `dataTooltipReverseColor` property.
-   * - If the `seriesIndex` is provided, the reverse color will be set for that series only. Otherwise, the reverse color will be set for all series.
    *
    * @param reverseColor - Indicator of whether to reverse the color.
-   * @param seriesIndex - The index of the series to set the reverse color.
+   * @param seriesIndex - The index of the series to set the reverse color. If omitted, all compatible series will be updated.
    */
   setDataTooltipReverseColor(reverseColor: boolean, seriesIndex?: number): void;
   /**
    * Sets the visibility of the data tooltips.
-   * - If the `seriesIndex` is provided, the visibility will be set for that series only. Otherwise, the visibility will be set for all series.
    *
    * @param visibility - The visibility of the data tooltips.
-   * @param seriesIndex - The index of the series to set the visibility.
+   * @param seriesIndex - The index of the series to set the visibility. If omitted, all compatible series will be updated.
    */
   setDataTooltipVisibility(visibility: boolean, seriesIndex?: number): void;
 }

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

@@ -78,7 +78,19 @@ export class PieChartModel extends PieChartModelSuperclass {
   accessor groupedSliceIds: string[];
   /** Threshold below which slices will be grouped. */
   accessor groupingThreshold: number;
-  /** Inner radius size for the pie chart. */
+  /**
+   * Inner radius of the pie chart.
+   *
+   * @since 5.2
+   */
+  accessor innerRadius: number;
+  /**
+   * Inner radius size for the pie chart.
+   *
+   * @deprecated
+   * since 5.2. Use [innerRadius](https://developers.arcgis.com/javascript/latest/references/charts-components/model/pie-chart-model/pie-chart-model/#innerRadius) instead.
+   * This property will be removed from `PieChartModel` in 6.0.
+   */
   accessor innerRadiusSize: number;
   /** Character limit for the slice labels. */
   accessor labelCharacterLimit: number | null;
@@ -135,6 +147,21 @@ export class PieChartModel extends PieChartModelSuperclass {
   generateChartTitle(): string;
   /** Gets the list of the category values for the chart. */
   getCustomSortValues(): Promise<string[]>;
+  /**
+   * Gets the data sort order for the pie chart.
+   *
+   * Data sort orders the pie slices by label, value, or an explicit category list.
+   * Pie charts do not have a series-order API; use data sort to control slice order.
+   *
+   * Sort order kinds:
+   * - `labelAsc` / `labelDesc` — order by slice label ascending or descending
+   * - `valueAsc` / `valueDesc` — order by slice value ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @returns The current data sort order kind.
+   * @since 5.2
+   */
+  getDataSortOrder(): PieChartDataSortingKinds;
   /**
    * Gets the setting for displaying numerical values on legend items.
    *
@@ -185,7 +212,11 @@ export class PieChartModel extends PieChartModelSuperclass {
   getSliceName(sliceIndex: number): string | undefined;
   /** Gets the length of the slices array. */
   getSlicesLength(): number;
-  /** Gets the sort order for the pie chart. */
+  /**
+   * Gets the data sort order for the pie chart.
+   *
+   * @deprecated since 5.2. Use [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/pie-chart-model/pie-chart-model/#getDataSortOrder) instead. This method will be removed from `PieChartModel` in 6.0.
+   */
   getSortOrder(): PieChartDataSortingKinds;
   /**
    * Moves the custom sort values in-place for the order by list in the config.
@@ -206,6 +237,22 @@ export class PieChartModel extends PieChartModelSuperclass {
   resetAvailable(): boolean;
   /** Resets the slices styling to the default styling. */
   resetSlices(): void;
+  /**
+   * Sets the data sort order for the pie chart.
+   *
+   * Data sort orders the pie slices by label, value, or an explicit category list.
+   * Pie charts do not have a series-order API; use data sort to control slice order.
+   *
+   * Sort order kinds:
+   * - `labelAsc` / `labelDesc` — order by slice label ascending or descending
+   * - `valueAsc` / `valueDesc` — order by slice value ascending or descending
+   * - `customSort` — order by an explicit category list (`orderByList`)
+   *
+   * @param sortOrder - The data sort order.
+   * @param orderByList - The list of category values when using `customSort`.
+   * @since 5.2
+   */
+  setDataSortOrder(sortOrder: PieChartDataSortingKinds, orderByList?: string[]): void;
   /**
    * Sets the setting for displaying numerical values on legend items.
    *
@@ -242,10 +289,11 @@ export class PieChartModel extends PieChartModelSuperclass {
    */
   setSliceName(name: string, sliceIndex: number): void;
   /**
-   * Sets the sort order for the pie chart.
+   * Sets the data sort order for the pie chart.
    *
-   * @param sortOrder - The sort order.
-   * @param orderByList - The list of category values.
+   * @deprecated since 5.2. Use [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/pie-chart-model/pie-chart-model/#setDataSortOrder) instead. This method will be removed from `PieChartModel` in 6.0.
+   * @param sortOrder - The data sort order.
+   * @param orderByList - The list of category values when using `customSort`.
    */
   setSortOrder(sortOrder: PieChartDataSortingKinds, orderByList?: string[]): void;
   /**

package/dist/model/properties/series/negative-values-stacked-to-baseline.d.ts

@@ -5,7 +5,7 @@ export abstract class WithNegativeValuesStackedToBaseline extends ChartModelBase
   /**
    * Specify how negative values are treated in stacked series.
    *
-   * **Note:** If true, negative values will be stacked on the base line. If false, negative values will be stacked in relation to their previous values in the stack.
+   * **Note:** If `true`, negative values will be stacked on the base line. If `false`, negative values will be stacked in relation to their previous values in the stack.
    *
    * @param seriesIndex - The index of the series.
    */
@@ -13,7 +13,7 @@ export abstract class WithNegativeValuesStackedToBaseline extends ChartModelBase
   /**
    * Specify how negative values are treated in stacked series.
    *
-   * **Note:** If true, negative values will be stacked on the base line. If false, negative values will be stacked in relation to their previous values in the stack.
+   * **Note:** If `true`, negative values will be stacked on the base line. If `false`, negative values will be stacked in relation to their previous values in the stack.
    *
    * @param stackNegativeValuesToBaseline - `true` if negative values should be stacked on the base line, `false` otherwise.
    * @param seriesIndex - The index of the series.

package/dist/model/scatterplot-model/scatterplot-model.d.ts

@@ -13,7 +13,7 @@ import type { WithXAxisTitleText } from "../properties/axes/x-axis/x-axis-title-
 import type { WithXAxisTitleVisibility } from "../properties/axes/x-axis/x-axis-title-visibility.js";
 import type { WithGenerateXAxisTitle } from "../properties/axes/x-axis/generate-x-axis-title.js";
 import type { ChartConfig } from "../../utils/types/index.js";
-import type { ScatterplotOverlays, SizePolicy } from "../../spec/web-chart.js";
+import type { ScatterplotOverlays, SizePolicy, WebChartLocationOfInterest } from "../../spec/web-chart.js";
 import type { ISimpleLineSymbol, ISimpleMarkerSymbol } from "../../spec/rest-js-types.js";
 import type { ModelWithMultiAxes } from "../mixins/model-with-multi-axes.js";
 import type { ModelWithLegend } from "../mixins/model-with-legend.js";
@@ -33,6 +33,8 @@ export class ScatterplotModel extends ScatterplotModelSuperclass {
   accessor fixedMarkerSymbol: ISimpleMarkerSymbol;
   /** Line symbol for the linear trend line. */
   accessor linearTrendSymbol: ISimpleLineSymbol;
+  /** Locations of interest used for imagery scatterplot. */
+  accessor locationsOfInterest: WebChartLocationOfInterest[] | undefined;
   /** Trendline overlay for the scatterplot. */
   accessor seriesOverlays: ScatterplotOverlays | undefined;
   /** Whether the linear trend line is shown. */

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

@@ -1,7 +1,6 @@
 import type { WebChartStatisticType, WebChartStackedKinds } from "../../spec/chart-object-literals.js";
 import type { Color } from "../../spec/rest-js-types.js";
 import type { WebChartDataFilters, WebChartNullCategory } from "../../spec/web-chart.js";
-import type { ChartModel } from "../chart-model/chart-model.js";
 import type { HeatChartDataSortingKinds, SerialChartDataSortingKinds } from "../interfaces/common.js";
 import type { ModelWithLegend } from "../mixins/model-with-legend.js";
 import type { ModelWithMultiAxes } from "../mixins/model-with-multi-axes.js";
@@ -22,6 +21,8 @@ import type { WithDataLabelsSymbol } from "../properties/data-labels/data-labels
 import type { WithDataLabelsVisibility } from "../properties/data-labels/data-labels-visibility.js";
 import type { WithRotatedState } from "../properties/rotated-state.js";
 import type { WithTimeZone } from "../properties/time-zone.js";
+import type { ChartModel } from "../chart-model/chart-model.js";
+import type { ChartElementLimit } from "../../utils/defaults/interfaces.js";
 
 export abstract class SerialChartModel extends SerialChartModelSuperclass {
   /** The aggregation type for the chart. */
@@ -32,6 +33,12 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
    * **Note:** Setting this prop removes any existing temporal binning settings if `value` is set to `false`.
    */
   accessor binTemporalData: boolean;
+  /**
+   * The chart limits used when generating split-by series.
+   *
+   * @internal
+   */
+  accessor chartLimits: ChartElementLimit | undefined;
   /**
    * The null category configuration of the chart.
    *
@@ -47,6 +54,18 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
   accessor orderByList: string[];
   /** The split-by field for the chart. */
   accessor splitByField: string;
+  /**
+   * Get the number of split-by series before applying the configured chart limit.
+   *
+   * @internal
+   */
+  accessor splitBySeriesCount: number;
+  /**
+   * Gets whether split-by series were trimmed to the configured chart limit.
+   *
+   * @internal
+   */
+  accessor splitBySeriesLimitReached: boolean;
   /**
    * How the bars (lines) should be placed when multiple series are rendered in the same chart, say when "split by" operation is executed on any field or
    * when multiple attributes/fields corresponding to the same set of classes are to be visualized.
@@ -69,7 +88,31 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
   getAssignToSecondValueAxis(seriesIndex: number): boolean;
   /** Gets the list of the category values for the chart. */
   getCustomSortValues(): Promise<string[]>;
-  /** Gets the order of the series array by returning an array of series ids. */
+  /**
+   * Gets the data sort order for the 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 The current data sort order kind.
+   * @since 5.2
+   */
+  getDataSortOrder(): HeatChartDataSortingKinds | SerialChartDataSortingKinds;
+  /**
+   * Gets the order of the series array by returning 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/serial-chart-model/serial-chart-model/#getDataSortOrder), which
+   * orders categories or numeric values within the chart data.
+   */
   getOrderOfSeries(): string[];
   /**
    * Gets the color of the series based on the series index. If the index is out of bounds, it will return `undefined`.
@@ -90,11 +133,17 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
    * @param seriesIndex - The index of the series.
    */
   getSeriesToSecondaryYAxis(seriesIndex: number): boolean;
-  /** Gets the sort order for the bar chart. */
+  /**
+   * Gets the data sort order for the chart.
+   *
+   * @deprecated since 5.2. Use [getDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#getDataSortOrder) instead. This method will be removed from `SerialChartModel` in 6.0.
+   */
   getSortOrder(): HeatChartDataSortingKinds | SerialChartDataSortingKinds;
   /**
    * Moves 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 `SerialChartDataSortingKinds.customSort`.
+   *
+   * **Note:** This method should only be used when the data sort order is set to `SerialChartDataSortingKinds.customSort`
+   * via [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#setDataSortOrder).
    *
    * @param fromIndex - The index to move the custom sort value from.
    * @param toIndex - The index to move the custom sort value to.
@@ -123,9 +172,32 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
    * @param newDataFilter - The new data filter.
    */
   setDataFilters(newDataFilter: WebChartDataFilters | undefined): Promise<void>;
+  /**
+   * Sets the data sort order for the 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 [setOrderOfSeries](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#setOrderOfSeries), 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`)
+   *
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values to order by when using `customSort`.
+   * @since 5.2
+   */
+  setDataSortOrder(newSortOrder: HeatChartDataSortingKinds | SerialChartDataSortingKinds, orderByList?: string[]): void;
   /**
    * Sets the order of the series array by providing 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 [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#setDataSortOrder), which
+   * orders categories or numeric values within the chart data.
+   *
    * @param newOrder - The new order of the series array.
    */
   setOrderOfSeries(newOrder: string[]): void;
@@ -156,10 +228,11 @@ export abstract class SerialChartModel extends SerialChartModelSuperclass {
    */
   setSeriesToSecondaryYAxis(assign: boolean, seriesIndex: number): void;
   /**
-   * Sets the sort order for the bar chart.
+   * Sets the data sort order for the chart.
    *
-   * @param newSortOrder - The new sort order.
-   * @param orderByList - The list of category's values to order by.
+   * @deprecated since 5.2. Use [setDataSortOrder](https://developers.arcgis.com/javascript/latest/references/charts-components/model/serial-chart-model/serial-chart-model/#setDataSortOrder) instead. This method will be removed from `SerialChartModel` in 6.0.
+   * @param newSortOrder - The new data sort order.
+   * @param orderByList - The list of category values to order by when using `customSort`.
    */
   setSortOrder(newSortOrder: HeatChartDataSortingKinds | SerialChartDataSortingKinds, orderByList?: string[]): void;
   /**

package/dist/model/shared/setup-utils.d.ts

@@ -1,7 +1,8 @@
-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 { CommonStrings } from "../../utils/localization/interfaces.js";
 import type { ChartConfig } from "../../utils/types/index.js";
+import type { ChartElementLimit } from "../../utils/defaults/interfaces.js";
 import type { ModelOfType, ModelTypes } from "../interfaces/common.js";
 
 /**
@@ -25,6 +26,7 @@ export function createModel<T extends ModelTypes>(props: CreateModelProps<T>): P
  */
 export type CreateModelProps<T extends ModelTypes> = (ILayerAndSourcelessConfig<T> | ILayerAndType<T> | LayerAndSourcelessConfig<T> | LayerAndType<T> | SourcedConfig<T>) & {
   commonStrings?: CommonStrings;
+  chartLimits?: ChartElementLimit;
 };
 
 /**
@@ -33,7 +35,7 @@ export type CreateModelProps<T extends ModelTypes> = (ILayerAndSourcelessConfig<
  * A new model of the specified type will be created using default values.
  */
 export type LayerAndType<T extends ModelTypes> = {
-  layer: ChartLayerInput;
+  layer: ChartLayerInputSansView;
   chartType: T;
 };
 
@@ -53,7 +55,7 @@ export type ILayerAndType<T extends ModelTypes> = {
  * The `config` is considered "sourceless" since its `iLayer` property is not required.
  */
 export type LayerAndSourcelessConfig<T extends ModelTypes> = {
-  layer: ChartLayerInput;
+  layer: ChartLayerInputSansView;
   config: ChartConfig<T>;
 };
 

package/dist/model/shared/setup-utils.js

@@ -1,80 +1,81 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import { M as o } from "../../chunks/common.js";
+import { M as i } from "../../chunks/common.js";
 import { g as r, i as n, c } from "../../chunks/model-types.js";
-async function s(a) {
-  const i = "config" in a ? r(a.config) : a.chartType;
-  let t;
-  if (!("layer" in a) && !("iLayer" in a) && "config" in a && a.config.iLayer === void 0)
+async function m(t) {
+  const o = "config" in t ? r(t.config) : t.chartType;
+  let a;
+  if (!("layer" in t) && !("iLayer" in t) && "config" in t && t.config.iLayer === void 0)
     throw new Error(
       "The source is missing. You can provide it to createModel through either `iLayer`, `layer`, or by setting the `config.iLayer` property."
     );
-  switch (i) {
-    case o.LineChart: {
+  switch (o) {
+    case i.LineChart: {
       const { LineChartModel: e } = await import("../../chunks/line-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.ComboBarLineChart: {
+    case i.ComboBarLineChart: {
       const { ComboBarLineChartModel: e } = await import("../../chunks/combo-bar-line-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.PieChart: {
+    case i.PieChart: {
       const { PieChartModel: e } = await import("../../chunks/pie-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.Histogram: {
+    case i.Histogram: {
       const { HistogramModel: e } = await import("../../chunks/histogram-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.Scatterplot: {
+    case i.Scatterplot: {
       const { ScatterplotModel: e } = await import("../../chunks/scatterplot-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.BoxPlot: {
+    case i.BoxPlot: {
       const { BoxPlotModel: e } = await import("../../chunks/box-plot-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.Gauge: {
+    case i.Gauge: {
       const { GaugeModel: e } = await import("../../chunks/gauge-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.RadarChart: {
+    case i.RadarChart: {
       const { RadarChartModel: e } = await import("../../chunks/radar-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.HeatChart: {
+    case i.HeatChart: {
       const { HeatChartModel: e } = await import("../../chunks/heat-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
-    case o.BarChart:
+    case i.BarChart:
     default: {
       const { BarChartModel: e } = await import("../../chunks/bar-chart-model.js");
-      t = new e();
+      a = new e();
       break;
     }
   }
-  if (await t?.setup({
-    layer: "layer" in a ? a.layer : void 0,
-    iLayer: "iLayer" in a ? a.iLayer : void 0,
-    config: "config" in a ? a.config : void 0,
-    commonStrings: "commonStrings" in a ? a.commonStrings : void 0
-  }), i !== void 0 && n(t, i))
-    return t;
+  if (await a?.setup({
+    layer: "layer" in t ? t.layer : void 0,
+    iLayer: "iLayer" in t ? t.iLayer : void 0,
+    config: "config" in t ? t.config : void 0,
+    commonStrings: "commonStrings" in t ? t.commonStrings : void 0,
+    chartLimits: "chartLimits" in t ? t.chartLimits : void 0
+  }), o !== void 0 && n(a, o))
+    return a;
   {
-    const e = c(t.chartType);
+    const e = c(a.chartType);
     throw new Error(
-      `Please check the arguments provided to \`createModel\`. The generated model's type (\`${e}\`) does not match the type specified by either the \`chartType\` or the \`config\` argument (\`${i}\`).`
+      `Please check the arguments provided to \`createModel\`. The generated model's type (\`${e}\`) does not match the type specified by either the \`chartType\` or the \`config\` argument (\`${o}\`).`
     );
   }
 }
 export {
-  s as createModel
+  m as createModel
 };