@arcgis/core 5.2.0-next.112 → 5.2.0-next.114

package/layers/list/types.d.ts

@@ -1,29 +1,47 @@
-import type Item from "./Item.js";
-import type ActionButton from "../../support/actions/ActionButton.js";
-import type ActionToggle from "../../support/actions/ActionToggle.js";
-
 /**
- * Identifies a displayable part of [TrackInfo](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TrackInfo/).
+ * Shared types for layer list workflows.
  *
  * @beta
  * @since 5.2
  */
-export type TrackInfoType = "latestObservations" | "previousObservations" | "trackLines";
+import type Layer from "../Layer.js";
+import type SubtypeGroupLayer from "../SubtypeGroupLayer.js";
+import type Item from "./Item.js";
+import type ItemPanel from "./ItemPanel.js";
+import type LayerItemCollection from "./LayerItemCollection.js";
+import type TableItem from "./TableItem.js";
+import type TableItemCollection from "./TableItemCollection.js";
+import type TableItemPanel from "./TableItemPanel.js";
+import type Sublayer from "../support/Sublayer.js";
+import type SubtypeSublayer from "../support/SubtypeSublayer.js";
+import type ActionButton from "../../support/actions/ActionButton.js";
+import type ActionToggle from "../../support/actions/ActionToggle.js";
+import type LayerView from "../../views/layers/LayerView.js";
+import type { StreamLayerViewConnectionStatus } from "../../views/layers/StreamLayerView.js";
+
+/** An action element that can be associated with a list item. */
+export type Action = ActionButton | ActionToggle;
 
 /**
- * Identifies a displayable telemetry element of [VideoLayer.telemetryDisplay](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/#telemetryDisplay).
+ * Represents a layer view for stream layers that provides connection status information.
+ * Used to determine the current connection state of a stream layer in the view.
  *
- * @beta
- * @since 5.2
+ * @see [Item.connectionStatus](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#connectionStatus)
  */
-export type TelemetryDisplayType = "frame" | "frameCenter" | "frameOutline" | "lineOfSight" | "sensorLocation" | "sensorPath" | "sensorTrail";
+export type ConnectedLayerView = LayerView
+  & {
+  /** The current connection status of the stream layer view. */
+  connectionStatus: StreamLayerViewConnectionStatus;
+};
 
 /**
- * Identifies the content represented by a [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/).
+ * A function used to filter which [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) objects are included.
  *
- * @beta
- * @since 5.2
+ * @param item - The list item to evaluate for inclusion.
  */
+export type FilterPredicate = (item: Item) => boolean;
+
+/** Identifies the content represented by a [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/). */
 export type ItemContent = { type: "layer"; } | {
     type: "track-info";
     name: TrackInfoType;
@@ -33,53 +51,156 @@ export type ItemContent = { type: "layer"; } | {
 };
 
 /**
- * Specifies the style of the visibility toggle displayed by list UIs.
+ * A function for customizing a list item as it is created.
  *
- * @since 5.2
+ * @param event - The event containing the list item to customize.
  */
-export type VisibilityAppearance = "default" | "checkbox";
+export type ItemModifier = (event: ItemModifierEvent) => void;
 
 /**
- * A function used to filter which [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/) objects are included.
+ * Event object passed to [ItemModifier](https://developers.arcgis.com/javascript/latest/references/core/layers/list/types/#ItemModifier).
+ * Provides access to the list item being created.
+ */
+export interface ItemModifierEvent {
+  /** The list item instance being created. */
+  item: Item;
+}
+
+/**
+ * Arbitrary data associated with the panel.
  *
- * @param item - The list item to evaluate for inclusion.
- * @since 5.2
+ * @see [ItemPanel.content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/#content)
  */
-export type FilterPredicate = (item: Item) => boolean;
+export type ItemPanelContent = "legend" | HTMLElement | string;
 
 /**
- * A function for customizing a list item as it is created.
+ * Defines one or more panel content values.
  *
- * @param event - The event containing the list item to customize.
- * @since 5.2
+ * @see [ItemPanel.content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/#content)
  */
-export type ItemModifier = (event: ItemModifierEvent) => void;
+export type ItemPanelContents = ItemPanelContent | ItemPanelContent[];
+
+/** Properties used to construct a [ItemPanel](https://developers.arcgis.com/javascript/latest/references/core/layers/list/ItemPanel/). */
+export type ItemPanelProperties = Partial<Pick<ItemPanel, "content" | "disabled" | "flowEnabled" | "icon" | "image" | "listItem" | "open" | "title" | "visible">>;
+
+/** Properties used to construct a [Item](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/). */
+export type ItemProperties = Partial<Pick<Item, "actionsExpanded" | "actionsOpen" | "actionsSections" | "checkPublishStatusEnabled" | "children" | "childrenSortable" | "connectionStatus" | "content" | "error" | "expanded" | "hidden" | "layer" | "layerView" | "listItemCreatedFunction" | "listModeDisabled" | "open" | "panel" | "parent" | "sortable" | "title" | "view" | "visible">>;
 
 /**
- * Event object passed to [ItemModifier](https://developers.arcgis.com/javascript/latest/references/core/layers/list/types/#ItemModifier).
- * Provides access to the list item being created.
+ * Defines how the visibility of child layers is managed within a list item.
  *
- * @since 5.2
+ * - `independent`: Each child layer's visibility is controlled separately.
+ * - `inherited`: Child layers inherit the visibility from their parent layer.
+ * - `exclusive`: Only one child layer can be visible at a time.
+ *
+ * @see [Item.visibilityMode](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#visibilityMode)
  */
-export interface ItemModifierEvent {
+export type ItemVisibilityMode = "independent" | "inherited" | "exclusive";
+
+/** Properties used to construct a [LayerItemCollection](https://developers.arcgis.com/javascript/latest/references/core/layers/list/LayerItemCollection/). */
+export type LayerItemCollectionProperties = Partial<Pick<LayerItemCollection, "listItemCreatedFunction" | "operationalItems" | "view">>;
+
+/** The event object for the `trigger-action` event in the layer lists. */
+export interface LayerItemCollectionTriggerActionEvent {
+  /** The action that was clicked by the user. */
+  action: Action;
+  /** The list item associated with the action. */
+  item: Item;
+}
+
+/**
+ * Represents a layer view that supports spatial referencing. Used to indicate whether the
+ * associated layer view can operate with a spatial reference in the current view context.
+ *
+ * @see [Item.layerView](https://developers.arcgis.com/javascript/latest/references/core/layers/list/Item/#layerView)
+ */
+export type SpatiallyReferencedLayerView = LayerView
+  & {
+  /** Indicates if the layer view supports the current spatial reference. */
+  spatialReferenceSupported: boolean;
+};
+
+/** Describes the current state of list item processing. */
+export type State = "ready" | "loading" | "disabled";
+
+/** @internal */
+export type TableItemCollectionLayer = TableItemLayer;
+
+/** @internal */
+export type TableItemCollectionProperties = Partial<Pick<TableItemCollection, "listItemCreatedFunction" | "map" | "tableItems" | "tables">>;
+
+/**
+ * The event object for the `trigger-action` event in the table list.
+ *
+ * @internal
+ */
+export interface TableItemCollectionTriggerActionEvent {
   /**
-   * The list item instance being created.
+   * The action clicked by the user.
    *
-   * @since 5.2
+   * @internal
    */
-  item: Item;
+  action: Action;
+  /**
+   * An item associated with the action.
+   *
+   * @internal
+   */
+  item: TableItem;
 }
 
+/** @internal */
+export type TableItemLayer = Layer | Layer | Sublayer | SubtypeGroupLayer | SubtypeSublayer;
+
 /**
- * An action element that can be associated with a list item.
+ * Function used to customize table list items during creation.
  *
- * @since 5.2
+ * @param event - The event containing the table list item being created.
+ * @internal
  */
-export type Action = ActionButton | ActionToggle;
+export type TableItemModifier = (event: TableItemModifierEvent) => void;
 
 /**
- * Describes the current state of list item processing.
+ * Event object passed to a table list item creation callback.
  *
- * @since 5.2
+ * @internal
+ */
+export interface TableItemModifierEvent {
+  /**
+   * The table list item being created.
+   *
+   * @internal
+   */
+  item: TableItem;
+}
+
+/**
+ * The content associated with a table list item panel.
+ *
+ * @internal
+ * @see [TableItemPanel.content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/TableItemPanel/#content)
  */
-export type State = "ready" | "loading" | "disabled";
+export type TableItemPanelContent = "legend" | HTMLElement | string;
+
+/**
+ * Defines one or more content values for a table list item panel.
+ *
+ * @internal
+ * @see [TableItemPanel.content](https://developers.arcgis.com/javascript/latest/references/core/layers/list/TableItemPanel/#content)
+ */
+export type TableItemPanelContents = TableItemPanelContent | TableItemPanelContent[];
+
+/** @internal */
+export type TableItemPanelProperties = Partial<Pick<TableItemPanel, "content" | "disabled" | "flowEnabled" | "icon" | "image" | "listItem" | "open" | "title" | "visible">>;
+
+/** @internal */
+export type TableItemProperties = Partial<Pick<TableItem, "actionsOpen" | "actionsSections" | "checkPublishStatusEnabled" | "children" | "error" | "hidden" | "layer" | "listItemCreatedFunction" | "listModeDisabled" | "open" | "panel" | "parent" | "publishing" | "sortable" | "title">>;
+
+/** Identifies a displayable telemetry element of [VideoLayer.telemetryDisplay](https://developers.arcgis.com/javascript/latest/references/core/layers/VideoLayer/#telemetryDisplay). */
+export type TelemetryDisplayType = "frame" | "frameCenter" | "frameOutline" | "lineOfSight" | "sensorLocation" | "sensorPath" | "sensorTrail";
+
+/** Identifies a displayable part of [TrackInfo](https://developers.arcgis.com/javascript/latest/references/core/layers/support/TrackInfo/). */
+export type TrackInfoType = "latestObservations" | "previousObservations" | "trackLines";
+
+/** Specifies the style of the visibility toggle displayed by list UIs. */
+export type VisibilityAppearance = "default" | "checkbox";

package/layers/support/ElevationQuery.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{result as e}from"../../core/asyncUtils.js";import t from"../../core/Error.js";import{assertIsSome as a}from"../../core/maybe.js";import{whenOrAbort as n,throwIfAbortError as o}from"../../core/promiseUtils.js";import{getMetersPerUnitForSR as i}from"../../core/units.js";import{initializeProjection as l,project as r}from"../../geometry/projectionUtils.js";import{fromExtent as s}from"../../geometry/support/aaBoundingRect.js";import{GeometryQueryContext as c,ExtentQueryContext as u,isTileInfoTilemapCache as m,getLods as f}from"./ElevationQueryContext.js";import{ElevationTile as p}from"./ElevationTile.js";import y from"./ElevationTileData.js";import{GeometryDescriptor as d}from"./GeometryDescriptor.js";import{TileElevationSampler as w}from"./TileElevationSampler.js";import{TileKey as h}from"./TileKey.js";async function v(e,a,n){if(e=n?.ignoreInvisibleLayers?e.filter(e=>e.visible):e.slice(),!e.length)throw new t(N,"Elevation queries require at least one elevation layer to fetch tiles from");const o=d.fromGeometry(a),i={...j,...n,returnSampleInfo:!0},l=e.pop(),r=await g(l,o,i),s=await I(e,r,i);return s.geometry=s.geometry.export(),n?.returnSampleInfo||delete s.sampleInfo,s}async function g(e,a,n){if(!e)throw new t(N,"Elevation queries require an elevation layer to fetch tiles from");if(!a||!(a instanceof d)&&"point"!==a.type&&"multipoint"!==a.type&&"polyline"!==a.type)throw new t("elevation-query:invalid-geometry","Only point, polyline and multipoint geometries can be used to query elevation");const o={...j,...n},i=o.signal;if("integrated-mesh-3dtiles"===e.type){const t=d.fromGeometry(a);if(e.queryElevationCallback&&e.replacesTerrain){const l=12.9*(n?.minDemResolution||0)+.71,r=await e.queryElevationCallback(t,{signal:i,maxGeometricError:l}),s=t.coordinates.map(()=>({demResolution:1,source:e})),c=await r.project(a.spatialReference,i);if(c){if(void 0!==o.noDataValue&&o.noDataValue!==Number.MAX_VALUE)for(const e of c.coordinates)e.z===Number.MAX_VALUE&&(e.z=o.noDataValue);return{geometry:c.export(),noDataValue:o.noDataValue??Number.MAX_VALUE,sampleInfo:s}}}const l=t.coordinates.map(()=>({demResolution:-1,source:e}));return{geometry:t.export(),noDataValue:Number.MAX_VALUE,sampleInfo:l}}const l=new c(e,a.spatialReference,o);return await e.load({signal:i}),await C(l,a,i),await R(l,i),await k(l,i),$(l),z(l,i)}async function T(e,a,n){if(e=Array.isArray(e)?e:[e],0===(e=n?.ignoreInvisibleLayers?e.filter(e=>e.visible):e.slice()).length)throw new t(N,"Elevation queries require at least one elevation layer to fetch tiles from");if(!a||"extent"!==a.type)throw new t("elevation-query:invalid-extent","Invalid or undefined extent");const o={...j,...n,returnSampleInfo:!0},i=E(e[e.length-1],a,o);if(1===e.length)return i;return D(e,a,await i,o)}async function E(e,t,a,n){const o=a.signal;await e.load({signal:o});const i=t.spatialReference,s=e.tileInfo.spatialReference;i.equals(s)||(await l([{source:i,dest:s}],{signal:o}),t=r(t,s));const c=new u(e,t,a,n);await R(c,o),await k(c,o);const m=c.elevationTiles,f=c.layer.tileInfo,p=c.parameters.noDataValue;return new w({noDataValue:p,tiles:m,tileInfo:f})}async function D(e,t,a,n){if(e.pop(),!e.length)return a;const o=a.samplers.filter(e=>!e.tile.hasNoDataValues).map(e=>s(e.extent)),i=await E(e[e.length-1],t,n,o);if(0===i.samplers.length)return a;const l=a.samplers.concat(i.samplers),r=n.noDataValue;return D(e,t,new w({samplers:l,noDataValue:r}),n)}async function I(e,t,n){const o=t.geometry.coordinates,i=t.sampleInfo;a(i);const l=new Array,r=new Array;for(let a=0;a<o.length;a++){i[a].demResolution<0&&e.length&&(l.push(o[a]),r.push(a))}const s=e.pop();if(null==s||0===l.length)return t;const c=t.geometry.clone(l),u=await g(s,c,n),m=u.sampleInfo;if(!m)throw new Error("no sampleInfo");return r.forEach((e,t)=>{o[e].z=u.geometry.coordinates[t].z,i[e].demResolution=m[t].demResolution,i[e].source=m[t].source}),I(e,t,n)}async function R(e,a){"geometry"===e.type&&L(e);const n=e.parameters.demResolution;if("number"==typeof n)U(e,n);else if("finest-contiguous"===n)await x(e,a);else{if("auto"!==n)throw new t("elevation-query:invalid-dem-resolution",`Invalid dem resolution value '${n}', expected a number, "finest-contiguous" or "auto"`);await A(e,a)}}async function x(e,t){const{tileInfo:a,tilemapCache:n}=e.layer,o=q(a,n,e.parameters.minDemResolution);await V(e,o,t)}async function V(e,a,i){const l=e.layer;if(e.selectTilesAtLOD(a),a<0)return;const r=l.tilemapCache,s=e.getTilesToFetch();try{if(r&&!m(r))await n(Promise.all(s.map(e=>r.fetchAvailability(e.level,e.row,e.col,{signal:i}))),i);else if(await k(e,i),!e.allElevationTilesFetched())throw e.clearElevationTiles(),new t("elevation-query:has-unavailable-tiles","Some elevation tiles are unavailable")}catch(c){o(c),await V(e,a-1,i)}}async function A(t,a){F(t),M(t);const i=t.layer.tilemapCache;if(!i||m(i))return b(t,a);const l=t.getTilesToFetch(),r={},s=l.map(async t=>{const n=new h(0,0,0),l=await e(i.fetchAvailabilityUpsample(t.level,t.row,t.col,n,{signal:a}));!1!==l.ok?null!=t.id&&(r[t.id]=n):o(l.error)});await n(Promise.all(s),a),t.remapTiles(r)}async function b(e,t){const a=e.layer.tileInfo;await k(e,t);let n=!1;e.forEachTileToFetch((e,t)=>{a.upsampleTile(e)?n=!0:t()}),n&&await b(e,t)}function q(e,t,a=0){const n=f(e,t);let o=n.length-1;if(a>0){const t=a/i(e.spatialReference),l=n.findIndex(e=>e.resolution<t);0===l?o=0:l>0&&(o=l-1)}return o}const j={maximumAutoTileRequests:20,noDataValue:0,returnSampleInfo:!1,demResolution:"auto",minDemResolution:0,signal:null};async function C(e,a,n){let o;const i=e.layer.tileInfo.spatialReference;if(a instanceof d?o=await a.project(i,n):(await l([{source:a.spatialReference,dest:i}],{signal:n}),o=r(a,i)),!o)throw new t("elevation-query:spatial-reference-mismatch",`Cannot query elevation in '${a.spatialReference.wkid}' on an elevation service in '${i.wkid}'`);e.geometry=d.fromGeometry(o)}function L(e){if(null==e.layer.fullExtent)return;const t=new p(new h(-1,-1,-1));t.sample=()=>e.parameters.noDataValue,e.outsideExtentTile=t;const a=e.layer.fullExtent;e.geometry.coordinates.forEach(e=>{const n=e.x,o=e.y;(n<a.xmin||n>a.xmax||o<a.ymin||o>a.ymax)&&(e.elevationTile=t)})}function S(e,t){const{tileInfo:a,tilemapCache:n}=e.layer,o=t/i(a.spatialReference),l=f(a,n);let r=l[0],s=0;for(let i=1;i<l.length;i++){const e=l[i];Math.abs(e.resolution-o)<Math.abs(r.resolution-o)&&(r=e,s=i)}return s}function U(e,t){const a=S(e,t);e.selectTilesAtLOD(a)}function F(e){const{tileInfo:t,tilemapCache:a}=e.layer,n=q(t,a,e.parameters.minDemResolution);e.selectTilesAtLOD(n,e.parameters.maximumAutoTileRequests)}async function k(e,t){const a=e.getTilesToFetch(),o={},i=e.parameters.cache,l=e.parameters.noDataValue,r={noDataValue:l,signal:t},s=a.map(async t=>{if(null==t.id)return;const a=`${e.layer.uid}:${t.id}:${l}`,n=i?.get(a),s=n??y.from(await e.layer.fetchTile(t.level,t.row,t.col,r));i?.put(a,s),o[t.id]=new p(t,s)});await n(Promise.allSettled(s),t),e.populateElevationTiles(o)}function M(e){const t=e.layer.tileInfo;let a=0;const n={},o=e=>{null!=e.id&&(e.id in n?n[e.id]++:(n[e.id]=1,a++))},i=e=>{if(null==e.id)return;const t=n[e.id];1===t?(delete n[e.id],a--):n[e.id]=t-1};e.forEachTileToFetch(o,i);let l=!0;for(;l&&(l=!1,e.forEachTileToFetch(n=>{a<=e.parameters.maximumAutoTileRequests||(i(n),t.upsampleTile(n)&&(l=!0),o(n))},i),l););}function $(e){e.geometry.coordinates.forEach(t=>{const a=t.elevationTile;let n=e.parameters.noDataValue;if(a){const e=a.sample(t.x,t.y);null==e?t.elevationTile=null:n=e}t.z=n})}async function z(e,t){const n=await e.geometry.project(e.outSpatialReference,t);a(n);const o={geometry:n.export(),noDataValue:e.parameters.noDataValue};return e.parameters.returnSampleInfo&&(o.sampleInfo=G(e)),e.geometry.coordinates.forEach(e=>{e.tile=null,e.elevationTile=null}),o}function G(e){const t=e.layer.tileInfo,a=i(t.spatialReference);return e.geometry.coordinates.map(n=>{let o=-1;if(n.elevationTile&&n.elevationTile!==e.outsideExtentTile){o=t.lodAt(n.elevationTile.key.level).resolution*a}return{demResolution:o,source:-1===o?void 0:e.layer}})}const N="elevation-query:invalid-layer";export{N as InvalidLayerError,T as createSampler,j as defaultOptions,q as getFinestLodIndex,g as query,v as queryAll};
+import{result as e}from"../../core/asyncUtils.js";import t from"../../core/Error.js";import has from"../../core/has.js";import{assertIsSome as a}from"../../core/maybe.js";import{whenOrAbort as o,throwIfAbortError as n}from"../../core/promiseUtils.js";import{getMetersPerUnitForSR as i}from"../../core/units.js";import{initializeProjection as r,project as l}from"../../geometry/projectionUtils.js";import{fromExtent as s}from"../../geometry/support/aaBoundingRect.js";import{GeometryQueryContext as c,ExtentQueryContext as u,isTileInfoTilemapCache as m,getLods as f}from"./ElevationQueryContext.js";import{ElevationTile as p}from"./ElevationTile.js";import y from"./ElevationTileData.js";import{GeometryDescriptor as d}from"./GeometryDescriptor.js";import{TileElevationSampler as w}from"./TileElevationSampler.js";import{TileKey as h}from"./TileKey.js";async function g(e,a,o){if(e=o?.ignoreInvisibleLayers?e.filter(e=>e.visible):e.slice(),!e.length)throw new t(z,"Elevation queries require at least one elevation layer to fetch tiles from");const n=d.fromGeometry(a),i={...j,...o,returnSampleInfo:!0},r=e.pop(),l=await v(r,n,i),s=await I(e,l,i);return s.geometry=s.geometry.export(),o?.returnSampleInfo||delete s.sampleInfo,s}async function v(e,a,o){if(!e)throw new t(z,"Elevation queries require an elevation layer to fetch tiles from");if(!a||!(a instanceof d)&&"point"!==a.type&&"multipoint"!==a.type&&"polyline"!==a.type)throw new t("elevation-query:invalid-geometry","Only point, polyline and multipoint geometries can be used to query elevation");const n={...j,...o},i=n.signal;if("integrated-mesh-3dtiles"===e.type){const t=d.fromGeometry(a);if(e.queryElevationCallback&&(has("enable-feature:im-as-ground")?e.isUsedAsGroundLayer:e.replacesTerrain)){const r=12.9*(o?.minDemResolution||0)+.71,l=await e.queryElevationCallback(t,{signal:i,maxGeometricError:r}),s=t.coordinates.map(()=>({demResolution:1,source:e})),c=await l.project(a.spatialReference,i);if(c){if(void 0!==n.noDataValue&&n.noDataValue!==Number.MAX_VALUE)for(const e of c.coordinates)e.z===Number.MAX_VALUE&&(e.z=n.noDataValue);return{geometry:c.export(),noDataValue:n.noDataValue??Number.MAX_VALUE,sampleInfo:s}}}const r=t.coordinates.map(()=>({demResolution:-1,source:e}));return{geometry:t.export(),noDataValue:Number.MAX_VALUE,sampleInfo:r}}if("integrated-mesh"===e.type){const t=d.fromGeometry(a),o=t.coordinates.map(()=>({demResolution:-1,source:e}));return{geometry:t.export(),noDataValue:Number.MAX_VALUE,sampleInfo:o}}const r=new c(e,a.spatialReference,n);return await e.load({signal:i}),await L(r,a,i),await R(r,i),await G(r,i),k(r),N(r,i)}async function T(e,a,o){if(e=Array.isArray(e)?e:[e],0===(e=o?.ignoreInvisibleLayers?e.filter(e=>e.visible):e.slice()).length)throw new t(z,"Elevation queries require at least one elevation layer to fetch tiles from");if(!a||"extent"!==a.type)throw new t("elevation-query:invalid-extent","Invalid or undefined extent");const n={...j,...o,returnSampleInfo:!0},i=E(e[e.length-1],a,n);if(1===e.length)return i;return D(e,a,await i,n)}async function E(e,t,a,o){const n=a.signal;await e.load({signal:n});const i=t.spatialReference,s=e.tileInfo.spatialReference;i.equals(s)||(await r([{source:i,dest:s}],{signal:n}),t=l(t,s));const c=new u(e,t,a,o);await R(c,n),await G(c,n);const m=c.elevationTiles,f=c.layer.tileInfo,p=c.parameters.noDataValue;return new w({noDataValue:p,tiles:m,tileInfo:f})}async function D(e,t,a,o){if(e.pop(),!e.length)return a;const n=a.samplers.filter(e=>!e.tile.hasNoDataValues).map(e=>s(e.extent)),i=await E(e[e.length-1],t,o,n);if(0===i.samplers.length)return a;const r=a.samplers.concat(i.samplers),l=o.noDataValue;return D(e,t,new w({samplers:r,noDataValue:l}),o)}async function I(e,t,o){const n=t.geometry.coordinates,i=t.sampleInfo;a(i);const r=new Array,l=new Array;for(let a=0;a<n.length;a++){i[a].demResolution<0&&e.length&&(r.push(n[a]),l.push(a))}const s=e.pop();if(null==s||0===r.length)return t;const c=t.geometry.clone(r),u=await v(s,c,o),m=u.sampleInfo;if(!m)throw new Error("no sampleInfo");return l.forEach((e,t)=>{n[e].z=u.geometry.coordinates[t].z,i[e].demResolution=m[t].demResolution,i[e].source=m[t].source}),I(e,t,o)}async function R(e,a){"geometry"===e.type&&U(e);const o=e.parameters.demResolution;if("number"==typeof o)S(e,o);else if("finest-contiguous"===o)await x(e,a);else{if("auto"!==o)throw new t("elevation-query:invalid-dem-resolution",`Invalid dem resolution value '${o}', expected a number, "finest-contiguous" or "auto"`);await V(e,a)}}async function x(e,t){const{tileInfo:a,tilemapCache:o}=e.layer,n=q(a,o,e.parameters.minDemResolution);await A(e,n,t)}async function A(e,a,i){const r=e.layer;if(e.selectTilesAtLOD(a),a<0)return;const l=r.tilemapCache,s=e.getTilesToFetch();try{if(l&&!m(l))await o(Promise.all(s.map(e=>l.fetchAvailability(e.level,e.row,e.col,{signal:i}))),i);else if(await G(e,i),!e.allElevationTilesFetched())throw e.clearElevationTiles(),new t("elevation-query:has-unavailable-tiles","Some elevation tiles are unavailable")}catch(c){n(c),await A(e,a-1,i)}}async function V(t,a){F(t),M(t);const i=t.layer.tilemapCache;if(!i||m(i))return b(t,a);const r=t.getTilesToFetch(),l={},s=r.map(async t=>{const o=new h(0,0,0),r=await e(i.fetchAvailabilityUpsample(t.level,t.row,t.col,o,{signal:a}));!1!==r.ok?null!=t.id&&(l[t.id]=o):n(r.error)});await o(Promise.all(s),a),t.remapTiles(l)}async function b(e,t){const a=e.layer.tileInfo;await G(e,t);let o=!1;e.forEachTileToFetch((e,t)=>{a.upsampleTile(e)?o=!0:t()}),o&&await b(e,t)}function q(e,t,a=0){const o=f(e,t);let n=o.length-1;if(a>0){const t=a/i(e.spatialReference),r=o.findIndex(e=>e.resolution<t);0===r?n=0:r>0&&(n=r-1)}return n}const j={maximumAutoTileRequests:20,noDataValue:0,returnSampleInfo:!1,demResolution:"auto",minDemResolution:0,signal:null};async function L(e,a,o){let n;const i=e.layer.tileInfo.spatialReference;if(a instanceof d?n=await a.project(i,o):(await r([{source:a.spatialReference,dest:i}],{signal:o}),n=l(a,i)),!n)throw new t("elevation-query:spatial-reference-mismatch",`Cannot query elevation in '${a.spatialReference.wkid}' on an elevation service in '${i.wkid}'`);e.geometry=d.fromGeometry(n)}function U(e){if(null==e.layer.fullExtent)return;const t=new p(new h(-1,-1,-1));t.sample=()=>e.parameters.noDataValue,e.outsideExtentTile=t;const a=e.layer.fullExtent;e.geometry.coordinates.forEach(e=>{const o=e.x,n=e.y;(o<a.xmin||o>a.xmax||n<a.ymin||n>a.ymax)&&(e.elevationTile=t)})}function C(e,t){const{tileInfo:a,tilemapCache:o}=e.layer,n=t/i(a.spatialReference),r=f(a,o);let l=r[0],s=0;for(let i=1;i<r.length;i++){const e=r[i];Math.abs(e.resolution-n)<Math.abs(l.resolution-n)&&(l=e,s=i)}return s}function S(e,t){const a=C(e,t);e.selectTilesAtLOD(a)}function F(e){const{tileInfo:t,tilemapCache:a}=e.layer,o=q(t,a,e.parameters.minDemResolution);e.selectTilesAtLOD(o,e.parameters.maximumAutoTileRequests)}async function G(e,t){const a=e.getTilesToFetch(),n={},i=e.parameters.cache,r=e.parameters.noDataValue,l={noDataValue:r,signal:t},s=a.map(async t=>{if(null==t.id)return;const a=`${e.layer.uid}:${t.id}:${r}`,o=i?.get(a),s=o??y.from(await e.layer.fetchTile(t.level,t.row,t.col,l));i?.put(a,s),n[t.id]=new p(t,s)});await o(Promise.allSettled(s),t),e.populateElevationTiles(n)}function M(e){const t=e.layer.tileInfo;let a=0;const o={},n=e=>{null!=e.id&&(e.id in o?o[e.id]++:(o[e.id]=1,a++))},i=e=>{if(null==e.id)return;const t=o[e.id];1===t?(delete o[e.id],a--):o[e.id]=t-1};e.forEachTileToFetch(n,i);let r=!0;for(;r&&(r=!1,e.forEachTileToFetch(o=>{a<=e.parameters.maximumAutoTileRequests||(i(o),t.upsampleTile(o)&&(r=!0),n(o))},i),r););}function k(e){e.geometry.coordinates.forEach(t=>{const a=t.elevationTile;let o=e.parameters.noDataValue;if(a){const e=a.sample(t.x,t.y);null==e?t.elevationTile=null:o=e}t.z=o})}async function N(e,t){const o=await e.geometry.project(e.outSpatialReference,t);a(o);const n={geometry:o.export(),noDataValue:e.parameters.noDataValue};return e.parameters.returnSampleInfo&&(n.sampleInfo=$(e)),e.geometry.coordinates.forEach(e=>{e.tile=null,e.elevationTile=null}),n}function $(e){const t=e.layer.tileInfo,a=i(t.spatialReference);return e.geometry.coordinates.map(o=>{let n=-1;if(o.elevationTile&&o.elevationTile!==e.outsideExtentTile){n=t.lodAt(o.elevationTile.key.level).resolution*a}return{demResolution:n,source:-1===n?void 0:e.layer}})}const z="elevation-query:invalid-layer";export{z as InvalidLayerError,T as createSampler,j as defaultOptions,q as getFinestLodIndex,v as query,g as queryAll};

package/layers/support/FeatureFilter.d.ts

@@ -1,6 +1,7 @@
 import type Query from "../../rest/support/Query.js";
 import type { JSONSupport } from "../../core/JSONSupport.js";
 import type { QueryProperties } from "../../rest/support/Query.js";
+import type { ObjectId } from "../../views/types.js";
 
 export interface FeatureFilterProperties extends Partial<Pick<FeatureFilter, "objectIds">> {
   /**
@@ -202,7 +203,7 @@ export default class FeatureFilter extends JSONSupport {
    * const oidsArray = layerView.queryObjectIds(query);
    * layerView.filter = oidsArray.length > 0 ?  { objectIds: oidsArray } : { where: "1=0" };
    */
-  accessor objectIds: number[] | null | undefined;
+  accessor objectIds: ObjectId[] | null | undefined;
   /**
    * For spatial filters, this parameter defines the spatial relationship to filter features in the layer view
    * against the filter [geometry](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/#geometry). The spatial relationships discover how features are spatially related to each other.

package/layers/support/FeatureFilter.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import{JSONMap as t}from"../../core/jsonMap.js";import{JSONSupport as i}from"../../core/JSONSupport.js";import{clone as r}from"../../core/lang.js";import{property as s,subclass as o}from"../../core/accessorSupport/decorators.js";import{geometryTypes as n}from"../../geometry/support/typeUtils.js";import l from"../../rest/support/Query.js";import a from"../../time/TimeExtent.js";var p;const c=new t({esriSpatialRelIntersects:"intersects",esriSpatialRelContains:"contains",esriSpatialRelCrosses:"crosses",esriSpatialRelDisjoint:"disjoint",esriSpatialRelEnvelopeIntersects:"envelope-intersects",esriSpatialRelIndexIntersects:"index-intersects",esriSpatialRelOverlaps:"overlaps",esriSpatialRelTouches:"touches",esriSpatialRelWithin:"within",esriSpatialRelRelation:"relation"}),u=new t({esriSRUnit_Meter:"meters",esriSRUnit_Kilometer:"kilometers",esriSRUnit_Foot:"feet",esriSRUnit_StatuteMile:"miles",esriSRUnit_NauticalMile:"nautical-miles",esriSRUnit_USNauticalMile:"us-nautical-miles"});let m=p=class extends i{constructor(e){super(e),this.where=null,this.geometry=null,this.spatialRelationship="intersects",this.distance=void 0,this.objectIds=null,this.units=null,this.timeExtent=null}createQuery(e={}){const{where:t,geometry:i,spatialRelationship:s,timeExtent:o,objectIds:n,units:a,distance:p}=this;return new l({geometry:r(i),objectIds:r(n),spatialRelationship:s,timeExtent:r(o),where:t,units:a,distance:p,...e})}clone(){const{where:e,geometry:t,spatialRelationship:i,timeExtent:s,objectIds:o,units:n,distance:l}=this;return new p({geometry:r(t),objectIds:r(o),spatialRelationship:i,timeExtent:r(s),where:e,units:n,distance:l})}};e([s({type:String,json:{write:!0}})],m.prototype,"where",void 0),e([s({types:n,json:{write:!0}})],m.prototype,"geometry",void 0),e([s({type:c.apiValues,json:{name:"spatialRel",read:{reader:c.read},write:{allowNull:!1,writer:c.write,overridePolicy(){return{enabled:null!=this.geometry}}}}})],m.prototype,"spatialRelationship",void 0),e([s({type:Number,json:{write:{overridePolicy(e){return{enabled:null!=e&&null!=this.geometry}}}}})],m.prototype,"distance",void 0),e([s({type:[Number],json:{write:!0}})],m.prototype,"objectIds",void 0),e([s({type:u.apiValues,json:{read:u.read,write:{writer:u.write,overridePolicy(e){return{enabled:null!=e&&null!=this.geometry}}}}})],m.prototype,"units",void 0),e([s({type:a,json:{write:!0}})],m.prototype,"timeExtent",void 0),m=p=e([o("esri.layers.support.FeatureFilter")],m);const d=m;export{d as default};
+import{__decorate as e}from"tslib";import{JSONMap as t}from"../../core/jsonMap.js";import{JSONSupport as i}from"../../core/JSONSupport.js";import{clone as r}from"../../core/lang.js";import{property as s,subclass as o}from"../../core/accessorSupport/decorators.js";import{geometryTypes as n}from"../../geometry/support/typeUtils.js";import l from"../../rest/support/Query.js";import a from"../../time/TimeExtent.js";var p;const c=new t({esriSpatialRelIntersects:"intersects",esriSpatialRelContains:"contains",esriSpatialRelCrosses:"crosses",esriSpatialRelDisjoint:"disjoint",esriSpatialRelEnvelopeIntersects:"envelope-intersects",esriSpatialRelIndexIntersects:"index-intersects",esriSpatialRelOverlaps:"overlaps",esriSpatialRelTouches:"touches",esriSpatialRelWithin:"within",esriSpatialRelRelation:"relation"}),u=new t({esriSRUnit_Meter:"meters",esriSRUnit_Kilometer:"kilometers",esriSRUnit_Foot:"feet",esriSRUnit_StatuteMile:"miles",esriSRUnit_NauticalMile:"nautical-miles",esriSRUnit_USNauticalMile:"us-nautical-miles"});let m=p=class extends i{constructor(e){super(e),this.where=null,this.geometry=null,this.spatialRelationship="intersects",this.distance=void 0,this.objectIds=null,this.units=null,this.timeExtent=null}createQuery(e={}){const{where:t,geometry:i,spatialRelationship:s,timeExtent:o,objectIds:n,units:a,distance:p}=this;return new l({geometry:r(i),objectIds:r(n),spatialRelationship:s,timeExtent:r(o),where:t,units:a,distance:p,...e})}clone(){const{where:e,geometry:t,spatialRelationship:i,timeExtent:s,objectIds:o,units:n,distance:l}=this;return new p({geometry:r(t),objectIds:r(o),spatialRelationship:i,timeExtent:r(s),where:e,units:n,distance:l})}};e([s({type:String,json:{write:!0}})],m.prototype,"where",void 0),e([s({types:n,json:{write:!0}})],m.prototype,"geometry",void 0),e([s({type:c.apiValues,json:{name:"spatialRel",read:{reader:c.read},write:{allowNull:!1,writer:c.write,overridePolicy(){return{enabled:null!=this.geometry}}}}})],m.prototype,"spatialRelationship",void 0),e([s({type:Number,json:{write:{overridePolicy(e){return{enabled:null!=e&&null!=this.geometry}}}}})],m.prototype,"distance",void 0),e([s({json:{write:!0}})],m.prototype,"objectIds",void 0),e([s({type:u.apiValues,json:{read:u.read,write:{writer:u.write,overridePolicy(e){return{enabled:null!=e&&null!=this.geometry}}}}})],m.prototype,"units",void 0),e([s({type:a,json:{write:!0}})],m.prototype,"timeExtent",void 0),m=p=e([o("esri.layers.support.FeatureFilter")],m);const d=m;export{d as default};

package/layers/support/FeatureReductionBinning.d.ts

@@ -726,7 +726,7 @@ export default class FeatureReductionBinning extends FeatureReductionBinningSupe
    * @param fieldName - The name of the field.
    * @returns The matching field or `undefined`.
    * @since 5.0
-   * @see [fields](#fields)
+   * @see [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#fields)
    */
   getField(fieldName: string): AggregateField | null | undefined;
   /**
@@ -734,7 +734,7 @@ export default class FeatureReductionBinning extends FeatureReductionBinningSupe
    *
    * The alias is resolved in the following order:
    *
-   * 1. [Field configuration alias](#fieldConfigurations)
+   * 1. The alias in [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/#fieldConfigurations)
    * 2. [AggregateField.alias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AggregateField/#alias) defined on the field.
    *
    * @param fieldName - The name of the field.

package/layers/support/FeatureReductionCluster.d.ts

@@ -1306,7 +1306,7 @@ export default class FeatureReductionCluster extends FeatureReductionClusterSupe
    * @param fieldName - The name of the field.
    * @returns The matching field or `undefined`.
    * @since 5.0
-   * @see [fields](#fields)
+   * @see [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#fields)
    */
   getField(fieldName: string): AggregateField | null | undefined;
   /**
@@ -1314,7 +1314,7 @@ export default class FeatureReductionCluster extends FeatureReductionClusterSupe
    *
    * The alias is resolved in the following order:
    *
-   * 1. [Field configuration alias](#fieldConfigurations)
+   * 1. The alias in [fieldConfigurations](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/#fieldConfigurations)
    * 2. [AggregateField.alias](https://developers.arcgis.com/javascript/latest/references/core/layers/support/AggregateField/#alias) defined on the field.
    *
    * @param fieldName - The name of the field.

package/layers/support/SubtypeSublayer.d.ts

@@ -826,7 +826,7 @@ export default class SubtypeSublayer extends SubtypeSublayerSuperclass {
   /**
    * Returns the title of a [feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/). The feature title is generated based on the following conditions for a `SubtypeSublayer`.
    * - If the feature has a popup title configured, then the popup title will be returned.
-   * - Otherwise, the [objectId](#objectIdField) of the associated feature will be returned.
+   * - Otherwise, the [objectIdField](https://developers.arcgis.com/javascript/latest/references/core/layers/support/SubtypeSublayer/#objectIdField) of the associated feature will be returned.
    *
    * @param graphic - The [graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) for which to generate a title.
    * @param options - Additional options that control how the title is generated.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcgis/core",
-  "version": "5.2.0-next.112",
+  "version": "5.2.0-next.114",
   "description": "ArcGIS Maps SDK for JavaScript: A complete 2D and 3D mapping and data visualization API",
   "keywords": [
     "ArcGIS",
@@ -19,8 +19,8 @@
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
   "dependencies": {
-    "@amcharts/amcharts5": "~5.20.5",
-    "@arcgis/toolkit": "5.2.0-next.112",
+    "@amcharts/amcharts5": "~5.20.6",
+    "@arcgis/toolkit": "5.2.0-next.114",
     "@esri/arcgis-html-sanitizer": "~4.1.0",
     "@esri/calcite-components": "^5.2.0-next.73",
     "@vaadin/grid": "~25.2.11",

package/popup/FeatureContent.d.ts

@@ -105,7 +105,7 @@ export default class FeatureContent extends FeatureContentSuperclass {
   /** A read-only map of Arcade expression names to their evaluated values for the current feature. */
   get expressionAttributes(): Record<string, any> | null | undefined;
   /**
-   * The formatted attributes calculated from `fieldInfo` [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) formatting. They are obtained from the feature's [graphic](#graphic) attribute values and can be read:
+   * The formatted attributes calculated from `fieldInfo` [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/) formatting. They are obtained from the feature's [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic) attribute values and can be read:
    *  * [globally](https://developers.arcgis.com/javascript/latest/references/core/popup/types/#FeatureFormattedAttributes-global) using the [PopupTemplate.fieldInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#fieldInfos) property directly at the root level of the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), or
    *  * [per an individual content element](https://developers.arcgis.com/javascript/latest/references/core/popup/types/#FeatureFormattedAttributes-content). This element is defined with a [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/) popup element set on the PopupTemplate [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content) property.
    */
@@ -144,7 +144,7 @@ export default class FeatureContent extends FeatureContentSuperclass {
    * @default ""
    */
   get heading(): string;
-  /** Indicates whether the current [graphic](#graphic) resides in a non-spatial table. */
+  /** Indicates whether the current [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic) resides in a non-spatial table. */
   get isFeatureFromTable(): boolean;
   /** A read-only property containing metadata regarding the last edit performed on a feature. */
   get lastEditInfo(): LastEditInfo | null | undefined;
@@ -161,9 +161,9 @@ export default class FeatureContent extends FeatureContentSuperclass {
   get location(): Point | null | undefined;
   set location(value: PointProperties | null | undefined);
   /**
-   * A map is required when the input [graphic](#graphic) has 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 [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic) has 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 [view](#view) property can be used to provide the map instance for this property.
+   * Alternatively, the [view](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#view) property can be used to provide the map instance for this property.
    *
    * @see [Type system](https://developers.arcgis.com/arcade/guide/types/#featuresetcollection)
    * @see [Arcade Profiles: Popup](https://developers.arcgis.com/arcade/profiles/popup/)
@@ -213,7 +213,7 @@ export default class FeatureContent extends FeatureContentSuperclass {
    * > [!WARNING]
    * >
    * > A view is required if the user expects to display content in any of the following situations:
-   * > - The [graphic](#graphic) has 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).
+   * > - The [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic) has a popupTemplate containing Arcade expressions in [ExpressionInfo](https://developers.arcgis.com/javascript/latest/references/core/popup/ExpressionInfo/) or [ExpressionContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/) that may use [geometry functions](https://developers.arcgis.com/arcade/function-reference/geometry_functions/) or reference the `$map` profile variable (i.e. access data from layers within a map).
    * > - Content is displayed from the popup template of an [aggregate feature](https://developers.arcgis.com/javascript/latest/references/core/Graphic/#isAggregate) (i.e. a [cluster](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) or [bin](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/)).
    * > - Values from `date` and `timestamp-offset` [fields](https://developers.arcgis.com/javascript/latest/references/core/layers/support/Field/#type) should respect the associated [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/#timeZone) or [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/#timeZone).
    */
@@ -221,8 +221,8 @@ export default class FeatureContent extends FeatureContentSuperclass {
   /** Indicates whether the feature is currently waiting for all of its content to finish loading. */
   get waitingForContent(): boolean;
   /**
-   * Fetches and updates the geometry of the [graphic](#graphic).
-   * This method can be called to refresh the [graphic](#graphic)'s geometry before taking actions such as calling
+   * Fetches and updates the geometry of the [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic).
+   * This method can be called to refresh the [graphic](https://developers.arcgis.com/javascript/latest/references/core/popup/FeatureContent/#graphic)'s geometry before taking actions such as calling
    * [View2D.goTo()](https://developers.arcgis.com/javascript/latest/references/core/views/View2D/#goTo) with the graphic as the `target`.
    *
    * @returns A promise that resolves when the geometry update attempt has completed.