@arcgis/core 5.1.0-next.64 → 5.1.0-next.66

package/popup/Features.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../Graphic.js";import{isSome as i}from"../core/arrayUtils.js";import s from"../core/Error.js";import{EventedAccessor as r}from"../core/Evented.js";import o from"../core/Logger.js";import{abortMaybe as n}from"../core/maybe.js";import{debounce as a,isAbortError as l}from"../core/promiseUtils.js";import u from"../core/ReactiveSet.js";import{watch as h,when as c,sync as p}from"../core/reactiveUtils.js";import{addMany as d}from"../core/SetUtils.js";import{property as g,subclass as m}from"../core/accessorSupport/decorators.js";import f from"../geometry/Point.js";import{initializeProjection as y,project as _}from"../geometry/projectionUtils.js";import F from"../geometry/SpatialReference.js";import{geographicToWebMercator as w}from"../geometry/support/webMercatorUtils.js";import{getGraphicLayer as v}from"../graphic/graphicOriginUtils.js";import{fallbackObjectIDAttribute as C}from"../layers/LayerConstants.js";import b from"./Feature.js";import I from"./support/FeatureAbilities.js";import P from"../symbols/SimpleFillSymbol.js";import{getDisplayedSymbol as A}from"../symbols/support/symbolUtils.js";import{system as L}from"../time/constants.js";import{highlightsSupported as j}from"../views/support/layerViewUtils.js";import{ActionsCollection as E,zoomToClusteredFeatures as x,browseClusteredFeatures as R,zoomToFeature as O}from"../widgets/Popup/actions.js";import{isClusterFeature as U,removeClusteredFeaturesForBrowsing as T,displayClusterExtent as S,browseAggregateFeatures as B,getSelectedTarget as H}from"../widgets/Popup/actionUtils.js";import{GoTo as M}from"../widgets/support/GoTo.js";const G="location-scale-handle",V=()=>[O.clone()],Z=()=>[x.clone(),R.clone()];let D=null;function z(e,t){switch(e){case"building-scene":case"map-image":case"tile":case"imagery":return!0;case"imagery-tile":return"2d"===t;default:return!1}}let N=class extends(M(r)){constructor(e){super(e),this._pendingPromises=new u,this._fetchFeaturesController=null,this._centerAtLocationController=null,this._locationUpdateController=null,this._highlightPromises={"highlight-active-feature":null,"highlight-selected-feature":null},this._selectedClusterFeature=null,this.actions=new E,this.activeFeature=null,this.browseClusterEnabled=!1,this.defaultPopupTemplateEnabled=!1,this.featurePage=null,this.featuresPerPage=20,this.featureMenuOpen=!1,this.featureMenuTitle=null,this.featureItemAbilities=null,this.featureItems=[],this.highlightEnabled=!0,this.includeDefaultActions=!0,this.initialDisplayMode="feature",this.selectedClusterBoundaryFeature=new t({symbol:new P({outline:{width:1.5,color:"cyan"},style:"none"})}),this.heading=null,this.updateLocationEnabled=!1,this.view=null,this.open=!1,this.zoomFactor=4,this._debouncedLocationUpdate=a(async e=>{this._cancelLocationUpdate();const t=new AbortController,{signal:i}=t;this._locationUpdateController=t,await this._locationUpdate(e,{signal:i}).catch(()=>{}).finally(()=>{this._locationUpdateController===t&&(this._locationUpdateController=null)})})}initialize(){this.addHandles([h(()=>[this.highlightEnabled,this.selectedFeature,this.open,this.view],()=>this._highlightSelectedFeature()),h(()=>[this.highlightEnabled,this.activeFeature,this.open,this.view],()=>this._highlightActiveFeature()),h(()=>this.location,e=>this._locationChange(e)),h(()=>this.selectedFeature,e=>this._selectedFeatureChange(e)),h(()=>[this.selectedFeatureIndex,this.featureCount,this.featuresPerPage],()=>this._selectedFeatureIndexChange()),h(()=>[this.featurePage,this.selectedFeatureIndex,this.featureCount,this.featuresPerPage,this.featureItems],()=>this._setGraphicOnFeatureItems()),h(()=>this.featureItems,()=>this._featureItemsChange()),h(()=>[this.featureItemAbilities?.attachmentsContent,this.featureItemAbilities?.chartAnimation,this.featureItemAbilities?.customContent,this.featureItemAbilities?.expressionContent,this.featureItemAbilities?.fieldsContent,this.featureItemAbilities?.mediaContent,this.featureItemAbilities?.relationshipContent,this.featureItemAbilities?.textContent,this.featureItemAbilities?.utilityNetworkAssociationsContent,this.features,this.map,this.spatialReference,this.timeZone],()=>this._updateFeatureItems()),c(()=>!this.waitingForResult,()=>this._waitingForResultChange(),p),h(()=>this.view?.scale,()=>this._viewScaleChange()),c(()=>!this.open,()=>this.browseClusterEnabled=!1),h(()=>this.browseClusterEnabled,e=>e?this.enableClusterBrowsing():this.disableClusterBrowsing())])}destroy(){this._cancelLocationUpdate(),this._cancelFetchingFeatures(),this._cancelCenterAtLocation(),this._clearBrowsedClusterGraphics(),this._pendingPromises.clear(),this.browseClusterEnabled=!1,this.view=null,this.map=null,this.spatialReference=null,this.timeZone=null}get active(){return this.open&&!this.waitingForResult}get allActions(){const e=this._get("allActions")||new E;e.removeAll();const{actions:t,defaultActions:s,defaultPopupTemplateEnabled:r,includeDefaultActions:o,selectedFeature:n}=this,a=o?s.concat(t):t,l=n&&("function"==typeof n.getEffectivePopupTemplate&&n.getEffectivePopupTemplate(r)||n.popupTemplate),u=l?.actions,h=l?.overwriteActions?u:u?.concat(a)??a;return h?.filter(i).forEach(t=>e.add(t)),e}set content(e){this.promises=[],this._set("content",e)}get defaultActions(){const e=this._get("defaultActions")||new E;return e.removeAll(),e.addMany(U(this.selectedFeature)?Z():V()),e}get featureCount(){return this.features.length}set features(e){if(this._get("features")===e)return;const t=e||[];this._set("features",t);const{pendingPromisesCount:i,promiseCount:s,selectedFeatureIndex:r}=this,o=s&&t.length;"list"!==this.initialDisplayMode?o&&i&&-1===r?this.selectedFeatureIndex=0:o&&-1!==r||(this.selectedFeatureIndex=t.length?0:-1):(!o||o&&i===s)&&(this.selectedFeatureIndex=-1)}set location(e){let t=e;const i=this.spatialReference?.isWebMercator,s=e?.spatialReference?.isWGS84;s&&i&&(t=w(e)),this._set("location",t)}get map(){return this.view?.map??null}set map(e){this._override("map",e)}get pendingPromisesCount(){return this._pendingPromises.size}get promiseCount(){return this.promises.length}get promises(){return this._get("promises")||[]}set promises(e){this._get("promises")!==e&&(this._pendingPromises.clear(),this.features=[],Array.isArray(e)&&e.length?(this._set("promises",e),e=e.slice(),d(this._pendingPromises,e),e.reduce((e,t)=>e.finally(()=>t.then(e=>{this._pendingPromises.has(t)&&this._updateFeatures(e)}).finally(()=>this._pendingPromises.delete(t)).catch(()=>{})),Promise.resolve())):this._set("promises",[]))}get selectedFeature(){const{features:e,selectedFeatureIndex:t}=this;if(-1===t)return null;return e[t]||null}get selectedFeatureIndex(){const e=this._get("selectedFeatureIndex");return"number"==typeof e?e:-1}set selectedFeatureIndex(e){const{featureCount:t}=this;(isNaN(e)||e<0||!t)&&(e=-1),this.activeFeature=null,this._set("selectedFeatureIndex",e)}get selectedFeatureItem(){return this.featureItems[this.selectedFeatureIndex]||null}get spatialReference(){return this.view?.spatialReference??null}set spatialReference(e){this._override("spatialReference",e)}get state(){const{view:e,map:t}=this;return e?e.ready?"ready":"disabled":t?"ready":"disabled"}get timeZone(){return this.view?.timeZone??L}set timeZone(e){this._overrideIfSome("timeZone",e)}get waitingForContents(){return this.featureItems.some(e=>e.waitingForContent)}get waitingForResult(){return(!!this._fetchFeaturesController||this.pendingPromisesCount>0)&&0===this.featureCount}zoomTo(e){return this.callGoTo(e)}clear(){this.set({promises:[],features:[],content:null,heading:null,location:null,activeFeature:null})}fetchFeatures(e,t){const{view:i}=this;if(!i||!e)throw new s("fetch-features:invalid-screenpoint-or-view","Cannot fetch features without a screenPoint and view.",{screenPoint:e,view:i});return i.fetchPopupFeatures(e,{pointerType:t?.event?.pointerType,defaultPopupTemplateEnabled:this.defaultPopupTemplateEnabled,signal:t?.signal})}next(){return this.selectedFeatureIndex=this._getRoundRobinIndex(this.selectedFeatureIndex+1,this.featureCount),this}previous(){return this.selectedFeatureIndex=this._getRoundRobinIndex(this.selectedFeatureIndex-1,this.featureCount),this}disableClusterBrowsing(){T(this),this._clearBrowsedClusterGraphics()}async enableClusterBrowsing(){const{view:e,selectedFeature:t}=this;"2d"===e?.type?U(t)?(await S(this),await B(this)):o.getLogger(this).warn("enableClusterBrowsing:invalid-selectedFeature: Selected feature must represent an aggregate/cluster graphic.",t):o.getLogger(this).warn("enableClusterBrowsing:invalid-view: View must be 2d MapView.",t)}async handleViewClick(e){return this._fetchFeaturesAndOpen(e)}_centerAtLocation(){const{view:e}=this,t=H(this);this._cancelCenterAtLocation();const i=new AbortController,{signal:r}=i;return this._centerAtLocationController=i,t&&e?this.callGoTo({target:{target:t,scale:e.scale},options:{signal:r}}).catch(e=>{l(e)||o.getLogger(this).error(e)}):Promise.reject(new s("center-at-location:invalid-target-or-view","Cannot center at a location without a target and view.",{target:t,view:e}))}_getRoundRobinIndex(e,t){return(e+t)%t}_clearBrowsedClusterGraphics(){const e=[this.selectedClusterBoundaryFeature,this._selectedClusterFeature].filter(i);this.view?.graphics?.removeMany(e),this._selectedClusterFeature=null,this.selectedClusterBoundaryFeature.geometry=null}_viewScaleChange(){if(U(this.selectedFeature))return this.browseClusterEnabled=!1,this.open=!1,void this.clear();this.browseClusterEnabled&&(this.features=this.selectedFeature?[this.selectedFeature]:[])}_locationChange(e){const{selectedFeature:t,updateLocationEnabled:i,view:s}=this;s&&!this._locationUpdateController&&i&&e&&(!t||t.geometry)&&this._centerAtLocation()}_selectedFeatureIndexChange(){this.featurePage=this.featureCount>0?Math.floor(this.selectedFeatureIndex/this.featuresPerPage)+1:null}_featureItemsChange(){this.featurePage=this.featureCount>0?1:null}_setGraphicOnFeatureItems(){const{features:e,featureCount:t,featurePage:i,featuresPerPage:s,featureItems:r}=this;if(null==i)return;const o=((i-1)*s+t)%t,n=o+s;r.slice(o,n).forEach((t,i)=>{t&&(t.graphic??=e[o+i])})}async _selectedFeatureChange(e){const{location:t,updateLocationEnabled:i,view:s}=this;if(!e||!s)return;if(this.browseClusterEnabled){if(this._selectedClusterFeature&&(s.graphics.remove(this._selectedClusterFeature),this._selectedClusterFeature=null),U(e))return;return e.symbol=await A(e),this._selectedClusterFeature=e,void s.graphics.add(this._selectedClusterFeature)}const r=v(e)?.type;if("map-image"!==r&&"imagery"!==r&&"imagery-tile"!==r||(e.symbol=await A(e)),(i||!t)&&e.geometry){if("point"===e.geometry.type)return void(this.location=e.geometry);const t=await import("../geometry/operators/labelPointOperator.js");return void(this.location=t.execute(e.geometry))}if(i&&!e.geometry){await this._centerAtLocation();const e=s.center?.clone();e&&(this.location=e)}}_waitingForResultChange(){!this.featureCount&&this.promises&&(this.open=!1)}_destroyFeatureItems(){this.featureItems.forEach(e=>e&&!e.destroyed&&e.destroy()),this._set("featureItems",[])}_updateFeatureItems(){const e=this.selectedFeature,t=this.features,i=this.featureItems,s=this.view,r=this.spatialReference,o=this.map,n=this.timeZone,a=this.location,l=this.featureItemAbilities??new I;if(U(t[0])||(this.browseClusterEnabled=!1),!t?.length)return void this._destroyFeatureItems();const u=i.slice(),h=[];t.forEach((t,i)=>{if(!t)return;const c=u.findIndex(e=>e?.graphic===t);if(-1!==c){const e=u[c];u.splice(c,1),e.abilities=l,h[i]=e}else{const u=new b({abilities:l,defaultPopupTemplateEnabled:this.defaultPopupTemplateEnabled,spatialReference:r,graphic:t===e?t:null,location:a,map:o,view:s,timeZone:n});h[i]=u}}),u.forEach(e=>e&&!e.destroyed&&e.destroy()),this._set("featureItems",h)}async _getScreenPoint(e,t){const{spatialReference:i,view:s}=this;if(!s)return null;await s.when();const r=e?.spatialReference;return r&&i?(await y(r,i,null,t),s.toScreen(e)):null}_cancelCenterAtLocation(){this._centerAtLocationController=n(this._centerAtLocationController)}_cancelFetchingFeatures(){this._fetchFeaturesController=n(this._fetchFeaturesController)}async _projectScreenPointAndFetchFeatures({mapPoint:e,screenPoint:t,event:i,signal:s}){return this.fetchFeatures(t??await this._getScreenPoint(e??this.location,{signal:s}),{signal:s,event:i})}_fetchFeaturesWithController({mapPoint:e,screenPoint:t,event:i}){this._cancelFetchingFeatures();const s=new AbortController,{signal:r}=s;this._fetchFeaturesController=s;const o=this._projectScreenPointAndFetchFeatures({mapPoint:e,screenPoint:t,signal:r,event:i});return o.catch(()=>{}).finally(()=>{this._fetchFeaturesController===s&&(this._fetchFeaturesController=null)}),o}async _fetchFeaturesAndOpen(e){const{mapPoint:t,screenPoint:i}=e;this.removeHandles(G),this.addHandles([h(()=>this.view?.scale,()=>this._debouncedLocationUpdate(t).catch(e=>{l(e)||o.getLogger(this).error(e)})),c(()=>!this.open,()=>{this.removeHandles(G)},{once:!0})],G);const{pendingFeatures:s}=await this._fetchFeaturesWithController({mapPoint:t,screenPoint:i,event:e});return{location:t??void 0,promises:s}}async _locationUpdate(e,t){const{spatialReference:i}=this,s=this.selectedFeature?.geometry?.type,r=this.location??e;if(s&&"mesh"!==s&&i&&r&&this.selectedFeature){if("point"===s){const e=await import("../geometry/operators/labelPointOperator.js");return void(this.location=e.execute(this.selectedFeature.geometry))}try{const e=this.selectedFeature;let s=e.geometry;const o=this._getHighlightLayer(e),n=e.getObjectId();if(!o||!this.view)return;if(n){const e=this.view?.allLayerViews.find(e=>e.layer.uid===o.uid);if(!e||!("queryFeatures"in e))return;const r=e.createQuery();r.outSpatialReference=i,r.objectIds=[n],r.returnGeometry=!0;const{features:a}=await e.queryFeatures(r,t);s=a[0]?.geometry}if(!s||"mesh"===s.type)return;s=_(s,i),D??=await Promise.all([import("../geometry/operators/intersectsOperator.js"),import("../geometry/operators/proximityOperator.js")]);const[a,l]=D;if(!a.execute(s,r)){const t=l.getNearestCoordinate(s,r).coordinate??r;this.selectedFeature===e&&(this.location=t)}}catch(n){l(n)||o.getLogger(this).error(n)}}}_cancelLocationUpdate(){this._locationUpdateController=n(this._locationUpdateController)}async _getLayerView(e,t){return await e.when(),e.whenLayerView(t)}_getHighlightLayer(e){const t=v(e),{layer:i}=e;return t&&"layer"in t&&t.layer?t.layer:"map-notes"===t?.type||"subtype-group"===t?.type?t:i??t}_getHighlightLayerView(e,t){return"subtype-sublayer"===t.type&&t.parent&&this._mapIncludesLayer(t.parent)?this._getLayerView(e,t.parent):t&&this._mapIncludesLayer(t)?this._getLayerView(e,t):null}_getHighlightTarget(e,t,i){if(z(t.type,i))return e;const s=e.getObjectId();if(null!=s)return s;const r="imagery"===t.type?void 0:"objectIdField"in t?t.objectIdField||C:null,o=e.attributes;return o&&r&&o[r]||e}_mapIncludesLayer(e){return!!this.map?.allLayers?.includes(e)}async _highlightFeature(e,t){this.removeHandles(e);const i=this[t];if(!i)return;const{highlightEnabled:s,view:r,open:o}=this;if(!r||!s||!o)return;const n=this._getHighlightLayer(i);if(!n)return;const a=this._getHighlightLayerView(r,n);if(!a)return;this._highlightPromises[e]=a;const l=await a;if(!(l&&j(l)&&this._highlightPromises[e]===a&&this[t]&&this.highlightEnabled))return;const u=l.highlight(this._getHighlightTarget(i,n,r.type));this.addHandles(u,e)}async _highlightActiveFeature(){return this._highlightFeature("highlight-active-feature","activeFeature")}async _highlightSelectedFeature(){return this._highlightFeature("highlight-selected-feature","selectedFeature")}_updateFeatures(e){const{features:t}=this,i=e.filter(e=>!t.includes(e));i?.length&&(this.features=t.concat(i))}};e([g()],N.prototype,"_fetchFeaturesController",void 0),e([g({type:E})],N.prototype,"actions",void 0),e([g({readOnly:!0})],N.prototype,"active",null),e([g()],N.prototype,"activeFeature",void 0),e([g({readOnly:!0})],N.prototype,"allActions",null),e([g()],N.prototype,"browseClusterEnabled",void 0),e([g({value:null})],N.prototype,"content",null),e([g({type:E,readOnly:!0})],N.prototype,"defaultActions",null),e([g({type:Boolean})],N.prototype,"defaultPopupTemplateEnabled",void 0),e([g({readOnly:!0})],N.prototype,"featureCount",null),e([g()],N.prototype,"featurePage",void 0),e([g({value:[]})],N.prototype,"features",null),e([g()],N.prototype,"featuresPerPage",void 0),e([g()],N.prototype,"featureMenuOpen",void 0),e([g()],N.prototype,"featureMenuTitle",void 0),e([g({type:I})],N.prototype,"featureItemAbilities",void 0),e([g({readOnly:!0})],N.prototype,"featureItems",void 0),e([g()],N.prototype,"highlightEnabled",void 0),e([g()],N.prototype,"includeDefaultActions",void 0),e([g()],N.prototype,"initialDisplayMode",void 0),e([g({type:f})],N.prototype,"location",null),e([g()],N.prototype,"map",null),e([g({readOnly:!0})],N.prototype,"pendingPromisesCount",null),e([g({readOnly:!0})],N.prototype,"promiseCount",null),e([g()],N.prototype,"promises",null),e([g({readOnly:!0})],N.prototype,"selectedClusterBoundaryFeature",void 0),e([g({value:null,readOnly:!0})],N.prototype,"selectedFeature",null),e([g({value:-1})],N.prototype,"selectedFeatureIndex",null),e([g({readOnly:!0})],N.prototype,"selectedFeatureItem",null),e([g({type:F})],N.prototype,"spatialReference",null),e([g({readOnly:!0})],N.prototype,"state",null),e([g()],N.prototype,"timeZone",null),e([g()],N.prototype,"heading",void 0),e([g()],N.prototype,"updateLocationEnabled",void 0),e([g()],N.prototype,"view",void 0),e([g()],N.prototype,"open",void 0),e([g({readOnly:!0})],N.prototype,"waitingForContents",null),e([g({readOnly:!0})],N.prototype,"waitingForResult",null),e([g()],N.prototype,"zoomFactor",void 0),N=e([m("esri.popup.Features")],N);const W=N;export{W as default};
+import{__decorate as e}from"tslib";import t from"../Graphic.js";import{isSome as i}from"../core/arrayUtils.js";import s from"../core/Error.js";import{EventedAccessor as r}from"../core/Evented.js";import o from"../core/Logger.js";import{abortMaybe as n}from"../core/maybe.js";import{debounce as a,isAbortError as l}from"../core/promiseUtils.js";import u from"../core/ReactiveSet.js";import{watch as h,when as c,sync as p}from"../core/reactiveUtils.js";import{addMany as d}from"../core/SetUtils.js";import{property as g,subclass as m}from"../core/accessorSupport/decorators.js";import f from"../geometry/Point.js";import{initializeProjection as y,project as _}from"../geometry/projectionUtils.js";import F from"../geometry/SpatialReference.js";import{geographicToWebMercator as w}from"../geometry/support/webMercatorUtils.js";import{getGraphicLayer as v}from"../graphic/graphicOriginUtils.js";import{fallbackObjectIDAttribute as C}from"../layers/LayerConstants.js";import b from"./Feature.js";import I from"./support/FeatureAbilities.js";import P from"../symbols/SimpleFillSymbol.js";import{getDisplayedSymbol as A}from"../symbols/support/symbolUtils.js";import{system as L}from"../time/constants.js";import{highlightsSupported as j}from"../views/support/layerViewUtils.js";import{ActionsCollection as x,zoomToClusteredFeatures as E,browseClusteredFeatures as R,zoomToFeature as O}from"../widgets/Popup/actions.js";import{isClusterFeature as U,removeClusteredFeaturesForBrowsing as S,displayClusterExtent as T,browseAggregateFeatures as B,getSelectedTarget as M}from"../widgets/Popup/actionUtils.js";import{GoTo as H}from"../widgets/support/GoTo.js";const G="location-scale-handle",V=()=>[O.clone()],D=()=>[E.clone(),R.clone()];let Z=null;function z(e,t){switch(e){case"building-scene":case"map-image":case"tile":case"imagery":return!0;case"imagery-tile":return"2d"===t;default:return!1}}let N=class extends(H(r)){constructor(e){super(e),this._pendingPromises=new u,this._fetchFeaturesController=null,this._centerAtLocationController=null,this._locationUpdateController=null,this._highlightPromises={"highlight-active-feature":null,"highlight-selected-feature":null},this._selectedClusterFeature=null,this.actions=new x,this.activeFeature=null,this.browseClusterEnabled=!1,this.defaultPopupTemplateEnabled=!1,this.featurePage=null,this.featuresPerPage=20,this.featureMenuOpen=!1,this.featureItemAbilities=null,this.featureItems=[],this.heading=null,this.highlightEnabled=!0,this.includeDefaultActions=!0,this.open=!1,this.selectedClusterBoundaryFeature=new t({symbol:new P({outline:{width:1.5,color:"cyan"},style:"none"})}),this.updateLocationEnabled=!1,this.view=null,this.zoomFactor=4,this._debouncedLocationUpdate=a(async e=>{this._cancelLocationUpdate();const t=new AbortController,{signal:i}=t;this._locationUpdateController=t,await this._locationUpdate(e,{signal:i}).catch(()=>{}).finally(()=>{this._locationUpdateController===t&&(this._locationUpdateController=null)})})}initialize(){this.addHandles([h(()=>[this.highlightEnabled,this.selectedFeature,this.open,this.view],()=>this._highlightSelectedFeature()),h(()=>[this.highlightEnabled,this.activeFeature,this.open,this.view],()=>this._highlightActiveFeature()),h(()=>this.location,e=>this._locationChange(e)),h(()=>this.selectedFeature,e=>this._selectedFeatureChange(e)),h(()=>[this.selectedFeatureIndex,this.featureCount,this.featuresPerPage],()=>this._selectedFeatureIndexChange()),h(()=>[this.featurePage,this.selectedFeatureIndex,this.featureCount,this.featuresPerPage,this.featureItems],()=>this._setGraphicOnFeatureItems()),h(()=>this.featureItems,()=>this._featureItemsChange()),h(()=>[this.featureItemAbilities?.attachmentsContent,this.featureItemAbilities?.chartAnimation,this.featureItemAbilities?.customContent,this.featureItemAbilities?.expressionContent,this.featureItemAbilities?.fieldsContent,this.featureItemAbilities?.mediaContent,this.featureItemAbilities?.relationshipContent,this.featureItemAbilities?.textContent,this.featureItemAbilities?.utilityNetworkAssociationsContent,this.features,this.map,this.spatialReference,this.timeZone],()=>this._updateFeatureItems()),c(()=>!this.waitingForResult,()=>this._waitingForResultChange(),p),h(()=>this.view?.scale,()=>this._viewScaleChange()),c(()=>!this.open,()=>this.browseClusterEnabled=!1),h(()=>this.browseClusterEnabled,e=>e?this.enableClusterBrowsing():this.disableClusterBrowsing())])}destroy(){this._cancelLocationUpdate(),this._cancelFetchingFeatures(),this._cancelCenterAtLocation(),this._clearBrowsedClusterGraphics(),this._pendingPromises.clear(),this.browseClusterEnabled=!1,this.view=null,this.map=null,this.spatialReference=null,this.timeZone=null}get active(){return this.open&&!this.waitingForResult}get allActions(){const e=this._get("allActions")||new x;e.removeAll();const{actions:t,defaultActions:s,defaultPopupTemplateEnabled:r,includeDefaultActions:o,selectedFeature:n}=this,a=o?s.concat(t):t,l=n&&("function"==typeof n.getEffectivePopupTemplate&&n.getEffectivePopupTemplate(r)||n.popupTemplate),u=l?.actions,h=l?.overwriteActions?u:u?.concat(a)??a;return h?.filter(i).forEach(t=>e.add(t)),e}set content(e){this.promises=[],this._set("content",e)}get defaultActions(){const e=this._get("defaultActions")||new x;return e.removeAll(),e.addMany(U(this.selectedFeature)?D():V()),e}get featureCount(){return this.features.length}set features(e){if(this._get("features")===e)return;const t=e||[];this._set("features",t),this._syncSelectedFeatureIndex(t)}get initialDisplayMode(){return this._get("initialDisplayMode")||"feature"}set initialDisplayMode(e){this._set("initialDisplayMode",e),this._syncSelectedFeatureIndex(this.features)}set location(e){let t=e;const i=this.spatialReference?.isWebMercator,s=e?.spatialReference?.isWGS84;s&&i&&(t=w(e)),this._set("location",t)}get map(){return this.view?.map??null}set map(e){this._override("map",e)}get pendingPromisesCount(){return this._pendingPromises.size}get promiseCount(){return this.promises.length}get promises(){return this._get("promises")||[]}set promises(e){this._get("promises")!==e&&(this._pendingPromises.clear(),this.features=[],Array.isArray(e)&&e.length?(this._set("promises",e),e=e.slice(),d(this._pendingPromises,e),e.reduce((e,t)=>e.finally(()=>t.then(e=>{this._pendingPromises.has(t)&&this._updateFeatures(e)}).finally(()=>this._pendingPromises.delete(t)).catch(()=>{})),Promise.resolve())):this._set("promises",[]))}get selectedFeature(){const{features:e,selectedFeatureIndex:t}=this;if(-1===t)return null;return e[t]||null}get selectedFeatureIndex(){const e=this._get("selectedFeatureIndex");return"number"==typeof e?e:-1}set selectedFeatureIndex(e){const{featureCount:t}=this;(isNaN(e)||e<0||!t)&&(e=-1),this.activeFeature=null,this._set("selectedFeatureIndex",e)}get selectedFeatureItem(){return this.featureItems[this.selectedFeatureIndex]||null}get spatialReference(){return this.view?.spatialReference??null}set spatialReference(e){this._override("spatialReference",e)}get state(){const{view:e,map:t}=this;return e?e.ready?"ready":"disabled":t?"ready":"disabled"}get timeZone(){return this.view?.timeZone??L}set timeZone(e){this._overrideIfSome("timeZone",e)}get waitingForContents(){return this.featureItems.some(e=>e.waitingForContent)}get waitingForResult(){return(!!this._fetchFeaturesController||this.pendingPromisesCount>0)&&0===this.featureCount}zoomTo(e){return this.callGoTo(e)}clear(){this.set({promises:[],features:[],content:null,heading:null,location:null,activeFeature:null})}fetchFeatures(e,t){const{view:i}=this;if(!i||!e)throw new s("fetch-features:invalid-screenpoint-or-view","Cannot fetch features without a screenPoint and view.",{screenPoint:e,view:i});return i.fetchPopupFeatures(e,{pointerType:t?.event?.pointerType,defaultPopupTemplateEnabled:this.defaultPopupTemplateEnabled,signal:t?.signal})}next(){return this.selectedFeatureIndex=this._getRoundRobinIndex(this.selectedFeatureIndex+1,this.featureCount),this}previous(){return this.selectedFeatureIndex=this._getRoundRobinIndex(this.selectedFeatureIndex-1,this.featureCount),this}disableClusterBrowsing(){S(this),this._clearBrowsedClusterGraphics()}async enableClusterBrowsing(){const{view:e,selectedFeature:t}=this;"2d"===e?.type?U(t)?(await T(this),await B(this)):o.getLogger(this).warn("enableClusterBrowsing:invalid-selectedFeature: Selected feature must represent an aggregate/cluster graphic.",t):o.getLogger(this).warn("enableClusterBrowsing:invalid-view: View must be 2d MapView.",t)}async handleViewClick(e){return this._fetchFeaturesAndOpen(e)}_syncSelectedFeatureIndex(e){const{pendingPromisesCount:t,promiseCount:i,selectedFeatureIndex:s}=this,r=i&&e.length;"list"!==this.initialDisplayMode?r&&t&&-1===s?this.selectedFeatureIndex=0:r&&-1!==s||(this.selectedFeatureIndex=e.length?0:-1):(!r||r&&t===i)&&(this.selectedFeatureIndex=-1)}_centerAtLocation(){const{view:e}=this,t=M(this);this._cancelCenterAtLocation();const i=new AbortController,{signal:r}=i;return this._centerAtLocationController=i,t&&e?this.callGoTo({target:{target:t,scale:e.scale},options:{signal:r}}).catch(e=>{l(e)||o.getLogger(this).error(e)}):Promise.reject(new s("center-at-location:invalid-target-or-view","Cannot center at a location without a target and view.",{target:t,view:e}))}_getRoundRobinIndex(e,t){return(e+t)%t}_clearBrowsedClusterGraphics(){const e=[this.selectedClusterBoundaryFeature,this._selectedClusterFeature].filter(i);this.view?.graphics?.removeMany(e),this._selectedClusterFeature=null,this.selectedClusterBoundaryFeature.geometry=null}_viewScaleChange(){if(U(this.selectedFeature))return this.browseClusterEnabled=!1,this.open=!1,void this.clear();this.browseClusterEnabled&&(this.features=this.selectedFeature?[this.selectedFeature]:[])}_locationChange(e){const{selectedFeature:t,updateLocationEnabled:i,view:s}=this;s&&!this._locationUpdateController&&i&&e&&(!t||t.geometry)&&this._centerAtLocation()}_selectedFeatureIndexChange(){this.featurePage=this.featureCount>0?Math.floor(this.selectedFeatureIndex/this.featuresPerPage)+1:null}_featureItemsChange(){this.featurePage=this.featureCount>0?1:null}_setGraphicOnFeatureItems(){const{features:e,featureCount:t,featurePage:i,featuresPerPage:s,featureItems:r}=this;if(null==i)return;const o=((i-1)*s+t)%t,n=o+s;r.slice(o,n).forEach((t,i)=>{t&&(t.graphic??=e[o+i])})}async _selectedFeatureChange(e){const{location:t,updateLocationEnabled:i,view:s}=this;if(!e||!s)return;if(this.browseClusterEnabled){if(this._selectedClusterFeature&&(s.graphics.remove(this._selectedClusterFeature),this._selectedClusterFeature=null),U(e))return;return e.symbol=await A(e),this._selectedClusterFeature=e,void s.graphics.add(this._selectedClusterFeature)}const r=v(e)?.type;if("map-image"!==r&&"imagery"!==r&&"imagery-tile"!==r||(e.symbol=await A(e)),(i||!t)&&e.geometry){if("point"===e.geometry.type)return void(this.location=e.geometry);const t=await import("../geometry/operators/labelPointOperator.js");return void(this.location=t.execute(e.geometry))}if(i&&!e.geometry){await this._centerAtLocation();const e=s.center?.clone();e&&(this.location=e)}}_waitingForResultChange(){!this.featureCount&&this.promises&&(this.open=!1)}_destroyFeatureItems(){this.featureItems.forEach(e=>e&&!e.destroyed&&e.destroy()),this._set("featureItems",[])}_updateFeatureItems(){const e=this.selectedFeature,t=this.features,i=this.featureItems,s=this.view,r=this.spatialReference,o=this.map,n=this.timeZone,a=this.location,l=this.featureItemAbilities??new I;if(U(t[0])||(this.browseClusterEnabled=!1),!t?.length)return void this._destroyFeatureItems();const u=i.slice(),h=[];t.forEach((t,i)=>{if(!t)return;const c=u.findIndex(e=>e?.graphic===t);if(-1!==c){const e=u[c];u.splice(c,1),e.abilities=l,h[i]=e}else{const u=new b({abilities:l,defaultPopupTemplateEnabled:this.defaultPopupTemplateEnabled,spatialReference:r,graphic:t===e?t:null,location:a,map:o,view:s,timeZone:n});h[i]=u}}),u.forEach(e=>e&&!e.destroyed&&e.destroy()),this._set("featureItems",h)}async _getScreenPoint(e,t){const{spatialReference:i,view:s}=this;if(!s)return null;await s.when();const r=e?.spatialReference;return r&&i?(await y(r,i,null,t),s.toScreen(e)):null}_cancelCenterAtLocation(){this._centerAtLocationController=n(this._centerAtLocationController)}_cancelFetchingFeatures(){this._fetchFeaturesController=n(this._fetchFeaturesController)}async _projectScreenPointAndFetchFeatures({mapPoint:e,screenPoint:t,event:i,signal:s}){return this.fetchFeatures(t??await this._getScreenPoint(e??this.location,{signal:s}),{signal:s,event:i})}_fetchFeaturesWithController({mapPoint:e,screenPoint:t,event:i}){this._cancelFetchingFeatures();const s=new AbortController,{signal:r}=s;this._fetchFeaturesController=s;const o=this._projectScreenPointAndFetchFeatures({mapPoint:e,screenPoint:t,signal:r,event:i});return o.catch(()=>{}).finally(()=>{this._fetchFeaturesController===s&&(this._fetchFeaturesController=null)}),o}async _fetchFeaturesAndOpen(e){const{mapPoint:t,screenPoint:i}=e;this.removeHandles(G),this.addHandles([h(()=>this.view?.scale,()=>this._debouncedLocationUpdate(t).catch(e=>{l(e)||o.getLogger(this).error(e)})),c(()=>!this.open,()=>{this.removeHandles(G)},{once:!0})],G);const{pendingFeatures:s}=await this._fetchFeaturesWithController({mapPoint:t,screenPoint:i,event:e});return{location:t??void 0,promises:s}}async _locationUpdate(e,t){const{spatialReference:i}=this,s=this.selectedFeature?.geometry?.type,r=this.location??e;if(s&&"mesh"!==s&&i&&r&&this.selectedFeature){if("point"===s){const e=await import("../geometry/operators/labelPointOperator.js");return void(this.location=e.execute(this.selectedFeature.geometry))}try{const e=this.selectedFeature;let s=e.geometry;const o=this._getHighlightLayer(e),n=e.getObjectId();if(!o||!this.view)return;if(n){const e=this.view?.allLayerViews.find(e=>e.layer.uid===o.uid);if(!e||!("queryFeatures"in e))return;const r=e.createQuery();r.outSpatialReference=i,r.objectIds=[n],r.returnGeometry=!0;const{features:a}=await e.queryFeatures(r,t);s=a[0]?.geometry}if(!s||"mesh"===s.type)return;s=_(s,i),Z??=await Promise.all([import("../geometry/operators/intersectsOperator.js"),import("../geometry/operators/proximityOperator.js")]);const[a,l]=Z;if(!a.execute(s,r)){const t=l.getNearestCoordinate(s,r).coordinate??r;this.selectedFeature===e&&(this.location=t)}}catch(n){l(n)||o.getLogger(this).error(n)}}}_cancelLocationUpdate(){this._locationUpdateController=n(this._locationUpdateController)}async _getLayerView(e,t){return await e.when(),e.whenLayerView(t)}_getHighlightLayer(e){const t=v(e),{layer:i}=e;return t&&"layer"in t&&t.layer?t.layer:"map-notes"===t?.type||"subtype-group"===t?.type?t:i??t}_getHighlightLayerView(e,t){return"subtype-sublayer"===t.type&&t.parent&&this._mapIncludesLayer(t.parent)?this._getLayerView(e,t.parent):t&&this._mapIncludesLayer(t)?this._getLayerView(e,t):null}_getHighlightTarget(e,t,i){if(z(t.type,i))return e;const s=e.getObjectId();if(null!=s)return s;const r="imagery"===t.type?void 0:"objectIdField"in t?t.objectIdField||C:null,o=e.attributes;return o&&r&&o[r]||e}_mapIncludesLayer(e){return!!this.map?.allLayers?.includes(e)}async _highlightFeature(e,t){this.removeHandles(e);const i=this[t];if(!i)return;const{highlightEnabled:s,view:r,open:o}=this;if(!r||!s||!o)return;const n=this._getHighlightLayer(i);if(!n)return;const a=this._getHighlightLayerView(r,n);if(!a)return;this._highlightPromises[e]=a;const l=await a;if(!(l&&j(l)&&this._highlightPromises[e]===a&&this[t]&&this.highlightEnabled))return;const u=l.highlight(this._getHighlightTarget(i,n,r.type));this.addHandles(u,e)}async _highlightActiveFeature(){return this._highlightFeature("highlight-active-feature","activeFeature")}async _highlightSelectedFeature(){return this._highlightFeature("highlight-selected-feature","selectedFeature")}_updateFeatures(e){const{features:t}=this,i=e.filter(e=>!t.includes(e));i?.length&&(this.features=t.concat(i))}};e([g()],N.prototype,"_fetchFeaturesController",void 0),e([g({type:x})],N.prototype,"actions",void 0),e([g({readOnly:!0})],N.prototype,"active",null),e([g()],N.prototype,"activeFeature",void 0),e([g({readOnly:!0})],N.prototype,"allActions",null),e([g()],N.prototype,"browseClusterEnabled",void 0),e([g({value:null})],N.prototype,"content",null),e([g({type:x,readOnly:!0})],N.prototype,"defaultActions",null),e([g({type:Boolean})],N.prototype,"defaultPopupTemplateEnabled",void 0),e([g({readOnly:!0})],N.prototype,"featureCount",null),e([g()],N.prototype,"featurePage",void 0),e([g({value:[]})],N.prototype,"features",null),e([g()],N.prototype,"featuresPerPage",void 0),e([g()],N.prototype,"featureMenuOpen",void 0),e([g({type:I})],N.prototype,"featureItemAbilities",void 0),e([g({readOnly:!0})],N.prototype,"featureItems",void 0),e([g()],N.prototype,"heading",void 0),e([g()],N.prototype,"highlightEnabled",void 0),e([g()],N.prototype,"includeDefaultActions",void 0),e([g({value:"feature"})],N.prototype,"initialDisplayMode",null),e([g({type:f})],N.prototype,"location",null),e([g()],N.prototype,"map",null),e([g()],N.prototype,"open",void 0),e([g({readOnly:!0})],N.prototype,"pendingPromisesCount",null),e([g({readOnly:!0})],N.prototype,"promiseCount",null),e([g()],N.prototype,"promises",null),e([g({readOnly:!0})],N.prototype,"selectedClusterBoundaryFeature",void 0),e([g({value:null,readOnly:!0})],N.prototype,"selectedFeature",null),e([g({value:-1})],N.prototype,"selectedFeatureIndex",null),e([g({readOnly:!0})],N.prototype,"selectedFeatureItem",null),e([g({type:F})],N.prototype,"spatialReference",null),e([g({readOnly:!0})],N.prototype,"state",null),e([g()],N.prototype,"timeZone",null),e([g()],N.prototype,"updateLocationEnabled",void 0),e([g()],N.prototype,"view",void 0),e([g({readOnly:!0})],N.prototype,"waitingForContents",null),e([g({readOnly:!0})],N.prototype,"waitingForResult",null),e([g()],N.prototype,"zoomFactor",void 0),N=e([m("esri.popup.Features")],N);const W=N;export{W as default};

package/popup/content/AttachmentsContent.d.ts

@@ -28,7 +28,7 @@ export interface AttachmentsContentProperties extends BaseContentProperties, Par
  *
  * | Preview view | List view |
  * | ---- | ---- |
- * | ![popuptemplate-attachments-element-preview](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-attachments-element-preview.png)| ![popuptemplate-attachments-element-list](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-attachments-element-list.png) |
+ * | ![popuptemplate-attachments-element-preview](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-attachments-element-preview.avif)| ![popuptemplate-attachments-element-list](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-attachments-element-list.avif) |
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/BarChartMediaInfo.d.ts

@@ -6,7 +6,7 @@ export interface BarChartMediaInfoProperties extends ChartMediaInfoProperties {}
 /**
  * A `BarChartMediaInfo` is a type of chart media element that represents a bar chart displayed within a popup.
  *
- * ![popuptemplate-media-element-barchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-barchart.png)
+ * ![popuptemplate-media-element-barchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-barchart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/ColumnChartMediaInfo.d.ts

@@ -7,7 +7,7 @@ export interface ColumnChartMediaInfoProperties extends ChartMediaInfoProperties
  * A `ColumnChartMediaInfo` is a type of chart media element
  * that represents a column chart displayed within a popup.
  *
- * ![popuptemplate-media-element-columnchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-columnchart.png)
+ * ![popuptemplate-media-element-columnchart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-columnchart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/FieldsContent.d.ts

@@ -18,7 +18,7 @@ export interface FieldsContentProperties extends BaseContentProperties, Partial<
  * it will revert to whatever may be set within the [PopupTemplate.fieldInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#fieldInfos)
  * property.
  *
- * ![popuptemplate-fields-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-fields-element.png)
+ * ![popuptemplate-fields-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-fields-element.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/ImageMediaInfo.d.ts

@@ -11,7 +11,7 @@ export interface ImageMediaInfoProperties extends MediaInfoProperties, Partial<P
 /**
  * An `ImageMediaInfo` is a type of media element that represents images to display within a popup.
  *
- * ![popuptemplate-media-element-image](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-image.png)
+ * ![popuptemplate-media-element-image](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-image.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/LineChartMediaInfo.d.ts

@@ -7,7 +7,7 @@ export interface LineChartMediaInfoProperties extends ChartMediaInfoProperties {
  * A `LineChartMediaInfo` is a type of chart media element
  * that represents a line chart displayed within a popup.
  *
- * ![popuptemplate-media-element-linechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-linechart.png)
+ * ![popuptemplate-media-element-linechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-linechart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/MediaContent.d.ts

@@ -33,7 +33,7 @@ export type PopupContentMediaInfoUnion = BarChartMediaInfo | ColumnChartMediaInf
  * [Binning](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionBinning/) and [clustering](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureReductionCluster/) popup charts are also based on the renderer colors.
  * However, popup charts only respect the colors from the [pie chart](https://developers.arcgis.com/javascript/latest/references/core/renderers/PieChartRenderer/) renderer when clustering is configured.
  *
- * ![popuptemplate-media-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element.png)
+ * ![popuptemplate-media-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/PieChartMediaInfo.d.ts

@@ -6,7 +6,7 @@ export interface PieChartMediaInfoProperties extends ChartMediaInfoProperties {}
 /**
  * A `PieChartMediaInfo` is a type of chart media element that represents a pie chart displayed within a popup.
  *
- * ![popuptemplate-media-element-piechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-piechart.png)
+ * ![popuptemplate-media-element-piechart](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-media-element-piechart.avif)
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/content/RelationshipContent.d.ts

@@ -23,7 +23,7 @@ export interface RelationshipContentProperties extends BaseContentProperties, Pa
  *
  * | Origin Feature | Related Destination Feature |
  * | -------------- | ------------- |
- * | ![origin feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-origin-feature.png) | ![destination feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-destination-feature.png) |
+ * | ![origin feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-origin-feature.avif) | ![destination feature](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-destination-feature.avif) |
  *
  * > [!WARNING]
  * >

package/popup/content/TextContent.d.ts

@@ -8,7 +8,7 @@ export interface TextContentProperties extends BaseContentProperties, Partial<Pi
  * content. The text may reference values returned from a field attribute or an
  * [Arcade](https://developers.arcgis.com/javascript/latest/arcade/) expression defined in a PopupTemplate's [PopupTemplate.expressionInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#expressionInfos) property.
  *
- * ![popuptemplate-text-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-text-element.png).
+ * ![popuptemplate-text-element](https://developers.arcgis.com/javascript/latest/assets/references/core/widgets/popup/popuptemplate-text-element.avif).
  *
  * @since 4.11
  * @see [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)

package/popup/support/FeatureAbilities.d.ts

@@ -9,22 +9,58 @@ export interface FeatureAbilitiesProperties extends Partial<Pick<FeatureAbilitie
  */
 export default class FeatureAbilities extends Accessor {
   constructor(properties?: FeatureAbilitiesProperties);
-  /** @default true */
+  /**
+   * Indicates whether to query and display [attachments](https://developers.arcgis.com/javascript/latest/references/core/popup/content/AttachmentsContent/) associated with the feature.
+   *
+   * @default true
+   */
   accessor attachmentsContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display animations for charts residing in [media content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/).
+   *
+   * @default true
+   */
   accessor chartAnimation: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display any [custom content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/CustomContent/).
+   *
+   * @default true
+   */
   accessor customContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display any [expression content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/ExpressionContent/).
+   *
+   * @default true
+   */
   accessor expressionContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display any [fields content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/).
+   *
+   * @default true
+   */
   accessor fieldsContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display any [media content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/MediaContent/).
+   *
+   * @default true
+   */
   accessor mediaContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display [relationship content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/RelationshipContent/).
+   *
+   * @default true
+   */
   accessor relationshipContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display any [text content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/TextContent/).
+   *
+   * @default true
+   */
   accessor textContent: boolean;
-  /** @default true */
+  /**
+   * Indicates whether to display [utility network associations content elements](https://developers.arcgis.com/javascript/latest/references/core/popup/content/UtilityNetworkAssociationsContent/).
+   *
+   * @default true
+   */
   accessor utilityNetworkAssociationsContent: boolean;
 }

package/popup/support/featureUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.1/LICENSE.txt */
-import e from"../../core/Logger.js";import{replace as t}from"../../core/string.js";import{getGraphicLayer as n}from"../../graphic/graphicOriginUtils.js";import{formatDate as r,convertDateFormatToIntlOptions as i}from"../../intl/date.js";import{convertNumberFieldFormatToIntlOptions as o,convertNumberFormatToIntlOptions as a,formatNumber as l}from"../../intl/number.js";import{fieldFormatFromFieldInfo as u}from"../../layers/support/fieldFormatUtils.js";import{isRasterPixelValueField as s,featureHasFields as f,isTimeOnlyField as d}from"../../layers/support/fieldUtils.js";import{getFieldConfigurationsContainer as c,getEffectiveLayerCapabilities as p}from"../../layers/support/layerUtils.js";import{formatAnyDate as y,isAnyDateField as m}from"../../smartMapping/support/utils.js";import{loadArcade as g}from"../../support/loadArcade.js";import{getTimeZoneFormattingOptions as I}from"../../time/timeZoneUtils.js";const b="esri.popup.support.featureUtils",h=()=>e.getLogger(b),F=/href=(""|'')/gi,T=/(\{([^{\r\n]+)\})/g,w=/'/g,N=/^\s*expression\//i,C=/(\n)/gi,j=/[\u00A0-\u9999<>&]/gim,Z=/href\s*=\s*(?:"([^"]+)"|'([^']+)')/gi,v=/^(?:mailto:|tel:)/,L="relationships/",U=i("short-date-short-time");function q(e){if(null!=e)return(e.sourceLayer||e.layer)??void 0}async function x({type:e,value:t,event:n}){try{return"function"==typeof t?t(n):await t}catch(r){return void h().error("error",`An error occurred when calling the "${e}" function`,{error:r,graphic:n.graphic,value:t})}}function A(e=""){if(e)return!v.test(e.trim().toLowerCase())}function E(e){return!!e&&N.test(e)}function M(e,t){if(!t||!E(t)||!e)return;const n=t.replace(N,"").toLowerCase();return e.find(({name:e})=>e.toLowerCase()===n)}function k(e){const{fieldInfo:t,graphic:n,layer:r}=e;return R({fieldInfo:t,graphic:n})?c(r,{graphic:n}):null}function R({fieldInfo:e,graphic:t}){return!(!e?.fieldName||E(e.fieldName)||Te(e.fieldName)||t?.popupTemplate)}function $({expressionInfos:e,fieldInfo:t,graphic:n,isContentFieldInfos:r,layer:i}){if(!t?.fieldName)return null;const o=M(e,t.fieldName);if(o)return o.title||null;const a=k({fieldInfo:t,graphic:n,layer:i});if(a){const e=a.getFieldAlias(t.fieldName);return r?t.label||e||t.fieldName:e||t.fieldName}return t.label||t.fieldName}function D(e){const{configurableFieldsContainer:t,fieldInfo:n,isContentFieldInfos:r}=e;if(!n?.fieldName)return null;const i=t.popupTemplate||t.fieldConfigurations?t.getFieldConfiguration(n.fieldName)?.fieldFormat:u(n,t.getField(n.fieldName));return r&&n.fieldFormat||i}function z(e,t){const n=t.get(e.toLowerCase());return`{${n?.fieldName||e}}`}function O(e){return e.replaceAll(F,"")}function S(e,t){const n=Q(t,e);return n?n.name:e}function G(e,t){return e&&e.map(e=>S(e,t))}function Q(e,t){return e&&"function"==typeof e.getField&&t?e.getField(t)??null:null}function P(e){return`${e}`.trim()}function _({attributes:e,globalAttributes:t,layer:n,text:r,expressionAttributes:i,fieldInfoMap:o}){return r?H({formattedAttributes:t,template:V(r,{...t,...i,...e},n),fieldInfoMap:o}):""}function H({formattedAttributes:e,template:n,fieldInfoMap:r}){return P(O(t(t(n,e=>z(e,r)),e)))}function W(e,t,n=!1){const r=t[e];if("string"==typeof r){const i="%27",o=(n?encodeURIComponent(r):r).replaceAll(w,i);t[e]=o}}function B(e,t=!1){const n={...e};return Object.keys(n).forEach(e=>W(e,n,t)),n}function J(e,n,r){const i=(n=P(n))&&!n.startsWith("{");return t(e,B(r,i||!1))}function K(e,t){return e.replaceAll(T,(e,n,r)=>{const i=Q(t,r);return i?`{${i.name}}`:n})}function V(e,t,n){const r=K(e,n);return r?r.replaceAll(Z,(e,n,r)=>J(e,n||r,t)):r}function X(e,t){const n="number"===t?.fieldFormat?.type||t?.format&&null==t.format.dateFormat&&(null!=t.format.places||null!=t.format.digitSeparator);if("string"==typeof e&&n){const t=Number(e);if(!isNaN(t))return t}return e}function Y(e){return null!=e&&"object"==typeof e&&"fieldsIndex"in e&&"geometryType"in e&&"getField"in e&&"load"in e&&"loaded"in e&&"objectIdField"in e&&"spatialReference"in e&&"type"in e&&("feature"===e.type||"scene"===e.type||"subtype-group"===e.type||"subtype-sublayer"===e.type||"sublayer"===e.type)&&"when"in e}function ee(e){return null!=e&&"object"==typeof e&&"createQuery"in e&&"queryFeatureCount"in e&&"queryObjectIds"in e&&"queryRelatedFeatures"in e&&"queryRelatedFeaturesCount"in e&&"relationships"in e}function te(e){return Y(e)&&ee(e)}function ne(e){return!(!(e&&"object"==typeof e&&"createQuery"in e&&"getField"in e&&"queryFeatureCount"in e&&"queryFeatures"in e&&"queryObjectIds"in e&&"capabilities"in e&&"fields"in e&&"fieldsIndex"in e&&"type"in e)||"feature"!==e.type&&"subtype-group"!==e.type&&"subtype-sublayer"!==e.type&&"sublayer"!==e.type||!("when"in e))&&("subtype-sublayer"===e.type&&"parent"in e&&e.parent&&"object"==typeof e.parent?"globalIdField"in e.parent:"globalIdField"in e)}function re(e){if(!e||"object"!=typeof e)return!1;return te(n(e))}function ie(e,t){const{fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:u,layer:f,preventPlacesFormatting:d,timeZone:c}=t,p=le(n,r),m=k({fieldInfo:p,graphic:i,layer:f}),g=Q(m||f,r),I=m?null:p?.format,b=m?D({configurableFieldsContainer:m,fieldInfo:p,isContentFieldInfos:u}):null,h="number"===b?.type;if(p&&!s(r)){const t=g?.type,n="date-time"===b?.type,r=I?.dateFormat;if("date"===t||"date-only"===t||"time-only"===t||"timestamp-offset"===t||n||r)return y(e,{format:n?void 0:r,fieldFormat:n?b:void 0,fieldType:t,timeZoneOptions:{layerTimeZone:f&&"preferredTimeZone"in f?f.preferredTimeZone:null,viewTimeZone:c,datesInUnknownTimezone:!(!f||!("datesInUnknownTimezone"in f))&&!!f.datesInUnknownTimezone}})}if("string"==typeof e&&s(r)&&I)return oe(e,I);if("string"==typeof(e=X(e,{format:h?void 0:I,fieldFormat:h?b:void 0}))||null==e||null==I&&null==b)return ye(e);const F=h?o(b):I?a(I):void 0;return l(e,d?{...F,minimumFractionDigits:0,maximumFractionDigits:20}:F)}function oe(e,t){return e=e.trim(),/\d{2}-\d{2}/.test(e)?e:e.includes(",")?ae(e,",",", ",t):e.includes(";")?ae(e,";","; ",t):e.includes(" ")?ae(e," "," ",t):l(Number(e),a(t))}function ae(e,t,n,r){return e.trim().split(t).map(e=>l(Number(e),a(r))).join(n)}function le(e,t){if(e?.length&&t)return e.find(e=>e.fieldName?.toLowerCase()===t.toLowerCase())}function ue({fieldName:e,graphic:t,layer:n}){if(Te(e))return null;if(!n||"function"!=typeof n.getFeatureType)return null;const{typeIdField:r}=n;if(!r||e!==r)return null;const i=n.getFeatureType(t);return i?i.name:null}function se({fieldName:e,value:t,graphic:n,layer:r}){if(Te(e))return null;if(!r||"function"!=typeof r.getFieldDomain)return null;const i=n&&r.getFieldDomain(e,{feature:n});return i&&"coded-value"===i.type?i.getName(t):null}function fe(e,t,n,i){const{creatorField:o,creationDateField:a,editorField:l,editDateField:u}=e;if(!t)return;const s=I(i&&"preferredTimeZone"in i?i.preferredTimeZone:null,!(!i||!("datesInUnknownTimezone"in i))&&!!i.datesInUnknownTimezone,n,U,"date"),f={...U,...s},d=t[u];if("number"==typeof d){const e=t[l];return{type:"edit",date:r(d,f),user:e}}const c=t[a];if("number"==typeof c){const e=t[o];return{type:"create",date:r(c,f),user:e}}return null}function de(e,t){const n=new Map;if(!e)return n;for(const r of e){if(!r.fieldName)continue;const e=S(r.fieldName,t);r.fieldName=e,n.set(e.toLowerCase(),r)}return n}function ce(e){const t=[];if(!e)return t;const{fieldInfos:n,content:r}=e;return n&&t.push(...n),r&&Array.isArray(r)?(r.forEach(e=>{if("fields"===e.type){const n=e?.fieldInfos;n&&t.push(...n)}}),t):t}function pe(e){return e.replaceAll(j,e=>`&#${e.charCodeAt(0)};`)}function ye(e){return"string"==typeof e?e.replaceAll(C,'<br class="esri-text-new-line" />'):e}function me(e){const{fieldInfoMap:t,fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l,value:u}=e;if(null==u)return"";const s=se({fieldName:r,value:u,graphic:i,layer:a});if(s)return s;const f=ue({fieldName:r,graphic:i,layer:a});if(f)return f;if(t.get(r.toLowerCase()))return ie(u,{fieldInfos:n||Array.from(t.values()),fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l});const c=a?.fieldsIndex?.get(r);return c&&(m(c)||d(c))?y(u,{fieldType:c.type,timeZoneOptions:{layerTimeZone:a&&"preferredTimeZone"in a?a.preferredTimeZone:null,viewTimeZone:l,datesInUnknownTimezone:!(!a||!("datesInUnknownTimezone"in a))&&!!a.datesInUnknownTimezone}}):ye(u)}function ge({attributes:e,fieldInfoMap:t,fieldInfos:n,graphic:r,isContentFieldInfos:i,layer:o,relatedInfos:a,timeZone:l}){const u={};return a?.forEach(e=>Ce({attributes:u,relatedInfo:e,fieldInfoMap:t,fieldInfos:n,layer:o,timeZone:l})),e&&Object.keys(e).forEach(a=>{const s=e[a];u[a]=me({fieldInfoMap:t,fieldInfos:n,fieldName:a,graphic:r,isContentFieldInfos:i,layer:o,timeZone:l,value:s})}),u}async function Ie(e,t){const{layer:n,graphic:r,outFields:i,objectIds:o,returnGeometry:a,spatialReference:l}=e,u=o[0];if("number"!=typeof u&&"string"!=typeof u){const e="Could not query required fields for the specified feature. The feature's ID is invalid.",t={layer:n,graphic:r,objectId:u,requiredFields:i};return h().warn(e,t),null}if(!p(n)?.operations?.supportsQuery){const e="The specified layer cannot be queried. The following fields will not be available.",t={layer:n,graphic:r,requiredFields:i,returnGeometry:a};return h().warn(e,t),null}const s=n.createQuery();s.objectIds=o,s.outFields=i?.length?i:[n.objectIdField],s.returnGeometry=!!a,s.returnZ=!!a,s.returnM=!!a,s.outSpatialReference=l;return(await n.queryFeatures(s,t)).features[0]}async function be(e){if(!e.expressionInfos?.length)return!1;const t=await g(),{arcadeUtils:{hasGeometryFunctions:n}}=t;return n(e)}async function he(e){if(!e.expressionInfos?.length)return!1;const t=await g(),{arcadeUtils:{requiresTrack:n}}=t;return n(e)}async function Fe({graphic:e,popupTemplate:t,layer:n,spatialReference:r},i){if(!n||!t)return;if("function"==typeof n.load&&await n.load(i),!e.attributes)return;const o=n.objectIdField,a=e.attributes[o];if(null==a)return;const l=[a],u=new Set(await t.getRequiredFields(n.fieldsIndex));null==n.timeInfo?.trackIdField||u.has(n.timeInfo.trackIdField)||await he(t)&&u.add(n.timeInfo.trackIdField);const s=f(e,u),d=s?[]:u.has(o)?[...u]:[...u,o],c=t.returnGeometry||await be(t);if(s&&!c)return;const p=await Ie({layer:n,graphic:e,outFields:d,objectIds:l,returnGeometry:c,spatialReference:r},i);p&&(p.geometry&&(e.geometry=p.geometry),p.attributes&&(e.attributes={...e.attributes,...p.attributes}))}function Te(e=""){return!!e&&e.includes(L)}function we(e){return e?`${L}${e.layerId}/${e.fieldName}`:""}function Ne({attributes:e,graphic:t,relatedInfo:n,fieldInfos:r,fieldInfoMap:i,layer:o,timeZone:a}){e&&t&&n&&Object.keys(t.attributes).forEach(l=>{const u=we({layerId:n.relation.id.toString(),fieldName:l}),s=t.attributes[l];e[u]=me({fieldName:u,fieldInfos:r,fieldInfoMap:i,layer:o,value:s,graphic:t,timeZone:a})})}function Ce({attributes:e,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o}){e&&t&&(t.relatedFeatures?.forEach(a=>Ne({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})),t.relatedStatsFeatures?.forEach(a=>Ne({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})))}const je=e=>{if(!e)return!1;const t=e.toUpperCase();return t.includes("CURRENT_TIMESTAMP")||t.includes("CURRENT_DATE")||t.includes("CURRENT_TIME")},Ze=({layer:e,method:t,query:n,definitionExpression:r})=>{if(!e.capabilities?.query?.supportsCacheHint||"attachments"===t)return;const i=null!=n.where?n.where:null,o=null!=n.geometry?n.geometry:null;je(r)||je(i)||"extent"===o?.type||"tile"===n.resultType||(n.cacheHint=!0)},ve=({query:e,layer:t,method:n})=>{Ze({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})},Le=({queryPayload:e,layer:t,method:n})=>{Ze({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})};function Ue(e,t,n){return e&&t&&n?"sublayer"===t.type?Ae({layers:t.layer?.allSublayers,map:e,relatedLayer:t,relationship:n})||Ae({layers:t.layer?.subtables,map:e,relatedLayer:t,relationship:n}):Ae({layers:e.allLayers,map:e,relatedLayer:t,relationship:n})||Ae({layers:e.allTables,map:e,relatedLayer:t,relationship:n}):null}function qe(e,t){return e&&"utilityNetworks"in e&&t?e.utilityNetworks?.find(e=>e.isUtilityLayer(t)):null}function xe(e,t){return e?.allTables.find(e=>"feature"===e.type&&e.layerId===t.id&&e.url===t.layer?.url)}function Ae({map:e,relationship:t,relationship:{relatedTableId:n},relatedLayer:r,layers:i}){if(!i)return null;for(const o of i){if("map-image"===o.type){const n=Ae({layers:o.sublayers,map:e,relatedLayer:r,relationship:t})||Ae({layers:o.subtables,map:e,relatedLayer:r,relationship:t});if(n)return n;continue}if(!te(o))continue;if("sublayer"===r.type){if(o!==r&&o.id===n)return o.isTable?xe(e,o):o;continue}const i="scene"===r.type&&r.associatedLayer?r.associatedLayer.url:r.url;if(!i)return null;if("sublayer"!==o.type){if(o!==r&&o.url===i&&o.layerId===n)return o}else if(o!==r&&o.layer?.url===i&&o.id===n)return o.isTable?xe(e,o):o}return null}export{ye as applyTextFormattingHTML,de as createFieldInfoMap,Ue as findRelatedLayer,qe as findUtilityNetwork,K as fixTokens,ge as formatAttributes,fe as formatEditInfo,ie as formatValueToFieldInfo,ce as getAllFieldInfos,k as getConfigurableFieldsContainer,D as getFieldFormat,le as getFieldInfo,$ as getFieldInfoLabel,S as getFixedFieldName,G as getFixedFieldNames,q as getSourceLayer,x as graphicCallback,pe as htmlEntities,ne as isAssociatedFeatureSupportedLayer,E as isExpressionField,Y as isFeatureSupportedLayer,re as isGraphicForRelatableFeatureSupportedLayer,te as isRelatableFeatureSupportedLayer,ee as isRelatableLayer,Te as isRelatedField,ve as preLayerQueryCallback,Le as preRequestCallback,Ie as querySourceLayer,Fe as queryUpdatedFeature,A as shouldOpenInNewTab,H as substituteAttributes,_ as substituteFieldsInLinksAndAttributes};
+import e from"../../core/Logger.js";import{replace as t}from"../../core/string.js";import{getGraphicLayer as n}from"../../graphic/graphicOriginUtils.js";import{formatDate as r,convertDateFormatToIntlOptions as i}from"../../intl/date.js";import{convertNumberFieldFormatToIntlOptions as o,convertNumberFormatToIntlOptions as a,formatNumber as l}from"../../intl/number.js";import{typesHaveUniqueIdsAndNames as u}from"../../layers/support/featureLayerUtils.js";import{fieldFormatFromFieldInfo as s}from"../../layers/support/fieldFormatUtils.js";import{isRasterPixelValueField as f,featureHasFields as d,isTimeOnlyField as c}from"../../layers/support/fieldUtils.js";import{getFieldConfigurationsContainer as p,getEffectiveLayerCapabilities as y}from"../../layers/support/layerUtils.js";import{formatAnyDate as m,isAnyDateField as g}from"../../smartMapping/support/utils.js";import{loadArcade as I}from"../../support/loadArcade.js";import{getTimeZoneFormattingOptions as b}from"../../time/timeZoneUtils.js";const h="esri.popup.support.featureUtils",F=()=>e.getLogger(h),T=/href=(""|'')/gi,w=/(\{([^{\r\n]+)\})/g,N=/'/g,C=/^\s*expression\//i,j=/(\n)/gi,Z=/[\u00A0-\u9999<>&]/gim,v=/href\s*=\s*(?:"([^"]+)"|'([^']+)')/gi,L=/^(?:mailto:|tel:)/,U="relationships/",q=i("short-date-short-time");function x(e){if(null!=e)return(e.sourceLayer||e.layer)??void 0}async function A({type:e,value:t,event:n}){try{return"function"==typeof t?t(n):await t}catch(r){return void F().error("error",`An error occurred when calling the "${e}" function`,{error:r,graphic:n.graphic,value:t})}}function E(e=""){if(e)return!L.test(e.trim().toLowerCase())}function M(e){return!!e&&C.test(e)}function k(e,t){if(!t||!M(t)||!e)return;const n=t.replace(C,"").toLowerCase();return e.find(({name:e})=>e.toLowerCase()===n)}function R(e){const{fieldInfo:t,graphic:n,layer:r}=e;return $({fieldInfo:t,graphic:n})?p(r,{graphic:n}):null}function $({fieldInfo:e,graphic:t}){return!(!e?.fieldName||M(e.fieldName)||we(e.fieldName)||t?.popupTemplate)}function D({expressionInfos:e,fieldInfo:t,graphic:n,isContentFieldInfos:r,layer:i}){if(!t?.fieldName)return null;const o=k(e,t.fieldName);if(o)return o.title||null;const a=R({fieldInfo:t,graphic:n,layer:i});if(a){const e=a.getFieldAlias(t.fieldName);return r?t.label||e||t.fieldName:e||t.fieldName}return t.label||t.fieldName}function z(e){const{configurableFieldsContainer:t,fieldInfo:n,isContentFieldInfos:r}=e;if(!n?.fieldName)return null;const i=t.popupTemplate||t.fieldConfigurations?t.getFieldConfiguration(n.fieldName)?.fieldFormat:s(n,t.getField(n.fieldName));return r&&n.fieldFormat||i}function O(e,t){const n=t.get(e.toLowerCase());return`{${n?.fieldName||e}}`}function S(e){return e.replaceAll(T,"")}function G(e,t){const n=P(t,e);return n?n.name:e}function Q(e,t){return e&&e.map(e=>G(e,t))}function P(e,t){return e&&"function"==typeof e.getField&&t?e.getField(t)??null:null}function _(e){return`${e}`.trim()}function H({attributes:e,globalAttributes:t,layer:n,text:r,expressionAttributes:i,fieldInfoMap:o}){return r?W({formattedAttributes:t,template:X(r,{...t,...i,...e},n),fieldInfoMap:o}):""}function W({formattedAttributes:e,template:n,fieldInfoMap:r}){return _(S(t(t(n,e=>O(e,r)),e)))}function B(e,t,n=!1){const r=t[e];if("string"==typeof r){const i="%27",o=(n?encodeURIComponent(r):r).replaceAll(N,i);t[e]=o}}function J(e,t=!1){const n={...e};return Object.keys(n).forEach(e=>B(e,n,t)),n}function K(e,n,r){const i=(n=_(n))&&!n.startsWith("{");return t(e,J(r,i||!1))}function V(e,t){return e.replaceAll(w,(e,n,r)=>{const i=P(t,r);return i?`{${i.name}}`:n})}function X(e,t,n){const r=V(e,n);return r?r.replaceAll(v,(e,n,r)=>K(e,n||r,t)):r}function Y(e,t){const n="number"===t?.fieldFormat?.type||t?.format&&null==t.format.dateFormat&&(null!=t.format.places||null!=t.format.digitSeparator);if("string"==typeof e&&n){const t=Number(e);if(!isNaN(t))return t}return e}function ee(e){return null!=e&&"object"==typeof e&&"fieldsIndex"in e&&"geometryType"in e&&"getField"in e&&"load"in e&&"loaded"in e&&"objectIdField"in e&&"spatialReference"in e&&"type"in e&&("feature"===e.type||"scene"===e.type||"subtype-group"===e.type||"subtype-sublayer"===e.type||"sublayer"===e.type)&&"when"in e}function te(e){return null!=e&&"object"==typeof e&&"createQuery"in e&&"queryFeatureCount"in e&&"queryObjectIds"in e&&"queryRelatedFeatures"in e&&"queryRelatedFeaturesCount"in e&&"relationships"in e}function ne(e){return ee(e)&&te(e)}function re(e){return!(!(e&&"object"==typeof e&&"createQuery"in e&&"getField"in e&&"queryFeatureCount"in e&&"queryFeatures"in e&&"queryObjectIds"in e&&"capabilities"in e&&"fields"in e&&"fieldsIndex"in e&&"type"in e)||"feature"!==e.type&&"subtype-group"!==e.type&&"subtype-sublayer"!==e.type&&"sublayer"!==e.type||!("when"in e))&&("subtype-sublayer"===e.type&&"parent"in e&&e.parent&&"object"==typeof e.parent?"globalIdField"in e.parent:"globalIdField"in e)}function ie(e){if(!e||"object"!=typeof e)return!1;return ne(n(e))}function oe(e,t){const{fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:u,layer:s,preventPlacesFormatting:d,timeZone:c}=t,p=ue(n,r),y=R({fieldInfo:p,graphic:i,layer:s}),g=P(y||s,r),I=y?null:p?.format,b=y?z({configurableFieldsContainer:y,fieldInfo:p,isContentFieldInfos:u}):null,h="number"===b?.type;if(p&&!f(r)){const t=g?.type,n="date-time"===b?.type,r=I?.dateFormat;if("date"===t||"date-only"===t||"time-only"===t||"timestamp-offset"===t||n||r)return m(e,{format:n?void 0:r,fieldFormat:n?b:void 0,fieldType:t,timeZoneOptions:{layerTimeZone:s&&"preferredTimeZone"in s?s.preferredTimeZone:null,viewTimeZone:c,datesInUnknownTimezone:!(!s||!("datesInUnknownTimezone"in s))&&!!s.datesInUnknownTimezone}})}if("string"==typeof e&&f(r)&&I)return ae(e,I);if("string"==typeof(e=Y(e,{format:h?void 0:I,fieldFormat:h?b:void 0}))||null==e||null==I&&null==b)return me(e);const F=h?o(b):I?a(I):void 0;return l(e,d?{...F,minimumFractionDigits:0,maximumFractionDigits:20}:F)}function ae(e,t){return e=e.trim(),/\d{2}-\d{2}/.test(e)?e:e.includes(",")?le(e,",",", ",t):e.includes(";")?le(e,";","; ",t):e.includes(" ")?le(e," "," ",t):l(Number(e),a(t))}function le(e,t,n,r){return e.trim().split(t).map(e=>l(Number(e),a(r))).join(n)}function ue(e,t){if(e?.length&&t)return e.find(e=>e.fieldName?.toLowerCase()===t.toLowerCase())}function se({fieldName:e,graphic:t,layer:n}){if(we(e))return null;if(!n||"function"!=typeof n.getFeatureType)return null;const{typeIdField:r}=n;if(!r||e!==r)return null;const i=n.getFeatureType(t);return i?i.name:null}function fe({fieldName:e,value:t,graphic:n,layer:r}){if(we(e))return null;if(!r||"function"!=typeof r.getFieldDomain)return null;const i=n&&r.getFieldDomain(e,{feature:n});return i&&"coded-value"===i.type?i.getName(t):null}function de(e,t,n,i){const{creatorField:o,creationDateField:a,editorField:l,editDateField:u}=e;if(!t)return;const s=b(i&&"preferredTimeZone"in i?i.preferredTimeZone:null,!(!i||!("datesInUnknownTimezone"in i))&&!!i.datesInUnknownTimezone,n,q,"date"),f={...q,...s},d=t[u];if("number"==typeof d){const e=t[l];return{type:"edit",date:r(d,f),user:e}}const c=t[a];if("number"==typeof c){const e=t[o];return{type:"create",date:r(c,f),user:e}}return null}function ce(e,t){const n=new Map;if(!e)return n;for(const r of e){if(!r.fieldName)continue;const e=G(r.fieldName,t);r.fieldName=e,n.set(e.toLowerCase(),r)}return n}function pe(e){const t=[];if(!e)return t;const{fieldInfos:n,content:r}=e;return n&&t.push(...n),r&&Array.isArray(r)?(r.forEach(e=>{if("fields"===e.type){const n=e?.fieldInfos;n&&t.push(...n)}}),t):t}function ye(e){return e.replaceAll(Z,e=>`&#${e.charCodeAt(0)};`)}function me(e){return"string"==typeof e?e.replaceAll(j,'<br class="esri-text-new-line" />'):e}function ge(e){const{fieldInfoMap:t,fieldInfos:n,fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l,value:s}=e;if(null==s)return"";const f=fe({fieldName:r,value:s,graphic:i,layer:a});if(f)return f;const d=a?.types&&u(a.types)?se({fieldName:r,graphic:i,layer:a}):null;if(d)return d;if(t.get(r.toLowerCase()))return oe(s,{fieldInfos:n||Array.from(t.values()),fieldName:r,graphic:i,isContentFieldInfos:o,layer:a,timeZone:l});const p=a?.fieldsIndex?.get(r);return p&&(g(p)||c(p))?m(s,{fieldType:p.type,timeZoneOptions:{layerTimeZone:a&&"preferredTimeZone"in a?a.preferredTimeZone:null,viewTimeZone:l,datesInUnknownTimezone:!(!a||!("datesInUnknownTimezone"in a))&&!!a.datesInUnknownTimezone}}):me(s)}function Ie({attributes:e,fieldInfoMap:t,fieldInfos:n,graphic:r,isContentFieldInfos:i,layer:o,relatedInfos:a,timeZone:l}){const u={};return a?.forEach(e=>je({attributes:u,relatedInfo:e,fieldInfoMap:t,fieldInfos:n,layer:o,timeZone:l})),e&&Object.keys(e).forEach(a=>{const s=e[a];u[a]=ge({fieldInfoMap:t,fieldInfos:n,fieldName:a,graphic:r,isContentFieldInfos:i,layer:o,timeZone:l,value:s})}),u}async function be(e,t){const{layer:n,graphic:r,outFields:i,objectIds:o,returnGeometry:a,spatialReference:l}=e,u=o[0];if("number"!=typeof u&&"string"!=typeof u){const e="Could not query required fields for the specified feature. The feature's ID is invalid.",t={layer:n,graphic:r,objectId:u,requiredFields:i};return F().warn(e,t),null}if(!y(n)?.operations?.supportsQuery){const e="The specified layer cannot be queried. The following fields will not be available.",t={layer:n,graphic:r,requiredFields:i,returnGeometry:a};return F().warn(e,t),null}const s=n.createQuery();s.objectIds=o,s.outFields=i?.length?i:[n.objectIdField],s.returnGeometry=!!a,s.returnZ=!!a,s.returnM=!!a,s.outSpatialReference=l;return(await n.queryFeatures(s,t)).features[0]}async function he(e){if(!e.expressionInfos?.length)return!1;const t=await I(),{arcadeUtils:{hasGeometryFunctions:n}}=t;return n(e)}async function Fe(e){if(!e.expressionInfos?.length)return!1;const t=await I(),{arcadeUtils:{requiresTrack:n}}=t;return n(e)}async function Te({graphic:e,popupTemplate:t,layer:n,spatialReference:r},i){if(!n||!t)return;if("function"==typeof n.load&&await n.load(i),!e.attributes)return;const o=n.objectIdField,a=e.attributes[o];if(null==a)return;const l=[a],u=new Set(await t.getRequiredFields(n.fieldsIndex));null==n.timeInfo?.trackIdField||u.has(n.timeInfo.trackIdField)||await Fe(t)&&u.add(n.timeInfo.trackIdField);const s=d(e,u),f=s?[]:u.has(o)?[...u]:[...u,o],c=t.returnGeometry||await he(t);if(s&&!c)return;const p=await be({layer:n,graphic:e,outFields:f,objectIds:l,returnGeometry:c,spatialReference:r},i);p&&(p.geometry&&(e.geometry=p.geometry),p.attributes&&(e.attributes={...e.attributes,...p.attributes}))}function we(e=""){return!!e&&e.includes(U)}function Ne(e){return e?`${U}${e.layerId}/${e.fieldName}`:""}function Ce({attributes:e,graphic:t,relatedInfo:n,fieldInfos:r,fieldInfoMap:i,layer:o,timeZone:a}){e&&t&&n&&Object.keys(t.attributes).forEach(l=>{const u=Ne({layerId:n.relation.id.toString(),fieldName:l}),s=t.attributes[l];e[u]=ge({fieldName:u,fieldInfos:r,fieldInfoMap:i,layer:o,value:s,graphic:t,timeZone:a})})}function je({attributes:e,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o}){e&&t&&(t.relatedFeatures?.forEach(a=>Ce({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})),t.relatedStatsFeatures?.forEach(a=>Ce({attributes:e,graphic:a,relatedInfo:t,fieldInfoMap:n,fieldInfos:r,layer:i,timeZone:o})))}const Ze=e=>{if(!e)return!1;const t=e.toUpperCase();return t.includes("CURRENT_TIMESTAMP")||t.includes("CURRENT_DATE")||t.includes("CURRENT_TIME")},ve=({layer:e,method:t,query:n,definitionExpression:r})=>{if(!e.capabilities?.query?.supportsCacheHint||"attachments"===t)return;const i=null!=n.where?n.where:null,o=null!=n.geometry?n.geometry:null;Ze(r)||Ze(i)||"extent"===o?.type||"tile"===n.resultType||(n.cacheHint=!0)},Le=({query:e,layer:t,method:n})=>{ve({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})},Ue=({queryPayload:e,layer:t,method:n})=>{ve({layer:t,method:n,query:e,definitionExpression:`${t.definitionExpression} ${t.serviceDefinitionExpression??""}`})};function qe(e,t,n){return e&&t&&n?"sublayer"===t.type?Ee({layers:t.layer?.allSublayers,map:e,relatedLayer:t,relationship:n})||Ee({layers:t.layer?.subtables,map:e,relatedLayer:t,relationship:n}):Ee({layers:e.allLayers,map:e,relatedLayer:t,relationship:n})||Ee({layers:e.allTables,map:e,relatedLayer:t,relationship:n}):null}function xe(e,t){return e&&"utilityNetworks"in e&&t?e.utilityNetworks?.find(e=>e.isUtilityLayer(t)):null}function Ae(e,t){return e?.allTables.find(e=>"feature"===e.type&&e.layerId===t.id&&e.url===t.layer?.url)}function Ee({map:e,relationship:t,relationship:{relatedTableId:n},relatedLayer:r,layers:i}){if(!i)return null;for(const o of i){if("map-image"===o.type){const n=Ee({layers:o.sublayers,map:e,relatedLayer:r,relationship:t})||Ee({layers:o.subtables,map:e,relatedLayer:r,relationship:t});if(n)return n;continue}if(!ne(o))continue;if("sublayer"===r.type){if(o!==r&&o.id===n)return o.isTable?Ae(e,o):o;continue}const i="scene"===r.type&&r.associatedLayer?r.associatedLayer.url:r.url;if(!i)return null;if("sublayer"!==o.type){if(o!==r&&o.url===i&&o.layerId===n)return o}else if(o!==r&&o.layer?.url===i&&o.id===n)return o.isTable?Ae(e,o):o}return null}export{me as applyTextFormattingHTML,ce as createFieldInfoMap,qe as findRelatedLayer,xe as findUtilityNetwork,V as fixTokens,Ie as formatAttributes,de as formatEditInfo,oe as formatValueToFieldInfo,pe as getAllFieldInfos,R as getConfigurableFieldsContainer,z as getFieldFormat,ue as getFieldInfo,D as getFieldInfoLabel,G as getFixedFieldName,Q as getFixedFieldNames,x as getSourceLayer,A as graphicCallback,ye as htmlEntities,re as isAssociatedFeatureSupportedLayer,M as isExpressionField,ee as isFeatureSupportedLayer,ie as isGraphicForRelatableFeatureSupportedLayer,ne as isRelatableFeatureSupportedLayer,te as isRelatableLayer,we as isRelatedField,Le as preLayerQueryCallback,Ue as preRequestCallback,be as querySourceLayer,Te as queryUpdatedFeature,E as shouldOpenInNewTab,W as substituteAttributes,H as substituteFieldsInLinksAndAttributes};

package/popup/types.d.ts

@@ -1,5 +1,9 @@
 import type Graphic from "../Graphic.js";
+import type SpatialReference from "../geometry/SpatialReference.js";
+import type Field from "../layers/support/Field.js";
+import type Relationship from "../layers/support/Relationship.js";
 import type Content from "./content/Content.js";
+import type StatisticDefinition from "../rest/support/StatisticDefinition.js";
 import type MapView from "../views/MapView.js";
 import type SceneView from "../views/SceneView.js";
 import type { ScreenPoint } from "../core/types.js";
@@ -168,14 +172,128 @@ export type PopupTemplateTitleResolved = string;
 /** @since 5.0 */
 export type State = "disabled" | "ready" | "error" | "loading";
 
-/** @since 5.0 */
-export interface FeatureFormattedAttributes {}
+/** @since 5.1 */
+export interface FeatureFormattedAttributes {
+  /**
+   * The formatted attributes specified at the root level of the [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/)
+   * using the [PopupTemplate.fieldInfos](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#fieldInfos) property.
+   *
+   * @since 5.1
+   */
+  global: Record<string, any>;
+  /**
+   * The formatted attributes for an individual content element. This is derived from the
+   * [PopupTemplate](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/), or
+   * per an individual content element. This element is defined with a [FieldsContent](https://developers.arcgis.com/javascript/latest/references/core/popup/content/FieldsContent/)
+   * popup element set on the PopupTemplate's [PopupTemplate.content](https://developers.arcgis.com/javascript/latest/references/core/PopupTemplate/#content).
+   *
+   * @since 5.1
+   */
+  content: Record<string, any>[];
+}
 
-/** @since 5.0 */
-export interface LastEditInfo {}
+/** @since 5.1 */
+export interface LastEditInfo {
+  /**
+   * User who performed the last edit on a feature.
+   *
+   * @since 5.1
+   */
+  user: string;
+  /**
+   * Date that the edit was performed.
+   *
+   * @since 5.1
+   */
+  date: string;
+  /**
+   * The type of edit that was performed on the feature.
+   *
+   * @since 5.1
+   */
+  type: "edit" | "create";
+}
 
-/** @since 5.0 */
-export interface RelatedInfo {}
+/**
+ * Information about the layer associated with the feature.
+ *
+ * @since 5.1
+ */
+export interface LayerInfo {
+  /**
+   * An array of the layer's fields.
+   *
+   * @since 5.1
+   */
+  fields: Field[];
+  /**
+   * An array of the layer's relationships.
+   *
+   * @since 5.1
+   */
+  relationships: Relationship[];
+  /**
+   * The object ID field of the layer.
+   *
+   * @since 5.1
+   */
+  objectIdField: string;
+  /**
+   * Indicates whether the layer supports statistics.
+   *
+   * @since 5.1
+   */
+  supportsStatistics: boolean;
+}
 
-/** @since 5.0 */
-export interface Abilities {}
+/** @since 5.1 */
+export interface RelatedInfo {
+  /**
+   * The URL of the related layer.
+   *
+   * @since 5.1
+   */
+  url: string;
+  /**
+   * An array of statistics to be calculated for the related features.
+   *
+   * @since 5.1
+   */
+  outStatistics?: StatisticDefinition[];
+  /**
+   * An array of related fields that are related to the current feature.
+   *
+   * @since 5.1
+   */
+  relatedFields?: string[];
+  /**
+   * An array of features related to the current feature.
+   *
+   * @since 5.1
+   */
+  relatedFeatures?: Graphic[];
+  /**
+   * An array of related features with statistics for the current feature.
+   *
+   * @since 5.1
+   */
+  relatedStatsFeatures?: Graphic[];
+  /**
+   * The relationship between the current feature and the related features.
+   *
+   * @since 5.1
+   */
+  relation?: Relationship;
+  /**
+   * The layer information for the related features.
+   *
+   * @since 5.1
+   */
+  layerInfo?: LayerInfo;
+  /**
+   * The spatial reference of the source feature.
+   *
+   * @since 5.1
+   */
+  sourceSpatialReference?: SpatialReference;
+}