@arcgis/map-components 4.34.0-next.125 → 4.34.0-next.127

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

@@ -3218,7 +3218,7 @@
     },
     {
       "name": "arcgis-feature",
-      "description": "The Feature component displays a graphic according to its [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\nThis component is useful in instances where you want to display information about a feature but without\nthe use of a [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html).\n\nIf wanting to show a feature's content with [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#actions), [related](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html), or [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate), etc., then use the [ArcgisFeatures](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component.\n\nWhen Arcade expressions that use `$map` or [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) are defined in any popup template content or as expression elements,\nthe [map](#map) and [spatialReference](#spatialReference) properties need to be defined in the Feature component.\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `nextMedia(contentElementIndex: number): Promise<void>` - Paginates to the next [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.\n- `previousMedia(contentElementIndex: number): Promise<void>` - Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info in the specified\n[media](esri-popup-content-MediaContent.html) content element.\n- `setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): Promise<void>` - Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.\n\n::: esri-md class=\"warning\"\nPrior to   version 4.17, this method was named `goToMedia`.\n:::\n- `updateGeometry(): Promise<void>`",
+      "description": "The Feature component displays a graphic according to its [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\nThis component is useful in instances where you want to display information about a feature but without\nthe use of a [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html).\n\nIf wanting to show a feature's content with [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#actions), [related](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html), or [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate), etc., then use the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component.\n\nWhen Arcade expressions that use `$map` or [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) are defined in any popup template content or as expression elements,\nthe [map](#map) and [spatialReference](#spatialReference) properties need to be defined in the Feature component.\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `nextMedia(contentElementIndex: number): Promise<void>` - Paginates to the next [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info.\n- `previousMedia(contentElementIndex: number): Promise<void>` - Paginates to the previous [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info in the specified\n[media](esri-popup-content-MediaContent.html) content element.\n- `setActiveMedia(contentElementIndex: number, mediaInfoIndex: number): Promise<void>` - Paginates to a specified [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) info object. For example,\nyou may have [media](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) content which contains\nmultiple `mediaInfos`. This method allows you to specify the index of the `mediaInfos`\nyou wish to display.\n\n::: esri-md class=\"warning\"\nPrior to   version 4.17, this method was named `goToMedia`.\n:::\n- `updateGeometry(): Promise<void>`",
       "attributes": [
         {
           "name": "auto-destroy-disabled",
@@ -3986,7 +3986,7 @@
     },
     {
       "name": "arcgis-features",
-      "description": "The Features component allows users to view a feature's popupTemplate content such as attributes,\nactions, related records, etc., without having to be tied to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html).\nThis component looks and behaves similarly to the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Popup.html) component,\nhowever unlike Popup, the Features component can be placed outside of the view.\nFor example, when features are selected in the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html),\nthe [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Popup.html) component opens within the View whether it is docked\nor anchored to the selected feature.\nWith the Features component, the same information that popup provides is shown in a separate container from the view, such as\na HTML div within a Calcite Design System\n[Shell Panel](https://developers.arcgis.com/calcite-design-system/components/shell-panel/).\n\n[![features-component-image](../assets/img/apiref/components/features-component.png)](../sample-code/sandbox/?sample=components-features)\n\nIn the image above, a Calcite shell panel displays the Features component along with a MapView in a separate div.\nA generic `title` and `content` property can be set directly on the Features component or\neach individual layer's [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) can be displayed (e.g.\nthe Olympic National Park feature's PopupTemplate that contains text, media, and relationship elements).\nThe action bar, shown below the title in the image above, displays [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) that can be defined either on the component level within the [open()](#open) method,\nwith the [FeaturesViewModel.actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions) property, or in the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of the layer.\nIf multiple features are passed into the Features component, the component provides buttons to page though the features and a feature menu that allows the\nlist of features to be displayed so the user can choose which feature content to display in the component. The component also respects\nfeature reduction PopupTemplates for [binning](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate).\n\nThe Features component should be used if needing to use the Popup functionality outside of the View. If wanting to show a single feature's content without\nactions, related records, clustering configuration, etc., then use the [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Feature.html) component.\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTriggerAction**\n\n### Methods\n- `clear(): Promise<void>` - Removes [promises](#promises), [features](#features), [content](#content), and\n[title](#title) from the Features component.\n- `close(): Promise<void>` - This is a convenience method to closes the component. Users can alternatively close the component\nby directly setting the [visible](#visible) property to `false`.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `fetchFeatures(screenPoint: __esri.ScreenPoint, options?: __esri.FetchFeaturesOptions): Promise<__esri.FetchPopupFeaturesResult>` - Use this method to return feature(s) at a given screen location.\nThese features are fetched from all of the [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\nin the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). In order to use this, a layer must already have an\nassociated [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html). This method allows a developer to\ncontrol how the input location is handled.\n- `next(): Promise<FeaturesViewModel>` - Selects the feature at the next index in relation to the selected feature.\n- `open(options?: __esri.FeaturesViewModelOpenOptions): Promise<void>` - Opens the Features component in its [container](#container) with content defined either explicitly with `content`\nor driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features. This method sets\nthe Feature component's [visible](#visible) property to `true`. Users can alternatively show the Features component\nby directly setting the [visible](#visible) property to `true`.\n- `previous(): Promise<FeaturesViewModel>` - Selects the feature at the previous index in relation to the selected feature.\n- `setFocus(): Promise<void>` - Use this method to give focus to the Component if the component is able to be focused.\n- `triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>` - Triggers the [trigger-action](#event-trigger-action) event and executes the [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions)\nat the specified index in the [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions) array.",
+      "description": "The Features component allows users to view a feature's popupTemplate content such as attributes,\nactions, related records, etc., without having to be tied to 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/) component.\nThis component looks and behaves similarly to the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html),\nhowever unlike Popup, the Features component can be placed outside of the map or scene component.\nFor example, when features are selected in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/),\nthe [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) opens within the map whether it is docked\nor anchored to the selected feature.\nWith the Features component, the same information that Popup provides is shown in a separate container from the map, such as\na HTML div within a Calcite Design System\n[Shell Panel](https://developers.arcgis.com/calcite-design-system/components/shell-panel/).\n\nIf multiple features are passed into the Features component, the component provides buttons to page though the features and a feature menu that allows the\nlist of features to be displayed so the user can choose which feature content to display in the component. The component also respects\nfeature reduction PopupTemplates for [binning](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate).\n\nThe Features component should be used if needing to use the Popup functionality outside of the map or scene component. If wanting to show a single feature's content without\nactions, related records, clustering configuration, etc., then use the [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) component.\n--\n\n### Events\n- **arcgisClose** - Emitted when the component's close button is clicked.\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTriggerAction** - Fires after the user clicks on an action in the Features component.\nThis event may be used to define a custom function to execute when particular actions are clicked.\n\n### Methods\n- `clear(): Promise<void>` - Removes [promises](#promises), [features](#features), [content](#content), and\n[heading](#heading) from the Features component.\n- `close(): Promise<void>` - A convenience method to close the component.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `fetchFeatures(screenPoint: __esri.ScreenPoint, options?: __esri.FetchFeaturesOptions): Promise<__esri.FetchPopupFeaturesResult>` - Use this method to return feature(s) at a given screen location.\nThese features are fetched from all of the [layer](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\nin the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). In order to use this, a layer must already have an\nassociated [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html). This method allows a developer to\ncontrol how the input location is handled.\n- `next(): Promise<FeaturesViewModel>` - Selects the feature at the next index in relation to the [selected feature](#selectedFeature).\n- `open(options?: __esri.FeaturesViewModelOpenOptions): Promise<void>` - Opens the Features component with content defined either explicitly with `content`\nor driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features.\n- `previous(): Promise<FeaturesViewModel>` - Selects the feature at the previous index in relation to the [selected feature](#selectedFeature).\n- `setFocus(): Promise<void>` - Use this method to give focus to the Component if the component is able to be focused.\n- `triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>` - Triggers the [`arcgisTriggerAction`](#arcgisTriggerAction) event and executes the action\nat the specified index in the [actions](#actions) array.",
       "attributes": [
         {
           "name": "auto-destroy-disabled",
@@ -3995,22 +3995,27 @@
         },
         {
           "name": "collapsed",
-          "description": "Indicates whether the popup displays its content. If `true`, only the header displays.",
+          "description": "Indicates whether the component displays its content. If `true`, only the header displays.\nThis property is only honored if [`showCollapsed`](#showCollapsed) is `true`.",
           "values": []
         },
         {
           "name": "content",
-          "description": "The content of the Features component. When set directly on the Popup, this content is\nstatic and cannot use fields to set content templates. To set a template\nfor the content based on field or attribute names, see\n[PopupTemplate.content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).",
+          "description": "The content of the Features component. When set directly on the component, this content is\nstatic and cannot use fields to set content templates. To set a template\nfor the content based on field or attribute names, see\n[PopupTemplate.content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).",
+          "values": []
+        },
+        {
+          "name": "default-popup-template-enabled",
+          "description": "Enables automatic creation of a popup template for layers that have popups enabled but no\npopupTemplate defined.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#defaultPopupTemplateEnabled)",
           "values": []
         },
         {
           "name": "feature-menu-open",
-          "description": "This property enables showing the list of features.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuOpen)",
+          "description": "This property enables multiple features in the component to display in a list rather than displaying the first selected feature.\nSetting this to `true` allows the user to scroll through the list of features.\nThis value will only be honored if [`initialDisplayMode`](#initialDisplayMode) is set to \"feature\".",
           "values": []
         },
         {
           "name": "feature-menu-title",
-          "description": "The title to display on the widget while viewing the feature menu.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuTitle)",
+          "description": "Sets the title to display on the component while viewing the feature menu.",
           "values": []
         },
         {
@@ -4020,7 +4025,7 @@
         },
         {
           "name": "features-per-page",
-          "description": "The number of features to fetch at one time.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featuresPerPage)",
+          "description": "The number of features to fetch at one time.",
           "values": []
         },
         {
@@ -4030,7 +4035,7 @@
         },
         {
           "name": "heading-level",
-          "description": "Indicates the heading level to use for the [title](#title) of the component.\nBy default, the title is rendered\nas a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the component's placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
+          "description": "Indicates the heading level to use for the [heading](#heading) of the component.\nBy default, the heading is rendered\nas a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the component's placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
           "values": [
             {
               "name": "1"
@@ -4054,42 +4059,47 @@
         },
         {
           "name": "hide-action-bar",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the action bar that holds the feature's [actions](#actions).",
           "values": []
         },
         {
           "name": "hide-close-button",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the close button in the component.",
           "values": []
         },
         {
           "name": "hide-feature-list-layer-title",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the group heading for a list of multiple features.",
           "values": []
         },
         {
           "name": "hide-feature-menu-heading",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the feature menu heading and description in the component's feature menu list.",
           "values": []
         },
         {
           "name": "hide-feature-navigation",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the feature pagination in the component.\nThis allows the user to scroll through various [selected features](#features) using pagination arrows.",
           "values": []
         },
         {
           "name": "hide-flow",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Determines whether the component should be shown within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/) or if the flow component should be excluded.\nThe component will be displayed within its original flow component if set to `false`.\nThe flow component will be omitted from the widget if set to `true`.\nTo place the component into an existing Calcite flow component, set this property to `false`.",
           "values": []
         },
         {
           "name": "hide-heading",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the component's [heading](#heading).",
           "values": []
         },
         {
           "name": "hide-spinner",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to hide the component's loading spinner.",
+          "values": []
+        },
+        {
+          "name": "highlight-disabled",
+          "description": "Highlight the selected feature using one of the [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html) defined in the view's\n[highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#highlights) collection.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#highlightEnabled)",
           "values": []
         },
         {
@@ -4099,7 +4109,7 @@
         },
         {
           "name": "include-default-actions",
-          "description": "Indicates whether or not to include [defaultActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#defaultActions).\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#includeDefaultActions)",
+          "description": "Indicates whether to include the [defaultActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#includeDefaultActions) in the component.",
           "values": []
         },
         {
@@ -4121,6 +4131,7 @@
         },
         {
           "name": "position",
+          "description": "**Deprecated**: since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
           "values": [
             {
               "name": "bottom-leading"
@@ -4153,6 +4164,7 @@
         },
         {
           "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.",
           "values": []
         },
         {
@@ -4162,7 +4174,7 @@
         },
         {
           "name": "show-collapse-button",
-          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "description": "Indicates whether to show the collapse button in the component.",
           "values": []
         },
         {
@@ -4179,7 +4191,12 @@
         },
         {
           "name": "time-zone",
-          "description": "Dates and times displayed in the component will be displayed in this time zone. By default this time zone is\ninherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#timeZone) if the [view](#view) property is set. When a MapView is not associated with the component\nthen the property will fallback to the `system` time zone.\n\n**Possible Values**\n\nValue | Description |\n----- | ----------- |\nsystem  | Dates and times will be displayed in the timezone of the device or browser.\nunknown | Dates and time are not adjusted for any timezone.\nSpecified IANA timezone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).",
+          "description": "Dates and times displayed in the component will be displayed in this time zone. By default this time zone is\ninherited from [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#timeZone) if the [view](#view) property is set. When a MapView is not associated with the component\nthen the property will fallback to the `system` time zone.\n\n**Possible Values**\n- `system`: Dates and times will be displayed in the timezone of the device or browser.\n- `unknown`: Dates and time are not adjusted for any timezone.\n- `Specified IANA timezone`: Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).",
+          "values": []
+        },
+        {
+          "name": "visible",
+          "description": "Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open in the view.\nUse the property to check if the popup is visible and is not",
           "values": []
         }
       ],
@@ -5030,7 +5047,7 @@
     },
     {
       "name": "arcgis-legend",
-      "description": "### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
+      "description": "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\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)](../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)](../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)](../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)](../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)](../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)](../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)](../sample-code/visualization-arcade/)\n\n### Relationship\n\n[![Relationship](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/legend/legend-relationship.png)](../sample-code/visualization-sm-relationship/)\n--\n\n### Events\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
       "attributes": [
         {
           "name": "auto-destroy-disabled",
@@ -5039,11 +5056,12 @@
         },
         {
           "name": "basemap-legend-visible",
-          "description": "Indicates whether to show the [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html) layers in the Legend. If you set this property to\n`true` and specify [layerInfos](#layerInfos), the basemap layers you want included in the legend must also be\nspecified in `layerInfos`.",
+          "description": "Indicates whether to show the [Basemap](https://developers.arcgis.com/javascript/latest/api-reference/esri-Basemap.html) layers in the Legend. If you set this property to\n`true` and specify [layerInfos](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#layerInfos) that include the basemap layers, the basemap will be displayed in the legend.",
           "values": []
         },
         {
           "name": "card-style-layout",
+          "description": "Indicates the layout of the legend when the [legendStyle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#legendStyle) is set to the string value of `\"card\"`.\nThe layout determines how the legend's content is arranged.\n\n[![card-style-layout](https://developers.arcgis.com/javascript/latest/assets/img/components/legend/card-style-layout.png)](../sample-code/legend-card/)",
           "values": [
             {
               "name": "auto"
@@ -5058,7 +5076,7 @@
         },
         {
           "name": "heading-level",
-          "description": "Indicates the heading level to use for the legend title. By default, legend titles\nare rendered as level 3 headings (e.g. `<h3>Legend title</h3>`). Depending on the legend placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
+          "description": "Indicates the heading level to use for the legend title. By default, legend titles are rendered as level 3 headings (e.g. `<h3>Legend title</h3>`). Depending on the legend placement\nin your app, you may need to adjust this heading for proper semantics. This is important for meeting accessibility standards.",
           "values": [
             {
               "name": "1"
@@ -5082,7 +5100,7 @@
         },
         {
           "name": "hide-layers-not-in-current-view",
-          "description": "When `true`, layers will only be shown in the legend if\nthey are visible in the view's extent. When data from a layer\nis not visible in the view, the layer's legend information\nwill be hidden. Only layers that implement the `createQuery()`\nand `queryFeatureCount()` methods are supported by `hideLayersNotInCurrentView`.\n\nTo hide layers completely\nfrom the legend, you should set the `legendEnabled` property of\nthe layer to `false`.",
+          "description": "When `true`, layers will only be shown in the legend if they are visible in the view's extent. When data from a layer\nis not visible in the view, the layer's legend information will be hidden. Only layers that implement the `createQuery()`\nand `queryFeatureCount()` methods are supported by `hideLayersNotInCurrentView`.\n\nTo hide layers completely from the legend, you should set the `legendEnabled` property of the layer to `false`.",
           "values": []
         },
         {
@@ -5092,7 +5110,7 @@
         },
         {
           "name": "ignore-layer-visibility",
-          "description": "Determines whether to respect the properties of the layers in the map that\ncontrol the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).\nBy default, a layer's legend elements **will\nnot render** in the legend given the following conditions:\n\n- The layer's [legendEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#legendEnabled) property\nis set to `false`.\n- If the view's scale is outside the visibility range\ndefined by the layer's [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#minScale) and\n[maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#maxScale) properties.\n\nWhen the `respectLayerVisibility` property of the legend is set to `false`, the legend elements for each\nlayer in the map will always display, thus disregarding the `minScale`, `maxScale`,\nand `legendEnabled` properties for each layer in the map.",
+          "description": "Determines whether to respect the properties of the layers in the map that control the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).\nBy default, a layer's legend elements **will not render** in the legend given the following conditions:\n\n- The layer's [legendEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#legendEnabled) property\nis set to `false`.\n- If the view's scale is outside the visibility range\ndefined by the layer's [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#minScale) and\n[maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#maxScale) properties.\n\nWhen the `ignoreLayerVisibility` property of the legend is set to `true`, the legend elements for each\nlayer in the map will always display, thus disregarding the `minScale`, `maxScale`,\nand `legendEnabled` properties for each layer in the map.",
           "values": []
         },
         {
@@ -5102,7 +5120,7 @@
         },
         {
           "name": "legend-style",
-          "description": "Indicates the style of the legend. The style determines the legend's layout and behavior.\nYou can either specify a string or an object to indicate the style. The known string values are the same values listed in\nthe table within the `type` property.",
+          "description": "Indicates the style of the legend. The style determines the legend's layout and behavior.\nYou can either specify a string or an object to indicate the style. The known string values are the same values listed in\nthe table within the `type` property.\n\n[![legend-style](https://developers.arcgis.com/javascript/latest/assets/img/components/legend/legend-style.png)](../sample-code/legend-card/)",
           "values": [
             {
               "name": "card"
@@ -5112,6 +5130,11 @@
             }
           ]
         },
+        {
+          "name": "loading",
+          "description": "Indicates whether the legend is currently loading.",
+          "values": []
+        },
         {
           "name": "position",
           "description": "**Deprecated**: since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
@@ -5156,348 +5179,31 @@
           "values": []
         },
         {
-          "name": "state",
-          "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#state)",
-          "values": [
-            {
-              "name": "disabled"
-            },
-            {
-              "name": "ready"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/"
-        },
-        {
-          "name": "Legend",
-          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-legend--demo&singleStory=true"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-color-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-color-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-element",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
+          "name": "respect-layer-visibility-disabled",
+          "description": "**Deprecated**: since 4.34 use [ignoreLayerVisibility](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/#ignoreLayerVisibility) instead.. Determines whether to respect the properties of the layers in the map that control the legend's visibility (`minScale`, `maxScale`, `legendEnabled`).\nBy default, a layer's legend elements **will not render** in the legend given the following conditions:\n\n- The layer's [legendEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#legendEnabled) property\nis set to `false`.\n- If the view's scale is outside the visibility range\ndefined by the layer's [minScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#minScale) and\n[maxScale](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#maxScale) properties.\n\nWhen the `respectLayerVisibilityDisabled` property of the legend is set to `false`, the legend elements for each\nlayer in the map will always display, thus disregarding the `minScale`, `maxScale`,\nand `legendEnabled` properties for each layer in the map.",
           "values": []
         },
         {
-          "name": "heading-level",
-          "values": [
-            {
-              "name": "1"
-            },
-            {
-              "name": "2"
-            },
-            {
-              "name": "3"
-            },
-            {
-              "name": "4"
-            },
-            {
-              "name": "5"
-            },
-            {
-              "name": "6"
-            }
-          ]
-        },
-        {
-          "name": "stacked",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-element/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-size-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "has-indicators",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-size-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-univariate-above-and-below-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-univariate-above-and-below-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-univariate-color-size-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-univariate-color-size-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-card-view",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "heading-level",
-          "values": [
-            {
-              "name": "1"
-            },
-            {
-              "name": "2"
-            },
-            {
-              "name": "3"
-            },
-            {
-              "name": "4"
-            },
-            {
-              "name": "5"
-            },
-            {
-              "name": "6"
-            }
-          ]
-        },
-        {
-          "name": "layout",
-          "description": "The rendering layout.",
-          "values": [
-            {
-              "name": "auto"
-            },
-            {
-              "name": "side-by-side"
-            },
-            {
-              "name": "stack"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-card-view/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-color-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-color-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-element",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-element/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-size-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-size-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-univariate-above-and-below-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-univariate-above-and-below-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-univariate-color-size-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-univariate-color-size-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-classic-view",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "heading-level",
-          "values": [
-            {
-              "name": "1"
-            },
-            {
-              "name": "2"
-            },
-            {
-              "name": "3"
-            },
-            {
-              "name": "4"
-            },
-            {
-              "name": "5"
-            },
-            {
-              "name": "6"
-            }
-          ]
-        }
-      ],
-      "references": [
-        {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-classic-view/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-relationship-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [
-        {
-          "name": "css-effect-filter",
-          "values": []
-        },
-        {
-          "name": "opacity",
-          "values": []
+          "name": "state",
+          "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Legend-LegendViewModel.html#state)",
+          "values": [
+            {
+              "name": "disabled"
+            },
+            {
+              "name": "ready"
+            }
+          ]
         }
       ],
       "references": [
         {
           "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-relationship-ramp/"
-        }
-      ]
-    },
-    {
-      "name": "arcgis-legend-spike-ramp",
-      "description": "### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",
-      "attributes": [],
-      "references": [
+          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend/"
+        },
         {
-          "name": "Docs",
-          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-legend-spike-ramp/"
+          "name": "Legend",
+          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-legend--demo&singleStory=true"
         }
       ]
     },
@@ -5985,7 +5691,7 @@
         },
         {
           "name": "spatial-reference-locked",
-          "description": "Indicates if the view's spatialReference can be changed after it is ready.\nThe default is false indicating the view's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the view's spatial reference\nwill be disabled in [ArcgisBasemapGallery](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-gallery/) and [ArcgisBasemapToggle](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-basemap-toggle/) components and the view spatialReference cannot be changed at runtime.",
+          "description": "Indicates if the view's spatialReference can be changed after it is ready.\nThe default is false indicating the view's spatialReference can be changed at runtime.\nWhen true, basemaps with spatial references that do not match the view'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 view spatialReference cannot be changed at runtime.",
           "values": []
         },
         {
@@ -6489,6 +6195,208 @@
         }
       ]
     },
+    {
+      "name": "arcgis-popup",
+      "description": "<a name=\"overview\"></a>\n\n## Overview\nThe Popup widget 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<a name=\"loading-the-popup\"></a>\n\n## Loading the Popup\nAt [version 4.27](../release-notes#popup-performance-improvements), the view's default popup is loaded on demand when [`popupEnabled`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popupEnabled) is set to `true` (which is the default), when the [`openPopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#openPopup) method is called,\nor when some widgets need the popup, such as [Search](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html). Please see the read more section below for details on how to manually load the popup or take\nadvantage of the API lazy loading.\n\n>>> esri-read-more\n\nThe Popup class can be loaded when the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) is instantiated, however, this does not take advantage of the performance improvements of lazily loading the popup.\n```js\n// Create a new MapView\nconst view = new MapView({\n// set the popup property to a new instance of Popup\n  popup: new Popup(...)\n});\n```\nTo utilize the performance improvements and the API automatically lazy loading the popup:\n- Set options/properties on the view's popup:\n  ```js\n  const view = MapView({\n    popup: {\n      dockEnabled: true,\n      dockOptions: {\n        position: true,\n        ...\n      }\n    }\n  });\n  ```\n- Use [`popupEnabled`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popupEnabled) to prevent the popup appearing when the user clicks the view.\n  ```js\n  // The popup doesn't show for features on selection, but will on Search results and when `openPopup()` is called.\n  view.popupEnabled = false;\n  ```\n- Use [`openPopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#openPopup) instead of [`open()`](#open) and [`closePopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#closePopup) instead of [`close()`](#close).\n  ```js\n  // A deprecation warning is prompted if the popup isn't created\n  // and calls view.openPopup() or view.closePopup() respectively under the hood.\n  view.popup.open(...);\n  view.popup.close(...);\n\n  // Opens or closes the popup on the View.\n  view.openPopup(...);\n  view.closePopup(...);\n  ```\n- Use [reactiveUtils](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html) to watch properties on the popup and its view model instead of the [`watch()`](#watch) method.\n  ```js\n  // This will throw an error that watch() is not a method\n  // since the popup hasn't been created yet.\n  view.popup.watch(\"selectedFeature\", ...)\n\n  // Call reactiveUtils.watch() on popup properties with optional chaining.\n  reactiveUtils.watch(() => view.popup?.selectedFeature, ...);\n  ```\n- Use the [`reactiveUtils.when()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#when) method to check when the popup instance is created. Once its created, then it's properties or methods can be accessed and called.\n  ```js\n  // This will throw an error that actions is not a property.\n  view.popup.actions.push(...);\n\n  // Wait for the popup to load before accessing properties.\n  reactiveUtils.when(() => view.popup?.actions, ()=>{\n    view.popup.actions.push(...);\n  });\n  ```\n\n>>>\n\n<a name=\"popup-ui\"></a>\n\n## Popup UI\nAll [Views](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) contain a default popup.\nThis popup can display generic content, which is set in its [title](#title)\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](../assets/img/apiref/widgets/popup/popup-basic.png)](../sample-code/sandbox/?sample=intro-popup)\n\nIn the image above, the text \"Marriage in New York County Census Tract 8\" is the popup's `title`. The remaining text is\nits `content`. A dock button ![popup-dock-btn](../assets/img/apiref/widgets/popup/popup-dock.png) may also be available in the\ntop right corner of the popup. This allows 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.\n\nPopups can also contain [actions](#actions) that act like buttons,\nwhich execute a function defined by the developer when clicked.\nBy default, every popup has a \"Zoom to\" action ![popupTemplate-zoom-action](../assets/img/apiref/widgets/popup/popuptemplate-zoom-action.png)\nthat allows users to zoom to the selected feature. See the [actions](#actions)\nproperty for information about adding custom actions to a popup.\n\nThe Popup widget is tied to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html), whether it's docked or anchored to the selected feature.\nIf wanting to utilize the Popup functionality outside of the View, the [Features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html) widget can be used to display the same content\nin its own container that's not tied to the View.\n\n<a name=\"popup-and-popuptemplate\"></a>\n\n## Popup and PopupTemplate\n[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) is closely related to Popup, but is 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). It allows 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\nPopupTemplate, the popup will display the content\ndefined in the PopupTemplate when the feature is clicked. The 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. For more information about Popup\nand how it relates to [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) see the samples listed below.\n--\n\n### Events\n- **arcgisClose** - Emitted when the component's close button is clicked.\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisTriggerAction**\n\n### Methods\n- `clear(): Promise<void>` - Removes [promises](#promises), [features](#features), [content](#content),\n[title](#title) and [location](#location) from the Popup.\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.\n- `fetchFeatures(screenPoint: __esri.ScreenPoint, options?: FetchFeaturesOptions): Promise<__esri.FetchPopupFeaturesResult>` - Use this method to return feature(s) at a given screen location.\nThese features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html)\nin the [view](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). In order to use this, a layer must already have an\nassociated [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html#popupEnabled).\nThese features can then be used within a custom [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html)\nor [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html) widget experience.\nOne example could be a custom side panel that displays feature-specific information based on\nan end user's click location. This method allows a developer the ability to\ncontrol how the input location is handled, and then subsequently, what to do with the results.\n- `next(): Promise<FeaturesViewModel>` - Selects the feature at the next index in relation to the selected feature.\n- `open(options?: __esri.FeaturesViewModelOpenOptions): Promise<void>` - Opens the popup at the given location with content defined either explicitly with `content`\nor driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features. This method sets\nthe popup's [visible](#visible) property to `true`. Users can alternatively open the popup\nby directly setting the [visible](#visible) property to `true`.\n\n::: esri-md class=\"warning\"\nThe popup will only display if\nthe view's size constraints in [dockOptions](#dockOptions) are met or the [location](#location)\nproperty is set to a geometry.\n:::\n- `previous(): Promise<FeaturesViewModel>` - Selects the feature at the previous index in relation to the selected feature.\n- `setFocus(): Promise<void>` - Use this method to give focus to the Widget if the widget is able to be focused.\n- `triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>` - Triggers the [trigger-action](#event-trigger-action) event and executes the [action](#actions)\nat the specified index in the [actions](#actions) array.",
+      "attributes": [
+        {
+          "name": "alignment",
+          "description": "Position of the popup in relation to the selected feature. The default behavior\nis to display above the feature and adjust if not enough room. If needing\nto explicitly control where the popup displays in relation to the feature, choose\nan option besides `auto`.",
+          "values": [
+            {
+              "name": "auto"
+            },
+            {
+              "name": "bottom-center"
+            },
+            {
+              "name": "bottom-end"
+            },
+            {
+              "name": "bottom-left"
+            },
+            {
+              "name": "bottom-right"
+            },
+            {
+              "name": "bottom-start"
+            },
+            {
+              "name": "top-center"
+            },
+            {
+              "name": "top-end"
+            },
+            {
+              "name": "top-left"
+            },
+            {
+              "name": "top-right"
+            },
+            {
+              "name": "top-start"
+            }
+          ]
+        },
+        {
+          "name": "auto-close-enabled",
+          "description": "This closes the popup when the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) camera or [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html) changes.",
+          "values": []
+        },
+        {
+          "name": "auto-destroy-disabled",
+          "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/#destroy) method when you are done to\nprevent memory leaks.",
+          "values": []
+        },
+        {
+          "name": "content",
+          "description": "The content of the popup. When set directly on the Popup, this content is\nstatic and cannot use fields to set content templates. To set a template\nfor the content based on field or attribute names, see\n[PopupTemplate.content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).",
+          "values": []
+        },
+        {
+          "name": "default-popup-template-enabled",
+          "description": "Enables automatic creation of a popup template for layers that have popups enabled but no\npopupTemplate defined. Automatic popup templates are supported for layers that\nsupport the `createPopupTemplate` method. (Supported for\n[FeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-FeatureLayer.html),\n[GeoJSONLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-GeoJSONLayer.html),\n[OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-OGCFeatureLayer.html),\n[SceneLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-SceneLayer.html),\n[CSVLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-CSVLayer.html),\n[PointCloudLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-PointCloudLayer.html),\n[StreamLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-StreamLayer.html),\n[ImageryLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ImageryLayer.html), and\n[VoxelLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VoxelLayer.html)).\n\n::: esri-md class=\"warning\"\n* Starting with version 4.12, [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) content can no longer be set using a\nwildcard, e.g. `*`. Instead, set the `defaultPopupTemplateEnabled` property to `true`.\n* Starting with 4.16, the default popup has been improved to no longer display system\n[fields](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-FieldInfo.html)\nthat do not hold significant value, e.g. `Shape__Area` and `Shape__Length` are two fields that\nno longer display.\n* Starting with version 4.28, `date` fields are formatted using the `short-date-short-time` preset [dateFormat](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-support-FieldInfoFormat.html#dateFormat)\nrather than `long-month-day-year` in default [popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) created by setting the `defaultPopupTemplateEnabled` property to `true`.\nFor example, previously a date that may have appeared as `\"December 30, 1997\"` will now appear as `\"12/30/1997 6:00 PM\"`.\n:::",
+          "values": []
+        },
+        {
+          "name": "dock-enabled",
+          "description": "Indicates whether the placement of the popup is docked to the side of the view.\n\nDocking the popup allows for a better user experience, particularly when opening\npopups in apps on mobile devices. When a popup is \"dockEnabled\" it means the popup no\nlonger points to the [selected feature](#selectedFeature) or the [location](#location)\nassigned to it. Rather it is attached to a side, the top, or the bottom of the view.\n\nSee [dockOptions](#dockOptions) to override default options related to docking the popup.",
+          "values": []
+        },
+        {
+          "name": "feature-menu-open",
+          "description": "This property enables showing the list of features.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuOpen)",
+          "values": []
+        },
+        {
+          "name": "heading",
+          "description": "The title of the popup. This can be set generically on the popup no\nmatter the features that are selected. If the [selected feature](#selectedFeature)\nhas a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html), then the title set in the\ncorresponding template is used here.",
+          "values": []
+        },
+        {
+          "name": "heading-level",
+          "description": "Indicates the heading level to use for the [title](#title) of the popup.\nBy default, the title is rendered\nas a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the widget's placement\nin your app, you may need to adjust this heading for proper semantics. This is\nimportant for meeting accessibility standards.",
+          "values": [
+            {
+              "name": "1"
+            },
+            {
+              "name": "2"
+            },
+            {
+              "name": "3"
+            },
+            {
+              "name": "4"
+            },
+            {
+              "name": "5"
+            },
+            {
+              "name": "6"
+            }
+          ]
+        },
+        {
+          "name": "hide-action-bar",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-close-button",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-collapse-button",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-feature-list-layer-title",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-feature-menu-heading",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-feature-navigation",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-heading",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "hide-spinner",
+          "description": "This property provides the ability to turn individual elements of the component's display on/off.",
+          "values": []
+        },
+        {
+          "name": "highlight-disabled",
+          "description": "Highlight the selected popup feature using the [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#highlights)\nset on the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or the [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#highlights)\nset on the [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).",
+          "values": []
+        },
+        {
+          "name": "initial-display-mode",
+          "description": "Indicates whether to initially display a list of features, or the content for one feature.",
+          "values": [
+            {
+              "name": "feature"
+            },
+            {
+              "name": "list"
+            }
+          ]
+        },
+        {
+          "name": "label",
+          "description": "The widget's default label.",
+          "values": []
+        },
+        {
+          "name": "reference-element",
+          "values": []
+        },
+        {
+          "name": "selected-feature-index",
+          "description": "Index of the feature that is [selected](#selectedFeature). When [features](#features) are set,\nthe first index is automatically selected.",
+          "values": []
+        },
+        {
+          "name": "state",
+          "description": "The view model's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#state)",
+          "values": [
+            {
+              "name": "disabled"
+            },
+            {
+              "name": "ready"
+            }
+          ]
+        },
+        {
+          "name": "visible",
+          "description": "Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open in the view.\nUse the property to check if the popup is visible and is not",
+          "values": []
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/"
+        },
+        {
+          "name": "Popup",
+          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-popup--demo&singleStory=true"
+        }
+      ]
+    },
     {
       "name": "arcgis-print",
       "description": "The Print component connects your application with a [printing service](https://enterprise.arcgis.com/en/portal/latest/administer/windows/configure-the-portal-to-print-maps.htm) to allow the map to be printed.\nIt takes advantage of server-side, high-quality, full cartographic print functionality using the ExportWebMap service of ArcGIS,\nwhich can be configured with custom layout templates. One is provided that shows the map only, while another provides a layout with legend, etc.\nThe Print component works with the [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) module, which generates a printer-ready version of the map.\n\nThe Print component uses the ArcGIS Online print service by default, but it can be configured to use a custom print service with the [printServiceUrl](#printServiceUrl) property.\nThe component can preserve map scale or map extent in the printout. By default, the map extent is preserved. Use\n[TemplateOptions.scaleEnabled](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Print-TemplateOptions.html#scaleEnabled) to preserve scale instead.\n\nThe Print component prints a localized date for all [layouts](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#layout)\nexcept `map-only`. If using a custom print service, then `customTextElements` are supported for each print\ntemplate. Values found there will be populated in the Print component under `Advanced options`. These values can\nbe overwritten in the Print component UI, or programmatically using the\n[templateCustomTextElements](#templateCustomTextElements) property.\n\nFor more information about printing with the `MAP_ONLY` layout, please see\n[exportOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-support-PrintTemplate.html#exportOptions).\n\n**Known limitations**\n\nSee [print](https://developers.arcgis.com/javascript/latest/api-reference/esri-rest-print.html) for a detailed list of known limitations.\n\n```html\n<arcgis-map item-id=\"45725ba7d9fb47a0925398919b13d1fa\">\n <arcgis-print slot=\"top-right\"></arcgis-print>\n</arcgis-map>\n```\n\n```js\n// get a reference to the component\nconst components = document.querySelectorAll(\"arcgis-print\");\n\nconst portal = new Portal({\n url: \"https://user.maps.arcgis.com/sharing\",\n authMode: \"immediate\",\n authorizedCrossOriginDomains: [\"https://user.maps.arcgis.com\"],\n});\n\ncomponents.forEach((component) => {\n component.portal = portal;\n});\n```\n--\n\n### Events\n- **arcgisComplete** - Emitted when the component is complete.\n- **arcgisPropertyChange** - Emitted when the value of a property is changed. Use this to listen to changes to properties.\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n- **arcgisSubmit** - Emitted when the component is submitted.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
@@ -8709,6 +8617,70 @@
         }
       ]
     },
+    {
+      "name": "arcgis-utility-network-trace-analysis",
+      "description": "### Events\n- **arcgisPropertyChange**\n- **arcgisReady** - Emitted when the component associated with a map or scene view is ready to be interacted with.\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.\n- `destroy(): Promise<void>` - Permanently destroy the component.",
+      "attributes": [
+        {
+          "name": "allow-editing-disabled",
+          "values": []
+        },
+        {
+          "name": "auto-destroy-disabled",
+          "description": "If true, the component will not be destroyed automatically when it is\ndisconnected from the document. This is useful when you want to move the\ncomponent to a different place on the page, or temporarily hide it. If this\nis set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/#destroy) method when you are done to\nprevent memory leaks.",
+          "values": []
+        },
+        {
+          "name": "closable",
+          "values": []
+        },
+        {
+          "name": "icon",
+          "values": []
+        },
+        {
+          "name": "label",
+          "values": []
+        },
+        {
+          "name": "mode",
+          "values": []
+        },
+        {
+          "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.",
+          "values": []
+        },
+        {
+          "name": "state",
+          "description": "The viewModel's state.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-UtilityNetworkTraceAnalysis-UtilityNetworkTraceAnalysisViewModel.html#state)",
+          "values": [
+            {
+              "name": "disabled"
+            },
+            {
+              "name": "executing"
+            },
+            {
+              "name": "loading"
+            },
+            {
+              "name": "ready"
+            }
+          ]
+        }
+      ],
+      "references": [
+        {
+          "name": "Docs",
+          "url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/"
+        },
+        {
+          "name": "Utility Network Trace Analysis",
+          "url": "https://developers.arcgis.com/javascript/latest/storybook/map-components/?path=/story/arcgis-utility-network-trace-analysis--demo&singleStory=true"
+        }
+      ]
+    },
     {
       "name": "arcgis-result-feature-list",
       "description": "This is a sub-component used by the **ArcgisUtilityNetworkTraceAnalysis** component.\n\nThis sub-component takes trace result elements as input.\nIt displays the layers the elements are from, with a count of elements on each layer.\nA `UtilityNetwork` and list of layers is required to display feature layer names.\n--\n\n### Events\n- **arcgisPropertyChange**\n\n### Methods\n- `componentOnReady(): Promise<void>` - Create a promise that resolves once component is fully loaded.",