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

package/dist/components/arcgis-paste/customElement.js

@@ -43,7 +43,7 @@ function Ee(e, t, i, a, s, o) {
   const g = o.objectIdField ?? "";
   return e.forEach((m) => {
     if (m.name !== g && !h.includes(m.name) && !p.includes(m.name) && !s.includes(m.name) && m.type !== "global-id" && (u === "" || u !== m.name)) {
-      const f = Ge(m, t);
+      const f = Oe(m, t);
       f.match && f.targetField && (l[f.targetField?.name] = i[m.name]);
     }
   }), l;
@@ -68,7 +68,7 @@ function Te(e, t) {
       return !1;
   }
 }
-function Ge(e, t) {
+function Oe(e, t) {
   const i = { match: !1, sourceField: null, targetField: null };
   for (const a of t)
     if (Te(e, a)) {
@@ -82,7 +82,7 @@ async function se(e, t, i, a) {
   let s = !0;
   const o = { hasAsyncArcadeExpressions: !1 }, l = e.items.filter((h) => h.type === "add");
   for (const h of l) {
-    const p = h.graphic.clone(), u = Oe(
+    const p = h.graphic.clone(), u = Ge(
       h.graphic,
       h.layer
     );
@@ -109,7 +109,7 @@ async function se(e, t, i, a) {
   }
   return s;
 }
-function Oe(e, t) {
+function Ge(e, t) {
   if (t.type === "feature" || t.type === "subtype-sublayer")
     return t;
   const i = t.findSublayerForFeature(e);
@@ -416,7 +416,7 @@ A([
 v = A([
   C("components.paste.commands.PasteCommand")
 ], v);
-var Be = Object.defineProperty, je = Object.getOwnPropertyDescriptor, G = (e, t, i, a) => {
+var Be = Object.defineProperty, je = Object.getOwnPropertyDescriptor, O = (e, t, i, a) => {
   for (var s = a > 1 ? void 0 : a ? je(t, i) : t, o = e.length - 1, l; o >= 0; o--)
     (l = e[o]) && (s = (a ? l(t, i, s) : l(s)) || s);
   return a && s && Be(t, i, s), s;
@@ -533,25 +533,25 @@ let F = class extends v {
     return e.pasteAppendTitle;
   }
 };
-G([
+O([
   r()
 ], F.prototype, "id", 1);
-G([
+O([
   r()
 ], F.prototype, "icon", 1);
-G([
+O([
   r()
 ], F.prototype, "immediate", 1);
-G([
+O([
   r()
 ], F.prototype, "mustShowOnCommandPage", 1);
-G([
+O([
   r()
 ], F.prototype, "commandEnabled", 1);
-F = G([
+F = O([
   C("components.paste.commands.PasteAppendCommand")
 ], F);
-var We = Object.defineProperty, Re = Object.getOwnPropertyDescriptor, O = (e, t, i, a) => {
+var We = Object.defineProperty, Re = Object.getOwnPropertyDescriptor, G = (e, t, i, a) => {
   for (var s = a > 1 ? void 0 : a ? Re(t, i) : t, o = e.length - 1, l; o >= 0; o--)
     (l = e[o]) && (s = (a ? l(t, i, s) : l(s)) || s);
   return a && s && We(t, i, s), s;
@@ -669,22 +669,22 @@ let _ = class extends v {
     return e.pasteSubtractTitle;
   }
 };
-O([
+G([
   r()
 ], _.prototype, "id", 1);
-O([
+G([
   r()
 ], _.prototype, "icon", 1);
-O([
+G([
   r()
 ], _.prototype, "immediate", 1);
-O([
+G([
   r()
 ], _.prototype, "mustShowOnCommandPage", 1);
-O([
+G([
   r()
 ], _.prototype, "commandEnabled", 1);
-_ = O([
+_ = G([
   C("components.paste.commands.PasteSubtractCommand")
 ], _);
 var Ne = Object.defineProperty, Ue = Object.getOwnPropertyDescriptor, k = (e, t, i, a) => {
@@ -973,7 +973,7 @@ function te(e) {
 let n = class extends U {
   //#region Lifecycle
   constructor(e) {
-    super(e), this.customPasteCommands = new j(), this.bauInvalidFeatures = [], this.bauFormValid = !0, this.bauFormUpdating = !1, this.bauActiveFeatureIndex = -1, this.bauHasTooManyFeatures = !1, this.bauHasTooManyComplexFeatures = !1, this.bauOriginalGraphics = [], this.formViewModelMap = /* @__PURE__ */ new Map(), this.supportedCommands = ["paste-append", "paste-as", "paste-subtract", "paste", "paste-merge"], this.pasteWithMultipleLayersEnabled = !1, this.pasteWithMultipleFeaturesEnabled = !1, this.alwaysShowFeatureForm = !1, this.selectedClipboardItemIndex = -1, this.pasteWithAttributes = !0, this.closeOnApply = !1, this.currentPasteOperation = "", this._activeFlowPage = "commands-page", this.showClipboardItems = !1, this.hideTooltips = !1, this.hideFooter = !1, this.hideFooterCancelButton = !1, this.hideHeaderCloseButton = !1, this.hideViewClipboard = !1, this.hideErrorNotice = !1, this.highlightGroup = "temporary", this._hoverHighlightHandle = null, this.maximumFeatureCount = 200, this.maximumFeatureCountWithComplexForms = 50, this.layerPermissionsCheck = {
+    super(e), this.customPasteCommands = new j(), this.bauInvalidFeatures = [], this.bauFormValid = !0, this.bauFormUpdating = !1, this.bauActiveFeatureIndex = -1, this.bauHasTooManyFeatures = !1, this.bauHasTooManyComplexFeatures = !1, this.bauOriginalGraphics = [], this.formViewModelMap = /* @__PURE__ */ new Map(), this.supportedCommands = ["paste-append", "paste-as", "paste-subtract", "paste", "paste-merge"], this.pasteWithMultipleLayersEnabled = !1, this.pasteWithMultipleFeaturesEnabled = !1, this.alwaysShowFeatureForm = !1, this.selectedClipboardItemIndex = -1, this.pasteWithAttributes = !0, this.closeOnApply = !1, this.currentPasteOperation = "", this.disableTemplatesMode = "never", this._activeFlowPage = "commands-page", this.showClipboardItems = !1, this.hideTooltips = !1, this.hideFooter = !1, this.hideFooterCancelButton = !1, this.hideHeaderCloseButton = !1, this.hideViewClipboard = !1, this.hideErrorNotice = !1, this.highlightGroup = "temporary", this._hoverHighlightHandle = null, this.maximumFeatureCount = 200, this.maximumFeatureCountWithComplexForms = 50, this.layerPermissionsCheck = {
       canCreate: (t) => t ? !!t.effectiveCapabilities?.operations.supportsAdd : !1,
       canUpdate: (t) => {
         if (!t)
@@ -1374,6 +1374,9 @@ c([
 c([
   r()
 ], n.prototype, "currentPasteOperation", 2);
+c([
+  r()
+], n.prototype, "disableTemplatesMode", 2);
 c([
   r()
 ], n.prototype, "activeFlowPage", 1);
@@ -1541,10 +1544,10 @@ M = S([
 const at = ve(n);
 class st extends he {
   constructor() {
-    super(), this._featureFormElement = V(), this._floatingChoiceContainer = V(), this._bauForm = V(), this._templateGallery = V(), this._messages = ge(), this.viewModel = at(this), this.hasPasteCommandsPage = this.viewModel.hasPasteCommandsPage, this.activeCommand = this.viewModel.activeCommand, this.availableCommands = this.viewModel.availableCommands, this._showFloatingChoice = !1, this.activeFlowPage = this.viewModel.activeFlowPage, this.autoDestroyDisabled = !1, this.view = this.viewModel.view, this.selectedFeature = this.viewModel.selectedFeature, this.closed = !1, this.highlightGroup = this.viewModel.highlightGroup, this.pasteWithMultipleLayersEnabled = this.viewModel.pasteWithMultipleLayersEnabled, this.pasteWithMultipleFeaturesEnabled = this.viewModel.pasteWithMultipleFeaturesEnabled, this.alwaysShowFeatureForm = this.viewModel.alwaysShowFeatureForm, this.closeOnApply = this.viewModel.closeOnApply, this.hideErrorNotice = this.viewModel.hideErrorNotice, this.hideFooterCancelButton = this.viewModel.hideFooterCancelButton, this.hideFooter = this.viewModel.hideFooter, this.hideHeaderCloseButton = this.viewModel.hideHeaderCloseButton, this.hideTooltips = this.viewModel.hideTooltips, this.hideViewClipboard = this.viewModel.hideViewClipboard, this.maximumFeatureCount = this.viewModel.maximumFeatureCount, this.maximumFeatureCountWithComplexForms = this.viewModel.maximumFeatureCountWithComplexForms, this.layerPermissionsCheck = this.viewModel.layerPermissionsCheck, this.pasteCommandsState = this.viewModel.pasteCommandsState, this.arcgisApplyPasteCommand = T(), this.arcgisApplyPasteError = T(), this.arcgisBeforeClipboardMove = T(), this.arcgisClipboardMoveStateChanged = T(), this.arcgisClose = T(), this.arcgisPropertyChange = xe()("pasteCommandsState", "activeFlowPage"), this.arcgisReady = T(), this.listenOn(window, "click", this._handleClickAway), this.listenOn(window, "keydown", this._handleKeyDown);
+    super(), this._featureFormElement = V(), this._floatingChoiceContainer = V(), this._bauForm = V(), this._templateGallery = V(), this._messages = ge(), this.viewModel = at(this), this.hasPasteCommandsPage = this.viewModel.hasPasteCommandsPage, this.activeCommand = this.viewModel.activeCommand, this.availableCommands = this.viewModel.availableCommands, this._showFloatingChoice = !1, this.activeFlowPage = this.viewModel.activeFlowPage, this.autoDestroyDisabled = !1, this.view = this.viewModel.view, this.selectedFeature = this.viewModel.selectedFeature, this.closed = !1, this.highlightGroup = this.viewModel.highlightGroup, this.pasteWithMultipleLayersEnabled = this.viewModel.pasteWithMultipleLayersEnabled, this.pasteWithMultipleFeaturesEnabled = this.viewModel.pasteWithMultipleFeaturesEnabled, this.alwaysShowFeatureForm = this.viewModel.alwaysShowFeatureForm, this.closeOnApply = this.viewModel.closeOnApply, this.hideErrorNotice = this.viewModel.hideErrorNotice, this.hideFooterCancelButton = this.viewModel.hideFooterCancelButton, this.hideFooter = this.viewModel.hideFooter, this.hideHeaderCloseButton = this.viewModel.hideHeaderCloseButton, this.hideTooltips = this.viewModel.hideTooltips, this.hideViewClipboard = this.viewModel.hideViewClipboard, this.maximumFeatureCount = this.viewModel.maximumFeatureCount, this.maximumFeatureCountWithComplexForms = this.viewModel.maximumFeatureCountWithComplexForms, this.layerPermissionsCheck = this.viewModel.layerPermissionsCheck, this.pasteCommandsState = this.viewModel.pasteCommandsState, this.disableTemplatesMode = this.viewModel.disableTemplatesMode, this.arcgisApplyPasteCommand = T(), this.arcgisApplyPasteError = T(), this.arcgisBeforeClipboardMove = T(), this.arcgisClipboardMoveStateChanged = T(), this.arcgisClose = T(), this.arcgisPropertyChange = xe()("pasteCommandsState", "activeFlowPage"), this.arcgisReady = T(), this.listenOn(window, "click", this._handleClickAway), this.listenOn(window, "keydown", this._handleKeyDown);
   }
   static {
-    this.properties = { hasPasteCommandsPage: 16, activeCommand: 16, availableCommands: 16, _showFloatingChoice: 16, activeFlowPage: 32, autoDestroyDisabled: 5, referenceElement: 1, view: 0, selectedFeature: 0, closed: 7, highlightGroup: 1, supportedCommands: 1, pasteWithMultipleLayersEnabled: 5, pasteWithMultipleFeaturesEnabled: 5, alwaysShowFeatureForm: 5, beforeApply: 0, clipboard: 32, closeOnApply: 5, hideErrorNotice: 5, hideFooterCancelButton: 5, hideFooter: 5, hideHeaderCloseButton: 5, hideTooltips: 5, hideViewClipboard: 5, maximumFeatureCount: 9, maximumFeatureCountWithComplexForms: 9, layerPermissionsCheck: 0, pasteCommandsState: 0 };
+    this.properties = { hasPasteCommandsPage: 16, activeCommand: 16, availableCommands: 16, _showFloatingChoice: 16, activeFlowPage: 32, autoDestroyDisabled: 5, referenceElement: 1, view: 0, selectedFeature: 0, closed: 7, highlightGroup: 1, supportedCommands: 1, pasteWithMultipleLayersEnabled: 5, pasteWithMultipleFeaturesEnabled: 5, alwaysShowFeatureForm: 5, beforeApply: 0, clipboard: 32, closeOnApply: 5, hideErrorNotice: 5, hideFooterCancelButton: 5, hideFooter: 5, hideHeaderCloseButton: 5, hideTooltips: 5, hideViewClipboard: 5, maximumFeatureCount: 9, maximumFeatureCountWithComplexForms: 9, layerPermissionsCheck: 0, pasteCommandsState: 0, disableTemplatesMode: 1 };
   }
   static {
     this.styles = $e;
@@ -1690,32 +1693,21 @@ class st extends he {
       if (!this._templateGallery.value || this.viewModel.activeFlowPage !== "gallery-page")
         return;
       const t = this._templateGallery.value;
-      if (t.state !== "ready")
-        return;
       if (this.viewModel.pasteTemplateIsValid || (this.viewModel.pasteTemplate = void 0), this.viewModel.pasteTemplate !== void 0) {
-        t.selectedItem || this._templateGallery.value?.select(this.viewModel.pasteTemplate);
+        t.selectedTemplateId !== this.viewModel.pasteTemplate.id && (t.selectedTemplateId = this.viewModel.pasteTemplate.id);
         return;
       }
-      let i;
-      for (const a of t.items) {
-        if ("items" in a) {
-          if (a.items.length > 0) {
-            i = a.items[0];
-            break;
-          }
-          continue;
-        }
-        i = a;
-        break;
-      }
-      i && t.select(i);
+      if (t.effectiveTemplates?.length === 0)
+        return;
+      const i = t.effectiveTemplates?.[0].templates[0];
+      i && (this.viewModel.pasteTemplate = i, t.selectedTemplateId = i.id);
     });
   }
   _renderFlowCommandStart(t) {
     return t ? d`<slot name=home-header-actions-start slot=header-actions-start></slot>` : null;
   }
   _renderCloseCommand(t) {
-    return d`${this.hideHeaderCloseButton ? null : d`<calcite-action slot=header-actions-end icon=x text @click=${() => {
+    return d`${this.hideHeaderCloseButton ? null : d`<calcite-action slot=header-actions-end icon=x .text=${this._messages.close ?? ""} @click=${() => {
       this.reset(), this.closed = !0, this.arcgisClose.emit();
     }}></calcite-action>`}${t ? d`<slot name=header-actions-end slot=header-actions-end></slot>` : null}`;
   }
@@ -1775,11 +1767,11 @@ class st extends he {
       this.viewModel.activeFlowPage = "merge-page";
     }} title=${this._messages.seeMergeOptions ?? ue}>${this._messages.seeMergeOptions}</calcite-link>` : null}</calcite-notice></div>` : null}${this.viewModel.clipboardAndTemplateSupportAttributes && this.viewModel.pasteTemplate ? this._renderAttributeCheckbox(!this.viewModel.clipboardAndTemplateSupportAttributes) : null}${this.viewModel.clipboardAndTemplateSupportAttributes ? null : this._renderAttributeCheckbox(!1)}</div><calcite-list .hidden=${this.viewModel.activeCommand !== "paste-merge"} .label=${this._messages.pasteCommandChoices ?? ""} selection-mode=none selection-appearance=border><calcite-list-item .label=${this._messages.mergeOptionsTitle} .description=${this._messages.mergeOptionsDesc} .disabled=${this.viewModel.updating} @click=${() => {
       this.viewModel.activeFlowPage = "merge-page";
-    }}><calcite-icon slot=content-start icon=configure></calcite-icon><calcite-icon slot=content-end icon=chevron-right></calcite-icon></calcite-list-item></calcite-list><div>${this.viewModel.workingLayers.length > 0 ? d`<arcgis-feature-templates-legacy .disabledItemFunction=${(i) => !!(i.template && ie(i.template) && i.template.type !== "feature")} class="paste-feature-templates" .layers=${this.viewModel.workingLayers} selection-mode=single @arcgisPropertyChange=${(i) => {
+    }}><calcite-icon slot=content-start icon=configure></calcite-icon><calcite-icon slot=content-end icon=chevron-right></calcite-icon></calcite-list-item></calcite-list><div>${this.viewModel.workingLayers.length > 0 ? d`<arcgis-feature-templates .disableTemplatesMode=${this.disableTemplatesMode} .applicationDisabledFunction=${(i) => !!(i.template && ie(i.template) && i.template.type !== "feature")} class="paste-feature-templates" .layers=${this.viewModel.workingLayers} @arcgisTemplatesChanged=${() => {
       this._checkAndUpdateInitialPasteTemplate();
-    }} @arcgisSelect=${(i) => {
-      this.viewModel.pasteTemplate = i.detail.item;
-    }} .view=${this.viewModel.view} .referenceElement=${this.referenceElement} ${D(this._templateGallery)}></arcgis-feature-templates-legacy>` : d`<calcite-notice open icon=exclamation-point kind=warning><div slot=message>${b(this._messages.noMatchingEditableLayers ?? "", { num: this.maximumFeatureCount })}</div></calcite-notice>`}</div></div></calcite-panel>${this._renderApplying()}</calcite-flow-item>`) : w("paste-gallery", d`<calcite-flow-item .selected=${t} .heading=${this._messages.componentLabel} @calciteFlowItemBack=${(i) => {
+    }} @arcgisSelectTemplate=${(i) => {
+      this.viewModel.pasteTemplate = i.detail.template;
+    }} .view=${this.viewModel.view} .referenceElement=${this.referenceElement} ${D(this._templateGallery)}></arcgis-feature-templates>` : d`<calcite-notice open icon=exclamation-point kind=warning><div slot=message>${b(this._messages.noMatchingEditableLayers ?? "", { num: this.maximumFeatureCount })}</div></calcite-notice>`}</div></div></calcite-panel>${this._renderApplying()}</calcite-flow-item>`) : w("paste-gallery", d`<calcite-flow-item .selected=${t} .heading=${this._messages.componentLabel} @calciteFlowItemBack=${(i) => {
       i.preventDefault(), this.viewModel.hasPasteCommandsPage && (this.viewModel.activeFlowPage = "commands-page");
     }}>${this._renderFlowCommandStart(!this.viewModel.hasPasteCommandsPage)}</calcite-flow-item>`);
   }

package/dist/components/arcgis-paste/index.js

@@ -10,7 +10,7 @@ import "@esri/calcite-components/components/calcite-link";
 import "@esri/calcite-components/components/calcite-list";
 import "@esri/calcite-components/components/calcite-list-item";
 import "@esri/calcite-components/components/calcite-icon";
-import "../arcgis-feature-templates-legacy/index.js";
+import "../arcgis-feature-templates/index.js";
 import "../arcgis-feature-title/index.js";
 import "../arcgis-feature-image/index.js";
 import "@esri/calcite-components/components/calcite-chip";

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

@@ -8,10 +8,10 @@ import type Point from "@arcgis/core/geometry/Point.js";
 import type { ArcgisReferenceElement, HeadingLevel } from "../types.js";
 import type { Alignment, DockOptions, PopupPositionResult, FetchFeaturesOptions } from "./types.js";
 import type { PublicLitElement as LitElement } from "@arcgis/lumina";
-import type { ArcgisFeature } from "../arcgis-feature/customElement.js";
 import type { ActionEvent, PopupOpenOptions } from "@arcgis/core/widgets/Popup/types.js";
 import type { ScreenPoint } from "@arcgis/core/core/types.js";
 import type { ClickEvent } from "@arcgis/core/views/input/types.js";
+import type { ArcgisFeatureNext } from "../arcgis-feature-next/customElement.js";
 import type { T9nMeta } from "@arcgis/lumina/controllers";
 import type { PopupAction, InitialDisplayOptions, State } from "@arcgis/core/popup/types.js";
 import type { GoToOverride } from "@arcgis/core/widgets/support/types.js";
@@ -35,7 +35,7 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  *
  * The Popup component can also be opened manually at a specific location using the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) property.
  * To prevent the popup from opening automatically when clicking on features within view components, set the `popup-disabled` attribute to `true` and add the Popup component to the [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/) using the `popup` slot.
- * Before setting the `open` property to `true`, you must set the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) property to specify where the popup should open or call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method to open the popup template for features at a specific screen location.
+ * Before setting the `open` property to `true`, you must set the [location](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#location) property to specify where the popup should open.
  *
  * Example of opening the popup at a clicked location with custom content:
  *
@@ -59,7 +59,7 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * </script>
  * ```
  *
- * Alternatively, you can call the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
+ * Alternatively, you can call the [arcgis-map.fetchPopupFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#fetchPopupFeatures) method within the view element's click event listener to open the popup with features at the clicked location.
  * ```html
  * <!-- Set popup-disabled and popup-component-enabled attributes -->
  * <arcgis-map id="06ca49d0ddb447e7817cfc343ca30df9" popup-disabled>
@@ -71,7 +71,12 @@ import type { MapViewOrSceneView } from "@arcgis/core/views/MapViewOrSceneView.j
  * const popupComponent = document.querySelector("arcgis-popup");
  * // Listen for clicks on the view and populate the popup with features at that location.
  * viewElement.addEventListener("arcgisViewClick", async (event) => {
- *   await popupComponent.fetchFeatures(event.detail);
+ *  const generator = await viewElement.fetchPopupFeatures(event.detail.screenPoint, {
+ *    pointerType: event.detail.pointerType,
+ *  });
+ *
+ *  const features = await Array.fromAsync(generator);
+ *  popupComponent.features = features;
  * });
  * // Open the popup when the features property changes.
  * reactiveUtils.watch(
@@ -250,7 +255,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor dockOptions: DockOptions;
   /**
-   * 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-popup/#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-popup/#heading).
    *
    * @since 5.1
    * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
@@ -276,9 +281,9 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor featureMenuTitle: string | undefined;
   /**
-   * 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-popup/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#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-popup/#selectedFeature).
    *
    * This value is `null` if no features are associated with the component.
    *
@@ -299,6 +304,14 @@ export abstract class ArcgisPopup extends LitElement {
    * ```
    */
   accessor features: Array<Graphic>;
+  /**
+   * When `true`, this prevents the popup from trapping focus when opened.
+   * Preventing focus trapping can be used in scenarios where interactions are expected within the user interface, such as when the popup resides in a panel.
+   *
+   * @default false
+   * @since 5.1
+   */
+  accessor focusTrapDisabled: boolean;
   /**
    * 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.
    *
@@ -343,7 +356,7 @@ export abstract class ArcgisPopup extends LitElement {
    * important for meeting accessibility standards.
    *
    * @default 2
-   * @see [Heading Elements](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements)
+   * @see [Heading Elements](https://developer.mozilla.org/docs/Web/HTML/Element/Heading_Elements)
    * @see [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading)
    * @example
    * ```html
@@ -389,7 +402,7 @@ export abstract class ArcgisPopup extends LitElement {
    */
   accessor hideFeatureNavigation: 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-popup/#heading).
    *
    * @default false
    */
@@ -424,7 +437,7 @@ export abstract class ArcgisPopup extends LitElement {
   accessor label: string | undefined;
   /**
    * Point used to position the popup. This is automatically set when viewing the
-   * popup by selecting a feature or when calling the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#fetchFeatures) method. If using the Popup to display content not related
+   * popup by selecting a feature. If using the Popup to display content not related
    * to features in the map, such as the results from a task, then you must set this
    * property before [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#open) the popup.
    *
@@ -481,11 +494,8 @@ export abstract class ArcgisPopup 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-popup/#content) and [heading](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#heading) directly, it is recommended to call [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#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-popup/#active)
    * @see [clear()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#clear)
    * @since 5.0
    * @example
@@ -493,7 +503,6 @@ export abstract class ArcgisPopup 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);
@@ -507,6 +516,8 @@ export abstract class ArcgisPopup 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-popup/#features) array.
+   *
+   * @deprecated since 5.1.
    */
   accessor promises: Array<Promise<Array<Graphic>>>;
   /**
@@ -530,7 +541,7 @@ export abstract class ArcgisPopup extends LitElement {
    * Returns a reference to the current [arcgis-feature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-feature/) that the Popup is using.
    * This is useful if needing to get a reference to the component in order to make any changes to it.
    */
-  get selectedFeatureComponent(): ArcgisFeature | null;
+  get selectedFeatureComponent(): ArcgisFeatureNext | null;
   /**
    * Index of the feature that is [selectedFeature](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#selectedFeature). When [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#features) are set,
    * the first index is automatically selected.
@@ -572,25 +583,11 @@ export abstract class ArcgisPopup 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](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-popup/#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-popup/#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>;
   /**