@arcgis/map-components 5.0.0-next.21 → 5.0.0-next.22

package/dist/docs/docs.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-10-14T04:46:24",
+  "timestamp": "2025-10-15T04:45:55",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.21",
+    "version": "5.0.0-next.22",
     "typescriptVersion": "5.8.3"
   },
   "components": [
@@ -6834,7 +6834,7 @@
             },
             {
               "name": "example",
-              "text": "Conversions can be set with an array of strings where each string is a format's name\n```js\ncoordinateConversionComponent.conversions = [\"mgrs\"];\n```"
+              "text": "Conversions can be set with an array of strings where each string is a format's name.\n```js\ncoordinateConversionComponent.conversions = [\"mgrs\"];\n```"
             }
           ],
           "values": [],
@@ -6865,7 +6865,7 @@
             },
             {
               "name": "example",
-              "text": "Set the current location\n```js\ncoordinateConversionComponent.currentLocation = { x: 77.0369, y: 38.9072, spatialReference: { wkid: 4326 } };\n```"
+              "text": "Set the current location.\n```js\ncoordinateConversionComponent.currentLocation = { x: 77.0369, y: 38.9072, spatialReference: { wkid: 4326 } };\n```"
             }
           ],
           "values": [],
@@ -6891,7 +6891,7 @@
             },
             {
               "name": "example",
-              "text": "Expand the component\n```js\ncoordinateConversionComponent.expanded = true;\n```"
+              "text": "Expand the component.\n```js\ncoordinateConversionComponent.expanded = true;\n```"
             }
           ],
           "default": "false",
@@ -6932,11 +6932,11 @@
             },
             {
               "name": "example",
-              "text": "Only show the \"xy\" format\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\nconst toRemove = coordinateConversionComponent.formats.filter(format => format.name !== \"xy\");\ncoordinateConversionComponent.formats.removeMany(toRemove);\n```"
+              "text": "Only show the \"xy\" format.\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\nconst toRemove = coordinateConversionComponent.formats.filter(format => format.name !== \"xy\");\ncoordinateConversionComponent.formats.removeMany(toRemove);\n```"
             },
             {
               "name": "example",
-              "text": "Show every format except \"xy\"\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\nconst toRemove = coordinateConversionComponent.formats.filter(format => format.name === \"xy\");\ncoordinateConversionComponent.formats.removeMany(toRemove);\n```"
+              "text": "Show every format except \"xy\".\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\nconst toRemove = coordinateConversionComponent.formats.filter(format => format.name === \"xy\");\ncoordinateConversionComponent.formats.removeMany(toRemove);\n```"
             }
           ],
           "values": [],
@@ -7031,7 +7031,7 @@
             },
             {
               "name": "example",
-              "text": "Hide the capture button\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-capture-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
+              "text": "Hide the capture button.\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-capture-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
             }
           ],
           "default": "false",
@@ -7062,7 +7062,7 @@
             },
             {
               "name": "example",
-              "text": "Hide the capture button\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-expand-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
+              "text": "Hide the expand button.\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-expand-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
             }
           ],
           "default": "false",
@@ -7085,7 +7085,7 @@
           "mutable": true,
           "attr": "hide-input-button",
           "reflectToAttr": true,
-          "docs": "Determines whether the input coordiante button will be shown in the component. If `true`, the input button will be hidden.",
+          "docs": "Determines whether the input coordinate button will be shown in the component. If `true`, the input button will be hidden.",
           "docsTags": [
             {
               "name": "type",
@@ -7093,7 +7093,7 @@
             },
             {
               "name": "example",
-              "text": "Hide the input button\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-input-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
+              "text": "Hide the input button.\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-input-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
             }
           ],
           "default": "false",
@@ -7124,7 +7124,7 @@
             },
             {
               "name": "example",
-              "text": "Hide the capture button\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-settings-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
+              "text": "Hide the settings button.\n```html\n<arcgis-map item-id=\"45b3b2fb35e94ab09381d0caa0da5946\">\n  <arcgis-coordinate-conversion hide-settings-button slot=\"bottom-left\"></arcgis-coordinate-conversion>\n</arcgis-map>\n```"
             }
           ],
           "default": "false",
@@ -7219,7 +7219,7 @@
             },
             {
               "name": "example",
-              "text": "Set the location symbol to be an 'x'\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\ncoordinateConversionComponent.locationSymbol = { type: \"simple-marker\", style: \"x\" };\n```"
+              "text": "Set the location symbol to be an 'x'.\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\ncoordinateConversionComponent.locationSymbol = { type: \"simple-marker\", style: \"x\" };\n```"
             }
           ],
           "values": [
@@ -7258,7 +7258,7 @@
             },
             {
               "name": "example",
-              "text": "Programmatically set the component to capture mode\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\ncoordinateConversionComponent.mode = \"capture\";\n```"
+              "text": "Programmatically set the component to capture mode.\n```js\nconst coordinateConversionComponent = document.getElementsByTagName(\"arcgis-coordinate-conversion\")[0];\ncoordinateConversionComponent.mode = \"capture\";\n```"
             }
           ],
           "default": "\"live\"",
@@ -26544,7 +26544,7 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The Legend component displays the symbols and labels used to represent layers in a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nOnly layers and sublayers visible in the view are shown, unless [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) is set to `true`.\n\nThe legend automatically updates when:\n - the visibility of a layer or sublayer changes\n - a layer is added or removed from the map\n - a layer's `renderer`, `opacity`, or `title` is changed\n - the `legendEnabled` property is changed (set to `true` or `false` on the layer)\n\n## Known Limitations\n\n* Currently, the legend component does not support the following layer types:\n[ElevationLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html),\n[IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html),\n[KMLLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KMLLayer.html),\n[MapNotesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapNotesLayer.html),\n[OpenStreetMapLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OpenStreetMapLayer.html),\n[VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html),\n[VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html), and\n[WebTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WebTileLayer.html).\n* [Symbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3D.html) with more than one\n[symbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3DLayer.html) are not supported.\n* [DictionaryRenderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-DictionaryRenderer.html) is not supported.\n* [TrackInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TrackInfo.html) is not supported.\n* CIM Symbol [primitiveOverride](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html#PrimitiveOverride) is not supported.\n* RasterStretchRenderer [dynamicRangeAdjustment](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-RasterStretchRenderer.html#dynamicRangeAdjustment) is not supported.\n\n## Various examples of legends based on renderer type.\n\n### Unique values\n\n[![Unique values](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-unique-values.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-location-types/)\n\n### Continuous color\n\n[![Continuous color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-color-vv.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-vv-color/)\n\n### Classed color\n\n[![Classed color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-class-breaks.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-classbreaks/)\n\n### Continuous size\n\n[![Continuous size](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-size/)\n\n### Size - above and below\n\n[![Size - above and below](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size-themes.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-size-themes/)\n\n### Dot density\n\n[![Dot density](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-dot-density.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-dot-density/)\n\n### Predominance\n\n[![Predominance](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-predominance.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-arcade/)\n\n### Relationship\n\n[![Relationship](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-relationship.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-relationship/)",
+      "docs": "The Legend component displays the symbols and labels used to represent layers in a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\nOnly layers and sublayers visible in the view are shown, unless [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) is set to `true`.\n\nThe legend automatically updates when:\n - the visibility of a layer or sublayer changes\n - a layer is added or removed from the map\n - a layer's `renderer`, `opacity`, or `title` is changed\n - the `legendEnabled` property is changed (set to `true` or `false` on the layer)\n\n## Known Limitations\n\n* Currently, the legend component does not support the following layer types:\n[ElevationLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ElevationLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html),\n[IntegratedMeshLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-IntegratedMeshLayer.html),\n[KMLLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KMLLayer.html),\n[MapNotesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapNotesLayer.html),\n[OpenStreetMapLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OpenStreetMapLayer.html),\n[VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html),\n[VideoLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VideoLayer.html), and\n[WebTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WebTileLayer.html).\n* [Symbol3D](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3D.html) with more than one\n[symbol](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-Symbol3DLayer.html) are not supported.\n* [DictionaryRenderer](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-DictionaryRenderer.html) is not supported.\n* [TrackInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TrackInfo.html) is not supported.\n* CIM Symbol [primitiveOverride](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-CIMSymbol.html#PrimitiveOverride) is not supported.\n* RasterStretchRenderer [dynamicRangeAdjustment](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-RasterStretchRenderer.html#dynamicRangeAdjustment) is not supported.\n\n## Various examples of legends based on renderer type.\n\n### Unique values\n\n[![Unique values](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-unique-values.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-location-types/)\n\n### Continuous color\n\n[![Continuous color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-color-vv.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-vv-color/)\n\n### Classed color\n\n[![Classed color](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-class-breaks.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-classbreaks/)\n\n### Continuous size\n\n[![Continuous size](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-size/)\n\n### Size - above and below\n\n[![Size - above and below](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-size-themes.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-size-themes/)\n\n### Dot density\n\n[![Dot density](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-dot-density.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-dot-density/)\n\n### Predominance\n\n[![Predominance](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-predominance.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-arcade/)\n\n### Relationship\n\n[![Relationship](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-relationship.png)](https://developers.arcgis.com/javascript/latest/sample-code/visualization-sm-relationship/)\n\n\n### Legend Field Formatting Summary\n\nThe following table summarizes how legend field values are formatted for different renderer and visual variable types, and the order in which formatting options are applied.\n\n| Renderer / Visual Variable Type              | Renderer Data Source                   | Formatting Priority (in order)                                                                                                             |\n|----------------------------------------------|----------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| Visual variable stops (color, opacity, size) | Number field                           | 1. `stop.label`<br>2. FieldConfiguration<br>3. Default precision formatting with grouping                                                  |\n| Visual variable stops (color, opacity, size) | Number field / normalization field     | 1. `stop.label`<br>2. FieldConfiguration (applies to main field, not normalization field)<br>3. Default precision formatting with grouping |\n| Visual variable                              | valueExpression                        | 1. `stop.label`<br>2. Default precision formatting with grouping                                                                           |\n| Unique-value renderer labels                 | Field value                            | 1. UniqueValueRenderer class label<br>2. Domain name<br>3. FieldConfiguration or PopupTemplate<br>4. Raw field value (if string) or default precision formatting with grouping (for number)|\n| Renderer title                               | FieldConfiguration or PopupTemplate    | 1. FieldConfiguration<br>2. PopupTemplate                                                                                                  |\n\n#### Legend Field Formatting Notes\n- [FieldConfiguration](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FieldConfiguration.html): Defines how fields in a layer are displayed and formatted within widgets and UI components.\n- [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html): Used as a fallback for layers that don’t support FieldConfigurations.\n- VisualVariable stop labels: If any stop has a label, it is used directly; otherwise, labels are generated at runtime. See [ColorStop](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-support-ColorStop.html), [OpacityStop](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-support-OpacityStop.html), and [SizeStop](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-support-SizeStop.html).\n- Normalization Field: Only the main field’s formatting is used, not the normalization field. See [ColorVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-ColorVariable.html#normalizationField), [OpacityVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-OpacityVariable.html#normalizationField), and [SizeVariable](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-SizeVariable.html#normalizationField).\n- [VisualVariable value expressions](https://developers.arcgis.com/javascript/latest/api-reference/esri-renderers-visualVariables-ColorVariable.html#valueExpression): Since there’s no field, field formatting does not apply; fallback is default formatting.\n- WebMap and Layer persistence: Labels generated at runtime by the legend are not persisted.",
       "docsTags": [
         {
           "name": "see",
@@ -31179,7 +31179,7 @@
       "overview": "",
       "readme": "",
       "usage": {},
-      "docs": "The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the\n[ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\nThe Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and loads a WebMap from either [ArcGIS Online](https://www.arcgis.com/home/index.html) or [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm).\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\"></arcgis-map>\n```\n\nAlternatively, the Map component can be initialized without a WebMap item.\n\n```html\n<arcgis-map basemap=\"satellite\" center=\"-154.88, 19.46\" zoom=\"15\"></arcgis-map>\n```\n\nOther components can be added and connected to the Map component.\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\">\n <arcgis-zoom slot=\"top-left\"></arcgis-zoom>\n <arcgis-legend slot=\"bottom-left\"></arcgis-legend>\n</arcgis-map>\n```\n\nThe Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n const layer = new GraphicsLayer({ title: \"My Layer\" });\n viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)\n- [Get started](https://developers.arcgis.com/javascript/latest/get-started/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
+      "docs": "The ArcGIS Map component is used to add 2D maps to web applications. For 3D maps, use the\n[ArcGIS Scene component](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\n\n#### Initializing the Map component\nThe Map component creates a [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) and\nand can be initialized in one of three ways:\n\n##### 1. Using a WebMap\nLoad a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html) from [ArcGIS Online](https://www.arcgis.com/home/index.html)\nor an [ArcGIS Enterprise portal](https://enterprise.arcgis.com/en/portal/latest/administer/windows/what-is-portal-for-arcgis-.htm) by specifying the [item-id](#itemId) attribute.\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\"></arcgis-map>\n```\n\n##### 2. Setting Map component attributes directly\nDefine the Map component using attributes like [basemap](#basemap), [center](#center), and [zoom](#zoom) directly.\n\n```html\n<arcgis-map basemap=\"satellite\" center=\"-154.88, 19.46\" zoom=\"15\"></arcgis-map>\n```\n\n##### 3. Providing a Map instance\nAlternatively, you can provide your own [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) instance to the component.\nThis allows full control over map configuration, including [basemap](#basemap), operational [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers)\nand [spatial reference](#spatialReference). See the [Select features by rectangle sample](https://developers.arcgis.com/javascript/latest/sample-code/highlight-features-by-geometry/)\nfor an example of this approach in action.\n\n```html\n<arcgis-map></arcgis-map>\n<script type=\"module\">\n const viewElement = document.querySelector(\"arcgis-map\");\n\n // set the basemap of the map to states feature layer\n // add national parks feature layer and a polygon graphics layer\n viewElement.map = new Map({\n   basemap: new Basemap({ baseLayers: [states] }),\n   layers: [nationalParksLayer, polygonGraphicsLayer]\n });\n\n // set the spatial reference of the map to NAD 1983 Albers contiguous USA\n viewElement.spatialReference = { wkid: 102003 };\n</script>\n```\n#### Adding components and customizing the Map\n\nOther components can be added and connected to the Map component.\n\n```html\n<arcgis-map item-id=\"05e015c5f0314db9a487a9b46cb37eca\">\n <arcgis-zoom slot=\"top-left\"></arcgis-zoom>\n <arcgis-legend slot=\"bottom-left\"></arcgis-legend>\n</arcgis-map>\n```\n\nThe Map component can be customized further using any of the [core API functionalities](https://developers.arcgis.com/javascript/latest/api-reference/) of the ArcGIS Maps SDK for JavaScript.\n\n```js\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.addEventListener(\"arcgisViewReadyChange\", () => {\n const layer = new GraphicsLayer({ title: \"My Layer\" });\n viewElement.map.add(layer);\n});\n```\n\nSee also:\n- [SDK sample apps using the Map component](https://developers.arcgis.com/javascript/latest/sample-code/?tagged=arcgis-map)\n- [Get started](https://developers.arcgis.com/javascript/latest/get-started/)\n- [Programming patterns](https://developers.arcgis.com/javascript/latest/programming-patterns/)",
       "docsTags": [
         {
           "name": "since",
@@ -31427,8 +31427,25 @@
           "mutable": true,
           "attr": "center",
           "reflectToAttr": false,
-          "docs": "Represents the view's center point; when setting the center, you may pass a\n[Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance or a string representing\na longitude/latitude pair (`\"-100.4593, 36.9014\"`).\nSetting the center immediately changes the current view.\nFor animating the view, see this component's [goTo()](#goTo) method.",
-          "docsTags": [],
+          "docs": "Represents the view's center point; when setting the center, you may pass a\n[Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) instance, numbers representing\na longitude/latitude pair (`[-100.4593, 36.9014]`), or a string attribute representing a longitude/latitude pair (\"-100.4593, 36.9014\").\nSetting the `center` immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.\n\nThe returned [Point](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html) object is always\nin the spatial reference of the view and may be modified internally.\nTo persist the returned object, create a clone using [clone()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Point.html#clone) method.\n\n**Notes**\n\n* If the spatial reference of `center` set in the constructor does not match the [spatialReference](#spatialReference) of the view, then the\n[projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) will be loaded dynamically.\n* At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) must be\n[loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) when\nsetting the `center` to a spatial reference that doesn't match the view spatial reference. You can check if the projectOperator is\nloaded prior to setting the center by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded)\nmethod. If it is not yet loaded, you can call [load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```html\n<arcgis-map zoom=\"4\" center=\"-98, 39\"></arcgis-map>\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// Sets the initial center point of the map component to lon/lat coordinates\n// lon/lat will be projected to match the spatial reference of the view\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.center = [-98, 39]; // lon, lat\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// Updates the view's center point to a pre-determined Point object\nlet centerPoint = new Point({\n  x: 12804.24,\n  y: -1894032.09,\n  spatialReference: {\n    wkid: view.spatialReference  // wkid 2027\n  }\n});\nconst viewElement = document.querySelector(\"arcgis-map\");\nview.center = centerPoint;\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// the point's spatialReference does not match the view's spatialReference\n// the projectOperator will be used to project the point to match\n// the view's spatialReference\nconst centerPoint = new Point({\n  x: -8746995,\n  y: 4352308,\n  spatialReference: {\n    wkid: 8857\n  }\n});\nif (!projectOperator.isLoaded()) {\n  await projectOperator.load();\n}\nconst viewElement = document.querySelector(\"arcgis-map\");\nviewElement.center = centerPoint;\n```"
+            }
+          ],
           "values": [
             {
               "type": "Array<number>"
@@ -31476,7 +31493,7 @@
           "mutable": true,
           "attr": "display-filter-disabled",
           "reflectToAttr": false,
-          "docs": "Indicates whether a layer's `displayFilter` is honored when rendering layers in the view.\nIf `false`, display filters are ignored and all features are rendered.",
+          "docs": "Indicates whether a layer's `displayFilterInfo` is honored when rendering layers in the view.\nIf `false`, display filters are ignored and all features are rendered.",
           "docsTags": [],
           "default": "false",
           "values": [
@@ -31503,7 +31520,7 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The extent represents the visible portion of a map within the view as an instance of [Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.",
+          "docs": "The extent represents the visible portion of a map within the view as an instance of [Extent](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Extent.html).\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's [goTo()](#goTo) method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.\n\n**Notes**\n\n* If the spatial reference of `extent` set does not match the [spatialReference](#spatialReference) of the view, then the\n[projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html) will be loaded dynamically.\n* At runtime, the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html)\nmust be [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) when\nsetting the `extent` to a spatial reference that doesn't match the view spatial reference. You can check if the projectOperator is\nloaded prior to setting the extent by calling [isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded)\nmethod. If it is not yet loaded, you can call the [load](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.",
           "docsTags": [],
           "values": [],
           "optional": true,
@@ -31690,8 +31707,17 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The highlights property is a collection of [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html) objects that\nallow you to visually emphasize specific features on the map. See [MapView.highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#highlights) for more information.",
-          "docsTags": [],
+          "docs": "Represents a collection of [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)\nobjects which can be used to highlight features throughout an application. Highlighting works by applying highlight options to one or\nmore features. You can configure these options (such as color or opacity) to define how a feature will be visually\nemphasized.\n\nA maximum of six [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)\nobjects are supported in the collection, and they can be added, removed, and reordered freely. Their order in the collection determines priority, with the last\nobject having the highest priority. If you apply more than one highlight to a feature, the one that is last within\nthe collection will be applied. The [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html)\nobject must be part of this collection in order to be applied to features.\n\nTo highlight a feature, use the [highlight()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-FeatureLayerView.html#highlight)\nmethod on the relevant [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) instance. To apply specific\n[HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html), include the\n[name](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html#name) in the `highlight()` method's `options` parameter.\nIf no `name` is provided, the feature will use the `default` highlight options.\n\nThe table below shows the default highlight options in the View's highlights collection if the collection has not\nbeen modified:\n\n| Highlight options name | Description | Default settings |\n| ---------------------- | ----------- | ---------------- |\n| default                | The default highlight options. Used when `layerView.highlight()` is called without specifying any particular highlight options. | ` { name: \"default\", color: \"cyan\", haloOpacity: 1, fillOpacity: 0.25, shadowColor: \"black\", shadowOpacity: 0.4, shadowDifference: 0.2}` |\n| temporary              | The temporary highlight options, pre-configured for common use cases such as hovering over a feature in the view. | `{ name: \"temporary\", color: \"yellow\", haloOpacity: 1, fillOpacity: 0.25, shadowColor: \"black\", shadowOpacity: 0.4, shadowDifference: 0.2 }` |",
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[Sample: Highlight features by geometry](https://developers.arcgis.com/javascript/latest/sample-code/highlight-features-by-geometry/)"
+            },
+            {
+              "name": "see",
+              "text": "[Sample: Highlight point features](https://developers.arcgis.com/javascript/latest/sample-code/highlight-point-features/)"
+            }
+          ],
           "values": [],
           "optional": true,
           "required": false
@@ -32188,8 +32214,31 @@
           },
           "mutable": true,
           "reflectToAttr": false,
-          "docs": "The spatial reference of the view.\nThis indicates the projected or geographic coordinate system used\nto locate geographic features in the map.",
-          "docsTags": [],
+          "docs": "The spatial reference of the view. This indicates the projected or geographic coordinate system used to locate geographic features in the map.\nYou can change the spatialReference of the view after it is initialized by either directly changing\nthis property, or by changing the basemap from the [Basemap Gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/)\nand [Basemap Toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components.\nSet [spatialReferenceLocked](#spatialReferenceLocked) property to `true` to prevent users from changing the view's spatial reference at runtime.\n\nPrior to changing the spatial reference, check if the [projectOperator](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html)\nis loaded by calling [projectOperator.isLoaded()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#isLoaded) method.\nIf it is not yet loaded, call [projectOperator.load()](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-operators-projectOperator.html#load) method.\nIf the `projectOperator` is not loaded, the view's [center](#center) will default to `[0, 0]` in the new spatial reference of the view and a console error will be thrown.\n\n**Notes**\n\n* [LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) not compatible with the view's spatial reference\nare not displayed. In such case, the layer view's [suspended](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html#suspended)\nproperty is `true` and [spatialReferenceSupported](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html#spatialReferenceSupported)\nproperty is `false`.\n* When setting view's spatial reference, the [center](#center), [extent](#extent) or [viewpoint.targetGeometry](#viewpoint) properties are projected to the new spatial\nreference. The [scale](#scale) and [rotation](#rotation) properties are adjusted to keep the content of the map at the same size and orientation on screen.\n* To ensure [TileLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-TileLayer.html) and\n[VectorTileLayers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html)\nare displayed in a [basemap](#basemap) correctly, the spatialReference of the view must be set match their\n[tileInfo's](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-TileInfo.html) spatial reference.\n* Switching spatial reference with an [imageCoordinateSystem](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-SpatialReference.html#imageCoordinateSystem)\nis not supported.",
+          "docsTags": [
+            {
+              "name": "name",
+              "text": "spatialReference"
+            },
+            {
+              "name": "instance"
+            },
+            {
+              "name": "type",
+              "text": "{module:esri/geometry/SpatialReference}"
+            },
+            {
+              "name": "autocast"
+            },
+            {
+              "name": "see",
+              "text": "[spatialReferenceLocked](#spatialReferenceLocked)"
+            },
+            {
+              "name": "example",
+              "text": "```js\nconst viewElement = document.querySelector(\"arcgis-map\");\n// check if the projectOperator is loaded\nif (!projectOperator.isLoaded()) {\n  // load the projectOperator if it is not loaded\n  projectOperator.load().then(() => {\n   // change the spatial reference of the map component to equal earth projection\n    viewElement.spatialReference = new SpatialReference({\n      wkid: 54035 //equal earth projection\n    });\n  });\n} else {\n  // the projectOperator is already loaded.\n  // change the spatial reference of the view to equal earth projection\n  viewElement.spatialReference = new SpatialReference({\n    wkid: 54035 //equal earth projection\n  });\n}\n```"
+            }
+          ],
           "default": "null",
           "values": [],
           "optional": true,
@@ -32862,8 +32911,17 @@
               "docs": ""
             }
           ],
-          "docs": "Returns hit test results from each layer that intersects the specified screen coordinates.",
-          "docsTags": []
+          "docs": "Returns [hit test results](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#HitTestResult)\nfrom each layer that intersects the specified screen coordinates. The results are\norganized as an array of objects containing different [result types](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#HitTestResult).\n\nThe following layer types will return all [features](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#GraphicHit) if a hit is\nmade on intersecting features: [FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[CatalogLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CatalogLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[GeoRSSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoRSSLayer.html),\n[GraphicsLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html),\n[KMLLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-KMLLayer.html),\n[MapNotesLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MapNotesLayer.html),\n[OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OGCFeatureLayer.html),\n[StreamLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-StreamLayer.html),\n[SubtypeSublayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-SubtypeSublayer.html),\n[VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html), and\n[WFSLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-WFSLayer.html).\n\nThe [ParquetLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ParquetLayer.html) hit result returns only the topmost feature\nwhen the hit occurs on overlapping features in a ParquetLayer.\n\nThe [VectorTileLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VectorTileLayer.html) hit test result contains an array of objects containing\na [graphic](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#GraphicHit).\nThe graphic returns attributes of a style layer. In addition, the graphic's [origin](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html#origin)\ncontains the style layer's [id](https://maplibre.org/maplibre-style-spec/layers/#id) and layer index within the [vector tile style](https://doc.arcgis.com/en/arcgis-online/reference/tile-layers.htm#ESRI_SECTION1_8F68399EB47B48FF9EF46719FCC96978).\nSpatial information about the actual feature represented in the style layer is returned only if the style layer is a [symbol layer](https://maplibre.org/maplibre-style-spec/layers/#symbol).\nOtherwise, the graphic's geometry is `null`.\n\nThe [MediaLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-MediaLayer.html) hit test result contains all media elements if the hit is made on intersecting elements.\nThe [RouteLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-RouteLayer.html) hit test result contains all route elements if the hit is made on intersecting elements.\n\nIf the [polygon](https://developers.arcgis.com/javascript/latest/api-reference/esri-geometry-Polygon.html) feature's symbol\n[style](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html#style) is set to `none`, the hitTest method will not\nreturn results when the fill is clicked. However, it will return results when the outline is clicked. To get results when clicking the fill, set the\n[color](https://developers.arcgis.com/javascript/latest/api-reference/esri-symbols-SimpleFillSymbol.html#color) to a transparent color instead.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n   viewElement.hitTest(event.detail).then((response) => {\n      const result = response.results[0];\n      if (result?.type === \"graphic\") {\n         const { longitude, latitude } = result.mapPoint;\n         console.log(`Hit graphic at (${longitude}, ${latitude})`, result.graphic);\n      } else {\n         console.log(\"Did not hit any graphic\");\n      }\n   });\n});\n```"
+            },
+            {
+              "name": "example",
+              "text": "```js\n// get screenpoint from view's click event\nviewElement.addEventListener(\"arcgisViewClick\", async (event) => {\n  // Search for all media elements only on included mediaLayer at the clicked location\n  const response = await viewElement.hitTest(event.detail, {\n    include: {mediaLayer}\n  });\n  // if media elements are returned from the mediaLayer, do something with results\n  if (response.results.length){\n    // do something\n    console.log(response.results.length, \"elements returned\");\n  }\n});\n```"
+            }
+          ]
         },
         {
           "name": "openPopup",
@@ -33326,8 +33384,13 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "This event is for view related property changes: zoom, scale, center, rotation, extent, camera, viewpoint.\nThis event will also emit if stationary toggles from true to false.",
-          "docsTags": []
+          "docs": "This event is triggered when view-related properties change, such as [zoom](#zoom), [scale](#scale), [center](#center), [rotation](#rotation), [extent](#extent),\n[viewpoint](#viewpoint), or [stationary](#stationary).\nIt reflects user interactions (e.g. panning or zooming) or programmatic updates to the view.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\n// get the number of features in a layer view whenever the view becomes stationary\nviewElement.addEventListener(\"arcgisViewChange\", async (event) =>{\n  if (viewElement.stationary) {\n    // Returns number of features available for drawing in a given layer view\n    const count = await layerView.queryFeatureCount({\n      geometry: viewElement.extent\n    });\n    // use the features count\n  }\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewClick",
@@ -33346,8 +33409,13 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires after a user clicks on the view.",
-          "docsTags": []
+          "docs": "Fires after a user clicks on the view. This event emits slightly slower than an [arcgisViewImmediateClick](#arcgisViewImmediateClick)\nevent to make sure that an [arcgisViewDoubleClick](#arcgisViewDoubleClick) event isn't triggered instead. The `arcgisViewImmediateClick`\nevent can be used for responding to an `arcgisViewClick` event without delay.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\n// Listen for clicks on the view and perform a hit test on a feature layer\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  // Return hit test results from the feature layer\n  // where it intersects the screen coordinates from the click event.\n  // The result is a polygon representing the state that was clicked.\n  viewElement.hitTest(event.detail).then((response) => {\n     if (response.results.length) {\n       const stateBoundaryPolygon = response.results.find((result) => {\n         return result.graphic.layer === stateBoundaryFeatureLayer;\n        }).graphic.geometry;\n\n        getPolygonCentroid(stateBoundaryPolygon);\n      }\n    });\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewDoubleClick",
@@ -33367,7 +33435,12 @@
           "cancelable": true,
           "composed": true,
           "docs": "Fires after double-clicking on the view.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\nviewElement.addEventListener(\"arcgisViewDoubleClick\", async (event) => {\n  // Prevent the default zoom-in behavior on double-click\n  event.detail.stopPropagation();\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewDrag",
@@ -33406,7 +33479,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires during a pointer drag on the view.",
+          "docs": "Fires after holding either a mouse button or a single finger on the view for a short amount of time.",
           "docsTags": []
         },
         {
@@ -33426,8 +33499,13 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires right after a user clicks on the view.",
-          "docsTags": []
+          "docs": "Fires right after a user clicks on the view. In contrast to the [arcgisViewClick](#arcgisViewClick) event, the `arcgisViewImmediateClick`\nis emitted as soon as the user clicks on the view, and is not inhibited by a [arcgisViewDoubleClick](#arcgisViewDoubleClick) event.\nThis event is useful for interactive experiences that require feedback without delay.",
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\nviewElement.addEventListener(\"arcgisViewImmediateClick\", async (event) => {\n  // Prevent the default zoom-in behavior on arcgisViewImmediateClick\n  event.detail.stopPropagation();\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewImmediateDoubleClick",
@@ -33446,7 +33524,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Is emitted after two consecutive immediate-click events.",
+          "docs": "Fires after after two consecutive [arcgisViewImmediateClick](#arcgisViewImmediateClick) events. In contrast to [arcgisViewDoubleClick](#arcgisViewDoubleClick),\nan `arcgisViewImmediateDoubleClick` cannot be prevented by use of `stopPropagation()` on the [arcgisViewImmediateClick](#arcgisViewImmediateClick)\nevent and can therefore be used to react to double-clicking independently of usage of the [arcgisViewImmediateClick](#arcgisViewImmediateClick) event.",
           "docsTags": []
         },
         {
@@ -33467,7 +33545,12 @@
           "cancelable": true,
           "composed": true,
           "docs": "Fires after a keyboard key is pressed.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\n// Disable zooming with the keyboard\n// Stop event propagation when `+` and `-` keys are pressed.\nviewElement.addEventListener(\"arcgisViewKeyDown\", function(event){\n  console.log(\"key-down\", event);\n\n  const prohibitedKeys = [\"+\", \"-\"];\n  const keyPressed = event.detail.key;\n  if (prohibitedKeys.indexOf(keyPressed) !== -1) {\n    event.detail.stopPropagation();\n  }\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewKeyUp",
@@ -33486,7 +33569,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires after a keyboard key is pressed.",
+          "docs": "Fires after a keyboard key is released.",
           "docsTags": []
         },
         {
@@ -33506,7 +33589,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires after each layer in the map has a corresponding LayerView created and rendered in the view.",
+          "docs": "Fires after each layer in the map has a corresponding\n[LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\ncreated and rendered in the view.",
           "docsTags": []
         },
         {
@@ -33526,7 +33609,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires when an error emits during the creation of a LayerView after a layer has been added to the map.",
+          "docs": "Fires when an error occurs during the creation of a [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\nafter a layer has been added to the map.",
           "docsTags": []
         },
         {
@@ -33546,7 +33629,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "Fires after a LayerView is destroyed and is no longer rendered in the view.",
+          "docs": "Fires after a [LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\nis destroyed and is no longer rendered in the view.",
           "docsTags": []
         },
         {
@@ -33567,7 +33650,12 @@
           "cancelable": true,
           "composed": true,
           "docs": "Fires when a wheel button of a pointing device (typically a mouse) is scrolled on the view.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "example",
+              "text": "```js\nviewElement.addEventListener(\"arcgisViewMouseWheel\", async (event) => {\n  // Prevent the default zoom-in and zoom-out behavior on arcgisViewMouseWheel\n  event.detail.stopPropagation();\n});\n```"
+            }
+          ]
         },
         {
           "event": "arcgisViewPointerDown",
@@ -33587,7 +33675,12 @@
           "cancelable": true,
           "composed": true,
           "docs": "Fires after a mouse button is pressed, or a finger touches the display.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[Sample: Access features with hitTest](https://developers.arcgis.com/javascript/latest/sample-code/map-component-hittest/)"
+            }
+          ]
         },
         {
           "event": "arcgisViewPointerEnter",
@@ -33647,7 +33740,12 @@
           "cancelable": true,
           "composed": true,
           "docs": "Fires after the mouse or a finger on the display moves.",
-          "docsTags": []
+          "docsTags": [
+            {
+              "name": "see",
+              "text": "[Sample: Access features with hitTest](https://developers.arcgis.com/javascript/latest/sample-code/map-component-hittest/)"
+            }
+          ]
         },
         {
           "event": "arcgisViewPointerUp",
@@ -33680,7 +33778,7 @@
           },
           "cancelable": true,
           "composed": true,
-          "docs": "This event is for the `ready` property and will be emitted when the view is ready.\nThis event will also emit if the `map` property is changed.",
+          "docs": "This event is for the `ready` property and is emitted when the view is ready.\nFires also when the [map](#map) is updated.",
           "docsTags": []
         },
         {