@arcgis/map-components 5.1.0-next.1 → 5.1.0-next.100

package/dist/components/arcgis-features/customElement.d.ts

@@ -1,29 +1,26 @@
 /// <reference path="../../index.d.ts" />
-import type FeaturesViewModel from "@arcgis/core/widgets/Features/FeaturesViewModel.js";
-import type Collection from "@arcgis/core/core/Collection.js";
 import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
+import type Collection from "@arcgis/core/core/Collection.js";
+import type Features from "@arcgis/core/popup/Features.js";
 import type ActionToggle from "@arcgis/core/support/actions/ActionToggle.js";
-import type Graphic from "@arcgis/core/Graphic";
-import type Widget from "@arcgis/core/widgets/Widget.js";
-import type Graphic2 from "@arcgis/core/Graphic.js";
+import type Graphic from "@arcgis/core/Graphic.js";
+import type FeatureAbilities from "@arcgis/core/popup/support/FeatureAbilities.js";
+import type FeatureViewModel from "@arcgis/core/widgets/Feature/FeatureViewModel.js";
 import type Map from "@arcgis/core/Map.js";
 import type SpatialReference from "@arcgis/core/geometry/SpatialReference.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { HeadingLevel } from "../../support/heading.js";
-import type { IconName } from "../../utils/action-utils.js";
+import type { ActionEvent, FetchFeaturesOptions } from "@arcgis/core/widgets/Popup/types.js";
 import type { ArcgisFeature } from "../arcgis-feature/customElement.js";
-import type { ActionEvent, FetchFeaturesOptions } from "@arcgis/core/widgets/Popup/types";
-import type { ScreenPoint } from "@arcgis/core/core/types";
+import type { ArcgisReferenceElement, IconName, HeadingLevel } from "../types.js";
+import type { ScreenPoint } from "@arcgis/core/core/types.js";
+import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/widgets/Popup/types.js";
-import type { Abilities } from "@arcgis/core/widgets/Feature/types.js";
+import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/popup/types.js";
 import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 
 /**
  * The Features component allows users to view a feature's popupTemplate content such as attributes,
- * actions, related records, etc., without having to be tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
+ * actions, related records, etc., without having to be tied to an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
  * This component looks and behaves similarly to the [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) component,
  * however unlike Popup, the Features component can be placed outside of the map or scene component.
  * For example, when features are selected in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/),
@@ -35,27 +32,27 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  *
  * If multiple features are passed into the Features component, the component provides buttons to page though the features and a feature menu that allows the
  * list of features to be displayed so the user can choose which feature content to display in the component. The component also respects
- * feature 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).
+ * feature reduction PopupTemplates for [binning](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#popupTemplate).
  *
  * The 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
  * actions, related records, clustering configuration, etc., then use the [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component.
  *
- * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)
+ * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * @since 4.28
  */
 export abstract class ArcgisFeatures extends LitElement {
   /**
-   * A [collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action button](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. Each action may be executed by clicking the icon or image symbolizing them.
-   * There is a default `Zoom To` action styled with a magnifying glass icon to zoom in four LODs and center the map on the selected feature. This default action can be removed by setting [`includeDefaultActionsDisabled`](#includeDefaultActionsDisabled) to `true`, or by setting the [`overwriteActions`](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).
+   * A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action button](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects. Each action may be executed by clicking the icon or image symbolizing them.
+   * There is a default `Zoom To` action styled with a magnifying glass icon to zoom in four LODs and center the map on the selected feature. This default action can be removed by setting [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#includeDefaultActionsDisabled) to `true`, or by setting the [`overwriteActions`](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
    *
-   * The 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). The [arcgisTriggerAction](#arcgisTriggerAction) event fires each time an action is clicked.
+   * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/). The [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#event-arcgisTriggerAction) event fires each time an action is clicked.
    *
    * @see [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#event-arcgisTriggerAction)
    * @see [Popup actions sample](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
    */
   accessor actions: Collection<PopupAction>;
   /**
-   * 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.
+   * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult) for results.
    *
    * @default false
    */
@@ -76,16 +73,16 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor chartAnimationDisabled: boolean;
+  accessor chartAnimationDisabled: boolean | undefined;
   /**
    * Indicates whether the component displays its content. If `true`, only the header displays.
-   * This property is only honored if [`showCollapsed`](#showCollapsed) is `true`.
+   * This property is only honored if [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton) is `true`.
    *
    * @default false
    */
   accessor collapsed: boolean;
   /**
-   * The content of the component. When set directly on the component, this content is static and cannot use fields to set content templates. To set a template for the content based on field or attribute names, see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#content).
+   * The content of the component. When set directly on the component, this content is static and cannot use fields to set content templates. To set a template for the content based on field or attribute names, see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content).
    *
    * @example
    * ```js
@@ -94,11 +91,11 @@ export abstract class ArcgisFeatures extends LitElement {
    * component.content = "Click a feature on the map to view its attributes";
    * ```
    */
-  accessor content: string | HTMLElement | Widget<any> | null | undefined;
+  accessor content: string | HTMLElement | null | undefined;
   /**
    * Enables automatic creation of a popup template for layers that have popups enabled but no popupTemplate defined. Automatic popup templates are supported for layers that support the `createPopupTemplate` method.
    *
-   * **Note:** 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) rather 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`.
+   * **Note:** Starting with version 4.28, `date` fields are formatted using the `short-date-short-time` preset [dateFormat](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FieldInfoFormat/#dateFormat) rather than `long-month-day-year` in default [popup](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) created by setting the `defaultPopupTemplateEnabled` property to `true`.
    * For example, previously a date that may have appeared as `"December 30, 1997"` will now appear as `"12/30/1997 6:00 PM"`.
    *
    * @default false
@@ -106,13 +103,23 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor defaultPopupTemplateEnabled: boolean;
   /**
-   * The number of {@link ArcgisFeatures#features available in the component.
+   * The heading currently displayed for the selected feature. This value resolves to the [selected feature item's heading](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#effectiveHeading) when available, otherwise it falls back to the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading).
+   *
+   * @since 5.1
+   * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading)
+   * @see [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)
+   */
+  get effectiveHeading(): string | null | undefined;
+  /**
+   * The number of [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) available in the component.
    *
    * @since 4.34
    */
   accessor featureCount: number;
+  /** Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/FeatureViewModel/#Abilities) that can be used when querying and displaying content. */
+  accessor featureItemAbilities: FeatureAbilities | null | undefined;
   /**
-   * This property enables multiple features in the component to display in a list rather than displaying the first selected feature. Setting this to `true` allows the user to scroll through the list of features. This value will only be honored if [`initialDisplayMode`](#initialDisplayMode) is set to "feature".
+   * This property enables multiple features in the component to display in a list rather than displaying the first selected feature. Setting this to `true` allows the user to scroll through the list of features. This value will only be honored if [initialDisplayMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#initialDisplayMode) is set to "feature".
    *
    * @default false
    * @since 4.34
@@ -123,7 +130,7 @@ export abstract class ArcgisFeatures extends LitElement {
    *
    * @since 4.34
    */
-  accessor featureMenuTitle: string | null | undefined;
+  accessor featureMenuTitle: string | undefined;
   /**
    * Indicates whether the feature navigation arrows are displayed at the top of the component.
    * By default, the navigation arrows are displayed at the bottom of the component.
@@ -133,9 +140,9 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor featureNavigationTop: boolean;
   /**
-   * An array of features associated with the component. Each graphic in this array must have a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) set. They may share the same [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) or have unique [PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) depending on their attributes. The [content](#content) and [heading](#heading) of the component is set based on the `content` and `title` properties of each graphic's respective [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).
+   * An array of features associated with the component. Each graphic in this array must have a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) set. They may share the same [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) or have unique [PopupTemplates](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) depending on their attributes. The [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) of the component is set based on the `content` and `title` properties of each graphic's respective [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
    *       
-   * When more than one graphic exists in this array, the current content of the component is set based on the value of the [selected feature](#selectedFeature).
+   * When more than one graphic exists in this array, the current content of the component is set based on the value of the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)).
    *
    * This value is `null` if no features are associated with the component.
    *
@@ -155,15 +162,19 @@ export abstract class ArcgisFeatures extends LitElement {
    * component.features = graphics;
    * ```
    */
-  accessor features: Array<Graphic2>;
+  accessor features: Array<Graphic>;
   /**
    * The number of features to fetch at one time.
    *
    * @default 20
    */
   accessor featuresPerPage: number;
-  /** 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. */
-  accessor featureViewModelAbilities: Abilities | null | undefined;
+  /**
+   * Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/FeatureViewModel/#Abilities) that can be used when querying and displaying content.
+   *
+   * @deprecated since 5.1. Use [featureItemAbilities](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureItemAbilities) instead to set abilities on a per feature basis.
+   */
+  accessor featureViewModelAbilities: FeatureViewModel["abilities"] | null | undefined;
   /**
    * This function provides the ability to override either the [arcgis-map.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#goTo) or [arcgis-scene.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#goTo) methods.
    *
@@ -183,11 +194,11 @@ export abstract class ArcgisFeatures extends LitElement {
   accessor headerActions: Collection<ActionButton | ActionToggle>;
   /**
    * The title of the Features component. This can be set to any string value no
-   * matter the features that are selected. If the [selected feature](#selectedFeature)
-   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html), then the title set in the
+   * matter the features that are selected. If the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)
+   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), then the title set in the
    * corresponding template is used here.
    *
-   * @see [headingLevel](#headingLevel)
+   * @see [headingLevel](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#headingLevel)
    * @since 4.34
    * @example
    * ```js
@@ -198,7 +209,7 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor heading: string | null | undefined;
   /**
-   * Indicates the heading level to use for the [heading](#heading) of the component.
+   * Indicates the heading level to use for the [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) of the component.
    * By default, the heading is rendered
    * as a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the component's placement
    * in your app, you may need to adjust this heading for proper semantics. This is
@@ -208,18 +219,18 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor headingLevel: HeadingLevel;
   /**
-   * Indicates whether to hide the action bar that holds the feature's [actions](#actions).
+   * Indicates whether to hide the action bar that holds the feature's [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions).
    *
    * @default false
    */
   accessor hideActionBar: boolean;
   /**
-   * This property provides the ability to hide or show [attachments content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-AttachmentsContent.html) within the component.
+   * This property provides the ability to hide or show [attachments content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideAttachmentsContent: boolean;
+  accessor hideAttachmentsContent: boolean | undefined;
   /**
    * Indicates whether to hide the close button in the component.
    *
@@ -234,14 +245,14 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor hideContent: boolean;
   /**
-   * This property provides the ability to hide or show [custom content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-CustomContent.html) within the component.
+   * This property provides the ability to hide or show [custom content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideCustomContent: boolean;
+  accessor hideCustomContent: boolean | undefined;
   /**
-   * This property provides the ability to hide or show [expression content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) within the component.
+   * This property provides the ability to hide or show [expression content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) within the component.
    *
    * @default false
    * @since 5.0
@@ -261,18 +272,18 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor hideFeatureMenuHeading: boolean;
   /**
-   * Indicates whether to hide the feature navigation in the component. This allows the user to scroll through various [selected features](#features) using pagination arrows.
+   * Indicates whether to hide the feature navigation in the component. This allows the user to scroll through various [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) using pagination arrows.
    *
    * @default false
    */
   accessor hideFeatureNavigation: boolean;
   /**
-   * This property provides the ability to hide or show [fields content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-FieldsContent.html) within the component.
+   * This property provides the ability to hide or show [fields content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideFieldsContent: boolean;
+  accessor hideFieldsContent: boolean | undefined;
   /**
    * Indicates whether to hide the heading in the component.
    *
@@ -287,19 +298,26 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor hideLastEditedInfo: boolean;
   /**
-   * This property provides the ability to hide or show [media content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-MediaContent.html) within the component.
+   * This property provides the ability to hide or show [media content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideMediaContent: boolean;
+  accessor hideMediaContent: boolean | undefined;
   /**
-   * This property provides the ability to hide or show [relationship content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-RelationshipContent.html) within the component.
+   * This property provides the ability to hide or show [relationship content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideRelationshipContent: boolean;
+  accessor hideRelationshipContent: boolean | undefined;
+  /**
+   * Indicates whether to hide the *select feature* action when viewing associated and related features.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor hideSelectFeature: boolean;
   /**
    * Indicates whether to hide the spinner in the component.
    *
@@ -307,21 +325,21 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor hideSpinner: boolean;
   /**
-   * This property provides the ability to hide or show [text content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-TextContent.html) within the component.
+   * This property provides the ability to hide or show [text content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideTextContent: boolean;
+  accessor hideTextContent: boolean | undefined;
   /**
-   * This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html) within the component.
+   * This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideUtilityNetworkContent: boolean;
+  accessor hideUtilityNetworkContent: boolean | undefined;
   /**
-   * Indicates whether to highlight the [selected feature](#selectedFeature) in the associated
+   * Indicates whether to highlight the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature) in the associated
    * [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
    *
    * @default false
@@ -352,9 +370,9 @@ export abstract class ArcgisFeatures extends LitElement {
   /** The component's default label. */
   accessor label: string | undefined;
   /**
-   * A map is required when the input [features](#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/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 the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
+   * A map is required when the input [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/arcade) expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) that may use the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
    *
-   * Alternatively, the [view](#view) property can be used to provide the map instance for this property.
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property can be used to provide the map instance for this property.
    *
    * @default null
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
@@ -376,7 +394,12 @@ export abstract class ArcgisFeatures extends LitElement {
   accessor messageOverrides: {
       componentLabel?: string | undefined;
       zoom?: string | undefined;
-      browseClusteredFeatures?: string | undefined;
+      browseAggregatedFeatures?: string | undefined;
+      aggregatedFeatures?: string | undefined;
+      aggregatedFeaturesPlaceholder?: string | undefined;
+      collapse?: string | undefined;
+      expand?: string | undefined;
+      noAggregatedFeatures?: string | undefined;
       featuresList?: string | undefined;
       total?: string | undefined;
       pageText?: string | undefined;
@@ -398,7 +421,12 @@ export abstract class ArcgisFeatures extends LitElement {
   protected messages: Partial<{
       componentLabel: string;
       zoom: string;
-      browseClusteredFeatures: string;
+      browseAggregatedFeatures: string;
+      aggregatedFeatures: string;
+      aggregatedFeaturesPlaceholder: string;
+      collapse: string;
+      expand: string;
+      noAggregatedFeatures: string;
       featuresList: string;
       total: string;
       pageText: string;
@@ -418,7 +446,12 @@ export abstract class ArcgisFeatures extends LitElement {
   }> & T9nMeta<{
       componentLabel: string;
       zoom: string;
-      browseClusteredFeatures: string;
+      browseAggregatedFeatures: string;
+      aggregatedFeatures: string;
+      aggregatedFeaturesPlaceholder: string;
+      collapse: string;
+      expand: string;
+      noAggregatedFeatures: string;
       featuresList: string;
       total: string;
       pageText: string;
@@ -439,15 +472,19 @@ export abstract class ArcgisFeatures extends LitElement {
   /**
    * Indicates whether the component is visible. This property is `true` when the component is querying for results, even if it is not open. Use this property to check if the component is visible.
    *
+   * When setting the [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) directly, it is recommended to call [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#clear) before setting `open` to `true` to remove any existing promises, features, heading, location, and content from the component. Otherwise, the old content will display.
+   *
    * @default false
    * @see [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures)
-   * @see [active](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#active)
+   * @see [active](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#active)
+   * @see [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#clear)
    * @since 5.0
    * @example
    * ```js
    * // Listen for clicks on the view and open the component at the clicked location with custom content.
    * viewElement.addEventListener("arcgisViewClick", (event) => {
    *   const { mapPoint } = event.detail;
+   *   component.clear();
    *   component.location = mapPoint;
    *   component.heading = "You clicked here";
    *   component.content = "Latitude: " + mapPoint.latitude.toFixed(3) + ", Longitude: " + mapPoint.longitude.toFixed(3);
@@ -460,9 +497,9 @@ export abstract class ArcgisFeatures extends LitElement {
    * An array of pending Promises that have not yet been fulfilled. If there are
    * no pending promises, the value is `null`. When the pending promises are
    * resolved they are removed from this array and the features they return
-   * are pushed into the [features](#features) array.
+   * are pushed into the [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) array.
    */
-  accessor promises: Array<Promise<Array<Graphic2>>>;
+  accessor promises: Array<Promise<Array<Graphic>>>;
   /**
    * 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.
    *
@@ -471,25 +508,26 @@ export abstract class ArcgisFeatures extends LitElement {
   accessor referenceElement: ArcgisReferenceElement | string | undefined;
   /**
    * The feature that the component has drilled into.
-   * This 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.
+   * This feature is either associated with the selected feature in a [relationship](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/)
+   * or [utility network](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/) element.
    *
    * @since 4.34
    */
-  get selectedDrillInFeature(): Graphic | null | undefined;
+  get selectedDrillInFeature(): Graphic | undefined;
   /**
    * The selected feature accessed by the Features component. The content displayed in the component is
-   * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to this feature.
+   * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) assigned to this feature.
    */
-  get selectedFeature(): Graphic2 | null;
+  get selectedFeature(): Graphic | null;
   /**
    * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component.
    * This is useful if needing to get a reference to the Feature component in order to make any changes to it.
    *
    * @since 4.34
    */
-  get selectedFeatureComponent(): ArcgisFeature | null;
+  get selectedFeatureComponent(): ArcgisFeature | undefined;
   /**
-   * Index of the feature that is [selected](#selectedFeature). When [features](#features) are set,
+   * Index of the feature that is [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature). When [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) are set,
    * the first index is automatically selected.
    */
   accessor selectedFeatureIndex: number;
@@ -503,7 +541,7 @@ export abstract class ArcgisFeatures extends LitElement {
    * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
    * This property should be set if the Features component executes Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
    *
-   * Alternatively, the [view](#view) property can be used to provide the spatial reference instance for this property.
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property can be used to provide the spatial reference instance for this property.
    *
    * @default null
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
@@ -518,7 +556,7 @@ export abstract class ArcgisFeatures extends LitElement {
   get state(): State;
   /**
    * Dates and times displayed in the component will be displayed in this time zone. By default this time zone is
-   * inherited from [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeZone) if the [view](#view) property is set. When a MapView is not associated with the component
+   * inherited from [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property is set. When a MapView is not associated with the component
    * then the property will fallback to the `system` time zone.
    *
    * **Possible Values**
@@ -530,30 +568,30 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor timeZone: string;
   /**
-   * Indicates whether to update the [location](#location) when the [selectedFeatureIndex](#selectedFeatureIndex) changes.
+   * Indicates whether to update the feature location when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex) changes.
    *
    * @default false
    * @since 5.0
    */
   accessor updateLocationEnabled: boolean;
   /**
-   * 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).
+   * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) or [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
    * The Features component requires a `view` to be set if:
-   * - 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.
-   * - 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)).
-   * - 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).
-   * Alternatively, set the [`timeZone`](#timeZone) property.
-   * - Using the [fetchFeatures](#fetchFeatures) method or the `fetchFeatures` option in the [`open`](#open) method.
-   * - Using the `Zoom to` default action. If the `view` is not specified, set the [includeDefaultActionsDisabled](#includeDefaultActionsDisabled) property to `true` to remove this default action.
+   * - The [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) have a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) 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](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#map) property.
+   * - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) or [bin](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/)).
+   * - Values from `date` and `timestamp-offset` fields should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/references/core/views/View/#timeZone).
+   * Alternatively, set the [timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#timeZone) property.
+   * - Using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures) method or the `fetchFeatures` option in the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open) method.
+   * - Using the `Zoom to` default action. If the `view` is not specified, set the [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#includeDefaultActionsDisabled) property to `true` to remove this default action.
    *
    * @since 4.34
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /** @since 4.34 */
-  accessor viewModel: FeaturesViewModel;
+  accessor viewModel: Features;
   /**
-   * Removes [promises](#promises), [features](#features), [content](#content), and
-   * [heading](#heading) from the Features component.
+   * Removes [promises](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#promises), [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features), [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content), and
+   * [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) from the Features component.
    */
   clear(): Promise<void>;
   /** A convenience method to close the component. */
@@ -561,7 +599,7 @@ export abstract class ArcgisFeatures extends LitElement {
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
-   * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-layers-LayerView.html) in 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 associated [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). This method allows a developer to control how the input location is handled. For example, you may want to fetch features on a `click` event or on a `pointer-move` event. This method automatically sets the [`location`](#location) based on the input event's screen coordinates.
+   * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) in the [view](https://developers.arcgis.com/javascript/latest/references/core/views/View/). In order to use this, a layer must already have an associated [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled). This method allows a developer to control how the input location is handled. For example, you may want to fetch features on a `click` event or on a `pointer-move` event. This method automatically sets the location based on the input event's screen coordinates.
    *
    * @param screenPoint
    * @param options
@@ -585,17 +623,17 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   fetchFeatures(screenPoint?: ScreenPoint, options?: FetchFeaturesOptions): Promise<void>;
   /**
-   * Selects the feature at the next index in relation to the [selected feature](#selectedFeature).
+   * Selects the feature at the next index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
    *
-   * @see [selectedFeatureIndex](#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
    */
-  next(): Promise<FeaturesViewModel>;
+  next(): Promise<Features>;
   /**
-   * Selects the feature at the previous index in relation to the [selected feature](#selectedFeature).
+   * Selects the feature at the previous index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
    *
-   * @see [selectedFeatureIndex](#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
    */
-  previous(): Promise<FeaturesViewModel>;
+  previous(): Promise<Features>;
   /**
    * Use this method to give focus to the Component if the component is able to be focused.
    *
@@ -603,8 +641,8 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   setFocus(): Promise<void>;
   /**
-   * Triggers the [`arcgisTriggerAction`](#arcgisTriggerAction) event and executes the action
-   * at the specified index in the [actions](#actions) array.
+   * Triggers the [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#event-arcgisTriggerAction) event and executes the action
+   * at the specified index in the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions) array.
    *
    * @param action
    */
@@ -612,16 +650,16 @@ export abstract class ArcgisFeatures extends LitElement {
   /** Emitted when the component's close button is clicked. */
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
   /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
-  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "effectiveHeading" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;
   /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
   readonly arcgisReady: import("@arcgis/lumina").TargetedEvent<this, void>;
   /**
    * Fires after the user clicks on an action in the component.
    * This event may be used to define a custom function to execute when particular actions are clicked.
    *
-   * @see [actions](#actions)
-   * @see [PopupTemplate.actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#actions)
-   * @see [open](#open)
+   * @see [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions)
+   * @see [PopupTemplate.actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions)
+   * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open)
    * @example
    * ```js
    * // Fires each time an action is clicked