@arcgis/map-components 4.33.0-next.165 → 4.33.0-next.167

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-06-18T13:14:29",
+  "timestamp": "2025-06-20T04:36:02",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "4.33.0-next.165",
+    "version": "4.33.0-next.167",
     "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": [
@@ -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```"
                 }
               ]
             },
@@ -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```"
                 }
               ]
             },
@@ -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": [
@@ -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```"
                 }
               ]
             },
@@ -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": [
@@ -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```"
                 }
               ]
             },
@@ -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```"
                 }
               ]
             },
@@ -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"
@@ -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```"
                 }
               ]
             },
@@ -14953,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```"
                 }
               ]
             },
@@ -15814,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```"
                 }
               ]
             },
@@ -16011,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": [
@@ -16315,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": [
@@ -16515,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": [
@@ -16601,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": [
@@ -16738,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```"
                 }
               ]
             },
@@ -16858,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": [
@@ -17070,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": [
@@ -17176,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": [
@@ -17262,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": [
@@ -17788,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```"
                 }
               ]
             },
@@ -18568,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": [
@@ -19664,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": [
@@ -20333,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": [
@@ -20664,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": [
@@ -20924,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```"
                 }
               ]
             },
@@ -21036,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": [
@@ -21254,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": [
@@ -21364,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": [
@@ -21468,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": [
@@ -21734,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```"
                 }
               ]
             },
@@ -22111,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": [
@@ -22493,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": [
@@ -22785,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": [
@@ -22930,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": [
@@ -23089,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```"
                 }
               ]
             },
@@ -23147,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": [
@@ -23406,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": [
@@ -23607,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```"
                 }
               ]
             },
@@ -23978,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```"
                 }
               ]
             },
@@ -25281,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```"
                 }
               ]
             },
@@ -25408,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": [
@@ -25698,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": [
@@ -25779,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": [
@@ -25988,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": [
@@ -26125,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```"
                 }
               ]
             },
@@ -26325,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": [
@@ -26478,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": [
@@ -26695,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```"
                 }
               ]
             },
@@ -26834,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": [
@@ -27219,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": [
@@ -27493,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": [
@@ -27712,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": [
@@ -27922,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```"
                 }
               ]
             },
@@ -27980,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": [
@@ -28195,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": [
@@ -28275,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": [
@@ -28403,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": [
@@ -28559,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```"
                 }
               ]
             },
@@ -29330,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```"
                 }
               ]
             },
@@ -30954,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```"
                 }
               ]
             },
@@ -31182,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": [
@@ -31424,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": [
@@ -31588,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```"
                 }
               ]
             },
@@ -32562,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```"
                 }
               ]
             },
@@ -32834,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",
@@ -34596,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```"
                 }
               ]
             },
@@ -34624,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": [
@@ -34841,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": [
@@ -34984,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": [
@@ -35132,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": [
@@ -35242,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```"
                 }
               ]
             },
@@ -35713,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```"
                 }
               ]
             },
@@ -35801,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": [
@@ -36163,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": [
@@ -36428,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```"
                 }
               ]
             },
@@ -36778,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```"
                 }
               ]
             },
@@ -37671,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```"
                 }
               ]
             },
@@ -38098,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```"
                 }
               ]
             },
@@ -38184,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": [
@@ -38451,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": [
@@ -38542,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": [
@@ -38703,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": [
@@ -39380,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```"
                 }
               ]
             },
@@ -41638,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```"
                 }
               ]
             },
@@ -42297,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": [
@@ -42722,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": [
@@ -42953,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```"
                 }
               ]
             },
@@ -43111,7 +43103,7 @@
               "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```"
                 }
               ]
             },
@@ -44254,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```"
                 }
               ]
             },
@@ -44755,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": [
@@ -45189,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": [
@@ -45755,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": [
@@ -45896,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": [
@@ -46149,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```"
                 }
               ]
             },
@@ -46788,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```"
                 }
               ]
             },
@@ -46887,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": [
@@ -47253,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": [
@@ -47521,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": [
@@ -47716,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": [
@@ -48063,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```"
                 }
               ]
             },
@@ -48330,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": [
@@ -48557,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": [
@@ -48725,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```"
                 }
               ]
             },
@@ -48835,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": [
@@ -49145,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": [
@@ -49310,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": [
@@ -49529,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": [
@@ -49733,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```"
                 }
               ]
             },
@@ -49822,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": [
@@ -50098,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": [
@@ -50332,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": [
@@ -50496,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": [
@@ -50645,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```"
                 }
               ]
             },
@@ -51089,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```"
                 }
               ]
             },
@@ -51827,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```"
                 }
               ]
             },
@@ -51957,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": [
@@ -52601,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": [
@@ -53140,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```"
                 }
               ]
             },
@@ -53274,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": [
@@ -53522,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": [
@@ -53599,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": [
@@ -53731,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": [
@@ -53918,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```"
                 }
               ]
             },
@@ -53966,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": [
@@ -54100,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": [
@@ -54191,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": [
@@ -54277,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": [
@@ -54530,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```"
                 }
               ]
             },
@@ -54600,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": [
@@ -55017,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": [
@@ -55352,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```"
                 }
               ]
             },
@@ -55559,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": [
@@ -55773,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": [
@@ -55917,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```"
                 }
               ]
             },
@@ -56108,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```"
                 }
               ]
             },
@@ -56364,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": [
@@ -56552,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": [
@@ -56698,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```"
                 }
               ]
             },
@@ -57229,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```"
                 }
               ]
             },