@arcgis/map-components 4.34.0-next.134 → 4.34.0-next.136

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

@@ -12,157 +12,73 @@ import { default as ActionButton } from '@arcgis/core/support/actions/ActionButt
 declare const useFeaturesViewModel: (component: LitElement & Pick<FeaturesViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<FeaturesViewModel>) => FeaturesViewModel;
 
 /**
- * <a name="overview"></a>
- *
  * ## Overview
- * The Popup widget allows users to view content from feature attributes. Popups enhance web applications
+ * The Popup component allows users to view content from feature attributes. Popups enhance web applications
  * 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.
  *
- * <a name="loading-the-popup"></a>
- *
- * ## Loading the Popup
- * At [version 4.27](../release-notes#popup-performance-improvements), the view's default popup is loaded on demand when [`popupEnabled`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popupEnabled) is set to `true` (which is the default), when the [`openPopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#openPopup) method is called,
- * or when some widgets need the popup, such as [Search](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Search.html). Please see the read more section below for details on how to manually load the popup or take
- * advantage of the API lazy loading.
- *
- * >>> esri-read-more
- *
- * The Popup class can be loaded when the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) is instantiated, however, this does not take advantage of the performance improvements of lazily loading the popup.
- * ```js
- * // Create a new MapView
- * const view = new MapView({
- * // set the popup property to a new instance of Popup
- *   popup: new Popup(...)
- * });
- * ```
- * To utilize the performance improvements and the API automatically lazy loading the popup:
- * - Set options/properties on the view's popup:
- *   ```js
- *   const view = MapView({
- *     popup: {
- *       dockEnabled: true,
- *       dockOptions: {
- *         position: true,
- *         ...
- *       }
- *     }
- *   });
- *   ```
- * - Use [`popupEnabled`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#popupEnabled) to prevent the popup appearing when the user clicks the view.
- *   ```js
- *   // The popup doesn't show for features on selection, but will on Search results and when `openPopup()` is called.
- *   view.popupEnabled = false;
- *   ```
- * - Use [`openPopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#openPopup) instead of [`open()`](#open) and [`closePopup()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View2D.html#closePopup) instead of [`close()`](#close).
- *   ```js
- *   // A deprecation warning is prompted if the popup isn't created
- *   // and calls view.openPopup() or view.closePopup() respectively under the hood.
- *   view.popup.open(...);
- *   view.popup.close(...);
- *
- *   // Opens or closes the popup on the View.
- *   view.openPopup(...);
- *   view.closePopup(...);
- *   ```
- * - Use [reactiveUtils](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html) to watch properties on the popup and its view model instead of the [`watch()`](#watch) method.
- *   ```js
- *   // This will throw an error that watch() is not a method
- *   // since the popup hasn't been created yet.
- *   view.popup.watch("selectedFeature", ...)
- *
- *   // Call reactiveUtils.watch() on popup properties with optional chaining.
- *   reactiveUtils.watch(() => view.popup?.selectedFeature, ...);
- *   ```
- * - Use the [`reactiveUtils.when()`](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-reactiveUtils.html#when) method to check when the popup instance is created. Once its created, then it's properties or methods can be accessed and called.
- *   ```js
- *   // This will throw an error that actions is not a property.
- *   view.popup.actions.push(...);
- *
- *   // Wait for the popup to load before accessing properties.
- *   reactiveUtils.when(() => view.popup?.actions, ()=>{
- *     view.popup.actions.push(...);
- *   });
- *   ```
- *
- * >>>
- *
- * <a name="popup-ui"></a>
- *
  * ## Popup UI
- * All [Views](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html) contain a default popup.
- * This popup can display generic content, which is set in its [title](#title)
+ * The [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) components contain a default popup.
+ * This popup can display generic content, which is set in its [heading](#heading)
  * and [content](#content) properties.
  * When  content is set directly on the Popup instance it is not tied to a specific feature or layer.
  *
- * [![popup-basic-example](../assets/img/apiref/widgets/popup/popup-basic.png)](../sample-code/sandbox/?sample=intro-popup)
+ * [![popup-basic-example](https://developers.arcgis.com/javascript/latest/assets/img/apiref/widgets/popup/popup-basic.png)](../sample-code/sandbox/?sample=intro-popup)
  *
- * In the image above, the text "Marriage in New York County Census Tract 8" is the popup's `title`. The remaining text is
- * its `content`. A dock button ![popup-dock-btn](../assets/img/apiref/widgets/popup/popup-dock.png) may also be available in the
- * top right corner of the popup. This allows the user to dock the popup to one of the sides or corners of the view.
+ * 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).
+ * 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 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) that act like buttons,
- * which execute a function defined by the developer when clicked.
- * By default, every popup has a "Zoom to" action ![popupTemplate-zoom-action](../assets/img/apiref/widgets/popup/popuptemplate-zoom-action.png)
- * that allows users to zoom to the selected feature. See the [actions](#actions)
- * property for information about adding custom actions to a popup.
+ * Popups can also contain [actions](#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.
  *
- * The Popup widget is tied to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html), whether it's docked or anchored to the selected feature.
- * If wanting to utilize the Popup functionality outside of the View, the [Features](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features.html) widget can be used to display the same content
- * in its own container that's not tied to the View.
- *
- * <a name="popup-and-popuptemplate"></a>
+ * The Popup component is tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component, whether it's docked or anchored to the selected feature.
+ * If wanting to utilize the Popup functionality outside of [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/), the [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/) component can be used to display the same content
+ * in its own container.
  *
  * ## Popup and PopupTemplate
- * [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) is closely related to Popup, but is more specific to [layers](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-Layer.html)
- * and [graphics](https://developers.arcgis.com/javascript/latest/api-reference/esri-Graphic.html). It allows you to define custom titles and content templates based on the source of the
+ * [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
- * PopupTemplate, the popup will display the content
- * defined in the PopupTemplate when the feature is clicked. The content may contain field values from the attributes of the [selected feature](#selectedFeature).
+ * 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).
  *
  * 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. For more information about Popup
- * and how it relates to [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) see the samples listed below.
+ * [features](#features) property.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/)
  *
- * @since 4.0
+ * @since 4.34
+ * @beta
  * @see module :esri/PopupTemplate
- * @see module :esri/views/SceneView#popup
- * @see module :esri/views/View2D#popup
- * @see [Sample - Intro to popups](../sample-code/intro-popup/index.html)
- * @see [Sample - to PopupTemplate](../sample-code/intro-popuptemplate/index.html)
- * @see [Sample - Dock positions with popup](../sample-code/popup-docking-position/index.html)
- * @see [Sample - Popup actions](../sample-code/popup-actions/index.html)
- * @see [Sample - Custom popup actions per feature](../sample-code/popup-custom-action/index.html)
- * @see [Sample - Popup with edit action](../sample-code/popup-editaction/index.html)
- * @see [Sample - Popup with DOM node](../sample-code/popup-domnode/index.html)
  * @see [Guide - Esri Icon Font](../guide/esri-icon-font/index.html)
- * @see module :esri/widgets/Popup/PopupViewModel
  */
 export declare class ArcgisPopup extends LitElement {
-    referenceElement?: ArcgisReferenceElement | string;
     /**
-     * [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects.
+     * 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.
-     * By default, popups have a `Zoom To` action styled with a magnifying glass icon ![popupTemplate-zoom-action](../assets/img/apiref/widgets/popup/popuptemplate-zoom-action.png).
-     * When this icon is clicked, the view zooms in four LODs and centers on the selected feature.
      *
-     * You may remove this default action by setting [includeDefaultActions](#includeDefaultActions) to `false`, or by setting the
+     * By default, popups have a `Zoom To` action styled with a magnifying glass icon.
+     * When this icon is clicked, the view zooms in four LODs and centers on the selected feature.
+     * You may remove this default action by setting [includeDefaultActionsDisabled](#includeDefaultActionsDisabled) to `true`, or by setting the
      * [`overwriteActions`](esri-PopupTemplate.html#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).
-     * 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 [trigger-action](#event-trigger-action) 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/api-reference/esri-core-Collection.html).
      *
-     * Actions are defined with the properties listed in the [ActionButton](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [ActionToggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) classes.
+     * The [arcgisTriggerAction](#arcgisTriggerAction) event fires each time an action is clicked.
      *
      * @autocast { "value": "Object[]", "typedCollection": true, "byTypeProperty": true }
-     * @see [trigger-action](#event-trigger-action)
+     * @see [arcgisTriggerAction](#arcgisTriggerAction)
      * @see [Sample - Popup actions](../sample-code/popup-actions/index.html)
      * @see [Sample - Custom popup actions per feature](../sample-code/popup-custom-action/index.html)
      * @see [Sample - Popup with edit action](../sample-code/popup-editaction/index.html)
      * @example
+     * ```js
      * // Defines an action button to zoom out from the selected feature
      * const zoomOutAction = {
      *   type: "button",
@@ -174,13 +90,13 @@ export declare class ArcgisPopup extends LitElement {
      *   icon: "magnifying-glass-minus"
      * };
      * // Adds the custom action to the popup.
-     * view.popup.actions.push(zoomOutAction);
+     * popupComponent.actions.push(zoomOutAction);
+     * ```
      */
     actions: __esri.Collection<ActionButton | __esri.ActionToggle>;
     /**
-     * Indicates if the widget 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/api-reference/esri-widgets-Popup-PopupViewModel.html#waitingForResult).
      *
-     * @since 4.30
      * @default false
      */
     readonly active: boolean;
@@ -190,20 +106,55 @@ export declare class ArcgisPopup extends LitElement {
      * to explicitly control where the popup displays in relation to the feature, choose
      * an option besides `auto`.
      *
-     * @since 4.8
      * @example
+     * ```js
      * // Popup will display on the bottom-right of the selected feature regardless of where that feature is located
-     * view.popup.alignment = "bottom-right";
+     * popupComponent.alignment = "bottom-right";
+     * ```
      * @default "auto"
      */
     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.
      *
-     * @since 4.5
      * @default false
      */
     autoCloseEnabled: boolean;
+    /**
+     * If true, the component will not be destroyed automatically when it is
+     * disconnected from the document. This is useful when you want to move the
+     * component to a different place on the page, or temporarily hide it. If this
+     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/#destroy) method when you are done to
+     * prevent memory leaks.
+     *
+     * @default false
+     */
+    autoDestroyDisabled: boolean;
+    /**
+     * Indicates whether the popup displays its content. If `true`, only the header displays.
+     *
+     * @default false
+     */
+    readonly collapsed: boolean;
+    /**
+     * The content of the popup. When set directly on the Popup, 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).
+     *
+     * @noautocast
+     * @see [Sample - Popup Docking](../sample-code/popup-docking-position/index.html)
+     * @see [Sample - Popup with DOM node](../sample-code/popup-domnode/index.html)
+     * @example
+     * ```js
+     * // This sets generic instructions in the popup that will always be displayed
+     * // unless it is overridden by a PopupTemplate
+     * popupComponent.content = "Click a feature on the map to view its attributes";
+     * ```
+     */
+    content: string | HTMLElement | nullish | __esri.Widget;
+    /** Dock position in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-link-chart/) component. */
+    get currentDockPosition(): nil | 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
@@ -218,7 +169,7 @@ export declare class ArcgisPopup extends LitElement {
      * [ImageryLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ImageryLayer.html), and
      * [VoxelLayer](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-VoxelLayer.html)).
      *
-     * ::: esri-md class="warning"
+     * **Note:**
      * * Starting with version 4.12, [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) content can no longer be set using a
      * wildcard, e.g. `*`. Instead, set the `defaultPopupTemplateEnabled` property to `true`.
      * * Starting with 4.16, the default popup has been improved to no longer display system
@@ -228,36 +179,35 @@ export declare class ArcgisPopup extends LitElement {
      * * 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`.
      * For example, previously a date that may have appeared as `"December 30, 1997"` will now appear as `"12/30/1997 6:00 PM"`.
-     * :::
      *
-     * @since 4.11
      * @default false
      */
     defaultPopupTemplateEnabled: boolean;
     /**
-     * The content of the popup. When set directly on the Popup, 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).
+     * Indicates whether the placement of the popup is docked to the side of the view.
      *
-     * @noautocast
-     * @see [Sample - Popup Docking](../sample-code/popup-docking-position/index.html)
-     * @see [Sample - Popup with DOM node](../sample-code/popup-domnode/index.html)
-     * @example
-     * // This sets generic instructions in the popup that will always be displayed
-     * // unless it is overridden by a PopupTemplate
-     * view.popup.content = "Click a feature on the map to view its attributes";
-     */
-    content: string | HTMLElement | nullish | __esri.Widget;
-    /**
-     * Indicates whether the popup displays its content. If `true`, only the header displays.
+     * 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)
+     * 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.
      *
-     * @since 4.5
+     * @see [Sample - Popup docking](../sample-code/popup-docking-position/index.html)
+     * @example
+     * ```html
+     * <!-- Setting this property in HTML -->
+     * <arcgis-popup dock-enabled></arcgis-popup>
+     * ```
+     * @example
+     * ```js
+     * // Setting this property using JS.
+     * // The popup will automatically be dockEnabled when made visible
+     * popupComponent.dockEnabled = true;
+     * ```
      * @default false
      */
-    readonly collapsed: boolean;
-    /** Dock position in the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html). */
-    get currentDockPosition(): nil | PopupPositionResult;
+    dockEnabled: boolean;
     /**
      * 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
@@ -269,7 +219,8 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @see [Sample - Popup docking](../sample-code/popup-docking-position/index.html)
      * @example
-     * view.popup.dockOptions = {
+     * ```js
+     * popupComponent.dockOptions = {
      *   // Disable the dock button so users cannot undock the popup
      *   buttonEnabled: false,
      *   // Dock the popup when the size of the view is less than or equal to 600x1000 pixels
@@ -278,26 +229,10 @@ export declare class ArcgisPopup extends LitElement {
      *     height: 1000
      *   }
      * };
+     * ```
      */
     get dockOptions(): DockOptions;
     set dockOptions(dockOptions: DockOptions);
-    /**
-     * Indicates whether the placement of the popup is docked to the side of the view.
-     *
-     * 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)
-     * 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 [Sample - Popup docking](../sample-code/popup-docking-position/index.html)
-     * @example
-     * // The popup will automatically be dockEnabled when made visible
-     * view.popup.dockEnabled = true;
-     * @default false
-     */
-    dockEnabled: boolean;
     /**
      * The number of selected [features](#features) available to the popup.
      *
@@ -305,9 +240,9 @@ export declare class ArcgisPopup extends LitElement {
      */
     readonly featureCount: number;
     /**
-     * This property enables showing the list of features.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuOpen)
+     * This property enables showing a list of features.
+     * 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".
      *
      * @default false
      */
@@ -328,6 +263,7 @@ export declare class ArcgisPopup extends LitElement {
      *
      * @noautocast
      * @example
+     * ```js
      * // When setting the features property, the graphics pushed to this property
      * // must have a PopupTemplate set.
      * let g1 = new Graphic();
@@ -339,53 +275,132 @@ export declare class ArcgisPopup extends LitElement {
      * // the popup will be set depending on the PopupTemplate of the graphics.
      * // Each graphic may share the same PopupTemplate or have a unique PopupTemplate
      * let graphics = [g1, g2, g3, g4, g5];
-     * view.popup.features = graphics;
+     * popupComponent.features = graphics;
+     * ```
      */
     features: __esri.Graphic[];
     /**
-     * This function provides the ability to override either the
-     * [MapView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#goTo) or
-     * [SceneView goTo()](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#goTo) methods.
+     * This function provides the ability to override either the [arcgis-map.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#goTo) or [arcgis-scene.goTo](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#goTo) methods.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#goToOverride)
+     * @example
+     * ```js
+     * popupComponent.goToOverride = (viewElement, goToParams)=>  {
+     *   goToParams.options = {
+     *     speedFactor: 2
+     *   };
+     *   return viewElement.goTo(goToParams.target, goToParams.options);
+     * };
+     * ```
      */
     goToOverride: nullish | __esri.GoToOverride;
     /**
-     * The current state of the component.
+     * 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
+     * corresponding template is used here.
      *
-     * @default "disabled"
+     * @see [headingLevel](#headingLevel)
+     * @example
+     * ```html
+     * <!-- This title will display in the popup unless a selected feature's
+     *     PopupTemplate overrides it -->
+     * <arcgis-popup heading="Population by zip codes in Southern California"></arcgis-popup>
+     * ```
+     * @example
+     * ```js
+     * // This title will display in the popup unless a selected feature's
+     * // PopupTemplate overrides it
+     * popupComponent.title = "Population by zip codes in Southern California";
+     * ```
      */
-    readonly state: "ready" | "disabled";
+    heading: string | nullish;
     /**
-     * Indicates the heading level to use for the [title](#title) of the popup.
-     * By default, the title is rendered
-     * as a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the widget's placement
+     * Indicates the heading level to use for the [heading](#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
      * important for meeting accessibility standards.
      *
-     * @since 4.20
      * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+     * @see [heading](#heading)
      * @example
-     * // popup title will render as an <h3>
-     * popup.headingLevel = 3;
+     * ```html
+     * <!-- Render the popup heading as a level 3 heading -->
+     * <arcgis-popup heading="Popup title" heading-level="3"></arcgis-popup>
+     * ```
      * @default 2
      */
     headingLevel: HeadingLevel;
     /**
-     * Highlight the selected popup feature using the [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#highlights)
-     * set on the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or the [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html#highlights)
-     * set on the [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
+     * Indicates whether to hide the action bar that holds the feature's [actions](#actions).
+     *
+     * @default false
+     */
+    hideActionBar: boolean;
+    /**
+     * Indicates whether to hide the close button in the component.
+     *
+     * @default false
+     */
+    hideCloseButton: boolean;
+    /**
+     * Indicates whether to hide the collapse button in the component.
+     *
+     * @default false
+     */
+    hideCollapseButton: boolean;
+    /**
+     * Indicates whether to hide a heading and description on the component feature menu list.
+     *
+     * @default false
+     */
+    hideFeatureMenuHeading: boolean;
+    /**
+     * Indicates whether pagination for feature navigation will be displayed. This allows the user to scroll through various [selected features](#features) using pagination arrows.
+     *
+     * @default false
+     */
+    hideFeatureNavigation: boolean;
+    /**
+     * Indicates whether to hide the group heading for a list of multiple features in the feature menu.
+     *
+     * @default false
+     */
+    hideFeatureListLayerTitle: boolean;
+    /**
+     * Indicates whether to hide the heading in the component.
+     *
+     * @default false
+     */
+    hideHeading: boolean;
+    /**
+     * Indicates whether to hide the spinner in the component.
+     *
+     * @default false
+     */
+    hideSpinner: boolean;
+    /**
+     * Indicates if the selected feature will be highlighted.
+     * This is done using the [arcgis-map.highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#highlights) or the [arcgis-scene.highlights](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/#highlights).
      *
      * @default false
      */
     highlightDisabled: boolean;
+    /**
+     * Indicates whether to include the default actions in the component.
+     * In order to disable any default actions, it is necessary to set `includeDefaultActionsDisabled` to `true`.
+     *
+     * @default false
+     */
+    includeDefaultActionsDisabled: boolean;
     /**
      * Indicates whether to initially display a list of features, or the content for one feature.
      *
-     * @since 4.32
      * @default "feature"
      */
     initialDisplayMode: "list" | "feature";
+    /** The component's default label. */
+    label?: string;
     /**
      * Point used to position the popup. This is automatically set when viewing the
      * popup by selecting a feature. If using the Popup to display content not related
@@ -395,23 +410,31 @@ export declare class ArcgisPopup extends LitElement {
      * @autocast { "byTypeProperty": false }
      * @see [Intro to popups](../sample-code/intro-popup/index.html)
      * @example
+     * ```js
      * // Sets the location of the popup to the center of the view
-     * view.popup.location = view.center;
+     * popupComponent.location = viewELement.center;
      * // Displays the popup
-     * view.popup.visible = true;
+     * popupComponent.visible = true;
+     * ```
      * @example
+     * ```js
      * // Sets the location of the popup to a specific place (using autocast)
      * // Note: using latitude/longitude only works if view is in Web Mercator or WGS84 spatial reference.
-     * view.popup.location = {latitude: 34.0571, longitude: -117.1968};
+     * popupComponent.location = {latitude: 34.0571, longitude: -117.1968};
+     * ```
      * @example
+     * ```js
      * // Sets the location of the popup to the location of a click on the view
-     * reactiveUtils.on(()=>view, "click", (event)=>{
-     *   view.popup.location = event.mapPoint;
+     * reactiveUtils.on(()=>viewElement, "arcgisViewClick", (event)=>{
+     *   popupComponent.location = event.detail.mapPoint;
      *   // Displays the popup
-     *   view.popup.visible = true;
+     *   popupComponent.visible = true;
      * });
+     * ```
      */
     location: nullish | __esri.Point;
+    /** Overwrite localized strings for this component */
+    messageOverrides?: typeof this.messages._overrides;
     /**
      * 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
@@ -419,6 +442,17 @@ export declare class ArcgisPopup extends LitElement {
      * are pushed into the [features](#features) array.
      */
     promises: Promise<__esri.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.
+     *
+     * @see [Associate components with a Map or Scene component](https://developers.arcgis.com/javascript/latest/programming-patterns/#associate-components-with-a-map-or-scene-component)
+     */
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * 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.
+     */
+    get selectedDrillInFeature(): __esri.Graphic | nil;
     /**
      * 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
@@ -426,112 +460,33 @@ export declare class ArcgisPopup extends LitElement {
      */
     readonly selectedFeature: nullish | __esri.Graphic;
     /**
-     * The feature that the widget 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](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html).
-     *
-     * @since 4.32
+     * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-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 selectedDrillInFeature(): __esri.Graphic | nil;
+    get selectedFeatureComponent(): HTMLArcgisFeatureElement | null;
     /**
      * Index of the feature that is [selected](#selectedFeature). When [features](#features) are set,
      * the first index is automatically selected.
      */
     selectedFeatureIndex: number;
     /**
-     * Returns a reference to the current [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html) that the Popup is using.
-     * This is useful if needing to get a reference to the widget in order to make any changes to it.
-     *
-     * @since 4.7
-     */
-    get selectedFeatureComponent(): HTMLArcgisFeatureElement | null;
-    /**
-     * 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
-     * corresponding template is used here.
-     *
-     * @see [headingLevel](#headingLevel)
-     * @example
-     * // This title will display in the popup unless a selected feature's
-     * // PopupTemplate overrides it
-     * view.popup.title = "Population by zip codes in Southern California";
-     */
-    heading: string | nullish;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideActionBar: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideCloseButton: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideCollapseButton: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideFeatureMenuHeading: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideFeatureNavigation: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideFeatureListLayerTitle: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideHeading: boolean;
-    /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
-     *
-     * @default false
-     */
-    hideSpinner: boolean;
-    /**
-     * If true, the component will not be destroyed automatically when it is
-     * disconnected from the document. This is useful when you want to move the
-     * component to a different place on the page, or temporarily hide it. If this
-     * is set, make sure to call the [destroy](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-popup/#destroy) method when you are done to
-     * prevent memory leaks.
+     * The current state of the component.
      *
-     * @default false
+     * @default "disabled"
      */
-    autoDestroyDisabled: boolean;
-    /** Overwrite localized strings for this component */
-    messageOverrides?: typeof this.messages._overrides;
-    /** The widget's default label. */
-    label?: string;
+    readonly state: "ready" | "disabled";
     /**
-     * Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open in the view.
-     * Use the property to check if the popup is visible and is not
+     * Indicates whether the popup is visible. This property is `true` when the popup is querying for results, even if it is not open.
+     * Use the property to check if the popup is visible and is not.
      *
      * @name visible
-     * @instance
      * @type {boolean}
      * @default false
      */
     visible: boolean;
     /**
-     * Removes [promises](#promises), [features](#features), [content](#content),
-     * [title](#title) and [location](#location) from the Popup.
+     * Removes all [promises](#promises), [features](#features), [content](#content),
+     * [heading](#heading) and [location](#location) from the Popup.
      */
     clear(): Promise<void>;
     /** Permanently destroy the component. */
@@ -541,29 +496,27 @@ export declare class ArcgisPopup extends LitElement {
      * 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).
-     * These features can then be used within a custom [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html)
-     * or [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature.html) widget experience.
-     * One example could be a custom side panel that displays feature-specific information based on
-     * an end user's click location. This method allows a developer the ability to
-     * control how the input location is handled, and then subsequently, what to do with the results.
      *
      * @example
-     * // Add Feature widget to UI
-     * view.ui.add(featureWidget, "top-right");
-     *
-     * // Get view's click event
-     * reactiveUtils.on(()=>view, "click", (event)=>{
-     *   // Call fetchFeatures and pass in the click event screenPoint
-     *   view.popup.fetchFeatures(event.screenPoint).then((response) => {
+     * ```js
+     * // Example showing how to use fetchFeatures in an application
+     * // with the popup and feature components.
+     * const popupComponent = document.querySelector("arcgis-popup");
+     * const viewElement = document.querySelector("arcgis-map");
+     * const featureComponent = document.querySelector("arcgis-feature");
+     * // Get viewElement's click event
+     * reactiveUtils.on(()=>viewElement, "arcgisViewClick", (event)=>{
+     *   const { screenPoint } = event.detail;
+     *   // Call fetchFeatures on the popup and pass in the click event screenPoint
+     *   popupComponent.fetchFeatures(screenPoint).then((response) => {
      *     // Access the response from fetchFeatures
      *     response.allGraphicsPromise.then((graphics) => {
-     *       // Set the feature widget's graphic to the returned graphic from fetchFeatures
-     *       featureWidget.graphic = graphics[0];
+     *       // Set the feature component's graphic to the returned graphic from fetchFeatures
+     *       featureComponent.graphic = graphics[0];
      *     });
      *   });
      * });
-     * @since 4.15
-     * @see [Sample - Feature widget - Query graphics from multiple layers](../sample-code/widgets-feature-multiplelayers/index.html)
+     * ```
      */
     fetchFeatures(screenPoint: __esri.ScreenPoint, options?: FetchFeaturesOptions): Promise<__esri.FetchPopupFeaturesResult>;
     /**
@@ -578,45 +531,50 @@ export declare class ArcgisPopup extends LitElement {
      * the popup's [visible](#visible) property to `true`. Users can alternatively open the popup
      * by directly setting the [visible](#visible) property to `true`.
      *
-     * ::: esri-md class="warning"
-     * The popup will only display if
-     * the view's size constraints in [dockOptions](#dockOptions) are met or the [location](#location)
+     * ***Note:***
+     * The popup will only display if the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) size constraints in [dockOptions](#dockOptions) are met or the [location](#location)
      * property is set to a geometry.
-     * :::
      *
-     * @see [Intro to popups](../sample-code/intro-popup/index.html)
-     * @see [Popup.visible](#visible)
-     * @see [Sample - Query with `rest/query`](../sample-code/query/index.html)
-     * @see [Sample - Popup with DOM node](../sample-code/popup-domnode/index.html)
+     * @see [visible](#visible)
      * @example
-     * reactiveUtils.on(()=>view, "click", (event)=>{
-     *   view.popup.open({
-     *    location: event.mapPoint,  // location of the click on the view
+     * ```js
+     * reactiveUtils.on(()=>viewElement, "arcgisViewClick", (event)=>{
+     *  const { mapPoint } = event.detail;
+     *   popupComponent.open({
+     *    location: mapPoint,  // location of the click on the view
      *    title: "You clicked here",  // title displayed in the popup
      *    content: "This is a point of interest"  // content displayed in the popup
      *   });
      * });
+     * ```
      * @example
-     * reactiveUtils.on(()=>view, "click", (event)=>{
-     *    view.popup.open({
-     *      location: event.mapPoint,  // location of the click on the view
+     * ```js
+     * reactiveUtils.on(()=>viewElement, "arcgisViewClick", (event)=>{
+     *    const { mapPoint } = event.detail;
+     *    popupComponent.open({
+     *      location: mapPoint,  // location of the click on the view
      *      fetchFeatures: true // display the content for the selected feature if a popupTemplate is defined.
      *    });
      *  });
+     * ```
      * @example
-     * view.popup.open({
+     * ```js
+     * popupComponent.open({
      *   title: "You clicked here",  // title displayed in the popup
      *   content: "This is a point of interest",  // content displayed in the popup
-     *   location: event.mapPoint,
+     *   location: event.detail.mapPoint,
      *   updateLocationEnabled: true  // updates the location of popup based on
      *   // selected feature's geometry
      * });
+     * ```
      * @example
-     * view.popup.open({
+     * ```js
+     * popupComponent.open({
      *   features: graphics,  // array of graphics
      *   featureMenuOpen: true, // selected features initially display in a list
      *   location: graphics[0].geometry // location of the first graphic in the array of graphics
      * });
+     * ```
      */
     open(options?: __esri.FeaturesViewModelOpenOptions): Promise<void>;
     /**
@@ -625,14 +583,10 @@ export declare class ArcgisPopup extends LitElement {
      * @see [selectedFeatureIndex](#selectedFeatureIndex)
      */
     previous(): Promise<FeaturesViewModel>;
-    /**
-     * Use this method to give focus to the Widget if the widget is able to be focused.
-     *
-     * @since 4.6
-     */
+    /** Use this method to give focus to the Widget if the widget is able to be focused. */
     setFocus(): Promise<void>;
     /**
-     * Triggers the [trigger-action](#event-trigger-action) event and executes the [action](#actions)
+     * Triggers the [arcgisTriggerAction](#arcgisTriggerAction) event and executes the [action](#actions)
      * at the specified index in the [actions](#actions) array.
      */
     triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>;
@@ -643,6 +597,49 @@ export declare class ArcgisPopup extends LitElement {
     readonly arcgisReady: TargetedEvent<this, void>;
     /** Emitted when the component's close button is clicked. */
     readonly arcgisClose: 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)
+     * @example
+     * ```js
+     * viewElement.addEventListener("arcgisViewClick", (event) => {
+     *   const { mapPoint } = event.detail;
+     *   popupComponent.open({
+     *     location: mapPoint,
+     *     fetchFeatures: true,
+     *     actions: [{
+     *       // This text is displayed as a tooltip
+     *       title: "Zoom out",
+     *       // The ID used to reference this action in the event handler
+     *       id: "zoom-out",
+     *       // Sets the icon font used to style the action button
+     *       icon: "magnifying-glass-minus"
+     *     },
+     *     {
+     *       title: "Delete Feature",
+     *       id: "delete-feature-action",
+     *       icon: "trash"
+     *     }]
+     *   });
+     * });
+     *
+     * // Fires each time an action is clicked
+     * reactiveUtils.on(()=> popupComponent, "arcgisTriggerAction", (event)=>{
+     *   // If the zoom-out action is clicked, execute the following code
+     *   if(event.detail.action.id === "zoom-out"){
+     *     // Zoom out two levels (LODs)
+     *     viewElement.goTo({
+     *       center: viewElement.center,
+     *       zoom: viewElement.zoom - 2
+     *     });
+     *   }
+     * });
+     * ```
+     */
     readonly arcgisTriggerAction: TargetedEvent<this, __esri.PopupTriggerActionEvent>;
     private messages;
 }