@arcgis/core 5.2.0-next.121 → 5.2.0-next.123

package/views/View.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../Map.js";import{createTask as i}from"../core/asyncUtils.js";import r from"../core/Collection.js";import a from"../core/CollectionFlattener.js";import{referenceSetter as s}from"../core/collectionUtils.js";import o from"../core/Error.js";import{EventedMixin as n}from"../core/Evented.js";import l from"../core/Handles.js";import{makeHandle as p}from"../core/handleUtils.js";import has from"../core/has.js";import{isLoadable as h}from"../core/Loadable.js";import d from"../core/Logger.js";import{destroyMaybe as y,abortMaybe as u}from"../core/maybe.js";import{EsriPromise as m}from"../core/Promise.js";import{after as c}from"../core/promiseUtils.js";import g from"../core/ReactiveSet.js";import{watch as f,sync as w,whenOnce as v,when as _,syncAndInitial as M}from"../core/reactiveUtils.js";import{property as V,subclass as b}from"../core/accessorSupport/decorators.js";import{owningCollectionProperty as R}from"../core/support/OwningCollection.js";import{UpdatingHandles as S}from"../core/support/UpdatingHandles.js";import T from"../geometry/Extent.js";import j from"../geometry/HeightModelInfo.js";import E from"../geometry/SpatialReference.js";import{equals as L}from"../geometry/support/spatialReferenceUtils.js";import{AnalysesCollection as x}from"../support/AnalysesCollection.js";import{GraphicsCollection as C}from"../support/GraphicsCollection.js";import{system as F}from"../time/constants.js";import O from"../time/TimeExtent.js";import{isTimeZoneValid as k}from"../time/timeZoneUtils.js";import H from"./BasemapView.js";import I from"./Magnifier.js";import Z from"./SelectionManager.js";import q from"./Theme.js";import{ToolViewManager as W}from"./ToolViewManager.js";import{GlyphMosaic as A}from"./2d/engine/webgl/GlyphMosaic.js";import{makeDefaultHighlightOptions as P}from"./3d/support/DefaultHighlights.js";import D from"./input/Input.js";import{ViewEvents as U}from"./input/ViewEvents.js";import z from"./navigation/Navigation.js";import{deduplicateAttributionItems as G}from"./support/attributionUtils.js";import{DefaultsFromMap as N}from"./support/DefaultsFromMap.js";import{defaultHighlightName as $}from"./support/HighlightDefaults.js";import B from"./support/HighlightOptions.js";import J from"./support/LayerViewManager.js";import K from"./support/RequiredFieldsOptions.js";import{checkWebAssemblyRequirements as Q}from"./support/WebAssemblyRequirements.js";import{checkWebGLRequirements as X}from"./support/WebGLRequirements.js";var Y;let ee=class extends(n(m)){static{Y=this}constructor(e){super(e),this._userSpatialReference=null,this.handles=new l,this.updatingHandles=new S,this.allLayerViews=new a({getCollections:()=>this.layerviewCollections,getChildrenFunction:ie}),this.animationsEnabled=!0,this.attributionVisible=!0,this.basemapView=null,this.dependencies={popup:void 0},this.displayFilterEnabled=!0,this.fatalError=null,this.graphics=new C,this.typeSpecificPreconditionsReady=!0,this.layerViews=new r,this.magnifier=new I,this.padding={left:0,top:0,right:0,bottom:0},this.ready=!1,this._readyStateWaitingTask=null,this.type=null,this.scale=null,this.updating=!1,this.initialExtentRequired=!0,this._lowPriorityCursorHandles=new r,this._highPriorityCursorHandles=new r,this.input=new D,this.navigation=new z,this.layerViewManager=null,this.analysisViewManager=null,this.isHeightModelInfoRequired=!1,this.width=null,this.height=null,this.resizing=!1,this.suspended=!1,this.viewEvents=new U(this),this.requiredFieldsOptions=new K,this._isValid=!1,this._readyCycleForced=!1,this._lockedSpatialReference=null,this._userTimeZone=null,this._lockedTimeZone=null,this._userTimeExtent=null,this._lockedTimeExtent=null,this._glyphMosaic=null,this.theme=null,this.registeredComponents=new g,this.handles.add(f(()=>this.preconditionsReady,e=>{const t=this.ready;if(e?(this._lockedSpatialReference=this.spatialReference,this._lockedTimeZone=this.timeZone,this._lockedTimeExtent=this.timeExtent,Y.views.add(this)):(this._lockedSpatialReference=null,Y.views.remove(this)),this.notifyChange("spatialReference"),!e&&t)this.toolViewManager?.detach(),this.analysisViewManager?.detach(),this.layerViewManager?.clear(),this._glyphMosaic?.dispose(),this._teardown();else if(e&&!t){try{this._startup()}catch(i){return void queueMicrotask(()=>{this.fatalError=new o("view:startup-error","View._startup failed",i)})}this._glyphMosaic=new A(1024,1024,!0),this.analysisViewManager?.attach(),this.toolViewManager.attach()}},w)),this.analyses=new x}initialize(){this.addResolvingPromise(Promise.all([this.loadAsyncDependencies(),this.validate()]).then(()=>(this._isValid=!0,v(()=>this.ready)))),this.basemapView=new H({view:this}),this.layerViewManager=new J({view:this,layerViewFilter:e=>this.layerViewFilter?.(e)??!0,layerViewImporter:{importLayerView:e=>this.importLayerView(e),hasLayerViewModule:e=>this.hasLayerViewModule(e)},layerviewMapping:this._layerToLayerviewMapping}),this.toolViewManager=new W({view:this}),this.selectionManager=new Z({view:this}),this.addHandles([_(()=>"map-content-error"===this.readyState&&!this.spatialReference,()=>{d.getLogger(this).warn("#spatialReference","no spatial reference could be derived from the currently added map layers")}),f(()=>this.initialExtentRequired,e=>this.defaultsFromMap.required={...this.defaultsFromMap.required,extent:e},M),f(()=>this.ready,e=>{this.defaultsFromMap&&(this.defaultsFromMap.viewReady=e)},w),f(()=>this.defaultsFromMapInputSpatialReference(),e=>{this.defaultsFromMap&&(this.defaultsFromMap.inputSpatialReference=e)},M)])}get _layerToLayerviewMapping(){return Y._layerToLayerview}static{this._layerToLayerview=[["view.map.basemap.baseLayers","view.basemapView.baseLayerViews"],["view.map.basemap.groundLayers","view.basemapView.groundLayerViews"],["view.map.basemap.referenceLayers","view.basemapView.referenceLayerViews"],["view.map.layers","view.layerViews"]]}destroy(){this.destroyed||(Y.views.remove(this),this.viewEvents.destroy(),this.allLayerViews.destroy(),this.navigation&&(this.navigation.destroy(),this._set("navigation",null)),this.graphics=y(this.graphics),this.analyses=y(this.analyses),this.defaultsFromMap.destroy(),this._set("defaultsFromMap",null),this.analysisViewManager=y(this.analysisViewManager),this.toolViewManager=y(this.toolViewManager),this.layerViewManager=y(this.layerViewManager),this.selectionManager=y(this.selectionManager),this.basemapView=y(this.basemapView),this.layerViews.destroyAll(),this.invalidate(),this.handles.destroy(),this.map=y(this.map),this.updatingHandles.destroy())}_startup(){this._set("ready",!0)}_teardown(){this._set("ready",!1)}whenReady(){return Promise.resolve(this)}toMap(){return d.getLogger(this).error("#toMap()","Not implemented on this instance of View"),null}get activeTool(){return this.toolViewManager?.activeTool}set activeTool(e){this.toolViewManager&&(this.toolViewManager.activeTool=e)}get layerviewCollections(){return[this.basemapView?.baseLayerViews,this.basemapView?.groundLayerViews,this.layerViews,this.basemapView?.referenceLayerViews]}get analyses(){return this._get("analyses")}set analyses(e){this._set("analyses",e)}get animation(){return this._get("animation")}set animation(e){this._set("animation",e)}get attributionItems(){return this.suspended?[]:G(this._get("attributionItems"),this.getAttributionItems())}get center(){return null}get defaultsFromMapSettings(){return{}}get defaultsFromMap(){return new N({required:{tileInfo:!1,heightModelInfo:!1,extent:!1},map:()=>this.map,getSpatialReferenceSupport:(e,t)=>this.getSpatialReferenceSupport(e,t),...this.defaultsFromMapSettings})}get extent(){return this._get("extent")}set extent(e){this._set("extent",e)}get heightModelInfo(){return this.getDefaultHeightModelInfo()}glyphMosaic(){return this._glyphMosaic}get highlights(){return this._get("highlights")??P()}set highlights(e){this._set("highlights",s(e,this._get("highlights"),r.ofType(B)))}get defaultHighlight(){return this.highlights.find(({name:e})=>e===$)}get interacting(){return this.navigating}get navigating(){return!1}get preconditionsReady(){if(this.destroying||this.destroyed)return!1;const{map:e,spatialReference:t}=this;return!(this.fatalError||!this._isValid||this._readyCycleForced||!e||h(e)&&!e.loaded||0===this.width||0===this.height||!t||!this._validateSpatialReference(t)||!this._lockedSpatialReference&&!this.defaultsFromMap?.ready||!this.typeSpecificPreconditionsReady)}get resolution(){return 0}set map(e){e!==this._get("map")&&(e?.destroyed&&(d.getLogger(this).warn("#map","The provided map is already destroyed",{map:e}),e=null),h(e)&&e.load().catch(()=>{}),this.constructed&&!this.destroyed&&(this.forceReadyCycle(),this._lockedSpatialReference=null),this._set("map",e))}get canZoomIn(){return!!this.ready}get canZoomOut(){return!!this.ready}get readyState(){if(this.destroyed)return this._get("readyState");if(!this.map)return"missing-map";if("container"in this&&!this.container)return"missing-container";if(this.fatalError)return"rendering-error";if((this.defaultsFromMap?.ready??!1)&&!this.spatialReference){const e=!("loaded"in this.map)||this.map.loaded,t=this.map.ground.loaded,r=this.map.basemap?.loaded??!0;return e&&r&&t&&!this.map?.allLayers.length?"empty-map":(this._readyStateWaitingTask||(this._readyStateWaitingTask=i(e=>c(has("view-readyState-waiting-delay"),null,e)),this.addHandles(this._readyStateWaitingTask),this.addHandles(this._readyStateWaitingTask,"ready-state-task")),this._readyStateWaitingTask?.finished?"map-content-error":"loading")}return this._readyStateWaitingTask=u(this._readyStateWaitingTask),this.removeHandles("ready-state-task"),this.ready?"ready":"loading"}get spatialReference(){const{_userSpatialReference:e}=this;if(e&&null!==e.vcsWkid)return e;const t=e??this._lockedSpatialReference??this.getWebDocumentSpatialReference()??this.defaultsFromMap?.spatialReference??null,i=this.defaultsFromMap?.combinedHorizontalAndVerticalSpatialReference;return i?.equals(t)?i:t}set spatialReference(e){const t=!L(e,this._get("spatialReference"));this._set("_userSpatialReference",e),t&&(this._set("spatialReference",e),this._spatialReferenceChanged(this.spatialReference))}_spatialReferenceChanged(e){}getWebDocumentSpatialReference(){return null}defaultsFromMapInputSpatialReference(){return this._userSpatialReference??(this.ready?this._lockedSpatialReference:null)}get stationary(){return!this.animation&&!this.navigating&&!this.resizing}get timeExtent(){return this._userTimeExtent??this._lockedTimeExtent??this.getDefaultTimeExtent()??null}set timeExtent(e){this._userTimeExtent=e}get timeZone(){return this._userTimeZone??this._lockedTimeZone??this.getDefaultTimeZone()??F}set timeZone(e){this._userTimeZone=e,k(e)||d.getLogger(this).warn("#timeZone",`the parsed value '${e}' may not be a valid IANA time zone`)}get tools(){return this.toolViewManager?.tools}get initialExtent(){return this.defaultsFromMap?.extent}get cursor(){return this.toolViewManager?.cursor??this._highPriorityCursorHandles.at(-1)?.cursor??this._lowPriorityCursorHandles.at(-1)?.cursor??"default"}acquireCursor(e,t="low"){const i="high"===t?this._highPriorityCursorHandles:this._lowPriorityCursorHandles,r={cursor:e},a=p(()=>i.remove(r));return i.add(r),this.addHandles(a),a}get size(){return[this.width,this.height]}get effectiveTheme(){return this.theme??new q}registerComponent(e){this.registeredComponents.add(e)}unregisterComponent(e){this.registeredComponents.delete(e)}whenLayerView(e){return this.layerViewManager?.whenLayerView(e)??Promise.reject()}getAttributionItems(){return this.allLayerViews.items.flatMap(e=>e.attributionItems)}getDefaultHeightModelInfo(){return(this.map&&"heightModelInfo"in this.map?this.map.heightModelInfo:void 0)??this.defaultsFromMap?.heightModelInfo??null}getDefaultTimeZone(){return null}getDefaultTimeExtent(){return null}getSurface(){return null}importLayerView(e){throw new o("view:importLayerView-missing","importLayerView() not implemented")}hasLayerViewModule(e){return!1}async validate(){const e=X(this.type);if(e)throw this._displayWebGLError(),d.getLogger(this).warn("#validate()",e.message),e;const t=await Q();if(t)throw d.getLogger(this).warn("#validate()",t.message),t}async loadAsyncDependencies(){}invalidate(){this._isValid=!1}getSpatialReferenceSupport(){return{constraints:null}}_validateSpatialReference(e){return null!=this.getSpatialReferenceSupport(e)}when(e,t){return this.isResolved()&&!this.ready&&d.getLogger(this).warn("#when()","Calling view.when() while the view is no longer ready but was already resolved once will resolve immediately. Use reactiveUtils.whenOnce(() => view.ready).then(...) instead."),super.when(e,t)}forceReadyCycle(){this.ready&&(_(()=>this.destroyed||!1===this.preconditionsReady,()=>this._readyCycleForced=!1,{once:!0}),this._readyCycleForced=!0)}on(e,t){return super.on(e,t)}addAndActivateTool(e){this.toolViewManager.tools.add(e),this.activeTool=e}tryFatalErrorRecovery(){this.fatalError=null}static{this.views=new r}_displayWebGLError(){const e=document.createElement("div");e.setAttribute("style","display: flex; flex-direction: column; gap: 8px; padding: 20px; height: 100%; justify-content: center; color: black; background: white; font-family: sans-serif;");const t=document.createElement("div");t.innerHTML="Unable to display map. WebGL2 support is required.",t.setAttribute("style","font-size: 24px; font-weight: bold;");const i=document.createElement("div");i.innerHTML="Ensure that your browser and hardware meet the minimum requirements.",i.setAttribute("style","font-size: 18px;");const r=document.createElement("a");r.innerHTML="https://esriurl.com/webgl-faq",r.target="_blank",r.setAttribute("style","font-size: 18px;"),r.href="https://esriurl.com/webgl-faq",e.appendChild(t),e.appendChild(i),e.appendChild(r);const a=this.getSurface();a&&a.appendChild(e)}};e([V()],ee.prototype,"_userSpatialReference",void 0),e([V()],ee.prototype,"activeTool",null),e([V({readOnly:!0})],ee.prototype,"allLayerViews",void 0),e([V({readOnly:!0})],ee.prototype,"layerviewCollections",null),e([V(R(x,"analyses"))],ee.prototype,"analyses",null),e([V()],ee.prototype,"animation",null),e([V()],ee.prototype,"animationsEnabled",void 0),e([V({readOnly:!0})],ee.prototype,"attributionItems",null),e([V()],ee.prototype,"attributionVisible",void 0),e([V()],ee.prototype,"basemapView",void 0),e([V()],ee.prototype,"center",null),e([V()],ee.prototype,"defaultsFromMapSettings",null),e([V()],ee.prototype,"defaultsFromMap",null),e([V()],ee.prototype,"dependencies",void 0),e([V()],ee.prototype,"displayFilterEnabled",void 0),e([V({type:T})],ee.prototype,"extent",null),e([V()],ee.prototype,"fatalError",void 0),e([V(R(C,"graphics"))],ee.prototype,"graphics",void 0),e([V({readOnly:!0,type:j})],ee.prototype,"heightModelInfo",null),e([V({type:r.ofType(B)})],ee.prototype,"highlights",null),e([V({readOnly:!0})],ee.prototype,"interacting",null),e([V({constructOnly:!0})],ee.prototype,"layerViewFilter",void 0),e([V({readOnly:!0})],ee.prototype,"navigating",null),e([V({readOnly:!0})],ee.prototype,"preconditionsReady",null),e([V({readOnly:!0})],ee.prototype,"typeSpecificPreconditionsReady",void 0),e([V({type:r,readOnly:!0})],ee.prototype,"layerViews",void 0),e([V()],ee.prototype,"resolution",null),e([V({type:I})],ee.prototype,"magnifier",void 0),e([V({value:null,type:t})],ee.prototype,"map",null),e([V()],ee.prototype,"padding",void 0),e([V({readOnly:!0})],ee.prototype,"ready",void 0),e([V({readOnly:!0})],ee.prototype,"canZoomIn",null),e([V({readOnly:!0})],ee.prototype,"canZoomOut",null),e([V()],ee.prototype,"_readyStateWaitingTask",void 0),e([V({readOnly:!0})],ee.prototype,"readyState",null),e([V({type:E})],ee.prototype,"spatialReference",null),e([V()],ee.prototype,"stationary",null),e([V({type:O})],ee.prototype,"timeExtent",null),e([V({type:String,nonNullable:!0})],ee.prototype,"timeZone",null),e([V()],ee.prototype,"tools",null),e([V()],ee.prototype,"toolViewManager",void 0),e([V({readOnly:!0})],ee.prototype,"type",void 0),e([V({type:Number})],ee.prototype,"scale",void 0),e([V({readOnly:!0})],ee.prototype,"updating",void 0),e([V({readOnly:!0})],ee.prototype,"initialExtentRequired",void 0),e([V({readOnly:!0})],ee.prototype,"initialExtent",null),e([V()],ee.prototype,"cursor",null),e([V({readOnly:!0})],ee.prototype,"input",void 0),e([V({type:z,nonNullable:!0})],ee.prototype,"navigation",void 0),e([V()],ee.prototype,"layerViewManager",void 0),e([V()],ee.prototype,"analysisViewManager",void 0),e([V()],ee.prototype,"selectionManager",void 0),e([V()],ee.prototype,"width",void 0),e([V()],ee.prototype,"height",void 0),e([V({readOnly:!0})],ee.prototype,"resizing",void 0),e([V({value:null,readOnly:!0})],ee.prototype,"size",null),e([V({readOnly:!0})],ee.prototype,"suspended",void 0),e([V({readOnly:!0})],ee.prototype,"viewEvents",void 0),e([V()],ee.prototype,"_isValid",void 0),e([V()],ee.prototype,"_readyCycleForced",void 0),e([V()],ee.prototype,"_lockedSpatialReference",void 0),e([V()],ee.prototype,"_userTimeZone",void 0),e([V()],ee.prototype,"_lockedTimeZone",void 0),e([V()],ee.prototype,"_userTimeExtent",void 0),e([V()],ee.prototype,"_lockedTimeExtent",void 0),e([V({type:q})],ee.prototype,"theme",void 0),e([V({readOnly:!0,type:q})],ee.prototype,"effectiveTheme",null),e([V({readOnly:!0})],ee.prototype,"registeredComponents",void 0),ee=Y=e([b("esri.views.View")],ee);const te=globalThis.$arcgis;function ie(e){return e.layerViews}te&&!te.views&&Object.defineProperty(te,"views",{configurable:!1,enumerable:!0,writable:!1,value:ee.views});export{ee as default};
+import{__decorate as e}from"tslib";import t from"../Map.js";import{createTask as i}from"../core/asyncUtils.js";import r from"../core/Collection.js";import s from"../core/CollectionFlattener.js";import{referenceSetter as a}from"../core/collectionUtils.js";import o from"../core/Error.js";import{EventedMixin as n}from"../core/Evented.js";import l from"../core/Handles.js";import{makeHandle as p}from"../core/handleUtils.js";import has from"../core/has.js";import{isLoadable as h}from"../core/Loadable.js";import d from"../core/Logger.js";import{destroyMaybe as y,abortMaybe as u}from"../core/maybe.js";import{EsriPromise as m}from"../core/Promise.js";import{after as c}from"../core/promiseUtils.js";import g from"../core/ReactiveSet.js";import{watch as f,sync as w,whenOnce as v,when as _,syncAndInitial as M}from"../core/reactiveUtils.js";import{property as V,subclass as b}from"../core/accessorSupport/decorators.js";import{owningCollectionProperty as R}from"../core/support/OwningCollection.js";import{UpdatingHandles as S}from"../core/support/UpdatingHandles.js";import T from"../geometry/Extent.js";import j from"../geometry/HeightModelInfo.js";import E from"../geometry/SpatialReference.js";import{equals as L}from"../geometry/support/spatialReferenceUtils.js";import{AnalysesCollection as F}from"../support/AnalysesCollection.js";import{GraphicsCollection as x}from"../support/GraphicsCollection.js";import{system as C}from"../time/constants.js";import O from"../time/TimeExtent.js";import{isTimeZoneValid as k}from"../time/timeZoneUtils.js";import H from"./BasemapView.js";import I from"./Magnifier.js";import Z from"./SelectionManager.js";import q from"./Theme.js";import{ToolViewManager as W}from"./ToolViewManager.js";import{GlyphMosaic as A}from"./2d/engine/webgl/GlyphMosaic.js";import{makeDefaultHighlightOptions as P}from"./3d/support/DefaultHighlights.js";import D from"./input/Input.js";import{ViewEvents as U}from"./input/ViewEvents.js";import z from"./interactive/options/ViewOptions.js";import N from"./navigation/Navigation.js";import{deduplicateAttributionItems as G}from"./support/attributionUtils.js";import{DefaultsFromMap as $}from"./support/DefaultsFromMap.js";import{defaultHighlightName as B}from"./support/HighlightDefaults.js";import J from"./support/HighlightOptions.js";import K from"./support/LayerViewManager.js";import Q from"./support/RequiredFieldsOptions.js";import{checkWebAssemblyRequirements as X}from"./support/WebAssemblyRequirements.js";import{checkWebGLRequirements as Y}from"./support/WebGLRequirements.js";var ee;let te=class extends(n(m)){static{ee=this}constructor(e){super(e),this._userSpatialReference=null,this.handles=new l,this.updatingHandles=new S,this.allLayerViews=new s({getCollections:()=>this.layerviewCollections,getChildrenFunction:re}),this.animationsEnabled=!0,this.attributionVisible=!0,this.basemapView=null,this.dependencies={popup:void 0},this.displayFilterEnabled=!0,this.fatalError=null,this.graphics=new x,this.typeSpecificPreconditionsReady=!0,this.layerViews=new r,this.magnifier=new I,this.options=new z,this.padding={left:0,top:0,right:0,bottom:0},this.ready=!1,this._readyStateWaitingTask=null,this.type=null,this.scale=null,this.updating=!1,this.initialExtentRequired=!0,this._lowPriorityCursorHandles=new r,this._highPriorityCursorHandles=new r,this.input=new D,this.navigation=new N,this.layerViewManager=null,this.analysisViewManager=null,this.isHeightModelInfoRequired=!1,this.width=null,this.height=null,this.resizing=!1,this.suspended=!1,this.viewEvents=new U(this),this.requiredFieldsOptions=new Q,this._isValid=!1,this._readyCycleForced=!1,this._lockedSpatialReference=null,this._userTimeZone=null,this._lockedTimeZone=null,this._userTimeExtent=null,this._lockedTimeExtent=null,this._glyphMosaic=null,this.theme=null,this.registeredComponents=new g,this.handles.add(f(()=>this.preconditionsReady,e=>{const t=this.ready;if(e?(this._lockedSpatialReference=this.spatialReference,this._lockedTimeZone=this.timeZone,this._lockedTimeExtent=this.timeExtent,ee.views.add(this)):(this._lockedSpatialReference=null,ee.views.remove(this)),this.notifyChange("spatialReference"),!e&&t)this.toolViewManager?.detach(),this.analysisViewManager?.detach(),this.layerViewManager?.clear(),this._glyphMosaic?.dispose(),this._teardown();else if(e&&!t){try{this._startup()}catch(i){return void queueMicrotask(()=>{this.fatalError=new o("view:startup-error","View._startup failed",i)})}this._glyphMosaic=new A(1024,1024,!0),this.analysisViewManager?.attach(),this.toolViewManager.attach()}},w)),this.analyses=new F}initialize(){this.addResolvingPromise(Promise.all([this.loadAsyncDependencies(),this.validate()]).then(()=>(this._isValid=!0,v(()=>this.ready)))),this.basemapView=new H({view:this}),this.layerViewManager=new K({view:this,layerViewFilter:e=>this.layerViewFilter?.(e)??!0,layerViewImporter:{importLayerView:e=>this.importLayerView(e),hasLayerViewModule:e=>this.hasLayerViewModule(e)},layerviewMapping:this._layerToLayerviewMapping}),this.toolViewManager=new W({view:this}),this.selectionManager=new Z({view:this}),this.addHandles([_(()=>"map-content-error"===this.readyState&&!this.spatialReference,()=>{d.getLogger(this).warn("#spatialReference","no spatial reference could be derived from the currently added map layers")}),f(()=>this.initialExtentRequired,e=>this.defaultsFromMap.required={...this.defaultsFromMap.required,extent:e},M),f(()=>this.ready,e=>{this.defaultsFromMap&&(this.defaultsFromMap.viewReady=e)},w),f(()=>this.defaultsFromMapInputSpatialReference(),e=>{this.defaultsFromMap&&(this.defaultsFromMap.inputSpatialReference=e)},M),f(()=>this.defaultsFromMapInputHeightModelInfo(),e=>{this.defaultsFromMap&&(this.defaultsFromMap.inputHeightModelInfo=e)},M)])}get _layerToLayerviewMapping(){return ee._layerToLayerview}static{this._layerToLayerview=[["view.map.basemap.baseLayers","view.basemapView.baseLayerViews"],["view.map.basemap.groundLayers","view.basemapView.groundLayerViews"],["view.map.basemap.referenceLayers","view.basemapView.referenceLayerViews"],["view.map.layers","view.layerViews"]]}destroy(){this.destroyed||(ee.views.remove(this),this.viewEvents.destroy(),this.allLayerViews.destroy(),this.navigation&&(this.navigation.destroy(),this._set("navigation",null)),this.graphics=y(this.graphics),this.analyses=y(this.analyses),this.defaultsFromMap.destroy(),this._set("defaultsFromMap",null),this.analysisViewManager=y(this.analysisViewManager),this.toolViewManager=y(this.toolViewManager),this.layerViewManager=y(this.layerViewManager),this.selectionManager=y(this.selectionManager),this.basemapView=y(this.basemapView),this.layerViews.destroyAll(),this.invalidate(),this.handles.destroy(),this.map=y(this.map),this.updatingHandles.destroy())}_startup(){this._set("ready",!0)}_teardown(){this._set("ready",!1)}whenReady(){return Promise.resolve(this)}toMap(){return d.getLogger(this).error("#toMap()","Not implemented on this instance of View"),null}get activeTool(){return this.toolViewManager?.activeTool}set activeTool(e){this.toolViewManager&&(this.toolViewManager.activeTool=e)}get layerviewCollections(){return[this.basemapView?.baseLayerViews,this.basemapView?.groundLayerViews,this.layerViews,this.basemapView?.referenceLayerViews]}get analyses(){return this._get("analyses")}set analyses(e){this._set("analyses",e)}get animation(){return this._get("animation")}set animation(e){this._set("animation",e)}get attributionItems(){return this.suspended?[]:G(this._get("attributionItems"),this.getAttributionItems())}get center(){return null}get defaultsFromMapSettings(){return{}}get defaultsFromMap(){return new $({required:{tileInfo:!1,heightModelInfo:!1,extent:!1},map:()=>this.map,getSpatialReferenceSupport:(e,t)=>this.getSpatialReferenceSupport(e,t),...this.defaultsFromMapSettings})}get extent(){return this._get("extent")}set extent(e){this._set("extent",e)}get heightModelInfo(){return this.getDefaultHeightModelInfo()}glyphMosaic(){return this._glyphMosaic}get highlights(){return this._get("highlights")??P()}set highlights(e){this._set("highlights",a(e,this._get("highlights"),r.ofType(J)))}get defaultHighlight(){return this.highlights.find(({name:e})=>e===B)}get interacting(){return this.navigating}get navigating(){return!1}get preconditionsReady(){if(this.destroying||this.destroyed)return!1;const{map:e,spatialReference:t}=this;return!(this.fatalError||!this._isValid||this._readyCycleForced||!e||h(e)&&!e.loaded||0===this.width||0===this.height||!t||!this._validateSpatialReference(t)||!this._lockedSpatialReference&&!this.defaultsFromMap?.ready||!this.typeSpecificPreconditionsReady)}get resolution(){return 0}set map(e){e!==this._get("map")&&(e?.destroyed&&(d.getLogger(this).warn("#map","The provided map is already destroyed",{map:e}),e=null),h(e)&&e.load().catch(()=>{}),this.constructed&&!this.destroyed&&(this.forceReadyCycle(),this._lockedSpatialReference=null),this._set("map",e))}get canZoomIn(){return!!this.ready}get canZoomOut(){return!!this.ready}get readyState(){if(this.destroyed)return this._get("readyState");if(!this.map)return"missing-map";if("container"in this&&!this.container)return"missing-container";if(this.fatalError)return"rendering-error";if((this.defaultsFromMap?.ready??!1)&&!this.spatialReference){const e=!("loaded"in this.map)||this.map.loaded,t=this.map.ground.loaded,r=this.map.basemap?.loaded??!0;return e&&r&&t&&!this.map?.allLayers.length?"empty-map":(this._readyStateWaitingTask||(this._readyStateWaitingTask=i(e=>c(has("view-readyState-waiting-delay"),null,e)),this.addHandles(this._readyStateWaitingTask),this.addHandles(this._readyStateWaitingTask,"ready-state-task")),this._readyStateWaitingTask?.finished?"map-content-error":"loading")}return this._readyStateWaitingTask=u(this._readyStateWaitingTask),this.removeHandles("ready-state-task"),this.ready?"ready":"loading"}get spatialReference(){const{_userSpatialReference:e}=this;if(e&&null!==e.vcsWkid)return e;const t=e??this._lockedSpatialReference??this.getWebDocumentSpatialReference()??this.defaultsFromMap?.spatialReference??null,i=this.defaultsFromMap?.combinedHorizontalAndVerticalSpatialReference;return i?.equals(t)?i:t}set spatialReference(e){const t=!L(e,this._get("spatialReference"));this._set("_userSpatialReference",e),t&&(this._set("spatialReference",e),this._spatialReferenceChanged(this.spatialReference))}_spatialReferenceChanged(e){}getWebDocumentSpatialReference(){return null}defaultsFromMapInputSpatialReference(){return this._userSpatialReference??this.getWebDocumentSpatialReference()??(this.ready?this._lockedSpatialReference:null)}defaultsFromMapInputHeightModelInfo(){return this.map?.heightModelInfo??null}get stationary(){return!this.animation&&!this.navigating&&!this.resizing}get timeExtent(){return this._userTimeExtent??this._lockedTimeExtent??this.getDefaultTimeExtent()??null}set timeExtent(e){this._userTimeExtent=e}get timeZone(){return this._userTimeZone??this._lockedTimeZone??this.getDefaultTimeZone()??C}set timeZone(e){this._userTimeZone=e,k(e)||d.getLogger(this).warn("#timeZone",`the parsed value '${e}' may not be a valid IANA time zone`)}get tools(){return this.toolViewManager?.tools}get initialExtent(){return this.defaultsFromMap?.extent}get cursor(){return this.toolViewManager?.cursor??this._highPriorityCursorHandles.at(-1)?.cursor??this._lowPriorityCursorHandles.at(-1)?.cursor??"default"}acquireCursor(e,t="low"){const i="high"===t?this._highPriorityCursorHandles:this._lowPriorityCursorHandles,r={cursor:e},s=p(()=>i.remove(r));return i.add(r),this.addHandles(s),s}get size(){return[this.width,this.height]}get effectiveTheme(){return this.theme??new q}registerComponent(e){this.registeredComponents.add(e)}unregisterComponent(e){this.registeredComponents.delete(e)}whenLayerView(e){return this.layerViewManager?.whenLayerView(e)??Promise.reject()}getAttributionItems(){return this.allLayerViews.items.flatMap(e=>e.attributionItems)}getDefaultHeightModelInfo(){return(this.map&&"heightModelInfo"in this.map?this.map.heightModelInfo:void 0)??this.defaultsFromMap?.heightModelInfo??null}getDefaultTimeZone(){return null}getDefaultTimeExtent(){return null}getSurface(){return null}importLayerView(e){throw new o("view:importLayerView-missing","importLayerView() not implemented")}hasLayerViewModule(e){return!1}async validate(){const e=Y(this.type);if(e)throw this._displayWebGLError(),d.getLogger(this).warn("#validate()",e.message),e;const t=await X();if(t)throw d.getLogger(this).warn("#validate()",t.message),t}async loadAsyncDependencies(){}invalidate(){this._isValid=!1}getSpatialReferenceSupport(){return{constraints:null}}_validateSpatialReference(e){return null!=this.getSpatialReferenceSupport(e)}when(e,t){return this.isResolved()&&!this.ready&&d.getLogger(this).warn("#when()","Calling view.when() while the view is no longer ready but was already resolved once will resolve immediately. Use reactiveUtils.whenOnce(() => view.ready).then(...) instead."),super.when(e,t)}forceReadyCycle(){this.ready&&(_(()=>this.destroyed||!1===this.preconditionsReady,()=>this._readyCycleForced=!1,{once:!0}),this._readyCycleForced=!0)}on(e,t){return super.on(e,t)}addAndActivateTool(e){this.toolViewManager.tools.add(e),this.activeTool=e}tryFatalErrorRecovery(){this.fatalError=null}static{this.views=new r}_displayWebGLError(){const e=document.createElement("div");e.setAttribute("style","display: flex; flex-direction: column; gap: 8px; padding: 20px; height: 100%; justify-content: center; color: black; background: white; font-family: sans-serif;");const t=document.createElement("div");t.innerHTML="Unable to display map. WebGL2 support is required.",t.setAttribute("style","font-size: 24px; font-weight: bold;");const i=document.createElement("div");i.innerHTML="Ensure that your browser and hardware meet the minimum requirements.",i.setAttribute("style","font-size: 18px;");const r=document.createElement("a");r.innerHTML="https://esriurl.com/webgl-faq",r.target="_blank",r.setAttribute("style","font-size: 18px;"),r.href="https://esriurl.com/webgl-faq",e.appendChild(t),e.appendChild(i),e.appendChild(r);const s=this.getSurface();s&&s.appendChild(e)}};e([V()],te.prototype,"_userSpatialReference",void 0),e([V()],te.prototype,"activeTool",null),e([V({readOnly:!0})],te.prototype,"allLayerViews",void 0),e([V({readOnly:!0})],te.prototype,"layerviewCollections",null),e([V(R(F,"analyses"))],te.prototype,"analyses",null),e([V()],te.prototype,"animation",null),e([V()],te.prototype,"animationsEnabled",void 0),e([V({readOnly:!0})],te.prototype,"attributionItems",null),e([V()],te.prototype,"attributionVisible",void 0),e([V()],te.prototype,"basemapView",void 0),e([V()],te.prototype,"center",null),e([V()],te.prototype,"defaultsFromMapSettings",null),e([V()],te.prototype,"defaultsFromMap",null),e([V()],te.prototype,"dependencies",void 0),e([V()],te.prototype,"displayFilterEnabled",void 0),e([V({type:T})],te.prototype,"extent",null),e([V()],te.prototype,"fatalError",void 0),e([V(R(x,"graphics"))],te.prototype,"graphics",void 0),e([V({readOnly:!0,type:j})],te.prototype,"heightModelInfo",null),e([V({type:r.ofType(J)})],te.prototype,"highlights",null),e([V({readOnly:!0})],te.prototype,"interacting",null),e([V({constructOnly:!0})],te.prototype,"layerViewFilter",void 0),e([V({readOnly:!0})],te.prototype,"navigating",null),e([V({readOnly:!0})],te.prototype,"preconditionsReady",null),e([V({readOnly:!0})],te.prototype,"typeSpecificPreconditionsReady",void 0),e([V({type:r,readOnly:!0})],te.prototype,"layerViews",void 0),e([V()],te.prototype,"resolution",null),e([V({type:I})],te.prototype,"magnifier",void 0),e([V({nonNullable:!0,type:z})],te.prototype,"options",void 0),e([V({value:null,type:t})],te.prototype,"map",null),e([V()],te.prototype,"padding",void 0),e([V({readOnly:!0})],te.prototype,"ready",void 0),e([V({readOnly:!0})],te.prototype,"canZoomIn",null),e([V({readOnly:!0})],te.prototype,"canZoomOut",null),e([V()],te.prototype,"_readyStateWaitingTask",void 0),e([V({readOnly:!0})],te.prototype,"readyState",null),e([V({type:E})],te.prototype,"spatialReference",null),e([V()],te.prototype,"stationary",null),e([V({type:O})],te.prototype,"timeExtent",null),e([V({type:String,nonNullable:!0})],te.prototype,"timeZone",null),e([V()],te.prototype,"tools",null),e([V()],te.prototype,"toolViewManager",void 0),e([V({readOnly:!0})],te.prototype,"type",void 0),e([V({type:Number})],te.prototype,"scale",void 0),e([V({readOnly:!0})],te.prototype,"updating",void 0),e([V({readOnly:!0})],te.prototype,"initialExtentRequired",void 0),e([V({readOnly:!0})],te.prototype,"initialExtent",null),e([V()],te.prototype,"cursor",null),e([V({readOnly:!0})],te.prototype,"input",void 0),e([V({type:N,nonNullable:!0})],te.prototype,"navigation",void 0),e([V()],te.prototype,"layerViewManager",void 0),e([V()],te.prototype,"analysisViewManager",void 0),e([V()],te.prototype,"selectionManager",void 0),e([V()],te.prototype,"width",void 0),e([V()],te.prototype,"height",void 0),e([V({readOnly:!0})],te.prototype,"resizing",void 0),e([V({value:null,readOnly:!0})],te.prototype,"size",null),e([V({readOnly:!0})],te.prototype,"suspended",void 0),e([V({readOnly:!0})],te.prototype,"viewEvents",void 0),e([V()],te.prototype,"_isValid",void 0),e([V()],te.prototype,"_readyCycleForced",void 0),e([V()],te.prototype,"_lockedSpatialReference",void 0),e([V()],te.prototype,"_userTimeZone",void 0),e([V()],te.prototype,"_lockedTimeZone",void 0),e([V()],te.prototype,"_userTimeExtent",void 0),e([V()],te.prototype,"_lockedTimeExtent",void 0),e([V({type:q})],te.prototype,"theme",void 0),e([V({readOnly:!0,type:q})],te.prototype,"effectiveTheme",null),e([V({readOnly:!0})],te.prototype,"registeredComponents",void 0),te=ee=e([b("esri.views.View")],te);const ie=globalThis.$arcgis;function re(e){return e.layerViews}ie&&!ie.views&&Object.defineProperty(ie,"views",{configurable:!1,enumerable:!0,writable:!1,value:te.views});export{te as default};

package/views/analysis/ElevationProfile/ElevationProfileLineGroundComputation.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import{dedupeResult as r}from"../../../core/dedupeResult.js";import{equalsShallow as t}from"../../../core/lang.js";import{watch as o}from"../../../core/reactiveUtils.js";import{getMetersPerVerticalUnitForSR as n}from"../../../core/units.js";import{property as i,subclass as s}from"../../../core/accessorSupport/decorators.js";import{ElevationProfileLineComputation as a}from"./ElevationProfileLineComputation.js";import{getGroundMinDemResolution as l}from"./elevationProfileQuerySourceUtils.js";let u=class extends a{constructor(){super(...arguments),this.type="ground",this.numSamplesForPreview=50,this.numSamplesPerChunk=1e3,this._getStableQueryElevationDependencies=r(()=>({ground:this._ground,groundLayers:this._getStableGroundLayers()}),t),this._getStableGroundLayers=r(()=>this._ground?.layers?.toArray(),t)}get minDemResolution(){return l(this._ground)}get available(){return!0===this._ground?.layers.some(e=>e.visible)||!0===this._groundLayers?.some(e=>e.visible)}initialize(){this.addHandles([o(()=>this._queryElevationDependencies,()=>this.onInvalidate(this)),o(()=>this._ground,e=>{e&&!e.loaded&&e.load().catch(()=>{})},{initial:!0})])}async queryElevation(e,r){const t=this._queryElevationDependencies;if(null==t)throw new Error(`${this.declaredClass}: no dependencies`);const{ground:o}=t;if(null==o)throw new Error("No ground configured in the view");const i=await o.queryElevation(e,r),s=n(e.spatialReference),a=n(o.allLayers.at(0).spatialReference);if(s!==a){const e=i.geometry;e.points=e.points.map(([e,t,o])=>[e,t,o===r.noDataValue?o:o*a/s])}return i}get _queryElevationDependencies(){return this._getStableQueryElevationDependencies()}get _ground(){return this.controller.view?.map?.ground}get _groundLayers(){return this.controller.view?.map?.basemap?.groundLayers}};e([i()],u.prototype,"minDemResolution",null),e([i()],u.prototype,"available",null),e([i()],u.prototype,"_queryElevationDependencies",null),e([i()],u.prototype,"_ground",null),e([i()],u.prototype,"_groundLayers",null),u=e([s("esri.views.analysis.ElevationProfile.ElevationProfileLineGroundComputation")],u);export{u as ElevationProfileLineGroundComputation};
+import{__decorate as e}from"tslib";import{dedupeResult as t}from"../../../core/dedupeResult.js";import{equalsShallow as r}from"../../../core/lang.js";import{watch as o}from"../../../core/reactiveUtils.js";import{getMetersPerVerticalUnitForSR as i}from"../../../core/units.js";import{property as n,subclass as s}from"../../../core/accessorSupport/decorators.js";import{ElevationProfileLineComputation as l}from"./ElevationProfileLineComputation.js";import{getGroundMinDemResolution as a}from"./elevationProfileQuerySourceUtils.js";let u=class extends l{constructor(){super(...arguments),this.type="ground",this.numSamplesForPreview=50,this.numSamplesPerChunk=1e3,this._getStableQueryElevationDependencies=t(()=>({ground:this._ground,groundLayers:this._getStableGroundLayers()}),r),this._getStableGroundLayers=t(()=>this._ground?.allLayers?.toArray(),r)}get minDemResolution(){return a(this._ground)}get available(){return!0===this._ground?.allLayers.some(e=>e.visible)}initialize(){this.addHandles([o(()=>this._queryElevationDependencies,()=>this.onInvalidate(this)),o(()=>this._ground,e=>{e&&!e.loaded&&e.load().catch(()=>{})},{initial:!0})])}async queryElevation(e,t){const r=this._queryElevationDependencies;if(null==r)throw new Error(`${this.declaredClass}: no dependencies`);const{ground:o}=r;if(null==o)throw new Error("No ground configured in the view");const n=await o.queryElevation(e,t),s=i(e.spatialReference),l=i(o.allLayers.at(0).spatialReference);if(s!==l){const e=n.geometry;e.points=e.points.map(([e,r,o])=>[e,r,o===t.noDataValue?o:o*l/s])}return n}get _queryElevationDependencies(){return this._getStableQueryElevationDependencies()}get _ground(){return this.controller.view?.map?.ground}};e([n()],u.prototype,"minDemResolution",null),e([n()],u.prototype,"available",null),e([n()],u.prototype,"_queryElevationDependencies",null),e([n()],u.prototype,"_ground",null),u=e([s("esri.views.analysis.ElevationProfile.ElevationProfileLineGroundComputation")],u);export{u as ElevationProfileLineGroundComputation};

package/views/analysis/ElevationProfile/elevationProfileQuerySourceUtils.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{isSome as n,min as r}from"../../../core/arrayUtils.js";import{getMetersPerUnitForSR as l}from"../../../core/units.js";import{isGround as t}from"../../../support/groundInstanceUtils.js";function u(n){if(null==n)return null;if(t(n))return o(n);const r=n.tileInfo;if(null==r)return null;const u=r.lods?.at(-1);return null==u?null:u.resolution*l(r.spatialReference)}function o(l){if(null==l)return null;const t=l.layers.items.map(e).filter(n);return r(t)??null}function e(n){return n&&"tileInfo"in n?u(n):null}export{o as getGroundMinDemResolution,u as getQuerySourceMinDemResolution};
+import{isSome as n,min as r}from"../../../core/arrayUtils.js";import{getMetersPerUnitForSR as l}from"../../../core/units.js";import{isGround as t}from"../../../support/groundInstanceUtils.js";function u(n){if(null==n)return null;if(t(n))return o(n);const r=n.tileInfo;if(null==r)return null;const u=r.lods?.at(-1);return null==u?null:u.resolution*l(r.spatialReference)}function o(l){if(null==l)return null;const t=l.allLayers.items.map(e).filter(n);return r(t)??null}function e(n){return n&&"tileInfo"in n?u(n):null}export{o as getGroundMinDemResolution,u as getQuerySourceMinDemResolution};

package/views/interactive/options/ViewOptions.d.ts

@@ -0,0 +1,98 @@
+import type Accessor from "../../../core/Accessor.js";
+import type SnappingOptions from "./SnappingOptions.js";
+import type TooltipOptions from "./TooltipOptions.js";
+import type Units from "../support/Units.js";
+import type { SnappingOptionsProperties } from "./SnappingOptions.js";
+import type { TooltipOptionsProperties } from "./TooltipOptions.js";
+import type { UnitsProperties } from "../support/Units.js";
+
+/**
+ * Properties used to configure [ViewOptions](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/).
+ *
+ * @beta
+ * @since 5.2
+ */
+export interface ViewOptionsProperties {
+  /**
+   * Units for displaying measurements, such as lengths, areas, and volumes.
+   *
+   * @since 5.2
+   */
+  displayUnits?: UnitsProperties;
+  /**
+   * Units for interpreting numeric values entered by the user.
+   *
+   * Input units may differ from [displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   *
+   * @since 5.2
+   */
+  inputUnits?: UnitsProperties;
+  /**
+   * Options for snapping to geometry guides and features.
+   *
+   * Snapping is disabled by default in a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and enabled by default in a
+   * [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+   *
+   * @since 5.2
+   */
+  snapping?: SnappingOptionsProperties;
+  /**
+   * Options for tooltips shown while sketching, editing, or placing analyses.
+   *
+   * Tooltips are disabled by default.
+   *
+   * @since 5.2
+   */
+  tooltips?: TooltipOptionsProperties;
+}
+
+/**
+ * Stores snapping, tooltip, and measurement unit options for supported components and analyses configured to inherit these options from the view.
+ * Configure these options through [View.options](https://developers.arcgis.com/javascript/latest/references/core/views/View/#options).
+ *
+ * > [!IMPORTANT]
+ * >
+ * > These options are not saved in a [WebMap](https://developers.arcgis.com/javascript/latest/references/core/WebMap/) or [WebScene](https://developers.arcgis.com/javascript/latest/references/core/WebScene/).
+ *
+ * @beta
+ * @since 5.2
+ */
+export default class ViewOptions extends Accessor {
+  /** @since 5.2 */
+  constructor(properties?: ViewOptionsProperties);
+  /**
+   * Units for displaying measurements, such as lengths, areas, and volumes.
+   *
+   * @since 5.2
+   */
+  get displayUnits(): Units;
+  set displayUnits(value: UnitsProperties);
+  /**
+   * Units for interpreting numeric values entered by the user.
+   *
+   * Input units may differ from [displayUnits](https://developers.arcgis.com/javascript/latest/references/core/views/interactive/options/ViewOptions/#displayUnits).
+   *
+   * @since 5.2
+   */
+  get inputUnits(): Units;
+  set inputUnits(value: UnitsProperties);
+  /**
+   * Options for snapping to geometry guides and features.
+   *
+   * Snapping is disabled by default in a [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and enabled by default in a
+   * [SceneView](https://developers.arcgis.com/javascript/latest/references/core/views/SceneView/).
+   *
+   * @since 5.2
+   */
+  get snapping(): SnappingOptions;
+  set snapping(value: SnappingOptionsProperties);
+  /**
+   * Options for tooltips shown while sketching, editing, or placing analyses.
+   *
+   * Tooltips are disabled by default.
+   *
+   * @since 5.2
+   */
+  get tooltips(): TooltipOptions;
+  set tooltips(value: TooltipOptionsProperties);
+}

package/views/interactive/options/ViewOptions.js

@@ -0,0 +1,2 @@
+/* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
+import{__decorate as o}from"tslib";import t from"../../../core/Accessor.js";import{property as p,subclass as s}from"../../../core/accessorSupport/decorators.js";import i from"./SnappingOptions.js";import n from"./TooltipOptions.js";import e from"../support/Units.js";let r=class extends t{constructor(o){super(o),this.snapping=new i,this.tooltips=new n,this.displayUnits=new e,this.inputUnits=new e}};o([p({nonNullable:!0,type:i})],r.prototype,"snapping",void 0),o([p({nonNullable:!0,type:n})],r.prototype,"tooltips",void 0),o([p({nonNullable:!0,type:e})],r.prototype,"displayUnits",void 0),o([p({nonNullable:!0,type:e})],r.prototype,"inputUnits",void 0),r=o([s("esri.views.interactive.options.ViewOptions")],r);const l=r;export{l as default};

package/views/interactive/support/Units.d.ts

@@ -1,12 +1,14 @@
 import type Accessor from "../../../core/Accessor.js";
-import type { SystemOrAreaUnit, SystemOrLengthUnit } from "../../../core/units.js";
+import type { SystemOrAreaUnit, SystemOrLengthUnit, SystemOrVolumeUnit } from "../../../core/units.js";
 
 /** @since 5.2 */
-export interface UnitsProperties extends Partial<Pick<Units, "area" | "length" | "verticalLength">> {}
+export interface UnitsProperties extends Partial<Pick<Units, "area" | "length" | "verticalLength" | "volume">> {}
 
 /**
  * Units used for displaying or interpreting values in the UI while sketching, editing, or placing analyses.
  *
+ * Each quantity accepts a specific unit or measurement system (`"metric"` or `"imperial"`).
+ *
  * @since 5.2
  */
 export default class Units extends Accessor {
@@ -30,4 +32,10 @@ export default class Units extends Accessor {
    * @since 5.2
    */
   accessor verticalLength: SystemOrLengthUnit | null | undefined;
+  /**
+   * Volume units.
+   *
+   * @since 5.2
+   */
+  accessor volume: SystemOrVolumeUnit | null | undefined;
 }

package/views/interactive/support/Units.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import o from"../../../core/Accessor.js";import{property as r,subclass as e}from"../../../core/accessorSupport/decorators.js";let s=class extends o{constructor(t){super(t),this.length=null,this.verticalLength=null,this.area=null}};t([r()],s.prototype,"length",void 0),t([r()],s.prototype,"verticalLength",void 0),t([r()],s.prototype,"area",void 0),s=t([e("esri.views.interactive.support.Units")],s);const i=s;export{i as default};
+import{__decorate as o}from"tslib";import t from"../../../core/Accessor.js";import{property as r,subclass as e}from"../../../core/accessorSupport/decorators.js";let s=class extends t{constructor(o){super(o)}};o([r()],s.prototype,"length",void 0),o([r()],s.prototype,"verticalLength",void 0),o([r()],s.prototype,"area",void 0),o([r()],s.prototype,"volume",void 0),s=o([e("esri.views.interactive.support.Units")],s);const p=s;export{p as default};

package/views/layers/FeatureLikeLayerView.d.ts

@@ -1,4 +1,3 @@
-import type Graphic from "../../Graphic.js";
 import type AnnotationFeatureLayer from "../../layers/AnnotationFeatureLayer.js";
 import type CSVLayer from "../../layers/CSVLayer.js";
 import type DimensionFeatureLayer from "../../layers/DimensionFeatureLayer.js";
@@ -23,7 +22,7 @@ import type HighlightOptions from "../support/HighlightOptions.js";
 import type { ResourceHandle } from "../../core/Handles.js";
 import type { AbortOptions } from "../../core/promiseUtils.js";
 import type { QueryProperties } from "../../rest/support/Query.js";
-import type { ObjectId } from "../types.js";
+import type { HighlightTarget, ObjectId } from "../types.js";
 import type { LayerViewHighlightOptions } from "./types.js";
 import type { HighlightOptionsProperties } from "../support/HighlightOptions.js";
 import type { FeatureEffectProperties } from "../../layers/support/FeatureEffect.js";
@@ -415,15 +414,20 @@ export default abstract class FeatureLikeLayerView extends LayerView {
    * from the view's [View.highlights](https://developers.arcgis.com/javascript/latest/references/core/views/View/#highlights) collection. If no `name` is provided, the
    * feature will use the `default` highlight options.
    *
+   * The `highlight()` method can highlight features using either a list of graphics or objectIDs, or a [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/).
+   * Graphics and objectIDs highlight the specified features. A [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/) highlights features that match the filter, such as cities with a population
+   * greater than a specified value. As features become available while navigating the map, features that match the specified objectIDs or filter are highlighted.
+   *
    * Release-specific changes:
+   * * As of version 5.2, [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/) can be used as a target to highlight features that match a filter. This option is supported only in 2D, with [2D MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and
+   * the [map component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
    * * As of version 4.32, the `highlight` method accepts an `options` parameter which can be used to provide a [HighlightOptions.name](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/#name)
    * to apply specific [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/).
    * If no `name` is provided, the `default` highlight options will be used.
    * * As of version 4.23, the `highlight()` method was added to [ImageryLayerView.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ImageryLayerView/#highlight),
    *   supported only in a [2D MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
    *
-   * @param target - The feature(s) to highlight. When passing a graphic or an array of graphics, each feature must have a valid `objectID`.
-   * You may alternatively pass one or more objectIDs as a single number, string, or an array of numbers or strings.
+   * @param target - The feature or features to highlight. The highlight target can be a graphic, an array of graphics, one or more objectIDs (provided as a number, string, or array of numbers or strings), or a [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/). If graphics are provided, each feature must have a valid `objectID`.
    * @param options - An additional set of options to customize the highlight behavior.
    * @returns Returns a highlight handler with a `remove()` method that can be called to remove the highlight.
    * @see [View.highlights](https://developers.arcgis.com/javascript/latest/references/core/views/View/#highlights)
@@ -479,8 +483,26 @@ export default abstract class FeatureLikeLayerView extends LayerView {
    *   });
    * });
    * ```
+   * @example
+   * ```js
+   * // Use a spatial FeatureFilter to highlight features within 3 miles of
+   * // the pointer as it moves.
+   * viewElement.addEventListener("arcgisViewPointerMove", ({ detail: { x, y } }) => {
+   *   const mapPoint = viewElement.toMap({ x, y });
+   *
+   *   highlightHandle?.remove();
+   *
+   *   highlightHandle = layerView.highlight(
+   *     new FeatureFilter({
+   *       geometry: mapPoint,
+   *       distance: 3,
+   *       units: "miles",
+   *     }),
+   *   );
+   * });
+   * ```
    */
-  abstract highlight(target: Graphic | Graphic[] | ObjectId | ObjectId[], options?: LayerViewHighlightOptions): ResourceHandle;
+  abstract highlight(target: HighlightTarget, options?: LayerViewHighlightOptions): ResourceHandle;
   /**
    * Executes a [Query](https://developers.arcgis.com/javascript/latest/references/core/rest/support/Query/) against aggregate features (i.e. clusters or bins)
    * available for drawing in the layerView

package/views/layers/GraphicsLayerView.d.ts

@@ -58,15 +58,20 @@ export default abstract class GraphicsLayerView extends LayerView {
    * from the view's [View.highlights](https://developers.arcgis.com/javascript/latest/references/core/views/View/#highlights) collection. If no `name` is provided, the
    * feature will use the `default` highlight options.
    *
+   * The `highlight()` method can highlight features using either a list of graphics or objectIDs, or a [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/).
+   * Graphics and objectIDs highlight the specified features. A [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/) highlights features that match the filter, such as cities with a population
+   * greater than a specified value. As features become available while navigating the map, features that match the specified objectIDs or filter are highlighted.
+   *
    * Release-specific changes:
+   * * As of version 5.2, [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/) can be used as a target to highlight features that match a filter. This option is supported only in 2D, with [2D MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) and
+   * the [map component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
    * * As of version 4.32, the `highlight` method accepts an `options` parameter which can be used to provide a [HighlightOptions.name](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/#name)
    * to apply specific [HighlightOptions](https://developers.arcgis.com/javascript/latest/references/core/views/support/HighlightOptions/).
    * If no `name` is provided, the `default` highlight options will be used.
    * * As of version 4.23, the `highlight()` method was added to [ImageryLayerView.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ImageryLayerView/#highlight),
    *   supported only in a [2D MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/).
    *
-   * @param target - The feature(s) to highlight. When passing a graphic or an array of graphics, each feature must have a valid `objectID`.
-   * You may alternatively pass one or more objectIDs as a single number, string, or an array of numbers or strings.
+   * @param target - The feature or features to highlight. The highlight target can be a graphic, an array of graphics, one or more objectIDs (provided as a number, string, or array of numbers or strings), or a [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/). If graphics are provided, each feature must have a valid `objectID`.
    * @param options - An additional set of options to customize the highlight behavior.
    * @returns Returns a highlight handler with a `remove()` method that can be called to remove the highlight.
    * @see [View.highlights](https://developers.arcgis.com/javascript/latest/references/core/views/View/#highlights)
@@ -122,6 +127,24 @@ export default abstract class GraphicsLayerView extends LayerView {
    *   });
    * });
    * ```
+   * @example
+   * ```js
+   * // Use a spatial FeatureFilter to highlight features within 3 miles of
+   * // the pointer as it moves.
+   * viewElement.addEventListener("arcgisViewPointerMove", ({ detail: { x, y } }) => {
+   *   const mapPoint = viewElement.toMap({ x, y });
+   *
+   *   highlightHandle?.remove();
+   *
+   *   highlightHandle = layerView.highlight(
+   *     new FeatureFilter({
+   *       geometry: mapPoint,
+   *       distance: 3,
+   *       units: "miles",
+   *     }),
+   *   );
+   * });
+   * ```
    */
   abstract highlight(target: Graphic | Graphic[] | ObjectId | ObjectId[], options?: LayerViewHighlightOptions): ResourceHandle;
   /**

package/views/layers/ImageryTileLayerView.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as t}from"tslib";import e from"../../Graphic.js";import r from"../../core/Error.js";import{makeHandle as i}from"../../core/handleUtils.js";import{property as a}from"../../core/accessorSupport/decorators.js";import{isFunctionRaster as s}from"../../layers/raster/datasets/datasetUtils.js";import{getDefaultDatumTransformationForDataset as n,projectDatasetExtent as l,getSourceScale as o}from"../../layers/raster/functions/rasterProjectionHelper.js";import{addMultidimensionalFieldValues as u,commonRasterFieldNames as p,rasterFieldPrefix as c}from"../../layers/support/rasterFieldUtils.js";import{combineTimeExtent as m}from"../../layers/support/timeSupport.js";import y from"./LayerView.js";import{getFetchPopupTemplate as f}from"./support/popupUtils.js";class h extends y{constructor(...t){super(...t),this.layer=null,this.tileInfo=null}get fullExtent(){try{return this.layer.loaded?this._getFullExtent():null}catch{return null}}get timeExtent(){return m(this.layer,this.view?.timeExtent,this._get("timeExtent"))}get hasTilingEffects(){const{renderer:t}=this.layer;return!!("raster-stretch"===t?.type&&t.dynamicRangeAdjustment&&!("min-max"===t.stretchType||"standard-deviation"===t.stretchType))}get datumTransformation(){try{return this.layer.loaded?n(this.layer.fullExtent,this.view.spatialReference,!0):null}catch{return null}}supportsSpatialReference(t){try{return!this.layer.loaded||!!l(this.layer.serviceRasterInfo,t)}catch{return!1}}async fetchPopupFeaturesAtTarget(t,i,a){const{layer:n}=this;if(!i)throw new r("imageryTileLayerView:fetchPopupFeatures","Nothing to fetch without area",{layer:n});const{popupEnabled:l}=n,o=f(n,a);if(!l||null==o)return[];"polygon"===i.type&&(i=i.extent?.center);const m=[],{value:y,magdirValue:h,processedValue:d}=await n.identify(i,{timeExtent:this.timeExtent,signal:a?.signal});let g="";if(y?.length){g="imagery-tile"===n.type&&n.hasStandardTime()&&null!=y[0]?y.map(t=>n.getStandardTimeValue(t)).join(", "):y.join(", ");const t={ObjectId:0};t[p.servicePixelValue]="imagery-tile"===n.type&&s(n.raster)?d?.join(", "):g,t[p.rawServicePixelValue]=g;const r=n.raster?.rasterInfo??n.serviceRasterInfo,i=r?.attributeTable;if(null!=i){const{fields:e,features:r}=i,a=e.find(({name:t})=>"value"===t.toLowerCase()),s=t[p.servicePixelValue],n=a?r.find(t=>String(t.attributes[a.name])===s):null;if(n)for(const i in n.attributes)if(n.attributes.hasOwnProperty(i)){t[c+i]=n.attributes[i]}}const a=r?.dataType;"vector-magdir"!==a&&"vector-uv"!==a||(t[p.magnitude]=h?.[0],t[p.direction]=h?.[1]);const{multidimensionalDefinition:l}=this.layer.normalizeRasterFetchOptions({timeExtent:this.timeExtent});u(n.rasterFields,t,l);const{graphicOrigin:o}=n,f=new e({geometry:this.fullExtent?.clone(),attributes:t,layer:n,origin:o,sourceLayer:n});m.push(f)}return m}highlight(t,e){return i()}async getSourceScale(){return await this.layer.load(),o(this.layer.serviceRasterInfo,this.view.spatialReference)}_getFullExtent(){return l(this.layer.serviceRasterInfo,this.view.spatialReference)}}t([a()],h.prototype,"fullExtent",null),t([a()],h.prototype,"layer",void 0),t([a({readOnly:!0})],h.prototype,"timeExtent",null),t([a()],h.prototype,"tileInfo",void 0),t([a({readOnly:!0})],h.prototype,"hasTilingEffects",null),t([a()],h.prototype,"datumTransformation",null);export{h as default};
+import{__decorate as t}from"tslib";import e from"../../Graphic.js";import r from"../../core/Error.js";import{makeHandle as i}from"../../core/handleUtils.js";import{property as a}from"../../core/accessorSupport/decorators.js";import{isFunctionRaster as s}from"../../layers/raster/datasets/datasetUtils.js";import{getDefaultDatumTransformationForDataset as n,projectDatasetExtent as l,getSourceScale as o}from"../../layers/raster/functions/rasterProjectionHelper.js";import{addMultidimensionalFieldValues as u,commonRasterFieldNames as p,rasterFieldPrefix as c}from"../../layers/support/rasterFieldUtils.js";import{hasTimeOptions as m,combineTimeExtent as f}from"../../layers/support/timeSupport.js";import y from"./LayerView.js";import{getFetchPopupTemplate as h}from"./support/popupUtils.js";class d extends y{constructor(...t){super(...t),this.layer=null,this.tileInfo=null}get fullExtent(){try{return this.layer.loaded?this._getFullExtent():null}catch{return null}}get timeExtent(){return m(this.layer)?f(this.layer,this.view?.timeExtent,this._get("timeExtent")):null}get hasTilingEffects(){const{renderer:t}=this.layer;return!!("raster-stretch"===t?.type&&t.dynamicRangeAdjustment&&!("min-max"===t.stretchType||"standard-deviation"===t.stretchType))}get datumTransformation(){try{return this.layer.loaded?n(this.layer.fullExtent,this.view.spatialReference,!0):null}catch{return null}}supportsSpatialReference(t){try{return!this.layer.loaded||!!l(this.layer.serviceRasterInfo,t)}catch{return!1}}async fetchPopupFeaturesAtTarget(t,i,a){const{layer:n}=this;if(!("popupTemplate"in n))return[];if(!i)throw new r("imageryTileLayerView:fetchPopupFeatures","Nothing to fetch without area",{layer:n});const{popupEnabled:l}=n,o=h(n,a);if(!l||null==o)return[];"polygon"===i.type&&(i=i.extent?.center);const m=[],{value:f,magdirValue:y,processedValue:d}=await n.identify(i,{timeExtent:this.timeExtent,signal:a?.signal});let g="";if(f?.length){g="imagery-tile"===n.type&&n.hasStandardTime()&&null!=f[0]?f.map(t=>n.getStandardTimeValue(t)).join(", "):f.join(", ");const t={ObjectId:0};t[p.servicePixelValue]="imagery-tile"===n.type&&s(n.raster)?d?.join(", "):g,t[p.rawServicePixelValue]=g;const r=n.raster?.rasterInfo??n.serviceRasterInfo,i=r?.attributeTable;if(null!=i){const{fields:e,features:r}=i,a=e.find(({name:t})=>"value"===t.toLowerCase()),s=t[p.servicePixelValue],n=a?r.find(t=>String(t.attributes[a.name])===s):null;if(n)for(const i in n.attributes)if(n.attributes.hasOwnProperty(i)){t[c+i]=n.attributes[i]}}const a=r?.dataType;"vector-magdir"!==a&&"vector-uv"!==a||(t[p.magnitude]=y?.[0],t[p.direction]=y?.[1]);const{multidimensionalDefinition:l}=n.normalizeRasterFetchOptions({timeExtent:this.timeExtent});u(n.rasterFields,t,l);const{graphicOrigin:o}=n,h=new e({geometry:this.fullExtent?.clone(),attributes:t,layer:n,origin:o,sourceLayer:n});m.push(h)}return m}highlight(t,e){return i()}async getSourceScale(){return await this.layer.load(),o(this.layer.serviceRasterInfo,this.view.spatialReference)}_getFullExtent(){return l(this.layer.serviceRasterInfo,this.view.spatialReference)}}t([a()],d.prototype,"fullExtent",null),t([a()],d.prototype,"layer",void 0),t([a({readOnly:!0})],d.prototype,"timeExtent",null),t([a()],d.prototype,"tileInfo",void 0),t([a({readOnly:!0})],d.prototype,"hasTilingEffects",null),t([a()],d.prototype,"datumTransformation",null);export{d as default};

package/views/selection/types.d.ts

@@ -73,7 +73,7 @@ export type SelectorGeometry = Extent | Multipoint | Point | Polygon | Polyline;
  *
  * @since 5.1
  */
-export type SelectionToolName = "lasso" | "rectangle" | "point" | string;
+export type SelectionToolName = "lasso" | "rectangle" | "polygon" | "point" | string;
 
 /**
  * An identifier used to represent a selected feature in a layer. This can either be a [Graphic](https://developers.arcgis.com/javascript/latest/references/core/Graphic/) (for layers with graphics) or an object ID (for layers with object IDs).

package/views/support/DefaultsFromMap.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import t from"../../core/Accessor.js";import{createTask as n}from"../../core/asyncUtils.js";import{abortMaybe as a}from"../../core/maybe.js";import{isAborted as i,isAbortError as r}from"../../core/promiseUtils.js";import{property as l,subclass as s}from"../../core/accessorSupport/decorators.js";import{supportsHeightModelInfo as o,getLayerHeightModelInfo as p,deriveHeightModelInfoFromLayer as u}from"../../geometry/support/heightModelInfoUtils.js";import{projectWithEngineOrService as c}from"./projectionUtils.js";let d=class extends t{constructor(e){super(e),this.required={extent:!1,heightModelInfo:!1,tileInfo:!1},this.defaultSpatialReference=null,this.inputSpatialReference=null,this.sourcePreloadCount=10,this.priorityCollection=null,this.requiresExtentInSpatialReference=!0,this.viewReady=!1,this._projectExtentTask={task:null,input:null,output:null,spatialReference:null}}destroy(){this._projectExtentTask.task&&(this._projectExtentTask.task=a(this._projectExtentTask.task)),this._set("map",null)}get ready(){return!this._spatialReferenceTask.updating&&!this._tileInfoTask.updating&&!this._extentTask.updating}get heightModelInfoReady(){return!this._heightModelInfoTask.updating}get spatialReference(){return this.inputSpatialReference??this._spatialReferenceTask.spatialReference}get extent(){return this._extentTask.extent}get heightModelInfo(){return this._heightModelInfoTask.heightModelInfo}get combinedHorizontalAndVerticalSpatialReference(){return this.heightModelInfoReady?this._heightModelInfoTask.spatialReference:null}get viewingMode(){return null==this.inputSpatialReference||this.inputSpatialReference.equals(this._spatialReferenceTask.spatialReference)?this._spatialReferenceTask.viewingMode??null:null}get tileInfo(){return this._tileInfoTask.tileInfo}get mapCollections(){const e=this.map?.(),t=[];return null!=this.priorityCollection&&t.push(this.priorityCollection),t.push({parent:e?.basemap,layers:e?.basemap?.baseLayers},{parent:e?.basemap,layers:e?.basemap?.groundLayers},{layers:e?.layers},{parent:e?.ground,layers:e?.ground?.layers},{parent:e?.basemap,layers:e?.basemap?.referenceLayers}),t}get _spatialReferenceTask(){if(this.viewReady)return this._get("_spatialReferenceTask")??{updating:!1};const{spatialReference:e,viewingMode:t,updating:n}=this._combinedSpatialReferenceTask(null,!1);return{spatialReference:e,viewingMode:t,updating:n}}get _heightModelInfoTask(){if(!this.required.heightModelInfo)return{updating:!1};const e=this.viewReady?this._get("_heightModelInfoTask"):null;return e&&!e.updating&&e.heightModelInfo?e:this._combinedSpatialReferenceTask(this.inputSpatialReference,!0)}_combinedSpatialReferenceTask(e,t){let n=e?[new f(e,null,null)]:null;const a=()=>1===n?.length&&(!t||null!=n[0].heightModelInfo);if(this._collectLayers(this.mapCollections,e=>{const t=this._getSupportedSpatialReferences(e);if(t.length>0){const e=this._narrowDownSpatialReferenceCandidates(n,t);null!=e&&(n=e)}return!!a()})&&!a())return{updating:!0};const i=this._pickSpatialReferenceCandidate(n);return{heightModelInfo:i?.heightModelInfo??null,spatialReference:i?.spatialReference??null,viewingMode:i?.viewingMode??null,updating:!1}}get _tileInfoTask(){if(!this.required.tileInfo)return this._get("_tileInfoTask")??{updating:!1};const e=this.map?.(),t=this.spatialReference;if(!t)return{updating:this._spatialReferenceTask.updating};let n;const a=this._collectLayers([{parent:e?.basemap,layers:e?.basemap?.baseLayers},{parent:e?.basemap,layers:e?.basemap?.groundLayers},{layers:e?.layers}],e=>!(!("tileInfo"in e)||!e.tileInfo?.spatialReference.equals(t))&&(n=e,!0),e=>"tileInfo"in e);if(n){return{tileInfo:n.tileInfo,updating:!1}}return{updating:a}}get _extentCandidatesTask(){if(this.viewReady||!this.required.extent)return this._get("_extentCandidatesTask")??{updating:!1};if(!this.spatialReference)return{updating:this._spatialReferenceTask.updating};const e=[],t=this._collectLayers(this.mapCollections,t=>{const n="fullExtents"in t&&t.fullExtents||(null!=t.fullExtent?[t.fullExtent]:[]),a=this.requiresExtentInSpatialReference?null:n[0],i=n.find(e=>e.spatialReference.equals(this.spatialReference))??a;if(i)return e.push({extent:i,layer:t}),!0;if(this._getSupportedSpatialReferences(t).length>0)for(const r of n)e.push({extent:r,layer:t});return!1});return{candidates:e,updating:t}}get _extentTask(){const{candidates:e,updating:t}=this._extentCandidatesTask;if(t)return{updating:t};if(null==e||0===e.length)return{updating:!1};if(!this.spatialReference)return{updating:this._spatialReferenceTask.updating};const r=this._pickExtentCandidate(e),l=this.spatialReference;return r.extent.equals(this._projectExtentTask.input)&&l.equals(this._projectExtentTask.spatialReference)?{extent:this._projectExtentTask.output,updating:null!=this._projectExtentTask.task&&!this._projectExtentTask.task.finished}:(null!=this._projectExtentTask.task&&(this._projectExtentTask.task=a(this._projectExtentTask.task)),this._projectExtentTask={input:r.extent.clone(),output:null,spatialReference:l.clone(),task:n(async e=>{try{const t=await c(r.extent,l,"portalItem"in r.layer?r.layer.portalItem:void 0,e);this._projectExtentTask={...this._projectExtentTask,task:null,output:t}}catch(t){if(i(e))return;this._projectExtentTask={...this._projectExtentTask,task:null}}})},{updating:!0})}_narrowDownSpatialReferenceCandidates(e,t){if(null==e)return t;const n=new Array;for(const a of e)for(const e of t){if(!a.spatialReference.equals(e.spatialReference))continue;const t=g(a.viewingMode,e.viewingMode);if(!1!==t){const i=e.heightModelInfo&&!a.heightModelInfo;n.push(new f(i?e.spatialReference:a.spatialReference,i?e.heightModelInfo:a.heightModelInfo,t));break}}return n.length>0?n:null}_pickSpatialReferenceCandidate(e){const t=this.defaultSpatialReference;if(!e?.length)return t?{heightModelInfo:null,spatialReference:t,viewingMode:null}:null;return(e.length>1&&t?e.find(({spatialReference:e})=>e.equals(t)):null)??e[0]}_getSupportedSpatialReferences(e){const t="supportedSpatialReferences"in e&&e.supportedSpatialReferences||(e.spatialReference?[e.spatialReference]:[]);if(0===t.length)return[];const n=this.required.heightModelInfo&&o(e),a=p(e),i=[];for(const r of t){const t=this.getSpatialReferenceSupport(r,e);if(null!=t){const l=t.constraints??[{spatialReference:r,viewingMode:null}];for(const{spatialReference:t,viewingMode:r}of l)if(!this.requiresExtentInSpatialReference||(this.inputSpatialReference?.equals(t)??!0)){const l=n?a??u(e,t):null;i.push(new f(t,l,r))}}}return i}_pickExtentCandidate(e){const t=this.spatialReference;return e.find(({extent:e})=>t.equals(e.spatialReference))||e[0]}_collectLayers(e,t,n=()=>!0){switch(this._loadMaybe(this.map?.())){case"loading":return!0;case"failed":return!1}const a=new h(n,t);for(const i of e)if(this._collectCollection(i,a),a.done||a.preloading===this.sourcePreloadCount)break;return a.updating}_collectCollection(e,t){if(e.layers){switch(this._loadMaybe(e.parent)){case"loading":return t.updating=!0,void++t.preloading;case"failed":return}for(const n of e.layers)if(("graphics"!==n.type||!n.internal)&&t.layerFilter(n)){switch(this._loadMaybe(n)){case"failed":continue;case"loading":t.updating=!0,++t.preloading;break;case"loaded":if(t.updating||(t.done=t.pushLayer(n)),t.done||t.preloading===this.sourcePreloadCount)break;"layers"in n&&this._collectCollection({layers:n.layers},t)}if(t.done||t.preloading===this.sourcePreloadCount)break}}}_loadMaybe(e){return e&&"loadStatus"in e&&null!=e.loadStatus?"not-loaded"===e.loadStatus?(e.load().catch(e=>{r(e)}),"loading"):e.loadStatus:"loaded"}};e([l()],d.prototype,"required",void 0),e([l({constructOnly:!0})],d.prototype,"map",void 0),e([l({constructOnly:!0})],d.prototype,"getSpatialReferenceSupport",void 0),e([l()],d.prototype,"defaultSpatialReference",void 0),e([l()],d.prototype,"inputSpatialReference",void 0),e([l()],d.prototype,"sourcePreloadCount",void 0),e([l()],d.prototype,"priorityCollection",void 0),e([l()],d.prototype,"requiresExtentInSpatialReference",void 0),e([l()],d.prototype,"viewReady",void 0),e([l({readOnly:!0})],d.prototype,"ready",null),e([l({readOnly:!0})],d.prototype,"heightModelInfoReady",null),e([l({readOnly:!0})],d.prototype,"spatialReference",null),e([l({readOnly:!0})],d.prototype,"extent",null),e([l({readOnly:!0})],d.prototype,"heightModelInfo",null),e([l({readOnly:!0})],d.prototype,"combinedHorizontalAndVerticalSpatialReference",null),e([l({readOnly:!0})],d.prototype,"viewingMode",null),e([l({readOnly:!0})],d.prototype,"tileInfo",null),e([l({readOnly:!0})],d.prototype,"mapCollections",null),e([l({readOnly:!0})],d.prototype,"_spatialReferenceTask",null),e([l({readOnly:!0})],d.prototype,"_heightModelInfoTask",null),e([l({readOnly:!0})],d.prototype,"_tileInfoTask",null),e([l({readOnly:!0})],d.prototype,"_extentCandidatesTask",null),e([l()],d.prototype,"_extentTask",null),e([l()],d.prototype,"_projectExtentTask",void 0),d=e([s("esri.views.support.DefaultsFromMap")],d);class f{constructor(e,t,n){this.spatialReference=e,this.heightModelInfo=t,this.viewingMode=n}}class h{constructor(e,t){this.layerFilter=e,this.pushLayer=t,this.preloading=-1,this.updating=!1,this.done=!1}}function g(e,t){return null!=e?null!=t?e===t&&e:e:t}export{d as DefaultsFromMap};
+import{__decorate as e}from"tslib";import t from"../../core/Accessor.js";import{createTask as n}from"../../core/asyncUtils.js";import{abortMaybe as a}from"../../core/maybe.js";import{isAborted as i,isAbortError as r}from"../../core/promiseUtils.js";import{property as l,subclass as s}from"../../core/accessorSupport/decorators.js";import{isCompatible as o,supportsHeightModelInfo as p,getLayerHeightModelInfo as u,deriveHeightModelInfoFromLayer as c}from"../../geometry/support/heightModelInfoUtils.js";import{projectWithEngineOrService as d}from"./projectionUtils.js";let f=class extends t{constructor(e){super(e),this.required={extent:!1,heightModelInfo:!1,tileInfo:!1},this.defaultSpatialReference=null,this.inputSpatialReference=null,this.inputHeightModelInfo=null,this.sourcePreloadCount=10,this.priorityCollection=null,this.requiresExtentInSpatialReference=!0,this.viewReady=!1,this._projectExtentTask={task:null,input:null,output:null,spatialReference:null}}destroy(){this._projectExtentTask.task&&(this._projectExtentTask.task=a(this._projectExtentTask.task)),this._set("map",null)}get ready(){return!this._spatialReferenceTask.updating&&!this._tileInfoTask.updating&&!this._extentTask.updating}get heightModelInfoReady(){return!this._heightModelInfoTask.updating}get spatialReference(){return this.inputSpatialReference??this._spatialReferenceTask.spatialReference}get extent(){return this._extentTask.extent}get heightModelInfo(){return this._heightModelInfoTask.heightModelInfo}get combinedHorizontalAndVerticalSpatialReference(){return this.heightModelInfoReady?this._heightModelInfoTask.spatialReference:null}get viewingMode(){return null==this.inputSpatialReference||this.inputSpatialReference.equals(this._spatialReferenceTask.spatialReference)?this._spatialReferenceTask.viewingMode??null:null}get tileInfo(){return this._tileInfoTask.tileInfo}get mapCollections(){const e=this.map?.(),t=[];return null!=this.priorityCollection&&t.push(this.priorityCollection),t.push({parent:e?.basemap,layers:e?.basemap?.baseLayers},{parent:e?.basemap,layers:e?.basemap?.groundLayers},{layers:e?.layers},{parent:e?.ground,layers:e?.ground?.layers},{parent:e?.basemap,layers:e?.basemap?.referenceLayers}),t}get _spatialReferenceTask(){if(this.viewReady)return this._get("_spatialReferenceTask")??{updating:!1};const{spatialReference:e,viewingMode:t,updating:n}=this._combinedSpatialReferenceTask(!1);return{spatialReference:e,viewingMode:t,updating:n}}get _heightModelInfoTask(){if(!this.required.heightModelInfo)return{updating:!1};const e=this.viewReady?this._get("_heightModelInfoTask"):null;return e&&!e.updating&&e.heightModelInfo?e:this._combinedSpatialReferenceTask(!0)}_combinedSpatialReferenceTask(e){let t=null;const n=()=>1===t?.length&&(!e||null!=t[0].heightModelInfo);if(this._collectLayers(this.mapCollections,a=>{const i=this._getSupportedSpatialReferences(a,e);if(i.length>0){const e=this._narrowDownSpatialReferenceCandidates(t,i);null!=e&&(t=e)}return!!n()})&&!n())return{updating:!0};const a=this._pickSpatialReferenceCandidate(t);return{heightModelInfo:a?.heightModelInfo??null,spatialReference:a?.spatialReference??null,viewingMode:a?.viewingMode??null,updating:!1}}get _tileInfoTask(){if(!this.required.tileInfo)return this._get("_tileInfoTask")??{updating:!1};const e=this.map?.(),t=this.spatialReference;if(!t)return{updating:this._spatialReferenceTask.updating};let n;const a=this._collectLayers([{parent:e?.basemap,layers:e?.basemap?.baseLayers},{parent:e?.basemap,layers:e?.basemap?.groundLayers},{layers:e?.layers}],e=>!(!("tileInfo"in e)||!e.tileInfo?.spatialReference.equals(t))&&(n=e,!0),e=>"tileInfo"in e);if(n){return{tileInfo:n.tileInfo,updating:!1}}return{updating:a}}get _extentCandidatesTask(){if(this.viewReady||!this.required.extent)return this._get("_extentCandidatesTask")??{updating:!1};if(!this.spatialReference)return{updating:this._spatialReferenceTask.updating};const e=[],t=this._collectLayers(this.mapCollections,t=>{const n="fullExtents"in t&&t.fullExtents||(null!=t.fullExtent?[t.fullExtent]:[]),a=this.requiresExtentInSpatialReference?null:n[0],i=n.find(e=>e.spatialReference.equals(this.spatialReference))??a;if(i)return e.push({extent:i,layer:t}),!0;if(this._getSupportedSpatialReferences(t).length>0)for(const r of n)e.push({extent:r,layer:t});return!1});return{candidates:e,updating:t}}get _extentTask(){const{candidates:e,updating:t}=this._extentCandidatesTask;if(t)return{updating:t};if(null==e||0===e.length)return{updating:!1};if(!this.spatialReference)return{updating:this._spatialReferenceTask.updating};const r=this._pickExtentCandidate(e),l=this.spatialReference;return r.extent.equals(this._projectExtentTask.input)&&l.equals(this._projectExtentTask.spatialReference)?{extent:this._projectExtentTask.output,updating:null!=this._projectExtentTask.task&&!this._projectExtentTask.task.finished}:(null!=this._projectExtentTask.task&&(this._projectExtentTask.task=a(this._projectExtentTask.task)),this._projectExtentTask={input:r.extent.clone(),output:null,spatialReference:l.clone(),task:n(async e=>{try{const t=await d(r.extent,l,"portalItem"in r.layer?r.layer.portalItem:void 0,e);this._projectExtentTask={...this._projectExtentTask,task:null,output:t}}catch(t){if(i(e))return;this._projectExtentTask={...this._projectExtentTask,task:null}}})},{updating:!0})}_narrowDownSpatialReferenceCandidates(e,t){if(null==e)return t;const n=new Array;for(const a of e)for(const e of t){const t=y(a.viewingMode,e.viewingMode);if(a.spatialReference&&!a.spatialReference.equals(e.spatialReference)||0!==o(a.heightModelInfo,e.heightModelInfo,!0)||!1===t)continue;const i=e.heightModelInfo&&!a.heightModelInfo||!a.spatialReference;n.push(new h(i?e.spatialReference:a.spatialReference,i?e.heightModelInfo:a.heightModelInfo,t));break}return n.length>0?n:null}_pickSpatialReferenceCandidate(e){const t=this.defaultSpatialReference;if(!e?.length)return t?{heightModelInfo:null,spatialReference:t,viewingMode:null}:null;return(e.length>1&&t?e.find(({spatialReference:e})=>e?.equals(t)):null)??e[0]}_getSupportedSpatialReferences(e,t=!1){const n="supportedSpatialReferences"in e&&e.supportedSpatialReferences||(e.spatialReference?[e.spatialReference]:[]);if(0===n.length)return[];const a=t?this.inputHeightModelInfo:null,i=t&&p(e),r=i?u(e):null,l=[];for(const s of n){const t=this.getSpatialReferenceSupport(s,e);if(null==t)continue;const n=t.constraints??[{spatialReference:s,viewingMode:null}];for(const{spatialReference:s,viewingMode:p}of n){if(this.requiresExtentInSpatialReference&&!(this.inputSpatialReference?.equals(s)??!0))continue;const t=r??(i?c(e,s):null);0===o(a,t,!0)&&l.push(new h(s,t,p))}}return l}_pickExtentCandidate(e){const t=this.spatialReference;return e.find(({extent:e})=>t.equals(e.spatialReference))||e[0]}_collectLayers(e,t,n=()=>!0){switch(this._loadMaybe(this.map?.())){case"loading":return!0;case"failed":return!1}const a=new g(n,t);for(const i of e)if(this._collectCollection(i,a),a.done||a.preloading===this.sourcePreloadCount)break;return a.updating}_collectCollection(e,t){if(e.layers){switch(this._loadMaybe(e.parent)){case"loading":return t.updating=!0,void++t.preloading;case"failed":return}for(const n of e.layers)if(("graphics"!==n.type||!n.internal)&&t.layerFilter(n)){switch(this._loadMaybe(n)){case"failed":continue;case"loading":t.updating=!0,++t.preloading;break;case"loaded":if(t.updating||(t.done=t.pushLayer(n)),t.done||t.preloading===this.sourcePreloadCount)break;"layers"in n&&this._collectCollection({layers:n.layers},t)}if(t.done||t.preloading===this.sourcePreloadCount)break}}}_loadMaybe(e){return e&&"loadStatus"in e&&null!=e.loadStatus?"not-loaded"===e.loadStatus?(e.load().catch(e=>{r(e)}),"loading"):e.loadStatus:"loaded"}};e([l()],f.prototype,"required",void 0),e([l({constructOnly:!0})],f.prototype,"map",void 0),e([l({constructOnly:!0})],f.prototype,"getSpatialReferenceSupport",void 0),e([l()],f.prototype,"defaultSpatialReference",void 0),e([l()],f.prototype,"inputSpatialReference",void 0),e([l()],f.prototype,"inputHeightModelInfo",void 0),e([l()],f.prototype,"sourcePreloadCount",void 0),e([l()],f.prototype,"priorityCollection",void 0),e([l()],f.prototype,"requiresExtentInSpatialReference",void 0),e([l()],f.prototype,"viewReady",void 0),e([l({readOnly:!0})],f.prototype,"ready",null),e([l({readOnly:!0})],f.prototype,"heightModelInfoReady",null),e([l({readOnly:!0})],f.prototype,"spatialReference",null),e([l({readOnly:!0})],f.prototype,"extent",null),e([l({readOnly:!0})],f.prototype,"heightModelInfo",null),e([l({readOnly:!0})],f.prototype,"combinedHorizontalAndVerticalSpatialReference",null),e([l({readOnly:!0})],f.prototype,"viewingMode",null),e([l({readOnly:!0})],f.prototype,"tileInfo",null),e([l({readOnly:!0})],f.prototype,"mapCollections",null),e([l({readOnly:!0})],f.prototype,"_spatialReferenceTask",null),e([l({readOnly:!0})],f.prototype,"_heightModelInfoTask",null),e([l({readOnly:!0})],f.prototype,"_tileInfoTask",null),e([l({readOnly:!0})],f.prototype,"_extentCandidatesTask",null),e([l()],f.prototype,"_extentTask",null),e([l()],f.prototype,"_projectExtentTask",void 0),f=e([s("esri.views.support.DefaultsFromMap")],f);class h{constructor(e,t,n){this.spatialReference=e,this.heightModelInfo=t,this.viewingMode=n}}class g{constructor(e,t){this.layerFilter=e,this.pushLayer=t,this.preloading=-1,this.updating=!1,this.done=!1}}function y(e,t){return null!=e?null!=t?e===t&&e:e:t}export{f as DefaultsFromMap};

package/views/types.d.ts

@@ -20,6 +20,7 @@ import type Layer from "../layers/Layer.js";
 import type MediaLayer from "../layers/MediaLayer.js";
 import type RouteLayer from "../layers/RouteLayer.js";
 import type BuildingSublayer from "../layers/buildingSublayers/BuildingSublayer.js";
+import type FeatureFilter from "../layers/support/FeatureFilter.js";
 import type SubtypeSublayer from "../layers/support/SubtypeSublayer.js";
 import type { ReadonlyArrayOrCollection } from "../core/Collection.js";
 import type { AbortOptions } from "../core/promiseUtils.js";
@@ -40,13 +41,18 @@ import type { ViewEventTypes } from "./input/types.js";
 export type ObjectId = number | string;
 
 /**
- * The feature(s) to highlight when calling [highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLikeLayerView/#highlight) method on a LayerView instance. When passing a graphic or array of graphics,
- * each feature must have a valid `objectId`.
+ * The feature(s) to highlight when calling [highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLikeLayerView/#highlight) method on a LayerView instance. When passing a graphic or an array of graphics,
+ * each feature must have a valid `objectID`. You may alternatively pass one or more objectIDs as a single number, string, or an array of numbers or strings.
+ * As of version 5.2,  a [FeatureFilter](https://developers.arcgis.com/javascript/latest/references/core/layers/support/FeatureFilter/) can be passed as the highlight target when calling `highlight` method in [MapView](https://developers.arcgis.com/javascript/latest/references/core/views/MapView/) or in
+ * [map component](https://developers.arcgis.com/javascript/latest/references/map-components/components/arcgis-map/).
  *
  * @see [FeatureLikeLayerView.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/FeatureLikeLayerView/#highlight)
+ * @see [ImageryLayerView.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ImageryLayerView/#highlight)
+ * @see [BuildingSceneLayerView.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/BuildingSceneLayerView/#highlight)
+ * @see [PointCloudLayerViewMixin.highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/PointCloudLayerView/#highlight)
  * @since 5.0
  */
-export type HighlightTarget = Graphic | Graphic[] | Collection<Graphic>;
+export type HighlightTarget = Graphic | Graphic[] | Collection<Graphic> | ObjectId | ObjectId[] | FeatureFilter;
 
 /**
  * The pixels in a single band to highlight when calling [highlight()](https://developers.arcgis.com/javascript/latest/references/core/views/layers/ImageryLayerView/#highlight) method on

package/widgets/ElevationProfile/ElevationProfileLineGround.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import o from"../../Color.js";import{handlesGroup as r}from"../../core/handleUtils.js";import{memoize as t}from"../../core/memoize.js";import{watch as n}from"../../core/reactiveUtils.js";import{getMetersPerVerticalUnitForSR as i}from"../../core/units.js";import{property as s,subclass as l}from"../../core/accessorSupport/decorators.js";import a from"./ElevationProfileLine.js";import{getGroundMinDemResolution as u}from"./support/elevationQuerySourceUtils.js";let p=class extends a{constructor(e){super(e),this.type="ground",this.color=new o("#ff7f00"),this.viewVisualizationEnabled=!0,this.numSamplesForPreview=50,this.numSamplesPerChunk=1e3,this._getQueryElevationDependencies=t((e,o)=>({ground:e,groundLayers:o}))}get available(){const e=this._ground;return null!=e&&e.layers.some(e=>e.visible)}get minDemResolution(){return u(this._ground)}get _queryElevationDependencies(){return this._getQueryElevationDependencies(this._ground,this._groundLayers)}get _ground(){return this._viewModel?.view?.map?.ground}get _groundLayers(){return this._ground?.layers?.toArray()??[]}async queryElevation(e,o){const r=this._queryElevationDependencies;if(null==r)throw new Error("ElevationProfileLineGround: no dependencies");const{ground:t}=r;if(null==t)throw new Error("No ground configured in the view");const n=await t.queryElevation(e,o),s=i(e.spatialReference),l=i(t.layers.at(0).spatialReference);if(s!==l){const e=n.geometry;e.points=e.points.map(([e,r,t])=>[e,r,t===o.noDataValue?t:t*l/s])}return n}attach(e){return r([super.attach(e),n(()=>this._queryElevationDependencies,()=>this._onChange())])}};e([s({type:o,nonNullable:!0})],p.prototype,"color",void 0),e([s()],p.prototype,"viewVisualizationEnabled",void 0),e([s()],p.prototype,"available",null),e([s({readOnly:!0})],p.prototype,"minDemResolution",null),e([s()],p.prototype,"_queryElevationDependencies",null),e([s()],p.prototype,"_ground",null),e([s()],p.prototype,"_groundLayers",null),p=e([l("esri.widgets.ElevationProfile.ElevationProfileLineGround")],p);const d=p;export{d as default};
+import{__decorate as e}from"tslib";import o from"../../Color.js";import{handlesGroup as r}from"../../core/handleUtils.js";import{memoize as t}from"../../core/memoize.js";import{watch as n}from"../../core/reactiveUtils.js";import{getMetersPerVerticalUnitForSR as i}from"../../core/units.js";import{property as s,subclass as l}from"../../core/accessorSupport/decorators.js";import a from"./ElevationProfileLine.js";import{getGroundMinDemResolution as u}from"./support/elevationQuerySourceUtils.js";let p=class extends a{constructor(e){super(e),this.type="ground",this.color=new o("#ff7f00"),this.viewVisualizationEnabled=!0,this.numSamplesForPreview=50,this.numSamplesPerChunk=1e3,this._getQueryElevationDependencies=t((e,o)=>({ground:e,groundLayers:o}))}get available(){const e=this._ground;return null!=e&&e.allLayers.some(e=>e.visible)}get minDemResolution(){return u(this._ground)}get _queryElevationDependencies(){return this._getQueryElevationDependencies(this._ground,this._groundLayers)}get _ground(){return this._viewModel?.view?.map?.ground}get _groundLayers(){return this._ground?.allLayers?.toArray()??[]}async queryElevation(e,o){const r=this._queryElevationDependencies;if(null==r)throw new Error("ElevationProfileLineGround: no dependencies");const{ground:t}=r;if(null==t)throw new Error("No ground configured in the view");const n=await t.queryElevation(e,o),s=i(e.spatialReference),l=i(t.layers.at(0).spatialReference);if(s!==l){const e=n.geometry;e.points=e.points.map(([e,r,t])=>[e,r,t===o.noDataValue?t:t*l/s])}return n}attach(e){return r([super.attach(e),n(()=>this._queryElevationDependencies,()=>this._onChange())])}};e([s({type:o,nonNullable:!0})],p.prototype,"color",void 0),e([s()],p.prototype,"viewVisualizationEnabled",void 0),e([s()],p.prototype,"available",null),e([s({readOnly:!0})],p.prototype,"minDemResolution",null),e([s()],p.prototype,"_queryElevationDependencies",null),e([s()],p.prototype,"_ground",null),e([s()],p.prototype,"_groundLayers",null),p=e([l("esri.widgets.ElevationProfile.ElevationProfileLineGround")],p);const d=p;export{d as default};

package/widgets/support/SelectionToolbar/SelectionToolbarViewModel.d.ts

@@ -5,7 +5,7 @@ import type { SelectableViewUnion, SelectionOperationEvents, SelectionOperationT
 import type { SelectionToolConfig, SelectionToolOptions, SelectionToolbarState } from "./types.js";
 
 /** @internal */
-export interface SelectionToolbarViewModelProperties extends Partial<Pick<SelectionToolbarViewModel, "continuousSelectionEnabled" | "defaultLassoToolOptions" | "defaultOperationType" | "defaultPointToolOptions" | "defaultRectangleToolOptions" | "layerViewPreferenceEnabled" | "persistSelection" | "returnFeatureTitleFields" | "returnGeometry" | "selectionManager" | "selectOnComplete" | "sources" | "toolConfigs" | "view">> {}
+export interface SelectionToolbarViewModelProperties extends Partial<Pick<SelectionToolbarViewModel, "continuousSelectionEnabled" | "defaultLassoToolOptions" | "defaultOperationType" | "defaultPointToolOptions" | "defaultPolygonToolOptions" | "defaultRectangleToolOptions" | "layerViewPreferenceEnabled" | "persistSelection" | "returnFeatureTitleFields" | "returnGeometry" | "selectionManager" | "selectOnComplete" | "sources" | "toolConfigs" | "view">> {}
 
 /**
  * Events emitted by SelectionToolbarViewModel.
@@ -22,7 +22,7 @@ export interface SelectionToolbarViewModelEvents {
 }
 
 /**
- * Manages interactive selection operations for rectangle, lasso, and custom selection tools.
+ * Manages interactive selection operations for various selection tools.
  *
  * @internal
  */
@@ -55,6 +55,12 @@ export default class SelectionToolbarViewModel extends EventedAccessor {
    * @internal
    */
   accessor defaultPointToolOptions: SelectionToolOptions;
+  /**
+   * Default configuration for the polygon tool.
+   *
+   * @internal
+   */
+  accessor defaultPolygonToolOptions: SelectionToolOptions;
   /**
    * Default configuration for the rectangle tool.
    *

package/widgets/support/SelectionToolbar/SelectionToolbarViewModel.js

@@ -1,2 +1,2 @@
 /* COPYRIGHT Esri - https://js.arcgis.com/5.2/LICENSE.txt */
-import{__decorate as e}from"tslib";import{deprecatedProperty as t}from"../../../core/deprecate.js";import{EventedAccessor as o}from"../../../core/Evented.js";import{handlesGroup as i}from"../../../core/handleUtils.js";import s from"../../../core/Logger.js";import{removeMaybe as r}from"../../../core/maybe.js";import{watch as a}from"../../../core/reactiveUtils.js";import{property as n,subclass as l}from"../../../core/accessorSupport/decorators.js";import{isKnowledgeGraphLayer as c,isLinkChartLayer as p}from"../../../layers/support/layerUtils.js";import{findLayerView as d}from"../../../views/draw/support/layerUtils.js";import u from"../../../views/selection/SelectionOperation.js";import{isSelectableLayerView2D as h}from"../../../views/support/layerViewUtils.js";import{isSelectableLayerView as v,isTableLayer as f}from"../../../views/support/selectionUtils.js";let y=class extends o{constructor(e){super(e),this._operationHandlesGroup=null,this.activeOperation=null,this.continuousSelectionEnabled=!1,this.defaultLassoToolOptions={createTool:"polygon",mode:"hybrid",toolName:"lasso"},this.defaultOperationType="add",this.defaultPointToolOptions={createTool:"point",toolName:"point"},this.defaultRectangleToolOptions={createTool:"rectangle",toolName:"rectangle"},this.layerViewPreferenceEnabled=!0,this.persistSelection=!0,this.selectionManager=null,this.returnFeatureTitleFields=!1,this.returnGeometry=!0,this.selectOnComplete=!0,this.sources=null,this.toolConfigs=[]}initialize(){this.addHandles([a(()=>this.effectiveSources,e=>{this.activeOperation&&(this.activeOperation.sources=e)}),a(()=>this.defaultOperationType,e=>{this.activeOperation&&(this.activeOperation.type=e)})])}destroy(){this.activeOperation?.cancel(),this.activeOperation?.destroy(),this._operationHandlesGroup=r(this._operationHandlesGroup)}get effectiveSelectionManager(){return this.selectionManager??this.view?.selectionManager}get effectiveSources(){const{layerViewPreferenceEnabled:e,sources:t,view:o}=this,i=t??this.effectiveSelectionManager?.sources;if(!i?.length)return[];const s=new Set,r="3d"===o?.type?v:h;return i.forEach(t=>{if(!f(t,o))if(r(t))s.add(t);else if(c(t)||p(t)){(t.layers||[]).forEach(t=>{const i=o?d(o,t):void 0,a=e&&r(i)?i:t;s.add(a)})}else if(e){const e=o?d(o,t):void 0;s.add(r(e)?e:t)}else s.add(t)}),Array.from(s)}get layers(){return t(s.getLogger(this),"layers",{replacement:"Use SelectionToolbar.sources instead."}),this.sources}set layers(e){t(s.getLogger(this),"layers",{replacement:"Use SelectionToolbar.sources instead."}),this.sources=e}get state(){return this.activeOperation?"active":this.view?.ready&&this.effectiveSources.length?"ready":"disabled"}activate(e){const{state:t}=this,o=e?.view||this.view,r=e?.sources||this.effectiveSources;if("disabled"===t||!o)return void s.getLogger(this).warn("Unable to start selection operation.");"active"===t&&this.cancel();const a=new CustomEvent("before-activate",{cancelable:!0,detail:{toolName:e?.toolName??null}});if(this.emit("before-activate",a),a.defaultPrevented)return;const n={type:this.defaultOperationType,persistSelection:this.persistSelection,returnFeatureTitleFields:this.returnFeatureTitleFields,returnGeometry:this.returnGeometry,selectOnComplete:this.selectOnComplete,selectionManager:this.effectiveSelectionManager,...e,sources:r,view:o},l=new u({...n});return this._operationHandlesGroup=i([l.on("selection-change",e=>this.emit("selection-change",e)),l.once("complete",e=>this._onOperationComplete(e,n))]),this._set("activeOperation",l),l}activateTool(e){this.cancel();const t=this._getToolOptions(e);if(t)return this.activate(t);s.getLogger(this).warn("Unable to activate tool: unable to determine options.")}cancel(){this.activeOperation?.cancel(),this._set("activeOperation",null)}toggleTool(e){const{activeOperation:t}=this;if(t){const o=t.toolName;if(this.cancel(),o===e)return}return this.activateTool(e)}_onOperationComplete(e,t){const o=this.activeOperation?.type??e.operationType;this._operationHandlesGroup=r(this._operationHandlesGroup),this.activeOperation?.destroy(),this._set("activeOperation",null),this.emit("complete",e),this.continuousSelectionEnabled&&!e.aborted&&this.activate({...t,type:o})}_getToolOptions(e){const t=this.toolConfigs.find(t=>t.toolName===e);return t||("lasso"===e?this.defaultLassoToolOptions:"point"===e?this.defaultPointToolOptions:"rectangle"===e?this.defaultRectangleToolOptions:void 0)}};e([n({readOnly:!0})],y.prototype,"activeOperation",void 0),e([n()],y.prototype,"continuousSelectionEnabled",void 0),e([n()],y.prototype,"defaultLassoToolOptions",void 0),e([n()],y.prototype,"defaultOperationType",void 0),e([n()],y.prototype,"defaultPointToolOptions",void 0),e([n()],y.prototype,"defaultRectangleToolOptions",void 0),e([n()],y.prototype,"effectiveSelectionManager",null),e([n()],y.prototype,"effectiveSources",null),e([n()],y.prototype,"layers",null),e([n()],y.prototype,"layerViewPreferenceEnabled",void 0),e([n()],y.prototype,"persistSelection",void 0),e([n()],y.prototype,"selectionManager",void 0),e([n()],y.prototype,"returnFeatureTitleFields",void 0),e([n()],y.prototype,"returnGeometry",void 0),e([n()],y.prototype,"selectOnComplete",void 0),e([n()],y.prototype,"sources",void 0),e([n({readOnly:!0})],y.prototype,"state",null),e([n()],y.prototype,"toolConfigs",void 0),e([n()],y.prototype,"view",void 0),y=e([l("esri.widgets.support.SelectionToolbar.SelectionToolbarViewModel")],y);const m=y;export{m as default};
+import{__decorate as e}from"tslib";import{deprecatedProperty as t}from"../../../core/deprecate.js";import{EventedAccessor as o}from"../../../core/Evented.js";import{handlesGroup as i}from"../../../core/handleUtils.js";import s from"../../../core/Logger.js";import{removeMaybe as r}from"../../../core/maybe.js";import{watch as n}from"../../../core/reactiveUtils.js";import{property as a,subclass as l}from"../../../core/accessorSupport/decorators.js";import{isKnowledgeGraphLayer as p,isLinkChartLayer as c}from"../../../layers/support/layerUtils.js";import{findLayerView as d}from"../../../views/draw/support/layerUtils.js";import u from"../../../views/selection/SelectionOperation.js";import{isSelectableLayerView2D as h}from"../../../views/support/layerViewUtils.js";import{isSelectableLayerView as f,isTableLayer as v}from"../../../views/support/selectionUtils.js";let y=class extends o{constructor(e){super(e),this._operationHandlesGroup=null,this.activeOperation=null,this.continuousSelectionEnabled=!1,this.defaultLassoToolOptions={createTool:"polygon",mode:"hybrid",toolName:"lasso"},this.defaultOperationType="add",this.defaultPolygonToolOptions={createTool:"polygon",mode:"hybrid",toolName:"polygon"},this.defaultPointToolOptions={createTool:"point",toolName:"point"},this.defaultRectangleToolOptions={createTool:"rectangle",toolName:"rectangle"},this.layerViewPreferenceEnabled=!0,this.persistSelection=!0,this.selectionManager=null,this.returnFeatureTitleFields=!1,this.returnGeometry=!0,this.selectOnComplete=!0,this.sources=null,this.toolConfigs=[]}initialize(){this.addHandles([n(()=>this.effectiveSources,e=>{this.activeOperation&&(this.activeOperation.sources=e)}),n(()=>this.defaultOperationType,e=>{this.activeOperation&&(this.activeOperation.type=e)})])}destroy(){this.activeOperation?.cancel(),this.activeOperation?.destroy(),this._operationHandlesGroup=r(this._operationHandlesGroup)}get effectiveSelectionManager(){return this.selectionManager??this.view?.selectionManager}get effectiveSources(){const{layerViewPreferenceEnabled:e,sources:t,view:o}=this,i=t??this.effectiveSelectionManager?.sources;if(!i?.length)return[];const s=new Set,r="3d"===o?.type?f:h;return i.forEach(t=>{if(!v(t,o))if(r(t))s.add(t);else if(p(t)||c(t)){(t.layers||[]).forEach(t=>{const i=o?d(o,t):void 0,n=e&&r(i)?i:t;s.add(n)})}else if(e){const e=o?d(o,t):void 0;s.add(r(e)?e:t)}else s.add(t)}),Array.from(s)}get layers(){return t(s.getLogger(this),"layers",{replacement:"Use SelectionToolbar.sources instead."}),this.sources}set layers(e){t(s.getLogger(this),"layers",{replacement:"Use SelectionToolbar.sources instead."}),this.sources=e}get state(){return this.activeOperation?"active":this.view?.ready&&this.effectiveSources.length?"ready":"disabled"}activate(e){const{state:t}=this,o=e?.view||this.view,r=e?.sources||this.effectiveSources;if("disabled"===t||!o)return void s.getLogger(this).warn("Unable to start selection operation.");"active"===t&&this.cancel();const n=new CustomEvent("before-activate",{cancelable:!0,detail:{toolName:e?.toolName??null}});if(this.emit("before-activate",n),n.defaultPrevented)return;const a={type:this.defaultOperationType,persistSelection:this.persistSelection,returnFeatureTitleFields:this.returnFeatureTitleFields,returnGeometry:this.returnGeometry,selectOnComplete:this.selectOnComplete,selectionManager:this.effectiveSelectionManager,...e,sources:r,view:o},l=new u({...a});return this._operationHandlesGroup=i([l.on("selection-change",e=>this.emit("selection-change",e)),l.once("complete",e=>this._onOperationComplete(e,a))]),this._set("activeOperation",l),l}activateTool(e){this.cancel();const t=this._getToolOptions(e);if(t)return this.activate(t);s.getLogger(this).warn("Unable to activate tool: unable to determine options.")}cancel(){this.activeOperation?.cancel(),this._set("activeOperation",null)}toggleTool(e){const{activeOperation:t}=this;if(t){const o=t.toolName;if(this.cancel(),o===e)return}return this.activateTool(e)}_onOperationComplete(e,t){const o=this.activeOperation?.type??e.operationType;this._operationHandlesGroup=r(this._operationHandlesGroup),this.activeOperation?.destroy(),this._set("activeOperation",null),this.emit("complete",e),this.continuousSelectionEnabled&&!e.aborted&&this.activate({...t,type:o})}_getToolOptions(e){const t=this.toolConfigs.find(t=>t.toolName===e);return t||("lasso"===e?this.defaultLassoToolOptions:"point"===e?this.defaultPointToolOptions:"polygon"===e?this.defaultPolygonToolOptions:"rectangle"===e?this.defaultRectangleToolOptions:void 0)}};e([a({readOnly:!0})],y.prototype,"activeOperation",void 0),e([a()],y.prototype,"continuousSelectionEnabled",void 0),e([a()],y.prototype,"defaultLassoToolOptions",void 0),e([a()],y.prototype,"defaultOperationType",void 0),e([a()],y.prototype,"defaultPolygonToolOptions",void 0),e([a()],y.prototype,"defaultPointToolOptions",void 0),e([a()],y.prototype,"defaultRectangleToolOptions",void 0),e([a()],y.prototype,"effectiveSelectionManager",null),e([a()],y.prototype,"effectiveSources",null),e([a()],y.prototype,"layers",null),e([a()],y.prototype,"layerViewPreferenceEnabled",void 0),e([a()],y.prototype,"persistSelection",void 0),e([a()],y.prototype,"selectionManager",void 0),e([a()],y.prototype,"returnFeatureTitleFields",void 0),e([a()],y.prototype,"returnGeometry",void 0),e([a()],y.prototype,"selectOnComplete",void 0),e([a()],y.prototype,"sources",void 0),e([a({readOnly:!0})],y.prototype,"state",null),e([a()],y.prototype,"toolConfigs",void 0),e([a()],y.prototype,"view",void 0),y=e([l("esri.widgets.support.SelectionToolbar.SelectionToolbarViewModel")],y);const m=y;export{m as default};

package/widgets/support/SelectionToolbar/VisibleElements.d.ts

@@ -1,7 +1,7 @@
 import type Accessor from "../../../core/Accessor.js";
 
 /** @internal */
-export interface VisibleElementsProperties extends Partial<Pick<VisibleElements, "chip" | "lassoTool" | "operationTypeControls" | "pan" | "pointTool" | "rectangleTool">> {}
+export interface VisibleElementsProperties extends Partial<Pick<VisibleElements, "chip" | "lassoTool" | "operationTypeControls" | "pan" | "pointTool" | "polygonTool" | "rectangleTool">> {}
 
 /**
  * Used to control visible elements of the selection toolbar widget.
@@ -50,6 +50,13 @@ export default class VisibleElements extends Accessor {
    * @internal
    */
   accessor pointTool: boolean;
+  /**
+   * Determines if the selection toolbar should display the polygon tool.
+   *
+   * @default false
+   * @internal
+   */
+  accessor polygonTool: boolean;
   /**
    * Determines if the selection toolbar should display the rectangle tool.
    *