@arcgis/charts-components 4.34.0-next.99 → 4.34.1

package/dist/docs/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-08-14T10:02:58",
+  "timestamp": "2025-10-21T18:39:42",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.34.0-next.99",
+    "version": "4.34.1",
     "typescriptVersion": "5.8.3"
   },
   "components": [
@@ -12,8 +12,12 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The ArcGIS Chart component renders various chart types based on the provided model.\n\nSupported chart types include bar charts, line charts, pie charts, box plots, combo bar-line charts, gauges, scatterplots, histograms and radar charts.\n\nThe Chart component can be rendered using an [existing model](https://developers.arcgis.com/javascript/latest/charts-components-intro/#use-an-existing-model-from-a-webmap-or-feature-layer) from a web map or feature layer,\nor by [creating a new model](https://developers.arcgis.com/javascript/latest/charts-components-intro/#create-a-new-model).\n\nSee also:\n- [Introduction to Charts components](https://developers.arcgis.com/javascript/latest/charts-components-intro/)\n- [Tutorial: Display and create charts components](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)",
+      "docs": "The ArcGIS Chart component renders a chart based on the provided model. Get started by reading the [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/) page.\n\nSupported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.\n\nSee also:\n- [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)\n- [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)\n- [Tutorial: Create a heat chart](https://developers.arcgis.com/javascript/latest/tutorials/create-a-heat-chart/)\n- [Tutorial: Modify a chart](https://developers.arcgis.com/javascript/latest/tutorials/modify-a-chart/)",
       "docsTags": [
+        {
+          "name": "since",
+          "text": "4.32"
+        },
         {
           "name": "superclass",
           "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
@@ -87,14 +91,14 @@
           "docsTags": [
             {
               "name": "type",
-              "text": "{boolean | undefined}"
+              "text": "{boolean}"
             },
             {
               "name": "category",
               "text": "Public"
             }
           ],
-          "default": "undefined",
+          "default": "false",
           "values": [
             {
               "type": "boolean"
@@ -270,42 +274,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "componentVersion",
-          "type": "\"beta\" | \"stable\"",
-          "complexType": {
-            "original": "\"beta\" | \"stable\"",
-            "resolved": "\"beta\" | \"stable\"",
-            "references": {}
-          },
-          "mutable": true,
-          "attr": "component-version",
-          "reflectToAttr": false,
-          "docs": "Whether to use the stable version of the component or the beta version.",
-          "docsTags": [
-            {
-              "name": "type",
-              "text": "{WebChartComponentVersion}"
-            },
-            {
-              "name": "category",
-              "text": "Public"
-            }
-          ],
-          "default": "\"stable\"",
-          "values": [
-            {
-              "value": "beta",
-              "type": "string"
-            },
-            {
-              "value": "stable",
-              "type": "string"
-            }
-          ],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "cursorRange",
           "type": "\"multi-axes\" | \"x-axis\" | \"y-axis\"",
@@ -352,10 +320,10 @@
         },
         {
           "name": "dataLabelFormatter",
-          "type": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
+          "type": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
           "complexType": {
-            "original": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
-            "resolved": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
+            "original": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
+            "resolved": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((statValue: number, percent?: number | undefined) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
             "references": {}
           },
           "mutable": true,
@@ -387,7 +355,7 @@
               "type": "(((statValue: number, percent?: number | undefined) => string))"
             },
             {
-              "type": "(((x: number, y: number, sizePolicyValue?: number | undefined) => string))"
+              "type": "(((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))"
             }
           ],
           "optional": true,
@@ -459,38 +427,6 @@
           "optional": true,
           "required": false
         },
-        {
-          "name": "displaySettings",
-          "type": "DisplaySettings",
-          "complexType": {
-            "original": "DisplaySettings",
-            "resolved": "DisplaySettings",
-            "references": {
-              "DisplaySettings": {
-                "location": "local",
-                "path": "dist/chart-rendering/common/interfaces.d.ts",
-                "id": "notImplemented"
-              }
-            }
-          },
-          "mutable": true,
-          "reflectToAttr": false,
-          "docs": "Used to set the options available to handle messages displayed on the chart.",
-          "docsTags": [
-            {
-              "name": "type",
-              "text": "{DisplaySettings | undefined}"
-            },
-            {
-              "name": "category",
-              "text": "Public"
-            }
-          ],
-          "default": "undefined",
-          "values": [],
-          "optional": true,
-          "required": false
-        },
         {
           "name": "enableConfiguration",
           "type": "boolean",
@@ -1266,15 +1202,15 @@
                 "id": "notImplemented"
               },
               "WebChart": {
-                "location": "import",
-                "path": "@arcgis/charts-spec/web-chart.d.ts",
+                "location": "local",
+                "path": "dist/spec/web-chart.d.ts",
                 "id": "notImplemented"
               }
             }
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "Instance of an ArcGIS Chart Model. Provides an API to interact with the chart's configuration.\n\n**Note:** This property has a union type of `ChartModel | WebChart` meaning a raw chart config object can be passed to it instead, however it is recommended to use a `ChartModel` instance whenever possible.",
+          "docs": "Instance of an ArcGIS Chart Model. Provides an API to interact with the chart's configuration.\n**Note:** This property has a union type of `ChartModel | WebChart` meaning a raw chart config object can be passed to it instead, however it is recommended to use a `ChartModel` instance whenever possible.",
           "docsTags": [
             {
               "name": "type",
@@ -1294,57 +1230,52 @@
           "required": false
         },
         {
-          "name": "placeholder",
-          "type": "string",
+          "name": "nullAsValid",
+          "type": "boolean",
           "complexType": {
-            "original": "string",
-            "resolved": "string",
+            "original": "boolean",
+            "resolved": "boolean",
             "references": {}
           },
           "mutable": true,
-          "attr": "placeholder",
+          "attr": "null-as-valid",
           "reflectToAttr": true,
-          "docs": "A placeholder string to provides a brief hint to the user indicating needed information for creating a chart.",
+          "docs": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only\nnull values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
           "docsTags": [
             {
               "name": "type",
-              "text": "{string | undefined}"
+              "text": "{boolean}"
             },
             {
               "name": "category",
               "text": "Public"
             }
           ],
-          "default": "undefined",
+          "default": "false",
           "values": [
             {
-              "type": "string"
+              "type": "boolean"
             }
           ],
           "optional": true,
           "required": false
         },
         {
-          "name": "querySettings",
-          "type": "QuerySettings",
+          "name": "placeholder",
+          "type": "string",
           "complexType": {
-            "original": "QuerySettings",
-            "resolved": "QuerySettings",
-            "references": {
-              "QuerySettings": {
-                "location": "local",
-                "path": "dist/chart-rendering/common/interfaces.d.ts",
-                "id": "notImplemented"
-              }
-            }
+            "original": "string",
+            "resolved": "string",
+            "references": {}
           },
           "mutable": true,
-          "reflectToAttr": false,
-          "docs": "Used to set the options available to query data for the chart.",
+          "attr": "placeholder",
+          "reflectToAttr": true,
+          "docs": "A placeholder string to provides a brief hint to the user indicating needed information for creating a chart.",
           "docsTags": [
             {
               "name": "type",
-              "text": "{QuerySettings | undefined}"
+              "text": "{string | undefined}"
             },
             {
               "name": "category",
@@ -1352,7 +1283,11 @@
             }
           ],
           "default": "undefined",
-          "values": [],
+          "values": [
+            {
+              "type": "string"
+            }
+          ],
           "optional": true,
           "required": false
         },
@@ -1556,10 +1491,10 @@
         },
         {
           "name": "runtimeDataFilters",
-          "type": "{\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IExtent | IEnvelope | IPoint | IPolygon | IPolygonWithCurves | IPolyline | undefined;\n    objectIds?: Array<number> | undefined;\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
+          "type": "{\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IPoint | IPolyline | IPolygon | IPolygonWithCurves | IEnvelope | IExtent | undefined;\n    objectIds?: Array<number> | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
           "complexType": {
-            "original": "{\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IExtent | IEnvelope | IPoint | IPolygon | IPolygonWithCurves | IPolyline | undefined;\n    objectIds?: Array<number> | undefined;\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
-            "resolved": "{\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IExtent | IEnvelope | IPoint | IPolygon | IPolygonWithCurves | IPolyline | undefined;\n    objectIds?: Array<number> | undefined;\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
+            "original": "{\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IPoint | IPolyline | IPolygon | IPolygonWithCurves | IEnvelope | IExtent | undefined;\n    objectIds?: Array<number> | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
+            "resolved": "{\n    spatialRelationship?: \"intersects\" | \"contains\" | \"crosses\" | \"disjoint\" | \"envelope-intersects\" | \"index-intersects\" | \"overlaps\" | \"touches\" | \"within\" | \"relation\" | undefined;\n    distance?: number | undefined;\n    gdbVersion?: string | undefined;\n    geometry?: IPoint | IPolyline | IPolygon | IPolygonWithCurves | IEnvelope | IExtent | undefined;\n    objectIds?: Array<number> | undefined;\n    timeExtent?: [number, number] | undefined;\n    units?: RESTUnits | undefined;\n    where?: string | undefined;\n}",
             "references": {}
           },
           "mutable": true,
@@ -1717,6 +1652,37 @@
           "optional": true,
           "required": false
         },
+        {
+          "name": "showUIMessages",
+          "type": "boolean",
+          "complexType": {
+            "original": "boolean",
+            "resolved": "boolean",
+            "references": {}
+          },
+          "mutable": true,
+          "attr": "show-ui-messages",
+          "reflectToAttr": true,
+          "docs": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an\naxis when the data contains values <= 0).",
+          "docsTags": [
+            {
+              "name": "type",
+              "text": "{boolean | undefined}"
+            },
+            {
+              "name": "category",
+              "text": "Public"
+            }
+          ],
+          "default": "undefined",
+          "values": [
+            {
+              "type": "boolean"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "syncSelection",
           "type": "boolean",
@@ -1817,10 +1783,10 @@
         },
         {
           "name": "tooltipFormatter",
-          "type": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
+          "type": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
           "complexType": {
-            "original": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
-            "resolved": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined) => string))",
+            "original": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
+            "resolved": "(((category: string, value?: number | undefined, percent?: number | undefined, originalCategory?: WebChartDataItemValue) => string)) | (((count: number, binMinValue: number, binMaxValue: number) => string)) | (((props: BarAndLineTooltipFormatCallbackProps) => string)) | (((props: BoxPlotTooltipFormatCallbackProps) => string)) | (((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))",
             "references": {}
           },
           "mutable": true,
@@ -1855,7 +1821,7 @@
               "type": "(((props: BoxPlotTooltipFormatCallbackProps) => string))"
             },
             {
-              "type": "(((x: number, y: number, sizePolicyValue?: number | undefined) => string))"
+              "type": "(((x: number, y: number, sizePolicyValue?: number | undefined, dataContext?: WebChartDataItem | undefined) => string))"
             }
           ],
           "optional": true,
@@ -2302,6 +2268,37 @@
             }
           ]
         },
+        {
+          "name": "loadModel",
+          "returns": {
+            "type": "Promise<void>",
+            "docs": ""
+          },
+          "complexType": {
+            "signature": "(): Promise<void>",
+            "parameters": [],
+            "return": "Promise<void>",
+            "references": {
+              "Promise": {
+                "location": "import",
+                "path": "typescript/lib/lib.es5.d.ts",
+                "id": "notImplemented"
+              }
+            }
+          },
+          "signature": "loadModel(): Promise<void>",
+          "parameters": [],
+          "docs": "Returns a promise that resolves when the chart model is fully loaded.",
+          "docsTags": [
+            {
+              "name": "returns"
+            },
+            {
+              "name": "category",
+              "text": "Public"
+            }
+          ]
+        },
         {
           "name": "notify",
           "returns": {
@@ -2386,11 +2383,11 @@
             "docs": ""
           },
           "complexType": {
-            "signature": "(props?: { updateData?: boolean; resetAxesBounds?: boolean; updateExtent?: boolean; }): Promise<void>",
+            "signature": "(props?: { updateData?: boolean; resetAxesBounds?: boolean; }): Promise<void>",
             "parameters": [
               {
                 "name": "props",
-                "type": "undefined | {\n    updateData?: boolean | undefined;\n    resetAxesBounds?: boolean | undefined;\n    updateExtent?: boolean | undefined;\n}",
+                "type": "undefined | {\n    updateData?: boolean | undefined;\n    resetAxesBounds?: boolean | undefined;\n}",
                 "docs": ""
               }
             ],
@@ -2403,11 +2400,11 @@
               }
             }
           },
-          "signature": "refresh(props?: { updateData?: boolean; resetAxesBounds?: boolean; updateExtent?: boolean; }): Promise<void>",
+          "signature": "refresh(props?: { updateData?: boolean; resetAxesBounds?: boolean; }): Promise<void>",
           "parameters": [
             {
               "name": "props",
-              "type": "undefined | {\n    updateData?: boolean | undefined;\n    resetAxesBounds?: boolean | undefined;\n    updateExtent?: boolean | undefined;\n}",
+              "type": "undefined | {\n    updateData?: boolean | undefined;\n    resetAxesBounds?: boolean | undefined;\n}",
               "docs": ""
             }
           ],
@@ -2417,10 +2414,6 @@
               "name": "param",
               "text": "props.updateData Indicates whether to fetch new data. Default: true."
             },
-            {
-              "name": "param",
-              "text": "props.updateExtent Indicates whether the view's extent is to update. Default: false."
-            },
             {
               "name": "param",
               "text": "props.resetAxesBounds Option to reset the axes bounds along with the refresh. Default: false;"
@@ -2596,23 +2589,23 @@
             "resolved": "WebChartBoxPlotDataItem | WebChartGenericDataItem | WebChartHistogramDataItem | WebChartScatterplotDataItem",
             "references": {
               "WebChartBoxPlotDataItem": {
-                "location": "import",
-                "path": "@arcgis/charts-spec/data-source.d.ts",
+                "location": "local",
+                "path": "dist/spec/data-source.d.ts",
                 "id": "notImplemented"
               },
               "WebChartGenericDataItem": {
-                "location": "import",
-                "path": "@arcgis/charts-spec/data-source.d.ts",
+                "location": "local",
+                "path": "dist/spec/data-source.d.ts",
                 "id": "notImplemented"
               },
               "WebChartHistogramDataItem": {
-                "location": "import",
-                "path": "@arcgis/charts-spec/data-source.d.ts",
+                "location": "local",
+                "path": "dist/spec/data-source.d.ts",
                 "id": "notImplemented"
               },
               "WebChartScatterplotDataItem": {
-                "location": "import",
-                "path": "@arcgis/charts-spec/data-source.d.ts",
+                "location": "local",
+                "path": "dist/spec/data-source.d.ts",
                 "id": "notImplemented"
               }
             }
@@ -2694,11 +2687,11 @@
         },
         {
           "event": "arcgisNoRenderPropChange",
-          "detail": "{\n    propName: string;\n    value: number | boolean | MapView | SceneView | WebChartLegendPositions | undefined;\n    model: ChartModel | undefined;\n}",
+          "detail": "{\n    propName: string;\n    value: number | boolean | WebChartLegendPositions | MapView | SceneView | undefined;\n    model: ChartModel | undefined;\n}",
           "bubbles": true,
           "complexType": {
-            "original": "{\n    propName: string;\n    value: number | boolean | MapView | SceneView | WebChartLegendPositions | undefined;\n    model: ChartModel | undefined;\n}",
-            "resolved": "{\n    propName: string;\n    value: number | boolean | MapView | SceneView | WebChartLegendPositions | undefined;\n    model: ChartModel | undefined;\n}",
+            "original": "{\n    propName: string;\n    value: number | boolean | WebChartLegendPositions | MapView | SceneView | undefined;\n    model: ChartModel | undefined;\n}",
+            "resolved": "{\n    propName: string;\n    value: number | boolean | WebChartLegendPositions | MapView | SceneView | undefined;\n    model: ChartModel | undefined;\n}",
             "references": {}
           },
           "cancelable": true,
@@ -2849,8 +2842,12 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The ArcGIS charts action bar component enhances chart functionality by offering context-specific actions such as rotation, zooming, and filtering.\nIt also supports general actions like exporting the chart as an image or CSV.\nThis component is designed to be used with a chart component and is not intended for standalone use.\n\nSee also:\n- [Tutorial: Charts components with Map components using charts action bar](https://developers.arcgis.com/javascript/latest/tutorials/charts-components-with-map-components/)",
+      "docs": "The ArcGIS Charts Action Bar component enhances chart functionality by providing context-specific actions such as rotation, zooming, and filtering, as well as general actions like exporting the chart as an image or CSV file.\nThis component is designed to be used with a chart component and is not intended for standalone use.\n\nSee also:\n- [Tutorial: Chart and map interactions](https://developers.arcgis.com/javascript/latest/tutorials/chart-and-map-interactions/)",
       "docsTags": [
+        {
+          "name": "since",
+          "text": "4.29"
+        },
         {
           "name": "superclass",
           "text": "{\"name\":\"LitElement\",\"package\":\"@arcgis/lumina\"}"
@@ -3106,10 +3103,10 @@
         },
         {
           "name": "disableCSVExportForChartTypes",
-          "type": "Array<\"number\" | \"cursorCrosshair\" | \"chartText\" | \"category\" | \"date\" | \"chartAxis\" | \"chartLegend\" | \"chartOverlay\" | \"chart\" | \"sizeScale\" | \"chartOverlays\" | \"scatterSeries\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"chartGuide\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"calendarDateParts\">",
+          "type": "Array<\"number\" | \"chart\" | \"chartText\" | \"chartOverlay\" | \"chartOverlays\" | \"chartLegend\" | \"cursorCrosshair\" | \"chartAxis\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"category\" | \"date\" | \"chartGuide\" | \"scatterSeries\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"sizeScale\" | \"calendarDateParts\">",
           "complexType": {
-            "original": "Array<\"number\" | \"cursorCrosshair\" | \"chartText\" | \"category\" | \"date\" | \"chartAxis\" | \"chartLegend\" | \"chartOverlay\" | \"chart\" | \"sizeScale\" | \"chartOverlays\" | \"scatterSeries\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"chartGuide\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"calendarDateParts\">",
-            "resolved": "Array<\"number\" | \"cursorCrosshair\" | \"chartText\" | \"category\" | \"date\" | \"chartAxis\" | \"chartLegend\" | \"chartOverlay\" | \"chart\" | \"sizeScale\" | \"chartOverlays\" | \"scatterSeries\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"chartGuide\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"calendarDateParts\">",
+            "original": "Array<\"number\" | \"chart\" | \"chartText\" | \"chartOverlay\" | \"chartOverlays\" | \"chartLegend\" | \"cursorCrosshair\" | \"chartAxis\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"category\" | \"date\" | \"chartGuide\" | \"scatterSeries\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"sizeScale\" | \"calendarDateParts\">",
+            "resolved": "Array<\"number\" | \"chart\" | \"chartText\" | \"chartOverlay\" | \"chartOverlays\" | \"chartLegend\" | \"cursorCrosshair\" | \"chartAxis\" | \"gaugeAxisTick\" | \"gaugeNeedle\" | \"category\" | \"date\" | \"chartGuide\" | \"scatterSeries\" | \"pieSeries\" | \"pieTick\" | \"gaugeSeries\" | \"lineSeries\" | \"barSeries\" | \"histogramSeries\" | \"boxPlotSeries\" | \"radarSeries\" | \"comboLineAndBarSeries\" | \"heatSeries\" | \"buffer\" | \"sizeScale\" | \"calendarDateParts\">",
             "references": {
               "Array": {
                 "location": "import",
@@ -3778,10 +3775,10 @@
         },
         {
           "name": "hiddenActions",
-          "type": "Array<\"zoom\" | \"editChart\" | \"legend\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
+          "type": "Array<\"legend\" | \"zoom\" | \"editChart\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
           "complexType": {
-            "original": "Array<\"zoom\" | \"editChart\" | \"legend\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
-            "resolved": "Array<\"zoom\" | \"editChart\" | \"legend\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
+            "original": "Array<\"legend\" | \"zoom\" | \"editChart\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
+            "resolved": "Array<\"legend\" | \"zoom\" | \"editChart\" | \"fullExtent\" | \"filterBySelection\" | \"filterByExtent\" | \"rotateChart\" | \"selection\" | \"clearSelection\" | \"switchSelection\" | \"exportAsImage\" | \"exportAsCSV\">",
             "references": {
               "Array": {
                 "location": "import",

package/dist/docs/vscode.html-custom-data.json

@@ -4,7 +4,7 @@
   "tags": [
     {
       "name": "arcgis-chart",
-      "description": "The ArcGIS Chart component renders various chart types based on the provided model.\n\nSupported chart types include bar charts, line charts, pie charts, box plots, combo bar-line charts, gauges, scatterplots, histograms and radar charts.\n\nThe Chart component can be rendered using an [existing model](https://developers.arcgis.com/javascript/latest/charts-components-intro/#use-an-existing-model-from-a-webmap-or-feature-layer) from a web map or feature layer,\nor by [creating a new model](https://developers.arcgis.com/javascript/latest/charts-components-intro/#create-a-new-model).\n\nSee also:\n- [Introduction to Charts components](https://developers.arcgis.com/javascript/latest/charts-components-intro/)\n- [Tutorial: Display and create charts components](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)\n--\n\n### Events\n- **arcgisAxesMinMaxChange** - Event triggered once the chart axes min/max values are computed\n- **arcgisBadDataWarningRaise** - Event triggered when an error is detected with the data set\n- **arcgisChartNotFoundWarning** - Event triggered when the chart is not found for the given `chartIndex` property.\n- **arcgisConfigChange** - Event triggered when the chart config is changed\n- **arcgisDataFetchComplete** - Event triggered once the chart data has been fetched but not yet fully processed.\nFor instance it can be useful for a pie chart to see all the slices before they get grouped into an 'other' slice during the post-processing step.\n- **arcgisDataProcessComplete** - Event triggered once the chart data has been processed\n- **arcgisDataProcessError** - Event triggered when an error occurred while fetching of processing the data for the chart\n- **arcgisLegendItemVisibilityChange** - Event triggered once a legend item visibility has been changed\n- **arcgisNoRenderPropChange** - Event triggered when a no-render prop is changed\n- **arcgisRuntimeError** - Event triggered when an error occurred that prevents the chart from being created or updated\n- **arcgisSelectionComplete** - Event triggered when a selection is applied to the chart\n- **arcgisSeriesColorChange** - Event triggered once the chart series color have been assigned\n- **arcgisSeriesOrder** - Event carrying the series id as they have been sorted following the `orderOptions` instructions\n- **arcgisUpdateComplete** - Event triggered once the chart is updated\n\n### Methods\n- `clearSelection(): Promise<void>` - Clears all selection on the chart.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `errorAlert(errorMessage?: string): Promise<void>` - Triggers an alert to display an error message.\n- `exportAsCSV(options?: CSVOptions): Promise<void>` - Export the current chart's data as a CSV file.\n- `exportAsImage(format?: DownloadableChartImagesTypes): Promise<void>` - Export the current chart as an image.\n- `notify(message?: string, heading?: string, options?: NotifyOptions): Promise<void>` - Notify method allows passing external messages to the chart component.\nIt can be used to pass validation or information messages.\nIn a situation where a config update is overriding your notification modal,\nconsider waiting for the `arcgisUpdateComplete` event.\n- `refresh(props?: { updateData?: boolean; resetAxesBounds?: boolean; updateExtent?: boolean; }): Promise<void>` - Re-render the chart.\n- `resetZoom(): Promise<void>` - Resets the chart zoom to bring it back to full extent\n- `switchSelection(): Promise<void>` - Switches the selection on the chart.\n\n### Slots\n- **action-bar** - Slot for adding a `charts-action-bar` component or `calcite-action-bar`.",
+      "description": "The ArcGIS Chart component renders a chart based on the provided model. Get started by reading the [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/) page.\n\nSupported chart types include bar charts, box plots, line charts, combo bar-line charts, gauges, heat charts, histograms, pie charts, scatterplots, and radar charts.\n\nSee also:\n- [Introduction to charts](https://developers.arcgis.com/javascript/latest/charts-components-intro/)\n- [Tutorial: Display a chart](https://developers.arcgis.com/javascript/latest/tutorials/display-and-create-charts-components/)\n- [Tutorial: Create a heat chart](https://developers.arcgis.com/javascript/latest/tutorials/create-a-heat-chart/)\n- [Tutorial: Modify a chart](https://developers.arcgis.com/javascript/latest/tutorials/modify-a-chart/)\n--\n\n### Events\n- **arcgisAxesMinMaxChange** - Event triggered once the chart axes min/max values are computed\n- **arcgisBadDataWarningRaise** - Event triggered when an error is detected with the data set\n- **arcgisChartNotFoundWarning** - Event triggered when the chart is not found for the given `chartIndex` property.\n- **arcgisConfigChange** - Event triggered when the chart config is changed\n- **arcgisDataFetchComplete** - Event triggered once the chart data has been fetched but not yet fully processed.\nFor instance it can be useful for a pie chart to see all the slices before they get grouped into an 'other' slice during the post-processing step.\n- **arcgisDataProcessComplete** - Event triggered once the chart data has been processed\n- **arcgisDataProcessError** - Event triggered when an error occurred while fetching of processing the data for the chart\n- **arcgisLegendItemVisibilityChange** - Event triggered once a legend item visibility has been changed\n- **arcgisNoRenderPropChange** - Event triggered when a no-render prop is changed\n- **arcgisRuntimeError** - Event triggered when an error occurred that prevents the chart from being created or updated\n- **arcgisSelectionComplete** - Event triggered when a selection is applied to the chart\n- **arcgisSeriesColorChange** - Event triggered once the chart series color have been assigned\n- **arcgisSeriesOrder** - Event carrying the series id as they have been sorted following the `orderOptions` instructions\n- **arcgisUpdateComplete** - Event triggered once the chart is updated\n\n### Methods\n- `clearSelection(): Promise<void>` - Clears all selection on the chart.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `errorAlert(errorMessage?: string): Promise<void>` - Triggers an alert to display an error message.\n- `exportAsCSV(options?: CSVOptions): Promise<void>` - Export the current chart's data as a CSV file.\n- `exportAsImage(format?: DownloadableChartImagesTypes): Promise<void>` - Export the current chart as an image.\n- `loadModel(): Promise<void>` - Returns a promise that resolves when the chart model is fully loaded.\n- `notify(message?: string, heading?: string, options?: NotifyOptions): Promise<void>` - Notify method allows passing external messages to the chart component.\nIt can be used to pass validation or information messages.\nIn a situation where a config update is overriding your notification modal,\nconsider waiting for the `arcgisUpdateComplete` event.\n- `refresh(props?: { updateData?: boolean; resetAxesBounds?: boolean; }): Promise<void>` - Re-render the chart.\n- `resetZoom(): Promise<void>` - Resets the chart zoom to bring it back to full extent\n- `switchSelection(): Promise<void>` - Switches the selection on the chart.\n\n### Slots\n- **action-bar** - Slot for adding a `charts-action-bar` component or `calcite-action-bar`.",
       "attributes": [
         {
           "name": "action-mode",
@@ -47,18 +47,6 @@
           "description": "The index of the chart to be rendered from the layer. Must be used in conjunction with the `layerItemId` or `layer` property.\n\nIf a `layer` or `layerItemId` is set without `chartIndex`, the first chart in the layer will be rendered.\n\nIf the `chartIndex` is out of bounds, the first chart in the layer will be rendered and a warning event will be emitted.",
           "values": []
         },
-        {
-          "name": "component-version",
-          "description": "Whether to use the stable version of the component or the beta version.",
-          "values": [
-            {
-              "name": "beta"
-            },
-            {
-              "name": "stable"
-            }
-          ]
-        },
         {
           "name": "cursor-range",
           "description": "Sets the cursor range:\n- CursorRange.MultiAxes: allows to draw a free rectangle\n- CursorRange.XAxis: allows to draw a rectangle bound to the x-axis\n- CursorRange.YAxis: allows to draw a rectangle bound to the y-axis\n- undefined: defaults to a preset behavior according to the chart type and action mode",
@@ -210,6 +198,11 @@
           "description": "When `true`, the legend is visible on the chart.",
           "values": []
         },
+        {
+          "name": "null-as-valid",
+          "description": "Whether to consider a `null` statistic as valid. If set to `false` and the data has only\nnull values, the chart's dataset will be considered empty:\n- the corresponding warning event will be sent\n- the \"no data\" message will be displayed (unless `showUIMesssages` is set to `false`)",
+          "values": []
+        },
         {
           "name": "placeholder",
           "description": "A placeholder string to provides a brief hint to the user indicating needed information for creating a chart.",
@@ -250,6 +243,11 @@
           "description": "When `true`, the series properties `unit` and `size` become optional and will be automatically set to values that fit the data set. Used when creating or updating a chart compatible with time binning.",
           "values": []
         },
+        {
+          "name": "show-ui-messages",
+          "description": "Whether to display or hide all UI messages (e.g. no data warnings, or when the logarithmic scale can't be applied to an\naxis when the data contains values <= 0).",
+          "values": []
+        },
         {
           "name": "sync-selection",
           "description": "Whether to synchronize the selection between chart components from the same layer.",
@@ -320,6 +318,10 @@
           "name": "Gauge\nGauges visualize a single metric within a quantitative context defined by minimum and maximum values.",
           "url": "https://developers.arcgis.com/javascript/latest/storybook/charts-components/?path=/story/arcgis-chart--gauge&singleStory=true"
         },
+        {
+          "name": "Heat Chart\nHeat charts visualize data density or intensity across two dimensions, using color gradients to represent values.",
+          "url": "https://developers.arcgis.com/javascript/latest/storybook/charts-components/?path=/story/arcgis-chart--heat-chart&singleStory=true"
+        },
         {
           "name": "Histogram\nHistograms visualize the distribution of a continuous numeric variable by showing the frequency of values within defined intervals.",
           "url": "https://developers.arcgis.com/javascript/latest/storybook/charts-components/?path=/story/arcgis-chart--histogram&singleStory=true"
@@ -340,7 +342,7 @@
     },
     {
       "name": "arcgis-charts-action-bar",
-      "description": "The ArcGIS charts action bar component enhances chart functionality by offering context-specific actions such as rotation, zooming, and filtering.\nIt also supports general actions like exporting the chart as an image or CSV.\nThis component is designed to be used with a chart component and is not intended for standalone use.\n\nSee also:\n- [Tutorial: Charts components with Map components using charts action bar](https://developers.arcgis.com/javascript/latest/tutorials/charts-components-with-map-components/)\n--\n\n### Events\n- **arcgisActionBarToggle** - Event triggered once action bar expand is toggled\n- **arcgisDefaultActionSelect** - Event triggered once a default action is selected\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n\n### Slots\n- **custom-action-top** - A slot for adding custom `calcite-action` to the top of the default actions.\n- **custom-action-below** - A slot for adding custom `calcite-action` to the bottom of the default actions.",
+      "description": "The ArcGIS Charts Action Bar component enhances chart functionality by providing context-specific actions such as rotation, zooming, and filtering, as well as general actions like exporting the chart as an image or CSV file.\nThis component is designed to be used with a chart component and is not intended for standalone use.\n\nSee also:\n- [Tutorial: Chart and map interactions](https://developers.arcgis.com/javascript/latest/tutorials/chart-and-map-interactions/)\n--\n\n### Events\n- **arcgisActionBarToggle** - Event triggered once action bar expand is toggled\n- **arcgisDefaultActionSelect** - Event triggered once a default action is selected\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n\n### Slots\n- **custom-action-top** - A slot for adding custom `calcite-action` to the top of the default actions.\n- **custom-action-below** - A slot for adding custom `calcite-action` to the bottom of the default actions.",
       "attributes": [
         {
           "name": "action-bar-selection-mode",