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

package/dist/docs/web-types.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/JetBrains/web-types/master/schema/web-types.json",
   "name": "@arcgis/map-components",
-  "version": "4.34.0-next.125",
+  "version": "4.34.0-next.126",
   "description-markup": "markdown",
   "contributions": {
     "html": {
@@ -7066,7 +7066,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 [ArcgisMap](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [ArcgisScene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/).\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 [ArcgisMap](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 [ArcgisFeature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-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- **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.\nSee the example below for details of how this works.\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>` - This is a convenience method to closes 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.",
           "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/",
           "attributes": [
             {
@@ -7079,7 +7079,7 @@
             },
             {
               "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`.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7087,14 +7087,14 @@
             },
             {
               "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).",
               "value": {
                 "type": "string"
               }
             },
             {
               "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\".",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7102,7 +7102,7 @@
             },
             {
               "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.",
               "value": {
                 "type": "string"
               }
@@ -7117,7 +7117,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.",
               "default": "20",
               "value": {
                 "type": "number"
@@ -7147,7 +7147,7 @@
             },
             {
               "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).",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7155,7 +7155,7 @@
             },
             {
               "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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7163,7 +7163,7 @@
             },
             {
               "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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7171,7 +7171,7 @@
             },
             {
               "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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7179,7 +7179,7 @@
             },
             {
               "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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7187,7 +7187,7 @@
             },
             {
               "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`.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7195,7 +7195,7 @@
             },
             {
               "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).",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7203,7 +7203,7 @@
             },
             {
               "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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7218,7 +7218,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.",
               "default": "true",
               "value": {
                 "type": "boolean"
@@ -7244,6 +7244,7 @@
             },
             {
               "name": "position",
+              "description": "**Deprecated**: since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead.. ",
               "value": {
                 "type": [
                   "\"bottom-leading\"",
@@ -7260,6 +7261,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.",
               "value": {
                 "type": "string"
               }
@@ -7273,7 +7275,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.",
               "default": "false",
               "value": {
                 "type": "boolean"
@@ -7292,7 +7294,7 @@
             },
             {
               "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\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).",
               "value": {
                 "type": "string"
               }
@@ -7311,19 +7313,20 @@
             },
             {
               "name": "arcgisTriggerAction",
-              "type": "FeaturesViewModelTriggerActionEvent"
+              "type": "FeaturesViewModelTriggerActionEvent",
+              "description": "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.\nSee the example below for details of how this works."
             }
           ],
           "js": {
             "properties": [
               {
                 "name": "actions",
-                "description": "[Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions)",
+                "description": "[Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects displayed in the action bar.\nEach action may be executed by clicking the icon or image symbolizing them.\nBy default, every component has a `Zoom To` action styled with a magnifying glass icon.\nWhen this icon is clicked, the map zooms in four LODs and centers on the selected feature.\nThis default action can be removed by setting [`includeDefaultActions`](#includedefaultactions) to `false`, or by setting the [overwriteActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#overwriteActions) property to `true` in the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\nThe order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html).\nThe [`arcgisTriggerAction`](#arcgistriggeraction) event fires each time an action is clicked.\nActions are defined with the properties listed in the [ActionButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [ActionToggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) class.",
                 "type": "Collection<ActionButton | ActionToggle>"
               },
               {
                 "name": "active",
-                "description": "Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#waitingForResult).",
+                "description": "Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#waitingForResult) for results.",
                 "type": "boolean"
               },
               {
@@ -7333,22 +7336,22 @@
               },
               {
                 "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`.",
                 "type": "boolean"
               },
               {
                 "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).",
                 "type": "HTMLElement | Widget | string"
               },
               {
                 "name": "featureMenuOpen",
-                "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\".",
                 "type": "boolean"
               },
               {
                 "name": "featureMenuTitle",
-                "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.",
                 "type": "string"
               },
               {
@@ -7358,22 +7361,22 @@
               },
               {
                 "name": "features",
-                "description": "An array of features associated with the Features component. Each graphic in this array must\nhave a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) set. They may share the same\n[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) or have unique\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) depending on their attributes.\nThe [content](#content) and [title](#title)\nof the component is set based on the `content` and `title` properties of each graphic's respective\n[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\n\nWhen more than one graphic exists in this array, the current content of the\nFeatures component is set based on the value of the [selected feature](#selectedFeature).\n\nThis value is `null` if no features are associated with the component.",
+                "description": "An array of features associated with the Features component. Each graphic in this array must\nhave a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) set. They may share the same\n[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) or have unique\n[PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) depending on their attributes.\nThe [content](#content) and [heading](#heading)\nof the component is set based on the `content` and `title` properties of each graphic's respective\n[PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).\n\nWhen more than one graphic exists in this array, the current content of the\ncomponent is set based on the value of the [selected feature](#selectedfeature).\n\nThis value is `null` if no features are associated with the component.",
                 "type": "Array<Graphic>"
               },
               {
                 "name": "featuresPerPage",
-                "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.",
                 "type": "number"
               },
               {
                 "name": "featureViewModelAbilities",
-                "description": "Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#Abilities) that can be used when querying and displaying content.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureViewModelAbilities)",
+                "description": "Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#Abilities) that can be used when querying and displaying content.",
                 "type": "Abilities"
               },
               {
                 "name": "goToOverride",
-                "description": "This function provides the ability to override either the\n[MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or\n[SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.\n\n[Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#goToOverride)",
+                "description": "This function provides the ability to override either the [arcgis-map.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#goTo) or [arcgis-scene.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) methods.",
                 "type": "(((view: MapView | SceneView, goToParameters: GoToParameters) => void))"
               },
               {
@@ -7393,42 +7396,42 @@
               },
               {
                 "name": "hideActionBar",
-                "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).",
                 "type": "boolean"
               },
               {
                 "name": "hideCloseButton",
-                "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.",
                 "type": "boolean"
               },
               {
                 "name": "hideFeatureListLayerTitle",
-                "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.",
                 "type": "boolean"
               },
               {
                 "name": "hideFeatureMenuHeading",
-                "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.",
                 "type": "boolean"
               },
               {
                 "name": "hideFeatureNavigation",
-                "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.",
                 "type": "boolean"
               },
               {
                 "name": "hideFlow",
-                "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`.",
                 "type": "boolean"
               },
               {
                 "name": "hideHeading",
-                "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).",
                 "type": "boolean"
               },
               {
                 "name": "hideSpinner",
-                "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.",
                 "type": "boolean"
               },
               {
@@ -7438,7 +7441,7 @@
               },
               {
                 "name": "includeDefaultActions",
-                "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.",
                 "type": "boolean"
               },
               {
@@ -7472,11 +7475,12 @@
               },
               {
                 "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": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string"
               },
               {
                 "name": "selectedDrillInFeature",
-                "description": "The feature that the component has drilled into.\nThis feature is either associated with the selected feature in a [relationship](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html) or [utility](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html).",
+                "description": "The feature that the component has drilled into.\nThis feature is either associated with the selected feature in a [relationship](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html) or [utility network](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html) element.",
                 "type": "Graphic"
               },
               {
@@ -7486,7 +7490,7 @@
               },
               {
                 "name": "selectedFeatureComponent",
-                "description": "Returns a reference to the current [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Feature.html).\nThis is useful if needing to get a reference to the Feature component in order to make any changes to it.",
+                "description": "Returns a reference to the current [ArcgisFeature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) component.\nThis is useful if needing to get a reference to the Feature component in order to make any changes to it.",
                 "type": "HTMLArcgisFeatureElement"
               },
               {
@@ -7496,7 +7500,7 @@
               },
               {
                 "name": "showCollapseButton",
-                "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.",
                 "type": "boolean"
               },
               {
@@ -7511,11 +7515,12 @@
               },
               {
                 "name": "timeZone",
-                "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\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).",
                 "type": "string"
               },
               {
                 "name": "view",
+                "description": "A reference to the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).\nThe Features component requires a `view` to be set if:\n- The [features](#features) have a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-ExpressionInfo.html) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) that may use [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) or reference the `$map` profile variable (i.e. access data from layers within a map). Alternatively, set the [`map`](#map) property.\n- Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html) or [bin](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html)).\n- Values from `date` and `timestamp-offset` fields should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#timeZone).\nAlternatively, set the [`timeZone`](#timeZone) property.\n- Using the [fetchFeatures](#fetchFeatures) method or the `fetchFeatures` option in the [`open`](#open) method.\n- Using the `Zoom to` default action. If the `view` is not specified, set the [includeDefaultActions](#includeDefaultActions) property to `false` to remove this default action.",
                 "type": "MapView | SceneView"
               }
             ],
@@ -7532,7 +7537,8 @@
               },
               {
                 "name": "arcgisTriggerAction",
-                "type": "FeaturesViewModelTriggerActionEvent"
+                "type": "FeaturesViewModelTriggerActionEvent",
+                "description": "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.\nSee the example below for details of how this works."
               }
             ]
           }
@@ -17170,6 +17176,138 @@
             ]
           }
         },
+        {
+          "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.",
+          "doc-url": "https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-utility-network-trace-analysis/",
+          "attributes": [
+            {
+              "name": "allow-editing-disabled",
+              "default": "false",
+              "value": {
+                "type": "boolean"
+              }
+            },
+            {
+              "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.",
+              "default": "false",
+              "value": {
+                "type": "boolean"
+              }
+            },
+            {
+              "name": "closable",
+              "default": "false",
+              "value": {
+                "type": "boolean"
+              }
+            },
+            {
+              "name": "icon",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "label",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "name": "mode",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "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.",
+              "value": {
+                "type": "string"
+              }
+            },
+            {
+              "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)",
+              "value": {
+                "type": [
+                  "\"disabled\"",
+                  "\"executing\"",
+                  "\"loading\"",
+                  "\"ready\""
+                ]
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "arcgisPropertyChange",
+              "type": "never"
+            },
+            {
+              "name": "arcgisReady",
+              "type": "void",
+              "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
+            }
+          ],
+          "js": {
+            "properties": [
+              {
+                "name": "allowEditingDisabled",
+                "type": "boolean"
+              },
+              {
+                "name": "autoDestroyDisabled",
+                "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.",
+                "type": "boolean"
+              },
+              {
+                "name": "closable",
+                "type": "boolean"
+              },
+              {
+                "name": "icon",
+                "type": "string"
+              },
+              {
+                "name": "label",
+                "type": "string"
+              },
+              {
+                "name": "messageOverrides",
+                "description": "Replace localized message strings with your own strings.\n\n_**Note**: Individual message keys may change between releases._",
+                "type": "Record<string, unknown>"
+              },
+              {
+                "name": "mode",
+                "type": "string"
+              },
+              {
+                "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": "HTMLArcgisLinkChartElement | HTMLArcgisMapElement | HTMLArcgisSceneElement | string"
+              },
+              {
+                "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)",
+                "type": "\"disabled\" | \"executing\" | \"loading\" | \"ready\""
+              }
+            ],
+            "events": [
+              {
+                "name": "arcgisPropertyChange",
+                "type": "never"
+              },
+              {
+                "name": "arcgisReady",
+                "type": "void",
+                "description": "Emitted when the component associated with a map or scene view is ready to be interacted with."
+              }
+            ]
+          }
+        },
         {
           "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.",

package/dist/index.d.ts

@@ -70,6 +70,7 @@ import type { ArcgisTimeZoneLabel } from "./components/arcgis-time-zone-label";
 import type { ArcgisTrack } from "./components/arcgis-track";
 import type { ArcgisUtilityNetworkAssociations } from "./components/arcgis-utility-network-associations";
 import type { ArcgisUtilityNetworkTrace } from "./components/arcgis-utility-network-trace";
+import type { ArcgisUtilityNetworkTraceAnalysis } from "./components/arcgis-utility-network-trace-analysis";
 import type { ArcgisResultFeatureList } from "./components/arcgis-result-feature-list";
 import type { ArcgisUtilityNetworkValidateTopology } from "./components/arcgis-utility-network-validate-topology";
 import type { ArcgisValuePicker } from "./components/arcgis-value-picker";
@@ -380,6 +381,11 @@ export interface ArcgisUtilityNetworkTraceCustomEvent<T> extends CustomEvent<T>
   target: HTMLArcgisUtilityNetworkTraceElement;
   currentTarget: HTMLArcgisUtilityNetworkTraceElement;
 }
+export interface ArcgisUtilityNetworkTraceAnalysisCustomEvent<T> extends CustomEvent<T> {
+  detail: T;
+  target: HTMLArcgisUtilityNetworkTraceAnalysisElement;
+  currentTarget: HTMLArcgisUtilityNetworkTraceAnalysisElement;
+}
 export interface ArcgisResultFeatureListCustomEvent<T> extends CustomEvent<T> {
   detail: T;
   target: HTMLArcgisResultFeatureListElement;
@@ -497,6 +503,7 @@ declare global {
     "arcgis-track": HTMLArcgisTrackElement;
     "arcgis-utility-network-associations": HTMLArcgisUtilityNetworkAssociationsElement;
     "arcgis-utility-network-trace": HTMLArcgisUtilityNetworkTraceElement;
+    "arcgis-utility-network-trace-analysis": HTMLArcgisUtilityNetworkTraceAnalysisElement;
     "arcgis-result-feature-list": HTMLArcgisResultFeatureListElement;
     "arcgis-utility-network-validate-topology": HTMLArcgisUtilityNetworkValidateTopologyElement;
     "arcgis-value-picker": HTMLArcgisValuePickerElement;
@@ -1407,6 +1414,19 @@ declare global {
     removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
     removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
   }
+  interface HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap {
+    "arcgisPropertyChange": ArcgisUtilityNetworkTraceAnalysis["arcgisPropertyChange"]["detail"];
+    "arcgisReady": ArcgisUtilityNetworkTraceAnalysis["arcgisReady"]["detail"];
+  }
+
+  interface HTMLArcgisUtilityNetworkTraceAnalysisElement extends ArcgisUtilityNetworkTraceAnalysis {
+    addEventListener<K extends keyof HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap>(type: K, listener: (this: HTMLArcgisUtilityNetworkTraceAnalysisElement, ev: ArcgisUtilityNetworkTraceAnalysisCustomEvent<HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap[K]>) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap>(type: K, listener: (this: HTMLArcgisUtilityNetworkTraceAnalysisElement, ev: ArcgisUtilityNetworkTraceAnalysisCustomEvent<HTMLArcgisUtilityNetworkTraceAnalysisElementEventMap[K]>) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+  }
   interface HTMLArcgisResultFeatureListElementEventMap {
     "arcgisPropertyChange": ArcgisResultFeatureList["arcgisPropertyChange"]["detail"];
   }

package/dist/index.js

@@ -1,7 +1,7 @@
 import { s, g as t } from "./chunks/runtime.js";
 /*! All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/4.34/esri/copyright.txt for details.
-v4.34.0-next.125 */
+v4.34.0-next.126 */
 const a = s, A = t;
 export {
   A as getArcgisAssetPath,