@arcgis/map-components 5.2.0-next.0 → 5.2.0-next.1

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

@@ -1,15 +1,13 @@
 /// <reference path="../../index.d.ts" />
 import type ActionButton from "@arcgis/core/support/actions/ActionButton.js";
 import type Collection from "@arcgis/core/core/Collection.js";
-import type Features from "@arcgis/core/popup/Features.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 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 { ActionEvent } from "@arcgis/core/widgets/Popup/types.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 { ArcgisFeatureNext } from "../arcgis-feature-next/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
@@ -18,25 +16,30 @@ import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
 import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.js";
 
 /**
- * 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 an [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.
+ * > [!WARNING]
+ * > The Features (next) component is the successor to the Features component, provided to you early for testing and feedback. 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 this component will be removed. To update at version 6.0, simply remove `-next` from the component name.
+ *
+ * The Features (next) component allows users to view a feature's popupTemplate content such as attributes,
+ * actions, related records, etc., without living inside a view component.
  * This component looks and behaves similarly to the [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) component,
- * however unlike Popup, the Features component can be placed outside of the map or scene component.
+ * however unlike Popup, the Features (next) component can be placed outside of a view component.
  * For example, when features are selected in the [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/),
  * the [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/) 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 map, such as
- * a HTML div within a Calcite Design System
+ * With the Features (next) component, the same information that Popup provides is shown in a separate container from the map, such as a Calcite Design System
  * [Shell Panel](https://developers.arcgis.com/calcite-design-system/components/shell-panel/).
  *
- * 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
+ * If multiple features are passed into the Features (next) 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/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
- * actions, related records, clustering configuration, etc., then use the [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) component.
+ * The Features (next) 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-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/) component.
  *
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
+ * @see [arcgis-feature-next](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature-next/)
+ * @see [arcgis-popup](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/)
+ * @beta
  * @since 5.1
  */
 export abstract class ArcgisFeaturesNext extends LitElement {
@@ -67,15 +70,14 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor autoDestroyDisabled: boolean;
   /**
-   * Disables chart animation within the component.
+   * Indicates whether to disable chart animation in the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor chartAnimationDisabled: boolean | undefined;
   /**
    * Indicates whether the component displays its content. If `true`, only the header displays.
-   * This property is only honored if [arcgis-features.showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton) is `true`.
+   * This property is only honored if [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#showCollapseButton) is `true`.
    *
    * @default false
    */
@@ -98,50 +100,39 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * For example, previously a date that may have appeared as `"December 30, 1997"` will now appear as `"12/30/1997 6:00 PM"`.
    *
    * @default false
-   * @since 5.1
    */
   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-next/#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-next/#heading).
    *
    * @since 5.1
    * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#heading)
    * @see [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature)
    */
   get effectiveHeading(): string | null | undefined;
-  /**
-   * The number of [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features) available in the component.
-   *
-   * @since 5.1
-   */
+  /** The number of [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features) available in the component. */
   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. */
+  /** Defines the specific [abilities](https://developers.arcgis.com/javascript/latest/references/core/popup/support/FeatureAbilities/) 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-next/#initialDisplayMode) is set to "feature".
    *
    * @default false
-   * @since 5.1
    */
   accessor featureMenuOpen: boolean;
-  /**
-   * Sets the title to display on the component while viewing the feature menu.
-   *
-   * @since 5.1
-   */
+  /** Sets the title to display on the component while viewing the feature menu. */
   accessor featureMenuTitle: string | 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.
    *
    * @default false
-   * @since 5.1
    */
   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-next/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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-next/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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-next/#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-next/#selectedFeature).
    *
    * This value is `null` if no features are associated with the component.
    *
@@ -183,16 +174,14 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * ```
    */
   accessor goToOverride: GoToOverride | null | undefined;
-  /** The actions that are displayed in the header of the component. */
+  /** A [collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/) of [action buttons](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/) that are displayed in the header of the component. Each action may be executed by clicking the icon or image symbolizing them. The order of each action is the order in which they appear in the actions [Collection](https://developers.arcgis.com/javascript/latest/references/core/core/Collection/). The [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#event-arcgisTriggerAction) event fires each time an action is clicked. */
   accessor 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 [arcgis-features.selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature)
-   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), then the title set in the
-   * corresponding template is used here.
+   * matter the features that are selected. If the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature)
+   * has a [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), then the title set in the corresponding template is used here.
    *
-   * @see [arcgis-features.headingLevel](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#headingLevel)
-   * @since 5.1
+   * @see [headingLevel](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#headingLevel)
    * @example
    * ```js
    * // This title will display in the component unless a selected feature's
@@ -202,26 +191,21 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor heading: string | null | undefined;
   /**
-   * Indicates the heading level to use for the [arcgis-features.heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#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.
+   * Indicates the heading level to use for the headings in the component.
    *
    * @default 2
    */
   accessor headingLevel: HeadingLevel;
   /**
-   * Indicates whether to hide the action bar that holds the feature's [arcgis-features.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions).
+   * Indicates whether to hide the action bar that holds the feature's [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions).
    *
    * @default false
    */
   accessor hideActionBar: boolean;
   /**
-   * This property provides the ability to hide or show [attachments content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) within the component.
+   * Indicates whether to hide [attachments content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideAttachmentsContent: boolean | undefined;
   /**
@@ -231,31 +215,27 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor hideCloseButton: boolean;
   /**
-   * This property provides the ability to hide or show content within the component.
+   * Indicates whether to hide the component's content.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideContent: boolean;
   /**
-   * This property provides the ability to hide or show [custom content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/) within the component.
+   * Indicates whether to hide [custom content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideCustomContent: boolean | undefined;
   /**
-   * 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.
+   * Indicates whether to hide [expression content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideExpressionContent: boolean;
   /**
    * Indicates whether to hide the group heading for a list of multiple features.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideFeatureListLayerTitle: boolean;
   /**
@@ -271,30 +251,27 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor hideFeatureNavigation: boolean;
   /**
-   * This property provides the ability to hide or show [fields content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) within the component.
+   * Indicates whether to hide [fields content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideFieldsContent: boolean | undefined;
   /**
-   * 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-next/#heading).
    *
    * @default false
    */
   accessor hideHeading: boolean;
   /**
-   * This property provides the ability to hide or show the last edited info within the component.
+   * Indicates whether to hide the last edited info in the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideLastEditedInfo: boolean;
   /**
-   * This property provides the ability to hide or show [media content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/) within the component.
+   * Indicates whether to hide [media content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideMediaContent: boolean | undefined;
   /**
@@ -308,7 +285,6 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * Indicates whether to hide the *select feature* action when viewing associated and related features.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideSelectFeature: boolean;
   /**
@@ -318,10 +294,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor hideSpinner: boolean;
   /**
-   * This property provides the ability to hide or show [text content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/) within the component.
+   * Indicates whether to hide [text content](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/) within the component.
    *
    * @default false
-   * @since 5.1
    */
   accessor hideTextContent: boolean | undefined;
   /**
@@ -332,11 +307,10 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor hideUtilityNetworkContent: boolean | undefined;
   /**
-   * Indicates whether to highlight the [arcgis-features.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.
+   * Indicates whether to highlight the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature) in the associated
+   * [arcgis-map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/), [arcgis-scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/), or [arcgis-link-chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/) component.
    *
    * @default false
-   * @since 5.1
    */
   accessor highlightDisabled: boolean;
   /**
@@ -351,7 +325,6 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * In order to disable any default actions, it is necessary to set `includeDefaultActionsDisabled` to `true`.
    *
    * @default false
-   * @since 5.1
    */
   accessor includeDefaultActionsDisabled: boolean;
   /**
@@ -363,9 +336,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   /** The component's default label. */
   accessor label: string | undefined;
   /**
-   * A map is required when the input [arcgis-features.features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/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 the `$map` profile variable to access data from layers within a map. Without a map, expressions that use `$map` will throw an error.
+   * A map is required when the input [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features) have a popupTemplate that contains [Arcade](https://developers.arcgis.com/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 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 [arcgis-features.view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property can be used to provide the map instance for this property.
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#view) property can be used to provide the map instance for this property.
    *
    * @default null
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
@@ -381,8 +354,6 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * Replace localized message strings with your own strings.
    *
    * _**Note**: Individual message keys may change between releases._
-   *
-   * @since 5.1
    */
   accessor messageOverrides: {
       componentLabel?: string | undefined;
@@ -477,11 +448,8 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   /**
    * 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-next/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#heading) directly, it is recommended to call [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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-next/#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-next/#active)
    * @see [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#clear)
    * @since 5.0
    * @example
@@ -489,7 +457,6 @@ export abstract class ArcgisFeaturesNext 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,13 +465,6 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * ```
    */
   accessor open: boolean;
-  /**
-   * 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 [arcgis-features.features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) array.
-   */
-  accessor promises: Array<Promise<Array<Graphic>>>;
   /**
    * By assigning the `id` attribute of the Map or Scene component to this property, you can position a child component anywhere in the DOM while still maintaining a connection to the Map or Scene.
    *
@@ -532,7 +492,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   get selectedFeatureComponent(): ArcgisFeatureNext | undefined;
   /**
-   * Index of the feature that is [arcgis-features.selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature). When [arcgis-features.features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) are set,
+   * Index of the feature that is [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature). When [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features) are set,
    * the first index is automatically selected.
    */
   accessor selectedFeatureIndex: number;
@@ -546,7 +506,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * 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 [arcgis-features.view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property can be used to provide the spatial reference instance for this property.
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#view) property can be used to provide the spatial reference instance for this property.
    *
    * @default null
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
@@ -561,7 +521,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   get state(): State;
   /**
    * 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/components/arcgis-map/#timeZone) if the [arcgis-features.view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#view) property is set. When a MapView is not associated with the component
+   * inherited from [arcgis-map.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#timeZone) if the [view](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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**
@@ -573,7 +533,7 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   accessor timeZone: string;
   /**
-   * Indicates whether to update the feature location when the [arcgis-features.selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex) changes.
+   * Indicates whether to update the feature location when the [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeatureIndex) changes.
    *
    * @default false
    * @since 5.1
@@ -582,21 +542,18 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   /**
    * A reference to the [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) or [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
    * The Features component requires a `view` to be set if:
-   * - The [arcgis-features.features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-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). Alternatively, set the [arcgis-features.map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#map) property.
+   * - The [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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). Alternatively, set the [map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#map) property.
    * - 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 [arcgis-features.timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#timeZone) property.
-   * - Using the [arcgis-features.fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures) method or the `fetchFeatures` option in the [arcgis-features.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 [arcgis-features.includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#includeDefaultActionsDisabled) property to `true` to remove this default action.
+   * Alternatively, set the [timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#timeZone) property.
+   * - 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-next/#includeDefaultActionsDisabled) property to `true` to remove this default action.
    *
    * @since 5.1
    */
   accessor view: MapViewOrSceneView | null | undefined;
-  /** @since 5.1 */
-  accessor viewModel: Features;
   /**
-   * Removes [arcgis-features.promises](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#promises), [arcgis-features.features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features), [arcgis-features.content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#content), and
-   * [arcgis-features.heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#heading) from the Features component.
+   * Removes [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#features), [content](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#content), and
+   * [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#heading) from the component.
    */
   clear(): void;
   /** A convenience method to close the component. */
@@ -604,39 +561,15 @@ export abstract class ArcgisFeaturesNext extends LitElement {
   /** Permanently destroy the component. */
   destroy(): Promise<void>;
   /**
-   * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/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.
-   *
-   * @param screenPoint
-   * @param options
-   * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#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 [arcgis-features.selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
+   * Selects the feature at the next index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature).
    *
-   * @see [arcgis-features.selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeatureIndex)
    */
   next(): void;
   /**
-   * Selects the feature at the previous index in relation to the [arcgis-features.selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeature).
+   * Selects the feature at the previous index in relation to the [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeature).
    *
-   * @see [arcgis-features.selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#selectedFeatureIndex)
+   * @see [selectedFeatureIndex](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#selectedFeatureIndex)
    */
   previous(): void;
   /**
@@ -646,8 +579,8 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    */
   setFocus(): Promise<void>;
   /**
-   * Triggers the [arcgis-features.@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#event-arcgisTriggerAction) event and executes the action
-   * at the specified index in the [arcgis-features.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions) array.
+   * Triggers the [@arcgisTriggerAction](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#event-arcgisTriggerAction) event and executes the action
+   * at the specified index in the [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions) array.
    *
    * @param action
    */
@@ -662,9 +595,9 @@ export abstract class ArcgisFeaturesNext extends LitElement {
    * Fires after the user clicks on an action in the component.
    * This event may be used to define a custom function to execute when particular actions are clicked.
    *
-   * @see [arcgis-features.actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#actions)
+   * @see [actions](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#actions)
    * @see [PopupTemplate.actions](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#actions)
-   * @see [arcgis-features.open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open)
+   * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features-next/#open)
    * @example
    * ```js
    * // Fires each time an action is clicked

package/dist/components/arcgis-link-chart-nonspatial-visibility-toggle/customElement.js

@@ -44,7 +44,7 @@ class y extends h {
 }
 const s = {
   changeNonspatialDataDisplay: (t, i) => {
-    t.map.changeNonspatialDataDisplay(i);
+    t.map?.changeNonspatialDataDisplay(i);
   },
   useView: (t) => m(t)
 };

package/dist/components/arcgis-oriented-imagery-viewer/customElement.d.ts

@@ -130,32 +130,32 @@ export abstract class ArcgisOrientedImageryViewer extends LitElement {
    * The layer contains the feature data and oriented imagery properties required by the viewer to load the image and generate the associated graphics.
    *
    * > [!WARNING]
-   * > Use `layer`, `layerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
+   * > Use `layer`, `mapLayerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
    */
   accessor layer: OrientedImageryLayer | null | undefined;
+  /**
+   * Indicates if the map-image location tool is available in the component.
+   * When `true`, the user can select a point on the map and the corresponding location in pixel space will be displayed in the image, and vice versa.
+   *
+   * @default false
+   */
+  accessor mapImageConversionToolState: boolean;
   /**
    * The layer ID of a Oriented Imagery Layer in the associated map.
    * When set, the component will attempt to find and use the layer with the provided ID from the map.
    *
    * > [!WARNING]
-   * > Use `layer`, `layerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
+   * > Use `layer`, `mapLayerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
    *
    * @since 5.1
    * @example
    * ```html
    * <arcgis-scene item-id="aa1c036445824e06a2d1b0e12e02a924">
-   *   <arcgis-oriented-imagery-viewer slot="top-right" layer-id="1962adf1de1-layer-82"></arcgis-oriented-imagery-viewer>
+   *   <arcgis-oriented-imagery-viewer slot="top-right" map-layer-id="1962adf1de1-layer-82"></arcgis-oriented-imagery-viewer>
    * </arcgis-scene>
    * ```
    */
-  accessor layerId: string | undefined;
-  /**
-   * Indicates if the map-image location tool is available in the component.
-   * When `true`, the user can select a point on the map and the corresponding location in pixel space will be displayed in the image, and vice versa.
-   *
-   * @default false
-   */
-  accessor mapImageConversionToolState: boolean;
+  accessor mapLayerId: string | undefined;
   /**
    * When `true`, the navigation tool is available in the component.
    * The navigation tool can be used to explore the images that contain the selected location on the map using a compass.
@@ -169,7 +169,7 @@ export abstract class ArcgisOrientedImageryViewer extends LitElement {
    * The portal item ID of an Oriented Imagery Layer to load and use in the component.
    *
    * > [!WARNING]
-   * > Use `layer`, `layerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
+   * > Use `layer`, `mapLayerId`, and `orientedImageryLayerItemId` independently; only one should be set at a time.
    */
   accessor orientedImageryLayerItemId: string | undefined;
   /**