@arcgis/map-components 4.33.0-next.164 → 4.33.0-next.166

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-17T18:03:51",
+  "timestamp": "2025-06-19T15:12:14",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.33.0-next.164",
+    "version": "4.33.0-next.166",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -98,7 +98,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisAreaMeasurement2d = document.createElement(\"arcgis-area-measurement-2d\");\ndocument.body.append(arcgisAreaMeasurement2d);\narcgisAreaMeasurement2d.componentOnReady().then(() => {\n  console.log(\"arcgis-area-measurement-2d is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisAreaMeasurement2d = document.querySelector(\"arcgis-area-measurement-2d\");\ndocument.body.append(arcgisAreaMeasurement2d);\nawait arcgisAreaMeasurement2d.componentOnReady();\nconsole.log(\"arcgis-area-measurement-2d is ready to go!\");\n```"
                 }
               ]
             },
@@ -126,7 +126,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -299,7 +299,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The ViewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D-AreaMeasurement2DViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -437,7 +437,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -523,7 +523,7 @@
             },
             {
               "name": "state",
-              "description": "The ViewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-AreaMeasurement2D-AreaMeasurement2DViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -661,7 +661,7 @@
           "customElement": true,
           "name": "ArcgisAreaMeasurement3d",
           "tagName": "arcgis-area-measurement-3d",
-          "description": "The Area Measurement 3D component calculates and displays the area and perimeter of a polygon.\nIt can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to measure the area and perimeter of a polygon.\n\n[![measurement-area-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,\n  in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).\n- If the perimeter is above 100 km, they are computed geodetically, and the visualization takes\n  the curvature of the planet into consideration.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter\nare always calculated in a Euclidean manner (in their respective PCS).\n\nThe area may be visualized and calculated in two ways:\n1. If all the vertices are more or less **coplanar** (aligning onto a horizontal or a sloped plane),\n  the area and perimeter are projected to that plane. Also, the measurements are computed on that plane.\n2. If the vertices have varying z-values and they create a **non-planar** surface, the visualization and the\nmeasurements show the area and perimeter that are projected to a horizontal plane.\n\n![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)\n\nWhen the component is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\n\nThe Area Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Area Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/).\n\n**Things to consider**\n\n* Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
+          "description": "The Area Measurement 3D component can be added to a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to calculate and display area and perimeter of polygons.\n\n[![measurement-area-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_AreaMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow the area and perimeter are computed depends on the scene's spatial reference and the length of the measured perimeter.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- If the measurement's perimeter is below 100 km, they are computed in a Euclidean manner,\n  in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets).\n- If the perimeter is above 100 km, they are computed geodetically, and the visualization takes\n  the curvature of the planet into consideration.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, the area and perimeter\nare always calculated in a Euclidean manner (in their respective PCS).\n\nThe area may be visualized and calculated in two ways:\n1. If all the vertices are mostly coplanar (lying on the same plane),\n   the measurement polygon is formed on that plane, and area and perimeter are calculated from its geometry.\n2. If the vertices don't form a planar surface, the measurement polygon\n   is projected to a horizontal plane, and area and perimeter are calculated from its geometry.\n\n![area-measurement-3d-types](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/area-measurement-3d-types.png)\n\nWhen the component is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\n\n**Things to consider**\n\n* Area Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Area Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-area-measurement-2d/).\n* Snapping is enabled by default. Holding the `CTRL` key disables it.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
           "demos": [
             {
               "description": "Docs",
@@ -683,7 +683,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst areaMeasurementAnalysis = new AreaMeasurementAnalysis({\n   geometry: new Polygon({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     rings: [\n       [\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764],\n         [-13624935.305160372, 4550273.144585712, 63.37829629518092],\n         [-13624995.61798748, 4550334.030096778, 63.37819860037416],\n         [-13624921.53589075, 4550407.42357004, 63.3783810287714],\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764]\n       ]\n     ]\n   })\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst areaMeasurement3d = document.querySelector(\"arcgis-area-measurement-3d\");\nawait areaMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(areaMeasurementAnalysis);\n// Connect the analysis to the measurement component:\nareaMeasurement3d.analysis = areaMeasurementAnalysis;\n```",
+              "description": "The [AreaMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-AreaMeasurementAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Area Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\n\n```js\n// Create the analysis.\nconst areaMeasurementAnalysis = new AreaMeasurementAnalysis({\n   geometry: new Polygon({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     rings: [\n       [\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764],\n         [-13624935.305160372, 4550273.144585712, 63.37829629518092],\n         [-13624995.61798748, 4550334.030096778, 63.37819860037416],\n         [-13624921.53589075, 4550407.42357004, 63.3783810287714],\n         [-13624861.22274897, 4550346.5519295, 63.378210234455764]\n       ]\n     ]\n   })\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst areaMeasurement3d = document.querySelector(\"arcgis-area-measurement-3d\");\nawait areaMeasurement3d.componentOnReady();\n// Add the analysis to the Scene component.\nviewElement.analyses.add(areaMeasurementAnalysis);\n// Connect the analysis to the measurement component:\nareaMeasurement3d.analysis = areaMeasurementAnalysis;\n```",
               "type": {
                 "text": "AreaMeasurementAnalysis",
                 "references": [
@@ -761,7 +761,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisAreaMeasurement3d = document.createElement(\"arcgis-area-measurement-3d\");\ndocument.body.append(arcgisAreaMeasurement3d);\narcgisAreaMeasurement3d.componentOnReady().then(() => {\n  console.log(\"arcgis-area-measurement-3d is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisAreaMeasurement3d = document.querySelector(\"arcgis-area-measurement-3d\");\ndocument.body.append(arcgisAreaMeasurement3d);\nawait arcgisAreaMeasurement3d.componentOnReady();\nconsole.log(\"arcgis-area-measurement-3d is ready to go!\");\n```"
                 }
               ]
             },
@@ -1049,7 +1049,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of available units and unit systems (imperial, metric) for displaying the area values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
+              "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
                 "text": "Array<\"square-millimeters\" | \"square-centimeters\" | \"square-decimeters\" | \"square-meters\" | \"square-kilometers\" | \"square-inches\" | \"square-feet\" | \"square-yards\" | \"square-miles\" | \"square-nautical-miles\" | \"square-us-feet\" | \"acres\" | \"ares\" | \"hectares\" | \"imperial\" | \"metric\">",
                 "references": [
@@ -1383,7 +1383,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisAttachments = document.createElement(\"arcgis-attachments\");\ndocument.body.append(arcgisAttachments);\narcgisAttachments.componentOnReady().then(() => {\n  console.log(\"arcgis-attachments is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisAttachments = document.querySelector(\"arcgis-attachments\");\ndocument.body.append(arcgisAttachments);\nawait arcgisAttachments.componentOnReady();\nconsole.log(\"arcgis-attachments is ready to go!\");\n```"
                 }
               ]
             },
@@ -1565,7 +1565,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -1699,7 +1699,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments-AttachmentsViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -1884,7 +1884,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -1970,7 +1970,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Attachments-AttachmentsViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -2118,7 +2118,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisBasemapGallery = document.createElement(\"arcgis-basemap-gallery\");\ndocument.body.append(arcgisBasemapGallery);\narcgisBasemapGallery.componentOnReady().then(() => {\n  console.log(\"arcgis-basemap-gallery is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisBasemapGallery = document.querySelector(\"arcgis-basemap-gallery\");\ndocument.body.append(arcgisBasemapGallery);\nawait arcgisBasemapGallery.componentOnReady();\nconsole.log(\"arcgis-basemap-gallery is ready to go!\");\n```"
                 }
               ]
             },
@@ -2375,7 +2375,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapGallery-BasemapGalleryViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"unsupported\"",
                 "values": [
@@ -2570,7 +2570,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapGallery-BasemapGalleryViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"unsupported\"",
                 "values": [
@@ -2842,7 +2842,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisBasemapLayerList = document.createElement(\"arcgis-basemap-layer-list\");\ndocument.body.append(arcgisBasemapLayerList);\narcgisBasemapLayerList.componentOnReady().then(() => {\n  console.log(\"arcgis-basemap-layer-list is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisBasemapLayerList = document.querySelector(\"arcgis-basemap-layer-list\");\ndocument.body.append(arcgisBasemapLayerList);\nawait arcgisBasemapLayerList.componentOnReady();\nconsole.log(\"arcgis-basemap-layer-list is ready to go!\");\n```"
                 }
               ]
             },
@@ -3000,7 +3000,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -3346,7 +3346,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList-BasemapLayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -3584,7 +3584,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -3803,7 +3803,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapLayerList-BasemapLayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -3992,7 +3992,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisBasemapToggle = document.createElement(\"arcgis-basemap-toggle\");\ndocument.body.append(arcgisBasemapToggle);\narcgisBasemapToggle.componentOnReady().then(() => {\n  console.log(\"arcgis-basemap-toggle is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisBasemapToggle = document.querySelector(\"arcgis-basemap-toggle\");\ndocument.body.append(arcgisBasemapToggle);\nawait arcgisBasemapToggle.componentOnReady();\nconsole.log(\"arcgis-basemap-toggle is ready to go!\");\n```"
                 }
               ]
             },
@@ -4205,7 +4205,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapToggle-BasemapToggleViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"incompatible-next-basemap\" | \"loading\" | \"ready\"",
                 "values": [
@@ -4385,7 +4385,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BasemapToggle-BasemapToggleViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"incompatible-next-basemap\" | \"loading\" | \"ready\"",
                 "values": [
@@ -4557,7 +4557,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisBookmarks = document.createElement(\"arcgis-bookmarks\");\ndocument.body.append(arcgisBookmarks);\narcgisBookmarks.componentOnReady().then(() => {\n  console.log(\"arcgis-bookmarks is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisBookmarks = document.querySelector(\"arcgis-bookmarks\");\ndocument.body.append(arcgisBookmarks);\nawait arcgisBookmarks.componentOnReady();\nconsole.log(\"arcgis-bookmarks is ready to go!\");\n```"
                 }
               ]
             },
@@ -4736,7 +4736,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -4954,7 +4954,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"loading\" | \"ready\"",
                 "values": [
@@ -5099,7 +5099,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -5263,7 +5263,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Bookmarks-BookmarksViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"loading\" | \"ready\"",
                 "values": [
@@ -5423,7 +5423,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisBuildingExplorer = document.createElement(\"arcgis-building-explorer\");\ndocument.body.append(arcgisBuildingExplorer);\narcgisBuildingExplorer.componentOnReady().then(() => {\n  console.log(\"arcgis-building-explorer is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisBuildingExplorer = document.querySelector(\"arcgis-building-explorer\");\ndocument.body.append(arcgisBuildingExplorer);\nawait arcgisBuildingExplorer.componentOnReady();\nconsole.log(\"arcgis-building-explorer is ready to go!\");\n```"
                 }
               ]
             },
@@ -5537,7 +5537,7 @@
             {
               "kind": "field",
               "name": "layers",
-              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)\nof layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)\nthat are added to the componen for exploration.",
+              "description": "A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html)\nof layers of type [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html)\nthat are added to the componen for exploration.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-BuildingExplorer.html#layers)",
               "type": {
                 "text": "Collection<BuildingSceneLayer>",
                 "references": [
@@ -6095,7 +6095,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisCatalogLayerList = document.createElement(\"arcgis-catalog-layer-list\");\ndocument.body.append(arcgisCatalogLayerList);\narcgisCatalogLayerList.componentOnReady().then(() => {\n  console.log(\"arcgis-catalog-layer-list is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisCatalogLayerList = document.querySelector(\"arcgis-catalog-layer-list\");\ndocument.body.append(arcgisCatalogLayerList);\nawait arcgisCatalogLayerList.componentOnReady();\nconsole.log(\"arcgis-catalog-layer-list is ready to go!\");\n```"
                 }
               ]
             },
@@ -6205,7 +6205,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -6501,7 +6501,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList-CatalogLayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -6659,7 +6659,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -6864,7 +6864,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CatalogLayerList-CatalogLayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -7033,7 +7033,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisCompass = document.createElement(\"arcgis-compass\");\ndocument.body.append(arcgisCompass);\narcgisCompass.componentOnReady().then(() => {\n  console.log(\"arcgis-compass is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisCompass = document.querySelector(\"arcgis-compass\");\ndocument.body.append(arcgisCompass);\nawait arcgisCompass.componentOnReady();\nconsole.log(\"arcgis-compass is ready to go!\");\n```"
                 }
               ]
             },
@@ -7258,7 +7258,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Compass-CompassViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"compass\" | \"disabled\" | \"rotation\"",
                 "values": [
@@ -7385,7 +7385,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Compass-CompassViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"compass\" | \"disabled\" | \"rotation\"",
                 "values": [
@@ -7506,7 +7506,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisCoordinateConversion = document.createElement(\"arcgis-coordinate-conversion\");\ndocument.body.append(arcgisCoordinateConversion);\narcgisCoordinateConversion.componentOnReady().then(() => {\n  console.log(\"arcgis-coordinate-conversion is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisCoordinateConversion = document.querySelector(\"arcgis-coordinate-conversion\");\ndocument.body.append(arcgisCoordinateConversion);\nawait arcgisCoordinateConversion.componentOnReady();\nconsole.log(\"arcgis-coordinate-conversion is ready to go!\");\n```"
                 }
               ]
             },
@@ -7691,7 +7691,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -7997,7 +7997,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CoordinateConversion-CoordinateConversionViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -8140,7 +8140,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -8282,7 +8282,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-CoordinateConversion-CoordinateConversionViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -8375,7 +8375,7 @@
           "customElement": true,
           "name": "ArcgisDaylight",
           "tagName": "arcgis-daylight",
-          "description": "The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nDaylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
+          "description": "The Daylight component can be used to manipulate the lighting conditions of a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nDaylight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [Environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment)\n- [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)",
           "demos": [
             {
               "description": "Docs",
@@ -8436,7 +8436,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisDaylight = document.createElement(\"arcgis-daylight\");\ndocument.body.append(arcgisDaylight);\narcgisDaylight.componentOnReady().then(() => {\n  console.log(\"arcgis-daylight is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisDaylight = document.querySelector(\"arcgis-daylight\");\ndocument.body.append(arcgisDaylight);\nawait arcgisDaylight.componentOnReady();\nconsole.log(\"arcgis-daylight is ready to go!\");\n```"
                 }
               ]
             },
@@ -8470,7 +8470,7 @@
             {
               "kind": "field",
               "name": "dateOrSeason",
-              "description": "Controls whether the component displays a date or a season picker.",
+              "description": "Controls whether the component displays a date or a season picker.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)",
               "type": {
                 "text": "\"date\" | \"season\"",
                 "values": [
@@ -8768,7 +8768,7 @@
             {
               "kind": "field",
               "name": "timeSliderSteps",
-              "description": "Sets steps, or intervals, on the time slider to restrict the times\nof the day that can be selected when dragging the thumb.",
+              "description": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#timeSliderSteps)",
               "type": {
                 "text": "Array<number> | number",
                 "references": [
@@ -8851,7 +8851,7 @@
             },
             {
               "name": "date-or-season",
-              "description": "Controls whether the component displays a date or a season picker.",
+              "description": "Controls whether the component displays a date or a season picker.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#dateOrSeason)",
               "type": {
                 "text": "\"date\" | \"season\"",
                 "values": [
@@ -9076,7 +9076,7 @@
             },
             {
               "name": "time-slider-steps",
-              "description": "Sets steps, or intervals, on the time slider to restrict the times\nof the day that can be selected when dragging the thumb.",
+              "description": "Sets steps, or intervals, on the time slider to restrict the times of the day that can be selected when dragging the thumb.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Daylight.html#timeSliderSteps)",
               "type": {
                 "text": "number",
                 "values": [
@@ -9208,7 +9208,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisDirectionalPad = document.createElement(\"arcgis-directional-pad\");\ndocument.body.append(arcgisDirectionalPad);\narcgisDirectionalPad.componentOnReady().then(() => {\n  console.log(\"arcgis-directional-pad is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisDirectionalPad = document.querySelector(\"arcgis-directional-pad\");\ndocument.body.append(arcgisDirectionalPad);\nawait arcgisDirectionalPad.componentOnReady();\nconsole.log(\"arcgis-directional-pad is ready to go!\");\n```"
                 }
               ]
             },
@@ -9439,7 +9439,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DirectionalPad-DirectionalPadViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"moving\" | \"ready\"",
                 "values": [
@@ -9646,7 +9646,7 @@
             },
             {
               "name": "state",
-              "description": "The state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DirectionalPad-DirectionalPadViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"moving\" | \"ready\"",
                 "values": [
@@ -9803,7 +9803,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisDirections = document.createElement(\"arcgis-directions\");\ndocument.body.append(arcgisDirections);\narcgisDirections.componentOnReady().then(() => {\n  console.log(\"arcgis-directions is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisDirections = document.querySelector(\"arcgis-directions\");\ndocument.body.append(arcgisDirections);\nawait arcgisDirections.componentOnReady();\nconsole.log(\"arcgis-directions is ready to go!\");\n```"
                 }
               ]
             },
@@ -9930,7 +9930,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -10229,7 +10229,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions-DirectionsViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"initializing\" | \"ready\" | \"routing\" | \"unauthenticated\"",
                 "values": [
@@ -10446,7 +10446,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -10558,7 +10558,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Directions-DirectionsViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"initializing\" | \"ready\" | \"routing\" | \"unauthenticated\"",
                 "values": [
@@ -10705,7 +10705,7 @@
           "customElement": true,
           "name": "ArcgisDirectLineMeasurement3d",
           "tagName": "arcgis-direct-line-measurement-3d",
-          "description": "The Direct Line Measurement 3D component calculates and displays the 3D distance between two points.\nIt can be used in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to measure the vertical, horizontal, and direct distance between two points.\n\n[![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow distances are computed depends on the scene's spatial reference.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- Direct distance is computed in a Euclidean manner, in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets);\n- Horizontal distance is computed geodetically, taking into consideration the curvature of the planet;\n- Vertical distance is computed as an elevation difference.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, all three distances (direct, horizontal, and vertical)\n are computed in a Euclidean manner (in their respective PCS).\n\nDirectLineMeasurement3D widget visualizes and labels the direct, horizontal, and vertical distances and displays the same values\nin the UI panel. When the distance between the points is greater than 100 kilometers,\nthe measurement visualization is simplified, and only the horizontal and vertical distances are calculated.\nThe direct distance option becomes unavailable.\n\n![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/direct-line-measurement-3d.png)\n\nWhen the widget is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\nA second laser line shows the intersection of the scene with the vertical plane that passes through the checkered line.\n\nThe Direct Line Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Distance Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-distance-measurement-2d/).\n\n**Things to consider**\n\n* Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)\n- [Sample - Color theming for interactive tools](https://developers.arcgis.com/javascript/latest/sample-code/view-theme/)",
+          "description": "The Direct Line Measurement 3D component can be added to a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent to calculate and display vertical, horizontal, and direct distances between two points.\n\n[![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/3D_DirectLineMeasurement_widget.png)](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n\nHow distances are computed depends on the scene's spatial reference.\n\nIn **geographic coordinate systems** (GCS) and in **Web Mercator**:\n- Direct distance is computed in a Euclidean manner, in an [ECEF](https://en.wikipedia.org/wiki/ECEF) coordinate system (or equivalent on other planets);\n- Horizontal distance is computed geodetically, taking into consideration the curvature of the planet;\n- Vertical distance is computed as an elevation difference.\n\nIn **projected coordinate systems** (PCS), apart from Web Mercator, all three distances (direct, horizontal, and vertical)\n are computed in a Euclidean manner (in their respective PCS).\n\nDirect Line Measurement 3D component visualizes and labels the direct, horizontal, and vertical distances and displays the same values\nin the UI panel. When the distance between the points is greater than 100 kilometers,\nthe measurement visualization is simplified, and only the horizontal and vertical distances are calculated.\nThe direct distance option becomes unavailable.\n\n![measurement-line-3d](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/direct-line-measurement-3d.png)\n\nWhen the component is active, a horizontal \"laser\" line is drawn which indicates the height at the current mouse position.\nThis line can help in analyzing the heights of objects relative to each other and the terrain.\nA second laser line shows the intersection of the scene with the vertical plane that passes through the checkered line.\n\n**Things to consider**\n\n* Direct Line Measurement 3D is designed to work in the Scene component. For measurements in the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/)\ncomponent, use [Distance Measurement 2D](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-distance-measurement-2d/).\n* Snapping is enabled by default. This can be temporarily disabled by holding the `CTRL` key.\n* Layer types currently supported for snapping are:\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html) (except Mesh geometries),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[3D Object SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\nand [BuildingSceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-BuildingSceneLayer.html).\n\n**See also**\n\n- [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\n- [Sample - Measurement in 3D](https://developers.arcgis.com/javascript/latest/sample-code/measurement-3d/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)\n- [Sample - Color theming for interactive tools](https://developers.arcgis.com/javascript/latest/sample-code/view-theme/)",
           "demos": [
             {
               "description": "Docs",
@@ -10727,7 +10727,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
+              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Direct Line Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the Scene component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
               "type": {
                 "text": "DirectLineMeasurementAnalysis",
                 "references": [
@@ -10805,7 +10805,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisDirectLineMeasurement3d = document.createElement(\"arcgis-direct-line-measurement-3d\");\ndocument.body.append(arcgisDirectLineMeasurement3d);\narcgisDirectLineMeasurement3d.componentOnReady().then(() => {\n  console.log(\"arcgis-direct-line-measurement-3d is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisDirectLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\ndocument.body.append(arcgisDirectLineMeasurement3d);\nawait arcgisDirectLineMeasurement3d.componentOnReady();\nconsole.log(\"arcgis-direct-line-measurement-3d is ready to go!\");\n```"
                 }
               ]
             },
@@ -11081,7 +11081,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of available units and unit systems (imperial, metric) for displaying the distance values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
+              "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
                 "text": "Array<\"imperial\" | \"metric\" | \"millimeters\" | \"centimeters\" | \"decimeters\" | \"meters\" | \"kilometers\" | \"inches\" | \"feet\" | \"yards\" | \"miles\" | \"nautical-miles\" | \"us-feet\">",
                 "references": [
@@ -11331,7 +11331,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
+              "description": "The [DirectLineMeasurementAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-DirectLineMeasurementAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Direct Line Measurement 3D component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\n\n```js\n// Create the analysis.\nconst directLineAnalysis = new DirectLineMeasurementAnalysis({\n   startPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624995.61798748,\n     y: 4550334.030096778,\n     z: 63.378210234455764\n   }),\n   endPoint: new Point({\n     spatialReference: { latestWkid: 3857, wkid: 102100 },\n     x: -13624921.53589075,\n     y: 4550407.42357004,\n     z: 63.3783810287714\n   }),\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst directLineMeasurement3d = document.querySelector(\"arcgis-direct-line-measurement-3d\");\nawait directLineMeasurement3d.componentOnReady();\n// Add the analysis to the Scene component.\nviewElement.analyses.add(directLineAnalysis);\n// Connect the analysis to the measurement component:\ndirectLineMeasurement3d.analysis = directLineAnalysis;\n```",
               "type": {
                 "text": "DirectLineMeasurementAnalysis",
                 "references": [
@@ -11421,7 +11421,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst deprecatedArcgisDirectLineMeasurement3d = document.createElement(\"arcgis-directline-measurement-3d\");\ndocument.body.append(deprecatedArcgisDirectLineMeasurement3d);\ndeprecatedArcgisDirectLineMeasurement3d.componentOnReady().then(() => {\n  console.log(\"arcgis-directline-measurement-3d is ready to go!\");\n});\n```"
+                  "text": "```js\nconst deprecatedArcgisDirectLineMeasurement3d = document.querySelector(\"arcgis-directline-measurement-3d\");\ndocument.body.append(deprecatedArcgisDirectLineMeasurement3d);\nawait deprecatedArcgisDirectLineMeasurement3d.componentOnReady();\nconsole.log(\"arcgis-directline-measurement-3d is ready to go!\");\n```"
                 }
               ]
             },
@@ -11729,7 +11729,7 @@
             {
               "kind": "field",
               "name": "unitOptions",
-              "description": "List of available units and unit systems (imperial, metric) for displaying the distance values.\nBy default, the following units are included: `metric`, `imperial`, `square-inches`, `square-feet`, `square-us-feet`, `square-yards`, `square-miles`, `square-meters`, `square-kilometers`, `acres`, `ares`, `hectares`.\nPossible [unit](#unit) values can only be a subset of this list.\nWith this, it is possible to limit which options are shown in the component's dropdown.",
+              "description": "List of available units and unit systems (imperial, metric) that are shown in the component's dropdown.\nBy default, the following units are included: `metric`, `imperial`, `inches`, `feet`, `us-feet`, `yards`, `miles`, `nautical-miles`, `meters`, `kilometers`.\nPossible [unit](#unit) values can only be a subset of this list.",
               "type": {
                 "text": "Array<\"imperial\" | \"metric\" | \"millimeters\" | \"centimeters\" | \"decimeters\" | \"meters\" | \"kilometers\" | \"inches\" | \"feet\" | \"yards\" | \"miles\" | \"nautical-miles\" | \"us-feet\">",
                 "references": [
@@ -12102,7 +12102,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisDistanceMeasurement2d = document.createElement(\"arcgis-distance-measurement-2d\");\ndocument.body.append(arcgisDistanceMeasurement2d);\narcgisDistanceMeasurement2d.componentOnReady().then(() => {\n  console.log(\"arcgis-distance-measurement-2d is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisDistanceMeasurement2d = document.querySelector(\"arcgis-distance-measurement-2d\");\ndocument.body.append(arcgisDistanceMeasurement2d);\nawait arcgisDistanceMeasurement2d.componentOnReady();\nconsole.log(\"arcgis-distance-measurement-2d is ready to go!\");\n```"
                 }
               ]
             },
@@ -12130,7 +12130,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -12303,7 +12303,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DistanceMeasurement2D-DistanceMeasurement2DViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -12429,7 +12429,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -12515,7 +12515,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-DistanceMeasurement2D-DistanceMeasurement2DViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -12768,7 +12768,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisEditor = document.createElement(\"arcgis-editor\");\ndocument.body.append(arcgisEditor);\narcgisEditor.componentOnReady().then(() => {\n  console.log(\"arcgis-editor is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisEditor = document.querySelector(\"arcgis-editor\");\ndocument.body.append(arcgisEditor);\nawait arcgisEditor.componentOnReady();\nconsole.log(\"arcgis-editor is ready to go!\");\n```"
                 }
               ]
             },
@@ -12943,7 +12943,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -13313,9 +13313,9 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Editor-EditorViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
-                "text": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"creating-features\" | \"disabled\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"editing-new-feature\" | \"ready\" | \"viewing-selection-list\"",
+                "text": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"creating-features\" | \"disabled\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"ready\" | \"viewing-selection-list\"",
                 "values": [
                   {
                     "value": "add-association-create-association",
@@ -13373,10 +13373,6 @@
                     "value": "editing-features",
                     "type": "string"
                   },
-                  {
-                    "value": "editing-new-feature",
-                    "type": "string"
-                  },
                   {
                     "value": "ready",
                     "type": "string"
@@ -13564,7 +13560,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -13663,9 +13659,9 @@
             },
             {
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Editor-EditorViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
-                "text": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"creating-features\" | \"disabled\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"editing-new-feature\" | \"ready\" | \"viewing-selection-list\"",
+                "text": "\"add-association-create-association\" | \"add-association-select-feature\" | \"add-association-select-layer\" | \"adding-attachment\" | \"awaiting-feature-creation-info\" | \"awaiting-feature-to-create\" | \"awaiting-feature-to-update\" | \"awaiting-update-feature-candidate\" | \"creating-features\" | \"disabled\" | \"editing-attachment\" | \"editing-attributes\" | \"editing-existing-feature\" | \"editing-features\" | \"ready\" | \"viewing-selection-list\"",
                 "values": [
                   {
                     "value": "add-association-create-association",
@@ -13723,10 +13719,6 @@
                     "value": "editing-features",
                     "type": "string"
                   },
-                  {
-                    "value": "editing-new-feature",
-                    "type": "string"
-                  },
                   {
                     "value": "ready",
                     "type": "string"
@@ -13778,7 +13770,7 @@
           "customElement": true,
           "name": "ArcgisElevationProfile",
           "tagName": "arcgis-elevation-profile",
-          "description": "The Elevation Profile component is used to generate and display an elevation profile from an [input line graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input).",
+          "description": "The Elevation Profile component is used to generate and display an elevation profile from an [input line graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input).\n\n**See also**\n\n- [Sample - Elevation Profile component](https://developers.arcgis.com/javascript/latest/sample-code/elevation-profile/)",
           "demos": [
             {
               "description": "Docs",
@@ -13839,7 +13831,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisElevationProfile = document.createElement(\"arcgis-elevation-profile\");\ndocument.body.append(arcgisElevationProfile);\narcgisElevationProfile.componentOnReady().then(() => {\n  console.log(\"arcgis-elevation-profile is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisElevationProfile = document.querySelector(\"arcgis-elevation-profile\");\ndocument.body.append(arcgisElevationProfile);\nawait arcgisElevationProfile.componentOnReady();\nconsole.log(\"arcgis-elevation-profile is ready to go!\");\n```"
                 }
               ]
             },
@@ -14043,7 +14035,7 @@
             {
               "kind": "field",
               "name": "input",
-              "description": "The input line graphic along which elevation will be queried in order to generate an elevation profile.",
+              "description": "The input path along which elevation will be queried in order to generate an elevation profile.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#input)",
               "type": {
                 "text": "Graphic",
                 "references": [
@@ -14123,7 +14115,7 @@
             {
               "kind": "field",
               "name": "profiles",
-              "description": "Collection of elevation profile lines which are to be generated and displayed in the component's chart.",
+              "description": "Collection of elevation profile lines which are to be generated and displayed in the component's chart.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ElevationProfile.html#profiles)",
               "type": {
                 "text": "Collection<ElevationProfileLineGround | ElevationProfileLineInput | ElevationProfileLineQuery | ElevationProfileLineView>",
                 "references": [
@@ -14240,6 +14232,7 @@
             {
               "kind": "method",
               "name": "start",
+              "description": "Switches to the \"creating\" state in which the user can draw a new line.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -14299,6 +14292,7 @@
             {
               "kind": "method",
               "name": "stop",
+              "description": "Stops the creation operation.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -14951,7 +14945,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisExpand = document.createElement(\"arcgis-expand\");\ndocument.body.append(arcgisExpand);\narcgisExpand.componentOnReady().then(() => {\n  console.log(\"arcgis-expand is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisExpand = document.querySelector(\"arcgis-expand\");\ndocument.body.append(arcgisExpand);\nawait arcgisExpand.componentOnReady();\nconsole.log(\"arcgis-expand is ready to go!\");\n```"
                 }
               ]
             },
@@ -15812,7 +15806,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFeature = document.createElement(\"arcgis-feature\");\ndocument.body.append(arcgisFeature);\narcgisFeature.componentOnReady().then(() => {\n  console.log(\"arcgis-feature is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFeature = document.querySelector(\"arcgis-feature\");\ndocument.body.append(arcgisFeature);\nawait arcgisFeature.componentOnReady();\nconsole.log(\"arcgis-feature is ready to go!\");\n```"
                 }
               ]
             },
@@ -16009,7 +16003,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -16313,7 +16307,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"loading\" | \"ready\"",
                 "values": [
@@ -16513,7 +16507,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -16599,7 +16593,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"loading\" | \"ready\"",
                 "values": [
@@ -16736,7 +16730,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFeatureForm = document.createElement(\"arcgis-feature-form\");\ndocument.body.append(arcgisFeatureForm);\narcgisFeatureForm.componentOnReady().then(() => {\n  console.log(\"arcgis-feature-form is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFeatureForm = document.querySelector(\"arcgis-feature-form\");\ndocument.body.append(arcgisFeatureForm);\nawait arcgisFeatureForm.componentOnReady();\nconsole.log(\"arcgis-feature-form is ready to go!\");\n```"
                 }
               ]
             },
@@ -16856,7 +16850,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -17068,7 +17062,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureForm-FeatureFormViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -17174,7 +17168,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -17260,7 +17254,7 @@
             },
             {
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureForm-FeatureFormViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -17786,7 +17780,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFeatureTable = document.createElement(\"arcgis-feature-table\");\ndocument.body.append(arcgisFeatureTable);\narcgisFeatureTable.componentOnReady().then(() => {\n  console.log(\"arcgis-feature-table is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFeatureTable = document.querySelector(\"arcgis-feature-table\");\ndocument.body.append(arcgisFeatureTable);\nawait arcgisFeatureTable.componentOnReady();\nconsole.log(\"arcgis-feature-table is ready to go!\");\n```"
                 }
               ]
             },
@@ -18566,7 +18560,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "The string value which indicates the displayed [icon](https://developers.arcgis.com/calcite-design-system/icons/).",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -19662,7 +19656,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureTable.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"loaded\" | \"loading\" | \"ready\"",
                 "values": [
@@ -20331,7 +20325,7 @@
             },
             {
               "name": "icon",
-              "description": "The string value which indicates the displayed [icon](https://developers.arcgis.com/calcite-design-system/icons/).",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -20662,7 +20656,7 @@
             },
             {
               "name": "state",
-              "description": "The state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureTable.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"error\" | \"loaded\" | \"loading\" | \"ready\"",
                 "values": [
@@ -20922,7 +20916,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFeatureTemplates = document.createElement(\"arcgis-feature-templates\");\ndocument.body.append(arcgisFeatureTemplates);\narcgisFeatureTemplates.componentOnReady().then(() => {\n  console.log(\"arcgis-feature-templates is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFeatureTemplates = document.querySelector(\"arcgis-feature-templates\");\ndocument.body.append(arcgisFeatureTemplates);\nawait arcgisFeatureTemplates.componentOnReady();\nconsole.log(\"arcgis-feature-templates is ready to go!\");\n```"
                 }
               ]
             },
@@ -21034,7 +21028,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -21252,7 +21246,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureTemplates-FeatureTemplatesViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -21362,7 +21356,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -21466,7 +21460,7 @@
             },
             {
               "name": "state",
-              "description": "The widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-FeatureTemplates-FeatureTemplatesViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -21732,7 +21726,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFeatures = document.createElement(\"arcgis-features\");\ndocument.body.append(arcgisFeatures);\narcgisFeatures.componentOnReady().then(() => {\n  console.log(\"arcgis-features is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFeatures = document.querySelector(\"arcgis-features\");\ndocument.body.append(arcgisFeatures);\nawait arcgisFeatures.componentOnReady();\nconsole.log(\"arcgis-features is ready to go!\");\n```"
                 }
               ]
             },
@@ -22109,7 +22103,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -22491,7 +22485,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -22783,7 +22777,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -22928,7 +22922,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -23087,7 +23081,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFloorFilter = document.createElement(\"arcgis-floor-filter\");\ndocument.body.append(arcgisFloorFilter);\narcgisFloorFilter.componentOnReady().then(() => {\n  console.log(\"arcgis-floor-filter is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFloorFilter = document.querySelector(\"arcgis-floor-filter\");\ndocument.body.append(arcgisFloorFilter);\nawait arcgisFloorFilter.componentOnReady();\nconsole.log(\"arcgis-floor-filter is ready to go!\");\n```"
                 }
               ]
             },
@@ -23145,7 +23139,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -23404,7 +23398,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -23605,7 +23599,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisFullscreen = document.createElement(\"arcgis-fullscreen\");\ndocument.body.append(arcgisFullscreen);\narcgisFullscreen.componentOnReady().then(() => {\n  console.log(\"arcgis-fullscreen is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisFullscreen = document.querySelector(\"arcgis-fullscreen\");\ndocument.body.append(arcgisFullscreen);\nawait arcgisFullscreen.componentOnReady();\nconsole.log(\"arcgis-fullscreen is ready to go!\");\n```"
                 }
               ]
             },
@@ -23976,7 +23970,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisGridControls = document.createElement(\"arcgis-grid-controls\");\ndocument.body.append(arcgisGridControls);\narcgisGridControls.componentOnReady().then(() => {\n  console.log(\"arcgis-grid-controls is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisGridControls = document.querySelector(\"arcgis-grid-controls\");\ndocument.body.append(arcgisGridControls);\nawait arcgisGridControls.componentOnReady();\nconsole.log(\"arcgis-grid-controls is ready to go!\");\n```"
                 }
               ]
             },
@@ -25279,7 +25273,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisHistogramRangeSlider = document.createElement(\"arcgis-histogram-range-slider\");\ndocument.body.append(arcgisHistogramRangeSlider);\narcgisHistogramRangeSlider.componentOnReady().then(() => {\n  console.log(\"arcgis-histogram-range-slider is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisHistogramRangeSlider = document.querySelector(\"arcgis-histogram-range-slider\");\ndocument.body.append(arcgisHistogramRangeSlider);\nawait arcgisHistogramRangeSlider.componentOnReady();\nconsole.log(\"arcgis-histogram-range-slider is ready to go!\");\n```"
                 }
               ]
             },
@@ -25406,7 +25400,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -25696,7 +25690,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-SliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -25777,7 +25771,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -25986,7 +25980,7 @@
             },
             {
               "name": "state",
-              "description": "The state of the view model.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider-SliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -26123,7 +26117,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisHome = document.createElement(\"arcgis-home\");\ndocument.body.append(arcgisHome);\narcgisHome.componentOnReady().then(() => {\n  console.log(\"arcgis-home is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisHome = document.querySelector(\"arcgis-home\");\ndocument.body.append(arcgisHome);\nawait arcgisHome.componentOnReady();\nconsole.log(\"arcgis-home is ready to go!\");\n```"
                 }
               ]
             },
@@ -26323,7 +26317,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Home-HomeViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"going-home\" | \"ready\"",
                 "values": [
@@ -26476,7 +26470,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Home-HomeViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"going-home\" | \"ready\"",
                 "values": [
@@ -26693,7 +26687,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLayerList = document.createElement(\"arcgis-layer-list\");\ndocument.body.append(arcgisLayerList);\narcgisLayerList.componentOnReady().then(() => {\n  console.log(\"arcgis-layer-list is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLayerList = document.querySelector(\"arcgis-layer-list\");\ndocument.body.append(arcgisLayerList);\nawait arcgisLayerList.componentOnReady();\nconsole.log(\"arcgis-layer-list is ready to go!\");\n```"
                 }
               ]
             },
@@ -26832,7 +26826,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -27217,7 +27211,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-LayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -27491,7 +27485,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -27710,7 +27704,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LayerList-LayerListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -27920,7 +27914,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLegend = document.createElement(\"arcgis-legend\");\ndocument.body.append(arcgisLegend);\narcgisLegend.componentOnReady().then(() => {\n  console.log(\"arcgis-legend is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLegend = document.querySelector(\"arcgis-legend\");\ndocument.body.append(arcgisLegend);\nawait arcgisLegend.componentOnReady();\nconsole.log(\"arcgis-legend is ready to go!\");\n```"
                 }
               ]
             },
@@ -27978,7 +27972,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -28193,7 +28187,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -28273,7 +28267,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -28401,7 +28395,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -28457,7 +28451,7 @@
           "customElement": true,
           "name": "ArcgisLineOfSight",
           "tagName": "arcgis-line-of-sight",
-          "description": "The Line Of Sight component is a 3D analysis tool that allows you to perform\n[line of sight visibility analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\nin a 3D view. Visibility between a given observer and multiple target points is calculated against the currently\ndisplayed content in the view, including ground, integrated meshes, and 3D objects such as buildings or trees.\n\nThe results from the analysis are displayed as lines, where the visible part, indicating what the observer can see,\nis colored green. Visible targets are displayed with a green sphere and a fully green line of sight.\nThe spheres marking occluded targets are displayed red, as are the occluded parts of the lines of sight.\nWhen the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either\nthe target or the observer is not in the view.\n\nWhen creating a new line of sight analysis with the component, the first click in the scene creates the\n[observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)\nand any further clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).\nBoth, observer and target points, can be moved by dragging them. Additionally, the target points can be removed with a right click.\n\n**Known limitations**\n\nLine Of Sight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
+          "description": "The Line Of Sight component is a 3D analysis tool that allows you to perform\n[line of sight visibility analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\nin a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). Visibility between a given observer and multiple target points is calculated against the currently\ndisplayed content in the view, including the ground, integrated meshes, and 3D objects such as buildings or trees.\n\n![line-of-sight](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/line-of-sight.png)\n\nThe analysis results are displayed as colored lines, where areas visible to the observer are\nshown green and occluded parts are marked in red. Also, the color of the target points indicates their visibility.\nWhen the line of sight cannot be calculated, it will be displayed with a gray color. This may happen if either\nthe target or the observer is not in the view.\n\nWhen creating a new line of sight analysis, the first click in the Scene creates the\n[observer](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisObserver.html)\nand subsequent clicks place the [targets](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysisTarget.html).\nBoth the observer and target points can be moved by dragging. Additionally, the target points can be removed with a right click.\n\n**Known limitation**\n\nLine Of Sight is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\n- [Sample - Line of sight component](https://developers.arcgis.com/javascript/latest/sample-code/line-of-sight/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
           "demos": [
             {
               "description": "Docs",
@@ -28479,7 +28473,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [line of sight analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\nobject being created by the component.",
+              "description": "The [LineOfSightAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-LineOfSightAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Line Of Sight component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\n\n```js\n//Create the analysis.\nconst lineOfSightAnalysis = new LineOfSightAnalysis({\n  observer: new LineOfSightAnalysisObserver({\n        position: new Point({\n        spatialReference: { latestWkid: 3857, wkid: 102100 },\n        x: -13624828.3377593,\n        y: 4550305.319405007,\n        z: 105.55410975124687\n        }),\n  }),\n  targets: [ new LineOfSightAnalysisTarget({\n        position: new Point({\n        spatialReference: { latestWkid: 3857, wkid: 102100 },\n        x: -13624944.17687458,\n        y: 4550420.577689567,\n        z: 0\n        }),\n  })\n]\n});\n// Get the Scene and Line Of Sight component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst lineOfSight = document.querySelector(\"arcgis-line-of-sight\");\nawait lineOfSight.componentOnReady();\n// Add the analysis to the Scene component.\nviewElement.analyses.add(lineOfSightAnalysis);\n// Connect the analysis to the component:\nlineOfSight.analysis = lineOfSightAnalysis;\n```",
               "type": {
                 "text": "LineOfSightAnalysis",
                 "references": [
@@ -28557,7 +28551,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLineOfSight = document.createElement(\"arcgis-line-of-sight\");\ndocument.body.append(arcgisLineOfSight);\narcgisLineOfSight.componentOnReady().then(() => {\n  console.log(\"arcgis-line-of-sight is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLineOfSight = document.querySelector(\"arcgis-line-of-sight\");\ndocument.body.append(arcgisLineOfSight);\nawait arcgisLineOfSight.componentOnReady();\nconsole.log(\"arcgis-line-of-sight is ready to go!\");\n```"
                 }
               ]
             },
@@ -28799,7 +28793,7 @@
             {
               "kind": "method",
               "name": "stop",
-              "description": "Stop the current line of sight analysis, keeping the results in the view.\nUsers can still interact with existing targets and the observer but they cannot place new target points.",
+              "description": "Stop the current placing of line of sight analysis. Any lines added this far are kept  in the view.\nUsers can still interact with existing targets and the observer, but they cannot place new target points.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -29328,7 +29322,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLinkChart = document.createElement(\"arcgis-link-chart\");\ndocument.body.append(arcgisLinkChart);\narcgisLinkChart.componentOnReady().then(() => {\n  console.log(\"arcgis-link-chart is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLinkChart = document.querySelector(\"arcgis-link-chart\");\ndocument.body.append(arcgisLinkChart);\nawait arcgisLinkChart.componentOnReady();\nconsole.log(\"arcgis-link-chart is ready to go!\");\n```"
                 }
               ]
             },
@@ -30952,7 +30946,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLinkChartLayoutSwitcher = document.createElement(\"arcgis-link-chart-layout-switcher\");\ndocument.body.append(arcgisLinkChartLayoutSwitcher);\narcgisLinkChartLayoutSwitcher.componentOnReady().then(() => {\n  console.log(\"arcgis-link-chart-layout-switcher is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLinkChartLayoutSwitcher = document.querySelector(\"arcgis-link-chart-layout-switcher\");\ndocument.body.append(arcgisLinkChartLayoutSwitcher);\nawait arcgisLinkChartLayoutSwitcher.componentOnReady();\nconsole.log(\"arcgis-link-chart-layout-switcher is ready to go!\");\n```"
                 }
               ]
             },
@@ -31180,7 +31174,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LinkChartLayoutSwitcher-LinkChartLayoutSwitcherViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -31422,7 +31416,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-LinkChartLayoutSwitcher-LinkChartLayoutSwitcherViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -31586,7 +31580,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisLocate = document.createElement(\"arcgis-locate\");\ndocument.body.append(arcgisLocate);\narcgisLocate.componentOnReady().then(() => {\n  console.log(\"arcgis-locate is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisLocate = document.querySelector(\"arcgis-locate\");\ndocument.body.append(arcgisLocate);\nawait arcgisLocate.componentOnReady();\nconsole.log(\"arcgis-locate is ready to go!\");\n```"
                 }
               ]
             },
@@ -32116,7 +32110,7 @@
           "customElement": true,
           "name": "ArcgisMap",
           "tagName": "arcgis-map",
-          "description": "The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the\n[ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\nThe Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\"></arcgis-map>\n```\n\nAlternatively, the Map component can be initialized without a WebMap item.\n\n```html\n<arcgis-map basemap=\"satellite\" center=\"-154.88, 19.46\" zoom=\"15\"></arcgis-map>\n```\n\nOther components can be added and connected to the Map component.\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\">\n <arcgis-zoom position=\"top-left\"></arcgis-zoom>\n <arcgis-legend position=\"bottom-left\"></arcgis-legend>\n</arcgis-map>\n```\n\nThe Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n const layer = new GraphicsLayer({ title: \"My Layer\" });\n viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
+          "description": "The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the\n[ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\nThe Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\"></arcgis-map>\n```\n\nAlternatively, the Map component can be initialized without a WebMap item.\n\n```html\n<arcgis-map basemap=\"satellite\" center=\"-154.88, 19.46\" zoom=\"15\"></arcgis-map>\n```\n\nOther components can be added and connected to the Map component.\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\">\n <arcgis-zoom position=\"top-left\"></arcgis-zoom>\n <arcgis-legend position=\"bottom-left\"></arcgis-legend>\n</arcgis-map>\n```\n\nThe Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n const layer = new GraphicsLayer({ title: \"My Layer\" });\n viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)\n- [Get started](https://developers.arcgis.com/javascript/latest/get-started/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
           "demos": [
             {
               "description": "Docs",
@@ -32560,7 +32554,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisMap = document.createElement(\"arcgis-map\");\ndocument.body.append(arcgisMap);\narcgisMap.componentOnReady().then(() => {\n  console.log(\"arcgis-map is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisMap = document.querySelector(\"arcgis-map\");\ndocument.body.append(arcgisMap);\nawait arcgisMap.componentOnReady();\nconsole.log(\"arcgis-map is ready to go!\");\n```"
                 }
               ]
             },
@@ -32832,7 +32826,7 @@
                   }
                 ]
               },
-              "deprecated": "since 4.33, use {@link ArcgisMap#highlights } instead.\n\nOptions for configuring the highlight. Use the highlight method on the\nappropriate esri/views/layers/LayerView to highlight a feature.\nThe layerView's `highlightOptions` will take precedence over the MapView's `highlightOptions` if both properties are set."
+              "deprecated": "since 4.33, use [highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#highlights) instead.\n\nOptions for configuring the highlight. Use the highlight method on the\nappropriate esri/views/layers/LayerView to highlight a feature.\nThe layerView's `highlightOptions` will take precedence over the MapView's `highlightOptions` if both properties are set."
             },
             {
               "kind": "field",
@@ -34594,7 +34588,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisMeasurement = document.createElement(\"arcgis-measurement\");\ndocument.body.append(arcgisMeasurement);\narcgisMeasurement.componentOnReady().then(() => {\n  console.log(\"arcgis-measurement is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisMeasurement = document.querySelector(\"arcgis-measurement\");\ndocument.body.append(arcgisMeasurement);\nawait arcgisMeasurement.componentOnReady();\nconsole.log(\"arcgis-measurement is ready to go!\");\n```"
                 }
               ]
             },
@@ -34622,7 +34616,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -34839,7 +34833,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The ViewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement-MeasurementViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -34982,7 +34976,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -35130,7 +35124,7 @@
             },
             {
               "name": "state",
-              "description": "The ViewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Measurement-MeasurementViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"measured\" | \"measuring\" | \"ready\"",
                 "values": [
@@ -35240,7 +35234,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisNavigationToggle = document.createElement(\"arcgis-navigation-toggle\");\ndocument.body.append(arcgisNavigationToggle);\narcgisNavigationToggle.componentOnReady().then(() => {\n  console.log(\"arcgis-navigation-toggle is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisNavigationToggle = document.querySelector(\"arcgis-navigation-toggle\");\ndocument.body.append(arcgisNavigationToggle);\nawait arcgisNavigationToggle.componentOnReady();\nconsole.log(\"arcgis-navigation-toggle is ready to go!\");\n```"
                 }
               ]
             },
@@ -35711,7 +35705,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisOrientedImageryViewer = document.createElement(\"arcgis-oriented-imagery-viewer\");\ndocument.body.append(arcgisOrientedImageryViewer);\narcgisOrientedImageryViewer.componentOnReady().then(() => {\n  console.log(\"arcgis-oriented-imagery-viewer is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisOrientedImageryViewer = document.querySelector(\"arcgis-oriented-imagery-viewer\");\ndocument.body.append(arcgisOrientedImageryViewer);\nawait arcgisOrientedImageryViewer.componentOnReady();\nconsole.log(\"arcgis-oriented-imagery-viewer is ready to go!\");\n```"
                 }
               ]
             },
@@ -35799,7 +35793,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -36161,7 +36155,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -36426,7 +36420,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisPlacement = document.createElement(\"arcgis-placement\");\ndocument.body.append(arcgisPlacement);\narcgisPlacement.componentOnReady().then(() => {\n  console.log(\"arcgis-placement is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisPlacement = document.querySelector(\"arcgis-placement\");\ndocument.body.append(arcgisPlacement);\nawait arcgisPlacement.componentOnReady();\nconsole.log(\"arcgis-placement is ready to go!\");\n```"
                 }
               ]
             },
@@ -36776,7 +36770,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisPrint = document.createElement(\"arcgis-print\");\ndocument.body.append(arcgisPrint);\narcgisPrint.componentOnReady().then(() => {\n  console.log(\"arcgis-print is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisPrint = document.querySelector(\"arcgis-print\");\ndocument.body.append(arcgisPrint);\nawait arcgisPrint.componentOnReady();\nconsole.log(\"arcgis-print is ready to go!\");\n```"
                 }
               ]
             },
@@ -37669,7 +37663,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisScaleBar = document.createElement(\"arcgis-scale-bar\");\ndocument.body.append(arcgisScaleBar);\narcgisScaleBar.componentOnReady().then(() => {\n  console.log(\"arcgis-scale-bar is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisScaleBar = document.querySelector(\"arcgis-scale-bar\");\ndocument.body.append(arcgisScaleBar);\nawait arcgisScaleBar.componentOnReady();\nconsole.log(\"arcgis-scale-bar is ready to go!\");\n```"
                 }
               ]
             },
@@ -38096,7 +38090,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisScaleRangeSlider = document.createElement(\"arcgis-scale-range-slider\");\ndocument.body.append(arcgisScaleRangeSlider);\narcgisScaleRangeSlider.componentOnReady().then(() => {\n  console.log(\"arcgis-scale-range-slider is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisScaleRangeSlider = document.querySelector(\"arcgis-scale-range-slider\");\ndocument.body.append(arcgisScaleRangeSlider);\nawait arcgisScaleRangeSlider.componentOnReady();\nconsole.log(\"arcgis-scale-range-slider is ready to go!\");\n```"
                 }
               ]
             },
@@ -38182,7 +38176,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -38449,7 +38443,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider-ScaleRangeSliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -38540,7 +38534,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -38701,7 +38695,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ScaleRangeSlider-ScaleRangeSliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -38757,7 +38751,7 @@
           "customElement": true,
           "name": "ArcgisScene",
           "tagName": "arcgis-scene",
-          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n  const layer = new GraphicsLayer({ title: \"My layer\"});\n  viewElement.map.add(layer);\n});\n```\n\n**See also**\n\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Getting started](https://developers.arcgis.com/javascript/latest/get-started-overview/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
+          "description": "The ArcGIS Scene component is used to add 3D maps to web applications. For 2D maps, use the\n[ArcGIS Map component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/).\n\nThe Scene component creates a [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html)\nand loads a [WebScene](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebScene.html) item from either\n[ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\"></arcgis-scene>\n```\n\nAlternatively, the Scene component can be initialized without a WebScene item:\n\n```html\n<arcgis-scene\n basemap=\"satellite\"\n ground=\"world-elevation\"\n camera-position=\"12.3808, 46.3959, 4400\"\n camera-tilt=\"75\"\n camera-heading=\"300\">\n</arcgis-scene>\n```\n\nFurther components can be added and connected to the Scene component:\n\n```html\n<arcgis-scene item-id=\"e2da7564e4f24eaaa918ffd70378056a\">\n  <arcgis-layer-list position=\"bottom-right\"></arcgis-layer-list>\n</arcgis-scene>\n```\n\nThe Scene component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/)\nof the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\n// The view is now ready to be used.\nconst layer = new GraphicsLayer({ title: \"My layer\"});\nviewElement.map.add(layer);\n```\n\n**See also**\n\n- [SDK sample apps using the Scene component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-scene)\n- [Get started](https://developers.arcgis.com/javascript/latest/get-started/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
           "demos": [
             {
               "description": "Docs",
@@ -39315,7 +39309,7 @@
             {
               "kind": "field",
               "name": "clippingArea",
-              "description": "Represents an optional clipping area used to define the visible [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html)\nof a [local scene](#viewingMode).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#clippingArea)",
+              "description": "Represents an optional clipping area used to define the visible [extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html)\nof a Scene in `local` [viewingMode](#viewingMode).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#clippingArea)",
               "type": {
                 "text": "Extent",
                 "references": [
@@ -39378,7 +39372,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisScene = document.createElement(\"arcgis-scene\");\ndocument.body.append(arcgisScene);\narcgisScene.componentOnReady().then(() => {\n  console.log(\"arcgis-scene is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisScene = document.querySelector(\"arcgis-scene\");\ndocument.body.append(arcgisScene);\nawait arcgisScene.componentOnReady();\nconsole.log(\"arcgis-scene is ready to go!\");\n```"
                 }
               ]
             },
@@ -39438,7 +39432,7 @@
             {
               "kind": "field",
               "name": "environment",
-              "description": "Specifies various properties of the environment's visualization in the view, like the lighting, background, weather, etc.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment)",
+              "description": "Specifies various properties of the environment's visualization within the view, including lighting, background, weather, and more.\nThe Scene will redraw automatically when any property of environment changes.\n\nModifying the lighting:\n\n```js\nviewElement.environment.lighting = {\n  type: \"sun\", // autocasts as new SunLighting()\n  date: new Date(), // sets the lighting to reflect the current time of day\n  directShadowsEnabled: true,\n};\n```\n\nSetting the background:\n\n```js\nviewElement.environment = {\n background: {\n    type: \"color\",\n    color: [255, 252, 244, 1]\n },\n  starsEnabled: false,\n  atmosphereEnabled: false\n};\n```\n\nChanging the weather in the scene:\n\n```js\nviewElement.environment.weather = {\n  type: \"rainy\", // autocasts as new RainyWeather({ cloudCover: 0.7, precipitation: 0.3 })\n  cloudCover: 0.7,\n  precipitation: 0.3\n};\n```\n\n**See also**\n\n- [SunLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunLighting.html)\n- [VirtualLighting](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-VirtualLighting.html)\n- [SunnyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunnyWeather.html)\n- [CloudyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-CloudyWeather.html)\n- [RainyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-RainyWeather.html)\n- [SnowyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SnowyWeather.html)\n- [FoggyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-FoggyWeather.html)\n- [Sample - Daylight component](https://developers.arcgis.com/javascript/latest/sample-code/daylight/)\n- [Sample - Weather component](https://developers.arcgis.com/javascript/latest/sample-code/weather/)\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#environment)",
               "type": {
                 "text": "SceneViewEnvironment",
                 "references": [
@@ -39455,7 +39449,7 @@
             {
               "kind": "field",
               "name": "extent",
-              "description": "The extent represents the visible portion of a map within the view as an instance of\n[Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\n\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#extent)",
+              "description": "The extent represents the visible portion of a [map](#map) within the view as an instance of\n[Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\n\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#extent)",
               "type": {
                 "text": "Extent",
                 "references": [
@@ -39643,7 +39637,7 @@
             {
               "kind": "field",
               "name": "ground",
-              "description": "Specifies the surface properties for the map. It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)\ninstance or a string with one of the following values:\n   * `\"world-elevation\"`\n   * `\"world-topobathymetry\"`\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground)",
+              "description": "Specifies the surface properties for the [map](#map). It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)\ninstance or a string with one of the following values:\n   * `\"world-elevation\"`\n   * `\"world-topobathymetry\"`\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground)",
               "type": {
                 "text": "Ground | string",
                 "references": [
@@ -39855,7 +39849,7 @@
             {
               "kind": "field",
               "name": "layerViews",
-              "description": "A collection containing a hierarchical list of all the created\n[LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) of the\n[operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the map.",
+              "description": "A collection containing a hierarchical list of all the created\n[LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) of the\n[operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the [map](#map).",
               "type": {
                 "text": "Collection<LayerView>",
                 "references": [
@@ -40038,7 +40032,7 @@
             {
               "kind": "field",
               "name": "popup",
-              "description": "A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) object that displays general content or attributes from\n[layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#map).\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#popup)",
+              "description": "A [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html)\nobject that displays general content or attributes from [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers)\nin the [map](#map).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#popup)",
               "type": {
                 "text": "Popup",
                 "references": [
@@ -40110,7 +40104,7 @@
             {
               "kind": "field",
               "name": "resolution",
-              "description": "Represents the current value of one pixel in the unit of the view's\n[spatialReference](#spatialReference).\nThe resolution is calculated by dividing the view's [extent width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)\nby [its width](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#width).",
+              "description": "Represents the current value of one pixel in the unit of the view's\n[spatialReference](#spatialReference).\nThe resolution is calculated by dividing the [Scene's extent](#extent) [width](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html#width)\nby [its width](#width).",
               "type": {
                 "text": "number",
                 "values": [
@@ -40582,7 +40576,7 @@
             {
               "kind": "field",
               "name": "visibleArea",
-              "description": "The visibleArea represents the visible portion of a [map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) within the view as\nan instance of a [Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html).\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#visibleArea)",
+              "description": "The visibleArea represents the visible portion of a [map](#map) within the view as an instance of a\n[Polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html).\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#visibleArea)",
               "type": {
                 "text": "Polygon",
                 "references": [
@@ -40931,7 +40925,7 @@
             },
             {
               "name": "ground",
-              "description": "Specifies the surface properties for the map. It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)\ninstance or a string with one of the following values:\n   * `\"world-elevation\"`\n   * `\"world-topobathymetry\"`\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground)",
+              "description": "Specifies the surface properties for the [map](#map). It can be either a [Ground](https://developers.arcgis.com/javascript/latest/api-reference/esri-Ground.html)\ninstance or a string with one of the following values:\n   * `\"world-elevation\"`\n   * `\"world-topobathymetry\"`\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#ground)",
               "type": {
                 "text": "string",
                 "values": [
@@ -41053,7 +41047,7 @@
           ],
           "events": [
             {
-              "name": "arcgisAnalysisViewCreate",
+              "name": "arcgisViewAnalysisViewCreate",
               "description": "Fires when the view for an analysis is created.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-create)",
               "type": {
                 "text": "ViewAnalysisViewCreateEvent",
@@ -41069,7 +41063,7 @@
               }
             },
             {
-              "name": "arcgisAnalysisViewCreateError",
+              "name": "arcgisViewAnalysisViewCreateError",
               "description": "Fires when an error occurs during the creation of an analysis view after an analysis is added to the view.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-create-error)",
               "type": {
                 "text": "ViewAnalysisViewCreateErrorEvent",
@@ -41085,7 +41079,7 @@
               }
             },
             {
-              "name": "arcgisAnalysisViewDestroy",
+              "name": "arcgisViewAnalysisViewDestroy",
               "description": "Fires after an analysis view is destroyed.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#event-analysis-view-destroy)",
               "type": {
                 "text": "ViewAnalysisViewDestroyEvent",
@@ -41395,7 +41389,7 @@
             },
             {
               "name": "arcgisViewReadyChange",
-              "description": "This event is for the [ready](#ready) property and will be emitted when the view is ready.\nThis event will also emit if the [map](#map) property is changed.\n\n```js\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n   const layer = new GraphicsLayer({ title: \"My layer\"});\n   viewElement.map.add(layer);\n});\n```",
+              "description": "This event is for the [ready](#ready) property and will be emitted when the view is ready.\nThis event will also emit if the [map](#map) property is changed.",
               "type": {
                 "text": "void"
               }
@@ -41636,7 +41630,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSearch = document.createElement(\"arcgis-search\");\ndocument.body.append(arcgisSearch);\narcgisSearch.componentOnReady().then(() => {\n  console.log(\"arcgis-search is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSearch = document.querySelector(\"arcgis-search\");\ndocument.body.append(arcgisSearch);\nawait arcgisSearch.componentOnReady();\nconsole.log(\"arcgis-search is ready to go!\");\n```"
                 }
               ]
             },
@@ -42295,7 +42289,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"searching\"",
                 "values": [
@@ -42720,7 +42714,7 @@
             },
             {
               "name": "state",
-              "description": "The current state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search-SearchViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\" | \"searching\"",
                 "values": [
@@ -42951,7 +42945,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSearchResultRenderer = document.createElement(\"arcgis-search-result-renderer\");\ndocument.body.append(arcgisSearchResultRenderer);\narcgisSearchResultRenderer.componentOnReady().then(() => {\n  console.log(\"arcgis-search-result-renderer is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSearchResultRenderer = document.querySelector(\"arcgis-search-result-renderer\");\ndocument.body.append(arcgisSearchResultRenderer);\nawait arcgisSearchResultRenderer.componentOnReady();\nconsole.log(\"arcgis-search-result-renderer is ready to go!\");\n```"
                 }
               ]
             },
@@ -43048,7 +43042,7 @@
           "customElement": true,
           "name": "ArcgisShadowCast",
           "tagName": "arcgis-shadow-cast",
-          "description": "The Shadow Cast component displays the cumulative shadows of 3D features in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nShadow Cast is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
+          "description": "The Shadow Cast component displays the cumulative shadows of 3D features in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nThis type of analysis is helpful in urban development, where new projects have to satisfy certain shadow duration constraints.\n\nThe component calculates the cumulative shadows for a time range during a single day. The user can\nconfigure the time range and select a calendar date. This time range and calendar date are only used\nfor the shadow analysis and are not connected to the lighting in the scene.\nTo control the lighting in the scene, the [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component can be used.\nChanging the timezone in the component updates the visualization by interpreting the time range as being\nin that timezone. This behavior is different from the [Daylight](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-daylight/) component,\nwhere selecting a timezone updates the [environment lighting's](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) date and time according to the camera position.\n\nThe component provides three [visualization modes](#visualizationType): threshold, duration, and discrete mode.\n\nIn the **threshold** mode, only the areas that receive\nshadows for more than a certain amount of time are displayed. In the image below, on May 1, 2021 the red areas receive\nshadow for more than 4 hours within the time interval of 10AM to 4PM.\n\n[![threshold mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-threshold.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)\n\n**Total shadow duration** mode displays the duration of the cumulative shadow using opacity: areas that don't\nreceive any shadow are fully transparent and areas that receive a maximum amount of shadow have a default opacity\nof 0.7. The values in between are interpolated. Hovering over the Scene will display a tooltip showing the\namount of time that location is in shadow, rounded to 15-minute intervals. In this mode, the visualization\ncan display shadow cast in a continuous way or in 1-hour intervals.\n\n[![duration mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-duration.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)\n\n**Discrete shadows** is a third visualization mode which displays individual shadows at a given time interval.\nFor example, setting the time range to 10AM-11AM and the visualization time interval to 30 minutes will display\nshadows for 10AM, 10:30AM and 11:00AM.\n\n[![discrete mode](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/shadow-cast/shadow-cast-discrete.png)](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)\n\nThe defaults for the time range and visualization settings can be changed using the [startTimeOfDay](#startTimeOfDay), [endTimeOfDay](#endTimeOfDay), and [visualizationType](#visualizationType) properties.\n\n**Known limitations**\n\n* Shadow Cast is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n* Terrain does not cast shadows and it is therefore not taken into account in this analysis.\n* The component does not take into account the daylight savings.\nUse the timezone dropdown to adjust the offset from the Coordinated Universal Time (UTC) and account for the daylight saving time.\n* The timezone is automatically detected by the component based on the camera location. In some situations, this might not be accurate.\nIn case of an inaccurate timezone, users can set it manually using the timezone dropdown.\n\n**See also**\n\n- [Sample - Shadow cast component](https://developers.arcgis.com/javascript/latest/sample-code/shadow-cast/)",
           "demos": [
             {
               "description": "Docs",
@@ -43109,13 +43103,14 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisShadowCast = document.createElement(\"arcgis-shadow-cast\");\ndocument.body.append(arcgisShadowCast);\narcgisShadowCast.componentOnReady().then(() => {\n  console.log(\"arcgis-shadow-cast is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisShadowCast = document.querySelector(\"arcgis-shadow-cast\");\ndocument.body.append(arcgisShadowCast);\nawait arcgisShadowCast.componentOnReady();\nconsole.log(\"arcgis-shadow-cast is ready to go!\");\n```"
                 }
               ]
             },
             {
               "kind": "field",
               "name": "date",
+              "description": "The calendar date used to calculate the shadow cast. This date excludes the time. If a date with a time is set, the time value will be set to midnight (`00:00:00`) of that date in local system time.\nIf no date is set, then it defaults to the current date in local system time.\n\n_See also_\n\n* [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)",
               "type": {
                 "text": "Date | number | string",
                 "references": [
@@ -43168,7 +43163,7 @@
             {
               "kind": "field",
               "name": "discreteOptions",
-              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"discrete\".",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"discrete\".\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-DiscreteOptions.html)",
               "type": {
                 "text": "DiscreteOptions",
                 "references": [
@@ -43186,7 +43181,7 @@
             {
               "kind": "field",
               "name": "durationOptions",
-              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"duration\".",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"duration\".\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-DurationOptions.html)",
               "type": {
                 "text": "DurationOptions",
                 "references": [
@@ -43204,7 +43199,7 @@
             {
               "kind": "field",
               "name": "endTimeOfDay",
-              "description": "Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date)) when the shadow cast computation should stop.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)",
+              "description": "Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should stop.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)",
               "type": {
                 "text": "number",
                 "values": [
@@ -43219,6 +43214,7 @@
             {
               "kind": "method",
               "name": "getDuration",
+              "description": "Returns the time (in milliseconds) spent in shadow for a certain point on the screen.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#getDuration)",
               "parameters": [
                 {
                   "name": "point",
@@ -43540,6 +43536,7 @@
             {
               "kind": "method",
               "name": "start",
+              "description": "Starts the component. While running, it will automatically perform shadow accumulation.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -43560,7 +43557,7 @@
             {
               "kind": "field",
               "name": "startTimeOfDay",
-              "description": "Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date))\nwhen the shadow cast computation should start.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)",
+              "description": "Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should start.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)",
               "type": {
                 "text": "number",
                 "values": [
@@ -43598,6 +43595,7 @@
             {
               "kind": "method",
               "name": "stop",
+              "description": "Stops the component.",
               "return": {
                 "type": {
                   "text": "Promise<void>",
@@ -43618,7 +43616,7 @@
             {
               "kind": "field",
               "name": "thresholdOptions",
-              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"threshold\".",
+              "description": "The configuration used when the component's [visualizationType](#visualizationType)\nis set to \"threshold\".\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ThresholdOptions.html)",
               "type": {
                 "text": "ThresholdOptions",
                 "references": [
@@ -43650,7 +43648,7 @@
             {
               "kind": "field",
               "name": "visualizationType",
-              "description": "Type of visualization to use when showing the shadows.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType)",
+              "description": "Type of visualization to use when showing the shadows. There are 3 types of visualization:\n* `threshold` - only displays areas that receive shadows for a period longer than a given threshold value\n* `duration` - displays all areas that receive shadows either in a continuous mode or in 1 hour time intervals\n* `discrete` - displays individual shadows cast at a given time interval",
               "type": {
                 "text": "\"discrete\" | \"duration\" | \"threshold\"",
                 "values": [
@@ -43689,6 +43687,7 @@
             },
             {
               "name": "date",
+              "description": "The calendar date used to calculate the shadow cast. This date excludes the time. If a date with a time is set, the time value will be set to midnight (`00:00:00`) of that date in local system time.\nIf no date is set, then it defaults to the current date in local system time.\n\n_See also_\n\n* [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/Date)",
               "type": {
                 "text": "number | string",
                 "values": [
@@ -43704,7 +43703,7 @@
             },
             {
               "name": "end-time-of-day",
-              "description": "Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date)) when the shadow cast computation should stop.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)",
+              "description": "Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should stop.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#endTimeOfDay)",
               "type": {
                 "text": "number",
                 "values": [
@@ -43948,7 +43947,7 @@
             },
             {
               "name": "start-time-of-day",
-              "description": "Time (in milliseconds from midnight of the [date](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#date))\nwhen the shadow cast computation should start.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)",
+              "description": "Time (in milliseconds from midnight of the [date](#date)) when the shadow cast computation should start.\n\n[Read more](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#startTimeOfDay)",
               "type": {
                 "text": "number",
                 "values": [
@@ -43994,7 +43993,7 @@
             },
             {
               "name": "visualization-type",
-              "description": "Type of visualization to use when showing the shadows.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-ShadowCast-ShadowCastViewModel.html#visualizationType)",
+              "description": "Type of visualization to use when showing the shadows. There are 3 types of visualization:\n* `threshold` - only displays areas that receive shadows for a period longer than a given threshold value\n* `duration` - displays all areas that receive shadows either in a continuous mode or in 1 hour time intervals\n* `discrete` - displays individual shadows cast at a given time interval",
               "type": {
                 "text": "\"discrete\" | \"duration\" | \"threshold\"",
                 "values": [
@@ -44247,7 +44246,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSketch = document.createElement(\"arcgis-sketch\");\ndocument.body.append(arcgisSketch);\narcgisSketch.componentOnReady().then(() => {\n  console.log(\"arcgis-sketch is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSketch = document.querySelector(\"arcgis-sketch\");\ndocument.body.append(arcgisSketch);\nawait arcgisSketch.componentOnReady();\nconsole.log(\"arcgis-sketch is ready to go!\");\n```"
                 }
               ]
             },
@@ -44748,7 +44747,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -45182,7 +45181,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The Sketch widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"active\" | \"disabled\" | \"ready\"",
                 "values": [
@@ -45748,7 +45747,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -45889,7 +45888,7 @@
             },
             {
               "name": "state",
-              "description": "The Sketch widget's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"active\" | \"disabled\" | \"ready\"",
                 "values": [
@@ -46042,7 +46041,7 @@
           "customElement": true,
           "name": "ArcgisSlice",
           "tagName": "arcgis-slice",
-          "description": "The Slice component is a 3D analysis tool that can be used to reveal occluded content in a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). It applies\n[slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\nto any layer type, making it possible to see inside buildings or to explore geological surfaces.\n\n[![slice](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice.gif)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nThe slicing [shape](#shape)\nis always a [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).\nBy default, the plane is either horizontal or vertical. To allow a tilt angle for the plane, set\n[tiltEnabled](#tiltEnabled)\nto `true`. The slice hides any content in front of the surface. The handles on the sides of the plane can be used to adjust\nthe size, heading, tilt, and position of the slice plane.\nThe [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)\ncan be set or retrieved using the [shape](#shape) property.\n\nOnce the slice plane is applied, layers can be excluded from the slicing. For example, by excluding the sublayers which include\ncolumns and floor slabs, the inner structure of a building can investigated.\n\n[![slice-exclude](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice-exclude.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nWhen interactively creating a new slice, the Shift key can be held to force the slice to be applied vertically.\n\n**Known limitations**\n\nSlice is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\n- [Sample - BuildingSceneLayer with Slice component](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
+          "description": "The Slice component is a 3D analysis tool that can be used to reveal occluded content in a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/). It applies\n[slice analysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\nto any layer type, making it possible to see inside buildings or to explore geological surfaces.\n\n[![slice](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice.gif)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nThe slicing [shape](#shape)\nis always a [plane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html).\nBy default, the plane is either horizontal or vertical. To allow a tilt angle for the plane, set\n[tiltEnabled](#tiltEnabled)\nto `true`. The slice hides any content in front of the surface. The handles on the sides of the plane can be used to adjust\nthe size, heading, tilt, and position of the slice plane.\nThe [SlicePlane](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SlicePlane.html)\ncan be set or retrieved using the [shape](#shape) property.\n\nOnce the slice plane is applied, layers can be excluded from the slicing. For example, by excluding the sublayers which include\ncolumns and floor slabs, the inner structure of a building can investigated.\n\n[![slice-exclude](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/slice-exclude.png)](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/index.html)\n\nHolding the `Shift` key while creating a new slice applies it vertically.\n\n**Known limitation**\n\nSlice is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\n- [Sample - BuildingSceneLayer with Slice component](https://developers.arcgis.com/javascript/latest/sample-code/building-scene-layer-slice/)\n- [Sample - Analysis objects](https://developers.arcgis.com/javascript/latest/sample-code/analysis-objects/)",
           "demos": [
             {
               "description": "Docs",
@@ -46064,7 +46063,7 @@
             {
               "kind": "field",
               "name": "analysis",
-              "description": "The [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\ncreated or modified by the component.\n\nIf no programmatically created analysis is provided, the component automatically creates an empty analysis on its own and adds it to the view.\nIn this case, the analysis will also be automatically removed from the view when the component is destroyed.\n\n\n```js\n// Create the analysis.\nconst sliceAnalysis = new SliceAnalysis({\n   shape: new SlicePlane({\n     position: new Point({\n       spatialReference: { latestWkid: 3857, wkid: 102100 },\n       x: -13624925.727820931,\n       y: 4550341.695170021,\n       z: 56\n     }),\n     tilt: 270,\n     width: 310,\n     height: 190,\n     heading: 45\n   })\n});\n// Get the Scene and measurement component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst slice = document.querySelector(\"arcgis-slice\");\nawait slice.componentOnReady();\n// Add the analysis to the view component.\nviewElement.analyses.add(sliceAnalysis);\n// Connect the analysis to the slice component:\nslice.analysis = sliceAnalysis;\n```",
+              "description": "The [SliceAnalysis](https://developers.arcgis.com/javascript/latest/api-reference/esri-analysis-SliceAnalysis.html)\ncreated or modified by the component.\n\nWhen connecting the Slice component to the [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/)\ncomponent, it automatically creates an empty analysis and adds it to the Scene's\n[analyses](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#analyses) collection.\nWhenever the component is destroyed, the analysis is automatically removed from the collection.\n\nAlternatively, a programmatically created analysis can be provided to the component.\nThen, the application itself needs to add it to and later remove it from the Scene's analyses collection.\n\n```js\n// Create the analysis.\nconst sliceAnalysis = new SliceAnalysis({\n   shape: new SlicePlane({\n     position: new Point({\n       spatialReference: { latestWkid: 3857, wkid: 102100 },\n       x: -13624925.727820931,\n       y: 4550341.695170021,\n       z: 56\n     }),\n     tilt: 270,\n     width: 310,\n     height: 190,\n     heading: 45\n   })\n});\n// Get the Scene and Slice component and wait until they are ready.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\nconst slice = document.querySelector(\"arcgis-slice\");\nawait slice.componentOnReady();\n// Add the analysis to the Scene component.\nviewElement.analyses.add(sliceAnalysis);\n// Connect the analysis to the slice component:\nslice.analysis = sliceAnalysis;\n```",
               "type": {
                 "text": "SliceAnalysis",
                 "references": [
@@ -46142,7 +46141,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSlice = document.createElement(\"arcgis-slice\");\ndocument.body.append(arcgisSlice);\narcgisSlice.componentOnReady().then(() => {\n  console.log(\"arcgis-slice is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSlice = document.querySelector(\"arcgis-slice\");\ndocument.body.append(arcgisSlice);\nawait arcgisSlice.componentOnReady();\nconsole.log(\"arcgis-slice is ready to go!\");\n```"
                 }
               ]
             },
@@ -46781,7 +46780,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSlider = document.createElement(\"arcgis-slider\");\ndocument.body.append(arcgisSlider);\narcgisSlider.componentOnReady().then(() => {\n  console.log(\"arcgis-slider is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSlider = document.querySelector(\"arcgis-slider\");\ndocument.body.append(arcgisSlider);\nawait arcgisSlider.componentOnReady();\nconsole.log(\"arcgis-slider is ready to go!\");\n```"
                 }
               ]
             },
@@ -46880,7 +46879,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -47246,7 +47245,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"dragging\" | \"editing\" | \"ready\"",
                 "values": [
@@ -47514,7 +47513,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -47709,7 +47708,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the widget.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Slider.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"dragging\" | \"editing\" | \"ready\"",
                 "values": [
@@ -48056,7 +48055,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisSwipe = document.createElement(\"arcgis-swipe\");\ndocument.body.append(arcgisSwipe);\narcgisSwipe.componentOnReady().then(() => {\n  console.log(\"arcgis-swipe is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisSwipe = document.querySelector(\"arcgis-swipe\");\ndocument.body.append(arcgisSwipe);\nawait arcgisSwipe.componentOnReady();\nconsole.log(\"arcgis-swipe is ready to go!\");\n```"
                 }
               ]
             },
@@ -48323,7 +48322,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The current state of the Swipe.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -48550,7 +48549,7 @@
             },
             {
               "name": "state",
-              "description": "The current state of the Swipe.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Swipe-SwipeViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"ready\"",
                 "values": [
@@ -48718,7 +48717,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisTableList = document.createElement(\"arcgis-table-list\");\ndocument.body.append(arcgisTableList);\narcgisTableList.componentOnReady().then(() => {\n  console.log(\"arcgis-table-list is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisTableList = document.querySelector(\"arcgis-table-list\");\ndocument.body.append(arcgisTableList);\nawait arcgisTableList.componentOnReady();\nconsole.log(\"arcgis-table-list is ready to go!\");\n```"
                 }
               ]
             },
@@ -48828,7 +48827,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -49138,7 +49137,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-TableListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -49303,7 +49302,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -49522,7 +49521,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TableList-TableListViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"loading\" | \"ready\"",
                 "values": [
@@ -49726,7 +49725,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisTimeSlider = document.createElement(\"arcgis-time-slider\");\ndocument.body.append(arcgisTimeSlider);\narcgisTimeSlider.componentOnReady().then(() => {\n  console.log(\"arcgis-time-slider is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisTimeSlider = document.querySelector(\"arcgis-time-slider\");\ndocument.body.append(arcgisTimeSlider);\nawait arcgisTimeSlider.componentOnReady();\nconsole.log(\"arcgis-time-slider is ready to go!\");\n```"
                 }
               ]
             },
@@ -49815,7 +49814,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -50091,7 +50090,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider-TimeSliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"playing\" | \"ready\"",
                 "values": [
@@ -50325,7 +50324,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -50489,7 +50488,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-TimeSlider-TimeSliderViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"playing\" | \"ready\"",
                 "values": [
@@ -50638,7 +50637,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisTimeZoneLabel = document.createElement(\"arcgis-time-zone-label\");\ndocument.body.append(arcgisTimeZoneLabel);\narcgisTimeZoneLabel.componentOnReady().then(() => {\n  console.log(\"arcgis-time-zone-label is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisTimeZoneLabel = document.querySelector(\"arcgis-time-zone-label\");\ndocument.body.append(arcgisTimeZoneLabel);\nawait arcgisTimeZoneLabel.componentOnReady();\nconsole.log(\"arcgis-time-zone-label is ready to go!\");\n```"
                 }
               ]
             },
@@ -51082,7 +51081,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisTrack = document.createElement(\"arcgis-track\");\ndocument.body.append(arcgisTrack);\narcgisTrack.componentOnReady().then(() => {\n  console.log(\"arcgis-track is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisTrack = document.querySelector(\"arcgis-track\");\ndocument.body.append(arcgisTrack);\nawait arcgisTrack.componentOnReady();\nconsole.log(\"arcgis-track is ready to go!\");\n```"
                 }
               ]
             },
@@ -51748,7 +51747,7 @@
           "customElement": true,
           "name": "ArcgisUtilityNetworkAssociations",
           "tagName": "arcgis-utility-network-associations",
-          "description": "The Utility Network Associations component offers an intuitive user interface, reducing the complexity of working with utility network associations.\n\n> The Utility Network Associations component does not support proxied feature services or feature services that utilize stored credentials.\n\nNote: Sign in to access the data in this sample, U/P: `viewer01`/`I68VGU^nMurF`",
+          "description": "The Utility Network Associations component offers an intuitive user interface, reducing the complexity of working with utility network associations.\n\n> The Utility Network Associations component does not support proxied feature services or feature services that utilize stored credentials.",
           "demos": [
             {
               "description": "Docs",
@@ -51820,7 +51819,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisUtilityNetworkAssociations = document.createElement(\"arcgis-utility-network-associations\");\ndocument.body.append(arcgisUtilityNetworkAssociations);\narcgisUtilityNetworkAssociations.componentOnReady().then(() => {\n  console.log(\"arcgis-utility-network-associations is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisUtilityNetworkAssociations = document.querySelector(\"arcgis-utility-network-associations\");\ndocument.body.append(arcgisUtilityNetworkAssociations);\nawait arcgisUtilityNetworkAssociations.componentOnReady();\nconsole.log(\"arcgis-utility-network-associations is ready to go!\");\n```"
                 }
               ]
             },
@@ -51950,7 +51949,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -52594,7 +52593,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -53133,7 +53132,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisUtilityNetworkTrace = document.createElement(\"arcgis-utility-network-trace\");\ndocument.body.append(arcgisUtilityNetworkTrace);\narcgisUtilityNetworkTrace.componentOnReady().then(() => {\n  console.log(\"arcgis-utility-network-trace is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisUtilityNetworkTrace = document.querySelector(\"arcgis-utility-network-trace\");\ndocument.body.append(arcgisUtilityNetworkTrace);\nawait arcgisUtilityNetworkTrace.componentOnReady();\nconsole.log(\"arcgis-utility-network-trace is ready to go!\");\n```"
                 }
               ]
             },
@@ -53267,13 +53266,13 @@
                 ]
               },
               "default": "\"sde.DEFAULT\"",
-              "deprecated": "since version 4.31, gdbVersion will be removed and the gdbVersion of the {@link module :esri/networks/UtilityNetwork} will be consumed directly.",
+              "deprecated": "`gdbVersion` is deprecated since version 4.31.",
               "attribute": "gdb-version"
             },
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -53515,7 +53514,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace-UtilityNetworkTraceViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"loading\" | \"ready\"",
                 "values": [
@@ -53592,11 +53591,11 @@
               },
               "default": "\"sde.DEFAULT\"",
               "fieldName": "gdbVersion",
-              "deprecated": "since version 4.31, gdbVersion will be removed and the gdbVersion of the {@link module :esri/networks/UtilityNetwork} will be consumed directly."
+              "deprecated": "`gdbVersion` is deprecated since version 4.31."
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -53724,7 +53723,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTrace-UtilityNetworkTraceViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"loading\" | \"ready\"",
                 "values": [
@@ -53911,7 +53910,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisUtilityNetworkValidateTopology = document.createElement(\"arcgis-utility-network-validate-topology\");\ndocument.body.append(arcgisUtilityNetworkValidateTopology);\narcgisUtilityNetworkValidateTopology.componentOnReady().then(() => {\n  console.log(\"arcgis-utility-network-validate-topology is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisUtilityNetworkValidateTopology = document.querySelector(\"arcgis-utility-network-validate-topology\");\ndocument.body.append(arcgisUtilityNetworkValidateTopology);\nawait arcgisUtilityNetworkValidateTopology.componentOnReady();\nconsole.log(\"arcgis-utility-network-validate-topology is ready to go!\");\n```"
                 }
               ]
             },
@@ -53959,7 +53958,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -54093,7 +54092,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkValidateTopology-UtilityNetworkValidateTopologyViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"executing\" | \"failed\" | \"loading\" | \"ready\" | \"success\"",
                 "values": [
@@ -54184,7 +54183,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon displayed in the widget's button.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -54270,7 +54269,7 @@
             },
             {
               "name": "state",
-              "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkValidateTopology-UtilityNetworkValidateTopologyViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"executing\" | \"failed\" | \"loading\" | \"ready\" | \"success\"",
                 "values": [
@@ -54523,7 +54522,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisValuePicker = document.createElement(\"arcgis-value-picker\");\ndocument.body.append(arcgisValuePicker);\narcgisValuePicker.componentOnReady().then(() => {\n  console.log(\"arcgis-value-picker is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisValuePicker = document.querySelector(\"arcgis-value-picker\");\ndocument.body.append(arcgisValuePicker);\nawait arcgisValuePicker.componentOnReady();\nconsole.log(\"arcgis-value-picker is ready to go!\");\n```"
                 }
               ]
             },
@@ -54593,7 +54592,7 @@
             {
               "kind": "field",
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -55010,7 +55009,7 @@
             },
             {
               "name": "icon",
-              "description": "Icon which represents the widget.",
+              "description": "Icon which represents the component.\nTypically used when the component is controlled by another component (e.g. by the Expand component).",
               "type": {
                 "text": "string",
                 "values": [
@@ -55345,7 +55344,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisVersionManagement = document.createElement(\"arcgis-version-management\");\ndocument.body.append(arcgisVersionManagement);\narcgisVersionManagement.componentOnReady().then(() => {\n  console.log(\"arcgis-version-management is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisVersionManagement = document.querySelector(\"arcgis-version-management\");\ndocument.body.append(arcgisVersionManagement);\nawait arcgisVersionManagement.componentOnReady();\nconsole.log(\"arcgis-version-management is ready to go!\");\n```"
                 }
               ]
             },
@@ -55552,7 +55551,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The viewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-VersionManagement-VersionManagementViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"executing\" | \"failed\" | \"loading\" | \"ready\" | \"success\"",
                 "values": [
@@ -55766,7 +55765,7 @@
             },
             {
               "name": "state",
-              "description": "The viewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-VersionManagement-VersionManagementViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"disabled\" | \"executing\" | \"failed\" | \"loading\" | \"ready\" | \"success\"",
                 "values": [
@@ -55910,7 +55909,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisVideo = document.createElement(\"arcgis-video\");\ndocument.body.append(arcgisVideo);\narcgisVideo.componentOnReady().then(() => {\n  console.log(\"arcgis-video is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisVideo = document.querySelector(\"arcgis-video\");\ndocument.body.append(arcgisVideo);\nawait arcgisVideo.componentOnReady();\nconsole.log(\"arcgis-video is ready to go!\");\n```"
                 }
               ]
             },
@@ -56101,7 +56100,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisVideoPlayer = document.createElement(\"arcgis-video-player\");\ndocument.body.append(arcgisVideoPlayer);\narcgisVideoPlayer.componentOnReady().then(() => {\n  console.log(\"arcgis-video-player is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisVideoPlayer = document.querySelector(\"arcgis-video-player\");\ndocument.body.append(arcgisVideoPlayer);\nawait arcgisVideoPlayer.componentOnReady();\nconsole.log(\"arcgis-video-player is ready to go!\");\n```"
                 }
               ]
             },
@@ -56357,7 +56356,7 @@
             {
               "kind": "field",
               "name": "state",
-              "description": "The state of the video layer.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-VideoPlayer-VideoPlayerViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"can-play\" | \"data-loaded\" | \"error\" | \"not-ready\" | \"paused\" | \"playing\" | \"ready\" | \"waiting\"",
                 "values": [
@@ -56545,7 +56544,7 @@
             },
             {
               "name": "state",
-              "description": "The state of the video layer.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-VideoPlayer-VideoPlayerViewModel.html#state)",
+              "description": "The current state of the component.",
               "type": {
                 "text": "\"can-play\" | \"data-loaded\" | \"error\" | \"not-ready\" | \"paused\" | \"playing\" | \"ready\" | \"waiting\"",
                 "values": [
@@ -56630,7 +56629,7 @@
           "customElement": true,
           "name": "ArcgisWeather",
           "tagName": "arcgis-weather",
-          "description": "The Weather component provides an interface for easily selecting and configuring the weather effects in a [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n**Known limitations**\n\nWeather is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.",
+          "description": "The Weather component allows easy selection and configuration of weather effects in a\n[Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\nThe available weather types are:\n[sunny](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunnyWeather.html),\n[cloudy](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-CloudyWeather.html),\n[rainy](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-RainyWeather.html),\n[snowy](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SnowyWeather.html), and\n[foggy](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-FoggyWeather.html).\n\nTo set the weather programmatically, apply the desired weather type to the\n[environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) property of the Scene component.\n\n```js\n// Access the Scene component.\nconst viewElement = document.querySelector(\"arcgis-scene\");\nawait viewElement.viewOnReady();\n// Specify the weather settings.\nviewElement.environment.weather = {\n   type: \"rainy\", // autocasts as new RainyWeather({ cloudCover: 0.7, precipitation: 0.3 })\n   cloudCover: 0.7,\n   precipitation: 0.3\n};\n```\n\nTo determine if the weather visualization is available, check the boolean value of `viewElement.environment.weatherAvailable`. The weather is only available:\n   * in `global` [viewing mode](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#viewingMode),\n   * when `atmosphereEnabled` property on [environment](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#environment) is `true`,\n   * at lower altitudes, near the ground.\n\n**Known limitations**\n\nWeather is only supported in a 3D [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.\n\n**See also**\n\n- [SunnyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SunnyWeather.html)\n- [CloudyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-CloudyWeather.html)\n- [RainyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-RainyWeather.html)\n- [SnowyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-SnowyWeather.html)\n- [FoggyWeather](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-3d-environment-FoggyWeather.html)\n- [Sample - Weather component](https://developers.arcgis.com/javascript/latest/sample-code/weather/)",
           "demos": [
             {
               "description": "Docs",
@@ -56691,7 +56690,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisWeather = document.createElement(\"arcgis-weather\");\ndocument.body.append(arcgisWeather);\narcgisWeather.componentOnReady().then(() => {\n  console.log(\"arcgis-weather is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisWeather = document.querySelector(\"arcgis-weather\");\ndocument.body.append(arcgisWeather);\nawait arcgisWeather.componentOnReady();\nconsole.log(\"arcgis-weather is ready to go!\");\n```"
                 }
               ]
             },
@@ -57222,7 +57221,7 @@
               "docsTags": [
                 {
                   "name": "example",
-                  "text": "```js\nconst arcgisZoom = document.createElement(\"arcgis-zoom\");\ndocument.body.append(arcgisZoom);\narcgisZoom.componentOnReady().then(() => {\n  console.log(\"arcgis-zoom is ready to go!\");\n});\n```"
+                  "text": "```js\nconst arcgisZoom = document.querySelector(\"arcgis-zoom\");\ndocument.body.append(arcgisZoom);\nawait arcgisZoom.componentOnReady();\nconsole.log(\"arcgis-zoom is ready to go!\");\n```"
                 }
               ]
             },