@arcgis/charts-components 5.1.0-next.99 → 5.1.0

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,chartIndex,chartLimits:,chartWillRender:,commonStrings:,configurationEnabled,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableAutoTheming,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"), "_messages:,actionMode,allowUsingObjectIdStat,animationEnabled,aria:,autoDestroyDisabled,autoDisposeChart,autoInverseDataLabelTextColor,calciteThemingCSSVariables:,chartIndex,chartLimits:,chartWillRender:,commonStrings:,configurationEnabled,cursorRange,dataLabelFormatter:,disableInteractions,disableTogglingLegendItems,enableBetaFeatures,enableConfiguration,enableResponsiveFeatures,errorPolicy,featureIndex,filterByExtent,filterBySelection,filterByViewExtent,gaugeInnerLabelFormatter:,guideTooltipFormatter:,hideEmptySeries,hideLicenseWatermark,hideLoaderAnimation,hideUIMessages,hideZeroCountCategories,ignoreSmoothRenderingLimit,ignoreViewExtent,interactionsDisabled,layer:,layerFieldsChangePolicy,layerFilterChangePolicy,layerItemId,layerRendererChangePolicy,legendPosition,legendValueLabelFormatter:,legendVisibility,loaderColors:,messageOverrides:,model:,nullAsValid,placeholder,popupTemplateFieldInfosEnabled,queueChartCreation,replaceNoValueCategoryWithZero,returnFeaturesExtent,returnSelectionIndexes,returnSelectionOIDs,rotated,rotation,runtimeDataFilters:,secondaryYAxisLabelFormatter:,selectionData:,selectionManager:,selectionTheme:,setTimeBinningInfoWhenNotProvided,showEmptySeries,showLicenseWatermark,showUIMessages,skipChartCreationQueue,syncChartsSelection,syncSelection,syncSelectionsBetweenChartAndLayerViewPolicy,syncViewSelection,syncViewTimeExtent,syncViewTimeZone,syncViewTimeZoneInclusionList:,timeZone,togglingLegendItemsDisabled,tooltipFormatter:,updateSplitBySeries:,useAnimatedCharts,usePopupTemplateFieldsInfo,view:,viewTimeExtentChangePolicy,xAxisLabelFormatter:,yAxisLabelFormatter:;clearSelection,destroy,errorAlert,exportAsCSV,exportAsImage,loadModel,notify,refresh,resetZoom,switchSelection;applySelectionFromSelectionManager"],
   "arcgis-charts-action-bar": [() => import("./components/arcgis-charts-action-bar/customElement.js"), "_messages:,actionBarSelectionMode,chartElement:,chartType,clearSelectionState,clearSelectionTitle,clearSelectionToggle,commonStrings:,csvExportExclusionList:,disableCSVExportForChartTypes:,editChartState,editChartTitle,editChartToggle,expanded,exportActionState,exportAsCSVState,exportAsCSVTitle,exportAsImageState,exportAsImageTitle,filterByExtentState,filterByExtentTitle,filterByExtentToggle,filterBySelectionState,filterBySelectionTitle,filterBySelectionToggle,forceDisableActions,fullExtentState,fullExtentTitle,fullExtentToggle,hiddenActions:,legendState,legendTitle,legendToggle,messageOverrides:,rotateChartState,rotateChartTitle,rotateChartToggle,selectionState,selectionTitle,selectionToggle,switchSelectionState,switchSelectionTitle,switchSelectionToggle,zoomState,zoomTitle,zoomToggle"],
   "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"],
@@ -54,7 +54,7 @@ const r = t(e, {
   "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"), "calciteThemeApplied,enableAutoTheming,heading,loaderColors:,message,showLoader"]
+  "arcgis-charts-info-modal": [() => import("./components/arcgis-charts-info-modal/customElement.js"), "calciteThemeColors:,heading,loaderColors:,message,showLoader"]
 });
 export {
   r as defineCustomElements

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

@@ -1,26 +1,26 @@
+import type { RESTSimpleLineSymbolStyle } from "../../spec/rest-js-object-literals.js";
+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";
+import type { ModelWithMultiAxes } from "../mixins/model-with-multi-axes.js";
+import type { ModelWithTooltips } from "../mixins/model-with-tooltips.js";
+import type { ModelWithYGuides } from "../mixins/model-with-y-guides.js";
 import type { WithAxisLabelsSymbol } from "../properties/axes/axis-labels-symbol.js";
 import type { WithAxisLinesSymbol } from "../properties/axes/axis-lines-symbol.js";
-import type { WithXBounds } from "../properties/axes/x-axis/x-bounds.js";
+import type { WithGenerateXAxisTitle } from "../properties/axes/x-axis/generate-x-axis-title.js";
 import type { WithXAxisLabelsVisibility } from "../properties/axes/x-axis/x-axis-labels-visibility.js";
 import type { WithXAxisTitleSymbol } from "../properties/axes/x-axis/x-axis-title-symbol.js";
 import type { WithXAxisTitleText } from "../properties/axes/x-axis/x-axis-title-text.js";
 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 { WithXBounds } from "../properties/axes/x-axis/x-bounds.js";
 import type { WithColorMatch } from "../properties/color-match.js";
-import type { WithRotatedState } from "../properties/rotated-state.js";
-import type { WithDataLabelsVisibility } from "../properties/data-labels/data-labels-visibility.js";
 import type { WithDataLabelsSymbol } from "../properties/data-labels/data-labels-symbol.js";
-import type { WebChartDataFilters } from "../../spec/web-chart.js";
-import type { Color } from "../../spec/rest-js-types.js";
-import type { RESTSimpleLineSymbolStyle } from "../../spec/rest-js-object-literals.js";
-import type { ChartConfig } from "../../utils/types/index.js";
-import type { ModelWithMultiAxes } from "../mixins/model-with-multi-axes.js";
-import type { ModelWithLegend } from "../mixins/model-with-legend.js";
-import type { ModelWithTooltips } from "../mixins/model-with-tooltips.js";
-import type { ModelWithYGuides } from "../mixins/model-with-y-guides.js";
+import type { WithDataLabelsVisibility } from "../properties/data-labels/data-labels-visibility.js";
+import type { WithRotatedState } from "../properties/rotated-state.js";
 
 export class BoxPlotModel extends BoxPlotModelSuperclass {
   /**

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

@@ -1,7 +1,7 @@
+import type { ChartTypes } from "../../utils/misc/index.js";
+import type { ChartConfig } from "../../utils/types/index.js";
 import type { ModelParams } from "../interfaces/chart-interfaces.js";
 import type { ChartModel } from "./chart-model.js";
-import type { ChartConfig } from "../../utils/types/index.js";
-import type { ChartTypes } from "../../utils/misc/index.js";
 
 export abstract class ChartModelBase extends EventTarget {
   constructor(...args: any[]);

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

@@ -19,10 +19,11 @@ import type { WithSeriesId } from "../properties/series/series-id.js";
 import type { WithSeriesIndex } from "../properties/series/series-index.js";
 import type { WithSeriesLength } from "../properties/series/series-length.js";
 import type { WithChartSubType } from "../properties/chart-sub-type.js";
+import type { WithSeriesDataTooltipFontSize } from "../properties/data-tooltip-font-size.js";
 import type { WithSeriesDataTooltipValueFormat } from "../properties/data-tooltip-value-format.js";
 import type { WithFetchNULLValues } from "../properties/fetch-null-values.js";
 import type { WithSplitByValues } from "../properties/split-by-values.js";
 import type { WithDataFilters } from "../properties/data-filters.js";
 
 export abstract class ChartModel extends ChartModelSuperclass {}
-declare const ChartModelSuperclass: typeof ChartModelBase & typeof WithDataFilters & typeof WithSplitByValues & typeof WithFetchNULLValues & typeof WithSeriesDataTooltipValueFormat & typeof WithChartSubType & typeof WithSeriesLength & typeof WithSeriesIndex & typeof WithSeriesId & typeof WithSeriesVisibility & typeof WithBackgroundColor & typeof WithChartRenderer & typeof WithDescriptionVisibility & typeof WithChartSubtitleVisibility & typeof WithChartTitleVisibility & typeof WithDescriptionSymbol & typeof WithDescriptionText & typeof WithSubtitleSymbol & typeof WithSubtitleText & typeof WithVersion & typeof WithTitleSymbol & typeof WithTitleText & typeof WithChartId & typeof WithLayer & typeof WithConfig
+declare const ChartModelSuperclass: typeof ChartModelBase & typeof WithDataFilters & typeof WithSplitByValues & typeof WithFetchNULLValues & typeof WithSeriesDataTooltipFontSize & typeof WithSeriesDataTooltipValueFormat & typeof WithChartSubType & typeof WithSeriesLength & typeof WithSeriesIndex & typeof WithSeriesId & typeof WithSeriesVisibility & typeof WithBackgroundColor & typeof WithChartRenderer & typeof WithDescriptionVisibility & typeof WithChartSubtitleVisibility & typeof WithChartTitleVisibility & typeof WithDescriptionSymbol & typeof WithDescriptionText & typeof WithSubtitleSymbol & typeof WithSubtitleText & typeof WithVersion & typeof WithTitleSymbol & typeof WithTitleText & typeof WithChartId & typeof WithLayer & typeof WithConfig

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

@@ -1,19 +1,19 @@
+import type { GaugeChartSubTypes, WebChartStatisticType } from "../../spec/chart-object-literals.js";
+import type { ISimpleFillSymbol } from "../../spec/rest-js-types.js";
+import type { ValueConversion, WebChartGaugeFixedProgressBands, WebChartTextSymbol } 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 } from "../interfaces/common.js";
+import type { ModelWithXGuides } from "../mixins/model-with-x-guides.js";
 import type { WithAxisLabelsSymbol } from "../properties/axes/axis-labels-symbol.js";
 import type { WithAxisLinesSymbol } from "../properties/axes/axis-lines-symbol.js";
-import type { WithXBounds } from "../properties/axes/x-axis/x-bounds.js";
+import type { WithGenerateXAxisTitle } from "../properties/axes/x-axis/generate-x-axis-title.js";
 import type { WithXAxisLabelsVisibility } from "../properties/axes/x-axis/x-axis-labels-visibility.js";
 import type { WithXAxisTitleSymbol } from "../properties/axes/x-axis/x-axis-title-symbol.js";
 import type { WithXAxisTitleText } from "../properties/axes/x-axis/x-axis-title-text.js";
 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 { ValueConversion, WebChartTextSymbol } from "../../spec/web-chart.js";
-import type { GaugeChartSubTypes, WebChartStatisticType } from "../../spec/chart-object-literals.js";
-import type { ISimpleFillSymbol } from "../../spec/rest-js-types.js";
-import type { ChartConfig } from "../../utils/types/index.js";
-import type { ModelWithXGuides } from "../mixins/model-with-x-guides.js";
+import type { WithXBounds } from "../properties/axes/x-axis/x-bounds.js";
 
 export class GaugeModel extends GaugeModelSuperclass {
   /**
@@ -85,6 +85,24 @@ export class GaugeModel extends GaugeModelSuperclass {
   accessor needleVisibility: boolean;
   /** Whether to only show the first and last axis labels. */
   accessor onlyShowFirstAndLastLabels: boolean;
+  /**
+   * Gauge progress bands configuration.
+   *
+   * @example
+   * ```ts
+   * gaugeModel.progressBands = {
+   *  type: "fixed",
+   *  visible: true,
+   *  bands: {
+   *    target: { type: "esriSFS", color: [0, 255, 0, 255] },
+   *    base: { type: "esriSFS", color: [255, 0, 0, 255] }
+   *  }
+   * };
+   * ```
+   */
+  accessor progressBands: WebChartGaugeFixedProgressBands | undefined;
+  /** Whether progress bands are visible. */
+  accessor progressBandsVisibility: boolean;
   /** Start angle of the gauge. */
   accessor startAngle: number;
   /** Conversion to apply to the gauge value. */

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

@@ -30,6 +30,8 @@ export class HeatChartModel extends SerialChartModel {
    * `manual` - Allows you to manually specify the class breaks.
    */
   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. */
   accessor emptyCell: WebChartHeatChartEmptyCell | undefined;
   /** The heat chart's empty cell symbol. */
@@ -77,6 +79,11 @@ export class HeatChartModel extends SerialChartModel {
   accessor hideEmptyRowsAndColumns: boolean | undefined;
   /** Whether to include leap day (February 29) in the heat chart when using "day of month" temporal binning. */
   accessor includeLeapDay: boolean | undefined;
+  /**
+   * Whether the color ramp is flipped for the heat chart,
+   * which means the colors will be reversed (e.g., if the original color ramp goes from light to dark, flipping it will make it go from dark to light).
+   */
+  accessor isColorRampFlipped: boolean;
   /** The layer associated with the heat chart model. */
   get layer(): Exclude<SerialChartModel["layer"], SupportedRasterLayer>;
   /** The heat chart's legend position. */

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

@@ -1,8 +1,9 @@
-import type { ModelTypes } from "./common.js";
 import type { SupportedLayer, SupportedRasterLayer } from "../../interfaces.js";
-import type { ChartConfig } from "../../utils/types/index.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 { ModelTypes } from "./common.js";
 
 /** Parameters for creating a chart model. */
 export type ModelParams<T extends ChartConfig> = {
@@ -12,6 +13,8 @@ export type ModelParams<T extends ChartConfig> = {
   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;
 };
 
 /** Type alias for the supported serial chart config. */

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

@@ -163,11 +163,9 @@ export const ModelTypes: {
 
 export type ModelTypes = (typeof ModelTypes)[keyof typeof ModelTypes];
 
-/** @internal */
 export type ModelTypeToSeriesType<T extends ModelTypes> = T extends typeof ModelTypes.BarChart ? WebChartBarChartSeries : T extends typeof ModelTypes.LineChart ? WebChartLineChartSeries : T extends typeof ModelTypes.ComboBarLineChart ? WebChartBarChartSeries | WebChartLineChartSeries : T extends typeof ModelTypes.BoxPlot ? WebChartBoxPlotSeries | WebChartLineChartSeries : T extends typeof ModelTypes.PieChart ? WebChartPieChartSeries : T extends typeof ModelTypes.Scatterplot ? WebChartScatterplotSeries : T extends typeof ModelTypes.Histogram ? WebChartHistogramSeries : T extends typeof ModelTypes.Gauge ? WebChartGaugeSeries : T extends typeof ModelTypes.RadarChart ? WebChartRadarChartSeries : T extends typeof ModelTypes.HeatChart ? WebChartHeatChartSeries : SupportedChartSeries;
 
 /** @internal */
 export type SeriesTypeToChartType<T extends SupportedChartSeries> = T extends WebChartBarChartSeries ? typeof WebChartTypes.BarSeries : T extends WebChartLineChartSeries ? typeof WebChartTypes.LineSeries : T extends WebChartBoxPlotSeries ? typeof WebChartTypes.BoxPlotSeries : T extends WebChartPieChartSeries ? typeof WebChartTypes.PieSeries : T extends WebChartScatterplotSeries ? typeof WebChartTypes.ScatterSeries : T extends WebChartHistogramSeries ? typeof WebChartTypes.HistogramSeries : T extends WebChartGaugeSeries ? typeof WebChartTypes.GaugeSeries : T extends WebChartRadarChartSeries ? typeof WebChartTypes.RadarSeries : T extends WebChartHeatChartSeries ? typeof WebChartTypes.HeatSeries : never;
 
-/** @internal */
 export type ModelOfType<T> = T extends typeof ModelTypes.BarChart ? BarChartModel : T extends typeof ModelTypes.BoxPlot ? BoxPlotModel : T extends typeof ModelTypes.LineChart ? LineChartModel : T extends typeof ModelTypes.ComboBarLineChart ? ComboBarLineChartModel : T extends typeof ModelTypes.PieChart ? PieChartModel : T extends typeof ModelTypes.Scatterplot ? ScatterplotModel : T extends typeof ModelTypes.Histogram ? HistogramModel : T extends typeof ModelTypes.Gauge ? GaugeModel : T extends typeof ModelTypes.RadarChart ? RadarChartModel : T extends typeof ModelTypes.HeatChart ? HeatChartModel : never;

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

@@ -1,9 +1,9 @@
+import type { ChartConfig } from "../../utils/types/index.js";
 import type { ModelParams } from "../interfaces/chart-interfaces.js";
 import type { ModelTypes } from "../interfaces/common.js";
-import type { SerialChartModel } from "../serial-chart-model/serial-chart-model.js";
-import type { WithNegativeValuesStackedToBaseline } from "../properties/series/negative-values-stacked-to-baseline.js";
-import type { ChartConfig } from "../../utils/types/index.js";
 import type { ModelWithLineMarkerStyling } from "../mixins/model-with-line-marker-styling.js";
+import type { WithNegativeValuesStackedToBaseline } from "../properties/series/negative-values-stacked-to-baseline.js";
+import type { SerialChartModel } from "../serial-chart-model/serial-chart-model.js";
 
 export class LineChartModel extends LineChartModelSuperclass {
   /** Returns whether the series styling is able to be reset. */

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

@@ -1,15 +1,15 @@
+import type { WebChartStatisticType } from "../../spec/chart-object-literals.js";
+import type { Color, ISimpleLineSymbol } from "../../spec/rest-js-types.js";
+import type { WebChartPieChartGroupSlice, WebChartPieChartSlice } 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, PieChartDataSortingKinds, PieChartSlicesDisplay, PieChartDataModes } from "../interfaces/common.js";
+import type { ModelWithTooltips } from "../mixins/model-with-tooltips.js";
 import type { WithColorMatch } from "../properties/color-match.js";
-import type { WithDataLabelsVisibility } from "../properties/data-labels/data-labels-visibility.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 { PieChartLegendModel } from "./pie-chart-legend-model.js";
-import type { ChartConfig } from "../../utils/types/index.js";
-import type { WebChartPieChartGroupSlice, WebChartPieChartSlice } from "../../spec/web-chart.js";
-import type { WebChartStatisticType } from "../../spec/chart-object-literals.js";
-import type { Color, ISimpleLineSymbol } from "../../spec/rest-js-types.js";
-import type { ModelWithTooltips } from "../mixins/model-with-tooltips.js";
 
 export class PieChartModel extends PieChartModelSuperclass {
   /** Aggregation type for the pie chart. */

package/dist/model/properties/axes/x-axis/x-bounds.d.ts

@@ -3,6 +3,5 @@ import type { WithMaxXBound } from "./max-x-bound.js";
 import type { WithMinXBound } from "./min-x-bound.js";
 
 /** Adds support for configuring both minimum and maximum x-axis bounds. */
-export abstract class WithXBounds extends ChartModelBase {}
-
-export interface WithXBounds extends WithMaxXBound, WithMinXBound {}
+export abstract class WithXBounds extends WithXBoundsSuperclass {}
+declare const WithXBoundsSuperclass: typeof ChartModelBase & typeof WithMinXBound & typeof WithMaxXBound

package/dist/model/properties/data-tooltip-font-size.d.ts

@@ -0,0 +1,20 @@
+import type { ChartModelBase } from "../chart-model/chart-model-base.js";
+
+/** Adds support for working with data tooltip font sizes. */
+export abstract class WithSeriesDataTooltipFontSize extends ChartModelBase {
+  /**
+   * Gets the data tooltip font size for a series.
+   *
+   * If the series index is out of bounds or the series list is empty, this function will return `undefined`.
+   *
+   * @param seriesIndex - The index of the series to retrieve the font size for.
+   */
+  getDataTooltipFontSize(seriesIndex: number): number | undefined;
+  /**
+   * Sets the data tooltip font size for a series.
+   *
+   * @param fontSize - The font size to set.
+   * @param seriesIndex - The index of the series to set the font size for.
+   */
+  setDataTooltipFontSize(fontSize: number | undefined, seriesIndex: number): void;
+}

package/dist/model/properties/rotated-state.d.ts

@@ -7,7 +7,7 @@ export abstract class WithRotatedState extends ChartModelBase {
   /**
    * Whether the chart is rotated.
    *
-   * @deprecated since 5.1. Use `rotated` instead.
+   * @deprecated since 5.1. Use [rotated](https://developers.arcgis.com/javascript/latest/references/charts-components/model/properties/rotated-state/#rotated) instead.
    */
   accessor rotatedState: boolean;
 }

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

@@ -1,7 +1,8 @@
-import type { ModelOfType, ModelTypes } from "../interfaces/common.js";
 import type { SupportedLayer, SupportedRasterLayer } 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 { ModelOfType, ModelTypes } from "../interfaces/common.js";
 
 /**
  * Creates a new chart model for config interaction based on the provided properties.
@@ -22,7 +23,9 @@ export function createModel<T extends ModelTypes>(props: CreateModelProps<T>): P
  * Properties used by the `createModel` function to create a new model.
  * Various combinations of `layer`, `iLayer`, `chartType`, and `config` are supported.
  */
-export type CreateModelProps<T extends ModelTypes> = ILayerAndSourcelessConfig<T> | ILayerAndType<T> | LayerAndSourcelessConfig<T> | LayerAndType<T> | SourcedConfig<T>;
+export type CreateModelProps<T extends ModelTypes> = (ILayerAndSourcelessConfig<T> | ILayerAndType<T> | LayerAndSourcelessConfig<T> | LayerAndType<T> | SourcedConfig<T>) & {
+  commonStrings?: CommonStrings;
+};
 
 /**
  * Properties used by the `createModel` function to create a new model based on the provided `layer` and `chartType`.

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

@@ -0,0 +1,80 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
+import { M as o } 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)
+    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: {
+      const { LineChartModel: e } = await import("../../chunks/line-chart-model.js");
+      t = new e();
+      break;
+    }
+    case o.ComboBarLineChart: {
+      const { ComboBarLineChartModel: e } = await import("../../chunks/combo-bar-line-chart-model.js");
+      t = new e();
+      break;
+    }
+    case o.PieChart: {
+      const { PieChartModel: e } = await import("../../chunks/pie-chart-model.js");
+      t = new e();
+      break;
+    }
+    case o.Histogram: {
+      const { HistogramModel: e } = await import("../../chunks/histogram-model.js");
+      t = new e();
+      break;
+    }
+    case o.Scatterplot: {
+      const { ScatterplotModel: e } = await import("../../chunks/scatterplot-model.js");
+      t = new e();
+      break;
+    }
+    case o.BoxPlot: {
+      const { BoxPlotModel: e } = await import("../../chunks/box-plot-model.js");
+      t = new e();
+      break;
+    }
+    case o.Gauge: {
+      const { GaugeModel: e } = await import("../../chunks/gauge-model.js");
+      t = new e();
+      break;
+    }
+    case o.RadarChart: {
+      const { RadarChartModel: e } = await import("../../chunks/radar-chart-model.js");
+      t = new e();
+      break;
+    }
+    case o.HeatChart: {
+      const { HeatChartModel: e } = await import("../../chunks/heat-chart-model.js");
+      t = new e();
+      break;
+    }
+    case o.BarChart:
+    default: {
+      const { BarChartModel: e } = await import("../../chunks/bar-chart-model.js");
+      t = 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;
+  {
+    const e = c(t.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}\`).`
+    );
+  }
+}
+export {
+  s as createModel
+};

package/dist/spec/chart-object-literals.d.ts

@@ -8,6 +8,7 @@ export const WebChartTypes: {
     readonly Axis: "chartAxis";
     readonly GaugeAxisTick: "gaugeAxisTick";
     readonly GaugeNeedle: "gaugeNeedle";
+    readonly FixedProgressBands: "fixed";
     readonly CategoryAxisFormat: "category";
     readonly NumberAxisFormat: "number";
     readonly DateAxisFormat: "date";

package/dist/spec/rest-js-object-literals.d.ts

@@ -108,7 +108,7 @@ export const RESTFontDecoration: {
 /** @deprecated since 5.1. Won't be replaced. */
 export type RESTFontDecoration = (typeof RESTFontDecoration)[keyof typeof RESTFontDecoration];
 
-/** @deprecated since 5.1. Use core's Query["units"] instead. */
+/** @deprecated since 5.1. Use [Query#units](https://developers.arcgis.com/javascript/latest/references/core/rest/support/Query/#units) instead. */
 export const RESTUnits: {
     readonly Feet: "feet";
     readonly Miles: "miles";
@@ -118,7 +118,7 @@ export const RESTUnits: {
     readonly Kilometers: "kilometers";
 };
 
-/** @deprecated since 5.1. Use core's Query["units"] instead. */
+/** @deprecated since 5.1. Use [Query#units](https://developers.arcgis.com/javascript/latest/references/core/rest/support/Query/#units) instead. */
 export type RESTUnits = (typeof RESTUnits)[keyof typeof RESTUnits];
 
 export const RESTRendererType: {

package/dist/spec/rest-js-types.d.ts

@@ -71,7 +71,16 @@ export interface IGeometry {
   spatialReference?: ISpatialReference;
 }
 
-/** @internal */
+/**
+ * A simple point geometry, with spatial reference defined.
+ *
+ * `IPoint` can also be imported from the following packages:
+ *
+ * ```js
+ * import { IPoint } from "@esri/arcgis-rest-routing";
+ * import { IPoint } from "@esri/arcgis-rest-geocoding";
+ * ```
+ */
 export interface IPoint extends IHasZM, IGeometry {
   x: number;
   y: number;
@@ -90,7 +99,7 @@ export interface ILocation {
   z?: number;
 }
 
-/** @internal */
+/** Polyline geometry. */
 export interface IPolyline extends IHasZM, IGeometry {
   paths: Position[][];
 }
@@ -103,12 +112,12 @@ export interface IPolylineWithCurves extends IHasZM, IGeometry {
   curvePaths: (JsonCurve | Position)[][];
 }
 
-/** @internal */
+/** Polygon geometry. */
 export interface IPolygon extends IHasZM, IGeometry {
   rings: Position[][];
 }
 
-/** @internal */
+/** Polygon geometry with curves. */
 export interface IPolygonWithCurves extends IHasZM, IGeometry {
   curveRings: (JsonCurve | Position)[][];
 }
@@ -1367,7 +1376,6 @@ export interface IBingLayer extends ILayer {
   portalUrl?: string;
 }
 
-/** @internal */
 export interface IImageServiceLayer extends ILayer, ISupportsTime {
   /** An array of bandIds that are visible, can specify bands to export or rearrange band order(from image service). */
   bandIds?: number[];
@@ -1748,7 +1756,7 @@ export interface IOpenStreetMapLayer extends ILayer {
   type?: "OpenStreetMap";
 }
 
-/** @internal */
+/** Tiled image service layer definition. */
 export interface ITiledImageServiceLayer extends ILayer {
   /** Applicable if used as a baseMapLayer. A boolean value indicating whether or not the baseMapLayer draws on top (true) of other layers, including operationalLayers , or below (false). */
   isReference?: boolean;
@@ -1758,7 +1766,7 @@ export interface ITiledImageServiceLayer extends ILayer {
   refreshInterval?: number;
 }
 
-/** @internal */
+/** Web Coverage Service (WCS) layer definition. */
 export interface IWCSLayer extends ILayer {
   /** Applicable if used as a baseMapLayer. A boolean value indicating whether or not the baseMapLayer draws on top (true) of other layers, including operationalLayers , or below (false). */
   isReference?: boolean;
@@ -1935,7 +1943,13 @@ export interface ICsvLayer extends ILayer {
   type?: "CSV";
 }
 
-/** @internal */
+/**
+ * Feature layers can be created by referencing a layer from either a map service or a feature service or by specifying a feature collection object.
+ * Use a map service if you just want to retrieve geometries and attributes from the server and symbolize them yourself. Use a feature service if
+ * you want to take advantage of symbols from the service's source map document. Also, use a feature service if you plan on doing editing with the
+ * feature layer. Feature layers honor any feature templates configured in the source map document. Feature collection objects are used to create
+ * a feature layer based on the supplied definition.
+ */
 export interface IFeatureLayer extends ILayer, ISupportsTime {
   /** A comma-separated string listing which editing operations are allowed on an editable feature service. */
   capabilities?: string;

package/dist/spec/web-chart.d.ts

@@ -4,7 +4,7 @@ import type { RESTUnits } from "./rest-js-object-literals.js";
 import type { Color, IDrawingInfo, IEnvelope, IExtent, IFeatureLayer, IImageServiceLayer, IPoint, IPolygon, IPolygonWithCurves, IPolyline, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, IStatisticDefinition, ITextSymbol, ITiledImageServiceLayer, IWCSLayer } from "./rest-js-types.js";
 
 /** Version of the current specification. */
-export const WebChartCurrentVersion: "25.0.0";
+export const WebChartCurrentVersion: "25.1.0";
 
 /** Stores information regarding a numeric conversion. */
 export interface ValueConversion {
@@ -202,7 +202,7 @@ export interface WebChartOverlay {
 export interface NumberFormatOptions {
   /** Represents a unique string identifier for the `NumberFormatOptions` object. For the `NumberFormatOptions` object, it is `number`. It can help to differentiate numerical (value) axis from other types of axes such as date-time axis and category axis. */
   type: typeof WebChartTypes.NumberAxisFormat;
-  /** Represents the JS native [Intl.NumberFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat), which is based on [CLDR](http://cldr.unicode.org/translation/numbers-currency/number-patterns) specifications. */
+  /** Represents the JS native [Intl.NumberFormatOptions](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/NumberFormat), which is based on [CLDR](https://cldr.unicode.org/translation/number-currency-formats/number-and-currency-patterns) specifications. */
   intlOptions: Intl.NumberFormatOptions;
 }
 
@@ -232,7 +232,7 @@ export interface WebChartDateTimeUnitFormatOptions {
 export interface DateTimeFormatOptions {
   /** Represents a unique string identifier for the `NumberFormatOptions` object. For the `NumberFormatOptions` object, it is `date`. It can help to differentiate date-time axis from other types of axes such as numeric (value) axis and category axis. */
   type: typeof WebChartTypes.DateAxisFormat;
-  /** Represent the JS native [Intl.DateTimeFormatOptions](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat), which is based on [CLDR](http://cldr.unicode.org/translation/date-time-1/date-time-patterns) specifications. */
+  /** Represent the JS native [Intl.DateTimeFormatOptions](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/DateTimeFormat), which is based on [CLDR](https://cldr.unicode.org/translation/date-time/date-time-patterns) specifications. */
   intlOptions: Intl.DateTimeFormatOptions;
   /** Represents how to format specific date and time units when displayed on the axis, independently from the `intlOptions`. */
   formatPerDateTimeUnit?: WebChartDateTimeUnitFormatOptions;
@@ -411,6 +411,41 @@ export interface WebChartNeedle {
   displayPin?: boolean;
 }
 
+/**
+ * JSON representation of the fixed progress bands for gauge chart, which is a specific type of guide for gauge charts.
+ * It defines the properties of the fixed progress bands and how they should be rendered on a gauge chart.
+ *
+ * The "target" band's start value is set to the axis minimum, end value is set to the gauge value, and the color is what defined in the bands config.
+ * Similarly, the "base" band's start value is set to the gauge value, end value is set to the axis maximum, and the color is what defined in the bands config.
+ *
+ * @example
+ * ```json
+ * "progressBands": {
+ *   "type": "fixed",
+ *   "visible": true,
+ *   "bands": {
+ *     "target": { "type": "esriSFS", "color": [0, 255, 0, 255] },
+ *     "base": { "type": "esriSFS", "color": [255, 0, 0, 255] }
+ *   }
+ * }
+ * ```
+ */
+export interface WebChartGaugeFixedProgressBands {
+  /** Represents a unique string identifier for the fixed progress bands object. For `WebChartGaugeFixedProgressBands` object, it is `fixed`. */
+  type: typeof WebChartTypes.FixedProgressBands;
+  /**
+   * Determines the visibility of the fixed progress bands on the gauge chart.
+   *
+   * @default true
+   */
+  visible?: boolean;
+  /** Contains styling information on how the fixed progress bands should be rendered. */
+  bands?: {
+      target?: ISimpleFillSymbol;
+      base?: ISimpleFillSymbol;
+  };
+}
+
 /** JSON representation of the gauge chart's axis object. Inherits from the `WebChartAxis` properties. */
 export interface WebChartGaugeAxis extends WebChartAxis {
   /** Specifies how the axis' inner label needs to be displayed. */
@@ -464,6 +499,12 @@ export interface WebChartGaugeAxis extends WebChartAxis {
    * When `maximumFromField` is not provided or when it leads to an invalid value, the `maximum` value from the axis config, if provided, or the default value of 0, in that order, will be used.
    */
   maximumFromField?: IStatisticDefinition | string;
+  /**
+   * Defines how to render the two progress bands on a gauge chart.
+   *
+   * **note**: When progressBands are used (defined and visible), the axis guides will be ignored.
+   */
+  progressBands?: WebChartGaugeFixedProgressBands;
 }
 
 /** JSON representation of the radar chart's axis object. */
@@ -586,6 +627,12 @@ export interface WebChartSeries {
    * Used for bar and line charts using a date x-axis with no time binning.
    */
   dataTooltipDateFormat?: DateTimeFormatOptions;
+  /**
+   * Specifies the font size for tooltip text.
+   *
+   * @default 14
+   */
+  dataTooltipFontSize?: number;
   /** Specifies the name of the series. It would be reflected in the chart's legend. */
   name: string;
   /** Specifies a query object associated with a particular series containing information on what data to fetch for that series. */
@@ -1135,6 +1182,10 @@ export interface WebChartHeatChartHeatClassBreaks {
    * `manual` - allows you to manually specify the class breaks.
    */
   classificationMethod?: WebChartClassBreakTypes;
+  colorRampInfo?: {
+      name?: string;
+      flipped?: boolean;
+  };
 }
 
 /** JSON representation of the heat chart empty cell configuration. */

package/dist/types/lumina.d.ts

@@ -3,7 +3,7 @@ import type { ArcgisChart } from "../components/arcgis-chart/customElement.js";
 import type { ArcgisChartsActionBar } from "../components/arcgis-charts-action-bar/customElement.js";
 import type { h, EventHandler } from "@arcgis/lumina";
 
-interface LuminaArcgisChart extends Partial<Pick<ArcgisChart, "actionMode" | "allowUsingObjectIdStat" | "animationEnabled" | "aria" | "autoDestroyDisabled" | "autoDisposeChart" | "autoInverseDataLabelTextColor" | "chartIndex" | "chartLimits" | "chartWillRender" | "configurationEnabled" | "cursorRange" | "dataLabelFormatter" | "disableInteractions" | "disableTogglingLegendItems" | "enableAutoTheming" | "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">>, h.JSX.HTMLAttributes<ArcgisChart> {
+interface LuminaArcgisChart extends Partial<Pick<ArcgisChart, "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" | "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">>, h.JSX.HTMLAttributes<ArcgisChart> {
   onarcgisAxesMinMaxChange?: EventHandler<ArcgisChart["arcgisAxesMinMaxChange"]>;
   onarcgisBadDataWarningRaise?: EventHandler<ArcgisChart["arcgisBadDataWarningRaise"]>;
   onarcgisChartNotFoundWarning?: EventHandler<ArcgisChart["arcgisChartNotFoundWarning"]>;