@arcgis/core 5.1.0-next.65 → 5.1.0-next.67

package/popup/Features.d.ts

@@ -8,11 +8,10 @@ import type FeatureAbilities from "./support/FeatureAbilities.js";
 import type { EventedAccessor } from "../core/Evented.js";
 import type { ScreenPoint } from "../core/types.js";
 import type { SpatialReferenceProperties } from "../geometry/SpatialReference.js";
-import type { State, FetchFeaturesOptions } from "./types.js";
+import type { FetchFeaturesOptions, InitialDisplayOptions, PopupAction, State } from "./types.js";
 import type { TimeZone } from "../time/types.js";
 import type { MapViewOrSceneView } from "../views/MapViewOrSceneView.js";
 import type { FetchPopupFeaturesResult } from "../views/types.js";
-import type { ActionEvent, InitialDisplayOptions, PopupAction } from "../widgets/Popup/types.js";
 import type { GoTo, GoToProperties } from "../widgets/support/GoTo.js";
 import type { GoToParameters } from "../widgets/support/types.js";
 import type { ActionToggleProperties } from "../support/actions/ActionToggle.js";
@@ -21,27 +20,22 @@ import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 import type { FeatureAbilitiesProperties } from "./support/FeatureAbilities.js";
 import type { PointProperties } from "../geometry/Point.js";
 
-export interface FeaturesProperties extends GoToProperties, Partial<Pick<Features, "activeFeature" | "browseClusterEnabled" | "content" | "defaultPopupTemplateEnabled" | "featurePage" | "features" | "featuresPerPage" | "heading" | "highlightEnabled" | "includeDefaultActions" | "initialDisplayMode" | "map" | "open" | "promises" | "selectedFeatureIndex" | "updateLocationEnabled" | "view" | "zoomFactor">> {
+export interface FeaturesProperties extends GoToProperties, Partial<Pick<Features, "activeFeature" | "browseClusterEnabled" | "clusterFeatures" | "content" | "defaultPopupTemplateEnabled" | "featurePage" | "features" | "featuresPerPage" | "heading" | "highlightEnabled" | "includeDefaultActions" | "initialDisplayMode" | "map" | "open" | "promises" | "selectedFeatureIndex" | "updateLocationEnabled" | "view" | "zoomFactor">> {
   /**
    * [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects.
    * Each action may be executed by clicking the icon or image symbolizing them.
-   * By default, every popup and Features widget has a `Zoom To` action styled with a magnifying glass icon ![popupTemplate-zoom-action](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-zoom-action.avif).
+   * By default, a `Zoom To` action styled with a magnifying glass icon is included.
    * 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](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#includeDefaultActions) to `false`, or by setting the
+   * This default action can be removed by setting [includeDefaultActions](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#includeDefaultActions) to `false`, or by setting the
    * [PopupTemplate.overwriteActions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
    * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/).
    *
-   * The [@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#event-trigger-action) event fires each time an action is clicked.
-   *
-   * Actions are defined with the properties listed in the [ActionButton](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [ActionToggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) class.
-   *
-   * @see [@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#event-trigger-action)
    * @see [Sample - Popup actions](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
    * @example
+   * ```js
    * // Defines an action button to zoom out from the selected feature
    * const zoomOutAction = new ActionButton({
-   *   // 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",
@@ -49,30 +43,27 @@ export interface FeaturesProperties extends GoToProperties, Partial<Pick<Feature
    *   icon: "magnifying-glass-minus"
    * });
    * // Adds the custom action to the popup.
-   * view.popup.viewModel.actions.push(zoomOutAction);
-   *
-   * // Adds the custom action to the Features widget
-   * featuresWidget.viewModel.actions.push(zoomOutAction);
+   * featuresModel.actions.push(zoomOutAction);
+   * ```
    */
   actions?: ReadonlyArrayOrCollection<((ActionButtonProperties & { type: "button" }) | (ActionToggleProperties & { type: "toggle" }))>;
-  /** Defines the specific [Abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/types/#Abilities) that can be used when querying and displaying content. */
+  /** Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that can be used when querying and displaying content. */
   featureItemAbilities?: FeatureAbilitiesProperties | null;
   /**
    * Geometry used to show the location of the feature. This is automatically set when selecting a feature. If displaying content not related
    * to features in the map, such as the results from a task, then you must set this
-   * property before making the widget [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open) to the user.
+   * property before setting [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open) to `true`.
    *
    * @see [Get started with popups](https://developers.arcgis.com/javascript/latest/sample-code/intro-popup/)
    * @example
-   * // Sets the location of the popup to the center of the view
-   * view.popup.viewModel.location = view.center;
-   * // Displays the popup
-   * view.popup.visible =  true;
+   * // Sets the location to the center of the view
+   * featuresItem.location = view.center;
+   * featuresItem.open = true;
    * @example
-   * // Display a popup when and where the user clicks the view.
+   * // Display the featuresItem when and where the user clicks the view.
    * reactiveUtils.on(()=>view, "click", ({ mapPoint })=>{
-   *   view.popup.viewModel.location = mapPoint;
-   *   view.popup.visible = true;
+   *   featuresItem.location = mapPoint;
+   *   featuresItem.open = true;
    * });
    */
   location?: PointProperties | null;
@@ -82,15 +73,13 @@ export interface FeaturesProperties extends GoToProperties, Partial<Pick<Feature
    *
    * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property can be used to provide the spatial reference instance for this property.
    *
-   * @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/)
    */
   spatialReference?: SpatialReferenceProperties | null;
   /**
    * Dates and times will be displayed in this time zone. By default this time zone is
-   * inherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property is set. When a MapView is not associated with the widget view model,
-   * then the property will fallback to the `system` time zone.
+   * inherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property is set. When a MapView is not associated, then the property will fallback to the `system` time zone.
    *
    * **Possible Values**
    *
@@ -99,140 +88,35 @@ export interface FeaturesProperties extends GoToProperties, Partial<Pick<Feature
    * 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).
-   *
-   * @since 4.30
    */
   timeZone?: TimeZone | null;
 }
 
-export interface FeaturesEvents {
-  /**
-   * Fires after the user clicks on an [action](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) in the action bar. This
-   * event may be used to define a custom function to execute when particular
-   * actions are clicked. See the example below for details of how this works.
-   *
-   * @see [Popup.actions](https://developers.arcgis.com/javascript/latest/references/core/widgets/Popup/#actions)
-   * @see [PopupTemplate.actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions)
-   * @see [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open)
-   * @example
-   * featuresWidget.open({
-   *   location: event.mapPoint,
-   *   fetchFeatures: true,
-   *   featureMenuOpen: true,
-   *   actions: [new ActionButton({
-   *     // 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 for the action button
-   *     icon: "magnifying-glass"
-   *   }),
-   *   new ActionButton({
-   *     title: "Delete Feature",
-   *     id: "delete-feature-action",
-   *     icon: "trash"
-   *   })]
-   * });
-   *
-   * // Fires each time an action is clicked
-   * reactiveUtils.on(()=> featuresWidget, "trigger-action", (event)=>{
-   *   // If the zoom-out action is clicked, execute the following code
-   *   if(event.action.id === "zoom-out"){
-   *     // Zoom out two levels (LODs)
-   *     view.goTo({
-   *       center: view.center,
-   *       zoom: view.zoom - 2
-   *     });
-   *   }
-   * });
-   * @example
-   * // Defines an action button to zoom out from the selected feature
-   * const zoomOutAction = new ActionButton({
-   *   // 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 popup.
-   * view.popup.actions.push(zoomOutAction);
-   *
-   * // This event fires for each click on any action
-   * reactiveUtils.on(()=>view.popup?.viewModel, "trigger-action", (event)=>{
-   *   // If the zoom-out action is clicked, fire the zoomOut() function
-   *   if(event.action.id === "zoom-out"){
-   *     // in this case the view zooms out two LODs on each click
-   *     view.goTo({
-   *       center: view.center,
-   *       zoom: view.zoom - 2
-   *     });
-   *   }
-   * });
-   * @example
-   * // Defines an action button to zoom out from the selected feature
-   * const zoomOutAction = new ActionButton({
-   *   // 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 popup.
-   * view.popup.actions.push(zoomOutAction);
-   *
-   * // This event fires for each click on any action
-   * reactiveUtils.on(()=>view.popup?.popupViewModel, "trigger-action", (event)=>{
-   *   // If the zoom-out action is clicked, fire the zoomOut() function
-   *   if(event.action.id === "zoom-out"){
-   *     // in this case the view zooms out two LODs on each click
-   *     view.goTo({
-   *       center: view.center,
-   *       zoom: view.zoom - 2
-   *     });
-   *   }
-   * });
-   */
-  "trigger-action": ActionEvent;
-}
-
 /**
- * Provides the logic for the [Features](https://developers.arcgis.com/javascript/latest/references/core/widgets/Features/) widget and [component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/).
+ * Provides reactive state and behavior for the [Features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/) component, including fetching and paging popup features, tracking selection, and coordinating highlighting and actions.
  *
- * @since 4.27
- * @see [Features](https://developers.arcgis.com/javascript/latest/references/core/widgets/Features/) widget - _Deprecated since 4.34. Use the [Features component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features) instead._
+ * @since 5.1
  * @see [Features component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/)
+ * @see [Popup component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/)
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
  */
 export default class Features extends FeaturesSuperclass {
-  /**
-   * @deprecated
-   * Do not directly reference this property.
-   * Use EventNames and EventTypes helpers from \@arcgis/core/Evented
-   */
-  "@eventTypes": FeaturesEvents;
   constructor(properties?: FeaturesProperties);
   /**
    * [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) objects.
    * Each action may be executed by clicking the icon or image symbolizing them.
-   * By default, every popup and Features widget has a `Zoom To` action styled with a magnifying glass icon ![popupTemplate-zoom-action](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-zoom-action.avif).
+   * By default, a `Zoom To` action styled with a magnifying glass icon is included.
    * 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](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#includeDefaultActions) to `false`, or by setting the
+   * This default action can be removed by setting [includeDefaultActions](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#includeDefaultActions) to `false`, or by setting the
    * [PopupTemplate.overwriteActions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#overwriteActions) property to `true` in a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/).
    * The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/).
    *
-   * The [@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#event-trigger-action) event fires each time an action is clicked.
-   *
-   * Actions are defined with the properties listed in the [ActionButton](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [ActionToggle](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/) class.
-   *
-   * @see [@trigger-action](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#event-trigger-action)
    * @see [Sample - Popup actions](https://developers.arcgis.com/javascript/latest/sample-code/popup-actions/)
    * @example
+   * ```js
    * // Defines an action button to zoom out from the selected feature
    * const zoomOutAction = new ActionButton({
-   *   // 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",
@@ -240,46 +124,46 @@ export default class Features extends FeaturesSuperclass {
    *   icon: "magnifying-glass-minus"
    * });
    * // Adds the custom action to the popup.
-   * view.popup.viewModel.actions.push(zoomOutAction);
-   *
-   * // Adds the custom action to the Features widget
-   * featuresWidget.viewModel.actions.push(zoomOutAction);
+   * featuresModel.actions.push(zoomOutAction);
+   * ```
    */
   get actions(): Collection<PopupAction>;
   set actions(value: ReadonlyArrayOrCollection<((ActionButtonProperties & { type: "button" }) | (ActionToggleProperties & { type: "toggle" }))>);
   /**
-   * Indicates if the view model is open and is not [waiting for results](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult).
+   * Indicates if the features component is open and is not [waiting for results](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult).
    *
    * @see [waitingForResult](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult)
    * @see [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open)
    */
   get active(): boolean;
-  /**
-   * The highlighted feature on the map that is either hovered over or in focus within the feature menu.
-   *
-   * @since 4.32
-   */
+  /** The highlighted feature on the map that is either hovered over or in focus within the feature menu. */
   accessor activeFeature: Graphic | null | undefined;
   /** A collection of [actions](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/) or [action toggles](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionToggle/). */
   get allActions(): Collection<PopupAction>;
   /**
    * Indicates if the "Browse features" experience is active in a
-   * [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) popup. This value becomes
+   * [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/). This value becomes
    * `true` when the user enables feature browsing with the "Browse features" cluster
    * [action button](https://developers.arcgis.com/javascript/latest/references/core/support/actions/ActionButton/).
-   * It becomes `false` when the view scale changes, when the widget is closed, or when the user disables
+   * It becomes `false` when the view scale changes, when the component is closed, or when the user disables
    * the "Browse features" action. This should only be set programmatically when the
    * [selectedFeature](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeature) is
    * an [aggregate graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) and represents a cluster.
    *
    * @default false
    * @example
+   * ```js
    * // open the browse features experience for a cluster graphic
-   * featuresWidget.viewModel.browseClusterEnabled = featuresWidget.viewModel.selectedFeature?.isAggregate;
-   *
-   * view.popup.viewModel.browseClusterEnabled = view.popup.viewModel.selectedFeature?.isAggregate;
+   * features.browseClusterEnabled = features.selectedFeature?.isAggregate;
+   * ```
    */
   accessor browseClusterEnabled: boolean;
+  /**
+   * The features returned when browsing members of a selected cluster.
+   * This state is separate from [features](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#features), which continues to represent
+   * the primary popup feature set.
+   */
+  accessor clusterFeatures: Graphic[] | null | undefined;
   /**
    * The information to display. When this property is set, this content may
    * only be static and cannot use fields to set content templates. To set a template
@@ -288,13 +172,11 @@ export default class Features extends FeaturesSuperclass {
    *
    * @see [Sample - Popup Docking](https://developers.arcgis.com/javascript/latest/sample-code/popup-docking-position/)
    * @example
+   * ```js
    * // This sets generic instructions in the popup that will always be displayed
    * // unless it is overridden by a PopupTemplate.
-   * // This can be set on the Features widget view model
-   * featuresWidget.viewModel.content = "Click a feature on the map to view its attributes";
-   *
-   * // Or set on the Popup widget view model.
-   * view.popup.viewModel.content = "Click a feature on the map to view its attributes";
+   * features.content = "Click a feature on the map to view its attributes";
+   * ```
    */
   accessor content: string | HTMLElement | null | undefined;
   /**
@@ -310,14 +192,24 @@ export default class Features extends FeaturesSuperclass {
    * 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. (Supported for
+   * [BuildingComponentSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/buildingSublayers/BuildingComponentSublayer/),
+   * [CatalogFootprintLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/catalog/CatalogFootprintLayer/),
+   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
    * [FeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/),
    * [GeoJSONLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/GeoJSONLayer/),
+   * [ImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer/)),
+   * [ImageryTileLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryTileLayer/),
+   * [KnowledgeGraphSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/knowledgeGraph/KnowledgeGraphSublayer/),
    * [OGCFeatureLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/OGCFeatureLayer/),
-   * [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
-   * [CSVLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/CSVLayer/),
+   * [ParquetLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ParquetLayer/),
    * [PointCloudLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/PointCloudLayer/),
-   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/), and
-   * [ImageryLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/ImageryLayer/)).
+   * [SceneLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/SceneLayer/),
+   * [StreamLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/StreamLayer/),
+   * [Sublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Sublayer/),
+   * [SubtypeSublayer](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/),
+   * [VoxelLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/VoxelLayer/),
+   * [WCSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WCSLayer/), and
+   * [WFSLayer](https://developers.arcgis.com/javascript/latest/references/core/layers/WFSLayer/)).
    *
    * @default false
    */
@@ -328,16 +220,14 @@ export default class Features extends FeaturesSuperclass {
    * @default 0
    */
   get featureCount(): number;
-  /** Defines the specific [Abilities](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/types/#Abilities) that can be used when querying and displaying content. */
+  /** Defines the specific [FeatureAbilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) that can be used when querying and displaying content. */
   get featureItemAbilities(): FeatureAbilities | null | undefined;
   set featureItemAbilities(value: FeatureAbilitiesProperties | null | undefined);
-  /** An array of [Feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Feature/) item view model(s). */
+  /** An array of [Feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Feature/) items. */
   get featureItems(): Feature[];
   /**
    * The current page number in the feature browsing menu. If the feature menu is not open, this value is `null`.
    * This value is dependent on the [featuresPerPage](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#featuresPerPage).
-   *
-   * @since 4.32
    */
   accessor featurePage: number | null | undefined;
   /**
@@ -346,15 +236,13 @@ export default class Features extends FeaturesSuperclass {
    * [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/core/popup/Features/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#heading) properties
-   * are set based on the `content` and `heading` properties of each graphic's respective
+   * are 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
-   * Popup is set based on the value of the [selected feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeature).
-   *
-   * This value is `null` if there are no features associated with the view model.
+   * When more than one graphic exists in this array, the current content is set based on the value of the [selected feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeature).
    *
    * @example
+   * ```js
    * // When setting the features property, the graphics pushed to this property
    * // must have a PopupTemplate set.
    * let g1 = new Graphic();
@@ -366,9 +254,8 @@ export default class Features extends FeaturesSuperclass {
    * // 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];
-   * // This value can be set on the popup  or Features view model.
-   * view.popup.viewModel.features = graphics;
-   * featuresWidget.viewModel.features = graphics;
+   * featuresItem.features = graphics;
+   * ```
    */
   accessor features: Graphic[];
   /**
@@ -378,15 +265,17 @@ export default class Features extends FeaturesSuperclass {
    */
   accessor featuresPerPage: number;
   /**
-   * The heading of the widget. This can be set to any string value no
+   * The heading. This can be set to any string value no
    * matter the features that are selected. If the [selected feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeature)
-   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), then the heading set in the
+   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), then the title set in the
    * corresponding template is used here.
    *
    * @example
+   * ```js
    * // This heading will display in the popup unless a selected feature's
    * // PopupTemplate overrides it.
-   * view.popup.viewModel.heading = "Population by zip codes in Southern California";
+   * featureComponent.heading = "Population by zip codes in Southern California";
+   * ```
    */
   accessor heading: string | null | undefined;
   /**
@@ -406,32 +295,30 @@ export default class Features extends FeaturesSuperclass {
    * @default true
    * @example
    * // Removes the default actions
-   * viewModel.includeDefaultActions = false;
+   * featureComponent.includeDefaultActions = false;
    */
   accessor includeDefaultActions: boolean;
   /**
    * Indicates whether to initially display a list of features, or the content for one feature.
    *
    * @default "feature"
-   * @since 4.32
    */
   accessor initialDisplayMode: InitialDisplayOptions;
   /**
    * Geometry used to show the location of the feature. This is automatically set when selecting a feature. If displaying content not related
    * to features in the map, such as the results from a task, then you must set this
-   * property before making the widget [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open) to the user.
+   * property before setting [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open) to `true`.
    *
    * @see [Get started with popups](https://developers.arcgis.com/javascript/latest/sample-code/intro-popup/)
    * @example
-   * // Sets the location of the popup to the center of the view
-   * view.popup.viewModel.location = view.center;
-   * // Displays the popup
-   * view.popup.visible =  true;
+   * // Sets the location to the center of the view
+   * featuresItem.location = view.center;
+   * featuresItem.open = true;
    * @example
-   * // Display a popup when and where the user clicks the view.
+   * // Display the featuresItem when and where the user clicks the view.
    * reactiveUtils.on(()=>view, "click", ({ mapPoint })=>{
-   *   view.popup.viewModel.location = mapPoint;
-   *   view.popup.visible = true;
+   *   featuresItem.location = mapPoint;
+   *   featuresItem.open = true;
    * });
    */
   get location(): Point | null | undefined;
@@ -450,11 +337,12 @@ export default class Features extends FeaturesSuperclass {
    */
   accessor map: EsriMap | null | undefined;
   /**
-   * Indicates whether the widget is open. This property is `true` when the widget is querying for results, even if it is not open in the view.
-   * Use the [active](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#active) property to check if the widget is open and is not [waiting for results](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult).
+   * Indicates whether the component is open. This property is `true` when querying for results, even if it is not open.
+   * Use the [active](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#active) property to check if the component is open and is not [waiting for results](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult).
    *
    * @default false
    * @see [active](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#active)
+   * @see [waitingForResult](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#waitingForResult)
    */
   accessor open: boolean;
   /**
@@ -494,11 +382,7 @@ export default class Features extends FeaturesSuperclass {
    * the first index is automatically selected.
    */
   accessor selectedFeatureIndex: number;
-  /**
-   * The selected [Feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Feature/) item view model.
-   *
-   * @since 4.32
-   */
+  /** The selected [Feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Feature/) item. */
   get selectedFeatureItem(): Feature;
   /**
    * The spatial reference used for [Arcade](https://developers.arcgis.com/arcade) operations.
@@ -506,22 +390,20 @@ export default class Features extends FeaturesSuperclass {
    *
    * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property can be used to provide the spatial reference instance for this property.
    *
-   * @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/)
    */
   get spatialReference(): SpatialReference | null | undefined;
   set spatialReference(value: SpatialReferenceProperties | null | undefined);
   /**
-   * The view model's state.
+   * The state.
    *
    * @default "disabled"
    */
   get state(): State;
   /**
    * Dates and times will be displayed in this time zone. By default this time zone is
-   * inherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property is set. When a MapView is not associated with the widget view model,
-   * then the property will fallback to the `system` time zone.
+   * inherited from [MapView.timeZone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#view) property is set. When a MapView is not associated, then the property will fallback to the `system` time zone.
    *
    * **Possible Values**
    *
@@ -530,8 +412,6 @@ export default class Features extends FeaturesSuperclass {
    * 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).
-   *
-   * @since 4.30
    */
   get timeZone(): TimeZone;
   set timeZone(value: TimeZone | null | undefined);
@@ -539,7 +419,6 @@ export default class Features extends FeaturesSuperclass {
    * Indicates whether to update the [location](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#location) when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeatureIndex) changes.
    *
    * @default false
-   * @since 4.32
    */
   accessor updateLocationEnabled: boolean;
   /**
@@ -547,18 +426,14 @@ export default class Features extends FeaturesSuperclass {
    *
    * > [!WARNING]
    * >
-   * > The FeaturesViewModel requires a view if the user expects it to display content in any of the following situations:
+   * > A view is required if the user expects it to display content in any of the following situations:
    * > - The [features](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#features) have a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) that may use [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) or reference the `$map` profile variable (i.e. access data from layers within a map).
    * > - 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](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone).
-   * > - When using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#fetchFeatures) method or the `fetchFeatures` option in the [open](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#open) method.
+   * > - When using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#fetchFeatures) method.
    */
   accessor view: MapViewOrSceneView | null | undefined;
-  /**
-   * Indicates whether the widget is waiting for content to be resolved.
-   *
-   * @since 4.32
-   */
+  /** Indicates whether the component is waiting for content to be resolved. */
   get waitingForContents(): boolean;
   /**
    * Indicates whether a feature was found while resolving [promises](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#promises).
@@ -571,10 +446,9 @@ export default class Features extends FeaturesSuperclass {
    * Number of levels of detail (LOD) to zoom in on the [selected feature](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeature).
    *
    * @default 4
-   * @since 4.34
    * @example
    * // Restricts the zooming to two LODS when the zoom in action is clicked.
-   * features.viewModel.zoomFactor = 2;
+   * featureComponent.zoomFactor = 2;
    */
   accessor zoomFactor: number;
   /**
@@ -589,52 +463,25 @@ export default class Features extends FeaturesSuperclass {
    * [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
    * [FeatureLayer.popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled).
-   * These features can then be used within a custom [Popup](https://developers.arcgis.com/javascript/latest/references/core/widgets/Popup/), [Features](https://developers.arcgis.com/javascript/latest/references/core/widgets/Features/),
-   * or [Feature](https://developers.arcgis.com/javascript/latest/references/core/widgets/Feature/) 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.
-   *
-   * @param screenPoint - An object representing a point on the screen. This point can be in either the
-   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenPoint) or
-   * [ScreenPoint](https://developers.arcgis.com/javascript/latest/references/core/core/types/#ScreenPoint).
-   * @param options - The [options](https://developers.arcgis.com/javascript/latest/references/core/widgets/Popup/types/#FetchFeaturesOptions)
+   *
+   * @param screenPoint - An object representing a point on the screen.
+   * @param options - The [options](https://developers.arcgis.com/javascript/latest/references/core/popup/types/#FetchFeaturesOptions)
    * to pass into the `fetchFeatures` method.
-   * @returns Resolves with the selected `hitTest`
-   * location. In addition, it also returns an array of [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) if the `hitTest` is
+   * @returns Resolves with the selected `hitTest` location. In addition, it also returns an array of [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) if the `hitTest` is
    * performed directly on the [View](https://developers.arcgis.com/javascript/latest/references/core/views/View/), a single Promise containing an array of all resulting
    * [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/), or an array of objects containing this array of resulting [graphics](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) in addition to its associated
    * [LayerView](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/).
-   *
-   * Most commonly if accessing all features, use the single promise returned in the
-   * [result's allGraphicsPromise](https://developers.arcgis.com/javascript/latest/references/core/views/types/#FetchPopupFeaturesResult) and call `.then()` as seen in
-   * the example snippet.
-   * @example
-   * // Get view's click event
-   * reactiveUtils.on(()=>view, "click", (event) => {
-   *   // Call fetchFeatures and pass in the click event screenPoint
-   *   viewModel.fetchFeatures(event.screenPoint).then((response) => {
-   *     // Access the response from fetchFeatures
-   *     response.allGraphicsPromise.then((graphics) => {
-   *       // Do something with the returned graphic from fetchFeatures such as setting this to the
-   *       // Features widget graphic property.
-   *       featureWidget.graphic = graphics[0];
-   *     });
-   *   });
-   * });
    */
   fetchFeatures(screenPoint: ScreenPoint | null | undefined, options?: FetchFeaturesOptions): Promise<FetchPopupFeaturesResult>;
   /**
    * Selects the feature at the next index in relation to the selected feature.
    *
-   * @returns Returns an instance of the popup's view model.
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeatureIndex)
    */
   next(): Features;
   /**
    * Selects the feature at the previous index in relation to the selected feature.
    *
-   * @returns Returns an instance of the popup's view model.
    * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/core/popup/Features/#selectedFeatureIndex)
    */
   previous(): Features;
@@ -644,7 +491,6 @@ export default class Features extends FeaturesSuperclass {
    *
    * @param params - The parameters to pass to the `zoomTo()` method.
    * @returns A promise that resolves when the view's extent updates to the value defined in `params.target`.
-   * @since 4.32
    * @see [MapView.goTo()](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#goTo) or [SceneView.goTo()](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#goTo)
    */
   zoomTo(params: GoToParameters): Promise<void>;