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

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

@@ -6,130 +6,133 @@ import { nil } from '@arcgis/toolkit/type';
 import { Use } from '@arcgis/lumina/controllers';
 import { JsxNode, PublicLitElement as LitElement, TargetedEvent } from '@arcgis/lumina';
 import { HeadingLevel } from '../../support/heading';
-import { Action } from '../../utils/action-utils';
 import { default as Collection } from '@arcgis/core/core/Collection.js';
 import { ArcgisFeature } from '../arcgis-feature/customElement.js';
+import { default as ActionButton } from '@arcgis/core/support/actions/ActionButton.js';
+import { default as ActionToggle } from '@arcgis/core/support/actions/ActionToggle.js';
 
 declare const useFeaturesViewModel: (component: LitElement & Pick<FeaturesViewModel, never> & import('../../controllers/useViewModel').ViewModelControllerUses<FeaturesViewModel>) => FeaturesViewModel;
 /**
  * The Features component allows users to view a feature's popupTemplate content such as attributes,
- * actions, related records, etc., without having to be tied to the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html).
- * This component looks and behaves similarly to the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Popup.html) component,
- * however unlike Popup, the Features component can be placed outside of the view.
- * For example, when features are selected in the [View](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html),
- * the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Popup.html) component opens within the View whether it is docked
+ * actions, related records, etc., without having to be tied to a [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-scene/) component.
+ * This component looks and behaves similarly to the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html),
+ * however unlike Popup, the Features component can be placed outside of the map or scene component.
+ * For example, when features are selected in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/),
+ * the [Popup](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Popup.html) opens within the map whether it is docked
  * or anchored to the selected feature.
- * With the Features component, the same information that popup provides is shown in a separate container from the view, such as
+ * With the Features component, the same information that Popup provides is shown in a separate container from the map, such as
  * a HTML div within a Calcite Design System
  * [Shell Panel](https://developers.arcgis.com/calcite-design-system/components/shell-panel/).
  *
- * [![features-component-image](../assets/img/apiref/components/features-component.png)](../sample-code/sandbox/?sample=components-features)
- *
- * In the image above, a Calcite shell panel displays the Features component along with a MapView in a separate div.
- * A generic `title` and `content` property can be set directly on the Features component or
- * each individual layer's [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) can be displayed (e.g.
- * the Olympic National Park feature's PopupTemplate that contains text, media, and relationship elements).
- * The action bar, shown below the title in the image above, displays [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) that can be defined either on the component level within the [open()](#open) method,
- * with the [FeaturesViewModel.actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions) property, or in the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of the layer.
  * If multiple features are passed into the Features component, the component provides buttons to page though the features and a feature menu that allows the
  * list of features to be displayed so the user can choose which feature content to display in the component. The component also respects
  * feature reduction PopupTemplates for [binning](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionBinning.html#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-FeatureReductionCluster.html#popupTemplate).
  *
- * The Features component should be used if needing to use the Popup functionality outside of the View. If wanting to show a single feature's content without
- * actions, related records, clustering configuration, etc., then use the [Feature](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Feature.html) component.
+ * The Features component should be used if needing to use the Popup functionality outside of the map or scene component. If wanting to show a single feature's content without
+ * actions, related records, clustering configuration, etc., then use the [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) component.
  *
  * [Read more...](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-features/)
  *
- * @since 4.27
  * @see module :esri/PopupTemplate
- * @see [Sample - Features component](../sample-code/components-features/)
  * @see [Guide - Esri Icon Font](../esri-icon-font/)
- * @see module :esri/components/Features/FeaturesViewModel
- * @example
- * // Create a new instance of Features and set this on the View's
- * // popup. When features are selected in the map, the Features component
- * // will automatically open in its respective container.
- * const view = new MapView({
- *   container: "viewDiv",
- *   map: map,
- *   popup: new Features({
- *     container: "features-component"
- *   })
- * });
- * @example
- * // Create a new instance of Features and set the view property
- * // to the View along with the container that holds the component
- * // such as a Calcite Shell Panel.
- * const featuresComponent = new Features({
- *   view: view,
- *   container: "features-component"
- * });
- *
- * // Use reactiveUtils to watch for when the view has a click event
- * // then open the Features component in its respective container.
- * reactiveUtils.on(()=> view, "click",
- * (event)=>{
- *   featuresComponent.open({
- *     location: event.mapPoint,
- *     fetchFeatures: true
- *   })
- * });
  */
 export declare class ArcgisFeatures extends LitElement {
-    view?: __esri.MapView | __esri.SceneView;
-    referenceElement?: ArcgisReferenceElement | string;
-    /**
-     * Icon which represents the component.
-     * Typically used when the component is controlled by another component (e.g. by the Expand component).
+    viewModel: FeaturesViewModel;
+    /**
+     * [Collection](https://developers.arcgis.com/javascript/latest/api-reference/esri-core-Collection.html) of [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionButton.html) or [action toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects displayed in the action bar.
+     * Each action may be executed by clicking the icon or image symbolizing them.
+     * By default, every component has a `Zoom To` action styled with a magnifying glass icon.
+     * When this icon is clicked, the map zooms in four LODs and centers on the selected feature.
+     * This default action can be removed by setting [`includeDefaultActions`](#includeDefaultActions) to `false`, or by setting the [overwriteActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html#overwriteActions) property to `true` in the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html).
+     * 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.
+     * 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) class.
+     *
+     * @see [arcgisTriggerAction](#arcgisTriggerAction)
+     * @example
+     * ```js
+     * // Defines an action button to zoom out from the selected feature
+     * const zoomOutAction = {
+     *   type: "button",
+     *   // This text is displayed as a tooltip
+     *   title: "Zoom out",
+     *   // The ID by which to reference the action in the event handler
+     *   id: "zoom-out",
+     *   // Sets the icon used to style the action button
+     *   icon: "magnifying-glass-minus"
+     * };
+     * // Adds the custom action to the Features component's actions collection.
+     * featuresComponent.actions.push(zoomOutAction);
+     * ```
+     */
+    actions: Collection<ActionButton | ActionToggle>;
+    /**
+     * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#waitingForResult) for results.
      *
-     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
+     * @default false
      */
-    icon?: string;
+    readonly active: boolean;
     /**
-     * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#waitingForResult).
+     * 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-features/#destroy) method when you are done to
+     * prevent memory leaks.
      *
-     * @since 4.30
      * @default false
      */
-    readonly active: boolean;
+    autoDestroyDisabled: boolean;
     /**
-     * Indicates whether the popup displays its content. If `true`, only the header displays.
+     * Indicates whether the component displays its content. If `true`, only the header displays.
+     * This property is only honored if [`showCollapsed`](#showCollapsed) is `true`.
      *
      * @default false
      */
     collapsed: boolean;
     /**
-     * The content of the Features component. When set directly on the Popup, this content is
+     * The content of the Features 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).
      *
      * @noautocast
      * @example
+     * ```js
      * // This sets generic instructions in the component that will always be displayed
-     * // unless it is overridden by a PopupTemplate
+     * // unless it is overridden by a PopupTemplate.
      * featuresComponent.content = "Click a feature on the map to view its attributes";
+     * ```
      */
     content: string | HTMLElement | nullish | __esri.Widget;
     /**
-     * This property enables showing the list of features.
+     * Enables automatic creation of a popup template for layers that have popups enabled but no
+     * popupTemplate defined.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuOpen)
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#defaultPopupTemplateEnabled)
      *
      * @default false
      */
-    featureMenuOpen: boolean;
+    defaultPopupTemplateEnabled: boolean;
+    /**
+     * The number of selected [features](#features) available to the popup.
+     *
+     * @default 0
+     */
+    readonly featureCount: number;
     /**
-     * The title to display on the widget while viewing the feature menu.
+     * 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".
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureMenuTitle)
+     * @default false
      */
+    featureMenuOpen: boolean;
+    /** Sets the title to display on the component while viewing the feature menu. */
     featureMenuTitle: string | nullish;
     /**
      * Indicates whether the feature navigation arrows are displayed at the top of the component.
      * By default, the navigation arrows are displayed at the bottom of the component.
      *
-     * @since 4.32
      * @default false
      */
     featureNavigationTop: boolean;
@@ -138,17 +141,18 @@ export declare class ArcgisFeatures extends LitElement {
      * 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 [title](#title)
+     * 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).
      *
      * When more than one graphic exists in this array, the current content of the
-     * Features component is set based on the value of the [selected feature](#selectedFeature).
+     * component is set based on the value of the [selected feature](#selectedFeature).
      *
      * This value is `null` if no features are associated with the component.
      *
      * @noautocast
      * @example
+     * ```js
      * // When setting the features property, the graphics pushed to this property
      * // must have a PopupTemplate set.
      * let g1 = new Graphic();
@@ -160,94 +164,38 @@ export declare class ArcgisFeatures extends LitElement {
      * // the component 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];
-     * const featuresComponent = new Features({
-     *   container: "features-component",
-     *   features: graphics
-     *   visible: true
-     * });
+     * featuresComponent.features = graphics;
+     * ```
      */
     features: __esri.Graphic[];
     /**
-     * The actions that are displayed in the header of the component.
-     *
-     * @autocast { typedCollection: true }
-     * @since 4.32
-     */
-    headerActions: Collection<Action>;
-    /**
-     * Indicates the heading level to use for the [title](#title) of the component.
-     * By default, the title 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.
-     *
-     * @default 2
-     */
-    headingLevel: HeadingLevel;
-    /**
-     * Indicates whether to initially display a list of features, or the content for one feature.
+     * The number of features to fetch at one time.
      *
-     * @since 4.32
-     * @default "feature"
+     * @default 20
      */
-    initialDisplayMode: "list" | "feature";
+    featuresPerPage: number;
+    /** Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#Abilities) that can be used when querying and displaying content. */
+    featureViewModelAbilities: nullish | __esri.Abilities;
     /**
-     * A map is required when the input [features](#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/arcade) expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-ExpressionInfo.html) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) that may use the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
+     * 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.
      *
-     * Alternatively, the [view](#view) property can be used to provide the map instance for this property.
-     *
-     * @noautocast
-     * @since 4.30
-     * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
-     * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
      * @example
-     * // The building footprints represent the buildings that intersect a clicked parcel
-     * let buildingFootprints = Intersects($feature, FeatureSetByName($map, "Building Footprints"));
-     * @default null
+     * ```js
+     * features.goToOverride = (map, goToParams)=>  {
+     *   goToParams.options = {
+     *     duration: updatedDuration
+     *   };
+     *   return map.goTo(goToParams.target, goToParams.options);
+     * };
+     * ```
      */
-    map: __esri.Map | nullish;
-    /**
-     * 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.
-     */
-    promises: Promise<__esri.Graphic[]>[];
-    /**
-     * The selected feature accessed by the Features component. The content displayed in the component is
-     * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to this feature.
-     */
-    readonly selectedFeature: nullish | __esri.Graphic;
-    /**
-     * 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](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-UtilityNetworkAssociationsContent.html).
-     *
-     * @since 4.32
-     */
-    get selectedDrillInFeature(): __esri.Graphic | nil;
-    /**
-     * 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-components-Feature.html).
-     * This is useful if needing to get a reference to the Feature component in order to make any changes to it.
-     */
-    get selectedFeatureComponent(): HTMLArcgisFeatureElement | null;
+    goToOverride: nullish | __esri.GoToOverride;
     /**
-     * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
-     * This property should be set if the Features component executes Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
-     *
-     * Alternatively, the [view](#view) property can be used to provide the spatial reference instance for this property.
+     * The actions that are displayed in the header of the component.
      *
-     * @autocast
-     * @since 4.30
-     * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
-     * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
-     * @default null
+     * @autocast { typedCollection: true }
      */
-    spatialReference: nullish | __esri.SpatialReference;
+    headerActions: Collection<ActionButton | ActionToggle>;
     /**
      * The title of the Features component. This can be set to any string value no
      * matter the features that are selected. If the [selected feature](#selectedFeature)
@@ -256,136 +204,177 @@ export declare class ArcgisFeatures extends LitElement {
      *
      * @see [headingLevel](#headingLevel)
      * @example
+     * ```js
      * // This title will display in the component unless a selected feature's
      * // PopupTemplate overrides it.
      * featuresComponent.title = "Population by zip codes in Southern California";
+     * ```
      */
     heading: string | nullish;
     /**
-     * Dates and times displayed in the component will be displayed in this time zone. By default this time zone is
-     * inherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html#timeZone) if the [view](#view) property is set. When a MapView is not associated with the component
-     * then the property will fallback to the `system` time zone.
-     *
-     * **Possible Values**
-     *
-     * Value | Description |
-     * ----- | ----------- |
-     * system  | Dates and times will be displayed in the timezone of the device or browser.
-     * unknown | Dates and time are not adjusted for any timezone.
-     * Specified IANA timezone | Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
+     * Indicates the heading level to use for the [heading](#heading) of the component.
+     * By default, the heading is rendered
+     * as a level 2 heading (e.g. `<h2>Popup title</h2>`). Depending on the component's placement
+     * in your app, you may need to adjust this heading for proper semantics. This is
+     * important for meeting accessibility standards.
      *
-     * @since 4.30
+     * @default 2
      */
-    timeZone: string;
+    headingLevel: HeadingLevel;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the action bar that holds the feature's [actions](#actions).
      *
      * @default false
      */
     hideActionBar: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the close button in the component.
      *
      * @default false
      */
     hideCloseButton: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to show the collapse button in the component.
      *
      * @default false
      */
     showCollapseButton: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the feature menu heading and description in the component's feature menu list.
      *
      * @default false
      */
     hideFeatureMenuHeading: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the feature pagination in the component.
+     * This allows the user to scroll through various [selected features](#features) using pagination arrows.
      *
      * @default false
      */
     hideFeatureNavigation: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the group heading for a list of multiple features.
      *
      * @default false
      */
     hideFeatureListLayerTitle: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Determines whether the component should be shown within its built-in [flow component](https://developers.arcgis.com/calcite-design-system/components/flow/) or if the flow component should be excluded.
+     * The component will be displayed within its original flow component if set to `false`.
+     * The flow component will be omitted from the widget if set to `true`.
+     * To place the component into an existing Calcite flow component, set this property to `false`.
      *
      * @default false
      */
     hideFlow: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the component's [heading](#heading).
      *
      * @default false
      */
     hideHeading: boolean;
     /**
-     * This property provides the ability to turn individual elements of the component's display on/off.
+     * Indicates whether to hide the component's loading spinner.
      *
      * @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-features/#destroy) method when you are done to
-     * prevent memory leaks.
+     * Icon which represents the component.
+     * Typically used when the component is controlled by another component (e.g. by the Expand component).
      *
-     * @default false
+     * @see [Calcite Icons](https://developers.arcgis.com/calcite-design-system/icons/)
      */
-    autoDestroyDisabled: boolean;
+    icon?: string;
     /**
-     * Replace localized message strings with your own strings.
+     * Indicates whether to include the [defaultActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#includeDefaultActions) in the component.
      *
-     * _**Note**: Individual message keys may change between releases._
+     * @default true
      */
-    messageOverrides?: typeof this.messages._overrides;
+    includeDefaultActions: boolean;
+    /**
+     * Indicates whether to initially display a list of features, or the content for one feature.
+     *
+     * @default "feature"
+     */
+    initialDisplayMode: "list" | "feature";
     /** The component's default label. */
     label?: 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 toggle](https://developers.arcgis.com/javascript/latest/api-reference/esri-support-actions-ActionToggle.html) objects.
+     * A map is required when the input [features](#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/arcade) expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-ExpressionInfo.html) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/api-reference/esri-popup-content-ExpressionContent.html) that may use the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
+     *
+     * Alternatively, the [view](#view) property can be used to provide the map instance for this property.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#actions)
+     * @noautocast
+     * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
+     * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
+     * @example
+     * ```js
+     * // The building footprints represent the buildings that intersect a clicked parcel
+     * let buildingFootprints = Intersects($feature, FeatureSetByName($map, "Building Footprints"));
+     * ```
+     * @default null
      */
-    actions: Collection<__esri.ActionButton | __esri.ActionToggle>;
+    map: __esri.Map | nullish;
     /**
-     * Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Feature-FeatureViewModel.html#Abilities) that can be used when querying and displaying content.
+     * Replace localized message strings with your own strings.
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featureViewModelAbilities)
+     * _**Note**: Individual message keys may change between releases._
      */
-    featureViewModelAbilities: nullish | __esri.Abilities;
+    messageOverrides?: typeof this.messages._overrides;
+    /** @deprecated since 4.34, use [`slot`](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/slot) instead. */
     position?: __esri.UIPosition;
     /**
-     * The number of features to fetch at one time.
-     *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#featuresPerPage)
+     * 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.
      *
-     * @default 20
+     * @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)
      */
-    featuresPerPage: number;
+    referenceElement?: ArcgisReferenceElement | string;
+    /**
+     * 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.
+     */
+    promises: Promise<__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.
+     * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-MapView.html) or [SceneView](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-SceneView.html).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#goToOverride)
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#view)
      */
-    goToOverride: nullish | __esri.GoToOverride;
+    view?: __esri.MapView | __esri.SceneView | nullish;
+    /**
+     * 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 Features component. The content displayed in the component is
+     * determined based on the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) assigned to this feature.
+     */
+    readonly selectedFeature: nullish | __esri.Graphic;
+    /**
+     * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-feature/) component.
+     * This is useful if needing to get a reference to the Feature component in order to make any changes to it.
+     */
+    get selectedFeatureComponent(): HTMLArcgisFeatureElement | null;
     /**
-     * Indicates whether or not to include [defaultActions](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#defaultActions).
+     * Index of the feature that is [selected](#selectedFeature). When [features](#features) are set,
+     * the first index is automatically selected.
+     */
+    selectedFeatureIndex: number;
+    /**
+     * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
+     * This property should be set if the Features component executes Arcade expressions that contain [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/).
      *
-     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#includeDefaultActions)
+     * Alternatively, the [view](#view) property can be used to provide the spatial reference instance for this property.
      *
-     * @default true
+     * @autocast
+     * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
+     * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
+     * @default null
      */
-    includeDefaultActions: boolean;
+    spatialReference: nullish | __esri.SpatialReference;
     /**
      * The view model's state.
      *
@@ -395,16 +384,41 @@ export declare class ArcgisFeatures extends LitElement {
      */
     readonly state: "ready" | "disabled";
     /**
-     * Removes [promises](#promises), [features](#features), [content](#content), and
-     * [title](#title) from the Features component.
+     * Dates and times displayed in the component will be displayed in this time zone. By default this time zone is
+     * inherited from [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/arcgis-map/#timeZone) if the [view](#view) property is set. When a MapView is not associated with the component
+     * then the property will fallback to the `system` time zone.
+     *
+     * **Possible Values**
+     * - `system`: Dates and times will be displayed in the timezone of the device or browser.
+     * - `unknown`: Dates and time are not adjusted for any timezone.
+     * - `Specified IANA timezone`: Dates and times will be displayed in the specified IANA time zone. See [wikipedia - List of tz database time zones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones).
      */
-    clear(): Promise<void>;
+    timeZone: string;
     /**
-     * This is a convenience method to closes the component. Users can alternatively close the component
-     * by directly setting the [visible](#visible) property to `false`.
+     * Highlight the selected feature using one of the [HighlightOptions](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-support-HighlightOptions.html) defined in the view's
+     * [highlights](https://developers.arcgis.com/javascript/latest/api-reference/esri-views-View.html#highlights) collection.
      *
-     * @see [Features.visible](#visible)
+     * [Read more...](https://developers.arcgis.com/javascript/latest/api-reference/esri-widgets-Features-FeaturesViewModel.html#highlightEnabled)
+     *
+     * @default true
      */
+    highlightDisabled: boolean;
+    /**
+     * 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
+     *
+     * @name visible
+     * @instance
+     * @type {boolean}
+     * @default false
+     */
+    visible: boolean;
+    /**
+     * Removes [promises](#promises), [features](#features), [content](#content), and
+     * [heading](#heading) from the Features component.
+     */
+    clear(): Promise<void>;
+    /** A convenience method to close the component. */
     close(): Promise<void>;
     /** Permanently destroy the component. */
     destroy(): Promise<void>;
@@ -416,8 +430,9 @@ export declare class ArcgisFeatures extends LitElement {
      * control how the input location is handled.
      *
      * @example
-     * // Use reactiveUtils to watch the view's click event.
-     * reactiveUtils.on(() => view, "click",
+     * ```js
+     * // Use reactiveUtils to watch the map's click event.
+     * reactiveUtils.on(() => map, "arcgisViewClick",
      * (event) => {
      *   // Call fetchFeatures and pass in the click event screenPoint
      *   featuresComponent.fetchFeatures(event.screenPoint).then((response) => {
@@ -429,52 +444,47 @@ export declare class ArcgisFeatures extends LitElement {
      *         featuresComponent.visible = false;
      *       }
      *       // If graphics do exist, set the Features component features property to the returned
-     *       // graphics from fetchFeatures and set the visible property to true.
+     *       // graphics from fetchFeatures.
      *       else{
      *         featuresComponent.features = graphics;
-     *         featuresComponent.visible = true;
      *       }
      *     });
      *   });
+     * ```
      */
     fetchFeatures(screenPoint: __esri.ScreenPoint, options?: __esri.FetchFeaturesOptions): Promise<__esri.FetchPopupFeaturesResult>;
     /**
-     * Selects the feature at the next index in relation to the selected feature.
-     *
-     * @see [selectedFeatureIndex](#selectedFeatureIndex)
-     */
-    next(): Promise<FeaturesViewModel>;
-    /**
-     * Opens the Features component in its [container](#container) with content defined either explicitly with `content`
-     * or driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features. This method sets
-     * the Feature component's [visible](#visible) property to `true`. Users can alternatively show the Features component
-     * by directly setting the [visible](#visible) property to `true`.
+     * Opens the Features component with content defined either explicitly with `content`
+     * or driven from the [PopupTemplate](https://developers.arcgis.com/javascript/latest/api-reference/esri-PopupTemplate.html) of input features.
      *
-     * @see [Sample - Features component](../sample-code/components-features/)
-     * @see [Features.visible](#visible)
      * @example
-     * // Use reactiveUtils to watch the view's click event.
-     * reactiveUtils.on(() => view, "click",
-     * (event) => {
+     * ```js
+     * // Use reactiveUtils to watch the map component's click event.
+     * reactiveUtils.on(() => viewElement, "arcgisViewClick", (event) => {
+     *   const { mapPoint } = event.detail;
      *   featuresComponent.open({
      *     // Title and content displayed in the component
-     *     title: `Click location: (${event.mapPoint.x},${event.mapPoint.y})`,
+     *     title: `Click location: (${mapPoint.x},${mapPoint.y})`,
      *     content: "This is the default content displayed on click."
      *   });
      * });
+     * ```
      * @example
-     * // The Features component must have a view set on the component along with the
+     * ```js
+     * // The Features component must have a reference element set on the component along with the
      * // location property to fetch features.
-     * // Use reactiveUtils to watch the view's click event.
-     * reactiveUtils.on(() => view, "click",
-     * (event) => {
+     * // Use reactiveUtils to watch the map component's click event.
+     * reactiveUtils.on(() => viewElement, "arcgisViewClick", (event) => {
+     *   const { mapPoint } = event.detail;
      *   featuresComponent.open({
-     *     location: event.mapPoint,
+     *     location: mapPoint,
      *     // Display the content for the selected feature(s) if a popupTemplate is defined.
      *     fetchFeatures: true
      *   });
      * });
+     * ```
      * @example
+     * ```js
      * // Open the Features component with a specified array of graphics that already
      * // have a PopupTemplate set and display the feature menu when it opens.
      * featuresComponent.open({
@@ -483,10 +493,17 @@ export declare class ArcgisFeatures extends LitElement {
      *   // selected features initially display in a list
      *   featureMenuOpen: true
      * });
+     * ```
      */
     open(options?: __esri.FeaturesViewModelOpenOptions): Promise<void>;
     /**
-     * Selects the feature at the previous index in relation to the selected feature.
+     * Selects the feature at the next index in relation to the [selected feature](#selectedFeature).
+     *
+     * @see [selectedFeatureIndex](#selectedFeatureIndex)
+     */
+    next(): Promise<FeaturesViewModel>;
+    /**
+     * Selects the feature at the previous index in relation to the [selected feature](#selectedFeature).
      *
      * @see [selectedFeatureIndex](#selectedFeatureIndex)
      */
@@ -494,16 +511,61 @@ export declare class ArcgisFeatures extends LitElement {
     /** Use this method to give focus to the Component if the component is able to be focused. */
     setFocus(): Promise<void>;
     /**
-     * Triggers the [trigger-action](#event-trigger-action) event and executes the [action](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions)
-     * at the specified index in the [actions](https://developers.arcgis.com/javascript/latest/api-reference/esri-components-Features-FeaturesViewModel.html#actions) array.
+     * Triggers the [`arcgisTriggerAction`](#arcgisTriggerAction) event and executes the action
+     * at the specified index in the [actions](#actions) array.
      */
     triggerAction(action: __esri.ActionButton | __esri.ActionToggle): Promise<void>;
     /** Emitted when the value of a property is changed. Use this to listen to changes to properties. */
     readonly arcgisPropertyChange: TargetedEvent<this, {
-        name: "state" | "selectedFeature" | "selectedFeatureIndex";
+        name: "state" | "active" | "collapsed" | "featureCount" | "featureMenuOpen" | "features" | "promises" | "selectedDrillInFeature" | "selectedFeature" | "selectedFeatureComponent" | "selectedFeatureIndex" | "visible";
     }>;
     /** Emitted when the component associated with a map or scene view is ready to be interacted with. */
     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 Features 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 [Features.open()](#open)
+     * @example
+     * ```js
+     * viewElement.addEventListener("arcgisViewClick", (event) => {
+     *   const { mapPoint } = event.detail;
+     *   featuresComponent.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(()=> featuresComponent, "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.FeaturesViewModelTriggerActionEvent>;
     private messages;
 }