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

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

@@ -1,22 +1,19 @@
 /// <reference path="../../index.d.ts" />
-import type FeaturesViewModel from "@arcgis/core/widgets/Features/FeaturesViewModel.js";
+import type Features from "@arcgis/core/popup/Features.js";
 import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
-import type ActionToggle from "@arcgis/core/support/actions/ActionToggle";
-import type Graphic from "@arcgis/core/Graphic";
+import type ActionToggle from "@arcgis/core/support/actions/ActionToggle.js";
+import type Graphic from "@arcgis/core/Graphic.js";
 import type Collection from "@arcgis/core/core/Collection.js";
-import type Widget from "@arcgis/core/widgets/Widget.js";
-import type Graphic2 from "@arcgis/core/Graphic.js";
 import type Point from "@arcgis/core/geometry/Point.js";
-import type { ArcgisReferenceElement } from "../../utils/component-utils.js";
-import type { HeadingLevel } from "../../support/heading.js";
+import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { Alignment, DockOptions, PopupPositionResult, FetchFeaturesOptions } from "./types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
 import type { ArcgisFeature } from "../arcgis-feature/customElement.js";
-import type { ActionEvent, PopupOpenOptions } from "@arcgis/core/widgets/Popup/types";
-import type { ScreenPoint } from "@arcgis/core/core/types";
-import type { ClickEvent } from "@arcgis/core/views/input/types";
+import type { ActionEvent, PopupOpenOptions } from "@arcgis/core/widgets/Popup/types.js";
+import type { ScreenPoint } from "@arcgis/core/core/types.js";
+import type { ClickEvent } from "@arcgis/core/views/input/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/widgets/Popup/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";
 
@@ -26,22 +23,25 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * by providing users with a simple way to interact with and view attributes in a layer.
  * They play an important role in relaying information to the user, which improves the storytelling capabilities of the application.
  *
- * The popup component can be used with the view components by default. Set the `popup-component-enabled` attribute to `true` using [arcgis-map.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled), [arcgis-scene.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupComponentEnabled), or [arcgis-link-chart.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/#popupComponentEnabled) to open the popup component automatically when clicking on features.
+ * The popup component can be added to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) using the `popup` slot.
+ * When added to a view component, the popup is automatically populated with content from the selected feature in the view and displays when clicking on features in the view.
+ * The content of the popup is determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) assigned to the selected feature.
  *
  * ```html
- * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-component-enabled></arcgis-map>
+ * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9">
+ *   <arcgis-popup slot="popup"></arcgis-popup>
+ * </arcgis-map>
  * ```
- * > At version 6.0, the Popup component will be used by default and setting the `popup-component-enabled` attribute will no longer be necessary.
  *
- * The Popup component can also be opened manually at a specific location using the [`open`](#open) property.
+ * The Popup component can also be opened manually at a specific location using the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) property.
  * To prevent the popup from opening automatically when clicking on features within view components, set the `popup-disabled` attribute to `true` and add the Popup component to the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) using the `popup` slot.
- * Before setting the `open` property to `true`, you must set the [`location`](#location) property to specify where the popup should open or call the [`fetchFeatures()`](#fetchFeatures) method to open the popup template for features at a specific screen location.
+ * Before setting the `open` property to `true`, you must set the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) property to specify where the popup should open or call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method to open the popup template for features at a specific screen location.
  *
  * Example of opening the popup at a clicked location with custom content:
  *
  * ```html
  * <!-- Set popup-disabled and popup-component-enabled attributes -->
- * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled popup-component-enabled>
+ * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
  *   <!-- Add the popup component to the popup slot. -->
  *   <arcgis-popup slot="popup"></arcgis-popup>
  * </arcgis-map>
@@ -59,10 +59,10 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * </script>
  * ```
  *
- * Alternatively, you can call the [`fetchFeatures()`](#fetchFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
+ * Alternatively, you can call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
  * ```html
  * <!-- Set popup-disabled and popup-component-enabled attributes -->
- * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled popup-component-enabled>
+ * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
  *   <!-- Add the popup component to the popup slot. -->
  *   <arcgis-popup slot="popup"></arcgis-popup>
  * </arcgis-map>
@@ -82,57 +82,64 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * </script>
  * ```
  *
+ * The popup component can be used with the view components by default. Set the `popup-component-enabled` attribute to `true` using [arcgis-map.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#popupComponentEnabled), [arcgis-scene.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#popupComponentEnabled), or [arcgis-link-chart.popupComponentEnabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/#popupComponentEnabled) to open the popup component automatically when clicking on features.
+ *
+ * ```html
+ * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-component-enabled></arcgis-map>
+ * ```
+ * > At version 6.0, the Popup component will be used by default and setting the `popup-component-enabled` attribute will no longer be necessary.
+ *
  * ## Popup UI
  * The [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) components contain a default popup.
- * This popup can display generic content, which is set in its [heading](#heading)
- * and [content](#content) properties.
+ * This popup can display generic content, which is set in its [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
+ * and [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#content) properties.
  * When  content is set directly on the Popup instance it is not tied to a specific feature or layer.
  *
- * ![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)
+ * ![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popup-basic.avif)
  *
- * In the image above, the text "Marriage in Nassau County Census Tract 5177.01" is the popup's [heading](#heading).
- * The remaining text is the popup's [content](#content).
+ * In the image above, the text "Marriage in Nassau County Census Tract 5177.01" is the popup's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading).
+ * The remaining text is the popup's [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#content).
  * A dock button is displayed in the top right corner of the popup allowing the user to dock the popup to one of the sides or corners of the view.
- * The options for docking may be set in the [dockOptions](#dockOptions) property.
+ * The options for docking may be set in the [dockOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#dockOptions) property.
  * The popup may also be collapsed by clicking the collapse button (the down arrow icon) in the top right corner of the popup.
  * When collapsed, only the heading of the popup displays.
  * The popup may be closed by clicking the close button (the "x" icon) in the top right corner of the popup.
  *
- * Popups can also contain [actions](#actions) which execute a function defined by the developer when clicked.
+ * Popups can also contain [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions) which execute a function defined by the developer when clicked.
  * By default, every popup has a "Zoom to" action (as shown in the image above with the magnifying glass) that allows users to zoom to the selected feature.
- * See the [actions](#actions) property for information about adding custom actions to a popup.
+ * See the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions) property for information about adding custom actions to a popup.
  *
- * The Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.
+ * The Popup component is tied to an [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.
  * If wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/) component can be used to display the same content
  * in its own container.
  *
  * ## Popup and PopupTemplate
- * [PopupTemplates](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)
- * and [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). Popup templates allow you to define custom titles and content templates based on the source of the
- * [selected feature](#selectedFeature). When a layer or a graphic has a defined
+ * [PopupTemplates](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) are closely related to Popup, but are more specific to [layers](https://developers.arcgis.com/javascript/latest/references/core/layers/Layer/)
+ * and [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/). Popup templates allow you to define custom titles and content templates based on the source of the
+ * [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature). When a layer or a graphic has a defined
  * popup template, the popup will display the content defined in the popup template when the feature is clicked.
- * The content may contain field values from the attributes of the [selected feature](#selectedFeature).
+ * The content may contain field values from the attributes of the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature).
  *
- * Custom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html) on the
- * [features](#features) property.
+ * Custom PopupTemplates may also be assigned directly to a popup by setting [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) on the
+ * [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) property.
  *
  * @since 4.34
  * @beta
- * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html)
+ * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  */
 export abstract class ArcgisPopup 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-popup/#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-popup/#event-arcgisTriggerAction) event fires each time an action is clicked.
    *
    * @see [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-Popup-PopupViewModel.html#waitingForResult).
+   * 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).
    *
    * @default false
    */
@@ -152,7 +159,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor alignment: Alignment;
   /**
-   * This closes the popup when the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) camera or [Viewpoint](https://developers.arcgis.com/javascript/latest/api-reference/esri-Viewpoint.html) changes.
+   * This closes the popup when the [View](https://developers.arcgis.com/javascript/latest/references/core/views/View/) camera or [Viewpoint](https://developers.arcgis.com/javascript/latest/references/core/Viewpoint/) changes.
    *
    * @default false
    */
@@ -174,7 +181,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   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
@@ -183,13 +190,13 @@ export abstract class ArcgisPopup 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;
   /** Dock position in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) component. */
   get currentDockPosition(): null | undefined | PopupPositionResult;
   /**
    * 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
@@ -200,10 +207,10 @@ export abstract class ArcgisPopup extends LitElement {
    *
    * Docking the popup allows for a better user experience, particularly when opening
    * popups in apps on mobile devices. When a popup is "dockEnabled" it means the popup no
-   * longer points to the [selected feature](#selectedFeature) or the [location](#location)
+   * longer points to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature) or the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location)
    * assigned to it. Rather it is attached to a side, the top, or the bottom of the view.
    *
-   * See [dockOptions](#dockOptions) to override default options related to docking the popup.
+   * See [dockOptions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#dockOptions) to override default options related to docking the popup.
    *
    * @default false
    * @example
@@ -222,7 +229,7 @@ export abstract class ArcgisPopup extends LitElement {
   /**
    * Docking the popup allows for a better user experience, particularly when opening
    * popups in apps on mobile devices. When a popup is "dockEnabled" it means the popup no
-   * longer points to the [selected feature](#selectedFeature) or the [location](#location)
+   * longer points to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature) or the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location)
    * assigned to it. Rather it is placed in one of the corners of the view or to the top or bottom
    * of it. This property allows the developer to set various options for docking the popup.
    *
@@ -243,13 +250,21 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor dockOptions: DockOptions;
   /**
-   * The number of {@link ArcgisPopup#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-popup/#heading).
+   *
+   * @since 5.1
+   * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
+   * @see [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature)
+   */
+  get effectiveHeading(): string | null | undefined;
+  /**
+   * The number of [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) available in the component.
    *
    * @default 0
    */
   get featureCount(): number;
   /**
-   * 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-popup/#initialDisplayMode) is set to "feature".
    *
    * @default false
    */
@@ -259,11 +274,11 @@ export abstract class ArcgisPopup extends LitElement {
    *
    * @since 5.0
    */
-  accessor featureMenuTitle: string | null | undefined;
+  accessor featureMenuTitle: string | undefined;
   /**
-   * 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-popup/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#selectedFeature)).
    *
    * This value is `null` if no features are associated with the component.
    *
@@ -283,7 +298,7 @@ export abstract class ArcgisPopup extends LitElement {
    * component.features = graphics;
    * ```
    */
-  accessor features: Array<Graphic2>;
+  accessor features: Array<Graphic>;
   /**
    * 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.
    *
@@ -301,11 +316,11 @@ export abstract class ArcgisPopup extends LitElement {
   accessor goToOverride: GoToOverride | null | undefined;
   /**
    * The title of the popup. This can be set generically on the popup 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-popup/#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-popup/#headingLevel)
    * @example
    * ```html
    * <!-- This title will display in the popup unless a selected feature's
@@ -321,7 +336,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor heading: string | null | undefined;
   /**
-   * Indicates the heading level to use for the [heading](#heading) of the popup.
+   * Indicates the heading level to use for the [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading) of the popup.
    * 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
@@ -329,7 +344,7 @@ export abstract class ArcgisPopup extends LitElement {
    *
    * @default 2
    * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
-   * @see [heading](#heading)
+   * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
    * @example
    * ```html
    * <!-- Render the popup heading as a level 3 heading -->
@@ -338,7 +353,7 @@ export abstract class ArcgisPopup 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-popup/#actions).
    *
    * @default false
    */
@@ -368,7 +383,7 @@ export abstract class ArcgisPopup 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-popup/#features) using pagination arrows.
    *
    * @default false
    */
@@ -409,9 +424,9 @@ export abstract class ArcgisPopup extends LitElement {
   accessor label: string | undefined;
   /**
    * Point used to position the popup. This is automatically set when viewing the
-   * popup by selecting a feature or when calling the [`fetchFeatures`](#fetchFeatures) method. If using the Popup to display content not related
+   * popup by selecting a feature or when calling the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method. If using the Popup to display content not related
    * to features in the map, such as the results from a task, then you must set this
-   * property before [opening](#open) the popup.
+   * property before [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) the popup.
    *
    * @example
    * ```js
@@ -444,6 +459,8 @@ export abstract class ArcgisPopup extends LitElement {
       zoom?: string | undefined;
       dock?: string | undefined;
       undock?: string | undefined;
+      collapse?: string | undefined;
+      expand?: string | undefined;
   };
   /** @internal */
   protected messages: Partial<{
@@ -451,24 +468,32 @@ export abstract class ArcgisPopup extends LitElement {
       zoom: string;
       dock: string;
       undock: string;
+      collapse: string;
+      expand: string;
   }> & T9nMeta<{
       componentLabel: string;
       zoom: string;
       dock: string;
       undock: string;
+      collapse: string;
+      expand: string;
   }>;
   /**
    * 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-popup/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading) directly, it is recommended to call [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#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-popup/#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);
@@ -481,9 +506,9 @@ export abstract class ArcgisPopup 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-popup/#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.
    *
@@ -492,22 +517,22 @@ export abstract class ArcgisPopup 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.
    */
   get selectedDrillInFeature(): Graphic | null | undefined;
   /**
    * The selected feature accessed by the popup. The content of the Popup is
-   * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to
+   * 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/) that the Popup is using.
    * This is useful if needing to get a reference to the component in order to make any changes to it.
    */
   get selectedFeatureComponent(): ArcgisFeature | null;
   /**
-   * 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-popup/#selectedFeature). When [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) are set,
    * the first index is automatically selected.
    */
   accessor selectedFeatureIndex: number;
@@ -526,7 +551,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor topLayerDisabled: boolean;
   /**
-   * Indicates whether to update the [location](#location) when the [selectedFeatureIndex](#selectedFeatureIndex) changes.
+   * Indicates whether to update the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeatureIndex) changes.
    *
    * @default false
    * @since 5.0
@@ -538,14 +563,14 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor view: MapViewOrSceneView | null | undefined;
   /**
-   * Removes all [promises](#promises), [features](#features), [content](#content),
-   * [heading](#heading) and [location](#location) from the Popup.
+   * Removes all [promises](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#promises), [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features), [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#content),
+   * [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading) and [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) from the Popup.
    */
   clear(): Promise<void>;
   /** 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](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) based on the input event's screen coordinates.
    *
    * @param screenPoint
    * @param options
@@ -576,36 +601,36 @@ export abstract class ArcgisPopup extends LitElement {
   /**
    * Selects the feature at the next index in relation to the selected feature.
    *
-   * @see [selectedFeatureIndex](#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeatureIndex)
    */
-  next(): Promise<FeaturesViewModel>;
+  next(): Promise<Features>;
   /**
    * Selects the feature at the previous index in relation to the selected feature.
    *
-   * @see [selectedFeatureIndex](#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeatureIndex)
    */
-  previous(): Promise<FeaturesViewModel>;
+  previous(): Promise<Features>;
   /** Use this method to give focus to the component if the component is able to be focused. */
   setFocus(): Promise<void>;
   /**
-   * Triggers the [arcgisTriggerAction](#arcgisTriggerAction) event and executes the [action](#actions)
-   * at the specified index in the [actions](#actions) array.
+   * Triggers the [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#event-arcgisTriggerAction) event and executes the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions)
+   * at the specified index in the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#actions) array.
    *
    * @param action
    */
   triggerAction(action: ActionButton | ActionToggle): Promise<void>;
   /** Emitted when the component's close button is clicked. */
   readonly arcgisClose: import("@arcgis/lumina").TargetedEvent<this, void>;
-  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "currentAlignment" | "dockEnabled" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "state" | "open"; }>;
+  readonly arcgisPropertyChange: import("@arcgis/lumina").TargetedEvent<this, { name: "active" | "collapsed" | "currentAlignment" | "dockEnabled" | "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 Popup 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-popup/#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-popup/#open)
    * @example
    * ```js
    * // Fires each time an action is clicked