npm - @arcgis/map-components - Versions diffs - 5.1.0-next.99 → 5.1.0 - Mend

@arcgis/map-components 5.1.0-next.99 → 5.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2028) hide show

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

@@ -1,20 +1,19 @@
 /// <reference path="../../index.d.ts" />
-import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
+import type FeaturesViewModel from "@arcgis/core/widgets/Features/FeaturesViewModel.js";
 import type Collection from "@arcgis/core/core/Collection.js";
-import type Features from "@arcgis/core/popup/Features.js";
+import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
 import type ActionToggle from "@arcgis/core/support/actions/ActionToggle.js";
 import type Graphic from "@arcgis/core/Graphic.js";
-import type FeatureAbilities from "@arcgis/core/popup/support/FeatureAbilities.js";
-import type FeatureViewModel from "@arcgis/core/widgets/Feature/FeatureViewModel.js";
+import type Widget from "@arcgis/core/widgets/Widget.js";
 import type Map from "@arcgis/core/Map.js";
 import type SpatialReference from "@arcgis/core/geometry/SpatialReference.js";
-import type { ActionEvent, FetchFeaturesOptions } from "@arcgis/core/widgets/Popup/types.js";
-import type { ArcgisFeature } from "../arcgis-feature/customElement.js";
 import type { ArcgisReferenceElement, IconName, HeadingLevel } from "../types.js";
-import type { ScreenPoint } from "@arcgis/core/core/types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
+import type { ArcgisFeature } from "../arcgis-feature/customElement.js";
+import type { ActionEvent, FetchFeaturesOptions, PopupAction, InitialDisplayOptions, State } from "@arcgis/core/widgets/Popup/types.js";
+import type { ScreenPoint } from "@arcgis/core/core/types.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
-import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/popup/types.js";
+import type { Abilities } from "@arcgis/core/widgets/Feature/types.js";
 import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
@@ -34,9 +33,12 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * 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/references/core/layers/support/FeatureReductionBinning/#popupTemplate) and [clustering](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#popupTemplate).
  *
- * The Features component should be used if needing to use the Popup functionality outside of the map or scene component. If wanting to show a single feature's content without
+ * The Features component should be used if needing to use the Popup functionality outside of the map or scene component. To show a single feature's content without
  * actions, related records, clustering configuration, etc., then use the [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component.
  *
+ * > [!WARNING]
+ * > In version 6.0, the implementation of [arcgis-features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/) will be updated under the hood to that of [arcgis-features-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/), and deprecated properties on this component will be removed. We encourage using the [arcgis-features-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/) component and providing feedback.
+ *
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  * @since 4.28
  */
@@ -52,7 +54,7 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor actions: Collection<PopupAction>;
   /**
-   * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult) for results.
+   * Indicates if the component is active when it is visible and is not [waiting](https://developers.arcgis.com/javascript/latest/references/core/widgets/Features/FeaturesViewModel/#waitingForResult) for results.
    *
    * @default false
    */
@@ -73,7 +75,7 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor chartAnimationDisabled: boolean | undefined;
+  accessor chartAnimationDisabled: boolean;
   /**
    * Indicates whether the component displays its content. If `true`, only the header displays.
    * This property is only honored if [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton) is `true`.
@@ -81,6 +83,16 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    */
   accessor collapsed: boolean;
+  /**
+   * Controls the direction the content collapses when the collapse button is used.
+   * When unset, the component chooses a direction based on the [feature navigation placement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureNavigationTop).
+   *
+   * @since 5.1
+   * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton)
+   * @see [collapsed](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapsed)
+   * @see [featureNavigationTop](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureNavigationTop)
+   */
+  accessor collapseDirection: "down" | "up" | undefined;
   /**
    * The content of the component. When set directly on the component, this content is static and cannot use fields to set content templates. To set a template for the content based on field or attribute names, see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content).
    *
@@ -91,7 +103,7 @@ export abstract class ArcgisFeatures extends LitElement {
    * component.content = "Click a feature on the map to view its attributes";
    * ```
    */
-  accessor content: string | HTMLElement | null | undefined;
+  accessor content: string | HTMLElement | Widget<any> | null | undefined;
   /**
    * Enables automatic creation of a popup template for layers that have popups enabled but no popupTemplate defined. Automatic popup templates are supported for layers that support the `createPopupTemplate` method.
    *
@@ -103,21 +115,19 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor defaultPopupTemplateEnabled: boolean;
   /**
-   * The heading currently displayed for the selected feature. This value resolves to the [selected feature item's heading](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#effectiveHeading) when available, otherwise it falls back to the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading).
+   * The heading currently displayed for the selected feature. This value resolves to the selected feature's [PopupTemplate title](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#title) when available, otherwise it falls back to the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading).
    *
    * @since 5.1
    * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading)
    * @see [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)
    */
-  get effectiveHeading(): string | null | undefined;
+  get effectiveHeading(): string | undefined;
   /**
    * The number of [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) available in the component.
    *
    * @since 4.34
    */
   accessor featureCount: number;
-  /** Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/FeatureViewModel/#Abilities) that can be used when querying and displaying content. */
-  accessor featureItemAbilities: FeatureAbilities | null | undefined;
   /**
    * This property enables multiple features in the component to display in a list rather than displaying the first selected feature. Setting this to `true` allows the user to scroll through the list of features. This value will only be honored if [initialDisplayMode](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#initialDisplayMode) is set to "feature".
    *
@@ -130,19 +140,22 @@ export abstract class ArcgisFeatures extends LitElement {
    *
    * @since 4.34
    */
-  accessor featureMenuTitle: string | undefined;
+  accessor featureMenuTitle: string | null | undefined;
   /**
    * Indicates whether the feature navigation arrows are displayed at the top of the component.
    * By default, the navigation arrows are displayed at the bottom of the component.
+   * This property also controls the collapse button's icon direction when the [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection) property is not set. When `featureNavigationTop` is `true`, the collapse button icon defaults to collapsing "up" and when `false` it defaults to collapsing "down".
    *
    * @default false
    * @since 4.34
+   * @see [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection)
+   * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton)
    */
   accessor featureNavigationTop: boolean;
   /**
-   * An array of features associated with the component. Each graphic in this array must have a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) set. They may share the same [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) or have unique [PopupTemplates](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) depending on their attributes. The [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) of the component is set based on the `content` and `title` properties of each graphic's respective [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
+   * An array of graphics associated with the component. Each graphic in this array must have a valid [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) set. They may share the same [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) or have unique [PopupTemplates](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) depending on their attributes. The [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) of the component is set based on the `content` and `title` properties of each graphic's respective [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
    *
-   * When more than one graphic exists in this array, the current content of the component is set based on the value of the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)).
+   * When more than one graphic exists in this array, the current content of the component is set based on the value of the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
    *
    * This value is `null` if no features are associated with the component.
    *
@@ -169,12 +182,8 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default 20
    */
   accessor featuresPerPage: number;
-  /**
-   * Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/FeatureViewModel/#Abilities) that can be used when querying and displaying content.
-   *
-   * @deprecated since 5.1. Use [featureItemAbilities](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureItemAbilities) instead to set abilities on a per feature basis.
-   */
-  accessor featureViewModelAbilities: FeatureViewModel["abilities"] | null | undefined;
+  /** Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/FeatureViewModel/#Abilities) that can be used when querying and displaying content. */
+  accessor featureViewModelAbilities: Abilities | null | undefined;
   /**
    * This function provides the ability to override either the [arcgis-map.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#goTo) or [arcgis-scene.goTo()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#goTo) methods.
    *
@@ -230,7 +239,7 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor hideAttachmentsContent: boolean | undefined;
+  accessor hideAttachmentsContent: boolean;
   /**
    * Indicates whether to hide the close button in the component.
    *
@@ -250,7 +259,7 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor hideCustomContent: boolean | undefined;
+  accessor hideCustomContent: boolean;
   /**
    * This property provides the ability to hide or show [expression content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) within the component.
    *
@@ -283,9 +292,9 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor hideFieldsContent: boolean | undefined;
+  accessor hideFieldsContent: boolean;
   /**
-   * Indicates whether to hide the heading in the component.
+   * Indicates whether to hide the component's [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading).
    *
    * @default false
    */
@@ -303,14 +312,14 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor hideMediaContent: boolean | undefined;
+  accessor hideMediaContent: boolean;
   /**
    * This property provides the ability to hide or show [relationship content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideRelationshipContent: boolean | undefined;
+  accessor hideRelationshipContent: boolean;
   /**
    * Indicates whether to hide the *select feature* action when viewing associated and related features.
    *
@@ -330,14 +339,14 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    * @since 5.0
    */
-  accessor hideTextContent: boolean | undefined;
+  accessor hideTextContent: boolean;
   /**
    * This property provides the ability to hide or show [utility network content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/) within the component.
    *
    * @default false
    * @since 5.0
    */
-  accessor hideUtilityNetworkContent: boolean | undefined;
+  accessor hideUtilityNetworkContent: boolean;
   /**
    * Indicates whether to highlight the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature) in the associated
    * [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/) or [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/) component.
@@ -394,12 +403,9 @@ export abstract class ArcgisFeatures extends LitElement {
   accessor messageOverrides: {
       componentLabel?: string | undefined;
       zoom?: string | undefined;
-      browseAggregatedFeatures?: string | undefined;
-      aggregatedFeatures?: string | undefined;
-      aggregatedFeaturesPlaceholder?: string | undefined;
+      browseClusteredFeatures?: string | undefined;
       collapse?: string | undefined;
       expand?: string | undefined;
-      noAggregatedFeatures?: string | undefined;
       featuresList?: string | undefined;
       total?: string | undefined;
       pageText?: string | undefined;
@@ -416,17 +422,18 @@ export abstract class ArcgisFeatures extends LitElement {
       back?: string | undefined;
       errorMessage?: string | undefined;
       returnToInitialFeature?: string | undefined;
+      maxRecordCountHeading?: string | undefined;
+      maxRecordCountDescriptionWithLayerList?: string | undefined;
+      maxRecordCountDescriptionMultipleLayers?: string | undefined;
+      maxRecordCountDescriptionMaxZoomLevel?: string | undefined;
   };
   /** @internal */
   protected messages: Partial<{
       componentLabel: string;
       zoom: string;
-      browseAggregatedFeatures: string;
-      aggregatedFeatures: string;
-      aggregatedFeaturesPlaceholder: string;
+      browseClusteredFeatures: string;
       collapse: string;
       expand: string;
-      noAggregatedFeatures: string;
       featuresList: string;
       total: string;
       pageText: string;
@@ -443,15 +450,16 @@ export abstract class ArcgisFeatures extends LitElement {
       back: string;
       errorMessage: string;
       returnToInitialFeature: string;
+      maxRecordCountHeading: string;
+      maxRecordCountDescriptionWithLayerList: string;
+      maxRecordCountDescriptionMultipleLayers: string;
+      maxRecordCountDescriptionMaxZoomLevel: string;
   }> & T9nMeta<{
       componentLabel: string;
       zoom: string;
-      browseAggregatedFeatures: string;
-      aggregatedFeatures: string;
-      aggregatedFeaturesPlaceholder: string;
+      browseClusteredFeatures: string;
       collapse: string;
       expand: string;
-      noAggregatedFeatures: string;
       featuresList: string;
       total: string;
       pageText: string;
@@ -468,15 +476,16 @@ export abstract class ArcgisFeatures extends LitElement {
       back: string;
       errorMessage: string;
       returnToInitialFeature: string;
+      maxRecordCountHeading: string;
+      maxRecordCountDescriptionWithLayerList: string;
+      maxRecordCountDescriptionMultipleLayers: string;
+      maxRecordCountDescriptionMaxZoomLevel: string;
   }>;
   /**
    * Indicates whether the component is visible. This property is `true` when the component is querying for results, even if it is not open. Use this property to check if the component is visible.
    *
-   * When setting the [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) directly, it is recommended to call [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#clear) before setting `open` to `true` to remove any existing promises, features, heading, location, and content from the component. Otherwise, the old content will display.
-   *
    * @default false
-   * @see [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures)
-   * @see [active](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#active)
+   * @see [active](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#active)
    * @see [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#clear)
    * @since 5.0
    * @example
@@ -484,7 +493,6 @@ export abstract class ArcgisFeatures extends LitElement {
    * // Listen for clicks on the view and open the component at the clicked location with custom content.
    * viewElement.addEventListener("arcgisViewClick", (event) => {
    *   const { mapPoint } = event.detail;
-   *   component.clear();
    *   component.location = mapPoint;
    *   component.heading = "You clicked here";
    *   component.content = "Latitude: " + mapPoint.latitude.toFixed(3) + ", Longitude: " + mapPoint.longitude.toFixed(3);
@@ -498,6 +506,8 @@ export abstract class ArcgisFeatures extends LitElement {
    * 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](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) array.
+   *
+   * @deprecated since 5.1.
    */
   accessor promises: Array<Promise<Array<Graphic>>>;
   /**
@@ -535,6 +545,8 @@ export abstract class ArcgisFeatures extends LitElement {
    * Indicates whether to show the collapse button in the component.
    *
    * @default false
+   * @see [collapsed](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapsed)
+   * @see [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection)
    */
   accessor showCollapseButton: boolean;
   /**
@@ -568,7 +580,7 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   accessor timeZone: string;
   /**
-   * Indicates whether to update the feature location when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex) changes.
+   * Indicates whether to update the component's location when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex) changes.
    *
    * @default false
    * @since 5.0
@@ -581,14 +593,16 @@ export abstract class ArcgisFeatures extends LitElement {
    * - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) or [bin](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/)).
    * - Values from `date` and `timestamp-offset` fields should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/references/core/views/View/#timeZone).
    * Alternatively, set the [timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#timeZone) property.
-   * - Using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures) method or the `fetchFeatures` option in the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open) method.
    * - Using the `Zoom to` default action. If the `view` is not specified, set the [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#includeDefaultActionsDisabled) property to `true` to remove this default action.
    *
    * @since 4.34
    */
   accessor view: MapViewOrSceneView | null | undefined;
-  /** @since 4.34 */
-  accessor viewModel: Features;
+  /**
+   * @deprecated since 5.1. Use properties directly on the component instead of accessing them through the `viewModel`. For example, instead of `viewModel.active`, use `active`.
+   * @since 4.34
+   */
+  accessor viewModel: FeaturesViewModel;
   /**
    * Removes [promises](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#promises), [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features), [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content), and
    * [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) from the Features component.
@@ -601,39 +615,31 @@ export abstract class ArcgisFeatures extends LitElement {
   /**
    * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) in the [view](https://developers.arcgis.com/javascript/latest/references/core/views/View/). In order to use this, a layer must already have an associated [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled). This method allows a developer to control how the input location is handled. For example, you may want to fetch features on a `click` event or on a `pointer-move` event. This method automatically sets the location based on the input event's screen coordinates.
    *
+   * @deprecated since 5.1. Use the `fetchPopupFeatures` method on the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#fetchPopupFeatures), [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#fetchPopupFeatures), or [Link Chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/#fetchPopupFeatures) component to fetch features based on a screen location.
    * @param screenPoint
    * @param options
+   * @deprecated
    * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open)
-   * @example
-   * ```js
-   * const viewElement = document.querySelector("arcgis-map");
-   * // Get viewElement's click event
-   * reactiveUtils.on(()=>viewElement, "arcgisViewClick", async (event)=>{
-   *   // Call fetchFeatures on the component and pass in the click event detail
-   *   await component.fetchFeatures(event.detail);
-   * });
-   * // Watch for changes to the features property and open the component when features are available.
-   * reactiveUtils.watch(
-   *   () => component.features,
-   *   () => {
-   *     component.open = component.features ? true : false;
-   *   },
-   * );
-   * ```
    */
   fetchFeatures(screenPoint?: ScreenPoint, options?: FetchFeaturesOptions): Promise<void>;
   /**
    * Selects the feature at the next index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
    *
+   * > [!WARNING]
+   * > The return type of `FeaturesViewModel` on the `next()` method is deprecated. At 6.0, this method will return void. See [arcgis-features-next.next()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#next) for the updated usage.
+   *
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
    */
-  next(): Promise<Features>;
+  next(): Promise<FeaturesViewModel>;
   /**
    * Selects the feature at the previous index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
    *
+   * > [!WARNING]
+   * > The return type of `FeaturesViewModel` on the `previous()` method is deprecated. At 6.0, this method will return void. See [arcgis-features-next.previous()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#previous) for the updated usage.
+   *
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
    */
-  previous(): Promise<Features>;
+  previous(): Promise<FeaturesViewModel>;
   /**
    * Use this method to give focus to the Component if the component is able to be focused.
    *