@arcgis/map-components 5.2.0-next.3 → 5.2.0-next.31

package/dist/components/arcgis-feature-utility-network-associations/customElement.js

@@ -11,15 +11,14 @@ import { watch as A } from "@arcgis/core/core/reactiveUtils.js";
 import * as x from "@arcgis/core/core/sql.js";
 import P from "@arcgis/core/rest/networks/support/NetworkElement.js";
 import U from "@arcgis/core/rest/networks/support/QueryAssociationsParameters.js";
-import Q from "@arcgis/core/rest/support/Query.js";
-import { LitElement as B, renderElement as q } from "@arcgis/lumina";
+import { LitElement as Q, renderElement as q } from "@arcgis/lumina";
 import { debounce as T } from "@arcgis/toolkit/function";
 import G from "@arcgis/core/popup/Feature.js";
-const R = M`.list-container{min-height:var(--calcite-spacing-xxxl)}.loading-container{display:flex;justify-content:center;padding:var(--calcite-spacing-md) 0;width:100%}.sticky-loading-container{display:flex;position:sticky;bottom:var(--calcite-spacing-sm);align-items:center;justify-content:center;z-index:2;margin:0;padding:0;height:var(--calcite-spacing-xxxl);pointer-events:none;height:500px}`, L = 100, $ = {
+const B = M`.list-container{min-height:var(--calcite-spacing-xxxl)}.loading-container{display:flex;justify-content:center;padding:var(--calcite-spacing-md) 0;width:100%}.sticky-loading-container{display:flex;position:sticky;bottom:var(--calcite-spacing-sm);align-items:center;justify-content:center;z-index:2;margin:0;padding:0;height:var(--calcite-spacing-xxxl);pointer-events:none;height:500px}`, L = 100, $ = {
   assetGroup: "assetgroup",
   assetType: "assettype"
 }, N = "{00000000-0000-0000-0000-000000000000}";
-class O extends B {
+class R extends Q {
   constructor() {
     super(...arguments), this._addFlowItem = (t) => {
       t && this.flowItems?.push(t);
@@ -51,7 +50,7 @@ class O extends B {
     this.properties = { _activeAssociationType: 16, _associationFeatures: 16, _associationViewModels: 16, _canLoad: 16, _canQuery: 16, _featureCount: 16, _loaded: 16, _queryAbortController: 16, _queryFeatureCountAbortController: 16, _queryPageAbortController: 16, _state: 16, associationTypes: 0, autoDestroyDisabled: 5, description: 1, flowItems: 0, useFeatureNextFlowItem: 5, flowType: 1, graphic: 0, heading: 1, headingLevel: 9, layer: 0, map: 0, messages: 0, parentFeatureViewModel: 0, referenceElement: 1, source: 1, spatialReference: 0, timeZone: 1, view: 0 };
   }
   static {
-    this.styles = R;
+    this.styles = B;
   }
   get _globalId() {
     return (this._globalIdField && this.graphic?.attributes?.[this._globalIdField]) ?? null;
@@ -82,8 +81,8 @@ class O extends B {
     return !!this.layer?.capabilities?.query?.supportsPagination;
   }
   get _state() {
-    const { _canLoad: t, _canQuery: e, _featureCount: s, _loaded: o, _queryAbortController: i, _queryFeatureCountAbortController: a, _queryPageAbortController: u, associationTypes: n } = this;
-    return a || t && !o ? "loading" : i || u ? "querying" : !this._globalId || !n || !e || !s ? "disabled" : "ready";
+    const { _canLoad: t, _canQuery: e, _featureCount: s, _loaded: o, _queryAbortController: i, _queryFeatureCountAbortController: a, _queryPageAbortController: r, associationTypes: c } = this;
+    return a || t && !o ? "loading" : i || r ? "querying" : !this._globalId || !c || !e || !s ? "disabled" : "ready";
   }
   get heading() {
     return this._heading;
@@ -133,12 +132,8 @@ class O extends B {
     });
   }
   async _countAssociatedFeatureCount(t, e, s, o, i) {
-    const a = this._getFeatureQueryWhereClause(t, e, s, o);
-    return await t.queryFeatureCount({
-      where: a,
-      outFields: ["*"],
-      returnGeometry: !1
-    }, {
+    const a = this._getFeatureQueryWhereClause(t, e, s, o), r = t.createQuery();
+    return r.where = a, r.outFields = ["*"], r.returnGeometry = !1, await t.queryFeatureCount(r, {
       signal: i?.signal
     });
   }
@@ -147,18 +142,18 @@ class O extends B {
       return 0;
     const a = await this._findLayersBySourceId(t);
     await this._loadLayers(a);
-    const u = a.map((c) => this._countAssociatedFeatureCount(c, e, s, o, i));
-    return (await Promise.all(u)).reduce((c, d) => c + d, 0);
+    const r = a.map((l) => this._countAssociatedFeatureCount(l, e, s, o, i));
+    return (await Promise.all(r)).reduce((l, d) => l + d, 0);
   }
   async _createAssociationFeatureObjects(t, e, s, o, i) {
     if (!t.length)
       return [];
-    const a = /* @__PURE__ */ new Map(), u = Array.from(e.entries()).map(async ([c, d]) => {
-      const l = await this._findLayersBySourceId(c);
-      await this._loadLayers(l);
-      const y = l.map((r) => this._queryLayer(r, d, s, o, i));
-      (await Promise.all(y)).forEach((r) => {
-        r.forEach((h) => {
+    const a = /* @__PURE__ */ new Map(), r = Array.from(e.entries()).map(async ([l, d]) => {
+      const u = await this._findLayersBySourceId(l);
+      await this._loadLayers(u);
+      const y = u.map((n) => this._queryLayer(n, d, s, o, i));
+      (await Promise.all(y)).forEach((n) => {
+        n.forEach((h) => {
           if (this.source === "popup" ? h.sourceLayer && h.getEffectivePopupTemplate() : !!h.sourceLayer) {
             const f = h.layer.globalIdField ?? "", g = h.getAttribute(f), F = a.get(g) ?? [];
             F.push(h), a.set(g, F);
@@ -166,38 +161,38 @@ class O extends B {
         });
       });
     });
-    await Promise.all(u);
-    const n = [];
-    return await Promise.all(t.toArray().map(async (c) => {
-      const { fromNetworkElement: d, toNetworkElement: l } = c, y = d.globalId === this._globalId ? l : d, p = a.get(y.globalId) ?? [];
-      await Promise.all(p.map(async (r) => {
-        const h = this._utilityNetwork?.getTerminalById(y?.terminalId ?? void 0)?.name, _ = await r.sourceLayer.getFeatureTitle(r) || this._getFeatureTitle(r);
-        n.push({
+    await Promise.all(r);
+    const c = [];
+    return await Promise.all(t.toArray().map(async (l) => {
+      const { fromNetworkElement: d, toNetworkElement: u } = l, y = d.globalId === this._globalId ? u : d, p = a.get(y.globalId) ?? [];
+      await Promise.all(p.map(async (n) => {
+        const h = this._utilityNetwork?.getTerminalById(y?.terminalId ?? void 0)?.name, _ = await n.sourceLayer.getFeatureTitle(n) || this._getFeatureTitle(n);
+        c.push({
           title: _,
-          feature: r,
-          association: c,
+          feature: n,
+          association: l,
           terminalName: h
         });
       }));
-    })), n;
+    })), c;
   }
   _destroyAssociatedFeatureViewModels() {
     this._associationViewModels.forEach((t) => t.destroyAll());
   }
   _equals(t, e) {
     if (t.globalId === N && e.globalId === N) {
-      let s = function(d, l) {
-        return d.networkSourceId === l.networkSourceId && d.globalId === l.globalId && d.terminalId === l.terminalId && d.firstUnit === l.firstUnit && d.numUnits === l.numUnits;
+      let s = function(d, u) {
+        return d.networkSourceId === u.networkSourceId && d.globalId === u.globalId && d.terminalId === u.terminalId && d.firstUnit === u.firstUnit && d.numUnits === u.numUnits;
       };
-      const o = t.fromNetworkElement, i = t.toNetworkElement, a = e.fromNetworkElement, u = e.toNetworkElement, n = s(o, a), c = s(i, u);
-      return n && c && t.associationType === e.associationType;
+      const o = t.fromNetworkElement, i = t.toNetworkElement, a = e.fromNetworkElement, r = e.toNetworkElement, c = s(o, a), l = s(i, r);
+      return c && l && t.associationType === e.associationType;
     }
     return t.globalId != null && e.globalId != null && t.globalId === e.globalId;
   }
   async _findLayersBySourceId(t) {
     const { _utilityNetwork: e, map: s } = this;
     e?.loaded || await e?.load();
-    const o = e.getLayerIdBySourceId(t), i = s.allLayers.filter((n) => !!e?.isUtilityLayer(n) && n.layerId === o), a = s.allTables.filter((n) => !!e?.isUtilityLayer(n) && n.layerId === o);
+    const o = e.getLayerIdBySourceId(t), i = s.allLayers.filter((c) => !!e?.isUtilityLayer(c) && c.layerId === o), a = s.allTables.filter((c) => !!e?.isUtilityLayer(c) && c.layerId === o);
     return i.concat(a).toArray();
   }
   _getAssociationsByType(t) {
@@ -246,15 +241,15 @@ class O extends B {
     }
   }
   _getFeatureQueryWhereClause(t, e, s, o) {
-    const i = t.globalIdField, a = t.fieldsIndex.get($.assetGroup), u = t.fieldsIndex.get($.assetType), n = s != null, c = o != null, d = i ? x.sqlIn(i, e) : null, l = n ? `(${a?.name} = ${s})` : null, y = n && c ? `(${u?.name} = ${o})` : null;
-    return [d, l, y].filter(Boolean).join(" AND ");
+    const i = t.globalIdField, a = t.fieldsIndex.get($.assetGroup), r = t.fieldsIndex.get($.assetType), c = s != null, l = o != null, d = i ? x.sqlIn(i, e) : null, u = c ? `(${a?.name} = ${s})` : null, y = c && l ? `(${r?.name} = ${o})` : null;
+    return [d, u, y].filter(Boolean).join(" AND ");
   }
   _getFeatureTitle(t) {
     const e = t.attributes, s = t.sourceLayer;
     if (!e || !s)
       return "";
-    const o = "displayField" in s ? s.displayField : null, i = o != null ? e[o.toString()] : null, a = i != null ? i.toString() : null, u = t.getObjectId()?.toString();
-    return a || u || "";
+    const o = "displayField" in s ? s.displayField : null, i = o != null ? e[o.toString()] : null, a = i != null ? i.toString() : null, r = t.getObjectId()?.toString();
+    return a || r || "";
   }
   _getParentFeatureDescription() {
     const { parentFeatureViewModel: t } = this;
@@ -289,12 +284,12 @@ class O extends B {
     return this._equals(t.association, e.association);
   }
   async _queryAssociatedFeatures(t, e) {
-    const { layer: s, _globalId: o, associationTypes: i, _utilityNetwork: a, _canQuery: u, _associationFeatures: n } = this;
-    if (await Promise.allSettled([s?.load(), a?.load()]), !u || !s || !i || !a)
+    const { layer: s, _globalId: o, associationTypes: i, _utilityNetwork: a, _canQuery: r, _associationFeatures: c } = this;
+    if (await Promise.allSettled([s?.load(), a?.load()]), !r || !s || !i || !a)
       return;
-    const c = this._getAssociationsByType(t.type), { associatedAssetGroup: d, associatedAssetType: l } = t, y = /* @__PURE__ */ new Map();
-    c.forEach((r) => {
-      const { fromNetworkElement: h, toNetworkElement: _ } = r, { networkSourceId: f, elementGlobalId: g } = h.globalId === o ? {
+    const l = this._getAssociationsByType(t.type), { associatedAssetGroup: d, associatedAssetType: u } = t, y = /* @__PURE__ */ new Map();
+    l.forEach((n) => {
+      const { fromNetworkElement: h, toNetworkElement: _ } = n, { networkSourceId: f, elementGlobalId: g } = h.globalId === o ? {
         networkSourceId: _.networkSourceId,
         elementGlobalId: _.globalId
       } : {
@@ -303,52 +298,52 @@ class O extends B {
       }, F = y.get(f) || [];
       F.push(g), y.set(f, F);
     });
-    const p = await this._createAssociationFeatureObjects(c, y, d, l, e);
-    this._parseFeatureObjects(p, n);
+    const p = await this._createAssociationFeatureObjects(l, y, d, u, e);
+    this._parseFeatureObjects(p, c);
   }
   async _queryAssociations(t) {
     const { layer: e, _globalId: s, associationTypes: o, _utilityNetwork: i, _canQuery: a } = this;
     if (await Promise.allSettled([e?.load(), i?.load()]), this._clearAssociations(), !a || !e || !o || !i || !s)
       return;
-    const u = k(e) ? e.parent : e, n = new P({
+    const r = k(e) ? e.parent : e, c = new P({
       globalId: s,
-      networkSourceId: i.getSourceIdByLayerId(u.layerId)
-    }), c = /* @__PURE__ */ new Set();
-    o.forEach((r) => {
-      switch (r.type) {
+      networkSourceId: i.getSourceIdByLayerId(r.layerId)
+    }), l = /* @__PURE__ */ new Set();
+    o.forEach((n) => {
+      switch (n.type) {
         case "attachment":
         case "structure":
-          c.add("attachment");
+          l.add("attachment");
           break;
         case "container":
         case "content":
-          c.add("containment");
+          l.add("containment");
           break;
         case "connectivity":
-          c.add("connectivity"), c.add("junction-junction-connectivity"), c.add("junction-edge-from-connectivity"), c.add("junction-edge-midspan-connectivity"), c.add("junction-edge-to-connectivity");
+          l.add("connectivity"), l.add("junction-junction-connectivity"), l.add("junction-edge-from-connectivity"), l.add("junction-edge-midspan-connectivity"), l.add("junction-edge-to-connectivity");
           break;
       }
     });
     const d = await i?.queryAssociations(new U({
-      elements: [n],
-      types: Array.from(c)
+      elements: [c],
+      types: Array.from(l)
     }), {
       signal: t?.signal
-    }), l = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
-    o.forEach((r) => {
-      y.set(r.type, r), l.set(r.type, []);
-    }), d.forEach((r) => {
-      const { toNetworkElement: h, fromNetworkElement: _ } = r;
-      switch (r.associationType) {
+    }), u = /* @__PURE__ */ new Map(), y = /* @__PURE__ */ new Map();
+    o.forEach((n) => {
+      y.set(n.type, n), u.set(n.type, []);
+    }), d.forEach((n) => {
+      const { toNetworkElement: h, fromNetworkElement: _ } = n;
+      switch (n.associationType) {
         case "attachment":
           if (_?.globalId === s) {
             if (this._shouldDiscardNetworkElement(h, "attachment", y))
               break;
-            l.get("attachment")?.push(h.globalId), this._attachmentAssociations.add(r);
+            u.get("attachment")?.push(h.globalId), this._attachmentAssociations.add(n);
           } else {
             if (this._shouldDiscardNetworkElement(_, "structure", y))
               break;
-            l.get("structure")?.push(_.globalId), this._structureAssociations.add(r);
+            u.get("structure")?.push(_.globalId), this._structureAssociations.add(n);
           }
           break;
         case "connectivity":
@@ -359,30 +354,30 @@ class O extends B {
           if (_?.globalId === s) {
             if (this._shouldDiscardNetworkElement(h, "connectivity", y))
               break;
-            l.get("connectivity")?.push(h.globalId);
+            u.get("connectivity")?.push(h.globalId);
           } else {
             if (this._shouldDiscardNetworkElement(_, "connectivity", y))
               break;
-            l.get("connectivity")?.push(_.globalId);
+            u.get("connectivity")?.push(_.globalId);
           }
-          this._connectivityAssociations.add(r);
+          this._connectivityAssociations.add(n);
           break;
         case "containment":
           if (_?.globalId === s) {
             if (this._shouldDiscardNetworkElement(h, "content", y))
               break;
-            l.get("content")?.push(h.globalId), this._contentAssociations.add(r);
+            u.get("content")?.push(h.globalId), this._contentAssociations.add(n);
           } else {
             if (this._shouldDiscardNetworkElement(_, "container", y))
               break;
-            l.get("container")?.push(_.globalId), this._containerAssociations.add(r);
+            u.get("container")?.push(_.globalId), this._containerAssociations.add(n);
           }
           break;
       }
     });
-    const p = o.map(async (r) => {
-      const { associatedNetworkSourceId: h, associatedAssetGroup: _, associatedAssetType: f } = r, g = l.get(r.type), b = _ != null ? await this._countAssociatedFeatures(h, g, _, f, t) : g.length;
-      switch (r.type) {
+    const p = o.map(async (n) => {
+      const { associatedNetworkSourceId: h, associatedAssetGroup: _, associatedAssetType: f } = n, g = u.get(n.type), b = _ != null ? await this._countAssociatedFeatures(h, g, _, f, t) : g.length;
+      switch (n.type) {
         case "attachment":
           this._attachmentFeatureCount = b;
           break;
@@ -412,12 +407,10 @@ class O extends B {
     await this._queryAssociations(t), this._featureCount = this._attachmentFeatureCount + this._connectivityFeatureCount + this._containerFeatureCount + this._contentFeatureCount + this._structureFeatureCount;
   }
   async _queryLayer(t, e, s, o, i) {
-    const a = this._getFeatureQueryWhereClause(t, e, s, o), u = new Q({
-      where: a,
-      outFields: ["*"],
-      cacheHint: this._supportsCacheHint
-    }), { features: n } = await D(t, u, i);
-    return n;
+    const a = this._getFeatureQueryWhereClause(t, e, s, o), r = t.createQuery();
+    r.where = a, r.outFields = ["*"], r.returnGeometry = !1, r.cacheHint = this._supportsCacheHint;
+    const { features: c } = await D(t, r, i);
+    return c;
   }
   _parseFeatureObjects(t, e) {
     const s = I();
@@ -434,20 +427,20 @@ class O extends B {
   }
   _setUpUtilityNetworkAssociationsViewModels() {
     this._associationViewModels.forEach((i, a) => {
-      const u = this._associationFeatures.get(a);
-      u ? i.forEach((n) => {
-        u.find((d) => this._matchesGlobalFeature(n, d)) || (i.remove(n), i.length || this._associationViewModels.delete(a));
+      const r = this._associationFeatures.get(a);
+      r ? i.forEach((c) => {
+        r.find((d) => this._matchesGlobalFeature(c, d)) || (i.remove(c), i.length || this._associationViewModels.delete(a));
       }) : (i.removeAll(), this._associationViewModels.delete(a));
     });
     const { map: t, view: e, spatialReference: s, timeZone: o } = this;
     this._associationFeatures.forEach((i, a) => {
-      const u = this._associationViewModels.get(a) || new w();
-      i?.filter(Boolean).forEach((n, c) => {
-        if (!u.some((l) => this._matchesGlobalFeature(l, n))) {
-          const { association: l, feature: y, terminalName: p, title: r } = n;
-          u.add({
-            title: r,
-            association: l,
+      const r = this._associationViewModels.get(a) || new w();
+      i?.filter(Boolean).forEach((c, l) => {
+        if (!r.some((u) => this._matchesGlobalFeature(u, c))) {
+          const { association: u, feature: y, terminalName: p, title: n } = c;
+          r.add({
+            title: n,
+            association: u,
             featureViewModel: new G({
               abilities: { utilityNetworkAssociationsContent: !1 },
               map: t,
@@ -457,9 +450,9 @@ class O extends B {
               graphic: y
             }),
             terminalName: p
-          }, c);
+          }, l);
         }
-      }), this._associationViewModels.set(a, u);
+      }), this._associationViewModels.set(a, r);
     });
   }
   _shouldDiscardNetworkElement(t, e, s) {
@@ -499,7 +492,7 @@ class O extends B {
     return this._state === "querying" ? m`<div class="sticky-loading-container">${this._renderLoadingIcon()}</div>` : null;
   }
 }
-S("arcgis-feature-utility-network-associations", O);
+S("arcgis-feature-utility-network-associations", R);
 export {
-  O as ArcgisFeatureUtilityNetworkAssociations
+  R as ArcgisFeatureUtilityNetworkAssociations
 };

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

@@ -83,6 +83,16 @@ export abstract class ArcgisFeatures extends LitElement {
    * @default false
    */
   accessor collapsed: boolean;
+  /**
+   * Controls the direction the content collapses when the collapse button is used.
+   * When unset, the component chooses a direction based on the [feature navigation placement](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureNavigationTop).
+   *
+   * @since 5.1
+   * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton)
+   * @see [collapsed](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapsed)
+   * @see [featureNavigationTop](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#featureNavigationTop)
+   */
+  accessor collapseDirection: "down" | "up" | undefined;
   /**
    * The content of the component. When set directly on the component, this content is static and cannot use fields to set content templates. To set a template for the content based on field or attribute names, see [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content).
    *
@@ -134,9 +144,12 @@ export abstract class ArcgisFeatures extends LitElement {
   /**
    * Indicates whether the feature navigation arrows are displayed at the top of the component.
    * By default, the navigation arrows are displayed at the bottom of the component.
+   * This property also controls the collapse button's icon direction when the [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection) property is not set. When `featureNavigationTop` is `true`, the collapse button icon defaults to collapsing "up" and when `false` it defaults to collapsing "down".
    *
    * @default false
    * @since 4.34
+   * @see [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection)
+   * @see [showCollapseButton](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#showCollapseButton)
    */
   accessor featureNavigationTop: boolean;
   /**
@@ -493,6 +506,8 @@ export abstract class ArcgisFeatures extends LitElement {
    * no pending promises, the value is `null`. When the pending promises are
    * resolved they are removed from this array and the features they return
    * are pushed into the [features](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#features) array.
+   *
+   * @deprecated since 5.1.
    */
   accessor promises: Array<Promise<Array<Graphic>>>;
   /**
@@ -530,6 +545,8 @@ export abstract class ArcgisFeatures extends LitElement {
    * Indicates whether to show the collapse button in the component.
    *
    * @default false
+   * @see [collapsed](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapsed)
+   * @see [collapseDirection](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#collapseDirection)
    */
   accessor showCollapseButton: boolean;
   /**
@@ -576,7 +593,6 @@ export abstract class ArcgisFeatures extends LitElement {
    * - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) or [bin](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/)).
    * - Values from `date` and `timestamp-offset` fields should respect the view's [time zone](https://developers.arcgis.com/javascript/latest/references/core/views/View/#timeZone).
    * Alternatively, set the [timeZone](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#timeZone) property.
-   * - Using the [fetchFeatures()](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#fetchFeatures) method or the `fetchFeatures` option in the [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open) method.
    * - Using the `Zoom to` default action. If the `view` is not specified, set the [includeDefaultActionsDisabled](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#includeDefaultActionsDisabled) property to `true` to remove this default action.
    *
    * @since 4.34
@@ -599,25 +615,11 @@ export abstract class ArcgisFeatures extends LitElement {
   /**
    * Use this method to return feature(s) at a given screen location. These features are fetched from all of the [LayerViews](https://developers.arcgis.com/javascript/latest/references/core/views/layers/LayerView/) in the [view](https://developers.arcgis.com/javascript/latest/references/core/views/View/). In order to use this, a layer must already have an associated [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) and have its [popupEnabled](https://developers.arcgis.com/javascript/latest/references/core/layers/FeatureLayer/#popupEnabled). This method allows a developer to control how the input location is handled. For example, you may want to fetch features on a `click` event or on a `pointer-move` event. This method automatically sets the location based on the input event's screen coordinates.
    *
+   * @deprecated since 5.1. Use the `fetchPopupFeatures` method on the [Map](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/#fetchPopupFeatures), [Scene](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-scene/#fetchPopupFeatures), or [Link Chart](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-link-chart/#fetchPopupFeatures) component to fetch features based on a screen location.
    * @param screenPoint
    * @param options
+   * @deprecated
    * @see [open](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-features/#open)
-   * @example
-   * ```js
-   * const viewElement = document.querySelector("arcgis-map");
-   * // Get viewElement's click event
-   * reactiveUtils.on(()=>viewElement, "arcgisViewClick", async (event)=>{
-   *   // Call fetchFeatures on the component and pass in the click event detail
-   *   await component.fetchFeatures(event.detail);
-   * });
-   * // Watch for changes to the features property and open the component when features are available.
-   * reactiveUtils.watch(
-   *   () => component.features,
-   *   () => {
-   *     component.open = component.features ? true : false;
-   *   },
-   * );
-   * ```
    */
   fetchFeatures(screenPoint?: ScreenPoint, options?: FetchFeaturesOptions): Promise<void>;
   /**
@@ -645,9 +647,9 @@ export abstract class ArcgisFeatures extends LitElement {
    */
   setFocus(): Promise<void>;
   /**
-   * Triggers the [@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 [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/#event-arcgisTriggerAction) event and executes the specified default action.
    *
+   * @deprecated since 5.1. Trigger actions with manual user interaction within the component.
    * @param action
    */
   triggerAction(action: ActionButton | ActionToggle): Promise<void>;