@arcgis/map-components 5.0.0-next.6 → 5.0.0-next.8

package/dist/docs/api.json

@@ -1,8 +1,8 @@
 {
-  "timestamp": "2025-10-01T04:36:32",
+  "timestamp": "2025-10-03T04:44:22",
   "compiler": {
     "name": "@arcgis/lumina-compiler",
-    "version": "5.0.0-next.6",
+    "version": "5.0.0-next.8",
     "typescriptVersion": "5.8.3"
   },
   "schemaVersion": "1.0.0",
@@ -35945,6 +35945,10 @@
             {
               "name": "bottom-end",
               "description": "Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL)."
+            },
+            {
+              "name": "popup",
+              "description": "Slot for the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/) component to open automatically on click. When using this slot, the [`popup-disabled`](#popupDisabled) attribute must be set to `true`. Only the Popup component can be placed in this slot."
             }
           ],
           "cssProperties": [
@@ -37677,7 +37681,7 @@
             {
               "kind": "field",
               "name": "background",
-              "description": "The background color of the MapView. If the view's map changes, the view's `background` is reset to the map's background,\neven if the user set it previously.",
+              "description": "The background color of the Map component.",
               "type": {
                 "text": "ColorBackground",
                 "references": [
@@ -37741,7 +37745,7 @@
             {
               "kind": "field",
               "name": "center",
-              "description": "Represents the view's center point; when setting the center, you may pass a\nesri/geometry/Point 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() method.",
+              "description": "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.",
               "type": {
                 "text": "Array<number> | Point | string",
                 "references": [
@@ -37833,7 +37837,7 @@
             {
               "kind": "field",
               "name": "constraints",
-              "description": "Specifies constraints to scale, zoom, and rotation that may be applied to the MapView.",
+              "description": "Specifies constraints to scale, zoom, and rotation that may be applied to the map.",
               "type": {
                 "text": "View2DConstraints",
                 "references": [
@@ -37871,7 +37875,7 @@
             {
               "kind": "field",
               "name": "displayFilterDisabled",
-              "description": "Indicates whether layer's displayFilter are honored when rendering layers in the view.\nIf `false`, display filters are ignored and all features are rendered.",
+              "description": "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.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -37886,7 +37890,7 @@
             {
               "kind": "field",
               "name": "extent",
-              "description": "The extent represents the visible portion of a map within the view as an instance of esri/geometry/Extent.\nSetting the extent immediately changes the view without animation. To animate\nthe view, see this component's goTo() method.\nWhen the view is rotated, the extent does not update to include the newly visible portions of the map.",
+              "description": "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.",
               "type": {
                 "text": "Extent",
                 "references": [
@@ -38103,7 +38107,7 @@
             {
               "kind": "field",
               "name": "highlights",
-              "description": "The highlights property is a collection of HighlightGroup objects that\nallow you to visually emphasize specific features on the map.",
+              "description": "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.",
               "type": {
                 "text": "Collection<HighlightOptions>",
                 "references": [
@@ -38216,7 +38220,7 @@
             {
               "kind": "field",
               "name": "interacting",
-              "description": "Indication whether the view is being interacted with (for example when panning or by an interactive tool).",
+              "description": "Indicates whether the view is being interacted with (for example, when panning or via an interactive tool).",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -38264,7 +38268,7 @@
             {
               "kind": "field",
               "name": "layerViews",
-              "description": "A collection containing a hierarchical list of all the created\nesri/views/layers/LayerView LayerViews of the\nesri/Map#layers operational layers in the map.",
+              "description": "A collection containing a hierarchical list of all the created\n[LayerView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)s of the\n[operational layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html#layers) in the map.",
               "type": {
                 "text": "Collection<LayerView>",
                 "references": [
@@ -38377,7 +38381,7 @@
             {
               "kind": "field",
               "name": "map",
-              "description": "An instance of a esri/Map object to display in the view.",
+              "description": "An instance of a [Map](https://developers.arcgis.com/javascript/latest/api-reference/esri-Map.html) object to display in the view.",
               "type": {
                 "text": "Map",
                 "references": [
@@ -38532,7 +38536,7 @@
             {
               "kind": "field",
               "name": "ready",
-              "description": "When `true`, this property indicates whether the view successfully satisfied all dependencies,\nsignaling that the following conditions are met.",
+              "description": "When `true`, this property indicates whether the [view](#view) has successfully satisfied all dependencies, signaling that the following conditions are met:\n\n* The view has a [map](#map). If [map](#map)\nis a [WebMap](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html), then the map\nmust be [loaded](https://developers.arcgis.com/javascript/latest/api-reference/esri-WebMap.html#loaded).\n* The view has a [spatialReference](#spatialReference), a [center](#center), and a [scale](#scale).\nThese also can be inferred by setting an [extent](#extent).\n\nWhen a view becomes ready it will resolve itself and invoke\nthe callback defined in [viewOnReady()](#viewOnReady) where code can execute on a working view.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -38626,7 +38630,7 @@
             {
               "kind": "field",
               "name": "scale",
-              "description": "Represents the map scale at the center of the view. Setting the scale immediately changes the view. For animating\nthe view, see this component's goTo() method.",
+              "description": "Represents the map scale at the center of the view. Setting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](#goTo) method.",
               "type": {
                 "text": "number",
                 "values": [
@@ -38659,7 +38663,7 @@
             {
               "kind": "field",
               "name": "spatialReferenceLocked",
-              "description": "Indicates if the map's spatialReference can be changed after it is ready.\nThe default is `false`, indicating the map's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the map's spatial reference\nwill be disabled in [arcgis-basemap-gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [arcgis-basemap-toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.",
+              "description": "Indicates if the map's [spatialReference](#spatialReference) can be changed after it is ready.\nThe default is `false`, indicating the map's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the map's spatial reference\nwill be disabled in [arcgis-basemap-gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [arcgis-basemap-toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -38768,7 +38772,7 @@
             {
               "kind": "field",
               "name": "theme",
-              "description": "This property specifies the base colors used by some widgets\nand components to render graphics and labels.",
+              "description": "This property specifies the base colors used by some components to render graphics and labels.",
               "type": {
                 "text": "Theme",
                 "references": [
@@ -38986,7 +38990,7 @@
             {
               "kind": "field",
               "name": "view",
-              "description": "The [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) instance created and manged by the component. Accessible once the component is fully loaded.",
+              "description": "The [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) instance created and managed by the component. Accessible once the component is fully loaded.",
               "type": {
                 "text": "MapView",
                 "references": [
@@ -39081,7 +39085,7 @@
             {
               "kind": "field",
               "name": "viewpoint",
-              "description": "Represents the current view as a Viewpoint or point of observation on the view.\nSetting the viewpoint immediately changes the current view. For animating\nthe view, see this component's goTo() method.",
+              "description": "Represents the current view as a Viewpoint or point of observation on the view.\nSetting the viewpoint immediately changes the current view. For animating\nthe view, see this component's [goTo()](#goTo) method.",
               "type": {
                 "text": "Viewpoint",
                 "references": [
@@ -39213,7 +39217,7 @@
             {
               "kind": "field",
               "name": "zoom",
-              "description": "Represents the level of detail (LOD) at the center of the view.\nA zoom level (or scale) is a number that defines how large or small the contents of a map appear in a map view.\nZoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.\nA value of -1 means the view has no LODs.\nWhen setting the zoom value, the MapView converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.\nMapView can display maps with different projections at a full range of scales, and so use the scale property on this component rather than zoom level.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's goTo() method.\nSetting this property in conjunction with `center` is a convenient way to set the initial extent of the view.",
+              "description": "Represents the level of detail (LOD) at the center of the map.\nA zoom level (or scale) is a number that defines how large or small the contents of a map appear in a Map component.\nZoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.\nA value of -1 means the map has no LODs.\nWhen setting the zoom value, the component converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.\nSetting this property in conjunction with `center` is a convenient way to set the initial extent of the view.",
               "type": {
                 "text": "number",
                 "values": [
@@ -39255,7 +39259,7 @@
             },
             {
               "name": "center",
-              "description": "Represents the view's center point; when setting the center, you may pass a\nesri/geometry/Point 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() method.",
+              "description": "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.",
               "type": {
                 "text": "string",
                 "values": [
@@ -39268,7 +39272,7 @@
             },
             {
               "name": "display-filter-disabled",
-              "description": "Indicates whether layer's displayFilter are honored when rendering layers in the view.\nIf `false`, display filters are ignored and all features are rendered.",
+              "description": "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.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -39383,7 +39387,7 @@
             },
             {
               "name": "scale",
-              "description": "Represents the map scale at the center of the view. Setting the scale immediately changes the view. For animating\nthe view, see this component's goTo() method.",
+              "description": "Represents the map scale at the center of the view. Setting the scale immediately changes the view. For animating\nthe view, see this component's [goTo()](#goTo) method.",
               "type": {
                 "text": "number",
                 "values": [
@@ -39396,7 +39400,7 @@
             },
             {
               "name": "spatial-reference-locked",
-              "description": "Indicates if the map's spatialReference can be changed after it is ready.\nThe default is `false`, indicating the map's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the map's spatial reference\nwill be disabled in [arcgis-basemap-gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [arcgis-basemap-toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.",
+              "description": "Indicates if the map's [spatialReference](#spatialReference) can be changed after it is ready.\nThe default is `false`, indicating the map's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the map's spatial reference\nwill be disabled in [arcgis-basemap-gallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [arcgis-basemap-toggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the map's spatialReference cannot be changed at runtime.",
               "type": {
                 "text": "boolean",
                 "values": [
@@ -39438,7 +39442,7 @@
             },
             {
               "name": "zoom",
-              "description": "Represents the level of detail (LOD) at the center of the view.\nA zoom level (or scale) is a number that defines how large or small the contents of a map appear in a map view.\nZoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.\nA value of -1 means the view has no LODs.\nWhen setting the zoom value, the MapView converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.\nMapView can display maps with different projections at a full range of scales, and so use the scale property on this component rather than zoom level.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's goTo() method.\nSetting this property in conjunction with `center` is a convenient way to set the initial extent of the view.",
+              "description": "Represents the level of detail (LOD) at the center of the map.\nA zoom level (or scale) is a number that defines how large or small the contents of a map appear in a Map component.\nZoom level is a number usually between 0 (global view) and 23 (very detailed view) and is used as a shorthand for predetermined scale values.\nA value of -1 means the map has no LODs.\nWhen setting the zoom value, the component converts it to the corresponding scale, or interpolates it if the zoom is a fractional number.\n\nSetting the zoom immediately changes the current view. For animating the view, see this component's [goTo()](#goTo) method.\nSetting this property in conjunction with `center` is a convenient way to set the initial extent of the view.",
               "type": {
                 "text": "number",
                 "values": [
@@ -39866,6 +39870,10 @@
             {
               "name": "bottom-end",
               "description": "Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL)."
+            },
+            {
+              "name": "popup",
+              "description": "Slot for the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/) component to open automatically on click. When using this slot, the [`popup-disabled`](#popupDisabled) attribute must be set to `true`. Only the Popup component can be placed in this slot."
             }
           ],
           "cssProperties": [
@@ -42321,7 +42329,7 @@
           "customElement": true,
           "name": "ArcgisPopup",
           "tagName": "arcgis-popup",
-          "description": "## Overview\nThe Popup component allows users to view content from feature attributes. Popups enhance web applications\nby providing users with a simple way to interact with and view attributes in a layer.\nThey play an important role in relaying information to the user, which improves the storytelling capabilities of the application.\n\n## Popup UI\nThe [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components contain a default popup.\nThis popup can display generic content, which is set in its [heading](#heading)\nand [content](#content) properties.\nWhen  content is set directly on the Popup instance it is not tied to a specific feature or layer.\n\n![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)\n\nIn the image above, the text \"Marriage in Nassau County Census Tract 5177.01\" is the popup's [heading](#heading).\nThe remaining text is the popup's [content](#content).\nA dock button is displayed in the top right corner of the popup allowing the user to dock the popup to one of the sides or corners of the view.\nThe options for docking may be set in the [dockOptions](#dockOptions) property.\nThe popup may also be collapsed by clicking the collapse button (the down arrow icon) in the top right corner of the popup.\nWhen collapsed, only the heading of the popup displays.\nThe popup may be closed by clicking the close button (the \"x\" icon) in the top right corner of the popup.\n\nPopups can also contain [actions](#actions) which execute a function defined by the developer when clicked.\nBy default, every popup has a \"Zoom to\" action (as shown in the image above with the magnifying glass) that allows users to zoom to the selected feature.\nSee the [actions](#actions) property for information about adding custom actions to a popup.\n\nThe Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.\nIf wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component can be used to display the same content\nin its own container.\n\n## Popup and PopupTemplate\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)\nand [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). Popup templates allow you to define custom titles and content templates based on the source of the\n[selected feature](#selectedFeature). When a layer or a graphic has a defined\npopup template, the popup will display the content defined in the popup template when the feature is clicked.\nThe content may contain field values from the attributes of the [selected feature](#selectedFeature).\n\nCustom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) on the\n[features](#features) property.",
+          "description": "## Overview\nThe Popup component allows users to view content from feature attributes. Popups enhance web applications\nby providing users with a simple way to interact with and view attributes in a layer.\nThey play an important role in relaying information to the user, which improves the storytelling capabilities of the application.\n\nThe [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), and [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components currently use the [Popup widget](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) by default.\nTo enable the Popup component, first disable the popup widget via the `popup-disabled` attribute on Map, Scene, or LinkChart, then add the Popup component.\nOnce added, there are two ways to open the Popup component: automatically when features are clicked, or manually by calling the popup component's [open()](#open) method.\n\n### Automatically open Popup when features are clicked\nThe Popup component can be opened automatically to display the selected feature's popup template when features in the Map, Scene, or Link Chart are clicked.\nTo configure this, add the Popup component to the `popup` slot of the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components.\n\n```html\n<arcgis-map id=\"06ca49d0ddb447e7817cfc343ca30df9\" popup-disabled>\n  <arcgis-popup slot=\"popup\"></arcgis-popup>\n</arcgis-map>\n```\n### Manually open Popup\nThe Popup component can also be opened manually by adding it to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/)'s default slot.\nFirst, set the `popup-disabled` attribute to `true` on the Map, Scene, or Link Chart, then call the popup component's [open()](#open) method and pass in a location.\nWhen the Map, Scene, or Link Chart is clicked, the Popup component will open with specified content at the clicked location.\n\n```html\n<arcgis-map id=\"06ca49d0ddb447e7817cfc343ca30df9\" popup-disabled>\n  <arcgis-popup></arcgis-popup>\n</arcgis-map>\n<script>\nconst viewElement = document.querySelector(\"arcgis-map\");\nconst popupComponent = document.querySelector(\"arcgis-popup\");\nviewElement.addEventListener(\"arcgisViewClick\", (event) => {\n  const { mapPoint } = event.detail;\n  popupComponent.open({\n    location: mapPoint,\n    heading: \"You clicked here\",\n    content: \"Latitude: \" + mapPoint.latitude.toFixed(3) + \", Longitude: \" + mapPoint.longitude.toFixed(3)\n  });\n});\n</script>\n```\n\n## Popup UI\nThe [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components contain a default popup.\nThis popup can display generic content, which is set in its [heading](#heading)\nand [content](#content) properties.\nWhen  content is set directly on the Popup instance it is not tied to a specific feature or layer.\n\n![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)\n\nIn the image above, the text \"Marriage in Nassau County Census Tract 5177.01\" is the popup's [heading](#heading).\nThe remaining text is the popup's [content](#content).\nA dock button is displayed in the top right corner of the popup allowing the user to dock the popup to one of the sides or corners of the view.\nThe options for docking may be set in the [dockOptions](#dockOptions) property.\nThe popup may also be collapsed by clicking the collapse button (the down arrow icon) in the top right corner of the popup.\nWhen collapsed, only the heading of the popup displays.\nThe popup may be closed by clicking the close button (the \"x\" icon) in the top right corner of the popup.\n\nPopups can also contain [actions](#actions) which execute a function defined by the developer when clicked.\nBy default, every popup has a \"Zoom to\" action (as shown in the image above with the magnifying glass) that allows users to zoom to the selected feature.\nSee the [actions](#actions) property for information about adding custom actions to a popup.\n\nThe Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.\nIf wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component can be used to display the same content\nin its own container.\n\n## Popup and PopupTemplate\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)\nand [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). Popup templates allow you to define custom titles and content templates based on the source of the\n[selected feature](#selectedFeature). When a layer or a graphic has a defined\npopup template, the popup will display the content defined in the popup template when the feature is clicked.\nThe content may contain field values from the attributes of the [selected feature](#selectedFeature).\n\nCustom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) on the\n[features](#features) property.",
           "demos": [
             {
               "description": "Docs",
@@ -42922,15 +42930,15 @@
                 {
                   "name": "event",
                   "type": {
-                    "text": "Event",
+                    "text": "ViewClickEvent",
                     "references": [
                       {
-                        "name": "Event",
-                        "package": "typescript",
-                        "module": "lib/lib.dom.d.ts",
-                        "viewUrl": "https://developer.mozilla.org/docs/Web/API/Event",
+                        "name": "ViewClickEvent",
+                        "package": "@arcgis/core",
+                        "module": "interfaces.d.ts",
+                        "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#event-click",
                         "start": 0,
-                        "end": 5
+                        "end": 14
                       }
                     ]
                   }
@@ -42938,7 +42946,7 @@
               ],
               "return": {
                 "type": {
-                  "text": "Promise<void>",
+                  "text": "Promise<FeaturesViewModelOpenOptions>",
                   "references": [
                     {
                       "name": "Promise",
@@ -42946,6 +42954,13 @@
                       "module": "lib/lib.es5.d.ts",
                       "start": 0,
                       "end": 7
+                    },
+                    {
+                      "name": "FeaturesViewModelOpenOptions",
+                      "package": "@arcgis/core",
+                      "module": "interfaces.d.ts",
+                      "start": 8,
+                      "end": 36
                     }
                   ]
                 }
@@ -42955,7 +42970,7 @@
                   "name": "internal"
                 }
               ],
-              "signature": "(event: Event): Promise<void>",
+              "signature": "(event: __esri.ViewClickEvent): Promise<__esri.FeaturesViewModelOpenOptions>",
               "async": true
             },
             {
@@ -49180,6 +49195,10 @@
             {
               "name": "bottom-end",
               "description": "Slot for components positioned at the bottom-end (bottom-right in LTR, bottom-left in RTL)."
+            },
+            {
+              "name": "popup",
+              "description": "Slot for the [Popup](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/) component to open automatically on click. When using this slot, the [`popup-disabled`](#popupDisabled) attribute must be set to `true`. Only the Popup component can be placed in this slot."
             }
           ],
           "cssProperties": [
@@ -61452,6 +61471,113 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/utility-network-trace-analysis/components/utility-network-subnetwork-info/utility-network-subnetwork-info.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "name": "ArcgisUtilityNetworkSubnetworkInfo",
+          "tagName": "arcgis-utility-network-subnetwork-info",
+          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a utility network and named trace configuration as input.\nThe sub-component displays information from the trace configuration relevant to subnetworks:\nDomain network name, tier name, and target tier name.",
+          "demos": [
+            {
+              "description": "Docs",
+              "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-subnetwork-info/"
+            }
+          ],
+          "docsTags": [
+            {
+              "name": "since",
+              "text": "4.34"
+            },
+            {
+              "name": "internal"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "@arcgis/lumina"
+          },
+          "pascalCaseName": "ArcgisUtilityNetworkSubnetworkInfo",
+          "importPath": "components/arcgis-utility-network-subnetwork-info",
+          "members": [
+            {
+              "kind": "method",
+              "name": "componentOnReady",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "module": "lib/lib.es5.d.ts",
+                      "name": "Promise",
+                      "package": "typescript",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "description": "Create a promise that resolves once component is fully loaded.",
+              "signature": "(): Promise<void>",
+              "async": true,
+              "inheritedFrom": {
+                "name": "LitElement",
+                "package": "@arcgis/lumina"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\nconst arcgisUtilityNetworkSubnetworkInfo = document.querySelector(\"arcgis-utility-network-subnetwork-info\");\ndocument.body.append(arcgisUtilityNetworkSubnetworkInfo);\nawait arcgisUtilityNetworkSubnetworkInfo.componentOnReady();\nconsole.log(\"arcgis-utility-network-subnetwork-info is ready to go!\");\n```"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "namedTraceConfig",
+              "type": {
+                "text": "NamedTraceConfiguration | undefined",
+                "references": [
+                  {
+                    "name": "NamedTraceConfiguration",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-support-NamedTraceConfiguration.html",
+                    "start": 0,
+                    "end": 23
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "NamedTraceConfiguration"
+                  },
+                  {
+                    "type": "undefined"
+                  }
+                ]
+              },
+              "docsTags": [
+                {
+                  "name": "required"
+                }
+              ]
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "arcgis-utility-network-subnetwork-info",
+          "declaration": {
+            "name": "ArcgisUtilityNetworkSubnetworkInfo",
+            "module": "src/components/utility-network-trace-analysis/components/utility-network-subnetwork-info/utility-network-subnetwork-info.tsx"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/utility-network-trace-analysis/components/utility-network-trace-inputs/utility-network-trace-inputs.tsx",
@@ -61518,7 +61644,6 @@
             {
               "kind": "field",
               "name": "referenceElement",
-              "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
               "type": {
                 "text": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string",
                 "references": [
@@ -61559,13 +61684,20 @@
                   }
                 ]
               },
-              "attribute": "reference-element",
-              "docsTags": [
-                {
-                  "name": "see",
-                  "text": "[Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)"
-                }
-              ]
+              "attribute": "reference-element"
+            },
+            {
+              "kind": "field",
+              "name": "selectedSubnetworkName",
+              "type": {
+                "text": "string",
+                "values": [
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "attribute": "selected-subnetwork-name"
             },
             {
               "kind": "field",
@@ -61601,6 +61733,31 @@
                 ]
               }
             },
+            {
+              "kind": "field",
+              "name": "traceLocations",
+              "type": {
+                "text": "Array<TraceLocation>",
+                "references": [
+                  {
+                    "name": "Array",
+                    "package": "typescript",
+                    "module": "lib/lib.es5.d.ts",
+                    "start": 0,
+                    "end": 5
+                  },
+                  {
+                    "name": "TraceLocation",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-networks-support-TraceLocation.html",
+                    "start": 6,
+                    "end": 19
+                  }
+                ]
+              },
+              "readonly": true
+            },
             {
               "kind": "field",
               "name": "view",
@@ -61635,7 +61792,6 @@
           "attributes": [
             {
               "name": "reference-element",
-              "description": "By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.",
               "type": {
                 "text": "string",
                 "values": [
@@ -61645,6 +61801,18 @@
                 ]
               },
               "fieldName": "referenceElement"
+            },
+            {
+              "name": "selected-subnetwork-name",
+              "type": {
+                "text": "string",
+                "values": [
+                  {
+                    "type": "string"
+                  }
+                ]
+              },
+              "fieldName": "selectedSubnetworkName"
             }
           ],
           "events": [
@@ -61674,6 +61842,293 @@
         }
       ]
     },
+    {
+      "kind": "javascript-module",
+      "path": "src/components/utility-network-trace-analysis/components/utility-network-trace-location/utility-network-trace-location.tsx",
+      "declarations": [
+        {
+          "kind": "class",
+          "customElement": true,
+          "name": "ArcgisUtilityNetworkTraceLocation",
+          "tagName": "arcgis-utility-network-trace-location",
+          "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes a map view as an input.\nIt allows users to select locations on the map to use as trace inputs.",
+          "demos": [
+            {
+              "description": "Docs",
+              "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-location/"
+            }
+          ],
+          "docsTags": [
+            {
+              "name": "since",
+              "text": "4.34"
+            },
+            {
+              "name": "internal"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "@arcgis/lumina"
+          },
+          "pascalCaseName": "ArcgisUtilityNetworkTraceLocation",
+          "importPath": "components/arcgis-utility-network-trace-location",
+          "members": [
+            {
+              "kind": "method",
+              "name": "componentOnReady",
+              "return": {
+                "type": {
+                  "text": "Promise<void>",
+                  "references": [
+                    {
+                      "module": "lib/lib.es5.d.ts",
+                      "name": "Promise",
+                      "package": "typescript",
+                      "start": 0,
+                      "end": 7
+                    }
+                  ]
+                }
+              },
+              "description": "Create a promise that resolves once component is fully loaded.",
+              "signature": "(): Promise<void>",
+              "async": true,
+              "inheritedFrom": {
+                "name": "LitElement",
+                "package": "@arcgis/lumina"
+              },
+              "docsTags": [
+                {
+                  "name": "example",
+                  "text": "```js\nconst arcgisUtilityNetworkTraceLocation = document.querySelector(\"arcgis-utility-network-trace-location\");\ndocument.body.append(arcgisUtilityNetworkTraceLocation);\nawait arcgisUtilityNetworkTraceLocation.componentOnReady();\nconsole.log(\"arcgis-utility-network-trace-location is ready to go!\");\n```"
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "filterLayers",
+              "type": {
+                "text": "Collection<Layer>",
+                "references": [
+                  {
+                    "name": "Collection",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html",
+                    "start": 0,
+                    "end": 10
+                  },
+                  {
+                    "name": "Layer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html",
+                    "start": 11,
+                    "end": 16
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "flagLayer",
+              "type": {
+                "text": "GraphicsLayer",
+                "references": [
+                  {
+                    "name": "GraphicsLayer",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GraphicsLayer.html",
+                    "start": 0,
+                    "end": 13
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "sketchViewModel",
+              "type": {
+                "text": "SketchViewModel",
+                "references": [
+                  {
+                    "name": "SketchViewModel",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Sketch-SketchViewModel.html",
+                    "start": 0,
+                    "end": 15
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "traceLocations",
+              "type": {
+                "text": "Collection<FlagProperty>",
+                "references": [
+                  {
+                    "name": "Collection",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html",
+                    "start": 0,
+                    "end": 10
+                  },
+                  {
+                    "name": "FlagProperty",
+                    "module": "dist/components/arcgis-utility-network-trace-location/customElement.d.ts",
+                    "start": 11,
+                    "end": 23
+                  }
+                ]
+              }
+            },
+            {
+              "kind": "field",
+              "name": "traceLocationType",
+              "type": {
+                "text": "\"barrier\" | \"starting-point\" | \"stopping-point\"",
+                "values": [
+                  {
+                    "value": "barrier",
+                    "type": "string"
+                  },
+                  {
+                    "value": "starting-point",
+                    "type": "string"
+                  },
+                  {
+                    "value": "stopping-point",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"starting-point\"",
+              "attribute": "trace-location-type"
+            },
+            {
+              "kind": "field",
+              "name": "utilityNetwork",
+              "type": {
+                "text": "UtilityNetwork | undefined",
+                "references": [
+                  {
+                    "name": "UtilityNetwork",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-networks-UtilityNetwork.html",
+                    "start": 0,
+                    "end": 14
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "UtilityNetwork"
+                  },
+                  {
+                    "type": "undefined"
+                  }
+                ]
+              },
+              "docsTags": [
+                {
+                  "name": "required",
+                  "text": "The utility network to perform the trace on."
+                }
+              ]
+            },
+            {
+              "kind": "field",
+              "name": "view",
+              "type": {
+                "text": "MapView | undefined",
+                "references": [
+                  {
+                    "name": "MapView",
+                    "package": "@arcgis/core",
+                    "module": "interfaces.d.ts",
+                    "viewUrl": "https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html",
+                    "start": 0,
+                    "end": 7
+                  }
+                ],
+                "values": [
+                  {
+                    "type": "MapView"
+                  },
+                  {
+                    "type": "undefined"
+                  }
+                ]
+              },
+              "docsTags": [
+                {
+                  "name": "required"
+                }
+              ]
+            }
+          ],
+          "attributes": [
+            {
+              "name": "trace-location-type",
+              "type": {
+                "text": "\"barrier\" | \"starting-point\" | \"stopping-point\"",
+                "values": [
+                  {
+                    "value": "barrier",
+                    "type": "string"
+                  },
+                  {
+                    "value": "starting-point",
+                    "type": "string"
+                  },
+                  {
+                    "value": "stopping-point",
+                    "type": "string"
+                  }
+                ]
+              },
+              "default": "\"starting-point\"",
+              "fieldName": "traceLocationType"
+            }
+          ],
+          "events": [
+            {
+              "name": "arcgisTraceLocationChange",
+              "type": {
+                "text": "void"
+              }
+            },
+            {
+              "name": "arcgisTraceLocationSelectEnd",
+              "type": {
+                "text": "void"
+              }
+            },
+            {
+              "name": "arcgisTraceLocationSelectStart",
+              "type": {
+                "text": "void"
+              }
+            }
+          ]
+        }
+      ],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "arcgis-utility-network-trace-location",
+          "declaration": {
+            "name": "ArcgisUtilityNetworkTraceLocation",
+            "module": "src/components/utility-network-trace-analysis/components/utility-network-trace-location/utility-network-trace-location.tsx"
+          }
+        }
+      ]
+    },
     {
       "kind": "javascript-module",
       "path": "src/components/utility-network-trace-analysis/components/utility-network-trace-results/utility-network-trace-results.tsx",