@arcgis/charts-components 5.0.0-next.13 → 5.0.0-next.131

package/dist/utils/components/themes.d.ts

@@ -0,0 +1,136 @@
+import { ChartOptions } from '../../chart-rendering/common/interfaces';
+import { EsriColor } from '../../chart-rendering/common/types';
+import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
+import { Color, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartHistogramSeries, WebChartLineChartSeries, WebChartOverlay, WebChartPieChartSlice, WebChartRadarChartSeries, WebChartScatterplotSeries } from '../../spec';
+/**
+ * Interface representing the list of colors a theme can provide.
+ */
+export interface ChartThemeColors {
+    backgroundColor?: EsriColor;
+    textColor?: EsriColor;
+    lineColor?: EsriColor;
+    secondLineColor?: EsriColor;
+}
+/**
+ * Indicates whether the Calcite dark mode is enabled on the DOM.
+ * @param chartElement The chart element
+ */
+export declare function isCalciteDarkModeEnabled(chartElement: HTMLElement): boolean;
+/**
+ * Retrieves the Calcite dark theme colors from the css variables.
+ * @param chartElement The chart element
+ */
+declare function getCalciteDarkThemeColors(chartElement: Element): ChartThemeColors;
+/**
+ * Applies the theme colors to the axes.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToAxes(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to the background.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToBackground(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to the title, footer and subtitle.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToTitleFooterSubtitle(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Updates the overlay symbol color (if the overlay is created and visible).
+ * @param overlayColor The color to set
+ * @param overlay The overlay to update
+ */
+declare function updateOverlaySymbolColor(overlayColor: Color, overlay?: WebChartOverlay): void;
+/**
+ * Updates the marker symbol color.
+ * @param props.configElementWithFillSymbol The config element with marker symbol to update
+ * @param props.markerColor The marker color to set
+ * @param props.lineColor The line color to set (optional)
+ */
+declare function updateMarkerSymbolColor(props: {
+    configElementWithFillSymbol: WebChartLineChartSeries | WebChartRadarChartSeries | WebChartScatterplotSeries;
+    markerColor: Color;
+    lineColor?: Color;
+}): void;
+/**
+ * Updates the fill symbol color.
+ * @param props.configElementWithFillSymbol The config element with fill symbol to update
+ * @param props.fillColor The fill color to set
+ * @param props.lineColor The line color to set (optional)
+ */
+declare function updateFillSymbolColor(props: {
+    configElementWithFillSymbol: WebChartBarChartSeries | WebChartBoxPlotSeries | WebChartHistogramSeries | WebChartPieChartSlice;
+    fillColor: Color;
+    lineColor?: Color;
+}): void;
+/**
+ * Applies the theme colors to the series.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToSeries(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to pie chart specific properties.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToPieChartSeries(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to the legend.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToLegend(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to gauge specific properties.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToGauge(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme colors to heat chart specific properties.
+ * @param config The config to alter
+ * @param themeColors The theme colors to apply
+ */
+declare function applyThemeColorsToHeatChart(config: ArcgisChart["config"], themeColors: ChartThemeColors): void;
+/**
+ * Applies the theme to the loader colors in the chart options.
+ * @param props.chartElement The chart element
+ * @param props.options The chart options
+ * @param props.calciteThemeApplied The currently applied calcite theme
+ * @param props.config The chart config
+ * @returns The altered chart options
+ */
+export declare function applyThemeToChartOptions(props: {
+    chartElement: HTMLArcgisChartElement;
+    options: ChartOptions;
+    calciteThemeApplied: ArcgisChart["calciteThemeApplied"];
+    config: ArcgisChart["config"];
+}): ChartOptions;
+/**
+ * Apply a theme colors to the chart config.
+ * The only theme supported currently is the Calcite dark mode.
+ * @param chartElement The chart element
+ * @param config The chart config
+ */
+export declare function applyThemeColors(chartElement: HTMLArcgisChartElement, config: ArcgisChart["config"]): ArcgisChart["config"];
+/** @private */
+export declare const commonThemesPrivateFunctions: {
+    applyThemeColorsToAxes: typeof applyThemeColorsToAxes;
+    applyThemeColorsToBackground: typeof applyThemeColorsToBackground;
+    applyThemeColorsToTitleFooterSubtitle: typeof applyThemeColorsToTitleFooterSubtitle;
+    applyThemeColorsToSeries: typeof applyThemeColorsToSeries;
+    applyThemeColorsToPieChartSeries: typeof applyThemeColorsToPieChartSeries;
+    applyThemeColorsToLegend: typeof applyThemeColorsToLegend;
+    applyThemeColorsToGauge: typeof applyThemeColorsToGauge;
+    applyThemeColorsToHeatChart: typeof applyThemeColorsToHeatChart;
+    getCalciteDarkThemeColors: typeof getCalciteDarkThemeColors;
+    updateOverlaySymbolColor: typeof updateOverlaySymbolColor;
+    updateFillSymbolColor: typeof updateFillSymbolColor;
+    updateMarkerSymbolColor: typeof updateMarkerSymbolColor;
+};
+export {};

package/dist/utils/components/watch-handlers.d.ts

@@ -1,37 +1,37 @@
 import { ArcgisChart } from '../../components/arcgis-chart/customElement.js';
 /**
- * Adds a listener on the feature layer, so every time the definition expression (filter) is modified we update
+ * Adds a watch handler on the feature layer, so every time the definition expression (filter) is modified we update
  * the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFilterListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFilter(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the renderer is modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the renderer is modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerRendererListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerRenderer(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer view, so every time the view's extent is modified we update
+ * Adds a watch handler on the feature layer view, so every time the view's extent is modified we update
  * the chart.
  *
  * @param props.component The chart component
  */
-export declare function addExtentChangeListener(component: ArcgisChart): Promise<IHandle[] | undefined>;
+export declare function watchExtentChange(component: ArcgisChart): Promise<IHandle[] | undefined>;
 /**
- * Adds a listener on the view's time extent, so every time extent is modified we update the chart.
+ * Adds a watch handler on the view's time extent, so every time extent is modified we update the chart.
  * @param component The chart component
  */
-export declare function addViewTimeExtentListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchViewTimeExtent(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the feature layer, so every time the fields are modified we update the chart.
+ * Adds a watch handler on the feature layer, so every time the fields are modified we update the chart.
  *
  * @param component The chart component
  */
-export declare function addLayerFieldsListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchLayerFields(component: ArcgisChart): IHandle | undefined;
 /**
- * Adds a listener on the layer's view; so every time the selection data is modified, we update the chart.
+ * Adds a watch handler on the layer's view; so every time the selection data is modified, we update the chart.
  * @param component The chart component
  */
-export declare function addSelectionsChangeInViewListener(component: ArcgisChart): Promise<IHandle | undefined>;
+export declare function watchSelectionsChangeInView(component: ArcgisChart): IHandle | undefined;

package/dist/utils/components/web-component-utils.d.ts

@@ -1,28 +1,24 @@
-import { CSVOptions } from '../../interfaces';
-import { ModelTypes } from '../../model';
-import { IField, SupportedLayer } from '../../spec';
-import { ChartConfig } from '../types';
 import { default as FeatureLayerView } from '@arcgis/core/views/layers/FeatureLayerView.js';
+import { SupportedLayer, CSVOptions } from '../../interfaces';
+import { ModelTypes } from '../../model';
+import { IField } from '../../spec';
 import { SupportedLocalesForFormats } from '../localization/interfaces';
+import { ChartConfig } from '../types';
 /**
  * A utility function to compare if a value has changed deeply.
- * @param value
- * @param oldValue
  */
 export declare function hasChangedDeep<T>(value: T, oldValue?: T): boolean;
 /**
  * A utility function to compare if a value has changed deeply or shallowly.
- * @param value
- * @param oldValue
  */
 export declare function hasChangedDeepOrShallow<T>(value: T, oldValue?: T): boolean;
 /**
  * Formats a cell value for CSV output.
  * This function handles quoting and escaping of special characters.
- * @param {unknown} value - The value to format.
- * @param {boolean} [quoteAll] - Whether to quote all values.
- *                               If `true`, all values will be quoted.
- *                               If `false` or `undefined`, only values that contain special characters will be quoted.
+ *
+ * @param value - The value to format.
+ * @param quoteAll - Whether to quote all values. If `true`, all values will be quoted. If `false` or `undefined`, only values that contain special characters will be quoted.
+ * @param locale - The locale to use for number formatting.
  */
 export declare const formatCell: (props: {
     value: unknown;
@@ -31,6 +27,7 @@ export declare const formatCell: (props: {
 }) => string;
 /**
  * Converts an array of objects to a CSV string.
+ *
  * @param data - The data to convert.
  * @param options - Options for CSV conversion.
  * @returns The CSV string.
@@ -39,10 +36,11 @@ export declare function arrayToCSV<T extends Record<string, unknown>>(data: T[],
 /**
  * Transform the raw data to a format that is suitable for exporting to CSV.
  * This function is used to transform the data before it is passed to the CSV export function.
- * @param props.config - [Optional] The chart configuration that defines the chart type and data transformation.
+ *
+ * @param props.config - The chart configuration that defines the chart type and data transformation.
  * @param props.rawData - The raw data to be transformed, which is an array of objects.
- * @param props.layer - [Optional] The layer associated with the chart, used for additional data context.
- * @param props.fieldList - [Optional] The list of fields in the layer, used to determine field types and names.
+ * @param props.layer - The layer associated with the chart, used for additional data context.
+ * @param props.fieldList - The list of fields in the layer, used to determine field types and names.
  */
 export declare function transformChartData<T extends Record<string, unknown>>(props: {
     config?: ChartConfig;
@@ -52,12 +50,14 @@ export declare function transformChartData<T extends Record<string, unknown>>(pr
 }): T[];
 /**
  * Transform the histogram data to a format that is suitable for exporting to CSV.
+ *
  * @param config - The histogram model or config
  * @param rows - The raw data to be transformed.
  */
 export declare function transformHistogramData<T extends Record<string, unknown>>(config: ChartConfig<typeof ModelTypes.Histogram>, rows: T[]): T[];
 /**
  * Processes the chart data for bar and line charts.
+ *
  * @param props.config - The chart model.
  * @param props.rows - The raw data to be transformed.
  * @param props.layer - The layer associated with the chart.
@@ -70,6 +70,7 @@ export declare function transformBarLineChartData<T extends Record<string, unkno
 }): T[];
 /**
  * Transform the pie chart data to a format that is suitable for exporting to CSV.
+ *
  * @param props.model - The pie chart model.
  * @param props.rows - The raw data to be transformed.
  * @param props.layer - The layer associated with the chart.
@@ -82,6 +83,7 @@ export declare function transformPieChartData<T extends Record<string, unknown>>
 }): T[];
 /**
  * Transform the box plot data to a format that is suitable for exporting to CSV.
+ *
  * @param model - The box plot model.
  * @param rows - The raw data to be transformed.
  * @returns The transformed data.
@@ -94,6 +96,14 @@ export declare function transformBoxPlotData<T extends Record<string, unknown>>(
 }): T[];
 /**
  * Check if the provided date is valid.
- * @param {unknown} date - The date to check, should be a string or a number.
+ *
+ * @param date - The date to check, should be a string or a number.
  */
 export declare const isValidDate: (date: unknown) => date is Date | number | string;
+/**
+ * Returns a unique ID.
+ *
+ * @example
+ * 33c2c20e-5a9e-c7be-1b23-b210e6218831
+ */
+export declare function generateGUID(): string;

package/dist/utils/data/categorical-data/index.d.ts

@@ -1,7 +1,7 @@
-import { WebChartQuery } from '../../../spec';
 import { ChartElementLimit } from '../../defaults/interfaces';
-import { AbortControllerKeyType } from '../../layer/query-features/interfaces';
 import { QueryObject } from '../../layer/interfaces';
+import { AbortControllerKeyType } from '../../layer/query-features/interfaces';
+import { WebChartQuery } from '../../../spec/web-chart';
 /**
  * Fetches the unique values from a given field.
  * /!\ Currently the results for a same split-by field might differ from a category field to another.

package/dist/utils/data/index.d.ts

@@ -1,6 +1,7 @@
-import { WebChart, WebChartBin, WebChartDataItem, WebChartDataTypes, WebChartSeriesType, WebGaugeChart } from '../../spec';
 import { ChartSubType } from '../misc/interfaces';
 import { BoxPlotYValueProps, DataMinMax, BoxPlotYFieldKeys } from './interfaces';
+import { WebChart, WebChartSeriesType, WebGaugeChart } from '../../spec/web-chart';
+import { WebChartBin, WebChartDataItem, WebChartDataTypes } from '../../spec/data-source';
 /**
  * Generates the y field names for box plot
  * @param y
@@ -11,30 +12,32 @@ export declare function getBoxPlotStatisticFieldNames(y?: string): Record<BoxPlo
  * Check the `subType` in the chart config to determine whether the chart is a gauge by feature.
  * If `subType` is not defined, the chart is defaulted to be a statistic gauge.
  *
- * @param config the chart config
- * @default false
+ * @param config - the chart config
  */
-export declare function isGaugeByFeature(config: WebGaugeChart): boolean;
+export declare function isGaugeByFeature(config: WebChart): boolean;
 /**
  * From fetched data (type: WebChartDataTypes) returns the part containing the data that
  * is to be assigned to the chart (WebChartDataItem[] | WebChartBin[])
- * @param props.fetchedData The fetched finished data
+ *
+ * @param props.fetchedData - The fetched finished data
  */
 export declare function extractChartDataFromFetchedData(fetchedData?: WebChartDataTypes): WebChartBin[] | WebChartDataItem[] | undefined;
 /**
  * Determine whether the current box plot has multi-fields or not based on its query type
- * @param chartSubType: Box plot sub type
+ *
+ * @param chartSubType - Box plot sub type
  */
 export declare function isMultiFieldsBoxPlot(chartSubType?: ChartSubType): boolean;
 /**
  * Compute Y value for given Box Plot Y field key based on the provided config
- * @param props.key The BoxPlotYFieldKeys related to the stat
- * @param props.y The y field to use to get the y value
- * @param props.chartSubType The box plot sub type
- * @param props.splitBy The where clause used as a split-by value for a given series
- * @param props.splitByValue The split-by value for a given series
- * @param props.showOutliers Whether to show the outliers
- * @param props.standardizeValues Whether to show the standardized values
+ *
+ * @param props.key - The BoxPlotYFieldKeys related to the stat
+ * @param props.y - The y field to use to get the y value
+ * @param props.chartSubType - The box plot sub type
+ * @param props.splitBy - The where clause used as a split-by value for a given series
+ * @param props.splitByValue - The split-by value for a given series
+ * @param props.showOutliers - Whether to show the outliers
+ * @param props.standardizeValues - Whether to show the standardized values
  */
 export declare function getBoxPlotYValue(props: BoxPlotYValueProps): string;
 /**
@@ -99,7 +102,7 @@ export declare function isEmptyDataset(props: {
     dataSet?: WebChartDataItem[];
 }): boolean;
 /**
- * Gets the data min and max values for a stacked series
+ * Gets the data min and max values for a stacked series; also an indicator whether the data has negative values.
  * @param seriesConfig The config for the series
  * @param filteredSeriesIds List of series ids to use as a filter
  * @param filteredData The data to look into
@@ -111,6 +114,7 @@ export declare function getDataMinMaxFromStackedSeries(props: {
 }): {
     stackedMinY: number;
     stackedMaxY: number;
+    dataHasNegativeValues: boolean;
 };
 /**
  * Looks for the min and max values from a data set, considering only the visible series.

package/dist/utils/data/interfaces.d.ts

@@ -1,7 +1,7 @@
-import { WebChartDataTypes, WebChartQuery } from '../../spec';
+import { WebChartDataTypes } from '../../spec/data-source';
+import { WebChartQuery } from '../../spec/web-chart';
 import { DataWarningKeywords } from '../chart-config/validator/interfaces';
 import { ChartSubType } from '../misc/interfaces';
-import { BinnedServerData } from './time-binning/interfaces';
 export interface DataMinMax {
     minY: number;
     maxY: number;
@@ -13,7 +13,6 @@ export interface DataInfo {
     invalidType?: DataWarningKeywords;
     count?: number;
     data?: WebChartDataTypes;
-    binnedServerData?: BinnedServerData;
     queryConfig?: WebChartQuery;
 }
 export declare const BoxPlotYFieldKeys: {
@@ -37,3 +36,36 @@ export interface BoxPlotYValueProps {
     showOutliers?: boolean;
     standardizeValues?: boolean;
 }
+export interface DataUpdateDetails {
+    common?: {
+        layerChanged?: boolean;
+        queryChanged?: boolean;
+        xOrYChanged?: boolean;
+        numberOfSeriesChanged?: boolean;
+        configFiltersChanged?: boolean;
+        filterBySelectionChanged?: boolean;
+        dataForFilterBySelectionChanged?: boolean;
+        binTemporalDataChanged?: boolean;
+        timeBinningChanged?: boolean;
+        timeIntervalUnitChanged?: boolean;
+        newTimeBinningWillBeCalculated?: boolean;
+        valueFormatChangeRequiresNewData?: boolean;
+    };
+    histogram?: {
+        dataPropsChanged?: boolean;
+    };
+    gauge?: {
+        valueConversionChanged?: boolean;
+    };
+    boxPlot?: {
+        showMeanChanged?: boolean;
+    };
+    heatChart?: {
+        binningChanged?: boolean;
+        hideEmptyRowsAndColumnsChanged?: boolean;
+        includeLeapDay?: boolean;
+    };
+    scatterPlot?: {
+        tooltipFieldsChanged?: boolean;
+    };
+}

package/dist/utils/data/stats/class-breaks.d.ts

@@ -0,0 +1,91 @@
+import { Color } from '../../../spec';
+import { ClassBreakInfo } from '../../chart-config/utils/class-breaks';
+import { ClassBreaksRendererResult } from '@arcgis/core/smartMapping/renderers/color.js';
+import { ColorRamp } from '@arcgis/core/smartMapping/symbology/types.js';
+/**
+ * Generates a color per class break (length = `numberOfClassBreaks`).
+ *
+ * @param props - Options.
+ * @param props.numberOfClassBreaks - Number of colors to generate.
+ * @param props.selectedColorRamp - Optional ArcGIS color ramp to sample from (assumed already flipped upstream).
+ * @param props.colorRamp - Optional explicit Charts colors. If its length matches `numberOfClassBreaks`, it is used as-is.
+ * @returns Charts colors as an array of RGBA tuples.
+ *
+ * @example
+ * ```ts
+ * // Prefer the explicit colorRamp when it already matches the break count.
+ * generateColorsForClassBreaks({ numberOfClassBreaks: 5, colorRamp: [[...], ...] });
+ * ```
+ */
+export declare function generateColorsForClassBreaks(props: {
+    numberOfClassBreaks: number;
+    selectedColorRamp?: ColorRamp;
+    colorRamp?: Color[];
+}): Color[];
+/**
+ * Builds {@link ClassBreakInfo} entries (label + symbol) from a Smart Mapping renderer result.
+ *
+ * @param props - Options.
+ * @param props.classBreaksRendererResult - ArcGIS Core class breaks renderer output.
+ * @param props.numberOfClassBreaks - Number of breaks used to generate colors.
+ * @param props.selectedColorRamp - Optional ArcGIS ramp (assumed already flipped upstream).
+ * @param props.colorRamp - Optional explicit Charts colors.
+ * @returns Array of {@link ClassBreakInfo}; empty if there are no break infos.
+ *
+ * @note Gotcha: min/max values are normalized for display (`floor(min)`, `ceil(max)`).
+ *
+ * @example
+ * ```ts
+ * const infos = extractClassBreakInfos({ classBreaksRendererResult, numberOfClassBreaks: 5 });
+ * // infos[0].label might be "≤ 10"
+ * ```
+ */
+export declare function extractClassBreakInfos(props: {
+    classBreaksRendererResult: ClassBreaksRendererResult;
+    numberOfClassBreaks: number;
+    selectedColorRamp?: ColorRamp;
+    colorRamp?: Color[];
+}): ClassBreakInfo[];
+/**
+ * Converts a Charts RGB/RGBA tuple to a CSS hex string.
+ *
+ * @param rgbaColor - `[r, g, b]` or `[r, g, b, a]` (alpha is ignored).
+ * @returns Hex color string in the form `#RRGGBB`.
+ *
+ * @note Values are clamped to 0–255.
+ *
+ * @example
+ * ```ts
+ * convertRgbaToHexString([255, 0, 0, 255]); // → "#ff0000"
+ * ```
+ */
+export declare function convertRgbaToHexString(rgbaColor: number[] | null | undefined): string;
+export declare const ColorRampCategoriesToTags: {
+    readonly all: readonly ["*"];
+    readonly light: readonly ["light"];
+    readonly dark: readonly ["dark"];
+    readonly redsAndYellows: readonly ["oranges", "reds", "yellows"];
+    readonly greens: readonly ["greens"];
+    readonly blues: readonly ["blues"];
+    readonly purplesAndPinks: readonly ["purples", "pinks"];
+    readonly browns: readonly ["browns"];
+    readonly grays: readonly ["grays"];
+    readonly bright: readonly ["bright"];
+    readonly subdued: readonly ["subdued"];
+    readonly colorblindFriendly: readonly ["colorblind-friendly"];
+};
+export declare const ColorRampCategories: {
+    readonly all: "all";
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly redsAndYellows: "redsAndYellows";
+    readonly greens: "greens";
+    readonly blues: "blues";
+    readonly purplesAndPinks: "purplesAndPinks";
+    readonly browns: "browns";
+    readonly grays: "grays";
+    readonly bright: "bright";
+    readonly subdued: "subdued";
+    readonly colorblindFriendly: "colorblindFriendly";
+};
+export type ColorRampCategories = (typeof ColorRampCategories)[keyof typeof ColorRampCategories];

package/dist/utils/data/time-binning/interfaces.d.ts

@@ -1,4 +1,5 @@
-import { TimeIntervalInfo, WebChartDataItem, WebChartTemporalBinningUnits } from '../../../spec';
+import { WebChartTemporalBinningUnits } from '../../../spec/chart-object-literals';
+import { TimeIntervalInfo, WebChartDataItem } from '../../../spec/data-source';
 export interface DateRange {
     dateMinTimestamp: number | null | undefined;
     dateMaxTimestamp: number | null | undefined;
@@ -14,10 +15,6 @@ export interface TimeBinningStatistics {
     dateRange: DateRange;
     numberOfFeatures: number;
 }
-export interface BinnedServerData {
-    data: WebChartDataItem[];
-    timeBinningStats: TimeBinningStatistics;
-}
 export interface GroupProps {
     binFirstOrLastIndex: number;
     data: WebChartDataItem[];

package/dist/utils/defaults/index.d.ts

@@ -1,6 +1,8 @@
-import { CategoryFormatOptions, Color, DateTimeFormatOptions, HistogramOverlays, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebChartStackedKinds, WebChartTypes } from '../../spec';
-import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
+import { WebChartStackedKinds, WebChartTypes } from '../../spec/chart-object-literals';
+import { Color, IFont, ISimpleFillSymbol, ISimpleLineSymbol, ISimpleMarkerSymbol } from '../../spec/rest-js-types';
+import { CategoryFormatOptions, DateTimeFormatOptions, HistogramOverlays, NumberFormatOptions, ScatterplotOverlays, SizePolicy, WebBoxPlot, WebChart, WebChartAxis, WebChartBarChartSeries, WebChartBoxPlotSeries, WebChartCursorCrosshair, WebChartGaugeAxis, WebChartGaugeSeries, WebChartHeatChartSeries, WebChartHistogramSeries, WebChartLegend, WebChartLineChartSeries, WebChartNeedle, WebChartOverlay, WebChartPieChartSeries, WebChartPieChartTick, WebChartRadarChartSeries, WebChartScatterplotSeries, WebChartText, WebChartTextSymbol, WebGaugeChart, WebHeatChart } from '../../spec/web-chart';
 import { CommonStrings } from '../localization/interfaces';
+import { ChartElementLimit, ChartElementTechnicalLimit, ChartTextProps, QueryDefaults, TextElements } from './interfaces';
 export declare const histogramBinCount = 32;
 export declare const featuresExtentField = "arcgis_charts_features_extent";
 export declare const queryDefaults: QueryDefaults;
@@ -25,7 +27,13 @@ export declare const defaultHeatChartFields: {
     xField: string;
     yField: string;
 };
+export declare const defaultHeatChartNumberOfBreaks: {
+    min: number;
+    max: number;
+};
 export declare const ramp: Color[];
+export declare const darkModeRamp: Color[];
+export declare const darkModeOverlayRamp: Color[];
 /**
  * Returns a specific color from the default ramp, given an index. If the index is > than the ramp length,
  * we use modulo to get the corresponding color.
@@ -88,7 +96,7 @@ export declare function getDefaultLineChartLineSymbol(seriesIndex?: number): ISi
 export declare function getDefaultScatterplotMarkerSymbol(useRandomColor?: boolean): ISimpleMarkerSymbol;
 export declare function getDefaultScatterplotSizePolicy(): Required<SizePolicy>;
 export declare function getDefaultTrendLine(useRandomColor?: boolean): Required<ScatterplotOverlays>;
-export declare function getHeatChartSeries(objectIdField?: string): WebChartHeatChartSeries;
+export declare function getHeatChartSeries(commonStrings: CommonStrings, objectIDField?: string): WebChartHeatChartSeries;
 export declare function getScatterplotSeries(): WebChartScatterplotSeries;
 /**
  * Returns default axes based on chart type as per the WebChart Specification
@@ -168,11 +176,11 @@ export declare function getDefaultGauge(commonStrings: CommonStrings, id?: strin
 export declare function getDefaultScatterplot(commonStrings: CommonStrings, id?: string): WebChart;
 /**
  * Gets default heat chart
- * @param commonStrings
- * @param id
- * @returns WebChart
+ * @param commonStrings Common strings
+ * @param objectIDField Object ID field
+ * @returns WebHeatChart
  */
-export declare function getDefaultHeatChart(commonStrings: CommonStrings, objectIDField: string): WebChart;
+export declare function getDefaultHeatChart(commonStrings: CommonStrings, objectIDField: string): WebHeatChart;
 export declare function getDefaultHistogramOverlays(): Required<HistogramOverlays>;
 export declare function getDefaultHistogramSymbol(): ISimpleFillSymbol;
 export declare function getDefaultHistogramSeries(): Omit<Required<WebChartHistogramSeries>, "dataTooltipDateFormat" | "dataTooltipPercentFormat" | "dataTooltipValueFormat" | "query">;

package/dist/utils/defaults/interfaces.d.ts

@@ -1,4 +1,4 @@
-import { IFont, IStatisticDefinition } from '../../spec';
+import { IFont, IStatisticDefinition } from '../../spec/rest-js-types';
 export declare const LimitBehavior: {
     readonly Reject: "reject";
     readonly RenderUpToTheLimit: "renderUpToTheLimit";
@@ -44,7 +44,7 @@ export interface QueryDefaults {
     maxParallelRequests: number;
     maxRecords: number;
     outStatistics: Readonly<IStatisticDefinition>;
-    uniqueIdsName: string;
+    uniqueIdsName: number | string;
     orderByJSAPIDelimiter: string;
 }
 export interface ChartTextProps {

package/dist/utils/errors/index.d.ts

@@ -17,11 +17,11 @@ export declare class ArcgisChartsError<T = any> extends Error {
      */
     details?: T;
     /**
-     * Creates a new ArcgisChartsError instance.
+     * Creates a new `ArcgisChartsError` instance.
      *
-     * @param {string} name - A unique error name.
-     * @param {string} [message] - A message describing the details of the error.
-     * @param {Object} [details] - The details object provides additional details specific to the error.
+     * @param name - A unique error name.
+     * @param message - A message describing the details of the error.
+     * @param details - The details object provides additional details specific to the error.
      */
     constructor(name: string, message?: string, details?: T);
 }